/*
 * 模块名称：IEC 60870-5-104 被控站服务（对外接口）
 * 模块功能：声明 iec104Task 任务体与监听端口；协议实现在 App/protocol/iec104/，
 *           本接口仅供 Src/freertos.c 创建任务使用。
 * 创建日期：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 标准端口）。 */

/*
 * 函数功能：iec104Task 任务体（在 Src/freertos.c USER CODE 区 osThreadNew 创建）
 * 入口参数：argument - 未用
 * 返回值：无（任务不返回）
 */
void iec104_serv_task(void *argument);

/*
 * 104 只读观测计数（道G task-12）：四个数都是**上电以来**、跨重连不清零，语义各自
 * 独立、不得互相换算：
 *   conn_up   = 主站接入次数（accept 成功并建立协议层链路）
 *   apdu_tx   = 成功发出的 APDU 帧数（短写算 tx_fail，不算这里）
 *   tx_fail   = 发送短写/失败次数（含拆链前那几次连败）
 *   rx_bytes  = 收到的**字节**数（不是帧数：帧边界在 link 层重组，serv 看不见）
 * ⚠ 与 App/task/iec104_serv.c 里 s_liveness_ctr / s_send_fail_run / s_conn_dead 三枚
 *   **控制量**无关：那三枚会被复位、只有 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() 的形态：观测口一旦去抢总线或等锁，
 *          观测就成了故障的一部分）
 * 函数说明：写者 = iec104Task，读者 = uiTask/喂数据侧；u32 单字读写原子，跨字段
 *          **不保证同一瞬间**——四枚之间没有"合起来才成立"的判据，混窗对显示无害。
 *          本函数无任何清零能力（能清零的统计口不是统计口）。
 */
void iec104_serv_get_stats(iec104_serv_stats_t *p_out);

/*
 * 函数功能：读 104 链路是否处于 RUN 态（STARTDT 已确认 = 主站在线在轮询）
 * 返 回 值：1 = RUN；0 = 其它（IDLE/OPEN/STOPPED 或未创建任务）  uint8_t
 * 限定条件：**任意上下文可读**——单枚举字读，不取锁、不碰 socket、不阻塞
 *          （与 iec104_serv_get_stats 同一形态与同一读者群）。
 * 函数说明：写者 = iec104Task（link 状态机推进），读者按需采样；单字读写在
 *          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 */