Bòrd Leasachaidh ESP32 Dev Kitc

Fiosrachadh toraidh

Sònrachaidhean

Toradh: ESP32
Stiùireadh Prògramaidh: ESP-IDF
Tionndadh Sgaoilidh: v5.0.9
Dèanadair: Espressif Systems
Ceann-latha foillseachaidh: 16 Cèitean, 2025

Stiùireadh airson cleachdadh bathar

1. Tòisich

Mus tòisich thu leis an ESP32, dèan eòlas air an
a leanas:

1.1 Ro-ràdh

Ionnsaich mu na prìomh ghnìomhan agus comasan aig an
ESP32.

1.2 Na tha a dhìth ort

Dèan cinnteach gu bheil am bathar-cruaidh is am bathar-bog riatanach agad:

Bathar-cruaidh: Thoir sùil air an liosta de bhathar-cruaidh a tha a dhìth
co-phàirtean.
Bathar-bog: Stàlaich am bathar-bog a tha a dhìth
co-phàirtean.

1.3 Stàladh

Lean na ceumannan seo gus an IDE a stàladh agus a stèidheachadh
àrainneachd:

IDE: Stàlaich an IDE a thathar a’ moladh airson
A’ prògramadh an ESP32.
Stàladh làimhe: Suidhich suas le làimh
àrainneachd ma bhios feum air.

1.4 Tog do chiad phròiseact

Cruthaich agus tog do phròiseact tùsail a’ cleachdadh an ESP32.

1.5 Dì-stàlaich ESP-IDF

Ma tha feum air, ionnsaich mar a dhì-stàlaicheas tu an ESP-IDF bhon choimpiutair agad.
siostam.

2. Iomradh API

Thoir sùil air sgrìobhainnean an API airson fiosrachadh mionaideach mu dheidhinn
protocolaidhean tagraidh, làimhseachadh mhearachdan, agus rèiteachadh
structaran.

Ceistean Cumanta (FAQ)

C: Ciamar as urrainn dhomh duilgheadasan cumanta le ESP32 fhuasgladh?

A: Thoir sùil air an earrann fuasgladh dhuilgheadasan anns an stiùireadh prògramaidh
no tadhal air an neach-dèanamh weblàrach-lìn airson goireasan taic.

C: An urrainn dhomh ESP-IDF a chleachdadh le meanbh-riaghladairean eile?

A: Tha ESP-IDF air a dhealbhadh gu sònraichte airson ESP32, ach is dòcha gum faigh thu a-mach
co-chòrdalachd le meanbh-riaghladairean Espressif eile.

View Fullscreen

ESP32
Stiùireadh prògramadh ESP-IDF
Foillseachadh v5.0.9 Siostaman Espressif 16 Cèitean, 2025

Clàr-innse

1 Tòisich

1.1 Ro-ràdh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.2 Na dh’fheumas tu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.2.1 Bathar-cruaidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.2.2 Bathar-bog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

1.3 Stàladh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

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

1.3.2 Stàladh le làimh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

1.4 Tog do chiad phròiseact . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

1.5 Dì-stàlaich ESP-IDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

2 Iomradh API

2.1 Co-chruinneachaidhean API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

2.1.1 Làimhseachadh mhearachdan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

2.1.2 Structaran rèiteachaidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

2.1.3 APIan Prìobhaideach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

2.1.4 Pàirtean ann an exampna pròiseactan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

2.1.5 Seasmhachd API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

2.2 Pròtacalan Iarrtais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

2.2.1 port ASIO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

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

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

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

2.2.5 Cliant ESP HTTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

2.2.6 Smachd Ionadail ESP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

2.2.7 Ceangal Tràill Sreathach ESP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

2.2.8 Pasgan Teisteanas ESP x509 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

2.2.9 Frithealaiche HTTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

2.2.10 Frithealaiche HTTPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

2.2.11 Mac-talla ICMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

2.2.12 Seirbheis mDNS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

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

2.2.14 Sreath Lìonra IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

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

2.3.1 Bluetooth® Cumanta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

2.3.2 Bluetooth® Lùth Ìosal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

2.3.3 Bluetooth® Clasaigeach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325

2.3.4 Smachdair & HCI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

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

2.3.6 APIan aoigheachd stèidhichte air NimBLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 767

2.4 Iomradh air Còdan Mearachd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769

2.5 APIan Lìonraidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776

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

2.5.2 Eitearnet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 899

2.5.3 Snàth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 936

2.5.4 ESP-NETIF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 942 2.5.5 Sreath Lìonra IP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 974 2.5.6 Sreath Iarrtais. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 976 2.6 API innealan-iomaill. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Draibhear Modh Aon-dhealbh airson Tionndair Analógach gu Didseatach (ADC) 977 2.6.1. . . . . . . . . . . . . . . . . 977 2.6.2 Draibhear Modh Leantainneach airson Tionndair Analógach gu Didseatach (ADC). . . . . . . . . . . . . . . 986 2.6.3 Draibhear Calabrachaidh Tionndair Analógach gu Didseatach (ADC). . . . . . . . . . . . . . . . . . . 993 2.6.4 Craobh a’ Chloca. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 997 2.6.5 Tionndair Didseatach gu Analógach (DAC). . . . . . . . . . . . . . . . . . . . . . . . . . . . 1004 2.6.6 GPIO & RTC GPIO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1008 2.6.7 Uaineadair Adhbhar Coitcheann (GPTimer). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1027 2.6.8 Cuairt Eadar-Amailte (I2C). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1039 2.6.9 Fuaim Eadar-IC (I2S). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1056 2.6.10 LCD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1090 2.6.11 Smachd LED (LEDC). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1107 2.6.12 Moduladair Leud Pulse Smachd Motair (MCPWM). . . . . . . . . . . . . . . . . . . . . 1126 2.6.13 Cunntair Cuisle (PCNT). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1178 2.6.14 Tar-ghlacadair Smachd Iomallach (RMT). . . . . . . . . . . . . . . . . . . . . . . . . . . . 1193 2.6.15 Riatanasan Tarraing Suas SD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Draibhear aoigheachd SDMMC 1220 2.6.16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Draibhear aoigheachd SD SPI 1223 2.6.17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1229 2.6.18 Draibhear Tràill Cairt SDIO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1234 2.6.19 Mòdachadh Sigma-Delta (SDM). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1244 2.6.20 Prìomh Dhraibhear SPI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1249 2.6.21 Draibhear Tràill SPI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1274 2.6.22 ESP32-WROOM-32SE (Eileamaid Thèarainte). . . . . . . . . . . . . . . . . . . . . . . . . 1281 2.6.23 Braitear suathaidh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1282 2.6.24 Eadar-aghaidh Chàraichean Dà-Uèir (TWAI). . . . . . . . . . . . . . . . . . . . . . . . . . 1299 2.6.25 Glacadair/Tar-chuir Neo-shioncronach Uile-choitcheann (UART). . . . . . . . . . . . . . . . . . 1317 2.7 Rèiteachadh a’ Phròiseict. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1342 2.7.1 Ro-ràdh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1342 2.7.2 Clàr-taice Rèiteachaidh a’ Phròiseict. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1342 2.7.3 A’ cleachdadh sdkconfig.defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1342 2.7.4 Riaghailtean Cruthachaidh Kconfig. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1343 2.7.5 Co-chòrdalachd air ais roghainnean Kconfig. . . . . . . . . . . . . . . . . . . . . . . . 1343 2.7.6 Tùs-iomradh air Roghainnean Rèiteachaidh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1343 2.8 API solarachaidh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1647 2.8.1 Conaltradh Pròtacal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1647 2.8.2 Solarachadh Aonaichte. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1665 2.8.3 Solarachadh Wi-Fi. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1669 2.9 API stòraidh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FileTaic Siostaim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1691 2.9.2 Goireas Saothrachaidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1699 2.9.3 Leabharlann Stòraidh Neo-luaineach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1703 2.9.4 Goireas Gineadair Roinneadh NVS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1725 2.9.5 Draibhear SD/SDIO/MMC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1730 2.9.6 SPI Flash API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1744 2.9.7 SPIFFS Filesiostam . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1780 2.9.8 Brìgheil filepàirt den shiostam . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1784 2.9.9 API Ìreachaidh Caitte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1800 2.10 API an t-siostaim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1803 2.10.1 Cruth Ìomhaigh an Aplacaid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1803 2.10.2 Lorg Ìre an Aplacaid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1808 2.10.3 Gairm gnìomh le cruach taobh a-muigh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1813 2.10.4 Ath-sgrùdadh Sliseag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1815 2.10.5 Consól . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1817 2.10.6 Manaidsear eFuse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1826 2.10.7 Còdan Mearachd agus Gnìomhan Cuideachaidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1846
ii

2.10.8 ESP HTTPS OTA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1849 2.10.9 Leabharlann Lùb Tachartais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1856 2.10.10 FreeRTOS (Tharview) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1869 2.10.11 FreeRTOS (ESP-IDF) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1871 2.10.12 FreeRTOS (Feartan a Bharrachd) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1988 2.10.13 Riarachadh Cuimhne Cruinn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2008 2.10.14 Fuasgladh Cuimhne Cruinn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2021 2.10.15 Uaireadair Rùn Àrd (Uaireadair ESP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2032 2.10.16 APIan a-staigh agus neo-sheasmhach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2038 2.10.17 Gairm Eadar-phròiseasar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2040 2.10.18 Riarachadh eadar-bhriseadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2045 2.10.19 Leabharlann clàraidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2051 2.10.20 APIan Siostaim Measgaichte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2058 2.10.21 Ùrachaidhean Thar an Adhair (OTA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2073 2.10.22 Sgrùdaiche Coileanaidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2084 2.10.23 Riaghladh Cumhachd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2087 2.10.24 Taic do Shnàithleanan POSIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2093 2.10.25 Gineadh Àireamhan air Thuaiream . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2097 2.10.26 Modhan Cadail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2099 2.10.27 Comasan SoC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2111 2.10.28 Ùine an t-Siostaim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2121 2.10.29 An API riarachadh himem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2126 2.10.30 Prògramadh co-phròiseasar ULP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2129 2.10.31 Coin-faire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2161

3 Iomradh bathar-cruaidh

2167

3.1 Coimeas Sreath Sliseagan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2167

3.1.1 Sgrìobhainnean co-cheangailte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2170

4 Stiùiridhean API

2171

4.1 Leabharlann Lorg Ìre Iarrtais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2171

4.1.1 Os cionnview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2171

4.1.2 Modhan Obrachaidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2171

4.1.3 Roghainnean rèiteachaidh agus eisimeileachdan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2172

4.1.4 Mar a chleachdas tu an leabharlann seo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2173

4.2 Sruth Tòiseachaidh an Aplacaid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2181

4.2.1 An toiseach stagan luchd-tòiseachaidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2182

4.2.2 An dara stagan luchd-luirg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2182

4.2.3 Tòiseachadh an aplacaid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2183

4.3 Bluetooth® Clasaigeach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2184

4.3.1 Os cionnview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2184

4.4 Bluetooth® Lùth Ìosal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2186

4.4.1 Os cionnview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2186

4.4.2 Tòisich . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2191

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

4.5 Luchd-luchdaidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2284

4.5.1 Co-chòrdalachd an luchd-luchaidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2285

4.5.2 Ìre Loga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2285

4.5.3 Ath-shuidheachadh factaraidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2286

4.5.4 Tòisich bho Bathar-bog Deuchainn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2286

4.5.5 Rolladh air ais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287

4.5.6 Cù-faire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287

4.5.7 Meud an Luchd-luchaidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287

4.5.8 Tòiseachadh luath bho Chadal Domhainn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287

4.5.9 Luchd-luchdaidh bròg gnàthaichte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287

4.6 Siostam Togail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2288

4.6.1 Os cionnview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2288

4.6.2 A’ cleachdadh an t-Siostam Togail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2289

iii

4.6.3 Eaampam Pròiseact . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2291 4.6.4 Liostaichean CMake a’ Phròiseict File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2291 4.6.5 Co-phàirt CMakeLists Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2293 4.6.6 Rèiteachadh nam Pàirtean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2295 4.6.7 Mìneachaidhean Ro-phròiseasar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2295 4.6.8 Riatanasan Co-phàirtean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2295 4.6.9 A’ dol thairis air pàirtean den phròiseact . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2299 4.6.10 Co-phàirtean rèiteachaidh a-mhàin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2300 4.6.11 A’ dì-bhugachadh CMake . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2300 4.6.12 Example Component CMakeLists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2301 4.6.13 Roghainnean bunaiteach sdkconfig gnàthaichte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2305 4.6.14 Argamaidean flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2305 4.6.15 A’ togail an luchd-tòiseachaidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2306 4.6.16 A’ sgrìobhadh cho-phàirtean CMake fìor-ghlan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2306 4.6.17 A’ cleachdadh phròiseactan CMake treas-phàrtaidh le co-phàirtean . . . . . . . . . . . . . . . . . . . . . . . 2306 4.6.18 A’ cleachdadh leabharlannan ro-thogte le co-phàirtean . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2307 4.6.19 A’ cleachdadh ESP-IDF ann am Pròiseactan CMake Gnàthaichte . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2307 4.6.20 API Siostam Togail CMake ESP-IDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2308 4.6.21 File Togalaichean Cruinneil is Mean air mhean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2312 4.6.22 Tog Meata-dhàta an t-Siostaim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2313 4.6.23 Tog Taobh a-staigh an t-Siostaim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2313 4.6.24 A’ gluasad bho ESP-IDF GNU Make System . . . . . . . . . . . . . . . . . . . . . . . . . . . 2315 4.7 Core Dump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2316 4.7.1 Thairis airview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2316 4.7.2 Rèiteachaidhean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2317 4.7.3 Sàbhail core dump chun flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2317 4.7.4 Clò-bhuail dump cridhe gu UART . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2318 4.7.5 Gnìomhan ROM ann an Lorg-cùil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2318 4.7.6 A’ dumpadh caochladairean air iarrtas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2318 4.7.7 A’ ruith espcoredump.py . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2319 4.8 Stubaichean Dùsgadh Cadail Dhomhain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2322 4.8.1 Riaghailtean airson Stubaichean Dùsgadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2322 4.8.2 A’ cur Stub an gnìomh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2322 4.8.3 A’ luchdachadh còd a-steach do chuimhne RTC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2322 4.8.4 A’ luchdachadh dàta a-steach do chuimhne RTC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2323 4.8.5 Sgrùdadh CRC airson Stubaichean Dùsgadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2323 4.8.6 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2323 4.9 Làimhseachadh Mhearachdan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2324 4.9.1 Thairis airview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2324 4.9.2 Còdan mearachd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2324 4.9.3 A’ tionndadh chòdan mearachd gu teachdaireachdan mearachd . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2324 4.9.4 Macra ESP_ERROR_CHECK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2325 4.9.5 Macra ESP_ERROR_CHECK_WITHOUT_ABORT . . . . . . . . . . . . . . . . . . . . . . 2325 4.9.6 Macra ESP_RETURN_ON_ERROR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2325 4.9.7 Macra ESP_GOTO_ON_ERROR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2325 4.9.8 Macra ESP_RETURN_ON_FALSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2325 4.9.9 Macra ESP_GOTO_ON_FALSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2325 4.9.10 Thoir sùil air na macros Exampnas lugha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2326 4.9.11 Mearachdan a’ làimhseachadh phàtranan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2326 4.9.12 Eisgeachdan C++ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2327 4.10 ESP-WIFI-MESH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2327 4.10.1 Thairis airview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2327 4.10.2 Ro-ràdh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2328 4.10.3 Bun-bheachdan ESP-WIFI-MESH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2329 4.10.4 A’ togail lìonra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2334 4.10.5 A’ riaghladh lìonra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2339 4.10.6 Tar-chur dàta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2342 4.10.7 Atharrachadh Seanail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2344
iv

4.10.8 Coileanadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2347 4.10.9 Notaichean a bharrachd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2348 4.11 Làimhseachadh thachartasan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2348 4.11.1 Tachartasan Wi-Fi, Ethernet, agus IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2348 4.11.2 Tachartasan Mogaill . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2349 4.11.3 Tachartasan Bluetooth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2350 4.12 Mearachdan marbhtach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2350 4.12.1 Thairis airview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2350 4.12.2 Làimhseadair Panic. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2350 4.12.3 Dumpadh Clàraidh agus Lorg Air Ais. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2351 4.12.4 Stub GDB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2353 4.12.5 Crìoch-ama Cù-faire RTC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2354 4.12.6 Mearachdan Meòrachaidh Guru. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2354 4.12.7 Mearachdan marbhtach eile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2356 4.13 Crioptachadh Flash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2358 4.13.1 Ro-ràdh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2359 4.13.2 Fiùsan e buntainneach. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2359 4.13.3 Pròiseas Crioptachaidh Flash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2360 4.13.4 Rèiteachadh Crioptachaidh Flash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2360 4.13.5 Fàilligidhean a dh’fhaodadh a bhith ann. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2366 4.13.6 Inbhe Crioptachaidh Flash ESP32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2368 4.13.7 A’ leughadh agus a’ sgrìobhadh dàta ann am flash crioptaichte. . . . . . . . . . . . . . . . . . . . . . . 2368 4.13.8 Ag ùrachadh Flash crioptaichte. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2369 4.13.9 A’ cur crioptachadh Flash à comas. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2369 4.13.10 Prìomh Phuingean mu Chrioptachadh Flash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2370 4.13.11 Teòraidhean air Crioptachadh Flash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2370 4.13.12 Crioptachadh Flash agus Bòtadh Tèarainte. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2371 4.13.13 Feartan Adhartach. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2371 4.13.14 Mion-fhiosrachadh Teicnigeach. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2373 4.14 Tarraing-às Bathar-cruaidh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2373 4.14.1 Ailtireachd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2374 4.14.2 Sreath LL (Ìre Ìosal). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2375 4.14.3 HAL (Sreath Tarraing-às Bathar-cruaidh). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2376 4.15 Eadar-bhrisidhean Àrd-Ìre. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2377 4.15.1 Ìrean Eadar-bhriseadh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2377 4.15.2 Notaichean. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TAG Fuasgladh-bhugachaidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2378 4.16.1 Ro-ràdh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2378 4.16.2 Ciamar a tha e ag obair? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2379 4.16.3 A’ taghadh JTAG Adapter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2380 4.16.4 Suidheachadh OpenOCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2380 4.16.5 A’ rèiteachadh Targaid ESP32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2380 4.16.6 A’ cur air bhog an dì-bhugadair . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2386 4.16.7 Dì-bhugachadh Exampnas lugha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2386 4.16.8 A’ togail OpenOCD bho stòran . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2386 4.16.9 Molaidhean agus rudan neònach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2391 4.16.10 Sgrìobhainnean co-cheangailte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2396 4.17 Gineadh Sgriobt Ceangail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2421 4.17.1 Thairis airview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2421 4.17.2 Tòiseachadh Luath . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2421 4.17.3 Taobh a-staigh Gineadh Sgriobt Ceangail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2424 4.18 lwIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2430 4.18.1 APIan a tha air an taiceadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2430 4.18.2 API Socaidean BSD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2431 4.18.3 Netconn API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2435 4.18.4 Gnìomh FreeRTOS lwIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2435 4.18.5 Taic IPv6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2435 4.18.6 atharrachaidhean gnàthaichte esp-lwip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2436
v

4.18.7 Leasachadh Coileanaidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2438 4.19 Seòrsachan Cuimhne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2439
4.19.1 DRAM (RAM Dàta) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2439 4.19.2 IRAM (RAM Stiùiridh) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2440 4.19.3 IROM (còd air a chur an gnìomh bhon fhlasg) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.4 DROM (dàta air a stòradh ann am flash) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.5 RTC Cuimhne slaodach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.6 RTC Cuimhne LUATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.7 Riatanas Comasach DMA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.8 Bufair DMA anns a’ chruach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2442 4.20 OpenThread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2442 4.20.1 Modhan cruach OpenThread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2443 4.20.2 Mar a sgrìobhas tu tagradh OpenThread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2443 4.20.3 An Router Crìochan OpenThread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2444 4.21 Clàran Roinneadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2444 4.21.1 Thairis airview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2445 4.21.2 Clàran Roinneadh Togte a-steach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2445 4.21.3 A’ cruthachadh Chlàran Gnàthaichte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2445 4.21.4 A’ gineadh clàr-roinneadh dà-thaobhach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2448 4.21.5 Sgrùdaidhean air meud na roinne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2448 4.21.6 A’ priobadh a’ chlàr-roinneadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2449 4.21.7 Inneal Roinnidh (parttool.py) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2449 4.22 Coileanadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2450 4.22.1 Mar a leasaicheas tu coileanadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2450 4.22.2 Stiùiridhean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2451 4.23 Calabrachadh RF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2468 4.23.1 Calabrachadh pàirteach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2468 4.23.2 Calabrachadh slàn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2469 4.23.3 Gun chalabrachadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2469 4.23.4 Dàta tòiseachaidh PHY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2469 4.23.5 Iomradh API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2469 4.24 Bòtadh Tèarainte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2472 4.24.1 Cùl-fhiosrachadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2472 4.24.2 Pròiseas Tòiseachaidh Tèarainte Tharview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2473 4.24.3 Iuchraichean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2473 4.24.4 Meud an Luchd-luchaidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2474 4.24.5 Mar a chuireas tu bòtadh tèarainte an comas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2474 4.24.6 Luchdaicheadair-bòtaidh bathar-bog ath-fhlasadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2475 4.24.7 A’ gineadh iuchair shoidhnidh bòtaidh tèarainte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2475 4.24.8 Soidhnigeadh Iomallach air Ìomhaighean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2475 4.24.9 Cleachdaidhean as Fheàrr airson Bòtadh Tèarainte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2476 4.24.10 Mion-fhiosrachadh Teicnigeach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2476 4.24.11 Bòtadh Tèarainte & Crioptachadh Flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2477 4.24.12 Dearbhadh Aplacaid Ainm-sgrìobhte às aonais Bòtadh Tèarainte Bathar-cruaidh . . . . . . . . . . . . . . . . . . . . 2478 4.24.13 Feartan Adhartach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2478 4.25 Bòt Tèarainte V2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2478 4.25.1 Cùl-fhiosrachadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2479 4.25.2 Adhartachtages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2479 4.25.3 Pròiseas Tòiseachaidh Tèarainte V2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2479 4.25.4 Cruth Bloca Ainm-sgrìobhte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2480 4.25.5 Lìonadh Tèarainte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2480 4.25.6 A’ dearbhadh bloc ainm-sgrìobhte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2481 4.25.7 A’ dearbhadh ìomhaigh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2481 4.25.8 Meud an Luchd-luchaidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2481 4.25.9 Cleachdadh eFuse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2481 4.25.10 Mar a chuireas tu Bòtadh Tèarainte V2 an comas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2481 4.25.11 Cuingealachaidhean an dèidh Bòtadh Tèarainte a chomasachadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2482 4.25.12 A’ gineadh iuchair shoidhnidh Bòtaidh Tèarainte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2482
vi

4.25.13 Soidhnigeadh Iomallach air Ìomhaighean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2483 4.25.14 Cleachdaidhean as Fheàrr airson Bòtadh Tèarainte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2484 4.25.15 Mion-fhiosrachadh Teicnigeach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2484 4.25.16 Bòtadh Tèarainte & Crioptachadh Flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2484 4.25.17 Dearbhadh Aplacaid Ainm-sgrìobhte às aonais Bòtadh Tèarainte Bathar-cruaidh . . . . . . . . . . . . . . . . . . . . . 2484 4.25.18 Feartan Adhartach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2485 4.26 Taic airson RAM Taobh a-muigh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2485 4.26.1 Ro-ràdh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2485 4.26.2 Bathar-cruaidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2485 4.26.3 A’ rèiteachadh RAM Taobh a-muigh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2486 4.26.4 Cuingealachaidhean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2487 4.26.5 Dh’fhàillig tòiseachadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2488 4.26.6 Ath-sgrùdaidhean Sliseagan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2488 4.27 Stòradh Ionadail Snàthainn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2488 4.27.1 Thairisview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2488 4.27.2 API Dùthchasach FreeRTOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.27.3 API Pthread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.27.4 Inbhe C11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.28 Innealan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.28.1 Aghaidh IDF – idf.py . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.28.2 Ìomhaigh Docair IDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2493 4.28.3 Stàlaichear Windows IDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2495 4.28.4 Manaidsear Cho-phàirtean IDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2496 4.28.5 IDF Clang Tidy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2497 4.28.6 Innealan a ghabhas luchdachadh a-nuas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2498 4.29 Deuchainn Aonad ann an ESP32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2512 4.29.1 Cùisean Deuchainn Àbhaisteach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2512 4.29.2 Cùisean Deuchainn Ioma-inneal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2513 4.29.3 Ioma-tagCùisean Deuchainne. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2514 4.29.4 Deuchainnean airson Targaidean Eadar-dhealaichte. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2514 4.29.5 Aplacaid Deuchainn Aonad Togalach. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2515 4.29.6 A’ ruith deuchainnean aonaid. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2515 4.29.7 Còd-ama le timer dìolaidh tasgadan. . . . . . . . . . . . . . . . . . . . . . . 2516 4.29.8 Magadh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2517 4.30 Deuchainn Aonaid air Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2519 4.30.1 Deuchainnean Bathar-bog Leabaithe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2519 4.30.2 Deuchainnean Aonad IDF air Aoigh Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Draibhear Wi-Fi 2520 4.31. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2521 4.31.1 Liosta Feartan Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2521 4.31.2 Mar a sgrìobhas tu tagradh Wi-Fi. . . . . . . . . . . . . . . . . . . . . . . . . . . . . Còd Mearachd API Wi-Fi ESP32 2521 4.31.3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2522 4.31.4 Tòiseachadh Paramadair API Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . Modail Prògramaidh Wi-Fi ESP32 2522 4.31.5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2522 4.31.6 Tuairisgeul Tachartais Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2523 4.31.7 Suidheachadh Coitcheann Stèisean Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . . . 2526 4.31.8 Suidheachadh Coitcheann AP Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2529 4.31.9 Sganadh Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2529 4.31.10 Suidheachadh Ceangail Stèisean Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . 2536 4.31.11 Stèisean Wi-Fi ESP32 a’ ceangal nuair a lorgar iomadh AP. . . . . . . . . . . . . 2543 4.31.12 Ath-cheangal Wi-Fi. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2543 4.31.13 Crìoch-ùine Beacon Wi-Fi. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2543 4.31.14 Rèiteachadh Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2543 4.31.15 Ceangal Furasta Wi-Fi™ (DPP). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2549 4.31.16 Riaghladh Lìonra Gun Uèir. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2549 4.31.17 Tomhas Goireasan Rèidio. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2549 4.31.18 Gluasad BSS Luath. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2550 4.31.19 ESP32 Modh Sàbhalaidh Cumhachd Wi-Fi. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2550 4.31.20 Toradh Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
vii

4.31.21 Cuir Pacaid Wi-Fi 80211 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2552 4.31.22 Modh Sniffer Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2554 4.31.23 Ioma Antennas Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2554 4.31.24 Fiosrachadh Staid Sianal Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2556 4.31.25 Rèiteachadh Fiosrachadh Staid Sianal Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . 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 Bloighdean Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2558 4.31.30 Clàraiche WPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2558 4.31.31 Cleachdadh Bufair Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2558 4.31.32 Mar a leasaicheas tu coileanadh Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2559 4.31.33 Clàr-taice Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2562 4.31.34 Fuasgladh dhuilgheadasan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2565 4.32 Tèarainteachd Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2568 4.32.1 Feartan Tèarainteachd Wi-Fi ESP32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2568 4.32.2 Frèamaichean Riaghlaidh Dìonta (PMF) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2571 4.32.3 WiFi Iomairt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2572 4.32.4 WPA3-Pearsanta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2572 4.32.5 Wi-Fi Enhanced OpenTM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2573 4.33 Co-sheasmhachd RF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2573 4.33.1 Thairis airview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2574 4.33.2 Suidheachadh Co-sheasmhachd a tha air a thaiceadh airson ESP32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2574 4.33.3 Dòigh-obrach agus Poileasaidh Co-sheasmhachd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2574 4.33.4 Mar a chleachdas tu am feart co-sheasmhachd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2576 4.34 Togalaichean ath-riochdachadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2577 4.34.1 Ro-ràdh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2577 4.34.2 Adhbharan airson toglaichean nach gabh ath-riochdachadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2577 4.34.3 A’ comasachadh toglaichean ath-riochdachadh ann an ESP-IDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2577 4.34.4 Mar a choileanar toglaichean ath-riochdachadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2578 4.34.5 Togalaichean ath-riochdachadh agus mearachdan-dhearbhaidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2578 4.34.6 Factaran a tha fhathast a’ toirt buaidh air togalaichean ath-riochdachadh . . . . . . . . . . . . . . . . . . . . . . . . . . . 2578 4.35 Stiùireadh Cleachdaiche Modh Cumhachd Ìosal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2578

5 Stiùiridhean Imrich

2579

5.1 Stiùireadh Imrich ESP-IDF 5.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2579

5.1.1 Imrich bho 4.4 gu 5.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2579

6 Leabharlannan agus Frèamaichean

2611

6.1 Frèamaichean Neòil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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 Frèamaichean Abairt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2612

6.2.1 Frèam Leasachaidh Fuaime Espressif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2612

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

6.2.3 Leabharlann DSP Espressif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2612

6.2.4 Frèam-obrach Leasachaidh ESP-WIFI-MESH . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2613

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

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

6.2.7 Fuasgladh ESP-IoT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2613

6.2.8 Pròtacalan ESP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2613

viii

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

Stiùireadh Tabhartasan 7

2615

7.1 Mar a chuireas tu tabhartas a-steach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2615

7.2 Mus cuir thu tabhartas a-steach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2615

7.3 Pròiseas Iarrtas Tarraing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2615

7.4 Pàirt Laghail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2616

7.5 Sgrìobhainnean co-cheangailte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2616

7.5.1 Stiùireadh Stoidhle Frèam Leasachaidh IoT Espressif . . . . . . . . . . . . . . . . . . . . . . . 2616

7.5.2 Stàlaich dubhan ro-gheallta airson Pròiseact ESP-IDF . . . . . . . . . . . . . . . . . . . . . . . . . . 2623

7.5.3 Còd Sgrìobhainn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2624

7.5.4 A’ cruthachadh Examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2629

7.5.5 Teamplaid Sgrìobhainnean API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2630

7.5.6 Aonta Tabhartaiche . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2632

7.5.7 Stiùireadh Ceann-sgrìobhaidh Dlighe-sgrìobhaidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2634

7.5.8 Deuchainnean ESP-IDF le Stiùireadh Pytest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2635

8 Tionndaidhean ESP-IDF

2645

8.1 Sgaoilidhean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2645

8.2 Dè an dreach a bu chòir dhomh tòiseachadh leis? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2645

8.3 Sgeama Tionndaidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2645

8.4 Ùinean Taic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2646

8.5 A’ sgrùdadh an tionndaidh làithreach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2647

8.6 Sruth-obrach Git . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2648

8.7 Ag ùrachadh ESP-IDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2648

8.7.1 Ag ùrachadh gu sgaoileadh seasmhach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2649

8.7.2 Ag ùrachadh gu dreach ro-fhoillsichte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2649

8.7.3 Ag ùrachadh chun Mheur Mhaighstir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2649

8.7.4 Ag ùrachadh gu Meur Sgaoilidh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2650

9 Goireasan

2651

9.1 Àrd-ùrlarIO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2651

9.1.1 Dè a th’ ann an PlatformIO? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2651

9.1.2 Stàladh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2651

9.1.3 Rèiteachadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652

9.1.4 Clasaichean-teagaisg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652

9.1.5 Pròiseact Examples. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652

9.1.6 Na Ceumannan a Leanas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652

9.2 Ceanglaichean feumail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652

10 Còraichean-lethbhric agus Ceadan

2653

10.1 Còraichean-lethbhreac Bathar-bog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2653

10.1.1 Co-phàirtean Bathar-bog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2653

10.1.2 Sgrìobhainnean . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2654

10.2 Dlighe-sgrìobhaidh Còd Tùsail ROM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2654

10.3 Ceadachas MIT Xtensa libhal. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2655

10.4 Cead TinyBasic Plus MIT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2655

Ceadachas TJpgDec 10.5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2655

11 Mu dheidhinn

2657

12 Atharraich Eadar Cànanan

2659

Clàr-innse

2661

Clàr-innse

2661

Clàr-innse
Seo na sgrìobhainnean airson Frèam-obrach Leasachaidh IoT Espressif (esp-idf). ’S e ESP-IDF am frèam-obrach leasachaidh oifigeil airson SoCan sreath ESP32, ESP32-S agus ESP32-C. Tha an sgrìobhainn seo a’ toirt cunntas air mar a chleachdas tu ESP-IDF leis an ESP32 SoC.

Tòisich

Iomradh API

Stiùiridhean API

Siostaman Espressif

1 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Clàr-innse

Siostaman Espressif

2 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1
Tòisich
Tha an sgrìobhainn seo an dùil do chuideachadh le bhith a’ stèidheachadh na h-àrainneachd leasachaidh bathar-bog airson a’ bhathar-chruaidh stèidhichte air a’ chip ESP32 le Espressif. Às dèidh sin, eisimpleir shìmplidhampSeallaidh le dhut mar a chleachdas tu ESP-IDF (Espressif IoT Development Framework) airson rèiteachadh clàr-taice, agus an uairsin airson bathar-bog a thogail agus a fhlasadh air bòrd ESP32.
Nota: Is e seo sgrìobhainnean airson an tionndadh seasmhach v5.0.9 de ESP-IDF. Tha tionndaidhean eile de ESP-IDF rim faighinn cuideachd.
1.1 Ro-ràdh
’S e siostam air sliseag a th’ ann an ESP32 a tha ag amalachadh nan feartan a leanas: · Wi-Fi (còmhlan 2.4 GHz) · Bluetooth · Croilean CPU dà-chonnaidh Xtensa® 32-bit LX6 àrd-choileanaidh · Co-phròiseasar cumhachd glè ìosal · Iomadh iomall
Le cumhachd bho theicneòlas 40 nm, tha ESP32 a’ toirt seachad àrd-ùrlar làidir, làn-aonaichte, a chuidicheas le bhith a’ coinneachadh ris na h-iarrtasan leantainneach airson cleachdadh cumhachd èifeachdach, dealbhadh teann, tèarainteachd, coileanadh àrd, agus earbsachd. Tha Espressif a’ toirt seachad goireasan bathar-cruaidh is bathar-bog bunaiteach gus luchd-leasachaidh aplacaidean a chuideachadh gus na beachdan aca a thoirt gu buil a’ cleachdadh bathar-cruaidh sreath ESP32. Tha frèam leasachaidh bathar-bog Espressif an dùil airson leasachadh aplacaidean Eadar-lìon nan Rudan (IoT) le Wi-Fi, Bluetooth, riaghladh cumhachd agus grunn fheartan siostaim eile.
1.2 Na tha a dhìth ort
1.2.1 Bathar-cruaidh
· Bòrd ESP32. · Càball USB – USB A / micro USB B. · Coimpiutair le Windows, Linux, no macOS.
Nota: An-dràsta, tha cuid de na bùird leasachaidh a’ cleachdadh luchd-ceangail USB Seòrsa C. Dèan cinnteach gu bheil an càball ceart agad gus do bhòrd a cheangal!
Ma tha aon de na bùird leasachaidh oifigeil ESP32 agad a tha air an liostadh gu h-ìosal, faodaidh tu briogadh air a’ cheangal gus barrachd ionnsachadh mun bhathar-chruaidh.
3

Caibideil 1. Tòisich
Pasgan Leasachaidh ESP32 (-R)
Tha an stiùireadh cleachdaiche seo a’ toirt seachad fiosrachadh mu ESP32-DevKitS(-R), bòrd-dealbhaidh stèidhichte air ESP32 air a thoirt gu buil le Espressif. Tha ESP32-DevKitS(-R) na mheasgachadh de dhà ainm bòrd: ESP32-DevKitS agus ESP32-DevKitS-R. Tha S a’ seasamh airson fuarain, agus R airson WROVER.

Pasgan Leasachaidh ESP32

ESP32-DevPatS-R

Tha na prìomh earrannan a leanas san sgrìobhainn: · A’ Tòiseachadh: A’ toirt seachad sealladh farsaingview de ESP32-DevKitS(-R) agus stiùiridhean rèiteachaidh bathar-cruaidh/bathar-bog gus tòiseachadh. · Iomradh Bathar-cruaidh: A’ toirt seachad fiosrachadh nas mionaidiche mu bhathar-cruaidh ESP32-DevKitS(-R)ns. · Sgrìobhainnean co-cheangailte: A’ toirt seachad ceanglaichean gu sgrìobhainnean co-cheangailte.

A’ Tòiseachadh Tha an earrann seo a’ mìneachadh mar a thòisicheas tu le ESP32-DevKitS(-R). Tha e a’ tòiseachadh le beagan earrannan tòiseachaidh mu ESP32-DevKitS(-R), agus an uairsin tha an earrann Mar a nì thu Flashing air Bòrd a’ toirt seachad stiùireadh air mar a chuireas tu modúl air ESP32-DevKitS(-R), ga ullachadh, agus a’ flashing firmware air.

Thairisview ’S e bòrd-lasachaidh Espressifns a th’ ann an ESP32-DevKitS(-R) a chaidh a dhealbhadh gu sònraichte airson ESP32. Faodar a chleachdadh gus modúl ESP32 a lasadh gun a bhith ga thàthadh ris an t-solar cumhachd agus na loidhnichean comharran. Le modúl air a chuir suas, faodar ESP32-DevKitS(-R) a chleachdadh cuideachd mar bhòrd-leasachaidh beag mar ESP32-DevKitC.
Chan eil eadar-dhealachadh sam bith eadar bùird ESP32-DevKitS agus ESP32-DevKitS-R ach ann an cruth nam prìnichean earraich gus freagairt air na modalan ESP32 a leanas.
· Pasganan Leasachaidh ESP32: 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
Airson fiosrachadh mu na modalan gu h-àrd, thoir sùil air Modalan Sreath ESP32.

Tuairisgeul air na pàirtean

Siostaman Espressif

4 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich

Figear 1: ESP32-DevKitS – aghaidh

Siostaman Espressif

Figear 2: ESP32-DevKitS-R – aghaidh 5
Cuir a-steach Fios air ais Sgrìobhainnean

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich

Prìnichean Earraich Prìomh Phàirt Ceann-sgrìobhaidh Boireann 2.54 mm
Drochaid USB-gu-UART LDO Ceanglaiche Micro-USB/Port Micro USB Putan EN Putan Tòiseachaidh
Cumhachd Air LED

Tuairisgeul Cliog am modúl a-steach. Bidh na prìnichean a’ freagairt a-steach do thuill chaisteil a’ mhodúil. Tha na cinn-cinn boireann seo ceangailte ri prìnichean a’ mhodúil a tha air a chuir air a’ bhòrd seo. Airson tuairisgeul air cinn-cinn boireann, thoir sùil air Blocaichean Ceann-cinn. Bheir drochaid USB aon-sliseag gu UART ìrean gluasaid suas ri 3 Mbps.
Meud-lìonaidh ìosal-tuiteam-a-mach 5V-gu-3.3Vtagriaghlaiche-e (LDO).
Eadar-aghaidh USB. Solar cumhachd airson a’ bhùird a bharrachd air an eadar-aghaidh conaltraidh eadar coimpiutair agus a’ bhòrd.
Putan ath-shuidheachadh.
Putan Luchdaich a-nuas. Ma chumas tu sìos Boot agus an uairsin a’ putadh air EN, tòisichidh seo air modh Luchdaich a-nuas Firmware airson firmware a luchdachadh a-nuas tron phort sreathach.
Bidh e a’ tionndadh air nuair a bhios an USB no an solar cumhachd ceangailte ris a’ bhòrd.

Mar a nì thu flash air bòrd Mus cuir thu cumhachd air an ESP32-DevKitS(-R) agad, dèan cinnteach gu bheil e ann an deagh staid gun chomharran follaiseach milleadh.
Bathar-cruaidh a dhìth · Modúl ESP32 de do roghainn · Càball USB 2.0 (Coitcheann-A gu Micro-B) · Coimpiutair le Windows, Linux, no macOS
Suidheachadh Bathar-cruaidh Cuir modúl de do roghainn air an ESP32-DevKitS(-R) agad a rèir nan ceumannan a leanas:
· Cuir am modúl agad gu socair air a’ bhòrd ESP32-DevKitS(-R). Dèan cinnteach gu bheil na tuill caistealach air a’ mhodúl agad co-thaobhadh ris na prìnichean earraich air a’ bhòrd.
· Brùth am modúl agad sìos dhan bhòrd gus an cliog e. · Thoir sùil a bheil na prìnichean earraich uile air an cur a-steach do na tuill caistealach. Ma tha cuid de phrìnichean earraich mì-cho-thaobhach ann,
cuir iad ann an tuill caistealach le clobhagan.
Suidhich bathar-bog
Modh as Fheàrr Tha frèam-obrach leasachaidh ESP-IDF a’ toirt seachad dòigh as fheàrr airson faidhlichean binary a fhlasadh air ESP32-DevKitS(-R). Lean air adhart gu Tòiseachadh, far am bi an Earrann Stàlaidh gad chuideachadh gu sgiobalta gus an àrainneachd leasachaidh a stèidheachadh agus an uairsin aplacaid a fhlasadh mar eisimpleir.ample air an ESP32-DevKitS(-R) agad.
Modh Eile Mar roghainn eile, faodaidh luchd-cleachdaidh Windows faidhlichean binary a flashadh le bhith a’ cleachdadh an Flash Download Tool. Dìreach luchdaich sìos e, fosgail e, agus lean an stiùireadh taobh a-staigh am pasgan doc.
Nota: 1. Gus faidhlichean dà-chànanach a lasadh files, bu chòir ESP32 a bhith air a shuidheachadh gu modh Luchdaich sìos Firmware. Faodar seo a dhèanamh leis an inneal flash gu fèin-ghluasadach, no le bhith a’ cumail sìos am putan Boot agus a’ cnagadh air a’ phutan EN. 2. Às dèidh dà-chànanachd a lasadh files, bidh an Flash Download Tool ag ath-thòiseachadh do mhodal ESP32 agus a’ tòiseachadh an aplacaid flashed gu bunaiteach.

Meudan a’ Bhùird Susbaint agus Pacadh

Siostaman Espressif

6 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich Figear 3: Meudan bòrd ESP32-DevKitS – air a’ chùl

Siostaman Espressif

Figear 4: Meudan bòrd ESP32-DevKitS-R – cùl 7
Cuir a-steach Fios air ais Sgrìobhainnean

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich
Òrdughan reic Ma dh’òrduicheas tu beaganampMar sin, thig gach ESP32-DevKitS(-R) ann am pasgan fa leth ann am baga antistatic no ann am pasgan sam bith a rèir an neach-reic. Airson òrdughan reic, rachaibh gu https://www.espressif.com/en/contact-us/get-samples.
Òrdughan Mòr-reic Ma nì thu òrdughan mòra, thig na bùird ann am bogsaichean cairt-bhòrd mòra. Airson òrdughan mòr-reic, rachaibh gu https://www.espressif.com/en/contact-us/sales-questions.
Iomradh bathar-cruaidh
Diagram Bloc Tha diagram bloc gu h-ìosal a’ sealltainn phàirtean ESP32-DevKitS(-R) agus na ceanglaichean eadar-cheangailte aca.

Figear 5: ESP32-DevKitS(-R) (cliog gus a mheudachadh)
Roghainnean Solar Cumhachd Tha trì dòighean ann a tha a’ cur às dha chèile airson cumhachd a thoirt don bhòrd: · Port Micro USB, solar cumhachd bunaiteach · Prìnichean cinn 5V agus GND · Prìnichean cinn 3V3 agus GND
Thathar a’ moladh a’ chiad roghainn a chleachdadh: port micro USB.

Siostaman Espressif

Comharra Leubail

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

a’ leantainn air an ath dhuilleag

8 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich

Tha Clàr 1 a' leantainn bhon duilleig roimhe

Comharra Leubail

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

Taobh a-muigh 5V

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

Blocaichean Ceann-sgrìobhaidh Airson ìomhaigh nam blocaichean ceann-sgrìobhaidh, thoir sùil air Tuairisgeul air na Co-phàirtean.

Sgrìobhainnean co-cheangailte
· Sgeamaichean ESP32-DevKitS(-R) (PDF) · Duilleag-dàta ESP32 (PDF) · Duilleag-dàta ESP32-WROOM-32 (PDF) · Duilleag-dàta ESP32-WROOM-32D & ESP32-WROOM-32U (PDF) · Duilleag-dàta ESP32-SOLO-1 (PDF) · Duilleag-dàta ESP32-WROVER (PDF) · Duilleag-dàta ESP32-WROVER-B (PDF) · Taghadair Bathar ESP

ESP32-DevKitM-1

Cuidichidh an stiùireadh cleachdaiche seo thu gus tòiseachadh le ESP32-DevKitM-1 agus bheir e seachad fiosrachadh nas mionaidiche cuideachd.
’S e bòrd leasachaidh stèidhichte air ESP32-MINI-1(1U) a th’ ann an ESP32-DevKitM-1 air a dhèanamh le Espressif. Tha a’ mhòr-chuid de na prìnichean I/O air an gearradh a-mach gu cinn nam prìnichean air gach taobh airson eadar-aghaidh furasta. Faodaidh luchd-cleachdaidh innealan iomaill a cheangal le uèirichean geansaidh no ESP32-DevKitM-1 a chuir air bòrd-arain.

Siostaman Espressif

9 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich

ESP32-DevKitM-1 - aghaidh

ESP32-DevKitM-1 – isomeatrach

Tha na prìomh earrannan a leanas san sgrìobhainn: · A’ tòiseachadh: A’ toirt seachad sealladh farsaingview den ESP32-DevKitM-1 agus stiùireadh rèiteachaidh bathar-cruaidh/bathar-bog gus tòiseachadh. · Iomradh bathar-cruaidh: A’ toirt seachad fiosrachadh nas mionaidiche mu bhathar-cruaidh ESP32-DevKitM-1ns. · Sgrìobhainnean co-cheangailte: A’ toirt seachad ceanglaichean gu sgrìobhainnean co-cheangailte.

A’ Tòiseachadh Tha an earrann seo a’ mìneachadh mar a thòisicheas tu le ESP32-DevKitM-1. Tha e a’ tòiseachadh le beagan earrannan tòiseachaidh mun ESP32-DevKitM-1, agus an uairsin tha an earrann Tòiseachadh air Leasachadh Iarrtasan a’ toirt seachad stiùireadh air mar a nì thu an rèiteachadh bathar-cruaidh tùsail agus an uairsin mar a chuireas tu firmware air an ESP32-DevKitM-1.

Thairisview Is e bòrd leasachaidh beag agus goireasach a tha seo anns a bheil:
· Modúl ESP32-MINI-1, no ESP32-MINI-1U · Eadar-aghaidh prògramaidh USB-gu-sreath a bheir seachad solar cumhachd don bhòrd cuideachd · cinn-prìne · putanan-putaidh airson ath-shuidheachadh agus gnìomhachadh modh Luchdaich sìos Firmware · beagan phàirtean eile

Susbaint agus Pacadh

Òrdughan reic Ma dh’òrduicheas tu beaganamples, thig gach ESP32-DevKitM-1 ann am pasgan fa leth an dàrna cuid ann am baga antistatic no ann am pasgan sam bith a rèir an neach-reic agad.
Airson òrdughan reic, rachaibh gu https://www.espressif.com/en/contact-us/get-samples.

Òrdughan Mòr-reic Ma nì thu òrdughan mòra, thig na bùird ann am bogsaichean cairt-bhòrd mòra. Airson òrdughan mòr-reic, rachaibh gu https://www.espressif.com/en/contact-us/sales-questions.

Tuairisgeul air na Co-phàirtean Tha an dealbh a leanas agus an clàr gu h-ìosal a’ toirt cunntas air na prìomh cho-phàirtean, eadar-aghaidhean agus smachdan air bòrd ESP32-DevKitM-1. Gabhaidh sinn am bòrd le modúl ESP32-MINI-1 mar eisimpleirampanns na rannan a leanas.

Siostaman Espressif

10 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich

Figear 6: ESP32-DevKitM-1 – aghaidh

Prìomh phàirt Modúl air bòrd
Putan Tòiseachaidh LDO 5 V gu 3.3 V
Putan Ath-shuidheachaidh Port Micro-USB
Drochaid USB-gu-UART 3.3 V Cumhachd air LED
Ceangalaiche I/O

Tuairisgeul
Modúl ESP32-MINI-1 no modúl ESP32-MINI-1U. Tha antenna PCB air bòrd aig ESP32-MINI-1. Tha ceanglaiche antenna taobh a-muigh aig ESP32-MINI-1U. Tha pasgan sliseag flash 4 MB anns an dà mhodúl. Airson fiosrachadh, faic Duilleag-dhàta ESP32-MINI-1 & ESP32-MINI-1U.
Bidh riaghladair cumhachd ag atharrachadh 5 V gu 3.3 V.
Putan Luchdaich a-nuas. Ma chumas tu sìos Boot agus an uairsin brùth air Reset, tòisichidh modh Luchdaich a-nuas Firmware airson firmware a luchdachadh a-nuas tron phort sreathach.
Putan Ath-shuidheachadh
Eadar-aghaidh USB. Solar cumhachd airson a 'bhùird a bharrachd air an eadar-aghaidh conaltraidh eadar coimpiutair agus a' chip ESP32.
Bidh sliseag drochaid USB-UART singilte a’ toirt seachad ìrean gluasaid suas ri 3 Mbps.
Bidh e a’ tionndadh air nuair a bhios an USB ceangailte ris a’ bhòrd. Airson mion-fhiosrachadh, faic na sgeamaichean ann an Sgrìobhainnean Co-cheangailte. Tha a h-uile prìne GPIO a tha ri fhaighinn (ach a-mhàin am bus SPI airson flash) air a bhriseadh a-mach gu cinn-prìne air a’ bhòrd. Faodaidh luchd-cleachdaidh sliseag ESP32 a phrògramadh gus iomadh gnìomh a chomasachadh.

Tòisich air Leasachadh Iarrtasan Mus cuir thu cumhachd air an ESP32-DevKitM-1 agad, dèan cinnteach gu bheil e ann an deagh staid gun chomharran follaiseach milleadh.
Bathar-cruaidh a dhìth · ESP32-DevKitM-1 · Càball USB 2.0 (Coitcheann-A gu Micro-B) · Coimpiutair le Windows, Linux, no macOS
Suidheachadh Bathar-bog Lean air adhart gu Tòisich, far am bi an earrann Stàladh gad chuideachadh gu sgiobalta gus an àrainneachd leasachaidh a stèidheachadh agus an uairsin aplacaid a flashadh mar eisimpleir.ampcuir air do ESP32-DevKitM-1.

Siostaman Espressif

11 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich
Aire: Tha modúl aon-chridhe air a stàladh air bùird ESP32-DevKitM-1 a chaidh a dhèanamh ro 2 Dùbhlachd 2021. Gus dearbhadh dè am modúl a th’ agad, thoir sùil air fiosrachadh comharrachaidh a’ mhodúil ann am PCN-2021-021. Ma tha modúl aon-chridhe air a stàladh air a’ bhòrd agad, cuir an comas modh aon-chridhe (CONFIG_FREERTOS_UNICORE) ann an clàr-taice config mus cuir thu flash air na h-aplacaidean agad.
Diagram Bloca Iomraidh Bathar-chruaidh Tha diagram bloc gu h-ìosal a’ sealltainn phàirtean ESP32-DevKitM-1 agus na ceanglaichean eadar-cheangailte aca.

Figear 7: ESP32-DevKitM-1
Taghadh Stòr Cumhachd Tha trì dòighean ann a tha a’ cur às dha chèile airson cumhachd a thoirt don bhòrd: · Port Micro USB, solar cumhachd bunaiteach · Prìnichean cinn 5V agus GND · Prìnichean cinn 3V3 agus GND
Rabhadh: · Feumar an solar cumhachd a thoirt seachad le bhith a’ cleachdadh aon agus dìreach aon de na roghainnean gu h-àrd, air neo dh’ fhaodadh am bòrd agus/no an stòr solar cumhachd a bhith air am milleadh. · Thathar a’ moladh solar cumhachd tro phort micro USB.

Tuairisgeulan nam Prìnichean Tha an clàr gu h-ìosal a’ toirt seachad Ainm agus Gnìomh nam prìnichean air gach taobh den bhòrd. Airson rèiteachaidhean prìnichean iomaill, thoir sùil air Duilleag-dàta ESP32.

Chan eil.

Ainm

Seòrsa

GND

3V3

Gnìomh Talamh Solar cumhachd 3.3 V

a’ leantainn air an ath dhuilleag

Siostaman Espressif

12 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich

Tha Clàr 2 a' leantainn bhon duilleig roimhe

Chan eil.

Ainm

Seòrsa

Gnìomh

I36

GPIO36, ADC1_CH0, RTC_GPIO0

I37

GPIO37, ADC1_CH1, RTC_GPIO1

I38

GPIO38, ADC1_CH2, RTC_GPIO2

I39

GPIO39, ADC1_CH3, RTC_GPIO3

RST

Ath-shuidhich; Àrd: comas; Ìosal: cumhachdan dheth

I34

GPIO34, ADC1_CH6, RTC_GPIO4

I35

GPIO35, ADC1_CH7, RTC_GPIO5

IO32

Tha mi/o

GPIO32, XTAL_32K_P (cuir a-steach oscillator criostail 32.768 kHz),

ADC1_CH4, TOUCH9, RTC_GPIO9

IO33

Tha mi/o

GPIO33, XTAL_32K_N (toradh oscillator criostail 32.768 kHz),

ADC1_CH5, TOUCH8, RTC_GPIO8

IO25

Tha mi/o

GPIO25, DAC_1, ADC2_CH8, RTC_GPIO6, EAC_RXD0

IO26

Tha mi/o

GPIO26, DAC_2, ADC2_CH9, RTC_GPIO7, EAC_RXD1

IO27

Tha mi/o

GPIO27, ADC2_CH7, TOUCH7, RTC_GPIO17, EAC_RX_DV

IO14

Tha mi/o

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

HS2_CLK, SD_CLK, EAC_TXD2

Solar cumhachd 5 V

IO12

Tha mi/o

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

HS2_DATA2, SD_DATA2, EAC_TXD3

IO13

Tha mi/o

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

HS2_DATA3, SD_DATA3, EAC_RX_ER

IO15

Tha mi/o

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

HS2_CMD, SD_CMD, EAC_RXD3

IO2

Tha mi/o

GPIO2, ADC2_CH2, TOUCH2, RTC_GPIO12, HSPIWP,

HS2_DATA0, SD_DATA0

IO0

Tha mi/o

GPIO0, ADC2_CH1, TOUCH1, RTC_GPIO11, CLK_OUT1,

EAC_TX_CLK

IO4

Tha mi/o

GPIO4, ADC2_CH0, TOUCH0, RTC_GPIO10, HSPIHD,

HS2_DATA1, SD_DATA1, EAC_TX_ER

IO9

Tha mi/o

GPIO9, HS1_DATA2, U1RXD, SD_DATA2

IO10

Tha mi/o

GPIO10, HS1_DATA3, U1TXD, SD_DATA3

IO5

Tha mi/o

GPIO5, HS1_DATA6, VSPICS0, EAC_RX_CLK

IO18

Tha mi/o

GPIO18, HS1_DATA7, VSPICLK

IO23

Tha mi/o

GPIO23, HS1_STROBE, VSPID

IO19

Tha mi/o

GPIO19, VSPIQ, U0CTS, EAC_TXD0

IO22

Tha mi/o

GPIO22, VSPIWP, U0RTS, EAC_TXD1

IO21

Tha mi/o

GPIO21, VSPIHD, EAC_TX_GA

TXD0

Tha mi/o

GPIO1, U0TXD, CLK_OUT3, EAC_RXD2

RXD0

Tha mi/o

GPIO3, U0RXD, CLK_OUT2

Mion-fhiosrachadh mu Ath-sgrùdadh Bathar-cruaidh Chan eil dreachan roimhe rim faighinn.
Sgrìobhainnean co-cheangailte
· Duilleag-dhàta ESP32-MINI-1 & ESP32-MINI-1U (PDF) · Sgeamaichean ESP32-DevKitM-1 (PDF) · Cruth PCB ESP32-DevKitM-1 (PDF) · Cruth ESP32-DevKitM-1 (DXF) – Faodaidh tu view e le Autodesk Viewair-loidhne · Duilleag-dàta ESP32 (PDF) · Taghadair Bathar ESP
Airson sgrìobhainnean dealbhaidh eile airson a’ bhùird, cuir fios thugainn aig sales@espressif.com.

Siostaman Espressif

13 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich
Bathar-bog 1.2.2
Gus tòiseachadh air ESP-IDF a chleachdadh air ESP32, stàlaich am bathar-bog a leanas: · Toolchain gus còd a chur ri chèile airson ESP32 · Innealan a thogail – CMake agus Ninja gus tagradh slàn a thogail airson ESP32 · ESP-IDF anns a bheil API (leabharlannan bathar-bog agus còd tùsail) airson ESP32 agus sgriobtaichean gus an Toolchain obrachadh.

1.3 Stàladh
Gus am bathar-bog riatanach uile a stàladh, tha sinn a’ tabhann grunn dhòighean eadar-dhealaichte gus an obair seo a dhèanamh nas fhasa. Tagh bho aon de na roghainnean a tha rim faighinn.
1.3.1 IDE

Nota: Tha sinn a’ moladh gu mòr gun stàlaich thu an ESP-IDF tron IDE as fheàrr leat.
· Plugan Eclipse · Leudachadh VSCode

1.3.2 Stàladh làimhe
Airson a’ mhodh-obrachaidh làimhe, tagh a rèir an t-siostaim obrachaidh agad.

Siostaman Espressif

14 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich
Suidheachadh àbhaisteach de Toolchain airson Windows
Ro-ràdh Feumaidh ESP-IDF cuid de dh’ innealan riatanach a bhith air an stàladh gus an urrainn dhut firmware a thogail airson sgoltagan le taic. Am measg nan innealan riatanach tha Python, Git, luchd-cruinneachaidh thar-chruinneachaidh, innealan togail CMake agus Ninja. Airson an Tòiseachaidh seo, cleachdaidh sinn an Command Prompt, ach às deidh dhut ESP-IDF a stàladh faodaidh tu Eclipse Plugin no IDE grafaigeach eile le taic CMake a chleachdadh na àite. Nota: Teòranachadh: – Chan fhaod slighe stàlaidh ESP-IDF agus Innealan ESP-IDF a bhith nas fhaide na 90 caractar. Dh’ fhaodadh slighean stàlaidh ro fhada leantainn gu togail fàilligeadh. – Chan fhaod àiteachan geala no camagan a bhith ann an slighe stàlaidh Python no ESP-IDF. – Cha bu chòir caractaran sònraichte (neo-ASCII) a bhith ann an slighe stàlaidh Python no ESP-IDF mura h-eil an siostam obrachaidh air a rèiteachadh le taic oUnicode UTF-8p. Faodaidh Rianadair an t-Siostaim an taic a chomasachadh tro Phannal Smachd – Atharraich cruthan ceann-latha, ùine no àireamhan – Taba Rianachd – Atharraich ionadail an t-siostaim – thoir sùil air an roghainn oBeta: Cleachd Unicode UTF-8 airson taic cànain air feadh an t-saoghailp – Ceart gu leòr agus ath-thòisich an coimpiutair.
Stàlaichear Innealan ESP-IDF Is e an dòigh as fhasa air ro-ghoireasan ESP-IDFns a stàladh aon de na Stàlaichean Innealan ESP-IDF a luchdachadh sìos.

Luchdaich sìos Stàlaichear Windows
Dè an cleachdadh a th’ ann airson Stàlaichear Air-loidhne agus Far-loidhne? Tha an Stàlaichear Air-loidhne glè bheag agus leigidh e le stàladh a h-uile dreach a tha ri fhaighinn de ESP-IDF. Cha luchdaich an stàlaichear sìos ach na h-eisimeileachdan riatanach a’ gabhail a-steach Git For Windows rè a’ phròiseas stàlaidh. Bidh an stàlaichear a’ stòradh na chaidh a luchdachadh sìos. files anns an eòlaire tasgadan %userprofile%. espressif
Chan eil feum aig an Stàlaichear Offline air ceangal lìonra sam bith. Tha a h-uile eisimeileachd riatanach anns an stàlaichear, nam measg Git For Windows.
Pàirtean an stàlaidh Bidh an stàlaichear a’ cleachdadh nan co-phàirtean a leanas:
· Python Leabaithe · Tar-chruinnichearan · OpenOCD · Innealan togail CMake agus Ninja · ESP-IDF
Leigidh an stàlaichear leat an eòlaire a tha ann mar-thà ath-chleachdadh le ESP-IDF. Is e %userpro an eòlaire a thathar a’ moladh.file%Desktopesp-idf far a bheil %userprofile'S e % an eòlaire dachaigh agad.

Siostaman Espressif

15 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich
A’ cur air bhog Àrainneachd ESP-IDF Aig deireadh a’ phròiseis stàlaidh, faodaidh tu sùil a thoirt air an roghainn Run ESP-IDF PowerShell Environment no Run ESP-IDF Command Prompt (cmd.exe). Cuiridh an stàlaichear àrainneachd ESP-IDF air bhog san àithne taghte. Ruith Àrainneachd ESP-IDF PowerShell:

Figear 8: A’ crìochnachadh Draoidh Suidheachaidh Innealan ESP-IDF le Run ESP-IDF PowerShell Environment
Ruith am Pròmpaid-àithne ESP-IDF (cmd.exe):
A’ cleachdadh an àithne-stiùiridh Airson na ceumannan Tòiseachaidh a tha air fhàgail, cleachdaidh sinn an àithne-stiùiridh Windows. Bidh ESP-IDF Tools Installer cuideachd a’ cruthachadh ath-ghoirid anns a’ chlàr-taice Tòisich gus an àithne-stiùiridh ESP-IDF a chuir air bhog. Bidh an ath-ghoirid seo a’ cur an àithne-stiùiridh (cmd.exe) air bhog agus a’ ruith an sgriobt export.bat gus na caochladairean àrainneachd (PATH, IDF_PATH agus feadhainn eile) a stèidheachadh. Taobh a-staigh an àithne-stiùiridh seo, tha na h-innealan stàlaichte uile rim faighinn. Thoir an aire gu bheil an ath-ghoirid seo sònraichte don eòlaire ESP-IDF a chaidh a thaghadh ann an ESP-IDF Tools Installer. Ma tha iomadh eòlaire ESP-IDF agad air a’ choimpiutair (mar eisimpleirample, gus obrachadh le diofar dhreachan de ESP-IDF), tha dà roghainn agad airson an cleachdadh:
1. Cruthaich leth-bhreac den ath-ghoirid a chruthaich an ESP-IDF Tools Installer, agus atharraich am pasgan-obrach den ath-ghoirid ùr chun phasgan ESP-IDF a tha thu airson a chleachdadh.
2. Air neo, ruith cmd.exe, an uairsin atharraich chun eòlaire ESP-IDF a tha thu airson a chleachdadh, agus ruith export.bat. Thoir an aire, eu-coltach ris an roghainn roimhe, gu bheil feum air Python agus Git a bhith an làthair ann am PATH san dòigh seo. Ma gheibh thu mearachdan co-cheangailte ri Python no Git nach eil air an lorg, cleachd a’ chiad roghainn.
A’ Chiad Cheumannan air ESP-IDF A-nis leis gu bheil a h-uile riatanas air a choileanadh, stiùiridh an ath chuspair thu air mar a thòisicheas tu air a’ chiad phròiseact agad.

Siostaman Espressif

16 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich Figear 9: ESP-IDF PowerShell

Figear 10: A’ crìochnachadh Draoidh Suidheachaidh Innealan ESP-IDF le Run ESP-IDF Command Prompt (cmd.exe)

Siostaman Espressif

17 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich

Figear 11: Pròmpaid Àithne ESP-IDF

Siostaman Espressif

18 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich
Cuidichidh an stiùireadh seo thu leis a’ chiad cheumannan a’ cleachdadh ESP-IDF. Lean an stiùireadh seo gus pròiseact ùr a thòiseachadh air an ESP32 agus toradh an inneil a thogail, a fhlasadh, agus a sgrùdadh. Nota: Mura h-eil thu air ESP-IDF a stàladh fhathast, rach gu Stàladh agus lean an stiùireadh gus am bathar-bog gu lèir fhaighinn a dh’ fheumas tu gus an stiùireadh seo a chleachdadh.

Tòisich Pròiseact A-nis tha thu deiseil airson an tagradh agad ullachadh airson ESP32. Faodaidh tu tòiseachadh leis a’ phròiseact getstarted/hello_world bho examples eòlaire ann an ESP-IDF.
Cudromach: Chan eil siostam togail ESP-IDF a’ toirt taic do bheàrnan anns na slighean gu ESP-IDF no gu pròiseactan.
Dèan lethbhreac den phròiseact get-started/hello_world dhan eòlaire ~/esp: cd %userprofile%esp xcopy /e /i %IDF_PATH%examptòisich-leugh halò_saoghal halò_saoghal
Nota: Tha raon de ex annample pròiseactan san t-seannamples eòlaire ann an ESP-IDF. Faodaidh tu pròiseact sam bith a chopaigeadh san aon dòigh mar a tha air a thaisbeanadh gu h-àrd agus a ruith. Tha e comasach cuideachd examples nan àite gun a bhith gan lethbhreacadh an toiseach.

Ceangail an inneal agad A-nis ceangail am bòrd ESP32 agad ris a’ choimpiutair agus thoir sùil fo dè am port sreathach a tha am bòrd ri fhaicinn. Bidh ainmean puirt sreathach a’ tòiseachadh le COM ann an Windows. Mura h-eil thu cinnteach ciamar a nì thu sgrùdadh air ainm a’ phuirt sreathach, thoir sùil air Stèidhich Ceangal Sreathach le ESP32 airson làn fhiosrachadh.
Nota: Cùm ainm a’ phuirt feumail oir bidh feum agad air anns na h-ath cheumannan.

Rèitich do Phròiseact Seòl chun eòlaire hello_world agad, suidhich ESP32 mar an targaid, agus ruith am goireas rèiteachaidh pròiseict menuconfig.
cd Windows %userprofile%esphello_world idf.py suidhich targaid esp32 idf.py clàr-taice rèiteachadh
Às dèidh dhut pròiseact ùr fhosgladh, bu chòir dhut an targaid a shuidheachadh an toiseach le idf.py set-target esp32. Thoir an aire gun tèid togail is rèiteachaidhean a tha ann mar-thà sa phròiseact, ma tha gin ann, a ghlanadh agus a thòiseachadh sa phròiseas seo. Faodar an targaid a shàbhaladh anns a’ chaochladair àrainneachd gus an ceum seo a sheachnadh idir. Faic Tagh a’ Chlò-bhualaidh Targaid: set-target airson fiosrachadh a bharrachd. Ma chaidh na ceumannan roimhe seo a dhèanamh gu ceart, nochdaidh an clàr-taice a leanas: Tha thu a’ cleachdadh a’ chlàr-taice seo gus caochladairean sònraichte don phròiseact a stèidheachadh, me, ainm is facal-faire lìonra Wi-Fi, astar a’ phròiseasair, msaa. Faodar a bhith a’ seachnadh stèidheachadh a’ phròiseict le menuconfig airson ohello_wordp, leis gu bheil seo mar eisimpleir.ampBidh le a’ ruith leis an rèiteachadh bunaiteach.
Aire: Ma chleachdas tu bòrd ESP32-DevKitC leis a’ mhodal ESP32-SOLO-1, no bòrd ESP32-DevKitM-1 leis a’ mhodal ESP32-MIN1-1(1U), cuir an comas modh aon-chridhe (CONFIG_FREERTOS_UNICORE) ann an clàr-taice config mus cuir thu flash air ex.amples.

Siostaman Espressif

19 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich

Figear 12: Rèiteachadh a’ phròiseict – Uinneag na dachaigh
Nota: Dh’fhaodadh dathan a’ chlàir-taice a bhith eadar-dhealaichte san teirminéal agad. ’S urrainn dhut an coltas atharrachadh leis an roghainn –style. Ruith idf.py menuconfig –help airson tuilleadh fiosrachaidh.
Ma tha thu a’ cleachdadh aon de na bùird leasachaidh a tha a’ faighinn taic, faodaidh tu do leasachadh a luathachadh le bhith a’ cleachdadh Pasgan Taic Bùird. Faic Molaidhean a Bharrachd airson tuilleadh fiosrachaidh.
Tog am Pròiseact Tog am pròiseact le bhith a’ ruith:
idf.py togail
Cuiridh an àithne seo ri chèile an tagradh agus a h-uile pàirt ESP-IDF, an uairsin cruthaichidh e an bootloader, clàr sgaradh, agus binaries tagraidh.
$ idf.py build A’ ruith cmake san eòlaire /path/to/hello_world/build A’ cur an gnìomh “cmake -G Ninja –warn-uninitialized /path/to/hello_world”… Rabhadh mu luachan neo-thòisichte. — Lorgar Git: /usr/bin/git (lorgar an tionndadh “2.17.0”) — A’ togail co-phàirt aws_iot falamh air sgàth rèiteachaidh — Ainmean nan co-phàirtean: … — Slighean nan co-phàirtean: …
… (barrachd loidhnichean de thoradh siostam togail)
[527/527] A’ gineadh hello_world.bin esptool.py v2.3.1
Togail a’ phròiseict deiseil. Gus flash a dhèanamh, ruith an àithne seo: ../../../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 no ruith 'idf.py -p PORT flash'
Mura h-eil mearachdan ann, crìochnaichidh an togail le bhith a’ gineadh am firmware binary .bin files.

Siostaman Espressif

20 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich
Flash air an inneal Flash na faidhlichean binary a thog thu (bootloader.bin, partition-table.bin agus hello_world.bin) air a’ bhòrd ESP32 agad le bhith a’ ruith: idf.py -p PORT [-b BAUD] flash
Cuir ainm port sreathach a’ bhùird ESP32 agad an àite PORT. Faodaidh tu cuideachd an ìre baud flasher atharrachadh le bhith a’ cur an àite BAUD leis an ìre baud a dh’ fheumas tu. Is e 460800 an ìre baud bunaiteach. Airson tuilleadh fiosrachaidh mu argamaidean idf.py, faic idf.py.
Nota: Bidh an roghainn flash a’ togail agus a’ flashadh a’ phròiseict gu fèin-ghluasadach, agus mar sin chan eil feum air idf.py build a ruith.

An do thachair duilgheadasan fhad ’s a bha e a’ flashadh? Ma ruitheas tu an àithne a chaidh a thoirt seachad agus ma chì thu mearachdan leithid Dh’fhàillig ceangal a dhèanamh, dh’ fhaodadh grunn adhbharan a bhith ann airson seo. Is dòcha gur e aon de na h-adhbharan duilgheadasan a thachair le esptool.py, an goireas a bhios an siostam togail a’ gairm gus an sliseag ath-shuidheachadh, eadar-obrachadh leis an luchd-tòiseachaidh ROM, agus firmware flash. Is e aon fhuasgladh sìmplidh ri fheuchainn ath-shuidheachadh làimhe a tha air a mhìneachadh gu h-ìosal, agus mura cuidich e gheibh thu barrachd fiosrachaidh mu dhuilgheadasan a dh’ fhaodadh a bhith ann an Duilgheadasan Fuasgladh.
Bidh esptool.py ag ath-shuidheachadh ESP32 gu fèin-ghluasadach le bhith ag agairt loidhnichean smachd DTR agus RTS a’ chip tionndaidh USB gu sreathach, i.e., FTDI no CP210x (airson tuilleadh fiosrachaidh, faic Stèidhich Ceangal Sreathach le ESP32). Tha na loidhnichean smachd DTR agus RTS an uair sin ceangailte ri prìnichean GPIO0 agus CHIP_PU (EN) de ESP32, agus mar sin bidh atharrachaidhean anns an tomhas-lìonaidh.tagBidh ìrean àrda de DTR agus RTS a’ tòiseachadh ESP32 ann am modh Luchdaich sìos Firmware. Mar eisimpleirample, thoir sùil air an sgeama airson bòrd leasachaidh ESP32 DevKitC.
San fharsaingeachd, cha bu chòir gum biodh duilgheadasan sam bith agad leis na bùird leasachaidh oifigeil esp-idf. Ach, chan urrainn dha esptool.py do bhathar-cruaidh ath-shuidheachadh gu fèin-ghluasadach anns na cùisean a leanas:
· Chan eil na loidhnichean DTR agus RTS ceangailte ri GPIO0 agus CHIP_PU aig a’ bhathar-chruaidh agad · Tha na loidhnichean DTR agus RTS air an rèiteachadh ann an dòigh eadar-dhealaichte · Chan eil loidhnichean smachd sreathach mar sin ann idir
A rèir an seòrsa bathar-cruaidh a th’ agad, is dòcha gum bi e comasach cuideachd am bòrd ESP32 agad a chuir le làimh ann am modh Luchdaich sìos Firmware (ath-shuidheachadh).
· Airson bùird leasachaidh air an dèanamh le Espressif, gheibhear am fiosrachadh seo anns na stiùiridhean tòiseachaidh no stiùiridhean luchd-cleachdaidh fa leth.ampGus bòrd leasachaidh ESP-IDF ath-shuidheachadh le làimh, cum sìos am putan Boot (GPIO0) agus brùth air a’ phutan EN (CHIP_PU).
Airson seòrsachan bathar-cruaidh eile, feuch ri GPIO0 a tharraing sìos.

Siostaman Espressif

21 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich
(leantainn bhon duilleag roimhe) A’ rèiteachadh meud flash… 3072 bytes air an teannachadh gu 103… A’ sgrìobhadh aig 0x00008000… (100 %) Sgrìobh 3072 bytes (103 air an teannachadh) aig 0x00008000 ann an 0.0 diogan (èifeachdach 5962.8 kbit/s)… Hash dàta air a dhearbhadh. 26096 bytes air an teannachadh gu 15408… A’ sgrìobhadh aig 0x00001000… (100 %) Sgrìobh 26096 bytes (15408 air an teannachadh) aig 0x00001000 ann an 0.4 diogan (èifeachdach 546.7 kbit/s)… Hash dàta air a dhearbhadh. 147104 bytes air an teannachadh gu 77364… A’ sgrìobhadh aig 0x00010000… (20%) A’ sgrìobhadh aig 0x00014000… (40%) A’ sgrìobhadh aig 0x00018000… (60%) A’ sgrìobhadh aig 0x0001c000… (80%) A’ sgrìobhadh aig 0x00020000… (100%) Sgrìobh 147104 bytes (77364 air an teannachadh) aig 0x00010000 ann an 1.9 diogan (èifeachdach 615.5 kbit/s)… Hash dàta air a dhearbhadh.
A’ fàgail… Ath-shuidheachadh cruaidh tro phrìne RTS…Dèanta
Mura h-eil duilgheadasan ann ro dheireadh a’ phròiseis flash, ath-thòisichidh am bòrd agus tòisichidh e theohello_worldpapplication. Ma tha thu airson an Eclipse no VS Code IDE a chleachdadh an àite idf.py a ruith, thoir sùil air Eclipse Plugin, VSCode Extension.
Cùm sùil air an toradh Gus dèanamh cinnteach a bheil ohello_worldpis ag obair, taip idf.py -p PORT monitor (Na dìochuimhnich ainm a’ phuirt sreathach agad a chur an àite PORT).
Bidh an àithne seo a’ cur air bhog an tagradh IDF Monitor:
$ idf.py -p A’ ruith idf_monitor san eòlaire […]/esp/hello_world/build A’ cur an gnìomh “python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_world/build/hello_world.elf”… — idf_monitor air 115200 —– Fàg: Ctrl+] | Clàr-taice: Ctrl+T | Cobhair: Ctrl+T agus an uair sin Ctrl+H –ets Ògmhìos 8 2016 00:22:57
rst:0x1 (POWERON_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT) ets Ògmhios 8 2016 00:22:57 …
Às dèidh dhut logaichean tòiseachaidh is breithneachaidh a sgroladh suas, bu chòir dhut oHello world!p fhaicinn air a chlò-bhualadh leis an aplacaid.
… Halò a shaoghail! Ag ath-thòiseachadh ann an 10 diogan… Is e seo sliseag esp32 le 2 chridhe(ean) CPU, WiFi/BT/BLE, silicon revision 1, flash taobh a-muigh 2MB Meud cruachan saor as ìsle: 298968 bytes Ag ath-thòiseachadh ann an 9 diogan… Ag ath-thòiseachadh ann an 8 diogan… Ag ath-thòiseachadh ann an 7 diogan…
Gus monitor IDF fhàgail cleachd an ath-ghoirid Ctrl+].

Siostaman Espressif

22 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich
Ma dh’fhailicheas air monitor IDF goirid às dèidh an luchdachadh suas, no, ma chì thu sgudal air thuaiream coltach ris an fhear a tha air a thoirt seachad gu h-ìosal an àite nan teachdaireachdan gu h-àrd, tha e coltach gu bheil criostal 26 MHz aig a’ bhòrd agad. Bidh a’ mhòr-chuid de dhealbhaidhean bhòrd leasachaidh a’ cleachdadh 40 MHz, agus mar sin bidh ESP-IDF a’ cleachdadh an tricead seo mar luach bunaiteach.

Ma tha duilgheadas mar sin agad, dèan na leanas: 1. Fàg an sgrùdair. 2. Till air ais gu clàr-taice/rèiteachadh. 3. Rach gu rèiteachadh nam pàirtean > Roghainnean bathar-cruaidh > Prìomh rèiteachadh XTAL > Prìomh tricead XTAL, agus an uairsin atharraich CONFIG_XTAL_FREQ_SEL gu 26 MHz. 4. Às dèidh sin, tog agus flash an aplacaid a-rithist.
Anns an dreach làithreach de ESP-IDF, is iad seo na prìomh triceadan XTAL a tha ESP32 a’ toirt taic dhaibh:
· 26 MHz · 40 MHz
Nota: Faodaidh tu togail, lasadh agus sgrùdadh a chur còmhla ann an aon cheum le bhith a’ ruith: idf.py -p PORT flash monitor
Faic cuideachd: · IDF Monitor airson ath-ghoiridean feumail agus barrachd fiosrachaidh mu bhith a’ cleachdadh IDF monitor. · idf.py airson làn iomradh air òrdughan agus roghainnean idf.py.
Sin a h-uile rud a dh’ fheumas tu gus tòiseachadh le ESP32! A-nis tha thu deiseil airson feuchainn ri beagan eile.amples, no rachaibh dìreach gu bhith a’ leasachadh na h-aplacaidean agad fhèin.
Cudromach: Cuid de sheann daoineampChan eil faidhlichean a’ toirt taic do ESP32 leis nach eil bathar-cruaidh riatanach air a ghabhail a-steach ann an ESP32 agus mar sin chan urrainnear taic a thoirt dha. Ma tha thu a’ togail example, thoir sùil air an README file airson a’ chlàir Targaidean a tha air an Taic. Ma tha seo an làthair a’ gabhail a-steach targaid ESP32, no mura h-eil an clàr ann idir, an exampBidh e ag obair air ESP32.
Molaidhean a bharrachd
Cùisean cead /dev/ttyUSB0 Le cuid de sgaoilidhean Linux, is dòcha gum faigh thu an teachdaireachd mearachd Dh’fhàillig fosgladh a’ phort /dev/ttyUSB0 nuair a bhios tu a’ flashadh an ESP32. Faodar seo fhuasgladh le bhith a’ cur an neach-cleachdaidh làithreach ris a’ bhuidheann dialout.
Co-chòrdalachd Python Tha ESP-IDF a’ toirt taic do Python 3.7 no nas ùire. Thathar a’ moladh gun ùraich thu an siostam obrachaidh agad gu dreach nas ùire a choinnicheas ris an riatanas seo. Am measg roghainnean eile tha stàladh Python bho thùsan no cleachdadh siostam riaghlaidh dreach Python leithid pyenv.
Tòisich leis a’ Phasgan Taic Bùird Gus prototàpadh a luathachadh air cuid de bhùird leasachaidh, faodaidh tu Pasganan Taic Bùird (BSPn) a chleachdadh, a tha ga dhèanamh cho furasta bòrd sònraichte a thòiseachadh le glè bheag de ghairmean gnìomh.

Siostaman Espressif

23 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich

Mar as trice bidh BSP a’ toirt taic do na pàirtean bathar-cruaidh uile a tha air an toirt seachad air bòrd leasachaidh. A bharrachd air mìneachadh pinout agus gnìomhan tòiseachaidh, thig BSP le draibhearan airson na pàirtean taobh a-muigh leithid mothachairean, taisbeanaidhean, codecs claisneachd msaa. Tha na BSPan air an sgaoileadh tro IDF Component Manager, agus mar sin gheibhear iad ann an Clàr nam Pàirtean IDF. Seo eisimpleir de phrògram.ampLeabhran air mar a chuireas tu ESP-WROVER-KIT BSP ris a’ phròiseact agad: idf.py add-dependency esp_wrover_kit
Barrachd exampGheibhear fiosrachadh mu chleachdadh BSP ann am BSP examples pasgan.
Sgrìobhainnean co-cheangailte Airson luchd-cleachdaidh adhartach a tha airson am pròiseas stàlaidh a ghnàthachadh: · Ag ùrachadh innealan ESP-IDF air Windows · A’ stèidheachadh ceangal sreathach le ESP32 · Plugin Eclipse · Leudachadh VSCode · Monitor IDF
Ag ùrachadh innealan ESP-IDF air Windows
Stàlaich innealan ESP-IDF le bhith a’ cleachdadh sgriobt. Bho Phrìomh Àithne Windows, atharraich chun eòlaire far a bheil ESPIDF air a stàladh. An uairsin ruith:
stàladh.bat
Airson Powershell, atharraich dhan eòlaire far a bheil ESP-IDF air a stàladh. An uairsin ruith:
stàladh.ps1
Luchdaichidh seo sìos is stàlaichidh e na h-innealan a tha riatanach airson ESP-IDF a chleachdadh. Mura h-eil an dreach sònraichte den inneal air a stàladh mu thràth, cha tèid gnìomh sam bith a dhèanamh. Thèid na h-innealan a luchdachadh sìos is a stàladh ann an eòlaire a chaidh a shònrachadh rè pròiseas Stàlaichear Innealan ESP-IDF. Gu gnàthach, is e seo C:Usersusername.espressif.
Cuir innealan ESP-IDF ri PATH le bhith a’ cleachdadh sgriobt às-mhalairt. Bidh stàlaichear innealan ESP-IDF a’ cruthachadh ath-ghoirid clàr-taice Tòisich airson oESP-IDF Command Promptp. Bidh an ath-ghoirid seo a’ fosgladh uinneag Command Prompt far a bheil na h-innealan uile mu thràth.
ri fhaighinn. Ann an cuid de chùisean, is dòcha gum bi thu airson obrachadh le ESP-IDF ann an uinneag Àithne nach deach a thòiseachadh leis an ath-ghoirid sin. Ma tha seo fìor, lean an stiùireadh gu h-ìosal gus innealan ESP-IDF a chur ri PATH. Anns an àithne far am feum thu ESP-IDF a chleachdadh, atharraich chun eòlaire far a bheil ESP-IDF air a stàladh, agus an uairsin cuir an gnìomh export.bat:
cd % userprofile%espesp-idf export.bat
Air neo, anns a’ Powershell far a bheil feum agad air ESP-IDF a chleachdadh, atharraich dhan eòlaire far a bheil ESP-IDF air a stàladh, agus an uairsin cuir an gnìomh export.ps1:
cd ~/esp/esp-idf às-phortaich.ps1
Nuair a bhios seo deiseil, bidh na h-innealan rim faighinn san àithne-stiùiridh seo.
Stèidhich Ceangal Sreathach le ESP32 Tha an earrann seo a’ toirt seachad stiùireadh air mar a stèidhicheas tu ceangal sreathach eadar ESP32 agus PC.

Siostaman Espressif

24 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich
Ceangail ESP32 ris a’ PC Ceangail am bòrd ESP32 ris a’ PC a’ cleachdadh a’ chàball USB. Mura stàlaich draibhear an inneil gu fèin-ghluasadach, comharraich sliseag tionndaidh USB gu sreathach air a’ bhòrd ESP32 agad (no dongle tionndaidh taobh a-muigh), rannsaich airson draibhearan air an eadar-lìon agus stàlaich iad. Gu h-ìosal tha liosta de na sliseagan tionndaidh USB gu sreathach a tha air an stàladh air a’ mhòr-chuid de na bùird ESP32 air an dèanamh le Espressif còmhla ri ceanglaichean chun na draibhearan:
· CP210x: Draibhearan VCP Drochaid USB gu UART CP210x · FTDI: Draibhearan Port COM Brìgheil FTDI Thoir sùil air leabhar-iùil an neach-cleachdaidh air a’ bhòrd airson a’ chip tionndaidh USB gu sreathach sònraichte a thathar a’ cleachdadh. Tha na draibhearan gu h-àrd airson fiosrachadh sa mhòr-chuid. Ann an suidheachaidhean àbhaisteach, bu chòir na draibhearan a bhith air am pasgadh le siostam obrachaidh agus air an stàladh gu fèin-ghluasadach nuair a cheanglas tu am bòrd ris a’ PC.
Thoir sùil air a’ phort air Windows. Thoir sùil air liosta nam puirt COM a chaidh a chomharrachadh ann am Manaidsear Innealan Windows. Dì-cheangail ESP32 agus ceangail air ais e, gus dearbhadh dè am port a dh’fhalbhas bhon liosta agus an uairsin a nochdas air ais a-rithist. Tha na figearan gu h-ìosal a’ sealltainn a’ phuirt sreathach airson ESP32 DevKitC agus ESP32 WROVER KIT.

Figear 13: Drochaid USB gu UART de ESP32-DevKitC ann am Manaidsear Innealan Windows

Thoir sùil air a’ phort air Linux agus macOS Gus ainm an inneil a dhearbhadh airson a’ phuirt sreathach den bhòrd ESP32 agad (no dongle tionndaidh taobh a-muigh), ruith an àithne seo dà uair, an toiseach leis a’ bhòrd / dongle gun phluga, agus an uairsin leis a’ phluga a-steach. Is e am port a nochdas an dàrna turas am fear a dh’ fheumas tu: Linux
ls /dev/tty*
macOS

Siostaman Espressif

25 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich

Figear 14: Dà Phort Sreathach USB de ESP-WROVER-KIT ann am Manaidsear Innealan Windows

Siostaman Espressif

26 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich

ls /dev/cu.* Nota: luchd-cleachdaidh macOS: mura faic thu am port sreathach, dèan cinnteach gu bheil na draibhearan USB/sreathach air an stàladh. Faic an Earrann Ceangail ESP32 ri PC airson ceanglaichean gu draibhearan. Airson macOS High Sierra (10.13), is dòcha gum feum thu leigeil leis na draibhearan luchdachadh gu soilleir cuideachd. Fosgail Roghainnean an t-Siostaim -> Tèarainteachd & Prìobhaideachd -> Coitcheann agus thoir sùil a bheil teachdaireachd air a shealltainn an seo mu dheidhinn Bathar-bog oSiostaim bhon leasaiche lp far a bheil ainm an leasaiche Silicon Labs no FTDI.

A’ cur cleachdaiche ri dialout air Linux Bu chòir gum biodh cothrom leughaidh is sgrìobhaidh aig an cleachdaiche a tha air logadh a-steach an-dràsta air a’ phort sreathach thairis air USB. Air a’ mhòr-chuid de sgaoilidhean Linux, thèid seo a dhèanamh le bhith a’ cur an cleachdaiche ris a’ bhuidheann dialout leis an àithne a leanas:
sudo usermod -a -G dialout $ USER
air Arch Linux tha seo air a dhèanamh le bhith a’ cur an cleachdaiche ri buidheann uucp leis an àithne a leanas:
sudo usermod -a -G uucp $USER
Dèan cinnteach gun dèan thu ath-logadh a-steach gus ceadan leughaidh is sgrìobhaidh airson a’ phort sreathach a chomasachadh.
Dearbhaich ceangal sreathach A-nis dearbhaich gu bheil an ceangal sreathach ag obair. Faodaidh tu seo a dhèanamh le bhith a’ cleachdadh prògram crìochnachaidh sreathach le bhith a’ sgrùdadh a bheil toradh sam bith air an teirminéal an dèidh dhut ESP32 ath-shuidheachadh. Is e 115200 an ìre baud consol bunaiteach air ESP32.
Windows agus Linux Anns an eisimpleir seoampcleachdaidh sinn PuTTY SSH Client a tha ri fhaighinn airson Windows agus Linux. Faodaidh tu prògraman sreathach eile a chleachdadh agus paramadairean conaltraidh a shuidheachadh mar a leanas. Ruith an teirminéal agus suidhich am port sreathach a chaidh a chomharrachadh. Ìre baud = 115200 (ma tha feum air, atharraich seo gu ìre baud bunaiteach a’ chip a thathar a’ cleachdadh), bìdean dàta = 8, bìdean stad = 1, agus co-ionannachd = N. Gu h-ìosal tha eisimpleireanampdealbhan-sgrìn de shuidheachadh a’ phuirt agus paramadairean tar-chuir mar sin (air an ainmeachadh gu goirid mar 115200-8-1-N) air Windows agus Linux. Cuimhnich gun tagh thu dìreach an aon phort sreathach a chomharraich thu anns na ceumannan gu h-àrd. An uairsin fosgail am port sreathach san teirminéal agus thoir sùil a bheil thu a’ faicinn loga sam bith air a chlò-bhualadh le ESP32. Bidh susbaint an loga an urra ris an aplacaid a chaidh a luchdachadh gu ESP32, faic Eisimpleirampan Toradh.
Nota: Dùin an teirminéal sreathach an dèidh dearbhadh gu bheil an conaltradh ag obair. Ma chumas tu seisean an teirminéil fosgailte, cha bhi am port sreathach ruigsinneach airson bathar-bog a luchdachadh suas nas fhaide air adhart.

macOS Gus an trioblaid a shàbhaladh dhut prògram crìochnachaidh sreathach a stàladh, tha macOS a’ tabhann an àithne screen. · Mar a chaidh a dheasbad ann an Thoir sùil air port air Linux agus macOS, ruith:

ls /dev/cu.* · Bu chòir dhut toradh coltach fhaicinn:

/dev/cu.Port-a-steach-Bluetooth /dev/cu.SLAB_USBtoUART USBtoUART7

/dev/cu.SLAB_

· Bidh an toradh ag atharrachadh a rèir an seòrsa agus an àireamh de bhùird a tha ceangailte ris a’ PC agad. An uairsin tagh ainm inneal a’ bhùird agad agus ruith (ma tha feum air, atharraich o115200pto an ìre baud bunaiteach den chip a thathar a’ cleachdadh):

screen /dev/cu.device_name 115200 Cuir an t-ainm a lorgar nuair a bhios ls /dev/cu.* a’ ruith an àite ainm_an inneil.

Siostaman Espressif

27 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich

Figear 15: A’ suidheachadh Conaltradh Sreathach ann am PuTTY air Windows

Siostaman Espressif

28 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich

Figear 16: A’ suidheachadh Conaltradh Sreathach ann am PuTTY air Linux

Siostaman Espressif

29 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich
· Is e loga a tha air a thaisbeanadh air an sgrion a tha thu a’ sireadh. Bidh susbaint an loga an urra ris an aplacaid a chaidh a luchdachadh suas gu ESP32, faic Eisimpleirample Toradh. Gus an seisean sgrion fhàgail, taip Ctrl-A + .
Nota: Na dìochuimhnich an seisean-sgrìn fhàgail an dèidh dhut dearbhadh gu bheil an conaltradh ag obair. Mura dèan thu sin agus mura dùin thu uinneag an teirminéil, cha bhi am port sreathach ruigsinneach airson bathar-bog a luchdachadh suas nas fhaide air adhart.
Example Toradh An exampChithear an loga gu h-ìosal. Ath-shuidhich am bòrd mura faic thu dad. 8 Ògmhios 2016 00:22:57
rst:0x5 (DEEPSLEEP_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT) ets Ògmhios 8 2016 00:22:57
rst:0x7 (TG0WDT_SYS_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT) configsip: 0, SPIWP:0x00 clk_drv:0x00,q_drv:0x00,d_drv:0x00,cs0_drv:0x00,hd_drv:0x00,wp_drv:0x00 mode:DIO, clock div:2 load:0x3fff0008,len:8 load:0x3fff0010,len:3464 load:0x40078000,len:7828 load:0x40080000,len:252 entry 0x40080034 I (44) boot: ESP-IDF v2.0-rc1-401-gf9fba35 2nd stagbootloader e I (45) boot: àm co-chruinneachaidh 18:48:10
…
Ma chì thu toradh loga a ghabhas leughadh, tha sin a’ ciallachadh gu bheil an ceangal sreathach ag obair agus gu bheil thu deiseil airson a dhol air adhart leis an stàladh agus mu dheireadh an aplacaid a luchdachadh suas gu ESP32.
Nota: Airson cuid de rèiteachaidhean uèiridh puirt sreathach, feumar na prìnichean sreathach RTS & DTR a dhì-chomasachadh sa phrògram crìche mus tòisich an ESP32 agus mus dèan e toradh sreathach. Tha seo an urra ris a’ bhathar-chruaidh fhèin, chan eil an duilgheadas seo aig a’ mhòr-chuid de bhùird leasachaidh (a’ gabhail a-steach a h-uile bòrd Espressif). Tha an duilgheadas ann ma tha RTS & DTR air an uèireadh gu dìreach ris na prìnichean EN & GPIO0. Faic sgrìobhainnean esptool airson tuilleadh fiosrachaidh.
Ma ràinig thu an seo bho Cheum 5. A’ Chiad Cheumannan air ESP-IDF nuair a bhios tu a’ stàladh bathar-bog airson leasachadh ESP32, faodaidh tu leantainn air adhart le Ceum 5. A’ Chiad Cheumannan air ESP-IDF.
Sgrùdaiche IDF 'S e prògram crìochnachaidh sreathach a th' ann an Sgrùdaiche IDF sa mhòr-chuid a bhios a' cur dàta sreathach gu agus bho phort sreathach an inneil targaid. Tha e cuideachd a' toirt seachad cuid de fheartan sònraichte do IDF. Faodar Sgrùdaiche IDF a chur air bhog bho phròiseact IDF le bhith a' ruith idf.py monitor.
Ath-ghoiridean meur-chlàir Airson eadar-obrachadh furasta le IDF Monitor, cleachd na h-ath-ghoiridean meur-chlàir a tha air an toirt seachad sa chlàr.

Siostaman Espressif

30 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich

Ath-ghoirid meur-chlàir Ctrl+] Ctrl+T
· Ctrl+T
· Ctrl+] · Ctrl+P
· Ctrl+R
· Ctrl+F
· Ctrl+A (no A)
· Ctrl+Y
· Ctrl+L
· Ctrl+I (no I)
· Ctrl+H (no H)
· Ctrl+X (no X)
Ctrl+C

Gnìomh

Tuairisgeul

Fàg am prògram Iuchair teicheadh a’ chlàr-taice Cuir caractar a’ chlàr-taice fhèin chun inneal iomallach
Cuir an caractar fàgail fhèin gu ionad iomallach
Ath-shuidhich an targaid a-steach don luchd-luirg gus an aplacaid a stad tro loidhne RTS
Ath-shuidhich am bòrd targaid tro RTS
Tog agus flash am pròiseact

Tog is flash an aplacaid a-mhàin

Stad/ath-thòiseachadh clò-bhualadh toraidh loga air an sgrion

Stad/ath-thòisich toradh loga air a shàbhaladh gu file

Ùine stad/ath-thòiseachadhamps

clò-bhualadh

Seall a h-uile ath-ghoirid meur-chlàr

Brùth agus lean air adhart le aon de na h-iuchraichean gu h-ìosal.
Ath-shuidhichidh seo an targaid, a-steach don bootloader tron loidhne RTS (ma tha e ceangailte), gus nach ruith am bòrd dad. Feumail nuair a dh’ fheumas tu feitheamh gus an tòisich inneal eile. Ath-shuidhichidh seo am bòrd targaid agus tòisichidh e an aplacaid a-rithist tron loidhne RTS (ma tha e ceangailte).
Cuiridh seo stad air idf_monitor gus targaid flash a’ phròiseict a ruith, agus an uairsin tòisichidh e air idf_monitor a-rithist. Stòr sam bith air atharrachadh fileThèid s ath-chruinneachadh agus an uairsin ath-fhlasadh. Thèid targaid encrypted-flash a ruith ma chaidh idf_monitor a thòiseachadh le argamaid -E. Cuiridh e stad air idf_monitor gus an targaid app-flash a ruith, agus an uairsin tòisichidh e air ais air idf_monitor. Coltach ris an targaid flash, ach chan eil ach am prìomh aplacaid air a thogail agus air ath-fhlasadh. Thèid targaid encrypted-app-flash a ruith ma chaidh idf_monitor a thòiseachadh le argamaid -E. Tilgidh e air falbh a h-uile dàta sreathach a tha a’ tighinn a-steach fhad ‘s a tha e gnìomhach. Leigidh e leat stad a chuir air toradh loga agus sgrùdadh a dhèanamh air gu sgiobalta gun an monitor fhàgail. Cruthaichidh e a file ann an eòlaire a’ phròiseict agus thèid an toradh a sgrìobhadh thuige sin file gus an tèid seo a dhì-chomasachadh leis an aon ath-ghoirid meur-chlàir (no gus an tèid IDF Monitor a dhùnadh). Faodaidh IDF Monitor clàr-ama a chlò-bhualadhamp aig toiseach gach loidhne. An t-àm as luaitheamp faodar cruth atharrachadh leis an –timestamp-format argamaid loidhne-àithne.

Fàg am prògram

Cuir stad air an aplacaid a tha a’ ruith

Cuiridh seo stad air Sgrùdaiche IDF agus ruithidh e dì-bhugadair pròiseict GDB gus dì-bhugachadh a dhèanamh air an aplacaid aig àm ruith. Feumaidh seo an roghainn :ref:CONFIG_ESP_SYSTEM_GDBSTUB_RUNTIME a bhith air a chomasachadh.

Thèid iuchraichean sam bith a bhrùthar, a bharrachd air Ctrl-] agus Ctrl-T, a chur tron phort sreathach.

Feartan sònraichte don IDF

Dì-chòdachadh Seòlaidhean Fèin-ghluasadach Nuair a chuireas ESP-IDF a-mach seòladh còd heicsidheach den chruth 0x4_______, bidh IDF Monitor a’ cleachdadh addr2line_ gus an t-àite anns a’ chòd tùsail a lorg agus ainm a’ ghnìomh.
Ma thuiteas aplacaid ESP-IDF agus ma dh’fhàsas e iomagaineach, thèid dump clàraidh agus lorg-cùil a chruthachadh, leithid an leanas:

Siostaman Espressif

31 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich

Thachair mearachd meòrachaidh Guru den t-seòrsa StoreProhibited air cridhe 0. B’ e eisgeachd a bh’ ann.

gun làimhseachadh.

Dumpadh clàraidh:

: 0x400f360d PS

: 0x00060330 A0

: 0x800dbf56 A1

0x3ffb7e00

: 0x3ffb136c A3

: 0x00000005 A4

: 0x00000000 A5

0x00000000

: 0x00000000 A7

: 0x00000080 A8

: 0x00000000 A9

0x3ffb7dd0

A10

: 0x00000003 A11

: 0x00060f23 A12

: 0x00060f20 A13

0x3ffba6d0

A14

: 0x00000047 A15

: 0x0000000f SAR

: 0x00000019 LEISGEUL:

0x0000001d

EXCVADDR: 0x00000000 LBEG: 0x4000c46c LEND: 0x4000c477 LCUNNT:

0x00000000

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

Tha IDF Monitor a’ cur barrachd fiosrachaidh ris an dump:

Thachair mearachd meòrachaidh Guru den t-seòrsa StoreProhibited air cridhe 0. B’ e eisgeachd a bh’ ann.

gun làimhseachadh.

Dumpadh clàraidh:

: 0x400f360d PS

: 0x00060330 A0

: 0x800dbf56 A1

0x3ffb7e00

0x400f360d: dèan_rudeigin_airson_tuiteam aig /home/gus/esp/32/idf/examples/tòisich/

halò_an_t-saoghal/prìomh/./halò_an_t-saoghal_prìomh.c:57

(air a chur a-steach le) inner_dont_crash aig /home/gus/esp/32/idf/examples/tòisich-air/halò_

saoghal/prìomh/./halò_saoghal_prìomh.c:52

: 0x3ffb136c A3

: 0x00000005 A4

: 0x00000000 A5

0x00000000

: 0x00000000 A7

: 0x00000080 A8

: 0x00000000 A9

0x3ffb7dd0

A10

: 0x00000003 A11

: 0x00060f23 A12

: 0x00060f20 A13

0x3ffba6d0

A14

: 0x00000047 A15

: 0x0000000f SAR

: 0x00000019 LEISGEUL:

0x0000001d

EXCVADDR: 0x00000000 LBEG: 0x4000c46c LEND: 0x4000c477 LCUNNT:

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 (air a chur a-steach le) inner_dont_crash aig /home/gus/esp/32/idf/examples/get-started/hello_ world/main/./hello_world_main.c:52 0x400dbf56: chan eil_fhathast_a’_tuiteam aig /home/gus/esp/32/idf/examples/tòisich-air-a-thòiseachadh/hello_world/main/./hello_world_main.c:47 0x400dbf5e: na dèan_tuiteam aig /home/gus/esp/32/idf/examples/tòisich-air/hello_world/ prìomh/./hello_world_main.c:42 0x400dbf82: app_main aig /home/gus/esp/32/idf/examples/tòisich-air/hello_world/main/ ./hello_world_main.c:33 0x400d071d: prìomh_ghnìomh aig /home/gus/esp/32/idf/components/esp32/./cpu_start.c:254

Gus gach seòladh a dhì-chòdachadh, bidh IDF Monitor a’ ruith an àithne a leanas air a’ chùl: xtensa-esp32-elf-addr2line -pfiaC -e build/PROJECT.elf ADDRESS

Nota: Suidhich caochladair àrainneachd ESP_MONITOR_DECODE gu 0 no cuir fòn gu idf_monitor.py le loidhne-àithne sònraichte

Siostaman Espressif

32 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich
roghainn: idf_monitor.py –disable-address-decoding gus dì-chòdachadh seòlaidhean a dhì-cheadachadh.
Ath-shuidheachadh Targaid nuair a cheanglas tu ris. Gu gnàthach, ath-shuidhichidh IDF Monitor an targaid nuair a cheanglas tu ris. Thèid ath-shuidheachadh a’ chip targaid a dhèanamh le bhith a’ cleachdadh nan loidhnichean sreathach DTR agus RTS. Gus casg a chuir air IDF Monitor bho bhith ag ath-shuidheachadh an targaid gu fèin-ghluasadach nuair a cheanglas tu ris, cuir fòn gu IDF Monitor leis an roghainn –no-reset (me, idf_monitor.py –no-reset).
Nota: Bidh an roghainn –no-reset a’ cleachdadh an aon ghiùlan eadhon nuair a bhios IDF Monitor ga cheangal ri port sònraichte (me, idf.py monitor –no-reset -p [PORT]).
A’ cur GDB air bhog le GDBStub Tha GDBStub na fheart feumail airson mearachdan mearachdan ruith-ùine a bhios a’ ruith air an targaid agus a’ ceangal ris an aoigh thairis air a’ phort sreathach gus òrdughan mearachdan mearachdan fhaighinn. Tha GDBStub a’ toirt taic do òrdughan leithid cuimhne agus caochladairean a leughadh, frèamaichean cruach gairm a sgrùdadh msaa. Ged nach eil GDBStub cho ioma-chruthach ri JTAG dì-bhugachadh, chan eil feum air bathar-cruaidh sònraichte sam bith (leithid J)TAG (gu drochaid USB) leis gu bheil conaltradh air a dhèanamh gu tur thairis air a’ phort sreathach. Faodar targaid a rèiteachadh gus GDBStub a ruith air a’ chùl le bhith a’ suidheachadh CONFIG_ESP_SYSTEM_PANIC gu GDBStub aig àm ruith. Ruithidh GDBStub air a’ chùl gus an tèid teachdaireachd Ctrl+C a chuir thairis air a’ phort sreathach agus gun toir e air GDBStub briseadh (ie, stad a chuir air cur an gnìomh) a’ phrògraim, agus mar sin a’ leigeil le GDBStub òrdughan dì-bhugachaidh a làimhseachadh. A bharrachd air an sin, faodar an làimhsichear clisgeadh a rèiteachadh gus GDBStub a ruith air tubaist le bhith a’ suidheachadh CONFIG_ESP_SYSTEM_PANIC gu GDBStub air clisgeadh. Nuair a thachras tubaist, cuiridh GDBStub pàtran sreang sònraichte a-mach thairis air a’ phort sreathach gus sealltainn gu bheil e a’ ruith. Anns an dà chùis (ie, a’ cur na teachdaireachd Ctrl+C, no a’ faighinn a’ phàtrain sreang sònraichte), cuiridh IDF Monitor GDB air bhog gu fèin-ghluasadach gus leigeil leis an neach-cleachdaidh òrdughan dì-bhugachaidh a chuir. Às deidh dha GDB fàgail, thèid an targaid ath-shuidheachadh tron loidhne sreathach RTS. Mura h-eil an loidhne seo ceangailte, faodaidh luchd-cleachdaidh an targaid aca ath-shuidheachadh (le bhith a’ putadh air a’ phutan Ath-shuidheachadh air a’ bhòrd).
Nota: Anns a’ chùlaibh, bidh IDF Monitor a’ ruith an àithne a leanas gus GDB a chur air bhog:
xtensa-esp32-elf-gdb -ex “suidhich baud sreathach BAUD” -ex “targaid PORT iomallach” -ex eadar-theachd togail/PROJECT.elf :idf_target:`Halò AINM chip`

Sìoladh Toraidh Faodar sgrùdaiche IDF a ghairm mar idf.py monitor –print-filter=”xyz”, far a bheil –print-filter na pharamadair airson sìoladh toraidh. Is e sreang falamh an luach bunaiteach, a tha a’ ciallachadh gu bheil a h-uile càil air a chlò-bhualadh.
Faodar cuingealachaidhean air na thèid a chlò-bhualadh a shònrachadh mar shreath detag>: nithean far a bheiltag> is e an tag sreang agus 'S e caractar bhon t-seata {N, E, W, I, D, V, *} a th' ann an `nan ainm` a' toirt iomradh air ìre airson logadh.
Airson example, PRINTE_FILTER=”tag1:W” a’ maidseadh agus a’ clò-bhualadh dìreach na toraidhean a chaidh a sgrìobhadh le ESP_LOGW(“tag1”, …) no aig ìre nas ìsle de dh’fhaclan, i.e. ESP_LOGE(“tag1″, …). Gun a bhith a’ sònrachadh a no a’ cleachdadh * mar as àbhaist gu ìre Verbose.
Nota: Cleachd prìomh logadh gus na toraidhean nach eil a dhìth ort a dhì-chomasachadh aig àm co-chruinneachaidh tron leabharlann logadh. Tha sìoladh toraidh le sgrùdair IDF na fhuasgladh àrd-sgoile a dh’ fhaodadh a bhith feumail airson na roghainnean sìolaidh atharrachadh gun an aplacaid ath-cho-chruinneachadh.
An aplacaid agad tags chan fhaod beàrnan, rionnagan *, no colons a bhith ann : gus a bhith co-chòrdail ris a’ fheart sìolaidh toraidh.
Mura tèid tilleadh giùlain a leantainn às dèidh na loidhne mu dheireadh den toradh san aplacaid agad, dh’ fhaodadh an sìoladh toraidh a bhith troimh-chèile, i.e., tòisichidh an sgrùdair a’ clò-bhualadh na loidhne agus gheibh e a-mach nas fhaide air adhart nach bu chòir an loidhne a bhith air a sgrìobhadh. Tha seo na chùis aithnichte agus faodar a sheachnadh le bhith a’ cur tilleadh giùlain ris an-còmhnaidh (gu h-àraidh nuair nach eil toradh sam bith a’ leantainn dìreach às deidh sin).

Siostaman Espressif

33 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich
ExampLeasan nan Riaghailtean Criathraidh:
· Faodar * a chleachdadh gus a bhith co-ionnan ri rud sam bith tagsAch, tha an sreang PRINT_FILTER=”*:I tag1:E” a thaobh tag1 a’ clò-bhualadh mearachdan a-mhàin, leis gu bheil an riaghailt airson tagTha prìomhachas nas àirde aig 1 thairis air an riaghailt airson *.
· Tha an riaghailt bunaiteach (falamh) co-ionann ri *:V oir tha a h-uile càil a’ freagairt tag aig an ìre Verbose no nas ìsle tha a h-uile càil a mhaidseadh.
· Bidh “*:N” a’ cur bacadh chan ann a-mhàin air na toraidhean bho ghnìomhan logaidh, ach cuideachd air na clò-bhualaidhean a rinn printf, msaa. Gus seo a sheachnadh, cleachd *:E no ìre nas àirde de bhriathrachas.
· Riaghailtean “tag1:V”, “tag1:v”, “tag1:”, “tag1:*”, agus “tag1” co-ionann. · Riaghailt “tag1:I tagTha 1:E” co-ionann ri “tag1:E” oir thachras an aon rud às dèidh sin tag
sgrìobhas an t-ainm thairis air an fhear roimhe. · Riaghailt “tag1:i tagClò-bhualaidhean 2:W” a-mhàin tag1 aig ìre briathrachais an fhiosrachaidh no nas ìsle agus tag2 aig an Rabhadh
ìre briathrachais no nas ìsle. · Riaghailt “tag1:i tag2:I tagTha 3:N” gu ìre mhòr co-ionann ris an fhear roimhe oir tag3: Tha N a’ sònrachadh
sin tagCha bu chòir 3 a chlò-bhualadh. tag3:N anns an riaghailt “tag1:i tag2:I tagTha “3:N *:V” nas brìghmhoire oir às aonais tag3:N an
tagDh’ fhaodadh 3 teachdaireachdan a bhith air an clò-bhualadh; na mearachdan airson tag1 agus tagThèid 2 a chlò-bhualadh aig an ìre bhriathrachais shònraichte (no nas ìsle) agus thèid a h-uile càil eile a chlò-bhualadh gu bunaiteach.
Eisimpleir sìolaidh nas iom-fhillteampChaidh an earrann loga a leanas fhaighinn gun roghainnean sìolaidh sam bith:
luchdaich:0x40078000,len:13564 inntrigeadh 0x40078d4c E (31) esp_image: tha byte draoidheil neo-dhligheach aig an ìomhaigh aig 0x30000 W (31) esp_image: tha modh SPI neo-dhligheach aig an ìomhaigh aig 0x30000 255 E (39) boot: Chan eil roinneadh aplacaid factaraidh so-bhòtaichte I (568) cpu_start: Pro cpu suas. I (569) heap_init: A’ tòiseachadh. RAM ri fhaighinn airson riarachadh fiùghantach: I (603) cpu_start: Còd cleachdaiche tòiseachaidh Pro cpu D (309) light_driver: [light_init, 74]:status: 1, modh: 2 D (318) vfs: tha esp_vfs_register_fd_range soirbheachail airson raon <54; 64) agus VFS ID 1 I (328) wifi: gnìomh draibhear wifi: 3ffdbf84, prio:23, stac:4096, cridhe=0
Tha an toradh a chaidh a ghlacadh airson nan roghainnean sìolaidh PRINT_FILTER=”wifi esp_image:E light_driver:I” air a thoirt seachad gu h-ìosal:
E (31) esp_image: tha byte draoidheil neo-dhligheach aig an ìomhaigh aig 0x30000 I (328) wifi: gnìomh draibhear wifi: 3ffdbf84, prio:23, stack:4096, core=0
Tha na roghainnean “PRINT_FILTER=”light_driver:D esp_image:N boot:N cpu_start:N vfs:N wifi:N *:V” a’ sealltainn an toraidh a leanas:
luchdaich:0x40078000,len:13564 inntrigeadh 0x40078d4c I (569) heap_init: A’ tòiseachadh. RAM ri fhaighinn airson riarachadh fiùghantach: D (309) light_driver: [light_init, 74]:inbhe: 1, modh: 2
Duilgheadasan aithnichte le IDF Monitor
Duilgheadasan a chaidh fhaicinn air Windows
· Chan eil iuchraichean saighead, a bharrachd air cuid de iuchraichean eile, ag obair ann an GDB air sgàth cuingealachaidhean Console Windows. · Aig amannan, nuair a bhios oidf.pypexits ag obair, dh’ fhaodadh e stad airson suas ri 30 diogan mus tòisich IDF Monitor a-rithist. · Nuair a bhios ogdbpis a’ ruith, dh’ fhaodadh e stad airson ùine ghoirid mus tòisich e a’ conaltradh ris an GDBStub.

Siostaman Espressif

34 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich air Suidheachadh Innealan Coitcheann airson Linux agus macOS

Stàladh Ceum air Cheum Seo mapa-rathaid mionaideach a stiùireas tu tron phròiseas stàlaidh.
A’ stèidheachadh na h-Àrainneachd Leasachaidh Seo na ceumannan airson an ESP-IDF a stèidheachadh airson an ESP32 agad. · Ceum 1. Stàlaich na Ro-ghoireasan · Ceum 2. Faigh ESP-IDF · Ceum 3. Suidhich na h-innealan · Ceum 4. Suidhich na caochladairean àrainneachd · Ceum 5. A’ chiad cheumannan air ESP-IDF
Ceum 1. Ro-ghoireasan Stàlaidh Gus ESP-IDF a chleachdadh leis an ESP32, feumaidh tu cuid de phasganan bathar-bog a stàladh stèidhichte air an t-Siostam Obrachaidh agad. Cuidichidh an stiùireadh rèiteachaidh seo thu gus a h-uile càil a stàladh air siostaman stèidhichte air Linux agus macOS.
Airson Luchd-cleachdaidh Linux Gus cruinneachadh le ESP-IDF feumaidh tu na pacaidean a leanas fhaighinn. Tha an àithne a ruitheas tu an urra ri dè an sgaoileadh de Linux a tha thu a’ cleachdadh:
· Ubuntu agus 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 ùrachadh && sudo yum stàlaich git wget flex bison gperf python3 cmake ninja-build ccache dfu-util libusbx
Tha taic fhathast ri CentOS 7 ach thathar a’ moladh CentOS dreach 8 airson eòlas cleachdaiche nas fheàrr. · Arch: sudo pacman -S –needed gcc git make flex bison gperf python cmake ninja ccache dfu-util libusb
Nota: · Feumar CMake dreach 3.16 no nas ùire airson a chleachdadh le ESP-IDF. Ruith otools/idf_tools.py stàlaich cmakepto stàlaich dreach freagarrach mura h-eil fear aig na dreachan OS agad. · Mura faic thu an sgaoileadh Linux agad san liosta gu h-àrd, thoir sùil air na sgrìobhainnean aige gus faighinn a-mach dè an àithne a chleachdas tu airson stàladh pasgan.
Airson luchd-cleachdaidh macOS, cleachdaidh ESP-IDF an dreach de Python a chaidh a stàladh gu bunaiteach air macOS. · Stàlaich CMake & Ninja build: Ma tha HomeBrew agad, faodaidh tu ruith: brew install cmake ninja dfu-util Ma tha MacPorts agad, faodaidh tu ruith: sudo port install cmake ninja dfu-util Rud eile, thoir sùil air duilleagan-dachaigh CMake agus Ninja airson luchdachadh sìos stàlaidh macOS.

Siostaman Espressif

35 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich
· Thathar a’ moladh gu làidir ccache a stàladh cuideachd airson togail nas luaithe. Ma tha HomeBrew agad, faodar seo a dhèanamh tro brew install ccache no sudo port install ccache air MacPorts.
Nota: Ma nochdas mearachd mar seo aig ceum sam bith: xcrun: mearachd: slighe leasachaidh gnìomhach neo-dhligheach (/Library/Developer/CommandLineTools), xcrun a dhìth aig: /Library/Developer/CommandLineTools/usr/bin/xcrun
Feumaidh tu innealan loidhne-àithne XCode a stàladh an uairsin gus leantainn air adhart. Faodaidh tu an stàladh le bhith a’ ruith xcode-select –install.
Luchd-cleachdaidh Apple M1 Ma chleachdas tu àrd-ùrlar Apple M1 agus ma chì thu mearachd mar seo: RABHADH: tha eòlaire airson an inneil xtensa-esp32-elf dreach esp-2021r2-patch3-8.4.0 an làthair, ach cha deach an inneal a lorg MEARACHD: chan eil dreachan stàlaichte aig an inneal xtensa-esp32-elf. Ruith 'install.sh' gus a stàladh.
no: zsh: seòrsa CPU lochtach san fhaidhle a ghabhas cur an gnìomh: ~/.espressif/tools/xtensa-esp32-elf/esp-2021r2patch3-8.4.0/xtensa-esp32-elf/bin/xtensa-esp32-elf-gcc
Feumaidh tu an uairsin Apple Rosetta 2 a stàladh le bhith a’ ruith /usr/sbin/softwareupdate –install-rosetta –agree-to-license
A’ stàladh Python 3 Stèidhichte air notaichean fuasglaidh macOS Catalina 10.15, chan eilear a’ moladh Python 2.7 a chleachdadh agus cha tèid Python 2.7 a thoirt a-steach gu bunaiteach ann an dreachan san àm ri teachd de macOS. Thoir sùil air dè am Python a th’ agad an-dràsta: python –version
Ma tha an toradh coltach ri Python 2.7.17, is e Python 2.7 an t-eadar-theangair bunaiteach agad. Ma tha, thoir sùil cuideachd a bheil Python 3 air a stàladh air a’ choimpiutair agad mu thràth: python3 –version
Ma thilleas an àithne gu h-àrd mearachd, tha sin a’ ciallachadh nach eil Python 3 air a stàladh. Seo eisimpleir gu h-ìosal.view de na ceumannan gus Python 3 a stàladh.
· Faodar stàladh le HomeBrew a dhèanamh mar a leanas: brew install python3
Ma tha MacPorts agad, faodaidh tu ruith: sudo port install python38
Ceum 2. Faigh ESP-IDF Gus aplacaidean a thogail airson an ESP32, feumaidh tu na leabharlannan bathar-bog a tha air an toirt seachad le Espressif ann an stòr-dàta ESP-IDF. Gus ESP-IDF fhaighinn, seòl chun eòlaire stàlaidh agad agus clòn an stòr-dàta le git clone, a’ leantainn an stiùiridh gu h-ìosal a tha sònraichte don t-siostam obrachaidh agad. Fosgail an Terminal, agus ruith na h-òrdughan a leanas:

Siostaman Espressif

36 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich

mkdir -p ~/esp cd ~/esp git clone -b v5.0.9 –ath-chuairteach https://github.com/espressif/esp-idf.git
Thèid ESP-IDF a luchdachadh sìos gu ~/esp/esp-idf. Bruidhinn ri Tionndaidhean ESP-IDF airson fiosrachadh mun dreach ESP-IDF a chleachdas tu ann an suidheachadh sònraichte.
Ceum 3. Suidhich na h-innealan A bharrachd air an ESP-IDF, feumaidh tu cuideachd na h-innealan a bhios ESP-IDF a’ cleachdadh a stàladh, leithid an co-chruinneadair, an dì-bhugadair, pacaidean Python, msaa, airson pròiseactan a tha a’ toirt taic do ESP32. cd ~/esp/esp-idf ./install.sh esp32
no le cd slige Èisg ~/esp/esp-idf ./install.fish esp32
Bidh na h-òrdughan gu h-àrd a’ stàladh innealan airson ESP32 a-mhàin. Ma tha thu an dùil pròiseactan a leasachadh airson barrachd thargaidean sliseagan, bu chòir dhut an liostadh uile agus an ruith mar eisimpleir.ample: cd ~/esp/esp-idf ./install.sh esp32,esp32s2
no le cd slige Èisg ~/esp/esp-idf ./install.fish esp32,esp32s2
Gus innealan a stàladh airson nan targaidean uile a tha a’ faighinn taic, ruith an àithne a leanas: cd ~/esp/esp-idf ./install.sh all
no le cd slige Èisg ~/esp/esp-idf ./install.fish all
Nota: Airson luchd-cleachdaidh macOS, ma thèid mearachd mar seo a shealltainn aig ceum sam bith:urlmearachd fosglaidh [SSL: CERTIFICATE_VERIFY_FAILED] dh’fhàillig dearbhadh teisteanais: cha ghabh teisteanas an fhoillsichear ionadail fhaighinn (_ssl.c:xxx)
Faodaidh tu Install Certificates.command a ruith ann am pasgan Python air a’ choimpiutair agad gus teisteanasan a stàladh. Airson tuilleadh fiosrachaidh, faic Mearachd Luchdaich sìos fhad ’s a tha Innealan ESP-IDF air an stàladh.

Roghainn eile File Luchdaich sìos Bidh an stàlaichear innealan a’ luchdachadh sìos grunn fileceangailte ri GitHub Releases. Ma tha ruigsinneachd air GitHub slaodach, tha e comasach caochladair àrainneachd a shuidheachadh gus frithealaiche luchdachadh sìos Espressifns a thaghadh airson luchdachadh sìos maoin GitHub.

Nota: Chan eil an roghainn seo a’ cumail smachd ach air innealan fa leth a chaidh a luchdachadh sìos bho fhoillseachaidhean GitHub, chan eil e ag atharrachadh an URLair a chleachdadh gus faighinn gu stòran-tasgaidh Git sam bith.

Gus am frithealaiche luchdachadh sìos Espressif a thaghadh nuair a bhios tu a’ stàladh innealan, cleachd an sreath òrdughan a leanas nuair a bhios tu a’ ruith install.sh:

Siostaman Espressif

37 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich

cd ~/esp/esp-idf às-phortaich IDF_GITHUB_ASSETS=”dl.espressif.com/github_assets” ./install.sh
A’ gnàthachadh slighe stàlaidh nan innealan Bidh na sgriobtaichean a chaidh a thoirt a-steach sa cheum seo a’ stàladh innealan co-chruinneachaidh a dh’ fheumas ESP-IDF taobh a-staigh eòlaire dachaigh an neach-cleachdaidh: $HOME/.espressif air Linux. Ma tha thu airson na h-innealan a stàladh ann an eòlaire eadar-dhealaichte, suidhich an caochladair àrainneachd IDF_TOOLS_PATH mus ruith thu na sgriobtaichean stàlaidh. Dèan cinnteach gu bheil ceadan gu leòr aig a’ chunntas cleachdaiche agad airson an t-slighe seo a leughadh agus a sgrìobhadh. Ma tha thu ag atharrachadh an IDF_TOOLS_PATH, dèan cinnteach gu bheil e air a shuidheachadh chun an aon luach a h-uile uair a thèid an sgriobt Stàlaidh (install.bat, install.ps1 no install.sh) agus sgriobt Às-mhalairt (export.bat, export.ps1 no export.sh) a chur an gnìomh.
Ceum 4. Suidhich na caochladairean àrainneachd Chan eil na h-innealan a chaidh a stàladh air an cur ris a’ chaochladair àrainneachd PATH fhathast. Gus na h-innealan a dhèanamh feumail bhon loidhne-àithne, feumar cuid de chaochladairean àrainneachd a shuidheachadh. Tha ESP-IDF a’ toirt seachad sgriobt eile a nì sin. Anns an teirminéal far a bheil thu a’ dol a chleachdadh ESP-IDF, ruith:
. $HOME/esp/esp-idf/export.sh
no airson iasg (air a thaiceadh a-mhàin bho dhreach 3.0.0 de iasg):
$DUILLEAG-DHACHAIGH/esp/esp-idf/às-mhalairt.iasg
Thoir an aire don àite eadar am puing tòiseachaidh agus an t-slighe! Ma tha thu an dùil esp-idf a chleachdadh gu tric, faodaidh tu far-ainm a chruthachadh airson export.sh a ruith:
1. Dèan lethbhreac agus pasg den àithne a leanas a-steach don shellns pro agadfile (.profile, .bashrc, .zprofile, msaa)
alias get_idf='. $HOME/esp/esp-idf/export.sh' 2. Ùraich an rèiteachadh le bhith ag ath-thòiseachadh seisean an teirminéil no le bhith a’ ruith source [path to profile],
airson example, stòr ~/.bashrc. A-nis faodaidh tu get_idf a ruith gus an àrainneachd esp-idf a stèidheachadh no ùrachadh ann an seisean crìochnachaidh sam bith. Gu teicnigeach, faodaidh tu export.sh a chur ris an shellns pro agad.file gu dìreach; ge-tà, chan eilear ga mholadh. Le bhith a’ dèanamh seo, bidh àrainneachd fhìor-dhealbhach IDF ga ghnìomhachadh anns a h-uile seisean crìochnachaidh (a’ gabhail a-steach an fheadhainn far nach eil feum air IDF), a’ cur às do adhbhar na h-àrainneachd fhìor-dhealbhach agus is dòcha a’ toirt buaidh air bathar-bog eile.
Ceum 5. A’ Chiad Cheumannan air ESP-IDF A-nis leis gu bheil na riatanasan uile air an coinneachadh, stiùiridh an ath chuspair thu air mar a thòisicheas tu air a’ chiad phròiseact agad. Cuidichidh an stiùireadh seo thu leis a’ chiad cheumannan a’ cleachdadh ESP-IDF. Lean an stiùireadh seo gus pròiseact ùr a thòiseachadh air an ESP32 agus toradh an inneil a thogail, a fhlasadh, agus a sgrùdadh.
Nota: Mura h-eil thu air ESP-IDF a stàladh fhathast, rach gu Stàladh agus lean an stiùireadh gus am faigh thu am bathar-bog gu lèir a dh’ fheumas tu gus an stiùireadh seo a chleachdadh.

Tòisich Pròiseact A-nis tha thu deiseil airson an tagradh agad ullachadh airson ESP32. Faodaidh tu tòiseachadh leis a’ phròiseact getstarted/hello_world bho examples eòlaire ann an ESP-IDF.

Cudromach: Chan eil siostam togail ESP-IDF a’ toirt taic do bheàrnan anns na slighean gu ESP-IDF no gu pròiseactan.

Dèan lethbhreac den phròiseact get-started/hello_world dhan eòlaire ~/esp:

Siostaman Espressif

38 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich
cd ~/esp cp -r $IDF_PATH/examples/get-started/hello_world .
Nota: Tha raon de ex annample pròiseactan san t-seannamples eòlaire ann an ESP-IDF. Faodaidh tu pròiseact sam bith a chopaigeadh san aon dòigh mar a tha air a thaisbeanadh gu h-àrd agus a ruith. Tha e comasach cuideachd examples nan àite gun a bhith gan lethbhreacadh an toiseach.
Ceangail an inneal agad A-nis ceangail am bòrd ESP32 agad ris a’ choimpiutair agus thoir sùil fon phort sreathach a tha am bòrd ri fhaicinn. Tha na pàtrain ainmeachaidh a leanas aig puirt sreathach:
· Linux: a’ tòiseachadh le /dev/tty · macOS: a’ tòiseachadh le /dev/cu. Mura h-eil thu cinnteach ciamar a nì thu sgrùdadh air ainm a’ phuirt sreathach, thoir sùil air Stèidhich Ceangal Sreathach le ESP32 airson làn fhiosrachadh.
Nota: Cùm ainm a’ phuirt feumail oir bidh feum agad air anns na h-ath cheumannan.
Rèitich do Phròiseact Seòl chun eòlaire hello_world agad, suidhich ESP32 mar an targaid, agus ruith am prògram rèiteachaidh pròiseict menuconfig.cd ~/esp/hello_world idf.py suidhich-target esp32 idf.py menuconfig
Às dèidh dhut pròiseact ùr fhosgladh, bu chòir dhut an targaid a shuidheachadh an toiseach le idf.py set-target esp32. Thoir an aire gun tèid togail is rèiteachaidhean a tha ann mar-thà sa phròiseact, ma tha gin ann, a ghlanadh agus a thòiseachadh sa phròiseas seo. Faodar an targaid a shàbhaladh anns a’ chaochladair àrainneachd gus an ceum seo a sheachnadh idir. Faic Tagh a’ Chliseag Targaid: set-target airson tuilleadh fiosrachaidh. Ma chaidh na ceumannan roimhe a dhèanamh gu ceart, nochdaidh an clàr-taice a leanas:

Figear 17: Rèiteachadh a’ phròiseict – Uinneag na dachaigh Tha thu a’ cleachdadh a’ chlàr-taice seo gus caochladairean sònraichte don phròiseact a stèidheachadh, me, ainm is facal-faire lìonra Wi-Fi, astar a’ phròiseasair, msaa. Faodar rèiteachadh a’ phròiseict le menuconfig a sheachnadh airson ohello_worldp, leis gu bheil seo mar eisimpleir.ampruithidh e le

Siostaman Espressif

39 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich
rèiteachadh bunaiteach.
Aire: Ma chleachdas tu bòrd ESP32-DevKitC leis a’ mhodal ESP32-SOLO-1, no bòrd ESP32-DevKitM-1 leis a’ mhodal ESP32-MIN1-1(1U), cuir an comas modh aon-chridhe (CONFIG_FREERTOS_UNICORE) ann an clàr-taice config mus cuir thu flash air ex.amples.
Nota: Dh’fhaodadh dathan a’ chlàir-taice a bhith eadar-dhealaichte san teirminéal agad. ’S urrainn dhut an coltas atharrachadh leis an roghainn –style. Ruith idf.py menuconfig –help airson tuilleadh fiosrachaidh.
Ma tha thu a’ cleachdadh aon de na bùird leasachaidh a tha a’ faighinn taic, faodaidh tu do leasachadh a luathachadh le bhith a’ cleachdadh Pasgan Taic Bùird. Faic Molaidhean a Bharrachd airson tuilleadh fiosrachaidh.
Tog am Pròiseact Tog am pròiseact le bhith a’ ruith:
idf.py togail
Cuiridh an àithne seo ri chèile an tagradh agus a h-uile pàirt ESP-IDF, an uairsin cruthaichidh e an bootloader, clàr sgaradh, agus binaries tagraidh.
$ idf.py build A’ ruith cmake san eòlaire /path/to/hello_world/build A’ cur an gnìomh “cmake -G Ninja –warn-uninitialized /path/to/hello_world”… Rabhadh mu luachan neo-thòisichte. — Lorgar Git: /usr/bin/git (lorgar an tionndadh “2.17.0”) — A’ togail co-phàirt aws_iot falamh air sgàth rèiteachaidh — Ainmean nan co-phàirtean: … — Slighean nan co-phàirtean: …
… (barrachd loidhnichean de thoradh siostam togail)
[527/527] A’ gineadh hello_world.bin esptool.py v2.3.1
Togail a’ phròiseict deiseil. Gus flash a dhèanamh, ruith an àithne seo: ../../../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 no ruith 'idf.py -p PORT flash'
Mura h-eil mearachdan ann, crìochnaichidh an togail le bhith a’ gineadh am firmware binary .bin files.
Flash air an inneal Flash na faidhlichean binary a thog thu (bootloader.bin, partition-table.bin agus hello_world.bin) air a’ bhòrd ESP32 agad le bhith a’ ruith:
idf.py -p PORT [-b BAUD] flash
Cuir ainm port sreathach a’ bhùird ESP32 agad an àite PORT. Faodaidh tu cuideachd an ìre baud flasher atharrachadh le bhith a’ cur an àite BAUD leis an ìre baud a dh’ fheumas tu. Is e 460800 an ìre baud bunaiteach. Airson tuilleadh fiosrachaidh mu argamaidean idf.py, faic idf.py.
Nota: Bidh an roghainn flash a’ togail agus a’ flashadh a’ phròiseict gu fèin-ghluasadach, agus mar sin chan eil feum air idf.py build a ruith.

Siostaman Espressif

40 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich

Obrachadh Àbhaisteach Nuair a bhios tu a’ priobadh, chì thu loga an toraidh coltach ris an leanas:
… 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-table.bin 0x1000 bootloader/bootloader.bin 0x10000 hello_world.bin esptool.py v3.0-dev Port sreathach /dev/ttyUSB0 A’ ceangal…….._ Is e ESP32D0WDQ6 a’ chip (ath-sgrùdadh 0) Feartan: WiFi, BT, Dà-chridhe, Sgeama Còdaidh Chan eil gin Is e 40MHz a’ chriostal MAC: 24:0a:c4:05:b9:14 A’ luchdachadh suas stub… A’ ruith stub… Ag atharrachadh ìre baud gu 460800 Air atharrachadh. A’ rèiteachadh meud an fhlasg… 3072 bytes air an teannachadh gu 103… A’ sgrìobhadh aig 0x00008000… (100 %) Sgrìobh 3072 bytes (103 air an teannachadh) aig 0x00008000 ann an 0.0 diogan (èifeachdach 5962.8 kbit/s)… Hash dàta air a dhearbhadh. 26096 bytes air an teannachadh gu 15408… A’ sgrìobhadh aig 0x00001000… (100 %) Sgrìobh 26096 bytes (15408 air an teannachadh) aig 0x00001000 ann an 0.4 diogan (èifeachdach 546.7 kbit/s)… Hash dàta air a dhearbhadh. Air a dhlùthadh 147104 bytes gu 77364… A’ sgrìobhadh aig 0x00010000… (20%) A’ sgrìobhadh aig 0x00014000… (40%) A’ sgrìobhadh aig 0x00018000… (60%) A’ sgrìobhadh aig 0x0001c000… (80%)
(a’ leantainn air an ath dhuilleag)

Siostaman Espressif

41 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich
(leantainn bhon duilleag roimhe) A’ sgrìobhadh aig 0x00020000… (100 %) Sgrìobh 147104 bytes (77364 teannaichte) aig 0x00010000 ann an 1.9 diogan (èifeachdach 615.5 kbit/s)… Hash dàta air a dhearbhadh.
A’ fàgail… Ath-shuidheachadh cruaidh tro phrìne RTS…Dèanta
Mura h-eil duilgheadasan ann ro dheireadh a’ phròiseis flash, ath-thòisichidh am bòrd agus tòisichidh e theohello_worldpapplication. Ma tha thu airson an Eclipse no VS Code IDE a chleachdadh an àite idf.py a ruith, thoir sùil air Eclipse Plugin, VSCode Extension.
Cum sùil air an toradh Gus dèanamh cinnteach a bheil ohello_worldpis ag obair, taip idf.py -p PORT monitor (Na dìochuimhnich ainm a’ phuirt sreathach agad a chur an àite PORT). Bidh an àithne seo a’ cur air bhog an aplacaid IDF Monitor:
$ idf.py -p A’ ruith idf_monitor san eòlaire […]/esp/hello_world/build A’ cur an gnìomh “python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_world/build/hello_world.elf”… — idf_monitor air 115200 —– Fàg: Ctrl+] | Clàr-taice: Ctrl+T | Cobhair: Ctrl+T agus an uair sin Ctrl+H –ets Ògmhìos 8 2016 00:22:57
rst:0x1 (POWERON_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT) ets Ògmhios 8 2016 00:22:57 …
Às dèidh dhut logaichean tòiseachaidh is breithneachaidh a sgroladh suas, bu chòir dhut oHello world!p fhaicinn air a chlò-bhualadh leis an aplacaid.
… Halò a shaoghail! Ag ath-thòiseachadh ann an 10 diogan… Is e seo sliseag esp32 le 2 chridhe(ean) CPU, WiFi/BT/BLE, silicon revision 1, flash taobh a-muigh 2MB Meud cruachan saor as ìsle: 298968 bytes Ag ath-thòiseachadh ann an 9 diogan… Ag ath-thòiseachadh ann an 8 diogan… Ag ath-thòiseachadh ann an 7 diogan…
Gus fàgail sgrùdair IDF cleachd an ath-ghoirid Ctrl+]. Ma dh’fhailicheas air sgrùdair IDF goirid às dèidh an luchdachadh suas, no, ma chì thu sgudal air thuaiream coltach ris an fhear a tha air a thoirt seachad gu h-ìosal an àite nan teachdaireachdan gu h-àrd, tha e coltach gu bheil do bhòrd a’ cleachdadh criostal 26 MHz. Bidh a’ mhòr-chuid de dhealbhaidhean bhòrd leasachaidh a’ cleachdadh 40 MHz, agus mar sin bidh ESP-IDF a’ cleachdadh an tricead seo mar luach bunaiteach.

Ma tha duilgheadas mar sin agad, dèan na leanas:
1. Fàg an sgrìn. 2. Till air ais gu clàr-taice/rèiteachadh. 3. Rach gu rèiteachadh nam pàirtean > Roghainnean bathar-cruaidh > Prìomh rèiteachadh XTAL > Prìomh XTAL
tricead, an uair sin atharraich CONFIG_XTAL_FREQ_SEL gu 26 MHz. 4. Às dèidh sin, tog agus flash an aplacaid a-rithist.

Siostaman Espressif

42 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich
Anns an dreach làithreach de ESP-IDF, is iad seo na prìomh triceadan XTAL a tha ESP32 a’ toirt taic dhaibh:
· 26 MHz · 40 MHz
Nota: Faodaidh tu togail, lasadh agus sgrùdadh a chur còmhla ann an aon cheum le bhith a’ ruith: idf.py -p PORT flash monitor
Faic cuideachd: · IDF Monitor airson ath-ghoiridean feumail agus barrachd fiosrachaidh mu bhith a’ cleachdadh IDF monitor. · idf.py airson làn iomradh air òrdughan agus roghainnean idf.py.
Sin a h-uile rud a dh’ fheumas tu gus tòiseachadh le ESP32! A-nis tha thu deiseil airson feuchainn ri beagan eile.amples, no rachaibh dìreach gu bhith a’ leasachadh na h-aplacaidean agad fhèin.
Cudromach: Cuid de sheann daoineampChan eil faidhlichean a’ toirt taic do ESP32 leis nach eil bathar-cruaidh riatanach air a ghabhail a-steach ann an ESP32 agus mar sin chan urrainnear taic a thoirt dha. Ma tha thu a’ togail example, thoir sùil air an README file airson a’ chlàir Targaidean a tha air an Taic. Ma tha seo an làthair a’ gabhail a-steach targaid ESP32, no mura h-eil an clàr ann idir, an exampBidh e ag obair air ESP32.
Molaidhean a bharrachd
Cùisean cead /dev/ttyUSB0 Le cuid de sgaoilidhean Linux, is dòcha gum faigh thu an teachdaireachd mearachd Dh’fhàillig fosgladh a’ phort /dev/ttyUSB0 nuair a bhios tu a’ flashadh an ESP32. Faodar seo fhuasgladh le bhith a’ cur an neach-cleachdaidh làithreach ris a’ bhuidheann dialout.
Co-chòrdalachd Python Tha ESP-IDF a’ toirt taic do Python 3.7 no nas ùire. Thathar a’ moladh gun ùraich thu an siostam obrachaidh agad gu dreach nas ùire a choinnicheas ris an riatanas seo. Am measg roghainnean eile tha stàladh Python bho thùsan no cleachdadh siostam riaghlaidh dreach Python leithid pyenv.
Tòisich leis a’ Phasgan Taic Bùird Gus prototàipeadh a luathachadh air cuid de bhùird leasachaidh, faodaidh tu Pasganan Taic Bùird (BSPn) a chleachdadh, a tha a’ dèanamh tòiseachadh bòrd sònraichte cho furasta ri glè bheag de ghairmean gnìomh. Mar as trice bidh BSP a’ toirt taic do na pàirtean bathar-cruaidh uile a tha air an toirt seachad air bòrd leasachaidh. A bharrachd air mìneachadh pinout agus gnìomhan tòiseachaidh, thig BSP le draibhearan airson na pàirtean taobh a-muigh leithid mothachairean, taisbeanaidhean, codecs claisneachd msaa. Tha na BSPn air an sgaoileadh tro Mhanaidsear Co-phàirtean IDF, agus mar sin gheibhear iad ann an Clàr Co-phàirtean IDF. Seo eisimpleir de…ampLeabhran air mar a chuireas tu ESP-WROVER-KIT BSP ris a’ phròiseact agad: idf.py add-dependency esp_wrover_kit
Barrachd exampGheibhear fiosrachadh mu chleachdadh BSP ann am BSP examples pasgan.
Molaidh: Ag ùrachadh ESP-IDF Thathar a’ moladh ESP-IDF ùrachadh bho àm gu àm, oir bidh dreachan nas ùire a’ càradh mhearachdan agus/no a’ toirt seachad feartan ùra. Thoir an aire gu bheil ùine taic co-cheangailte ri gach dreach mòr is beag de ESP-IDF, agus nuair a bhios aon mheur de fhoillseachaidhean a’ tighinn faisg air deireadh a bheatha (EOL), thathar a’ brosnachadh a h-uile neach-cleachdaidh na pròiseactan aca ùrachadh gu foillseachaidhean ESP-IDF nas ùire, gus tuilleadh fhaighinn a-mach mu amannan taic, faic Tionndaidhean ESP-IDF.

Siostaman Espressif

43 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 1. Tòisich
Is e an dòigh as sìmplidh air an ùrachadh a dhèanamh am pasgan esp-idf a tha ann mar-thà a dhubhadh às agus a chlònadh a-rithist, mar gum biodh tu a’ dèanamh a’ chiad stàladh a chaidh a mhìneachadh ann an Ceum 2. Faigh ESP-IDF. Is e fuasgladh eile dìreach na tha air atharrachadh ùrachadh. Tha am modh-obrach ùrachaidh an urra ris an dreach de ESP-IDF a tha thu a’ cleachdadh. Às dèidh dhut ESP-IDF ùrachadh, cuir an gnìomh an sgriobt Stàlaidh a-rithist, air eagal ’s gum bi feum aig an dreach ùr de ESP-IDF air dreachan eadar-dhealaichte de dh’ innealan. Faic an stiùireadh aig Ceum 3. Suidhich na h-innealan. Cho luath ‘s a bhios na h-innealan ùra air an stàladh, ùraich an àrainneachd a’ cleachdadh an sgriobt Às-mhalairt. Faic an stiùireadh aig Ceum 4. Suidhich na caochladairean àrainneachd.
Sgrìobhainnean co-cheangailte · Stèidhich ceangal sreathach le ESP32 · Plugin Eclipse · Leudachadh VSCode · Monitor IDF
1.4 Tog do chiad phròiseact
Ma tha ESP-IDF agad mu thràth agus mura h-eil thu a’ cleachdadh IDE, faodaidh tu a’ chiad phròiseact agad a thogail bhon loidhne-àithne a’ leantainn Tòisich Pròiseact air Windows no Tòisich Pròiseact air Linux agus macOS.
1.5 Dì-stàlaich ESP-IDF
Ma tha thu airson ESP-IDF a thoirt air falbh, lean an stiùireadh airson ESP-IDF a dhì-stàlachadh.

Siostaman Espressif

44 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 2
Iomradh API
2.1 Co-chruinneachaidhean API
Tha an sgrìobhainn seo a’ toirt cunntas air gnàthasan agus barailean a tha cumanta do Eadar-aghaidhean Prògramaidh Iarrtais (APIan) ESP-IDF. Tha grunn sheòrsaichean eadar-aghaidhean prògramaidh aig ESP-IDF:
· Gnìomhan C, structaran, enums, mìneachaidhean seòrsa agus macros ro-phròiseasar air an dearbhadh ann an ceann-sgrìobhaidh poblach filede cho-phàirtean ESPIDF. Tha tuairisgeulan air na gnìomhan, na structaran agus na seòrsaichean sin ri fhaighinn air diofar dhuilleagan san earrann Iomraidh API den stiùireadh prògramaidh.
· Gnìomhan siostam togail, caochladairean ro-mhìnichte agus roghainnean. Tha iad sin air an clàradh anns an stiùireadh siostam togail. · Faodar roghainnean Kconfig a chleachdadh ann an còd agus anns an t-siostam togail (CMakeLists.txt) files. · Tha innealan aoigheachd agus na paramadairean loidhne-àithne aca cuideachd nam pàirt de eadar-aghaidh ESP-IDF. Tha ESP-IDF air a dhèanamh suas de phàirtean a chaidh a sgrìobhadh gu sònraichte airson ESP-IDF a bharrachd air leabharlannan treas-phàrtaidh. Ann an cuid de chùisean, thèid pasgan sònraichte do ESP-IDF a chur ris an leabharlann treas-phàrtaidh, a’ toirt seachad eadar-aghaidh a tha an dàrna cuid nas sìmplidh no nas fheàrr amalaichte leis a’ chòrr de ghoireasan ESP-IDF. Ann an cùisean eile, thèid an API tùsail den leabharlann treas-phàrtaidh a thaisbeanadh do luchd-leasachaidh an aplacaid. Tha na h-earrannan a leanas a’ mìneachadh cuid de na taobhan de APIan ESP-IDF agus an cleachdadh.
2.1.1 Mearachd ann an làimhseachadh
Bidh a’ mhòr-chuid de APIan ESP-IDF a’ tilleadh chòdan mearachd a tha air am mìneachadh leis an t-seòrsa esp_err_t. Faic an earrann Làimhseachadh Mhearachdan airson tuilleadh fiosrachaidh mu dhòighean-obrach làimhseachaidh mhearachdan. Tha liosta de chòdan mearachd a thilleas co-phàirtean ESP-IDF ann an Iomradh Còd Mearachd.
2.1.2 Structaran rèiteachaidh
Cudromach: Tha tòiseachadh ceart structaran rèiteachaidh na phàirt chudromach ann a bhith a’ dèanamh an aplacaid co-chòrdail ri dreachan san àm ri teachd de ESP-IDF.
Bidh a’ mhòr-chuid de ghnìomhan tòiseachaidh no rèiteachaidh ann an ESP-IDF a’ gabhail mar argamaid comharra gu structar rèiteachaidh. Mar eisimpleirample:
45

Caibideil 2. Iomradh API

const esp_timer_create_args_t my_timer_args = { .callback = &my_timer_callback, .arg = callback_arg, .name = “my_timer”
}; esp_timer_handle_t mo_timer; esp_err_t mearachd = esp_timer_create(&mo_timer_args, &mo_timer);
Cha stòraich gnìomhan tòiseachaidh a’ chomharraiche don structar rèiteachaidh a-riamh, agus mar sin tha e sàbhailte an structar a riarachadh air a’ chruach.
Feumaidh an aplacaid a h-uile raon den structar a thòiseachadh. Tha an leanas ceàrr:
esp_timer_create_args_t my_timer_args; my_timer_args.callback = &my_timer_callback; /* Ceàrr! Chan eil na raointean .arg agus .name air an tòiseachadh */ esp_timer_create(&my_timer_args, &my_timer);
A’ mhòr-chuid de ESP-IDF exampBidh les a’ cleachdadh luchd-tòiseachaidh ainmichte C99 airson tòiseachadh structar, leis gu bheil iad a’ toirt seachad dòigh ghoirid airson fo-sheata de raointean a shuidheachadh, agus na raointean a tha air fhàgail a thòiseachadh aig neoni:
const esp_timer_create_args_t my_timer_args = { .callback = &my_timer_callback, /* Ceart, tha na raointean .arg agus .name air an tòiseachadh gu neoni */
};
Chan eil cànan C++ a’ toirt taic do cho-chàradh nan tòiseachaidhean ainmichte gu C++20, ach tha co-chruinneadair GCC ga thaic gu ìre mar leudachadh. Nuair a bhios tu a’ cleachdadh APIan ESP-IDF ann an còd C++, faodaidh tu beachdachadh air a’ phàtran a leanas a chleachdadh:
esp_timer_create_args_t my_timer_args = {}; /* Tha na raointean uile air an tòiseachadh gu neoni */ my_timer_args.callback = &my_timer_callback;

Tòiseachaidhean bunaiteach
Airson cuid de structaran rèiteachaidh, tha ESP-IDF a’ toirt seachad macros airson luachan bunaiteach raointean a shuidheachadh:
httpd_config_t config = HTTPD_DEFAULT_CONFIG(); /* Leudaichidh HTTPD_DEFAULT_CONFIG gu tòiseachaiche ainmichte.
A-nis tha na luachan bunaiteach aig na raointean uile. Faodar raon sam bith atharrachadh fhathast: */ config.server_port = 8081; httpd_handle_t server; esp_err_t err = httpd_start(&server, &config);
Thathar a’ moladh macros tòiseachaidh bunaiteach a chleachdadh nuair a thèid an toirt seachad airson structar rèiteachaidh sònraichte.

2.1.3 APIan Prìobhaideach
Ceann-sgrìobhaidh sònraichte fileTha APIan anns na h-aplacaidean ann an ESP-IDF a tha an dùil an cleachdadh ann an còd tùsail ESP-IDF a-mhàin, agus chan ann leis na h-aplacaidean. Tha ceann-sgrìobhaidh mar sin fileBidh ainm no slighe nan APIan gu tric a’ toirt a-steach “private” no “esp_private”. Chan eil ach APIan prìobhaideach ann an cuid de phàirtean, leithid hal. Faodar APIan prìobhaideach a thoirt air falbh no atharrachadh ann an dòigh neo-fhreagarrach eadar foillseachaidhean beaga no badan.

2.1.4 Pàirtean ann an example pròiseactan
ESP-IDF exampTha measgachadh de phròiseactan anns na faidhlichean a tha a’ sealltainn cleachdadh APIan ESP-IDF. Gus dùblachadh còd a lughdachadh san examples, tha beagan luchd-cuideachaidh cumanta air am mìneachadh taobh a-staigh cho-phàirtean a bhios iomadh ex a’ cleachdadhamples.

Siostaman Espressif

46 Cuir a-steach fios-air-ais air an sgrìobhainn

Air fhoillseachadh v5.0.9

Caibideil 2. Iomradh API
Tha seo a’ gabhail a-steach co-phàirtean a tha suidhichte

Sgrìobhainnean/Goireasan

Bòrd Leasachaidh ESP32 Dev Kitc bho Espressif Systems [pdfStiùireadh Cleachdaiche
Bòrd Leasachaidh ESP32 Dev Kitc, ESP32, Bòrd Leasachaidh Dev Kitc, Bòrd Leasachaidh Kitc, Bòrd Leasachaidh, Bòrd

Iomraidhean

Leabhar-làimhe cleachdaiche

Bòrd Leasachaidh ESP32 Dev Kitc

Fiosrachadh toraidh

Sònrachaidhean

Stiùireadh airson cleachdadh bathar

1. Tòisich

1.1 Ro-ràdh

1.2 Na tha a dhìth ort

1.3 Stàladh

1.4 Tog do chiad phròiseact

1.5 Dì-stàlaich ESP-IDF

2. Iomradh API

Ceistean Cumanta (FAQ)

C: Ciamar as urrainn dhomh duilgheadasan cumanta le ESP32 fhuasgladh?

C: An urrainn dhomh ESP-IDF a chleachdadh le meanbh-riaghladairean eile?

Sgrìobhainnean/Goireasan

Iomraidhean

Fàg beachd

Sguir an fhreagairt