57 lines
4.8 KiB
Markdown
57 lines
4.8 KiB
Markdown
# 纯 APP：开机首次有效 NITZ 校时测试
|
|
|
|
当前 `test/time-fix` 在 PDP 首次激活后启动一次独立测试任务，尽早读取有效的运营商 NITZ 快照，写入 APP RTC 后读回验证。不再要求两次查询值每隔 3 秒推进；这符合实机已观察到的“最近一次授时快照”行为。
|
|
|
|
只改 APP，没有修改内核，也不依赖新增的 `talkingq_time_diag_snapshot_v1`。前置 SYS/AT 探测及 APP NTP 测试均已关闭，相关源文件保留但不参与当前 APP 构建。原有内核功能不因本 APP 测试而关闭。
|
|
|
|
## 编译与实测
|
|
|
|
在现有 Windows 环境执行 `build.bat app`，构建成功并核对 APP 镜像容量后，只更新 APP。保持原内核和故障现场 RTC/NVM 状态。
|
|
|
|
启动时应出现：
|
|
|
|
```text
|
|
[TIME-DIAG] nitz_enabled=1 app_nitz_test=first_valid_after_pdp ntp_test=off sys_probe=off
|
|
[APP-NITZ-TEST] begin version=3 source=operator_nitz ntp=off policy=first_valid_after_pdp sys_probe=off
|
|
```
|
|
|
|
保留从启动到 `[APP-NITZ-TEST] finished` 的完整日志，随后按语音键触发一次实际 WSS 连接，并保留连接日志。以下是预期格式示例，不是本次实机结果：
|
|
|
|
```text
|
|
[APP-NITZ-TEST] sample attempt=1 index=1 rc=0 raw="26/10/26 08:00:10 32 0" abs_time=... leap_sec=0 query_ms=5
|
|
[APP-NITZ-TEST] parsed utc=1793001610 zone_quarters=32 zone_minutes=480
|
|
[APP-NITZ-TEST] snapshot_selected attempt=1 utc=1793001610 age=unknown first_valid_after_pdp=1 max_rtc_writes=1
|
|
[APP-NITZ-TEST] set_begin app_before=... expected_utc=1793001610 pmic_zone_minutes=480 app_calendar=2026-10-26T16:00:10
|
|
[APP-NITZ-TEST] readback set_rc=0 rtc_rc=0 app_after=1793001610 expected_utc=1793001610 delta_s=0 calendar=2026-10-26T16:00:10
|
|
[APP-NITZ-TEST] PASS source=nitz app_utc=verified wss_requires_separate_handshake_check=1
|
|
[APP-NITZ-TEST] finished one_test_per_boot=1
|
|
```
|
|
|
|
## 校时逻辑
|
|
|
|
1. 检查原内核是否提供既有公开 SDK 接口 `ql_nw_get_nitz_time_info`、`ql_localtime_r`、`ql_rtc_set_time`、`ql_rtc_get_time`，缺失则退出。
|
|
2. 立即读取 NITZ。支持实机格式 `YY/MM/DD HH:MM:SS 32 0`、文档中的带符号格式和紧凑格式。严格检查终止符、日期、闰年、时区和 UTC 范围：2024 年起至 signed 32 位秒数上限。
|
|
3. 查询失败、空值、无效格式或查询耗时超过 2 秒，不写入，间隔 5 秒重试，最多 3 次。首次有效后立即采用，不等待第二个快照，也不运行前置 AT/SYS 探测。
|
|
4. NITZ UT 日期字段按 UTC 解析；`32` 表示 32 个 15 分钟，即 UTC+8。UTC 时间戳本身不加 8 小时。使用 SDK `ql_localtime_r` 按现有 PMIC 时区转换成 RTC 本地日历，再调用 `ql_rtc_set_time`。不直接改时区、跟随标记或 NVM 文件。
|
|
5. 读回 RTC 日历和 `time(NULL)` 返回的 UTC 秒数，要求 SDK 返回成功、日期有效，且 UTC 和本地日历均与写入目标相差不超过 3 秒，才输出 `PASS`。
|
|
6. 设置尝试后不再重试写入，即使读回失败；任务结束后本次启动不再校时。仅任务创建失败允许下一次 PDP 激活重试创建。
|
|
|
|
## 结果与边界
|
|
|
|
- `sdk_api_unavailable`：缺少所需公开 SDK 接口。
|
|
- `stage=parse` / `stage=slow_query`：本次查询未采用。
|
|
- `no_valid_nitz rtc_not_written=1`：三次均未得到可采用值。
|
|
- `snapshot_selected`：已选择本次启动首次读到的有效快照。
|
|
- `stage=local_calendar`：SDK 时区转换未产生可用 RTC 日历，不写入。
|
|
- `app_clock_verification`：设置或读回验证失败。
|
|
|
|
本版本按用户要求验证“开机联网后尽早采用首次有效快照”。首次读取不等于已证明基站刚刚下发；接口没有提供本测试可确认的快照接收时刻，所以记录 `age=unknown`。只补偿本次查询返回后至写入的运行时间，不把设备开机时间或 PDP 激活时间冒充快照接收时间。
|
|
|
|
`PASS` 证明 APP 设置、时区换算和读回与所选快照一致，不独立证明快照绝对新鲜。需把原始 NITZ、APP 日历和实际北京时间对照，并继续看 WSS 实际握手。TLS 校验保持开启。本版没有增加 NITZ 更新事件处理、周期重校、WSS 启动等待或主动重连；先验证一次 APP 校时能否恢复当前故障设备。
|
|
|
|
## 本机验证
|
|
|
|
`python3 tools/test_app_nitz_test.py` 使用实际 C 源码验证解析、首次有效快照（含实机冻结快照）、失败后重试、最多一次写入、日期跨天、PMIC 时区转换、UTC 不重复偏移、tick 回绕、signed 32 位边界、设置失败及读回不符。启用 ASan/UBSan，不发送设备或公网数据。
|
|
|
|
同时对实际 SDK 头文件执行 ARM 目标语法检查。当前 macOS 环境不能运行仓库的 Windows 完整构建工具链，完整 APP 构建和实机验证待用户执行。SYS/AT 探测代码仍可通过 `tools/test_app_sys_time_probe.py` 单独回归，但不在本次开机流程中运行。
|