esp32 idf 手册 pdf版

API Reference

 Wi-Fi

o Wi-Fi

o Smart Config

o ESPNOW

 Mesh

o ESP Mesh

 Bluetooth

o Bluetooth Controller && VHCI

o ADC

o DAC

o GPIO (including RTC low power I/O)

o I2C

o I2S

o LED Control

o MCPWM

o Pulse Counter

o Remote Control

o SDMMC Host

o Touch Sensor

o UART

 Protocols

o mDNS

o ESP-TLS

o HTTP Client

 Storage

o SPI Flash and Partition APIs

o SD/SDIO/MMC Driver

o Non-Volatile Storage

o FreeRTOS

o FreeRTOS Additions

o Heap Memory Allocation

o Heap Memory Debugging

o Interrupt Allocation

o Watchdogs

o Inter-Processor Call

o High Resolution Timer

o Logging

o Application Level Tracing

 Configuration Options

o Introduction

o Using sdkconfig.defaults

o Configuration Options Reference

o Customisations

 Error Codes Reference

Wi-Fi

 Station mode (aka STA mode or WiFi client mode). ESP32 connects to an access

point.

 AP mode (aka Soft-AP mode or Access Point mode). Stations connect to the

ESP32.

 Combined AP-STA mode (ESP32 is concurrently an access point and a station

connected to another access point).

 Various security modes for the above (WPA, WPA2, WEP, etc.)

 Scanning for access points (active & passive scanning).

 Promiscuous mode monitoring of IEEE802.11 WiFi packets.

Application Examples

Header File

 esp32/include/esp_wifi.h

Functions

esp_err_tesp_wifi_init(constwifi_init_config_t *config)

Init WiFi Alloc resource for WiFi driver, such as WiFi control structure,

RX/TX buffer, WiFi NVS structure etc, this WiFi also start WiFi task.

Attention

1. This API must be called before all other WiFi API can be called

Attention

2. Always use WIFI_INIT_CONFIG_DEFAULT macro to init the config to default

values, this can guarantee all the fields got correct value when more fields are

 ESP_ERR_NO_MEM: out of memory

 others: refer to error code esp_err.h

Parameters

 config : pointer to WiFi init configuration structure; can point to a temporary

variable.

esp_err_tesp_wifi_deinit(void)

Deinit WiFi Free all resource allocated in esp_wifi_init and stop WiFi

task.

Attention

1. This API should be called if you want to remove WiFi driver from the system

Return

 ESP_OK: succeed

 ESP_ERR_WIFI_NOT_INIT: WiFi is not initialized by esp_wifi_init

 ESP_ERR_INVALID_ARG: invalid argument

 others: refer to error code in esp_err.h

Parameters

 mode : WiFi operating mode

esp_err_tesp_wifi_get_mode(wifi_mode_t *mode)

Get current operating mode of WiFi.

Return

Start WiFi according to current configuration If mode is

WIFI_MODE_STA, it create station control block and start station If

mode is WIFI_MODE_AP, it create soft-AP control block and start

soft-AP If mode is WIFI_MODE_APSTA, it create soft-AP and station

control block and start soft-AP and station.

Return

 ESP_OK: succeed

 ESP_ERR_WIFI_NOT_INIT: WiFi is not initialized by esp_wifi_init

 ESP_ERR_INVALID_ARG: invalid argument

 ESP_ERR_NO_MEM: out of memory