ESP32 Dev Kitc Atina'e Komiti

Fa'amatalaga o oloa

Fa'amatalaga

Oloa: ESP32
Ta'iala mo Polokalama: ESP-IDF
Fa'asalalauga Fa'amatalaga: v5.0.9
Tufuga: Espressif Systems
Aso Fa'asalalau: Me 16, 2025

Fa'atonuga o le Fa'aaogaina o Mea

1. Amata

A'o le'i amataina le ESP32, faamasani oe i le
o lo'o mulimuli mai:

1.1 Folasaga

A'oa'o e uiga i galuega fa'avae ma agava'a o le
ESP32.

1.2 Mea e te Manaomia

Ia mautinoa o loʻo ia te oe meafaigaluega ma polokalama talafeagai:

Meafaigaluega: Siaki le lisi o meafaigaluega manaʻomia
vaega.
Polokalama: Fa'apipi'i le polokalame e mana'omia
vaega.

1.3 Fa'apipi'i

Mulimuli i laasaga nei e faʻapipiʻi ai le IDE ma faʻatutu le
siosiomaga:

IDE: Fa'apipi'i le IDE fautuaina mo
polokalame ole ESP32.
Fa'apipi'i tusilima: Seti ma le lima le
siosiomaga pe a manaomia.

1.4 Fausia Lau Poloketi Muamua

Fausia ma fausia lau uluai poloketi e faʻaaoga ai le ESP32.

1.5 Aveese le ESP-IDF

Afai e manaʻomia, aʻoaʻo pe faʻafefea ona aveese le ESP-IDF mai lau
faiga.

2. API Fa'asinomaga

Va'ai ile fa'amaumauga API mo fa'amatalaga auiliili ile
fa'asologa o talosaga, fa'afoega o mea sese, ma fa'atulagaina
fausaga.

Fesili e Fai soo (FAQ)

Q: E mafai faapefea ona ou foia faafitauli masani ile ESP32?

A: Va'ai i le vaega fo'i fa'afitauli i le ta'iala o polokalame
pe asiasi ile fale gaosi oloa webnofoaga mo punaoa lagolago.

Q: E mafai ona ou fa'aogaina le ESP-IDF ma isi microcontrollers?

A: ESP-IDF ua fuafuaina faapitoa mo ESP32, ae e mafai ona e mauaina
fetaui ma isi masini espressif microcontrollers.

View Fullscreen

ESP32
ESP-IDF Polokalama Taiala
Fa'asalalau v5.0.9 Espressif Systems Me 16, 2025

Lisi o anotusi

1 Amata

1.1 Folasaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.2 Mea e te Manaomia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.2.1 Meafaigaluega . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.2.2 Polokalama . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

1.3 Fa'apipi'i . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

1.3.1 IDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

1.3.2 Fa'apipi'i Tusitala . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

1.4 Fausia Lau Poloketi Muamua . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

1.5 Aveese le ESP-IDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

2 API Fa'asinomaga

2.1 Feagaiga API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

2.1.1 Tausiga sese . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

2.1.2 Fa'atonuga fa'atulagaina . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

2.1.3 API Tumaoti . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

2.1.4 Vaega i example galuega faatino . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

2.1.5 Maumau API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

2.2 Polokalama Talosaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

2.2.1 ASIO uafu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

2.2.2 ESP-Modbus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

2.2.3 ESP-MQTT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49

2.2.4 ESP-TLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

2.2.5 ESP HTTP Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

2.2.6 ESP Pulea Fa'alotoifale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

2.2.7 ESP Fa'asologa o Pologa So'oga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

2.2.8 ESP x509 Tusi Fa'amaonia Fusi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

2.2.9 HTTP Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

2.2.10 HTTPS Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

2.2.11 ICMP Echo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

2.2.12 mDNS Auaunaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

2.2.13 Mbed TLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

2.2.14 IP Network Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

2.3 Bluetooth API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

2.3.1 Bluetooth® masani . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

2.3.2 Bluetooth® Maualalo Malosiaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

2.3.3 Bluetooth® Classic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325

2.3.4 Pule & HCI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

2.3.5 ESP-BLE-MESH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485

2.3.6 API talimalo fa'avae NimBLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 767

2.4 Fa'ailoga Fa'ailoga Fa'asinomaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769

2.5 Networking APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776

2.5.1 Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776

2.5.2 Ethernet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 899

2.5.3 filo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 936

2.5.4 ESP-NETIF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 942 2.5.5 IP Network Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 974 2.5.6 Fa'aoga Fa'atonu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 976 2.6 Peripherals API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 977 2.6.1 Analog to Digital Converter (ADC) Oneshot Mode Avetaavale . . . . . . . . . . . . . . . . . 977 2.6.2 Analog to Digital Converter (ADC) Avetaavale Tulaga Fa'aauau . . . . . . . . . . . . . . . 986 2.6.3 Avetaavale Fa'ata'ita'i Fa'atusa i le Fa'afuainumera (ADC). . . . . . . . . . . . . . . . . . . 993 2.6.4 Laau Uati . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 997 2.6.5 Fa'aliliuga Fa'atekinolosi i le Analog (DAC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1004 2.6.6 GPIO & RTC GPIO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1008 2.6.7 Taimi Fa'amoemoe Lautele (GPTimer) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1027 2.6.8 Li'o Fa'atasi (I2C) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1039 2.6.9 Inter-IC Sound (I2S) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1056 2.6.10 LCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1090 2.6.11 Pulea LED (LEDC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1126 2.6.13 Pulse Counter (PCNT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1178 2.6.14 Feavea'i Pulea Mamao (RMT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1193 2.6.15 SD Manaoga Toso i luga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1220 2.6.16 SDMMC Host Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1223 2.6.17 SD SPI Host Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1229 2.6.18 SDIO Card Pologa Avetaavale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1234 2.6.19 Sigma-Delta Modulation (SDM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1244 2.6.20 SPI Master Avetaavale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1249 2.6.21 Avetaavale Pologa SPI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1274 2.6.22 ESP32-WROOM-32SE (Elemene Saogalemu) . . . . . . . . . . . . . . . . . . . . . . . . . 1281 2.6.23 Pa'i Sensori . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1282 2.6.24 Fa'afeso'ota'i Ta'avale Lua-Uaea (TWAI) . . . . . . . . . . . . . . . . . . . . . . . . . . 1299 2.6.25 Universal Asynchronous Receiver/Transmitter (UART) . . . . . . . . . . . . . . . . . . 1317 2.7 Fa'atulagaina o Poloketi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1342 2.7.1 Folasaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1342 2.7.2 Menu Fa'atulagaina o Poloketi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1342 2.7.3 Fa'aaogaina sdkconfig.defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1342 2.7.4 Tulafono Fa'atulagaina o Kconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1343 2.7.5 Fesootaiga i tua o Kconfig Options . . . . . . . . . . . . . . . . . . . . . . . . 1343 2.7.6 Fa'atonuga Filifiliga Fa'asinomaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1343 2.8 Tuuina atu API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1647 2.8.1 Fesootaiga Fesootaiga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1647 2.8.2 Tulaga Autasi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1665 2.8.3 Tulaga Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1669 2.9 Teuga API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FileSystem Lagolago . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1691 2.9.2 Gaosiga Fa'aoga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1699 2.9.3 Faletusi Teuina e le mafai ona fa'afefe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1703 2.9.4 NVS Vaevaega Fa'aaogāga Fa'aaogāga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1725 2.9.5 SD/SDIO/MMC Avetaavale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1730 2.9.6 SPI Flash API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1744 2.9.7 SPIFFS Filefaiga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1780 2.9.8 Vaitaimi filevaega faiga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1784 2.9.9 La'ei Fa'ata'atia API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1800 2.10 System API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1803 2.10.1 Fa'asologa o Ata Fa'aoga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1803 2.10.2 Su'ega Tulaga Fa'aaogā . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1808 2.10.3 Vala'au galuega ma fa'aputu i fafo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1813 2.10.4 Toe Iloiloga Chip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1815 2.10.5 Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1817 2.10.6 Pule eFuse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1826 2.10.7 Faailoga Faailoga ma Galuega Fesoasoani . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1846
ii

2.10.8 ESP HTTPS OTA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1849 2.10.9 Faletusi Loop Mea na tutupu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1856 2.10.10 FreeRTOS (Ovaview). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1869 2.10.11 FreeRTOS (ESP-IDF) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1871 2.10.12 FreeRTOS (Vaega Faaopoopo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1988 2.10.13 Fa'aputuga o Manatu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2008 2.10.14 Debugging Fa'aputugā Manatu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2021 2.10.15 Taimi Maualuga Maualuga (ESP Timer) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2032 2.10.16 API i totonu ma le le mautu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2040 2.10.18 Fa'alavelave vaevaega . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2045 2.10.19 Loka faletusi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2051 2.10.20 Faiga Eseese APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2058 2.10.21 I luga ole Ea Faafouga (OTA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2073 2.10.22 Mataituina o Galuega . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2084 2.10.23 Pulea Malosiaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2087 2.10.24 POSIX Threads Lagolago . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2093 2.10.25 Fausia Numera Faafuasei . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2097 2.10.26 Tulaga Moe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2099 2.10.27 SoC Avanoa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2111 2.10.28 Taimi System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2121 2.10.29 O le tufaina o himem API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2126 2.10.30 ULP Coprocessor polokalame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2129 2.10.31 Matamata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2161

3 Fa'amatalaga Meafaigaluega

2167

3.1 Fa'atusatusaga Fa'asologa o Chip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2167

3.1.1 Pepa Faatatau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2170

4 API Taiala

2171

4.1 Laasaga Talosaga Su'eina faletusi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2171

4.1.1 Ovaview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2171

4.1.2 Faiga Fa'atino . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2171

4.1.3 Filifiliga Fa'atulagaina ma Fa'alagolago . . . . . . . . . . . . . . . . . . . . . . . . . . 2172

4.1.4 Auala e Faaaoga ai Lenei Faletusi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2173

4.2 Talosaga Amata Fa'asolo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2181

4.2.1 Muamua stage fa'apipi'i . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2182

4.2.2 Lua stage fa'apipi'i . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2182

4.2.3 Talosaga amata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2183

4.3 Bluetooth® Classic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2184

4.3.1 Ovaview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2184

4.4 Bluetooth® Maualalo Malosiaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2186

4.4.1 Ovaview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2186

4.4.2 Amata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2191

4.4.3 Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2240

4.5 Bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2284

4.5.1 Fesoasoani Bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2285

4.5.2 Tulaga Fa'amau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2285

4.5.3 Toe setiina falegaosimea . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2286

4.5.4 Fa'aoso mai Su'ega Firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2286

4.5.5 Toe faafoi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287

4.5.6 Ta‘ifau Leoleo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287

4.5.7 Tele o le Bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287

4.5.8 Va'a vave mai le moe loloto. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287

4.5.9 Fa'atagata fa'ameamea . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287

4.6 Faiga Faiga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2288

4.6.1 Ovaview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2288

4.6.2 Fa'aaogaina o le Faiga Fausia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2289

iii

4.6.3 Esoample Poloketi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2291 4.6.4 Poloketi CMakeLists File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2291 4.6.5 Vaega CMakeLists Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2293 4.6.6 Fa'asologa o Vaega . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2295 4.6.8 Vaega Manaomia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2295 4.6.9 Vaega Sili o le Poloketi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2299 4.6.10 Fa'atonu-Na'o Vaega . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2300 4.6.11 Debugging CMake . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2300 4.6.12 Esoample Component CMakeLists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2301 4.6.13 Custom sdkconfig faaletonu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2305 4.6.14 Fa'aupuga Flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2305 4.6.15 Fausiaina o le Fa'asao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2306 4.6.16 Tusia Vaega mama CMake . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2306 4.6.17 Fa'aaogaina Poloketi CMake Vaega Tolu ma Vaega . . . . . . . . . . . . . . . . . . . 2306 4.6.18 Fa'aaogaina o Faletusi ua Fausia ma Vaega . . . . . . . . . . . . . . . . . . . . . . . . . 2307 4.6.19 Fa'aaogaina o le ESP-IDF i Poloketi CMake Fa'apitoa . . . . . . . . . . . . . . . . . . . . . . . . . 2307 4.6.20 ESP-IDF CMake Build System API . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2308 4.6.21 File Globbing & Fa'aopoopo Fausia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2312 4.6.22 Fausia Faiga Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2313 4.6.23 Fausia Faiga Totonu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2313 4.6.24 Siitia mai le ESP-IDF GNU Make System . . . . . . . . . . . . . . . . . . . . . . . 2315 4.7 Lafoa'i Autu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2316 4.7.1 Ovaview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2316 4.7.2 Fa'atonuga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2317 4.7.3 Faasaoina le otaota autu e moli . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2317 4.7.4 Lolomi le lapisi autu ile UART . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2318 4.7.5 Galuega ROM i Fa'asologa i tua . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2318 4.7.6 Lafoa'i o fesuiaiga pe a mana'omia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2318 4.7.7 Tamomoe escoredump.py . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2319 4.8 Moe Mue Fafagu Ala . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2322 4.8.1 Tulafono mo Fafago Fafagu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2322 4.8.2 Fa'atinoina o se Stub . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2322 4.8.3 Tu'uina o le Code i le RTC Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2322 4.8.4 Tu'uina o Fa'amatalaga i totonu o le RTC Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2323 4.8.6 Esoample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2323 4.9 Fa'afoeina o Measese . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2324 4.9.1 Ua umaview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2324 4.9.2 Fa'ailoga sese . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2324 4.9.3 Faaliliuina o fa'ailoga sese i fe'au sese . . . . . . . . . . . . . . . . . . . . . . . . . . 2324 4.9.4 ESP_ERROR_CHECK macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2325 4.9.5 ESP_ERROR_CHECK_WITHOUT_ABORT macro . . . . . . . . . . . . . . . . . . . . . 2325 4.9.6 ESP_RETURN_ON_ERROR macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2325 4.9.7 ESP_GOTO_ON_ERROR macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2325 4.9.8 ESP_RETURN_ON_FALSE macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2325 4.9.9 ESP_GOTO_ON_FALSE macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2325 4.9.10 SIAKI MACROS Eamples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2326 4.9.11 Fa'asologa o le taulimaina o mea sese . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2326 4.9.12 C++ Tuusaunoaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2327 4.10 ESP-WIFI-MESH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2327 4.10.1 Ovaview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2327 4.10.2 Folasaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2328 4.10.3 Manatu ESP-WIFI-MESH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2329 4.10.4 Fausiaina o se Fesootaiga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2334 4.10.5 Puleaina o se Fesootaiga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2339 4.10.6 Tuuina atu o Faamatalaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2342 4.10.7 Suiga Auala . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2344
iv

4.10.8 Faatinoga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2347 4.10.9 Isi Faamatalaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2348 4.11 Taulimaina o Mea e tutupu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2348 4.11.1 Wi-Fi, Ethernet, ma IP Mea na tutupu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2348 4.11.2 Mesh Mea na tutupu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2349 4.11.3 Bluetooth Mea na tutupu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2350 4.12 Sese Matautia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2350 4.12.1 Ovaview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2350 4.12.2 Taupulea Fa'afefe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2350 4.12.3 Resitala Lafoa'i ma Su'esu'e i tua . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2351 4.12.4 GDB Stub . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2353 4.12.5 RTC Watchdog Taimi Taimi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2354 4.12.6 Guru Mafaufauga Loloto Sese . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2354 4.12.7 Isi Mea Sese Matautia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2356 4.13 Flash Encryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2358 4.13.1 Folasaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2359 4.13.2 eFuses talafeagai . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2359 4.13.3 Fa'agasologa o le Fa'ailoga o le Flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2360 4.13.4 Fa'ailoga Fa'ailoga momi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2360 4.13.5 Fa'aletonu e ono tutupu mai . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2366 4.13.6 ESP32 Flash Encryption Tulaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2368 4.13.7 Faitau ma Tusitusi Fa'amatalaga i Fa'ailoga Fa'ailoga . . . . . . . . . . . . . . . . . . . . . . . 2368 4.13.8 Fa'afouina le Flash Fa'ailoga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2369 4.13.9 Fa'agata le Fa'ailoga Flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2369 4.13.10 Manatu Autu e Uiga i le Flash Encryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2370 4.13.11 Tapula'a o le Fa'ailoga Flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2370 4.13.12 Flash Encryption ma Secure Boot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2371 4.13.13 Avanoa Avanoa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2371 4.13.14 Fa'amatalaga Fa'apitoa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2373 4.14 Aveesega Meafaigaluega . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2373 4.14.1 Fausia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2374 4.14.2 LL (Tulaga Maulalo) Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2375 4.14.3 HAL (Vaega Fa'apipi'i Meafaigaluega) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2376 4.15 Faʻalavelave Tulaga Maualuga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2377 4.15.1 Tulaga Faalavelave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2377 4.15.2 Faamatalaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TAG Debugging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2378 4.16.1 Folasaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2378 4.16.2 E Faapefea Ona Gaioiina? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2379 4.16.3 Filifilia o JTAG fetuutuunai . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2380 4.16.4 Seti o OpenOCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2380 4.16.5 Fa'atulagaina o le ESP32 Sini . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2380 4.16.6 Tatala Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2386 4.16.7 Debugging Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2386 4.16.8 Fausia OpenOCD mai Punaoa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2386 4.16.9 Fautuaga ma Fa'amatalaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2391 4.16.10 Pepa Faatatau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2396 4.17 Fausia o Tusitusiga Feso'ota'i . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2421 4.17.1 Ua umaview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2421 4.17.2 Amata vave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2424 4.18 lwIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2430 4.18.1 API Lagolago . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2430 4.18.2 BSD Sockets API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2431 4.18.3 Netconn API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2435 4.18.4 lwIP FreeRTOS Galuega . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2435 4.18.5 IPv6 Lagolago . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2435 4.18.6 esp-lwip suiga masani . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2436
v

4.18.7 Fa'aleleia o Fa'atinoga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2438 4.19 Ituaiga Mafaufau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2439
4.19.1 DRAM (Data RAM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2439 4.19.2 IRAM (Faatonuga RAM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2440 4.19.3 IROM (code executed from flash) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.4 DROM (faʻamaumauga o loʻo teuina i le moli) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.5 RTC Lemu le manatua . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.6 RTC FAST manatua . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.7 DMA Manaoga Manaomia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.8 DMA Puipui i le faaputuga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2442 4.20 OpenThread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2442 4.20.1 Faiga o le faaputuga OpenThread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2443 4.20.2 Fa'afefea ona Tusia se Talosaga OpenThread . . . . . . . . . . . . . . . . . . . . . . . . . 2443 4.20.3 O le OpenThread Border Router . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2444 4.21 Laupapa Vaevaega . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2444 4.21.1 Ua umaview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2445 4.21.2 Laupapa Vaevaega Fausia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2445 4.21.3 Fausiaina o Laupapa Fa'apitoa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2445 4.21.4 Fausiaina Laulau Vaeluaga Binary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2448 4.21.5 Siaki le Tele o Vaevaega . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2448 4.21.6 Emo le laulau vaeluaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2449 4.21.7 Meafaigaluega Vaevaega (parttool.py) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2449 4.22 Faatinoga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2450 4.22.1 Fa'afefea ona Fa'asili le Fa'atinoga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2450 4.22.2 Taiala . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2451 4.23 RF fa'avasegaina . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2468 4.23.1 Fa'avasegaina vaega . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2468 4.23.2 Fa'avasega atoatoa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2469 4.23.3 Leai se fa'avasegaina . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2469 4.23.4 PHY fa'amatalaga amata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2469 4.23.5 API Fa'asinomaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2469 4.24 Fa'a Saogalemu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2472 4.24.1 Talaaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2472 4.24.2 Saogalemu Fa'agasologa Fa'aumaview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2473 4.24.3 Ki . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2473 4.24.4 Tele o le Fa'aa'e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2474 4.24.5 Faʻafefea ona Faʻaagaoioi le Secure Boot . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2475 4.24.7 Fausiaina o Ki Saini Fa'amau Saogalemu . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2475 4.24.8 Saini Mamao o Ata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2475 4.24.9 Saogalemu Fa'ata'ita'iga Sili . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2476 4.24.10 Fa'amatalaga Fa'apitoa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2476 4.24.11 Fa'ailoga Saogalemu & Fa'ailoga Uila . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2477 4.24.12 Fa'amaonia le Fa'ailoga Fa'ailoga e aunoa ma se fa'a malu puipuia o meafaigaluega . . . . . . . . . . . . . . . . . . 2478 4.24.13 Avanoa Avanoa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2478 4.25 Fa'a Saogalemu V2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2478 4.25.1 Talaaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2479 4.25.2 Advantages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2479 4.25.3 Saogalemu Boot V2 Fa'agasologa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2479 4.25.4 Fa'atulagaina Poloka Saini . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2480 4.25.5 Padding Saogalemu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2480 4.25.6 Faamaoniaina o se Poloka Saini . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2481 4.25.7 Faamaonia o se Ata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2481 4.25.9 fa'aoga eFuse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2481 4.25.10 Fa'afefea ona fa'aagaoioi le Secure Boot V2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2482 4.25.12 Fausiaina o le Ki Saini Fa'amau . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2482
vi

4.25.13 Saini Mamao o Ata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2483 4.25.14 Saogalemu Fa'ata'ita'iga Sili . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2484 4.25.15 Fa'amatalaga Fa'apitoa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2484 4.25.16 Fa'ailoga Saogalemu & Fa'ailoga Uila . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2484 4.25.17 Fa'amaonia le Fa'ailoga Fa'ailoga e aunoa ma se fa'a malu puipuia o meafaigaluega . . . . . . . . . . . . . . . . . . 2484 4.25.18 Avanoa Avanoa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2485 4.26 Lagolago mo RAM i fafo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2485 4.26.1 Folasaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2485 4.26.2 Meafaigaluega . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2485 4.26.3 Fa'atulagaina o le RAM i fafo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2486 4.26.4 Tapulaa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2487 4.26.5 Le taulau ona amatalia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2488 4.26.6 Toe Iloiloga Chip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2488 4.27 Fa'aigoa Fa'alotoifale Teuina . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2488 4.27.1 Ua umaview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2488 4.27.2 FreeRTOS Native API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.27.3 Pthread API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.27.4 C11 Tulaga masani . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.28 Meafaigaluega . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.28.1 IDF Frontend – idf.py . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.28.2 IDF Docker Ata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2493 4.28.3 IDF Windows Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2495 4.28.4 Pule o Vaega IDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2496 4.28.5 IDF Clang Tidy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2497 4.28.6 Meafaigaluega e mafai ona sii mai . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2498 4.29 Su'ega Iunite ile ESP32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2512 4.29.1 Su'ega masani . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2512 4.29.2 Tulaga Su'ega Tele-masini . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2513 4.29.3 Tele-stagu Tulaga Su'ega . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2514 4.29.4 Su'ega Mo Sini Eseese . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2514 4.29.5 Su'ega Su'ega Iunite Faufale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2515 4.29.6 Su'ega Su'ega a le Iunite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2515 4.29.7 Taimi Code ma Cache Taui Timer . . . . . . . . . . . . . . . . . . . . . . . 2516 4.29.8 Tauemuga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2517 4.30 Su'ega Iunite ile Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2519 4.30.1 Su'ega Polokalama Fa'apipi'i . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2519 4.30.2 Su'ega IDF Unit i Linux Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2520 4.31 Avetaavale Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2521 4.31.1 ESP32 Wi-Fi Lisi Fa'aaliga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2521 4.31.2 Fa'afefea ona Tusia se Talosaga Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2521 4.31.3 ESP32 Wi-Fi API Fa'ailoga Sese . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2522 4.31.4 ESP32 Wi-Fi API Parameter Initialization . . . . . . . . . . . . . . . . . . . . . . . . . 2522 4.31.5 ESP32 Fa'ata'ita'iga Polokalama Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2522 4.31.6 ESP32 Wi-Fi Fa'amatalaga o Mea e fai . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2523 4.31.7 ESP32 Wi-Fi Station Tala Lautele . . . . . . . . . . . . . . . . . . . . . . . . . . . 2526 4.31.8 ESP32 Wi-Fi AP Tala Lautele . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2529 4.31.9 ESP32 Wi-Fi Scan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2529 4.31.10 ESP32 Wi-Fi Tulaga Feso'ota'i Tulaga . . . . . . . . . . . . . . . . . . . . . . . . . 2536 4.31.11 ESP32 Wi-Fi Nofoaga Feso'ota'i pe a Maua ni AP se tele . . . . . . . . . . . . . 2543 4.31.12 Toe Feso'ota'i Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2543 4.31.13 Taimi Faailoga o le Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2543 4.31.14 ESP32 Wi-Fi Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2543 4.31.15 Wi-Fi Easy ConnectTM (DPP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2549 4.31.16 Puleaina o Fesootaiga Uaealesi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2549 4.31.17 Fua o Punaoa Leitio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2549 4.31.18 Vave BSS Suiga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2550 4.31.19 ESP32 Wi-Fi Fa'asao Malosiaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2550 4.31.20 ESP32 Wi-Fi Fa'atosina . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
vii

4.31.21 Wi-Fi 80211 Auina Atu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2552 4.31.22 Faiga Sniffer Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2554 4.31.23 Wi-Fi Tele Antenna . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2554 4.31.24 Wi-Fi Channel Fa'amatalaga a le Setete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2556 4.31.25 Wi-Fi Channel Fa'amatalaga Fa'amatalaga a le Setete . . . . . . . . . . . . . . . . . . . . . . . . . 2557 4.31.26 Wi-Fi HT20/40 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2557 4.31.27 Wi-Fi QoS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2557 4.31.28 Wi-Fi AMSDU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2558 4.31.29 Vaega Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2558 4.31.30 WPS Tagata lesitala . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2558 4.31.31 Fa'aoga Fa'apolopolo Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2558 4.31.32 Fa'afefea ona Fa'aleleia le Fa'atinoga o le Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2559 4.31.33 Wi-Fi Menuconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2562 4.31.34 Fa'afitauli . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2565 4.32 Saogalemu Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2568 4.32.1 ESP32 Wi-Fi Vaega Puipuiga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2568 4.32.2 Puipuia Fa'atonu Fa'avaa (PMF) . . . . . . . . . . . . . . . . . . . . . . . . . . . 2571 4.32.3 WiFi Enterprise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2572 4.32.4 WPA3-Tagata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2572 4.32.5 Wi-Fi Faʻaleleia OpenTM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2573 4.33 RF Fa'atasi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2573 4.33.1 Ua umaview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2574 4.33.2 Lagolagoina Va'aiga Fa'atasi mo le ESP32 . . . . . . . . . . . . . . . . . . . . . . . . . 2574 4.33.3 Faiga Fa'atasi ma Faiga Fa'avae . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2574 4.33.4 Faʻafefea ona Faʻaaogaina le Faʻamatalaga Faʻatasi . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2576 4.34 Toe Fausiaina . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2577 4.34.1 Folasaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2577 4.34.2 Mafuaaga mo fale e le mafai ona toe gaosia . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2577 4.34.3 Fa'aagaoioiga fau toe fa'aleleia ile ESP-IDF . . . . . . . . . . . . . . . . . . . . . . . . . . 2577 4.34.4 Fa'afefea ona ausia le toe gaosia o fale . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2578 4.34.5 Toe fa'aleleia ma fa'apipi'i . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2578 4.34.6 O a'afiaga o lo'o a'afia ai pea fale e mafai ona toe gaosia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2578

5 Taiala Femalagaiga

2579

5.1 ESP-IDF 5.x Taiala Femalagaiga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2579

5.1.1 Femalagaiga mai le 4.4 i le 5.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2579

6 Faletusi ma Auivi

2611

6.1 Fa'avaa o Ao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2611

6.1.1 ESP RainMaker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2611

6.1.2 AWS IoT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2611

6.1.3 Azure IoT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2611

6.1.4 Google IoT Core . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2611

6.1.5 Aliyun IoT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2611

6.1.6 Joylink IoT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2611

6.1.7 Tencent IoT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2612

6.1.8 Tencentyun IoT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2612

6.1.9 Baidu IoT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2612

6.2 Espressifns Frameworks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2612

6.2.1 Espressif Audio Development Framework . . . . . . . . . . . . . . . . . . . . . . . . . 2612

6.2.2 ESP-CSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2612

6.2.3 Espressif DSP Faletusi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2612

6.2.4 ESP-WIFI-MESH Ta'iala Atina'e . . . . . . . . . . . . . . . . . . . . . . . . 2613

6.2.5 ESP-WHO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2613

6.2.6 ESP RainMaker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2613

6.2.7 ESP-IoT-Fuli . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2613

6.2.8 ESP-Protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2613

viii

6.2.9 ESP-BSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2614

7 Taiala Fesoasoani

2615

7.1 Le Auala e Saofagā ai . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2615

7.2 A o le'i Tuuina Atu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2615

7.3 Toso Talosaga Fa'agasologa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2615

7.4 Vaega Faaletulafono . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2616

7.5 Pepa Fa'atatau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2616

7.5.1 Espressif IoT Development Framework Taiala Taiala . . . . . . . . . . . . . . . . . . . . 2616

7.5.2 Fa'apipi'i le Mata'u muamua mo le Poloketi ESP-IDF. . . . . . . . . . . . . . . . . . . . . . . 2623

7.5.3 Fa'amaumauga Fa'amaumauga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2624

7.5.4 Faia Esoamples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2629

7.5.5 API Fa'amaumauga Fa'amaumauga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2630

7.5.6 Maliega Fesoasoani . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2632

7.5.7 Taiala Ulutala Puletaofia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2634

7.5.8 Su'ega ESP-IDF ma Pytest Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2635

8 ESP-IDF Versions

2645

8.1 Fa'asa'oloto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2645

8.2 O le fea Ituaiga e Tatau Ona Ou Amata ai? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2645

8.3 Fa'aliliuga Fuafuaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2645

8.4 Vaitaimi Lagolago . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2646

8.5 Siakiina le Lomiga o lo'o iai nei . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2647

8.6 Git Galue Galuega . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2648

8.7 Fa'afouina ESP-IDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2648

8.7.1 Faʻafouina i le Faʻasaʻo Faʻamautu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2649

8.7.2 Faʻafouina i se Lomiga aʻo leʻi faʻasalalau . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2649

8.7.3 Faafouga i le Paranesi Sili . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2649

8.7.4 Faʻafouina i se Paranesi Faʻamalolo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2650

9 Punaoa

2651

9.1 PlatformIO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2651

9.1.1 O le a le PlatformIO? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2651

9.1.2 Fa'apipi'i . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2651

9.1.3 Fa'atulagaga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652

9.1.4 Aoaoga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652

9.1.5 Poloketi Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652

9.1.6 Laasaga e sosoo ai . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652

9.2 Sootaga aoga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652

10 Puletaofia ma Laisene

2653

10.1 Puletaofia Puletaofia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2653

10.1.1 Vaega o Firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2653

10.1.2 Fa'amaumauga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2654

10.2 ROM Source Code Puletaofia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2654

10.3 Xtensa libhal MIT Laisene. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2655

10.4 Laisene TinyBasic Plus MIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2655

10.5 TJpgDec Laisene . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2655

11 E uiga i

2657

12 Suia i le Va o Gagana

2659

Fa'asinomaga

2661

Fa'asinomaga

2661

Lisi o anotusi
Ole fa'amaumauga lea mo Espressif IoT Development Framework (esp-idf). O le ESP-IDF o le fa'avae fa'avae aloa'ia mo le ESP32, ESP32-S ma le ESP32-C Series SoCs. O lenei pepa o loʻo faʻamatalaina le faʻaogaina o le ESP-IDF ma le ESP32 SoC.

Amata

API Fa'asinomaga

API Taiala

Espressif Systems

1 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Lisi o anotusi

Espressif Systems

2 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1
Amata
O lenei pepa o loʻo faʻamoemoe e fesoasoani ia te oe i le setiina o le siosiomaga o le atinaʻeina o masini komepiuta e faʻavae i luga o le ESP32 chip e Espressif. Ina ua uma lena, o se ex faigofieampO le a fa'aali atu ia te oe le fa'aogaina o le ESP-IDF (Espressif IoT Development Framework) mo le fa'atulagaina o lisi, ona fau lea ma fa'amumuina le firmware i luga o le laupapa ESP32.
Manatua: O le fa'amaumauga lea mo le fa'amautu version v5.0.9 o le ESP-IDF. O lo'o avanoa fo'i isi Fa'aliliuga ESP-IDF.
1.1 Folasaga
O le ESP32 o se faiga i luga o se va'a e tu'ufa'atasia vaega nei: · Wi-Fi (2.4 GHz band) · Bluetooth · Lua maualuga fa'atinoga Xtensa® 32-bit LX6 CPU cores · Ultra Low Power co-processor · Tele peripherals
Faʻamalosia e le 40 nm tekinolosi, ESP32 e maua ai se faʻavae malosi, maualuga faʻapipiʻi, lea e fesoasoani e faʻafetaui manaoga faʻaauau mo le faʻaogaina lelei o le mana, mamanu faʻatusatusa, saogalemu, maualuga faʻatinoga, ma le faʻamaoni. Espressif o lo'o tu'uina atu meafaigaluega fa'apitoa ma punaoa fa'akomepiuta e fesoasoani ai i tagata e fa'atupu talosaga e iloa o latou manatu e fa'aaoga ai meafaigaluega fa'asologa ESP32. O le faʻatulagaina o le atinaʻeina o polokalama e Espressif ua faʻamoemoeina mo le atinaʻeina o Internetof-Things (IoT) talosaga faʻatasi ma Wi-Fi, Bluetooth, pulega eletise ma le tele o isi mea faʻaoga.
1.2 Mea e te Manaomia
1.2.1 Meafaigaluega
· Se laupapa ESP32. · Uaea USB – USB A / micro USB B. · Komipiuta e fa'aoga Windows, Linux, po'o macOS.
Manatua: I le taimi nei, o nisi o laupapa atinaʻe o loʻo faʻaogaina fesoʻotaʻiga USB Type C. Ia mautinoa o loʻo ia te oe le uaea saʻo e faʻafesoʻotaʻi ai lau laupapa!
Afai ei ai se tasi o ESP32 ofisa atinaʻe aloaʻia o loʻo lisiina i lalo, e mafai ona e kiliki i luga o le sootaga e aʻoaʻo atili ai e uiga i meafaigaluega.
3

Mataupu 1. Amata
ESP32-DevKitS(-R)
O lenei ta'iala fa'aoga o lo'o tu'uina atu ai fa'amatalaga ile ESP32-DevKitS(-R), o le ESP32 fa'avae moli laupapa na gaosia e Espressif. ESP32-DevKitS(-R) o se tuufaatasiga o igoa laupapa e lua: ESP32-DevKitS ma ESP32-DevKitS-R. O le S o le puna, a o le R o le WROVER.

ESP32-DevKitS

ESP32-DevKitS-R

O le pepa o lo'o i ai vaega tetele nei: · Amataina: Tuuina atu le toeview o le ESP32-DevKitS(-R) ma fa'atonuga fa'atulagaina o meafaigaluega/polokalame e amata ai. · Fa'amatalaga Meafaigaluega: Tuuina atu fa'amatalaga auiliili e uiga i meafaigaluega ESP32-DevKitS(-R)ns. · Pepa Fa'atatau: Tu'uina atu so'otaga i fa'amaumauga fa'atatau.

Amataina O lenei vaega o loʻo faʻamatalaina pe faʻafefea ona amata ile ESP32-DevKitS(-R). E amata i nai vaega fa'atomuaga e uiga i le ESP32-DevKitS(-R), ona tu'uina atu lea e le Vaega o le Fa'afefeteina o se Komiti Fa'atonu fa'atonuga ile fa'apipi'iina o se module i luga ole ESP32-DevKitS(-R), sauni, ma fa'amalama le firmware i luga.

Ua umaview O le ESP32-DevKitS(-R) o le ESP32 fe'avea'i laupapa ua fuafuaina faapitoa mo le ESP32. E mafai ona faʻaaogaina e moli ai se module ESP32 e aunoa ma le faʻapipiʻiina o le module i le eletise ma laina faailo. Faatasi ai ma se module faʻapipiʻi, ESP32-DevKitS(-R) e mafai foʻi ona faʻaaogaina e fai ma laupapa atinaʻe laiti e pei o le ESP32-DevKitC.
ESP32-DevKitS ma ESP32-DevKitS-R laupapa e na'o le fa'atulagaina o pine puna e fa'afetaui i le ESP32 modules nei.
· ESP32-DevKitS: ESP32-WROOM-32 ESP32-WROOM-32D ESP32-WROOM-32U ESP32-SOLO-1 ESP32-WROOM-32E ESP32-WROOM-32UE
· ESP32-DevKitS-R: ESP32-WROVER (PCB & IPEX) ESP32-WROVER-B (PCB & IPEX) ESP32-WROVER-E ESP32-WROVER-IE
Mo fa'amatalaga e uiga i modules o lo'o i luga, fa'amolemole va'ai ile ESP32 Series Modules.

Fa'amatalaga o Vaega

Espressif Systems

4 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata

Ata 1: ESP32-DevKitS - luma

Espressif Systems

Ata 2: ESP32-DevKitS-R – luma 5
Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata

Fa'aigoa Fa'amau Fa'amau Fa'aulu 2.54 mm Fa'aulu
USB-i-UART Bridge LDO Micro-USB Connector/Micro USB Port EN Button Boot Button
Mana Iila

Fa'amatalaga Kiliki le module i totonu. O pine o le a ofi i totonu ole modulens pu. O nei ulutala tama'ita'i e feso'ota'i i pine o le module o lo'o fa'apipi'i i luga o lenei laupapa. Mo fa'amatalaga o ulutala tama'ita'i, fa'amolemole tagai ile Ulutala Blocks. USB kipi ta'itasi ile UART alalaupapa e tu'uina atu tau fa'aliliu e o'o atu ile 3 Mbps.
5V-i-3.3V maualalo-tuu ese voltage fa'atonu (LDO).
fa'aoga USB. Sapalai eletise mo le laupapa faʻapea foʻi ma fesoʻotaʻiga i le va o le komepiuta ma le laupapa.
Toe seti faamau.
Fa'amau download. Taofi i lalo Boot ona oomi lea ole EN e amata ai le faiga o le Firmware Download mo le la'uina mai o le firmware e ala i le laina telefoni.
E ki pe a feso'ota'i le USB po'o le sapalai eletise i le laupapa.

Fa'afefea ona emo se Komiti A'o le'i fa'aola lau ESP32-DevKitS(-R), fa'amolemole ia mautinoa o lo'o lelei ma leai ni fa'ailoga manino o le fa'aleagaina.
Meafaigaluega Manaomia · Se ESP32 module o lau filifiliga · USB 2.0 cable (Standard-A i Micro-B) · Komipiuta e faʻaogaina Windows, Linux, poʻo macOS
Seti Meafaigaluega Faʻamolemole faʻapipiʻi se module o lau filifiliga i luga o lau ESP32-DevKitS(-R) e tusa ai ma laasaga nei:
· Tuu lemu lau module i luga o le laupapa ESP32-DevKitS(-R). Ia mautinoa o pu fa'apipi'i i luga o lau module o lo'o ogatusa ma pine puna i luga o le laupapa.
· Oomi lau module i lalo i totonu o le laupapa seia oomi. · Siaki pe fa'aofi uma pine puna i totonu o pu. Afai o lo'o i ai ni pine puna e sese,
tu'u i totonu o pu fa'asalaina ma ni tweezers.
Seti polokalama
Metotia e Mana'omia O le fa'avae o le atina'e o le ESP-IDF e tu'uina atu ai se auala e fa'amaninoina e fa'amalamaina ai ta'i lua ile ESP32-DevKitS(-R). Fa'amolemole fa'agasolo i le Amata, lea e fesoasoani vave ai le Fa'apipi'iina o le Vaega e fa'atūina ai le si'osi'omaga o le atina'e ona fa'amalama ai lea o se talosaga fa'atasiampi luga o lau ESP32-DevKitS(-R).
Alternative Method I se isi itu, e mafai e tagata fa'aoga Windows ona fa'apipi'i binaries e fa'aaoga ai le Flash Download Tool. Na'o le siiina mai, tatala le sipuni, ma mulimuli i faatonuga i totonu o le faila faila.
Fa'aaliga: 1. Ia moli le binary files, ESP32 e tatau ona seti i le Firmware Download mode. E mafai ona faia lenei mea a le otometi le meafaigaluega moli, poʻo le uu i lalo o le Boot button ma oomi le EN button. 2. Ina ua uma ona emo le binary files, o le Flash Download Tool e toe amata lau module ESP32 ma fa'aa'e le talosaga emo e ala i le faaletonu.

Fua o le Komiti Fa'atonu mea o lo'o i totonu ma le afifiina

Espressif Systems

6 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata Ata 3: ESP32-DevKitS fua laupapa – tua

Espressif Systems

Ata 4: ESP32-DevKitS-R fua laupapa – tua 7
Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata
Fa'atauga fa'atau A e oka ni nai sample mea, ESP32-DevKitS(-R) ta'itasi e sau i totonu o se afifi ta'itasi i totonu ole ato fa'aantistatic po'o so'o se afifi e fa'atatau ile fa'atauoloa. Mo fa'atauga fa'atau, fa'amolemole alu ile https://www.espressif.com/en/contact-us/get-samples.
Fa'atauga A'oa'o Afai e te oka fa'atele, e sau laupapa i atigipusa lapopo'a. Mo fa'atauga fa'atau, fa'amolemole alu ile https://www.espressif.com/en/contact-us/sales-questions.
Fa'asinoga Meafaigaluega
Fa'ata poloka O se ata poloka o lo'o i lalo o lo'o fa'aalia ai vaega ole ESP32-DevKitS(-R) ma a latou feso'ota'iga.

Ata 5: ESP32-DevKitS(-R) (kiliki e fa'atele)
Filifiliga Sapalai Malosiaga E tolu auala fa'apitoa e tu'u atu ai le paoa i le laupapa: · Micro USB uafu, fa'aletonu le paoa · 5V ma GND pine ulu · 3V3 ma GND pine ulu
E fautuaina e faʻaaoga le filifiliga muamua: micro USB port.

Espressif Systems

Faailoga Faailoga

L1 3V3 VDD 3V3

L2 EN CHIP_PU

L3 VP SENSOR_VP

L4 VN SENSOR_VN

L5 34

GPIO34

L6 35

GPIO35

L7 32

GPIO32

L8 33

GPIO33

faaauau i le isi itulau

8 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata

Siata 1 fa'aauau mai le itulau muamua

Faailoga Faailoga

L9 25

GPIO25

L10 26

GPIO26

L11 27

GPIO27

L12 14

GPIO14

L13 12

GPIO12

L14 GND GND

L15 13

GPIO13

L16 D2 SD_DATA2

L17 D3 SD_DATA3

L18 CMD SD_CMD

L19 5V

5V fafo

R1 GND GND

R2 23

GPIO23

R3 22

GPIO22

R4 TX U0TXD

R5 RX U0RXD

R6 21

GPIO21

R7 GND GND

R8 19

GPIO19

R9 18

GPIO18

R10 5

GPIO5

R11 17

GPIO17

R12 16

GPIO16

R13 4

GPIO4

R14 0

GPIO0

R15 2

GPIO2

R16 15

GPIO15

R17 D1 SD_DATA1

R18 D0 SD_DATA0

R19 CLK SD_CLK

Poloka Ulutala Mo le ata o poloka ulutala, fa'amolemole fa'afeso'ota'i le Fa'amatalaga o Vaega.

Pepa Fa'atatau
· ESP32-DevKitS(-R) Schematics (PDF) · ESP32 Datasheet (PDF) · ESP32-WROOM-32 Datasheet (PDF) · ESP32-WROOM-32D & ESP32-WROOM-32U Datasheet (PDF) · ESP32-WROOM-32 Datasheet (PDF1) (PDF) · ESP32-WROVER-B Pepa Fa'amaumauga (PDF) · ESP Filifiliga o Mea

ESP32-DevKitM-1

O le a fesoasoani lenei taiala fa'aoga ia te oe e amata ile ESP32-DevKitM-1 ma o le a maua ai fo'i nisi fa'amatalaga loloto.
ESP32-DevKitM-1 o le ESP32-MINI-1(1U)-faʻavaeina faʻavae laupapa faʻavae na gaosia e Espressif. O le tele o pine I/O o lo'o malepe i ulu pine i itu uma e lua mo le fa'afaigofie ona fa'afeso'ota'i. E mafai e tagata fa'aoga ona fa'afeso'ota'i va'aiga fa'atasi ma uaea osooso po'o le fa'amauina o le ESP32-DevKitM-1 i luga o se laupapa falaoa.

Espressif Systems

9 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata

ESP32-DevKitM-1 – luma

ESP32-DevKitM-1 – isometric

O le pepa o lo'o aofia ai vaega tetele nei: · Amataina: Tuuina atu se fa'aumaview o le ESP32-DevKitM-1 ma faʻatonuga faʻatulagaina o meafaigaluega/polokalame e amata ai. · Fa'amatalaga Meafaigaluega: Tuuina atu fa'amatalaga auiliili e uiga i meafaigaluega ESP32-DevKitM-1ns. · Pepa Fa'afeso'ota'i: Tuuina atu so'otaga i fa'amaumauga fa'atatau.

Amataina O lenei vaega o loʻo faʻamatalaina pe faʻafefea ona amata ile ESP32-DevKitM-1. E amata i nai vaega folasaga e uiga i le ESP32-DevKitM-1, ona tuʻuina atu lea e le Vaega Amata le Atinaʻeina o Talosaga faʻatonuga i le auala e fai ai le seti muamua o meafaigaluega ma faʻafefea ona moli firmware i luga o le ESP32-DevKitM-1.

Ua umaview Ole la'ititi la'ititi ma faigofie le atina'e laupapa e fa'aalia:
· ESP32-MINI-1, poʻo le ESP32-MINI-1U module · USB-i-serial programming interface lea e maua ai foʻi le sapalai eletise mo le laupapa · ulu pine · faʻamau mo le toe setiina ma le faʻagaoioia o le Firmware Download mode · nai isi vaega.

Anotusi ma le afifiina

Fa'atauga fa'atau A e oka ni nai sample mea, ESP32-DevKitM-1 ta'itasi e sau i totonu o se afifi ta'itasi i totonu ole ato fa'aantistatic po'o so'o se afifi e fa'atatau i lau fa'atau.
Mo fa'atauga fa'atau, fa'amolemole alu ile https://www.espressif.com/en/contact-us/get-samples.

Fa'atauga A'oa'o Afai e te oka fa'atele, e sau laupapa i atigipusa lapopo'a. Mo fa'atauga fa'atau, fa'amolemole alu ile https://www.espressif.com/en/contact-us/sales-questions.

Faʻamatalaga o Vaega O le ata o loʻo i lalo ma le laulau o loʻo i lalo o loʻo faʻamatalaina vaega autu, fesoʻotaʻiga ma faʻatonuga o le ESP32-DevKitM-1 laupapa. Matou te ave le laupapa ma le ESP32-MINI-1 module e pei o se example i vaega nei.

Espressif Systems

10 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata

Ata 6: ESP32-DevKitM-1 - luma

Vaega Autu I luga o le laupapa module
5 V i le 3.3 V LDO Fa'amau Fa'amau
Toe Seti le Fa'amau Micro-USB Port
USB-i-UART Alalaupapa 3.3 V Malosi i luga o le LED
I/O Feso'ota'i

Fa'amatalaga
ESP32-MINI-1 module po'o le ESP32-MINI-1U module. ESP32-MINI-1 e sau ma se antenna PCB i luga ole laupapa. ESP32-MINI-1U e sau fa'atasi ma se feso'ota'iga antenna fafo. O modules e lua o loʻo i ai uma le 4 MB flash i totonu o le pusa chip. Mo fa'amatalaga, fa'amolemole va'ai le Pepa Fa'amatalaga ESP32-MINI-1 & ESP32-MINI-1U.
E fa'aliliuina e le pule fa'atonu le 5 V i le 3.3 V.
Fa'amau download. Taofi i lalo Boot ona oomi lea o le Toe seti e amata ai le faiga o le Download Firmware mo le la'uina o le firmware e ala i le laina telefoni.
Toe Seti ki
fa'aoga USB. Sapalai eletise mo le laupapa faʻapea foʻi ma fesoʻotaʻiga fesoʻotaʻiga i le va o le komepiuta ma le ESP32 chip.
O le pusi alalaupapa USB-UART ta'itasi e maua ai le fa'aliliuga o tau e o'o atu i le 3 Mbps.
E ki pe a feso'ota'i le USB i le laupapa. Mo fa'amatalaga, fa'amolemole va'ai le fa'asologa i totonu Pepa Fa'atatau. O pine GPIO uma o lo'o avanoa (sei vagana ai le pasi SPI mo moli) o lo'o ta'e i fa'aulu fa'aulu i luga o le laupapa. E mafai e tagata faʻaoga ona faʻapipiʻi le ESP32 chip e mafai ai le tele o galuega.

Amata le Atina'eina o Talosaga A'o le'i fa'aola lau ESP32-DevKitM-1, fa'amolemole ia mautinoa o lo'o lelei ma leai ni fa'ailoga manino o le fa'aleagaina.
Meafaigaluega Manaomia · ESP32-DevKitM-1 · USB 2.0 uaea (Standard-A i le Micro-B) · Komipiuta o loʻo faʻaogaina Windows, Linux, poʻo macOS
Seti Polokalama Fa'amolemole fa'agasolo i le Amata, lea o le a fesoasoani vave ai le Fa'apipi'iina o le Vaega e fa'atūina le si'osi'omaga o le atina'e ona emo lea o se talosaga muamua.ampi luga o lau ESP32-DevKitM-1.

Espressif Systems

11 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata
Faʻalogo: ESP32-DevKitM-1 laupapa na gaosia aʻo leʻi oʻo i le aso 2 o Tesema, 2021 o loʻo faʻapipiʻiina se module autu e tasi. Ina ia faʻamaonia po o le a le module o loʻo ia te oe, faʻamolemole siaki faʻamatalaga faʻailoga module ile PCN-2021-021. Afai o lau laupapa o lo'o fa'apipi'iina se module autu e tasi, fa'amolemole fa'agasolo le fa'aoga tasi (CONFIG_FREERTOS_UNICORE) ile menuconfig a'o le'i fa'amalama au talosaga.
Mea Fa'asinomaga Fa'asinomaga Fa'ata'ita'iga O se ata poloka o lo'o i lalo o lo'o fa'aalia ai vaega ole ESP32-DevKitM-1 ma a latou feso'ota'iga.

Ata 7: ESP32-DevKitM-1
Filifilia Punavai Malosi E tolu auala fa'apitoa e tu'uina atu ai le paoa i le laupapa: · Micro USB port, fa'aletonu le paoa · 5V ma GND pine ulu · 3V3 ma GND pine ulu.
Lapataiga: · E tatau ona tu'uina atu le eletise e fa'aaoga ai le tasi ma na'o le tasi o filifiliga o lo'o i luga, a leai e mafai ona fa'aleagaina le laupapa ma/po'o le puna eletise. · E fautuaina le sapalai eletise e ala i le micro USB port.

Fa'amatalaga Pin O le laulau o lo'o i lalo o lo'o maua ai le Igoa ma le Galuega o pine i itu uma e lua o le laupapa. Mo fa'asologa o pine fa'apitonu'u, fa'amolemole va'ai ile Pepa Fa'amaumauga ESP32.

Leai.

Igoa

Ituaiga

GND

3V3

Galuega Eleele 3.3 V sapalai eletise

faaauau i le isi itulau

Espressif Systems

12 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata

Siata 2 fa'aauau mai le itulau muamua

Leai.

Igoa

Ituaiga

Galuega

I36

GPIO36, ADC1_CH0, RTC_GPIO0

I37

GPIO37, ADC1_CH1, RTC_GPIO1

I38

GPIO38, ADC1_CH2, RTC_GPIO2

I39

GPIO39, ADC1_CH3, RTC_GPIO3

RST

Toe setiina; Maualuga: mafai; Maulalo: paoa

I34

GPIO34, ADC1_CH6, RTC_GPIO4

I35

GPIO35, ADC1_CH7, RTC_GPIO5

IO32

I/O

GPIO32, XTAL_32K_P (32.768 kHz fa'aoga oscillator tioata),

ADC1_CH4, TOUCH9, RTC_GPIO9

IO33

I/O

GPIO33, XTAL_32K_N (32.768 kHz oscillator tioata),

ADC1_CH5, TOUCH8, RTC_GPIO8

IO25

I/O

GPIO25, DAC_1, ADC2_CH8, RTC_GPIO6, EMAC_RXD0

IO26

I/O

GPIO26, DAC_2, ADC2_CH9, RTC_GPIO7, EMAC_RXD1

IO27

I/O

GPIO27, ADC2_CH7, TOUCH7, RTC_GPIO17, EMAC_RX_DV

IO14

I/O

GPIO14, ADC2_CH6, TOUCH6, RTC_GPIO16, MTMS, HSPICLK,

HS2_CLK, SD_CLK, EMAC_TXD2

5 V eletise sapalai

IO12

I/O

GPIO12, ADC2_CH5, TOUCH5, RTC_GPIO15, MTDI, HSPIQ,

HS2_DATA2, SD_DATA2, EMAC_TXD3

IO13

I/O

GPIO13, ADC2_CH4, TOUCH4, RTC_GPIO14, MTCK, HSPID,

HS2_DATA3, SD_DATA3, EMAC_RX_ER

IO15

I/O

GPIO15, ADC2_CH3, TOUCH3, RTC_GPIO13, MTDO, HSPICS0,

HS2_CMD, SD_CMD, EMAC_RXD3

IO2

I/O

GPIO2, ADC2_CH2, TOUCH2, RTC_GPIO12, HSPIWP,

HS2_DATA0, SD_DATA0

IO0

I/O

GPIO0, ADC2_CH1, TOUCH1, RTC_GPIO11, CLK_OUT1,

EMAC_TX_CLK

IO4

I/O

GPIO4, ADC2_CH0, TOUCH0, RTC_GPIO10, HSPIHD,

HS2_DATA1, SD_DATA1, EMAC_TX_ER

IO9

I/O

GPIO9, HS1_DATA2, U1RXD, SD_DATA2

IO10

I/O

GPIO10, HS1_DATA3, U1TXD, SD_DATA3

IO5

I/O

GPIO5, HS1_DATA6, VSPICS0, EMAC_RX_CLK

IO18

I/O

GPIO18, HS1_DATA7, VSPICLK

IO23

I/O

GPIO23, HS1_STROBE, VSPID

IO19

I/O

GPIO19, VSPIQ, U0CTS, EMAC_TXD0

IO22

I/O

GPIO22, VSPIWP, U0RTS, EMAC_TXD1

IO21

I/O

GPIO21, VSPIHD, EMAC_TX_EN

TXD0

I/O

GPIO1, U0TXD, CLK_OUT3, EMAC_RXD2

RXD0

I/O

GPIO3, U0RXD, CLK_OUT2

Fa'amatalaga Toe Iloiloga o Meafaigaluega E leai ni lomiga muamua o maua.
Pepa Fa'atatau
· ESP32-MINI-1 & ESP32-MINI-1U Pepa Fa'amaumauga (PDF) · ESP32-DevKitM-1 Schematics (PDF) · ESP32-DevKitM-1 PCB layout (PDF) · ESP32-DevKitM-1 layout (DXF) – E te mafaia view faʻatasi ma Autodesk Viewer luga ole laiga · ESP32 Pepa Fa'amaumauga (PDF) · ESP Mea Filifilia
Mo isi faʻamaumauga o mamanu mo le laupapa, faʻamolemole faʻafesoʻotaʻi matou i le sales@espressif.com.

Espressif Systems

13 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata
1.2.2 Software
Ina ia amata faʻaaoga le ESP-IDF i luga ole ESP32, faʻapipiʻi le polokalame lea: · Meafaigaluega e tuʻufaʻatasia ai le code mo ESP32 · Fau mea faigaluega - CMake ma Ninja e fausia ai se Talosaga atoa mo ESP32 · ESP-IDF o loʻo i ai le API (faletusi komipiuta ma le code source) mo le ESP32 ma tusitusiga e faʻaogaina ai le Toolchain.

1.3 Fa'apipi'i
Ina ia faʻapipiʻi uma polokalama manaʻomia, matou te ofoina atu ni auala eseese e faʻafaigofie ai lenei galuega. Filifili mai se tasi o avanoa avanoa.
1.3.1 IDE

Manatua: Matou te matua fautuaina le faʻapipiʻiina o le ESP-IDF e ala i lau IDE e sili ona e fiafia i ai.
· Eclipse Plugin · VSCode Extension

1.3.2 Fa'apipi'i Tusia
Mo le fa'atinoga o le tusi lesona, fa'amolemole filifili e tusa ai ma lau faiga fa'aoga.

Espressif Systems

14 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata
Seti masani o Meafaigaluega mo Pupuni
Fa'atomuaga ESP-IDF e mana'omia ni meafaigaluega mana'omia muamua e fa'apipi'i ina ia mafai ai ona e fausia le firmware mo tupe meataalo lagolago. O mea faigaluega muamua e aofia ai le Python, Git, cross-compilers, CMake ma Ninja fau mea faigaluega. Mo lenei Amataina o le a faʻaaogaina le Poloaiga Polokalama, ae a maeʻa faʻapipiʻi le ESP-IDF e mafai ona e faʻaogaina le Eclipse Plugin poʻo se isi IDE faʻataʻitaʻi ma le CMake lagolago nai lo. Fa'aaliga: Tapula'a: – Ole ala fa'apipi'i ole ESP-IDF ma le ESP-IDF Meafaigaluega e le tatau ona umi atu i le 90 mataitusi. O auala fa'apipi'i uumi e ono i'u ai i se faufale ua le manuia. - Ole auala faʻapipiʻi ole Python poʻo le ESP-IDF e le tatau ona iai ni avanoa paʻepaʻe poʻo ni puipui. - O le auala faʻapipiʻi o le Python poʻo le ESP-IDF e le tatau ona i ai ni mataitusi faʻapitoa (nonASCII) seivagana ua faʻapipiʻiina le faiga faʻaogaina i le oUnicode UTF-8psupport. E mafai e le Pule Faʻatonu ona faʻatagaina le lagolago e ala i le Pulea Pulea - Suia le aso, taimi, poʻo numera numera - Faʻatonu tab - Suia le nofoaga faʻaoga - siaki le filifiliga oBeta: Faʻaaoga Unicode UTF-8 mo le lagolago gagana i le lalolagi atoa - Ok ma toe faʻafou le komepiuta.
ESP-IDF Tools Installer O le auala pito sili ona faigofie e fa'apipi'i ai mea e mana'omia muamua ESP-IDFns o le la'uina lea o se tasi o ESP-IDF Tools Installers.

Windows Installer Download
O le a le faʻaoga mo luga ole Initaneti ma Offline Installer Online Installer e matua laʻititi ma faʻatagaina le faʻapipiʻiina o faʻasalalauga avanoa uma ole ESP-IDF. O le faʻapipiʻi o le a faʻapipiʻiina naʻo mea faʻalagolago e aofia ai Git Mo Windows i le taimi o le faʻapipiʻiina. Le fa'apipi'i faleoloa na sii mai files i totonu o le lisi o mea e teu ai %userprofile%. espressif
E le mana'omia e le tagata fa'apipi'i le Initaneti so'o se feso'ota'iga feso'ota'iga. O le faʻapipiʻi o loʻo i ai faʻalagolago uma e manaʻomia e aofia ai Git Mo Windows.
Vaega o le faʻapipiʻi E faʻapipiʻi e le faʻapipiʻi vaega nei:
· Embedded Python · Cross-compilers · OpenOCD · CMake ma Ninja fausia meafaigaluega · ESP-IDF
E fa'atagaina fo'i e le fa'apipi'i ona toe fa'aogaina le fa'atonu o lo'o iai ma le ESP-IDF. Ole fa'atonuga ole %userprofile%Desktopesp-idf lea %userprofile% o lau lisi o fale.

Espressif Systems

15 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata
Fa'alauiloa ESP-IDF Si'osi'omaga I le fa'ai'uga o le fa'atulagaga fa'apipi'i e mafai ona e siakia le filifiliga Fa'agaoioi le ESP-IDF PowerShell Si'osi'omaga po'o le Ta'avale ESP-IDF Command Prompt (cmd.exe). O le fa'apipi'i o le a fa'alauiloa le siosiomaga ESP-IDF i le vave filifilia. Fa'atino le ESP-IDF PowerShell Environment:

Ata 8: Fa'auma le ESP-IDF Tools Setup Wizard ma le Run ESP-IDF PowerShell Environment
Fa'asolo le ESP-IDF Command Prompt (cmd.exe):
Fa'aaogaina o le Poloaiga Fa'atonu Mo isi laasaga o le Amataina, o le a fa'aaoga le Windows Command Prompt. ESP-IDF Tools Installer e fai fo'i se ala 'alo i le lisi Amata e fa'alauiloa ai le ESP-IDF Command Prompt. O lenei ala pupuu e faʻalauiloa ai le Poloaiga Polokalama (cmd.exe) ma faʻatautaia le export.bat script e faʻatulaga ai suiga o le siosiomaga (PATH, IDF_PATH ma isi). I totonu o lenei fa'atonuga fa'atonu, o lo'o avanoa uma meafaigaluega fa'apipi'i. Manatua o lenei ala 'alo e patino i le ESP-IDF directory ua filifilia i le ESP-IDF Tools Installer. Afai e tele au fa'atonuga ESP-IDF i luga ole komipiuta (fa'ataample, e galue ai i lomiga eseese o le ESP-IDF), e lua au filifiliga e fa'aoga ai:
1. Fausia se kopi o le ala 'alo na faia e le ESP-IDF Tools Installer, ma sui le lisi galue o le ala 'upu fou i le ESP-IDF directory e te mana'o e fa'aoga.
2. I le isi itu, ta'e cmd.exe, ona sui lea i le ESP-IDF directory e te mana'o e fa'aoga, ma ta'e export.bat. Manatua e le pei o le filifiliga muamua, o lenei auala e manaʻomia ai le Python ma le Git e iai ile PATH. Afai e te maua ni mea sese e fesoʻotaʻi ma le Python poʻo le Git e le o maua, faʻaaoga le filifiliga muamua.
Laasaga Muamua ile ESP-IDF I le taimi nei talu ai ua ausia uma mana'oga, o le isi autu o le a ta'ita'ia oe ile auala e amata ai lau galuega muamua.

Espressif Systems

16 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata Ata 9: ESP-IDF PowerShell

Ata 10: Fa'auma le ESP-IDF Tools Setup Wizard ma le Run ESP-IDF Command Prompt (cmd.exe)

Espressif Systems

17 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata

Ata 11: ESP-IDF Command Prompt

Espressif Systems

18 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata
O le a fesoasoani lenei ta'iala ia te oe ile laasaga muamua ile fa'aogaina ole ESP-IDF. Mulimuli i lenei taʻiala e amata ai se poloketi fou ile ESP32 ma fausia, moli, ma mataʻituina le gaioiga o le masini. Manatua: Afai e te leʻi faʻapipiʻiina le ESP-IDF, faʻamolemole alu i le Faʻapipiʻi ma mulimuli i le faʻatonuga ina ia mafai ai ona maua uma polokalama e manaʻomia e faʻaoga ai lenei taʻiala.

Amata se Poloketi O lea ua e sauni e tapena lau talosaga mo le ESP32. E mafai ona e amata i le getstarted/hello_world project from examples directory i le ESP-IDF.
Taua: E le lagolagoina e le polokalama faufale ESP-IDF avanoa i ala i le ESP-IDF po'o galuega faatino.
Kopi le galuega amata/hello_world ile ~/esp directory: cd%userprofile%esp xcopy /e /i %IDF_PATH%examplesget-startedhello_world hello_world
Fa'aaliga: E iai le tele o fa'aupugaample galuega faatino i le examples directory i le ESP-IDF. E mafai ona e kopiina soʻo se poloketi i le auala lava e tasi e pei ona tuʻuina atu i luga ma faʻatautaia. E mafai foi ona fausia examples in-place e aunoa ma le kopiina muamua.

Fa'afeso'ota'i lau masini Fa'afeso'ota'i lau laupapa ESP32 i le komipiuta ma siaki po'o fea o lo'o va'aia ai le va'aiga fa'asologa o le laupapa. O igoa tau telefoni e amata ile COM ile Windows. Afai e te le o mautinoa pe faʻafefea ona siaki le igoa tau telefoni, faʻamolemole faʻafesoʻotaʻi le Faʻavaeina Faʻasologa Faʻatasi ma ESP32 mo faʻamatalaga atoa.
Fa'aaliga: Taofi le igoa o le taulaga aua e te mana'omia ile isi laasaga.

Fa'atulaga lau Poloketi Su'e i lau hello_world directory, seti le ESP32 e fai ma fa'amoemoega, ma fa'agasolo le project configuration utility menuconfig.
Pupuni cd%userprofile%esphello_world idf.py seti-taulai esp32 idf.py menuconfig
A maeʻa ona tatalaina se poloketi fou, e tatau ona e seti muamua le sini ile idf.py set-target esp32. Manatua o mea o loʻo i ai nei ma faʻatulagaga i totonu o le poloketi, pe a iai, o le a faʻamalo ma amataina i lenei faiga. E mafai ona fa'asaoina le fa'amoemoe ile suiga ole si'osi'omaga e fa'ase'e ai le la'asaga lea. Va'ai Filifili le Chip Target: set-target mo fa'amatalaga faaopoopo. Afai ua sa'o le faiga o laasaga muamua, e aliali mai le lisi o lo'o i lalo: O lo'o e fa'aogaina le lisi lea e fa'atulaga ai suiga fa'apitoa o le poloketi, fa'ata'ita'iga, Wi-Fi igoa feso'ota'iga ma upu fa'aoga, le saoasaoa o le gaosiga, ma isi.ample tamo'e ma le seti fa'aletonu.
Manatua: Afai e te faʻaogaina le ESP32-DevKitC laupapa ma le ESP32-SOLO-1 module, poʻo le ESP32-DevKitM-1 laupapa faʻatasi ma le ESP32-MIN1-1(1U) module, faʻamolemole faʻafesoʻotaʻi le tasi tulaga autu (CONFIG_FREERTOS_UNICORE) ile menuconfig aʻo leʻi faʻamalama ex.amples.

Espressif Systems

19 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata

Ata 12: Fa'atulagaina o Poloketi - Fa'amalama o le fale
Manatua: O lanu o le lisi e mafai ona ese i lau laina. E mafai ona e suia foliga i le filifiliga -style. Fa'amolemole fa'agasolo idf.py menuconfig –fesoasoani mo nisi fa'amatalaga.
Afai o loʻo e faʻaaogaina se tasi o laupapa atinaʻe lagolago, e mafai ona e faʻavaveina lau atinaʻe e ala i le faʻaaogaina o le Board Support Package. Va'ai Fautuaga Faaopoopo mo nisi fa'amatalaga.
Fausia le Poloketi Fausia le poloketi e ala i le ta'avale:
idf.py fausia
O lenei poloaiga o le a tuʻufaʻatasia ai le talosaga ma vaega uma o le ESP-IDF, ona faʻatupuina ai lea o le bootloader, laulau vaeluaga, ma binaries talosaga.
$ idf.py fausia Tamomoe cmake i le lisi /path/to/hello_world/build Fa'atinoina o le “cmake -G Ninja –warn-uninitialized /path/to/hello_world”… Lapata'i e uiga i tulaga taua e le'i amataina. — Maua Git: /usr/bin/git (maua lomiga “2.17.0”) — Fausiaina gaogao aws_iot vaega ona o le faatulagaga — Igoa o vaega: … — Auala vaega: …
… (sili atu laina o galuega faufale)
[527/527] Fausia hello_world.bin esptool.py v2.3.1
Ua mae'a le fausiaina o le poloketi. Ina ia moli, fai le poloaiga lenei: ../../../components/esptool_py/esptool/esptool.py -p (PORT) -b 921600 write_flash -flash_mode dio –flash_size detect –flash_freq 40m 0x10000 build/hello_world. talone fausia 0x1000 fau/bootloader/bootloader.bin 0x8000 fausia/partition_table/ partition-table.bin pe ta'e 'idf.py -p PORT flash'
Afai e leai ni mea sese, o le a maeʻa le fausiaina e ala i le fausiaina o le firmware binary .bin files.

Espressif Systems

20 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata
Foma'i i luga o le Masini Fa'ailoa le fa'atosina na e fa'ato'a fausia (bootloader.bin, partition-table.bin ma hello_world.bin) i luga o lau laupapa ESP32 e ala i le ta'avale: idf.py -p PORT [-b BAUD] flash
Suia le PORT i lau ESP32 boardns serial port name. E mafai fo'i ona e suia le fua o le pa'u moli e ala i le suia o le BAUD i le fua o le pa'u e te mana'omia. Ole fua ole baud ole 460800. Mo nisi fa'amatalaga ile idf.py finauga, va'ai idf.py.
Fa'aaliga: O le filifiliga moli e otometi lava ona fausia ma moli le poloketi, o lea e le manaʻomia ai le faʻaogaina o le idf.py build.

Fa'asaga i Fa'afitauli A'o Emo? Afai e te faʻatinoina le faʻatonuga ma vaʻai i mea sese e pei o le le mafai ona faʻafesoʻotaʻi, atonu e tele mafuaʻaga mo lenei mea. O se tasi o mafuaʻaga atonu o ni faʻafitauli e feagai ma esptool.py, o le aoga e taʻua e le fausiaina o le polokalama e toe setiina ai le pu, fegalegaleai ma le ROM bootloader, ma flash firmware. O se tasi o fofo faigofie e taumafai ai o le toe setiina o le tusi lesona o loʻo faʻamatalaina i lalo, ma afai e le fesoasoani e mafai ona e mauaina nisi faʻamatalaga e uiga i faʻafitauli e ono tutupu i Faʻafitauli.
esptool.py resets ESP32 otometi e ala i le faʻamaonia DTR ma RTS pulea laina o le USB i le puʻupuʻu faaliliu serial, ie, FTDI poʻo le CP210x (mo nisi faʻamatalaga, vaʻai Faʻamauina Soʻotaga Serial ma ESP32). Ole laina ole DTR ma le RTS e feso'ota'i atu ile GPIO0 ma le CHIP_PU (EN) pine o le ESP32, ma suia ai le vol.tagO la'asaga o le DTR ma le RTS o le a fa'auluina le ESP32 i totonu o le fa'aogaina o le Firmware Download mode. I le avea ai ma se example, siaki le schematic mo le ESP32 DevKitC atinae laupapa.
I se tulaga lautele, e le tatau ona i ai ni faʻafitauli i le ofisa faʻapitoa esp-idf development boards. Ae peitai, esptool.py e le mafai ona toe setiina au meafaigaluega i tulaga nei:
· O au meafaigaluega e leai ni laina DTR ma RTS e fesoʻotaʻi i le GPIO0 ma le CHIP_PU · O laina DTR ma RTS e ese le faʻatulagaina · E leai lava se laina faʻatautaia faʻasologa
Fa'alagolago i le ituaiga meafaigaluega o lo'o ia te oe, e ono mafai fo'i ona tu'u ma le lima lau laupapa ESP32 i totonu o le Firmware Download mode (toe setiina).
· Mo laupapa atina'e na gaosia e Espressif, o nei fa'amatalaga e mafai ona maua i ta'iala amata po'o ta'iala fa'aoga. Mo example, e toe setiina ma le lima se laupapa atinae ESP-IDF, taofi i lalo le faamau Boot (GPIO0) ma fetaomi le faamau EN (CHIP_PU).
· Mo isi ituaiga meafaigaluega, taumafai e toso i lalo GPIO0.

Espressif Systems

21 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata
(fa'aauau mai le itulau muamua) Fa'atonu le lapo'a moli… Fa'amau 3072 paita i le 103... Tusi i le 0x00008000... (100 %) Tusia le 3072 paita (103 fa'amau) i le 0x00008000 i le 0.0.000000000000... (100 %) Tusia le 3072 paita (103 fa'apipi'i) i le 0x00008000 i le 0.0.0.8 sekone (e aoga 5990/62) fa'amatalaga fa'amaonia. Fa'apipi'i 26096 paita i le 15408... Tusia ile 0x00001000... (100 %) Tusia 26096 paita (15408 fa'amau) ile 0x00001000 ile 0.4 sekone (e aoga 546.7 kbit/s fa'amaonia). Fa'amauina 147104 paita i le 77364... Tusia ile 0x00010000... (20 %) Tusia ile 0x00014000... (40 %) Tusi ile 0x00018000... (60 %) Tusi ile 0x0001c000% (60%) Writing ile 0x0001c000%) 0x00020000… (100 %) Tusia 147104 bytes (77364 compressed) i le 0x00010000 i le 1.9 sekone (e aoga 615. 5 kbit/s)… Hash of data verified.
Tu'u ese... Toe setiina faigata e ala i le pine RTS... Ma'ea
Afai e leai ni fa'afitauli i le fa'ai'uga o le flash process, o le a toe fa'afou le laupapa ma amata le theohello_worldpapplication. Afai e te manaʻo e faʻaoga le Eclipse poʻo le VS Code IDE nai lo le taʻavale idf.py, siaki le Eclipse Plugin, VSCode Extension.
Mata'ituina le Fa'asologa Ina ia siaki pe o le ohello_worldpis o lo'o tamo'e moni, fa'aigoa idf.py -p PORT mata'itu (Aua nei galo e sui le PORT i lou igoa tau telefoni).
O lenei poloaiga e faʻalauiloa ai le talosaga IDF Monitor:
$ idf.py -p mata'itū Ta'avale idf_monitor i le fa'atonu [...]/esp/hello_world/build Fa'atino le “python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_ world/build/hello_world.elf”… — idf_monitor on 115200 —– Tu'u: Ctrl+] | Menu: Ctrl+T | Fesoasoani: Ctrl+T sosoo ai Ctrl+H –ets Jun 8 2016 00:22:57
muamua:0x1 (POWERON_RESET), seevae:0x13 (SPI_FAST_FLASH_BOOT) ma Iuni 8 2016 00:22:57 …
A mae'a le amataga ma fa'amaufa'ailoga tusi fa'asolo i luga, e tatau ona e va'ai i le oTalofa lalolagi! lolomi i fafo e le talosaga.
… Talofa le lalolagi! Toe amata ile 10 sekone… Ole esp32 chip lea ma le 2 CPU core(s), WiFi/BT/BLE, silicon revision 1, 2MB external flash Laiti faupu'e fua fua: 298968 bytes Toe amata ile 9 sekone... Toe amata ile 8 sekone... Toe amata ile 7 sekone...
Ina ia alu ese mai le mata'ituina o le IDF, fa'aoga le ala pupuu Ctrl+].

Espressif Systems

22 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata
Afai e le manuia le mata'ituina o le IDF pe a uma le tu'uina atu, pe, pe a le o savali o loʻo i luga, e te vaʻai i lapisi faʻafuaseʻi e pei o mea o loʻo tuʻuina atu i lalo, o lau laupapa e ono faʻaaogaina se tioata 26 MHz. O le tele o fuafuaga a le komiti atina'e e fa'aaoga le 40 MHz, o lea e fa'aogaina ai e le ESP-IDF lenei fa'atuputeleina o se tau fa'aletonu.

Afai ei ai sou fa'afitauli fa'apea, fai mea nei: 1. Alu ese mai le mata'itu. 2. Toe fo'i ile menuconfig. 3. Alu ile Component config > Hardware Settings > Main XTAL Config > Main XTAL frequency, ona sui lea CONFIG_XTAL_FREQ_SEL i le 26 MHz. 4. A maeʻa lena, toe fausia ma toe moli le talosaga.
I le lomiga o loʻo iai nei o le ESP-IDF, o laina autu XTAL o loʻo lagolagoina e le ESP32 e faʻapea:
· 26 MHz · 40 MHz
Fa'aaliga: E mafai ona e tu'ufa'atasia le fale, moli ma mata'ituina i le la'asaga tasi e ala ile tamo'e: idf.py -p PORT flash monitor
Va'ai fo'i: · IDF Monitor mo ala 'alo fa'apitoa ma nisi fa'amatalaga i le fa'aogaina o le IDF monitor. · idf.py mo se faʻamatalaga atoa o idf.py poloaiga ma filifiliga.
Pau na mea e te manaʻomia e amata ai ile ESP32! O lea ua e sauni e fa'ata'ita'i se isi examples, pe alu sa'o e atia'e au lava talosaga.
Taua: O nisi o exampE le lagolagoina e le au le ESP32 ona o meafaigaluega mana'omia e le o aofia i le ESP32 o lea e le mafai ai ona lagolagoina. Afai e fausia se example, faamolemole siaki le README file mo le laulau Lagolago Sini. Afai o loʻo iai lenei mea e aofia ai le ESP32 faʻamoemoe, pe leai se laulau, o le exampe galue ile ESP32.
Fautuaga Faaopoopo
Fa'atagaga mataupu / dev / ttyUSB0 Faatasi ai ma nisi o tufatufaga Linux, e mafai ona e maua le Faile e tatala le taulaga / dev / ttyUSB0 savali sese pe a emo le ESP32. E mafai ona foia lenei mea e ala i le faʻaopoopoina o le tagata faʻaoga o loʻo i ai nei i le vaega faʻasalalau.
Python fetaui ESP-IDF lagolagoina le Python 3.7 poʻo le fou. E fautuaina e fa'aleleia lau faiga fa'aogaina i se fa'ata'ita'iga lata mai e fa'amalieina ai lenei mana'oga. O isi filifiliga e aofia ai le faʻapipiʻiina o le Python mai faʻapogai poʻo le faʻaogaina o le Python version management system e pei ole pyenv.
Amata i le Board Support Package Ina ia faatelevaveina le fa'ata'ita'iga i luga o nisi laupapa atina'e, e mafai ona e fa'aogaina le Board Support Packages (BSPs), lea e fa'afaigofie ai le fa'aulufaleina o se laupapa fa'apitoa e pei o ni nai telefoni fa'atino.

Espressif Systems

23 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata

E masani ona lagolagoina e le BSP vaega uma o meafaigaluega o loʻo tuʻuina atu ile laupapa atinaʻe. E ese mai i le faʻauigaina o le pinout ma galuega amata, o le BSP o loʻo vaʻavaʻai ma avetaʻavale mo vaega i fafo e pei o masini, faʻaaliga, codec leo ma isi. O BSP e tufatufaina e ala i le IDF Component Manager, ina ia mafai ona maua i le IDF Component Registry. Herens se example auala e fa'aopoopo ai le ESP-WROVER-KIT BSP i lau poloketi: idf.py add-dependency esp_wrover_kit
E sili atu exampole fa'aogaina ole BSP e mafai ona maua ile BSP examples faila.
Pepa Fa'atatau Mo tagata fa'apitoa e manana'o e fa'avasegaina le fa'apipi'i: · Fa'afouina mea faigaluega ESP-IDF i luga o Windows · Fa'atūina Feso'ota'iga Serial ma le ESP32 · Eclipse Plugin · VSCode Extension · IDF Monitor
Fa'afouina mea faigaluega ESP-IDF i Windows
Fa'apipi'i meafaigaluega ESP-IDF e fa'aaoga ai se tusitusiga Mai le Windows Command Prompt, sui i le fa'atonuga o lo'o fa'apipi'i ai le ESPIDF. Ona tamoe lea:
install.bat
Mo Powershell, sui i le lisi o loʻo faʻapipiʻi ai le ESP-IDF. Ona tamoe lea:
install.ps1
O le a la'u mai ma fa'apipi'i meafaigaluega e mana'omia e fa'aoga ai le ESP-IDF. Afai ua uma ona faʻapipiʻiina le faʻamatalaga patino o le meafaigaluega, e leai se gaioiga e faia. O meafaigaluega e sii mai ma faʻapipiʻi i totonu o se lisi faʻamaonia i le faagasologa o le ESP-IDF Tools Installer. Ona o le faaletonu, o le C:Usersusername.espressif.
Fa'aopoopo mea faigaluega ESP-IDF ile PATH e fa'aaoga ai se fa'amatalaga e auina atu i fafo ESP-IDF mea faigaluega fa'apipi'i e fau ai se ala 'Amata lisi mo le oESP-IDF Command Promptp. O lenei ala pupuu e tatalaina ai se faamalama Command Prompt lea ua uma ai meafaigaluega uma
avanoa. I nisi tulaga, atonu e te manaʻo e galue ma ESP-IDF i se faʻamalama Poloaiga Polokalama lea e leʻi amata faʻaaoga lena ala pupuu. Afai o le tulaga lea, mulimuli i faatonuga o loʻo i lalo e faʻaopoopo ai meafaigaluega ESP-IDF ile PATH. I le faʻatonuga vave lea e te manaʻomia e faʻaaoga ai le ESP-IDF, sui i le lisi o loʻo faʻapipiʻi ai le ESP-IDF, ona faʻatino lea o export.bat:
cd %userprofile%espesp-idf export.bat
I le isi itu i le Powershell lea e te manaʻomia e faʻaoga ai le ESP-IDF, sui i le lisi o loʻo faʻapipiʻi ai le ESP-IDF, ona faʻatino lea o le export.ps1:
cd ~/esp/esp-idf export.ps1
A maeʻa lenei mea, o le a maua meafaigaluega i lenei faʻatonuga vave.
Fa'atuina Feso'ota'iga Serial ma le ESP32 O lenei vaega o lo'o tu'uina atu ai le ta'iala ile fa'atuina o feso'ota'iga i le va o le ESP32 ma le PC.

Espressif Systems

24 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata
Faʻafesoʻotaʻi le ESP32 i le PC Faʻafesoʻotaʻi le laupapa ESP32 i le PC e faʻaaoga ai le USB cable. Afai e le otometi ona fa'apipi'i le aveta'avale, fa'ailoa le USB i le chip converter serial i luga o lau laupapa ESP32 (po'o le dongle liliu mai fafo), su'e ta'avale ile initaneti ma fa'apipi'i. O loʻo i lalo le lisi o meataalo USB i le faʻaliliuga faʻapipiʻi faʻapipiʻi i luga o le tele o laupapa ESP32 na gaosia e Espressif faʻatasi ai ma fesoʻotaʻiga i avetaavale:
· CP210x: CP210x USB i UART Bridge VCP Avetaavale · FTDI: FTDI Virtual COM Port Drivers Fa'amolemole siaki le ta'iala mo le fa'aogaina o le USB i le va'aiga fa'aliliu fa'asologa fa'aaoga. O avetaavale o loʻo i luga e masani lava mo faʻamatalaga. I lalo o tulaga masani, e tatau ona faʻapipiʻi avetaʻavale ma se faiga faʻaogaina ma faʻapipiʻi faʻapipiʻi pe a faʻafesoʻotaʻi le laupapa i le PC.
Siaki le taulaga ile Windows Siaki le lisi o pusa COM ua iloa ile Windows Device Manager. Aveese le ESP32 ma faʻafesoʻotaʻi i tua, e faʻamaonia po o fea uafu e mou atu mai le lisi ona toe faʻaalia lea. O ata o lo'o i lalo o lo'o fa'aalia ai le laina telefoni mo le ESP32 DevKitC ma le ESP32 WROVER KIT

Ata 13: USB i le UART alalaupapa o le ESP32-DevKitC i Windows Device Manager

Siaki le taulaga i luga o Linux ma macOS Ina ia siaki le igoa o le masini mo le laina telefoni o lau laupapa ESP32 (poʻo le faʻaliliuina fafo dongle), faʻatino lenei faʻatonuga faʻalua, muamua ma le laupapa / dongle e tatalaina, ona faʻapipiʻiina lea.
ls /dev/tty*
macOS

Espressif Systems

25 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata

Ata 14: E lua Taulaga Fa'asalalau USB o le ESP-WROVER-KIT ile Pupuni Pule Fa'atonu

Espressif Systems

26 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata

ls /dev/cu.* Fa'aaliga: tagata fa'aoga macOS: afai e te le va'ai i le port serial ona siaki lea o lo'o fa'apipi'iina oe ta'avale USB/serial. Va'ai le Vaega Feso'ota'i le ESP32 i le PC mo so'otaga i aveta'avale. Mo macOS High Sierra (10.13), atonu e te manaʻomia foʻi le faʻatagaina manino o avetaavale e uta. Tatala System Preferences -> Security & Privacy -> General ma siaki pe o iai se feʻau o loʻo faʻaalia iinei e uiga i le oSystem Software mai le atiaʻe lplea o le igoa o le tagata e faia le Silicon Labs poʻo le FTDI.

Fa'aopoopo le tagata fa'aoga e fa'afeso'ota'i i luga o Linux O le tagata fa'aoga o lo'o fa'aigoaina nei e tatau ona faitau ma tusitusi le avanoa i luga o le USB. I le tele o faʻasalalauga Linux, e faia lenei mea e ala i le faʻaopoopoina o le tagata faʻaoga i le faʻasalalauga faʻatasi ma le faʻatonuga lea:
sudo usermod -a -G dialout $USER
i luga o Arch Linux e faia lenei mea e ala i le faʻaopoopoina o le tagata faʻaoga i le uucp vaega ma le poloaiga lenei:
sudo usermod -a -G uucp $USER
Ia mautinoa e te toe saini ina ia mafai ai ona faitau ma tusi faatagaga mo le laina telefoni.
Fa'amaonia le feso'ota'iga fa'asologa Fa'amaonia nei o lo'o fa'agaioi le so'oga fa'asologa. E mafai ona e faia lenei mea e ala i le fa'aogaina o se polokalame fa'asologa fa'asologa e ala i le siakiina pe e te maua se mea e maua i luga o le laina pe a uma ona toe setiina le ESP32. Ole fua ole fa'amafanafanaga fa'aleaogaina ile ESP32 ole 115200.
Windows ma Linux I lenei exampmatou te fa'aogaina le PuTTY SSH Client o lo'o avanoa mo Windows ma Linux. E mafai ona e fa'aogaina isi polokalame fa'asologa ma fa'atulaga laina feso'ota'iga pei o lalo. Fa'asolo le laina fa'amau ma fa'atulaga uafu fa'asologa fa'ailoa. Baud rate = 115200 (pe a manaʻomia, sui le mea lea i le faaletonu o le paʻu fua o le pu o loʻo faʻaaogaina), faʻamaumauga o faʻamaumauga = 8, taofi paʻu = 1, ma le paʻu = N. Lalo o example faʻamalama o le setiina o le taulaga ma ia faʻasalalauga faʻasalalau (i se faapuupuuga faʻamatalaina o le 115200-8-1-N) i luga o Windows ma Linux. Manatua e filifili tonu lava le laina laina tutusa na e faailoaina i laasaga i luga. Ona tatala lea o le port serial i le terminal ma siaki, pe a e vaʻai i soʻo se ogalaau o loʻo lolomiina e ESP32. O mea o loʻo i totonu o le ogalaau o le a faʻalagolago i le talosaga e utaina i le ESP32, vaʻai Example Galuega Fa'atino.
Manatua: Tapuni le laina laina pe a uma ona faʻamaonia o loʻo galue fesoʻotaʻiga. Afai e te fa'aauau pea ona tatala le fa'asalalauga, o le a le mafai ona maua le laina telefoni mo le tu'uina atu o firmware mulimuli ane.

macOS Ina ia faʻasaoina oe mai le faʻalavelave o le faʻapipiʻiina o se polokalame faʻapipiʻi laina, macOS e ofoina atu le faʻatonuga o le mata. · E pei ona talanoaina i le Siaki uafu i Linux ma macOS, tamoe:

ls /dev/cu.* · E tatau ona e va'ai i galuega fa'atusa:

/dev/cu.Bluetooth-Incoming-Port /dev/cu.SLAB_USBtoUART USBtoUART7

/dev/cu.SLAB_

· O le gaioiga e eseese e faʻatatau i le ituaiga ma le numera o laupapa e fesoʻotaʻi i lau PC. Ona filifili lea o le igoa o le masini o lau laupapa ma tamoe (pe a manaʻomia, sui o115200 i le faʻaogaina o le fua o le pu o loʻo faʻaaogaina):

mata /dev/cu.device_name 115200 Sui device_name i le igoa o lo'o maua ls /dev/cu.*.

Espressif Systems

27 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata

Ata 15: Fa'atulagaina Feso'ota'iga Fa'asalalau ile PuTTY ile Windows

Espressif Systems

28 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata

Ata 16: Fa'atulagaina Feso'ota'iga Fa'asalalau ile PuTTY ile Linux

Espressif Systems

29 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata
· O le mea o loʻo e suʻeina o ni ogalaau o loʻo faʻaalia e le lau. O mea o loʻo i totonu o le ogalaau o le a faʻalagolago i le talosaga e utaina i le ESP32, vaʻai Example Galuega Fa'atino. Ina ia alu ese mai le faʻasalalauga faʻataʻitaʻiga faʻaoga Ctrl-A + .
Manatua: Aua nei galo e alu ese mai le vasega screen pe a uma ona faʻamaonia o loʻo galue le fesoʻotaʻiga. Afai e te le faia ma na o le tapunia o le faʻamalama faʻamalama, o le a le mafai ona faʻaogaina le port serial mo le faʻapipiʻiina o firmware mulimuli ane.
Example Galuega Fa'atinoample ogalaau o loʻo faʻaalia i lalo. Toe setiina le laupapa pe a e le iloa se mea. ma Iuni 8 2016 00:22:57
muamua:0x5 (DEEPSLEEP_RESET),fa'a:0x13 (SPI_FAST_FLASH_BOOT) ets Jun 8 2016 00:22:57
rst:0x7 (TG0WDT_SYS_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT) configsip: 0, SPIWP:0x00 clk_drv:0x00,q_drv:0x00,d_drv:0x00,cs0_drv:0x00,hd_drv:0x00,wp_drv:0x00 mode:DIO, clock div:2 load:0x3fff0008,len:8 load:0x3fff0010,len:3464 load:0x40078000,len:7828 load:0x40080000,len:252 entry 0x40080034 I (44) boot: ESP-IDF v2.0-rc1-401-gf9fba35 2nd stage bootloader I (45) boot: taimi faʻapipiʻi 18:48:10
…
Afai e mafai ona e vaʻaia le faʻaogaina o le log, o lona uiga o loʻo galue le fesoʻotaʻiga ma ua e sauni e faʻaauau le faʻapipiʻiina ma mulimuli ane tuʻuina atu le talosaga ile ESP32.
Fa'aaliga: Mo nisi fetuutuunaiga o uaea tau telefoni, o pine RTS & DTR e mana'omia ona fa'aletonu i le polokalame fa'amau a'o le'i fa'aa'e le ESP32 ma maua mai ai le fa'asologa. E fa'alagolago lea i meafaigaluega lava ia, o le tele o laupapa atina'e (e aofia uma ai laupapa Espressif) e leai se fa'afitauli. O lo'o iai le fa'afitauli pe a fa'apipi'i sa'o le RTS & DTR i pine EN & GPIO0. Va'ai le esptool pepa mo nisi fa'amatalaga.
Afai na e sau iinei mai le Laasaga 5. Laasaga Muamua ile ESP-IDF pe a faʻapipiʻi s / w mo le atinaʻe ESP32, ona mafai lea ona e faʻaauau le Laasaga 5. Laasaga Muamua ile ESP-IDF.
IDF Mata'ituina IDF Mata'ituina o le tele lava o se polokalame fa'amaufa'ailoga e fa'asalalauina fa'amaumauga fa'asologa i ma mai le tau fa'asologa o masini. O lo'o tu'uina atu ai fo'i nisi o vaega fa'apitoa a le IDF. IDF Monitor e mafai ona faʻalauiloa mai se poloketi IDF e ala i le faʻaogaina o le idf.py monitor.
Pisinisi Pu'upu Mo feso'ota'iga faigofie ma le IDF Monitor, fa'aoga ala pupuu keyboard o lo'o tu'uina atu i le laulau.

Espressif Systems

30 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata

Laupapa Laupapa Ctrl+] Ctrl+T
· Ctrl+T
· Ctrl+] · Ctrl+P
· Ctrl+R
· Ctrl+F
· Ctrl+A (poʻo le A)
· Ctrl+Y
· Ctrl+L
· Ctrl+I (po o le I)
· Ctrl+H (poo H)
· Ctrl+X (poʻo X)
Ctrl+C

Gaioiga

Fa'amatalaga

Tu'u ese mai le polokalame Menu escape ki Auina atu le uiga o le lisi lava ia i le mamao
Auina atu le tagata e alu i fafo i le mamao
Toe seti le sini i totonu o le bootloader e taofi le app e ala i le laina RTS
Toe setiina le laupapa sini e ala i le RTS
Fausia ma moli le poloketi

Fausia ma moli le app na'o

Taofi/faaauau le lomitusi o ogalaau i luga ole lau

Taofi/faaauau le ogalaau sau i file

Taofi/faaauau taimiamps

lomitusi

Fa'aali uma ala pupuu keyboard

Oomi ma mulimuli i se tasi o ki o loʻo tuʻuina atu i lalo.
Toe setiina le sini, i totonu o le bootloader e ala i le laina RTS (pe a fesoʻotaʻi), ina ia leai se mea e taʻavale ai le laupapa. Fa'aoga pe a mana'omia le fa'atali mo se isi masini e amata. Toe setiina le laupapa sini ma toe amata le talosaga e ala i le laina RTS (pe a fesoʻotaʻi).
Taofi le idf_monitor e fa'agasolo ai le fa'amoemoe o le poloketi, ona toe fa'aauau lea idf_monitor. So'o se puna ua suia files ua toe tuufaatasia ona toe moli. Fa'ailoga fa'ailoga fa'ailoga e fa'atautaia pe a amata idf_monitor i le finauga -E. Taofi le idf_monitor e fa'agasolo ai le app-flash target, ona toe amata lea idf_monitor. E tutusa ma le taulaiga moli, ae na o le autu autu e fausia ma toe moli. O lo'o fa'atautaia le fa'ailoga fa'ailoga-app-flash pe afai na amata le idf_monitor i le finauga -E. Fa'ate'a uma fa'amaumauga fa'asologa o lo'o o'o mai a'o fa'agaoioia. Fa'ataga fa'atopetope ma su'esu'e le ogala'au galuega e aunoa ma le tu'ua o le mata'itū. Fausia a file i totonu o le lisi o poloketi ma o le gaioiga o loʻo tusia i lena file se'ia o'o ina fa'aletonu le ala lea e tasi (po'o le IDF Monitor outs). E mafai e le IDF Monitor ona lolomi se taimiamp i le amataga o laina taitasi. Le taimiamp e mafai ona suia le faatulagaga i le –timestamp-fa'atulagaina o finauga laina fa'atonu.

Tu'u ese mai le polokalame

Faʻalavelave le faʻaogaina o le talosaga

Taofi le IDF Monitor ma fa'agaoioi le GDB project debugger e fa'apolopolo le talosaga ile taimi fa'agasolo. E mana'omia le :ref:CONFIG_ESP_SYSTEM_GDBSTUB_RUNTIME filifiliga e mafai.

So'o se ki e oomi, e ese mai le Ctrl-] ma le Ctrl-T, o le a lafo i le laina telefoni.

Fa'ailoga fa'apitoa a le IDF

Otometi le Fa'aliliuina o le Tuatusi Soo se taimi lava e maua mai ai e le ESP-IDF se tuatusi fa'ailoga hexadecimal o le fomu 0x4_______, e fa'aaoga e le IDF Monitor addr2line_ e su'e ai le nofoaga i le source code ma su'e le igoa o galuega.
Afai e pa'u ma fa'alavelave se ESP-IDF app, e faia se tusi resitala e lafoa'i ma fa'asologa i tua, e pei o mea nei:

Espressif Systems

31 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata

Guru Meditation Error of type StoreProhibited occurred on core 0. Exception was

le taulimaina.

Resitala lafoa'i:

: 0x400f360d PS

: 0x00060330 A0

: 0x800dbf56 A1

0x3ffb7e00

: 0x3ffb136c A3

: 0x00000005 A4

: 0x00000000 A5

0x00000000

: 0x00000000 A7

: 0x00000080 A8

: 0x00000000 A9

0x3ffb7dd0

A10

: 0x00000003 A11

: 0x00060f23 A12

: 0x00060f20 A13

0x3ffba6d0

A14

: 0x00000047 A15

: 0x0000000f SAR

: 0x00000019 ALOFA:

0x0000001d

EXCVADDR: 0x00000000 LBEG : 0x4000c46c FA'ATAU : 0x4000c477 LUA :

0x00000000

Backtrace: 0x400f360d:0x3ffb7e00 0x400dbf56:0x3ffb7e20 0x400dbf5e:0x3ffb7e40 0x400dbf82:0x3ffb7e60 0x400d071d:0x3ffb7e90

E fa'aopoopo e le IDF Monitor nisi fa'amatalaga i le lapisi:

Guru Meditation Error of type StoreProhibited occurred on core 0. Exception was

le taulimaina.

Resitala lafoa'i:

: 0x400f360d PS

: 0x00060330 A0

: 0x800dbf56 A1

0x3ffb7e00

0x400f360d: fai_something_to_crash i /home/gus/esp/32/idf/examples/amataina/

hello_world/main/./hello_world_main.c:57

(fa'asinoina e) inner_dont_crash i /home/gus/esp/32/idf/examples/amataina/hello_

lalolagi/autu/./hello_world_main.c:52

: 0x3ffb136c A3

: 0x00000005 A4

: 0x00000000 A5

0x00000000

: 0x00000000 A7

: 0x00000080 A8

: 0x00000000 A9

0x3ffb7dd0

A10

: 0x00000003 A11

: 0x00060f23 A12

: 0x00060f20 A13

0x3ffba6d0

A14

: 0x00000047 A15

: 0x0000000f SAR

: 0x00000019 ALOFA:

0x0000001d

EXCVADDR: 0x00000000 LBEG : 0x4000c46c FA'ATAU : 0x4000c477 LUA :

0x00000000

Backtrace: 0x400f360d:0x3ffb7e00 0x400dbf56:0x3ffb7e20 0x400dbf5e:0x3ffb7e40 0x400dbf82:0x3ffb7e60 0x400d071d:0x3ffb7e90 0x400f360d: do_something_to_crash at /home/gus/esp/32/idf/examples/get-started/ hello_world/main/./hello_world_main.c:57 (i totonu o) inner_dont_crash i /home/gus/esp/32/idf/examples/get-started/hello_ world/main/./hello_world_main.c:52 0x400dbf56: still_dont_crash at /home/gus/esp/32/idf/examples/get-started/hello_ world/main/./hello_world_main.c:47 0x400dbf5e: dont_crash at /home/gus/esp/32/idf/examples/get-started/hello_world/ main/./hello_world_main.c:42 0x400dbf82: app_main i /home/gus/esp/32/idf/examples/get-started/hello_world/main/ ./hello_world_main.c:33 0x400d071d: main_task i /home/gus/esp/32/idf/components/esp32/./cpu_start.c:254

Ina ia fa'avasega tuatusi ta'itasi, e fa'atino e le IDF Monitor le fa'atonuga lea i tua: xtensa-esp32-elf-addr2line -pfiaC -e build/PROJECT.elf ADDRESS

Fa'aaliga: Seti le suiga ole siosiomaga ESP_MONITOR_DECODE ile 0 pe vala'au ile idf_monitor.py ile laina ole fa'atonuga.

Espressif Systems

32 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata
filifiliga: idf_monitor.py –disable-address-decoding e faʻamalo ai le faʻavasegaina o tuatusi.
Toe Toe Fua'i ile So'oga I le fa'aletonu, ole a toe setiina e le IDF Monitor le sini pe a fa'afeso'ota'i i ai. O le toe setiina o le atigipusa sini e faia i le faʻaaogaina o laina laina DTR ma RTS. Ina ia puipuia le IDF Monitor mai le toe setiina otometi le taulaʻi i luga o le fesoʻotaʻiga, valaʻau le IDF Monitor ma le filifiliga -no-reset (faʻataʻitaʻiga, idf_monitor.py –no-reset).
Fa'aaliga: O le filifiliga –no-reset e fa'aoga tutusa le amio tusa lava pe fa'afeso'ota'i le IDF Monitor i se uafu fa'apitoa (fa'ata'ita'iga, idf.py monitor –no-reset -p [PORT]).
Fa'ailoaina o le GDB ma le GDBStub GDBStub ose fa'aoga fa'aoga fa'aoga ta'avale e tamo'e i luga o le taula'iga ma feso'ota'i atu i le tagata talimalo i luga o le uafu fa'asologa e maua ai fa'atonuga fa'aletonu. E lagolagoina e le GDBStub tulafono e pei o le faitau manatua ma fesuiaiga, suʻesuʻeina o faʻapipiʻi telefoni ma isi. E ui o le GDBStub e itiiti le atamai nai lo JTAG debugging, e le manaʻomia ni meafaigaluega faʻapitoa (e pei o le JTAG i le alalaupapa USB) e pei ona faia uma fesootaiga i luga o le uafu serial. E mafai ona fa'atulaga se fa'amoemoe e fa'agasolo ai le GDBStub i tua e ala i le fa'atulagaina o le CONFIG_ESP_SYSTEM_PANIC i le GDBStub i le taimi fa'atino. GDBStub o le a tamoʻe i tua seʻia tuʻuina atu se feʻau Ctrl + C i luga o le laina telefoni ma mafua ai ona malepe le GDBStub (ie, taofi le faʻatinoina o) le polokalama, ma faʻatagaina GDBStub e faʻatautaia le faʻaogaina o poloaiga. E le gata i lea, e mafai ona faʻatulagaina le faʻalavelave faʻalavelave e taʻavale GDBStub i luga o se faʻalavelave e ala i le setiina o le CONFIG_ESP_SYSTEM_PANIC i le GDBStub i luga o le fefe. A tupu se faʻalavelave, GDBStub o le a tuʻuina atu se mamanu manoa faʻapitoa i luga o le laina telefoni e faʻaalia ai o loʻo tamoe. I tulaga uma e lua (e pei o le auina atu o le Ctrl + C feʻau, poʻo le mauaina o le mamanu manoa faʻapitoa), IDF Monitor o le a otometi lava ona faʻalauiloa le GDB ina ia mafai ai e le tagata faʻaoga ona tuʻuina atu faʻatonuga faʻapipiʻi. A maeʻa ona alu ese le GDB, e toe setiina le sini e ala i le laina laina RTS. Afai e le o feso'ota'i le laina lea, e mafai e tagata fa'aoga ona toe setiina a latou sini (e ala i le oomiina o le laupapa Reset button).
Manatua: I tua, IDF Monitor o loʻo faʻatautaia le poloaiga lenei e faʻalauiloa ai le GDB:
xtensa-esp32-elf-gdb -ex “set serial baud BAUD” -ex “target mamao PORT” -ex interrupt build/PROJECT.elf :idf_target:`Talofa NAME chip`

Fuafuaga Fuafuaga IDF mataitu e mafai ona faʻaogaina e pei o idf.py mataitu –print-filter=”xyz”, lea –print-filter o le parakalafa mo le faamamaina o galuega. O le tau fa'aletonu o se manoa gaogao, o lona uiga o mea uma e lolomi.
O tapula'a i mea e lolomi e mafai ona fa'amaoti o se faasologa otag>: mea i featag> o le tag manoa ma o se uiga mai le seti {N, E, W, I, D, V, *} e faasino i se tulaga mo le taina.
Mo example, PRINT_FILTER=”tag1:W” e fetaui ma lolomi na'o galuega faatino na tusia ile ESP_LOGW(“tag1", ...) po'o le fa'aupuga maualalo, e pei o le ESP_LOGE("tag1″, …). Le fa'ama'oti a po'o le fa'aogaina o * fa'aletonu i le tulaga Verbose.
Fa'aaliga: Fa'aaoga le fa'amaufa'ailoga muamua e fa'agata ai i le tu'ufa'atasiga o galuega e te le mana'omia e ala i le faletusi talatala. O le faʻamamaina o mea e faʻaogaina ai le mataʻituina o le IDF o se fofo lona lua lea e mafai ona aoga mo le fetuunaiga o filifiliga e aunoa ma le toe faʻapipiʻiina o le talosaga.
Lau app tags e le tatau ona iai avanoa, fetu *, po'o koluma : ina ia fetaui ma le vaega e fa'amama ai galuega.
Afai o le laina mulimuli o le gaioiga i lau app e le mulimulitaʻia e le toe foʻi mai o le taavale, e ono fenumiai le faʻamamaina o galuega, o lona uiga, e amata ona lolomi e le mataʻitusi le laina ma mulimuli ane iloa e le tatau ona tusia le laina. Ose fa'afitauli ua iloa ma e mafai ona 'alofia e ala i le fa'aopoopo i taimi uma o le fa'afo'i mai o le ta'avale (aemaise pe a leai se mea fa'atino e mulimuli mai mulimuli ane).

Espressif Systems

33 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata
Examptulafono o le Filifiliga:
· * e mafai ona faʻaoga e faʻafetaui soʻo se mea tags. Peitai, ole manoa PRINT_FILTER=”*:I tag1:E” e tusa ai ma tag1 lolomi na o mea sese, ona o le tulafono mo tag1 e maualuga lona fa'amuamua nai lo le tulafono mo *.
· Ole tulafono fa'aletonu (gaogao) e tutusa ma *:V aua e tutusa uma tag i le Verbose level po'o lalo ifo o lona uiga e fetaui ma mea uma.
· “*:N” e taofiofia e le gata i mea e maua mai i galuega fa'amau, ae fa'apea fo'i ma lolomi na faia e le printf, ma isi. Ina ia 'alofia lenei mea, fa'aaoga le *:E po'o le maualuga o le verbosity level.
· Tulafono “tag1:V”, “tag1:v”, “tag1:”, “tag1:*”, ma le “tag1” e tutusa. · Tulafono “tag1:W tag1:E” e tutusa ma le “tag1:E” ona o soʻo se taunuuga o le mea lava e tasi tag
igoa e sui ai le igoa muamua. · Tulafono “tag1:I tag2:W” na o lomitusi tag1 ile fa'amatalaga verbosity level po'o lalo ifo ma tag2 i le Lapataiga
tulaga tautala po'o lalo ifo. · Tulafono “tag1:I tag2:W tag3:N” e tutusa lelei ma le muamua ona tag3:N faʻamaonia
lena tag3 e le tatau ona lolomi. · tag3:N i le tulafono "tag1:I tag2:W tag3:N *:V” e sili atu ona anoa aua a leai tag3:N le
tag3 fe'au na mafai ona lolomi; o mea sese mo tag1 ma tag2 o le a lolomi i le tulaga faʻamaonia (pe maualalo) verbosity level ma isi mea uma o le a lolomi e ala i le faaletonu.
Ose Fa'asili Faigata Example O lo'o i lalo snippet ogalaau na maua e aunoa ma se filifiliga filifiliga:
uta:0x40078000,len:13564 ulufale 0x40078d4c E (31) esp_image: ata i le 0x30000 ua le aoga byte faamaneta W (31) esp_image: ata i le 0x30000 ua faaletonu le SPI mode 255 E (39) boot (568) boot. cpu_start: Pro cpu i luga. I (569) heap_init: Initializing. RAM avanoa mo vaevaega malosi: I (603) cpu_start: Pro cpu amata user code D (309) light_driver: [light_init, 74]: tulaga: 1, mode: 2 D (318) vfs: esp_vfs_register_fd_range ua manuia mo le tele <54; 64) ma le VFS ID 1 I (328) wifi: galuega aveta'avale wifi: 3ffdbf84, muamua:23, faaputuga:4096, autu = 0
O le gaioiga na pu'eina mo filifiliga filiga PRINT_FILTER = "wifi esp_image:E light_driver:I" o loʻo tuʻuina atu i lalo:
E (31) esp_image: ata i le 0x30000 o loʻo i ai le faʻaogaina o le togafiti faʻataulāitu I (328) wifi: galuega avetaʻavale wifi: 3ffdbf84, muamua:23, faaputuga:4096, autu = 0
O filifiliga "PRINT_FILTER ="light_driver:D esp_image:N boot:N cpu_start:N vfs:N wifi:N *:V" faʻaalia le gaioiga lea:
uta:0x40078000,len:13564 ulufale 0x40078d4c I (569) heap_init: Initializing. RAM avanoa mo le vaevaega malosi: D (309) light_driver: [light_init, 74]: tulaga: 1, mode: 2
Fa'afitauli iloga ile IDF Monitor
Fa'afitauli Mata'ituina ile Windows
· Arrow ki, faʻapea foʻi ma isi ki, e le aoga i le GDB ona o faʻatapulaʻa Windows Console. · Mai lea taimi i lea taimi, pe a oidf.pypexits, e ono taofi mo le 30 sekone a'o le'i toe amata le IDF Monitor. · A tamo'e ogdbpis, e ono taofi mo sina taimi a'o le'i amata ona feso'ota'i ma le GDBStub.

Espressif Systems

34 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Vaega 1. Amata le Seti o Meafaigaluega Fa'atonu mo Linux ma macOS

Fa'apipi'i La'asaga ma lea La'asaga Ose fa'afanua fa'ata'ita'i au'ili'ili lea e savalia oe ile faiga fa'apipi'i.
Fa'atulagaina o le Siosiomaga o Atina'e O laasaga nei mo le fa'atulagaina o le ESP-IDF mo lau ESP32. · Laasaga 1. Faʻapipiʻi mea e manaʻomia muamua · Laasaga 2. Maua le ESP-IDF · Laasaga 3. Seti meafaigaluega · Laasaga 4. Seti suiga o le siosiomaga · Laasaga 5. Laasaga Muamua ile ESP-IDF
Laasaga 1. Fa'apipi'i mea e mana'omia muamua Ina ia fa'aogaina le ESP-IDF ma le ESP32, e te mana'omia le fa'apipi'iina o ni pusa fa'akomepiuta e fa'atatau i lau Operating System. O lenei taʻiala faʻatulagaina o le a fesoasoani ia te oe i le faʻapipiʻiina o mea uma ile Linux ma macOS faʻavae faiga.
Mo Linux Users Ina ia faʻapipiʻi faʻaaoga le ESP-IDF e te manaʻomia le mauaina o afifi nei. O le poloaiga e tamoe e faʻalagolago i le tufatufaina o Linux o loʻo e faʻaogaina:
· Ubuntu ma Debian: sudo apt-get install git wget flex bison gperf python3 python3-pip python3venv cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0
· CentOS 7 & 8: sudo yum -y fa'afouga && sudo yum fa'apipi'i git wget flex bison gperf python3 cmake ninja-fausia ccache dfu-util libusbx
CentOS 7 o loʻo lagolagoina pea ae o le CentOS version 8 ua fautuaina mo se faʻaoga sili atu. · Arch: sudo pacman -S –mana'omia gcc git fai flex bison gperf python cmake ninja ccache dfu-util libusb
Manatua: · CMake version 3.16 po'o le fou e mana'omia mo le fa'aoga ma le ESP-IDF. Fa'asolo otools/idf_tools.py fa'apipi'i cmakepto fa'apipi'i se fa'ata'ita'iga talafeagai pe afai e leai se fa'aliliuga o lau OS. · Afai e te le vaʻai i lau faʻasalalauga Linux i le lisi o loʻo i luga, faʻamolemole siaki ana faʻamaumauga e suʻe ai poʻo fea poloaiga e faʻaoga mo le faʻapipiʻiina o afifi.
Mo macOS Tagata faʻaoga ESP-IDF o le a faʻaogaina le faʻaogaina o le Python faʻapipiʻiina e ala ile macOS. · Fa'apipi'i le CMake & Ninja fausia: Afai e iai sau HomeBrew, e mafai ona e tamo'e: brew install cmake ninja dfu-util Afai e iai sau MacPorts, e mafai ona e tamo'e: sudo port install cmake ninja dfu-util A leai, fa'afeso'ota'i le CMake ma Ninja itulau o le fale mo macOS fa'apipi'i download.

Espressif Systems

35 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata
· E matua fautuaina e faʻapipiʻi foi le ccache mo le fausiaina vave. Afai ei ai sau HomeBrew, e mafai ona faia lenei mea e ala ile brew install ccache poʻo sudo port install ccache i MacPorts.
Manatua: Afai e faʻaalia se mea sese faʻapenei i soʻo se laasaga: xcrun: mea sese: le aoga le atinaʻe ala (/Library/Developer/CommandLineTools), misi xcrun i: /Library/Developer/CommandLineTools/usr/bin/xcrun
Ona e manaʻomia lea e faʻapipiʻi meafaigaluega laina laina XCode e faʻaauau ai. E mafai ona e faʻapipiʻi nei mea e ala i le taʻavale xcode-select -install.
Apple M1 Users Afai e te faʻaogaina le Apple M1 platform ma vaʻai i se mea sese e pei o lenei: LAPATAʻIGA: faʻatonuga mo meafaigaluega xtensa-esp32-elf version esp-2021r2-patch3-8.4.0 o loʻo i ai, ae e leʻi maua le meafaigaluega ERROR: meafaigaluega xtensa-esp32-elf e leai ni faʻapipiʻiina. Fa'amolemole tamo'e 'install.sh' e fa'apipi'i ai.
po'o le: zsh: leaga ituaiga PPU i le fa'atinoina: ~/.espressif/tools/xtensa-esp32-elf/esp-2021r2patch3-8.4.0/xtensa-esp32-elf/bin/xtensa-esp32-elf-gcc
Ona e manaʻomia lea e faʻapipiʻi Apple Rosetta 2 e ala i le tamoe /usr/sbin/softwareupdate –install-rosetta –agree-to-license
Fa'apipi'i le Python 3 Fa'avae ile macOS Catalina 10.15 fa'asalalauga fa'amatalaga, fa'aoga ole Python 2.7 e le fautuaina ma ole Python 2.7 o le a le fa'aofiina e ala ile fa'aletonu ile fa'asologa o macOS i le lumana'i. Siaki le Python o loʻo ia te oe i le taimi nei: python -version
Afai o le gaioiga e pei o le Python 2.7.17, o lau fa'aliliuupu le lelei o le Python 2.7. Afai o lea, siaki foi pe o le Python 3 e leʻi faʻapipiʻiina i lau komepiuta: python3 -version
Afai o le poloaiga o loʻo i luga e toe faʻafoʻi mai se mea sese, o lona uiga e le faʻapipiʻi le Python 3. O loʻo i lalo se faʻamatalagaview o laasaga e faʻapipiʻi ai le Python 3.
· Fa'apipi'i ma le HomeBrew e mafai ona fa'apea: brew install python3
· Afai e iai sau MacPorts, e mafai ona e tamoe: sudo port install python38
Laasaga 2. Maua le ESP-IDF Ina ia fausia ni tusi talosaga mo le ESP32, e te mana'omia le faletusi faakomepiuta na saunia e Espressif i le fale teu oloa ESP-IDF. Ina ia maua le ESP-IDF, faʻafeiloaʻi i lau lisi faʻapipiʻi ma faʻapipiʻi le fale teu oloa i le git clone, mulimuli i faʻatonuga o loʻo i lalo faʻapitoa i lau faiga faʻaogaina. Tatala le Terminal, ma taʻavale tulafono nei:

Espressif Systems

36 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata

mkdir -p ~/esp cd ~/esp git clone -b v5.0.9 –recursive https://github.com/espressif/esp-idf.git
ESP-IDF o le a la'u mai i totonu ~/esp/esp-idf. Fa'afeso'ota'i Fa'aliliuga ESP-IDF mo fa'amatalaga po'o fea le fa'aliliuga ESP-IDF e fa'aoga i se tulaga.
Laasaga 3. Faʻatulaga meafaigaluega E ese mai le ESP-IDF, e te manaʻomia foʻi le faʻapipiʻiina o meafaigaluega e faʻaaogaina e le ESP-IDF, e pei o le tuʻufaʻatasia, debugger, Python packages, ma isi, mo galuega faatino e lagolagoina ai le ESP32. cd ~/esp/esp-idf ./install.sh esp32
po'o le atigi i'a cd ~/esp/esp-idf ./install.fish esp32
O tulafono o loʻo i luga faʻapipiʻi meafaigaluega mo ESP32 naʻo. Afai e te mana'o e atia'e ni poloketi mo nisi fa'amoemoega chip, e tatau ona e lisiina uma ma tamo'e mo fa'atasiample: cd ~/esp/esp-idf ./install.sh esp32,esp32s2
pe fa'atasi ai ma atigi i'a cd ~/esp/esp-idf ./install.fish esp32,esp32s2
Ina ia faʻapipiʻi meafaigaluega mo sini lagolago uma faʻamolemole faʻatautaia le poloaiga lenei: cd ~/esp/esp-idf ./install.sh all
po'o le atigi i'a cd ~/esp/esp-idf ./install.fish all
Manatua: Mo tagata faʻaoga macOS, pe a faʻaalia se mea sese i soʻo se laasaga:urlfa'aletonu tatala [SSL: CERTIFICATE_VERIFY_FAILED] fa'amaonia le fa'amaonia ua le manuia: le mafai ona maua le tusipasi fa'alotoifale (_ssl.c:xxx)
E mafai ona e tamoʻe le Install Certificates.command i le Python folder o lau komepiuta e faʻapipiʻi ai tusi faamaonia. Mo faʻamatalaga, vaʻai i lalo o le Faʻasalaga Aʻo Faʻapipiʻi Meafaigaluega ESP-IDF.

Su'ega File La'uina E la'u mai e le tagata fa'apipi'i meafaigaluega se numera o files fa'apipi'i i GitHub Releases. Afai e telegese le mauaina o le GitHub ona mafai lea ona seti se fesuiaiga o le siosiomaga e sili atu ai le espressifns download server mo GitHub asset downloads.

Manatua: O lenei faʻatulagaga e naʻo le pulea o meafaigaluega taʻitasi na sii mai GitHub faʻasalalauga, e le suia ai le URLs faʻaaoga e faʻaoga ai soʻo se faleoloa Git.

Ina ia fiafia i le Espressif download server pe a faʻapipiʻi meafaigaluega, faʻaoga le faʻasologa o poloaiga pe a taʻavale install.sh:

Espressif Systems

37 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata

cd ~/esp/esp-idf export IDF_GITHUB_ASSETS=”dl.espressif.com/github_assets” ./install.sh
Fa'asinomaga le ala fa'apipi'i meafaigaluega O fa'amaumauga na fa'ailoa mai i lenei la'asaga fa'apipi'i meafaigaluega tu'ufa'atasi e mana'omia e le ESP-IDF i totonu o le fa'atonuga o le fale fa'aoga: $HOME/.espressif on Linux. Afai e te mana'o e fa'apipi'i meafaigaluega i se isi fa'atonuga, fa'atulaga le suiga ole si'osi'omaga IDF_TOOLS_PATH a'o le'i fa'agasolo le fa'apipi'i tusitusiga. Ia mautinoa o lo'o lava fa'atagaga o lau fa'amatalaga fa'aoga e faitau ma tusi ai lenei ala. Afai e suia le IDF_TOOLS_PATH, ia mautinoa e seti i le tau tutusa i taimi uma e faʻapipiʻi ai le faʻapipiʻi (install. bat, install.ps1 or install.sh) ma le Export script (export.bat, export.ps1 poʻo export.sh).
Laasaga 4. Seti le fesuiaiga o le siosiomaga O meafaigaluega faʻapipiʻi e leʻi faʻaopoopoina i le PATH environment variable. Ina ia faʻaaogaina meafaigaluega mai le laina faʻatonu, e tatau ona setiina nisi o fesuiaiga o le siosiomaga. ESP-IDF o loʻo tuʻuina atu se isi tusitusiga e faia lena mea. I le laina o loʻo e faʻaogaina ai le ESP-IDF, tamoʻe:
. $HOME/esp/esp-idf/export.sh
po'o mo i'a (na'o le lagolagoina talu mai le i'a version 3.0.0):
. $HOME/esp/esp-idf/export.fish
Matau le avanoa i le va o le togi ma le ala! Afai e te fuafua e faʻaaoga soo le esp-idf, e mafai ona e fatuina se igoa mo le faʻatinoina o export.sh:
1. Kopi ma faapipii le poloaiga lenei i lau shellns profile (.profile, .bashrc, .zprofile, ma isi)
alias get_idf='. $HOME/esp/esp-idf/export.sh' 2. Toe fa'afou le fa'atulagaga e ala i le toe amataina o le sauniga fa'amau po'o le fa'agaioia puna [path to profile],
mo example, puna ~/.bashrc. Ole taimi nei e mafai ona e tamo'e get_idf e fa'atutu pe fa'afou le siosiomaga esp-idf i so'o se taimi fa'agata. Fa'apitoa, e mafai ona e fa'aopoopo export.sh i lau shellns profile tuusao; ae peitai, e le fautuaina. O le faia o lea mea e fa'aagaoioia ai le IDF virtual environment i so'o se sauniga fa'ato'aga (e aofia ai ma mea e le mana'omia ai le IDF), fa'ato'ilaloina le fa'amoemoega o le si'osi'omaga fa'apitoa ma e ono a'afia ai isi polokalame.
Laasaga 5. Laasaga Muamua ile ESP-IDF I le taimi nei talu ai ua ausia uma mana'oga, o le isi autu o le a ta'ita'ia oe ile auala e amata ai lau galuega muamua. O le a fesoasoani lenei ta'iala ia te oe ile laasaga muamua ile fa'aogaina ole ESP-IDF. Mulimuli i lenei taʻiala e amata ai se poloketi fou ile ESP32 ma fausia, moli, ma mataʻituina le gaioiga o le masini.
Manatua: Afai e te leʻi faʻapipiʻiina le ESP-IDF, faʻamolemole alu i le Faʻapipiʻi ma mulimuli i le faʻatonuga ina ia mafai ai ona maua uma polokalama e manaʻomia e faʻaoga ai lenei taʻiala.

Amata se Poloketi O lea ua e sauni e tapena lau talosaga mo le ESP32. E mafai ona e amata i le getstarted/hello_world project from examples directory i le ESP-IDF.

Taua: E le lagolagoina e le polokalama faufale ESP-IDF avanoa i ala i le ESP-IDF po'o galuega faatino.

Kopi le poloketi amata/hello_world i ~/esp directory:

Espressif Systems

38 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata
cd ~/esp cp -r $IDF_PATH/examples/amataina/hello_world .
Fa'aaliga: E iai le tele o fa'aupugaample galuega faatino i le examples directory i le ESP-IDF. E mafai ona e kopiina soʻo se poloketi i le auala lava e tasi e pei ona tuʻuina atu i luga ma faʻatautaia. E mafai foi ona fausia examples in-place e aunoa ma le kopiina muamua.
Fa'afeso'ota'i lau masini Fa'afeso'ota'i lau laupapa ESP32 i le komipiuta ma siaki po'o fea o lo'o va'aia ai le va'aiga fa'asologa o le laupapa. O tau fa'asologa o lo'o i ai mamanu fa'aigoaina nei:
· Linux: amata ile /dev/tty · macOS: amata ile /dev/cu. Afai e te le o mautinoa pe faʻafefea ona siaki le igoa tau telefoni, faʻamolemole faʻafesoʻotaʻi le Faʻavaeina Faʻasologa Faʻatasi ma ESP32 mo faʻamatalaga atoa.
Fa'aaliga: Taofi le igoa o le taulaga aua e te mana'omia ile isi laasaga.
Fa'atulaga lau Poloketi Su'e i lau hello_world directory, seti le ESP32 e fai ma fa'amoemoega, ma fa'agasolo le project configuration utility menuconfig. cd ~/esp/hello_world idf.py set-target esp32 idf.py menuconfig
A maeʻa ona tatalaina se poloketi fou, e tatau ona e seti muamua le sini ile idf.py set-target esp32. Manatua o mea o loʻo i ai nei ma faʻatulagaga i totonu o le poloketi, pe a iai, o le a faʻamalo ma amataina i lenei faiga. E mafai ona fa'asaoina le fa'amoemoe ile suiga ole si'osi'omaga e fa'ase'e ai le la'asaga lea. Va'ai Filifili le Chip Target: set-target mo fa'amatalaga faaopoopo. Afai na faia sa'o laasaga muamua, o le lisi lea e aliali mai:

Ata 17: Fa'atulagaina o le Poloketi - Fa'amalama o le fale O lo'o e fa'aogaina le lisi lea e fa'atulaga ai suiga fa'apitoa o le poloketi, fa'ata'ita'iga, igoa ole feso'ota'iga Wi-Fi ma upu fa'aigoa, ole saoasaoa ole gaioiga, ma isi.ample tamoe ma

Espressif Systems

39 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata
fa'atonuga fa'aletonu.
Manatua: Afai e te faʻaogaina le ESP32-DevKitC laupapa ma le ESP32-SOLO-1 module, poʻo le ESP32-DevKitM-1 laupapa faʻatasi ma le ESP32-MIN1-1(1U) module, faʻamolemole faʻafesoʻotaʻi le tasi tulaga autu (CONFIG_FREERTOS_UNICORE) ile menuconfig aʻo leʻi faʻamalama ex.amples.
Manatua: O lanu o le lisi e mafai ona ese i lau laina. E mafai ona e suia foliga i le filifiliga -style. Fa'amolemole fa'agasolo idf.py menuconfig –fesoasoani mo nisi fa'amatalaga.
Afai o loʻo e faʻaaogaina se tasi o laupapa atinaʻe lagolago, e mafai ona e faʻavaveina lau atinaʻe e ala i le faʻaaogaina o le Board Support Package. Va'ai Fautuaga Faaopoopo mo nisi fa'amatalaga.
Fausia le Poloketi Fausia le poloketi e ala i le ta'avale:
idf.py fausia
O lenei poloaiga o le a tuʻufaʻatasia ai le talosaga ma vaega uma o le ESP-IDF, ona faʻatupuina ai lea o le bootloader, laulau vaeluaga, ma binaries talosaga.
$ idf.py fausia Tamomoe cmake i le lisi /path/to/hello_world/build Fa'atinoina o le “cmake -G Ninja –warn-uninitialized /path/to/hello_world”… Lapata'i e uiga i tulaga taua e le'i amataina. — Maua Git: /usr/bin/git (maua lomiga “2.17.0”) — Fausiaina gaogao aws_iot vaega ona o le faatulagaga — Igoa o vaega: … — Auala vaega: …
… (sili atu laina o galuega faufale)
[527/527] Fausia hello_world.bin esptool.py v2.3.1
Ua mae'a le fausiaina o le poloketi. Ina ia moli, fai le poloaiga lenei: ../../../components/esptool_py/esptool/esptool.py -p (PORT) -b 921600 write_flash -flash_mode dio –flash_size detect –flash_freq 40m 0x10000 build/hello_world. talone fausia 0x1000 fau/bootloader/bootloader.bin 0x8000 fausia/partition_table/ partition-table.bin pe ta'e 'idf.py -p PORT flash'
Afai e leai ni mea sese, o le a maeʻa le fausiaina e ala i le fausiaina o le firmware binary .bin files.
Fa'aola i luga o le Masini Fa'ailoa le fa'amaufa'ailoga na e fa'ato'a fausia (bootloader.bin, partition-table.bin ma hello_world.bin) i luga o lau laupapa ESP32 e ala i le ta'avale:
idf.py -p PORT [-b BAUD] moli
Suia le PORT i lau ESP32 boardns serial port name. E mafai fo'i ona e suia le fua o le pa'u moli e ala i le suia o le BAUD i le fua o le pa'u e te mana'omia. Ole fua ole baud ole 460800. Mo nisi fa'amatalaga ile idf.py finauga, va'ai idf.py.
Fa'aaliga: O le filifiliga moli e otometi lava ona fausia ma moli le poloketi, o lea e le manaʻomia ai le faʻaogaina o le idf.py build.

Espressif Systems

40 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata

Fa'agaoioiga masani Pe a emo, o le a e va'ai i le ogalaau o galuega e pei o mea nei:
… esptool.py –chip esp32 -p /dev/ttyUSB0 -b 460800 –before=default_reset -after=hard_reset write_flash –flash_mode dio –flash_freq 40m –flash_size 2MB 0x8000 partition_table/partition-bootbin0bin. 0x10000 hello_world.bin esptool.py v3.0-dev Taulaga Serial /dev/ttyUSB0 Fesoʻotaʻi…….._ Chip o le ESP32D0WDQ6 (toe iloilo 0) Mea: WiFi, BT, Lua Autu, Coding Scheme Leai se Crystal e 40MHz MAC: 24:0atubb:c9:0.4 Stub… tamo'e... Suia le fua o le baud i le 460800 Suia. Fa'atulaga le lapo'a moli… Fa'omia le 3072 paita i le 103... Tusi i le 0x00008000... (100 %) Tusia le 3072 paita (103 fa'amau) i le 0x00008000 i le 0.0 sekone (tatau 5962.8 kbit/s fa'amaonia). Fa'apipi'i 26096 paita i le 15408... Tusia ile 0x00001000... (100 %) Tusia 26096 paita (15408 fa'amau) ile 0x00001000 ile 0.4 sekone (e aoga 546.7 kbit/s fa'amaonia). Fa'amauina 147104 paita i le 77364... Tusia ile 0x00010000... (20 %) Tusi ile 0x00014000... (40 %) Tusi ile 0x00018000... (60 %) Tusia ile 0x0001c000%)
(fa'aauau i le itulau e sosoo ai)

Espressif Systems

41 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata
(faʻaauau mai le itulau muamua) Tusia i le 0x00020000… (100 %) Tusia 147104 bytes (77364 compressed) i le 0x00010000 i le 1.9 sekone (e aoga 615. 5 kbit/s)… Hash of data verified.
Tu'u ese... Toe setiina faigata e ala i le pine RTS... Ma'ea
Afai e leai ni fa'afitauli i le fa'ai'uga o le flash process, o le a toe fa'afou le laupapa ma amata le theohello_worldpapplication. Afai e te manaʻo e faʻaoga le Eclipse poʻo le VS Code IDE nai lo le taʻavale idf.py, siaki le Eclipse Plugin, VSCode Extension.
Mata'ituina le Fa'asologa Ina ia siaki pe o le ohello_worldpis o lo'o tamo'e moni, fa'aigoa idf.py -p PORT mata'itu (Aua nei galo e sui le PORT i lou igoa tau telefoni). O lenei poloaiga e faʻalauiloa ai le talosaga IDF Monitor:
$ idf.py -p mata'itū Ta'avale idf_monitor i le fa'atonu [...]/esp/hello_world/build Fa'atino le “python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_ world/build/hello_world.elf”… — idf_monitor on 115200 —– Tu'u: Ctrl+] | Menu: Ctrl+T | Fesoasoani: Ctrl+T sosoo ai Ctrl+H –ets Jun 8 2016 00:22:57
muamua:0x1 (POWERON_RESET), seevae:0x13 (SPI_FAST_FLASH_BOOT) ma Iuni 8 2016 00:22:57 …
A mae'a le amataga ma fa'amaufa'ailoga tusi fa'asolo i luga, e tatau ona e va'ai i le oTalofa lalolagi! lolomi i fafo e le talosaga.
… Talofa le lalolagi! Toe amata ile 10 sekone… Ole esp32 chip lea ma le 2 CPU core(s), WiFi/BT/BLE, silicon revision 1, 2MB external flash Laiti faupu'e fua fua: 298968 bytes Toe amata ile 9 sekone... Toe amata ile 8 sekone... Toe amata ile 7 sekone...
Ina ia alu ese mai le mataʻituina o le IDF, faʻaaoga le ala pupuu Ctrl+]. Afai e le manuia le mata'ituina o le IDF pe a uma le tu'uina atu, pe, pe a le o savali o loʻo i luga, e te vaʻai i lapisi faʻafuaseʻi e pei o mea o loʻo tuʻuina atu i lalo, o lau laupapa e ono faʻaaogaina se tioata 26 MHz. O le tele o fuafuaga a le komiti atina'e e fa'aaoga le 40 MHz, o lea e fa'aogaina ai e le ESP-IDF lenei fa'atuputeleina o se tau fa'aletonu.

Afai e iai sau fa'afitauli fa'apea, fai mea nei:
1. Alu ese mai le mataitu. 2. Toe fo'i ile menuconfig. 3. Alu i le Component config > Fa'atonuga Meafaigaluega > Autu XTAL Config > Autu XTAL
masani, ona sui lea CONFIG_XTAL_FREQ_SEL i le 26 MHz. 4. A maeʻa lena, toe fausia ma toe moli le talosaga.

Espressif Systems

42 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata
I le lomiga o loʻo iai nei o le ESP-IDF, o laina autu XTAL o loʻo lagolagoina e le ESP32 e faʻapea:
· 26 MHz · 40 MHz
Fa'aaliga: E mafai ona e tu'ufa'atasia le fale, moli ma mata'ituina i le la'asaga tasi e ala ile tamo'e: idf.py -p PORT flash monitor
Va'ai fo'i: · IDF Monitor mo ala 'alo fa'apitoa ma nisi fa'amatalaga i le fa'aogaina o le IDF monitor. · idf.py mo se faʻamatalaga atoa o idf.py poloaiga ma filifiliga.
Pau na mea e te manaʻomia e amata ai ile ESP32! O lea ua e sauni e fa'ata'ita'i se isi examples, pe alu sa'o e atia'e au lava talosaga.
Taua: O nisi o exampE le lagolagoina e le au le ESP32 ona o meafaigaluega mana'omia e le o aofia i le ESP32 o lea e le mafai ai ona lagolagoina. Afai e fausia se example, faamolemole siaki le README file mo le laulau Lagolago Sini. Afai o loʻo iai lenei mea e aofia ai le ESP32 faʻamoemoe, pe leai se laulau, o le exampe galue ile ESP32.
Fautuaga Faaopoopo
Fa'atagaga mataupu / dev / ttyUSB0 Faatasi ai ma nisi o tufatufaga Linux, e mafai ona e maua le Faile e tatala le taulaga / dev / ttyUSB0 savali sese pe a emo le ESP32. E mafai ona foia lenei mea e ala i le faʻaopoopoina o le tagata faʻaoga o loʻo i ai nei i le vaega faʻasalalau.
Python fetaui ESP-IDF lagolagoina le Python 3.7 poʻo le fou. E fautuaina e fa'aleleia lau faiga fa'aogaina i se fa'ata'ita'iga lata mai e fa'amalieina ai lenei mana'oga. O isi filifiliga e aofia ai le faʻapipiʻiina o le Python mai faʻapogai poʻo le faʻaogaina o le Python version management system e pei ole pyenv.
Amata i le Board Support Package Ina ia faatelevaveina le fa'ata'ita'iga i luga o nisi laupapa atina'e, e mafai ona e fa'aogaina le Board Support Packages (BSPs), lea e fa'afaigofie ai le fa'aulufaleina o se laupapa fa'apitoa e pei o ni nai telefoni fa'atino. E masani ona lagolagoina e le BSP vaega uma o meafaigaluega o loʻo tuʻuina atu ile laupapa atinaʻe. E ese mai i le faʻauigaina o le pinout ma galuega amata, o le BSP o loʻo vaʻavaʻai ma avetaʻavale mo vaega i fafo e pei o masini, faʻaaliga, codec leo ma isi. O BSP e tufatufaina e ala i le IDF Component Manager, ina ia mafai ona maua i le IDF Component Registry. Herens se example auala e fa'aopoopo ai le ESP-WROVER-KIT BSP i lau poloketi: idf.py add-dependency esp_wrover_kit
E sili atu exampole fa'aogaina ole BSP e mafai ona maua ile BSP examples faila.
Motugaafa: Fa'afou le ESP-IDF E fautuaina e fa'afou le ESP-IDF mai lea taimi i lea taimi, a'o fa'afou fou fa'aleleia bug ma/po'o le tu'uina atu o foliga fou. Fa'amolemole ia maitauina o lo'o i ai i le ESP-IDF fa'asalalauga tetele ma la'ititi la'ititi o lo'o i ai se vaitaimi lagolago e feso'ota'i ai, ma a o'o ina lalata se lala fa'amalolo se tasi (EOL), e fa'amalosia tagata uma e fa'aoga e fa'aleleia a latou poloketi i fa'amaumauga lata mai o le ESP-IDF, e saili atili ai e uiga i vaitaimi lagolago, va'ai ESP-IDF Versions.

Espressif Systems

43 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 1. Amata
O le auala pito sili ona faigofie e fai ai le faʻafouga o le tapeina lea o le faila esp-idf o loʻo iai ma toe faʻapipiʻi, e pei o le faia o le faʻapipiʻi muamua o loʻo faʻamatalaina i le Laasaga 2. Maua le ESP-IDF. O le isi fofo o le fa'afouina na'o mea ua suia. Ole faiga fa'afouga e fa'alagolago ile lomiga ole ESP-IDF o lo'o e fa'aogaina. A mae'a ona fa'afou le ESP-IDF, toe fa'atino le Fa'amaufa'ailoga, ina ne'i mana'omia e le ESP-IDF fou fa'aliliuga eseese o meafaigaluega. Va'ai faatonuga ile Laasaga 3. Fa'atulaga meafaigaluega. A maeʻa ona faʻapipiʻi meafaigaluega fou, faʻafouina le siosiomaga e faʻaaoga ai le Export script. Va'ai fa'atonuga ile Laasaga 4. Fa'atulaga suiga ole si'osi'omaga.
Pepa Fa'afeso'ota'i · Fa'avae So'oga Fa'asologa ma le ESP32 · Eclipse Plugin · VSCode Extension · IDF Monitor
1.4 Fausia Lau Poloketi Muamua
Afai ua uma ona faʻapipiʻi le ESP-IDF ae e te le faʻaaogaina le IDE, e mafai ona e fausia lau poloketi muamua mai le laina faʻatonu pe a maeʻa le Amata se Poloketi i luga o Windows poʻo Amata se Poloketi i Linux ma macOS.
1.5 Aveese le ESP-IDF
Afai e te manaʻo e aveese le ESP-IDF, faʻamolemole mulimuli i le Aveese ESP-IDF.

Espressif Systems

44 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 2
API Fa'asinomaga
2.1 Feagaiga API
O lenei pepa o lo'o fa'amatala ai tu'utu'uga ma manatu e masani ai ESP-IDF Application Programming Interfaces (APIs). ESP-IDF e maua ai le tele o ituaiga o feso'ota'iga polokalame:
· C galuega, fausaga, enums, fa'amatalaga fa'aigoa ma fa'ata'ita'iga muamua fa'atonu fa'alauiloa ile ulutala fa'alaua'itele. files o vaega ESPIDF. O itulau eseese i le API Reference section o le polokalame taʻiala o loʻo iai faʻamatalaga o nei galuega, fausaga ma ituaiga.
· Fausia galuega faʻaoga, suiga faʻavasegaina ma filifiliga. O lo'o fa'amaumauina i totonu o le ta'iala faufale. · Kconfig filifiliga e mafai ona faʻaogaina i le faʻailoga ma i le faiga faʻavae (CMakeLists.txt) files. · Mea faigaluega fa'afeiloa'i ma a latou laina laina fa'atonuga o se vaega fo'i ole fa'aoga ole ESP-IDF. ESP-IDF e aofia ai vaega na tusia fa'apitoa mo ESP-IDF fa'apea fo'i ma faletusi a isi vaega. I nisi tulaga, o se afifi ESP-IDF-faʻapitoa e faʻapipiʻiina i le faletusi lona tolu, e maua ai se faʻaoga e sili atu ona faigofie pe sili atu ona tuʻufaʻatasia ma isi nofoaga o le ESP-IDF. I isi tulaga, o le API muamua o le faletusi lona tolu o loʻo tuʻuina atu i le au atinaʻe talosaga. O vaega o lo'o mulimuli mai e fa'amatala ai nisi o vaega o le ESP-IDF API ma lo latou fa'aogaina.
2.1.1 Sese taulimaina
Ole tele ole ESP-IDF API e toe fa'afo'i fa'ailoga sese ua fa'amatalaina ile ituaiga esp_err_t. Va'ai vaega o le Fa'afoeina o Fa'aletonu mo nisi fa'amatalaga e uiga i le fa'aogaina o mea sese. Error Code Reference o loʻo i ai le lisi o mea sese na faʻafoʻi mai e vaega ESP-IDF.
2.1.2 Fa'atonuga fa'atulagaina
Taua: Fa'asa'o sa'o o fa'atulagaga fa'atulagaina o se vaega taua i le fa'aogaina o le talosaga ma fa'asologa o le ESP-IDF i le lumana'i.
Ole tele ole amataga po'o le fa'atulagaina o galuega ile ESP-IDF e fai ma fa'aupuga o se fa'asino ile fausaga fa'atulagaina. Mo exampLe:
45

Mataupu 2. API Fa'asinomaga

const esp_timer_create_args_t my_timer_args = { .callback = &my_timer_callback, .arg = callback_arg, .name = “my_timer”
}; esp_timer_handle_t my_timer; esp_err_t err = esp_timer_create(&my_timer_args, &my_timer);
O galuega amata e le mafai ona teuina le faʻailoga i le fausaga faʻatulagaina, o lea e saogalemu ai le tuʻufaʻatasia o le fausaga i luga o le faaputuga.
O le talosaga e tatau ona amataina uma vaega o le fausaga. E le sa'o mea nei:
esp_timer_create_args_t my_timer_args; my_timer_args.callback = &my_timer_callback; /* Le sa'o! Fields .arg ma .name e le'o amataina */ esp_timer_create(&my_timer_args, &my_timer);
Ole tele ole ESP-IDF exampfa'aaoga le C99 fa'ailoga amata mo le fa'avaeina o le fausaga, talu ai latou te tu'uina atu se auala pupuu e fa'atulaga ai se vaega o fanua, ma leai se amataga o fanua o totoe:
const esp_timer_create_args_t my_timer_args = { .callback = &my_timer_callback, /* Sa'o, fanua .arg ma .igoa e leai se amataga */
};
E le lagolagoina e le gagana C++ le syntax amata filifilia seia oʻo i le C++ 20, peitaʻi o le GCC compiler o loʻo lagolagoina i se vaega o se faʻaopoopoga. A fa'aaoga ESP-IDF API i le C++ code, e mafai ona e mafaufau e fa'aoga le mamanu lea:
esp_timer_create_args_t my_timer_args = {}; /* O fanua uma e leai se amataga */ my_timer_args.callback = &my_timer_callback;

Fa'ailoga amata
Mo nisi fausaga fa'atulagaina, ESP-IDF e tu'uina atu macros mo le fa'atulagaina o tau fa'aletonu o fanua:
httpd_config_t config = HTTPD_DEFAULT_CONFIG(); /* HTTPD_DEFAULT_CONFIG fa'alautele atu i se fa'ailoga amata.
Ole taimi nei ua seti uma fanua ile tulaga fa'aletonu. Soo se fanua e mafai lava ona suia: */ config.server_port = 8081; httpd_handle_t server; esp_err_t err = httpd_start(&server, &config);
E fautuaina le fa'aogaina o macros initializer e le mafai ona maua i so'o se taimi e tu'uina atu ai mo se fausaga fa'apitoa.

2.1.3 API Tumaoti
Fa'aulutala patino files i le ESP-IDF o loʻo i ai API e faʻamoemoe e faʻaaogaina i na o le ESP-IDF source code, ae le o talosaga. Faaulutala faapena files e masani ona aofia ai mea faalilolilo pe esp_private i latou igoa poʻo le ala. O nisi vaega, pei o le hal, o lo'o i ai na'o API fa'apitoa. APIs Tutoatasi e mafai ona aveese pe suia i se auala e le fetaui i le va o faʻasalalauga laiti poʻo patch.

2.1.4 Vaega i example galuega faatino
ESP-IDF exampo lo'o i ai le tele o galuega fa'atino e fa'aalia ai le fa'aogaina o ESP-IDF API. Ina ia faʻaitiitia le faʻasologa o code i le example mea, o nai fesoasoani masani o loʻo faʻamatalaina i totonu o vaega o loʻo faʻaaogaina e le tele o meaamples.

Espressif Systems

46 Tuuina atu Faamatalaga Faamatalaga

Tu'u v5.0.9

Mataupu 2. API Fa'asinomaga
E aofia ai vaega o lo'o iai

Pepa / Punaoa

Espressif Systems ESP32 Dev Kitc Development Board [pdf] Taiala mo Tagata Fa'aoga
ESP32 Dev Kitc Development Board, ESP32, Dev Kitc Development Board, Kitc Development Board, Development Board, Board

Fa'asinomaga

Tusi Taiala

ESP32 Dev Kitc Atina'e Komiti

Fa'amatalaga o oloa

Fa'amatalaga

Fa'atonuga o le Fa'aaogaina o Mea

1. Amata

1.1 Folasaga

1.2 Mea e te Manaomia

1.3 Fa'apipi'i

1.4 Fausia Lau Poloketi Muamua

1.5 Aveese le ESP-IDF

2. API Fa'asinomaga

Fesili e Fai soo (FAQ)

Q: E mafai faapefea ona ou foia faafitauli masani ile ESP32?

Q: E mafai ona ou fa'aogaina le ESP-IDF ma isi microcontrollers?

Pepa / Punaoa

Fa'asinomaga

Tuu se faamatalaga

Fa'aleaogaina le tali