[RISCV]
详细说明
表格1：函数概述
| 函数名称 | 功能描述 | 处理的RISC-V指令 |
|---|---|---|
InstructionMapFind | 根据给定的指令代码查找对应的指令映射（InstructionMap）。 | 所有通过映射表定义的RISC-V指令 |
Instruction::to_str | 将指令对象转换为对应的汇编语言字符串表示。 | 所有通过映射表定义的RISC-V指令 |
Instruction::code_from_tokens | 根据分词后的指令生成对应的指令代码。 | 所有通过基本和伪指令映射表定义的RISC-V指令 |
Instruction::pseudo_from_tokens | 将伪指令转换为一系列真实指令代码。 | 伪指令如 nop, la, li, call, tail, sext.b, sext.h, zext.h, zext.w 等 |
Instruction::base_from_tokens | 解析基本指令并生成指令代码。 | 所有通过基本指令映射表定义的RISC-V指令 |
Instruction::parse_field | 解析指令的单个字段（如寄存器、立即数）并将其编码到指令代码中。 | 所有需要字段解析的RISC-V指令 |
Instruction::update | 更新指令中的某个字段的值，并重新编码该字段。 | 所有RISC-V指令（通用） |
Instruction::modify_pseudoinst_imm | 根据伪指令的修饰符调整立即数值。 | 需要立即数值调整的伪指令 |
TokenizedInstruction::from_line | 将一行汇编指令字符串分词，提取出指令的名称和参数。 | 所有RISC-V指令（通用） |
Instruction::append_recognized_instructions | 将所有已识别的指令名称添加到给定的QStringList列表中，用于语法高亮或自动补全。 | 所有通过映射表定义的RISC-V指令及已识别的伪指令 |
Instruction::append_recognized_registers | 将所有已识别的寄存器名称添加到给定的QStringList列表中，用于寄存器名的自动补全或语法高亮。 | 所有RISC-V寄存器 |
Instruction::extend | 对给定的值进行符号扩展，确保负数的正确表示。 | 所有需要符号扩展的RISC-V指令 |
Instruction::set_symbolic_registers | 启用或禁用符号化寄存器名称，决定指令显示时使用符号名称（如x1）还是数字编号。 | 影响所有RISC-V指令的寄存器显示方式 |
Instruction::operator== | 重载等于运算符，比较两个指令对象是否相同。 | 所有RISC-V指令（基于指令代码） |
Instruction::operator!= | 重载不等于运算符，比较两个指令对象是否不同。 | 所有RISC-V指令（基于指令代码） |
Instruction::code_from_string | 将字符串形式的指令转换为对应的指令代码。 | 所有RISC-V指令（通过分词和解析） |
表格2：指令映射表概述
| 映射表名称 | 功能描述 | 包含的RISC-V指令 |
|---|---|---|
LOAD_map | 映射加载指令。 | lb, lh, lw, ld, lbu, lhu, lwu |
STORE_map | 映射存储指令。 | sb, sh, sw, sd |
OP_IMM_map | 映射立即数型算术指令。 | addi, slli, slti, sltiu, xori, sri（srli, srai）, ori, andi |
SR_map | 映射右移指令。 | srl, sra |
OP_ALU_map | 映射ALU操作指令。 | add, sub, sll, slt, sltu, xor, srl, sra, or, and |
OP_MUL_map | 映射乘除法指令。 | mul, mulh, mulhsu, mulhu, div, divu, rem, remu |
OP_map | 综合映射ALU和乘除法指令。 | add, sub, sll, slt, sltu, xor, srl, sra, or, and, mul, mulh, mulhsu, mulhu, div, divu, rem, remu |
BRANCH_map | 映射分支指令。 | beq, bne, blt, bge, bltu, bgeu |
ENVIRONMENT_AND_BREAKPOINTS_map | 映射环境调用和断点指令。 | ecall, ebreak |
SYSTEM_PRIV_map | 映射特权系统指令。 | sret, mret |
SYSTEM_map | 映射CSR（控制和状态寄存器）指令。 | csrrw, csrrs, csrrc, csrrwi, csrrsi, csrrci |
MISC_MEM_map | 映射杂项内存指令。 | fence, fence.i |
SRI_32_map | 映射32位右移指令。 | srliw, sraiw |
OP_IMM_32_map | 映射32位立即数型算术指令。 | addiw, slliw, sriw |
ADD_32_map | 映射32位加法指令。 | addw, subw |
SR_32_map | 映射32位右移指令。 | srlw, sraw |
OP_ALU_32_map | 映射32位ALU操作指令。 | addw, subw, sllw, srlw, sraw |
OP_MUL_32_map | 映射32位乘除法指令。 | mulw, divw, divuw, remw, remuw |
OP_32_map | 综合映射32位ALU和乘除法指令。 | addw, subw, sllw, srlw, sraw, mulw, divw, divuw, remw, remuw |
I_inst_map | 顶层映射I型指令。 | load, misc-mem, op-imm, auipc, op-imm-32, store, amo, op, lui, op-32, branch, jalr, jal, system |
PSEUDO_inst_map | 映射伪指令。 | 伪指令如 .section, .global |
R_inst_map | 映射R型指令。 | 伪指令 vsetvl（RVV扩展指令） |
C_inst_map | 映射压缩指令。 | I 型指令，R 型指令 |
说明
-
函数概述
- 通用函数如
InstructionMapFind、Instruction::to_str、Instruction::code_from_tokens等，主要负责指令的查找、转换和编码，涵盖了所有定义在映射表中的RISC-V指令。 - 伪指令处理函数如
Instruction::pseudo_from_tokens、Instruction::modify_pseudoinst_imm等，专门用于处理汇编中的伪指令，将其转换为实际的RISC-V指令序列。 - 寄存器与符号化相关的函数如
Instruction::append_recognized_registers、Instruction::set_symbolic_registers，用于管理和显示寄存器名称。
- 通用函数如
-
指令映射表
- 基本指令映射表如
LOAD_map、STORE_map、OP_IMM_map等，分别对应RISC-V指令集中的不同类别指令，每个映射表包含了该类别下所有相关的具体指令。 - 综合映射表如
OP_map、OP_32_map，将多个子类别指令整合在一起，便于统一处理。 - 伪指令映射表如
PSEUDO_inst_map，定义了汇编语言中的伪指令及其对应的实际指令转换关系。
- 基本指令映射表如
例子
-
函数
Instruction::to_str- 功能：将指令对象转换为汇编语言字符串。
- 处理的指令：例如，对于
add x1, x2, x3指令，它会解析add操作及其三个寄存器参数，生成对应的字符串表示。
-
映射表
LOAD_map- 功能：定义加载指令的编码与解析规则。
- 包含的指令：例如，
lw（加载字）、ld（加载双字）等