Files
STM32F4-Base/App/task/iec104_serv.h
T
wandering1 13ed84a0f0 refactor(iec104): 把 104_port 适配层并入 104,协议栈只剩一个目录
104 从 App/protocol 迁入 App/iec60870 时,协议核心(common/ 104/ examples/)
与我方平台适配层(原 104_port/)仍分成两个平行目录。既然这个库已转为项目自有
代码,适配层没有独立存在的理由——它本来就是对协议的装配与平台后端。

本次只做目录合并,不动任何协议逻辑:

- App/iec60870/104_port/ 的 11 个文件全部移入 App/iec60870/104/
  (iec104_core / iec104_source / iec104_source_ranks / iec104_net_mcu /
  iec104_dtu_table / iec104_comm 的 .c/.h),空目录删除
- Keil 删掉 ../App/iec60870/104_port include 路径;模拟器 CMake 把重复的
  104_port include 行合并进既有的 IEC60870_DIR/104
- 单测运行器里硬拼的 "104_port" 路径段改成 "104"(rename_ref 只认斜杠形态)
- .pre-commit-config.yaml 的 iec104-tcp 触发面去掉 104_port 前缀;coding-standard
  的排除注释改写为「库已转为自有代码,排除项待收编完成后删除」
- 文档与生成物同步:项目架构总览、软件架构与运行时规格、IEC104 上行设计说明、
  产品需求、网络配置说明、App/README、仓根 README,以及引用关系图与架构 SVG

验证(均为实跑):
- Keil UV4 RC=0,0 errors 0 warnings,Code=367464 RO=48492 RW=2288 ZI=173544
- 模拟器构建 OK,编译告警 0,iec104-tcp 13/13 真实 TCP 回环通过
- 受影响单测:iec104_comm 50/50、iec104_serv 50/50、iec104_netmcu 13/13 与
  static 2/2、soe 32/32、iec104_dtu 7 tests OK
- 覆盖率门禁 RC=0,line 8204/9185 (89.3%),49/49 套件
- 全仓 104_port 残留:仅 App/README 里一句「原 104_port 并入 104」的历史说明
2026-11-18 19:17:25 +08:00

80 lines
4.4 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.
/*
* 模块名称: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 <stdint.h> /* 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 */