ST7701 3线SPI驱动技术解析

ST7701 3线SPI初始化代码技术解析

在如今的智能穿戴设备、工业HMI和便携式医疗仪器中，一块小尺寸TFT屏往往是人机交互的核心。但当主控MCU的GPIO资源捉襟见肘时，如何用最少的引脚驱动一块显示屏？这正是ST7701这类高集成显示驱动IC的价值所在——它不仅能内置电源管理，还支持仅需三根信号线即可通信的 3线SPI模式 。

而真正让工程师头疼的，往往不是芯片本身，而是那一段看似简单却极易出错的初始化代码。稍有不慎，屏幕就黑着不亮，调试无从下手。本文将深入剖析基于ST7701的3线SPI驱动实现机制，重点解决“没有DC引脚怎么区分命令与数据”、“为何初始化总失败”、“如何写出可移植性强的底层代码”等实际问题，并提供一套经过验证的完整实现框架。

核心挑战：没有DC引脚，如何控制LCD？

传统的MCU接口LCD通常需要至少四条控制线：CS（片选）、SCK（时钟）、SDA（数据）和 DC （Data/Command）。其中DC引脚最关键——拉低表示发送命令（如设置显示方向），拉高则表示发送数据（如像素颜色值）。

但在许多低引脚数MCU上，比如nRF52840或STM32G0系列，每一个GPIO都弥足珍贵。这时候如果能省掉DC引脚，就能极大缓解资源压力。ST7701正是为此类场景设计的：它支持通过 3线SPI 工作，在仅有SCK、SDA、CS的情况下完成全部配置。

那它是怎么做到的？答案是： 软件协议层约定 。

具体来说，每个传输字节的最高位（Bit7）被用作类型标志：
- 若该位为 0 → 表示这是一个 命令
- 若该位为 1 → 表示这是一个 数据

例如：
- 发送 0x2C （二进制 0010_1100 ），Bit7=0 → 解释为“写显存”命令
- 发送 0xA0 （二进制 1010_0000 ），Bit7=1 → 解释为数据

这样一来，无需额外硬件引脚，仅靠软件打包即可实现双向逻辑控制。当然，这也要求我们在发送数据时必须手动加上 0x80 的偏移量，否则命令和数据会混淆。

GPIO模拟SPI：灵活但需谨慎处理时序

虽然部分MCU具备硬件SPI外设，但在某些封装受限或引脚复用复杂的项目中，仍需使用 GPIO模拟SPI 来实现通信。这种方式通用性强，便于跨平台移植，但也对时序精度提出了更高要求。

以下是一个典型的3线SPI模拟实现：

// gpio_spi.h
#ifndef __GPIO_SPI_H__
#define __GPIO_SPI_H__

#include <stdint.h>
#define PIN_SCK_PORT    GPIOB
#define PIN_SCK_PIN     GPIO_PIN_13
#define PIN_SDA_PORT    GPIOB
#define PIN_SDA_PIN     GPIO_PIN_15
#define PIN_CS_PORT     GPIOB
#define PIN_CS_PIN      GPIO_PIN_12

#define SET_SCK()   HAL_GPIO_WritePin(PIN_SCK_PORT, PIN_SCK_PIN, GPIO_PIN_SET)
#define CLR_SCK()   HAL_GPIO_WritePin(PIN_SCK_PORT, PIN_SCK_PIN, GPIO_PIN_RESET)
#define SET_SDA()   HAL_GPIO_WritePin(PIN_SDA_PORT, PIN_SDA_PIN, GPIO_PIN_SET)
#define CLR_SDA()   HAL_GPIO_WritePin(PIN_SDA_PORT, PIN_SDA_PIN, GPIO_PIN_RESET)
#define CS_ENABLE() HAL_GPIO_WritePin(PIN_CS_PORT, PIN_CS_PIN, GPIO_PIN_RESET)
#define CS_DISABLE()HAL_GPIO_WritePin(PIN_CS_PORT, PIN_CS_PIN, GPIO_PIN_SET)

void gpio_spi_init(void);
void gpio_spi_send_byte(uint8_t byte);

#endif

对应的底层发送函数如下：

// gpio_spi.c
#include "gpio_spi.h"
#include "delay.h"

void gpio_spi_init(void) {
    GPIO_InitTypeDef gpio = {0};
    __HAL_RCC_GPIOB_CLK_ENABLE();

    // SCK 初始化
    gpio.Pin = PIN_SCK_PIN;
    gpio.Mode = GPIO_MODE_OUTPUT_PP;
    gpio.Speed = GPIO_SPEED_FREQ_HIGH;
    gpio.Pull = GPIO_NOPULL;
    HAL_GPIO_Init(PIN_SCK_PORT, &gpio);

    // SDA 输出模式
    gpio.Pin = PIN_SDA_PIN;
    HAL_GPIO_Init(PIN_SDA_PORT, &gpio);

    // CS 初始化
    gpio.Pin = PIN_CS_PIN;
    HAL_GPIO_Init(PIN_CS_PORT, &gpio);

    CS_DISABLE();
    CLR_SCK();
    CLR_SDA();
}

void gpio_spi_send_byte(uint8_t byte) {
    for (int i = 0; i < 8; i++) {
        CLR_SCK();

        if (byte & 0x80) {
            SET_SDA();
        } else {
            CLR_SDA();
        }

        delay_us(1);    // 建立时间 ≥ 100ns
        SET_SCK();      // 上升沿采样
        delay_us(1);    // 保持时间

        byte <<= 1;
    }
    CLR_SCK();
}

这里有几个关键点需要注意：
- CPOL=0, CPHA=0 ：即空闲时钟低电平，上升沿采样，符合ST7701规格书要求。
- delay_us(1) 不可省略，尤其是在高速主频下（如64MHz以上），否则建立/保持时间不足会导致通信失败。
- SDA始终作为输出使用，因为ST7701在此模式下不会回传任何数据。

如果你的目标平台已有硬件SPI，建议优先启用DMA或中断方式提升效率；但对于快速原型开发，GPIO模拟方式足够直观且易于调试。

初始化序列：成败在此一举

很多开发者遇到的问题是：“代码烧进去后屏幕完全没反应”。排除接线错误后，最常见的原因就是 初始化序列执行不当 。

ST7701上电后处于复位状态，内部电源未开启，必须通过一系列寄存器配置才能进入正常工作模式。这个过程不能随意跳步，也不能缺少必要的延时。

以下是典型初始化流程及对应代码实现：

// st7701.c
#include "st7701.h"
#include "delay.h"

void st7701_write_cmd(uint8_t cmd) {
    CS_ENABLE();
    gpio_spi_send_byte(cmd);  // Bit7=0 → 命令
    CS_DISABLE();
}

void st7701_write_data(uint8_t data) {
    CS_ENABLE();
    gpio_spi_send_byte(0x80 | data);  // Bit7=1 → 数据
    CS_DISABLE();
}

void st7701_write_buffer(const uint8_t *buf, uint16_t len) {
    CS_ENABLE();
    for (uint16_t i = 0; i < len; i++) {
        gpio_spi_send_byte(0x80 | buf[i]);
    }
    CS_DISABLE();
}

void st7701_init(void) {
    gpio_spi_init();
    delay_ms(120);  // 等待电源稳定

    st7701_write_cmd(0x11);  // 退出睡眠模式
    delay_ms(150);           // 必须等待足够长时间！

    st7701_write_cmd(0x3A);
    st7701_write_data(0x55); // RGB565 色彩格式

    st7701_write_cmd(0xB2);  // Porch 设置
    st7701_write_data(0x0C);
    st7701_write_data(0x0C);
    st7701_write_data(0x00);
    st7701_write_data(0x33);
    st7701_write_data(0x33);

    st7701_write_cmd(0xB7);
    st7701_write_data(0x35); // Gate电压控制

    st7701_write_cmd(0xBB);
    st7701_write_data(0x1F); // VCOM设置

    st7701_write_cmd(0xC0);
    st7701_write_data(0x28); // AVDD = 6.8V
    st7701_write_data(0x08); // AVCL = -4.8V

    st7701_write_cmd(0xC3);
    st7701_write_data(0x0A); // VDV设置

    st7701_write_cmd(0xC6);
    st7701_write_data(0x0F); // 60Hz刷新率

    st7701_write_cmd(0xD0);
    st7701_write_data(0xA4);
    st7701_write_data(0xA1);

    // 正伽马校正
    st7701_write_cmd(0xE0);
    uint8_t gammaP[] = {0xD0,0x00,0x02,0x07,0x0A,0x28,0x32,0x44,0x42,0x06,0x0E,0x12,0x14,0x17};
    st7701_write_buffer(gammaP, sizeof(gammaP));

    // 负伽马校正
    st7701_write_cmd(0xE1);
    uint8_t gammaN[] = {0xD0,0x00,0x02,0x07,0x09,0x28,0x31,0x44,0x40,0x06,0x0E,0x12,0x14,0x17};
    st7701_write_buffer(gammaN, sizeof(gammaN));

    st7701_write_cmd(0x29);  // 开启显示
    delay_ms(100);
}

几个容易踩坑的地方：
- 0x11命令后必须延时≥120ms ：这是ST7701内部电源建立所需时间，若太短可能导致后续配置无效。
- 伽马参数不可乱改 ：这些数值直接影响色彩饱和度与对比度，应根据实际面板型号微调。
- SPI速率不宜过高 ：初始建议设置为1~2MHz，确认功能正常后再逐步提升至4~6MHz上限。

实际应用中的工程考量

在一个典型的嵌入式系统中，ST7701常用于连接小尺寸圆形或矩形TFT屏，典型架构如下：

[MCU]
   ├── SCK ──┐
   ├── SDA ──┤──→ [ST7701] ──→ [TFT LCD Panel]
   └── CS  ──┘
         （可选RST连接）

适用平台包括：
- STM32L系列 ：追求超低功耗的便携设备
- ESP32-S3 ：带LVGL图形界面的物联网终端
- nRF52xx ：蓝牙手环、手表等穿戴产品

为了提高系统的鲁棒性，推荐以下设计实践：

此外，若需支持背光控制，可额外引出一个PWM引脚驱动LED背光；若需触摸功能，则可搭配I²C接口的触控IC（如GT911）组成完整解决方案。

写在最后：以软件换硬件的设计哲学

ST7701配合3线SPI的方案，本质上体现了一种典型的嵌入式设计思路： 用软件复杂度换取硬件资源节约 。虽然我们需要在代码中手动处理Bit7标志、精确控制延时、维护冗长的初始化表，但换来的是仅用3个GPIO就能点亮一块彩色屏幕的能力。

这套初始化代码不仅可以直接用于智能手环、工业仪表等产品开发，也可作为教学参考帮助初学者理解LCD驱动的本质。未来还可在此基础上扩展横竖屏切换、DMA刷新、LVGL集成等功能，构建更完整的GUI系统。

当你下次面对一个只剩几个空闲引脚的MCU时，不妨想想：也许不需要换主控，只需换个通信方式，问题就迎刃而解了。