2e9272cc8a
引入成熟 IEC 60870-5-104 子站的只读子集(App/protocol/iec60870,28 个源文件 按原字节复制,UPSTREAM.sha256 记录来源,兼容补丁保留全部断言与容量),在其上 装配单属主共享核心(Start/Poll/Stop/Get_Status),并把标准 DTU 演示点表全量 接入为唯一真源。 - iec104_core:threadless 推进,poll 零等待,通知/交互/COV 扫描全部有界; 生命周期区分失败启动待重试、重复启动拒绝、断线保固化 RAM。 - iec104_dtu_table / iec104_source:标准 DTU 全点表注册,无数据源的点读 0, 遥控只做模拟状态可读回,不触碰实际出口。 - iec104_sim:仅窗口与独立服务模式起真实 TCP,无头黄金模式保持确定性假统计。 - test/host/iec104_dtu:独立真实 TCP 11 项、传输层 10 项、生命周期与借用负例。 验证:lvgl_sim 真实 TCP 11/11、传输 10/10,UI 像素回归未回退;AC5 单 TU 编译 0 错误 0 诊断。板端尚未切换:完整库闭包 RAM 超 92% 门禁净增预算 25730B, 结论为停止转实施,记录在 IEC104_MCU最小可行性验证.md。旧实现与 board 服务 保持原样,未提交 MDK 工程改动,未烧板。
104 lines
3.5 KiB
C
104 lines
3.5 KiB
C
/**
|
|
* IEC104_Log.h —— IEC 60870-5-104 通用日志接口。
|
|
*
|
|
* 本模块独立于报文解析和链路状态,只负责:
|
|
* 1. 按最低日志级别过滤消息;
|
|
* 2. 为消息添加本地时间和级别前缀;
|
|
* 3. 将完整消息交给用户回调或默认标准流。
|
|
*
|
|
* 公共名称全部使用 IEC104_ 前缀,可与 POSIX <syslog.h> 同时使用。
|
|
* 构建与测试命令见 IEC104测试文档.md。
|
|
*/
|
|
#ifndef IEC104_LOG_H
|
|
#define IEC104_LOG_H
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* 日志级别。
|
|
*
|
|
* 数值必须按严重程度递增,因为过滤条件为:
|
|
* message_level >= minimum_level
|
|
*/
|
|
typedef enum {
|
|
IEC104_LOG_LEVEL_DEBUG = 0,
|
|
IEC104_LOG_LEVEL_INFO = 1,
|
|
IEC104_LOG_LEVEL_WARN = 2,
|
|
IEC104_LOG_LEVEL_ERR = 3
|
|
} IEC104_LogLevel_t;
|
|
|
|
/**
|
|
* 日志回调。
|
|
*
|
|
* level:本条消息的 IEC104_LOG_LEVEL_* 级别。
|
|
* msg 指向已经拼接时间戳和级别、但不含行末换行的临时字符串;
|
|
* 字符串只在本次回调期间有效,需要保留时应由回调自行复制。
|
|
* 回调可能从不同调用线程执行,如需共享数据应自行同步。
|
|
*/
|
|
typedef void (*IEC104_LogCb_t)(int level, const char *msg);
|
|
|
|
/**
|
|
* 功能:设置日志输出回调。
|
|
* 输入参数:cb——回调函数;传入空指针时恢复默认标准流输出。
|
|
* 输出参数:无。
|
|
* 返回值:无。
|
|
* 说明:应在开始并发输出日志之前完成配置。
|
|
*/
|
|
extern void IEC104_Set_Log_Callback(IEC104_LogCb_t cb);
|
|
|
|
/**
|
|
* 功能:设置允许输出的最低日志级别。
|
|
* 输入参数:min_level——IEC104_LOG_LEVEL_* 之一。
|
|
* 输出参数:无。
|
|
* 返回值:无。
|
|
* 说明:应在开始并发输出日志之前完成配置。
|
|
*/
|
|
extern void IEC104_Set_Log_Level(int min_level);
|
|
|
|
/**
|
|
* 功能:格式化并输出一条日志。
|
|
* 输入参数:level——日志级别;fmt——非空且不含行末换行的 printf 风格格式串;
|
|
* 其后为格式化参数。
|
|
* 输出参数:无;日志交给回调,或默认写入 stdout/stderr。
|
|
* 返回值:无。
|
|
* 说明:时间戳、级别与正文合计最多保留511字节,不含结尾空字符及默认输出追加的换行;
|
|
* 超出部分按字节截断,不保证UTF-8等多字节字符的边界完整。
|
|
*/
|
|
#if defined(__GNUC__) || defined(__clang__)
|
|
extern void IEC104_Log_Emit(int level, const char *fmt, ...)
|
|
__attribute__((format(printf, 2, 3)));
|
|
#else
|
|
/**
|
|
* 功能:格式化并输出一条带时间戳和级别前缀的日志。
|
|
* 输入参数:level——日志级别;fmt——非空且不含行末换行的 printf 格式串;
|
|
* 其后为格式化参数。
|
|
* 输出参数:无;优先交给用户回调,否则写入默认标准流。
|
|
* 返回值:无。
|
|
* 说明:低级别消息直接忽略;超出固定缓冲区的内容按字节截断,可能截断多字节字符。
|
|
*/
|
|
extern void IEC104_Log_Emit(int level, const char *fmt, ...);
|
|
#endif
|
|
|
|
/*
|
|
* 便捷输出宏。
|
|
*
|
|
* 使用模块前缀,避免与 POSIX <syslog.h> 的 LOG_DEBUG、LOG_INFO、
|
|
* LOG_ERR 等常量冲突。宏至少需要传入一个格式串参数。
|
|
*/
|
|
#define IEC104_LOG_DEBUG(...) \
|
|
IEC104_Log_Emit(IEC104_LOG_LEVEL_DEBUG, __VA_ARGS__)
|
|
#define IEC104_LOG_INFO(...) \
|
|
IEC104_Log_Emit(IEC104_LOG_LEVEL_INFO, __VA_ARGS__)
|
|
#define IEC104_LOG_WARN(...) \
|
|
IEC104_Log_Emit(IEC104_LOG_LEVEL_WARN, __VA_ARGS__)
|
|
#define IEC104_LOG_ERR(...) \
|
|
IEC104_Log_Emit(IEC104_LOG_LEVEL_ERR, __VA_ARGS__)
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* IEC104_LOG_H */
|