ST7789-STM32 项目使用教程

1. 项目介绍

ST7789-STM32 是一个基于 STM32 微控制器的开源项目，旨在使用硬件 SPI 接口驱动 ST7789 显示屏。该项目支持多种分辨率的 ST7789 显示屏，包括 135x240、240x240 和 170x320 等。通过使用硬件 SPI 和 DMA（可选），该项目能够高效地驱动显示屏，适用于各种嵌入式系统应用。

2. 项目快速启动

2.1 环境准备

• 硬件：STM32 微控制器（如 STM32F103C8T6）、ST7789 显示屏
• 软件：STM32CubeMX、Keil MDK 或 STM32CubeIDE

2.2 代码集成

1. 克隆项目：

   git clone https://github.com/Floyd-Fish/ST7789-STM32.git
   

2. 添加到项目： 将项目中的 st7789 目录复制到你的 STM32 项目源码路径中，并将其添加到编译器的包含路径。

3. 配置参数： 在 st7789.h 文件中配置你的显示屏参数，如分辨率、引脚映射等。

4. 初始化代码： 在系统启动时调用 ST7789_Init() 函数进行初始化。

5. 测试代码： 在 main.c 中调用 ST7789_Test() 函数进行测试。

2.3 示例代码

#include "stm32f1xx_hal.h"
#include "st7789.h"

int main(void) {
    // 初始化 HAL 库
    HAL_Init();
    SystemClock_Config();

    // 初始化 ST7789 显示屏
    ST7789_Init();

    // 测试显示屏
    ST7789_Test();

    while (1) {
        // 主循环
    }
}

3. 应用案例和最佳实践

3.1 应用案例

• 智能家居控制面板：使用 ST7789 显示屏作为智能家居控制面板，显示温度、湿度、时间等信息，并通过触摸屏进行交互。
• 工业监控系统：在工业环境中，使用 ST7789 显示屏显示设备状态、报警信息等，帮助操作人员实时监控设备运行情况。

3.2 最佳实践

• 优化 SPI 速度：在使用杜邦线连接时，SPI 时钟频率不应超过 40MHz，建议使用 PCB 布线以提高数据传输速度。
• 使用 DMA：对于大块数据写入（如填充整个屏幕或绘制位图），启用 DMA 可以显著提高性能，减少 CPU 负担。

4. 典型生态项目

• STM32CubeMX：用于配置 STM32 微控制器的硬件资源，生成初始化代码。
• uGUI：一个轻量级的图形用户界面库，可以与 ST7789 显示屏结合使用，实现更复杂的图形界面。
• STM32CubeIDE：ST 官方的集成开发环境，支持 STM32 系列微控制器的开发和调试。

通过以上步骤，你可以快速上手 ST7789-STM32 项目，并将其应用于各种嵌入式系统中。