快速理解ST7789显示模块：核心要点解析

以下是对您提供的博文内容进行深度润色与结构重构后的技术文章。我以一位长期深耕嵌入式显示驱动开发的工程师视角，重新组织逻辑、强化实践导向、剔除AI腔调，并大幅增强可读性、教学性与工程落地感。全文已彻底去除模板化标题、空洞总结和机械分段，代之以自然流畅的技术叙事节奏；所有代码、表格、关键参数均保留并优化注释；语言兼具专业深度与口语温度，就像一位资深同事在白板前边画边讲。

一块1.3寸彩屏背后的“指挥官”：ST7789不是芯片，是图形世界的翻译官

你有没有遇到过这样的场景？
焊好一块ST7789驱动的1.3寸TFT屏，接上ESP32，烧进官方例程，结果——屏幕亮了，但全是噪点；或者图像上下颠倒、颜色发紫；再或者，明明写了全屏刷图，却只刷出左上角四分之一……
别急着换屏、换MCU、甚至别急着重写驱动。这些问题，90%都出在你还没真正“听懂”ST7789在说什么。

它不是一块被动接收数据的玻璃，而是一个有自己语法、时序、记忆和脾气的图形翻译官：你给它SPI指令，它决定像素怎么排；你设一个寄存器，它就改写整个坐标系；你不小心漏掉一个SLPOUT，它就一直躺在睡眠里装死。

下面，我们就从真实调试现场出发，一层层剥开ST7789的“操作系统”，不讲概念，只讲它怎么干活、为什么这么干、以及你踩坑时它其实在悄悄告诉你什么。

它的“内存”不是RAM，是画布——GRAM的本质是线性地址映射

很多初学者一看到“GRAM = Graphic RAM”，下意识就类比成MCU的SRAM：读写自由、随机访问、DMA直连……错了。ST7789的GRAM是一块被严格栅格化的画布，它的地址不是按字节线性递增的“内存地址”，而是按屏幕物理像素一一对应的坐标地址。

• 分辨率240×320 → 总共76,800个像素
• 每个像素RGB565占2字节 → GRAM总大小 = 153,600 字节（约150KB）
• 地址排列方式：行优先（Row-major）—— 第0行从左到右填满240个像素（地址0~479），接着第1行（地址480~959），以此类推。

这意味着：
✅ 你想刷第10行第20列的像素？先算地址偏移：(10 × 240 + 20) × 2 = 4840，再往GRAM写2字节。
❌ 你不能像操作数组一样gram[4840] = 0xF800—— ST7789没有“随机地址写入”指令，一切必须通过地址窗口 + 连续流写完成。

所以，CASET（列设置）和PASET（行设置）不是可选项，而是GRAM写入的前置签证。没它，你的数据就像没买票的乘客，根本进不了站台。

// ✅ 正确：先划区域，再灌数据 st7789_set_window(0, 0, 239, 319); // 全屏 st7789_start_write(); // 开闸：后续所有SPI数据直送GRAM HAL_SPI_Transmit(&hspi1, (uint8_t*)fb, 240*320*2, HAL_MAX_DELA