esp32驱动带字库芯片TFT屏幕

前言

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

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

文档

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


开发准备

下面开始根据文档进行开发,调用这个字库文件内的汉字,并且把它显示出来。

这个是我的接线,没有走硬件spi,这样直接插上去,就免去了接线线。

引脚对应

c 复制代码
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.43
	tikaflow/UTF8ToGB2312@^1.1.52
c 复制代码
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

c 复制代码
#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 * fontSize
  uint32_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 GB2312
  const 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 问题就迎刃而解了。

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

相关推荐
Ronin-Lotus1 小时前
嵌入式硬件篇---驱动板
单片机·嵌入式硬件·esp32·驱动板
flashier19 小时前
ESP32学习笔记_Components(1)——使用LED Strip组件点亮LED灯带
学习·esp32·led·led灯带·esp32组件
flashier2 天前
ESP32学习笔记_Peripherals(4)——MCPWM基础使用
单片机·学习·esp32·pwm·mcpwm
IT项目分享4 天前
ESP32-CAM实战:DIY基于OpenAI的AI视觉识别相机
人工智能·数码相机·esp32·智能硬件·it项目网
包罗万码9 天前
esp32 idf 使用http访问json直接拼接content_length = -1
网络协议·http·json·esp32·espidf
Ching·9 天前
esp32使用ESP-IDF在Linux下的升级步骤,和遇到的坑Traceback (most recent call last):,及解决
linux·python·esp32·esp_idf升级
科技人生12 天前
小智完整MCP交互流程(以调节音量为例)
esp32·mcp·小智ai
2301_8059629315 天前
微信小程序控制空调之接收MQTT消息
微信小程序·小程序·esp32
政安晨17 天前
政安晨【开源人工智能硬件】【ESP乐鑫篇】 —— 在macOS上部署工具开发环境(小资的非开发者用苹果系统也可以玩乐鑫)
esp32·mac·开源硬件·环境部署·乐鑫·开源人工智能硬件·工具链搭建
@Hwang17 天前
【ESP32-IDF笔记】09-UART配置和使用
笔记·esp32·uart·esp32s3·esp32-idf