network: 台架 IP 迁到 192.168.31.100，并把重复写死的值收进单一真源
分两段（用户裁定 2026-11-02）：先做地址迁移，再把同类字面量收敛成
单一真源，以后再改地址只动一处。
一、IP 迁移 192.168.1.100 → 192.168.31.100（gw 同步 → .31.1）
- 工厂默认：Drivers/BSP/NETCFG/net_cfg.c 的 NET_CFG_DEF_IP/_GW
- 注释/文档示例、主机与板级测试、台架 py 脚本、两份 sim_config.ini
- 字节序教学点同步换算 hex：0x6401A8C0 → 0x641FA8C0（内存
C0 A8 1F 64），旧版示例引文与历史 Trap 记录按冻结纪律不动
- UI 黄金基准：网口设置 4 态 + shot_info 共 5 张 .bin 由
check_content_pages.py --update 重刷（渲染值 IP 变了，属预期变更）
- 保留判定：客户点表引用（IEC104/继电保护规划）、芯片手册摘录、
日期冻结的变更记录行、已退役台架档案 MDK-ARM/retracted_bench_*
二、单一真源收口（A+B+C+D，用户批准全做）
- 新建 test/host/bench_defaults.py：台架 py 默认值唯一定义点
（DEVICE_IP/DEVICE_GW/PC_IP/NET_BCAST），22 个脚本改为引用；
MDK-ARM 两探针与 scripts/board_ui_nav.py 经 sys.path shim 引入
- test/board/net_test_task.h 新增 TEST_PC_PEER_IP，板测三处
PHASE*_REMOTE_IP 改引该宏（保留 -D 覆盖）；Phase1 断言改
memcmp 数组比较，数组各只出现一次
- simulator/tests/check_content_pages.py 从 net_cfg.c 正则解析
NET_CFG_DEF_* 推导期望值（解析失败即报错、不静默兜底），
脚本内台架 IP 字面量清零
- 装饰性注释去具体值（net_cfg.h/net_socket.h/net_socket.c/
net_socket_sim.c）；字节序教学 hex 对刻意保留为唯一写值点
- 刻意不动：主机单测夹具 IP（逐文件钉住的任意值是正确测试
实践）、文档正文 IP（那是文档内容本身）
顺带：scripts/gen_task_table.py 规范串清掉「，B5」——编号清退提交
72b4b094 改了受管区没重跑生成器，task-table 门禁因此一直红
验证：产品 @build 0/0；CH395F 套件开关构建 0/0 后还原产品态；
6 套主机单测 rc=0；content_pages（含宏推导路径）/菜单 8 态/
推流位比对全 PASS；bom-drift 99 无漂移；doc-links/coding-standard/
cppcheck 绿；py_compile 23 文件 + --help 冒烟（含 shim 绝对路径）
This commit is contained in:
@@ -268,9 +268,9 @@ static bool s_mac_is_zero(const uint8_t *p_mac) {
|
||||
|
||||
/*
|
||||
* 函数功能：网络子系统初始化（配置 CH395F + 启用多连接模式）
|
||||
* 入口参数：ip - IP 地址字符串 "192.168.1.100"，NULL 使用 DHCP 自动获取 const char *
|
||||
* mask - 子网掩码字符串 "255.255.255.0"，NULL 使用默认值 const char *
|
||||
* gateway - 网关地址字符串 "192.168.1.1"，NULL 使用默认值 const char *
|
||||
* 入口参数：ip - IP 地址字符串（点分十进制），NULL 使用 DHCP 自动获取 const char *
|
||||
* mask - 子网掩码字符串，NULL 使用默认值 const char *
|
||||
* gateway - 网关地址字符串，NULL 使用默认值 const char *
|
||||
* mac - MAC 地址（6 字节，低字节在前），NULL/全零使用芯片内置 const uint8_t *
|
||||
* 返回值：0 - 初始化成功 int
|
||||
* -1 - 初始化失败（芯片检测/复位/协议栈初始化失败） int
|
||||
@@ -2930,7 +2930,7 @@ int net_sock_state(int sockfd) {
|
||||
|
||||
/*
|
||||
* 函数功能：将点分十进制 IP 地址字符串转换为网络字节序的 32 位地址
|
||||
* 入口参数：cp - 点分十进制 IP 字符串（如 "192.168.1.100"） const char *
|
||||
* 入口参数：cp - 点分十进制 IP 字符串 const char *
|
||||
* 出口参数：无
|
||||
* 返回值：网络字节序的 32 位 IP 地址（0 表示参数无效） uint32_t
|
||||
* 限定条件：无
|
||||
@@ -2939,9 +2939,9 @@ int net_sock_state(int sockfd) {
|
||||
* 本文件内 s_addr 只有这一族（2026-10-24：两套 IP 字节序约定统一为 POSIX 网络序）：net_inet_ntoa 的
|
||||
* 「先 NTOHL、再高段在前」正是本函数的解析逆运算；net_getsockname、
|
||||
* net_getpeername、net_recvfrom 填的 s_addr 也同族，故三者可直接相等比较。
|
||||
* 2. 小端主机（STM32F407 与 PC 模拟器均是）上 "192.168.1.100" 的数值为
|
||||
* 0x6401A8C0（内存字节 C0 A8 01 64）。旧实现在小端累加后又多做一次
|
||||
* HTONL，得到 0xC0A80164，与 ntoa 不互逆——那是同一文件里的第二套约定，
|
||||
* 2. 小端主机（STM32F407 与 PC 模拟器均是）上 "192.168.31.100" 的数值为
|
||||
* 0x641FA8C0（内存字节 C0 A8 1F 64）。旧实现在小端累加后又多做一次
|
||||
* HTONL，得到 0xC0A81F64，与 ntoa 不互逆——那是同一文件里的第二套约定，
|
||||
* 已连同其消费者（connect/sendto 的 des_ip 拆装）一起改为本族。
|
||||
* 3. 段值超过 255 时按低 8 位截断（旧实现会把溢出位溅进相邻段，更不可预期）；
|
||||
* 非法字符仍按 0 处理，失败返回值维持 0，不改 NET_INADDR_NONE 的语义。
|
||||
@@ -2988,9 +2988,9 @@ uint32_t net_inet_addr(const char *cp) {
|
||||
* 函数说明：1. 先经 NET_NTOHL 转为主机字节序再格式化输出
|
||||
* 2. ⚠ 段序（E13 定案 修复）：NTOHL 后主机序数值的高字节才是
|
||||
* 点分第一段。**入参必须是网络序整数**（&addr 的第 0 字节 = 第一段，
|
||||
* 小端上 192.168.1.100 = 0x6401A8C0，见 net_inet_addr 的约定说明），
|
||||
* 于是 0x6401A8C0 → NTOHL → 0xC0A80164 → 高字节 0xC0 = 192 首段 ✓。
|
||||
* 原实现低段在前，同一入参会显示成字节反转的 "100.1.168.192"。
|
||||
* 小端上 192.168.31.100 = 0x641FA8C0，见 net_inet_addr 的约定说明），
|
||||
* 于是 0x641FA8C0 → NTOHL → 0xC0A81F64 → 高字节 0xC0 = 192 首段 ✓。
|
||||
* 原实现低段在前，同一入参会显示成字节反转的 "100.31.168.192"。
|
||||
* 3. ⚠ 本注释旧版举的例子写成「192.168.1.100 → 0xC0A80164 → 同串」，
|
||||
* 那个 0xC0A80164 取的是**已废弃的另一族**（当时 net_inet_addr 的返回
|
||||
* 值），按本函数的真实算法它打印出来恰是 "100.1.168.192"。两套 s_addr
|
||||
@@ -3100,7 +3100,7 @@ static int alloc_socket(void) {
|
||||
|
||||
/*
|
||||
* 函数功能：将点分十进制 IP 地址字符串解析为 4 字节数组
|
||||
* 入口参数：str - 点分十进制 IP 字符串（如 "192.168.1.100"） const char *
|
||||
* 入口参数：str - 点分十进制 IP 字符串 const char *
|
||||
* ip_arr - 输出：4 字节 IP 数组（网络序，低字节在前） uint8_t *
|
||||
* 出口参数：ip_arr - 填充解析后的 IP 地址
|
||||
* 返回值：无
|
||||
|
||||
@@ -85,9 +85,9 @@ int net_msg_queue_adopt(osMessageQueueId_t queue_id);
|
||||
|
||||
/*
|
||||
* 函数功能：网络子系统初始化（配置 CH395F + 启用多连接模式）
|
||||
* 入口参数：ip - 本地 IP 地址字符串 "192.168.1.100"，NULL 使用 DHCP
|
||||
* mask - 子网掩码字符串 "255.255.255.0"，NULL 使用默认
|
||||
* gateway - 网关地址字符串 "192.168.1.1"，NULL 使用默认
|
||||
* 入口参数：ip - 本地 IP 地址字符串（点分十进制），NULL 使用 DHCP
|
||||
* mask - 子网掩码字符串，NULL 使用默认
|
||||
* gateway - 网关地址字符串，NULL 使用默认
|
||||
* mac - MAC 地址（6 字节，低字节在前），NULL 或全零使用芯片内置
|
||||
* 返回值：0 成功，-1 失败
|
||||
* 限定条件：SPI2 已正确初始化
|
||||
@@ -465,14 +465,14 @@ int net_sock_state(int sockfd);
|
||||
|
||||
/*
|
||||
* 函数功能：将 IP 地址字符串转为网络字节序
|
||||
* 入口参数：cp - 点分十进制字符串 "192.168.1.100"
|
||||
* 入口参数：cp - 点分十进制字符串
|
||||
* 返回值：网络字节序 IP，失败返回 0
|
||||
* 限定条件：cp 指针非空
|
||||
* 函数说明：不支持域名解析
|
||||
*
|
||||
* s_addr 的**唯一约定**（2026-10-24 定案：两套 IP 字节序约定统一为 POSIX 网络序；全仓只此一族，勿再引入第二套）：
|
||||
* 网络字节序整数 —— &s_addr 的第 0 个内存字节 == 点分第一段。
|
||||
* 小端主机（STM32F407 与 PC 模拟器都是）上 "192.168.1.100" 的数值 = 0x6401A8C0。
|
||||
* 小端主机（STM32F407 与 PC 模拟器都是）上 "192.168.31.100" 的数值 = 0x641FA8C0。
|
||||
* 与 net_inet_ntoa 互为逆运算；net_getsockname / net_getpeername / net_recvfrom
|
||||
* 填出来的 s_addr、以及 net_bind / net_connect / net_sendto 收进去的 s_addr
|
||||
* 全在同一族，故可直接做相等比较（旧实现里 inet_addr 与其余四个不互逆，
|
||||
|
||||
@@ -41,9 +41,9 @@
|
||||
/* 私有宏定义区 */
|
||||
|
||||
/* 工厂默认值（单一来源：s_cfg 初值与 s_defaults 共用，避免两处漂移） */
|
||||
#define NET_CFG_DEF_IP { 192u, 168u, 1u, 100u }
|
||||
#define NET_CFG_DEF_IP { 192u, 168u, 31u, 100u }
|
||||
#define NET_CFG_DEF_MASK { 255u, 255u, 255u, 0u }
|
||||
#define NET_CFG_DEF_GW { 192u, 168u, 1u, 1u }
|
||||
#define NET_CFG_DEF_GW { 192u, 168u, 31u, 1u }
|
||||
#define NET_CFG_DEF_MAC { 0u, 0u, 0u, 0u, 0u, 0u }
|
||||
|
||||
/* 静态变量定义区 */
|
||||
|
||||
@@ -36,9 +36,9 @@ extern "C" {
|
||||
* 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 ip[4]; /* IP 地址（工厂默认 = net_cfg.c 的 NET_CFG_DEF_IP） */
|
||||
uint8_t mask[4]; /* 子网掩码（工厂默认 = net_cfg.c 的 NET_CFG_DEF_MASK） */
|
||||
uint8_t gw[4]; /* 默认网关（工厂默认 = net_cfg.c 的 NET_CFG_DEF_GW） */
|
||||
uint8_t mac[6]; /* MAC 地址（全零 = 芯片内置 MAC） */
|
||||
} net_cfg_t;
|
||||
|
||||
|
||||
Reference in New Issue
Block a user