STM32F4-Base/App/task/net_task.c

/*
 * 模块名称：Network Application Task
 * 模块功能：CH395F 协议栈初始化 + 轮询 + TCP/UDP 业务处理
 *          与 net_socket.h 配合，在 FreeRTOS 独立任务中运行
 * 适用平台：STM32F407ZGTx + CH395F
 * 作者：王建锋
 * 创建日期：2026-07-19
 * 修改记录：
 *   v1.0  2026-07-19  王建锋  创建初始版本
 *   v1.1  2026-07-19  王建锋  migrate from freertos.c StartNetTask
 *   v1.2  2026-07-21  王建锋  网络初始化移入本任务（net_init + TCP 监听）
 *   v1.3  2026-07-22  王建锋  单连接模式重构，增加大文件/边界/KeepAlive 测试
 *   v1.4  2026-09-14  王建锋  新增自检埋点：PHY 链路 3s 未建立 → sys_log "comms fault"
 *   v1.5  2026-09-15  王建锋  配置加载移交 defaultTask（配置引擎属主，P1-3）；
 *                             本任务只读 RAM 副本
 *   v1.6  2026-09-15  王建锋  P1-6：入口加 CH395F 硬件层测试模式自挂起守卫
 *                             （基础线程无条件创建，该模式下不运行）；
 *                             freertos.c USER CODE 区重复创建已删除
 */

#include <string.h>
#include "net_task.h"
#include "cmsis_os.h"
#include "net_socket.h"
#include "net_select.h"
#include "net_cfg.h"
#include "ch395f.h"
#include "sys_events.h"
#include "sys_log.h"
#include "test_config.h"   /* 测试模式宏（ENABLE_HW_LAYER_TESTS）；产品构建全未定义，无作用 */
#include "task_watchdog.h"

#define DBG_TAG "[NET_TASK]"
#include "dbg_log.h"

/*
 * 函数功能："立即应用网口配置"平台回调（注册给 net_cfg）
 * 入口参数：无
 * 返回值：无
 * 限定条件：保存写盘成功后经 net_cfg_request_apply() 调用（MCU 上由
 *          defaultTask 上下文调用；任意任务上下文均安全）
 * 函数说明：只置事件位；真正的重建在主循环内完成（CH395F SPI 归 netTask 独占，
 *          UI 不得直接操作）
 */
static void net_reconfig_request_cb(void) {
    if (sys_evtHandle != NULL) {
        (void)osEventFlagsSet(sys_evtHandle, SYS_EVT_NET_RECONFIG);
    }
}

/*
 * 函数功能：CH395F 协议栈一次性初始化（两种构建模式共用）
 * 入口参数：无
 * 返 回 值：0 - 成功，-1 - 失败
 * 函数说明：net_cfg 已由 defaultTask 在就绪屏障前加载进 RAM 副本（配置引擎
 *          属主 = defaultTask，本任务不触碰配置文件引擎）→ 只读副本组网 →
 *          net_init → MAC 回写
 *          配置模块 → MAC 打印 → PHY 强制 100M 全双工 → 广播网络就绪事件。
 *          NET 层模式由 netTask 调用；硬件层模式（阶段 1~5）netTask 不创建，
 *          由 testTask 调用后独占 CH395F。
 */
int net_stack_bring_up(void) {
    const net_cfg_t *cfg;
    char ip[16];
    char mask[16];
    char gw[16];

    DBG_INFO("=== Network Init ===");

    /* 网络配置：defaultTask 已在 SYS_EVT_STORAGE_READY 屏障前置入 RAM 副本
     * （首启/文件缺失/损坏 = 工厂默认，与既有硬编码组网值一致）；
     * 此处只读副本，不触碰配置文件引擎 */
    cfg = net_cfg_get();

    net_cfg_fmt_ipv4(cfg->ip, ip, sizeof(ip));
    net_cfg_fmt_ipv4(cfg->mask, mask, sizeof(mask));
    net_cfg_fmt_ipv4(cfg->gw, gw, sizeof(gw));

    if (net_init(ip, mask, gw, cfg->mac) != 0) {
        DBG_ERROR("net init: FAIL");
        return -1;
    }
    DBG_INFO("net init: OK");

    uint8_t mac[6];
    ch395f_get_mac_addr(mac);
    DBG_INFO("MAC: %02X:%02X:%02X:%02X:%02X:%02X",
             mac[0], mac[1], mac[2], mac[3], mac[4], mac[5]);

    /* 回写芯片实际 MAC 到配置模块（UI "网口设置"页只读影子，
     * 不直接触 CH395F SPI——SPI 归 netTask 集中处理） */
    net_cfg_set_active_mac(mac);

    uint8_t ipinf[20];
    ch395f_get_ip_inf(ipinf);
    DBG_INFO("IP_INF: IP=%d.%d.%d.%d GW=%d.%d.%d.%d MASK=%d.%d.%d.%d",
             ipinf[0], ipinf[1], ipinf[2], ipinf[3],
             ipinf[4], ipinf[5], ipinf[6], ipinf[7],
             ipinf[8], ipinf[9], ipinf[10], ipinf[11]);

    ch395f_set_phy(CH395F_PHY_100M_FULL);

    /* 强制 PHY 模式后链路会短暂掉线再重建，CH395F 会锁存 GINT_STAT_PHY_CHANGE(0x04) 全局中断标志。
     * 这里轮询该标志等待"链路状态变化"（每次读取即清除），同时用 ch395f_get_phy_status()
     * 确认链路是否已真正建立——避免因 PHY_CHANGE 只反映"掉线"边沿而误判就绪。
     * 链路一就绪（phy != DISCONN）即跳出；最多等约 3s（60 × 50ms），超时仍按实际状态继续（由下方日志暴露问题）。
     * 注：此处读取全局中断状态属"启动期一次性链路等待"，net_poll 尚未启动，不与其中断集中处理冲突；
     *     NET 模式下该标志后续仍会被 net_poll 正常消费/清除（见 net_socket.c）。 */
    uint8_t phy = CH395F_PHY_DISCONN;
    for (unsigned int i = 0U; i < 60U; i++) {
        (void)ch395f_get_glob_int_status_all();   /* 读取并清除 PHY_CHANGE 等全局中断标志 */
        phy = ch395f_get_phy_status();
        if (phy != CH395F_PHY_DISCONN) {
            break;
        }
        /* 心跳埋点：本循环单次最长约 1.1s（含 PHY 仍未就绪的 60 次迭代里
         * 每次 50ms 延时叠加），远超看门狗 100ms 抽样窗——必须在延时段补心跳，
         * 否则 PHY 未插网线时本任务会被误判为卡死（见设计说明 §4.4 长耗时白名单） */
        task_wd_beat(TASK_WD_NET);
        osDelay(50);
    }
    DBG_INFO("PHY: %s",
             (phy == CH395F_PHY_100M_FULL) ? "100M FULL" :
             (phy == CH395F_PHY_100M_HALF) ? "100M HALF" :
             (phy == CH395F_PHY_10M_FULL)  ? "10M FULL"  :
              (phy == CH395F_PHY_10M_HALF)  ? "10M HALF"  :
              (phy == CH395F_PHY_DISCONN)   ? "DISCONNECT" : "UNKNOWN");

    /* 自检埋点：链路超时未建立 → 记入自检记录（仅故障才写） */
    if (phy == CH395F_PHY_DISCONN) {
        syslog_post(SYSLOG_SELFTEST, "comms fault");
    }

    /* 网络已重建完成、对外可用：递增代次号，通知各 TCP 服务（FTP/对时/远程显示）
     * 旧 Socket 已随芯片复位失效、应重建监听 */
    net_generation_inc();

    return 0;
}

/*
 * 函数功能：网络任务初始化
 * 入口参数：无
 * 返 回 值：0 - 成功，-1 - 失败
 * 限定条件：CH395F 协议栈已初始化
 * 函数说明：创建 TCP Server 监听 Socket，注册回调等
 */
int net_task_init(void) {
    DBG_INFO("net_task_init");
    return 0;
}

/*
 * 函数功能：网络任务主函数
 * 入口参数：arg - FreeRTOS 传入参数（未使用）
 * 返 回 值：无
 * 函数说明：等待存储就绪（就绪屏障 = 卷挂载 + 网络配置加载完成，10s 超时
 *          回退工厂默认，存储故障不阻塞组网）→ net_stack_bring_up() 初始化
 *          CH395F 协议栈，
 *          再进入轮询循环处理网络事件。
 *          本任务 = 基础线程：CubeMX 生成区无条件创建（全构建唯一实例）；
 *          CH395F 硬件层测试模式（阶段 1~5）下入口自挂起（不 bring_up、
 *          不轮询、不广播 NET_READY），由 testTask 独占 CH395F。
 */
void net_task_func(void const *arg) {
    (void)arg;

    /* 硬件层测试模式：testTask 独占 CH395F，本任务自挂起（基础线程恒创建，
     * 该模式下"不运行"）：不 bring_up、不 net_poll、不广播 NET_READY；
     * ftpTask/timeSyncTask 将永久阻塞于屏障 = 预期行为（见《项目启动顺序管理》） */
#if defined(ENABLE_HW_LAYER_TESTS)
    DBG_INFO("netTask parked: HW-layer test mode, CH395F owned by testTask");
    for (;;) {
        /* 该模式下本任务已被 task_wd_required_mask() 剔除，喂心跳无副作用；
         * 保留埋点以免掩码配置变更时意外误杀 */
        task_wd_beat(TASK_WD_NET);
        osDelay(1000);
    }
#endif

    /* 配置在 NAND 的 FatFS 卷上：等存储就绪再读（取代原 2s 魔法延时）；
     * 超时（存储异常）继续以工厂默认组网，不卡网络启动 */
    if (sys_evtHandle != NULL) {
        /* osFlagsNoClear：就绪位是状态，不能被本任务消费（ftpTask 等仍要 WaitAll 两位） */
        (void)osEventFlagsWait(sys_evtHandle, SYS_EVT_STORAGE_READY,
                               osFlagsWaitAny | osFlagsNoClear, 10000u);
    }

    if (net_stack_bring_up() != 0) {
        for (;;) {
            osDelay(1000);
        }
    }

    /* 广播"网络就绪"，唤醒等待它的 ftpTask / start_test_task / timeSyncTask 等 */
    if (sys_evtHandle != NULL) {
        osEventFlagsSet(sys_evtHandle, SYS_EVT_NET_READY);
    }

    /* 注册"立即应用网口配置"回调：UI 保存成功后经 net_cfg_request_apply() 触发 */
    net_cfg_set_apply_cb(net_reconfig_request_cb);

    DBG_INFO("netTask: started (single-socket mode)");

    /* ==================== 主轮询循环 ==================== */
    for (;;) {
        /* 心跳：本任务在监视掩码内（ENABLE_HW_LAYER_TESTS 下由 task_wd_required_mask
         * 剔除，本埋点无副作用） */
        task_wd_beat(TASK_WD_NET);

        /* UI 保存网口配置后请求立即应用：在此重建网络（新 IP/掩码/网关/MAC）。
         * 重建完成后代次号已递增，各 TCP 服务据此重建监听；期间连接会断开（预期）。 */
        if (sys_evtHandle != NULL
                && (osEventFlagsGet(sys_evtHandle) & SYS_EVT_NET_RECONFIG) != 0u) {
            (void)osEventFlagsClear(sys_evtHandle, SYS_EVT_NET_RECONFIG);
            DBG_INFO("netTask: apply new net config (re-init)");
            if (net_stack_bring_up() == 0) {
                (void)osEventFlagsSet(sys_evtHandle, SYS_EVT_NET_READY);
            } else {
                DBG_ERROR("netTask: re-init FAIL");
            }
        }

        net_poll();
        net_process_messages();
        osDelay(1);
    }
}