ESP32 Dev Kitc Development Board
Product Information
fepetra arahana
- Vokatra: ESP32
- Torolàlana momba ny fandaharana: ESP-IDF
- Version famoahana: v5.0.9
- Mpanamboatra: Espressif Systems
- Daty famoahana: May 16, 2025
Torolàlana momba ny fampiasana vokatra
1. Manomboha
Alohan'ny hanombohanao amin'ny ESP32, fantaro ny tenanao amin'ny
manaraka ireto:
1.1 Fampidirana
Mianara momba ny fiasa fototra sy ny fahaiza-manaon'ny
ESP32.
1.2 Inona no ilainao
Ataovy azo antoka fa manana fitaovana sy rindrambaiko ilaina ianao:
- Hardware: Jereo ny lisitry ny fitaovana ilaina
singa. - Software: Mametraka ny rindrambaiko ilaina
singa.
1.3 Fametrahana
Araho ireto dingana ireto mba hametrahana ny IDE ary amboary ny
tontolo iainana:
- IDE: Apetraho ny IDE natolotra ho an'ny
Ny programa ESP32. - Fametrahana tanana: Apetraho amin'ny tanana ny
tontolo iainana raha ilaina.
1.4 Amboary ny tetikasanao voalohany
Mamorona sy manangana ny tetikasanao voalohany amin'ny fampiasana ny ESP32.
1.5 Esory ny ESP-IDF
Raha ilaina, ianaro ny fomba hanesorana ny ESP-IDF amin'ny findainao
rafitra.
2. Reference API
Jereo ny antontan-taratasy API raha mila fanazavana amin'ny antsipiriany momba ny
protocols fampiharana, fitantanana ny hadisoana ary fanamafisana
rafitra.
Fanontaniana matetika (FAQ)
F: Ahoana no ahafahako mamaha olana mahazatra amin'ny ESP32?
A: Jereo ny fizarana famahana olana ao amin'ny torolàlana fandaharana
na tsidiho ny mpanamboatra webtranokala ho an'ny loharano fanohanana.
F: Afaka mampiasa ESP-IDF miaraka amin'ny microcontrollers hafa ve aho?
A: ESP-IDF dia natao manokana ho an'ny ESP32, fa mety ho hitanao
mifanaraka amin'ny microcontrollers Espressif hafa.
Sary ESP32
Torolàlana momba ny fandaharana ESP-IDF
Famoahana v5.0.9 Espressif Systems 16 Mey 2025
Fizahan-takelaka
Fizahan-takelaka
i
1 Manomboha
3
1.1 Fampidirana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.2 Inona no ilainao . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.2.1 Fitaovana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.2.2 Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.3 Fametrahana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.3.1 IDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.3.2 Fametrahana tanana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
1.4 Amboary ny tetikasanao voalohany . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
1.5 Esory ny ESP-IDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
2 API Reference
45
2.1 Fifanarahana API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
2.1.1 Fikarakarana fahadisoana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
2.1.2 Rafitra fanamboarana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
2.1.3 API tsy miankina . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
2.1.4 Ireo singa ao amin'ny example projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
2.1.5 Filaminana API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
2.2 Fitsipika fampiharana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
2.2.1 seranan-tsambo ASIO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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 Fanaraha-maso eo an-toerana ESP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
2.2.7 Rohy Andevo Serial ESP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
2.2.8 ESP x509 Certificat Bundle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
2.2.9 Mpizara HTTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
2.2.10 Mpizara HTTPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
2.2.11 ICMP Echo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
2.2.12 Serivisy mDNS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
2.2.13 Mbed TLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
2.2.14 IP Network Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
2.3 Bluetooth API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
2.3.1 Bluetooth® mahazatra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
2.3.2 Bluetooth® Low Energy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
2.3.3 Bluetooth® Classic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
2.3.4 Controller & HCI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
2.3.5 ESP-BLE-MESH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485
2.3.6 API mpampiantrano miorina amin'ny NimBLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 767
2.4 Error Codes Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769
2.5 Networking APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776
2.5.1 Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776
2.5.2 Ethernet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 899
2.5.3 Kofehy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 936
i
2.5.4 ESP-NETIF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 942 2.5.5 IP Network Layer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 974 2.5.6 Lay fampiharana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 976 2.6 Periferika API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 977 2.6.1 Analog to Digital Converter (ADC) Oneshot Mode Driver . . . . . . . . . . . . . . . . . 977 2.6.2 Analog to Digital Converter (ADC) Continuous Mode Driver . . . . . . . . . . . . . . . 986 2.6.3 Analog to Digital Converter (ADC) Calibration Driver . . . . . . . . . . . . . . . . . . . 993 2.6.4 Hazo famantaranandro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 997 2.6.5 Digital To Analog Converter (DAC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1004 2.6.6 GPIO & RTC GPIO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1008 2.6.7 Fameram-potoana ankapobeny (GPTimer) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1027 2.6.8 Inter-Integrated Circuit (I2C) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1039 2.6.9 Feon'ny Inter-IC (I2S) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1056 2.6.10 LCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1090 2.6.11 Fanaraha-maso LED (LEDC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1107 2.6.12 Moteur Control Pulse Width Modulator (MCPWM) . . . . . . . . . . . . . . . . . . . . . 1126 2.6.13 Pulse Counter (PCNT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1178 2.6.14 Fanaraha-maso lavitra (RMT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1193 2.6.15 Fitakiana fisintonana SD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1220 2.6.16 SDMMC Host Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1223 2.6.17 SD SPI Host Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1229 2.6.18 SDIO Card Slave Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1234 2.6.19 Sigma-Delta Modulation (SDM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1244 2.6.20 SPI Master Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1249 2.6.21 SPI Slave Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1274 2.6.22 ESP32-WROOM-32SE (Singa azo antoka) . . . . . . . . . . . . . . . . . . . . . . . . . 1281 2.6.23 Touch Sensor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1282 2.6.24 Roa-Wire Automotive Interface (TWAI) . . . . . . . . . . . . . . . . . . . . . . . . . . 1299 2.6.25 Universal Asynchronous Receiver/Transmitter (UART) . . . . . . . . . . . . . . . . . . 1317 2.7 Fanamboarana tetikasa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1342 2.7.1 Fampidirana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1342 2.7.2 Menu Configuration Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1342 2.7.3 Mampiasa sdkconfig.defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1342 2.7.4 Fitsipika Fandrafetana Kconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1343 2.7.5 Fifanarahana mihemotra amin'ny safidy Kconfig . . . . . . . . . . . . . . . . . . . . . . . . 1343 2.7.6 Reference Options Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1343 2.8 Provisioning API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1647 2.8.1 Fifandraisana Protocole . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1647 2.8.2 Fanomezana iombonana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1665 2.8.3 Fanomezana Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1669 2.9 Storage API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FileSystem Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1691 2.9.2 Fitaovana fanamboarana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1699 2.9.3 Tranomboky fitahirizana tsy miovaova . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1703 2.9.4 NVS Partition Generator Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1725 2.9.5 SD/SDIO/MMC Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1730 2.9.6 SPI Flash API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1744 2.9.7 SPIFFS Filerafitra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1780 2.9.8 Virtual filesinga rafitra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1784 2.9.9 Wear Leveling API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1800 2.10 System API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1803 2.10.1 endrika sary fampiharana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1803 2.10.2 Fanaraha-maso ny haavon'ny fampiharana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1808 2.10.3 Fampiasa antso miaraka amin'ny stack ivelany. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1813 2.10.4 Fanavaozana Chip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1815 2.10.5 Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1817 2.10.6 eFuse Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1826 2.10.7 Kaody diso sy ny asan'ny mpanampy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1846
ii
2.10.8 ESP HTTPS OTA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1849 2.10.9 Tranomboky Loop Event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1856 2.10.10 FreeRTOS (Mihoatra nyview). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1869 2.10.11 FreeRTOS (ESP-IDF) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1871 2.10.12 FreeRTOS (Endri-javatra fanampiny) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1988 2.10.13 Fanomezana fitadidiana antontam . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2008 2.10.14 Debugging fitadidiana antontam . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2021 2.10.15 Fameram-potoana avo lenta (ESP Timer) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2032 2.10.16 API anatiny sy tsy miorina . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2038 2.10.17 Call Inter-Processor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2040 2.10.18 Fametrahana fanapahana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2045 2.10.19 Fitehirizam-boky . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2051 2.10.20 Miscellaneous System APIs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2058 2.10.21 Over The Air Updates (OTA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2073 2.10.22 Fanaraha-maso ny zava-bita . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2084 2.10.23 Fitantanana herinaratra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2087 2.10.24 POSIX Threads Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2093 2.10.25 Famoronana isa kisendrasendra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2097 2.10.26 Fomba torimaso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2099 2.10.27 SoC Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2111 2.10.28 System Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2121 2.10.29 The himem alllocation API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2126 2.10.30 ULP Coprocessor programming . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2129 2.10.31 Watchdogs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2161
3 Reference Hardware
2167
3.1 Fampitahana andiam-pizarana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2167
3.1.1 Taratasy mifandraika . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2170
4 API Guides
2171
4.1 Tranomboky fanaraha-maso amin'ny ambaratonga fampiharana. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2171
4.1.1 Mihoatraview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2171
4.1.2 Fomba fiasa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2171
4.1.3 Safidy Configuration sy Fiankinan-doha . . . . . . . . . . . . . . . . . . . . . . . . . . 2172
4.1.4 Ahoana ny fampiasana ity tranomboky ity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2173
4.2 Fandefasana fanombohana fampiharana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2181
4.2.1 Voalohany stage bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2182
4.2.2 Faharoa stage bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2182
4.2.3 Fanombohana fampiharana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2183
4.3 Bluetooth® Classic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2184
4.3.1 Mihoatraview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2184
4.4 Bluetooth® Low Energy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2186
4.4.1 Mihoatraview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2186
4.4.2 Manomboka . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2191
4.4.3 Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2240
4.5 Bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2284
4.5.1 Mifanaraka amin'ny bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2285
4.5.2 Log Level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2285
4.5.3 Famerenana ny orinasa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2286
4.5.4 Boot avy amin'ny Test Firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2286
4.5.5 Famerenana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287
4.5.6 Alika mpiambina . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287
4.5.7 Haben'ny bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287
4.5.8 Haingana haingana avy amin'ny Deep Sleep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287
4.5.9 Custom bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287
4.6 Rafitra fananganana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2288
4.6.1 Mihoatraview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2288
4.6.2 Mampiasa ny Rafitra fananganana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2289
iii
4.6.3 Eksample Project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2291 4.6.4 Project CMakeLists File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2291 4.6.5 Component CMakeLists Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2293 4.6.6 Fanamboarana singa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2295 4.6.7 Famaritana mialoha ny processeur . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2295 4.6.8 Fepetra takiana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2295 4.6.9 Ampahany ambony amin'ny tetikasa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2299 4.6.10 Configuration-only Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2300 4.6.11 Debugging CMake . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2300 4.6.12 Eksample Component CMakeLists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2301 4.6.13 Custom sdkconfig defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2305 4.6.14 Fandresen-dahatra tselatra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2305 4.6.15 Manangana ny Bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2306 4.6.16 Manoratra singa CMake madio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2306 4.6.17 Mampiasa tetikasa CMake avy amin'ny antoko fahatelo miaraka amin'ny singa . . . . . . . . . . . . . . . . . . . 2306 4.6.18 Mampiasa tranomboky efa namboarina miaraka amin'ny singa . . . . . . . . . . . . . . . . . . . . . . . . . 2307 4.6.19 Mampiasa ESP-IDF amin'ny tetikasa Custom CMake . . . . . . . . . . . . . . . . . . . . . . . . . 2307 4.6.20 ESP-IDF CMake Build System API . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2308 4.6.21 File Globbing & Incremental Builds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2312 4.6.22 Build System Metadata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2313 4.6.23 Manangana Rafitra anatiny . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2313 4.6.24 Fifindra-monina avy amin'ny ESP-IDF GNU Make System . . . . . . . . . . . . . . . . . . . . . . . 2315 4.7 Core Dump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2316 4.7.1 Mihoatraview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2316 4.7.2 Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2317 4.7.3 Tehirizo ny fanariam-pako ho flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2317 4.7.4 Manonta ny fanariam-pako amin'ny UART . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2318 4.7.5 ROM miasa amin'ny Backtraces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2318 4.7.6 Fanondrahana ny fari-piainana amin'ny fangatahana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2318 4.7.7 Mihazakazaka escoredump.py . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2319 4.8 Stubs fifohazana torimaso lalina . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2322 4.8.1 Fitsipika momba ny Fifohazana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2322 4.8.2 Fampiharana Stub . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2322 4.8.3 Fampidirana ny kaody ao amin'ny fitadidiana RTC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2322 4.8.4 Fampidirana angona ao amin'ny fitadidiana RTC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2323 4.8.5 Fanamarinana CRC ho an'ny stubs mifoha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2323 4.8.6 Eksample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2323 4.9 Fikarakarana hadisoana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2324 4.9.1 Mihoatraview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2324 4.9.2 Kaody diso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2324 4.9.3 Manova kaody diso ho hafatra diso . . . . . . . . . . . . . . . . . . . . . . . . . . 2324 4.9.4 ESP_ERROR_CHECK macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2325 4.9.5 ESP_ERROR_CHECK_TSY_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 CHECK MACROS Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2326 4.9.11 Fomba fikarakarana fahadisoana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2326 4.9.12 C++ Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2327 4.10 ESP-WIFI-MESH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2327 4.10.1 Mihoatraview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2327 4.10.2 Fampidirana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2328 4.10.3 Hevitra ESP-WIFI-MESH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2329 4.10.4 Fananganana tambajotra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2334 4.10.5 Fitantanana tambajotra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2339 4.10.6 Fandefasana angona . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2342 4.10.7 Fanovana fantsona . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2344
iv
4.10.8 Fampisehoana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2347 4.10.9 Fanamarihana fanampiny . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2348 4.11 Fikarakarana zava-nitranga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2348 4.11.1 Wi-Fi, Ethernet, ary hetsika IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2348 4.11.2 Hetsika harato . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2349 4.11.3 Hetsika Bluetooth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2350 4.12 Fahadisoana mahafaty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2350 4.12.1 Mihoatraview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2350 4.12.2 Mpitarika tahotra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2350 4.12.3 Misoratra anarana dump sy backtrace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2351 4.12.4 GDB Stub . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2353 4.12.5 RTC Watchdog Timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2354 4.12.6 Fahadisoan'ny Guru Meditation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2354 4.12.7 Fahadisoana mahafaty hafa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2356 4.13 Fanaovana tselatra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2358 4.13.1 Fampidirana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2359 4.13.2 EFuses mifandraika . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2359 4.13.3 Fomba fanafenana tselatra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2360 4.13.4 Fanovana fanafenana tselatra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2360 4.13.5 Mety tsy fahombiazana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2366 4.13.6 Toetran'ny fanafenana tselatra ESP32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2368 4.13.7 Mamaky sy manoratra angona amin'ny tselatra miafina . . . . . . . . . . . . . . . . . . . . . . . 2368 4.13.8 Fanavaozana ny Flash Encrypted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2369 4.13.9 Fanaovana fanafenana tselatra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2369 4.13.10 Hevi-dehibe momba ny fanafenana tselatra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2370 4.13.11 Famerana ny fanafenana tselatra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2370 4.13.12 Fanafenana tselatra sy Boot azo antoka . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2371 4.13.13 Endri-javatra mandroso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2371 4.13.14 Fanazavana ara-teknika . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2373 4.14 Fanamafisana ny Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2373 4.14.1 Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2374 4.14.2 LL (Ambany ambaratonga) sosona . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2375 4.14.3 HAL (Sosona fanamafisam-peo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2376 4.15 Fiatoana avo lenta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2377 4.15.1 Ambaratonga fahatapahana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2377 4.15.2 Fanamarihana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TAG Debugging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2378 4.16.1 Fampidirana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2378 4.16.2 Ahoana no fiasan'izy io? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2379 4.16.3 Misafidiana JTAG adaptatera . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2380 4.16.4 Fametrahana ny OpenOCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2380 4.16.5 Fanamboarana tanjona ESP32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2380 4.16.6 Famoahana Debugger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2386 4.16.7 Debugging Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2386 4.16.8 Manangana OpenOCD avy amin'ny Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2386 4.16.9 Soso-kevitra sy karazany . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2391 4.16.10 Ireo antontan-taratasy mifandraika amin'izany . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2396 4.17 Famoronana Scripter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2421 4.17.1 Ambonyview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2421 4.17.2 Fanombohana haingana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2421 4.17.3 Famoronana Script Mpandrindra anatiny . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2424 4.18 lwIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2430 4.18.1 API tohana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2430 4.18.2 BSD Sockets API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2431 4.18.3 Netconn API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2435 4.18.4 lwIP FreeRTOS Task . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2435 4.18.5 IPv6 Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2435 4.18.6 esp-lwip custom modifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2436
v
4.18.7 Fanatsarana ny fampisehoana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2438 4.19 Karazana fitadidiana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2439
4.19.1 DRAM (Data RAM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2439 4.19.2 IRAM (Instruction RAM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2440 4.19.3 IROM (code executed from flash) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.4 DROM (angona voatahiry anaty tselatra) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.5 RTC fitadidiana miadana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.6 RTC FAST fahatsiarovana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.7 Fitakiana DMA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.8 DMA Buffer ao amin'ny stack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2442 4.20 OpenThread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2442 4.20.1 Fomban'ny tahiry OpenThread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2443 4.20.2 Ahoana ny fanoratana fampiharana OpenThread . . . . . . . . . . . . . . . . . . . . . . . . . 2443 4.20.3 Ny OpenThread Border Router . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2444 4.21 tabilao fisarahana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2444 4.21.1 Mihoatraview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2445 4.21.2 Latabatra fisarahana naorina . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2445 4.21.3 Mamorona tabilao manokana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2445 4.21.4 Famoronana tabilao fisarahana binary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2448 4.21.5 Fanamarinana ny haben'ny fisarahana. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2448 4.21.6 Mamelatra ny latabatra fisarahana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2449 4.21.7 Fizarana fitaovana (parttool.py) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2449 4.22 Fampisehoana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2450 4.22.1 Ahoana ny fomba hanatsarana ny fahombiazana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2450 4.22.2 Mpitarika . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2451 4.23 RF calibration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2468 4.23.1 Fanamarinana ampahany . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2468 4.23.2 Fanamarinana feno . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2469 4.23.3 Tsy misy calibration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2469 4.23.4 angon-drakitra fanombohana PHY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2469 4.23.5 API Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2469 4.24 Boot azo antoka . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2472 4.24.1 Faritra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2472 4.24.2 Fihodinana azo antokaview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2473 4.24.3 Fanalahidy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2473 4.24.4 Haben'ny bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2474 4.24.5 Ahoana ny fampandehanana ny boot azo antoka . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2474 4.24.6 Re-flashable Software Bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2475 4.24.7 Mamorona lakile fanasonia baoty azo antoka . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2475 4.24.8 Fanasonia an-tsary lavitra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2475 4.24.9 Fomba fanao tsara indrindra Boot azo antoka . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2476 4.24.10 Fanazavana ara-teknika . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2476 4.24.11 Boot azo antoka & fanafenana tselatra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2477 4.24.12 Fanamarinana fampiharana voasonia tsy misy baotin'ny Hardware Secure . . . . . . . . . . . . . . . . . . 2478 4.24.13 Endri-javatra mandroso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2478 4.25 Boot azo antoka V2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2478 4.25.1 Faritra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2479 4.25.2 Advantages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2479 4.25.3 Fizotry ny Boot V2 azo antoka . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2479 4.25.4 Endriky sakana sonia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2480 4.25.5 Padding azo antoka . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2480 4.25.6 Fanamarinana sakana sonia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2481 4.25.7 Fanamarinana sary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2481 4.25.8 Haben'ny bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2481 4.25.9 fampiasana eFuse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2481 4.25.10 Ahoana ny fampandehanana ny Secure Boot V2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2481 4.25.11 Fameperana rehefa alefa ny Secure Boot . . . . . . . . . . . . . . . . . . . . . . . . . . 2482 4.25.12 Mamorona lakile fanaovana sonia baoty azo antoka . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2482
vi
4.25.13 Fanasoniavana sary lavitra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2483 4.25.14 Fomba fanao tsara indrindra Boot azo antoka . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2484 4.25.15 Fanazavana ara-teknika . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2484 4.25.16 Boot azo antoka & fanafenana tselatra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2484 4.25.17 Fanamarinana fampiharana sonia tsy misy baotin'ny Hardware Secure . . . . . . . . . . . . . . . . . . 2484 4.25.18 Endri-javatra mandroso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2485 4.26 Fanohanana ny RAM ivelany . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2485 4.26.1 Fampidirana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2485 4.26.2 Hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2485 4.26.3 Fanamboarana RAM ivelany . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2486 4.26.4 Fameperana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2487 4.26.5 Tsy nahavita nanombohana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2488 4.26.6 Chip fanavaozana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2488 4.27 Fitahirizana eo an-toerana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2488 4.27.1 Mihoatraview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2488 4.27.2 FreeRTOS Native API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.27.3 Pthread API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.27.4 C11 Standard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.28 Fitaovana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.28.1 IDF Frontend – idf.py . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.28.2 IDF Docker Image . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2493 4.28.3 IDF Windows Installer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2495 4.28.4 IDF Component Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2496 4.28.5 IDF Clang Tidy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2497 4.28.6 Fitaovana azo alaina . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2498 4.29 Fitsapana vondrona amin'ny ESP32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2512 4.29.1 Fitsapana mahazatra. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2512 4.29.2 Fitsapana fitaovana maro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2513 4.29.3 Multi-stage Tranga fitsapana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2514 4.29.4 Fitsapana ho an'ny tanjona samihafa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2514 4.29.5 Fampiharana Fitsapana Unite fanorenana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2515 4.29.6 Fitsapana vondrona mihazakazaka . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2515 4.29.7 Kaody ora miaraka amin'ny fameram-potoana onitra Cache . . . . . . . . . . . . . . . . . . . . . . . 2516 4.29.8 Maneso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2517 4.30 Fitsapana vondrona amin'ny Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2519 4.30.1 Fitsapana rindrankajy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2519 4.30.2 IDF Unit Tests amin'ny Linux Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2520 4.31 Wi-Fi Driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2521 4.31.1 Lisitry ny endri-javatra Wi-Fi ESP32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2521 4.31.2 Ahoana ny fanoratana fampiharana Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2521 4.31.3 ESP32 Wi-Fi API Code Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2522 4.31.4 ESP32 Wi-Fi API Parameter Initialization . . . . . . . . . . . . . . . . . . . . . . . . . 2522 4.31.5 ESP32 Wi-Fi Programming Model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2522 4.31.6 ESP32 Wi-Fi Famariparitana hetsika . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2523 4.31.7 ESP32 Wi-Fi Station General Scenario . . . . . . . . . . . . . . . . . . . . . . . . . . . 2526 4.31.8 ESP32 Wi-Fi AP Scenario ankapobeny . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2529 4.31.9 ESP32 Wi-Fi Scan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2529 4.31.10 ESP32 Wi-Fi Station Fifandraisana . . . . . . . . . . . . . . . . . . . . . . . . . 2536 4.31.11 ESP32 Tobim-piantsonan'ny Wi-Fi Mifandray Rehefa Hita ny AP maro . . . . . . . . . . . . . 2543 4.31.12 Wi-Fi Reconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2543 4.31.13 Wi-Fi Beacon fe-potoana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2543 4.31.14 ESP32 Wi-Fi Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2543 4.31.15 Wi-Fi Easy ConnectTM (DPP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2549 4.31.16 Wireless Network Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2549 4.31.17 Fandrefesana loharanon-karena radio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2549 4.31.18 Tetezamita BSS haingana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2550 4.31.19 ESP32 Wi-Fi Fomba fitsitsiana herinaratra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2550 4.31.20 ESP32 Wi-Fi Throughput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
vii
4.31.21 Wi-Fi 80211 Packet Send . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2552 4.31.22 Wi-Fi Sniffer Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2554 4.31.23 Wi-Fi Multiple Antenna . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2554 4.31.24 Wi-Fi Channel momba ny fanjakana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2556 4.31.25 Wi-Fi Channel State Information Configure . . . . . . . . . . . . . . . . . . . . . . . . . 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 Wi-Fi Fragment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2558 4.31.30 Mpisoratra anarana WPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2558 4.31.31 Fampiasana Buffer Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2558 4.31.32 Ahoana no hanatsarana ny fahombiazan'ny Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2559 4.31.33 Wi-Fi Menuconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2562 4.31.34 Famahana olana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2565 4.32 Fiarovana Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2568 4.32.1 ESP32 Wi-Fi Security Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2568 4.32.2 Rafitra fitantanana voaaro (PMF) . . . . . . . . . . . . . . . . . . . . . . . . . . . 2571 4.32.3 WiFi Enterprise . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2572 4.32.4 WPA3-Personal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2572 4.32.5 Wi-Fi Enhanced OpenTM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2573 4.33 RF Fiaraha-monina . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2573 4.33.1 Mihoatraview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2574 4.33.2 Tohanana ny fiaraha-miaina ho an'ny ESP32 . . . . . . . . . . . . . . . . . . . . . . . . . 2574 4.33.3 Mekanisma sy Politika fiaraha-miaina . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2574 4.33.4 Ahoana ny fampiasana ny endri-javatra iaraha-monina . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2576 4.34 Fanorenana azo averina . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2577 4.34.1 Fampidirana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2577 4.34.2 Antony fananganana tsy azo averina . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2577 4.34.3 Mamela ny fananganana azo averina ao amin'ny ESP-IDF . . . . . . . . . . . . . . . . . . . . . . . . . . 2577 4.34.4 Ahoana ny fanatanterahana ny fananganana azo averina . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2578 4.34.5 Fanamboarana sy debugging azo averina. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2578 4.34.6 Ny anton-javatra mbola misy fiantraikany amin'ny fananganana azo averina. . . . . . . . . . . . . . . . . . . . . . . . 2578 4.35 Torolàlana ho an'ny mpampiasa fomba fiasa ambany. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2578
5 Torolàlana momba ny fifindra-monina
2579
5.1 ESP-IDF 5.x Torolàlana momba ny fifindra-monina . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2579
5.1.1 Fifindra-monina avy amin'ny 4.4 mankany 5.0. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2579
6 Tranomboky sy Rafitra
2611
6.1 Rahona Frameworks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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 Framework Fampandrosoana Audio Espressif . . . . . . . . . . . . . . . . . . . . . . . . . 2612
6.2.2 ESP-CSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2612
6.2.3 Espressif DSP Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2612
6.2.4 Rafitra Fampandrosoana ESP-WIFI-MESH . . . . . . . . . . . . . . . . . . . . . . . . 2613
6.2.5 ESP-WHO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2613
6.2.6 ESP RainMaker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2613
6.2.7 ESP-IoT-Vahaolana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2613
6.2.8 ESP-Protocoles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2613
viii
6.2.9 ESP-BSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2614
7 Torolàlana momba ny fandraisana anjara
2615
7.1 Fomba fandraisana anjara . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2615
7.2 Alohan'ny Fandraisana anjara . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2615
7.3 Fizotry ny fangatahana fisintonana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2615
7.4 Fizarana ara-dalàna . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2616
7.5 Taratasy mifandraika . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2616
7.5.1 Espressif IoT Development Framework Guide Style . . . . . . . . . . . . . . . . . . . . 2616
7.5.2 Mametraka Hook pre-commit ho an'ny tetikasa ESP-IDF. . . . . . . . . . . . . . . . . . . . . . . 2623
7.5.3 Kaody fanoratana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2624
7.5.4 Mamorona Eksamples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2629
7.5.5 API Documentation Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2630
7.5.6 Fifanarahana Mpandray anjara . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2632
7.5.7 Torolàlana Lohatenin'ny Zon'ny mpamorona . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2634
7.5.8 Fitsapana ESP-IDF miaraka amin'ny Pytest Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2635
8 Dikan-teny ESP-IDF
2645
8.1 Famoahana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2645
8.2 Dikan-teny inona no tokony hatomboko? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2645
8.3 Tetika famoahana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2645
8.4 Vanim-potoana fanohanana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2646
8.5 Fanamarinana ny dikan-teny ankehitriny . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2647
8.6 Git Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2648
8.7 Fanavaozana ny ESP-IDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2648
8.7.1 Fanavaozana ho amin'ny famoahana Stable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2649
8.7.2 Fanavaozana amin'ny dikan-teny mialoha ny famoahana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2649
8.7.3 Fanavaozana ny sampana Master . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2649
8.7.4 Fanavaozana ny sampana famoahana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2650
9 Loharano
2651
9.1 PlatformIO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2651
9.1.1 Inona no atao hoe PlatformIO? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2651
9.1.2 Fametrahana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2651
9.1.3 Fanamboarana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652
9.1.4 Tutorials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652
9.1.5 Tetika Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652
9.1.6 Dingana manaraka . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652
9.2 Rohy mahasoa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652
10 Zon'ny mpamorona sy fahazoan-dàlana
2653
10.1 Software Copyrights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2653
10.1.1 Ireo singa firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2653
10.1.2 Fanadihadiana . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2654
10.2 ROM Source Code Copyrights . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2654
10.3 Xtensa libhal MIT License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2655
10.4 TinyBasic Plus MIT License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2655
10.5 TJpgDec License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2655
11 Momba ny
2657
12 Mifamadiho amin'ny fiteny
2659
Fanondroana
2661
Fanondroana
2661
ix
x
Fizahan-takelaka
Ity ny antontan-taratasy momba ny Espressif IoT Development Framework (esp-idf). ESP-IDF no rafitra fampandrosoana ofisialy ho an'ny ESP32, ESP32-S ary ESP32-C Series SoCs. Ity antontan-taratasy ity dia mamaritra ny fampiasana ESP-IDF miaraka amin'ny ESP32 SoC.
Manomboha
API Reference
API Guides
Espressif Systems
1 Alefaso ny valin-kafatra
Famoahana v5.0.9
Fizahan-takelaka
Espressif Systems
2 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1
Manomboha
Ity antontan-taratasy ity dia natao hanampy anao amin'ny fametrahana ny tontolon'ny fampivoarana rindrambaiko ho an'ny fitaovana mifototra amin'ny chip ESP32 nataon'i Espressif. Taorian'izay, ex tsotraampHasehoko anao ny fomba fampiasana ESP-IDF (Espressif IoT Development Framework) ho an'ny fandrindrana ny sakafo, avy eo amin'ny fananganana sy fametahana firmware eo amin'ny tabilao ESP32.
Fanamarihana: Ity dia antontan-taratasy momba ny version stable v5.0.9 an'ny ESP-IDF. Misy dikan-teny ESP-IDF hafa koa.
1.1 Fampidirana
ESP32 dia rafitra iray amin'ny puce izay mampiditra ireto endri-javatra manaraka ireto: · Wi-Fi (tarika 2.4 GHz) · Bluetooth · Xtensa® 32-bit LX6 CPU cores avo roa heny · Ultra Low Power co-processor · Periferika maromaro
Navoakan'ny teknolojia 40 nm, ny ESP32 dia manome sehatra matanjaka sy tena mitambatra, izay manampy amin'ny famenoana ny fitakiana mitohy amin'ny fampiasana herinaratra mahomby, famolavolana mirindra, fiarovana, fampisehoana avo lenta ary azo itokisana. Ny Espressif dia manome loharanom-pitaovana fototra sy rindrambaiko hanampiana ireo mpamorona fampiharana hahatsapa ny heviny amin'ny fampiasana ny fitaovana an-tariby ESP32. Ny rafi-pampandrosoana rindrambaiko nataon'i Espressif dia natao hamolavola rindranasa Internetof-Things (IoT) miaraka amin'ny Wi-Fi, Bluetooth, fitantanana herinaratra ary endri-javatra maro hafa.
1.2 Inona no ilainao
1.2.1 Fitaovana
· Fiara ESP32. · Cable USB – USB A / micro USB B. · Solosaina mampiasa Windows, Linux, na macOS.
Fanamarihana: Amin'izao fotoana izao, ny sasany amin'ireo birao fampandrosoana dia mampiasa connecteur USB Type C. Ataovy azo antoka fa manana tariby marina ianao hampifandraisana ny solaitrao!
Raha manana iray amin'ireo birao fampandrosoana ofisialy ESP32 voatanisa etsy ambany ianao dia azonao atao ny manindry ny rohy raha te hahalala bebe kokoa momba ny fitaovana.
3
Toko 1. Manomboha
ESP32-DevKitS(-R)
Ity torolalana ho an'ny mpampiasa ity dia manome fampahalalana momba ny ESP32-DevKitS(-R), takelaka tselatra miorina amin'ny ESP32 novokarin'ny Espressif. ESP32-DevKitS(-R) dia fitambaran'ny anaran'ny birao roa: ESP32-DevKitS sy ESP32-DevKitS-R. S dia midika hoe loharano, ary R dia midika hoe WROVER.
ESP32-DevKitS
ESP32-DevKitS-R
Ny antontan-taratasy dia ahitana ireto fizarana lehibe manaraka ireto: · Fiaingana: Manome fanoneranaview an'ny ESP32-DevKitS(-R) sy ny toromarika fananganana fitaovana/rindrambaiko hanombohana. · Reference Hardware: Manome fampahalalana misimisy kokoa momba ny fitaovana ESP32-DevKitS(-R)ns. · Taratasy mifandraika: Manome rohy mankany amin'ny antontan-taratasy mifandraika amin'izany.
Fanombohana Ity fizarana ity dia mamaritra ny fomba hanombohana amin'ny ESP32-DevKitS(-R). Manomboka amin'ny fizarana fampidirana vitsivitsy momba ny ESP32-DevKitS(-R), avy eo ny Fizarana Ahoana ny famatrarana ny Board dia manome torolalana momba ny fomba fametahana mody eo amin'ny ESP32-DevKitS(-R), amboary izany, ary tselatra ny firmware eo aminy.
TAPITRAview ESP32-DevKitS(-R) dia espressifns flash board natao manokana ho an'ny ESP32. Azo ampiasaina hanesorana ny mody ESP32 tsy misy fametahana ny maody amin'ny famatsiana herinaratra sy ny tsipika famantarana. Miaraka amin'ny maodely napetraka, ny ESP32-DevKitS(-R) dia azo ampiasaina ho birao fampandrosoana kely toa ny ESP32-DevKitC.
Ny tabilao ESP32-DevKitS sy ESP32-DevKitS-R dia tsy mitovy afa-tsy amin'ny fisehon'ny tsimatra lohataona mba hifanaraka amin'ireto maody ESP32 manaraka ireto.
· 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
Raha mila fanazavana momba ireo maody etsy ambony dia jereo ny ESP32 Series Modules.
Famaritana ny singa
Espressif Systems
4 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Sary 1: ESP32-DevKitS - eo anoloana
Espressif Systems
Sary 2: ESP32-DevKitS-R – eo anoloana 5
Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Lohataona Lohataona 2.54 mm Lohatenin'ny vehivavy
USB-to-UART Bridge LDO Micro-USB Connector/Micro USB Port EN Button Boot Button
Power On LED
Famaritana Tsindrio ny module in. Ny tsimatra dia hiditra ao amin'ny modulens castelled lavaka. Ireo lohapejy vavy ireo dia mifamatotra amin'ny tsimatra amin'ny maodely apetraka amin'ity solaitrabe ity. Raha mila fanazavana momba ny lohatenin'ny vehivavy, azafady jereo ny Lohateny Blocks. USB tokan-tsolika tokana mankany amin'ny tetezana UART dia manome tahan'ny famindrana hatramin'ny 3 Mbps.
5V ka hatramin'ny 3.3V voltage regulator (LDO).
USB interface tsara. Famatsiana herinaratra ho an'ny birao ary koa ny fifandraisana eo amin'ny solosaina sy ny birao.
Reset bokotra.
bokotra Download. Ny fihazonana ny Boot ary ny fanindriana ny EN dia manomboka ny maody Download Firmware ho an'ny fampidinana firmware amin'ny alàlan'ny seranan-tsambo.
Mivoha rehefa mifandray amin'ny solaitrabe ny USB na famatsiana herinaratra.
Ahoana ny famendrehana ny birao Alohan'ny hampandehanana ny ESP32-DevKitS(-R), azafady mba ho azo antoka fa ao anatin'ny toe-javatra tsara tsy misy soritr'aretina miharihary.
Fitaovana ilaina · Module ESP32 nofidinao · Cable USB 2.0 (Standard-A hatramin'ny Micro-B) · Solosaina mampiasa Windows, Linux, na macOS
Fametrahana Hardware Azafady, apetraho eo amin'ny ESP32-DevKitS(-R) ny môdely iray tianao, araka ireto dingana manaraka ireto:
· Apetaho moramora eo amin'ny solaitrabe ESP32-DevKitS(-R) ny môdelinao. Ataovy azo antoka fa mifanandrify amin'ny tsipìka lohataona eo amin'ny solaitrabe ny loaka voapetaka eo amin'ny maodyo.
· Tsindrio midina eo amin'ny solaitrabe ny môdelinao mandra-pikitika. · Hamarino raha ampidirina ao anatin'ny lavaka misy lavaka avokoa ny tsimatra lohataona rehetra. Raha misy tsipìka lohataona tsy mifanaraka,
apetraho ao anaty lavaka castelled miaraka amin'ny tweezers izy ireo.
Fametrahana lozisialy
Fomba tiana Ny rafi-pampandrosoana ESP-IDF dia manome fomba tiana indrindra amin'ny fanipazana binary amin'ny ESP32-DevKitS(-R). Azafady, tohizo amin'ny Started, izay ny fametrahana fizarana dia hanampy anao haingana amin'ny fametrahana ny tontolo fampandrosoana ary avy eo mametaka fampiharana exampAmpidiro ao amin'ny ESP32-DevKitS(-R).
Fomba hafa Ho solon'izay, ny mpampiasa Windows dia afaka tselatra binary mampiasa ny Flash Download Tool. Ampidino fotsiny izany, sokafy ary araho ny torolàlana ao anaty lahatahiry doc.
Fanamarihana: 1. Mametaka binary files, ESP32 dia tokony apetraka amin'ny fomba Download Firmware. Azo atao izany na amin'ny alalan'ny fitaovana tselatra ho azy, na amin'ny fihazonana ny bokotra Boot ary fipihana ny bokotra EN. 2. Taorian'ny tselatra binary files, ny Flash Download Tool dia mamerina ny maodely ESP32 anao ary manomboka ny fampiharana tselatra amin'ny alàlan'ny default.
Ny haben'ny board Ny atiny sy ny fonosana
Espressif Systems
6 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Atombohy Sary 3: ESP32-DevKitS refin'ny board - miverina
Espressif Systems
Fig. 4: ESP32-DevKitS-R refin'ny board - aoriana 7
Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Kaomandy antsinjarany Raha manafatra s vitsivitsy ianaoampAmin'ny ankapobeny, ny ESP32-DevKitS(-R) tsirairay dia tonga ao anaty fonosana tsirairay ao anaty kitapo antistatika na fonosana rehetra miankina amin'ny mpivarotra iray. Raha mila baiko antsinjarany dia tsidiho azafady https://www.espressif.com/en/contact-us/get-samples.
Kaomandy ambongadiny Raha manafatra ambongadiny ianao dia tonga ao anaty boaty baoritra lehibe ny takelaka. Raha mila baiko ambongadiny dia tsidiho azafady https://www.espressif.com/en/contact-us/sales-questions.
Hardware Reference
Diagrama sakana Ny kisary sakana etsy ambany dia mampiseho ny singa ao amin'ny ESP32-DevKitS(-R) sy ny fifandraisany.
Sary 5: ESP32-DevKitS(-R) (tsindrio raha hanitatra)
Safidy famatsiana herinaratra Misy fomba telo tsy manam-paharoa hanomezana herinaratra ny solaitrabe: · seranan-tsambo Micro USB, famatsiana herinaratra mahazatra · Pin lohapejy 5V sy GND · Pin lohapejy 3V3 sy GND
Manoro hevitra ny hampiasa ny safidy voalohany: micro USB port.
Espressif Systems
.
Label Signal
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
mitohy amin'ny pejy manaraka
8 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Ny tabilao 1 dia nitohy tamin'ny pejy teo aloha
.
Label Signal
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 ivelany
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
Ny sarin'ny lohapejy, azafady jereo ny Famaritana ny singa.
Documents mifandraika
Takelaka data ESP32-WROOM-32 (PDF) · ESP32-WROOM-32D & ESP32-WROOM-32U (PDF) · ESP32-WROOM-32 Takelaka data ESP32-WROOM-32D & ESP32-WROOM-32U (PDF) · ESP32-WROVER-B Takelaka data (PDF) · ESP Product Selector
ESP32-DevKitM-1
Ity torolàlana mpampiasa ity dia hanampy anao hanomboka amin'ny ESP32-DevKitM-1 ary hanome fampahalalana lalindalina kokoa.
ESP32-DevKitM-1 dia birao fampandrosoana miorina amin'ny ESP32-MINI-1(1U) novokarin'ny Espressif. Ny ankamaroan'ny tsimatra I/O dia tapaka amin'ny lohatenin'ny pin eo amin'ny andaniny roa mba hifandraisana mora. Ny mpampiasa dia afaka mampifandray ny periferika amin'ny tariby jumper na mametraka ESP32-DevKitM-1 amin'ny takelaka mofo.
Espressif Systems
9 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
ESP32-DevKitM-1 – eo anoloana
ESP32-DevKitM-1 - isometrika
Ny antontan-taratasy dia ahitana ireto fizarana lehibe manaraka ireto: · Fiaingana: Manome ny famarananaview amin'ny ESP32-DevKitM-1 sy ny toromarika fametrahana fitaovana/rindrambaiko hanombohana. · Reference Hardware: Manome fampahalalana amin'ny antsipiriany bebe kokoa momba ny fitaovana ESP32-DevKitM-1ns. · Documents mifandraika: Manome rohy mankany amin'ny documentaiton mifandraika.
Fanombohana Ity fizarana ity dia mamaritra ny fomba hanombohana amin'ny ESP32-DevKitM-1. Manomboka amin'ny fizarana fampidirana vitsivitsy momba ny ESP32-DevKitM-1 izy io, avy eo ny fizarana Start Application Development dia manome torolàlana momba ny fomba hanaovana ny fananganana fitaovana voalohany ary avy eo ny fomba fametahana firmware amin'ny ESP32-DevKitM-1.
TAPITRAview Ity dia birao fampandrosoana kely sy mety tsara izay ahitana:
· ESP32-MINI-1, na ESP32-MINI-1U module · USB-to-serial fandaharana interface tsara izay manome ihany koa ny famatsiana herinaratra ho an'ny solaitrabe · pin lohapejy · pushbuttons mba hamerenana sy fampahavitrihana ny Firmware Download mode · singa vitsivitsy hafa
Ny votoatiny sy ny fonosana
Kaomandy antsinjarany Raha manafatra s vitsivitsy ianaoampAmin'ny ankapobeny, ny ESP32-DevKitM-1 tsirairay dia tonga ao anaty fonosana tsirairay ao anaty kitapo antistatika na fonosana rehetra miankina amin'ny mpivarotra anao.
Raha mila baiko antsinjarany dia tsidiho azafady https://www.espressif.com/en/contact-us/get-samples.
Kaomandy ambongadiny Raha manafatra ambongadiny ianao dia tonga ao anaty boaty baoritra lehibe ny takelaka. Raha mila baiko ambongadiny dia tsidiho azafady https://www.espressif.com/en/contact-us/sales-questions.
Ny vidiny sy ny fotoana nitarika ny ESP32-DevKitM-1 arakaraka ny habetsahany takiana, ny fahazoana sy ny toerana fivarotana. Raisinay ny solaitrabe miaraka amin'ny maody ESP32-MINI-1 ho toy ny talohaample ao amin'ny fizarana manaraka.
Espressif Systems
10 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Fig. 6: ESP32-DevKitM-1 - eo anoloana
Key Component On-board Module
5 V hatramin'ny 3.3 V LDO bokotra Boot
Reset Button Micro-USB Port
USB-to-UART Bridge 3.3 V Power On LED
Mpandrindra I/O
Description
ESP32-MINI-1 module na ESP32-MINI-1U module. ESP32-MINI-1 dia miaraka amin'ny antenne PCB an-tsambo. ESP32-MINI-1U dia miaraka amin'ny mpampitohy antena ivelany. Samy manana tselatra 4 MB ao anaty fonosana chip ireo modules roa ireo. Takelaka data ESP32-MINI-1 & ESP32-MINI-1U
Power regulator dia manova ny 5 V ho 3.3 V.
bokotra Download. Ny fitazonana ny Boot ary avy eo ny fanindriana ny Reset dia manomboka ny maody Download Firmware ho an'ny fampidinana firmware amin'ny alàlan'ny seranan-tsambo.
Reset Button
USB interface tsara. Famatsiana herinaratra ho an'ny birao ary koa ny fifandraisana eo amin'ny solosaina sy ny chip ESP32.
Ny chip tetezana USB-UART tokana dia manome tahan'ny famindrana hatramin'ny 3 Mbps.
Mivadika rehefa mifandray amin'ny solaitrabe ny USB. Raha mila fanazavana fanampiny dia jereo ny skema ao amin'ny Documents mifandraika. Ny pins GPIO rehetra misy (afa-tsy ny fiara fitateram-bahoaka SPI ho an'ny flash) dia tapaka amin'ny lohatenin'ny pin eo amin'ny solaitrabe. Ny mpampiasa dia afaka manomana chip ESP32 mba ahafahana miasa maro.
Atombohy ny Fampivoarana Fampiharana Alohan'ny hampandehanana ny ESP32-DevKitM-1 anao, azafady mba ho azo antoka fa ao anatin'ny toe-javatra tsara tsy misy soritr'aretina miharihary.
Fitaovana ilaina · ESP32-DevKitM-1 · Cable USB 2.0 (Standard-A mankany Micro-B) · Solosaina mandeha Windows, Linux, na macOS
Software Setup Azafady, tohizo ny fanombohana, izay ny fametrahana fizarana dia hanampy anao haingana amin'ny fametrahana ny tontolo fampandrosoana ary avy eo tselatra fampiharana talohaampAmpidiro ao amin'ny ESP32-DevKitM-1 anao.
Espressif Systems
11 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Fanamarihana: Ny boards ESP32-DevKitM-1 novokarina talohan'ny 2 Desambra 2021 dia manana module fototra tokana napetraka. Raha te hanamarina ny maody anananao dia jereo azafady ny fampahalalana momba ny marika ao amin'ny PCN-2021-021. Raha manana môdô fototra tokana napetraka ny solaitrao, azafady avelao ny maody fototra tokana (CONFIG_FREERTOS_UNICORE) ao amin'ny menuconfig alohan'ny handrehitra ny rindranasao.
Hardware Reference Block Diagram Ny kisary sakana etsy ambany dia mampiseho ny singa ao amin'ny ESP32-DevKitM-1 sy ny fifandraisany.
Sary 7: ESP32-DevKitM-1
Fifantenana Loharanon-jiro Misy fomba telo mitokana hanomezana herinaratra ho an'ny solaitrabe: · seranan-tsambo Micro USB, famatsiana herinaratra mahazatra · Pin lohapejy 5V sy GND · Pin lohapejy 3V3 sy GND
Fampitandremana: · Ny famatsiana herinaratra dia tsy maintsy omena amin'ny alalan'ny iray sy iray ihany amin'ireo safidy etsy ambony, raha tsy izany dia mety ho simba ny solaitrabe sy/na ny loharanon-jiro. · Ny famatsiana herinaratra amin'ny alàlan'ny seranan-tsambo micro USB dia soso-kevitra.
Famaritana Pin Ny tabilao etsy ambany dia manome ny anarana sy ny asan'ny tsimatra amin'ny lafiny roa amin'ny solaitrabe. Ho an'ny fanamafisam-peo periferika, azafady jereo ny Takelaka data ESP32.
Tsia.
Anarana
Type
1
GND
P
2
3V3
P
Famatsiana herinaratra 3.3 V
mitohy amin'ny pejy manaraka
Espressif Systems
12 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Ny tabilao 2 dia nitohy tamin'ny pejy teo aloha
Tsia.
Anarana
Type
asa
3
I36
I
GPIO36, ADC1_CH0, RTC_GPIO0
4
I37
I
GPIO37, ADC1_CH1, RTC_GPIO1
5
I38
I
GPIO38, ADC1_CH2, RTC_GPIO2
6
I39
I
GPIO39, ADC1_CH3, RTC_GPIO3
7
voalohany
I
Mamerina; Avo: enable; Ambany: tapaka ny herinaratra
8
I34
I
GPIO34, ADC1_CH6, RTC_GPIO4
9
I35
I
GPIO35, ADC1_CH7, RTC_GPIO5
10
IO32
I/O
GPIO32, XTAL_32K_P (fampidirana oscillator kristaly 32.768 kHz),
ADC1_CH4, TOUCH9, RTC_GPIO9
11
IO33
I/O
GPIO33, XTAL_32K_N (famoahana oscillator kristaly 32.768 kHz),
ADC1_CH5, TOUCH8, RTC_GPIO8
12
IO25
I/O
GPIO25, DAC_1, ADC2_CH8, RTC_GPIO6, EMAC_RXD0
13
IO26
I/O
GPIO26, DAC_2, ADC2_CH9, RTC_GPIO7, EMAC_RXD1
14
IO27
I/O
GPIO27, ADC2_CH7, TOUCH7, RTC_GPIO17, EMAC_RX_DV
15
IO14
I/O
GPIO14, ADC2_CH6, TOUCH6, RTC_GPIO16, MTMS, HSPICLK,
HS2_CLK, SD_CLK, EMAC_TXD2
16
5V
P
Famatsiana herinaratra 5 V
17
IO12
I/O
GPIO12, ADC2_CH5, TOUCH5, RTC_GPIO15, MTDI, HSPIQ,
HS2_DATA2, SD_DATA2, EMAC_TXD3
18
IO13
I/O
GPIO13, ADC2_CH4, TOUCH4, RTC_GPIO14, MTCK, HSPID,
HS2_DATA3, SD_DATA3, EMAC_RX_ER
19
IO15
I/O
GPIO15, ADC2_CH3, TOUCH3, RTC_GPIO13, MTDO, HSPICS0,
HS2_CMD, SD_CMD, EMAC_RXD3
20
IO2
I/O
GPIO2, ADC2_CH2, TOUCH2, RTC_GPIO12, HSPIWP,
HS2_DATA0, SD_DATA0
21
IO0
I/O
GPIO0, ADC2_CH1, TOUCH1, RTC_GPIO11, CLK_OUT1,
EMAC_TX_CLK
22
IO4
I/O
GPIO4, ADC2_CH0, TOUCH0, RTC_GPIO10, HSPIHD,
HS2_DATA1, SD_DATA1, EMAC_TX_ER
23
IO9
I/O
GPIO9, HS1_DATA2, U1RXD, SD_DATA2
24
IO10
I/O
GPIO10, HS1_DATA3, U1TXD, SD_DATA3
25
IO5
I/O
GPIO5, HS1_DATA6, VSPICS0, EMAC_RX_CLK
26
IO18
I/O
GPIO18, HS1_DATA7, VSPICLK
27
IO23
I/O
GPIO23, HS1_STROBE, VSPID
28
IO19
I/O
GPIO19, VSPIQ, U0CTS, EMAC_TXD0
29
IO22
I/O
GPIO22, VSPIWP, U0RTS, EMAC_TXD1
30
IO21
I/O
GPIO21, VSPIHD, EMAC_TX_EN
31
TXD0
I/O
GPIO1, U0TXD, CLK_OUT3, EMAC_RXD2
32
Sary RXD0
I/O
GPIO3, U0RXD, CLK_OUT2
Hardware Revision Details Tsy misy dikan-teny teo aloha.
Documents mifandraika
· ESP32-MINI-1 & ESP32-MINI-1U (PDF) · ESP32-DevKitM-1 Schematics (PDF) · ESP32-DevKitM-1 PCB layout (PDF) · ESP32-DevKitM-1 layout (DXF) – Azonao atao view miaraka amin'ny Autodesk Viewer an-tserasera · ESP32 Datasheet (PDF) · ESP Product Selector
Ho an'ny antontan-taratasy famolavolana hafa ho an'ny birao, azafady mifandraisa aminay sales@espressif.com.
Espressif Systems
13 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
1.2.2 Software
Hanombohana ny fampiasana ESP-IDF amin'ny ESP32, apetraho ireto lozisialy manaraka ireto: · Toolchain hanangonana kaody ho an'ny ESP32 · Manamboara fitaovana – CMake sy Ninja hananganana Fampiharana feno ho an'ny ESP32 · ESP-IDF izay misy API (fitehirizam-bokin'ny rindrambaiko sy kaody loharano) ho an'ny ESP32 sy scripts hampandehanana ny Toolchain.
1.3 Fametrahana
Mba hametrahana ireo rindrambaiko ilaina rehetra dia manolotra fomba samihafa izahay hanamorana ity asa ity. Misafidiana amin'ny iray amin'ireo safidy misy.
1.3.1 IDE
Fanamarihana: Manoro hevitra mafy izahay hametraka ny ESP-IDF amin'ny alàlan'ny IDE tianao indrindra.
· Eclipse Plugin · VSCode Extension
1.3.2 Fametrahana tanana
Ho an'ny fomba fanao amin'ny tanana, azafady mifidiana araka ny rafitra fiasanao.
Espressif Systems
14 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Fametrahana mahazatra ny Toolchain ho an'ny Windows
Fampidirana Ny ESP-IDF dia mitaky fitaovana tsy maintsy apetraka mba hahafahanao manamboatra firmware ho an'ny chips tohanana. Ny fitaovana ilaina dia ahitana Python, Git, cross-compilers, CMake ary fitaovana fananganana Ninja. Ho an'ity fanombohana ity dia hampiasa ny Command Prompt, fa aorian'ny fametrahana ESP-IDF dia azonao atao ny mampiasa Eclipse Plugin na IDE sary hafa miaraka amin'ny fanohanana CMake. Fanamarihana: Famerana: – Ny lalan'ny fametrahana ny ESP-IDF sy ny ESP-IDF Tools dia tsy tokony hihoatra ny tarehintsoratra 90. Mety hiteraka tsy fahombiazana ny lalan'ny fametrahana lava loatra. - Ny lalan'ny fametrahana Python na ESP-IDF dia tsy tokony ahitana toerana fotsy na fononteny. - Ny lalan'ny fametrahana Python na ESP-IDF dia tsy tokony ahitana tarehin-tsoratra manokana (nonASCII) raha tsy hoe ny rafitra fandidiana dia namboarina miaraka amin'ny oUnicode UTF-8psupport. Ny Administrator System dia afaka manome alalana ny fanohanana amin'ny alàlan'ny Control Panel - Manova ny daty, ny ora, na ny laharan'ny isa - Tabilao fitantanana - Manova ny toerana misy ny rafitra - jereo ny safidy oBeta: Ampiasao ny Unicode UTF-8 ho fanohanana ny fiteny manerantanyp - Ok ary avereno indray ny solosaina.
ESP-IDF Tools Installer Ny fomba tsotra indrindra hametrahana ny fepetra takiana ESP-IDFns dia ny misintona iray amin'ireo ESP-IDF Tools Installer.
Windows Installer Download
Inona no fampiasa ho an'ny Online sy Offline Installer Online Installer dia tena kely ary mamela ny fametrahana ny famoahana rehetra misy an'ny ESP-IDF. Ny installer dia haka ny fiankinan-doha ilaina ao anatin'izany ny Git For Windows mandritra ny dingana fametrahana. Ny tranokala installer dia alaina files ao amin'ny lahatahiry cache %userprofile%. espressif
Tsy mila fifandraisana amin'ny tambazotra ny Offline Installer. Ny installer dia misy ny fiankinan-doha rehetra ilaina ao anatin'izany ny Git For Windows.
Ny singa amin'ny fametrahana Ny installer dia mametraka ireto singa manaraka ireto:
· Python voaraikitra · Cross-compilers · OpenOCD · CMake sy Ninja fitaovana fananganana · ESP-IDF
Ny installer dia mamela ny fampiasana indray ny lahatahiry efa misy miaraka amin'ny ESP-IDF. Ny lahatahiry atolotra dia %userprofile%Desktopesp-idf misy %userprofile% no lahatahiry an-tranonao.
Espressif Systems
15 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Famoahana ny tontolo iainana ESP-IDF Rehefa tapitra ny dingana fametrahana dia azonao atao ny mijery ny safidy Run ESP-IDF PowerShell Environment na Run ESP-IDF Command Prompt (cmd.exe). Ny installer dia hanomboka ny tontolo ESP-IDF amin'ny bitsika voafantina. Mandehana ESP-IDF PowerShell Environment:
Sary 8: Famenoana ny ESP-IDF Tools Setup Wizard miaraka amin'ny Run ESP-IDF PowerShell Environment
Alefaso ESP-IDF Command Prompt (cmd.exe):
Mampiasa ny Command Prompt Ho an'ireo dingana fanombohana sisa, dia hampiasa ny Windows Command Prompt ianao. Ny ESP-IDF Tools Installer dia mamorona hitsin-dàlana ihany koa ao amin'ny menu Start mba hanombohana ny ESP-IDF Command Prompt. Ity hitsin-dàlana ity dia manomboka ny Command Prompt (cmd.exe) ary mihazakazaka export.bat script mba hananganana ny fari-piainan'ny tontolo iainana (PATH, IDF_PATH sy ny hafa). Ao anatin'ity baikon'ny baiko ity dia misy ny fitaovana napetraka rehetra. Mariho fa ity hitsin-dàlana ity dia manokana amin'ny lahatahiry ESP-IDF voafantina ao amin'ny ESP-IDF Tools Installer. Raha manana lahatahiry ESP-IDF marobe amin'ny solosaina ianao (ohatraampmba hiasa amin'ny dikan-teny samihafa amin'ny ESP-IDF), manana safidy roa hampiasana azy ireo ianao:
1. Mamorona dika mitovy amin'ny hitsin-dàlana noforonin'ny ESP-IDF Tools Installer, ary ovay ny lahatahiry fiasan'ny hitsin-dàlana vaovao ho any amin'ny lahatahiry ESP-IDF tianao hampiasaina.
2. Raha tsy izany, mandehana cmd.exe, dia ovay amin'ny lahatahiry ESP-IDF tianao hampiasaina, ary mandehana export.bat. Mariho fa tsy toy ny safidy teo aloha, ity fomba ity dia mitaky Python sy Git ho eo amin'ny PATH. Raha mahazo lesoka mifandraika amin'ny Python na Git tsy hita ianao dia ampiasao ny safidy voalohany.
Dingana Voalohany amin'ny ESP-IDF Ankehitriny satria feno ny fepetra rehetra, ny lohahevitra manaraka dia hitarika anao amin'ny fomba hanombohana ny tetikasanao voalohany.
Espressif Systems
16 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Atombohy Fig. 9: ESP-IDF PowerShell
Sary 10: Famenoana ny ESP-IDF Tools Setup Wizard amin'ny Run ESP-IDF Command Prompt (cmd.exe)
Espressif Systems
17 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Sary 11: ESP-IDF Command Prompt
Espressif Systems
18 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Ity torolàlana ity dia hanampy anao amin'ny dingana voalohany amin'ny fampiasana ESP-IDF. Araho ity torolalana ity hanombohana tetikasa vaovao amin'ny ESP32 ary manangana, tselatra ary manara-maso ny fivoahan'ny fitaovana. Fanamarihana: Raha mbola tsy nametraka ESP-IDF ianao dia mandehana any amin'ny Fametrahana ary araho ny torolalana mba hahazoana ny rindrambaiko rehetra ilaina amin'ny fampiasana ity torolàlana ity.
Manomboha Tetikasa Ankehitriny dia vonona ny hanomana ny fangatahanao ho an'ny ESP32 ianao. Afaka manomboka amin'ny tetikasa getstarted/hello_world avy amin'ny examples directory ao amin'ny ESP-IDF.
Zava-dehibe: Ny rafitra fananganana ESP-IDF dia tsy mahazaka habaka amin'ny lalana mankany amin'ny ESP-IDF na amin'ny tetikasa.
Adikao ny tetikasa get-started/hello_world amin'ny ~/esp directory: cd %userprofile%esp xcopy /e /i %IDF_PATH%examplesget-startedhello_world hello_world
Fanamarihana: Misy isan-karazany ny example projet ao amin'ny examples directory ao amin'ny ESP-IDF. Azonao atao ny mandika ny tetikasa rehetra amin'ny fomba mitovy amin'ny aseho etsy ambony ary mampandeha azy. Azo atao koa ny manorina examples in-place nefa tsy maka tahaka azy aloha.
Ampifandraiso amin'ny solosainao izao ny fitaovanao ary ampifandraiso amin'ny solosaina ny biraonao ESP32 ary jereo ny seranan-tsambo misy ny solaitrabe. Ny anaran'ny seranan-tsambo dia manomboka amin'ny COM ao amin'ny Windows. Raha tsy azonao antoka ny fomba hijerena ny anaran'ny seranan-tsambo, azafady jereo ny Mametraha Serial Connection amin'ny ESP32 ho an'ny antsipiriany feno.
Fanamarihana: Tehirizo mora foana ny anaran'ny seranan-tsambo satria ilainao izany amin'ny dingana manaraka.
Ampifanaraho amin'ny lahatahiry hello_world anao ny tetikasanao, apetraho ho tanjona ny ESP32, ary tanteraho ny menuconfig utility configuration.
Windows cd %userprofile%esphello_world idf.py set-target esp32 idf.py menuconfig
Aorian'ny fanokafana tetikasa vaovao dia tokony hametraka ny tanjona amin'ny idf.py set-target esp32 aloha ianao. Mariho fa ny fananganana sy ny fanamboarana efa misy ao amin'ny tetikasa, raha misy, dia ho voafafa sy hatomboka amin'ity dingana ity. Ny lasibatra dia mety ho voatahiry ao amin'ny fari-piainan'ny tontolo iainana mba handingana ity dingana ity mihitsy. Jereo ny Select the Target Chip: set-target raha mila fanazavana fanampiny. Raha vita tsara ny dingana teo aloha, dia miseho ity menu manaraka ity: Mampiasa ity sakafo ity ianao mba hananganana fari-pahalalana manokana momba ny tetikasa, ohatra, ny anaran'ny tambajotra Wi-Fi sy ny tenimiafina, ny hafainganam-pandehan'ny processeur, sns.ample dia mandeha amin'ny konfigurasi default.
Fanamarihana: Raha mampiasa board ESP32-DevKitC ianao miaraka amin'ny module ESP32-SOLO-1, na board ESP32-DevKitM-1 miaraka amin'ny module ESP32-MIN1-1(1U), azafady avelao ny maody fototra tokana (CONFIG_FREERTOS_UNICORE) ao amin'ny menuconfig alohan'ny handrehitra examples.
Espressif Systems
19 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Fig. 12: Fanamboarana tetikasa - varavarankely an-trano
Fanamarihana: Mety tsy mitovy ny lokon'ny sakafo ao amin'ny terminalo. Azonao atao ny manova ny endrika amin'ny safidy -style. Alefaso azafady idf.py menuconfig –help raha mila fanazavana fanampiny.
Raha mampiasa ny iray amin'ireo birao fampandrosoana tohana ianao, dia azonao atao ny manafaingana ny fivoaranao amin'ny alàlan'ny fampiasana Board Support Package. Jereo ny toro-hevitra fanampiny raha mila fanazavana fanampiny.
Amboary ny tetikasa Amboary ny tetikasa amin'ny alàlan'ny fampandehanana:
idf.py fananganana
Ity baiko ity dia hanangona ny fampiharana sy ny singa ESP-IDF rehetra, avy eo dia hamokatra bootloader, latabatra fisarahana ary binaries fampiharana.
$ idf.py build Mandeha cmake ao amin'ny lahatahiry /path/to/hello_world/build Manatanteraka ny “cmake -G Ninja –warn-uninitialized /path/to/hello_world”… Mampitandrina momba ny soatoavina tsy fantatra. — Hita Git: /usr/bin/git (hitana dikan-teny “2.17.0”) — Manangana singa aws_iot tsy misy na inona na inona noho ny fanamboarana — Anaran'ny singa: … — Lalana singa: …
… (tsipika bebe kokoa amin'ny famoahana rafitra fananganana)
[527/527] Mamorona hello_world.bin esptool.py v2.3.1
Vita ny fananganana tetikasa. Raha tselatra dia araho ity baiko ity: ../../../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. bin build 0x1000 build/bootloader/bootloader.bin 0x8000 build/partition_table/ partition-table.bin na mandehana 'idf.py -p PORT flash'
Raha tsy misy lesoka dia hamita ny fananganana amin'ny famoronana ny firmware binary .bin files.
Espressif Systems
20 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Flash eo amin'ny Device Flash ny binary vao naorinao (bootloader.bin, partition-table.bin ary hello_world.bin) eo amin'ny tabilao ESP32 anao amin'ny alàlan'ny fampandehanana: idf.py -p PORT [-b BAUD] flash
Soloy ny PORT amin'ny anaranao seranan-tsambo ESP32 boardns. Azonao atao koa ny manova ny tahan'ny baud flasher amin'ny fanoloana ny BAUD amin'ny tahan'ny baud ilainao. Ny tahan'ny baud default dia 460800. Raha mila fanazavana fanampiny momba ny tohan-kevitra idf.py dia jereo idf.py.
Fanamarihana: Ny safidy tselatra dia manangana sy mamelatra ny tetikasa, noho izany dia tsy ilaina ny fampandehanana idf.py build.
Nisedra olana nandritra ny tselatra? Raha mihazakazaka ny baiko nomena ianao ary mahita lesoka toy ny tsy nahomby ny connectp, mety misy antony maromaro mahatonga izany. Ny iray amin'ireo antony dia mety ho olana sedrain'ny esptool.py, ilay fitaovana antsoina amin'ny rafitra fananganana hamerenana ny chip, hifanerasera amin'ny bootloader ROM, ary flash firmware. Ny vahaolana tsotra iray hanandramana dia ny famerenana amin'ny tanana voalaza etsy ambany, ary raha tsy manampy dia afaka mahita antsipiriany bebe kokoa momba ny olana mety hitranga amin'ny Famahana olana.
esptool.py dia mamerina mandeha ho azy ny ESP32 amin'ny alàlan'ny fanamafisana ny tsipika fanaraha-maso DTR sy RTS amin'ny USB mankany amin'ny chip converter serial, izany hoe FTDI na CP210x (raha mila fanazavana fanampiny dia jereo ny Mametraha fifandraisana amin'ny ESP32). Ny tsipika fanaraha-maso DTR sy RTS dia mifamatotra amin'ny tsipika GPIO0 sy CHIP_PU (EN) an'ny ESP32, ka miova ny vol.tagNy haavon'ny DTR sy RTS dia handefa ny ESP32 amin'ny fomba Download Firmware. Amin'ny maha example, jereo ny skema ho an'ny birao fampandrosoana ESP32 DevKitC.
Amin'ny ankapobeny, tsy tokony hanana olana amin'ny biraon'ny fampandrosoana ofisialy esp-idf ianao. Na izany aza, tsy afaka mamerina ny fitaovanao ho azy ny esptool.py amin'ireto tranga manaraka ireto:
· Tsy manana tsipika DTR sy RTS mifandray amin'ny GPIO0 sy CHIP_PU ny fitaovanao.
Miankina amin'ny karazana fitaovana anananao, dia mety ho azo atao ihany koa ny mametraka ny birao ESP32 anao amin'ny maodely Download Firmware (reset).
· Ho an'ny takelaka fampandrosoana novokarin'ny Espressif, ity fampahalalana ity dia azo jerena ao amin'ny torolalana fanombohana tsirairay na torolàlana momba ny mpampiasa. Ho an'ny exampary, raha hamerenana amin'ny tanana ny birao fampandrosoana ESP-IDF, tazony ny bokotra Boot (GPIO0) ary tsindrio ny bokotra EN (CHIP_PU).
· Ho an'ny karazana fitaovana hafa, andramo misintona GPIO0 midina.
Normal Operation Rehefa mitselatra dia ho hitanao ny log de output mitovy amin'ireto manaraka ireto:
… 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-boot00bin. 0x10000 hello_world.bin esptool.py v3.0-dev Serial port /dev/ttyUSB0 Mampifandray…….._ Chip dia ESP32D0WDQ6 (fanavaozana 0) Endriny: WiFi, BT, Dual Core, Coding Scheme Tsy misy Crystal dia 40MHz MAC: 24:0atubb:c4:04… mihazakazaka… Manova ny tahan'ny baud ho 460800 Niova.
(mitohy amin'ny pejy manaraka)
Espressif Systems
21 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
(tohiny avy amin'ny pejy teo aloha) Manefa ny haben'ny tselatra… Namboarina 3072 octet ho 103… Manoratra amin'ny 0x00008000… (100 %) Nanoratra 3072 octs (103 voatsindry) amin'ny 0x00008000 ao anatin'ny 0.0 segondra (nahomby 5962 ksh/s.8) 26096 octares nopotserina ho 15408… Manoratra amin'ny 0x00001000… (100 %) Nanoratra 26096 octet (15408 voatsindry) amin'ny 0x00001000 ao anatin'ny 0.4 segondra (546.7 kbit/s nohamarinina). 147104 octares de 77364… Manoratra amin'ny 0x00010000… (20 %) Manoratra amin'ny 0x00014000… (40 %) Manoratra amin'ny 0x00018000… (60 %) Manoratra amin'ny 0x0001c000% Writing amin'ny 0x0001c000% 0x00020000… (100 %) Nanoratra 147104 bytes (77364 compresses) tamin'ny 0x00010000 tao anatin'ny 1.9 segondra (effective 615. 5 kbit/s)… Hash of data voamarina.
Miala… Famerenana mafy amin'ny alalan'ny pin RTS… Vita
Raha tsy misy olana amin'ny fiafaran'ny fizotran'ny tselatra, dia hamerina ny birao ary hanomboka theohello_worldpapplication. Raha tianao ny mampiasa ny Eclipse na VS Code IDE fa tsy ny idf.py dia jereo ny Eclipse Plugin, VSCode Extension.
Araho ny Output Raha hijerena raha toa ka mandeha tokoa ny ohello_worldpis dia soraty idf.py -p PORT monitor (Aza adino ny manolo ny PORT amin'ny anaran'ny seranan-tsambonao).
Ity baiko ity dia manomboka ny fampiharana IDF Monitor:
$ idf.py -p monitor Mandeha idf_monitor ao anaty lahatahiry […]/esp/hello_world/build Manatanteraka “python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_ world/build/hello_world.elf”… — idf_monitor on 115200 —– Mialà: Ctrl+] | Menu: Ctrl+T | Fanampiana: Ctrl+T arahin'ny Ctrl+H –ets 8 Jun 2016 00:22:57
voalohany: 0x1 (POWERON_RESET), boot: 0x13 (SPI_FAST_FLASH_BOOT) ary ny 8 Jun 2016 00:22:57 …
Aorian'ny fikoriana ny diarin'ny fanombohana sy ny diagnostika dia tokony ho hitanao ny oHello world!navoakan'ny fampiharana.
… Hello World! Averina ao anatin'ny 10 segondra… Ity dia puce esp32 misy core(s) CPU 2, WiFi/BT/BLE, fanavaozana silisiôma 1, tselatra ivelany 2MB Habe antonony maimaim-poana farany indrindra: 298968 bita Miverina ao anatin'ny 9 segondra… Miverina ao anatin'ny 8 segondra… Miverina ao anatin'ny 7 segondra…
Mba hialana amin'ny fanaraha-maso IDF dia ampiasao ny hitsin-dàlana Ctrl+].
Espressif Systems
22 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Raha tsy nahomby ny fanaraha-maso IDF taoriana kelin'ny fampiakarana, na raha tsy ireo hafatra etsy ambony ianao dia mahita fako kisendrasendra mitovy amin'ny omena etsy ambany, dia azo inoana fa mampiasa kristaly 26 MHz ny biraonao. Ny ankamaroan'ny famolavolana boards dia mampiasa 40 MHz, ka ny ESP-IDF dia mampiasa an'io matetika io ho sanda mahazatra.
Raha manana olana toy izany ianao dia ataovy izao manaraka izao: 1. Mialà amin'ny monitor. 2. Miverena amin'ny menuconfig. 3. Mandehana any amin'ny Component config > Hardware Settings > Main XTAL Config > Main XTAL frequency, dia ovay ny CONFIG_XTAL_FREQ_SEL ho 26 MHz. 4. Aorian'izay, amboary sy tselatra indray ny fampiharana.
Ao amin'ny ESP-IDF amin'izao fotoana izao, ny frequence XTAL lehibe tohanan'ny ESP32 dia toy izao manaraka izao:
· 26 MHz · 40 MHz
Fanamarihana: Azonao atao ny manambatra ny fanorenana, ny tselatra ary ny fanaraha-maso amin'ny dingana iray amin'ny alàlan'ny fampandehanana: idf.py -p PORT flash monitor
Jereo koa: · IDF Monitor ho an'ny hitsin-dàlana mora ampiasaina sy antsipiriany bebe kokoa momba ny fampiasana IDF monitor. · idf.py ho fanondro feno ny baiko sy safidy idf.py.
Izay ihany no ilainao hanombohana amin'ny ESP32! Ankehitriny ianao dia vonona ny hanandrana ex hafaamples, na mandehana mivantana amin'ny famolavolana ny fampiharana anao manokana.
Zava-dehibe: Ny sasany amin'ireo exampTsy manohana ny ESP32 ny les satria tsy tafiditra ao anatin'ny ESP32 ny fitaovana ilaina ka tsy azo tohana. Raha manangana example, mba jereo ny README file ho an'ny tabilao Supported Targets. Raha misy izany ao anatin'izany ny tanjona ESP32, na tsy misy mihitsy ny latabatra, ny exampdia hiasa amin'ny ESP32.
Torohevitra fanampiny
Olana fahazoan-dàlana / dev / ttyUSB0 Miaraka amin'ny fizarana Linux sasany, mety ho azonao ny hafatra tsy nahomby tamin'ny fanokafana port / dev / ttyUSB0 rehefa mandrehitra ny ESP32. Azo voavaha izany amin'ny fampidirana ny mpampiasa ankehitriny amin'ny vondrona fifanakalozan-kevitra.
Python compatibility ESP-IDF dia manohana Python 3.7 na vao haingana. Amporisihina ny manavao ny rafitra fiasanao amin'ny dikan-teny vao haingana mahafa-po ity fepetra ity. Ny safidy hafa dia ny fametrahana Python avy amin'ny loharano na ny fampiasana rafitra fitantanana version Python toy ny pyenv.
Atombohy amin'ny Board Support Package Mba hanafainganana ny fanaovana prototype amin'ny tabilao fampivoarana sasany dia azonao atao ny mampiasa Board Support Packages (BSPs), izay mahatonga ny fanombohana ny birao iray ho mora toy ny fiantsoana asa vitsivitsy.
Espressif Systems
23 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Ny BSP mazàna dia manohana ireo singa fitaovana rehetra omena ao amin'ny birao fampandrosoana. Ankoatra ny famaritana pinout sy ny asa fanombohana, ny BSP dia mandefa mpamily ho an'ny singa ivelany toy ny sensor, fampisehoana, codec audio sns. Ny BSP dia zaraina amin'ny alàlan'ny IDF Component Manager, ka hita ao amin'ny IDF Component Registry. Henoy ny exampny fomba hanampiana ESP-WROVER-KIT BSP amin'ny tetikasanao: idf.py add-dependency esp_wrover_kit
More exampNy fampiasana BSP dia azo jerena ao amin'ny BSP examples folder.
Documents mifandraika Ho an'ireo mpampiasa efa mandroso te-hanamboatra ny fizotry ny fametrahana: · Fanavaozana ny fitaovana ESP-IDF amin'ny Windows · Mametraha fifandraisana amin'ny ESP32 · Eclipse Plugin · VSCode Extension · IDF Monitor
Fanavaozana ny fitaovana ESP-IDF amin'ny Windows
Mametraka fitaovana ESP-IDF mampiasa script Avy amin'ny Windows Command Prompt, manova ny lahatahiry misy ny ESPIDF. Dia mihazakazaka:
install.bat
Ho an'ny Powershell, miova amin'ny lahatahiry misy ny ESP-IDF. Dia mihazakazaka:
install.ps1
Izany dia hisintona sy hametraka ny fitaovana ilaina amin'ny fampiasana ESP-IDF. Raha toa ka efa napetraka ny dikan-teny manokana amin'ny fitaovana dia tsy hisy hetsika hatao. Ny fitaovana dia alaina ary apetraka ao anaty lahatahiry voafaritra mandritra ny fizotran'ny ESP-IDF Tools Installer. Amin'ny alàlan'ny default dia C:Usersusername.espressif.
Ampio fitaovana ESP-IDF amin'ny PATH amin'ny fampiasana script fanondranana ESP-IDF Tool installer dia mamorona hitsin-dàlana Start menu ho an'ny oESP-IDF Command Promptp. Ity hitsin-dàlana ity dia manokatra varavarankely Command Prompt izay efa misy ny fitaovana rehetra
misy. Amin'ny toe-javatra sasany, azonao atao ny miara-miasa amin'ny ESP-IDF amin'ny varavarankely Command Prompt izay tsy nanomboka nampiasa an'io hitsin-dàlana io. Raha izany no izy, araho ny toromarika etsy ambany mba hanampiana fitaovana ESP-IDF amin'ny PATH. Ao amin'ny baikon'ny baiko izay ilainao hampiasana ESP-IDF, miova amin'ny lahatahiry misy ny ESP-IDF, ary asio export.bat:
cd %userprofile%espesp-idf export.bat
Raha tsy izany, ao amin'ny Powershell izay ilainao hampiasana ESP-IDF, ovay amin'ny lahatahiry misy ny ESP-IDF, ary tanteraho ny export.ps1:
cd ~/esp/esp-idf export.ps1
Rehefa vita izany dia ho hita ao amin'ity baiko baiko ity ny fitaovana.
Manangana Fifandraisana Serial amin'ny ESP32 Ity fizarana ity dia manome torolalana ny fomba fametrahana fifandraisana serial eo amin'ny ESP32 sy ny PC.
Espressif Systems
24 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Ampifandraiso amin'ny PC ny ESP32 Ampifandraiso amin'ny PC ny birao ESP32 amin'ny alalan'ny tariby USB. Raha toa ka tsy mametraka ho azy ny mpamily fitaovana, fantaro ny USB amin'ny chip converter serial ao amin'ny birao ESP32 (na dongle mpanova ivelany), tadiavo amin'ny Internet ny mpamily ary apetraho. Ity ambany ity ny lisitry ny USB ho serial converter chips napetraka amin'ny ankamaroan'ny ESP32 boards novokarin'ny Espressif miaraka amin'ny rohy mankany amin'ny mpamily:
· CP210x: CP210x USB mankany amin'ny UART Bridge VCP Drivers · FTDI: FTDI Virtual COM Port Drivers Azafady, jereo ny torolalana ho an'ny mpampiasa amin'ny USB manokana ho an'ny chip converter serial ampiasaina. Ireo mpamily etsy ambony dia natao ho fanondroana. Amin'ny toe-javatra mahazatra, ny mpamily dia tokony hatambatra miaraka amin'ny rafitra miasa ary apetraka ho azy rehefa mampifandray ny birao amin'ny PC.
Jereo ny seranan-tsambo amin'ny Windows Jereo ny lisitry ny seranan-tsambo COM fantatra ao amin'ny Windows Device Manager. Esory ny ESP32 ary ampifandraiso indray, hanamarinana hoe iza no seranana nanjavona amin'ny lisitra ary avy eo dia miverina indray. Ny sary etsy ambany dia mampiseho seranan-tsambo ho an'ny ESP32 DevKitC sy ESP32 WROVER KIT
Sary 13: USB mankany amin'ny tetezana UART an'ny ESP32-DevKitC ao amin'ny Windows Device Manager
Hamarino ny seranan-tsambo amin'ny Linux sy macOS Raha hijery ny anaran'ny fitaovana ho an'ny seranan-tsambon'ny birao ESP32 anao (na dongle mpanova ivelany) dia araho in-droa ity baiko ity, voalohany miaraka amin'ny board / dongle nesorina, avy eo miaraka amin'ny plug. Ny seranana miseho fanindroany dia ilay ilainao: Linux
ls /dev/tty*
macOS
Espressif Systems
25 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Fig. 14: seranan-tsambo USB roa an'ny ESP-WROVER-KIT ao amin'ny Windows Device Manager
Espressif Systems
26 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
ls /dev/cu.* Fanamarihana: mpampiasa macOS: raha tsy hitanao ny seranan-tsambo dia jereo fa efa napetraka ny mpamily USB/serial. Jereo ny Fizarana Connect ESP32 amin'ny PC ho an'ny rohy mankany amin'ny mpamily. Ho an'ny macOS High Sierra (10.13), mety tsy maintsy avelanao ihany koa ny mitondra entana. Sokafy ny Préférences System -> Security & Privacy -> General ary jereo raha misy hafatra aseho eto momba ny oSystem Software avy amin'ny developer lp izay ny anaran'ny developer dia Silicon Labs na FTDI.
Mampiditra mpampiasa amin'ny fifanakalozan-dresaka amin'ny Linux Ny mpampiasa voarakitra an-tsoratra amin'izao fotoana izao dia tokony ho namaky sy nanoratra ny fidirana amin'ny seranana serial amin'ny USB. Amin'ny ankamaroan'ny fizarana Linux, izany dia atao amin'ny fampidirana ny mpampiasa amin'ny vondrona dialogout miaraka amin'ity baiko manaraka ity:
sudo usermod -a -G diaalout $USER
amin'ny Arch Linux dia atao amin'ny fampidirana ny mpampiasa amin'ny vondrona uucp miaraka amin'ity baiko manaraka ity:
sudo usermod -a -G uucp $USER
Ataovy azo antoka fa miditra indray ianao mba hahafahanao mahazo alalana mamaky sy manoratra ho an'ny seranan-tsambo.
Hamarino ny fifandraisana serial Hamarino izao fa mandeha ny fifandraisana serial. Azonao atao izany amin'ny alàlan'ny programa terminal serial amin'ny fanamarinana raha misy vokatra azo avy amin'ny terminal ianao aorian'ny famerenana ny ESP32. Ny tahan'ny baud console default amin'ny ESP32 dia 115200.
Windows sy Linux Amin'ity exampfa hampiasa ny mpanjifa PuTTY SSH izahay izay misy amin'ny Windows sy Linux. Azonao atao ny mampiasa programa serial hafa ary mametraka ny mari-pamantarana fifandraisana toy ny etsy ambany. Ampandehano ny terminal ary apetraho ny seranan-tsambo fantatra. Ny tahan'ny baud = 115200 (raha ilaina dia ovay ny tahan'ny baud default amin'ny chip ampiasaina), bits data = 8, bits stop = 1, ary parity = N. Ireto ambany ireto ny exampny pikantsary momba ny fametrahana ny seranan-tsambo sy ny masontsivana fampitana toy izany (raha lazaina amin'ny teny fohy hoe 115200-8-1-N) amin'ny Windows sy Linux. Tsarovy ny mifidy ny seranan-tsambo serial mitovy amin'izay hitanao amin'ny dingana etsy ambony. Avy eo sokafy ny seranan-tsambo serial ao amin'ny terminal ary jereo, raha hitanao misy log vita pirinty amin'ny ESP32. Ny votoatin'ny log dia miankina amin'ny fampiharana napetraka amin'ny ESP32, jereo ny Eksample Output.
Fanamarihana: Akatona ny terminal serial aorian'ny fanamarinana fa mandeha ny fifandraisana. Raha mitazona ny fivorian'ny terminal misokatra ianao, dia tsy ho azo idirana ny seranan-tsambo serial amin'ny fandefasana firmware any aoriana.
macOS Mba hialana amin'ny olana amin'ny fametrahana programa terminal serial, macOS dia manolotra ny baiko efijery. · Araka ny resahina ao amin'ny Check port amin'ny Linux sy macOS, mandehana:
ls /dev/cu.* · Tokony hahita vokatra mitovy amin'izany ianao:
/dev/cu.Bluetooth-Incoming-Port /dev/cu.SLAB_USBtoUART USBtoUART7
/dev/cu.SLAB_
· Ny vokatra dia hiova arakaraka ny karazana sy ny isan'ny boards mifandray amin'ny PC-nao. Avy eo safidio ny anaran'ny fitaovana ao amin'ny biraonao ary mihazakazaka (raha ilaina, ovay ny o115200 amin'ny tahan'ny baud default amin'ny chip ampiasaina):
screen /dev/cu.device_name 115200 Soloy ny anarana_fitaovana amin'ny anarana hita mandeha ls /dev/cu.*.
Espressif Systems
27 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Fig. 15: Fametrahana Serasera Serial ao amin'ny PuTTY amin'ny Windows
Espressif Systems
28 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Fig. 16: Fametrahana Serasera Serial amin'ny PuTTY amin'ny Linux
Espressif Systems
29 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
· Ny zavatra tadiavinao dia diary aseho amin'ny efijery. Ny votoatin'ny log dia miankina amin'ny fampiharana napetraka amin'ny ESP32, jereo ny Eksample Output. To exit the screen session type Ctrl-A + .
Fanamarihana: Aza adino ny miala amin'ny session screen rehefa avy nanamarina fa mandeha ny fifandraisana. Raha tsy mahavita izany ianao ary manidy ny varavarankelin'ny terminal, dia tsy ho azo idirana ny seranan-tsambo amin'ny fandefasana firmware any aoriana.
Example Output An example log dia aseho eto ambany. Avereno ny solaitrabe raha tsy mahita na inona na inona ianao. ary ny 8 jona 2016 00:22:57
voalohany: 0x5 (DEEPSLEEP_RESET), boot: 0x13 (SPI_FAST_FLASH_BOOT) ary ny 8 Jun 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: fotoana fanangonana 18:48:10
…
Raha hitanao ny famoahana log azo vakiana dia midika izany fa miasa ny fifandraisana serial ary vonona ny hanohy ny fametrahana ianao ary farany ny fampidinana ny fampiharana amin'ny ESP32.
Fanamarihana: Ho an'ny fandrindrana fampifandraisana an-telefaonina an-tserasera sasany, ny zana-tsipìka RTS & DTR dia tsy maintsy esorina ao amin'ny programa terminal alohan'ny hanombohan'ny ESP32 ary hamokatra vokatra serial. Miankina amin'ny hardware izany, ny ankamaroan'ny boards fampandrosoana (anisan'izany ny boards Espressif rehetra) dia tsy manana io olana io. Ny olana dia misy raha RTS & DTR dia mifandray mivantana amin'ny EN & GPIO0 pins. Jereo ny antontan-taratasy esptool raha mila fanazavana fanampiny.
Raha tonga eto ianao avy amin'ny dingana 5. Dingana voalohany amin'ny ESP-IDF rehefa mametraka s/w ho an'ny fampandrosoana ESP32, dia azonao atao ny manohy ny dingana 5. Dingana voalohany amin'ny ESP-IDF.
IDF Monitor IDF Monitor dia fandaharana amin'ny terminal serial izay mampita angon-drakitra serial mankany sy avy amin'ny seranan-tsambon'ny fitaovana kendrena. Manome endri-javatra manokana IDF ihany koa izy io. Ny IDF Monitor dia azo atomboka amin'ny tetikasa IDF amin'ny alàlan'ny fampandehanana idf.py monitor.
Kitendry hitsin-dàlana Mba hifaneraserana mora amin'ny IDF Monitor, ampiasao ny hitsin-dàlana hita ao amin'ny tabilao.
Espressif Systems
30 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Kitendry Shortcut Ctrl+] Ctrl+T
· Ctrl+T
· Ctrl+] · Ctrl+P
· Ctrl+R
· Ctrl+F
· Ctrl+A (na A)
· Ctrl+Y
· Ctrl+L
· Ctrl+I (na I)
· Ctrl+H (na H)
· Ctrl+X (na X)
Ctrl+C
Action
Description
Mialà amin'ny programa Menu fanehezan'ny fandosirana Alefaso any amin'ny lavitra ny toetran'ny sakafo
Alefaso any amin'ny lavitra ny toetra fivoahana
Avereno amin'ny bootloader ny kendrena hampiato ny fampiharana amin'ny alàlan'ny tsipika RTS
Avereno indray ny board kendrena amin'ny alàlan'ny RTS
Amboary sy tselatra ny tetikasa
Amboary sy tselatra ny fampiharana ihany
Atsaharo / tohizo ny fanontam-pirinty mivoaka amin'ny log
Atsaharo/ tohizo ny vokatra dia voatahiry ao amin'ny file
Fotoana fiatoana / tohizoamps
FANONTANA PRINTY
Asehoy ny hitsin-dàlana fitendry rehetra
Tsindrio ary araho amin'ny iray amin'ireo fanalahidy omena etsy ambany.
Mamerina ny kendrena, ho bootloader amin'ny alàlan'ny tsipika RTS (raha mifandray), ka tsy mandeha na inona na inona ny birao. Mahasoa rehefa mila miandry fitaovana hafa hanombohana ianao. Avereno indray ny birao kendrena ary atomboka indray ny fampiharana amin'ny alàlan'ny tsipika RTS (raha mifandray).
Atsaharo ny idf_monitor mba hampandehanana ny tanjona tselatra tetikasa, avy eo dia manohy ny idf_monitor. Izay loharano niova files dia atambatra indray ary avy eo averina tselatra. Ny tselatra miafina kendrena dia mandeha raha idf_monitor dia natomboka tamin'ny argument -E. Atsaharo ny idf_monitor mba hampandehanana ny lasibatry ny app-flash, avy eo dia manohy ny idf_monitor. Mitovy amin'ny tanjona tselatra, fa ny fampiharana lehibe ihany no aorina sy averina averina. Ny tanjona encrypted-app-flash dia mihazakazaka raha idf_monitor dia natomboka tamin'ny argument -E. Esory daholo ny angon-drakitra serie miditra rehefa ahetsiketsika. Mamela ny fiatoana haingana sy handinika ny vokatra log nefa tsy miala amin'ny fanaraha-maso. Mamorona a file ao amin'ny lahatahiry tetikasa ary ny vokatra dia nosoratana tamin'izany file mandra-pahafatin'io miaraka amin'ny hitsin-dàlana fitendry mitovy (na fivoahana IDF Monitor). Afaka manonta fotoana iray ny IDF Monitoramp eo am-piandohan’ny andalana tsirairay. Ny fotoanaamp Ny endrika dia azo ovaina amin'ny -timestamp-format argument andalana baiko.
Mialà amin'ny programa
Tapaka ny fampiharana mandeha
Miato ny IDF Monitor ary mampandeha debugger tetikasa GDB mba hanalana ny rindranasa amin'ny fotoana fandehanana. Izany dia mitaky :ref:CONFIG_ESP_SYSTEM_GDBSTUB_RUNTIME safidy mba ho azo.
Ny fanalahidy rehetra voatsindry, ankoatra ny Ctrl-] sy Ctrl-T, dia halefa amin'ny alàlan'ny seranan-tsambo.
endri-javatra manokana IDF
Famaritana adiresy mandeha ho azy Isaky ny mamoaka adiresin'ny kaody hexadecimal amin'ny endrika 0x4_______ ny ESP-IDF, dia mampiasa addr2line_ ny IDF Monitor mba hijery ny toerana ao amin'ny kaody loharano ary hahita ny anaran'ny asa.
Raha mianjera sy mikorontana ny fampiharana ESP-IDF, dia misy fanariam-pamokarana sy backtrace, toy ireto manaraka ireto:
Espressif Systems
31 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Ny Guru Meditation Error amin'ny karazana StoreProhibited dia niseho tamin'ny core 0. Exception dia
tsy voafehy.
Register dump:
PC
: 0x400f360d PS
: 0x00060330 A0
: 0x800dbf56 A1
:
0x3ffb7e00
A2
: 0x3ffb136c A3
: 0x00000005 A4
: 0x00000000 A5
:
0x00000000
A6
: 0x00000000 A7
: 0x00000080 A8
: 0x00000000 A9
:
0x3ffb7dd0
A10
: 0x00000003 A11
: 0x00060f23 A12
: 0x00060f20 A13
:
0x3ffba6d0
A14
: 0x00000047 A15
: 0x0000000f SAR
: 0x00000019 FANAZAVANA:
0x0000001d
EXCVADDR: 0x00000000 LBEG : 0x4000c46c AMPY : 0x4000c477 LCOUNT :
0x00000000
Backtrace: 0x400f360d:0x3ffb7e00 0x400dbf56:0x3ffb7e20 0x400dbf5e:0x3ffb7e40 0x400dbf82:0x3ffb7e60 0x400d071d:0x3ffb7e90
Ny IDF Monitor dia manampy antsipiriany bebe kokoa amin'ny fanariam-pako:
Ny Guru Meditation Error amin'ny karazana StoreProhibited dia niseho tamin'ny core 0. Exception dia
tsy voafehy.
Register dump:
PC
: 0x400f360d PS
: 0x00060330 A0
: 0x800dbf56 A1
:
0x3ffb7e00
0x400f360d: do_something_to_crash ao amin'ny /home/gus/esp/32/idf/examples/manomboka/
hello_world/main/./hello_world_main.c:57
(navoakan'i) inner_dont_crash ao amin'ny /home/gus/esp/32/idf/examples/get-start/hello_
world/main/./hello_world_main.c:52
A2
: 0x3ffb136c A3
: 0x00000005 A4
: 0x00000000 A5
:
0x00000000
A6
: 0x00000000 A7
: 0x00000080 A8
: 0x00000000 A9
:
0x3ffb7dd0
A10
: 0x00000003 A11
: 0x00060f23 A12
: 0x00060f20 A13
:
0x3ffba6d0
A14
: 0x00000047 A15
: 0x0000000f SAR
: 0x00000019 FANAZAVANA:
0x0000001d
EXCVADDR: 0x00000000 LBEG : 0x4000c46c AMPY : 0x4000c477 LCOUNT :
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 (nasehon'i) inner_dont_crash ao amin'ny /home/gus/esp/32/idf/examples/get-started/hello_ world/main/./hello_world_main.c:52 0x400dbf56: still_dont_crash ao amin'ny /home/gus/esp/32/idf/examples/get-started/hello_ world/main/./hello_world_main.c:47 0x400dbf5e: dont_crash ao amin'ny /home/gus/esp/32/idf/examples/get-started/hello_world/ main/./hello_world_main.c:42 0x400dbf82: app_main ao amin'ny /home/gus/esp/32/idf/examples/get-started/hello_world/main/ ./hello_world_main.c:33 0x400d071d: main_task ao amin'ny /home/gus/esp/32/idf/components/esp32/./cpu_start.c:254
Mba hamadika ny adiresy tsirairay, ny IDF Monitor dia mitantana izao baiko manaraka izao ao ambadika: xtensa-esp32-elf-addr2line -pfiaC -e build/PROJECT.elf ADDRESS
Fanamarihana: Apetraho amin'ny 0 ny fari-piainan'ny tontolo iainana ESP_MONITOR_DECODE na antsoy idf_monitor.py miaraka amin'ny baiko manokana
Espressif Systems
32 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
safidy: idf_monitor.py –disable-address-decoding mba hanesorana ny decoding adiresy.
Target Reset amin'ny fifandraisana Amin'ny alàlan'ny default, ny IDF Monitor dia hamerina ny tanjona rehefa mifandray aminy. Ny famerenana ny chip kendrena dia atao amin'ny alàlan'ny tsipika serial DTR sy RTS. Mba hisorohana ny IDF Monitor tsy hamerina ho azy ny tanjona amin'ny fifandraisana, antsoy ny IDF Monitor miaraka amin'ny safidy –no-reset (oh: idf_monitor.py –no-reset).
Fanamarihana: Ny safidy –no-reset dia mihatra amin'ny fihetsika mitovy na dia rehefa mampifandray ny IDF Monitor amin'ny seranana manokana (oh: idf.py monitor –no-reset -p [PORT]).
Famoahana ny GDB miaraka amin'ny GDBStub GDBStub dia endri-javatra ilaina amin'ny debugging runtime izay mandeha amin'ny kendrena ary mifandray amin'ny mpampiantrano amin'ny seranan-tsambo serial mba hahazoana baiko debugging. GDBStub dia manohana ny baiko toy ny famakiam-boky fahatsiarovana sy ny fari-piainana, ny fandinihana ny antso stack frames sns.TAG debugging, tsy mila fitaovana manokana (toy ny JTAG amin'ny tetezana USB) satria ny fifandraisana dia vita tanteraka amin'ny seranan-tsambo. Ny kendrena iray dia azo amboarina hampandeha ny GDBStub ao ambadika amin'ny fametrahana ny CONFIG_ESP_SYSTEM_PANIC ho GDBStub amin'ny fotoana fandehanana. Ny GDBStub dia hihazakazaka ao ambadika mandra-pahatongan'ny hafatra Ctrl+C alefa amin'ny seranan-tsambo ary mahatonga ny GDBStub ho tapaka (izany hoe, atsaharo ny fanatanterahana) ny programa, ka mamela an'i GDBStub mitantana ny baiko debugging. Fanampin'izay, azo amboarina hampandeha ny GDBStub amin'ny fianjerana amin'ny alàlan'ny fametrahana ny CONFIG_ESP_SYSTEM_PANIC amin'ny GDBStub ny CONFIG_ESP_SYSTEM_PANIC amin'ny tahotra. Rehefa misy fianjerana, GDBStub dia hamoaka lamina tady manokana eo ambonin'ny seranan-tsambo mba hanondroana fa mandeha izy. Amin'ireo toe-javatra roa ireo (izany hoe, mandefa hafatra Ctrl+C, na mandray ny lamina tady manokana), ny IDF Monitor dia hanomboka ho azy ny GDB mba ahafahan'ny mpampiasa mandefa baiko debugging. Aorian'ny fivoahan'ny GDB dia averina amin'ny alàlan'ny tsipika serial RTS ny tanjona. Raha tsy mifandray ity tsipika ity, dia afaka mamerina ny kendreny ny mpampiasa (amin'ny fanindriana ny bokotra Reset boardns).
Fanamarihana: Ao ambadika, ny IDF Monitor dia mitantana ity baiko manaraka ity hanombohana ny GDB:
xtensa-esp32-elf-gdb -ex "mametraka serial baud BAUD" -ex "target remote PORT" -ex interrupt build/PROJECT.elf :idf_target:`Salama NAME chip`
Output Filtering IDF monitor dia azo antsoina hoe idf.py monitor –print-filter=”xyz”, izay –print-filter no mari-pamantarana ho an'ny sivana vokatra. Ny sandan'ny default dia tady tsy misy na inona na inona, izay midika fa vita pirinty ny zava-drehetra.
Ny famerana ny zavatra ho pirinty dia azo faritana ho andianatag>: zavatra aizatag> dia ny tag string ary dia tarehin-tsoratra avy amin'ny andiana {N, E, W, I, D, V, *} manondro ambaratonga iray ho an'ny logging.
Ho an'ny exampny, PRINT_FILTER=”tag1:W" mifanandrify sy manonta afa-tsy ny vokatra nosoratana tamin'ny ESP_LOGW("tag1", ...) na amin'ny ambaratonga ambany kokoa, izany hoe ESP_LOGE("tag1″, …). Tsy voafaritra a na mampiasa * default amin'ny ambaratonga Verbose.
Fanamarihana: Ampiasao ny logging voalohany mba hanesorana amin'ny fanangonana ireo vokatra tsy ilainao amin'ny alàlan'ny tranomboky logging. Ny fanivanana vokatra miaraka amin'ny fanaraha-maso IDF dia vahaolana faharoa izay mety ilaina amin'ny fanitsiana ny safidy fanivanana nefa tsy mamerina ny fampiharana.
Ny fampiharanao tags tsy tokony ahitana habaka, asterisk *, na tsangantsangana : mba hifanaraka amin'ny endri-panasivana mivoaka.
Raha tsy arahin'ny fiverenan'ny fiara ny andalana farany amin'ny vokatra ao amin'ny app-nao, dia mety ho sahiran-tsaina ny fanivanana vokatra, izany hoe manomboka manonta ny tsipika ny mpanara-maso ary mahita avy eo fa tsy tokony ho nosoratana ilay tsipika. Olana efa fantatra izany ary azo ialana amin'ny fampidirana foana ny fiverenan'ny kalesy (indrindra rehefa tsy misy vokatra manaraka avy hatrany).
Espressif Systems
33 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Exampny fitsipika sivana:
· * azo ampiasaina hampitoviana na inona na inona tags. Na izany aza, ny tady PRINT_FILTER =”*:I tag1:E” momba ny tag1 manonta fahadisoana ihany, satria ny fitsipika momba ny tag1 dia manana laharam-pahamehana kokoa noho ny fitsipika ho an'ny *.
· Ny fitsipika default (foana) dia mitovy amin'ny *:V satria mifanandrify amin'ny tsirairay tag amin'ny ambaratonga Verbose na ambany dia midika hoe mifanentana amin'ny zava-drehetra.
· Ny “*:N” dia manafoana tsy ny vokatra azo avy amin'ny asa firaketana an-tsoratra ihany, fa ny pirinty vita amin'ny printf, sns. Mba hisorohana izany, ampiasao *:E na ambaratonga ambony kokoa.
· Fitsipika “tag1:V", "tag1:v", "tag1:", "tag1:*", arytag1” dia mitovy. · Fitsipika “tag1:W tag1:E” dia mitovy amin’ny “tag1: E” satria misy vokany mitovy tag
anarana dia misolo ny teo aloha. · Fitsipika “tag1:i tag2:W” ihany no atao pirinty tag1 amin'ny ambaratonga Info verbosity na ambany ary tag2 amin'ny fampitandremana
haavon'ny verbosity na ambany. · Fitsipika “tag1:i tag2:W tag3:N" dia mitovy amin'ny teo aloha satria tag3:N mamaritra
IZAY tag3 tsy tokony atao pirinty. · tag3: N amin'ny fitsipika "tag1:i tag2:W tag3:N *:V” dia misy dikany kokoa satria tsy misy tag3:n ny
tagHafatra 3 no azo natao pirinty; ny lesoka ho tag1 ary tag2 dia hatao pirinty amin'ny haavon'ny verbosity voafaritra (na ambany) ary ny zavatra hafa rehetra dia hatao pirinty amin'ny alàlan'ny default.
Fasivanana sarotra kokoa Example Ity snippet log manaraka ity dia azo tsy misy safidy sivana:
entana: 0x40078000, len: 13564 fidirana 0x40078d4c E (31) esp_image: sary ao amin'ny 0x30000 dia manana byte majika tsy mety W (31) esp_image: sary ao amin'ny 0x30000 dia tsy mety SPI mode 255 E (39) bootable (39) bootable (39) cpu_start: Pro cpu up. I (569) heap_init: Initializing. RAM azo omena dynamic: I (603) cpu_start: Pro cpu start user code D (309) light_driver: [light_init, 74]:status: 1, mode: 2 D (318) vfs: esp_vfs_register_fd_range dia mahomby amin'ny range <54; 64) ary VFS ID 1 I (328) wifi: asa mpamily wifi: 3ffdbf84, aloha: 23, stack: 4096, core = 0
Ny vokatra azo ho an'ny safidy sivana PRINT_FILTER=”wifi esp_image:E light_driver:I” dia omena eto ambany:
E (31) esp_image: sary amin'ny 0x30000 dia manana byte majika I (328) wifi: asa mpamily wifi: 3ffdbf84, prio: 23, stack: 4096, core = 0
Ny safidy "PRINT_FILTER = "light_driver: D esp_image: N boot: N cpu_start: N vfs: N wifi: N *: V" dia mampiseho izao vokatra manaraka izao:
entana:0x40078000,len:13564 fidirana 0x40078d4c I (569) heap_init: fanombohana. RAM azo ampiasaina amin'ny fizarana mavitrika: D (309) light_driver: [light_init, 74]: status: 1, mode: 2
Olana fantatra amin'ny IDF Monitor
Olana voamarika amin'ny Windows
· Ny fanalahidin'ny zana-tsipìka, ary koa ny fanalahidy hafa, dia tsy mandeha amin'ny GDB noho ny fetran'ny Windows Console. · Indraindray, rehefa oidf.pypexits, dia mety hijanona hatramin'ny 30 segondra alohan'ny hiverenan'ny IDF Monitor. · Rehefa mandeha ny ogdbpis dia mety hijanona vetivety izy alohan'ny hanombohany mifandray amin'ny GDBStub.
Espressif Systems
34 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Atombohy ny Fametrahana Toolchain Standard ho an'ny Linux sy macOS
Fametrahana dingana isan-dingana Ity dia tondrozotra amin'ny antsipiriany hitondrana anao amin'ny dingana fametrahana.
Fametrahana tontolo iainana fampandrosoana Ireto ny dingana amin'ny fametrahana ny ESP-IDF ho an'ny ESP32 anao. · Dingana 1. Mametraka fepetra takiana · Dingana 2. Makà ESP-IDF · Dingana 3. Amboary ny fitaovana · Dingana 4. Amboary ny fari-piainan'ny tontolo iainana · Dingana 5. Dingana voalohany amin'ny ESP-IDF
Dingana 1. Mametraka fepetra takiana Raha te hampiasa ny ESP-IDF miaraka amin'ny ESP32 ianao dia mila mametraka fonosana rindrambaiko mifototra amin'ny Rafitra fiasanao. Ity torolàlana fananganana ity dia hanampy anao amin'ny fametrahana ny zava-drehetra amin'ny rafitra mifototra amin'ny Linux sy macOS.
Ho an'ny mpampiasa Linux Mba hanangonana mampiasa ESP-IDF dia mila maka ireto fonosana manaraka ireto ianao. Ny baiko mihazakazaka dia miankina amin'ny fizarana Linux ampiasainao:
· Ubuntu sy 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 fanavaozana && sudo yum install git wget flex bison gperf python3 cmake ninja-build ccache dfu-util libusbx
Ny CentOS 7 dia mbola tohanana fa ny CentOS version 8 dia atolotra ho an'ny traikefa mpampiasa tsara kokoa. · Arch: sudo pacman -S –mila gcc git manao flex bison gperf python cmake ninja ccache dfu-util libusb
Fanamarihana: · CMake version 3.16 na vao haingana no ilaina raha ampiasaina amin'ny ESP-IDF. Alefaso ny otools/idf_tools.py install cmakepto mametraka dikan-teny mety raha tsy manana izany ny dikan-teninao OS. · Raha tsy hitanao ny fizarana Linux anao amin'ny lisitra etsy ambony dia jereo azafady ny antontan-taratasiny mba hahitana izay baiko ampiasaina amin'ny fametrahana fonosana.
Ho an'ny mpampiasa macOS ESP-IDF dia hampiasa ny kinova Python napetraka amin'ny alàlan'ny macOS. · Mametraka CMake & Ninja build: Raha manana HomeBrew ianao dia afaka mihazakazaka: brew install cmake ninja dfu-util Raha manana MacPorts ianao dia afaka mihazakazaka: sudo port install cmake ninja dfu-util Raha tsy izany dia jereo ny pejin-tranonkala CMake sy Ninja momba ny fampidinana ny fametrahana macOS.
Espressif Systems
35 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
· Ampirisihina mafy ny hametraka ccache ho an'ny fananganana haingana kokoa. Raha manana HomeBrew ianao dia azo atao amin'ny alàlan'ny brew install ccache na sudo port install ccache amin'ny MacPorts.
Fanamarihana: Raha misy hadisoana toy izao aseho mandritra ny dingana rehetra: xcrun: hadisoana: lalan'ny mpamorona mavitrika tsy mety (/Library/Developer/CommandLineTools), tsy hita ny xcrun amin'ny: /Library/Developer/CommandLineTools/usr/bin/xcrun
Avy eo dia mila mametraka ny fitaovana baiko XCode ianao hanohizana. Azonao atao ny mametraka ireo amin'ny alàlan'ny fampandehanana xcode-select –install.
Mpampiasa Apple M1 Raha mampiasa sehatra Apple M1 ianao ka mahita hadisoana toy izao: FAMPITANDREMANA: ny lahatahiry ho an'ny fitaovana xtensa-esp32-elf version esp-2021r2-patch3-8.4.0 dia misy, saingy tsy hita ny fitaovana ERROR: fitaovana xtensa-esp32-elf dia tsy misy dikan-teny napetraka. Alefaso azafady ny 'install.sh' hametrahana azy.
na: zsh: karazana CPU ratsy azo ampiasaina: ~/.espressif/tools/xtensa-esp32-elf/esp-2021r2patch3-8.4.0/xtensa-esp32-elf/bin/xtensa-esp32-elf-gcc
Avy eo dia mila mametraka Apple Rosetta 2 ianao amin'ny alàlan'ny fampandehanana / usr / sbin / softwareupdate -install-rosetta -agree-to-license
Fametrahana Python 3 Miorina amin'ny naoty famoahana macOS Catalina 10.15, ny fampiasana ny Python 2.7 dia tsy soso-kevitra ary ny Python 2.7 dia tsy ampidirina amin'ny alàlan'ny default amin'ny dikan-teny macOS ho avy. Jereo izay Python anananao amin'izao fotoana izao: python -version
Raha toa ny Python 2.7.17 ny vokatra dia Python 2.7 ny mpandika teny ho anao. Raha izany no izy, jereo koa raha tsy efa napetraka ao amin'ny solosainao ny Python 3: python3 -version
Raha mamerina hadisoana ilay baiko etsy ambony dia midika izany fa tsy napetraka ny Python 3. Ity ambany ity ny faranyview ny dingana fametrahana Python 3.
· Ny fametrahana amin'ny HomeBrew dia azo atao toy izao: brew install python3
· Raha manana MacPorts ianao dia afaka mihazakazaka: sudo port install python38
Dingana 2. Makà ESP-IDF Mba hamoronana rindranasa ho an'ny ESP32 dia mila ny tranomboky rindrambaiko omen'i Espressif ao amin'ny tahiry ESP-IDF ianao. Raha te-hahazo ESP-IDF, mandehana mankany amin'ny lahatahiry fametrahana anao ary asio clone ny tahiry miaraka amin'ny git clone, manaraka ny torolàlana etsy ambany manokana amin'ny rafitra fiasanao. Sokafy ny Terminal, ary araho ireto baiko manaraka ireto:
Espressif Systems
36 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
mkdir -p ~/esp cd ~/esp git clone -b v5.0.9 – miverimberina https://github.com/espressif/esp-idf.git
ESP-IDF dia alaina ao amin'ny ~/esp/esp-idf. Jereo ny dikan-teny ESP-IDF raha mila fanazavana momba ny dikan-teny ESP-IDF hampiasaina amin'ny toe-javatra iray.
Dingana 3. Amboary ny fitaovana Ankoatra ny ESP-IDF, mila mametraka ny fitaovana ampiasain'ny ESP-IDF koa ianao, toy ny compiler, debugger, Python packages, sns, ho an'ny tetikasa manohana ny ESP32. cd ~/esp/esp-idf ./install.sh esp32
na miaraka amin'ny akoran-trondro cd ~/esp/esp-idf ./install.fish esp32
Ireo baiko etsy ambony dia mametraka fitaovana ho an'ny ESP32 ihany. Raha mikasa ny hamolavola tetik'asa ho an'ny kendrena chip bebe kokoa ianao dia tokony tanisao daholo izy ireo ary mihazakazaka ho an'ny example: cd ~/esp/esp-idf ./install.sh esp32,esp32s2
na miaraka amin'ny akoran-trondro cd ~/esp/esp-idf ./install.fish esp32,esp32s2
Mba hametrahana fitaovana ho an'ny tanjona tohanana rehetra dia araho ity baiko manaraka ity: cd ~/esp/esp-idf ./install.sh all
na miaraka amin'ny Fish shell cd ~/esp/esp-idf ./install.fish all
Fanamarihana: Ho an'ny mpampiasa macOS, raha misy hadisoana toy izao aseho mandritra ny dingana rehetra:urlhadisoana misokatra [SSL: CERTIFICATE_VERIFY_FAILED] fanamarinana tsy nahomby: tsy afaka nahazo taratasy fanamarinana avy any an-toerana (_ssl.c:xxx)
Azonao atao ny mampandeha ny Install Certificates.command ao amin'ny lahatahiry Python amin'ny solosainao mba hametrahana mari-pankasitrahana. Raha mila fanazavana fanampiny dia jereo ny Download Error ESP-IDF Tools.
Anarana iombonana amin'ny File Downloads Ny installer fitaovana dia misintona maromaro files mifamatotra amin'ny GitHub Releases. Raha miadana ny fidirana amin'ny GitHub dia azo atao ny mametraka fari-piainan'ny tontolo iainana mba hisafidianana mpizara fampidinana Espressifns ho an'ny fampidinana fananana GitHub.
Fanamarihana: Ity toe-javatra ity dia mifehy ny fitaovana tsirairay alaina avy amin'ny famoahana GitHub, tsy manova ny URLs ampiasaina hidirana amin'ny tahiry Git rehetra.
Raha tianao ny mpizara fampidinana Espressif rehefa mametraka fitaovana, ampiasao ireto baiko manaraka ireto rehefa mihazakazaka install.sh:
Espressif Systems
37 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
cd ~/esp/esp-idf export IDF_GITHUB_ASSETS=”dl.espressif.com/github_assets” ./install.sh
Fanamboarana ny lalan'ny fametrahana fitaovana Ny script nampidirina tamin'ity dingana ity dia mametraka fitaovana fanangonana takian'ny ESP-IDF ao anatin'ny lahatahiry ho an'ny mpampiasa: $HOME/.espressif amin'ny Linux. Raha te-hametraka ireo fitaovana ao anaty lahatahiry hafa ianao dia apetraho ny fari-piainan'ny tontolo iainana IDF_TOOLS_PATH alohan'ny hampandehanana ny sora-baventy. Ataovy azo antoka fa manana alalana ampy hamakiana sy hanoratra ity lalana ity ny kaontinao mpampiasa. Raha manova ny IDF_TOOLS_PATH dia ataovy azo antoka fa mitovy ny sandany isaky ny mandeha ny script Install (install. bat, install.ps1 na install.sh) sy ny script Export (export.bat, export.ps1 na export.sh).
Dingana 4. Amboary ny fari-piainan'ny tontolo iainana Ny fitaovana napetraka dia tsy mbola ampiana amin'ny fari-piainan'ny tontolo PATH. Mba hahatonga ny fitaovana azo ampiasaina amin'ny baiko dia tsy maintsy apetraka ny fari-piainan'ny tontolo iainana sasany. ESP-IDF dia manome script hafa izay manao izany. Ao amin'ny terminal izay hampiasanao ny ESP-IDF, mandehana:
. $HOME/esp/esp-idf/export.sh
na ho an'ny trondro (tsy tohanan'ny trondro version 3.0.0 ihany):
. $HOME/esp/esp-idf/export.fish
Mariho ny elanelana eo anelanelan'ny teboka voalohany sy ny lalana! Raha mikasa ny hampiasa esp-idf matetika ianao dia afaka mamorona alias ho an'ny fanatanterahana export.sh:
1. Adikao ary apetaho amin'ny shellns pro anao ity baiko manaraka ityfile (.profile, .bashrc, .zprofile, sns.)
alias get_idf='. $HOME/esp/esp-idf/export.sh' 2. Havaozy ny fanitsiana amin'ny alàlan'ny fanombohana indray ny session terminal na amin'ny alàlan'ny fampandehanana loharano [lalana mankany amin'ny profile],
ho example, loharano ~/.bashrc. Azonao atao izao ny mihazakazaka get_idf mba hananganana na hamelombelona ny tontolo esp-idf amin'ny fivoriana terminal rehetra. Ara-teknika, azonao atao ny manampy export.sh amin'ny shellns pro anaofile mivantana; tsy soso-kevitra anefa izany. Ny fanaovana izany dia manetsika ny tontolo virtoaly IDF isaky ny fivoriana farany (ao anatin'izany ireo izay tsy ilàna IDF), mandresy ny tanjon'ny tontolo virtoaly ary mety hisy fiantraikany amin'ny rindrambaiko hafa.
Dingana 5. Dingana Voalohany amin'ny ESP-IDF Ankehitriny satria feno ny fepetra rehetra, ny lohahevitra manaraka dia hitarika anao amin'ny fomba hanombohana ny tetikasanao voalohany. Ity torolàlana ity dia hanampy anao amin'ny dingana voalohany amin'ny fampiasana ESP-IDF. Araho ity torolalana ity hanombohana tetikasa vaovao amin'ny ESP32 ary manangana, tselatra ary manara-maso ny fivoahan'ny fitaovana.
Fanamarihana: Raha mbola tsy nametraka ESP-IDF ianao dia mandehana any amin'ny Fametrahana ary araho ny torolalana mba hahazoana ny rindrambaiko rehetra ilaina amin'ny fampiasana ity torolàlana ity.
Manomboha Tetikasa Ankehitriny dia vonona ny hanomana ny fangatahanao ho an'ny ESP32 ianao. Afaka manomboka amin'ny tetikasa getstarted/hello_world avy amin'ny examples directory ao amin'ny ESP-IDF.
Zava-dehibe: Ny rafitra fananganana ESP-IDF dia tsy mahazaka habaka amin'ny lalana mankany amin'ny ESP-IDF na amin'ny tetikasa.
Adikao ny tetikasa get-started/hello_world amin'ny ~/esp directory:
Espressif Systems
38 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
cd ~/esp cp -r $IDF_PATH/examples/get-start/hello_world .
Fanamarihana: Misy isan-karazany ny example projet ao amin'ny examples directory ao amin'ny ESP-IDF. Azonao atao ny mandika ny tetikasa rehetra amin'ny fomba mitovy amin'ny aseho etsy ambony ary mampandeha azy. Azo atao koa ny manorina examples in-place nefa tsy maka tahaka azy aloha.
Ampifandraiso amin'ny solosainao izao ny fitaovanao ary ampifandraiso amin'ny solosaina ny biraonao ESP32 ary jereo ny seranan-tsambo misy ny solaitrabe. Ny seranan-tsambo serial dia manana ireto modely nomena ireto:
· Linux: manomboka amin'ny /dev/tty · macOS: manomboka amin'ny /dev/cu. Raha tsy azonao antoka ny fomba hijerena ny anaran'ny seranan-tsambo, azafady jereo ny Mametraha Serial Connection amin'ny ESP32 ho an'ny antsipiriany feno.
Fanamarihana: Tehirizo mora foana ny anaran'ny seranan-tsambo satria ilainao izany amin'ny dingana manaraka.
Ampifanaraho amin'ny lahatahiry hello_world anao ny tetikasanao, apetraho ho tanjona ny ESP32, ary tanteraho ny menuconfig utility configuration. cd ~/esp/hello_world idf.py set-target esp32 idf.py menuconfig
Aorian'ny fanokafana tetikasa vaovao dia tokony hametraka ny tanjona amin'ny idf.py set-target esp32 aloha ianao. Mariho fa ny fananganana sy ny fanamboarana efa misy ao amin'ny tetikasa, raha misy, dia ho voafafa sy hatomboka amin'ity dingana ity. Ny lasibatra dia mety ho voatahiry ao amin'ny fari-piainan'ny tontolo iainana mba handingana ity dingana ity mihitsy. Jereo ny Select the Target Chip: set-target raha mila fanazavana fanampiny. Raha vita tsara ireo dingana teo aloha dia miseho ity menu manaraka ity:
Fig. 17: Fanamboarana tetikasa - varavarankely an-trano Mampiasa an'ity sakafo ity ianao hananganana fari-pitsipika manokana momba ny tetikasa, ohatra, anarana sy tenimiafina Wi-Fi, ny hafainganam-pandehan'ny processeur, sns.ample mihazakazaka miaraka
Espressif Systems
39 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
config default.
Fanamarihana: Raha mampiasa board ESP32-DevKitC ianao miaraka amin'ny module ESP32-SOLO-1, na board ESP32-DevKitM-1 miaraka amin'ny module ESP32-MIN1-1(1U), azafady avelao ny maody fototra tokana (CONFIG_FREERTOS_UNICORE) ao amin'ny menuconfig alohan'ny handrehitra examples.
Fanamarihana: Mety tsy mitovy ny lokon'ny sakafo ao amin'ny terminalo. Azonao atao ny manova ny endrika amin'ny safidy -style. Alefaso azafady idf.py menuconfig –help raha mila fanazavana fanampiny.
Raha mampiasa ny iray amin'ireo birao fampandrosoana tohana ianao, dia azonao atao ny manafaingana ny fivoaranao amin'ny alàlan'ny fampiasana Board Support Package. Jereo ny toro-hevitra fanampiny raha mila fanazavana fanampiny.
Amboary ny tetikasa Amboary ny tetikasa amin'ny alàlan'ny fampandehanana:
idf.py fananganana
Ity baiko ity dia hanangona ny fampiharana sy ny singa ESP-IDF rehetra, avy eo dia hamokatra bootloader, latabatra fisarahana ary binaries fampiharana.
$ idf.py build Mandeha cmake ao amin'ny lahatahiry /path/to/hello_world/build Manatanteraka ny “cmake -G Ninja –warn-uninitialized /path/to/hello_world”… Mampitandrina momba ny soatoavina tsy fantatra. — Hita Git: /usr/bin/git (hitana dikan-teny “2.17.0”) — Manangana singa aws_iot tsy misy na inona na inona noho ny fanamboarana — Anaran'ny singa: … — Lalana singa: …
… (tsipika bebe kokoa amin'ny famoahana rafitra fananganana)
[527/527] Mamorona hello_world.bin esptool.py v2.3.1
Vita ny fananganana tetikasa. Raha tselatra dia araho ity baiko ity: ../../../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. bin build 0x1000 build/bootloader/bootloader.bin 0x8000 build/partition_table/ partition-table.bin na mandehana 'idf.py -p PORT flash'
Raha tsy misy lesoka dia hamita ny fananganana amin'ny famoronana ny firmware binary .bin files.
Atsipazo eo amin'ny fitaovana Ampidiro eo amin'ny solaitrabe ESP32 ireo binary vao naorinao (bootloader.bin, partition-table.bin ary hello_world.bin) eo amin'ny solaitrao ESP32:
idf.py -p PORT [-b BAUD] tselatra
Soloy ny PORT amin'ny anaranao seranan-tsambo ESP32 boardns. Azonao atao koa ny manova ny tahan'ny baud flasher amin'ny fanoloana ny BAUD amin'ny tahan'ny baud ilainao. Ny tahan'ny baud default dia 460800. Raha mila fanazavana fanampiny momba ny tohan-kevitra idf.py dia jereo idf.py.
Fanamarihana: Ny safidy tselatra dia manangana sy mamelatra ny tetikasa, noho izany dia tsy ilaina ny fampandehanana idf.py build.
Espressif Systems
40 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Nisedra olana nandritra ny tselatra? Raha mihazakazaka ny baiko nomena ianao ary mahita lesoka toy ny tsy nahomby ny connectp, mety misy antony maromaro mahatonga izany. Ny iray amin'ireo antony dia mety ho olana sedrain'ny esptool.py, ilay fitaovana antsoina amin'ny rafitra fananganana hamerenana ny chip, hifanerasera amin'ny bootloader ROM, ary flash firmware. Ny vahaolana tsotra iray hanandramana dia ny famerenana amin'ny tanana voalaza etsy ambany, ary raha tsy manampy dia afaka mahita antsipiriany bebe kokoa momba ny olana mety hitranga amin'ny Famahana olana.
esptool.py dia mamerina mandeha ho azy ny ESP32 amin'ny alàlan'ny fanamafisana ny tsipika fanaraha-maso DTR sy RTS amin'ny USB mankany amin'ny chip converter serial, izany hoe FTDI na CP210x (raha mila fanazavana fanampiny dia jereo ny Mametraha fifandraisana amin'ny ESP32). Ny tsipika fanaraha-maso DTR sy RTS dia mifamatotra amin'ny tsipika GPIO0 sy CHIP_PU (EN) an'ny ESP32, ka miova ny vol.tagNy haavon'ny DTR sy RTS dia handefa ny ESP32 amin'ny fomba Download Firmware. Amin'ny maha example, jereo ny skema ho an'ny birao fampandrosoana ESP32 DevKitC.
Amin'ny ankapobeny, tsy tokony hanana olana amin'ny biraon'ny fampandrosoana ofisialy esp-idf ianao. Na izany aza, tsy afaka mamerina ny fitaovanao ho azy ny esptool.py amin'ireto tranga manaraka ireto:
· Tsy manana tsipika DTR sy RTS mifandray amin'ny GPIO0 sy CHIP_PU ny fitaovanao.
Miankina amin'ny karazana fitaovana anananao, dia mety ho azo atao ihany koa ny mametraka ny birao ESP32 anao amin'ny maodely Download Firmware (reset).
· Ho an'ny takelaka fampandrosoana novokarin'ny Espressif, ity fampahalalana ity dia azo jerena ao amin'ny torolalana fanombohana tsirairay na torolàlana momba ny mpampiasa. Ho an'ny exampary, raha hamerenana amin'ny tanana ny birao fampandrosoana ESP-IDF, tazony ny bokotra Boot (GPIO0) ary tsindrio ny bokotra EN (CHIP_PU).
· Ho an'ny karazana fitaovana hafa, andramo misintona GPIO0 midina.
Normal Operation Rehefa mitselatra dia ho hitanao ny log de output mitovy amin'ireto manaraka ireto:
… 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-boot0.0bin. 0x10000 hello_world.bin esptool.py v3.0-dev Serial port /dev/ttyUSB0 Mampifandray…….._ Chip dia ESP32D0WDQ6 (fanavaozana 0) Endriny: WiFi, BT, Dual Core, Coding Scheme Tsy misy Crystal dia 40MHz MAC: 24:0atubb:c4:0.4… mihazakazaka… Manova ny tahan'ny baud ho 460800 Niova. Manefa ny haben'ny tselatra… Namboarina 3072 byte ho 103… Manoratra amin'ny 0x00008000… (100 %) Nanoratra 3072 octet (103 voatsindry) amin'ny 0x00008000 tao anatin'ny 0.0 segondra (5962.8 kbit/s voamarina). 26096 octares nopotserina ho 15408… Manoratra amin'ny 0x00001000… (100 %) Nanoratra 26096 octet (15408 voatsindry) amin'ny 0x00001000 ao anatin'ny 0.4 segondra (546.7 kbit/s nohamarinina). 147104 octares amin'ny 77364… Manoratra amin'ny 0x00010000… (20 %) Manoratra amin'ny 0x00014000… (40 %) Manoratra amin'ny 0x00018000… (60 %) Manoratra amin'ny 0x0001c000%)
(mitohy amin'ny pejy manaraka)
Espressif Systems
41 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
(tohiny avy amin'ny pejy teo aloha) Manoratra amin'ny 0x00020000… (100 %) Nanoratra 147104 octet (77364 compresses) amin'ny 0x00010000 tao anatin'ny 1.9 segondra (effective 615. 5 kbit/s)… Hash ny angona voamarina.
Miala… Famerenana mafy amin'ny alalan'ny pin RTS… Vita
Raha tsy misy olana amin'ny fiafaran'ny fizotran'ny tselatra, dia hamerina ny birao ary hanomboka theohello_worldpapplication. Raha tianao ny mampiasa ny Eclipse na VS Code IDE fa tsy ny idf.py dia jereo ny Eclipse Plugin, VSCode Extension.
Araho ny Output Raha hijerena raha toa ka mandeha tokoa ny ohello_worldpis dia soraty idf.py -p PORT monitor (Aza adino ny manolo ny PORT amin'ny anaran'ny seranan-tsambonao). Ity baiko ity dia manomboka ny fampiharana IDF Monitor:
$ idf.py -p monitor Mandeha idf_monitor ao anaty lahatahiry […]/esp/hello_world/build Manatanteraka “python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_ world/build/hello_world.elf”… — idf_monitor on 115200 —– Mialà: Ctrl+] | Menu: Ctrl+T | Fanampiana: Ctrl+T arahin'ny Ctrl+H –ets 8 Jun 2016 00:22:57
voalohany: 0x1 (POWERON_RESET), boot: 0x13 (SPI_FAST_FLASH_BOOT) ary ny 8 Jun 2016 00:22:57 …
Aorian'ny fikoriana ny diarin'ny fanombohana sy ny diagnostika dia tokony ho hitanao ny oHello world!navoakan'ny fampiharana.
… Hello World! Averina ao anatin'ny 10 segondra… Ity dia puce esp32 misy core(s) CPU 2, WiFi/BT/BLE, fanavaozana silisiôma 1, tselatra ivelany 2MB Habe antonony maimaim-poana farany indrindra: 298968 bita Miverina ao anatin'ny 9 segondra… Miverina ao anatin'ny 8 segondra… Miverina ao anatin'ny 7 segondra…
Mba hialana amin'ny fanaraha-maso IDF dia ampiasao ny hitsin-dàlana Ctrl+]. Raha tsy nahomby ny fanaraha-maso IDF taoriana kelin'ny fampiakarana, na raha tsy ireo hafatra etsy ambony ianao dia mahita fako kisendrasendra mitovy amin'ny omena etsy ambany, dia azo inoana fa mampiasa kristaly 26 MHz ny biraonao. Ny ankamaroan'ny famolavolana boards dia mampiasa 40 MHz, ka ny ESP-IDF dia mampiasa an'io matetika io ho sanda mahazatra.
Raha manana olana toy izany ianao dia ataovy izao manaraka izao:
1. Mialà amin'ny monitor. 2. Miverena amin'ny menuconfig. 3. Mandehana any amin'ny Component config > Hardware Settings > Main XTAL Config > Main XTAL
matetika, dia ovay ny CONFIG_XTAL_FREQ_SEL ho 26 MHz. 4. Aorian'izay, amboary sy tselatra indray ny fampiharana.
Espressif Systems
42 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Ao amin'ny ESP-IDF amin'izao fotoana izao, ny frequence XTAL lehibe tohanan'ny ESP32 dia toy izao manaraka izao:
· 26 MHz · 40 MHz
Fanamarihana: Azonao atao ny manambatra ny fanorenana, ny tselatra ary ny fanaraha-maso amin'ny dingana iray amin'ny alàlan'ny fampandehanana: idf.py -p PORT flash monitor
Jereo koa: · IDF Monitor ho an'ny hitsin-dàlana mora ampiasaina sy antsipiriany bebe kokoa momba ny fampiasana IDF monitor. · idf.py ho fanondro feno ny baiko sy safidy idf.py.
Izay ihany no ilainao hanombohana amin'ny ESP32! Ankehitriny ianao dia vonona ny hanandrana ex hafaamples, na mandehana mivantana amin'ny famolavolana ny fampiharana anao manokana.
Zava-dehibe: Ny sasany amin'ireo exampTsy manohana ny ESP32 ny les satria tsy tafiditra ao anatin'ny ESP32 ny fitaovana ilaina ka tsy azo tohana. Raha manangana example, mba jereo ny README file ho an'ny tabilao Supported Targets. Raha misy izany ao anatin'izany ny tanjona ESP32, na tsy misy mihitsy ny latabatra, ny exampdia hiasa amin'ny ESP32.
Torohevitra fanampiny
Olana fahazoan-dàlana / dev / ttyUSB0 Miaraka amin'ny fizarana Linux sasany, mety ho azonao ny hafatra tsy nahomby tamin'ny fanokafana port / dev / ttyUSB0 rehefa mandrehitra ny ESP32. Azo voavaha izany amin'ny fampidirana ny mpampiasa ankehitriny amin'ny vondrona fifanakalozan-kevitra.
Python compatibility ESP-IDF dia manohana Python 3.7 na vao haingana. Amporisihina ny manavao ny rafitra fiasanao amin'ny dikan-teny vao haingana mahafa-po ity fepetra ity. Ny safidy hafa dia ny fametrahana Python avy amin'ny loharano na ny fampiasana rafitra fitantanana version Python toy ny pyenv.
Atombohy amin'ny Board Support Package Mba hanafainganana ny fanaovana prototype amin'ny tabilao fampivoarana sasany dia azonao atao ny mampiasa Board Support Packages (BSPs), izay mahatonga ny fanombohana ny birao iray ho mora toy ny fiantsoana asa vitsivitsy. Ny BSP mazàna dia manohana ireo singa fitaovana rehetra omena ao amin'ny birao fampandrosoana. Ankoatra ny famaritana pinout sy ny asa fanombohana, ny BSP dia mandefa mpamily ho an'ny singa ivelany toy ny sensor, fampisehoana, codec audio sns. Ny BSP dia zaraina amin'ny alàlan'ny IDF Component Manager, ka hita ao amin'ny IDF Component Registry. Henoy ny exampny fomba hanampiana ESP-WROVER-KIT BSP amin'ny tetikasanao: idf.py add-dependency esp_wrover_kit
More exampNy fampiasana BSP dia azo jerena ao amin'ny BSP examples folder.
Soso-kevitra: Fanavaozana ny ESP-IDF Amporisihina ny hanavao ny ESP-IDF tsindraindray, satria ny dikan-teny vaovao dia manamboatra ny bug sy/na manome endri-javatra vaovao. Mariho fa manana fe-potoana fanohanana mifandraika amin'izany ny kinova famoahana lehibe sy kely ESP-IDF tsirairay, ary rehefa manakaiky ny faran'ny androm-piainana (EOL) ny sampana famoahana iray, dia entanina ny mpampiasa rehetra hanavao ny tetikasany ho amin'ny famoahana ESP-IDF vao haingana kokoa, mba hahafantarana bebe kokoa momba ny vanim-potoana fanohanana, jereo ny ESP-IDF Versions.
Espressif Systems
43 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 1. Manomboha
Ny fomba tsotra indrindra hanaovana ny fanavaozana dia ny famafana ny lahatahiry esp-idf efa misy ary ny clone azy indray, toy ny hoe manao ny fametrahana voalohany voalaza ao amin'ny dingana 2. Mahazoa ESP-IDF. Vahaolana iray hafa dia ny fanavaozana izay niova ihany. Ny fomba fanavaozana dia miankina amin'ny dikan-tenin'ny ESP-IDF ampiasainao. Aorian'ny fanavaozana ny ESP-IDF, avereno indray ny script Install, raha toa ka mitaky fitaovana hafa ny dikan-teny ESP-IDF vaovao. Jereo ny toromarika ao amin'ny dingana 3. Amboary ny fitaovana. Raha vao tafapetraka ny fitaovana vaovao dia manavao ny tontolo iainana amin'ny alàlan'ny script Export. Jereo ny toromarika ao amin'ny dingana 4. Amboary ny fari-piainan'ny tontolo iainana.
Documents mifandraika · Mametraha fifandraisana an-tariby amin'ny ESP32 · Eclipse Plugin · VSCode Extension · IDF Monitor
1.4 Amboary ny tetikasanao voalohany
Raha efa nametraka ny ESP-IDF ianao fa tsy mampiasa IDE, dia azonao atao ny manangana ny tetikasanao voalohany amin'ny baiko manaraka ny Start a Project on Windows na Start a Project on Linux sy macOS.
1.5 Esory ny ESP-IDF
Raha te hanala ESP-IDF ianao dia araho azafady ny Uninstall ESP-IDF.
Espressif Systems
44 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 2
API Reference
2.1 Fifanarahana API
Ity antontan-taratasy ity dia mamaritra ny fifanarahana sy ny fiheverana mahazatra amin'ny ESP-IDF Application Programming Interfaces (APIs). Ny ESP-IDF dia manome karazana programa interface tsara:
· Ny fiasa C, ny rafitra, ny enum, ny famaritana karazana ary ny macro preprocessor nambara tamin'ny lohatenim-bahoaka files amin'ny singa ESPIDF. Ny pejy isan-karazany ao amin'ny fizarana API Reference ao amin'ny torolalana fandaharana dia misy famaritana ireo fiasa, rafitra ary karazana.
· Manamboara fiasan'ny rafitra, fari-pahalalana efa voafaritra mialoha ary safidy. Ireo dia voarakitra ao amin'ny torolàlana momba ny rafitra fananganana. · Ny safidy Kconfig dia azo ampiasaina amin'ny code sy amin'ny rafitra fananganana (CMakeLists.txt) files. · Ny fitaovana fampiantranoana sy ny mari-pamantarana andalana baikony dia ampahany amin'ny interface ESP-IDF ihany koa. Ny ESP-IDF dia ahitana singa nosoratana manokana ho an'ny ESP-IDF ary koa ny tranomboky an'ny antoko fahatelo. Amin'ny toe-javatra sasany, misy fonosana manokana ESP-IDF ampiana ao amin'ny tranomboky an'ny antoko fahatelo, manome interface tsara na tsotra kokoa na mitambatra tsara kokoa amin'ny sisa amin'ny trano ESP-IDF. Amin'ny tranga hafa, ny API tany am-boalohany an'ny tranomboky an'ny antoko fahatelo dia aseho amin'ireo mpamorona fampiharana. Ny fizarana manaraka dia manazava ny lafiny sasany amin'ny ESP-IDF API sy ny fampiasana azy.
2.1.1 Fikirakira lesoka
Ny ankamaroan'ny ESP-IDF API dia mamerina kaody diso voafaritra amin'ny karazana esp_err_t. Jereo ny fizarana Error Handling raha mila fampahalalana bebe kokoa momba ny fomba fitantanana fahadisoana. Error Code Reference dia ahitana ny lisitry ny kaody diso naverin'ny singa ESP-IDF.
2.1.2 Rafitra fanamboarana
Zava-dehibe: Ampahany manan-danja amin'ny fanaovana ny fampiharana mifanaraka amin'ny dikan-teny ho avy amin'ny ESP-IDF ny fanombohana marina ny rafi-pandaminana.
Ny ankamaroan'ny asa fanombohana na fanamafisam-peo ao amin'ny ESP-IDF dia raisina ho tohan-kevitra ho an'ny firafitry ny fanamafisana. Ho an'ny example:
45
Toko 2. Reference API
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);
Ny asa fanombohana dia tsy mitahiry na oviana na oviana ny tondro amin'ny rafi-drafitra, noho izany dia azo antoka ny fametrahana ny rafitra eo amin'ny stack.
Ny fampiharana dia tsy maintsy manomboka ny sehatra rehetra amin'ny rafitra. Diso ireto manaraka ireto:
esp_timer_create_args_t my_timer_args; my_timer_args.callback = &my_timer_callback; /* Diso! Ny saha .arg sy .name dia tsy natomboka */ esp_timer_create(&my_timer_args, &my_timer);
Ny ankamaroan'ny ESP-IDF examples mampiasa C99 voatendry initializers ho an'ny rafitra fanombohana, satria izy ireo dia manome fomba fohy fametrahana ny ampahany amin'ny saha, ary aotra-nanombohana ny saha sisa:
const esp_timer_create_args_t my_timer_args = { .callback = &my_timer_callback, /* Ahitsio
};
Ny fiteny C++ dia tsy manohana ny syntax fanombohana voatendry mandra-pahatongan'ny C++ 20, fa ny GCC compiler dia manohana azy amin'ny ampahany ho fanitarana. Rehefa mampiasa ESP-IDF API amin'ny kaody C++ ianao dia azonao atao ny mandinika ny fampiasana ity lamina manaraka ity:
esp_timer_create_args_t my_timer_args = {}; /* Ny saha rehetra dia zero-initialized */ my_timer_args.callback = &my_timer_callback;
Default initializers
Ho an'ny rafitra fanefena sasany, ny ESP-IDF dia manome macros amin'ny fametrahana ny sandan'ny saha:
httpd_config_t config = HTTPD_DEFAULT_CONFIG(); /* HTTPD_DEFAULT_CONFIG dia miitatra mankany amin'ny fanombohana voatendry.
Ankehitriny ny saha rehetra dia napetraka amin'ny sanda default. Mbola azo ovaina ny saha rehetra: */ config.server_port = 8081; httpd_handle_t server; esp_err_t err = httpd_start(&server, &config);
Amporisihina ny mampiasa macro initializer default isaky ny omena azy ireo ho an'ny rafitra fanaingoana manokana.
2.1.3 API tsy miankina
Lohateny sasany files ao amin'ny ESP-IDF dia misy API natao hampiasaina ao amin'ny kaody loharano ESP-IDF ihany, fa tsy amin'ny fampiharana. Lohateny toy izany files matetika misy manokana na esp_private amin'ny anarany na ny lalany. Ny singa sasany, toy ny hal, dia tsy misy afa-tsy API manokana. Ny API tsy miankina dia mety esorina na ovaina amin'ny fomba tsy mifanaraka amin'ny famoahana kely na patch.
2.1.4 Ireo singa ao amin'ny example projects
ESP-IDF exampMisy tetikasa isan-karazany mampiseho ny fampiasana ny ESP-IDF API. Mba hampihenana ny dika mitovy amin'ny examples, mpanampy mahazatra vitsivitsy dia voafaritra ao anaty singa izay ampiasain'ny ex maroamples.
Espressif Systems
46 Alefaso ny valin-kafatra
Famoahana v5.0.9
Toko 2. Reference API
Anisan'izany ny singa hita
Documents / Loharano
 |
Espressif Systems ESP32 Dev Kitc Development Board [pdf] Torolàlana ho an'ny mpampiasa ESP32 Dev Kitc Development Board, ESP32, Dev Kitc Development Board, Kitc Development Board, Development Board, Board |