/* * 模块名称:IEC 60870-5-104 被控站服务(对外接口) * 模块功能:声明 IEC104 服务的 netTask 驱动入口与对外只读契约;协议实现在 * App/iec60870/104/ 与 App/iec60870/common/,由 netTask 单属主 * 在 1 ms 循环内调用 iec104_serv_net_tick() 驱动 threadless 核心; * iec104Task 已退役,其任务体声明/创建点已全部删除。 * 创建日期:2026-10-12(B4) */ #ifndef IEC104_SERV_H #define IEC104_SERV_H #include /* uint32_t(观测计数声明):头文件自含——2026-10-27 /keil-build 实测 * 本头此前全靠包含者先带 stdint,feed 换 include 即断链报 #20 */ /* 监听端口的宏出口已删除(道G task-9 收口 task-8 交接痕):运行期真源 = * [comm] 段 getter(App/iec60870/104/iec104_comm.h 的 iec104_comm_port(), * 工厂默认 IEC104_COMM_DEF_PORT = 2404 = DL/T 634.5104 标准端口)。 */ /* * 函数功能:netTask 内唯一的 104 推进入口(每轮一次,零阻塞) * 入口参数:无 * 返回值:无 * 限定条件:**仅 netTask 上下文调用**(在 net_task.c 主循环 net_process_messages() * 之后、osDelay(1) 之前);内部含 task_wd_beat(TASK_WD_IEC104)。 * 函数说明:驱动 threadless iec104_core 的 start/poll/stop,不做任何阻塞等待。 */ void iec104_serv_net_tick(void); /* * 104 只读观测计数(道G task-12):四个数都是**上电以来**、跨重连不清零,语义各自 * 独立、不得互相换算: * conn_up = 主站接入次数(core 统计的 TCP 接入事件次数) * apdu_tx = I 帧写帧数(**只含 I 帧,不含 S/U 帧**;在 ACK 与收尾记录交付时 * 观察,可能滞后于实际写入) * tx_fail = 以发送类故障结束的会话次数(不是字节失败数/短写次数) * rx_bytes = 收到的**字节**数(不是帧数:帧边界在传输层重组,本层看不见) * 四个字段**跨重连单调、不归零**(core 下次 start 会清零其源计数,服务层做 * 跨 start 搬运累计,对外永不倒退)。 * ⚠ 与旧的 iec104Task 控制量(活性分频 / 发送连败 / 拆链标记)无关:那些会被 * 复位、只有 8 位,为"要不要拆链"服务,拿来当统计必错。 * 到顶饱和在 0xFFFFFFF0,不回绕(回绕成个位数会被读成"刚上电")。 * 页面这一栏要写「本次开机以来」,与运行时长同一类,别让人读成终身值。 */ typedef struct { uint32_t conn_up; uint32_t apdu_tx; uint32_t tx_fail; uint32_t rx_bytes; } iec104_serv_stats_t; /* * 函数功能:读 104 观测计数(纯拷字段) * 入口参数:p_out - 输出缓冲;NULL 时无害返回 iec104_serv_stats_t * * 返 回 值:无 void * 限定条件:**任意上下文可读**——不取锁、不读时刻、不碰 socket、不阻塞(照 * adc_cal_get_stats() / boot_stats_get() 的形态:观测口一旦去抢总线或等锁, * 观测就成了故障的一部分) * 函数说明:写者 = netTask(iec104_serv_net_tick),读者 = uiTask/喂数据侧; * u32 单字读写原子,跨字段**不保证同一瞬间**——四枚之间没有"合起来 * 才成立"的判据,混窗对显示无害。 * 本函数无任何清零能力(能清零的统计口不是统计口)。 */ void iec104_serv_get_stats(iec104_serv_stats_t *p_out); /* * 函数功能:读 104 链路是否处于 RUN 态(STARTDT 数据传输已启动) * 返 回 值:1 = core.status.active(connected && status_valid && data_transfer_started); * 0 = 其它(未连接/未启动/未就绪) * 限定条件:**任意上下文可读**——单字节镜像读,不取锁、不碰 socket、不阻塞 * (与 iec104_serv_get_stats 同一形态与同一读者群)。 * 函数说明:写者 = netTask(iec104_serv_net_tick 从 core.status.active 镜像), * 读者按需采样;单字节读写在 Cortex-M4 上原子,最多读到"晚一拍"的 * 状态,无撕裂风险。 * 消费点 = 屏板状态灯 ID 3(App/algo/sb_led_map.h 的通信灯)。 * ⚠ 别拿它换算 conn_up:RUN 是电平,conn_up 是累计边沿,语义不可互换 * (同文件统计注释里的"不得互相换算"纪律)。 */ uint8_t iec104_serv_link_run(void); #endif /* IEC104_SERV_H */