小龙虾
e014ca7704
- 更新固件版本从0.2.0到0.2.7 - 替换默认密钥为实际密钥值 - 添加GD32芯片UID运行时获取机制 - 实现AES-128加密验证challenge响应 - 集成NVS持久化存储OTA元数据 - 改进数据包传输可靠性，添加ACK确认和重试机制 - 新增结构化错误响应解析功能 - 实现GD32应用通知进入Bootloader流程 - 添加详细函数文档注释 refactor(ble): 优化BLE OTA服务端代码结构 - 为所有关键函数添加详细的Doxygen注释 - 改进固件大小验证逻辑，支持4字节对齐计算 - 优化数据块接收和处理流程
151 lines
5.6 KiB
C
151 lines
5.6 KiB
C
/*
|
|
* spi_master.h - SPI Master 驱动头文件
|
|
* CANFD 3通道发送接口 + 底层 SPI 总线
|
|
*/
|
|
#ifndef SPI_MASTER_H
|
|
#define SPI_MASTER_H
|
|
|
|
#include <stdint.h>
|
|
#include "driver/spi_master.h"
|
|
|
|
// SPI 配置常量
|
|
#define SPI_MASTER_CS_GPIO (4) // CS 片选引脚
|
|
#define SPI_CLOCK_HZ (4 * 1000 * 1000) // 4MHz
|
|
#define SPI_MODE (0) // CPOL=0, CPHA=0
|
|
#define SPI_QUEUE_SIZE (1)
|
|
#define SPI_OTA_FRAME_MAX (96)
|
|
|
|
// GD32 SPI OTA 帧类型
|
|
#define SPI_OTA_SOF (0xA5)
|
|
#define SPI_OTA_CMD_REQ (0x01)
|
|
#define SPI_OTA_CMD_DATA (0x02)
|
|
#define SPI_OTA_CMD_CANCEL (0x03)
|
|
#define SPI_APP_ENTER_BOOT_CMD (0xB0)
|
|
#define SPI_APP_ENTER_BOOT_ACK_OK (0xA5)
|
|
#define SPI_OTA_RSP_ACK (0x80)
|
|
#define SPI_OTA_RSP_WAIT (0x81)
|
|
#define SPI_OTA_RSP_ERROR (0x82)
|
|
|
|
// SPI 设备句柄（外部引用）
|
|
extern spi_device_handle_t g_spi_device;
|
|
|
|
// ============================================================
|
|
// CANFD 帧格式（3通道）
|
|
// [通道编号: 1B] [扩展帧ID: 4B BE] [数据: 1~64B]
|
|
// 长度自动识别，无需发送 DLC
|
|
// ============================================================
|
|
#define CAN_EXTENDED_ID_BITS (29) // CAN 扩展帧 ID 位数
|
|
#define CAN_MAX_DLC (64) // 最大数据长度
|
|
#define CAN_CHANNEL_MASK (0x03) // 通道号掩码 (0~2)
|
|
|
|
// 通道定义
|
|
typedef enum {
|
|
CAN_CHANNEL_0 = 0,
|
|
CAN_CHANNEL_1 = 1,
|
|
CAN_CHANNEL_2 = 2,
|
|
CAN_CHANNEL_MAX = 3,
|
|
} can_channel_t;
|
|
|
|
// CANFD 帧结构
|
|
typedef struct {
|
|
can_channel_t channel; // CAN 通道 (0~2)
|
|
uint32_t ext_id; // 扩展帧 ID (29bit, Big-Endian 存储)
|
|
uint8_t data[CAN_MAX_DLC]; // CAN 数据负载 (最大 64 字节)
|
|
uint8_t dlc; // 数据长度 (1~64)
|
|
} can_frame_t;
|
|
|
|
/**
|
|
* @brief 发送一帧 CANFD 数据，可选等待并读取响应内容。
|
|
* @param channel CAN 通道（0~2）。
|
|
* @param ext_id 29 位扩展帧 ID。
|
|
* @param data 数据负载指针。
|
|
* @param dlc 数据长度，范围 1~64。
|
|
* @param recv_buf 接收缓冲区，可为 NULL。
|
|
* @param recv_max 期望最大接收字节数。
|
|
* @param timeout_ms 超时时间（毫秒）。
|
|
* @return >= 0 接收字节数，< 0 失败。
|
|
*/
|
|
int gd32_can_send(can_channel_t channel, uint32_t ext_id,
|
|
const uint8_t *data, uint8_t dlc,
|
|
uint8_t *recv_buf, uint8_t recv_max,
|
|
uint32_t timeout_ms);
|
|
|
|
/**
|
|
* @brief 发送一帧无需响应的 CANFD 数据，适合广播或通知场景。
|
|
* @param channel CAN 通道（0~2）。
|
|
* @param ext_id 29 位扩展帧 ID。
|
|
* @param data 数据负载指针。
|
|
* @param dlc 数据长度，范围 1~64。
|
|
* @return >= 0 成功，< 0 失败。
|
|
*/
|
|
int gd32_can_send_no_reply(can_channel_t channel, uint32_t ext_id,
|
|
const uint8_t *data, uint8_t dlc);
|
|
|
|
/**
|
|
* @brief 初始化 SPI2 总线与目标从设备。
|
|
* @return ESP_OK 成功，其他失败。
|
|
*/
|
|
esp_err_t spi_master_init(void);
|
|
|
|
/**
|
|
* @brief 执行一次同步 SPI 事务，先发送请求，再读取请求之后的响应字节。
|
|
* @param cmd SPI 命令码；为 0 时不额外插入命令字节。
|
|
* @param payload 发送数据指针。
|
|
* @param payload_len 发送数据长度。
|
|
* @param recv_buf 接收缓冲区，可为 NULL。
|
|
* @param recv_len 期望接收的响应长度。
|
|
* @param timeout_ms 超时时间（毫秒）。
|
|
* @return ESP_OK 成功，其他失败。
|
|
*/
|
|
esp_err_t spi_sync_transfer(uint8_t cmd, const uint8_t *payload,
|
|
size_t payload_len, uint8_t *recv_buf,
|
|
size_t recv_len, uint32_t timeout_ms);
|
|
|
|
/**
|
|
* @brief 仅发送 SPI 请求数据，不关心返回内容。
|
|
* @param cmd SPI 命令码；为 0 时仅发送 payload。
|
|
* @param payload 发送数据指针。
|
|
* @param len 发送数据长度。
|
|
* @return ESP_OK 成功，其他失败。
|
|
*/
|
|
esp_err_t spi_send(uint8_t cmd, const uint8_t *payload, size_t len);
|
|
|
|
/**
|
|
* @brief 仅接收 SPI 数据，必要时先发送命令字节，再发送哑数据产生时钟。
|
|
* @param cmd SPI 命令码；为 0 时只发送哑数据。
|
|
* @param recv_buf 接收缓冲区。
|
|
* @param len 接收长度。
|
|
* @param timeout_ms 超时时间（毫秒）。
|
|
* @return ESP_OK 成功，其他失败。
|
|
*/
|
|
esp_err_t spi_recv(uint8_t cmd, uint8_t *recv_buf, size_t len, uint32_t timeout_ms);
|
|
|
|
/**
|
|
* @brief 按 GD32 SPI OTA 最小协议执行一次请求事务 + 一次响应读取事务。
|
|
* @param type 请求帧类型（REQ/DATA/CANCEL）。
|
|
* @param payload 请求负载。
|
|
* @param payload_len 负载长度。
|
|
* @param resp_type 输出响应类型（ACK/WAIT/ERROR）。
|
|
* @param resp_payload 输出响应负载缓冲区。
|
|
* @param resp_max 输出响应负载最大长度。
|
|
* @param resp_len 输出实际响应负载长度。
|
|
* @param timeout_ms 超时。
|
|
*/
|
|
esp_err_t spi_ota_transfer(uint8_t type, const uint8_t *payload, size_t payload_len,
|
|
uint8_t *resp_type, uint8_t *resp_payload,
|
|
size_t resp_max, size_t *resp_len, uint32_t timeout_ms);
|
|
|
|
/**
|
|
* @brief 仅执行 SPI OTA 响应读取事务，不重复发送请求帧。
|
|
*/
|
|
esp_err_t spi_ota_poll_response(uint8_t *resp_type, uint8_t *resp_payload,
|
|
size_t resp_max, size_t *resp_len, uint32_t timeout_ms);
|
|
|
|
/**
|
|
* @brief 通知正在运行的 GD32 DCU_APP 设置 OTA 标志并软复位进入 Bootloader。
|
|
* @return ESP_OK 表示 APP 已确认；ESP_ERR_TIMEOUT 常表示 GD32 已在 Bootloader 或通信未就绪。
|
|
*/
|
|
esp_err_t gd32_app_request_bootloader(uint32_t timeout_ms);
|
|
|
|
#endif // SPI_MASTER_H
|