ESP32_COMM/main/include/app_config.h

/*
 * app_config.h - 统一配置文件（C++ 版本）
 * ESP32-C3 OTA 中继项目
 *
 * 使用 constexpr 代替 #define，提供类型安全
 * 版本号和编译时间由 version.h 自动生成
 */
#pragma once
#include <cstdint>
#include "freertos/FreeRTOS.h"
#include "version.h"

// ============================================================
// 功能开关（ESP32 本机；GD32 侧开关随 HELLO/PING 身份块上报，无需镜像）
// ============================================================
// 0 = AP 热点，1 = STA 连路由器
inline constexpr uint8_t CONFIG_WIFI_MODE = 1;

// ============================================================
// 固件版本（由 version.h 自动生成，此处提供 C++ constexpr 访问）
// ============================================================
inline constexpr const char *FW_VERSION = FW_VERSION_STRING;     ///< 固件版本字符串（自动生成）
inline constexpr const char *FW_BUILD_TIME = BUILD_TIME;         ///< 编译时间字符串（自动生成）
inline constexpr const char *FW_GIT_HASH = GIT_HASH;             ///< Git 提交哈希（自动生成）

// ============================================================
// WiFi STA 模式配置（连接路由器）
// ============================================================
inline constexpr const char* WIFI_STA_SSID = "004舰桥";            ///< STA 模式目标 WiFi 名称
inline constexpr const char* WIFI_STA_PASSWORD = "q13362875622";   ///< STA 模式 WiFi 密码
inline constexpr uint32_t WIFI_STA_CONNECT_TIMEOUT_MS = 30000;     ///< STA 连接超时（毫秒）
inline constexpr uint8_t  WIFI_STA_MAX_RETRY = 5;  // 最大重连次数，超过后切换 AP 模式

// ============================================================
// WiFi AP 模式配置（设备当热点）
// ============================================================
inline constexpr const char* WIFI_AP_SSID     = "ESP32_OTA_RELAY"; ///< AP 模式热点名称
inline constexpr const char* WIFI_AP_PASSWORD = "12345678";        ///< AP 模式热点密码
inline constexpr uint8_t     WIFI_AP_CHANNEL = 6;                  ///< AP 模式工作信道
inline constexpr uint8_t     WIFI_AP_MAX_CONNECT = 4;              ///< AP 模式最大连接数

// ============================================================
// HTTP 服务器配置
// ============================================================
inline constexpr uint16_t HTTP_SERVER_PORT      = 80;              ///< HTTP 服务器监听端口

// ============================================================
// 任务栈大小（字节）— 2026-07 按板端 task_stack 水位收敛
// 规则：S ≈ peak_used + 1.5～2KB；偏松的收、偏紧的不砍。
// 板测峰值量级（常规/OTA）：
//   http~5.2KB, spi~1.9KB, wifi_ota~1.2KB, ble_ota~0.9KB,
//   ble_worker 1004B, health/cpu~1.8KB, ota_relay 轻载~1.3KB。
// 2026-07 余量优化：收 http/spi/wifi/ble* 偏松项，health/cpu/relay 保持。
// ============================================================
inline constexpr uint32_t HTTP_SERVER_STACK_SIZE   = 7168;  ///< httpd：peak~5.2KB + ~2KB → 7KB（原 8/10KB）
inline constexpr uint32_t TASK_STACK_WIFI_OTA      = 3072;  ///< wifi_ota：peak~1.2KB + ~1.8KB → 3KB（原 4/8KB）
inline constexpr uint32_t TASK_STACK_OTA_RELAY     = 2560;  ///< ota_relay：2.5KB（轻载 peak~1.3KB；转发突发不砍）
inline constexpr uint32_t TASK_STACK_SPI_WORKER    = 4096;  ///< spi_worker：peak~1.9KB + ~2KB → 4KB（原 5KB）
inline constexpr uint32_t TASK_STACK_BLE_OTA       = 2560;  ///< ble_ota：peak~0.9KB + ~1.5KB → 2.5KB（原 3KB）
inline constexpr uint32_t TASK_STACK_BLE_WORKER    = 2560;  ///< ble_ota_worker：peak 1004B + ~1.5KB → 2.5KB（原 3KB）
inline constexpr uint32_t TASK_STACK_HEALTH_MON    = 3072;  ///< health_mon：peak~1.8KB，余量~1.2KB，不砍
inline constexpr uint32_t TASK_STACK_CPU_STATS     = 3072;  ///< cpu_stats：peak~1.8KB，余量~1.2KB，不砍
inline constexpr uint32_t TASK_STACK_WIFI_RECONNECT = 2560; ///< wifi_reconnect：轻载，2.5KB 保持
inline constexpr uint32_t TASK_STACK_CAN_FB        = 3072;  ///< can_fb：被动 takeEvent(0xC1)
inline constexpr uint32_t TASK_STACK_BLE_FINISH    = 4096;  ///< 按需：SHA finalize（保持）
inline constexpr uint32_t TASK_STACK_BLE_GD32_WAIT = 3072;  ///< 按需：GD32 中继等待
inline constexpr uint32_t TASK_STACK_BLE_RESTART   = 2048;  ///< 按需：延时重启

// ============================================================
// OTA 配置
// ============================================================
inline constexpr size_t  OTA_BLOCK_SIZE         = 4096;            ///< 上传接收块：4KB（吞吐优先；s_ota_upload_recv 静态 +2KB vs 2KB 块）
// OTA_BLOCK_SIZE 演进：8KB→2KB(压堆)→4KB(试吞吐)→2KB(2026-07 回退)→4KB(2026-07-20 再提吞吐)。
inline constexpr size_t  OTA_MAX_FIRMWARE_SIZE  = 216 * 1024;  // 216KB = 221184B = 0x35F90，固件大小上限
inline constexpr size_t  GD32_OTA_PACKET_SIZE   = 48;          // GD32 OTA 实际转发包载荷

// ============================================================
// 健康监控阈值
// ============================================================
inline constexpr int32_t WIFI_RSSI_CRITICAL = -85;                 ///< WiFi 信号严重警告阈值（dBm）
inline constexpr int32_t WIFI_RSSI_WARNING  = -80;                 ///< WiFi 信号一般警告阈值（dBm）
inline constexpr int32_t OTA_WIFI_RSSI_CRITICAL = -88;             ///< OTA 传输期间 WiFi 信号临界阈值
inline constexpr uint32_t OTA_WIFI_RSSI_SAMPLE_MAX_AGE_MS = 15000; ///< RSSI 采样最大有效期（毫秒）
inline constexpr uint32_t OTA_PACKET_HEALTH_CHECK_INTERVAL = 32;   ///< 每 N 包执行一次健康检查
inline constexpr int32_t TEMP_WARNING       = 80;                  ///< 芯片温度警告阈值（℃）
inline constexpr int32_t TEMP_CRITICAL      = 100;                 ///< 芯片温度严重警告阈值（℃）
inline constexpr size_t  HEAP_WARNING_MIN   = 10240;               ///< 堆内存警告阈值（字节）

// ============================================================
// 调试配置（UDP 日志）
// GD32 ADC/CAN 等开关：看 HELLO_ACK/PING 身份块 feat 位（GD32 config 顶部）
// ============================================================
inline constexpr const char* DEBUG_LOG_IP   = "192.168.31.3";      ///< UDP 日志目标 IP
inline constexpr uint16_t DEBUG_LOG_PORT   = 6666;                 ///< UDP 日志目标端口

// ============================================================
// SPI 主机（ESP32 ↔ GD32）可调参数
// 协议帧格式见 spi_link_v2.h；引脚与超时集中在此便于板级调整
// ============================================================
inline constexpr int      SPI_MASTER_CS_GPIO     = 4;     ///< CS 片选 GPIO
inline constexpr int      SPI_READY_GPIO         = 10;    ///< DATA_READY 通知线 GPIO（↔ GD32 PB6）
inline constexpr int      SPI_MODE               = 0;     ///< CPOL=0 CPHA=0
inline constexpr int      SPI_QUEUE_SIZE         = 4;     ///< SPI 事务队列深度
inline constexpr size_t   SPI_OTA_FRAME_MAX      = 256;   ///< 单 CS 最大帧长（APP 满缓冲）
inline constexpr size_t   SPI_BOOT_TX_BUF_SIZE   = 128;   ///< BOOT TX DMA 满缓冲（读预算用）
inline constexpr size_t   SPI_APP_TX_BUF_SIZE    = 256;   ///< APP TX DMA 满缓冲（读预算用）

// ============================================================
// OTA 协调器
// ============================================================
inline constexpr uint32_t OTA_COORD_LOCK_TIMEOUT_MS   = 100;  ///< 协调器 mutex 超时（ms）
/** 忙状态自愈：须 > 中继转发预算上限（约 120s）+ 握手/SIZE 余量。 */
inline constexpr uint32_t OTA_COORD_BUSY_WATCHDOG_MS  = 150000;

// ============================================================
// BLE OTA 配置
// ============================================================
inline constexpr const char* BLE_DEVICE_NAME    = "ESP32-OTA-RELAY"; ///< BLE 广播设备名
inline constexpr uint16_t    BLE_MTU_SIZE       = 512;               ///< BLE MTU 协商大小
inline constexpr uint16_t    BLE_OTA_SERVICE_UUID = 0xFFFF;          ///< OTA GATT 服务 UUID
inline constexpr uint16_t    BLE_OTA_CTRL_UUID   = 0x0001;           ///< OTA 控制特征 UUID（写入命令）
inline constexpr uint16_t    BLE_OTA_DATA_IN_UUID  = 0x0002;         ///< OTA 数据输入特征 UUID（写固件包）
inline constexpr uint16_t    BLE_OTA_DATA_OUT_UUID = 0x0003;         ///< OTA 数据输出特征 UUID（通知/ACK）
inline constexpr uint16_t    BLE_OTA_VERSION_UUID  = 0x0004;         ///< OTA 版本信息特征 UUID（只读）
inline constexpr uint8_t BLE_OTA_CTRL_TRIGGER_GD32  = 0xF7;         ///< BLE 控制命令：触发 GD32 中继 OTA
inline constexpr uint8_t BLE_OTA_CTRL_TRIGGER_ESP32 = 0xF8;         ///< BLE 控制命令：触发 ESP32 本机 OTA
inline constexpr uint8_t BLE_OTA_CTRL_VERIFY_SHA256 = 0xF9;         ///< BLE 控制命令：SHA-256 哈希验证
inline constexpr uint8_t BLE_OTA_CTRL_RESTART_ESP32 = 0xFA;         ///< BLE 控制命令：重启 ESP32
inline constexpr uint8_t BLE_OTA_CTRL_ABORT_OTA     = 0xFB;         ///< BLE 控制命令：中止当前 OTA（不断开 BLE）
inline constexpr uint8_t BLE_OTA_CMD_GD32_DATA  = 0x00;             ///< BLE 数据通道：GD32 固件包标识
inline constexpr uint8_t BLE_OTA_CMD_ESP32_DATA = 0x01;             ///< BLE 数据通道：ESP32 固件包标识
inline constexpr size_t      BLE_OTA_CHUNK_PAYLOAD = 480;            ///< BLE 单包数据载荷大小（字节）
// 滑动 ACK 窗口（须与前端 tools/js/ble/constants.js BLE_OTA_ACK_WINDOW 保持一致）
// ★ 64：实测 Windows WebBT 窗口内单包间隔 0.4-2.9ms（2M PHY 多包/事件），
//        瓶颈在每窗口的 ACK 往返。窗口 32→64 提速 ~10%（40→44 KB/s），再试 96 无收益
//        （ACK 往返在 64 已摊薄，稳态瓶颈是 Windows GATT 每包 ~10.6ms resolve 延迟）。
//        内存：64×480B ≈ 30KB reorder buffer，分配失败有 fallback 丢弃策略兜底。
inline constexpr size_t      BLE_OTA_ACK_WINDOW = 64;
// Reorder buffer 窗口大小（吸收 BLE 窗口内乱序到达的包，须 >= BLE_OTA_ACK_WINDOW）
inline constexpr size_t      BLE_OTA_REORDER_WINDOW = 64;
// 数据队列深度：略大于窗口，seq=0 预擦期间多扛几批
inline constexpr size_t      BLE_OTA_DATA_QUEUE_LEN = (BLE_OTA_ACK_WINDOW * 2 + 16);

// ============================================================
// 安全常量（需与 GD32 固件团队确认）
// ⚠️ 请填入实际密钥
// ============================================================
inline constexpr uint8_t MASTER_KEY[] = {
    0x01, 0x23, 0x45, 0x67, 0x89, 0xAB, 0xCD, 0xEF,
    0xFE, 0xDC, 0xBA, 0x98, 0x76, 0x54, 0x32, 0x10
};

// SCRAMBLE_CONST 已移至 Protocol 类，运行时由硬件 RNG 随机生成
inline constexpr size_t SCRAMBLE_CONST_LEN = 16;

inline constexpr uint32_t DEVICE_SERIAL_ADDR_LSB = 0x1FFFF7E8U; ///< GD32 设备序列号低字 Flash 地址
inline constexpr uint32_t DEVICE_SERIAL_ADDR_MID = 0x1FFFF7ECU; ///< GD32 设备序列号中字 Flash 地址
inline constexpr uint32_t DEVICE_SERIAL_ADDR_MSB = 0x1FFFF7F0U; ///< GD32 设备序列号高字 Flash 地址