New Project

• Run the Arduino IDE and select File -> New Sketch
  
  
• Enter the code:

void setup() {
  // put your setup code here, to run once:
  Serial.begin(115200);
}

void loop() {
  // put your main code here, to run repeatedly:
  Serial.println("Hello, World!");
  delay(2000);
}

• Save the project and select File -> Save As.... In the pop-up menu, select the path to save the project, and enter a project name, such as Hello_World, click Save

Compile and Flash Demos

• Select the corresponding development board, take the ESP32S3 motherboard as an example:
  

①. Click to select the dropdown menu option Select Other Board and Port;
②. Search for the required development board model esp32s3 dev module and select;
③. Select COM Port;
④. Save the selection.

• Some development boards with specified version numbers support direct model selection, for example, "Waveshare ESP32-S3-LCD-1.69":
  

• If the ESP32S3 mainboard only has a USB port, you need to enable USB CDC, as shown in the following diagram:
  

• Compile and upload the program:
  

①. Compile the program; ②. Compile and download the program; ③. Download successful.

• Open the Serial Monitor window, and the demo will print "Hello World!" every 2 seconds, and the operation is as follows:
  

This demo demonstrates that ESP32-C6-Touch-LCD-1.47 uses the GFX_Library_for_Arduino library to drive the screen and display HelloWorld on the screen

【Hardware connection】

• Connect the board to the computer

【Code analysis】

• Create an object bus of the Arduino_ESP32SPI class to configure the SPI bus GPIO, and create an object gfx of the Arduino_ST7789 class to drive the ST7789 display

Arduino_DataBus *bus = new Arduino_ESP32SPI(45 /* DC */, 21 /* CS */, 38 /* SCK */, 39 /* MOSI */);

Arduino_GFX *gfx = new Arduino_ST7789(
  bus, 47 /* RST */, 0 /* rotation */, false /* IPS */,
  172 /* width */, 320 /* height */,
  34 /*col_offset1*/, 0 /*uint8_t row_offset1*/,
  34 /*col_offset2*/, 0 /*row_offset2*/);

【Result demonstration】

• HelloWorld is displayed on the screen.

This demo demonstrates that ESP32-C6-Touch-LCD-1.47 acquires QMI8658 data and prints it using serial port

【Hardware connection】

• Connect the board to the computer

【Code analysis】

• Initialize QMI8658

int err = IMU.init(calib, IMU_ADDRESS);
if (err != 0) {
  Serial.print("Error initializing IMU: ");
  Serial.println(err);
  while (true) {
    ;
  }
}

【Result demonstration】

• Open the serial port monitor to see the accel and gyro data of the X, Y, and Z axes printed

This demo demonstrates that ESP32-C6-Touch-LCD-1.47 tests the read and write functions of the TF card

【Hardware connection】

• Connect the board to the computer
• Insert the TF card into the card slot (TF card needs to be formatted as FAT32)

【Code analysis】

• SPI interface initialization and TF card initialization

#ifdef REASSIGN_PINS
  SPI.begin(sck, miso, mosi, cs);
  if (!SD.begin(cs)) {
#else
  if (!SD.begin()) {
#endif
    Serial.println("Card Mount Failed");
    return;
  }

【Result demonstration】

• Insert the TF card into the computer, and you can find two more files: test.txt and foo.test. The content of the foo.txt is Hello World!, and the content of the test.txt is empty

This demo demonstrates that ESP32-C6-Touch-LCD-1.47 runs the lvgl demos

【Hardware connection】

• Connect the board to the computer

• If the lvgl library is installed online, you need to copy the demos folder to src

【Code analysis】

• Select the lvgl demos to run

lv_demo_widgets();
// lv_demo_benchmark();
// lv_demo_keypad_encoder();
// lv_demo_music();
// lv_demo_stress();

【Result demonstration】

• It can be operated by touch

This demo demonstrates that ESP32-C6-Touch-LCD-1.47 displays battery voltage and ADC values on the screen using the lvgl library

【Hardware connection】

• Connect the board to the computer

【Code analysis】

• Initialize the UI and create a 1000ms timer to obtain the data of the adc and convert the data into a voltage

lvgl_battery_ui_init(lv_scr_act());

【Result demonstration】

This demo demonstrates that ESP32-C6-Touch-LCD-1.47 displays the screen brightness on the screen using the lvgl library, and controls the screen brightness through the slider

【Hardware connection】

• Connect the board to the computer

【Code analysis】

• Initialize the UI, and create a slider value change callback, when the value of the slider changes, modify the screen brightness

lvgl_brightness_ui_init(lv_scr_act());

【Result demonstration】

This demo demonstrates that ESP32-C6-Touch-LCD-1.47 acquires QMI8658 data and displays it using the lvgl library

【Hardware connection】

• Connect the board to the computer

【Code analysis】

• Initialize the UI and create a 100ms timer to obtain data from QMI8658

lvgl_qmi8658_ui_init(lv_scr_act());

【Result demonstration】

This demo demonstrates that ESP32-C6-Touch-LCD-1.47 runs the lvgl to display images.

【Hardware connection】

• Connect the board to the computer

【Preparation】

• Open lvgl Image Converter website
• Import the image images/image_1.jpg and convert it, the image_1.c file will be generated

• Copy image_1.c to the project folder
• Add the following code to 06_lvgl_image.ino to declare the image

LV_IMG_DECLARE(image_1);

• Set the image to be displayed

lv_img_set_src(img, &image_1);

【Result demonstration】

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: