资料收集：ESP32-C3-WS2812(IDF+VScode).rar

# 前言 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ESP32-C3模组是4月初发布上线的一款双模(==2.4GWiFi+BLE5.0==)的通信模块，博主手上的是一款外置2M Flash的型号ESP32-C3F：  **本文是在Linux 开发环境用的是乐鑫的ESP-IDF的<font color=#1e15d9>master<font color=#4D4D4D>分 支的SDK基础上做的二次开发。** 所以需要准备的软件： &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; Linux 开发环境(当然Windos也是可以的，请参考： [ESP-IDF编程指南](https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32/get-started/index.html#get-started-get-prerequisites).) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ESP-IDF: [master](https://github.com/espressif/esp-idf).(ESP-IDF的使用请参考 [ESP-IDF编程指南](https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32/get-started/index.html#linux-macos).) **注意：** 在进行配置<font color=#e90827>menuconifg<font color=#> 的时候需要把 **Revision** 设置为<font color=#e90827>Rev2<font color=#> **硬件准备：** &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;1、ESP32-C3F小开发板 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;2、VB01离线语音模块 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;3、WS2812 RGB灯条 # 一、<font color=#19b2f2>新建工程文件 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 把ESP-IDF中的一个空例程复制到自己工程目录中，空例程在ESP-IDF中的路径如下： ```c .../esp=idf/examples/get-started/sample_project ``` 主函数文件就在该目录下的：<font color=#e90827>main<font color=#>文件夹中的main.c  # 二、<font color=#1da306>WS2812<font color=#f91454>R<font color=#14f93f>G<font color=#0d2efa>B<font color=#>驱动 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; WS2812的驱动其实乐鑫的ESP-IDF中就做有相关的例程：<font color=#e90827>.../examples/peripherals/rmt/led_strip<font color=#>，这个例程使用了RMT红外驱动，还连接了les_strip 驱动库（库路径：..../examples/common_components/led_strip）。但是那个例程无法驱动WS2812灯条，但是它的库却可以使用，所以要移植一下这个库。 ## 1.led_strip 驱动库移植 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;在main文件夹的同级目录下创建一个名为<font color=#e90827>**compornents**<font color=#>的文件夹： ```c mkidr compornents ```  然后把<font color=#e90827>**/examples/common_components/** <font color=#>下的 **led_strip** 文件夹全部复制到==刚刚创建的compornents文件夹中== 。并且在main.c中引用以下头文件： ```c #include "driver/rmt.h" #include "led_strip.h" #include "esp_system.h" #include "esp_log.h" ``` ## 2.初始化WS2812 灯条 定义RMT发送管脚和频道及灯珠个数的宏 ``` #define RMT_TX_NUM 3 //发送口 #define RMT_TX_CHANNEL RMT_CHANNEL_0//发送频道 #define LED_STRIP_NUM 24//灯珠数量 ``` ```c void init_led() { rmt_config_t config = RMT_DEFAULT_CONFIG_TX(RMT_TX_NUM, RMT_TX_CHANNEL); // set counter clock to 40MHz config.clk_div = 2; ESP_ERROR_CHECK(rmt_config(&config)); ESP_ERROR_CHECK(rmt_driver_install(config.channel, 0, 0)); // install ws2812 driver led_strip_config_t strip_config = LED_STRIP_DEFAULT_CONFIG(24, (led_strip_dev_t)config.channel); strip = led_strip_new_rmt_ws2812(&strip_config); if (!strip) { ESP_LOGE(TAG, "install WS2812 driver failed"); } // Clear LED strip (turn off all LEDs) ESP_ERROR_CHECK(strip->clear(strip, 100)); } ``` ## 3.设置RGB颜色的函数 缓存颜色的结构体 ```json struct WS2812_COLOR{ uint32_t red; uint32_t green ; uint32_t blue; }; struct WS2812_COLOR WS2812_RGB; ``` ```c void set_rgb(uint16_t Red, uint16_t Green, uint16_t Blue) { for (int i = 0; i < LED_STRIP_NUM; i++) { strip->set_pixel(strip, i, Red, Green, Blue);//设置颜色 } WS2812_RGB.red = Red; WS2812_RGB.green = Green; WS2812_RGB.blue = Blue; strip->refresh(strip, 10); } ``` # 三、<font color=#1558ee>UART 串口驱动与VB01通信 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;UART通信同样也可以使用ESP-IDF的example，参考的例程在：**examples/peripherals/uart/uart_async_rxtxtasks** 目录之下。这个例程使用了**FreeRTOS**来管理UART的发送函数和接收函数，博主也照样使用了**freeRTOS** ，<font color=#999AAA >UART驱动这里只是使用了**FreeRTOS** 创建任务，并没有使用太多**FreeRTOS**的各种功能，所以对于不太熟悉**FreeRTOS** 的同学也不要怕。<font color=#> ## 1.串口初始化配置 同样的，先要引用一下相关头文件 ``` /*********RTOS Handle-file****************/ #include "freertos/FreeRTOS.h" #include "freertos/task.h" #include "freertos/event_groups.h" /*********UART Handle-file*****************/ #include "driver/gpio.h" #include "driver/uart.h" ``` 串口初始化配置函数： ```c void UART_Init(void){ const uart_config_t uart_config = { .baud_rate =38400, //波特率 .data_bits = UART_DATA_8_BITS,//数据位 .parity = UART_PARITY_DISABLE,//校验位 .stop_bits = UART_STOP_BITS_1,//停止位 .flow_ctrl = UART_HW_FLOWCTRL_DISABLE,//流控制 .source_clk = UART_SCLK_APB,//时钟 }; // We won't use a buffer for sending data. uart_driver_install(UART_NUM_1, RX_BUF_SIZE * 2, 0, 0, NULL, 0); uart_param_config(UART_NUM_1, &uart_config); uart_set_pin(UART_NUM_1, TXD_PIN, RXD_PIN, UART_PIN_NO_CHANGE, UART_PIN_NO_CHANGE); } ``` ## 2.串口接收任务创建 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;在主函数中初始化UART之后，就创建串口的接收数据的任务，提高数据接收的速度： ```c //开启串口接收任务 xTaskCreate(uartRxTask, "uart_rx_task", 1024*3, NULL, 4, NULL); ``` **任务函数:** ```c static void uartRxTask(void *arg) { static const char *RX_TASK_TAG = "RX_TASK"; esp_log_level_set(RX_TASK_TAG, ESP_LOG_INFO); uint8_t *data=(uint8_t *)malloc(RX_BUF_SIZE+1); while (1) { const int rxBytes = uart_read_bytes(UART_NUM_1, data, RX_BUF_SIZE, 1000 / portTICK_RATE_MS); if (rxBytes > 0) { data[rxBytes] = 0; ESP_LOGI(RX_TASK_TAG, "Read %d bytes: '%s'", rxBytes, data); memset(cJson_data, 0, sizeof(cJson_data)); uartControlLedStrip(uartDataHandle(data)); //设置灯条颜色 ESP_LOG_BUFFER_HEXDUMP(RX_TASK_TAG, data, rxBytes, ESP_LOG_INFO); } } free(data); } ``` <font color=#10bcba>**说明**：<font color=#> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;uartControlLedStrip函数和uartDataHandle函数是博主自己写一个串口数据处理函数，目的是把串口接收的数据中提取控制RGB的指令或者数据，各位同学可通过自己的需求去写这样的函数，比如提取指令ID号，只是用一些字符串操作的函数就可以了。 # 四、<font color=#d1260a>WiFi 配置连接 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;WiFi的配置连接极为简单，不需要些配置函数，也不需要写初始化函数，需要连接的WiFi名称和密码都可以通过<font color=#d1260a>menuconfig<font color=#>来配置。因为ESP-IDF的例程中，已经写好了相关的配置文件，只需要简单的修改就可以配置连接WiFi�