ESP-IDF

esp-idf 是乐鑫官方的物联网开发框架，适用于 ESP32、ESP32-S 和 ESP32-C 系列 SoC。它基于 C/C++ 语言提供了一个自给自足的 SDK，方便用户在这些平台上开发通用应用程序。

相较于传统MCU厂商提供的SDK组件，IDF更接近开源模板，集成丰富的使用案例资源，尤其是广泛吸纳开源资源，是开发趋势的直观呈现，当然这一特性，对于最求底层稳定，上层差异化的应用开发者十分恼火。

FreeRTOS

1
2
3
4
5
6

cd $IDF_PATH
git apply $ADF_PATH/idf_patches/idf_v4.4_freertos.patch

cd $IDF_PATH
git am your_demo_path/idf_v4.4_patch/0001-add-freertos-xTaskCreateRestrictedPinnedToCore-api.patch
git am your_demo_path/idf_v4.4_patch/0001-add-ptread_creat_static-api.patch

System

timer

1
2

#include "esp_timer.h"
#include "esp_timer_impl.h"

调用接口:

• esp_timer_init(void)
• esp_timer_create(const esp_timer_create_args_t *create_args, esp_timer_handle_t *out_handle)
• esp_timer_start_once(esp_timer_handle_t timer, uint64_t timeout_us)
• esp_timer_start_periodic(esp_timer_handle_t timer, uint64_t period)
• esp_timer_stop(esp_timer_handle_t timer)
• esp_timer_delete(esp_timer_handle_t timer)

1
2
3
4
5
6
7

typedef struct {
    esp_timer_cb_t callback;        //!< Function to call when timer expires
    void* arg;                      //!< Argument to pass to the callback
    esp_timer_dispatch_t method;    //!< Call the callback from task or from ISR
    const char* name;               //!< Timer name, used in esp_timer_dump function
    bool skip_unhandled_events;     //!< Skip unhandled events for periodic timers
} esp_timer_create_args_t;

获取状态:

• esp_timer_dump(stdout);
• int64_t esp_timer_get_time(void);
• int64_t esp_timer_get_next_alarm(void);
• bool esp_timer_is_active(esp_timer_handle_t timer);

sleep

不同芯片的低功耗策略不同，针对ESP32-S3而言，可以通过不同唤醒源退出。

1

#include "esp_sleep.h"

唤醒源：

• Timer: esp_sleep_enable_timer_wakeup(uint64_t time_in_us)
• Touch : esp_sleep_enable_touchpad_wakeup()
• RTC GPIO : esp_sleep_enable_ext0_wakeup(gpio_num_tgpio_num, int level)
• RTC GPIO : esp_sleep_enable_ext1_wakeup(uint64_t mask, esp_sleep_ext1_wakeup_mode_t mode)
• ULP : esp_sleep_enable_gpio_wakeup(void)

Deep sleep

一般而言，追求低功耗会优先考虑极低的可能，对应在ESP芯片上就是Deep Sleep模式

Light sleep

由于芯片时钟域的不同，在极低功耗的Deep Sleep模式下，很多功能是无法使用的，所以可以退而求其次，采用light sleep模式

• UART : esp_sleep_enable_uart_wakeup(int uart_num)
• GPIO : esp_sleep_enable_uart_wakeup(int uart_num)

Wireless

Wi-Fi

Bluetooth

BLE

作为蓝牙物联网领域的主要应用模式，适用于 ESP32、ESP32-S3 和 ESP32-C 系列

Classic

CLASSIC BT 目前只有ESP32支持，主要应用于音频领域。

• SPP
• HFP
• A2DP

Protocols

MQTT

ESP-MQTT

HTTP

OpenSSL

Modbus

ESP-Modbus

Peripherals

ADC

1

#include "driver/adc.h"

PWM

1

#include "driver/mcpwm.h"

Touch

1

#include "driver/touch_pad.h"