2. 开发环境搭建：Keil / IAR / STM32CubeIDE 安装、工程模板建立、调试器配置

在开始 LCD TFT 驱动开发之前，必须搭建一套稳定、可复用的嵌入式软件开发环境。本章将指导你完成三种主流 IDE（Keil MDK、IAR EWARM、STM32CubeIDE）的安装与配置，建立统一的工程模板，并完成 J-Link / ST-Link 调试器的连接验证。正确搭建环境可避免后续开发中 80% 的常见工具链问题。

2.1 开发工具选型对比

三种 IDE 各有侧重，下表从关键维度进行对比，帮助你根据项目需求做出选择。

2.2 STM32CubeIDE 安装与配置

STM32CubeIDE 是 ST 官方基于 Eclipse 的免费 IDE，集成了 STM32CubeMX 配置工具。以下是标准安装流程。

2.2.1 安装步骤

1. 访问 ST 官网下载最新版 STM32CubeIDE（当前稳定版 v1.15.1）。
2. 运行安装程序，选择安装路径（建议路径不含中文和空格）。
3. 勾选“Install ST-Link drivers”选项，自动安装调试器驱动。
4. 安装完成后启动 IDE，选择工作空间目录（Workspace）。
5. 首次启动会自动下载 MCU 固件包，等待完成即可。

2.2.2 安装验证

打开 IDE 后，点击 Help → About STM32CubeIDE，确认版本信息。在 Window → Preferences → STM32CubeMX → Firmware Updates 中检查已安装的固件包列表，确保至少包含你所用 MCU 系列的固件包（如 STM32F4xx）。

2.3 工程模板建立（以 STM32CubeIDE 为例）

建立一个标准化的工程模板，可以避免每次新建项目时重复配置 LCD 接口、时钟和调试参数。模板将作为后续所有 LCD 驱动实验的基础。

2.3.1 使用 STM32CubeMX 生成初始化代码

1. 在 STM32CubeIDE 中点击 File → New → STM32 Project。
2. 选择 MCU 型号（例如 STM32F407VGT6），点击 Next。
3. 输入项目名称（如 LCD_TFT_Template），选择 C 语言，点击 Finish。
4. 在 CubeMX 图形界面中配置以下关键外设：

5. 点击 Project Manager → Code Generator，勾选 Generate peripheral initialization as a pair of .c/.h files per peripheral。
6. 点击 GENERATE CODE，生成 HAL 库初始化代码。

2.3.2 添加 LCD 驱动文件夹结构

在生成的工程目录 Core/Src 和 Core/Inc 下，手动创建 LCD 驱动文件夹：

Core/
├── Inc/
│   ├── main.h
│   ├── lcd_driver.h      // LCD 底层接口 (写命令/数据)
│   ├── lcd_controller.h  // LCD 控制器初始化 (ILI9341/ST7789)
│   └── lcd_gui.h         // 图形绘制函数 (点、线、矩形)
├── Src/
│   ├── main.c
│   ├── lcd_driver.c
│   ├── lcd_controller.c
│   └── lcd_gui.c

2.3.3 编写模板主函数框架

在 main.c 中预留 LCD 初始化与测试循环的骨架代码：

/* main.c - 工程模板主函数 */
#include "main.h"
#include "lcd_driver.h"
#include "lcd_controller.h"
#include "lcd_gui.h"

int main(void)
{
    HAL_Init();                     // 初始化 HAL 库
    SystemClock_Config();           // 配置系统时钟 168MHz
    MX_GPIO_Init();                 // 初始化 GPIO
    MX_FSMC_Init();                 // 初始化 FSMC (LCD 接口)
    // MX_SPI1_Init();              // 如果使用 SPI 接口则取消注释

    LCD_Init();                     // 初始化 LCD 控制器
    LCD_Clear(0x0000);              // 清屏为黑色

    while (1)
    {
        LCD_Test_ColorBar();        // 测试：显示彩条
        HAL_Delay(2000);
        LCD_Test_Grid();            // 测试：显示网格
        HAL_Delay(2000);
    }
}

2.4 调试器配置：J-Link 与 ST-Link

调试器是连接 PC 与目标板的桥梁，负责下载程序、单步调试和变量监控。本节分别介绍 ST-Link（STM32 板载调试器）和 J-Link（独立调试器）的配置方法。

2.4.1 ST-Link 配置（板载调试器）

大多数 STM32 开发板（如 STM32F4 Discovery、Nucleo 系列）都集成了 ST-Link/V2 调试器。配置步骤如下：

1. 使用 USB 线连接开发板上的 ST-Link USB 端口到 PC。
2. 在 STM32CubeIDE 中点击 Run → Debug Configurations。
3. 双击 STM32 Cortex-M C/C++ Application 新建配置。
4. 在 Debugger 选项卡中：

5. 点击 Apply，然后 Debug。IDE 会自动下载固件并进入调试模式。

2.4.2 J-Link 配置（独立调试器）

J-Link 是 SEGGER 公司的高性能调试器，支持更快的下载速度和更丰富的调试功能。配置步骤：

1. 安装 J-Link 驱动（从 SEGGER 官网下载 J-Link Software Pack）。
2. 将 J-Link 的 SWD 接口与目标板连接：

3. 在 STM32CubeIDE 中，打开 Run → Debug Configurations，选择 STM32 Cortex-M C/C++ Application。
4. 在 Debugger 选项卡中：

5. 点击 Apply 并 Debug。首次使用 J-Link 会提示更新固件，按提示操作即可。

2.5 调试器连接验证流程

完成配置后，通过以下步骤验证调试器是否正常工作：

1. 点击 Debug 按钮，观察 Console 窗口输出信息。
2. 正常连接时，应看到类似 ST-Link GDB server connected 或 J-Link connected to target 的提示。
3. 程序自动下载到 Flash 后，停在 main() 入口处（断点自动设置）。
4. 点击 Resume (F8) 运行程序，观察开发板上的 LED 或 LCD 是否按预期工作。
5. 如果连接失败，检查以下常见问题：

2.6 开发环境搭建总览图

下图展示了从 IDE 安装到调试器连接的整体流程，以及各组件之间的数据流关系。

2.7 工程模板验证测试

完成上述配置后，执行一次完整的编译-下载-调试循环，验证模板是否可用：

1. 点击 Project → Build All (Ctrl+B)，确认编译无错误。
2. 点击 Run → Debug，等待下载完成。
3. 程序停在 main() 入口，点击 Resume 运行。
4. 观察开发板：如果 LCD 已连接，应看到彩条和网格交替显示（需先实现测试函数）。
5. 如果 LCD 未连接，可通过 GPIO 翻转 LED 引脚验证程序运行。