增加网络配置界面

This commit is contained in:
2026-09-10 11:36:33 +08:00
parent 856b6f6426
commit 2b80d34e74
44 changed files with 2488 additions and 332 deletions
+260
View File
@@ -0,0 +1,260 @@
/*
* 模块名称:Network Configuration Core (配置核心)
* 模块功能:RAM 配置副本 + 工厂默认 + 加载/保存编排 + 实际 MAC 影子 +
* IPv4 字符串转换;磁盘格式 magic 'NCFG' + ver + CRC-16(MODBUS)
* + 18B 字段(两端小端一致,sizeof 含尾部对齐填充)
* 适用平台:STM32F407ZGTx / PC 模拟器(两端共用)
* 作者:王建锋
* 创建日期:2026-09-10
* 修改记录:
* v1.0 2026-09-10 王建锋 创建初始版本
*/
/* 头文件包含区 */
#include <string.h>
#include <stdio.h>
#include <stdbool.h>
#include "net_cfg.h"
#include "net_cfg_store.h"
#define DBG_TAG "[NET_CFG]"
#include "dbg_log.h"
/* 私有宏定义区 */
#define NET_CFG_MAGIC 0x4647434Eu /* 'NCFG'(文件字节序 N,C,G,F;小端装载) */
#define NET_CFG_VER 1u /* 磁盘格式版本 */
/* 工厂默认值(单一来源:s_cfg 初值与 s_cfg_defaults 共用,避免两处漂移) */
#define NET_CFG_DEF_IP { 192u, 168u, 1u, 100u }
#define NET_CFG_DEF_MASK { 255u, 255u, 255u, 0u }
#define NET_CFG_DEF_GW { 192u, 168u, 1u, 1u }
#define NET_CFG_DEF_MAC { 0u, 0u, 0u, 0u, 0u, 0u }
/* 磁盘格式(两端布局一致:u32 4 对齐;字段区 18B 连续,CRC 覆盖之) */
typedef struct {
uint32_t magic; /* NET_CFG_MAGIC */
uint16_t ver; /* 格式版本 */
uint16_t crc; /* CRC-16/MODBUS(覆盖 ip..mac 共 18B) */
uint8_t ip[4];
uint8_t mask[4];
uint8_t gw[4];
uint8_t mac[6];
} net_cfg_blob_t;
/* 静态变量定义区 */
/* RAM 配置副本:以工厂默认值静态初始化(落 .data),自启动即有效——
* 不依赖 net_cfg_load 是否被调用(load 仅在文件有效时覆盖) */
static net_cfg_t s_cfg = {
.ip = NET_CFG_DEF_IP,
.mask = NET_CFG_DEF_MASK,
.gw = NET_CFG_DEF_GW,
.mac = NET_CFG_DEF_MAC,
};
static uint8_t s_active_mac[6]; /* 芯片实际 MAC 影子(netTask 回写) */
static uint8_t s_active_valid; /* 影子有效标志(0 = 尚未回写) */
/* 函数定义区 */
/*
* 函数功能:CRC-16/MODBUS(无查表逐位算法)
* 入口参数:p_data - 数据指针 const uint8_t *
* len - 数据长度 size_t
* 返回值:CRC-16 值 uint16_t
* 限定条件:p_data 非空(len 可为 0,返回初始值 0xFFFF)
* 函数说明:文件私有(双端共享、避免跨模块依赖:模拟器不编译 App/util;
* 数据量 ≤32B,性能无关)
*/
static uint16_t s_crc16_modbus(const uint8_t *p_data, size_t len) {
uint16_t crc = 0xFFFFu;
for (size_t i = 0u; i < len; i++) {
crc = (uint16_t)(crc ^ (uint16_t)p_data[i]);
for (int b = 0; b < 8; b++) {
if (crc & 0x0001u) {
crc = (uint16_t)((crc >> 1) ^ 0xA001u);
}
else {
crc = (uint16_t)(crc >> 1);
}
}
}
return crc;
}
/*
* 函数功能:填充工厂默认配置
* 入口参数:p_cfg - 输出结构指针(不可为 NULL) net_cfg_t *
* 返回值:无
* 限定条件:p_cfg 非空
* 函数说明:与既有硬编码组网值一致(192.168.1.100/24,gw .1,MAC 全零
* = 芯片内置),保证首启/存储异常时行为与旧版本相同
*/
static void s_cfg_defaults(net_cfg_t *p_cfg) {
const net_cfg_t def = {
.ip = NET_CFG_DEF_IP,
.mask = NET_CFG_DEF_MASK,
.gw = NET_CFG_DEF_GW,
.mac = NET_CFG_DEF_MAC,
};
*p_cfg = def;
}
/*
* 函数功能:判断 6 字节 MAC 是否全零
* 入口参数:p_mac - MAC 指针(不可为 NULL) const uint8_t *
* 返回值:true - 全零;false - 非全零
* 限定条件:p_mac 非空
*/
static bool s_mac_is_zero(const uint8_t *p_mac) {
for (int i = 0; i < 6; i++) {
if (p_mac[i] != 0u) {
return false;
}
}
return true;
}
/*
* 函数功能:从存储加载网络配置到 RAM 副本
* 入口参数:无
* 返回值:恒 0(RAM 恒有效:文件缺失/CRC 错回退工厂默认) int
* 限定条件:MCU 端应在存储就绪后调用;未就绪时文件读失败自动回退
* 函数说明:见 net_cfg.h 同名函数说明
*/
int net_cfg_load(void) {
net_cfg_blob_t blob;
if (net_cfg_store_read((uint8_t *)&blob, sizeof(blob)) != 0) {
/* 文件缺失/不可读(首启、存储未就绪):工厂默认 */
s_cfg_defaults(&s_cfg);
DBG_INFO("load: no valid file, factory defaults");
return 0;
}
if (blob.magic != NET_CFG_MAGIC || blob.ver != NET_CFG_VER
|| s_crc16_modbus(blob.ip, 18u) != blob.crc) {
/* 格式损坏:工厂默认并留痕(不让坏配置带崩网络) */
s_cfg_defaults(&s_cfg);
DBG_ERROR("load: blob invalid (magic/ver/crc), factory defaults");
return 0;
}
memcpy(s_cfg.ip, blob.ip, 4u);
memcpy(s_cfg.mask, blob.mask, 4u);
memcpy(s_cfg.gw, blob.gw, 4u);
memcpy(s_cfg.mac, blob.mac, 6u);
DBG_INFO("load: OK ip=%u.%u.%u.%u",
(unsigned)s_cfg.ip[0], (unsigned)s_cfg.ip[1],
(unsigned)s_cfg.ip[2], (unsigned)s_cfg.ip[3]);
return 0;
}
/*
* 函数功能:保存当前 RAM 配置到存储
* 入口参数:无
* 返回值:0 - 成功;-1 - 写失败 int
* 限定条件:MCU 端应在存储就绪后调用
* 函数说明:组装磁盘格式经后端写盘;下次上电生效
*/
int net_cfg_save(void) {
net_cfg_blob_t blob;
memcpy(blob.ip, s_cfg.ip, 4u);
memcpy(blob.mask, s_cfg.mask, 4u);
memcpy(blob.gw, s_cfg.gw, 4u);
memcpy(blob.mac, s_cfg.mac, 6u);
blob.magic = NET_CFG_MAGIC;
blob.ver = NET_CFG_VER;
blob.crc = s_crc16_modbus(blob.ip, 18u);
if (net_cfg_store_write((const uint8_t *)&blob, sizeof(blob)) != 0) {
DBG_ERROR("save: store write FAILED");
return -1;
}
DBG_INFO("save: OK (effective at next power-on)");
return 0;
}
/*
* 函数功能:取 RAM 配置副本(只读指针)
* 入口参数:无
* 返回值:RAM 配置副本指针(恒非空) const net_cfg_t *
* 限定条件:无
*/
const net_cfg_t *net_cfg_get(void) {
return &s_cfg;
}
/*
* 函数功能:更新 RAM 配置副本(不写盘)
* 入口参数:p_cfg - 新配置指针(不可为 NULL) const net_cfg_t *
* 返回值:无
* 限定条件:p_cfg 非空
*/
void net_cfg_set(const net_cfg_t *p_cfg) {
if (p_cfg == NULL) {
return;
}
s_cfg = *p_cfg;
}
/*
* 函数功能:回写芯片实际 MAC(影子区)
* 入口参数:p_mac - 芯片读回的实际 MAC(不可为 NULL) const uint8_t *
* 返回值:无
* 限定条件:net_init 成功后由 netTask 上下文调用
*/
void net_cfg_set_active_mac(const uint8_t *p_mac) {
if (p_mac == NULL) {
return;
}
memcpy(s_active_mac, p_mac, 6u);
s_active_valid = 1u;
}
/*
* 函数功能:取显示用 MAC
* 入口参数:p_out - 6 字节输出缓冲(不可为 NULL) uint8_t *
* 返回值:无
* 限定条件:p_out 非空
* 函数说明:存储非全零 → 存储值;否则芯片实际(已回写);否则全零
*/
void net_cfg_get_mac(uint8_t *p_out) {
if (p_out == NULL) {
return;
}
if (!s_mac_is_zero(s_cfg.mac)) {
memcpy(p_out, s_cfg.mac, 6u);
}
else if (s_active_valid != 0u) {
memcpy(p_out, s_active_mac, 6u);
}
else {
memset(p_out, 0, 6u);
}
}
/*
* 函数功能:4 字节 IPv4 格式化为点分十进制字符串(每段 3 位补零)
* 入口参数:p_ip - 4 字节 IP(不可为 NULL) const uint8_t *
* p_buf - 输出缓冲(不可为 NULL) char *
* len - 缓冲长度 size_t
* 返回值:无
* 限定条件:p_ip/p_buf 非空;len ≥ 16
* 函数说明:"192.168.001.100"(定长 11 字符,UI 编辑光标按固定偏移定位字节)
*/
void net_cfg_fmt_ipv4(const uint8_t *p_ip, char *p_buf, size_t len) {
if (p_ip == NULL || p_buf == NULL || len == 0u) {
return;
}
(void)snprintf(p_buf, len, "%03u.%03u.%03u.%03u",
(unsigned)p_ip[0], (unsigned)p_ip[1],
(unsigned)p_ip[2], (unsigned)p_ip[3]);
}
+116
View File
@@ -0,0 +1,116 @@
/*
* 模块名称:Network Configuration (NET CFG)
* 模块功能:网络参数配置(IP/掩码/网关/MAC)——双端共享核心:RAM 配置副本 +
* 工厂默认 + 加载/保存编排 + 实际 MAC 影子;存储后端经 net_cfg_store.h
* 抽象(MCU = NAND 上 FatFS 文件 /cfg/netcfg.bin,模拟器 = 本地文件
* sim_netcfg.bin);磁盘格式 = magic + ver + CRC-16 + 18B 字段;
* MAC 全零哨兵 = 不覆盖芯片内置 MAC;保存后下次上电生效
* (每次上电 netTask 在 net_init 前加载)
* 适用平台:STM32F407ZGTx / PC 模拟器(两端共用)
* 作者:王建锋
* 创建日期:2026-09-10
* 修改记录:
* v1.0 2026-09-10 王建锋 创建初始版本
*/
#ifndef NET_CFG_H
#define NET_CFG_H
#include <stdint.h>
#include <stddef.h>
#ifdef __cplusplus
extern "C" {
#endif
/*
* 网络参数配置(RAM 副本)
* mac 全零哨兵:不设置芯片 MAC(用芯片内置值,存于芯片 EEPROM)
*/
typedef struct {
uint8_t ip[4]; /* IP 地址(工厂默认 192.168.1.100) */
uint8_t mask[4]; /* 子网掩码(工厂默认 255.255.255.0) */
uint8_t gw[4]; /* 默认网关(工厂默认 192.168.1.1) */
uint8_t mac[6]; /* MAC 地址(全零 = 芯片内置 MAC) */
} net_cfg_t;
/*
* 函数功能:从存储加载网络配置到 RAM 副本
* 入口参数:无
* 返回值:恒 0(RAM 恒有效:文件缺失/损坏回退工厂默认) int
* 限定条件:MCU 端应在存储就绪(SYS_EVT_STORAGE_READY)后调用;
* 未就绪时文件读失败,自动回退工厂默认(不阻塞网络启动)
* 函数说明: 1. 文件缺失(首启/未保存过)→ 工厂默认
* 2. magic/ver/CRC 错误 → 工厂默认并留痕(不让坏配置带崩网络)
* 3. 校验通过 → 装入 RAM 副本
*/
int net_cfg_load(void);
/*
* 函数功能:保存当前 RAM 配置到存储(Flash 持久化)
* 入口参数:无
* 返回值:0 - 成功;-1 - 写失败 int
* 限定条件:MCU 端应在存储就绪后调用
* 函数说明:组装磁盘格式(magic+ver+CRC-16+18B 字段)经后端写盘;
* 下次上电生效(netTask 在 net_init 前加载)
*/
int net_cfg_save(void);
/*
* 函数功能:取 RAM 配置副本(只读指针)
* 入口参数:无
* 返回值:RAM 配置副本指针(恒非空) const net_cfg_t *
* 限定条件:无
* 函数说明:netTask(启动期读取组网)与 UI 页(显示/编辑)共用
*/
const net_cfg_t *net_cfg_get(void);
/*
* 函数功能:更新 RAM 配置副本(不写盘)
* 入口参数:p_cfg - 新配置指针(不可为 NULL) const net_cfg_t *
* 返回值:无
* 限定条件:p_cfg 非空;写盘须另行调 net_cfg_save
* 函数说明:UI 编辑页调整字段后经此落 RAM 副本
*/
void net_cfg_set(const net_cfg_t *p_cfg);
/*
* 函数功能:回写芯片实际 MAC(影子区,供 UI 显示)
* 入口参数:p_mac - 芯片读回的实际 MAC(不可为 NULL) const uint8_t *
* 返回值:无
* 限定条件:net_init 成功后由 netTask 上下文调用
* 函数说明:CH395F SPI 归 netTask 独占(中断/轮询集中处理);UI 页不可直接
* 调 SPI 读命令,故 netTask 初始化后读回实际 MAC 存于此供
* "网口设置"页显示(存储 MAC 全零时显示芯片内置 MAC)
*/
void net_cfg_set_active_mac(const uint8_t *p_mac);
/*
* 函数功能:取显示用 MAC
* 入口参数:p_out - 6 字节输出缓冲(不可为 NULL) uint8_t *
* 返回值:无
* 限定条件:p_out 非空
* 函数说明:存储 MAC 非全零 → 存储值;否则芯片实际(已回写时);
* 否则全零(网络未初始化/芯片内置未知)
*/
void net_cfg_get_mac(uint8_t *p_out);
/*
* 函数功能:4 字节 IPv4 格式化为点分十进制字符串(每段 3 位补零)
* 入口参数:p_ip - 4 字节 IP(不可为 NULL) const uint8_t *
* p_buf - 输出缓冲(不可为 NULL) char *
* len - 缓冲长度 size_t
* 返回值:无
* 限定条件:p_ip/p_buf 非空;len ≥ 16(输出 11 字符 + '\0')
* 函数说明:"192.168.001.100"——每段 3 位补零使字符串定长,UI 编辑光标
* 可按固定偏移(4i/3i 起始)定位字节;net_init 的 parse_ip_string
* 对前导零兼容(十进制逐段解析)
*/
void net_cfg_fmt_ipv4(const uint8_t *p_ip, char *p_buf, size_t len);
#ifdef __cplusplus
}
#endif
#endif /* NET_CFG_H */
+46
View File
@@ -0,0 +1,46 @@
/*
* 模块名称:Network Configuration Store (存储后端接口)
* 模块功能:net_cfg 加载/保存的磁盘读写抽象——每平台一份实现(互斥编译):
* MCU = NAND 上 FatFS 文件 /cfg/netcfg.bin(net_cfg_store_mcu.c);
* 模拟器 = 工作目录本地文件 sim_netcfg.bin(net_cfg_store_sim.c)
* 适用平台:STM32F407ZGTx / PC 模拟器(接口共用;两端各编一份实现)
* 作者:王建锋
* 创建日期:2026-09-10
* 修改记录:
* v1.0 2026-09-10 王建锋 创建初始版本
*/
#ifndef NET_CFG_STORE_H
#define NET_CFG_STORE_H
#include <stdint.h>
#include <stddef.h>
#ifdef __cplusplus
extern "C" {
#endif
/*
* 函数功能:读取配置文件
* 入口参数:p_buf - 接收缓冲(不可为 NULL) uint8_t *
* len - 文件长度(须与磁盘格式一致,net_cfg.c 的 net_cfg_blob_t) size_t
* 返回值:0 - 成功;-1 - 文件缺失/读失败 int
* 限定条件:后端存储可用(MCU:FatFS 已挂载;未挂载时实现直接返回 -1 即可)
*/
int net_cfg_store_read(uint8_t *p_buf, size_t len);
/*
* 函数功能:写配置文件(不存在则创建,存在则覆盖)
* 入口参数:p_buf - 待写数据(不可为 NULL) const uint8_t *
* len - 数据长度(须与磁盘格式一致) size_t
* 返回值:0 - 成功;-1 - 写失败 int
* 限定条件:后端存储可用
*/
int net_cfg_store_write(const uint8_t *p_buf, size_t len);
#ifdef __cplusplus
}
#endif
#endif /* NET_CFG_STORE_H */
+71
View File
@@ -0,0 +1,71 @@
/*
* 模块名称:Network Configuration Store (MCU 后端)
* 模块功能:net_cfg 存储后端——NAND 上 FatFS 文件 /cfg/netcfg.bin
* (目录 /cfg 首次写入时自动创建;卷由 defaultTask 挂载并广播
* SYS_EVT_STORAGE_READY 后方可读写)
* 适用平台:STM32F407ZGTx
* 作者:王建锋
* 创建日期:2026-09-10
* 修改记录:
* v1.0 2026-09-10 王建锋 创建初始版本
*/
/* 头文件包含区 */
#include "net_cfg_store.h"
#include "ff.h"
/* 静态变量定义区 */
static const char s_path[] = "/cfg/netcfg.bin";
/* 函数定义区 */
/*
* 函数功能:读取配置文件
* 入口参数:p_buf - 接收缓冲(不可为 NULL) uint8_t *
* len - 文件长度 size_t
* 返回值:0 - 成功;-1 - 文件缺失/读失败 int
* 限定条件:FatFS 已挂载(未挂载时 f_open 返回 FR_NO_SYSTEM,转 -1)
*/
int net_cfg_store_read(uint8_t *p_buf, size_t len) {
FIL f;
FRESULT fr;
UINT br = 0u;
if (p_buf == NULL) {
return -1;
}
fr = f_open(&f, s_path, FA_READ);
if (fr != FR_OK) {
return -1;
}
fr = f_read(&f, p_buf, (UINT)len, &br);
(void)f_close(&f);
return (fr == FR_OK && br == (UINT)len) ? 0 : -1;
}
/*
* 函数功能:写配置文件(目录不存在则创建;文件覆盖写)
* 入口参数:p_buf - 待写数据(不可为 NULL) const uint8_t *
* len - 数据长度 size_t
* 返回值:0 - 成功;-1 - 写失败 int
* 限定条件:FatFS 已挂载
*/
int net_cfg_store_write(const uint8_t *p_buf, size_t len) {
FIL f;
FRESULT fr;
UINT bw = 0u;
if (p_buf == NULL) {
return -1;
}
(void)f_mkdir("/cfg"); /* 目录已存在(FR_EXIST)不影响后续建文件 */
fr = f_open(&f, s_path, FA_WRITE | FA_CREATE_ALWAYS);
if (fr != FR_OK) {
return -1;
}
fr = f_write(&f, (const void *)p_buf, (UINT)len, &bw);
(void)f_close(&f);
return (fr == FR_OK && bw == (UINT)len) ? 0 : -1;
}
+67
View File
@@ -0,0 +1,67 @@
/*
* 模块名称:Network Configuration Store (模拟器后端)
* 模块功能:net_cfg 存储后端——模拟器工作目录本地文件 sim_netcfg.bin
* (磁盘格式与 MCU 端一致,两端可互读)
* 适用平台:PC 模拟器
* 作者:王建锋
* 创建日期:2026-09-10
* 修改记录:
* v1.0 2026-09-10 王建锋 创建初始版本
*/
/* 头文件包含区 */
#include <stdio.h>
#include "net_cfg_store.h"
/* 静态变量定义区 */
static const char s_path[] = "sim_netcfg.bin";
/* 函数定义区 */
/*
* 函数功能:读取配置文件
* 入口参数:p_buf - 接收缓冲(不可为 NULL) uint8_t *
* len - 文件长度 size_t
* 返回值:0 - 成功;-1 - 文件缺失/读失败 int
* 限定条件:无
*/
int net_cfg_store_read(uint8_t *p_buf, size_t len) {
FILE *fp;
size_t n;
if (p_buf == NULL) {
return -1;
}
fp = fopen(s_path, "rb");
if (fp == NULL) {
return -1;
}
n = fread(p_buf, 1u, len, fp);
fclose(fp);
return (n == len) ? 0 : -1;
}
/*
* 函数功能:写配置文件(不存在则创建,存在则覆盖)
* 入口参数:p_buf - 待写数据(不可为 NULL) const uint8_t *
* len - 数据长度 size_t
* 返回值:0 - 成功;-1 - 写失败 int
* 限定条件:无
*/
int net_cfg_store_write(const uint8_t *p_buf, size_t len) {
FILE *fp;
size_t n;
if (p_buf == NULL) {
return -1;
}
fp = fopen(s_path, "wb");
if (fp == NULL) {
return -1;
}
n = fwrite(p_buf, 1u, len, fp);
fclose(fp);
return (n == len) ? 0 : -1;
}