esp-idf-m5stickC
Example code for driving M5StickC ST7735S display using ESP-IDF’s SPI driver.
M5StickC Schematic PDF is here.
M5StickC has 80x160 ST7735S tft.
Software requirements
ESP-IDF V5.2 or later.
Because this project uses the new I2C driver.
How to build
git clone https://github.com/nopnop2002/esp-idf-m5stickC
cd esp-idf-m5stickC/
idf.py set-target esp32
idf.py menuconfig
idf.py flash -b 115200 monitor
*There is no MENU ITEM where this application is peculiar.
You need to specify Baud rate for flashing.
Graphic support
Fonts support
It’s possible to text rotation and invert.
It’s possible to indicate more than one font at the same time.
Gothic Font.
Mincyo Font.
Font 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.
Font File Editor(FONTX Editor)
There is a font file editor.
This can be done on Windows 10.
Developer page is here.
Convert from BDF font to FONTX font
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/font 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.
Convert from TTF font to FONTX font
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/fonts directory.
step8)
add font to use
FontxFile fx16[2];
FontxFile fx24[2];
FontxFile fx32[2];
//InitFontx(fx16,"/fonts/ILGH16XB.FNT",""); // 8x16Dot Gothic
//InitFontx(fx24,"/fonts/ILGH24XB.FNT",""); // 12x24Dot Gothic
//InitFontx(fx32,"/fonts/ILGH32XB.FNT",""); // 16x32Dot Gothic
//InitFontx(fx16,"/fonts/ILMH16XB.FNT",""); // 8x16Dot Mincyo
//InitFontx(fx24,"/fonts/ILMH24XB.FNT",""); // 12x24Dot Mincyo
//InitFontx(fx32,"/fonts/ILMH32XB.FNT",""); // 16x32Dot Mincyo
InitFontx(fx16,"/fonts/Gigi16.FNT",""); // 8x16Dot Gigi
InitFontx(fx24,"/fonts/Gigi24.FNT",""); // 12x24Dot Gigi
InitFontx(fx32,"/fonts/Gigi32.FNT",""); // 16x32Dot Gigi
How to add your color
Change this:
#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
Reference
https://github.com/nopnop2002/esp-idf-m5stickC-Plus
评论