Files
STM32F4-Base/Drivers/BSP/UI/ui_page_yx.c
T
wandering1 74efa671bb feat(ioboard): wire 6 new CubeMX pins into 10-channel DO driver
Flat-expand the board output driver from 4 to 10 channels as decided:
IOBOARD_DO_COUNT 4->10, mask uint8_t->uint16_t, IOBOARD_DO_MASK_ALL
0x03FF.  The 6 new pins keep their bit positions: KO_LED1=PF2(bit4),
KO_LED2=PF3(bit5), KO_24V=PF4(bit6), KO4=PF5(bit7), KO5=PC15(bit8),
KO_LED3=PE6(bit9); the original 4 (KO6/TRIP/ERT/CLZ) keep bit0..3.
Backups-domain PC15 is used as a signal bit only (+/-3 mA limit).

No 24V supply interlock and no LED special-casing: the driver writes
KO_24V as an ordinary bit; callers needing relay power sequencing must
assert it before energizing a channel.  do_write/get/read_level and the
shadow register are all uint16_t; do_apply flushes four port segments
(GPIOC/GPIOF/GPIOC/GPIOE) and do_read_level caches three port ODRs.

UI: UI_DATA_DO_N 4->10, dio_do_mask uint16_t, UI_DATA_VER 3->4 because
dio_do_valid shifts 211->212; feed mask and dio row table extended;
content-page golden references regenerated for 51 rows / 7 pages.
Host ioboard tests 127/127 and ui_data tests 305/305 pass; Keil rebuild
0 errors 0 warnings.  RAM ledger, memory snapshot and size attestation
refilled from the authoritative map.  Docs: ioboard spec v1.2->v1.3 and
the resolved 6-pin question closed out.
2026-11-18 14:25:32 +08:00

293 lines
15 KiB
C
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/*
* 模块名称:UI Page YX (遥信量内容页)
* 模块功能:33 点遥信的固定名表页(方案 A)——每行一个遥信点,值列按快照的三个位图
* (有效 / 动作 / 单双点)映射成"合位-分位"、"动作-复归"或"--";动态列表页,
* 数据只读 Drivers/BSP/UI/ui_data.h 的实时快照,零 App include
* 为什么是 33 行固定表(V0.1 只有 6 点有硬件来源,另外 27 行都是 "--"):
* ① 与 104 点表一一对应,现场拿这张屏就能与上位机逐点对;② 开入落地后本页
* 零改动自动变真;③ 只显有效点的做法看不出"缺哪些点",而且点数一变黄金参考
* 就得重做(把判据建立在会漂的东西上等于没有判据)——取舍记录在
* docs/UI设计/页面扩充详细方案.md §3.1.3
* 名表为什么在页面侧而不在快照里:显示文案属表现层(同文档 §8);点数与单/双点性质
* 反过来**必须**由写侧下发(那是点表事实),两者边界见 ui_data.h 的 yx_dp 注释
* 适用平台:STM32F407ZGTx / PC 模拟器(共用源码)
* 作者:王建锋
* 创建日期:2026-10-25
* 修改记录:
* v1.0 2026-10-25 王建锋 创建(道E task-15 批 4)
*/
/* 头文件包含区 */
#include "ui_page_yx.h"
#include <string.h>
#include "ui_data.h"
#include "ui_tokens.h"
/* 静态变量定义区 */
/*
* 33 点固定名表(下标 = 遥信位图位号 = 104 点表 IOA - 1,IOA 1~33)
*
* 两处偏离文档的命名(文档 §3.1.3 用的是区间简写,落到逐行名字时必须选一个,理由写在
* 这里而不是留给人猜):
* · 文档把 idx0~3 写成「YK1~4 位置」:遥信页上出现"YK"前缀会被读成遥控对象(那是
* 另一页的事),屏上只写「位置1~4」,与遥控的对应关系留在本注释;
* · 文档把 idx30~32 写成「闭锁1~3」:idx30 在写侧有明确语义来源(保护闭锁,定值校验
* 和自检失败),用编号反而把信息丢了;idx31/32 点表未定义功能名,如实写点号占位,
* **不编造功能名**。同理 idx4~13(YX5~14)也用点号占位。
*
* 长度与 UI_DATA_YX_N 的一致性由下面的编译期数组守卫钉住(本仓惯用宽度法,ARMCC C99
* 没有 _Static_assert):名表少写/多写一行直接编译失败,不会到了屏上才少一行
*/
static const char *const s_yx_name[UI_DATA_YX_N] = {
"位置1", "位置2", "位置3", "位置4", /* 0~3 双点;V0.1 无开入硬件 */
"YX5", "YX6", "YX7", "YX8", "YX9", /* 4~8 点表未定义功能名 */
"YX10", "YX11", "YX12", "YX13", "YX14", /* 9~13 (同上,不编名) */
"故障总", "过流Ⅰ段", "过流Ⅱ段", "过流Ⅲ段", /* 14~17 YX15~18,有硬件来源 */
"零序Ⅰ段", "零序Ⅱ段", /* 18,19 V0.1 无该判据上送 */
"接地故障", "重载", "过载", /* 20~22 过载(YX23)有来源 */
"外部遥信1", "外部遥信2", "外部遥信3", "外部遥信4", /* 23~26 开入未实现 */
"外部遥信5", "外部遥信6", "外部遥信7", /* 27~29 */
"保护闭锁", "YX32", "YX33", /* 30~32 闭锁(YX31)有来源 */
};
/* 名表行数与快照点数一致(不一致 = 编译期错误,见上注) */
typedef char yx_name_count_check[(sizeof(s_yx_name) / sizeof(s_yx_name[0]) == UI_DATA_YX_N) ? 1 : -1];
/* 值列词表(全在既有 183 字子集内,font-charset 实测零新增) */
#define YX_INVALID "--"
#define YX_DP_ON "合位"
#define YX_DP_OFF "分位"
#define YX_SP_ON "动作"
#define YX_SP_OFF "复归"
/*
* 板级开入开出区(追加在 33 点遥信之后的 18 行)
*
* 为什么并入遥信页而不是单独一页:现场关心的是"这一台装置现在什么状态",
* 把 104 点表遥信与板级开入开出分两屏看,等于要人自己把两处信息拼起来。
* 但**并入显示不等于并入点表**:这 18 行没有进 YX_VALID_MASK、不经 iec104 上送,
* 它们的数据源是 dio_di_* / dio_do_*(板级 GPIO 与 74HC165),不是 yx_bits。
* 什么时候真接进点表(占 YX5~14 预留位)由协议契约决定,不由本页决定。
*
* 措辞沿用原开入开出页:开入「合/分」(外部 24V 有/无),开出「吸合/释放」
* (继电器线圈被驱动/未驱动,见 ioboard.h 的开出极性宏注释)。
*
* 硬件层面的事实(反相链路、电平检测非通断检测、极性宏在驱动层的转换、位序与开出极性
* 的验证状态)详见 Drivers/BSP/IOBOARD/README.md「6. 已知限制」中的
* PC15 备份域限流、极性未经原理图核对、硬件无辅助触点回读、开入位序验证状态等条目。
* 本文件不复述,避免两处详述漂移后互相矛盾。
*
* 这 18 行能看到什么、看不到什么(与 33 行点表遥信同等对待,别把板级状态当点表事实):
* 1. 开出这 10 行显示的是**软件影子寄存器**(ODR 镜像)——"我们让这一路吸合了",
* 不是继电器机械触点真闭合的实测反馈,本平台没有辅助触点回读通路。
* 2. 驱动里的 ioboard_do_read_level() 读的同样是 ODR,故它读回与本页恒等;
* 它只用来发现"有人在驱动之外写了这 10 根引脚的 ODR",不证明光耦导通。
* 3. 这 18 行与上面 33 行**没有任何映射关系**:上面是 104 点表(协议事实、经 iec104 上送),
* 这里是板级 GPIO/74HC165 物理状态(未进点表、不上送)。同屏只是"一屏看全"。
* 4. valid 为 0 时显示「--」而不是「分/释放」:此时 mask 里可能还留着上一次的值,画成
* "分"等于把"没数据"伪装成"已复归"。真板子上开出十行会正常显示「吸合/释放」
* (板端 feed 走 ioboard_do_get() 取得到影子,dio_do_valid=1);只有 PC 模拟器构建
* 没有 ioboard 硬件时才恒为 0 显示「--」。上板看到「--」先查 feed 侧,不要改本页判定。
* 5. 拼接边界与页数:行 0~32 = 33 点遥信(下标即 104 点表 IOA-1),行 33~50 = 板级
* 开入开出(DI_A..DI_H + KO6/TRIP/ERT/CLZ/KO_LED1/KO_LED2/KO_24V/KO4/KO5/KO_LED3,
* 名表见下方 s_dio_name);合计 33 + 18 = 51 行,51 / 8 行每页 = 6 满页 + 1 余页
* = 7 页。拼接是**纯行号偏移**:没有第二套取数分支边界要维护,
* pg_refresh 里 `a_row >= UI_DATA_YX_N` 即转板级段。
*/
#define DIO_ROW_N ((uint16_t)(UI_DATA_DI_N + UI_DATA_DO_N))
#define DIO_DI_ON "合"
#define DIO_DI_OFF "分"
#define DIO_DO_ON "吸合"
#define DIO_DO_OFF "释放"
/* 18 行名表:前 8 路板级开入,后 10 路开出(照抄丝印名,全 ASCII);
* 开出顺序与 bit0..bit9 一一对应,改顺序 = 屏上把路号指错继电器,禁止 */
static const char *const s_dio_name[] = {
"DI_A", "DI_B", "DI_C", "DI_D", "DI_E", "DI_F", "DI_G", "DI_H",
"KO6", "TRIP", "ERT", "CLZ",
"KO_LED1", "KO_LED2", "KO_24V", "KO4", "KO5", "KO_LED3"
};
/* 板级名表行数与快照点数一致(不一致 = 编译期错误,同上面 33 点名表的做法) */
typedef char dio_name_count_check[
(sizeof(s_dio_name) / sizeof(s_dio_name[0]) == (UI_DATA_DI_N + UI_DATA_DO_N)) ? 1 : -1];
/* 帧缓存:只在发布序号变化时整帧拷一次(一帧约 200 B,逐行只读标量) */
static ui_data_rt_t s_rt;
static uint32_t s_seq = 0xFFFFFFFFu;
/* 函数定义区 */
/*
* 函数功能:定长缓冲内拷字面量(代码规范 7.5 禁 strcpy;长度取调用点 sizeof)
* 入口参数:a_dst - 目标缓冲(框架行缓冲 UI_BUF_STRLEN) char *
* a_src - 源字面量(含 NUL) const char *
* len - 目标容量 uint32_t
* 返回值:无
* 限定条件:源串长度必须小于 len(编译期由字面量 sizeof 保证,不做运行期截断——
* 截断只会把"动作"打成"动",比读错更难查)
*/
static void yx_put(char *a_dst, const char *a_src, uint32_t len) {
uint32_t i = 0u;
if (len == 0u) {
return;
}
while (((i + 1u) < len) && (a_src[i] != '\0')) {
a_dst[i] = a_src[i];
i++;
}
a_dst[i] = '\0';
}
/*
* 长度参数**必须取目标缓冲容量**,不能取 sizeof(源):本表的源是 `const char *const`
* 表里的**指针**,`sizeof(lit)` 得到的是指针宽度(4/8),于是 "故障总" 会被拷成第一个
* 汉字 "故"——ASCII 名("YX9" 恰好 4 字节)看着完全正常,CJK 名集体缺尾巴。这个错
* 编译器、cppcheck、编码钩子都不会响,是像素文本断言把它揪出来的(第 2 页第 7 行
* "过流Ⅰ段" 匹配不到,值列 "复归" 却在原位 = 名字被截、值没错位)。
* 批 1 那几处 *_PUT 宏传的是**字面量数组**(sizeof 就是数组长度),照抄到这里就中招——
* 同名宏、不同参数类别,正是"看着像同构其实不同"的那类坑。
*/
#define YX_PUT(dst, lit) yx_put((dst), (lit), (uint32_t)UI_BUF_STRLEN)
/*
* 函数功能:开页复位帧缓存(接框架 init_cb)
* 入口参数:无
* 返回值:无
* 限定条件:框架开页链内(uiTask)
* 函数说明:序号必须复位——否则重开本页会沿用上次开页的帧号,首帧之前的 "--" 状态
* 可能被永久留在屏上(批 1 已踩过一次,同一条纪律再用一遍)
*/
static void pg_init(void) {
s_seq = 0xFFFFFFFFu;
(void)memset(&s_rt, 0, sizeof(s_rt));
}
/*
* 函数功能:按发布序号刷新帧缓存
* 入口参数:无
* 返回值:无
* 限定条件:uiTask 绘制链内(refresh 前)
* 函数说明:ui_data_rt() 的通道是 0=成功 / -1=尚无首帧(不是 bool 成败);失败时把
* 序号打回不可能的值,下一轮一定重试,不会停在半新不旧的帧上
*/
static void pg_sync(void) {
uint32_t seq = ui_data_rt_seq();
if ((seq == s_seq) && (s_rt.valid != 0u)) {
return;
}
if (ui_data_rt(&s_rt) != 0) {
s_seq = 0xFFFFFFFFu;
(void)memset(&s_rt, 0, sizeof(s_rt));
return;
}
s_seq = seq;
}
/*
* 函数功能:总行数(固定 51 行 = 33 点遥信 + 18 行板级开入开出,不随有效性增减)
* 入口参数:无
* 返回值:行数 uint16_t
* 限定条件:框架绘制/翻页链内
* 函数说明:故意返回常量——"只显有效点"会让现场无法判断缺了哪些点(方案 B 的缺点),
* 且行数变化会让黄金参考随运行态漂移
*/
static uint16_t pg_count(void) {
return (uint16_t)(UI_DATA_YX_N + DIO_ROW_N);
}
/*
* 函数功能:逐行取数(名 = 固定名表,值 = 三个位图映射出的词)
* 入口参数:a_row - 行下标(0..32 = 点表遥信,33..44 = 板级开入开出) uint16_t
* a_name - 名输出缓冲(UI_BUF_STRLEN) char *
* a_value - 值输出缓冲 char *
* 返回值:无
* 限定条件:框架绘制链内(双缓冲各调一次,本函数无副作用)
* 函数说明:判定顺序是"先无效、再单双点、最后位值"——无效位上的位值是真随机垃圾
* (位图没更新过就是 0,更新了也不代表该点有效),所以 IV 必须排在最前;
* 双点段 V0.1 恒无效,"合位/分位"这条支路当前不可达但必须写:开入一接上
* 就走通,而按协议写死的 4 个点本来就是双点(可达性由点表决定,不由本页决定)
*/
static void pg_refresh(uint16_t a_row, char *a_name, char *a_value) {
uint64_t bit;
uint16_t dio_row;
a_value[0] = '\0';
if (a_row >= (uint16_t)(UI_DATA_YX_N + DIO_ROW_N)) {
a_name[0] = '\0';
return; /* 防御:行号越界不越读名表 */
}
pg_sync();
/* ===== 板级开入开出区(追加在 33 点遥信之后,见文件头注释) =====
* 这一段的**数据语义与上面 33 行完全不同**:上面是 104 点表(协议事实,经 iec104
* 上送主站),这里是板级 GPIO/74HC165 的物理状态(未进点表、不上送)。
* 两段共用一张屏只是现场"一屏看全",不代表它们是同一套点。 */
if (a_row >= (uint16_t)UI_DATA_YX_N) {
dio_row = (uint16_t)(a_row - (uint16_t)UI_DATA_YX_N);
YX_PUT(a_name, s_dio_name[dio_row]);
if (dio_row < (uint16_t)UI_DATA_DI_N) {
if ((s_rt.valid == 0u) || (s_rt.dio_di_valid == 0u)) {
YX_PUT(a_value, YX_INVALID);
return;
}
bit = (uint64_t)((s_rt.dio_di_mask >> (uint8_t)dio_row) & 0x01u);
YX_PUT(a_value, (bit != 0u) ? DIO_DI_ON : DIO_DI_OFF);
return;
}
if ((s_rt.valid == 0u) || (s_rt.dio_do_valid == 0u)) {
YX_PUT(a_value, YX_INVALID);
return;
}
bit = (uint64_t)((s_rt.dio_do_mask
>> (uint8_t)(dio_row - (uint16_t)UI_DATA_DI_N)) & 0x01u);
YX_PUT(a_value, (bit != 0u) ? DIO_DO_ON : DIO_DO_OFF);
return;
}
YX_PUT(a_name, s_yx_name[a_row]);
bit = (uint64_t)1u << (uint8_t)a_row;
if ((s_rt.valid == 0u) || ((s_rt.yx_valid & bit) == 0u)) {
YX_PUT(a_value, YX_INVALID);
return;
}
if ((s_rt.yx_dp & bit) != 0u) {
YX_PUT(a_value, ((s_rt.yx_bits & bit) != 0u) ? YX_DP_ON : YX_DP_OFF);
return;
}
YX_PUT(a_value, ((s_rt.yx_bits & bit) != 0u) ? YX_SP_ON : YX_SP_OFF);
}
/*
* 页面描述符(外部链接:生成物 ui_page_registry.c 按菜单树 #page=yx 绑定引用):
* 固定 51 行的动态页(rows=NULL + count_cb/refresh),8 行/页 = 6 满页 + 1 余页 = 7 页;band_h 必须 >0
* (selectable 页选中行是黑字,无白带即不可见,同记录页约定)
*/
const content_page_def_t ui_page_yx_desc = {
.id = "yx",
.title = "遥信量",
.selectable = 1u,
.top_y = UI_LIST_TOP,
.pitch = UI_ROW_PITCH,
.band_h = UI_ROW_BAND_H,
.text_dy = 0,
.left_x = UI_LIST_LEFT_X,
.right_x = UI_LIST_RIGHT_X,
.rows_per_page = UI_LIST_ROWS,
.init_cb = pg_init,
.count_cb = pg_count,
.refresh = pg_refresh,
/* 自动失效轮询(机制见 ui_content_page.h 的 auto_ms 注;口径见供给说明 §5.5):
* 遥信变位是低频事件,屏上可见变化只在 rt 帧(200ms 拍)落地时发生;seq 恒
* 随帧前进,所以轮询周期就是稳态整页重绘频率——取 500ms 的账:变位"1s 内
* 上屏"够用(最坏 200 + 500 = 700ms 到位),比电气量档 300ms 少 40% 无内容
* 变化的重绘;500 = 25 × LVGL 整刷周期 20ms,落整刷边界 */
.auto_ms = 500u,
};