docs(screenlink): 屏板链路档去「说明」并瘦身,控制台档收编台架日志口
屏板链路设计说明.md -> 屏板链路设计.md(去档名「说明」,与 ADC 节拍 / 运行与自检记录两篇口径一致);控制台单写者日志设计说明.md 同改。 两档并存期间旧名引用 0 残留。 - 屏板链路 §3.2 台架日志口(RS232#1 / CN1 端子 / COM3)移入控制台档 §3.4:日志口的接线属 UART5 控制台通道,不属屏板链路;屏板档只留 「别去 CN1 找 USART1 端子」这句接线防错提示。 - 屏板链路 §7.1 由「根因账本 + 修复前后对比」改写为现状描述:延迟 应答机制表 + 耗时分解表 + 两个计数口径 + 已知边界,40 行压到 24 行。 顺带修正 §8 的错引:原指 `网络自愈架构设计.md` §8(实为「延后项」, 不含 uiTask 内容)改为 §4.1 `net_reconcile_tick`。 - §9.1 增补长稳行(串口日志 2026-11-13 18:31 -> 2026-11-15 21:43, 单次上电 51.2 h:rx=658262 ok=658262、crc/len/fmt/err 全 0、 drop=7 仅启动期、kerr/abor/bad=0、全程 off=0);§9.2 销项三条 (仪器项、2 h 长稳、len=7 观察项),新增「按键通路」一条——51.2 h 日志 keys=0 kq=0 dfok=0 dfold=0,延迟应答在真机上从未执行过。 - 删除 sb_frame_b_build_logo() 及 SB_LOGO_MAGIC_* / SB_SCREEN_W/H 与对应单测(TC-SBPROTO-022/023 全组、024c/024d),组帧入口只剩 sb_frame_b_build_image()。sb_proto 单测 59 -> 45 条,45/45 通过。 - cfg_file.c 出厂模板三条中文字面量改 \uXXXX 转义:消除全量重编时的 4 条 #870-D invalid multibyte character sequence,运行期字节不变, 源码回到纯 ASCII(符合「字符串字面量必须纯 ASCII」)。 验证:keil-build 0 Error 0 Warning;sb_proto 45/45、sb_link 164/164; pre-commit 48 钩子全 Passed;check_doc_links --sections-strict 通过。
This commit is contained in:
@@ -64,13 +64,13 @@ extern "C" {
|
||||
* 接收缓冲:16 B 足够。
|
||||
* 屏板只发 6 B 的帧 A(周期召唤 / 按键召唤),16 B 留出一次噪声冲击的余量。
|
||||
* ⚠ 不要照抄屏板侧的 4208 B——那是帧 B 的长度,方向相反(主机发、屏板收),
|
||||
* 放进接收侧白占 SRAM(判据见 docs/子系统设计/屏板链路设计说明.md §2)。
|
||||
* 放进接收侧白占 SRAM(判据见 docs/子系统设计/屏板链路设计.md §2)。
|
||||
*/
|
||||
#define SB_LINK_RX_BUF_SIZE (16U)
|
||||
|
||||
/*
|
||||
* 统计上报周期(ms)。只在计数有变化时才打一行,链路空闲不刷屏;
|
||||
* 台架验收靠的就是这一行里的累计值(判据见 docs/子系统设计/屏板链路设计说明.md §9)。
|
||||
* 台架验收靠的就是这一行里的累计值(判据见 docs/子系统设计/屏板链路设计.md §9)。
|
||||
*/
|
||||
#define SB_LINK_REPORT_MS (5000U)
|
||||
|
||||
@@ -79,7 +79,7 @@ extern "C" {
|
||||
* 复位期间约 1 s 不召唤;再叠上主机的重挂/噪声恢复,短窗口会把"屏板活着但歇了口气"
|
||||
* 误判成离线,然后在下一次召唤时又"恢复"——现场看到的是离线标志反复跳。
|
||||
* 10 s 的取法:比 1 s 自复位空窗大一个数量级,又远小于"人发现屏板黑屏"的时间。
|
||||
* 出处 docs/子系统设计/屏板链路设计说明.md §2 链路监视。
|
||||
* 出处 docs/子系统设计/屏板链路设计.md §2 链路监视。
|
||||
*/
|
||||
#define SB_LINK_OFFLINE_MS (10000U)
|
||||
|
||||
@@ -108,7 +108,7 @@ extern "C" {
|
||||
* 为什么是 140 而不是更大:扣住的窗从召唤时刻起算,到点必须发(旧帧)保"一召唤
|
||||
* 一答";140 + 线上 59.6 ≈ 199.6 < **205**(屏板放弃计时——它带键重问的最早时刻),
|
||||
* 超时答案也赶在下一次召唤之前发完,不与任何重问对撞。再大就要撞上 205 线。
|
||||
* 出处:docs/子系统设计/屏板链路设计说明.md §7.1(205/280 两线)与本函数说明。
|
||||
* 出处:docs/子系统设计/屏板链路设计.md §7.1(205/280 两线)与本函数说明。
|
||||
*/
|
||||
#define SB_KEY_RESP_MAX_MS (140U)
|
||||
|
||||
@@ -148,7 +148,7 @@ typedef struct
|
||||
uint32_t frame_build; /* 组帧次数(只有内容/掩码变化才 +1) */
|
||||
uint32_t frame_bad; /* 组完自校验失败次数(正常恒 0) */
|
||||
uint32_t frame_us; /* 最近一次组帧耗时(µs,DWT 实测) */
|
||||
uint32_t frame_us_max; /* 组帧耗时峰值(µs),预算 ≤1 ms(docs/子系统设计/屏板链路设计说明.md §7) */
|
||||
uint32_t frame_us_max; /* 组帧耗时峰值(µs),预算 ≤1 ms(docs/子系统设计/屏板链路设计.md §7) */
|
||||
|
||||
/* ---- 按键上行与链路监视 ---- */
|
||||
uint32_t key_drop; /* 按键队列满导致的丢弃次数 */
|
||||
@@ -257,7 +257,7 @@ void sb_link_poll(uint32_t now_ms);
|
||||
* BSP_ERR_CRC 组完自校验失败(已计数 frame_bad,帧不会发出去)
|
||||
* 限定条件:**任务上下文**,且必须与 ui_port_step() 同一个任务(显存是单写者)。
|
||||
* 变化帧实测 ≈0.5 ms(典型)/ 0.8 ms(峰值),没变只付 memcmp(≈20 µs);
|
||||
* 判据口径见 docs/子系统设计/屏板链路设计说明.md §7。
|
||||
* 判据口径见 docs/子系统设计/屏板链路设计.md §7。
|
||||
* 函数说明:1. **不持有显存副本**——直接拿 p_live_bmp 与帧缓冲里的点阵段 memcmp,
|
||||
* 没变就立刻返回(约 20 µs)。省掉 3200 B 影子缓冲,也省掉每拍重算 CRC。
|
||||
* 2. **TX 占用期间绝不写帧缓冲**(那会让 DMA 发出半新半旧的"脏帧"):
|
||||
@@ -269,13 +269,13 @@ bsp_err_t sb_link_frame_update(const uint8_t *p_live_bmp, uint32_t led_mask);
|
||||
/*
|
||||
* 函数功能:取走一个待注的屏板按键(任务侧)
|
||||
* 入口参数:无
|
||||
* 返回值:屏板 key 字节(1~10,语义见 docs/子系统设计/屏板链路设计说明.md §5);
|
||||
* 返回值:屏板 key 字节(1~10,语义见 docs/子系统设计/屏板链路设计.md §5);
|
||||
* 0 = 队列空(屏板自己的 0 就是"无键",两者同义,不必再分)
|
||||
* 限定条件:任务上下文;中断侧在入队,本函数出队。单生产者单消费者,不需要关中断。
|
||||
* 函数说明:只吐**屏板原始键号**,不映射 UI_KEY_*——键号是协议语义,UI 键码是 UI 语义,
|
||||
* 两者在 uiTask 里汇合(那一层才知道当前是哪个页面在接键)。
|
||||
* key == 9/10(RESET/FACTORY)照原样吐出,丢不丢由调用方定(当前口径见
|
||||
* docs/子系统设计/屏板链路设计说明.md §5)。
|
||||
* docs/子系统设计/屏板链路设计.md §5)。
|
||||
*/
|
||||
uint8_t sb_link_key_take(void);
|
||||
|
||||
|
||||
@@ -105,7 +105,7 @@ uint16_t sb_crc16(const uint8_t *p_data, uint16_t len)
|
||||
uint16_t crc = 0xFFFFU;
|
||||
/* 32 位计数:用 uint16_t 循环变量时 ARMCC 每轮会多生成一条 UXTH(实测见
|
||||
* fromelf 反汇编),4206 B 一轮就是 4206 条无用指令。帧 B 每帧都要算满 4206 B,
|
||||
* 这条值得省(组帧预算见 docs/子系统设计/屏板链路设计说明.md §7)。 */
|
||||
* 这条值得省(组帧预算见 docs/子系统设计/屏板链路设计.md §7)。 */
|
||||
uint32_t n = (uint32_t)len;
|
||||
|
||||
while (n > 0U)
|
||||
@@ -199,53 +199,6 @@ bsp_err_t sb_frame_b_build_image(uint8_t *p_frame, const uint8_t *p_bmp, uint32_
|
||||
return BSP_OK;
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能:组一帧帧 B「LOGO」(点阵 + 宽高 + 魔数 0x89 0x45)
|
||||
* 入口参数:p_frame - 输出缓冲(>= SB_FRAME_B_LEN)
|
||||
* p_bmp - 点阵源(>= SB_FRAME_B_BMP_LEN)
|
||||
* width - 图片宽度(像素),大端填进 info[0..1]
|
||||
* height - 图片高度(像素),大端填进 info[2..3]
|
||||
* 返回值:BSP_OK / BSP_ERR_PARAM(指针空 / 宽高为 0 / 点阵装不下)
|
||||
* 限定条件:按字节数判容量(((width + 7) / 8) * height <= 3200),不是按像素数。
|
||||
* 函数说明:本帧会覆盖屏板 Flash 扇区 126,发送时机由调用方决定。
|
||||
*/
|
||||
bsp_err_t sb_frame_b_build_logo(uint8_t *p_frame, const uint8_t *p_bmp, uint16_t width, uint16_t height)
|
||||
{
|
||||
uint32_t need_bytes;
|
||||
|
||||
if ((p_frame == 0) || (p_bmp == 0))
|
||||
{
|
||||
return BSP_ERR_PARAM;
|
||||
}
|
||||
if ((width == 0U) || (height == 0U))
|
||||
{
|
||||
return BSP_ERR_PARAM;
|
||||
}
|
||||
|
||||
/* 按字节数判容量而不是像素数:161x159 只有 25599 像素,却要 21x159 = 3339 B 才装得下 */
|
||||
need_bytes = ((uint32_t)width + 7U) / 8U;
|
||||
need_bytes *= (uint32_t)height;
|
||||
if (need_bytes > (uint32_t)SB_FRAME_B_BMP_LEN)
|
||||
{
|
||||
return BSP_ERR_PARAM;
|
||||
}
|
||||
|
||||
(void)memset(p_frame, 0, (size_t)SB_FRAME_B_LEN);
|
||||
(void)memcpy(p_frame, p_bmp, (size_t)SB_FRAME_B_BMP_LEN);
|
||||
|
||||
/* info[0..1] 宽、info[2..3] 高,均大端 */
|
||||
p_frame[SB_FRAME_B_INFO_OFF + 0U] = (uint8_t)((width >> 8) & 0xFFU);
|
||||
p_frame[SB_FRAME_B_INFO_OFF + 1U] = (uint8_t)(width & 0xFFU);
|
||||
p_frame[SB_FRAME_B_INFO_OFF + 2U] = (uint8_t)((height >> 8) & 0xFFU);
|
||||
p_frame[SB_FRAME_B_INFO_OFF + 3U] = (uint8_t)(height & 0xFFU);
|
||||
/* info[4..5] LOGO 魔数;info[6..7] 保留(已归零) */
|
||||
p_frame[SB_FRAME_B_INFO_OFF + 4U] = SB_LOGO_MAGIC_HI;
|
||||
p_frame[SB_FRAME_B_INFO_OFF + 5U] = SB_LOGO_MAGIC_LO;
|
||||
|
||||
sb_put_crc(p_frame, (uint16_t)SB_FRAME_B_CRC_OFF, sb_crc16(p_frame, (uint16_t)SB_FRAME_B_CRC_OFF));
|
||||
return BSP_OK;
|
||||
}
|
||||
|
||||
/*
|
||||
* 函数功能:自校验一帧帧 B(重算 CRC 并与帧尾比对)
|
||||
* 入口参数:p_frame - 待校验帧首地址
|
||||
|
||||
@@ -58,16 +58,6 @@ extern "C" {
|
||||
#define SB_CMD_KEY (0x00U) /* 命令类型:按键事件(立即召唤) */
|
||||
#define SB_CMD_RT (0x01U) /* 命令类型:周期刷新 */
|
||||
|
||||
/* 帧 B 的 LOGO 魔数(info[4] / info[5])
|
||||
* ⚠ 待删除(用户裁定 2026-10-29):LOGO 功能出局,不下发、不接线;本组
|
||||
* LOGO 常量与 sb_frame_b_build_logo() 保留仅为协议层完整性,**勿新增调用**。 */
|
||||
#define SB_LOGO_MAGIC_HI (0x89U)
|
||||
#define SB_LOGO_MAGIC_LO (0x45U)
|
||||
|
||||
/* 屏幕几何:LOGO 的宽高要在这一片点阵装得下 */
|
||||
#define SB_SCREEN_W (160U)
|
||||
#define SB_SCREEN_H (160U)
|
||||
|
||||
/* ============================================================================
|
||||
* 二、帧 A 的解析结果
|
||||
* ==========================================================================*/
|
||||
@@ -132,20 +122,6 @@ bsp_err_t sb_frame_a_parse(const uint8_t *p_buf, uint16_t len, sb_frame_a_t *p_o
|
||||
*/
|
||||
bsp_err_t sb_frame_b_build_image(uint8_t *p_frame, const uint8_t *p_bmp, uint32_t led_mask);
|
||||
|
||||
/*
|
||||
* 函数功能:组一帧帧 B「LOGO」(点阵 + 宽高 + 魔数 0x89 0x45)
|
||||
* 入口参数:p_frame - 输出缓冲,长度必须 >= SB_FRAME_B_LEN
|
||||
* p_bmp - 点阵源,长度必须 >= SB_FRAME_B_BMP_LEN
|
||||
* width - 图片宽度(像素),大端填进 info[0..1]
|
||||
* height - 图片高度(像素),大端填进 info[2..3]
|
||||
* 返回值:BSP_OK 组帧完成
|
||||
* BSP_ERR_PARAM 指针为空 / 宽高为 0 / 超出 160x160 点阵容量
|
||||
* 限定条件:宽高必须满足 ((width + 7) / 8) * height <= 3200 —— 屏板拿这两个数直接显示,
|
||||
* 装不下的宽高会让它读越 3200 B 的点阵缓冲,故本函数按字节数而非像素数判容量。
|
||||
* 函数说明:LOGO 帧会把屏板 Flash 0x0803F000(扇区 126)整块覆盖,且屏板不校验是否同一张图;
|
||||
* 本模块只负责把帧组对,**什么时候发、能不能重复发由调用方决定**。
|
||||
*/
|
||||
bsp_err_t sb_frame_b_build_logo(uint8_t *p_frame, const uint8_t *p_bmp, uint16_t width, uint16_t height);
|
||||
|
||||
/*
|
||||
* 函数功能:自校验一帧帧 B(重算 CRC 并与帧尾比对)
|
||||
|
||||
Reference in New Issue
Block a user