Files
STM32F4-Base/App/protocol/iec104/iec104_net_mcu.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

150 lines
7.6 KiB
C

/* 模块名称:IEC 60870-5-104 板端 Net 后端附加导出 */
/*
* IEC104_Net.h 的全部 ABI 由 iec104_net_mcu.c 实现,本头只导出本后端特有的
* 只读统计入口。严禁从这里暴露 net_* 或 CH395F 细节给上层。
*/
#ifndef IEC104_NET_MCU_H
#define IEC104_NET_MCU_H
#include <stdint.h>
#include "IEC104_Net.h"
#ifdef __cplusplus
extern "C" {
#endif
/*
* 功能:读取本后端累计收到的 TCP 字节数。
* 入口参数:rx_bytes - 必填输出,写入后饱和于 0xFFFFFFF0。
* 说明:只在 Recv 返回 OK 时按 transferred 累加;跨 TCP 重连不清零。
* 帧级计数(apdu_tx / tx_fail)在 iec104_core_status_t 中,不从 Send 调用推断。
* 句柄/代次不变量:后端槽的有效性只由 slot->net_gen == net_get_generation() 判定;
* net_stack_bring_up 复位芯片并清空 net 层控制块后旧句柄一律失效,后端绝不
* 向跨代次的 fd 发任何硬件操作(含 net_close_sock)。句柄值单调递增、永不
* 复用(不是用 32 位 gen 编码身份),保证是"单调不复用"而非句柄内嵌校验。
* 平台偏离:CH395F 无 setsockopt/TCP_NODELAY 配置面,视同链路恒无 Nagle 延迟;
* Accept 不以设置 NODELAY 为 OK 条件,也不因无法设置而返回 RETRY。
*/
void iec104_net_mcu_stats(uint32_t *rx_bytes);
/* ================================================================
* 平台 Net 后端 ABI 的复述声明(本文件即 iec104_net_mcu.c 的配对头)
*
* 这 11 个名字**不是本项目起的**:它们由 vendor 的 `IEC104_Net.h`(第 73~200 行)
* 以 extern 钉死,`iec104_net_mcu.c` 只是该 ABI 在 CH395F/net_* 上的一个实现
* (与 Windows 实现 `IEC104_Net_Windows.c` 平级)。把它们在配对头里复述一遍的
* 作用是让"这个 .c 导出的每个非 static 符号都在头里有声明"这条规则(2.2)成立,
* 而不是重新定义契约——契约的唯一出处仍是 `IEC104_Net.h` 的文档注释。
*
* 为什么这里 include 上游头而不是照抄 typedef:句柄/结果码/peer 结构体都是上游
* 类型,照抄会与上游漂移;include 一次由编译器保证逐字一致。上层仍只从
* iec104_net_mcu.h 取统计入口,不会因此看到 net_* 或 CH395F 细节。
* ================================================================ */
/*
* 功能:平台网络后端的运行期起点(每个运行期成功一次,须与 Cleanup 严格配对)。
* 入口参数:native_error - 可选输出,失败时写入平台诊断码。
* 返 回 值:OK 成功;ERROR 参数或环境无效。
* 说明:只清后端句柄映射表,不向跨代次的旧 fd 发任何硬件操作(不变量见 .c 文件头)。
*/
extern IEC104_NetResult_t IEC104_Net_Init(int *native_error);
/*
* 功能:结束本运行期,不关闭任何 socket(由 TcpServer 先 Close 自己持有的句柄)。
* 入口参数:无。
* 返 回 值:无。
*/
extern void IEC104_Net_Cleanup(void);
/*
* 功能:返回平台"无效参数"的错误码(供上层把平台码归一化)。
* 入口参数:无。
* 返 回 值:平台无效参数错误码。
*/
extern int IEC104_Net_Invalid_Argument_Error(void);
/*
* 功能:创建非阻塞 IPv4 监听句柄(只接受数字地址,不解析域名)。
* 入口参数:bind_address 绑定地址;port 端口(0 = 由系统分配);
* listener/bound_port 必填输出;native_error 可选输出。
* 返 回 值:OK 交付句柄与实得端口;ERROR 失败且两个输出置无效值。
* 说明:失败时回收本次创建的 socket,不关闭调用方先前持有的句柄。
*/
extern IEC104_NetResult_t IEC104_Net_Listen(
const char *bind_address, uint16_t port, IEC104_NetSocket_t *listener,
uint16_t *bound_port, int *native_error);
/*
* 功能:从非阻塞监听句柄接入至多一个客户端,不在内部循环 accept。
* 入口参数:listener 监听句柄;client/peer 必填输出;native_error 可选输出。
* 返 回 值:OK 接入成功;WOULD_BLOCK 暂无待接入连接;RETRY 本次被中断或
* 新客户端设置失败;RETRY_LATER 接入资源暂缺;ERROR 参数或其它失败。
* 说明:单 fd 模型下第 2 次调用必须返回 WOULD_BLOCK(见 .c 文件头"一次性闸")。
*/
extern IEC104_NetResult_t IEC104_Net_Accept(
IEC104_NetSocket_t listener, IEC104_NetSocket_t *client,
IEC104_NetPeer_t *peer, int *native_error);
/*
* 功能:对已接入的非阻塞客户端执行至多一次同步 recv。
* 入口参数:socket_handle 客户端句柄;data 可写缓冲区;capacity 容量(须 > 0)。
* 返 回 值:OK/EOF/WOULD_BLOCK/RETRY/ERROR;非 OK 时 transferred 恒为 0。
* 说明:TCP 是字节流,一次接收不对应一个完整报文,拆帧由上层负责;
* EOF 不自动关闭句柄,也不设置整帧错误。
*/
extern IEC104_NetIoResult_t IEC104_Net_Recv(
IEC104_NetSocket_t socket_handle, void *data, size_t capacity);
/*
* 功能:只读取得当前内核接收队列的字节数,不等待、不消费输入。
* 入口参数:socket_handle 句柄;available 必填输出;native_error 可选输出。
* 返 回 值:OK 时写入可用字节数;ERROR 失败并保留平台诊断。
* 说明:用于给跨调度轮次的续收设定有限边界,不是完整 APDU 数,也不表示连接仍存活。
*/
extern IEC104_NetResult_t IEC104_Net_Pending_Input(
IEC104_NetSocket_t socket_handle, uint32_t *available, int *native_error);
/*
* 功能:对已接入的非阻塞客户端执行至多一次同步 send。
* 入口参数:socket_handle 客户端句柄;data 待发送数据;length 长度(须 > 0)。
* 返 回 值:OK 时 transferred 为本次被接受的字节数(可小于 length 或为 0);
* WOULD_BLOCK/RETRY/ERROR 其余情况;本接口不返回 EOF。
* 说明:只按 transferred 推进发送位置;返回后不再借用 data。
*/
extern IEC104_NetIoResult_t IEC104_Net_Send(
IEC104_NetSocket_t socket_handle, const void *data, size_t length);
/*
* 功能:等待本轮关注的监听/客户端事件;interest 为 0 时只作有限定时等待。
* 入口参数:listener/client 按 interest 需要有效;interest 为事件位组合;
* timeout_ms 等待时长;ready_events 必填输出;native_error 可选输出。
* 返 回 值:OK 时就绪位有效;RETRY 被中断;ERROR 参数或等待失败。
* 说明:最多调用一次平台等待,不无限重试;就绪后实际 I/O 仍可能暂不可读写。
* ACCEPT 就绪必须同时满足"无在役会话",否则库会每轮重复 Accept。
*/
extern IEC104_NetResult_t IEC104_Net_Wait(
IEC104_NetSocket_t listener, IEC104_NetSocket_t client, uint32_t interest,
uint32_t timeout_ms, uint32_t *ready_events, int *native_error);
/*
* 功能:关闭一个监听或客户端句柄,不调用 Cleanup 或业务回调。
* 入口参数:socket_handle 要关闭的句柄(INVALID_SOCKET 视为已关闭)。
* 返 回 值:OK 关闭成功或传入无效哨兵;ERROR 关闭失败。
* 说明:句柄按值传入,调用方须自行把保存的句柄置为 INVALID_SOCKET。
*/
extern IEC104_NetResult_t IEC104_Net_Close(
IEC104_NetSocket_t socket_handle, int *native_error);
/*
* 功能:读取平台单调时钟(供超时与收发期限计算)。
* 入口参数:无。
* 返 回 值:64 位单调毫秒计数,不是 UTC 时间戳。
*/
extern uint64_t IEC104_Net_Now_Ms(void);
#ifdef __cplusplus
}
#endif
#endif /* IEC104_NET_MCU_H */