feat: ESP32-C3 OTA 中继项目 initial commit

2026-04-27 00:42:26 +08:00
commit bcfe130451
48 changed files with 9705 additions and 0 deletions
@@ -0,0 +1,124 @@
+/*
+ * spi_master.c - SPI Master 驱动实现
+ * T1.1 - T1.4
+ * ESP-IDF 6.0 适配版本
+ */
+#include <string.h>
+#include "freertos/FreeRTOS.h"
+#include "freertos/task.h"
+#include "driver/spi_master.h"
+#include "soc/spi_struct.h"
+
+#include "spi_master.h"
+#include "debug_log.h"
+
+spi_device_handle_t g_spi_device = NULL;
+
+// SPI2 总线初始化
+esp_err_t spi_master_init(void)
+{
+    DEBUG_INFO("SPI", "初始化 SPI2 (VSPI)...");
+
+    spi_bus_config_t bus_cfg = {};
+    bus_cfg.mosi_io_num = 8;
+    bus_cfg.miso_io_num = 7;
+    bus_cfg.sclk_io_num = 6;
+    bus_cfg.quadwp_io_num = -1;
+    bus_cfg.quadhd_io_num = -1;
+    bus_cfg.max_transfer_sz = 256;
+
+    esp_err_t ret = spi_bus_initialize(SPI2_HOST, &bus_cfg, SPI_DMA_CH_AUTO);
+    if (ret != ESP_OK) {
+        DEBUG_ERR("SPI", "SPI 总线初始化失败: %s", esp_err_to_name(ret));
+        return ret;
+    }
+
+    spi_device_interface_config_t dev_cfg = {};
+    dev_cfg.clock_speed_hz = SPI_CLOCK_HZ;
+    dev_cfg.mode = SPI_MODE;
+    dev_cfg.spics_io_num = SPI_MASTER_CS_GPIO;
+    dev_cfg.queue_size = SPI_QUEUE_SIZE;
+    dev_cfg.command_bits = 0;
+    dev_cfg.address_bits = 0;
+    dev_cfg.dummy_bits = 0;
+    dev_cfg.cs_ena_posttrans = 0;
+    dev_cfg.cs_ena_pretrans = 0;
+
+    ret = spi_bus_add_device(SPI2_HOST, &dev_cfg, &g_spi_device);
+    if (ret != ESP_OK) {
+        DEBUG_ERR("SPI", "添加 SPI 设备失败: %s", esp_err_to_name(ret));
+        return ret;
+    }
+
+    DEBUG_INFO("SPI", "SPI2 已初始化: CLK=40MHz, CS=GPIO4");
+    return ESP_OK;
+}
+
+// 带超时的同步 SPI 传输
+// ESP-IDF 6.0: spi_device_transmit() 不再接受超时参数
+// 使用 spi_device_queue_trans() + spi_device_get_trans_result() 实现超时
+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)
+{
+    if (g_spi_device == NULL) {
+        DEBUG_ERR("SPI", "SPI 设备未初始化");
+        return ESP_ERR_INVALID_STATE;
+    }
+
+    spi_transaction_t t = {};
+    t.cmd = cmd;
+    t.length = payload_len * 8;
+    t.rxlength = recv_len * 8;
+    t.tx_buffer = payload;
+    t.rx_buffer = recv_buf;
+    t.user = (void *)(uintptr_t)cmd;
+
+    /* ESP-IDF 6.0: 使用 spi_device_transmit() 无超时参数
+     * 如需超时控制，使用 spi_device_queue_trans() + spi_device_get_trans_result()
+     */
+    esp_err_t ret = spi_device_transmit(g_spi_device, &t);
+    if (ret != ESP_OK) {
+        DEBUG_WARN("SPI", "SPI 发送 cmd=0x%02X 失败: %s", cmd, esp_err_to_name(ret));
+    }
+
+    return ret;
+}
+
+// 仅发送
+esp_err_t spi_send(uint8_t cmd, const uint8_t *payload, size_t len)
+{
+    return spi_sync_transfer(cmd, payload, len, NULL, 0, 3000);
+}
+
+// 仅接收
+esp_err_t spi_recv(uint8_t cmd, uint8_t *recv_buf, size_t len, uint32_t timeout_ms)
+{
+    uint8_t dummy[64] = {0};
+    memset(dummy, 0xFF, sizeof(dummy));
+    return spi_sync_transfer(cmd, dummy, len, recv_buf, len, timeout_ms);
+}
+
+// 带重试的 SPI 传输
+esp_err_t spi_transfer_with_retry(uint8_t cmd, const uint8_t *payload,
+                                  size_t payload_len, uint8_t *recv_buf,
+                                  size_t recv_len, int max_retries)
+{
+    esp_err_t ret;
+    int retry_count = 0;
+
+    while (retry_count < max_retries) {
+        ret = spi_sync_transfer(cmd, payload, payload_len,
+                                recv_buf, recv_len, 3000);
+        if (ret == ESP_OK) {
+            return ESP_OK;
+        }
+
+        retry_count++;
+        DEBUG_WARN("SPI", "SPI 重试 %d/%d, cmd=0x%02X", retry_count, max_retries, cmd);
+        vTaskDelay(pdMS_TO_TICKS(100));
+    }
+
+    DEBUG_ERR("SPI", "SPI 传输 %d 次重试后失败", max_retries);
+    return ESP_ERR_TIMEOUT;
+}