fix(dwt): stop resetting CYCCNT, a counter six modules share

Three of the six DWT CYCCNT users wrote the counter to zero on init:
console_log, net_latency_test and ch395f_reuse_bench. Every one of them
only ever takes the difference (CYCCNT - t0) against a local snapshot, so
the reset bought nothing and instead caused a bogus ~2^32 delta for
anyone who sampled across it. That delta trips the task_prof glitch guard
(TASK_PROF_GLITCH_CYC = 10 s worth of cycles), which discards the sample,
so a whole worst-case measurement could vanish silently.

All three call sites now leave the counter alone; the shared contract is
"enable only, never reset", documented at each of the six users. The
documented behaviour in the link latency test guide (section 4.3) is
updated to match.

Net source change is three deleted lines, no new executable code.

Verification:
- grep for a zero assignment to CYCCNT across the tree: no hits left.
- Keil build: Code=257932 RO-data=32108 RW-data=2104 ZI-data=152688,
  0 errors 0 warnings.
- Host unit tests: console_log 153/153, task_prof 27/27, ioboard 100/100,
  sb_link 164/164.
- Four console_log assertions pinned the absolute number of DWT register
  touches; dropping the reset write lowers it by one, so their expected
  counts move from 3 to 2 (and 4 to 3 for TC-CONLOG-093). The test text
  now says why the third write disappeared.
- check_doc_links: 6 known issues, unchanged from baseline.
This commit is contained in:
2026-11-16 19:58:44 +08:00
parent e4981aa2f6
commit cc7f17f231
7 changed files with 41 additions and 16 deletions
+5 -3
View File
@@ -69,9 +69,11 @@ typedef enum {
* 返回值:当前 CYCCNT 值(周期数)
* 限定条件:任意上下文可调(幂等;纯寄存器读,不创建任何内核对象)
* 函数说明:首次调用置 CoreDebug->DEMCR.TRCENA 与 DWT->CTRL.CYCCNTENA。
* 刻意**不清零** CYCCNT:本模块只用差值,清零无意义,且会与
* console_log.c 的同名惰性使能互相干扰。DWT 使能失败时恒返回 0,
* 采样侧把 0 判为"不可用"(见 task_prof_sample)。
* 刻意**不清零** CYCCNT:本模块只用差值,清零无意义。CYCCNT 是全内核
* 共享的单一计数器,本仓 console_log.c、IOBOARD 驱动与 ScreenLink 驱动
* 也在用它取差值;任何一处清零都会让其余使用者"在途"的基准失效。
* 该口径已于 2026-11-16 在四处统一(此前 console_log.c 会清零)。
* DWT 使能失败时恒返回 0,采样侧把 0 判为"不可用"(见 task_prof_sample)。
*/
uint32_t task_prof_cyc(void);