STM32F4-Base/docs/SD2506_Trap_Records.md

SD2506API-G 陷阱记录 (Trap Records)

陷阱 1：KEIL/ARMCC 下十六进制字面量 H 后缀被编译为 0（严重）

现象

SD2506 RTC 时间写不进去：sd2506_set_time() 返回 OK，但回读 / 示波器 / 重启后时间不更新。 诊断时读 SD2506_REG_CTR1(0x0F) 得到的值像是秒寄存器内容（PMF / BLF / RTCF / WRTC 位全是反的）， 曾据此误判为「芯片处于 VBAT 模式、写保护硬禁止、需要抬高 VDD 电压」——全部是假象。

根因

在 Drivers/BSP/SD2506/sd2506.h 中，控制寄存器 1 曾写成：

#define SD2506_REG_CTR1 0x0FH  /* 控制寄存器1 */

KEIL/ARMCC (armcc v5) 不识别 H 整数后缀。遇到 0x0FH 会报语法错并把它当作 0 处理， 于是 SD2506_REG_CTR1 实际等于 0（即秒寄存器 00H），而不是 0x0F。

后果链：

1. sd2506_write_enable() 把 WRTC 位写到了 00H（秒寄存器），而非真正的 CTR1(0x0F)；
2. 真正的 CTR1 里 WRTC 永远是 0 → 写保护永不解除；
3. 任何对 00H~79H 的「时间写」都被芯片静默忽略；
4. 所有通过 SD2506_REG_CTR1 读取的诊断都实际读到秒寄存器，于是 PMF / BLF / RTCF / WRTC 解码全错。

修复

把整数后缀统一改成 U（或纯 0xNN，绝不能带 H）：

#define SD2506_REG_CTR1 0x0FU  /* 控制寄存器1 */

排查要点（铁律）

• KEIL 工程里 所有 十六进制寄存器 / 常量宏都必须用 0xNNU / 0xNNUL / 0xNN，禁止 0xNNH。
• 全工程已扫描确认仅此一处 0x0FH 非法字面量（.c/.h 非注释行）；凡是出现 「寄存器读出来位全反 / WRTC 置位无效 / 时间写不进」，先排查寄存器宏后缀，再怀疑硬件。
• 改代码只用 Edit 工具，绝不用 PowerShell Get/Set-Content 重写含中文文件（会 UTF-8/GBK 互转乱码）。

验证

修复后 TEST_SUITE_RTC Phase 1：6/6 PASS，set==readback PASS，CTR1 真实读出 PMF=0（VDD 模式）。 VDD 3.2V 完全正常，无需抬高电压；之前的「VBAT / 电压不够」推断作废。