文件
phonerail/firmware/components/phonerail_hal/sim/hal_time_sim.c
T
zhou yang和Claude Opus 5 18d3d69856 A11:事件日志(环形缓冲 + 落盘)
事件从 evlog_put*() 进一个 256 条的 RAM 环(临界区里两条指令,**不阻塞、
不碰 flash**),由最低优先级的 t_log 攒够 16 条或最老那条等满 1 s 时批量写进
新的 `evlog` 分区(17 扇区 × 4 KB = **4335 条**)。A10 的事件出口原样接上,
判据那一层一个字没动。

八条实现约定(详见需求文档 §10.7):

· 落盘不用 NVS 也不用 SPIFFS,是一块裸 data 分区 —— NVS 的页式 GC 会把
  「写一条事件」变成一次不可预测的搬移。HAL 因此多出第六样 hal_store;
· 17 个扇区不是 16:每扇区要拿一个 16 B 的槽当扇区头,4 KB 只装 255 条,
  16 扇区 = 4080,差 16 条不到 §10.7 要求的 4096;
· 序号 = flash 里的位置(epoch × 255 + 槽号),不是自增计数器 —— 重启接着数
  不用存计数器;代价是没落盘的事件还没有序号,A12 读之前要先 flush;
· 入队走关中断的临界区,**不是第三把锁**:入队方是最高优先级的 t_safety,
  停在一把 t_log 持着的锁上等于让最低优先级的任务决定巡检节拍;
· 丢事件可以,悄悄丢不行 —— 缓冲满了盖最旧的,但补一条 LOG_EV_LOST 记着丢了几条;
· 每条记录带 CRC-8(见下),写失败就放弃该扇区剩余部分,被放弃的那段在序号
  空间里是个洞,读回时给一条空记录占位(跳过的话上位机游标会卡住);
· 每次上电记一条 LOG_EV_BOOT:时间戳上电从 0 计,没有它两次上电的记录会穿插。

事件类型的数字是 flash 格式的一部分,只许往末尾加;safety_ev_t → log_ev_t
是显式 switch 不是加偏移。§10.7 里还没人产生的六类号已占住(A12/A15/A16 去填)。

27 个用例;23 条注错逐个跑过,21 条变红。第一版校验和用异或,漏掉的正是最常见
的那条:payload 全 0 的记录被掉电切在第 8 个字节上时,后 8 个字节留在 0xFF,
而 8 个 0xFF 的异或恰好是 0 —— 半条的校验和与整条一模一样,扫描把半条当成
一条真事件。换成 CRC-8 之后拦住。另外两个只在这里才踩得到的坑:「掉电重启」
不能用 sim_hal_reset()(那是换新板子,flash 一起擦,测试永远绿),为此加了
sim_hal_reboot();「读到洞就跳过」这个错被测试里 static 数组的零初始化掩盖过
一次,缓冲要先填成非零。

Co-Authored-By: Claude Opus 5 <[email protected]>
2026-09-07 09:20:02 +08:00

37 行
1.1 KiB
C

/* 时钟的假实现:虚拟时钟,delay 只是把时间往前拨,不真的睡。
所以 A9 那种「17 ms 上电时序」的场景测试跑起来是零耗时的。 */
#include "sim_hal.h"
static uint64_t s_now_us;
static uint32_t s_delay_calls;
void sim_time_reset_internal(void); /* 只给 sim_hal_reset() 用 */
void sim_time_reset_internal(void)
{
s_now_us = 0;
s_delay_calls = 0;
}
uint64_t hal_time_now_us(void) { return s_now_us; }
uint32_t hal_time_now_ms(void) { return (uint32_t)(s_now_us / 1000u); }
uint32_t hal_time_elapsed_ms(uint32_t since_ms)
{
/* 无符号减法自然回绕,49.7 天那个坎不用特判。 */
return hal_time_now_ms() - since_ms;
}
void hal_time_delay_ms(uint32_t ms)
{
sim_crit_blocking_note(); /* 关着中断去睡:见 hal_lock.h 的临界区那一段 */
s_delay_calls++;
s_now_us += (uint64_t)ms * 1000u;
}
void sim_time_set_us(uint64_t us) { s_now_us = us; }
void sim_time_advance_us(uint64_t us) { s_now_us += us; }
void sim_time_advance_ms(uint32_t ms) { s_now_us += (uint64_t)ms * 1000u; }
uint32_t sim_time_delay_calls(void) { return s_delay_calls; }