API tools faq
paste
Advertisement
retrokits

TESTESP32DISPLAY

retrokits
Mar 6th, 2025 (edited)
104
0
Never
Add comment
Not a member of Pastebin yet? Sign Up, it unlocks many cool features!
Arduino 14.90 KB | None | 0 0
raw download clone embed print report
  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 should
  8. //   run without the need to make any more changes for a particular hardware setup!
  9. //   Note that some sketches are designed for a particular TFT pixel width/height
  10.  
  11. // User defined information reported by "Read_User_Setup" test & diagnostics example
  12. #define USER_SETUP_INFO "User_Setup"
  13.  
  14. // Define to disable all #warnings in library (can be put in User_Setup_Select.h)
  15. //#define DISABLE_ALL_LIBRARY_WARNINGS
  16.  
  17. // ##################################################################################
  18. //
  19. // Section 1. Call up the right driver file and any options for it
  20. //
  21. // ##################################################################################
  22.  
  23. // Define STM32 to invoke optimised processor support (only for STM32)
  24. //#define STM32
  25.  
  26. // Defining the STM32 board allows the library to optimise the performance
  27. // for UNO compatible "MCUfriend" style shields
  28. //#define NUCLEO_64_TFT
  29. //#define NUCLEO_144_TFT
  30.  
  31. // STM32 8-bit parallel only:
  32. // If STN32 Port A or B pins 0-7 are used for 8-bit parallel data bus bits 0-7
  33. // then this will improve rendering performance by a factor of ~8x
  34. //#define STM_PORTA_DATA_BUS
  35. //#define STM_PORTB_DATA_BUS
  36.  
  37. // Tell the library to use parallel mode (otherwise SPI is assumed)
  38. //#define TFT_PARALLEL_8_BIT
  39. //#defined TFT_PARALLEL_16_BIT // **** 16-bit parallel ONLY for RP2040 processor ****
  40.  
  41. // Display type -  only define if RPi display
  42. //#define RPI_DISPLAY_TYPE // 20MHz maximum SPI
  43.  
  44. // Only define one driver, the other ones must be commented out
  45. //#define ILI9341_DRIVER       // Generic driver for common displays
  46. //#define ILI9341_2_DRIVER     // Alternative ILI9341 driver, see https://github.com/Bodmer/TFT_eSPI/issues/1172
  47. //#define ST7735_DRIVER      // Define additional parameters below for this display
  48. //#define ILI9163_DRIVER     // Define additional parameters below for this display
  49. //#define S6D02A1_DRIVER
  50. //#define RPI_ILI9486_DRIVER // 20MHz maximum SPI
  51. //#define HX8357D_DRIVER
  52. //#define ILI9481_DRIVER
  53. //#define ILI9486_DRIVER
  54. //#define ILI9488_DRIVER     // WARNING: Do not connect ILI9488 display SDO to MISO if other devices share the SPI bus (TFT SDO does NOT tristate when CS is high)
  55. #define ST7789_DRIVER      // Full configuration option, define additional parameters below for this display
  56. //#define ST7789_2_DRIVER    // Minimal configuration option, define additional parameters below for this display
  57. //#define R61581_DRIVER
  58. //#define RM68140_DRIVER
  59. //#define ST7796_DRIVER
  60. //#define SSD1351_DRIVER
  61. //#define SSD1963_480_DRIVER
  62. //#define SSD1963_800_DRIVER
  63. //#define SSD1963_800ALT_DRIVER
  64. //#define ILI9225_DRIVER
  65. //#define GC9A01_DRIVER
  66.  
  67. // Some displays support SPI reads via the MISO pin, other displays have a single
  68. // bi-directional SDA pin and the library will try to read this via the MOSI line.
  69. // To use the SDA line for reading data from the TFT uncomment the following line:
  70.  
  71.  //#define TFT_SDA_READ      // This option is for ESP32 ONLY, tested with ST7789 and GC9A01 display only
  72.  
  73. // For ST7735, ST7789 and ILI9341 ONLY, define the colour order IF the blue and red are swapped on your display
  74. // Try ONE option at a time to find the correct colour order for your display
  75.  
  76. #define TFT_RGB_ORDER TFT_RGB  // Colour order Red-Green-Blue
  77. // #define TFT_RGB_ORDER TFT_BGR  // Colour order Blue-Green-Red
  78.  
  79. // For M5Stack ESP32 module with integrated ILI9341 display ONLY, remove // in line below
  80.  
  81. // #define M5STACK
  82. #define INIT_SEQUENCE_3
  83. //#define CGRAM_OFFSET      // Library will add offsets required
  84. // For ST7789, ST7735, ILI9163 and GC9A01 ONLY, define the pixel width and height in portrait orientation
  85. // #define TFT_WIDTH  80
  86.  #define TFT_WIDTH  302
  87. // #define TFT_WIDTH  172 // ST7789 172 x 320
  88. // #define TFT_WIDTH  170 // ST7789 170 x 320
  89. // #define TFT_WIDTH  240 // ST7789 240 x 240 and 240 x 320
  90.  #define TFT_HEIGHT 302
  91. // #define TFT_HEIGHT 128
  92. // #define TFT_HEIGHT 240 // ST7789 240 x 240
  93. // #define TFT_HEIGHT 320 // ST7789 240 x 320
  94. // #define TFT_HEIGHT 240 // GC9A01 240 x 240
  95.  
  96. // For ST7735 ONLY, define the type of display, originally this was based on the
  97. // colour of the tab on the screen protector film but this is not always true, so try
  98. // out the different options below if the screen does not display graphics correctly,
  99. // e.g. colours wrong, mirror images, or stray pixels at the edges.
  100. // Comment out ALL BUT ONE of these options for a ST7735 display driver, save this
  101. // this User_Setup file, then rebuild and upload the sketch to the board again:
  102.  
  103. // #define ST7735_INITB
  104. //#define ST7735_GREENTAB
  105. // #define ST7735_GREENTAB2
  106. // #define ST7735_GREENTAB3
  107. // #define ST7735_GREENTAB128    // For 128 x 128 display
  108. // #define ST7735_GREENTAB160x80 // For 160 x 80 display (BGR, inverted, 26 offset)
  109. // #define ST7735_ROBOTLCD       // For some RobotLCD Arduino shields (128x160, BGR, https://docs.arduino.cc/retired/getting-started-guides/TFT)
  110. // #define ST7735_REDTAB
  111. // #define ST7735_BLACKTAB
  112. // #define ST7735_REDTAB160x80   // For 160 x 80 display with 24 pixel offset
  113.  
  114. // If colours are inverted (white shows as black) then uncomment one of the next
  115. // 2 lines try both options, one of the options should correct the inversion.
  116.  
  117. // #define TFT_INVERSION_ON
  118. // #define TFT_INVERSION_OFF
  119.  
  120.  
  121. // ###### EDIT THE PIN NUMBERS IN THE LINES FOLLOWING TO SUIT YOUR ESP32 SETUP   ######
  122.  
  123. // For ESP32 Dev board (only tested with ILI9341 display)
  124. // The hardware SPI can be mapped to any pins
  125.  
  126. /*
  127. 1 SDA mosi
  128. 2 SCL clk
  129. 3 DC rs
  130. 4 RES res
  131. 5 CS cs
  132. 6 GND
  133. 7 VCC
  134. 8 LEDK
  135. 9 LEDA
  136. 10 GND
  137. */
  138.  
  139. // PORT  MOSI[SDA]  MISO[<-]   CLK   CS
  140. // SPI2   11         13         12   10
  141. // SPI3   35         37         36   39
  142.  
  143. #define TFT_BL   18            // LED back-light control pin
  144. //#define TFT_BACKLIGHT_ON HIGH  // Level to turn ON back-light (HIGH or LOW)
  145.  
  146. #define TFT_MISO 13 // not used
  147. #define TFT_MOSI 35 //11
  148. #define TFT_SCLK 36 //12
  149. #define TFT_CS   39 //10  // Chip select control pin
  150. #define TFT_DC    8  // Data Command control pin
  151. //#define TFT_RST   9  // Reset pin (could connect to RST pin)
  152. #define TFT_RST  -1  // Set TFT_RST to -1 if display RESET is connected to ESP32 board RST
  153.  
  154. // For ESP32 Dev board (only tested with GC9A01 display)
  155. // The hardware SPI can be mapped to any pins
  156.  
  157. //#define TFT_MOSI 15 // In some display driver board, it might be written as "SDA" and so on.
  158. //#define TFT_SCLK 14
  159. //#define TFT_CS   5  // Chip select control pin
  160. //#define TFT_DC   27  // Data Command control pin
  161. //#define TFT_RST  33  // Reset pin (could connect to Arduino RESET pin)
  162. //#define TFT_BL   22  // LED back-light
  163.  
  164. //#define TOUCH_CS 21     // Chip select pin (T_CS) of touch screen
  165.  
  166. //#define TFT_WR 22    // Write strobe for modified Raspberry Pi TFT only
  167.  
  168. // For the M5Stack module use these #define lines
  169. //#define TFT_MISO 19
  170. //#define TFT_MOSI 23
  171. //#define TFT_SCLK 18
  172. //#define TFT_CS   14  // Chip select control pin
  173. //#define TFT_DC   27  // Data Command control pin
  174. //#define TFT_RST  33  // Reset pin (could connect to Arduino RESET pin)
  175. //#define TFT_BL   32  // LED back-light (required for M5Stack)
  176.  
  177. // ######       EDIT THE PINs BELOW TO SUIT YOUR ESP32 PARALLEL TFT SETUP        ######
  178.  
  179. // The library supports 8-bit parallel TFTs with the ESP32, the pin
  180. // selection below is compatible with ESP32 boards in UNO format.
  181. // Wemos D32 boards need to be modified, see diagram in Tools folder.
  182. // Only ILI9481 and ILI9341 based displays have been tested!
  183.  
  184. // Parallel bus is only supported for the STM32 and ESP32
  185. // Example below is for ESP32 Parallel interface with UNO displays
  186.  
  187. // Tell the library to use 8-bit parallel mode (otherwise SPI is assumed)
  188. //#define TFT_PARALLEL_8_BIT
  189.  
  190. // The ESP32 and TFT the pins used for testing are:
  191. //#define TFT_CS   33  // Chip select control pin (library pulls permanently low
  192. //#define TFT_DC   15  // Data Command control pin - must use a pin in the range 0-31
  193. //#define TFT_RST  32  // Reset pin, toggles on startup
  194.  
  195. //#define TFT_WR    4  // Write strobe control pin - must use a pin in the range 0-31
  196. //#define TFT_RD    2  // Read strobe control pin
  197.  
  198. //#define TFT_D0   12  // Must use pins in the range 0-31 for the data bus
  199. //#define TFT_D1   13  // so a single register write sets/clears all bits.
  200. //#define TFT_D2   26  // Pins can be randomly assigned, this does not affect
  201. //#define TFT_D3   25  // TFT screen update performance.
  202. //#define TFT_D4   17
  203. //#define TFT_D5   16
  204. //#define TFT_D6   27
  205. //#define TFT_D7   14
  206.  
  207. // ######       EDIT THE PINs BELOW TO SUIT YOUR STM32 SPI TFT SETUP        ######
  208.  
  209. // The TFT can be connected to SPI port 1 or 2
  210. //#define TFT_SPI_PORT 1 // SPI port 1 maximum clock rate is 55MHz
  211. //#define TFT_MOSI PA7
  212. //#define TFT_MISO PA6
  213. //#define TFT_SCLK PA5
  214.  
  215. //#define TFT_SPI_PORT 2 // SPI port 2 maximum clock rate is 27MHz
  216. //#define TFT_MOSI PB15
  217. //#define TFT_MISO PB14
  218. //#define TFT_SCLK PB13
  219.  
  220. // Can use Ardiuno pin references, arbitrary allocation, TFT_eSPI controls chip select
  221. //#define TFT_CS   D5 // Chip select control pin to TFT CS
  222. //#define TFT_DC   D6 // Data Command control pin to TFT DC (may be labelled RS = Register Select)
  223. //#define TFT_RST  D7 // Reset pin to TFT RST (or RESET)
  224. // OR alternatively, we can use STM32 port reference names PXnn
  225. //#define TFT_CS   PE11 // Nucleo-F767ZI equivalent of D5
  226. //#define TFT_DC   PE9  // Nucleo-F767ZI equivalent of D6
  227. //#define TFT_RST  PF13 // Nucleo-F767ZI equivalent of D7
  228.  
  229. //#define TFT_RST  -1   // Set TFT_RST to -1 if the display RESET is connected to processor reset
  230.                         // Use an Arduino pin for initial testing as connecting to processor reset
  231.                         // may not work (pulse too short at power up?)
  232.  
  233. // ##################################################################################
  234. //
  235. // Section 3. Define the fonts that are to be used here
  236. //
  237. // ##################################################################################
  238.  
  239. // Comment out the #defines below with // to stop that font being loaded
  240. // The ESP8366 and ESP32 have plenty of memory so commenting out fonts is not
  241. // normally necessary. If all fonts are loaded the extra FLASH space required is
  242. // about 17Kbytes. To save FLASH space only enable the fonts you need!
  243.  
  244. #define LOAD_GLCD   // Font 1. Original Adafruit 8 pixel font needs ~1820 bytes in FLASH
  245. #define LOAD_FONT2  // Font 2. Small 16 pixel high font, needs ~3534 bytes in FLASH, 96 characters
  246. #define LOAD_FONT4  // Font 4. Medium 26 pixel high font, needs ~5848 bytes in FLASH, 96 characters
  247. #define LOAD_FONT6  // Font 6. Large 48 pixel font, needs ~2666 bytes in FLASH, only characters 1234567890:-.apm
  248. #define LOAD_FONT7  // Font 7. 7 segment 48 pixel font, needs ~2438 bytes in FLASH, only characters 1234567890:-.
  249. #define LOAD_FONT8  // Font 8. Large 75 pixel font needs ~3256 bytes in FLASH, only characters 1234567890:-.
  250. //#define LOAD_FONT8N // Font 8. Alternative to Font 8 above, slightly narrower, so 3 digits fit a 160 pixel TFT
  251. #define LOAD_GFXFF  // FreeFonts. Include access to the 48 Adafruit_GFX free fonts FF1 to FF48 and custom fonts
  252.  
  253. // Comment out the #define below to stop the SPIFFS filing system and smooth font code being loaded
  254. // this will save ~20kbytes of FLASH
  255. //#define SMOOTH_FONT
  256.  
  257.  
  258. // ##################################################################################
  259. //
  260. // Section 4. Other options
  261. //
  262. // ##################################################################################
  263.  
  264. // For RP2040 processor and SPI displays, uncomment the following line to use the PIO interface.
  265. //#define RP2040_PIO_SPI // Leave commented out to use standard RP2040 SPI port interface
  266.  
  267. // For RP2040 processor and 8 or 16-bit parallel displays:
  268. // The parallel interface write cycle period is derived from a division of the CPU clock
  269. // speed so scales with the processor clock. This means that the divider ratio may need
  270. // to be increased when overclocking. It may also need to be adjusted dependant on the
  271. // display controller type (ILI94341, HX8357C etc.). If RP2040_PIO_CLK_DIV is not defined
  272. // the library will set default values which may not suit your display.
  273. // The display controller data sheet will specify the minimum write cycle period. The
  274. // controllers often work reliably for shorter periods, however if the period is too short
  275. // the display may not initialise or graphics will become corrupted.
  276. // PIO write cycle frequency = (CPU clock/(4 * RP2040_PIO_CLK_DIV))
  277. //#define RP2040_PIO_CLK_DIV 1 // 32ns write cycle at 125MHz CPU clock
  278. //#define RP2040_PIO_CLK_DIV 2 // 64ns write cycle at 125MHz CPU clock
  279. //#define RP2040_PIO_CLK_DIV 3 // 96ns write cycle at 125MHz CPU clock
  280.  
  281. // For the RP2040 processor define the SPI port channel used (default 0 if undefined)
  282. //#define TFT_SPI_PORT 1 // Set to 0 if SPI0 pins are used, or 1 if spi1 pins used
  283.  
  284. // For the STM32 processor define the SPI port channel used (default 1 if undefined)
  285. //#define TFT_SPI_PORT 2 // Set to 1 for SPI port 1, or 2 for SPI port 2
  286.  
  287. // Define the SPI clock frequency, this affects the graphics rendering speed. Too
  288. // fast and the TFT driver will not keep up and display corruption appears.
  289. // With an ILI9341 display 40MHz works OK, 80MHz sometimes fails
  290. // With a ST7735 display more than 27MHz may not work (spurious pixels and lines)
  291. // With an ILI9163 display 27 MHz works OK.
  292.  
  293. // #define SPI_FREQUENCY   1000000
  294. // #define SPI_FREQUENCY   5000000
  295. // #define SPI_FREQUENCY  10000000
  296. // #define SPI_FREQUENCY  20000000
  297. //#define SPI_FREQUENCY  27000000
  298.  #define SPI_FREQUENCY  40000000
  299. // #define SPI_FREQUENCY  55000000 // STM32 SPI1 only (SPI2 maximum is 27MHz)
  300. // #define SPI_FREQUENCY  80000000
  301.  
  302. // Optional reduced SPI frequency for reading TFT
  303. #define SPI_READ_FREQUENCY  20000000
  304.  
  305. // The XPT2046 requires a lower SPI clock rate of 2.5MHz so we define that here:
  306. #define SPI_TOUCH_FREQUENCY  2500000
  307.  
  308. // The ESP32 has 2 free SPI ports i.e. VSPI and HSPI, the VSPI is the default.
  309. // If the VSPI port is in use and pins are not accessible (e.g. TTGO T-Beam   )
  310. // then uncomment the following line:
  311. #define USE_HSPI_PORT
  312.  
  313. // Comment out the following #define if "SPI Transactions" do not need to be
  314. // supported. When commented out the code size will be smaller and sketches will
  315. // run slightly faster, so leave it commented out unless you need it!
  316.  
  317. // Transaction support is needed to work with SD library but not needed with TFT_SdFat
  318. // Transaction support is required if other SPI devices are connected.
  319.  
  320. // Transactions are automatically enabled by the library for an ESP32 (to use HAL mutex)
  321. // so changing it here has no effect
  322.  
  323. // #define SUPPORT_TRANSACTIONS
  324.  
Advertisement
Add Comment
Please, Sign In to add comment
Advertisement
Public Pastes
Advertisement
We use cookies for various purposes including analytics. By continuing to use Pastebin, you agree to our use of cookies as described in the Cookies Policy.  OK, I Understand
Not a member of Pastebin yet?
Sign Up, it unlocks many cool features!