以下是使用 ESP32 和 ESP-IDF 驱动 ST7735 屏幕的基础步骤及代码示例：

1. 硬件准备

• 接线参考（根据实际模块调整）：

  ST7735      ESP32
  ------------------
  SCL(CLK)  → GPIO 18 (SPI CLK)
  SDA(MOSI) → GPIO 23 (SPI MOSI)
  RES       → GPIO 4  (自定义复位引脚)
  DC        → GPIO 2  (数据/命令控制)
  CS        → GPIO 5  (SPI CS)
  VCC       → 3.3V/5V（根据屏幕要求）
  GND       → GND

2. 添加驱动库

推荐使用 st7735 组件：

# 通过组件管理器添加（或手动下载到 components 目录）
git clone https://github.com/nopnop/st7735-esp-idf components/st7735

3. 代码示例 (main.c)

#include "driver/spi_master.h"
#include "st7735.h"

#define TFT_CS  5
#define TFT_DC  2
#define TFT_RST 4
#define TFT_HOST SPI2_HOST  // 使用SPI2主机

void app_main(void) {
    // 初始化SPI配置
    spi_bus_config_t buscfg = {
        .miso_io_num = -1,  // 不需要MISO
        .mosi_io_num = 23,
        .sclk_io_num = 18,
        .quadwp_io_num = -1,
        .quadhd_io_num = -1,
        .max_transfer_sz = 32 * 1024,
    };
    spi_bus_initialize(TFT_HOST, &buscfg, SPI_DMA_CH_AUTO);

    // 屏幕初始化参数
    st7735_config_t tft_config = {
        .host = TFT_HOST,
        .cs_pin = TFT_CS,
        .dc_pin = TFT_DC,
        .rst_pin = TFT_RST,
        .width = 128,        // 根据实际屏幕尺寸调整
        .height = 160,
        .offset_x = 0,       // 显示偏移校准
        .offset_y = 0,
        .invert_colors = 0,  // 颜色反转
        .rotation = ST7735_ROTATION_90  // 旋转方向
    };
    st7735_init(&tft_config);

    // 测试显示
    st7735_fill_screen(ST7735_RED);    // 填充红色
    vTaskDelay(1000 / portTICK_PERIOD_MS);
    st7735_fill_screen(ST7735_GREEN); // 填充绿色
}

4. 关键配置说明

• SPI 频率调整：在 st7735.h 中修改 SPI_FREQUENCY（默认通常为 40MHz）。
• 显示偏移校准：部分屏幕需要调整 offset_x 和 offset_y 以正确居中显示。
• 颜色模式：支持 16位 RGB565 格式（ST7735默认）。

5. 高级用法

• 图形库集成：可结合 LVGL 实现 UI，需额外配置显示缓冲区和回调函数。
• 优化刷新：使用 DMA 传输减少 CPU 占用。

常见问题排查

• 屏幕无显示：检查背光引脚是否需单独供电/控制。
• 花屏/乱码：降低 SPI 频率（尝试 20MHz 或 10MHz）。
• 颜色异常：确认 invert_colors 设置是否正确。

建议从简单填充屏幕开始测试，逐步扩展功能。