- Name: ST7735
- Description: Library for TFT SPI LCD, ST7735 Driver,.
- Author: Gavin Lyons
- STM32: STM32F070RB nucleo-64
- Toolchain: STM32cubeIDE, HAL, C.
- Note: this is a fork of PIC project at link
Tested
These two are the only type of ST7735 library tested on, but should work on other types in theory.
- TFT SPI LCD, ST7735 Driver, Red PCB v1.1, 1.44 , 128 x 128 pixels, "ST7735R Red Tab"
- TFT SPI LCD, ST7735 Driver, Red PCB v1.2, 1.8 , 128 x 160 pixels, "ST7735S Black Tab"
No support for built-in SD card holder (that some modules have) at present and backlight control is left to user.
Screen Size settings
In the setup() function in USER OPTION 1 Screen Setup. Select your PCB size and offsets. User can adjust pixel height, pixel width and screen offsets in the header file. When calling function TFTInitScreenSize(OFFSET_COL, OFFSET_ROW , TFT_PIXEL_WIDTH , TFT_PIXEL_HEIGHT).
PCB Version
There are 4 types of the ST7735 TFT display supported.. User picks the one they want when calling TFTInitPCBType() function See USER OPTION 2 PCB_TYPE in Setup() function in main.c
| Number | Description | Enum label |
|---|---|---|
| 1 | ST7735B controller | TFT_ST7735B |
| 2 | ST7735R Green Tab | TFT_ST7735R_Green |
| 3 | ST7735R Red Tab | TFT_ST7735R_Red |
| 4 | ST7735S Black Tab | TFT_ST7735S_Black |
Fonts
Six fonts are included. USER OPTION 3 FONT at start of font file to turn off unused fonts to save memory.
Six fonts available :
| Font num | Font name | Pixel size | Note |
|---|---|---|---|
| 1 | Default | 5x8 | ------ |
| 2 | Thick | 7x8 | no lowercase letters |
| 3 | Seven segment | 4x8 | ------ |
| 4 | Wide | 8x8 | no lowercase letters |
| 5 | Tiny | 3x8 | ------ |
| 6 | HomeSpun | 7x8 | ------ |
SPI
This library supports both Hardware SPI and software SPI. Change the define a top of header file to switch between the two. USER OPTION 4 SPI TYPE.
Files
The Main.c contains tests showing library functions There is an TFT library (ST7735_TFT.c and ST7735_TFT.h), There are font files that contains ASCII pixel fonts. There are bitmap data files that contain the bitmap test data used by the main.c to test functions
fill Rectangles functions
| Num | Function Name | Note |
|---|---|---|
| 1 | TFTfillRectangle | --- |
| 2 | TFTfillRect | uses TFTdrawFastVLine |
| 3 | TFTfillRectangleBuffer | Uses buffered writes , ~5 times faster than #1 & #2 |
| 4 | TFTfillScreen | Wraps #1 |
| 5 | TFTfillScreenBuffer | Wraps #3 |
Bitmap
There are 4 functions to support drawing bitmaps. Full color bitmaps will take up a lot of memory on this device. In the bitmap data file you can switch off the tests in USER OPTION 5.
| Num | Function Name | Colour support | bitmap size Max | Note |
|---|---|---|---|---|
| 1 | Icon | bi-colour | (8 x (0-Max_y)) | useful to create icons or fill rows with patterns ,Data vertically addressed |
| 2 | Bitmap | bi-colour | 2048 bytes | Data horizontally addressed |
| 3 | BitmapBuffer | bi-colour | 2048 bytes | Data horizontally addressed , uses buffered writes , 25 times faster than #2 |
| 4 | Bitmap1624Buffer | 16 bit or 24 bit color | 32768 or 49152 | Data from Array 24 bit Converted by software to 16-bit color, uses buffered writes |
- Bitmap size in kiloBytes = (screenWidth * screenHeight * bitsPerPixel)/(1024 * 8)
- Math in bitmap size column 2-4 assumes 128x128 pixel screen.
- The data array for 1 -3 is created from image files using file data conversion tool link
- The data array for 4 is created from BMP files using file data conversion tool link
Connections
| TFT PinNum | Pindesc | STM32 SW SPI | STM32 HW SPI |
|---|---|---|---|
| 1 | LED | VCC | VCC |
| 2 | SCLK | PA1 | PB3 SPI1_SCK |
| 3 | SDA | PA0 | PA7 SPI1_MOSI |
| 4 | A0/DC | PC1 | PC1 |
| 5 | RESET | PC0 | PC0 |
| 6 | SS/CS | PC2 | PC2 |
| 7 | GND | GND | GND |
| 8 | VCC | VCC | VCC |
- NOTE connect LED backlight pin 1 thru a 150R to 220R ohm resistor to 3.3V or 5V VCC.
- This is a 3.3V logic device do NOT connect the I/O logic lines to 5V.
- You can connect VCC to 5V if there is a 3.3 volt regulator on back of TFT module.
Output of some of the test routine's on a 128x128 TFT.
- Different defined colors at default font size 1. Full 16 bit colour 565 available
- Different sizes of default font: 2,3,4 & 5 . Are fonts are scale-able
- Different Fonts at font size 2, six fonts included . font 6 not shown here.
- Shapes.
- MORE shapes!
- Bitmap (bi-color) A background and a foreground.
- 16 bit color bitmap 128x128 image included in test data
- 24 bit color bitmap 64x64 image included in test data
Timer16 and Usart are included just for the Frames per second test TestFPS.