第 06 集仍然不改 CVE2 的 CPU 核。RTL 里补一个标准 CLINT(mtime / mtimecmp)和 64 项中断跳转表,把 FreeRTOS Kernel V11.1.0 跑成 1 kHz tick 的五任务系统:pulse、producer、consumer、monitor、heartbeat,外加 idle。队列、互斥量、栈水位、堆余量和抢占节奏全部用串口计数验证,8 秒时给出 PASS。
这集证明的是“调度器真的在跑”,不是“能编译”。 8.000 s 时 tick=8000、队列 81 发 81 收、qerr=0、互斥保护计数 shared=expected=971、四个任务栈高水位全部有数。两次独立下载的 SUMMARY 与 STACK 行逐字一致。
JTAG 下载后,串口从启动横幅一路打印到 8 秒验收。下面是原始日志的关键段(完整日志见工程文件):
EP06 FreeRTOS minimal system on CVE2
configCPU_CLOCK_HZ=50000000 configTICK_RATE_HZ=1000
tasks created, starting scheduler
[mon] tick=0 heap=15280 idle=0 pulse=1 hb=0 q=1/1 sh=11/11
[pulse] n=20 tick=950
[mon] tick=1000 heap=15280 idle=2739634 pulse=21 hb=2 q=11/11 sh=131/131
[hb] n=4 tick=1501
[prod] sent=20 tick=1900
[cons] recv=20 tick=1902
...
[mon] tick=7000 heap=15280 idle=19102201 pulse=141 hb=14 q=71/71 sh=851/851
[prod] sent=80 tick=7900
[cons] recv=80 tick=7902
[pulse] n=160 tick=7950
[mon] tick=8000 heap=15280 idle=21820112 pulse=161 hb=16 q=81/81 sh=971/971
EP06 SUMMARY tick=8000 heap_free=15280 idle=21820112 pulse=161 heartbeat=17 sent=81 recv=81 qerr=0 shared=971 expected=971
EP06 STACK pulse=177 producer=309 consumer=309 monitor=421 words
EP06 RESULT: PASS
第二次下载重跑,SUMMARY 与 STACK 两行与第一次逐字相同:tick=8000、heap_free=15280、idle=21820112、pulse=161、heartbeat=17、sent=recv=81、qerr=0、shared=expected=971。这不是“跑一次碰巧过”,而是同一份固件、同一块板、同一组计数的可重复结果。
mtime 每个 clk 自增,读地址 +0xBFF8(低 32 位)与 +0xBFFC(高 32 位);mtimecmp 复位全 1,读写地址 +0x4000 / +0x4004。比较关系 mtime >= mtimecmp 直接接 CVE2 的 irq_timer_i。mtvec.MODE 硬连为 01(vectored)。异常固定跳 base + 0x00,中断跳 base + 4 × irq_id。所以不能把 FreeRTOS 的单一入口直接写进 mtvec;在 0x100 放 64 项 j freertos_risc_v_trap_handler,异常项 0、timer 项 7、external 项 11 都落到同一 handler,由它按 mcause 分派。.text.start 从 0x0000 开始,跳转表占 0x100–0x1FF,.text 从 0x200 开始;64 KiB RAM 里同时放代码、rodata、bss、24 KiB heap 和主栈。configUSE_TIMERS=0、configUSE_EVENT_GROUPS=0、configUSE_STREAM_BUFFERS=0,避免把未验证的模块算进“最小系统”。| 任务 | 优先级 | 周期 / 触发 | 栈 words | 工作 |
|---|---|---|---|---|
| pulse | 4 | 50 ms | 256 | 翻转 LED0,共享计数 +1 |
| producer | 3 | 100 ms | 384 | 队列发送序号,共享计数 +10 |
| consumer | 2 | 阻塞等队列 | 384 | 收序号、校验连续性 |
| monitor | 1 | 1000 ms | 512 | 打印水位;8 s 汇总并判定 |
| heartbeat | 1 | 500 ms | 256 | 翻转 LED1 |
| idle | 0 | 空闲 | 256 | idle hook 累加空转计数 |
验收不只看“有输出”,而是把每个计数都对上:
| 计数器 | 8.000 s 值 | 判定 |
|---|---|---|
| FreeRTOS tick | 8,000 | 1 kHz 定时器中断稳定,tick 与真实时间对齐 |
| 队列发送 / 接收 | 81 / 81 | 100 ms 周期,首发在 t=0,8 s 内 81 次 |
| 队列错误 | 0 | 无发送失败、无序号错位 |
| 共享计数 / 期望值 | 971 / 971 | producer 81×10 + pulse 161 = 971,互斥量无丢更新 |
| pulse / heartbeat | 161 / 17 | 50 ms 与 500 ms 周期任务均按节拍运行 |
| idle 空转计数 | 21,820,112 | 没有任务可跑时 idle 确实在消耗 CPU |
| 堆余量 | 15,280 B | 24 KiB 堆中用掉 9,296 B(37.8%) |
关键在于 shared 与 expected 同时递增。 producer 和 pulse 每次修改共享计数时都先拿 g_shared_mtx,在同一个临界区里同时执行 g_shared++ 与 g_expected++。如果互斥量失效、临界区被抢占或计数丢更新,两者就会分叉;8 秒后仍然严格相等,说明互斥量在这颗核上的 mstatus.MIE 保存/恢复路径是通的。
configCHECK_FOR_STACK_OVERFLOW=2 打开;uxTaskGetStackHighWaterMark 返回的是“历史最小剩余”,单位是 word(4 B)。数值越大表示余量越多:
| 任务 | 分配 words | 峰值占用 words | 最小剩余 words | 剩余字节 |
|---|---|---|---|---|
| pulse | 256 | 79 | 177 | 708 B |
| producer | 384 | 75 | 309 | 1,236 B |
| consumer | 384 | 75 | 309 | 1,236 B |
| monitor | 512 | 91 | 421 | 1,684 B |
绝对余量最小的是 pulse(177 words / 708 B),但它的占用只有 79 words;monitor 占用最多(91 words),因为它要拼多段 log_printf 的变参和多个 32 位计数,只是 512 words 的分配让它还剩 421 words。这个结果直接给出下一集的预算:再加格式化输出或浮点,就得把 monitor 栈从 512 提到 640 words,或者把打印拆短。
ISR 栈是独立的 256 words(1 KiB)静态数组,位于 .bss;它和 24 KiB heap 的边界正好在 0x63E0:ISR 栈向下生长,heap 从 0x63E0 向上生长,两个方向不重叠。这个布局在链接后被 nm 实测确认,而不是靠估算。
| 项目 | EP05 | EP06 | 变化 |
|---|---|---|---|
| Slice LUTs | 4,266 | 4,332 | +66 |
| Slice Registers | 3,687 | 3,815 | +128 |
| Block RAM Tile | 32 / 50 | 32 / 50 | 不变(64.0%) |
| DSPs | 11 | 11 | 不变 |
| Bonded IOB | 25 | 25 | 不变 |
| WNS / WHS | 1.239 / 0.053 ns | 1.563 / 0.032 ns | 0 failing endpoints |
| bitstream | 2,192,137 B | 2,192,137 B | 同一器件、同一布局规模 |
新增的 CLINT 是 64 位计数器 + 64 位比较器,跳转表是 64 条 4 B 指令;代价只有 +66 LUT / +128 FF,BRAM 一点没多。时序反而比 EP05 好(WNS 1.563 ns),说明这组新增逻辑没有落在关键路径上,主要是布局布线换了种子后的正常波动,不应解读为“FreeRTOS 比 CoreMark 更快”。
bitstream 大小与 EP05 完全相同(2,192,137 B),因为两者都是同一颗 XC7A35T、同一套 64 KiB 双 RAM 配置;差异只在 BRAM 初始化内容和少量控制逻辑,不改变 bitstream 的固定开销。SHA-256:02cfb84a5b3cf95096e317c564b753978f64c27f3ef259584ae48399989c406a。
data_is_clint 写成 data_addr[31:12] == 0x20000,只覆盖 0x2000_0000–0x2000_0FFF;但 mtimecmp 在 0x2000_4000,mtime 在 0x2000_BFF8,两者都在这个 4 KiB 页之外。结果第一次读 mtime 就触发 load access fault,串口停在一行横幅,看起来像“FreeRTOS 卡死”。改成 64 KiB 区间 data_addr[31:16] == 0x2000 后,首次上板直接跑到 PASS。这是本集最贵的一课:地址解码要按外设真实跨度划,不要按一个寄存器地址划。.trap_vector 段内写 .balign 256,汇编器在段首插了 0xFC 字节 padding,vector_table 实际落在 0x1FC,64 项表一直伸到 0x2FC,和 0x200 开始的 .text 重叠,链接器直接报 LMA overlap。去掉段内 .balign、让链接脚本把整段放在 0x100 后,objdump 确认表项从 0x100 开始、共 64 条、最后一条在 0x1FC。cap_serial.py,只能抓到尾部 64 B,误判为“打印到一半卡住”。正确顺序是先起抓包,再下载;抓包文件从 EP06 FreeRTOS minimal system 标记处切开,避免把上一版 bitstream 的残留字节算进本次日志。xTaskDelayUntil 和 uxTaskGetStackHighWaterMark 在 V11.1.0 里分别受 INCLUDE_xTaskDelayUntil、INCLUDE_uxTaskGetStackHighWaterMark 控制,不显式置 1 就是链接期 undefined reference。编译能过、链接才报,容易误判成内核缺失。mtvec 写入只保留 [31:8],低 8 位强制 01;异常和中断的入口地址不同。必须做 64 项跳转表,且异常项 0、timer 项 7、external 项 11 都要落到同一 handler,否则 timer tick 和异常会走两个不同入口。configISR_STACK_SIZE_WORDS=256 会在 port.c 里生成 xISRStack 静态数组,并导出 xISRStackTop。如果只定义宏却没有这个符号,portASM.S 的 load_x sp, xISRStackTop 会链接失败;有符号但地址和 heap 重叠,则第一次中断就会踩坏堆。riscv-nuclei-elf-gcc 10.2、JTAG 与 USB 串口线;串口 /dev/ttyUSB1,115200 8N1。cd sw && make clean && make,确认生成 firmware.hex(6,079 words)。vivado -mode batch -source build_ep06.tcl。脚本会跑 synth_1、impl_1、phys_opt_design -hold_fix、route_design,再出最终 timing/util/drc 报告与 bitstream。python3 cap_serial.py 22 /tmp/ep06.bin &,再执行 vivado -mode batch -source program_ep06.tcl。EP06 RESULT: PASS;把日志从启动横幅处切开,和 metrics/ep06_metrics.json 对照。cd sw && make clean && make
cd ..
vivado -mode batch -source build_ep06.tcl
python3 cap_serial.py 22 /tmp/ep06.bin & # 先启动,再下载
vivado -mode batch -source program_ep06.tcl
/media/alinx/nvme4t/fpga-love/pi_ar035_f1_1_cve2_ep06/sw/firmware.hex。换机器或换目录时必须同步改 RTL 里的 INIT_FILE,否则综合会“成功”但 RAM 全 0。以下文件直接取自本次验证工程。FreeRTOS 内核源码按 MIT 许可随包提供;本页只放端口与工程文件,完整内核以 FreeRTOS 上游为准。
每日快报 · 每周精选 · 每月深度刊