ESP32自定义三线半双工SPI驱动GC9A01无响应求助

云原生阿岚

2026-8-4

ESP32 SPI三线半双工主模式驱动GC9A01 LCD无响应排查

开发目标：为ESP-WROOM-32开发GC9A01圆形LCD自定义驱动
前置背景：尝试过Arduino/ESP32生态下的现成GC9A01驱动库均失效，决定从零构建驱动库；此前已在STM32平台成功驱动同款LCD
当前问题：ESP32配置SPI三线半双工主模式后，LCD无任何响应；已验证寄存器地址访问逻辑正确，问题集中在SPI初始化与数据发送函数的实现环节

相关代码片段

SPI初始化函数

void spi_init(void) {
    // 配置GPIO引脚（SCK、MOSI/SDIO、CS、DC）
    gpio_set_direction(GPIO_NUM_18, GPIO_MODE_OUTPUT);
    gpio_set_direction(GPIO_NUM_23, GPIO_MODE_OUTPUT);
    gpio_set_direction(GPIO_NUM_5, GPIO_MODE_OUTPUT);
    gpio_set_direction(GPIO_NUM_21, GPIO_MODE_OUTPUT);

    // 初始化SPI总线
    spi_bus_config_t buscfg = {
        .miso_io_num = -1, // 三线半双工无需MISO
        .mosi_io_num = GPIO_NUM_23,
        .sclk_io_num = GPIO_NUM_18,
        .quadwp_io_num = -1,
        .quadhd_io_num = -1,
        .max_transfer_sz = 0
    };

    spi_device_interface_config_t devcfg = {
        .clock_speed_hz = 4000000, // 4MHz
        .mode = 0, // SPI模式0
        .spics_io_num = GPIO_NUM_5,
        .queue_size = 7,
        .flags = SPI_DEVICE_HALFDUPLEX // 启用半双工模式
    };

    esp_err_t ret = spi_bus_initialize(SPI2_HOST, &buscfg, SPI_DMA_CH_AUTO);
    ESP_ERROR_CHECK(ret);
    ret = spi_bus_add_device(SPI2_HOST, &devcfg, &spi);
    ESP_ERROR_CHECK(ret);
}

LCD命令/数据发送函数

void lcd_send_cmd(uint8_t cmd) {
    gpio_set_level(GPIO_NUM_21, 0); // DC引脚拉低表示命令
    spi_transaction_t t = {
        .length = 8,
        .tx_buffer = &cmd,
        .rx_buffer = NULL
    };
    spi_device_transmit(spi, &t);
}

void lcd_send_data(uint8_t data) {
    gpio_set_level(GPIO_NUM_21, 1); // DC引脚拉高表示数据
    spi_transaction_t t = {
        .length = 8,
        .tx_buffer = &data,
        .rx_buffer = NULL
    };
    spi_device_transmit(spi, &t);
}