101 lines
3.6 KiB
C
101 lines
3.6 KiB
C
/*
|
||
* ota_relay.h - OTA 中继核心状态机
|
||
* T2.3, T3.1 - T3.7
|
||
*/
|
||
#ifndef OTA_RELAY_H
|
||
#define OTA_RELAY_H
|
||
|
||
#include <stdint.h>
|
||
#include "freertos/FreeRTOS.h"
|
||
#include "freertos/queue.h"
|
||
|
||
// T4.3: OTA 元数据结构，用于 Flash 存储
|
||
#define META_FILE "/spiffs/ota_meta.json"
|
||
|
||
typedef struct {
|
||
uint32_t total_size; // 固件总大小（字节）
|
||
uint32_t stored_size; // 当前已存储大小（字节）
|
||
uint32_t last_seq; // 最后成功存储的序列号
|
||
uint32_t chunk_count; // 预期总块数
|
||
uint8_t checksum[32]; // 固件 SHA256 校验（可选）
|
||
} ota_meta_t;
|
||
|
||
// OTA 中继状态（对应 GD32 四阶段协议）
|
||
typedef enum {
|
||
// 阶段0: 空闲
|
||
RELAY_IDLE = 0,
|
||
|
||
// 阶段1: 安全握手
|
||
RELAY_HANDSHAKE_IDLE, // 等待 HANDSHAKE_REQ
|
||
RELAY_HANDSHAKE_SENT, // 已发送 0x00 AC，等待 GD32 响应
|
||
RELAY_CHALLENGE_SENT, // 已发送 nonce_server (16B)，等待响应
|
||
RELAY_CHALLENGE_RESPOND, // 已收到 GD32 握手数据包
|
||
RELAY_SESSION_KEY_SENT, // 已发送变换后的随机数，等待 0xBA C0
|
||
RELAY_AUTH_COMPLETE, // 已收到 0xBA C0，安全通道建立完成
|
||
|
||
// 阶段2: 传输准备
|
||
RELAY_SIZE_SENT, // 已发送固件大小（4B LE）
|
||
RELAY_SIZE_ACK, // 已收到 0xBA C0 + seq
|
||
|
||
// 阶段3: 数据传输
|
||
RELAY_RECEIVING, // 接收并存储固件到 Flash
|
||
RELAY_RELAY_ACTIVE, // 存储完成，开始向 GD32 转发
|
||
RELAY_PACKET_SENT, // 已发送 DATA_PACKET，等待 GD32 ACK
|
||
RELAY_PACKET_ACK_OK, // ACK 正常，继续下一包
|
||
RELAY_PACKET_ACK_RETRY, // ACK 要求重发，重新发送当前包
|
||
RELAY_RECEIVE_DONE, // 已发送 DATA_END，等待 TRANSFER_DONE
|
||
|
||
// 阶段4: 结束跳转
|
||
RELAY_TRANSFER_DONE, // 已收到 0xBA C0 + FF FF FF FF
|
||
RELAY_FINISH_SENT, // 已发送 0x0A AC，等待 GD32 确认
|
||
RELAY_DONE, // GD32 回复 0x0A AC，OTA 完成
|
||
|
||
// 错误状态
|
||
RELAY_ERROR = 0xFF
|
||
} relay_state_t;
|
||
|
||
// OTA 结果码
|
||
typedef enum {
|
||
OTA_RESULT_OK = 0,
|
||
OTA_RESULT_ERR_TIMEOUT = -1, // GD32 超时无响应
|
||
OTA_RESULT_ERR_CRC = -2, // CRC 校验失败
|
||
OTA_RESULT_ERR_AUTH = -3, // 认证失败
|
||
OTA_RESULT_ERR_STORAGE = -4, // Flash 存储错误
|
||
OTA_RESULT_ERR_GD32 = -5, // GD32 返回错误
|
||
OTA_RESULT_ERR_HEALTH = -6, // 健康状态异常中止
|
||
OTA_RESULT_ERR_USER_ABORT = -7 // 用户中止
|
||
} ota_result_t;
|
||
|
||
// 外部队列句柄（在 app_main 中创建）
|
||
extern QueueHandle_t g_ota_dispatch_queue; // 从 WiFi/BLE 到 OTA 中继
|
||
extern QueueHandle_t g_ota_result_queue; // OTA 结果到 WiFi/BLE
|
||
|
||
// OTA 中继任务入口
|
||
void ota_relay_task(void *pvParameters);
|
||
|
||
// T2.3: 发起与 GD32 的握手
|
||
ota_result_t ota_relay_start_handshake(void);
|
||
|
||
// T3.4: 从 Flash 向 GD32 转发存储的固件（48B/包）
|
||
ota_result_t ota_relay_forward_firmware(void);
|
||
|
||
// T3.7: 获取当前中继状态
|
||
relay_state_t ota_relay_get_state(void);
|
||
|
||
// T3.7: 重置中继状态机
|
||
void ota_relay_reset(void);
|
||
|
||
// T4.2: Flash 写入接口
|
||
esp_err_t flash_write_chunk(uint32_t offset, const uint8_t *data, size_t len);
|
||
esp_err_t flash_read_chunk(uint32_t offset, uint8_t *data, size_t len);
|
||
|
||
// T3.3: 元数据文件管理
|
||
esp_err_t meta_load(ota_meta_t *meta);
|
||
esp_err_t meta_save(const ota_meta_t *meta);
|
||
esp_err_t meta_update(uint32_t stored_size, uint32_t last_seq);
|
||
esp_err_t meta_clear(void);
|
||
|
||
// 当前中继状态（供健康监控外部访问）
|
||
extern relay_state_t g_relay_state;
|
||
|
||
#endif // OTA_RELAY_H
|