Example code for driving M5StickC-Plus/Plus2 ST7789V2 display using ESP-IDF's SPI driver.
M5StickC-Plus/Plus2 has 135x240 ST7789V2 tft.
esp-idf v4.4/v5.x.
git clone https://github.com/nopnop2002/esp-idf-m5stickC-Plus
cd esp-idf-m5stickC-Plus/screen
idf.py set-target esp32
idf.py menuconfig
idf.py flash -b 115200 monitor
You need to specify Baud rate for flashing.
It's possible to text rotation and invert.
It's possible to indicate more than one font at the same time.
BMP file
JPEG file
PNG file
This project uses the following as default fonts:
- fonts/ILGH16XB.FNT // 8x16Dot Gothic
- fonts/ILGH24XB.FNT // 12x24Dot Gothic
- fonts/ILGH32XB.FNT // 16x32Dot Gothic
- fonts/ILMH16XB.FNT // 8x16Dot Mincyo
- fonts/ILMH24XB.FNT // 12x24Dot Mincyo
- fonts/ILMH32XB.FNT // 16x32Dot Mincyo
From 0x00 to 0x7f, the characters image of Alphanumeric are stored.
From 0x80 to 0xff, the characters image of Japanese are stored.
Changing this file will change the font.
You can add your original font file.
The format of the font file is the FONTX format.
Your font file is put in font directory.
When you build the firmware, the font files are uploaded to the SPIFFS partition.
Please refer this page about FONTX format.
There is a font file editor.
This can be done on Windows 10.
Developer page is here.
step1)
download Font File Editor(FONTX Editor) from here.
step2)
download BDF font file from Internet.
fontxedit.exe can ONLY import Monospaced bitmap fonts file.
Monospaced bitmap fonts can also be downloaded here.
u8g2 library contains many BDF fonts.
step3)
import the BDF font file into your fontxedit.exe.
this tool can convert from BDF to FONTX.
step4)
check font pattern.
step5)
adjust font size.
step6)
save as .fnt file from your fontedit.exe.
step7)
upload your font file to $HOME/esp-idf-m5stickC-Plus/fonts directory.
step8)
add font to use
FontxFile fx32E[2];
InitFontx(fx32E,"/fonts/emoticons21.fnt",""); // 24x24Dot Smile
FontxFile fx32S[2];
InitFontx(fx32S,"/fonts/Scroll-o-Sprites.fnt",""); // 16x16Dot Emoji
This is a 24x24 font converted from emoticons21.bdf from u8g2 library.
This is a 16x16 font converted from Scroll-o-Sprites.bdf from u8g2 library.
step1)
Download WFONTX64.exe from here.
Developer page is here.
step2)
Select ttf font.
Please note that if you select a proportional font, some fonts may not convert correctly.
If you select a proportional font, some fonts will need to be modified using fontxedit.exe.
Monospaced fonts can be converted correctly.
step3)
Enter Height, Width, FontX2 name.
Specify half of Height for Width.
Specify your favorite font name in the FontX2 name field using up to 8 characters.
step4)
Specify the file name to save.
step5)
Specify the font style as required.
step6)
Press the RUN button to convert TTF fonts to FONTX format.
step7)
upload your font file to $HOME/esp-idf-m5stickC-Plus/fonts directory.
step8)
add font to use
FontxFile fx16G[2];
FontxFile fx24G[2];
FontxFile fx32G[2];
//InitFontx(fx16G,"/fonts/ILGH16XB.FNT",""); // 8x16Dot Gothic
//InitFontx(fx24G,"/fonts/ILGH24XB.FNT",""); // 12x24Dot Gothic
//InitFontx(fx32G,"/fonts/ILGH32XB.FNT",""); // 16x32Dot Gothic
InitFontx(fx16G,"/fonts/Gigi16.FNT",""); // 8x16Dot Gigi
InitFontx(fx24G,"/fonts/Gigi24.FNT",""); // 12x24Dot Gigi
InitFontx(fx32G,"/fonts/Gigi32.FNT",""); // 16x32Dot Gigi
Change here.
#define RED rgb565(255, 0, 0) // 0xf800
#define GREEN rgb565( 0, 255, 0) // 0x07e0
#define BLUE rgb565( 0, 0, 255) // 0x001f
#define BLACK rgb565( 0, 0, 0) // 0x0000
#define WHITE rgb565(255, 255, 255) // 0xffff
#define GRAY rgb565(128, 128, 128) // 0x8410
#define YELLOW rgb565(255, 255, 0) // 0xFFE0
#define CYAN rgb565( 0, 156, 209) // 0x04FA
#define PURPLE rgb565(128, 0, 128) // 0x8010