ARCHITECTURE.md: 顶部新增每次下载Boot前必查配置项(版本/项目、CAT1服务器/Lora、默认通道)

2026-09-02 10:08:15 +08:00
parent 46e5d0a4bd
commit 3372a9b71a
1 changed files with 52 additions and 0 deletions
@@ -1,5 +1,57 @@
 # HC32F460 BootLoader 项目架构与工作流程分析
 > ## ⚠️ 每次下载 Boot 前必查配置项
 >
 > 以下配置集中在 **`source/User/Inc/bsp.h`**，每次重新下载 Boot 程序前必须核对，
 > 修改后 **需重新编译并烧录**，配置会由 Boot 首次运行时自动写入 Flash 参数区。
 >
 > ### ① 当前设备版本 / 项目选择（决定本机 MAC 编码，bsp.h:62-64）
 >
 > ```c
 > #define GATEWAY_VER_INFO   GATEWAY_VER1_0        // 版本信息 → Mac[0](Bit7固定1)
 > #define GATEWAY_PRJ_NUM    GATEWAY_PRJ_YAXIA     // 项目编号 → Mac[1:3]（枚举见 bsp.h:17-26）
 > #define GATEWAY_GW_NUM     0x0000                // 网关编号 → Mac[4:5]（1~65535，按设备唯一分配）
 > ```
 >
 > | 项 | 当前值 | 影响 |
 > | --- | --- | --- |
 > | GATEWAY_VER_INFO | GATEWAY_VER1_0 | 写入 MAC[0]，标识网关软件版本 |
 > | GATEWAY_PRJ_NUM | GATEWAY_PRJ_YAXIA | 写入 MAC[1:3]，标识所属项目（换项目必改） |
 > | GATEWAY_GW_NUM | 0x0000 | 写入 MAC[4:5]，每台设备必须唯一（按网关编号分配） |
 >
 > ### ② CAT1 服务器 / Lora 配置（bsp.h:67-73）
 >
 > ```c
 > #define GATEWAY_SVR_ADDR0  39        // 服务器 IP[0]
 > #define GATEWAY_SVR_ADDR1  106       // 服务器 IP[1]
 > #define GATEWAY_SVR_ADDR2  103       // 服务器 IP[2]
 > #define GATEWAY_SVR_ADDR3  147       // 服务器 IP[3]
 > #define GATEWAY_SVR_PORT   8080      // 服务器端口
 > #define GATEWAY_LORA_FREQ  CH3       // Lora 中心频率（CH0~CH45，470.1MHz~492.6MHz）
 > ```
 >
 > | 项 | 当前值 | 说明 |
 > | --- | --- | --- |
 > | 服务器 IP | 39.106.103.147 | CAT1 上传的默认服务器地址 |
 > | 服务器端口 | 8080 | CAT1 上传的默认端口 |
 > | GATEWAY_LORA_FREQ | CH3 | Lora 中心频率，按现场干扰/组网需要从 CH0~CH45 中选择 |
 >
 > ### ③ 默认通道配置（bsp.h:76-79）
 >
 > ```c
 > #define GATEWAY_MUCH        CH_ETH      // 主上传通道
 > #define GATEWAY_AUCH        CH_NULL     // 辅助上传通道（-1 = 无）
 > #define GATEWAY_DUCH        CH_CAT1     // 调试/升级通道
 > #define GATEWAY_CUCH_MASK   CUCH_LORA   // 通讯单元通道掩码
 > ```
 >
 > | 项 | 当前值 | 说明 |
 > | --- | --- | --- |
 > | GATEWAY_MUCH | CH_ETH | 主上传通道：CH_DBG/CH_RS485_1/CH_RS485_2/CH_ETH/CH_LORA/CH_CAT1 |
 > | GATEWAY_AUCH | CH_NULL | 辅助上传通道，-1 表示不使用 |
 > | GATEWAY_DUCH | CH_CAT1 | 调试/升级通道 |
 > | GATEWAY_CUCH_MASK | CUCH_LORA | 通讯单元通道掩码，可多通道按位或（CUCH_CH1/CUCH_CH2/CUCH_ETH/CUCH_LORA/CUCH_CAT1） |
 ## 1. 项目概述
 基于华大半导体 HC32F460KETA (Cortex-M4F) 的 BootLoader 程序，实现通过 RS485 串口对 APP 应用程序进行在线升级。升级协议遵循《传感器通用串口升级协议 V1.1》。