[Digi-Key Follow me Issue 2] Summary of ESP32-S3 Simple Calendar Clock (Arduino)

小默叔叔

[Digi-Key Follow me Issue 2] Summary of ESP32-S3 Simple Calendar Clock (Arduino) [Copy link]

 

<i class="pstatus"> This post was last edited by Uncle Xiaomo on 2023-10-9 13:48 </i> # [Digital Electronics Follow me Issue 2] Summary of ESP32-S3 Simple Calendar Clock (Arduino) ## Video link: https://training.eeworld.com.cn/video/37977 ## Previous content: [[Digital Electronics Follow me Issue 2] ESP32-S3 Based on Clion+PlatformIO+Arduino Environment Construction and Use](https://bbs.eeworld.com.cn/thread-1258611-1-1.html "[Digital Electronics Follow me Issue 2] ESP32-S3 Based on Clion+PlatformIO+Arduino Environment Construction and Use") [[Digital Electronics Follow me Issue 2] ESP32-S3 LVGL adaptation and Chinese display (Arduino)](https://bbs.eeworld.com.cn/thread-1258612-1-1.html "[Digi-Key Electronics Follow me Issue 2] ESP32-S3 LVGL adaptation and Chinese display (Arduino)") [[Digi-Key Electronics Follow me Issue 2] ESP32-S3 network connection and ntp time acquisition (Arduino)](https://bbs.eeworld.com.cn/thread-1258613-1-1.html "[Digi-Key Electronics Follow me Issue 2] ESP32-S3 network connection and ntp time acquisition (Arduino)") [[Digi-Key Electronics Follow me Issue 2] ESP32-S3 control WS2812 (Arduino)](https://bbs.eeworld.com.cn/thread-1258615-1-1.html "[Digi-Key Electronics Follow me第2期]ESP32-S3之控制WS2812（Arduino） ") ## 1. Project Introduction 1. **adafruit-esp32-s3-tft-feather** This Feather is equipped with native USB and **4 MB flash + 2 MB PSRAM**, so it is perfect for use with CircuitPython or Arduino and low-cost WiFi. Native USB means it can act as a keyboard or disk drive. WiFi means it is great for IoT projects. Feather means it works with the large Feather Wings community for scalability. ESP32-S3 is a highly integrated, low-power, 2.4 GHz Wi-Fi/BLE system-on-chip (SoC) solution with built-in native USB and some other interesting new technologies such as time-of-flight distance measurement and artificial intelligence acceleration. With its state-of-the-art power and RF performance, the SoC is ideal for a variety of application scenarios related to the Internet of Things [(IoT)](https://www.adafruit.com/category/342), [wearable electronics](https://www.adafruit.com/category/65) and smart homes. 2. This event is the second "Follow me event" organized by Digi-Key and Electronic Engineer World. It was my first time to use Arduino for development. The process was bumpy and interesting, and I gained a lot. But I suggest that you use idf+arduino for future development. It is more reasonable~ ## 2. Environment construction 1. This project **adafruit-esp32-s3-tft-feather is based on Clion+PlatformIO+Arduino environment construction and use** 2. **Clion** CLion is an integrated development environment (IDE) developed by JetBrains, specially designed for C and C++ programming. It provides powerful code editing, debugging, code navigation and automated build tools to make C and C++ development more efficient. CLion supports multiple platforms, including Windows, macOS, and Linux, and can integrate multiple compilers such as GCC and Clang. After installing the relevant plug-ins, Clion can also be used for STM32 and ESP32 development. 3. **PlatformIO** PlatformIO is an open source cross-platform IDE for embedded development that can be used with ESP32. It provides features such as project management, automatic building, debugging, and library management, which simplifies the ESP32 development process and makes development more convenient. You can use PlatformIO to easily create, write, build, and upload ESP32 firmware in IDEs such as VSCode. It also supports debugging and library management to accelerate the development cycle. We used it as a plug-in for Clion here. 4. **Arduino** Arduino is a development platform that provides easy-to-use hardware and software tools for creating embedded systems and IoT devices. It writes code in a simple way, suitable for beginners and professional developers. PlatformIO provides more powerful project management, building, and debugging tools, making ESP32 development more convenient. This means that you can easily write, build, and upload ESP32 firmware in PlatformIO, while also taking advantage of Arduino libraries and simple programming syntax to develop your applications. This combination combines the ease of use of Arduino with the power of PlatformIO to make development of ESP32 projects more efficient. 1. For development, you need to install the plugins "PlatformIO for Clion" + "Arduino Support" 2. To add dependent libraries, you need to open the platformio.ini file and add a line "`lib_deps =`" ## 3. Control the screen to display Chinese 1. Two dependent libraries are needed here```arduino lib_deps = lvgl/lvgl@^8.3.9 bodmer/TFT_eSPI@^2.5.31 ``` 2. ST7789 code adaptation 1. The library used is TFT_eSPI. The first step is to modify User_Setup.h ```c // USER DEFINED SETTINGS // Set driver type, fonts to be loaded, pins used and SPI control method etc // // See the User_Setup_Select.h file if you wish to be able to define multiple // setups and then easily select which setup file is used by the compiler. // // If this file is edited correctly then all the library example sketches should // run without the need to make any more changes for a particular hardware setup!// Note that some sketches are designed for a particular TFT pixel width/height // User defined information reported by "Read_User_Setup" test & diagnostics example #define USER_SETUP_INFO "User_Setup" // Define to disable all #warnings in library (can be put in User_Setup_Select.h) //#define DISABLE_ALL_LIBRARY_WARNINGS // #################################### ########################################## // // Section 1 . Call up the right driver file and any options for it // // ################################################ ################################ // Define STM32 to invoke optimized processor support (only for STM32) //#define STM32 // Defining the STM32 board allows the library to optimize the performance // for UNO compatible "MCUfriend" style shields //#define NUCLEO_64_TFT //#define NUCLEO_144_TFT // STM32 8 bit parallel only: // If STN32 Port A or B pins 0-7 are used for 8 bit parallel data bus bits 0-7 // then this will improve rendering performance by a factor of ~8x //#define STM_PORTA_DATA_BUS //#define STM_PORTB_DATA_BUS // Tell the library to use parallel mode (otherwise SPI is assumed) //#define TFT_PARALLEL_8_BIT //#defined TFT_PARALLEL_16_BIT // **** 16 bit parallel ONLY for RP2040 processor **** // Display type - only define if RPi display //#define RPI_DISPLAY_TYPE // 20MHz maximum SPI // Only define one driver, the other ones must be commented out //#define ILI9341_DRIVER // Generic driver for common displays //#define ILI9341_2_DRIVER // Alternative ILI9341 driver, see https://github.com/Bodmer/TFT_eSPI/issues/1172 //#define ST7735_DRIVER // Define additional parameters below for this display //#define ILI9163_DRIVER // Define additional parameters below for this display //#define S6D02A1_DRIVER //#define RPI_ILI9486_DRIVER // 20MHz maximum SPI //#define HX8357D_DRIVER //#define ILI9481_DRIVER //#define ILI9486_DRIVER //#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) #define ST7789_DRIVER // Full configuration option, define additional parameters below for this display //#define ST7789_2_DRIVER // Minimal configuration option, define additional parameters below for this display //#define R61581_DRIVER //#define RM68140_DRIVER //#define ST7796_DRIVER //#define SSD1351_DRIVER //#define SSD1963_480_DRIVER //#define SSD1963_800_DRIVER //#define SSD1963_800ALT_DRIVER //#define ILI9225_DRIVER //#define GC9A01_DRIVER // Some displays support SPI reads via the MISO pin,other displays have a single // bi-directional SDA pin and the library will try to read this via the MOSI line. // To use the SDA line for reading data from the TFT uncomment the following line: // #define TFT_SDA_READ // This option is for ESP32 ONLY, tested with ST7789 and GC9A01 display only // For ST7735, ST7789 and ILI9341 ONLY, define the color order IF the blue and red are swapped on your display // Try ONE option at a time to find the correct color order for your display // #define TFT_RGB_ORDER TFT_RGB // Color order Red-Green-Blue // #define TFT_RGB_ORDER TFT_BGR // Color order Blue-Green-Red // For M5Stack ESP32 module with integrated ILI9341 display ONLY, remove // in line below // #define M5STACK // For adafruit_feather_esp32s3_tft 1.14tft st7789 #define TFT_WIDTH 240 #define TFT_HEIGHT 135 // For ST7789, ST7735, ILI9163 and GC9A01 ONLY, define the pixel width and height in portrait orientation // #define TFT_WIDTH 80 // #define TFT_WIDTH 128 // #define TFT_WIDTH 172 // ST7789 172 x 320 // #define TFT_WIDTH 170 // ST7789 170 x 320 // #define TFT_WIDTH 240 // ST7789 240 x 240 and 240 x 320 // #define TFT_HEIGHT 160 // #define TFT_HEIGHT 128 // #define TFT_HEIGHT 240 // ST7789 240 x 240 // #define TFT_HEIGHT 320 // ST7789 240 x 320 // #define TFT_HEIGHT 240 // GC9A01 240 x 240 // For ST7735 ONLY, define the type of display, originally this was based on the // color of the tab on the screen protector film but this is not always true, so try // out the different options below if the screen does not display graphics correctly, // eg colors wrong, mirror images, or stray pixels at the edges. // Comment out ALL BUT ONE of these options for a ST7735 display driver, save this // this User_Setup file, then rebuild and upload the sketch to the board again: // #define ST7735_INITB // #define ST7735_GREENTAB // #define ST7735_GREENTAB2 // # define ST7735_GREENTAB3 // #define ST7735_GREENTAB128 // For 128 x 128 display // #define ST7735_GREENTAB160x80 // For 160 x 80 display (BGR, inverted, 26 offset) // #define ST7735_ROBOTLCD // For some RobotLCD arduino shields (128x160, BGR, https://docs .arduino.cc/retired/getting-started-guides/TFT) // #define ST7735_REDTAB // #define ST7735_BLACKTAB // #define ST7735_REDTAB160x80 // For 160 x 80 display with 24 pixel offset // If colors are inverted (white shows as black) then uncomment one of the next // 2 lines try both options, one of the options should correct the inversion.// #define TFT_INVERSION_ON // #define TFT_INVERSION_OFF // ##################################### ########################################## // // Section 2 . Define the pins that are used to interface with the display here // // ################################ ############################################### / / If a backlight control signal is available then define the TFT_BL pin in Section 2 // below. The backlight will be turned ON when tft.begin() is called, but the library // needs to know if the LEDs are ON with the pin HIGH or LOW. If the LEDs are to be // driven with a PWM signal or turned OFF/ON then this must be handled by the user // sketch. eg with digitalWrite(TFT_BL, LOW); // #define TFT_BL 32 // LED back-light control pin // #define TFT_BACKLIGHT_ON HIGH // Level to turn ON back-light (HIGH or LOW ) // We must use hardware SPI, a minimum of 3 GPIO pins is needed. // Typical setup for ESP8266 NodeMCU ESP-12 is : // // Display SDO/MISO to NodeMCU pin D6 (or leave disconnected if not reading TFT ) // Display LED to NodeMCU pin VIN (or 5V, see below) // Display SCK to NodeMCU pin D5 // Display SDI/MOSI to NodeMCU pin D7 // Display DC (RS/AO) to NodeMCU pin D3 // Display RESET to NodeMCU pin D4 (or RST, see below) // Display CS to NodeMCU pin D8 (or GND, see below) // Display GND to NodeMCU pin GND (0V) // Display VCC to NodeMCU 5V or 3.3V // // The TFT RESET pin can be connected to the NodeMCU RST pin or 3.3V to free up a control pin // // The DC (Data Command) pin may be labeled AO or RS (Register Select) // // With some displays such as the ILI9341 the TFT CS pin can be connected to GND if no more // SPI devices (eg an SD Card) are connected, in this case comment out the #define TFT_CS // line below so it is NOT defined. Other displays such at the ST7735 require the TFT CS pin // to be toggled during setup, so in these cases the TFT_CS line must be defined and connected. // // The NodeMCU D0 pin can be used for RST // // // Note: only some versions of the NodeMCU provide the USB 5V on the VIN pin // If 5V is not available at a pin you can use 3.3V but backlight brightness // will be lower.// ###### EDIT THE PIN NUMBERS IN THE LINES FOLLOWING TO SUIT YOUR ESP8266 SETUP ###### // For NodeMCU - use pin numbers in the form PIN_Dx where Dx is the NodeMCU pin designation //#define TFT_MISO PIN_D6 // Automatically assigned with ESP8266 if not defined //#define TFT_MOSI PIN_D7 // Automatically assigned with ESP8266 if not defined //#define TFT_SCLK PIN_D5 // Automatically assigned with ESP8266 if not defined // //#define TFT_CS PIN_D8 / / Chip select control pin D8 //#define TFT_DC PIN_D3 // Data Command control pin //#define TFT_RST PIN_D4 // Reset pin (could connect to NodeMCU RST, see next line) //#define TFT_RST -1 // Set TFT_RST to -1 if the display RESET is connected to NodeMCU RST or 3.3V //#define TFT_BL PIN_D1 // LED back-light (only for ST7789 with backlight control pin) //#define TOUCH_CS PIN_D2 // Chip select pin (T_CS ) of touch screen //#define TFT_WR PIN_D2 // Write strobe for modified Raspberry Pi TFT only // ###### FOR ESP8266 OVERLAP MODE EDIT THE PIN NUMBERS IN THE FOLLOWING LINES ###### // Overlap mode shares the ESP8266 FLASH SPI bus with the TFT so has a performance impact // but saves pins for other functions. It is best not to connect MISO as some displays // do not tristate that line when chip select is high! // Note: Only one SPI device can share the FLASH SPI lines, so a SPI touch controller // cannot be connected as well to the same SPI signals. // On NodeMCU 1.0 SD0=MISO, SD1=MOSI, CLK=SCLK to connect to TFT in overlap mode // On NodeMCU V3 S0 =MISO, S1 =MOSI, S2 =SCLK // In ESP8266 overlap mode the following must be defined //#define TFT_SPI_OVERLAP // In ESP8266 overlap mode the TFT chip select MUST connect to pin D3 //#define TFT_CS PIN_D3 //#define TFT_DC PIN_D5 // Data Command control pin //# define TFT_RST PIN_D4 // Reset pin (could connect to NodeMCU RST, see next line) //#define TFT_RST -1 // Set TFT_RST to -1 if the display RESET is connected to NodeMCU RST or 3.3V // ###### EDIT THE PIN NUMBERS IN THE LINES FOLLOWING TO SUIT YOUR ESP32 SETUP ###### // For ESP32 Dev board (only tested with ILI9341 display) // The hardware SPI can be mapped to any pins //#define TFT_MISO 19 //#define TFT_MOSI 23 //#define TFT_SCLK 18 //#define TFT_CS 15 // Chip select control pin //#define TFT_DC 2 // Data Command control pin //#define TFT_RST 4 // Reset pin (could connect to RST pin) //#define TFT_RST -1 // Set TFT_RST to -1 if display RESET is connected to ESP32 board RST // For ESP32 Dev board (only tested with GC9A01 display) // The hardware SPI can be mapped to any pins //#define TFT_MOSI 15 // In some display driver board, it might be written as "SDA" and so on. //#define TFT_SCLK 14 //#define TFT_CS 5 // Chip select control pin //#define TFT_DC 27 // Data Command control pin //#define TFT_RST 33 // Reset pin (could connect to Arduino RESET pin) //#define TFT_BL 22 // LED back-light // For adafruit_feather_esp32s3_tft #define TFT_MOSI 35 // In some display driver board, it might be written as "SDA" and so on. #define TFT_SCLK 36 #define TFT_CS 7 // Chip select control pin #define TFT_DC 39 // Data Command control pin #define TFT_RST 40 // Reset pin (could connect to Arduino RESET pin) #define TFT_BL 45 // LED back-light //#define TOUCH_CS 21 // Chip select pin (T_CS) of touch screen //#define TFT_WR 22 // Write strobe for modified Raspberry Pi TFT only // For the M5Stack module use these #define lines //# define TFT_MISO 19 //#define TFT_MOSI 23 //#define TFT_SCLK 18 //#define TFT_CS 14 // Chip select control pin //#define TFT_DC 27 // Data Command control pin //#define TFT_RST 33 // Reset pin ( could connect to Arduino RESET pin) //#define TFT_BL 32 // LED back-light (required for M5Stack) // ###### EDIT THE PINs BELOW TO SUIT YOUR ESP32 PARALLEL TFT SETUP ###### / / The library supports 8 bit parallel TFTs with the ESP32, the pin // selection below is compatible with ESP32 boards in UNO format. // Wemos D32 boards need to be modified, see diagram in Tools folder. // Only ILI9481 and ILI9341 based displays have been tested! // Parallel bus is only supported for the STM32 and ESP32 // Example below is for ESP32 Parallel interface with UNO displays // Tell the library to use 8 bit parallel mode (otherwise SPI is assumed) //#define TFT_PARALLEL_8_BIT // The ESP32 and TFT the pins used for testing are://#define TFT_CS 33 // Chip select control pin (library pulls permanently low //#define TFT_DC 15 // Data Command control pin - must use a pin in the range 0-31 //#define TFT_RST 32 // Reset pin , toggles on startup //#define TFT_WR 4 // Write strobe control pin - must use a pin in the range 0-31 //#define TFT_RD 2 // Read strobe control pin //#define TFT_D0 12 // Must use pins in the range 0-31 for the data bus //#define TFT_D1 13 // so a single register write sets/clears all bits. //#define TFT_D2 26 // Pins can be randomly assigned, this does not affect //# define TFT_D3 25 // TFT screen update performance. //#define TFT_D4 17 //#define TFT_D5 16 //#define TFT_D6 27 //#define TFT_D7 14 // ###### EDIT THE PINs BELOW TO SUIT YOUR STM32 SPI TFT SETUP ###### // The TFT can be connected to SPI port 1 or 2 //#define TFT_SPI_PORT 1 // SPI port 1 maximum clock rate is 55MHz //#define TFT_MOSI PA7 //#define TFT_MISO PA6 //#define TFT_SCLK PA5 //#define TFT_SPI_PORT 2 // SPI port 2 maximum clock rate is 27MHz //#define TFT_MOSI PB15 //#define TFT_MISO PB14 //#define TFT_SCLK PB13 // Can use Ardiuno pin references, arbitrary allocation, TFT_eSPI controls chip select //#define TFT_CS D5 // Chip select control pin to TFT CS //#define TFT_DC D6 // Data Command control pin to TFT DC (may be labeled RS = Register Select) //#define TFT_RST D7 // Reset pin to TFT RST (or RESET) // OR alternatively, we can use STM32 port reference names PXnn //#define TFT_CS PE11 // Nucleo-F767ZI equivalent of D5 //#define TFT_DC PE9 // Nucleo-F767ZI equivalent of D6 //#define TFT_RST PF13 // Nucleo-F767ZI equivalent of D7 // #define TFT_RST -1 // Set TFT_RST to -1 if the display RESET is connected to processor reset // Use an Arduino pin for initial testing as connecting to processor reset // may not work (pulse too short at power up?) / / ################################################ ################################ // // Section 3. Define the fonts that are to be used here // // ############################################### ################################# // Comment out the #defines below with // to stop that font being loaded // The ESP8366 and ESP32 have plenty of memory so commenting out fonts is not // normally necessary. If all fonts are loaded the extra FLASH space required is // about 17Kbytes. To save FLASH space only enable the fonts you need! #define LOAD_GLCD // Font 1. Original Adafruit 8 pixel font needs ~1820 bytes in FLASH #define LOAD_FONT2 // Font 2. Small 16 pixel high font, needs ~3534 bytes in FLASH,96 characters #define LOAD_FONT4 // Font 4. Medium 26 pixel high font, needs ~5848 bytes in FLASH, 96 characters #define LOAD_FONT6 // Font 6. Large 48 pixel font, needs ~2666 bytes in FLASH, only characters 1234567890:- .apm #define LOAD_FONT7 // Font 7. 7 segment 48 pixel font, needs ~2438 bytes in FLASH, only characters 1234567890:-. #define LOAD_FONT8 // Font 8. Large 75 pixel font needs ~3256 bytes in FLASH, only characters 1234567890:-. //#define LOAD_FONT8N // Font 8. Alternative to Font 8 above, slightly narrower, so 3 digits fit a 160 pixel TFT #define LOAD_GFXFF // FreeFonts. Include access to the 48 Adafruit_GFX free fonts FF1 to FF48 and custom fonts // Comment out the #define below to stop the SPIFFS filing system and smooth font code being loaded // this will save ~20kbytes of FLASH #define SMOOTH_FONT // ########################################### #################################### // // Section 4. Other options // / / ################################################ ################################ // For RP2040 processor and SPI displays, uncomment the following line to use the PIO interface . //#define RP2040_PIO_SPI // Leave commented out to use standard RP2040 SPI port interface // For RP2040 processor and 8 or 16 bit parallel displays: // The parallel interface write cycle period is derived from a division of the CPU clock // speed so scales with the processor clock. This means that the divider ratio may need // to be increased when overclocking. It may also need to be adjusted dependant on the // display controller type (ILI94341, HX8357C etc). If RP2040_PIO_CLK_DIV is not defined // the library will set default values which may not suit your display. // The display controller data sheet will specify the minimum write cycle period. The // controllers often work reliably for shorter periods, however if the period is too short // the display may not initialise or graphics will become corrupted. // PIO write cycle frequency = (CPU clock/(4 * RP2040_PIO_CLK_DIV)) //#define RP2040_PIO_CLK_DIV 1 // 32ns write cycle at 125MHz CPU clock //# define RP2040_PIO_CLK_DIV 2 // 64ns write cycle at 125MHz CPU clock //#define RP2040_PIO_CLK_DIV 3 // 96ns write cycle at 125MHz CPU clock // For the RP2040 processor define the SPI port channel used (default 0 if undefined) //#define TFT_SPI_PORT 1 // Set to 0 if SPI0 pins are used, or 1 if spi1 pins used // For the STM32 processor define the SPI port channel used (default 1 if undefined) //#define TFT_SPI_PORT 2 // Set to 1 for SPI port 1, or 2 for SPI port 2 // Define the SPI clock frequency, this affects the graphics rendering speed. Too // fast and the TFT driver will not keep up and display corruption appears.// With an ILI9341 display 40MHz works OK, 80MHz sometimes fails // With a ST7735 display more than 27MHz may not work (spurious pixels and lines) // With an ILI9163 display 27 MHz works OK. // #define SPI_FREQUENCY 1000000 // #define SPI_FREQUENCY 5000000 // #define SPI_FREQUENCY 10000000 // #define SPI_FREQUENCY 20000000 // #define SPI_FREQUENCY 27000000 // #define SPI_FREQUENCY 40000000 // #define SPI_FREQUENCY 5500000 0 // STM32 SPI1 only (SPI2 maximum is 27MHz) #define SPI_FREQUENCY 80000000 // Optional reduced SPI frequency for reading TFT #define SPI_READ_FREQUENCY 20000000 // The XPT2046 requires a lower SPI clock rate of 2.5MHz so we define that here: #define SPI_TOUCH_FREQUENCY 2500000 // The ESP32 has 2 free SPI ports ie VSPI and HSPI , the VSPI is the default. // If the VSPI port is in use and pins are not accessible (eg TTGO T-Beam) // then uncomment the following line: //#define USE_HSPI_PORT // Comment out the following #define if "SPI Transactions" do not need to be // supported. When commented out the code size will be smaller and sketches will // run slightly faster, so leave it commented out unless you need it! // Transaction support is needed to work with SD library but not needed with TFT_SdFat // Transaction support is required if other SPI devices are connected. // Transactions are automatically enabled by the library for an ESP32 (to use HAL mutex) // so changing it here has no effect // #define SUPPORT_TRANSACTIONS ``` 2. Modify and adapt to ST7789, set the screen width and height, and open the macro, file ST7789_Defines.h ```c // Change the width and height if required (defined in portrait mode) // or use the constructor to over-ride defaults #ifndef TFT_WIDTH #define TFT_WIDTH 240 #endif #ifndef TFT_HEIGHT #define TFT_HEIGHT 320 #endif #if (TFT_HEIGHT == 240) && (TFT_WIDTH == 240) #ifndef CGRAM_OFFSET #define CGRAM_OFFSET #endif #endif // Adafruit 1.44 TFT support #if (TFT_HEIGHT == 240) && (TFT_WIDTH == 135) #ifndef CGRAM_OFFSET #define CGRAM_OFFSET #endif #endif // Adafruit 1.44 TFT support #if (TFT_HEIGHT == 135) && (TFT_WIDTH == 240) #ifndef CGRAM_OFFSET #define CGRAM_OFFSET #endif #endif // Adafruit 1.69 round corner TFT support #if (TFT_HEIGHT == 280) && (TFT_WIDTH == 240) #ifndef CGRAM_OFFSET #define CGRAM_OFFSET #endif #endif // 1.47" 172x320 Round Rectangle Color IPS TFT Display #if (TFT_HEIGHT == 320) && (TFT_WIDTH == 172) #ifndef CGRAM_OFFSET #define CGRAM_OFFSET #endif #endif #if (TFT_HEIGHT == 320) && (TFT_WIDTH == 170) # ifndef CGRAM_OFFSET #define CGRAM_OFFSET #endif #endif #if (TFT_HEIGHT == 300) && (TFT_WIDTH == 240) #ifndef CGRAM_OFFSET #define CGRAM_OFFSET #endif #endif // Delay between some initialisation commands #define TFT_INIT_DELAY 0x80 // Not used unless commandlist invoked // Generic commands used by TFT_eSPI.cpp #define TFT_NOP 0x00 #define TFT_SWRST 0x01 #define TFT_SLPIN 0x10 #define TFT_SLPOUT 0x11 #define TFT_NORON 0x13 #define TFT_INVOFF 0x20 #define TFT_INVON 0x21 #define TFT_DISPOFF 0x28 #define TFT_DISPON 0x29 #define TFT_CASET 0x2A #def ine TFT_PASET 0x2B #define TFT_RAMWR 0x2C #define TFT_RAMRD 0x2E #define TFT_MADCTL 0x36 #define TFT_COLMOD 0x3A // Flags for TFT_MADCTL #define TFT_MAD_MY 0x80 #define TFT_MAD_MX 0x40 #define TFT_MAD_MV 0x20 #define TFT_MAD_ML 0x10 #define TFT_MAD_RGB 0x00 #define TFT_MAD_BGR 0x08 #define TFT_MAD_MH 0x04 #define TFT_MAD_SS 0x02 #define TFT_MAD_GS 0x01 #ifdef TFT_RGB_ORDER #if (TFT_RGB_ORDER == 1) #define TFT_MA D_COLOR_ORDER TFT_MAD_RGB #else #define TFT_MAD_COLOR_ORDER TFT_MAD_BGR #endif #else #ifdef CGRAM_OFFSET #define TFT_MAD_COLOR_ORDER TFT_MAD_BGR #else #define TFT_MAD_COLOR_ORDER TFT_MAD_RGB #endif #endif #define TFT_IDXRD 0x00 // ILI9341 only,indexed control register read // ST7789 specific commands used in init #define ST7789_NOP 0x00 #define ST7789_SWRESET 0x01 #define ST7789_RDDID 0x04 #define ST7789_RDDST 0x09 #define ST7789_RDDPM 0x0A // Read display power mode #define ST7789_RDD_MADCTL 0 x0B // Read display MADCTL #define ST7789_RDD_COLMOD 0x0C // Read display pixel format #define ST7789_RDDIM 0x0D // Read display image mode #define ST7789_RDDSM 0x0E // Read display signal mode #define ST7789_RDDSR 0x0F // Read display self-diagnostic result (ST7789V) #define ST7789_SLPIN 0x10 #define ST7789_SLPOUT 0x11 #define ST7789_PTLON 0x12 #define ST7789_NORON 0x13 #define ST7789_INVOFF 0x20 #define ST7789_INVON 0x21 #define ST7789_GAMSET 0x26 // Gamma set #define ST7 789_DISPOFF 0x28 #define ST7789_DISPON 0x29 #define ST7789_CASET 0x2A #define ST7789_RASET 0x2B #define ST7789_RAMWR 0x2C #define ST7789_RGBSET 0x2D // Color setting for 4096,64K and 262K colors #define ST7789_RAMRD 0x2E #define ST7789_PTLAR 0x30 #define ST7789_VSCRDEF 0x33 // Vertical scrolling definition (ST7789V) #define ST7789_TEOFF 0x34 // Tearing effect line off #define ST7789_TEON 0x35 // Tearing effect line on #def ine ST7789_MADCTL 0x36 // Memory data access control #define ST7789_VSCRSADD 0x37 // Vertical screoll address #define ST7789_IDMOFF 0x38 // Idle mode off #define ST7789_IDMON 0x39 // Idle mode on #define ST7789_RAMWRC 0x3C // Memory write continue (ST7789V) #define ST7789_RAMRDC 0x3E // Memory read continue (ST7789V) #define ST7789_COLMOD 0x3A #define ST7789_RAMCTRL 0xB0 // RAM control #define ST7789_RGBCTRL 0xB1 // RGB control #define ST7789_PORCTRL 0xB2 // Porch control #define ST7789_FRCTRL1 0 xB3 // Frame rate control #define ST7789_PARCTRL 0xB5 // Partial mode control #define ST7789_GCTRL 0xB7 // Gate control #define ST7789_GTADJ 0xB8 // Gate on timing adjustment #define ST7789_DGMEN 0xBA // Digital gamma enable #define ST7789_VCOMS 0xBB // VCOMS setting #define ST7789_LCMCTRL 0xC0 // LCM control #define ST7789_IDSET 0xC1 // ID setting #define ST7789_VDVVRHEN 0xC2 // VDV and VRH command enable #define ST7789_VRHS 0xC3 // VRH set #define ST7789_VDVSET 0xC4 // VDV setting #define ST7789_VCMOFSET 0xC5 // VCOMS offset set #define ST7789_FRCTR2 0xC6 // FR Control 2 #define ST7789_CABCCTRL 0xC7 // CABC control #define ST7789_REGSEL1 0xC8 // Register value section 1 #define ST7789_REGSEL2 0xCA // Register value section 2 #define ST7789_PWMFRSEL 0xCC // PWM frequency selection #define ST7789_PWCTRL1 0xD0 // Power control 1 #define ST7789_VAPVANEN 0xD2 // Enable VAP/VAN signal output #define ST7789_CMD2EN 0xDF // Command 2 enable #define ST7789_PVGAMCTRL 0xE0 // Positive voltage gamma control #define ST7789_NVGAMCTRL 0xE1 // Negative voltage gamma control #define ST7789_DGMLUTR 0xE2 // Digital gamma look-up table for red #define ST7789_DGMLUTB 0xE3 // Digital gamma look-up table for blue #define ST7789_GATECTRL 0xE4 // Gate control #define ST7789_SPI2EN 0xE7 // SPI2 enable #define ST7789_PWCTRL2 0xE8 // Power control 2 #define ST7789_EQCTRL 0xE9 // Equalize time control #define ST7789_PROMCTRL 0xEC // Program control #define ST7789_PROMEN 0xFA // Program mode enable #define ST7789_NVMSET 0xFC // NVM setting #define ST7789_PROMACT 0xFE // Program action `` ` 3. Set the screen offset, file ST7789_Rotation.h ```c // This is the command sequence that rotates the ST7789 driver coordinate frame writecommand(TFT_MADCTL); rotation = m % 4; switch (rotation) { case 0: // Portrait #ifdef CGRAM_OFFSET if (_init_width == 135 ) { colstart = 52; rowstart = 40; } else if(_init_height == 280) { colstart = 0; rowstart = 20; } else if(_init_width == 172) { colstart = 34; rowstart = 0; } else if( _init_width == 170) { colstart = 35; rowstart = 0; } else { colstart = 0; rowstart = 0; } #endif writedata(TFT_MAD_COLOR_ORDER); _width = _init_width; _height = _init_height; break; case 1: // Landscape (Portrait + 90) #ifdef CGRAM_OFFSET if (_init_width == 135) { colstart = 40; rowstart = 53; } else if (_init_width == 240) { colstart = 40; rowstart = 53; } else if(_init_height == 280 ) { colstart = 20; rowstart = 0; } else if(_init_width == 172) { colstart = 0; rowstart = 34; } else if(_init_width == 170) { colstart = 0; rowstart = 35; } else { colstart = 0; rowstart = 0; } #endif writedata(TFT_MAD_MX | TFT_MAD_MV | TFT_MAD_COLOR_ORDER); _width = _init_height; _height = _init_width; break; case 2: // Inverter portrait #ifdef CGRAM_OFFSET if (_init_width == 135) { colstart = 53; rowstart = 40; } else if(_init_height == 280) { colstart = 0; rowstart = 20; } else if(_init_width == 172) { colstart = 34; rowstart = 0; } else if(_init_width == 170) { colstart = 35; rowstart = 0; } else { colstart = 0; rowstart = 80; } #endif writedata(TFT_MAD_MX | TFT_MAD_MY | TFT_MAD_COLOR_ORDER); _width = _init_width; _height = _init_height; break; case 3:// Inverted landscape #ifdef CGRAM_OFFSET if (_init_width == 135) { colstart = 40; rowstart = 52; } else if (_init_width == 240) { colstart = 40; rowstart = 52; } else if(_init_height == 280) { colstart = 20; rowstart = 0; } else if(_init_width == 172) { colstart = 0; rowstart = 34; } else if(_init_width == 170) { colstart = 0; rowstart = 35; } else { colstart = 80; rowstart = 0; } #endif writedata(TFT_MAD_MV | TFT_MAD_MY | TFT_MAD_COLOR_ORDER); _width = _init_height; _height = _init_width; break; } ``` 3. lvgl code adaptation 1. Copy lv_conf_template.h to lv_conf.h, and modify the configuration ```c /** * @file lv_conf.h * Configuration file for v8.3.9 */ /* * Copy this file as `lv_conf. h` * 1. simply next to the `lvgl` folder * 2. or any other places and * - define `LV_CONF_INCLUDE_SIMPLE` * - add the path as include path */ /* clang-format off */ #if 1 /* Set it to "1" to enable content*/ #ifndef LV_CONF_H #define LV_CONF_H #include<stdint.h> /*==================== COLOR SETTINGS *======================*/ /*Color depth: 1 (1 byte per pixel), 8 (RGB332), 16 (RGB565), 32 (ARGB8888)*/ #define LV_COLOR_DEPTH 16 /*Swap the 2 bytes of RGB565 color. Useful if the display has an 8-bit interface (eg SPI)*/ #define LV_COLOR_16_SWAP 0 /*Enable features to draw on transparent background. *It's required if opa, and transform_* style properties are used. *Can be also used if the UI is above another layer, eg an OSD menu or video player.*/ #define LV_COLOR_SCREEN_TRANSP 0 /* Adjust color mix functions rounding. GPUs might calculate color mix (blending) differently. * 0: round down, 64: round up from x.75, 128: round up from half, 192: round up from x.25, 254: round up */ #define LV_COLOR_MIX_ROUND_OFS 0 /*Images pixels with this color will not be drawn if they are chroma keyed)*/ #define LV_COLOR_CHROMA_KEY lv_color_hex(0x00ff00) /*pure green*/ /*=============== ========= MEMORY SETTINGS *=========================*/ /*1: use custom malloc/free, 0: use the built-in `lv_mem_alloc()` and `lv_mem_free()`*/ #define LV_MEM_CUSTOM 0 #if LV_MEM_CUSTOM == 0 /*Size of the memory available for `lv_mem_alloc()` in bytes (>= 2kB)*/ #define LV_MEM_SIZE (48U * 1024U) /*[ bytes]*/ /*Set an address for the memory pool instead of allocating it as a normal array. Can be in external SRAM too.*/ #define LV_MEM_ADR 0 /*0: unused*/ /*Instead of an address give a memory allocator that will be called to get a memory pool for LVGL. Eg my_malloc*/ #if LV_MEM_ADR == 0 #undef LV_MEM_POOL_INCLUDE #undef LV_MEM_POOL_ALLOC #endif #else /*LV_MEM_CUSTOM*/ #define LV_MEM_CUSTOM_INCLUDE<stdlib.h> /*Header for the dynamic memory function*/ #define LV_MEM_CUSTOM_ALLOC malloc #define LV_MEM_CUSTOM_FREE free #define LV_MEM_CUSTOM_REALLOC realloc #endif /*LV_MEM_CUSTOM*/ /*Number of the intermediate memory buffer used during rendering and other internal processing mechanisms. *You will see an error log message if there wasn't enough buffers. */ #define LV_MEM_BUF_MAX_NUM 16 /*Use the standard `memcpy` and `memset` instead of LVGL's own functions. (Might or might not be faster).*/ #define LV_MEMCPY_MEMSET_STD 0 /*==================== HAL SETTINGS *====================*/ /* Default display refresh period. LVG will redraw changed areas with this period time*/ #define LV_DISP_DEF_REFR_PERIOD 30 /*[ms]*/ /*Input device read period in milliseconds*/ #define LV_INDEV_DEF_READ_PERIOD 30 /*[ms]*/ /*Use a custom tick source that tells the elapsed time in milliseconds. *It removes the need to manually update the tick with `lv_tick_inc()`)*/ #define LV_TICK_CUSTOM 1 #if LV_TICK_CUSTOM #define LV_TICK_CUSTOM_INCLUDE "Arduino.h" /*Header for the system time function */ #define LV_TICK_CUSTOM_SYS_TIME_EXPR (millis()) /*Expression evaluating to current system time in ms*/ /*If using lvgl as ESP32 component*/ // #define LV_TICK_CUSTOM_INCLUDE "esp_timer.h" // #define LV_TICK_CUSTOM_SYS_TIME_EXPR ((esp_timer_get_time() / 1000LL)) #endif /*LV_TICK_CUSTOM*/ /*Default Dot Per Inch. Used to initialize default sizes such as widgets sized, style paddings. *(Not so important, you can adjust it to modify default sizes and spaces)*/ #define LV_DPI_DEF 130 /*[px/inch]*/ /*=================== ==== * FEATURE CONFIGURATION *=======================*/ /*------------- * Drawing *-----------*/ /*Enable complex draw engine. *Required to draw shadow, gradient, rounded corners, circles, arc, skew lines, image transformations or any masks*/ #define LV_DRAW_COMPLEX 1 #if LV_DRAW_COMPLEX != 0 /*Allow buffering some shadow calculation. *LV_SHADOW_CACHE_SIZE is the max. shadow size to buffer, where shadow size is `shadow_width + radius` *Caching has LV_SHADOW_CACHE_SIZE^2 RAM cost*/ #define LV_SHADOW_CACHE_SIZE 0 /* Set number of maximally cached circle data. * The circumference of 1/4 circle are saved for anti-aliasing * radius * 4 bytes are used per circle ( the most often used radiuses are saved) * 0:to disable caching */ #define LV_CIRCLE_CACHE_SIZE 4 #endif /*LV_DRAW_COMPLEX*/ /** * "Simple layers" are used when a widget has `style_opa < 255` to buffer the widget into a layer * and blend it as an image with the given opacity. * Note that `bg_opa`, `text_opa` etc don't require buffering into layer) * The widget can be buffered in smaller chunks to avoid using large buffers. * * - LV_LAYER_SIMPLE_BUF_SIZE: [bytes] the optimal target buffer size. LVGL will try to allocate it * - LV_LAYER_SIMPLE_FALLBACK_BUF_SIZE: [bytes] used if `LV_LAYER_SIMPLE_BUF_SIZE` couldn't be allocated. * * Both buffer sizes are in bytes. * "Transformed layers" (where transform_angle/zoom properties are used) use larger buffers * and can't be drawn in chunks. So these settings affects only widgets with opacity. */ #define LV_LAYER_SIMPLE_BUF_SIZE (24 * 1024) #define LV_LAYER_SIMPLE_FALLBACK_BUF_SIZE (3 * 1024) /*Default image cache size. Image caching keeps the images opened. *If only the built-in image formats are used there is no real advantage of caching. (Ie if no new image decoder is added) *With complex image decoders (eg PNG or JPG ) caching can save the continuous open/decode of images. *However the opened images might consume additional RAM. *0: to disable caching*/ #define LV_IMG_CACHE_DEF_SIZE 0 /*Number of stops allowed per gradient. Increase this to allow more stops. *This adds (sizeof(lv_color_t) + 1) bytes per additional stop*/ #define LV_GRADIENT_MAX_STOPS 2 /*Default gradient buffer size. *When LVGL calculates the gradient "maps" it can save them into a cache to avoid calculating them again. *LV_GRAD_CACHE_DEF_SIZE sets the size of this cache in bytes. *If the cache is too small the map will be allocated only while it's required for the drawing. *0 mean no caching.*/ #define LV_GRAD_CACHE_DEF_SIZE 0 /*Allow dithering the gradients (to achieve visual smooth color gradients on limited color depth display) *LV_DITHER_GRADIENT implies allocating one or two more lines of the object's rendering surface *The increase in memory consumption is (32 bits * object width) plus 24 bits * object width if using error diffusion */ # define LV_DITHER_GRADIENT 0 #if LV_DITHER_GRADIENT /*Add support for error diffusion dithering. *Error diffusion dithering gets a much better visual result, but implies more CPU consumption and memory when drawing. *The increase in memory consumption is (24 bits * object's width)*/ #define LV_DITHER_ERROR_DIFFUSION 0 #endif /*Maximum buffer size to allocate for rotation.*Only used if software rotation is enabled in the display driver.*/ #define LV_DISP_ROT_MAX_BUF (10*1024) /*------------- * GPU *--------- --*/ /*Use Arm's 2D acceleration library Arm-2D */ #define LV_USE_GPU_ARM2D 0 /*Use STM32's DMA2D (aka Chrom Art) GPU*/ #define LV_USE_GPU_STM32_DMA2D 0 #if LV_USE_GPU_STM32_DMA2D /*Must be defined to include path of CMSIS header of target processor eg "stm32f7xx.h" or "stm32f4xx.h"*/ #define LV_GPU_DMA2D_CMSIS_INCLUDE #endif /*Enable RA6M3 G2D GPU*/ #define LV_USE_GPU_RA6M3_G2D 0 #if LV_USE_GPU_RA6M3_G2D /*include path of target processor eg "hal_data.h"*/ #define LV_GPU_RA6M3_G2D_INCLUDE "hal_data.h" #endif /*Use SWM341's DMA2D GPU*/ #define LV_USE_GPU_SWM341_DMA2 D 0 #if LV_USE_GPU_SWM341_DMA2D #define LV_GPU_SWM341_DMA2D_INCLUDE "SWM341 .h" #endif /*Use NXP's PXP GPU iMX RTxxx platforms*/ #define LV_USE_GPU_NXP_PXP 0 #if LV_USE_GPU_NXP_PXP /*1: Add default bare metal and FreeRTOS interrupt handling routines for PXP (lv_gpu_nxp_pxp_osa.c) * and call lv_gpu_nxp_pxp_init() automatically during lv_init(). Note that symbol SDK_OS_FREE_RTOS * has to be defined in order to use FreeRTOS OSA, otherwise bare-metal implementation is selected. *0: lv_gpu_nxp_pxp_init() has to be called manually before lv_init() */ #define LV_USE_GPU_NXP_PXP_AUTO_INIT 0 #endif /*Use NXP's VG-Lite GPU iMX RTxxx platforms*/ #define LV_USE_GPU_NXP_VG_LITE 0 /*Use SDL renderer API*/ #define LV_USE_GPU_SDL 0 #if LV_USE_GPU_SDL # define LV_GPU_SDL_INCLUDE_PATHh" #endif /*Use NXP's PXP GPU iMX RTxxx platforms*/ #define LV_USE_GPU_NXP_PXP 0 #if LV_USE_GPU_NXP_PXP /*1: Add default bare metal and FreeRTOS interrupt handling routines for PXP (lv_gpu_nxp_pxp_osa.c) * and call lv_gpu_nxp_pxp_init() automatically during lv_init(). Note that symbol SDK_OS_FREE_RTOS * has to be defined in order to use FreeRTOS OSA, otherwise bare-metal implementation is selected. *0: lv_gpu_nxp_pxp_init() has to be called manually before lv_init() */ #define LV_USE_GPU_NXP_PXP_AUTO_INIT 0 # endif /*Use NXP's VG-Lite GPU iMX RTxxx platforms*/ #define LV_USE_GPU_NXP_VG_LITE 0 /*Use SDL renderer API*/ #define LV_USE_GPU_SDL 0 #if LV_USE_GPU_SDL #define LV_GPU_SDL_INCLUDE_PATHh" #endif /*Use NXP's PXP GPU iMX RTxxx platforms*/ #define LV_USE_GPU_NXP_PXP 0 #if LV_USE_GPU_NXP_PXP /*1: Add default bare metal and FreeRTOS interrupt handling routines for PXP (lv_gpu_nxp_pxp_osa.c) * and call lv_gpu_nxp_pxp_init() automatically during lv_init(). Note that symbol SDK_OS_FREE_RTOS * has to be defined in order to use FreeRTOS OSA, otherwise bare-metal implementation is selected. *0: lv_gpu_nxp_pxp_init() has to be called manually before lv_init() */ #define LV_USE_GPU_NXP_PXP_AUTO_INIT 0 # endif /*Use NXP's VG-Lite GPU iMX RTxxx platforms*/ #define LV_USE_GPU_NXP_VG_LITE 0 /*Use SDL renderer API*/ #define LV_USE_GPU_SDL 0 #if LV_USE_GPU_SDL #define LV_GPU_SDL_INCLUDE_PATH<sdl2 sdl.h=""> /*Texture cache size, 8MB by default*/ #define LV_GPU_SDL_LRU_SIZE (1024 * 1024 * 8) /*Custom blend mode for mask drawing, disable if you need to link with older SDL2 lib*/ #define LV_GPU_SDL_CUSTOM_BLEND_MODE (SDL_VERSION_ATLEAST(2, 0, 6)) #endif /*------------- * Logging *-----------*/ /*Enable the log module*/ #define LV_USE_LOG 0 #if LV_USE_LOG /*How important log should be added: *LV_LOG_LEVEL_TRACE A lot of logs to give detailed information *LV_LOG_LEVEL_INFO Log important events *LV_LOG_LEVEL_WARN Log if something unwanted happened but didn't cause a problem *LV_LOG_LEVEL_ERROR Only critical issue, when the system may fail *LV_LOG_LEVEL_USER Only logs added by the user *LV_LOG_LEVEL_NONE Do not log anything*/ #define LV_LOG_LEVEL LV_LOG_LEVEL_WARN /*1: Print the log with 'printf'; *0: User need to register a callback with `lv_log_register_print_cb()`*/ #define LV_LOG_PRINTF 0 /*Enable/disable LV_LOG_TRACE in modules that produces a huge number of logs*/ #define LV_LOG_TRACE_MEM 1 #define LV_LOG_TRACE_TIMER 1 #define LV_LOG_TRACE_INDEV 1 #define LV_LOG_TRACE_DISP_REFR1 #define LV_LOG_TRACE_EVENT 1 #define LV_LOG_TRACE_OBJ_CREATE 1 #define LV_LOG_TRACE_LAYOUT 1 #define LV_LOG_TRACE_ANIM 1 #endif/*LV_USE_LOG*/ /*------------- * Asserts *-----------*/ /*Enable asserts if an operation is failed or an invalid data is found. *If LV_USE_LOG is enabled an error message will be printed on failure*/ #define LV_USE_ASSERT_NULL 1 /*Check if the parameter is NULL. (Very fast, recommended)*/ #define LV_USE_ASSERT_MALLOC 1 /*Checks is the memory is successfully allocated or no. (Very fast, recommended)*/ #define LV_USE_ASSERT_STYLE 0 /*Check if the styles are properly initialized. (Very fast, recommended)*/ #define LV_USE_ASSERT_MEM_INTEGRITY 0 /*Check the integrity of `lv_mem` after critical operations. (Slow)*/ #define LV_USE_ASSERT_OBJ 0 /*Check the object's type and existence (e.g. not deleted). (Slow)*/ /*Add a custom handler when assert happens e.g. to restart the MCU*/ #define LV_ASSERT_HANDLER_INCLUDE <stdint.h> #define LV_ASSERT_HANDLER while(1); /*Halt by default*/ /*------------- * Others *----------*/ /*1: Show CPU usage and FPS count*/ #define LV_USE_PERF_MONITOR 0 #if LV_USE_PERF_MONITOR #define LV_USE_PERF_MONITOR_POS LV_ALIGN_BOTTOM_RIGHT #endif /*1: Show the used memory and the memory fragmentation * Requires LV_MEM_CUSTOM = 0*/ #define LV_USE_MEM_MONITOR 0 #if LV_ USE_MEM_MONITOR #define LV_USE_MEM_MONITOR_POS LV_ALIGN_BOTTOM_LEFT #endif /*1: Draw random colored rectangles over the redrawn areas*/ #define LV_USE_REFR_DEBUG 0 /*Change the built in (v)snprintf functions*/ #define LV_SPRINTF_CUSTOM 0 #if LV_SPRINTF_CUSTOM #define LV_SPRINTF_INCLUDE<stdio.h> #define lv_snprintf snprintf #define lv_vsnprintf vsnprintf #else /*LV_SPRINTF_CUSTOM*/ #define LV_SPRINTF_USE_FLOAT 0 #endif /*LV_SPRINTF_CUSTOM*/ #define LV_USE_USER_DATA 1 /*Garbage Collector settings *Used if lvgl is bound to higher level language and the memory is managed by that language*/ #define LV_ENABLE_GC 0 #if LV_ENABLE_GC != 0 #define LV_GC_INCLUDE "gc.h" /*Include Garbage Collector related things*/ #endif /*LV_ENABLE_GC*/ /*========= ============ * COMPILER SETTINGS *====================*/ /*For big endian systems set to 1*/ #define LV_BIG_ENDIAN_SYSTEM 0 /*Define a custom attribute to `lv_tick_inc` function* / #define LV_ATTRIBUTE_TICK_INC /*Define a custom attribute to `lv_timer_handler` function*/ #define LV_ATTRIBUTE_TIMER_HANDLER /*Define a custom attribute to `lv_disp_flush_ready` function*/ #define LV_ATTRIBUTE_FLUSH_READY /*Required alignment size for buffers*/ #define LV_ATTRIBUTE_MEM_ ALIGN_SIZE 1 / *Will be added where memories needs to be aligned (with -Os data might not be aligned to boundary by default). * Eg __attribute__((aligned(4)))*/ #define LV_ATTRIBUTE_MEM_ALIGN /*Attribute to mark large constant arrays for example font's bitmaps*/ #define LV_ATTRIBUTE_LARGE_CONST /*Compiler prefix for a big array declaration in RAM*/ #define LV_ATTRIBUTE_LARGE_RAM_ARRAY /*Place performance critical functions into a faster memory (eg RAM) */ #define LV_ATTRIBUTE_FAST_MEM /*Prefix variables that are used in GPU accelerated operations, often these need to be placed in RAM sections that are DMA accessible*/ #define LV_ATTRIBUTE_DMA /*Export integer constant to binding. This macro is used with constants in the form of LV_<const>that *should also appear on LVGL binding API such as Micropython.*/ #define LV_EXPORT_CONST_INT(int_value) struct _silence_gcc_warning /*The default value just prevents GCC warning*/ /*Extend the default -32k..32k coordinate range to -4M. .4M by using int32_t for coordinates instead of int16_t*/ #define LV_USE_LARGE_COORD 0 /*================== * FONT USAGE *========== =========*/ /*Montserrat fonts with ASCII range and some symbols using bpp = 4 *https://fonts.google.com/specimen/Montserrat*/ #define LV_FONT_MONTSERRAT_8 0 #define LV_FONT_MONTSERRAT_10 0 #define LV_FONT_MONTSERRAT_12 0 #define LV_FONT_MONTSERRAT_14 1 #define LV_FONT_MONTSERRAT_16 0 #define LV_FONT_MONTSERRAT_18 0 #define LV_FONT_MONTSERRAT_20 0 #define LV_FONT_MONTSER RAT_22 0 #define LV_FONT_MONTSERRAT_24 0 #define LV_FONT_MONTSERRAT_26 0 #define LV_FONT_MONTSERRAT_28 0 #define LV_FONT_MONTSERRAT_30 0 #define LV_FONT_MONTSERRAT_32 0 #define LV_FONT_MONTSERRAT_34 0 #define LV_FONT_MONTSERRAT_36 0 #define LV_FONT_MONTSERRAT_38 0 #define LV_FONT_MONTSERRAT_40 0 #define LV_FONT_MONTSERRAT_42 0 #define LV_FONT_MONTSERRAT_44 0 #define LV_FONT_MONTSERRAT_46 0 #define LV_FONT_ MONTSERRAT_48 0 /*Demonstrate special features*/ #define LV_FONT_MONTSERRAT_12_SUBPX 0 #define LV_FONT_MONTSERRAT_28_COMPRESSED 0 /*bpp = 3*/ #define LV_FONT_DEJAVU_16_PERSIAN_HEBREW 1 /*Hebrew, Arabic, Persian letters and all their forms*/ #define LV_FONT_SIMSUN_16_CJK 1 /*1000 most common CJK radicals*/ /*Pixel perfect monospace fonts*/ #define LV_FONT_UNSCII_8 0 #define LV_FONT_UNSCII_16 0 /*Optionally declare custom fonts here. *You can use these fonts as default font too and they will be available globally. *Eg #define LV_FONT_CUSTOM_DECLARE LV_FONT_DECLARE(my_font_1) LV_FONT_DECLARE(my_font_2)*/ #define LV_FONT_CUSTOM_DECLARE /*Always set a default font*/ #define LV_FONT_DEFAULT &lv_font_montserrat_14 /*Enable handling large font and/or fonts with a lot of characters . *The limit depends on the font size, font face and bpp. *Compiler error will be triggered if a font needs it.*/ #define LV_FONT_FMT_TXT_LARGE 0 /*Enables/disables support for compressed fonts.*/ #define LV_USE_FONT_COMPRESSED 0 /*Enable subpixel rendering*/ #define LV_USE_FONT_SUBPX 0 #if LV_USE_FONT_SUBPX /* Set the pixel order of the display. Physical order of RGB channels. Doesn't matter with "normal" fonts.*/ #define LV_FONT_SUBPX_BGR 0 /*0: RGB; 1:BGR order*/ #endif /*Enable drawing placeholders when glyph dsc is not found*/ #define LV_USE_FONT_PLACEHOLDER 1 /*================= * TEXT SETTINGS *==== =============*/ /** * Select a character encoding for strings. * Your IDE or editor should have the same character encoding * - LV_TXT_ENC_UTF8 * - LV_TXT_ENC_ASCII */ #define LV_TXT_ENC LV_TXT_ENC_UTF8 / *Can break (wrap) texts on these chars*/ #define LV_TXT_BREAK_CHARS " ,.;:-_" /*If a word is at least this long, will break wherever "prettyest" *To disable, set to a value <= 0*/ #define LV_TXT_LINE_BREAK_LONG_LEN 0 /*Minimum number of characters in a long word to put on a line before a break. . *Depends on LV_TXT_LINE_BREAK_LONG_LEN.*/ #define LV_TXT_LINE_BREAK_LONG_POST_MIN_LEN 3 /*The control character to use for signaling text recoloring.*/ #define LV_TXT_COLOR_CMD "#" /*Support bidirectional texts. Allows mixing Left-to-Right and Right-to- Left texts. *The direction will be processed according to the Unicode Bidirectional Algorithm: *https://www.w3.org/International/articles/inline-bidi-markup/uba-basics*/ #define LV_USE_BIDI 1 #if LV_USE_BIDI /*Set the default direction. Supported values: *`LV_BASE_DIR_LTR` Left -to-Right *`LV_BASE_DIR_RTL` Right-to-Left *`LV_BASE_DIR_AUTO` detect texts base direction*/ #define LV_BIDI_BASE_DIR_DEF LV_BASE_DIR_AUTO #endif /*Enable Arabic/Persian processing *In these languages characters should be replaced with an other form based on their position in the text*/ #define LV_USE_ARABIC_PERSIAN_CHARS 0 /*================== * WIDGET USAGE *================*/ /*Documentation of the widgets: https://docs.lvgl.io/latest/en/html/widgets/index.html*/ # LV_USE_ARC 1 #define LV_USE_BAR 1 #define LV_USE_BTN 1 #define LV_USE_BTNMATRIX 1 #define LV_USE_CANVAS 1 #define LV_USE_CHECKBOX 1 #define LV_USE_DROPDOWN 1 /*Requires: lv_label*/ #define LV_USE_IMG 1 /*Requires: define lv_label*/ #define LV_USE_LABEL 1 # if LV_USE_LABEL #define LV_LABEL_TEXT_SELECTION 1 /*Enable selecting text of the label*/ #define LV_LABEL_LONG_TXT_HINT 1 /*Store some extra info in labels to speed up drawing of very long texts*/ #endif #define LV_USE_LINE 1 #define LV_USE_ROLLER 1 /*Requires:lv_label*/ #if LV_USE_ROLLER #define LV_ROLLER_INF_PAGES 7 /*Number of extra "pages" when the roller is infinite*/ #endif #define LV_USE_SLIDER 1 /*Requires: lv_bar*/ #define LV_USE_SWITCH 1 #define LV_USE_TEXTAREA 1 /*Requires: lv_label*/ #if LV_USE_TEXTAREA != 0 #define LV_TEXTAREA_DEF_PWD_SHOW_TIME 1500 /*ms*/ #endif #define LV_USE_TABLE 1 /*================== * EXTRA COMPONENTS *== ================*/ /*----------- * Widgets *----------*/ #define LV_USE_ANIMIMG 1 #define LV_USE_CALENDAR 1 #if LV_USE_CALENDAR #define LV_CALENDAR_WEEK_STARTS_MONDAY 0 #if LV_CALENDAR_WEEK_STARTS_MONDAY #define LV_CALENDAR_DEFAULT_DAY_NAMES {"Mo", "Tu", "We", "Th", "Fr", ", "Su"} #else #define LV_CALENDAR_DEFAULT_DAY_NAMES {"Su", "Mo", "Tu", "We", "Th", "Fr", "Sa"} #endif #define LV_CALENDAR_DEFAULT_MONTH_NAMES {"January", "February", "March ", "April", "May", "June", "July", "August", "September", "October", "November", "December"} #define LV_USE_CALENDAR_HEADER_ARROW 1 #define LV_USE_CALENDAR_HEADER_DROPDOWN 1 #endif /*LV_USE_CALENDAR*/ #define LV_USE_CHART 1 #define LV_USE_COLORWHEEL 1 #define LV_USE_IMGBTN 1 #define LV_USE_KEYBOARD 1 #define LV_USE_LED 1 #define LV_USE_LIST 1 #define LV_USE_MENU 1 #define LV_USE_METER 1 #define LV_USE_MSGBOX 1 #define LV_USE_SPAN 1 #if LV_USE_SPAN /*A line text can contain maximum num of span descriptor */ #define LV_SPAN_SNIPPET_STACK_SIZE 64 #endif #define LV_USE_SPINBOX 1 #define LV_USE_SPINNER 1 #define LV_USE_TABVIEW 1 #define LV_USE_TILEVIEW 1 #define LV_USE_WIN 1 /*---------- * Themes *---------- */ /*A simple, impressive and very complete theme*/ #define LV_USE_THEME_DEFAULT 1 #if LV_USE_THEME_DEFAULT /*0: Light mode; 1: Dark mode*/ #define LV_THEME_DEFAULT_DARK 0 /*1:Enable grow on press*/ #define LV_THEME_DEFAULT_GROW 1 /*Default transition time in [ms]*/ #define LV_THEME_DEFAULT_TRANSITION_TIME 80 #endif /*LV_USE_THEME_DEFAULT*/ /*A very simple theme that is a good starting point for a custom theme*/ #define LV_USE_THEME_BASIC 1 /*A theme designed for monochrome displays*/ #define LV_USE_THEME_MONO 1 /*----------- * Layouts *----------*/ /*A layout similar to Flexbox in CSS.*/ #define LV_USE_FLEX 1 /*A layout similar to Grid in CSS.*/ #define LV_USE_GRID 1 /*-------------------------- - * 3rd party libraries *--------------------*/ /*File system interfaces for common APIs */ /*API for fopen, fread, etc*/ #define LV_USE_FS_STDIO 0 #if LV_USE_FS_STDIO #define LV_FS_STDIO_LETTER '\0' /*Set an upper cased letter on which the drive will accessible (eg 'A')*/ #define LV_FS_STDIO_PATH "" /*Set the working directory. File/directory paths will be appended to it.*/ #define LV_FS_STDIO_CACHE_SIZE 0 /*>0 to cache this number of bytes in lv_fs_read()*/ #endif /*API for open, read, etc*/ #define LV_USE_FS_POSIX 0 #if LV_USE_FS_POSIX #define LV_FS_POSIX_LETTER '\0' /*Set an upper cased letter on which the drive will accessible (eg 'A')*/ #define LV_FS_POSIX_PATH "" /*Set the working directory. File/directory paths will be appended to it.*/ #define LV_FS_POSIX_CACHE_SIZE 0 /*>0 to cache this number of bytes in lv_fs_read()*/ #endif /*API for CreateFile, ReadFile , etc*/ #define LV_USE_FS_WIN32 0 #if LV_USE_FS_WIN32 #define LV_FS_WIN32_LETTER '\0' /*Set an upper cased letter on which the drive will accessible (eg 'A')*/ #define LV_FS_WIN32_PATH "" /*Set the working directory . File/directory paths will be appended to it.*/ #define LV_FS_WIN32_CACHE_SIZE 0 /*>0 to cache this number of bytes in lv_fs_read()*/ #endif /*API for FATFS (needs to be added separately). Uses f_open, f_read, etc*/ #define LV_USE_FS_FATFS 0 #if LV_USE_FS_FATFS #define LV_FS_FATFS_LETTER '\0' /*Set an upper cased letter on which the drive will accessible (eg 'A')*/ #define LV_FS_FATFS_CACHE_SIZE 0 /*> 0 to cache this number of bytes in lv_fs_read()*/ #endif /*PNG decoder library*/ #define LV_USE_PNG 1 /*BMP decoder library*/ #define LV_USE_BMP 0 /* JPG + split JPG decoder library. * Split JPG is a custom format optimized for embedded systems.*/ #define LV_USE_SJPG 0 /*GIF decoder library*/ #define LV_USE_GIF 0 /*QR code library*/ #define LV_USE_QRCODE 0 /*FreeType library*/ #define LV_USE_FREETYPE 0 #if LV_USE_FREETYPE /*Memory used by FreeType to cache characters [bytes] (-1: no caching)*/ #define LV_FREETYPE_CACHE_SIZE (16 * 1024) #if LV_FREETYPE_CACHE_SIZE >= 0 /* 1: bitmap cache use the sbit cache, 0: bitmap cache use the image cache. */ /* sbit cache:it is much more memory efficient for small bitmaps(font size < 256) */ /* if font size >= 256, must be configured as image cache */ #define LV_FREETYPE_SBIT_CACHE 0 /* Maximum number of opened FT_Face/FT_Size objects managed by this cache instance. */ /* (0:use system defaults) */ #define LV_FREETYPE_CACHE_FT_FACES 0 #define LV_FREETYPE_CACHE_FT_SIZES 0 #endif #endif /*Rlottie library*/ # LV_USE_RLOTTIE 0 /*FFmpeg library for image decoding and playing videos *Supports all major image formats so do not enable other image decoder with it*/ #define LV_USE_FFMPEG 0 #if LV_USE_FFMPEG /*Dump input information to stderr*/ #define LV_FFMPEG_DUMP_FORMAT 0 define #endif /*----------- * Others *----------*/ /*1: Enable API to take snapshot for object*/ #define LV_USE_SNAPSHOT 0 /*1: Enable Monkey test*/ #define LV_USE_MONKEY 0 /*1: Enable grid navigation*/ #define LV_USE_GRIDNAV 0 /*1: Enable lv_obj fragment*/ #define LV_USE_FRAGMENT 0 /*1: Support using images as font in label or span widgets */ #define LV_USE_IMGFONT 0 /*1: Enable a published subscriber based messaging system */ #define LV_USE_MSG 0 /*1: Enable Pinyin input method*/ /*Requires: lv_keyboard*/ #define LV_USE_IME_PINYIN 0 # if LV_USE_IME_PINYIN /*1: Use default thesaurus*/ /*If you do not use the default thesaurus,be sure to use `lv_ime_pinyin` after setting the thesauruss*/ #define LV_IME_PINYIN_USE_DEFAULT_DICT 1 /*Set the maximum number of candidate panels that can be displayed*/ /*This needs to be adjusted according to the size of the screen*/ #define LV_IME_PINYIN_CAND_TEXT_NUM 6 /*Use 9 key input(k9)*/ #define LV_IME_PINYIN_USE_K9_MODE 1 #if LV_IME_PINYIN_USE_K9_MODE == 1 #define LV_IME_PINYIN_K9_CAND_TEXT_NUM 3 #endif // LV_IME_PINYIN_USE_K9_MODE #end if /*============== ==== * EXAMPLES *==================*/ /*Enable the examples to be built with the library*/ #define LV_BUILD_EXAMPLES 1 /*==================== * DEMO USAGE ========= ===========*/ /*Show some widget. It might be required to increase `LV_MEM_SIZE` */ #define LV_USE_DEMO_WIDGETS 0 #if LV_USE_DEMO_WIDGETS #define LV_DEMO_WIDGETS_SLIDESHOW 0 #endif /*Demonstrate the usage of encoder and keyboard*/ #define LV_USE_DEMO_KEYPAD_AND_ENCODER 0 /*Benchmark your system*/ #define LV_USE_DEMO_BENCHMARK 0 #if LV_USE_DEMO_BENCHMARK /*Use RGB565A8 images with 16 bit color depth instead of ARGB8565*/ #define LV_DEMO_BENCHMARK_RGB565A8 0 #endif /*Stress test for LVGL*/ #define LV_USE_DEMO_STRESS 0 /*Music player demo*/ #define LV_USE_DEMO_MUSIC 0 #if LV_USE_DEMO_MUSIC #define LV_DEMO_MUSIC_SQUARE 0 #define LV_DEMO_MUSIC_LANDSCAPE 0 #define LV_DEMO_MUSIC_ROUND 0 #define LV_DEMO_MUSIC_LARGE 0 #define LV_DEMO_MUSIC_AUTO_PLAY 0 #endif /*--END OF LV_CONF_H--*/ #endif /*LV_CONF_H*/ #endif /*End of "Content enable"*/ ``` 2. Application code display```c // // Created by Administrator on 2023-10-04. // #includeIt might be required to increase `LV_MEM_SIZE` */ #define LV_USE_DEMO_WIDGETS 0 #if LV_USE_DEMO_WIDGETS #define LV_DEMO_WIDGETS_SLIDESHOW 0 #endif /*Demonstrate the usage of encoder and keyboard*/ #define LV_USE_DEMO_KEYPAD_AND_ENCODER 0 /*Benchmark your system*/ #define LV_USE_DEMO_BENCHMARK 0 #if LV_USE_DEMO_BENCHMARK /*Use RGB565A8 images with 16 bit color depth instead of ARGB8565*/ #define LV_DEMO_BENCHMARK_RGB565A8 0 #endif /*Stress test for LVGL*/ #define LV_USE_DEMO_STRESS 0 /*Music player demo*/ #define LV_USE_DEMO_MUSIC 0 #if LV_USE_DEMO_MUSIC #define LV_DEMO_MUSIC_SQUARE 0 #define LV_DEMO_MUSIC_LANDSCAPE 0 #define LV_DEMO_MUSIC_ROUND 0 #define LV_DEMO_MUSIC_LARGE 0 #define LV_DEMO_MUSIC_AUTO_PLAY 0 #endif /*--END OF LV _CONF_H--*/ #endif /*LV_CONF_H*/ #endif /*End of "Content enable"*/ ``` 2. Application code display```c // // Created by Administrator on 2023-10-04. // #includeIt might be required to increase `LV_MEM_SIZE` */ #define LV_USE_DEMO_WIDGETS 0 #if LV_USE_DEMO_WIDGETS #define LV_DEMO_WIDGETS_SLIDESHOW 0 #endif /*Demonstrate the usage of encoder and keyboard*/ #define LV_USE_DEMO_KEYPAD_AND_ENCODER 0 /*Benchmark your system*/ #define LV_USE_DEMO_BENCHMARK 0 #if LV_USE_DEMO_BENCHMARK /*Use RGB565A8 images with 16 bit color depth instead of ARGB8565*/ #define LV_DEMO_BENCHMARK_RGB565A8 0 #endif /*Stress test for LVGL*/ #define LV_USE_DEMO_STRESS 0 /*Music player demo*/ #define LV_USE_DEMO_MUSIC 0 #if LV_USE_DEMO_MUSIC #define LV_DEMO_MUSIC_SQUARE 0 #define LV_DEMO_MUSIC_LANDSCAPE 0 #define LV_DEMO_MUSIC_ROUND 0 #define LV_DEMO_MUSIC_LARGE 0 #define LV_DEMO_MUSIC_AUTO_PLAY 0 #endif /*--END OF LV _CONF_H--*/ #endif /*LV_CONF_H*/ #endif /*End of "Content enable"*/ ``` 2. Application code display```c // // Created by Administrator on 2023-10-04. // #include<lvgl.h> #include<tft_espi.h> #include "extra/libs/png/lv_png.h" #include "demos/lv_demos.h" #include "esp32s3_wifi.h" #include "iot-cat-logo.c" /*Change to your screen resolution*/ static const uint16_t screenWidth = 240; static const uint16_t screenHeight = 135; static lv_disp_draw_buf_t draw_buf; static lv_color_t buf[ screenWidth * screenHeight / 10 ]; // Global variable lv_obj_t * cz_label; TFT_eSPI tft = TFT_eSPI(screenWidth, screenHeight); /* TFT instance */ #if LV_USE_LOG != 0 /* Serial debugging */ static void my_print(const char * buf) { Serial.printf(buf); Serial.flush(); } #endif __attribute__((unused)) static void esp32s3_lvgl_arduino_demos( void ) { /* Create simple label */ lv_obj_t *label = lv_label_create( lv_scr_act() ); lv_label_set_text( label, "Hello Ardino and LVGL!"); lv_obj_align( label , LV_ALIGN_CENTER, 0, 0 ); /*Or try out a demo. Don't forget to enable the demos in lv_conf.h. Eg LV_USE_DEMO_WIDGETS*/ // lv_demo_widgets(); // lv_demo_benchmark(); // lv_demo_keypad_encoder() ; // lv_demo_music(); // lv_demo_printer(); // lv_demo_stress(); } static void update_label(void) { char *str = getFormattedString(getESP32ClockStr(), app_weather_data.temperature); if (str != NULL) { lv_label_set_text(cz_label, str); printf("%s\n", str); free(str ; ()); lv_img_set_src(img_bg, &my_image); lv_obj_align(img_bg, LV_ALIGN_BOTTOM_RIGHT, 0, 0); cz_label = lv_label_create(lv_scr_act()); lv_label_set_text(cz_label, "Loading..."); lv_obj_set_style_text_font(cz_label, &lv_font_simsun_16_cjk, 0); lv_obj_set_width(cz_label, 24 0); lv_obj_align(cz_label, LV_ALIGN_CENTER, 5, -5); #endif } /* Display flushing */ static void my_disp_flush( lv_disp_drv_t *disp_drv, const lv_area_t *area, lv_color_t *color_p ) { uint32_t w = ( area->x2 - area->x1 + 1 ); uint32_t h = ( area->y2 - area->y1 + 1 ); tft.startWrite(); tft.setAddrWindow( area->x1, area->y1, w, h ); tft.pushColors( ( uint16_t * )&color_p->full , w * h, true ); tft.endWrite(); lv_disp_flush_ready( disp_drv ); } static void esp32s3_ftt_init() { // turn on backlite pinMode(TFT_BACKLITE, OUTPUT); digitalWrite(TFT_BACKLITE, HIGH); // turn on the TFT / I2C power supply pinMode(TFT_I2C_POWER, OUTPUT ); digitalWrite(TFT_I2C_POWER, HIGH); delay(10); tft.begin(); tft.setRotation( 1 ); /* Landscape orientation, flipped */ } [[noreturn]] void esp32s3_lvgl_task( void * parameter ) { Serial .println("Enter esp32s3_lvgl_task!"); lv_init(); lv_png_init(); #if LV_USE_LOG != 0 lv_log_register_print_cb( my_print ); /* register print function for debugging */ #endif esp32s3_ftt_init(); /* TFT init */ lv_disp_draw_buf_init( &draw_buf, buf, NULL, screenWidth * screenHeight / 10 ); /*Initialize the display*/ static lv_disp_drv_t disp_drv; lv_disp_drv_init( &disp_drv ); /*Change the following line to your display resolution*/ disp_drv.hor_res = screenWidth; disp_drv.ver_res = screenHeight; disp_drv.flush_cb = my_disp_flush; disp_drv.draw_buf = &draw_buf; lv_disp_drv_register( &disp_ drv ); my_lvgl_demo(); // Create a timer to update the time and temperature data every 1 second while(true) { lv_timer_handler(); /* let the GUI do its work */ delay( 1000 ); } Serial.println(" Ending esp32s3_lvgl_task!"); vTaskDelete( nullptr ); } ``` ## 4. Use of network functions 1. The header file that needs to be included is ```c // Contains the WiFi api interface #includeflush_cb = my_disp_flush; disp_drv.draw_buf = &draw_buf; lv_disp_drv_register( &disp_drv ); my_lvgl_demo(); // Create a timer to update the time and temperature data every 1 second while(true) { lv_timer_handler(); /* let the GUI do its work */ delay( 1000 ); } Serial.println("Ending esp32s3_lvgl_task!"); vTaskDelete( nullptr ); } ``` ## 4. Use of network functions 1. The header file that needs to be included is ```c // Contains the WiFi api interface #includeflush_cb = my_disp_flush; disp_drv.draw_buf = &draw_buf; lv_disp_drv_register( &disp_drv ); my_lvgl_demo(); // Create a timer to update the time and temperature data every 1 second while(true) { lv_timer_handler(); /* let the GUI do its work */ delay( 1000 ); } Serial.println("Ending esp32s3_lvgl_task!"); vTaskDelete( nullptr ); } ``` ## 4. Use of network functions 1. The header file that needs to be included is ```c // Contains the WiFi api interface #include<wifi.h> // Two header files are needed when getting weather requests#include<httpclient.h> #include<arduinojson.h> ``` 2. Connection code and time acquisition code display```c // // Created by Administrator on 2023-10-04. // #include<wifi.h> #include<httpclient.h> #include "time.h" #include<arduinojson.h> #include "esp32s3_wifi.h" #include "esp32s3_button.h" #define STATUS "status" #define LIVES "lives" #define WEATHER "weather" #define TEMP "temperature" #define TIME "reporttime" String url = "https: //restapi.amap.com/v3/weather/weatherInfo?city=310000&key=??? const char* id="xxx"; const char* psw="xxx"; const char* ntpServer = "pool.ntp.org "; const long gmtOffset_sec = 8*60*60; const int daylightOffset_sec = 0; bool esp32s3WiFiConnected = false; #if 1 static void esp32s3_wifi_start() { WiFi.begin(id,psw); while(WiFiClass::status()!=WL_CONNECTED){ delay(500); Serial.println("wifi connecting..."); esp32s3WiFiConnected = false; } esp32s3WiFiConnected = true; configTime(gmtOffset_sec, daylightOffset_sec, ntpServer); delay (1000); Serial.println("wifi connected!"); } #endif static void parse_http_data(const char *http_data) { DynamicJsonDocument doc(512); // Resize according to the size of JSON dataDeserializationError error = deserializeJson(doc, http_data); if (!error) { Serial.println("JSON_data:"); serializeJsonPretty(doc, Serial); const char* status = doc[STATUS]; if (status) { Serial.printf("status: %d , %s\r\n", atoi(status), status); JsonArray lives = doc[LIVES]; if (lives) { Serial.printf("!!size: %d\r\n", lives.size()); for (JsonObject live_obj : lives) { const char* temp = live_obj[TEMP]; sprintf(app_weather_data.temperature, "%s", temp); Serial.println(app_weather_data.temperature); } } } } else { Serial.println("deserializeJson() failed with code "); Serial.println(error.c_str()); } } void esp32s3_wifi_task( void * parameter ) { Serial.println("Enter esp32s3_wifi_task!"); esp32s3_wifi_start(); while(true) { while(WiFiClass ::status()==WL_CONNECTED) { esp32s3WiFiConnected = true; if(esp32s3ButtonDoubleClick) { esp32s3ButtonDoubleClick = false; Serial.println("\nStarting connection to server..."); http.begin(url); // start get int http_code = http.GET(); / / handle http code if (http_code != HTTP_CODE_OK) { // get fail. Serial.printf("GET fail, http code is %s\n", http.errorToString(http_code).c_str()); return; } // http response String response = http.getString(); Serial.printf("response:[%s]\n", response.c_str()); parse_http_data(response.c_str() ); // close http http.end(); Serial.println("\nClose http code..."); } } while(WiFiClass::status()!=WL_CONNECTED) { delay(500); Serial.println ("wifi connecting..."); esp32s3WiFiConnected = false; } delay(1000); } Serial.println("Ending esp32s3_wifi_task!"); vTaskDelete( nullptr ); } ``` ## 5. Control WS2812B 1. Add Dependent library that drives WS2812 ```arduino lib_deps = fastled/FastLED@^3.6.0 ``` 2. FastLED **`FastLED`** is an Arduino library for controlling WS2812 and similar LED strips. It allows you to more easily control colored LED strips in your Arduino projects, making various lighting effects, animations and Colorful effects. The library is very popular because it provides high-performance LED control functions and supports a variety of different LED types. In the commercial market, there are also many products developed using the FastLED library. 3. Code display ``` c // // Created by Administrator on 2023-10-04. // #include<arduino.h> #include<fastled.h> #include "esp32s3_button.h" #define DATA_PIN PIN_NEOPIXEL #define NUM_LEDS NEOPIXEL_NUM CRGB crgb[NUM_LEDS]; static void esp32s3_ws2812_led_init() { CFastLED::addLeds<ws2812b, data_pin,="" rgb="">(crgb, NUM_LEDS); } [[noreturn]] void esp32s3_ws2812_led_task( void * parameter ) { Serial.println("Enter esp32s3_ws2812_led_task!"); esp32s3_ws2812_led_init(); while(true){ crgb[0] = CRGB::Blue; FastLED.show(); delay(1000); crgb[0] = CRGB::Black; FastLED.show(); delay(1000); } Serial.println("Ending esp32s3_ws2812_led_task!"); vTaskDelete( nullptr ); } ``` ## 6. Calendar & Clock 1. Weather acquisition```c // HTTPClient init HTTPClient http; app_weather_t app_weather_data; String url = "https://restapi.amap.com/v3/weather/weatherInfo?city=??&key=??? http.begin(url); // start get int http_code = http.GET(); // handle http code if (http_code != HTTP_CODE_OK) { // get fail. Serial.printf("GET fail, http code is %s\n", http.errorToString(http_code).c_str()); return; } // http response String response = http.getString(); Serial.printf("response:[%s]\n", response.c_str()); // close http http.end(); Serial.println("\nClose http code..."); ``` 2. Weather parameter acquisition and analysis```c // Weather JSON data after request // {"status":"1","count":"1","info":"OK","infocode":"10000","lives":[{"province":"Guangdong","city" :"Bao'an District","adcode":"440306","weather":"Cloudy","temperature":"28","winddirection":"Northeast","windpower":"6","humidity": "59","reporttime":"2023-10-05 22:00:48","temperature_float":"28.0","humidity_float":"59.0"}]} #include<arduinojson.h> #define STATUS "status" #define LIVES "lives" #define TEMP "temperature" static void parse_http_data(const char *http_data) { DynamicJsonDocument doc(512); // Adjust size according to the size of JSON dataDeserializationError error = deserializeJson(doc, http_data); if (!error) { Serial.println("JSON_data:"); serializeJsonPretty(doc, Serial); const char* status = doc[STATUS]; if (status) { Serial.printf("status: %d , %s\r\n", atoi(status), status); JsonArray lives = doc[LIVES]; if (lives) { Serial.printf("!!size: %d\r\n", lives.size ()); for (JsonObject live_obj : lives) { const char* temp = live_obj[TEMP]; sprintf(app_weather_data.temperature, "%s", temp); Serial.println(app_weather_data.temperature); } } } } else { Serial.println("deserializeJson() failed with code "); Serial.println(error.c_str ()); } } ``` 3. Button control```c // // Created by Administrator on 2023-10-05. // #include<arduino.h> #include "OneButton.h" #include "esp32s3_button.h" OneButton button(BUTTON, true); bool esp32s3ButtonClick = false; bool esp32s3ButtonDoubleClick = false; bool esp32s3ButtonLongPress = false; static void doubleclick() { esp32s3ButtonDoubleClick = true; esp32s3ButtonClick = false ; esp32s3ButtonLongPress = false; Serial.println("doubleclick"); } static void click() { esp32s3ButtonClick = true; esp32s3ButtonDoubleClick = false; esp32s3ButtonLongPress = false; Serial.println("click"); } static void longPressStart() { Serial .println("longPressStart"); } static void duringLongPress() { if (button.isLongPressed()) { esp32s3ButtonLongPress = true; esp32s3ButtonDoubleClick = false; esp32s3ButtonClick = false; Serial.print("duringLongPress:"); Serial.println(button.getNumberClicks()); delay(50) ; } } static void longPressStop() { Serial.println("longPressStop"); } static void esp32s3_button_init() { button.reset();//Clear the status of the button state machine button.attachClick(click); button.attachDoubleClick (doubleclick); button.attachLongPressStart(longPressStart); button.attachDuringLongPress(duringLongPress); button.attachLongPressStop(longPressStop); } [[noreturn]] void esp32s3_button_task( void * parameter ) { Serial.println("Enter esp32s3_button_task!"); esp32s3_button_init(); while(true){ button.tick(); delay(10); } Serial.println("Ending esp32s3_button_task!"); vTaskDelete( nullptr ); } ``` 4. Product display (be sure to watch the video, the function introduction here is relatively simple, the video is more detailed) Main functions: - LED light: WiFi is not connected to the network or disconnected: the LED light flashes slowly , 500ms interval; WiFi connected, LED light on for 3s and off for 1s - Screen display: WiFi not connected or disconnected: The screen displays "There is a cat" logo and text "loading...", the network is successful, the current weather is not obtained, only the logo and location are displayed and the current time (which changes every second) - Button: Single-click the Boot0 button, the WS2812 lamp turns blue; double-click the Boot0 button to get the time, and the screen displays the current temperature Picture: <ignore_js_op> <img style="cursor:pointer;" id="aimg_738390" aid="738390" src="static/image/common/none.gif" onclick="zoom(this, this.getAttribute('zoomfile'), 0, 0, '0')" zoomfile="data/attachment/forum/202310/09/133516b8ln44wzk06n0li4.png" file="data/attachment/forum/202310/09/133516b8ln44wzk06n0li4.png" inpost="1" onmouseover="showMenu({'ctrlid':this.id,'pos':'12'})" /> <div class="tip tip_4 aimg_tip" id="aimg_738390_menu" style="position: absolute; display: none" disautofocus="true"> <div class="xs0"> <p><strong>Untitled.png</strong> <em class="xg1">(363.63 KB, downloads: 0)</em></p> <p> <a href="javascript:;" class="loginf" >download attach</a> <a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_738390" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=738390&handlekey=savephoto_738390">save to album</a> </p> <p class="xg1 y">2023-10-9 13:35 上传</p> </div> <div class="tip_horn"></div> </div> </ignore_js_op> <ignore_js_op> <img style="cursor:pointer;" id="aimg_738389" aid="738389" src="static/image/common/none.gif" onclick="zoom(this, this.getAttribute('zoomfile'), 0, 0, '0')" zoomfile="data/attachment/forum/202310/09/133516xdgsddx3dldyksxw.png" file="data/attachment/forum/202310/09/133516xdgsddx3dldyksxw.png" inpost="1" onmouseover="showMenu({'ctrlid':this.id,'pos':'12'})" /> <div class="tip tip_4 aimg_tip" id="aimg_738389_menu" style="position: absolute; display: none" disautofocus="true"> <div class="xs0"> <p><strong>Untitled 1.png</strong> <em class="xg1">(510.19 KB, downloads: 0)</em></p> <p> <a href="javascript:;" class="loginf" >download attach</a> <a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_738389" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=738389&handlekey=savephoto_738389">save to album</a> </p> <p class="xg1 y">2023-10-9 13:35 上传</p> </div> <div class="tip_horn"></div> </div> </ignore_js_op> ## VII. Summary I'm sure many people I'm curious, why do I need this combination? Of course, it's because I haven't been able to successfully burn IDF in Linux. I've been troubleshooting for a long time and I think it may be caused by the partition not being done properly. It can only be burned in Windows. I chose serial port burning in the recording software, but the USB mode didn't work. I don't know if I did something wrong, but it didn't work. Finally, I had no choice but to choose the current development environment and method. **This took me 3 days** When I copied files on my computer, Windows Explorer would freeze. After trying n ways, I had to reinstall the system. This took me a whole day (including the night) and I also encountered Be careful not to accidentally delete the code disk (I personally prefer to build git and push after writing the first version of the code), which may cause the code to be rewritten (95% of the work has been completed at that time) Then, because I was not familiar with PlatformIO, there was a problem in the code. After burning, it kept entering DFU mode after restarting, and I couldn't see the module log and couldn't find the reason. ** This took me 1 afternoon and 1 At night, I finally saw others submitting their homework happily during the holiday, while I was still checking whether my environment loading was OK. Hey, I want to use IDF programming. Do you know that FreeRTOS does not seem to support vTaskList on Arduino? )???????????? **I also struggled for 2 hours** I have always used idf before, and this is the first time I use this development method. I have been trying to figure it out... ## Notice: Because it took a lot of time to figure it out from scratch, I have to be busy with other things recently So the assignment is just a simple calendar clock, without any other functions. This is a small preview. There will be a complete small work in early December, and the code will be open source~ Code: [Click to download](https://download.eeworld .com.cn/detail/%E5%B0%8F%E9%BB%98%E5%8F%94%E5%8F%94/629600 "Click to download")</arduino.h></arduinojson.h></ws2812b,></fastled.h></arduino.h></arduinojson.h></httpclient.h></wifi.h></arduinojson.h></httpclient.h></wifi.h></tft_espi.h></lvgl.h></const></stdio.h></stdint.h></sdl2></stdlib.h></stdint.h>