首页/指令库/环境断点
EBREAK

RISC-V EBREAK 指令详解

指令手册I-type

将控制转移回调试环境,产生断点异常

指令语法

ebreak
操作数说明
目标寄存器 rd:存放运算结果的通用寄存器。
源寄存器 rs1:第一个操作数所在的寄存器。
立即数 imm:12 位有符号立即数,符号扩展后与 rs1 进行运算。
RV32I系统特权

指令编码

31..20
imm[11:0]
19..15
rs1
14..12
funct3
11..7
rd
6..0
opcode

EBREAK 使用 opcode 1110011(0x73)、funct3 000、funct12 000000000001。rs1 字段选择源寄存器,12 位立即数提供第二操作数,rd 选择目标寄存器。

格式: I-type
opcode: 1110011 (0x73)
funct3: 000 (0x0)
funct12: 000000000001 (0x001)

指令行为说明

EBREAK指令采用I型编码(imm=1, rs1=x0, funct3=000, rd=x0, opcode=SYSTEM即1110011)。该指令产生断点异常,用于将控制权返回给调试环境。主要用途包括:调试器断点、标记不应执行到的代码路径(GCC内建__builtin_unreachable),以及支持半主机(semihosting)方式通过EBREAK序列实现调试器提供的服务调用。原名SBREAK(Supervisor Break),重命名为EBREAK。

常见使用场景

特定用途

结合 «ebreak # transfer control to debugger» 等实际代码理解该场景。

调试与监控

结合 «ebreak # transfer control to debugger» 等实际代码理解该场景。

使用前检查清单

语法检查
  • 确认当前指令格式为 I-type。
  • 确认操作数排列顺序与示例一致。
语义检查
  • 确认目标寄存器用途和调用约定兼容。
  • 确认该指令不是伪指令展开后的底层形式。

容易混淆 / 常见误区

与ECALL编码仅imm[0]不同(EBREAK为1,ECALL为0)
半主机使用需特殊的三指令序列(slli+ebreak+srai)来区分调试断点