arduino/TFT_eSPI
1
0
Fork 0
mirror of https://github.com/Bodmer/TFT_eSPI.git synced 2024-09-21 10:27:11 +00:00
Code Issues Packages Projects Releases Wiki Activity
046e48f8c3
TFT_eSPI/User_Setup_Select.h

134 lines
6.3 KiB
C
Raw Normal View History

First draft release Not yet fully tested but seems to work OK!
2017-02-22 03:07:17 +00:00
// This header file contains a list of user setup files and defines which one the
Make setup files consistent User setups are now all based on the same template.
2018-02-09 21:52:26 +00:00
// compiler uses when the IDE performs a Verify/Compile or Upload.
First draft release Not yet fully tested but seems to work OK!
2017-02-22 03:07:17 +00:00
//
Make setup files consistent User setups are now all based on the same template.
2018-02-09 21:52:26 +00:00
// Users can create configurations for different Espressif boards and TFT displays.
First draft release Not yet fully tested but seems to work OK!
2017-02-22 03:07:17 +00:00
// This makes selecting between hardware setups easy by "uncommenting" one line.
// The advantage of this hardware configuration method is that the examples provided
// with the library should work with different setups immediately without any other
Added support for RPi TFT 16 bit serial based ILI9486 supported
2017-03-24 23:23:35 +00:00
// changes being needed. It also improves the portability of users sketches to other
First draft release Not yet fully tested but seems to work OK!
2017-02-22 03:07:17 +00:00
// hardware configurations and compatible libraries.
//
Add smooth (antialiased) fonts
2018-02-24 19:02:20 +00:00
// Create a shortcut to this file on your desktop to permit quick access for editing.
First draft release Not yet fully tested but seems to work OK!
2017-02-22 03:07:17 +00:00
// Re-compile and upload after making and saving any changes to this file.
Update with multiple User_Setup file option Added Tools folder and licence for Marek's screenshot viewer utility
2017-02-22 10:04:26 +00:00
// Customised User_Setup files are stored in the "User_Setups" folder.
First draft release Not yet fully tested but seems to work OK!
2017-02-22 03:07:17 +00:00
Added Waveshare ePaper support Also added ability to push 1bpp bitmaps to a Sprite to support rendering images on an EPaper screen. Floyd-Steinberg dithering and basic graphics example added as first ePaper demo.
2018-04-02 01:53:42 +00:00
#ifndef USER_SETUP_LOADED // Lets PlatformIO users define settings in
Performance enhancements, new functions, bug fixes 1. Ability to swap bytes in pushColors() and pushImage() 2. pushImage() will handle FLASH stroed images 3. pushImage() will accept a transparent color 4. pushRect() deprecated but still works 5. setSwapBytes() to set swapping bytes in color for pushImage() and pushColors() true or false 6. getSwapBytes() returns swap bytes parameter 7. fillCircle() and fillCircleHelper() changed to use horizontal lines to speed up plotting in a sprite 8. fillTriangle bug fix by moving spi_begin() 9 Small performance improvement to setAddrWindow() 10. pushColor() bug fix for swapped bytes 11. pushColors() performance improvement for ESP8266 and add optional byte swap parameter, accepts higher pixel count 12. move spi_begin() later in drawLine() incase fn returns early 13. add spi_end() in drawLine incdae return occurs early 14. Add color332() fn to convert 16 bit to 8 bit colour 15. Sprite: createSprite() checks if sprite already created and returns pointer if it does 16. Sprite: one extra "off-screen pixel added to a sprite to point out-of-bounds setWindow coords to this avoids extra bounds checks in push/write color 17. Sprite: setColorDepth allows changing of depthe for existing sprtie and returns a new pointer to the new sprite 18. Sprite: pushImage() accepts a swapped byte parameter 19. Sprite: setSwapBytes() to set swapping bytes in color for pushImage() and pushColors() true or false 20. Sprite: getSwapBytes() returns swap bytes parameter 21. Sprite: setWindow deals with duff out of sprite coords. 22. Sprite: bug in draw char corrected which could draw too many over-writing pixels
2018-01-08 23:19:42 +00:00
// platformio.ini, see notes in "Tools" folder.
// Only ONE line below should be uncommented. Add extra lines and files as needed.
Correct default setup file called up
2017-02-22 22:56:32 +00:00
#include <User_Setup.h> // Default setup is root library folder
Update with multiple User_Setup file option Added Tools folder and licence for Marek's screenshot viewer utility
2017-02-22 10:04:26 +00:00
Change \ in file path to / for Windows AND Linux compatibility
2017-03-09 22:37:25 +00:00
//#include <User_Setups/Setup1_ILI9341.h> // Setup file configured for my ILI9341
//#include <User_Setups/Setup2_ST7735.h> // Setup file configured for my ST7735
//#include <User_Setups/Setup3_ILI9163.h> // Setup file configured for my ILI9163
//#include <User_Setups/Setup4_S6D02A1.h> // Setup file configured for my S6D02A1
Add RPi display support for write strobe mod
2017-03-27 01:15:30 +00:00
//#include <User_Setups/Setup5_RPi_ILI9486.h> // Setup file configured for my stock RPi TFT
//#include <User_Setups/Setup6_RPi_Wr_ILI9486.h> // Setup file configured for my modified RPi TFT
Add support for ST7735 128x128 display May not cater for 128x128 ST7735 displays with different RGB and offset configurations.
2017-04-16 15:13:12 +00:00
//#include <User_Setups/Setup7_ST7735_128x128.h> // Setup file configured for my ST7735 128x128 display
Add ILI9163 129 x 128 display support
2017-04-18 22:15:59 +00:00
//#include <User_Setups/Setup8_ILI9163_128x128.h> // Setup file configured for my ILI9163 128x128 display
Add SPI overlap support Issue #26 Note, must use latest ESP board package with support for the overlap mode
2017-07-15 17:44:49 +00:00
//#include <User_Setups/Setup9_ST7735_Overlap.h> // Setup file configured for my ST7735
Added Waveshare ePaper support Also added ability to push 1bpp bitmaps to a Sprite to support rendering images on an EPaper screen. Floyd-Steinberg dithering and basic graphics example added as first ePaper demo.
2018-04-02 01:53:42 +00:00
//#include <User_Setups/Setup10_RPi_touch_ILI9486.h> // Setup file configured for ESP8266 and RPi TFT with touch
//#include <User_Setups/Setup11_RPi_touch_ILI9486.h> // Setup file configured for ESP32 and RPi TFT with touch
Add support for ESP32 based M5Stack
2018-02-08 00:45:18 +00:00
//#include <User_Setups/Setup12_M5Stack.h> // Setup file for the ESP32 based M5Stack
Add 8 bit parallel TFT support for ESP32 Add interface driver macro Add 8 bit parallel support Add 8 bit parallel read support Add ILI9481, ILI9488 and HX8357D drivers Update version and ReadMe Update Create_Font processing sketch Add slightly narrower alternative font 8
2018-03-10 23:08:57 +00:00
//#include <User_Setups/Setup13_ILI9481_Parallel.h> // Setup file for the ESP32 with parallel bus TFT
//#include <User_Setups/Setup14_ILI9341_Parallel.h> // Setup file for the ESP32 with parallel bus TFT
//#include <User_Setups/Setup15_HX8357D.h> // Setup file configured for HX8357D (untested)
//#include <User_Setups/Setup16_ILI9488_Parallel.h> // Setup file for the ESP32 with parallel bus TFT
Add support for ST7789 display (240 x 240)
2018-06-01 17:26:09 +00:00
//#include <User_Setups/Setup17_ePaper.h> // Setup file for any Waveshare ePaper display
//#include <User_Setups/Setup18_ST7789.h> // Setup file configured for HX8357D (untested)
Update with multiple User_Setup file option Added Tools folder and licence for Marek's screenshot viewer utility
2017-02-22 10:04:26 +00:00
Completed support for SPI ILI9488 Setup20 added for ESP8266 and Setup21 addwd for ESP32
2018-07-07 21:41:53 +00:00
//#include <User_Setups/Setup20_ILI9488.h> // Setup file for ESP8266 and ILI9488 SPI bus TFT
//#include <User_Setups/Setup21_ILI9488.h> // Setup file for ESP32 and ILI9488 SPI bus TFT
Add TTGO boards
2018-11-25 17:20:40 +00:00
//#include <User_Setups/Setup22_TTGO_T4.h> // Setup file for ESP32 and TTGO T4 (BTC) ILI9341 SPI bus TFT
//#include <User_Setups/Setup23_TTGO_TM.h> // Setup file for ESP32 and TTGO TM ST7789 SPI bus TFT
Completed support for SPI ILI9488 Setup20 added for ESP8266 and Setup21 addwd for ESP32
2018-07-07 21:41:53 +00:00
Add new anti-aliased (smooth) font examples + bug fixes Four new examples have been added to show different methods of rendering the anta-aliased fonts. A few minor bugs have been corrected associated with the font rendering. drawNumber and drawFloat handle fixed width mono fonts with no digit movement.
2018-10-21 16:53:27 +00:00
//#include <User_Setups/Setup43_ST7735.h> // Setup file configured for my ST7735S 80x160
Added Waveshare ePaper support Also added ability to push 1bpp bitmaps to a Sprite to support rendering images on an EPaper screen. Floyd-Steinberg dithering and basic graphics example added as first ePaper demo.
2018-04-02 01:53:42 +00:00
//#include <User_Setups/SetupX_Template.h>
Performance enhancements, new functions, bug fixes 1. Ability to swap bytes in pushColors() and pushImage() 2. pushImage() will handle FLASH stroed images 3. pushImage() will accept a transparent color 4. pushRect() deprecated but still works 5. setSwapBytes() to set swapping bytes in color for pushImage() and pushColors() true or false 6. getSwapBytes() returns swap bytes parameter 7. fillCircle() and fillCircleHelper() changed to use horizontal lines to speed up plotting in a sprite 8. fillTriangle bug fix by moving spi_begin() 9 Small performance improvement to setAddrWindow() 10. pushColor() bug fix for swapped bytes 11. pushColors() performance improvement for ESP8266 and add optional byte swap parameter, accepts higher pixel count 12. move spi_begin() later in drawLine() incase fn returns early 13. add spi_end() in drawLine incdae return occurs early 14. Add color332() fn to convert 16 bit to 8 bit colour 15. Sprite: createSprite() checks if sprite already created and returns pointer if it does 16. Sprite: one extra "off-screen pixel added to a sprite to point out-of-bounds setWindow coords to this avoids extra bounds checks in push/write color 17. Sprite: setColorDepth allows changing of depthe for existing sprtie and returns a new pointer to the new sprite 18. Sprite: pushImage() accepts a swapped byte parameter 19. Sprite: setSwapBytes() to set swapping bytes in color for pushImage() and pushColors() true or false 20. Sprite: getSwapBytes() returns swap bytes parameter 21. Sprite: setWindow deals with duff out of sprite coords. 22. Sprite: bug in draw char corrected which could draw too many over-writing pixels
2018-01-08 23:19:42 +00:00
#endif // USER_SETUP_LOADED
Update to screenshot sketches + others Minor tweaks and re-arrangement of User and Custom font references between header files
2017-03-10 19:16:31 +00:00
/////////////////////////////////////////////////////////////////////////////////////
// //
// DON'T TINKER WITH ANY OF THE FOLLOWING LINES, THESE ADD THE TFT DRIVERS //
Add support for ST7735 128x128 display May not cater for 128x128 ST7735 displays with different RGB and offset configurations.
2017-04-16 15:13:12 +00:00
// AND ESP8266 PIN DEFINITONS THEY ARE HERE FOR BODMER'S CONVENIENCE! //
Update to screenshot sketches + others Minor tweaks and re-arrangement of User and Custom font references between header files
2017-03-10 19:16:31 +00:00
// //
/////////////////////////////////////////////////////////////////////////////////////
Format and code tidy - fixes for compatibility issues
2017-04-14 00:04:04 +00:00
Add option for different RGB colour order with ST7789 // For ST7789 ONLY, define the colour order IF the blue and red are swapped on your display //#define TFT_RGB_ORDER TFT_RGB // Colour order Red-Green-Blue //#define TFT_RGB_ORDER TFT_BGR // Colour order Blue-Green-Red
2018-11-19 23:49:32 +00:00
// Identical looking TFT displays may have a different colour ordering in the 16 bit colour
#define TFT_BGR 0 // Colour order Blue-Green-Red
#define TFT_RGB 1 // Colour order Red-Green-Blue
Update to screenshot sketches + others Minor tweaks and re-arrangement of User and Custom font references between header files
2017-03-10 19:16:31 +00:00
// Load the right driver definition - do not tinker here !
#if defined (ILI9341_DRIVER)
#include <TFT_Drivers/ILI9341_Defines.h>
Add support for 1 bit per pixel in Sprite class This is stage one of support for ePaper displays from Waveshare. Examples for 1 bit per pixel Sprites and 2 or 3 colour ePaper displays to follow soon.
2018-03-26 00:02:23 +00:00
#define TFT_DRIVER 0x9341
Update to screenshot sketches + others Minor tweaks and re-arrangement of User and Custom font references between header files
2017-03-10 19:16:31 +00:00
#elif defined (ST7735_DRIVER)
#include <TFT_Drivers/ST7735_Defines.h>
Add support for 1 bit per pixel in Sprite class This is stage one of support for ePaper displays from Waveshare. Examples for 1 bit per pixel Sprites and 2 or 3 colour ePaper displays to follow soon.
2018-03-26 00:02:23 +00:00
#define TFT_DRIVER 0x7735
Update to screenshot sketches + others Minor tweaks and re-arrangement of User and Custom font references between header files
2017-03-10 19:16:31 +00:00
#elif defined (ILI9163_DRIVER)
#include <TFT_Drivers/ILI9163_Defines.h>
Add support for 1 bit per pixel in Sprite class This is stage one of support for ePaper displays from Waveshare. Examples for 1 bit per pixel Sprites and 2 or 3 colour ePaper displays to follow soon.
2018-03-26 00:02:23 +00:00
#define TFT_DRIVER 0x9163
Update to screenshot sketches + others Minor tweaks and re-arrangement of User and Custom font references between header files
2017-03-10 19:16:31 +00:00
#elif defined (S6D02A1_DRIVER)
#include <TFT_Drivers/S6D02A1_Defines.h>
Add support for 1 bit per pixel in Sprite class This is stage one of support for ePaper displays from Waveshare. Examples for 1 bit per pixel Sprites and 2 or 3 colour ePaper displays to follow soon.
2018-03-26 00:02:23 +00:00
#define TFT_DRIVER 0x6D02
Added support for RPi TFT 16 bit serial based ILI9486 supported
2017-03-24 23:23:35 +00:00
#elif defined (RPI_ILI9486_DRIVER)
Support ST7789 rotation offset and boards with no chip select Other minor changes to tidy code up Put back in ability to call init() multiple times in sketch
2018-07-06 17:48:24 +00:00
#include <TFT_Drivers/ILI9486_Defines.h>
#define TFT_DRIVER 0x9486
#elif defined (ILI9486_DRIVER)
#include <TFT_Drivers/ILI9486_Defines.h>
Added Waveshare ePaper support Also added ability to push 1bpp bitmaps to a Sprite to support rendering images on an EPaper screen. Floyd-Steinberg dithering and basic graphics example added as first ePaper demo.
2018-04-02 01:53:42 +00:00
#define TFT_DRIVER 0x9486
Add 8 bit parallel TFT support for ESP32 Add interface driver macro Add 8 bit parallel support Add 8 bit parallel read support Add ILI9481, ILI9488 and HX8357D drivers Update version and ReadMe Update Create_Font processing sketch Add slightly narrower alternative font 8
2018-03-10 23:08:57 +00:00
#elif defined (ILI9481_DRIVER)
#include <TFT_Drivers/ILI9481_Defines.h>
Add support for 1 bit per pixel in Sprite class This is stage one of support for ePaper displays from Waveshare. Examples for 1 bit per pixel Sprites and 2 or 3 colour ePaper displays to follow soon.
2018-03-26 00:02:23 +00:00
#define TFT_DRIVER 0x9481
Add 8 bit parallel TFT support for ESP32 Add interface driver macro Add 8 bit parallel support Add 8 bit parallel read support Add ILI9481, ILI9488 and HX8357D drivers Update version and ReadMe Update Create_Font processing sketch Add slightly narrower alternative font 8
2018-03-10 23:08:57 +00:00
#elif defined (ILI9488_DRIVER)
#include <TFT_Drivers/ILI9488_Defines.h>
Add support for 1 bit per pixel in Sprite class This is stage one of support for ePaper displays from Waveshare. Examples for 1 bit per pixel Sprites and 2 or 3 colour ePaper displays to follow soon.
2018-03-26 00:02:23 +00:00
#define TFT_DRIVER 0x9488
Add 8 bit parallel TFT support for ESP32 Add interface driver macro Add 8 bit parallel support Add 8 bit parallel read support Add ILI9481, ILI9488 and HX8357D drivers Update version and ReadMe Update Create_Font processing sketch Add slightly narrower alternative font 8
2018-03-10 23:08:57 +00:00
#elif defined (HX8357D_DRIVER)
#include "TFT_Drivers/HX8357D_Defines.h"
Add support for 1 bit per pixel in Sprite class This is stage one of support for ePaper displays from Waveshare. Examples for 1 bit per pixel Sprites and 2 or 3 colour ePaper displays to follow soon.
2018-03-26 00:02:23 +00:00
#define TFT_DRIVER 0x8357
#elif defined (EPD_DRIVER)
#include "TFT_Drivers/EPD_Defines.h"
#define TFT_DRIVER 0xE9D
Add support for ST7789 display (240 x 240)
2018-06-01 17:26:09 +00:00
#elif defined (ST7789_DRIVER)
#include "TFT_Drivers/ST7789_Defines.h"
#define TFT_DRIVER 0x7789
Added Waveshare ePaper support Also added ability to push 1bpp bitmaps to a Sprite to support rendering images on an EPaper screen. Floyd-Steinberg dithering and basic graphics example added as first ePaper demo.
2018-04-02 01:53:42 +00:00
#elif defined (XYZZY_DRIVER) // <<<<<<<<<<<<<<<<<<<<<<<< ADD NEW DRIVER HERE
#include "TFT_Drivers/XYZZY_Defines.h"
#define TFT_DRIVER 0x0000
#else
#define TFT_DRIVER 0x0000
Update to screenshot sketches + others Minor tweaks and re-arrangement of User and Custom font references between header files
2017-03-10 19:16:31 +00:00
#endif
Format and code tidy - fixes for compatibility issues
2017-04-14 00:04:04 +00:00
Add option for different RGB colour order with ST7789 // For ST7789 ONLY, define the colour order IF the blue and red are swapped on your display //#define TFT_RGB_ORDER TFT_RGB // Colour order Red-Green-Blue //#define TFT_RGB_ORDER TFT_BGR // Colour order Blue-Green-Red
2018-11-19 23:49:32 +00:00
Work around for D4 IDE bug A condition can exist where pin D4 is allocated a value of 0 The workaround is to define and use pin numbers in the PIN_Dx format
2017-04-14 14:45:40 +00:00
// These are the pins for all ESP8266 boards
Add support for 1 bit per pixel in Sprite class This is stage one of support for ePaper displays from Waveshare. Examples for 1 bit per pixel Sprites and 2 or 3 colour ePaper displays to follow soon.
2018-03-26 00:02:23 +00:00
// Name GPIO Function
#define PIN_D0 16 // WAKE
#define PIN_D1 5 // User purpose
#define PIN_D2 4 // User purpose
Update notes on ESP8266 pins
2018-07-09 09:54:05 +00:00
#define PIN_D3 0 // Low on boot means enter FLASH mode
#define PIN_D4 2 // TXD1 (must be high on boot to go to UART0 FLASH mode)
Add support for 1 bit per pixel in Sprite class This is stage one of support for ePaper displays from Waveshare. Examples for 1 bit per pixel Sprites and 2 or 3 colour ePaper displays to follow soon.
2018-03-26 00:02:23 +00:00
#define PIN_D5 14 // HSCLK
#define PIN_D6 12 // HMISO
#define PIN_D7 13 // HMOSI RXD2
Update notes on ESP8266 pins
2018-07-09 09:54:05 +00:00
#define PIN_D8 15 // HCS TXD0 (must be low on boot to enter UART0 FLASH mode)
Add support for 1 bit per pixel in Sprite class This is stage one of support for ePaper displays from Waveshare. Examples for 1 bit per pixel Sprites and 2 or 3 colour ePaper displays to follow soon.
2018-03-26 00:02:23 +00:00
#define PIN_D9 3 // RXD0
#define PIN_D10 1 // TXD0
#define PIN_MOSI 8 // SD1
#define PIN_MISO 7 // SD0
#define PIN_SCLK 6 // CLK
Add diagnostic sketches Do not load button class is touch screen chip select not defined
2018-04-11 00:03:26 +00:00
#define PIN_HWCS 0 // D3
Add support for 1 bit per pixel in Sprite class This is stage one of support for ePaper displays from Waveshare. Examples for 1 bit per pixel Sprites and 2 or 3 colour ePaper displays to follow soon.
2018-03-26 00:02:23 +00:00
#define PIN_D11 9 // SD2
#define PIN_D12 10 // SD4
Reference in New Issue Copy Permalink