esp32驱动带字库芯片TFT屏幕

前言

学习esp32单片机开发，前段时间在网上买了一块2.0寸TFT屏幕。

长这个样子，这个屏幕带汉字字库的硬件模块。我仔细看了一下这个字库模块上面写的字是25Q32FVSIG 1336

文档

卖家也发来了开发文档，是个doc文档，张这个样子。

开发准备

下面开始根据文档进行开发，调用这个字库文件内的汉字，并且把它显示出来。
这个是我的接线，没有走硬件spi，这样直接插上去，就免去了接线线。
引脚对应

ST7789_GND GND
ST7789_VCC 15 VCC
ST7789_SCL 2  (SCLK)
ST7789_SDA 4  (MOSI)
ST7789_SDO 16  (MISO)
ST7789_RST 17
ST7789_DC 5
ST7789_CS 18
ST7789_CSF 19  
ST7789_BLK 21 VCC

创建工程 PlatformIO工程
配置和引用

[env:esp32dev]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
upload_speed = 921600
lib_deps = bodmer/TFT_eSPI@^2.5.43tikaflow/UTF8ToGB2312@^1.1.52

1.引入TFT_eSPI.h 下载地址：https://github.com/Bodmer/TFT_eSPI
2.在User_Setup.h中放开注释： #define TFT_WIDTH  240放开注释： #define TFT_HEIGHT 320放开注释： #define ST7789_DRIVER 注释掉：默认的#define ILI9341_DRIVER#define TFT_MOSI 4
#define TFT_SCLK 2
#define TFT_CS   18  // Chip select control pin
#define TFT_DC   5   // Data Command control pin
#define TFT_RST  17  // Reset pin (could connect to RST pin)
#define TFT_BL   21  // LED back-light

源码实现

根据上面文档，实现读取模块中汉字并且渲染到屏幕上。下面是源码

main.cpp

#include <Arduino.h>
#include <TFT_eSPI.h>
#include <SPI.h>
#include "UTF8ToGB2312.h"
TFT_eSPI tft;
// 字库芯片引脚
#define FLASH_CS 19
#define FLASH_MISO 16// 字库结构体
struct FontInfo {uint8_t fontSize;      // 字号uint32_t byteSize;     // 字库占用字节数 实际占用是 byteSize * fontSizeuint32_t addr;         // 字库偏移地址
};// ASCII 字库信息
const FontInfo ASCII_FONTS[] = {{12, 1, 0X1000L},  // 6x12{14, 1, 0X1600L},  // 7x14{16, 1, 0X1D00L},  // 8x16{18, 2, 0X2500L},  // 9x18{20, 2, 0X3700L},  // 10x20{22, 2, 0X4B00L},  // 11x22{24, 2, 0X6100L},  // 12x24{26, 2, 0X7900L}   // 13x26
};// GB2312 字库信息
const FontInfo GB2312_FONTS[] = {{12, 2, 0X9300L},     // 12x12{14, 2, 0X39300L},    // 14x14{16, 2, 0X71300L},    // 16x16{18, 3, 0XB1300L},    // 18x18{20, 3, 0X11D300L},   // 20x20{22, 3, 0X195300L},   // 22x22{24, 3, 0X219300L},   // 24x24{26, 4, 0X2A9300L}    // 26x26
};// 初始化 SPI Flash
void initFlash() {pinMode(FLASH_CS, OUTPUT);digitalWrite(FLASH_CS, HIGH);SPI.begin(TFT_SCLK, FLASH_MISO, TFT_MOSI, FLASH_CS);SPI.setFrequency(1000000);SPI.setDataMode(SPI_MODE0);
}// 读取字库数据
uint8_t readFontData(uint32_t addr) {uint8_t data;digitalWrite(FLASH_CS, LOW);SPI.transfer(0x03);SPI.transfer((addr >> 16) & 0xFF);SPI.transfer((addr >> 8) & 0xFF);SPI.transfer(addr & 0xFF);data = SPI.transfer(0x00);digitalWrite(FLASH_CS, HIGH);return data;
}// 显示一个汉字 (GB2312)
void drawGB2312Char(uint16_t x, uint16_t y, uint16_t ch, uint16_t color, uint8_t fontSize) {if (fontSize < 12 || fontSize > 26 || (fontSize % 2) != 0) {return; // 无效的字体大小}const FontInfo& fontInfo = GB2312_FONTS[(fontSize - 12) / 2];uint32_t fontAddr = fontInfo.addr + (((ch >> 8) - 0xA1) * 94 + (ch & 0xFF) - 0xA1) * fontInfo.fontSize * fontInfo.byteSize;for (uint16_t i = 0; i < fontInfo.fontSize; i++) {for (uint16_t j = 0; j < fontInfo.byteSize; j++) {uint8_t data = readFontData(fontAddr + i * fontInfo.byteSize + j);for (uint8_t k = 0; k < 8; k++) {if (data & (0x80 >> k)) {tft.drawPixel(x + j * 8 + k, y + i, color);}}}}
}// 显示一个 ASCII 字符
void drawASCIIChar(uint16_t x, uint16_t y, uint8_t ch, uint16_t color, uint8_t fontSize) {if (fontSize < 12 || fontSize > 26 || (fontSize % 2) != 0) {return; // 无效的字体大小}const FontInfo& fontInfo = ASCII_FONTS[(fontSize - 12) / 2];uint32_t fontAddr = fontInfo.addr + ch * fontInfo.byteSize * fontInfo.fontSize;for (uint16_t i = 0; i < fontInfo.fontSize; i++) {for (uint16_t j = 0; j < fontInfo.byteSize; j++) {uint8_t data = readFontData(fontAddr + i * fontInfo.byteSize + j);for (uint8_t k = 0; k < 8; k++) {if (data & (0x80 >> k)) {tft.drawPixel(x + j * 8 + k, y + i, color);}}}}
}// 显示字符串 (兼容汉字、英文字符和数字)
void drawString(uint16_t x, uint16_t y, const char *str, uint16_t color, uint8_t fontSize = 16) {String gbStr = GB.get(str); // UTF-8 to GB2312const char *gbCharPtr = gbStr.c_str();uint16_t xPos = x;while (*gbCharPtr) {uint8_t ch = (uint8_t)gbCharPtr[0];if (ch >= 0xA1) { // 汉字uint16_t gbCh = (ch << 8) | (uint8_t)gbCharPtr[1];drawGB2312Char(xPos, y, gbCh, color, fontSize);xPos += fontSize;gbCharPtr += 2;} else if (ch >= 32 && ch <= 126) { // ASCII 字符drawASCIIChar(xPos, y, ch, color, fontSize);gbCharPtr++;xPos += fontSize / 2;} else { // 其他字符或错误处理gbCharPtr++; // 跳过未知字符}}
}void setup() {Serial.begin(115200);pinMode(15, OUTPUT);pinMode(21, OUTPUT);digitalWrite(15, HIGH);digitalWrite(21, HIGH);tft.init();tft.fillScreen(TFT_BLACK);initFlash();drawString(0, 0, "12号：你好，世界！123abc", TFT_GREEN, 12);drawString(0, 12, "14号：你好，世界！123abc", TFT_GREEN, 14);drawString(0, 26, "16号：你好，世界！123abc", TFT_GREEN, 16);drawString(0, 42, "18号：你好，世界！123abc", TFT_GREEN, 18);drawString(0, 60, "20号：你好，世界！123abc", TFT_GREEN, 20);drawString(0, 80, "22号：你好，世界！123abc", TFT_GREEN, 22);drawString(0, 102, "24号：你好，世界！123abc", TFT_GREEN, 24);drawString(0, 126, "26号：你好，世界！123abc", TFT_GREEN, 26);drawString(0, 180, "CSDN关注：雨季余静", TFT_GREEN, 26);
}void loop() {}

最终效果如下

总结

虽然源码没多少行，但是真的折腾了我一整天。

主要是这模块是gb2312的字库，然而程序代码中的汉字是UTF-8汉字。显示出来就是乱码，开始我还以为是我弄错了，后来才发现代码中的文字是UTF-8编码。引入了UTF8ToGB2312.h 问题就迎刃而解了。

如果解决了你的问题希望给个关注，谢谢。