】Used under ESP-IDF
The following development systems default to Windows. It is recommended to use the VSCode plug-in for development.
】Developed using VSCode plug-in
Install VSCode
Open the download page of the VSCode official website , select the corresponding system and system digits to download.
After running the installation package, the rest can be installed by default. However, for the sake of subsequent experience, it is recommended to check items 1, 2, and 3 in the box here.
After the first and second items are turned on, VSCode can be opened directly by right-clicking the file or directory, which can improve the subsequent use experience.
After the third item is turned on, when selecting the opening method, you can directly select VSCode
Install Espressif IDF plugin
Note: The latest version of the current plug-in is V1.6.4. For consistent experience, users can choose the same version as us.
Open VSCode, use the shortcut key Shift+Ctrl+X to enter the plug-in manager
In the search bar, enter Espressif IDF, select the corresponding plug-in and click install.
Use the shortcut key F1 and enter
esp-idf: configure esp-idf extension
Select express (this tutorial is for first-time installation users, so it only describes the first general installation tutorial)
Select the download server. We recommend that domestic users use Espressif as your download server.
Select the current ESP-IDF version you want, we choose the latest V5.1.1
The following two are respectively the ESP-IDF container installation address and the tool installation address required for ESP-IDF.
Note: If ESP-IDF has been installed before or failed, please be sure to completely delete the file or create a new non-Chinese path.
After the configuration is complete, click install to download
Enter the download page, which will automatically install the corresponding tools and environment, just wait a moment.
After the installation is completed, you will enter the following interface, indicating that the installation is complete.
Official routine usage tutorial
Create a routine
Use the shortcut key F1 and enter
esp-idf:show examples projects
Select your current IDF version
Take the Hello world routine as an example
①Select the corresponding routine
②The readme will explain what chip the routine is suitable for (how to use the routine and the file structure are introduced below, which is omitted here)
③Click to create a routine
Select the path to place the routine. It is required that there is no folder with the same name as the routine.
Modify COM port
The corresponding COM port is displayed here. Click to modify the corresponding COM port.
Please select according to the COM port corresponding to the device (can be viewed through the device manager)
If the download fails, please click the reset button for more than 1 second or enter the download mode and wait for the PC to re-recognize the device before downloading again.
Select the project or routine to use
Then our COM port will be modified.
Modify driver object
Shown here is the driver object used. Click to modify the corresponding driver object.
Select the project or routine to use
Please wait for a while after clicking
Select the object we need to drive, that is, our main chip is ESP32S3
Select the path of openocd. It has no effect on us here, so we can choose any one.
Introduction to other status bars
①SDK configuration editor, many functions and configurations of ESP-IDF can be modified in it
② Clean all, clear all compiled files,
③Compile
④Current download method, default is UART
⑤ Burn the current firmware, please do it after compilation
⑥Open the serial port monitor to view serial port information
⑦ Compile, burn, and open the serial monitor integrated button (most commonly used during debugging)
Compilation, burning, serial port monitoring
Click the compile, burn, and open serial monitor buttons we introduced earlier
Compilation may take a long time to complete, especially the first time.
During this process, ESP-IDF may occupy a large amount of CPU resources and therefore may cause system lags.
If it is the first time to burn a program for a new project, you will need to choose the download method and select UART.
You can also modify the download method later (click to pop up options)
Because of the onboard automatic download circuit, automatic downloading is possible without manual operation.
After the download is successful, it automatically enters the serial port monitor. You can see the corresponding information output by the chip and prompts to restart after 10 seconds.
Wipe device Flash
Open the flash_download_tool_3.9.5.exe software and select ESP32-S3 and USB
Select the UART port number and click START (do not select any bin file)
Wait for burning to complete, click Erase
Wait for erasure to complete
】Use under Arduino
】Build environment
After the installation is complete, open the Arduino IDE
Enter the development board manager, search for esp32, select the latest version in esp32 by Espressif Systems below and click to install (if it cannot be installed normally, you can try using a mobile phone hotspot)
After the installation is complete, restart the Arduino IDE and it will be ready to use.
If the installation fails then
Installation of version 2.0.11 failed
Extraction code: 0755
From the resource manager, press the path "c:\Users\Waveshare\AppData\Local\Arduino15\packages" to enter (where Waveshare is the computer username, you need to turn on the display of hidden files)
Unzip the file downloaded above into the packages folder
Re-execute the installation operation
After the installation is complete, restart the Arduino IDE and it will be ready to use.
】Run the example
Create an example
Change the project folder above to c:\Users\Waveshare\AppData\Local\Arduino15\packages (where Waveshare is the computer user name)
Restart Arduino IDE
Routine creation is available from the examples in the project folder under Files
The following demo creates an example of RGB blinking (BlinkRGB under File -> Sketchbook -> esp32 -> hardware -> esp32 -> 2.0.11 -> libraries -> ESP32 -> examples -> GPIO )
Program burning
Select development board and port
Search esp32c6, select ESP32C6 Dev Module and download port
Select Finish, click Upload, Arduino IDE will compile and burn the program
After the upload is completed, you can see the phenomenon on the development board