Guest User

Untitled

a guest
Aug 14th, 2025
176
0
Never
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
C++ 16.52 KB | None | 0 0
  1. //                            USER DEFINED SETTINGS
  2. //   Set driver type, fonts to be loaded, pins used and SPI control method etc
  3. //
  4. //   See the User_Setup_Select.h file if you wish to be able to define multiple
  5. //   setups and then easily select which setup file is used by the compiler.
  6. //
  7. //   If this file is edited correctly then all the library example sketches
  8. //   should run without the need to make any more changes for a particular
  9. //   hardware setup! Note that some sketches are designed for a particular TFT
  10. //   pixel width/height
  11.  
  12. // ##################################################################################
  13. //
  14. // Section 1. Call up the right driver file and any options for it
  15. //
  16. // ##################################################################################
  17.  
  18. // Define STM32 to invoke optimised processor support (only for STM32)
  19. // #define STM32
  20.  
  21. // Defining the STM32 board allows the library to optimise the performance
  22. // for UNO compatible "MCUfriend" style shields
  23. // #define NUCLEO_64_TFT
  24. // #define NUCLEO_144_TFT
  25.  
  26. // STM32 8 bit parallel only:
  27. // If STN32 Port A or B pins 0-7 are used for 8 bit parallel data bus bits 0-7
  28. // then this will improve rendering performance by a factor of ~8x
  29. // #define STM_PORTA_DATA_BUS
  30. // #define STM_PORTB_DATA_BUS
  31.  
  32. // Tell the library to use 8 bit parallel mode (otherwise SPI is assumed)
  33. // #define TFT_PARALLEL_8_BIT
  34.  
  35. // Display type -  only define if RPi display
  36. // #define RPI_DISPLAY_TYPE // 20MHz maximum SPI
  37.  
  38. // Only define one driver, the other ones must be commented out
  39. // #define ILI9341_DRIVER  // Generic driver for common displays
  40. #define ST7789_DRIVER
  41. // #define ILI9341_2_DRIVER     // Alternative ILI9341 driver, see
  42. // https://github.com/Bodmer/TFT_eSPI/issues/1172 #define ST7735_DRIVER      //
  43. // Define additional parameters below for this display #define ILI9163_DRIVER //
  44. // Define additional parameters below for this display #define S6D02A1_DRIVER
  45. // #define RPI_ILI9486_DRIVER // 20MHz maximum SPI
  46. // #define HX8357D_DRIVER
  47. // #define ILI9481_DRIVER
  48. // #define ILI9486_DRIVER
  49. // #define ILI9488_DRIVER     // WARNING: Do not connect ILI9488 display SDO to
  50. // MISO if other devices share the SPI bus (TFT SDO does NOT tristate when CS is
  51. // high) #define ST7789_DRIVER      // Full configuration option, define
  52. // additional parameters below for this display #define ST7789_2_DRIVER    //
  53. // Minimal configuration option, define additional parameters below for this
  54. // display #define R61581_DRIVER #define RM68140_DRIVER #define ST7796_DRIVER
  55. // #define SSD1351_DRIVER
  56. // #define SSD1963_480_DRIVER
  57. // #define SSD1963_800_DRIVER
  58. // #define SSD1963_800ALT_DRIVER
  59. // #define ILI9225_DRIVER
  60. // #define GC9A01_DRIVER
  61.  
  62. // Some displays support SPI reads via the MISO pin, other displays have a
  63. // single bi-directional SDA pin and the library will try to read this via the
  64. // MOSI line. To use the SDA line for reading data from the TFT uncomment the
  65. // following line:
  66.  
  67. // #define TFT_SDA_READ      // This option is for ESP32 ONLY, tested with
  68. // ST7789 and GC9A01 display only
  69.  
  70. // For ST7735, ST7789 and ILI9341 ONLY, define the colour order IF the blue and
  71. // red are swapped on your display Try ONE option at a time to find the correct
  72. // colour order for your display
  73.  
  74. //  #define TFT_RGB_ORDER TFT_RGB  // Colour order Red-Green-Blue
  75. //  #define TFT_RGB_ORDER TFT_BGR  // Colour order Blue-Green-Red
  76.  
  77. // For M5Stack ESP32 module with integrated ILI9341 display ONLY, remove // in
  78. // line below
  79.  
  80. // #define M5STACK
  81.  
  82. // For ST7789, ST7735, ILI9163 and GC9A01 ONLY, define the pixel width and
  83. // height in portrait orientation #define TFT_WIDTH  80 #define TFT_WIDTH  128
  84. // #define TFT_WIDTH  128 // ST7789 240 x 240 and 240 x 320
  85. #define TFT_WIDTH 240
  86. // #define TFT_WIDTH  320
  87. // #define TFT_HEIGHT 160
  88. // #define TFT_HEIGHT 128
  89. // #define TFT_HEIGHT 160 // ST7789 240 x 240
  90. #define TFT_HEIGHT 320  // ST7789 240 x 320
  91. // #define TFT_HEIGHT 240 // GC9A01 240 x 240 //#define TFT_HEIGHT 480
  92. // #define TFT_HEIGHT 480 //
  93.  
  94. // For ST7735 ONLY, define the type of display, originally this was based on the
  95. // colour of the tab on the screen protector film but this is not always true,
  96. // so try out the different options below if the screen does not display
  97. // graphics correctly, e.g. colours wrong, mirror images, or stray pixels at the
  98. // edges. Comment out ALL BUT ONE of these options for a ST7735 display driver,
  99. // save this this User_Setup file, then rebuild and upload the sketch to the
  100. // board again:
  101.  
  102. // #define ST7735_INITB
  103. // #define ST7735_GREENTAB
  104. // #define ST7735_GREENTAB2
  105. // #define ST7735_GREENTAB3
  106. // #define ST7735_GREENTAB128    // For 128 x 128 display
  107. // #define ST7735_GREENTAB160x80 // For 160 x 80 display (BGR, inverted, 26
  108. // offset) #define ST7735_REDTAB #define ST7735_BLACKTAB #define
  109. // ST7735_REDTAB160x80   // For 160 x 80 display with 24 pixel offset
  110.  
  111. // If colours are inverted (white shows as black) then uncomment one of the next
  112. // 2 lines try both options, one of the options should correct the inversion.
  113.  
  114. // #define TFT_INVERSION_ON
  115. // #define TFT_INVERSION_OFF
  116.  
  117. // ##################################################################################
  118. //
  119. // Section 2. Define the pins that are used to interface with the display here
  120. //
  121. // ##################################################################################
  122.  
  123. // If a backlight control signal is available then define the TFT_BL pin in
  124. // Section 2 below. The backlight will be turned ON when tft.begin() is called,
  125. // but the library needs to know if the LEDs are ON with the pin HIGH or LOW. If
  126. // the LEDs are to be driven with a PWM signal or turned OFF/ON then this must
  127. // be handled by the user sketch. e.g. with digitalWrite(TFT_BL, LOW);
  128.  
  129. // #define TFT_BL   27            // LED back-light control pin
  130. // #define TFT_BACKLIGHT_ON HIGH  // Level to turn ON back-light (HIGH or LOW)
  131.  
  132. // We must use hardware SPI, a minimum of 3 GPIO pins is needed.
  133. // Typical setup for ESP8266 NodeMCU ESP-12 is :
  134. //
  135. // Display SDO/MISO  to NodeMCU pin D6 (or leave disconnected if not reading
  136. // TFT) Display LED       to NodeMCU pin VIN (or 5V, see below) Display SCK to
  137. // NodeMCU pin D5 Display SDI/MOSI  to NodeMCU pin D7 Display DC (RS/AO)to
  138. // NodeMCU pin D3 Display RESET     to NodeMCU pin D4 (or RST, see below)
  139. // Display CS        to NodeMCU pin D8 (or GND, see below)
  140. // Display GND       to NodeMCU pin GND (0V)
  141. // Display VCC       to NodeMCU 5V or 3.3V
  142. //
  143. // The TFT RESET pin can be connected to the NodeMCU RST pin or 3.3V to free up
  144. // a control pin
  145. //
  146. // The DC (Data Command) pin may be labelled AO or RS (Register Select)
  147. //
  148. // With some displays such as the ILI9341 the TFT CS pin can be connected to GND
  149. // if no more SPI devices (e.g. an SD Card) are connected, in this case comment
  150. // out the #define TFT_CS line below so it is NOT defined. Other displays such
  151. // at the ST7735 require the TFT CS pin to be toggled during setup, so in these
  152. // cases the TFT_CS line must be defined and connected.
  153. //
  154. // The NodeMCU D0 pin can be used for RST
  155. //
  156. //
  157. // Note: only some versions of the NodeMCU provide the USB 5V on the VIN pin
  158. // If 5V is not available at a pin you can use 3.3V but backlight brightness
  159. // will be lower.
  160.  
  161. // ###### EDIT THE PIN NUMBERS IN THE LINES FOLLOWING TO SUIT YOUR ESP8266 SETUP
  162. // ######
  163.  
  164. // For NodeMCU - use pin numbers in the form PIN_Dx where Dx is the NodeMCU pin
  165. // designation
  166. // #define TFT_CS   PIN_D8  // Chip select control pin D8
  167. // #define TFT_DC   PIN_D3  // Data Command control pin
  168. // #define TFT_RST  PIN_D4  // Reset pin (could connect to NodeMCU RST, see next
  169. // line) #define TFT_RST  -1    // Set TFT_RST to -1 if the display RESET is
  170. // connected to NodeMCU RST or 3.3V
  171.  
  172. // #define TFT_BL PIN_D1  // LED back-light (only for ST7789 with backlight
  173. // control pin)
  174.  
  175. // #define TOUCH_CS PIN_D2     // Chip select pin (T_CS) of touch screen
  176.  
  177. // #define TFT_WR PIN_D2       // Write strobe for modified Raspberry Pi TFT
  178. // only
  179.  
  180. // ######  FOR ESP8266 OVERLAP MODE EDIT THE PIN NUMBERS IN THE FOLLOWING LINES
  181. // ######
  182.  
  183. // Overlap mode shares the ESP8266 FLASH SPI bus with the TFT so has a
  184. // performance impact but saves pins for other functions. It is best not to
  185. // connect MISO as some displays do not tristate that line when chip select is
  186. // high! On NodeMCU 1.0 SD0=MISO, SD1=MOSI, CLK=SCLK to connect to TFT in
  187. // overlap mode On NodeMCU V3  S0 =MISO, S1 =MOSI, S2 =SCLK In ESP8266 overlap
  188. // mode the following must be defined
  189.  
  190. // #define TFT_SPI_OVERLAP
  191.  
  192. // In ESP8266 overlap mode the TFT chip select MUST connect to pin D3
  193. // #define TFT_CS   PIN_D3
  194. // #define TFT_DC   PIN_D5  // Data Command control pin
  195. // #define TFT_RST  PIN_D4  // Reset pin (could connect to NodeMCU RST, see next
  196. // line) #define TFT_RST  -1  // Set TFT_RST to -1 if the display RESET is
  197. // connected to NodeMCU RST or 3.3V
  198.  
  199. // ###### EDIT THE PIN NUMBERS IN THE LINES FOLLOWING TO SUIT YOUR ESP32 SETUP
  200. // ######
  201.  
  202. // For ESP32 Dev board (only tested with ILI9341 display)
  203. // The hardware SPI can be mapped to any pins
  204.  
  205. // #define TFT_MISO -1
  206. // #define TFT_MOSI 14
  207. // #define TFT_SCLK 33
  208. // #define TFT_CS   -1  // Chip select control pin
  209. // #define TFT_DC    13  // Data Command control pin
  210. // #define TFT_RST   12  // Reset pin (could connect to RST pin)
  211. // #define TFT_RST  -1  // Set TFT_RST to -1 if display RESET is connected to
  212. // ESP32 board RST
  213.  
  214. // For ESP32 Dev board (only tested with GC9A01 display)
  215. // The hardware SPI can be mapped to any pins
  216. #define ESP32_DMA
  217. #define TFT_MISO 12
  218. #define TFT_MOSI \
  219.   13  // In some display driver board, it might be written as "SDA" and so on.
  220. #define TFT_SCLK 14
  221. #define TFT_CS 15   // Chip select control pin
  222. #define TFT_DC 2    // Data Command control pin
  223. #define TFT_RST -1  // Reset pin (could connect to Arduino RESET pin)
  224. #define TFT_BL 27   // LED back-light
  225.  
  226. #define TOUCH_CS 33  // Chip select pin (T_CS) of touch screen
  227.  
  228. // #define TFT_WR 22    // Write strobe for modified Raspberry Pi TFT only
  229.  
  230. // For the M5Stack module use these #define lines
  231. // #define TFT_MISO 19
  232. // #define TFT_MOSI 23
  233. // #define TFT_SCLK 18
  234. // #define TFT_CS   14  // Chip select control pin
  235. // #define TFT_DC   27  // Data Command control pin
  236. // #define TFT_RST  33  // Reset pin (could connect to Arduino RESET pin)
  237. // #define TFT_BL   32  // LED back-light (required for M5Stack)
  238.  
  239. // ######       EDIT THE PINs BELOW TO SUIT YOUR ESP32 PARALLEL TFT SETUP ######
  240.  
  241. // The library supports 8 bit parallel TFTs with the ESP32, the pin
  242. // selection below is compatible with ESP32 boards in UNO format.
  243. // Wemos D32 boards need to be modified, see diagram in Tools folder.
  244. // Only ILI9481 and ILI9341 based displays have been tested!
  245.  
  246. // Parallel bus is only supported for the STM32 and ESP32
  247. // Example below is for ESP32 Parallel interface with UNO displays
  248.  
  249. // Tell the library to use 8 bit parallel mode (otherwise SPI is assumed)
  250. // #define TFT_PARALLEL_8_BIT
  251.  
  252. // The ESP32 and TFT the pins used for testing are:
  253. // #define TFT_CS   33  // Chip select control pin (library pulls permanently
  254. // low #define TFT_DC   15  // Data Command control pin - must use a pin in the
  255. // range 0-31 #define TFT_RST  32  // Reset pin, toggles on startup
  256.  
  257. // #define TFT_WR    4  // Write strobe control pin - must use a pin in the
  258. // range 0-31 #define TFT_RD    2  // Read strobe control pin
  259.  
  260. // #define TFT_D0   12  // Must use pins in the range 0-31 for the data bus
  261. // #define TFT_D1   13  // so a single register write sets/clears all bits.
  262. // #define TFT_D2   26  // Pins can be randomly assigned, this does not affect
  263. // #define TFT_D3   25  // TFT screen update performance.
  264. // #define TFT_D4   17
  265. // #define TFT_D5   16
  266. // #define TFT_D6   27
  267. // #define TFT_D7   14
  268.  
  269. // ######       EDIT THE PINs BELOW TO SUIT YOUR STM32 SPI TFT SETUP ######
  270.  
  271. // The TFT can be connected to SPI port 1 or 2
  272. // #define TFT_SPI_PORT 1 // SPI port 1 maximum clock rate is 55MHz
  273. // #define TFT_MOSI PA7
  274. // #define TFT_MISO PA6
  275. // #define TFT_SCLK PA5
  276.  
  277. // #define TFT_SPI_PORT 2 // SPI port 2 maximum clock rate is 27MHz
  278. // #define TFT_MOSI PB15
  279. // #define TFT_MISO PB14
  280. // #define TFT_SCLK PB13
  281.  
  282. // Can use Ardiuno pin references, arbitrary allocation, TFT_eSPI controls chip
  283. // select
  284. // #define TFT_CS   D5 // Chip select control pin to TFT CS
  285. // #define TFT_DC   D6 // Data Command control pin to TFT DC (may be labelled RS
  286. // = Register Select) #define TFT_RST  D7 // Reset pin to TFT RST (or RESET)
  287. // OR alternatively, we can use STM32 port reference names PXnn
  288. // #define TFT_CS   PE11 // Nucleo-F767ZI equivalent of D5
  289. // #define TFT_DC   PE9  // Nucleo-F767ZI equivalent of D6
  290. // #define TFT_RST  PF13 // Nucleo-F767ZI equivalent of D7
  291.  
  292. // #define TFT_RST  -1   // Set TFT_RST to -1 if the display RESET is connected
  293. // to processor reset
  294. //  Use an Arduino pin for initial testing as connecting to processor reset
  295. //  may not work (pulse too short at power up?)
  296.  
  297. // ##################################################################################
  298. //
  299. // Section 3. Define the fonts that are to be used here
  300. //
  301. // ##################################################################################
  302.  
  303. // Comment out the #defines below with // to stop that font being loaded
  304. // The ESP8366 and ESP32 have plenty of memory so commenting out fonts is not
  305. // normally necessary. If all fonts are loaded the extra FLASH space required is
  306. // about 17Kbytes. To save FLASH space only enable the fonts you need!
  307.  
  308. #define LOAD_GLCD   // Font 1. Original Adafruit 8 pixel font needs ~1820 bytes
  309.                     // in FLASH
  310. #define LOAD_FONT2  // Font 2. Small 16 pixel high font, needs ~3534 bytes in
  311.                     // FLASH, 96 characters
  312. #define LOAD_FONT4  // Font 4. Medium 26 pixel high font, needs ~5848 bytes in
  313.                     // FLASH, 96 characters
  314. #define LOAD_FONT6  // Font 6. Large 48 pixel font, needs ~2666 bytes in FLASH,
  315.                     // only characters 1234567890:-.apm
  316. #define LOAD_FONT7  // Font 7. 7 segment 48 pixel font, needs ~2438 bytes in
  317.                     // FLASH, only characters 1234567890:-.
  318. #define LOAD_FONT8  // Font 8. Large 75 pixel font needs ~3256 bytes in FLASH,
  319.                     // only characters 1234567890:-.
  320. // #define LOAD_FONT8N // Font 8. Alternative to Font 8 above, slightly
  321. // narrower, so 3 digits fit a 160 pixel TFT
  322. #define LOAD_GFXFF  // FreeFonts. Include access to the 48 Adafruit_GFX free
  323.                     // fonts FF1 to FF48 and custom fonts
  324.  
  325. // Comment out the #define below to stop the SPIFFS filing system and smooth
  326. // font code being loaded this will save ~20kbytes of FLASH
  327. #define SMOOTH_FONT
  328.  
  329. // ##################################################################################
  330. //
  331. // Section 4. Other options
  332. //
  333. // ##################################################################################
  334.  
  335. // Define the SPI clock frequency, this affects the graphics rendering speed.
  336. // Too fast and the TFT driver will not keep up and display corruption appears.
  337. // With an ILI9341 display 40MHz works OK, 80MHz sometimes fails
  338. // With a ST7735 display more than 27MHz may not work (spurious pixels and
  339. // lines) With an ILI9163 display 27 MHz works OK.
  340.  
  341. // #define SPI_FREQUENCY   1000000
  342. // #define SPI_FREQUENCY   5000000
  343. // #define SPI_FREQUENCY  10000000
  344. // #define SPI_FREQUENCY  20000000
  345. // #define SPI_FREQUENCY  27000000
  346. #define SPI_FREQUENCY 40000000
  347. // #define SPI_FREQUENCY  55000000 // STM32 SPI1 only (SPI2 maximum is 27MHz)
  348. // #define SPI_FREQUENCY  65000000
  349. // #define SPI_FREQUENCY 80000000
  350.  
  351. // Optional reduced SPI frequency for reading TFT
  352. #define SPI_READ_FREQUENCY 20000000
  353.  
  354. // The XPT2046 requires a lower SPI clock rate of 2.5MHz so we define that here:
  355. #define SPI_TOUCH_FREQUENCY 2500000  // 2500000
  356.  
  357. // The ESP32 has 2 free SPI ports i.e. VSPI and HSPI, the VSPI is the default.
  358. // If the VSPI port is in use and pins are not accessible (e.g. TTGO T-Beam)
  359. // then uncomment the following line:
  360. // #define USE_HSPI_PORT
  361.  
  362. // Comment out the following #define if "SPI Transactions" do not need to be
  363. // supported. When commented out the code size will be smaller and sketches will
  364. // run slightly faster, so leave it commented out unless you need it!
  365.  
  366. // Transaction support is needed to work with SD library but not needed with
  367. // TFT_SdFat Transaction support is required if other SPI devices are connected.
  368.  
  369. // Transactions are automatically enabled by the library for an ESP32 (to use
  370. // HAL mutex) so changing it here has no effect
  371.  
  372. // #define SUPPORT_TRANSACTIONS
  373.  
Advertisement
Add Comment
Please, Sign In to add comment