rdtime
RISC-V rdtime 伪指令详解
汇编器伪指令读取 time 计数器伪指令，展开为 csrrs rd, time, x0。它读取平台提供的实时时间计数器低 XLEN 位。
你写下的是
rdtime rd
常见真实展开
csrrs rd, time, x0
这条伪指令到底在帮你省什么
计数器是只读 CSR；伪指令隐藏 CSRRS rd, csr, x0 的固定写法，让性能计数和时间读取更直观。
rdtime 的核心作用是“读取计数器低 XLEN 位”。它是汇编器层面的简写；调试、审计或阅读机器码时，应回到页面列出的真实展开指令和相关重定位语义来判断行为。
官方语义核对重点
官方汇编手册把 rdtime 作为汇编器层面的伪指令/别名处理，硬件执行的是展开后的真实指令序列。
真实语义以 CSRRS 等展开指令的 ISA 定义为准；本页不把 rdtime 当作独立硬件 opcode。
CSR 读写、置位、清位和立即数字段行为以 Zicsr 的 CSRRW/CSRRS/CSRRC 及立即数变体语义为准。
可用性与扩展条件
基础条件
- Zicntr/time 计数器 CSR 语义
- 读取 time 的低 XLEN 位
单指令/标准写法条件
- 目标平台提供并允许当前特权级读取 time
回退/边界
time 计数器的可用性和含义由平台定义；完整 64 位 RV32 读取需配合 rdtimeh 并处理进位。备注
- 不要把 time 直接等同于 CPU 周期计数。
展开过程怎么理解
步骤 1
CSRRS 读取 time CSR；rs1=x0 表示不修改计数器。
在 objdump / 反汇编里可能看到什么
反汇编可能显示 rdcycle/rdtime/rdinstret，也可能显示 csrrs rd, csr, x0。
官方依据与阅读顺序
本页把伪指令当作汇编器层面的别名或宏来解释：先看它会展开成哪些真实指令，再回到官方 ISA 手册理解真实指令的行为。涉及 ABI、重定位或链接器松弛时，以 psABI 文档为准。
什么时候优先想到它
测量短代码片段的周期或指令退休数
读取平台时间基准
编写基准测试、运行库或低层诊断代码
容易混淆 / 常见误区
在 RV32 上读取完整 64 位计数器通常需要配合 h 后缀形式并处理进位
计数器是否可被低特权级读取受平台和 CSR 访问控制影响
多核或动态频率环境下，cycle/time 的解释取决于平台定义
常见问题
rdtime 是真实 RISC-V 指令吗？
rdtime 是汇编器伪指令或别名，不是单独硬件 opcode。页面中的“常见真实展开”列出官方展开，真实行为由展开后的 ISA 指令决定。
使用 rdtime 时最容易误解什么？
在 RV32 上读取完整 64 位计数器通常需要配合 h 后缀形式并处理进位