实施A2/A3/A4并通过真机验证:net_task失败重试自检、ch395f有限超时故障锁存、remo_send短写阻断;@test 7/7,A1含配置持久化闭环

This commit is contained in:
2026-10-03 09:05:57 +08:00
parent ddbba714f7
commit 1780e5320b
8 changed files with 165 additions and 33 deletions
+49 -9
View File
@@ -8,6 +8,8 @@
* 修改记录:
* 2026-03-14 王建锋 创建初始版本,按代码规范重构
* 2026-07-18 王建锋 改进write_send_buf/read_recv_buf使用SPI2 DMA批量传输
* 2026-10-02 王建锋 E-34:3 处字节级 SPI 调用由 HAL_MAX_DELAY 改有限超时(100ms)
* + 返回值检查 + 故障锁存(沿程只记一条日志);原 SPI 异常时调用方永久挂死
*/
/* 头文件包含区 - 先包含系统头文件,再包含自定义头文件 */
@@ -30,6 +32,7 @@
#define CH395F_RESET_DELAY_MS 20U /* 复位后等待延时(ms) */
#define CH395F_INIT_TIMEOUT_MS 500U /* 初始化超时时间(ms) */
#define CH395F_SPI_BEGIN_DELAY_MS 1U /* SPI事务开始延时(ms) */
#define CH395F_SPI_BYTE_TIMEOUT_MS 100U /* E-34:字节级SPI有限超时(原 HAL_MAX_DELAY) */
/* DMA缓冲大小使用ch395f.h中公开的CH395F_SPI_DMA_BUF_SIZE */
#define CH395F_DMA_BUF_SIZE CH395F_SPI_DMA_BUF_SIZE
@@ -37,6 +40,7 @@
* 静态变量定义区 - DMA传输相关
*/
static volatile uint8_t s_spi2_dma_done = 0U; /* DMA传输完成标志 */
static uint8_t s_spi_byte_fault = 0U; /* E-34:字节级SPI故障锁存(超时/出错置位,MCU复位清除) */
__attribute__((aligned(4)))
static uint8_t s_spi2_dma_tx_buf[CH395F_DMA_BUF_SIZE]; /* DMA发送缓冲区 */
@@ -49,6 +53,7 @@ static uint8_t s_spi2_dma_rx_buf[CH395F_DMA_BUF_SIZE]; /* DMA接收缓冲区 */
static void ch395f_spi_begin(void);
static void ch395f_spi_end(void);
static void ch395f_spi_dma_transfer(uint16_t len);
static void ch395f_spi_byte_fault_set(void);
/*
* 私有函数定义区
@@ -76,6 +81,21 @@ static void ch395f_spi_end(void) {
HAL_GPIO_WritePin(CH395_SCS_GPIO_Port, CH395_SCS_Pin, GPIO_PIN_SET);
}
/*
* 函数功能:锁存一次字节级SPI故障(E-34:仅首条故障记日志)
* 入口参数:无
* 返回值:无
* 限定条件:无
* 函数说明:任一字节级SPI调用超时/失败时调用;置位 s_spi_byte_fault 并记一条日志,
* 后续故障静默(防串口刷屏);上层经 ch395f_spi_byte_fault() 查询
*/
static void ch395f_spi_byte_fault_set(void) {
if (s_spi_byte_fault == 0U) {
s_spi_byte_fault = 1U;
DBG_ERROR("SPI byte op fail, channel latched");
}
}
/*
* 函数功能:DMA全双工传输并等待完成
* 入口参数:len - 传输长度(字节) uint16_t 1 - CH395F_DMA_BUF_SIZE
@@ -175,10 +195,13 @@ void HAL_SPI_ErrorCallback(SPI_HandleTypeDef *hspi) {
* 函数说明:SPI模式下命令和数据字节之间无需间隔
*/
uint8_t ch395f_write_cmd(uint8_t cmd) {
uint8_t rx_data;
uint8_t rx_data = 0xFFU;
/* 通过SPI发送命令并接收回显 */
HAL_SPI_TransmitReceive(&hspi2, &cmd, &rx_data, 1, HAL_MAX_DELAY);
/* 通过SPI发送命令并接收回显(E-34:有限超时+返回值检查;失败返回0xFF占位并锁存故障) */
if (HAL_SPI_TransmitReceive(&hspi2, &cmd, &rx_data, 1,
CH395F_SPI_BYTE_TIMEOUT_MS) != HAL_OK) {
ch395f_spi_byte_fault_set();
}
return rx_data;
}
@@ -189,10 +212,13 @@ uint8_t ch395f_write_cmd(uint8_t cmd) {
* 限定条件:必须在ch395f_spi_begin()和ch395f_spi_end()之间调用
*/
uint8_t ch395f_write_data(uint8_t data) {
uint8_t rx_data;
uint8_t rx_data = 0xFFU;
/* 通过SPI发送数据并接收回显 */
HAL_SPI_TransmitReceive(&hspi2, &data, &rx_data, 1, HAL_MAX_DELAY);
/* 通过SPI发送数据并接收回显(E-34:有限超时+返回值检查) */
if (HAL_SPI_TransmitReceive(&hspi2, &data, &rx_data, 1,
CH395F_SPI_BYTE_TIMEOUT_MS) != HAL_OK) {
ch395f_spi_byte_fault_set();
}
return rx_data;
}
@@ -204,13 +230,27 @@ uint8_t ch395f_write_data(uint8_t data) {
*/
uint8_t ch395f_read_data(void) {
uint8_t tx_dummy = 0xFFU;
uint8_t rx_data;
uint8_t rx_data = 0xFFU;
/* 发送0xFF作为时钟源,读取芯片返回数据 */
HAL_SPI_TransmitReceive(&hspi2, &tx_dummy, &rx_data, 1, HAL_MAX_DELAY);
/* 发送0xFF作为时钟源,读取芯片返回数据(E-34:有限超时+返回值检查) */
if (HAL_SPI_TransmitReceive(&hspi2, &tx_dummy, &rx_data, 1,
CH395F_SPI_BYTE_TIMEOUT_MS) != HAL_OK) {
ch395f_spi_byte_fault_set();
}
return rx_data;
}
/*
* 函数功能:查询字节级SPI故障锁存(E-34)
* 返回值:0 - 正常 1 - 曾发生字节级SPI超时/错误
* 限定条件:无
* 函数说明:锁存式(不自动清除,MCU 复位前一直有效);上层据此判定
* "SPI 通道异常"(区别于"无芯片"/"PHY 未链接");仅首条故障记日志
*/
uint8_t ch395f_spi_byte_fault(void) {
return s_spi_byte_fault;
}
/*
* 函数功能:检测CH395芯片是否存在且通信正常
* 返回值:CH395F_STATUS_OK - 芯片检测成功 ch395f_status_t
+9
View File
@@ -301,6 +301,15 @@ uint8_t ch395f_write_data(uint8_t data);
*/
uint8_t ch395f_read_data(void);
/*
* 函数功能:查询字节级SPI故障锁存(E-34)
* 返回值:0 - 正常 1 - 曾发生字节级SPI超时/错误
* 限定条件:无
* 函数说明:锁存式(MCU 复位前一直有效);上层据此判定"SPI 通道异常"
* (区别于"无芯片"/"PHY 未链接");仅首条故障记日志
*/
uint8_t ch395f_spi_byte_fault(void);
/*
* 函数声明区 - 芯片检测与版本
*/