Hardware connection

• Connect the board to the computer using a USB cable

Code analysis

• setup():
  • Initialize the serial port and print the start information;
  • Create ESP_Panel object and initialize the panel;
  • Get pointers to the individual components of the panel (LCD, touch, backlight);
  • Based on the existence of the component, perform corresponding operations such as turning off and on the backlight, setting the LCD's refresh completion callback function, and conducting a color bar test.

• loop():
  • If a touch component exists, read the touch point information;
  • Based on the reading results, different treatments are performed. The touch point information is printed if it succeeds, and the error message is printed if it fails;
  • If touch interrupt is not enabled, delay for a period of time to avoid frequent reading;
  • If the touch component does not exist, delay 1000 milliseconds and print "IDLE loop".

Result demonstration

• After flashing the code, you can observe stripes of blue, green, and red on the screen (If there's no screen response after flashing the code, check whether the correct configurations are set in Arduino IDE -> Tools: Enable PSRAM (8MB OPI)

Hardware connection

• Connect the board to the computer using a USB cable

Code analysis

• setup():
  • Extender Initialization:
    • Create an extender object with specific parameters, initialize and attempt to start the extender. If initialization fails, try again with the alternate parameters. If successful, the success message is output through the serial port
  • Serial port and pin settings:
    • Set pin 16 as output and initialize it to low level, initialize the serial port and set the baud rate to 115200, print the title and "start" information
  • Panel device initialization:
    • Create ESP_Panel object and initialize the panel, start the panel device, if the anti-tearing function is enabled, set the RGB bus parameters according to the LVGL configuration
  • LVGL initialization and user interface creation:
    • Initialize LVGL, pass in the LCD and touch objects of the panel, print information, and lock the LVGL mutual exclusion lock (since the LVGL API is not thread-safe); create a simple label and set the text as the title, display it centered on the screen, call a function to demonstrate LVGL widget examples, and unlock the mutual exclusion lock

Hardware connection

• Connect the board to the computer using a USB cable
• Connect the development board to USB to RS485 converter, as shown in the figure

Code analysis

• setup():
  • Serial2.begin(115200, SERIAL_8N1, 43, 44);: Initialize UART2, set the baud rate to 115200, set the data format to 8-bit data, no parity bit, 1 stop bit, and specify GPIO43 (RXD) and GPIO44 (TXD) as the transmit and receive pins
• loop() :
  • Check if UART2 has data to read using Serial2.available(), read data using Serial2.read(), and when certain conditions are met, send the data from the buffer using Serial2.println(buffer) to realize the reception and transmission of UART2 data

Result demonstration

• Open the serial port debugging assistant to send a message to the ESP32-S3-Touch-LCD-4 device, and the device will return the received message to the serial port debugging assistant

Hardware connection

• Connect the board to the computer using a USB cable
• Connect the development board to USB-CAN-A, as shown in the figure

Code analysis

• Function overview:
  • Initialize serial communication to output information
  • Configure the GPIO pin as the output
  • Install and start the CAN (Controller Area Network) bus driver (TWAI), connect to the specified RX_PIN (0) and TX_PIN (6) pins, and set it to monitor mode
  • In the main loop, if a CAN driver is installed, check if there are any alarms triggered, handle various alarm conditions such as error passive state, bus errors, and full receive queues. If there is a data alert reception, process the received CAN messages
• Important interface and pin descriptions:
  • RX_PIN(0) and TX_PIN(6): Pins for connecting to a CAN bus transceiver
  • GPIO_OUTPUT_PIN_SEL (corresponding to GPIO15 and GPIO16): Used to configure specific GPIO pins as output mode

Result demonstration

• ESP32-S3-Touch-LCD-4 waits USB-CAN-A_TOOL to send a message. If the message is received successfully, it will be printed to the serial port.

Hardware connection

• Connect the board to the computer using a USB cable
• Connect the development board to USB-CAN-A, as shown in the figure

Code analysis

• Function overview:
  • Initialize serial communication to output information
  • Configure specific GPIO pins (RX_PIN and TX_PIN) as output mode
  • Install and start the CAN (Controller Area Network) bus driver (TWAI), connect to the specified RX_PIN (0) and TX_PIN (6) pins, and set it to no-answer mode
  • Reconfigure CAN alarms to detect specific statuses, including sending related alerts and bus error alerts
  • In the main loop, if the CAN driver is installed, check if there are alarms triggered and handle various alarm situations, while sending CAN messages at regular intervals
• Important interface and pin descriptions:
  • RX_PIN(0) and TX_PIN(6): Pins for connecting to a CAN bus transceiver
  • GPIO_OUTPUT_PIN_SEL: Used to configure specific GPIO pins as output mode, here for RX_PIN and TX_PIN

Result demonstration

• Serial port print indicates successful CAN message transmission. After configuring USB-CAN-A_TOOL, you can observe the CAN messages sent by the ESP32-S3-Touch-LCD-4 upon startup.

• Observe USB-CAN-A_TOOL further, and you will see the CAN messages sent by ESP32-S3-Touch-LCD-4

Hardware connection

• Connect the development board to the computer using a USB cable
• Insert the TF card into the board

Code analysis

• TF card initialization and detection
  • Initialize the TF card
    • Initialize the TF card by setting specific pins (SDMMC_CLK, SDMMC_CMD, SDMMC_DATA). If initialization fails, the program will enter an infinite loop, ensuring that no further operations are executed without successfully mounting the TF card
  • Detect TF card type and size
    • Detect the type of TF card (such as MMC, SDSC, SDHC, etc.) and print information, allowing the user to understand the specific specifications of the connected TF card. At the same time, get the size of the TF card and print it in MB, making it easy for users to know the storage capacity
  • List the contents of the TF card directory
    • y calling the listDir function, list the files and directories under the root directory of the TF card, providing users with an intuitive understanding of the content stored on the TF card, making it convenient for subsequent file operations and management

Result demonstration

• The ESP32-S3-Touch-LCD-4 can identify the type and size of an TF card, and then perform file operations such as adding, deleting, modifying, and querying.

New Project

Create Demo

• Using the shortcut F1, enter esp-idf:show examples projects
  

• Select your current IDF version
  

• Take the Hello world demo as an example

①Select the corresponding demo
②Its readme will state what chip the demo applies to (how to use the demo and the file structure are described below, omitted here)

③Click to create the demo

• Select the path to save the demo, and require that the demos cannot use folders with the same name
  

Modify COM Port

• The corresponding COM ports are shown here, click to modify them
  
• Please select the COM ports according to your device (You can view it from the device manager)
  
• In case of a download failure, please press the Reset button for more than 1 second or enter download mode, and wait for the PC to recognize the device again before downloading once more
  

Modify Driver Object

• Select the object we need to drive, which is our main chip ESP32S3
  

• Choose the path to openocd, it doesn't affect us here, so let's just choose one
  

Other Status Bar Functions

①.ESP-IDF Development Environment Version Manager, when our project requires differentiation of development environment versions, it can be managed by installing different versions of ESP-IDF. When the project uses a specific version, it can be switched to by utilizing it
②.Device flashing COM port, select to flash the compiled program into the chip
③.Select set-target chip model, select the corresponding chip model, for example, ESP32-P4-NANO needs to choose esp32p4 as the target chip
④.menuconfig, click it to Modify sdkconfig configuration file Project configuration details
⑤.fullclean button, when the project compilation error or other operations pollute the compiled content, you can clean up all the compiled content by clicking it
⑥.Build project, when a project satisfies the build, click this button to compile
⑦.Current download mode, the default is UART
⑧.flash button, when a project build is completed, select the COM port of the corresponding development board, and click this button to flash the compiled firmware to the chip
⑨.monitor enable flashing port monitoring, when a project passes through Build --> Flash, click this button to view the log of output from flashing port and debugging port, so as to observe whether the application works normally
⑩.Debug
⑪.Build Flash Monitor one-click button, which is used to continuously execute Build --> Flash --> Monitor, often referred to as "little flame"

Compile, Flash and Serial Port Monitor

• Click on the all-in-one button we described before to compile, flash and open the serial port monitor
  

• It may take a long time to compile especially for the first time
  

• During this process, the ESP-IDF may take up a lot of CPU resources, so it may cause the system to lag
  
• If it is the first time to flash the program for a new project, you will need to select the download method, and select UART
  

• This can also be changed later in the Download methods section (click on it to pop up the options)
  

• As it comes with the onboard automatic download circuit, it can be downloaded automatically without manual operation
• After successful download, it will automatically enter the serial monitor, you can see the chip output the corresponding information and be prompted to restart after 10S
  

Use the IDF Demos

Open in the software

• Open VScode software and select the folder to open the demo
  

• Select the provided ESP-IDF example and click to select the file (located in the /Demo/ESP-IDF path under demo)
  

Open from Outside the Software

• Select the project directory correctly and open the project, otherwise it will affect the compilation and flashing of subsequent programs
  

• After connecting the device, select the COM port and model, click below to compile and flash to achieve program control
  

ESP-IDF Project Details

• Component: The components in ESP-IDF are the basic modules for building applications, each component is usually a relatively independent code base or library, which can implement specific functions or services, and can be reused by applications or other components, similar to the definition of libraries in Python development.
  • Component reference: The import of libraries in the Python development environment only requires to "import library name or path", while ESP-IDF is based on the C language, and the importing of libraries is configured and defined through CMakeLists.txt.
  • The purpose of CmakeLists.txt: When compiling ESP-IDF, the build tool CMake first reads the content of the top-level CMakeLists.txt in the project directory to read the build rules and identify the content to be compiled. When the required components and demos are imported into the CMakeLists.txt, the compilation tool CMake will import each content that needs to be compiled according to the index. The compilation process is as follows:

Hardware connection

• Connect the board to the computer using a USB cable
• Connect the development board to USB to RS485 converter, as shown in the figure

Code analysis

• echo_task():
  
  • Firstly, UART parameters were configured, including baud rate, data bits, parity bits, stop bits, and hardware flow control, etc.
  • Then install the UART driver, set the UART pins, and allocate a temporary buffer for receiving data.
  • In an infinite loop, data is read from the UART, the read data is written back to the UART, and log information is recorded when data is received.

Result demonstration

• Open the serial port debugging assistant to send a message to the ESP32-S3-Touch-LCD-4 device, and the device will return the received message to the serial port debugging assistant

Hardware connection

• Connect the board to the computer using a USB cable
• Insert the TF card into the board

Code analysis

• waveshare_sd_card_init():
  

This function is mainly used to initialize the TF card. First initialize I2C, pull down the CS pin of the TF card through I2C control chip. Next, configure the TF card mounting options, including whether to format when mounting fails, the maximum number of files, and the allocation unit size, etc. After that, initialize the SPI bus and mount the TF card file system using the configured SPI bus and mount options. If mounting is successful, return ESP_OK, indicating that the TF card initialization is complete.

• waveshare_sd_card_test():
  

This function is used to test the functionality of the TF card. First print the information of the initialized TF card. Then create a file, write data into it, rename the file, and read the content of the renamed file. Next, format the file system and check if the file has been deleted after formatting. Finally, create a new file and read its content, unmount the TF card and free up SPI bus resources when the test is complete.

Result demonstration

• After successful programming, the serial port will print information about the storage card, such as its name, type, capacity, and maximum supported frequency. Then, it will create a file, write to the file, rename the file, and read the renamed file:

• You can also directly use the serial monitor of ESP-IDF

Hardware connection

• Connect the board to the computer using a USB cable

Code analysis

• app_main():
  • First define the structure used to store the current time and some variables, including the alarm clock interrupt flag, etc.
  • Next, initialize the chip, set the initial time and alarm time, enable the alarm function, and initialize the interrupt input pin and interrupt handler. In an infinite loop, read the current time, convert it to a string, and print it. When a clock interrupt occurs, reset the interrupt flag and optionally re-enable the alarm. Also print a message indicating that the alarm has gone off. There is a 1-second delay within the loop.
  • In general, a simple alarm clock function is implemented, and the time reading and alarm response are realized through the operation and interrupt processing of the PCF85063A chip.

Result demonstration

• After the flashing is successful, the time will be set, the alarm will be started, and then the current time will be read and wait to enter the alarm clock
• The serial port terminal will print relevant information