Files
STM32F4-Base/App/task/iec104_serv.h
T
wandering1 90cc9a7d99 feat(iec104): 把 104 骨架完整迁到 MCU 板端并在台架跑通总召
把 IEC104 从模拟器端整体搬到板端:协议栈原先由独立 iec104Task 驱动,
现在改为 netTask 单 owner 的 threadless 驱动,退役独立任务。

驱动与后端:
- 新增 iec104_net_mcu.c/.h,实现 IEC104_Net.h 的 11 个 ABI 函数,
  用槽表加单调句柄映射 net_socket 的单 fd 模型;CLIENT 拆除只走
  net_drop_conn_locked,绝不 net_close 监听 fd。
- net_socket 增 5 个 owner-only 接口(net_accept_locked、
  net_drop_conn_locked、net_pending_bytes、net_send_try、
  net_mono_now_ms)。
- iec104_serv.c 重写为 iec104_serv_net_tick(),在 netTask 1ms 主循环
  里驱动 core;无 osDelay/阻塞调用,喂狗是第一句。
- Src/freertos.c 删除 iec104Task 三件套,对应栈水位探针表项同步删除。

内存:目标板 192KB SRAM 装不下 vendor 默认容量档,按实测裁剪到
skeleton 档(TCP 缓冲、业务池、SOE 256->128、值槽密集化),
RW_IRAM1 118,408 B / 90.3%,留 2,178 B 余量。

台架修复(只在真硬件暴露):
- SNTP s_ctx.fd 零初始化后为 0,而 net fd 0 是合法槽位下标,
  首次代次变化时误 net_close(0) 关掉 ftpTask 的监听槽,导致 104
  连接被 FTP 的 220 banner 抢走;改为显式 .fd = -1。
- Accept 幂等:单 fd 模型下 vendor 每轮重试 Accept 会拿到同一 fd,
  后端改为会话在役时返 WOULD_BLOCK,Close 不再清槽。

验证:
- Keil 全量重建 0 error 0 warning,uvprojx 零抖动。
- 模拟器真实 TCP 13/13、transport 10/10。
- netmcu 后端单测 13/13(新增 N12)。
- 台架 serial-boot-test required 全中;板端 2404 总召 129 帧收到
  59 遥信(53 有源、全 IV)+ 16 双点 + 30 遥测(PT1 三相非零、
  UN/频率/温度按未标定置 IV)、遥控选择执行全否定、校时 COT 7。
- 期间顺带修正 UI 漂移自检文案、.serialtest required 陈旧项、
  coding-standard 对 vendor 与外部 ABI 名字的排除口径。
2026-11-18 10:29:18 +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/protocol/iec104/ 与 App/protocol/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/protocol/iec104/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 */