Demo description

• The analog voltage connected through the GPIO is converted to digital by the ADC, and then the actual system voltage is calculated and printed to the terminal

Hardware connection

• Connect the board to the computer using a USB cable

Code analysis

• adc_bsp_init(void) : Initializes ADC1, including creating an ADC one-time trigger unit and configuring channel 3 for ADC1
• adc_get_value(float *value,int *data) : Reads the value of ADC1 channel 3 and calculates the corresponding voltage value based on the reference voltage and resolution, stores it at the position where the incoming pointer points to, and stores 0 if the read fails
• adc_example(void* parameter): Initialize ADC1 and then create an ADC task that reads the ADC value every 1 second and calculates the system's voltage based on the raw ADC value

Result demonstration

• The program compilation download is complete, and opening the serial port monitor will show the printed ADC values and voltage, as shown in the following figure:
  

• The ADC sampling value is about 1900, and the system voltage is about 4.9V. For a detailed analysis, you can refer to the schematic diagram

Demo description

• Through the I2C protocol, initialize the PCF85063 chip, set the time, and then periodically read the time and print it to the terminal

Hardware connection

• Connect the board to the computer using a USB cable

Code analysis

• void PCF85063_example(void* parameter) : Create an RTC task to implement RTC functionality, reading the clock from the RTC chip every 10 seconds and then outputting it to the terminal

Result demonstration

• Open the serial port monitoring, you can see the RTC time of the printout, as shown in the figure below:
  

• Data is output every 10 seconds. If you need to modify or refer to it, you can directly access the PCF85063 source file for operations.

Demo description

• Through I2C protocol, initialize the QMI8658 chip, then read and print the corresponding attitude information every 1 second to the terminal

Hardware connection

• Connect the board to the computer using a USB cable

Code analysis

• qmi8658c_example(void* parameter): The function initializes the QMI8658 device, reading and printing accelerometer data, gyroscope data, and temperature data in an infinite loop, once every second. During the rotation of the board, the gyroscope data increases with greater rotation speed, and the accelerometer calculates the corresponding acceleration based on the current position.

Result demonstration

• Open the serial port monitoring, and you can see the original data output from the IMU (Euler angles need to be converted by yourself), as shown in the following figure:
  

• Data is output once every second. If you need to modify or refer to it, you can directly access the qmi source file for operations

Demo description

• Select SPI or SDMMC direction to drive the TF card through macro definition, and print the TF card information to the terminal after successfully mounting the TF card

Hardware connection

• Install a TF card on the board (you must insert a TF card with a capacity of less than 64G first), and use a USB cable to connect the board to the computer

Code analysis

• The communication protocol of the TF card can be implemented according to the user's choice, find the macro definition SD_Read_Mode under the source file sd_card_bsp.cpp, the macro definition uses the SDMMC communication protocol by default, which can be modified to SDSPI

#define SD_Read_Mode USER_SPI

Result demonstration

• Click on the serial port monitoring device, you can see the information of the output TF card, practical_size is the actual capacity of the TF card, as shown in the figure below:
  

Demo description

• Use the development board as an AP waiting for STA terminal connection

Hardware connection

• Connect the board to the computer using a USB cable

Code analysis

• The code initializes serial communication on the ESP32 and then creates a WiFi access point named "bsp_esp_demo" with the password "waveshare", and no other continuous operations are performed in a loop while the program runs.

const char* ssid     = "bsp_esp_demo";
const char* password = "waveshare"; 

WiFi.softAP(ssid,password);

Result demonstration

• Use your mobile phone or other device to connect to WIFI, the WiFi name is "bsp_esp_demo", and the password is "waveshare"
  

Demo description

• The development board is used as a terminal role, which can connect to the AP available in the environment, and print the obtained IP information to the terminal after successful connection

Hardware connection

• Connect the board to the computer using a USB cable

Code modification

This project implements the chip connecting to WIFI and obtaining an IP address while in STA mode. Before compiling and downloading the firmware, some code needs to be modified to the name and password of the available WIFI router in the current environment 

Code analysis

• wifi_init(void): This function is used to initialize the Wi-Fi connection of the ESP32. It sets the ESP32 to Wi-Fi site mode and tries to connect to the specified Wi-Fi network (via the ssid and password). If the connection is successful, it prints the local IP address; if the connection fails within a certain period (20 * 500 milliseconds), it prints the connection failure message. At the same time, the function can also set the auto-connection and auto-reconnect functions

Result demonstration

• The chip is successfully connected to WIFI in STA mode, and you can see the obtained IP address by clicking on the serial port monitoring device
  

Demo description

• Implement some multifunctional GUI interfaces on the screen by porting LVGL

Hardware connection

• Connect the board to the computer using a USB cable

Code analysis

For LVGL, lvgl_conf.h is its configuration file. Below, some commonly used settings are explained, and some LVGL demos and file systems can also be configured in the conf file

/*Color depth: 1 (1 byte per pixel), 8 (RGB332), 16 (RGB565), 32 (ARGB8888)*/
#define LV_COLOR_DEPTH 16//Color depth, a macro definition that must be concerned with porting LVGL


#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. E.g. 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*/
//The above section is mainly for LVGL memory allocation, 
//which defaults to lv_mem_alloc() versus lv_mem_free().

Code modification

• The display chip itself does not support hardware rotation. If rotation is needed, it can be achieved through software. You can find the macro definition #define EXAMPLE_Rotate_90 in lcd_bsp.c file and uncomment this macro definition. Software rotation performance is not as good as hardware rotation

#define EXAMPLE_Rotate_90

Result demonstration

• The LVGL demo has high requirements for RAM and ROM, so it is necessary to configure the demo according to the requirements of environment setup, and after the program is flashed, the running effect of the device is as follows:

Demo description

• The analog voltage connected through the GPIO is converted to digital by the ADC, and then the actual system voltage is calculated and printed to the terminal

Hardware connection

• Connect the board to the computer using a USB cable

Code analysis

• adc_bsp_init(void) : Initializes ADC1, including creating an ADC one-time trigger unit and configuring channel 3 for ADC1
• adc_get_value(float *value,int *data) : Reads the value of ADC1 channel 3 and calculates the corresponding voltage value based on the reference voltage and resolution, stores it at the position where the incoming pointer points to, and stores 0 if the read fails
• adc_example(void* parameter): Initialize ADC1 and then create an ADC task that reads the ADC value every 1 second and calculates the system's voltage based on the raw ADC value

Result demonstration

• After the program is flashed, open the monitoring device and you can see the output ADC values and voltage, as shown in the figure below:
  

• The ADC sampling value is about 1960, and the system voltage is about 4.92V. For a detailed analysis, you can refer to the schematic diagram

Demo description

• Through the I2C protocol, initialize the PCF85063 chip, set the time, and then periodically read the time and print it to the terminal

Hardware connection

• Connect the board to the computer using a USB cable

Code analysis

• void PCF85063_example(void* parameter) : Create an RTC task to implement RTC functionality, read the clock from the RTC chip every 10 seconds and then output it to the terminal

Result demonstration

• After burning is completed, open the monitoring device to see the printed RTC time, as shown in the following figure:
  

• Data is output every 10 seconds. If you need to modify or refer to it, you can directly access the PCF85063 source file for operations.

Demo description

• Through I2C protocol, initialize the QMI8658 chip, then read and print the corresponding attitude information every 1 second to the terminal

Hardware connection

• Connect the board to the computer using a USB cable

Code analysis

• qmi8658c_example(void* parameter): The function initializes the QMI8658 device, reading and printing accelerometer data, gyroscope data, and temperature data in an infinite loop, once every second. During the rotation of the board, the gyroscope data increases with greater rotation speed, and the accelerometer calculates the corresponding acceleration based on the current position.

Result demonstration

After the demo is flashed, the running result of the device is as follows:

• Open the serial port monitoring, and you can see the original data output from the IMU (Euler angles need to be converted by yourself), as shown in the following figure:
  

• You can see that it is output every 1 second. If you need to modify or refer to it, you can directly go to the qmi source file to modify it

Hardware connection

• Install a TF card on the board (you must insert a TF card with a capacity of less than 64G first), and use a USB cable to connect the board to the computer

Demo description

• Select SPI or SDMMC direction to drive the TF card through macro definition, and print the TF card information to the terminal after successfully mounting the TF card

Code analysis

• The communication protocol of the TF card can be implemented according to the user's choice, find the macro definition SD_Read_Mode under the source file sd_card_bsp.cpp, the macro definition uses the SDMMC communication protocol by default, which can be modified to SDSPI

#define SD_Read_Mode USER_SPI

Result demonstration

• Click on the serial port monitoring device, you can see the information of the output TF card, practical_size is the actual capacity of the TF card, as shown in the figure below:
  

Demo description

• Use the development board as an AP waiting for STA terminal connection

Hardware connection

• Connect the board to the computer using a USB cable

Code analysis

• wifi_init_softap(void): This function is used to initialize the ESP32's Wi-Fi soft access point, including setting up the network interface, registering event handling functions, configuring soft AP parameters, and starting the soft AP

Result demonstration

• When the chip is in AP mode, use the mobile phone to successfully connect to WIFI and the serial port will print the MACA address of the connected device and the IP address assigned to the device
  

Demo description

• The development board is used as a terminal role, which can connect to the AP available in the environment, and print the obtained IP information to the terminal after successful connection

Hardware connection

• Connect the board to the computer using a USB cable

Code analysis

• espwifi_Init(void): This function is used for WiFi initialization on ESP32. It sequentially initializes non-volatile storage, the TCP/IP stack, creates a default event loop and a default WiFi site network interface, initializes WiFi with the default configuration, registers event handlers to handle WiFi and IP-related events, sets WiFi connection parameters, and starts WiFi.

Code modification

This project implements the chip connecting to WIFI and obtaining an IP address while in STA mode. Before compiling and downloading the firmware, some code needs to be modified to the name and password of the available WIFI router in the current environment 

Result demonstration

After the demo is flashed, the running result of the device is as follows:

• The chip successfully connects to WIFI and obtains an IP address while in STA mode
  

Demo description

• Implement some multifunctional GUI interfaces on the screen by porting LVGL

Hardware connection

• Connect the board to the computer using a USB cable

Code analysis

• The display chip itself does not support hardware rotation. If rotation is needed, it can be achieved through software. You can find the macro definition #define EXAMPLE_Rotate_90 in main file and uncomment this macro definition. Software rotation performance is not as good as hardware rotation

#define EXAMPLE_Rotate_90

Result demonstration

• The LVGL demo has high requirements for RAM and ROM, so it is necessary to configure the demo according to the requirements of environment setup, and after the program is flashed, the running effect of the device is as follows:

Demo description

• Store the images in png, jpg, and bmp formats on the TF card, then read the images from the TF card and display them on the LVGL interface
• Note :
  • The images need to have a unified resolution of 320 x 240
  • BMP images must be converted to RGB565 format

Hardware connection

• Connect the board to the computer using a USB cable

Code analysis

• The display chip itself does not support hardware rotation. If rotation is needed, it can be achieved through software. You can find the macro definition #define EXAMPLE_Rotate_90 in main file and uncomment this macro definition. Software rotation performance is not as good as hardware rotation

#define EXAMPLE_Rotate_90

Result demonstration

• Create a new directory Test under the TF card, put the required pictures into the directory, then insert the TF card into the board, power on normally, and the operation effect of the device is as follows:

• Clicking Scan IMG will scan the image files in the Test directory. The scan results are shown in the figure:

• Click on the corresponding image file name to jump to the corresponding image, as shown in the figure:

Demo description

• Comprehensive project, test the onboard function, this demo needs to pay attention to the version of IDF, V5.2.0 or above may not be able to scan the surrounding wifi. If you need to test, you can use the lower version of the compilation or use the BIN firmware we provide

Hardware connection

• Use a USB cable to connect the board to the computer (the display effect is default to software rotation by 90 degrees. If you don't need it, you can find the #define EXAMPLE_Rotate_90 macro definition in the main file and comment it out)

Result demonstration

• Swipe left or right to switch pages, first display RGB colors every 1.5 seconds, which can be used to observe if there are any issues with the screen
  

• After the RGB is displayed, it will automatically jump to the clock interface
  

• Swipe left on the interface, you can see that this page contains some built-in hardware information
  

• Swipe left again, you can see that the interface is a functional interface
  

• You can click on the WIFI icon to enter the WIFI test interface, then click the Scan button to scan the surrounding WIFI
• Click Exit to return to the previous interface, then click the BLE flag to enter the BLE test interface, and then click the Scan button to scan the surrounding BLE

• The final interface is for backlight adjustment, where you can slide the slider to adjust the backlight brightness