Files
STM32F4-Base/App/task/iec104_serv.h
T
wandering1 c0cef2fca0 refactor(app): 去掉 App/protocol 层,104 迁入 App/iec60870/104_port
IEC 60870 是标准族(含 104/101),原 App/protocol/ 把它拆成
iec60870/(vendor 核心)+ iec104/(我方适配)两棵同级树,多一层且
看不出「104 只维护一个」。现按标准族收口:

  App/protocol/iec60870        -> App/iec60870
  App/protocol/iec104          -> App/iec60870/104_port
  App/protocol/{README.md,.gitkeep}  删除
  App/protocol/iec104/iec104_asdu.h  删除(零 include / 零注册的孤儿)

vendor 子树(104/ common/ examples/)逐字节未改:91 个 R100 重命名、
git diff --cached -M 后 0 insertions / 0 deletions,另按字节直比 89/89
一致;UPSTREAM.sha256 差异集仍等于既有 17 项受控差异,非篡改。
适配层只改注释里的路径字样,无逻辑行。

门禁配套:
- coding-standard 的 exclude 不能写祖先 App/iec60870/——rename_ref 机械
  改出的祖先形态会把 2,191 行适配层一起豁免掉。改为三条精确前缀
  common/ 104/ examples/,适配层 11/11 回到受检;vendor 直调脚本仍报
  88 处违规而钩子 Skipped,证明确实由 exclude 生效而非空跑。
- check_registration 的 KNOWN_GAPS 键与理由文本同步到新路径。

验证:Keil 0 errors 0 warnings(Code=367464 RO-data=48492
RW-data=2288 ZI-data=173544),构建日志与 .d 依赖证明 5 个适配 .o
真被编入;模拟器 0 警告并跑通 iec104-tcp 13/13 真实 TCP 回环;
pre-commit 25 Passed / 0 Failed;doc-links 30 处问题全在
IEC60870-Slave/ 供应商快照,我方文档零新增。

顺带删掉仓根误入库且零引用的 _all_hook.txt 与 _scope.txt。
2026-11-18 14:15:10 +08:00

80 lines
4.5 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_port/ 与 App/iec60870/,由 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_port/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 */