CCU621M/app/sub_comm/sub_comm模块说明.md

sub_comm 模块说明

路径：app/sub_comm/
返回主说明：README

1. 模块职责

• 主板侧 USART0 与副板（CCU621-S）通信：0x01 接收 DI/DIP，0x02/0x03/0x04 下发 DO 与系统/枪信息；
• 维护副板 YK/YX 缓存，供其它模块读写；
• FreeRTOS 周期任务：接收拼帧、发送轮询、DI 超时清零遥信缓存。

2. 关键文件

• sub_comm_task.c
• sub_comm_task.h

3. 功能说明

• 任务模型对齐工程其它通信任务（初始化、周期循环、任务锁、喂狗、日志）；
• 执行周期 50ms（app_init.c 中 TASK_SLEEP_MS_50）；
• 对外接口：
  • void v_sub_comm_task(void *arg)：SubComm 线程入口（FreeRTOS）
  • void v_sub_comm_yk_set(E_SUB_YK_TYPE e_type, E_CMD e_cmd)：写入待下发的 DO（YK）缓存；实际下发见 v_sub_comm_tx_process() 轮询
  • E_CMD e_sub_comm_yk_get(E_SUB_YK_TYPE e_type)：读取 YK 缓存
  • U8_T u8_sub_comm_yx_get(E_SUB_YX_TYPE e_type)：读取最近一次有效 0x01 刷新后的 YX/DIP 缓存

4. 维护建议

• 校验字段实现上使用 u16_crc_checksum()，函数名为历史命名，实质为 字节累加和（见 public_func.c），与副板 subcomm_checksum8 语义一致（结果取低 8 位）；
• 可增加链路统计（超时次数、校验失败计数）便于现场诊断；
• 大报文时可评估环形缓冲；当前 SUBCOMM_RX_BUF_MAX=128 与副板一致。

5. 关联文档

• plat_comm模块说明
• 主索引：README

---

6. 协议格式说明（副板：USART0，主板<->副板）

本模块使用自定义短帧协议，帧头/帧尾固定，命令码区分 DI 上报与 DO 控制。

6.1 帧结构（通用）

单帧总长度：total_len = 5 + len（其中 len 为数据域长度）

字节序号	字段	说明
[0]	HEAD	固定帧头：0x5A
[1]	cmd	命令码（DI/DO）
[2]	len	数据域长度：0~64
[3..3+len-1]	data[]	数据域（按 cmd 不同含义不同）
[3+len]	sum	校验：对帧头到数据域的校验结果取低 8 位
[4+len]	TAIL	固定帧尾：0xA5

6.2 校验字段 sum

• 校验计算（发送与接收一致）：
  • sum = (uint8_t)u16_crc_checksum(&buf[0], 3 + len)
  • 即对 [0]~[2+len]（帧头+cmd+len+data）做 u16_crc_checksum，再取低 8 位作为 sum

6.3 命令码定义

• 0x01：SUBCOMM_CMD_DI_STATUS
  • 方向：副板 -> 主板（上报 DI 状态）
  • 数据域长度：工程约定 len >= 2（低 16bit 有效）
• 0x02：SUBCOMM_CMD_DO_CTRL
  • 方向：主板 -> 副板（控制副板继电器 DO11~DO16）
  • 数据域长度：固定 len = 2（两个字节编码 DO11~DO16 + 预留位）
• 0x03：SUBCOMM_CMD_SYS_INFO
  • 方向：主板 -> 副板（下发系统信息）
  • 数据域长度：固定 len = 22
• 0x04：SUBCOMM_CMD_GUN_INFO
  • 方向：主板 -> 副板（下发充电枪信息）
  • 数据域长度：固定 len = 14

6.4 DI 状态帧（cmd=0x01）数据域映射

通信方向：副板 -> 主板（副板上报 DI/DIP 状态）。

数据域低 16bit（data[0] 为低字节，data[1] 为高字节）用于承载：

• bit0 -> YX13
• bit1 -> YX14
• ...
• bit9 -> YX22
• bit10 -> DIP1
• ...
• bit15 -> DIP6

当接收未超时（见 6.5）时，上述位值被写入副板缓存 g_subcomm_ctx.sub_yx.u32_bits。

6.5 DO 控制帧（cmd=0x02）数据域映射

通信方向：主板 -> 副板（主板下发 DO11~DO16 控制命令）。

数据域固定 2 字节（payload[0] 为低字节，payload[1] 为高字节），承载：

• bit0 -> DO11(K1)
• bit1 -> DO12(K2)
• bit2 -> DO13(K3)
• bit3 -> DO14(K4)
• bit4 -> DO15(K5)
• bit5 -> DO16(K6)
• bit6 -> RSVD1（预留遥控位，不参与当前业务）
• bit7 -> RSVD2
• ...
• bit11 -> RSVD6
• bit12~bit15：保留对齐

6.6 系统信息帧（cmd=0x03）数据域映射（新增）

通信方向：主板 -> 副板（主板周期/按需下发系统状态信息）。

数据域固定 22 字节，字段定义如下：

偏移	长度	字段	说明
0	12	time_str	当前时间，ASCII 格式 YYMMDDhhmmss，示例：260101120000
12	1	gun_cnt	枪数量，单字节 0~N
13	1	led_board_type	灯板类型，单字节 0~N
14	1	liquid_cooling_enable	液冷使能标志，0/1
15	1	liquid_cooling_type	液冷类型；本工程未提供数据来源，默认 0x00
16	6	rsvd	预留 6 字节，当前固定 0x00

说明：

• 时间字段为纯 ASCII 数字，不带结束符 \0；
• gun_cnt 建议来自主板当前配置枪数；
• led_board_type 建议在后续实现时由板型参数或配置项给出。
• liquid_cooling_enable 取值来源：主板系统配置 u_enable.bit_enable.bit_YeLenEn 的最低位（约定 0/1）；
• liquid_cooling_type 当前未对接任何系统接口，固定为 0（预留给后续协议扩展）。

6.7 充电枪信息帧（cmd=0x04）数据域映射（新增）

通信方向：主板 -> 副板（按枪号下发枪状态信息）。

数据域固定 14 字节，字段定义如下：

偏移	长度	字段	说明
0	1	gun_no	充电枪号，单字节，取值 1/2
1	1	gun_link	枪连接状态，0 未连接，1 已连接
2	1	charge_state	充电状态，取 flow_interface.c 的 e_flow_real_state（u16_flow_put_data(...E_FLOW_PUT_DATA_GUN_REAL_STATE...)）
3	1	led_state	指示灯状态，枚举参考 E_LED_STATE_TYPE：0绿常亮、1绿闪、2红常亮、3红闪、4黄常亮、5黄闪
4	1	fault_alarm_flag	故障告警标志：0无、1故障、2告警
5	1	soc	充电 SOC，单字节 0~100
6	8	rsvd	预留 8 字节，当前固定 0x00

6.8 发送节拍与接收超时

说明：当前 sub_comm_task.c 中 DO/信息帧发送节拍由 SubComm 线程 50ms 周期的轮询位移决定，而不是由某个固定 SUBCOMM_CMD_PERIOD_MS 常量直接控制。

• DO 控制帧 0x02：
  • 在 v_sub_comm_tx_process() 中通过 s_send_turn 轮询发送；
  • 当 SubComm 任务周期为 50ms 时，0x02 下发约为 100ms/次（偶数执行周期发送）。
• 系统信息 0x03 / 枪信息 0x04：
  • 与 0x02 轮流发送；
  • 轮询顺序为：0x03（系统）-> 0x04（枪1）-> 0x04（枪2，若配置存在）-> 下一轮。
• DI 接收超时（离线判断）：
  • SUBCOMM_DI_TIMEOUT_MS = 5000ms
  • 若超过该时间未收到有效 DI 状态帧（cmd=0x01），则清零副板 YX/DIP 缓存，避免使用过期状态。

6.9 收发处理流程（概览）

• 接收端：
  • 从 USART0 FIFO 尽可能读取数据追加到 rx_buf（支持粘包/残包）。
  • 在 while (u8_sub_comm_try_parse_one_frame() != 0) {} 中循环解帧，校验失败则丢弃 1 字节重新同步。
  • 处理策略：当前接收侧仅对 cmd=0x01 的 DI 状态帧刷新 YX/DIP 缓存，其它 cmd 默认不落业务缓存。
• 发送端：
  • 上层通过 v_sub_comm_yk_set() 仅修改副板 YK 缓存位图；串口下发由副板通信任务周期性执行。