驱动TFT屏幕
注:所有SPI屏幕的CS引脚都可以省略,节省一个引脚。屏幕的CS接地就是启用了。
ESP8266 硬件SPI引脚:
这里用的是硬件SPI,所以驱动其他屏幕,一般只需要指定CS、DC、RST引脚就行,MOSI、SCLK是固定的,不用指明。除想走软件模拟驱动。
#define TFT_MISO D6 //数据IN :Automatically assigned with ESP8266 if not defined #define TFT_MOSI D7 //或叫SDA,数据OUT: Automatically assigned with ESP8266 if not defined #define TFT_SCLK D5 //或叫SCK :Automatically assigned with ESP8266 if not defined #define TFT_CS D8 //Chip select control pin D8 #define TFT_DC D3 //或叫A0或RS: Data Command control pin #define TFT_RST D4 //Reset pin (could connect to NodeMCU RST, see next line)
//拷贝到Arduino里即可
ESP32S3的SPI:
官方文档好像说ESP32S3的引脚是可以随便映射的(通过 GPIO 交换矩阵连接),但是性能会有所下降,只能到400MHz,推荐用IO MUX 管脚,也就是默认的SPI3引脚,可以到800MHz(有4个SPI,前两个不能用,用SPI3就行)
参考:ESP32-S3 引脚参考大全 - 小鹏STEM (xpstem.com)
//暂时还没测速过硬件SPI,下面是软件SPI的,如果是软SPI,随便用哪个引脚都行
#define TFT_MOSI 14 #define TFT_RST 13 #define TFT_DC 12 #define TFT_CLK 11 #define TFT_CS 10 #define TFT_MISO 9
Air001的引脚:
硬件SPI引脚(PA_5,PA_7) #define TFT_CS PB_0 #define TFT_RST PA_1 #define TFT_DC PA_4 #define TFT_MOSI PA_7 #define TFT_SCLK PA_5
注意:驱动的不同版本一般兼容,比如ST7789,ST7789V,ST7789V2,只是不同的屏幕分辨率,不同型号可能有某些参数不同,需要区别设置下
SSD1306(这个不属于TFT但临时放在这里吧):
屏幕:
库:U8g2(推荐) 或 ESP8266 and ESP32 OLED driver for SSD1306 displays(测试时4.4.1)
实例:随便
设置:
ESP8266 and ESP32 OLED driver for SSD1306 displays:
I2C: 附带的示例默认都是I2C的,随便打开一个示例,加入引脚设置,就可以直接运行: #define SDA 13 #define SCL 14 SPI: 先把I2C的注释掉: //#include "SSD1306Wire.h" //SSD1306Wire display(0x3c, SDA, SCL); 取消注释SPI的设置: #include "SSD1306Spi.h" #define CLK 10 #define RST 11 #define DC 12 #define CS 13 #define MOSI 14 SSD1306Spi display(RST, DC, CS); 注:SPI的没测过,只是看注释部分应该是这样用
ssd1327:
屏幕:【淘宝】https://m.tb.cn/h.5zn7evSrVPNgMbz?tk=gKI9WKREaD0 MF6563 「1.5寸日本进口 128128带灰阶oled屏 spi串口 有资料」
注:买来的这块屏的排线内部接触不良,导致连接屏幕后什么都不显示,要把排线往上用力托起来
库:Adafruit SSD1327 或 u8g2
实例:随便
设置:
Adafruit_SSD1327: 修改SPI相关引脚,给硬件SPI取消注释,并且注释默认的I2C函数 #define OLED_CS D8 #define OLED_DC D3 #define OLED_RESET D4 // hardware SPI Adafruit_SSD1327 display(128, 128, &SPI, OLED_DC, OLED_RESET, OLED_CS); u8g2: 取消注释 U8G2_SSD1327_MIDAS_128X128_F_4W_HW_SPI u8g2(U8G2_R0, /* cs=*/ D8, /* dc=*/ D3, /* reset=*/ D4);
ili9341:
屏幕:【淘宝】https://m.tb.cn/h.5u0mXA8T7ooDhE7?tk=SYlrWP3iyCw HU0025 「全新2.8寸TFT液晶屏 SPI串口屏240*320 4线IO 驱动ILI934118PIN」
库:Adafruit_ILI9341
示例:graphicstest
设置:
在代码里添加引脚映射 #define TFT_MOSI 14 #define TFT_RST 13 #define TFT_DC 12 #define TFT_CLK 11 #define TFT_CS 10 #define TFT_MISO 9 根据是软SPI还是硬SPI,选择其中一个 //Adafruit_ILI9341 tft = Adafruit_ILI9341(TFT_CS, TFT_DC); //硬件SPI Adafruit_ILI9341 tft = Adafruit_ILI9341(TFT_CS, TFT_DC, TFT_MOSI, TFT_CLK, TFT_RST, TFT_MISO);
st7565 / uc1701:
屏幕:老王3.6寸12864 SPI屏幕(已下架)库:u8g2
示例:GraphicsTest
设置:
GraphicsTest 加入以下其中一行,F是FullBuffer的意思,如果想硬件驱动就用那个参数最少的 切记,这块屏幕默认对比度太低,运行起来看不清的,要在setup里的u8g2.begin();后面加一行u8g2.setContrast(200);设置一个比较高的对比度(最高255) 这块屏幕的引脚(从1到9):1.CS 2.RST 3.A0(DC) 4.SCK 5.SDA 6.VCC(3V) 7.GND 8.LED- 9.LED+(3V) //U8G2_ST7565_LX12864_1_4W_SW_SPI u8g2(U8G2_R0, /* clock=*/ D5, /* data=*/ D7, /* cs=*/ D8, /* dc=*/ D3, /* reset=*/ D4); //U8G2_ST7565_LX12864_F_4W_SW_SPI u8g2(U8G2_R0, /* clock=*/ D5, /* data=*/ D7, /* cs=*/ D8, /* dc=*/ D3, /* reset=*/ D4); //U8G2_ST7565_LX12864_F_4W_HW_SPI u8g2(U8G2_R0, /* cs=*/ D8, /* dc=*/ D3, /* reset=*/ D4);
st7789:
屏幕:【淘宝】https://m.tb.cn/h.5Ga4BuEXHLopuQv?tk=4gPtWPWtEv1 CZ3460 「高清ips 0.96寸 1.3寸 TFT显示屏 OLED 液晶屏 ST7735驱动」(1.3寸st7789)库:TFT_eSPI(测试时版本2.5.34)
链接:GitHub - Bodmer/TFT_eSPI: Arduino and PlatformIO IDE compatible TFT library optimised for the Raspberry Pi Pico (RP2040), STM32, ESP8266 and ESP32 that supports different driver chips
示例:随便
设置:
这个库的例子不需要改引脚,改为在库源码目录里修改。 C:\Users\jeaso\Documents\Arduino\libraries\TFT_eSPI\User_Setup.h 把45行注释,并且55行左右的注释去掉,声明要用7789的驱动,#define ST7789_DRIVER
切记,因为默认选择的是ili9341驱动,所以要把ili9341的那一行注释掉,否则同时选中两个驱动,虽然编译不会报错,但是默认用ili9341,神奇的是也能驱动屏幕,但是屏幕显示方向错误,并且颜色不正常。 把88行的屏幕分辨率设置一下 #define TFT_WIDTH 240 // ST7789 240 x 240 and 240 x 320 #define TFT_HEIGHT 240 // ST7789 240 x 240 170行左右声明了引脚 #define TFT_MISO PIN_D6 // Automatically assigned with ESP8266 if not defined #define TFT_MOSI PIN_D7 // Automatically assigned with ESP8266 if not defined #define TFT_SCLK PIN_D5 // Automatically assigned with ESP8266 if not defined #define TFT_CS PIN_D8 // Chip select control pin D8 #define TFT_DC PIN_D3 // Data Command control pin #define TFT_RST PIN_D4 // Reset pin (could connect to NodeMCU RST, see next line) 至于PIN_DXX对应的是哪个物理引脚,可以在User_Setup_Select.h里末尾的地方看到,搜下关键字就找到了
默认SPI帧率是27MHz,可以改成40MHz,提高速度。如果是ESP32S3这种,还可以在硬件SPI的条件下改成80MHz
//#define SPI_FREQUENCY 27000000
#define SPI_FREQUENCY 40000000
但是不是越高越高,不少屏幕都有限制,像ili9341就推荐40,80会出现一些渲染错误
// With an ILI9341 display 40MHz works OK, 80MHz sometimes fails
// With a ST7735 display more than 27MHz may not work (spurious pixels and lines)
st7789v(这个库有BUG不支持8266?显示一点内容后就不断重启,以前记得不会)
屏幕:【淘宝】https://m.tb.cn/h.5Gmg01fUQypAIZp?tk=ybgWWPWSmDK CZ3452 「1.14寸TFT显示屏LCD彩色液晶屏 ST7789驱动135x240分辨率 高清IPS」库:st7789v-arduino(测试时版本0.1,该库没上arduino官方仓库)
链接:GitHub - deirvlon/ST7789v-Arduino: ST7789v Arduino Library - Tested on Arduino UNO and STM32 (Blue Pill)
例子:graphicsTEST.ino
设置:
先从github上下载仓库的zip文件,然后打开arduino -> 项目 -> 导入库 -> 添加.zip库,然后选择该库的示例文件即可
引脚跟上面一样配置 #define TFT_DC D3 #define TFT_RST D4 #define TFT_CS D8 // only for displays with CS pin #define TFT_MOSI D7 // for hardware SPI data pin (all of available pins) #define TFT_SCLK D5 // for hardware SPI sclk pin (all of available pins) 取消注释这一行,取代默认打开的那一行,ST7789v_arduino tft = ST7789v_arduino(TFT_DC, TFT_RST, TFT_CS); //for display 用硬件SPI的方式模拟 然后在setup里修改屏幕分辨率:tft.init(135, 240);
st7789v2(存疑,不知道测试屏幕是否真的为st7789v2)
屏幕:【淘宝】https://m.tb.cn/h.5tAtyKgr5yIYo5Z?tk=0JnHWPWiLLw HU9196 「2.0寸tft液晶屏lcd屏240*320焊接12Pin2寸ips全视角st7789串口SPI」(商家文档说是st7789v2,但是用st7789的库也可以直接运行)库:Adafruit ST7735 and ST7789 Library(测试时版本1.10.3) 或者参考上面st7789的TFT_eSPI库(这个库最完美)也可以运行,上面st7789v的st7789v-arduino也能点亮,输出文字,但是设置有问题,不停重启屏幕
链接:GitHub - adafruit/Adafruit-ST7735-Library: This is a library for the Adafruit 1.8" SPI display http://www.adafruit.com/products/358 and http://www.adafruit.com/products/618
示例:graphicstest_st7789
设置:
Adafruit_ST7789 tft = Adafruit_ST7789(TFT_CS, TFT_DC, TFT_RST);
// 修改8266的引脚 #elif defined(ESP8266) #define TFT_CS D8 #define TFT_RST D4 #define TFT_DC D3 // 设置屏幕分辨率 // Use this initializer (uncomment) if using a 1.3" or 1.54" 240x240 TFT:
tft.init(240, 320); // Init ST7789 240x240
// 如果屏幕颠倒了旋转下
tft.setRotation(rotation)
// 如果屏幕刷新太快,可以手动设置下SPI的速度
st7735s
屏幕:【淘宝】https://m.tb.cn/h.5wT3LddBbmR0aDy?tk=YXBwWn5xKm3 CZ0000 「0.96寸高清ips tft显示屏液晶屏st7735 0.96寸TFT全彩屏 液晶屏」库:TFT_eSPI(测试时版本2.5.34)或 Adafruit ST7735 and ST7789 Library 或 Ucglib (1.5.2)
示例:随便
设置:
TFT_eSPI:
跟上面st7789的一样,不同的是:
1.驱动选 #define ST7735_DRIVER
2.#define TFT_WIDTH 80
3.#define TFT_HEIGHT 160
4.注意,160x80这个分辨率的要开启颜色反转,不然显示不正常:#define ST7735_GREENTAB160x80 // For 160 x 80 display (BGR, inverted, 26 offset)
Adafruit ST7735 and ST7789 Library:
跟上面一样,不同的是:
1.驱动选7735:Adafruit_ST7735 tft = Adafruit_ST7735(TFT_CS, TFT_DC, TFT_RST);
2.如果是160x80则选:tft.initR(INITR_MINI160x80_PLUGIN); // Init ST7735S mini display