复现案例 · OpenHW on ALINX · 第 06 集

FreeRTOS 最小系统:1 kHz tick、5 任务与队列 / 互斥量实测

第 06 集仍然不改 CVE2 的 CPU 核。RTL 里补一个标准 CLINT(mtime / mtimecmp)和 64 项中断跳转表,把 FreeRTOS Kernel V11.1.0 跑成 1 kHz tick 的五任务系统:pulse、producer、consumer、monitor、heartbeat,外加 idle。队列、互斥量、栈水位、堆余量和抢占节奏全部用串口计数验证,8 秒时给出 PASS。

已验证上板 · 2026-11-20 CVE2 / RV32IM 50 MHz · 1 kHz tick FreeRTOS V11.1.0 第 06 / 12 集

这集证明的是“调度器真的在跑”,不是“能编译”。 8.000 s 时 tick=8000、队列 81 发 81 收、qerr=0、互斥保护计数 shared=expected=971、四个任务栈高水位全部有数。两次独立下载的 SUMMARY 与 STACK 行逐字一致。

板卡ALINX PI-AR035-F1-1工程板,尚未列入开发板选型;型号上线后补链
芯片AMD Artix-7 · XC7A35T看芯片参数与同族板卡 → 项目OpenHW CVE2 / CV32E20上游仓库与 commit →
tick
8,000 @ 8.000 s
队列
81 发 / 81 收 · qerr 0
互斥计数
971 / 971
堆余量
15,280 / 24,576 B
最小栈余量
pulse 177 / 256 words
资源
LUT 4,332 / FF 3,815
BRAM
32 / 50 · 64.0%
时序
WNS 1.563 / WHS 0.032 ns

1. 上板结果

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。这不是“跑一次碰巧过”,而是同一份固件、同一块板、同一组计数的可重复结果。

2. 系统结构

CLINTmtime 64-bit / mtimecmp 64-bit
0x2000_0000–0x2000_FFFF
→
CVE2 / CV32E20RV32IM · M-mode · 50 MHz
64 项跳转表 @ 0x100
→
FreeRTOS V11.1.0tasks / queue / list / heap_4
5 任务 + idle
任务优先级周期 / 触发栈 words工作
pulse450 ms256翻转 LED0,共享计数 +1
producer3100 ms384队列发送序号,共享计数 +10
consumer2阻塞等队列384收序号、校验连续性
monitor11000 ms512打印水位;8 s 汇总并判定
heartbeat1500 ms256翻转 LED1
idle0空闲256idle hook 累加空转计数

3. 调度与同步验证

验收不只看“有输出”,而是把每个计数都对上:

计数器8.000 s 值判定
FreeRTOS tick8,0001 kHz 定时器中断稳定,tick 与真实时间对齐
队列发送 / 接收81 / 81100 ms 周期,首发在 t=0,8 s 内 81 次
队列错误0无发送失败、无序号错位
共享计数 / 期望值971 / 971producer 81×10 + pulse 161 = 971,互斥量无丢更新
pulse / heartbeat161 / 1750 ms 与 500 ms 周期任务均按节拍运行
idle 空转计数21,820,112没有任务可跑时 idle 确实在消耗 CPU
堆余量15,280 B24 KiB 堆中用掉 9,296 B(37.8%)

关键在于 shared 与 expected 同时递增。 producer 和 pulse 每次修改共享计数时都先拿 g_shared_mtx,在同一个临界区里同时执行 g_shared++ 与 g_expected++。如果互斥量失效、临界区被抢占或计数丢更新,两者就会分叉;8 秒后仍然严格相等,说明互斥量在这颗核上的 mstatus.MIE 保存/恢复路径是通的。

4. 栈与堆水位

configCHECK_FOR_STACK_OVERFLOW=2 打开;uxTaskGetStackHighWaterMark 返回的是“历史最小剩余”,单位是 word(4 B)。数值越大表示余量越多:

任务分配 words峰值占用 words最小剩余 words剩余字节
pulse25679177708 B
producer384753091,236 B
consumer384753091,236 B
monitor512914211,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 实测确认,而不是靠估算。

5. 资源与时序

项目EP05EP06变化
Slice LUTs4,2664,332+66
Slice Registers3,6873,815+128
Block RAM Tile32 / 5032 / 50不变(64.0%)
DSPs1111不变
Bonded IOB2525不变
WNS / WHS1.239 / 0.053 ns1.563 / 0.032 ns0 failing endpoints
bitstream2,192,137 B2,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。

6. 踩坑记录

7. 复现步骤

  1. 准备 Vivado 2025.2、riscv-nuclei-elf-gcc 10.2、JTAG 与 USB 串口线;串口 /dev/ttyUSB1,115200 8N1。
  2. 编译固件:cd sw && make clean && make,确认生成 firmware.hex(6,079 words)。
  3. 综合实现:vivado -mode batch -source build_ep06.tcl。脚本会跑 synth_1、impl_1、phys_opt_design -hold_fix、route_design,再出最终 timing/util/drc 报告与 bitstream。
  4. 先开抓包:python3 cap_serial.py 22 /tmp/ep06.bin &,再执行 vivado -mode batch -source program_ep06.tcl。
  5. 等待约 8 秒,串口应出现 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
构建脚本里的 BRAM 初始化路径是绝对路径 /media/alinx/nvme4t/fpga-love/pi_ar035_f1_1_cve2_ep06/sw/firmware.hex。换机器或换目录时必须同步改 RTL 里的 INIT_FILE,否则综合会“成功”但 RAM 全 0。

8. 工程文件

以下文件直接取自本次验证工程。FreeRTOS 内核源码按 MIT 许可随包提供;本页只放端口与工程文件,完整内核以 FreeRTOS 上游为准。

本集验证的是单核 CVE2 上的 FreeRTOS 最小内核、1 kHz tick、五任务抢占调度、队列与互斥量、栈/堆水位。未验证:timers / event groups / stream buffers、多核 SMP、FPU 上下文、带 cache 或 DDR 的调度抖动、长时间跑稳定性、温度/电压角,以及与其他 RISC-V 核的调度延迟横比。

9. 相关入口

订阅 fpga.love

每日快报 · 每周精选 · 每月深度刊