Bord Forbartha ESP32 Dev Kitc

Eolas Táirge

Sonraíochtaí

Táirge: ESP32
Treoir Chlársceidealaithe: ESP-IDF
Leagan Scaoilte: v5.0.9
Monaróir: Espressif Systems
Dáta Eisiúna: 16 Bealtaine, 2025

Treoracha Úsáide Táirge

1. Tosaigh

Sula dtosaíonn tú ag úsáid an ESP32, bíodh eolas agat ar an
seo a leanas:

1.1 Réamhrá

Foghlaim faoi na feidhmiúlachtaí agus na cumais bhunúsacha atá ag an
ESP32.

1.2 Na rudaí a bheidh uait

Cinntigh go bhfuil an crua-earraí agus na bogearraí riachtanacha agat:

Crua-earraí: Seiceáil an liosta de chrua-earraí riachtanacha
comhpháirteanna.
Bogearraí: Suiteáil an bogearra riachtanach
comhpháirteanna.

1.3 Suiteáil

Lean na céimeanna seo chun an IDE a shuiteáil agus a chur ar bun
timpeallacht:

IDE: Suiteáil an IDE molta le haghaidh
ag clársceidealú an ESP32.
Suiteáil de Láimh: Socraigh de láimh an
timpeallacht más gá.

1.4 Tóg Do Chéad Tionscadal

Cruthaigh agus tóg do thionscadal tosaigh ag baint úsáide as an ESP32.

1.5 Díshuiteáil ESP-IDF

Más gá, foghlaim conas an ESP-IDF a dhíshuiteáil ó do
córas.

2. Tagairt API

Féach ar dhoiciméadacht an API le haghaidh tuilleadh eolais faoi
prótacail feidhmchláir, láimhseáil earráidí, agus cumraíocht
struchtúir.

Ceisteanna Coitianta (FAQ)

C: Conas is féidir liom fadhbanna coitianta le ESP32 a réiteach?

A: Féach ar an rannán fabhtcheartaithe sa treoir ríomhchlárúcháin
nó tabhair cuairt ar shuíomh an mhonaróra websuíomh le haghaidh acmhainní tacaíochta.

C: An féidir liom ESP-IDF a úsáid le micrea-rialaitheoirí eile?

A: Tá ESP-IDF deartha go sonrach le haghaidh ESP32, ach d'fhéadfá a fháil amach
comhoiriúnacht le micrea-rialaitheoirí Espressif eile.

View Fullscreen

ESP32
Treoir Ríomhchlárúcháin ESP-IDF
Scaoileadh v5.0.9 Córais Espressif 16 Bealtaine, 2025

Clár ábhar

1 Tosaigh

1.1 Réamhrá . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.2 Cad is gá duit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.2.1 Crua-earraí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.2.2 Bogearraí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

1.3 Suiteáil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

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

1.3.2 Suiteáil Láimhe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

1.4 Tóg Do Chéad Tionscadal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

1.5 Díshuiteáil ESP-IDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44

2 Tagairt API

2.1 Coinbhinsiúin API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

2.1.1 Láimhseáil earráide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

2.1.2 Struchtúir chumraíochta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

2.1.3 APIanna Príobháideacha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

2.1.4 Comhpháirteanna i sean-ampna tionscadail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

2.1.5 Cobhsaíocht API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

2.2 Prótacail Iarratais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

2.2.1 calafort ASIO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

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

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

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

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

2.2.6 Rialú Áitiúil ESP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95

2.2.7 Nasc Sclábhaí Sraitheach ESP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

2.2.8 Pacáiste Teastas ESP x509 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

2.2.9 Freastalaí HTTP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

2.2.10 Freastalaí HTTPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

2.2.11 Macalla ICMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

2.2.12 Seirbhís mDNS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159

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

2.2.14 Ciseal Líonra IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

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

2.3.1 Bluetooth® Coiteann . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161

2.3.2 Bluetooth® Ísealfhuinnimh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

2.3.3 Bluetooth® Clasaiceach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325

2.3.4 Rialaitheoir & HCI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471

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

2.3.6 APIanna óstach bunaithe ar NimBLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 767

2.4 Tagairt do Chóid Earráide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 769

2.5 APIanna Líonraithe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776

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

2.5.2 Eitiréad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 899

2.5.3 Snáithe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 936

2.5.4 ESP-NETIF. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 942 2.5.5 Sraith Líonra IP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 974 2.5.6 Sraith Feidhmchláir. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 976 2.6 API Forimeallaigh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tiománaí Mód Aon-urchair 977 2.6.1 Tiontaire Analógach go Digiteach (ADC). . . . . . . . . . . . . . . . . 977 2.6.2 Tiománaí Mód Leanúnach Tiontaire Analógach go Digiteach (ADC). . . . . . . . . . . . . . . 986 2.6.3 Tiománaí Calabrúcháin Tiontaire Analógach go Digiteach (ADC). . . . . . . . . . . . . . . . . . . 993 2.6.4 Crann Cloig. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 997 2.6.5 Tiontaire Digiteach go Analógach (DAC). . . . . . . . . . . . . . . . . . . . . . . . . . . . 1004 2.6.6 GPIO & RTC GPIO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1008 2.6.7 Amaireoir Ilchuspóireach (GPTimer). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1027 2.6.8 Ciorcad Idir-Chomhtháite (I2C). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1039 2.6.9 Fuaim Idir-IC (I2S). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1056 2.6.10 LCD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1090 2.6.11 Rialú LED (LEDC). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1107 2.6.12 Modúlóir Leithead Pulse Rialaithe Mótair (MCPWM). . . . . . . . . . . . . . . . . . . . . 1126 2.6.13 Áireamhán Puls (PCNT). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1178 2.6.14 Tarchuradóir Rialaithe Cian (RMT). . . . . . . . . . . . . . . . . . . . . . . . . . . . 1193 2.6.15 Riachtanais Tarraingthe Suas SD. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tiománaí Óstach SDMMC 1220 2.6.16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1223 2.6.17 Tiománaí Óstach SD SPI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1229 2.6.18 Tiománaí Sclábhaí Cárta SDIO. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1234 2.6.19 Modhnú Sigma-Delta (SDM). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1244 2.6.20 Tiománaí Máistir SPI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1249 2.6.21 Tiománaí Sclábhaí SPI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1274 2.6.22 ESP32-WROOM-32SE (Eilimint Shlán). . . . . . . . . . . . . . . . . . . . . . . . . 1281 2.6.23 Braiteoir Tadhaill. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1282 2.6.24 Comhéadan Feithicleach Dhá-Shreang (TWAI). . . . . . . . . . . . . . . . . . . . . . . . . . 1299 2.6.25 Glacadóir/Tarchuradóir Asinchronach Uilíoch (UART). . . . . . . . . . . . . . . . . . 1317 2.7 Cumraíocht Tionscadail. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1342 2.7.1 Réamhrá. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1342 2.7.2 Roghchlár Cumraíochta Tionscadail. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1342 2.7.3 Ag baint úsáide as sdkconfig.defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1342 2.7.4 Rialacha Formáidithe Kconfig. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1343 2.7.5 Comhoiriúnacht Siar ar Roghanna Kconfig. . . . . . . . . . . . . . . . . . . . . . . . 1343 2.7.6 Tagairt do Roghanna Cumraíochta. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1343 2.8 API Soláthair. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1647 2.8.1 Cumarsáid Phrótacail. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1647 2.8.2 Soláthar Aontaithe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1665 2.8.3 Soláthar Wi-Fi. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1669 2.9 API Stórála. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . FileTacaíocht Chórais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1691 2.9.2 Fóntais Déantúsaíochta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1699 2.9.3 Leabharlann Stórála Neamh-so-ghalaithe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1703 2.9.4 Fóntais Gineadóir Deighiltí NVS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1725 2.9.5 Tiománaí SD/SDIO/MMC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1730 2.9.6 SPI Flash API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1744 2.9.7 SPIFFS Filecóras . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1780 2.9.8 Fíorúil filecomhpháirt chórais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1784 2.9.9 API Cothromú Caithimh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1800 2.10 API Córais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1803 2.10.1 Formáid Íomhá Aipe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1803 2.10.2 Rianú Leibhéal Feidhmchláir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1808 2.10.3 Glaoigh ar fheidhm le cruach sheachtrach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1813 2.10.4 Athbhreithniú Sliseanna . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1815 2.10.5 Consól . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1817 2.10.6 Bainisteoir eFuse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1826 2.10.7 Cóid Earráide agus Feidhmeanna Cúnta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1846
ii

2.10.8 ESP HTTPS OTA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1849 2.10.9 Leabharlann Lúb Imeachtaí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1856 2.10.10 FreeRTOS (Os cionnview) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1869 2.10.11 FreeRTOS (ESP-IDF) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1871 2.10.12 FreeRTOS (Gnéithe Forlíontacha) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1988 2.10.13 Leithdháileadh Cuimhne Carn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2008 2.10.14 Dífhabhtú Cuimhne Carn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2021 2.10.15 Amadóir Ardtaifigh (Amadóir ESP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2032 2.10.16 APIanna Inmheánacha agus Éagobhsaí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2038 2.10.17 Glao Idirphróiseálaí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2040 2.10.18 Leithdháileadh Idirbhriseadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2045 2.10.19 Leabharlann logála . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2051 2.10.20 APIanna Córais Ilghnéitheacha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2058 2.10.21 Nuashonruithe Thar an Aer (OTA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2073 2.10.22 Monatóir Feidhmíochta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2084 2.10.23 Bainistíocht Cumhachta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2087 2.10.24 Tacaíocht do Shnáitheanna POSIX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2093 2.10.25 Giniúint Uimhreacha Randamacha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2097 2.10.26 Móid Codlata . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2099 2.10.27 Cumais SoC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2111 2.10.28 Am Córais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2121 2.10.29 An API leithdháilte himem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2126 2.10.30 Cláir Chomhphróiseálaí ULP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2129 2.10.31 Madraí Faire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2161

3 Tagairt Crua-earraí

2167

3.1 Comparáid Sraith Sliseanna . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2167

3.1.1 Doiciméid Ghaolmhara . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2170

4 Threoir API

2171

4.1 Leabharlann Rianaithe Leibhéal an Fheidhmchláir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2171

4.1.1 Tharview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2171

4.1.2 Modhanna Oibríochta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2171

4.1.3 Roghanna Cumraíochta agus Spleáchais . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2172

4.1.4 Conas an Leabharlann seo a Úsáid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2173

4.2 Sreabhadh Tosaithe Feidhmchláir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2181

4.2.1 An chéad stagan luchtóir tosaithe e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2182

4.2.2 Soicind stagan luchtóir tosaithe e . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2182

4.2.3 Tosú feidhmchláir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2183

4.3 Bluetooth® Clasaiceach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2184

4.3.1 Tharview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2184

4.4 Bluetooth® Ísealfhuinnimh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2186

4.4.1 Tharview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2186

4.4.2 Tosaigh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2191

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

4.5 Luchtóir Tosaithe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2284

4.5.1 Comhoiriúnacht tosaitheora . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2285

4.5.2 Leibhéal Logála . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2285

4.5.3 Athshocrú monarchan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2286

4.5.4 Tosaithe ó Fhirmchlár Tástála . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2286

4.5.5 Rolladh Siar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287

4.5.6 Madra Faire . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287

4.5.7 Méid an Luchtóra Tosaithe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287

4.5.8 Tosaithe tapa ó Chodladh Domhain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287

4.5.9 Tosaitheoir saincheaptha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2287

4.6 Córas Tógála . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2288

4.6.1 Tharview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2288

4.6.2 Ag Úsáid an Chórais Tógála . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2289

iii

4.6.3 Exampan Tionscadal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2291 4.6.4 Tionscadal CMakeLists File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2291 4.6.5 Comhpháirt CMakeLists Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2293 4.6.6 Cumraíocht Comhpháirte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2295 4.6.7 Sainmhínithe Réamhphróiseálaí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2295 4.6.8 Riachtanais Chomhpháirteanna . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2295 4.6.9 Codanna den Tionscadal a Shárú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2299 4.6.10 Comhpháirteanna Cumraíochta Amháin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2300 4.6.11 Dífhabhtú CMake . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2300 4.6.12 Example Comhpháirt CMakeLists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2301 4.6.13 Réamhshocruithe saincheaptha sdkconfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2305 4.6.14 Argóintí flash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2305 4.6.15 An Tosaitheoir a Thógáil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2306 4.6.16 Comhpháirteanna CMake Íona a Scríobh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2306 4.6.17 Tionscadail CMake Tríú Páirtí a Úsáid le Comhpháirteanna . . . . . . . . . . . . . . . . . . . . . . 2306 4.6.18 Leabharlanna Réamhthógtha a Úsáid le Comhpháirteanna . . . . . . . . . . . . . . . . . . . . . . . . . . . 2307 4.6.19 ESP-IDF a Úsáid i dTionscadail Saincheaptha CMake . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2307 4.6.20 API Córas Tógála CMake ESP-IDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2308 4.6.21 File Tógálacha Cruinneacha & Incriminteacha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2312 4.6.22 Meiteashonraí Córais a Thógáil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2313 4.6.23 Inmheánaigh an Chórais a Thógáil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2313 4.6.24 Ag aistriú ó ESP-IDF GNU Make System . . . . . . . . . . . . . . . . . . . . . . . . . . . 2315 4.7 Croí-Dumpáil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2316 4.7.1 Tharview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2316 4.7.2 Cumraíochtaí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2317 4.7.3 Sábháil croí-dumpáil chuig an splanc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2317 4.7.4 Dumpáil croí priontála chuig UART . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2318 4.7.5 Feidhmeanna ROM i Lorg Cúltaca . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2318 4.7.6 Athróga a Dhumpáil ar éileamh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2318 4.7.7 Ag rith espcoredump.py . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2319 4.8 Stubanna Dúiseachta Codladh Domhain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2322 4.8.1 Rialacha maidir le Stubanna Dúiseachta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2322 4.8.2 Stub a Chur i bhFeidhm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2322 4.8.3 Cód a Luchtú i gCuimhne RTC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2322 4.8.4 Sonraí a Luchtú i gCuimhne RTC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2323 4.8.5 Seiceáil CRC le haghaidh Stubanna Múscailte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2323 4.8.6 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2323 4.9 Láimhseáil Earráidí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2324 4.9.1 Tharview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2324 4.9.2 Cóid earráide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2324 4.9.3 Cóid earráide a thiontú go teachtaireachtaí earráide . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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 SEICEÁIL MACRAÍ Exampníos lú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2326 4.9.11 Earráid patrúin láimhseála . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2326 4.9.12 Eisceachtaí C++ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2327 4.10 ESP-WIFI-MESH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2327 4.10.1 Tharview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2327 4.10.2 Réamhrá . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2328 4.10.3 Coincheapa ESP-WIFI-MESH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2329 4.10.4 Líonra a Thógáil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2334 4.10.5 Líonra a Bhainistiú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2339 4.10.6 Tarchur Sonraí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2342 4.10.7 Athrú Cainéal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2344
iv

4.10.8 Feidhmíocht . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2347 4.10.9 Nótaí Tuilleadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2348 4.11 Láimhseáil Imeachtaí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2348 4.11.1 Imeachtaí Wi-Fi, Eitirnéad, agus IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2348 4.11.2 Imeachtaí Mogaill . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2349 4.11.3 Imeachtaí Bluetooth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2350 4.12 Earráidí Marfacha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2350 4.12.1 Tharview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2350 4.12.2 Láimhseálaí Scaoill. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2350 4.12.3 Dumpáil agus Rianú Cúltaca Cláraithe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2351 4.12.4 Stub GDB. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2353 4.12.5 Am Teorann Faire RTC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2354 4.12.6 Earráidí Machnamh Guru. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2354 4.12.7 Earráidí Marfacha Eile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2356 4.13 Criptiú Flash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2358 4.13.1 Réamhrá. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2359 4.13.2 Fiúsanna leictreonacha ábhartha. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2359 4.13.3 Próiseas Criptithe Flash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2360 4.13.4 Cumraíocht Criptithe Flash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2360 4.13.5 Teipeanna Féideartha. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2366 4.13.6 Stádas Criptithe Splanc ESP32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2368 4.13.7 Léamh agus Scríobh Sonraí i Flash Criptithe. . . . . . . . . . . . . . . . . . . . . . . 2368 4.13.8 Ag Nuashonrú Flash Criptithe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2369 4.13.9 Criptiú Flash a Dhíchumasú. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2369 4.13.10 Príomhphointí Maidir le Criptiú Flash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2370 4.13.11 Teorainneacha Criptithe Flash. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2370 4.13.12 Criptiú Flash agus Tosaithe Slán. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2371 4.13.13 Gnéithe Ardleibhéil. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2371 4.13.14 Sonraí Teicniúla. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2373 4.14 Astarraingt Crua-earraí. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2373 4.14.1 Ailtireacht. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2374 4.14.2 Sraith LL (Ísealleibhéil). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2375 4.14.3 HAL (Sraith Astarraingthe Crua-earraí). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2376 4.15 Idirbhristí Ardleibhéil. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2377 4.15.1 Leibhéil Idirbhriseadh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2377 4.15.2 Nótaí. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TAG Dífhabhtú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2378 4.16.1 Réamhrá . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2378 4.16.2 Conas a Oibríonn sé? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2379 4.16.3 Ag Roghnú JTAG Cuibheoir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2380 4.16.4 Socrú OpenOCD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2380 4.16.5 Cumrú Sprioc ESP32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2380 4.16.6 Ag Seoladh an Dífhabhtóra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2386 4.16.7 Dífhabhtú Exampníos lú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2386 4.16.8 OpenOCD a Thógáil ó Fhoinsí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2386 4.16.9 Leideanna agus Cúrsaí Ciúine . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2391 4.16.10 Doiciméid Ghaolmhara . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2396 4.17 Giniúint Script Nascóra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2421 4.17.1 Tharview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2421 4.17.2 Tús Tapa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2421 4.17.3 Inmheánaigh Giniúint Script Nascóra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2424 4.18 lwIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2430 4.18.1 APIanna Tacaithe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2430 4.18.2 API Soicéid BSD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2431 4.18.3 Netconn API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2435 4.18.4 Tasc FreeRTOS lwIP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2435 4.18.5 Tacaíocht IPv6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2435 4.18.6 modhnuithe saincheaptha esp-lwip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2436
v

4.18.7 Uasmhéadú Feidhmíochta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2438 4.19 Cineálacha Cuimhne . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2439
4.19.1 DRAM (RAM Sonraí) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2439 4.19.2 IRAM (RAM Treoracha) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2440 4.19.3 IROM (cód arna fhorghníomhú ón splanc) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.4 DROM (sonraí stóráilte i splanc) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.5 RTC Cuimhne mhall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.6 Cuimhne RTC FAST . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.7 Riachtanas Cumasach DMA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2441 4.19.8 Maolán DMA sa chairn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2442 4.20 OpenThread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2442 4.20.1 Móid an chairn OpenThread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2443 4.20.2 Conas Feidhmchlár OpenThread a Scríobh . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2443 4.20.3 An Ródaire Teorann OpenThread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2444 4.21 Táblaí Deighilte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2444 4.21.1 Tharview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2445 4.21.2 Táblaí Deighilte Tógtha Isteach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2445 4.21.3 Táblaí Saincheaptha a Chruthú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2445 4.21.4 Tábla Deighilte Dénártha a Ghiniúint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2448 4.21.5 Seiceálacha Méid na Deighilte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2448 4.21.6 An tábla deighilte a splancadh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2449 4.21.7 Uirlis Deighilte (parttool.py) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2449 4.22 Feidhmíocht . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2450 4.22.1 Conas Feidhmíocht a Uasmhéadú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2450 4.22.2 Treoracha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2451 4.23 Calabrú RF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2468 4.23.1 Calabrú páirteach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2468 4.23.2 Calabrú iomlán . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2469 4.23.3 Gan calabrú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2469 4.23.4 Sonraí tosaithe PHY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2469 4.23.5 Tagairt API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2469 4.24 Tosaithe Slán . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2472 4.24.1 Cúlra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2472 4.24.2 Próiseas Tosaithe Slán Tharview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2473 4.24.3 Eochracha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2473 4.24.4 Méid an Tosaitheora . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2474 4.24.5 Conas Tosaithe Slán a Chumasú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2474 4.24.6 Luchtóir Tosaithe Bogearraí In-athsplanctha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2475 4.24.7 Eochair Shínithe Tosaithe Slán a Ghiniúint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2475 4.24.8 Síniú Íomhánna Cian . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2475 4.24.9 Cleachtais is Fearr maidir le Tosaithe Slán . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2476 4.24.10 Sonraí Teicniúla . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2476 4.24.11 Tosaithe Slán & Criptiú Splanc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2477 4.24.12 Fíorú Aipe Sínithe Gan Crua-earraí Tosaithe Slán . . . . . . . . . . . . . . . . . . . . . 2478 4.24.13 Gnéithe Ardleibhéil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2478 4.25 Tosaithe Slán L2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2478 4.25.1 Cúlra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2479 4.25.2 Ardteistiméireachtaítages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2479 4.25.3 Próiseas Tosaithe Slán V2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2479 4.25.4 Formáid Bloic Shínithe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2480 4.25.5 Líonta Slán . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2480 4.25.6 Bloc Sínithe a Fhíorú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2481 4.25.7 Íomhá a Fhíorú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2481 4.25.8 Méid an Tosaitheora . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2481 4.25.9 Úsáid eFuse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2481 4.25.10 Conas Tosaithe Slán V2 a Chumasú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2481 4.25.11 Srianta tar éis Tosaithe Slán a chumasú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2482 4.25.12 Eochair Shínithe Tosaithe Slán a Ghiniúint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2482
vi

4.25.13 Síniú Íomhánna Cian . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2483 4.25.14 Cleachtais is Fearr maidir le Tosaithe Slán . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2484 4.25.15 Sonraí Teicniúla . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2484 4.25.16 Tosaithe Slán & Criptiú Splanc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2484 4.25.17 Fíorú Aipe Sínithe Gan Crua-earraí Tosaithe Slán . . . . . . . . . . . . . . . . . . . . . 2484 4.25.18 Gnéithe Ardleibhéil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2485 4.26 Tacaíocht do RAM Seachtrach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2485 4.26.1 Réamhrá . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2485 4.26.2 Crua-earraí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2485 4.26.3 RAM Seachtrach a Chumrú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2486 4.26.4 Srianta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2487 4.26.5 Teip ar thúsú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2488 4.26.6 Athbhreithnithe Sliseanna . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2488 4.27 Stóráil Áitiúil Snáithe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2488 4.27.1 Tharview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2488 4.27.2 API Dúchasach FreeRTOS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.27.3 API Pthread . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.27.4 Caighdeán C11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.28 Uirlisí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.28.1 Tosaigh IDF – idf.py . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2489 4.28.2 Íomhá Docair IDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2493 4.28.3 Suiteálaí Windows IDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2495 4.28.4 Bainisteoir Comhpháirteanna IDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2496 4.28.5 IDF Clang Tidy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2497 4.28.6 Uirlisí In-Íoslódáilte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2498 4.29 Tástáil Aonaid in ESP32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2512 4.29.1 Gnáthchásanna Tástála . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2512 4.29.2 Cásanna Tástála Ilghléasanna . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2513 4.29.3 IlghléasannatagCásanna Tástála leictreonacha. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2514 4.29.4 Tástálacha do Spriocanna Éagsúla. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2514 4.29.5 Aip Tástála Aonaid Foirgníochta. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2515 4.29.6 Tástálacha Aonaid á Rith. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2515 4.29.7 Cód Ama le hAthadóir Cúitimh Taisce. . . . . . . . . . . . . . . . . . . . . . . 2516 4.29.8 Magadh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2517 4.30 Tástáil Aonaid ar Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2519 4.30.1 Tástálacha Bogearraí Leabaithe. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2519 4.30.2 Tástálacha Aonaid IDF ar Óstach Linux. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tiománaí Wi-Fi 2520 4.31. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2521 4.31.1 Liosta Gnéithe Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2521 4.31.2 Conas Feidhmchlár Wi-Fi a Scríobh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2521 4.31.3 Cód Earráide API Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2522 4.31.4 Túsú Paraiméadar API Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . 2522 4.31.5 Múnla Cláir Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2522 4.31.6 Cur Síos ar Imeacht Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2523 4.31.7 Cás Ginearálta Stáisiún Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . . . 2526 4.31.8 Cás Ginearálta AP Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2529 4.31.9 Scanadh Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2529 4.31.10 Cás Ceangail Stáisiún Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . 2536 4.31.11 Stáisiún Wi-Fi ESP32 ag Ceangal nuair a aimsítear il-APanna. . . . . . . . . . . . . 2543 4.31.12 Athcheangail Wi-Fi. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2543 4.31.13 Teorainn Ama Beacon Wi-Fi. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2543 4.31.14 Cumraíocht Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2543 4.31.15 Ceangal Éasca Wi-Fi™ (DPP). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2549 4.31.16 Bainistíocht Líonra Gan Sreang. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2549 4.31.17 Tomhas Acmhainní Raidió. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2549 4.31.18 Aistriú BSS Tapa. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2550 4.31.19 Mód Coigilte Cumhachta ESP32 Wi-Fi. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2550 4.31.20 Tréchur Wi-Fi ESP32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
vii

4.31.21 Seol Paicéid Wi-Fi 80211 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2552 4.31.22 Mód Sniffer Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2554 4.31.23 Il-Antennaí Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2554 4.31.24 Faisnéis faoi Staid Cainéal Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2556 4.31.25 Cumraigh Faisnéis faoi Staid Cainéal 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 Blúirse Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2558 4.31.30 Cláraitheoir WPS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2558 4.31.31 Úsáid Maoláin Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2558 4.31.32 Conas Feidhmíocht Wi-Fi a Fheabhsú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2559 4.31.33 Cumraíocht Roghchláir Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2562 4.31.34 Fabhtcheartú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2565 4.32 Slándáil Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2568 4.32.1 Gnéithe Slándála Wi-Fi ESP32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2568 4.32.2 Frámaí Bainistíochta Cosanta (PMF) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2571 4.32.3 WiFi Fiontar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2572 4.32.4 WPA3-Pearsanta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2572 4.32.5 Oscailte Feabhsaithe Wi-Fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2573 4.33 Comhbhaint RF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2573 4.33.1 Tharview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2574 4.33.2 Cás Comhbhainteachta Tacaithe le haghaidh ESP32 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2574 4.33.3 Sásra agus Beartas Comhbhainteachta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2574 4.33.4 Conas an Ghné Chomhchónaithe a Úsáid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2576 4.34 Tógálacha In-athchruthaithe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2577 4.34.1 Réamhrá . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2577 4.34.2 Cúiseanna le tógálacha neamh-in-athchruthaithe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2577 4.34.3 Tógálacha in-athchruthaithe a chumasú in ESP-IDF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2577 4.34.4 Conas a bhaintear tógálacha in-athchruthaithe amach . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2578 4.34.5 Tógálacha in-athchruthaithe agus dífhabhtú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2578 4.34.6 Fachtóirí a mbíonn tionchar acu fós ar thógálacha in-athchruthaithe . . . . . . . . . . . . . . . . . . . . . . . . . . . 2578 4.35 Treoir Úsáideora Mód Ísealchumhachta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2578

5 Threoir Imirce

2579

5.1 Treoir Imirce ESP-IDF 5.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2579

5.1.1 Imirce ó 4.4 go 5.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2579

6 Leabharlann agus Creatlach

2611

6.1 Creatlacha Scamall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2611

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

6.1.2 AWS Idirlíon na Rudaí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2611

6.1.3 Idirlíon na Rudaí Azure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2611

6.1.4 Croí-IoT Google . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2611

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

6.1.6 Joylink Idirlín na Rudaí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2611

6.1.7 Tencent Idirlíon na Rudaí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2612

6.1.8 Tencentyun Idirlíon na Rudaí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2612

6.1.9 Baidu Idirlíon na Rudaí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2612

6.2 Creatlacha Inspioráideacha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2612

6.2.1 Creat Forbartha Fuaime Espressif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2612

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

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

6.2.4 Creat Forbartha ESP-WIFI-MESH . . . . . . . . . . . . . . . . . . . . . . . . . . . 2613

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

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

6.2.7 Réiteach ESP-IoT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2613

6.2.8 Prótacail ESP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2613

viii

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

Treoir 7 Ranníocaíochtaí

2615

7.1 Conas Ranníocaíocht a Dhéanamh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2615

7.2 Sula ndéanann tú ranníocaíocht . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2615

7.3 Próiseas Iarratais Tarraingthe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2615

7.4 An Chuid Dhlíthiúil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2616

7.5 Doiciméid Ghaolmhara . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2616

7.5.1 Treoir Stíle Chreat Forbartha Idirlín na Rudaí Espressif . . . . . . . . . . . . . . . . . . . . . . . 2616

7.5.2 Suiteáil Hook réamh-thiomantais do Thionscadal ESP-IDF . . . . . . . . . . . . . . . . . . . . . . . . . . 2623

7.5.3 Cód Doiciméadaithe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2624

7.5.4 Ag Cruthú Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2629

7.5.5 Teimpléad Doiciméadaithe API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2630

7.5.6 Comhaontú Ranníocóra . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2632

7.5.7 Treoir Cheanntásc Cóipchirt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2634

7.5.8 Tástálacha ESP-IDF le Treoir Pytest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2635

8 Leaganacha ESP-IDF

2645

8.1 Scaoiltí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2645

8.2 Cén Leagan Ba Chóir Dom Tosú Leis? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2645

8.3 Scéim Leaganaithe . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2645

8.4 Tréimhsí Tacaíochta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2646

8.5 Ag Seiceáil an Leagan Reatha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2647

8.6 Sreabhadh Oibre Git . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2648

8.7 ESP-IDF a Nuashonrú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2648

8.7.1 Ag Nuashonrú chuig Scaoileadh Cobhsaí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2649

8.7.2 Nuashonrú chuig Leagan Réamh-Eisiúna . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2649

8.7.3 Ag Nuashonrú chuig an Máistir-Bhrainse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2649

8.7.4 Nuashonrú chuig Brainse Scaoilte . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2650

9 Acmhainní

2651

9.1 ArdánIO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2651

9.1.1 Cad is PlatformIO ann? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2651

9.1.2 Suiteáil . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2651

9.1.3 Cumraíocht . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652

9.1.4 Ranganna Teagaisc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652

9.1.5 Tionscadal Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652

9.1.6 Na Céimeanna Eile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652

9.2 Naisc Úsáideacha . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2652

10 Cóipchearta agus Ceadúnais

2653

10.1 Cóipchearta Bogearraí . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2653

10.1.1 Comhpháirteanna Firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2653

10.1.2 Doiciméadú . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2654

10.2 Cóipchearta an Chóid Foinse ROM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2654

10.3 Ceadúnas MIT Xtensa libhal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2655

10.4 Ceadúnas MIT TinyBasic Plus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2655

Ceadúnas 10.5 TJpgDec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2655

11 Maidir le

2657

12 Athraigh Idir Teangacha

2659

Innéacs

2661

Innéacs

2661

Clár ábhar
Seo an doiciméadú le haghaidh Creat Forbartha IoT Espressif (esp-idf). Is é ESP-IDF an creat forbartha oifigiúil do na SoCanna Sraith ESP32, ESP32-S agus ESP32-C. Déanann an doiciméad seo cur síos ar úsáid ESP-IDF leis an ESP32 SoC.

Faigh Tosaigh

Tagairt API

Treoracha API

Córais Espressif

1 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Clár ábhar

Córais Espressif

2 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1
Faigh Tosaigh
Tá an doiciméad seo ceaptha chun cabhrú leat an timpeallacht forbartha bogearraí a chur ar bun don chrua-earraí bunaithe ar an sliseanna ESP32 ó Espressif. Ina dhiaidh sin, sampla simplíampTaispeánfaidh le duit conas ESP-IDF (Creat Forbartha Espressif IoT) a úsáid le haghaidh cumraíocht roghchláir, agus ansin chun firmware a thógáil agus a splancadh ar bhord ESP32.
Nóta: Is doiciméadacht é seo don leagan cobhsaí v5.0.9 de ESP-IDF. Tá leaganacha eile de ESP-IDF ar fáil freisin.
1.1 Réamhrá
Is córas ar shlis é ESP32 a chomhtháthaíonn na gnéithe seo a leanas: · Wi-Fi (banda 2.4 GHz) · Bluetooth · Croíleacáin LAP dé-ardfheidhmíochta Xtensa® 32-giotán LX6 · Comhphróiseálaí Cumhachta Thar a Bheith Íseal · Ilghnéitheacha
Cumhachtaithe ag teicneolaíocht 40 nm, soláthraíonn ESP32 ardán láidir, comhtháite go mór, a chabhraíonn le freastal ar na héilimh leanúnacha maidir le húsáid chumhachta éifeachtúil, dearadh dlúth, slándáil, ardfheidhmíocht agus iontaofacht. Soláthraíonn Espressif acmhainní bunúsacha crua-earraí agus bogearraí chun cabhrú le forbróirí feidhmchlár a gcuid smaointe a bhaint amach ag baint úsáide as crua-earraí sraith ESP32. Tá creat forbartha bogearraí Espressif beartaithe le haghaidh forbairt feidhmchlár Idirlíon na Rudaí (IoT) le Wi-Fi, Bluetooth, bainistíocht cumhachta agus roinnt gnéithe córais eile.
1.2 Na rudaí a bheidh uait
1.2.1 Crua-earraí
· Bord ESP32. · Cábla USB – USB A / micrea USB B. · Ríomhaire a bhfuil Windows, Linux, nó macOS air.
Nóta: Faoi láthair, tá cuid de na boird forbartha ag baint úsáide as nascóirí USB Cineál C. Bí cinnte go bhfuil an cábla ceart agat chun do bhord a nascadh!
Má tá ceann de na boird forbartha oifigiúla ESP32 atá liostaithe thíos agat, is féidir leat cliceáil ar an nasc chun tuilleadh eolais a fháil faoin gcrua-earraí.
3

Caibidil 1. Tosaigh
ESP32-DevKitS(-R)
Tugann an treoir úsáideora seo faisnéis faoi ESP32-DevKitS(-R), bord splancach bunaithe ar ESP32 arna tháirgeadh ag Espressif. Is meascán de dhá ainm boird é ESP32-DevKitS(-R): ESP32-DevKitS agus ESP32-DevKitS-R. Seasann S do spriongaí, agus seasann R do WROVER.

ESP32-DevKitS

ESP32-DevKitS-R

Tá na príomhchodanna seo a leanas sa cháipéis: · Ag Tosú: Tugann sé léargas forbhreathnaitheview de threoracha socraithe ESP32-DevKitS(-R) agus crua-earraí/bogearraí chun tús a chur leis. · Tagairt Crua-earraí: Soláthraíonn sé faisnéis níos mionsonraithe faoi chrua-earraí ESP32-DevKitS(-R)ns. · Doiciméid Ghaolmhara: Tugann sé naisc chuig doiciméid ghaolmhara.

Ag Tosú Déanann an chuid seo cur síos ar conas tosú le ESP32-DevKitS(-R). Tosaíonn sé le cúpla cuid réamhráiteach faoi ESP32-DevKitS(-R), ansin tugann an chuid Conas Bord a Splancadh treoracha maidir le conas modúl a fheistiú ar ESP32-DevKitS(-R), é a ullmhú, agus firmware a splancadh air.

Tharview Is bord splanctha Espressifns é ESP32-DevKitS(-R) atá deartha go sonrach do ESP32. Is féidir é a úsáid chun modúl ESP32 a splancadh gan an modúl a shádráil leis an soláthar cumhachta agus na línte comhartha. Agus modúl suiteáilte, is féidir ESP32-DevKitS(-R) a úsáid mar bhord forbartha beag cosúil le ESP32-DevKitC.
Ní athraíonn boird ESP32-DevKitS agus ESP32-DevKitS-R ach i leagan amach na bioráin earraigh chun freastal ar na modúil ESP32 seo a leanas.
· Trealamh Forbartha 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
Le haghaidh eolais faoi na modúil thuas, féach ar Mhodúil Sraith ESP32.

Cur síos ar na Comhpháirteanna

Córais Espressif

4 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh

Fíor 1: ESP32-DevKitS – tosaigh

Córais Espressif

Fíor 2: ESP32-DevKitS-R – tosaigh 5
Cuir isteach Aiseolas Doiciméid

Eisiúint v5.0.9

Caibidil 1. Tosaigh

Bioráin Earraigh Chomhpháirte Eochair Ceanntásca Baineann 2.54 mm
Droichead USB-go-UART Nascóir Micrea-USB LDO/Port Micrea USB Cnaipe EN Cnaipe Tosaithe
Cumhacht Ar LED

Cur Síos Cliceáil an modúl isteach. Luífidh na bioráin isteach i bpoill chaistéil an mhodúil. Tá na ceanntásca baineann seo ceangailte le bioráin an mhodúil atá suite ar an mbord seo. Le haghaidh cur síos ar cheanntásca baineann, féach Bloic Cheanntásca. Soláthraíonn droichead USB go UART aon-sliseanna rátaí aistrithe suas le 3 Mbps.
Toirt íseal-titim amach 5V-go-3.3Vtagrialtóir e (LDO).
Comhéadan USB. Soláthar cumhachta don bhord chomh maith leis an gcomhéadan cumarsáide idir ríomhaire agus an bord.
Cnaipe athshocraigh.
Cnaipe Íoslódála. Agus an cnaipe Boot á bhrú síos agus ansin EN á bhrú, cuirtear tús le mód Íoslódála Firmware chun firmware a íoslódáil tríd an gcalafort sraitheach.
Casann sé air nuair a bhíonn an USB nó an soláthar cumhachta ceangailte leis an mbord.

Conas Bord a Splancadh Sula gcuireann tú do ESP32-DevKitS(-R) ar siúl, déan cinnte go bhfuil sé i riocht maith gan aon chomharthaí soiléire damáiste.
Crua-earraí Riachtanacha · Modúl ESP32 de do rogha féin · Cábla USB 2.0 (Caighdeánach-A go Micrea-B) · Ríomhaire ag rith Windows, Linux, nó macOS
Socrú Crua-earraí Suiteáil modúl de do rogha féin ar do ESP32-DevKitS(-R) de réir na gcéimeanna seo a leanas:
· Cuir do mhodúl go réidh ar an mbord ESP32-DevKitS(-R). Cinntigh go bhfuil na poill chaistéil ar do mhodúl ailínithe leis na bioráin earraigh ar an mbord.
· Brúigh do mhodúl síos isteach sa bhord go dtí go gcliceálann sé. · Seiceáil an bhfuil na bioráin earraigh go léir curtha isteach sna poill chaistéil. Má tá roinnt bioráin earraigh mí-ailínithe,
cuir iad i bpoill chaistéileacha le tweezers.
Socrú Bogearraí
An Modh is Fearr Soláthraíonn creat forbartha ESP-IDF bealach is fearr chun comhaid dhénártha a splancadh ar ESP32-DevKitS(-R). Téigh ar aghaidh go dtí Tosaigh, áit a gcabhróidh an Rannóg Suiteála leat an timpeallacht forbartha a bhunú go tapa agus ansin feidhmchlár a splancadh.ample ar do ESP32-DevKitS(-R).
Modh Malartach Mar mhalairt air sin, is féidir le húsáideoirí Windows comhaid dhénártha a splancadh ag baint úsáide as an Flash Download Tool. Níl le déanamh ach é a íoslódáil, é a dhízipeáil, agus na treoracha atá sa bhfillteán doc a leanúint.
Nóta: 1. Chun comhaid dénártha a splancadh files, ba chóir ESP32 a shocrú i mód Íoslódála Firmware. Is féidir é seo a dhéanamh go huathoibríoch leis an uirlis splanctha, nó tríd an gcnaipe Tosaithe a choinneáil síos agus an cnaipe EN a thapáil. 2. Tar éis an dénártha a splancadh files, atosóidh an Flash Download Tool do mhodúl ESP32 agus tosóidh sé an feidhmchlár splancáilte de réir réamhshocraithe.

Toisí an Bhoird Ábhar agus Pacáistiú

Córais Espressif

6 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh Fíor 3: Toisí an bhoird ESP32-DevKitS – ar chúl

Córais Espressif

Fíor 4: Toisí an bhoird ESP32-DevKitS-R – cúl 7
Cuir isteach Aiseolas Doiciméid

Eisiúint v5.0.9

Caibidil 1. Tosaigh
Orduithe miondíola Má ordaíonn tú cúpla ceannampMar sin féin, tagann gach ESP32-DevKitS(-R) i bpacáiste aonair i mála frithstatach nó in aon phacáistiú eile ag brath ar an miondíoltóir. Le haghaidh orduithe miondíola, téigh chuig https://www.espressif.com/en/contact-us/get-samples.
Orduithe Mórdhíola Má ordaíonn tú i mórchóir, tagann na boird i mboscaí cairtchláir mhóra. Le haghaidh orduithe mórdhíola, téigh chuig https://www.espressif.com/en/contact-us/sales-questions.
Tagairt Crua-earraí
Léaráid Bhloc Taispeánann léaráid bhloc thíos comhpháirteanna ESP32-DevKitS(-R) agus a n-idirnaisc.

Fíor 5: ESP32-DevKitS(-R) (cliceáil chun é a mhéadú)
Roghanna Soláthair Cumhachta Tá trí bhealach frithpháirteach ann chun cumhacht a sholáthar don bhord: · Port micrea USB, soláthar cumhachta réamhshocraithe · Bioráin ceanntásca 5V agus GND · Bioráin ceanntásca 3V3 agus GND
Moltar an chéad rogha a úsáid: port micrea USB.

Córais Espressif

Comhartha Lipéid

L1 3V3 VDD 3V3

L2 EN CHIP_PU

L3 VP BRAITHEOIR_VP

BRAITHEOIR_VN L4 VN

L5 34

GPIO34

L6 35

GPIO35

L7 32

GPIO32

L8 33

GPIO33

leanann ar an leathanach seo chugainn

8 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh

Tábla 1 ar leanúint ón leathanach roimhe seo

Comhartha Lipéid

L9 25

GPIO25

L10 26

GPIO26

L11 27

GPIO27

L12 14

GPIO14

L13 12

GPIO12

L14 GND GND

L15 13

GPIO13

L16 D2 SD_DATA2

L17 D3 SD_DATA3

L18 CMD SD_CMD

L19 5V

5V seachtrach

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

Bloic Cheanntásca Chun íomhá de bhloic cheanntásca a fheiceáil, féach ar Thuairis na gComhpháirteanna.

Doiciméid Ghaolmhara
· Sceimlíní ESP32-DevKitS(-R) (PDF) · Bileog Sonraí ESP32 (PDF) · Bileog Sonraí ESP32-WROOM-32 (PDF) · Bileog Sonraí ESP32-WROOM-32D & ESP32-WROOM-32U (PDF) · Bileog Sonraí ESP32-SOLO-1 (PDF) · Bileog Sonraí ESP32-WROVER (PDF) · Bileog Sonraí ESP32-WROVER-B (PDF) · Roghnóir Táirgí ESP

ESP32-DevKitM-1

Cabhróidh an treoir úsáideora seo leat tosú le ESP32-DevKitM-1 agus cuirfidh sé tuilleadh eolais níos doimhne ar fáil freisin.
Is bord forbartha bunaithe ar ESP32-MINI-1(1U) é ESP32-DevKitM-1 arna tháirgeadh ag Espressif. Tá an chuid is mó de na bioráin ionchuir/aschur briste amach chuig na ceanntásca bioráin ar an dá thaobh le haghaidh comhéadan éasca. Is féidir le húsáideoirí forimeallaigh a nascadh le sreanga geansaí nó ESP32-DevKitM-1 a shuiteáil ar chlár aráin.

Córais Espressif

9 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh

ESP32-DevKitM-1 – tosaigh

ESP32-DevKitM-1 – isiméadrach

Tá na príomhchodanna seo a leanas sa cháipéis: · Ag tosú: Tugann sé léargas forbhreathnaitheview de na treoracha socraithe ESP32-DevKitM-1 agus crua-earraí/bogearraí chun tús a chur leis. · Tagairt crua-earraí: Soláthraíonn sé faisnéis níos mionsonraithe faoi chrua-earraí ESP32-DevKitM-1ns. · Doiciméid Ghaolmhara: Tugann sé naisc chuig doiciméid ghaolmhara.

Ag Tosú Déanann an chuid seo cur síos ar conas tosú le ESP32-DevKitM-1. Tosaíonn sé le cúpla cuid réamhráiteach faoin ESP32-DevKitM-1, ansin tugann an chuid Tosaigh Forbairt Feidhmchláir treoracha maidir le conas an chéad thus crua-earraí a dhéanamh agus ansin conas firmware a splancadh ar an ESP32-DevKitM-1.

Tharview Is bord forbartha beag áisiúil é seo a bhfuil gnéithe:
· Modúl ESP32-MINI-1, nó ESP32-MINI-1U · Comhéadan ríomhchlárúcháin USB-go-sraitheach a sholáthraíonn soláthar cumhachta don bhord freisin · ceanntásca bioráin · cnaipí brú le haghaidh athshocrú agus gníomhachtú mód Íoslódála Firmware · cúpla comhpháirt eile

Ábhar agus Pacáistiú

Orduithe miondíola Má ordaíonn tú cúpla ceannampMar sin féin, tagann gach ESP32-DevKitM-1 i bpacáiste aonair i mála frithstatach nó in aon phacáistiú eile ag brath ar do mhiondíoltóir.
Le haghaidh orduithe miondíola, téigh chuig https://www.espressif.com/en/contact-us/get-samples.

Orduithe Mórdhíola Má ordaíonn tú i mórchóir, tagann na boird i mboscaí cairtchláir mhóra. Le haghaidh orduithe mórdhíola, téigh chuig https://www.espressif.com/en/contact-us/sales-questions.

Cur Síos ar na Comhpháirteanna Déanann an figiúr seo a leanas agus an tábla thíos cur síos ar phríomhchodanna, comhéadain agus rialuithe an bhoird ESP32-DevKitM-1. Glacaimid an bord le modúl ESP32-MINI-1 mar shampla.ample sna hailt seo a leanas.

Córais Espressif

10 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh

Fíor 6: ESP32-DevKitM-1 – tosaigh

Príomh-chomhpháirt Modúl ar bord
Cnaipe Tosaithe LDO 5 V go 3.3 V
Cnaipe Athshocraithe Port Micrea-USB
LED Cumhachta Droichead USB-go-UART 3.3 V
Nascóirí I/O

Cur síos
Modúl ESP32-MINI-1 nó modúl ESP32-MINI-1U. Tagann antenna PCB ar bord leis an ESP32-MINI-1. Tagann cónascaire antenna seachtrach leis an ESP32-MINI-1U. Tá pacáiste sliseanna flash 4 MB sa dá mhodúl. Le haghaidh sonraí, féach Bileog Sonraí ESP32-MINI-1 & ESP32-MINI-1U.
Athraíonn rialtóir cumhachta 5 V go 3.3 V.
An cnaipe Íoslódála. Agus tú ag coinneáil síos Boot agus ansin ag brú Athshocraigh, cuirtear tús le mód Íoslódála Firmware chun firmware a íoslódáil tríd an gcalafort sraitheach.
Cnaipe Athshocraigh
Comhéadan USB. Soláthar cumhachta don bhord chomh maith leis an gcomhéadan cumarsáide idir ríomhaire agus an sliseanna ESP32.
Soláthraíonn sliseanna droichead USB-UART aonair rátaí aistrithe suas le 3 Mbps.
Casann sé air nuair a bhíonn an USB ceangailte leis an mbord. Le haghaidh sonraí, féach na sceitseálacha i nDoiciméid Ghaolmhara. Tá na bioráin GPIO uile atá ar fáil (seachas an bus SPI le haghaidh splanc) briste amach chuig na ceanntásca bioráin ar an mbord. Is féidir le húsáideoirí sliseanna ESP32 a chlárú chun feidhmeanna iolracha a chumasú.

Tosaigh ag Forbairt Feidhmchlár Sula gcumhachtaíonn tú do ESP32-DevKitM-1, déan cinnte go bhfuil sé i riocht maith gan aon chomharthaí soiléire damáiste.
Crua-earraí Riachtanacha · ESP32-DevKitM-1 · Cábla USB 2.0 (Caighdeánach-A go Micrea-B) · Ríomhaire ag rith Windows, Linux, nó macOS
Socrú Bogearraí Téigh ar aghaidh go dtí Tosaigh, áit a gcabhróidh an Rannóg Suiteála leat an timpeallacht forbartha a chur ar bun go tapa agus ansin feidhmchlár a splancadh.ampisteach ar do ESP32-DevKitM-1.

Córais Espressif

11 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh
Aird: Tá modúl croí aonair suiteáilte ar bhoird ESP32-DevKitM-1 a monaraíodh roimh 2 Nollaig, 2021. Chun a fhíorú cén modúl atá agat, seiceáil faisnéis marcála modúil i PCN-2021-021. Má tá modúl croí aonair suiteáilte ar do bhord, cumasaigh mód croí aonair (CONFIG_FREERTOS_UNICORE) sa menuconfig sula ndéanann tú d’fheidhmchláir a splancadh.
Léaráid Bhloc Tagartha Crua-earraí Taispeánann léaráid bhloc thíos comhpháirteanna ESP32-DevKitM-1 agus a n-idirnaisc.

Fíor 7: ESP32-DevKitM-1
Roghnú Foinse Cumhachta Tá trí bhealach frithpháirteach ann chun cumhacht a sholáthar don bhord: · Port micrea USB, soláthar cumhachta réamhshocraithe · Bioráin ceanntásca 5V agus GND · Bioráin ceanntásca 3V3 agus GND
Rabhadh: · Ní mór an soláthar cumhachta a sholáthar trí cheann amháin de na roghanna thuas, nó féadfar damáiste a dhéanamh don bhord agus/nó don fhoinse soláthair cumhachta. · Moltar soláthar cumhachta trí phort micrea USB.

Cur Síos ar Bhioráin Tugann an tábla thíos Ainm agus Feidhm na mbiorán ar an dá thaobh den bhord. Le haghaidh cumraíochtaí bioráin imeallacha, féach ar Bhileog Sonraí ESP32.

Níl.

Ainm

Cineál

GND

3V3

Feidhm Talún Soláthar cumhachta 3.3 V

leanann ar an leathanach seo chugainn

Córais Espressif

12 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh

Tábla 2 ar leanúint ón leathanach roimhe seo

Níl.

Ainm

Cineál

Feidhm

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

Athshocraigh; Ard: cumasaigh; Ísle: cumhachtaí as

I34

GPIO34, ADC1_CH6, RTC_GPIO4

I35

GPIO35, ADC1_CH7, RTC_GPIO5

IO32

I/O

GPIO32, XTAL_32K_P (ionchur ocsaileora criostail 32.768 kHz),

ADC1_CH4, TOUCH9, RTC_GPIO9

IO33

I/O

GPIO33, XTAL_32K_N (aschur oscillator criostail 32.768 kHz),

ADC1_CH5, TOUCH8, RTC_GPIO8

IO25

I/O

GPIO25, DAC_1, ADC2_CH8, RTC_GPIO6, EAC_RXD0

IO26

I/O

GPIO26, DAC_2, ADC2_CH9, RTC_GPIO7, EAC_RXD1

IO27

I/O

GPIO27, ADC2_CH7, TOUCH7, RTC_GPIO17, EAC_RX_DV

IO14

I/O

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

HS2_CLK, SD_CLK, EAC_TXD2

Soláthar cumhachta 5 V

IO12

I/O

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

HS2_DATA2, SD_DATA2, EAC_TXD3

IO13

I/O

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

HS2_DATA3, SD_DATA3, EAC_RX_ER

IO15

I/O

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

HS2_CMD, SD_CMD, EAC_RXD3

IO2

I/O

GPIO2, ADC2_CH2, TOUCH2, RTC_GPIO12, HSPIWP,

HS2_DATA0, SD_DATA0

IO0

I/O

GPIO0, ADC2_CH1, TOUCH1, RTC_GPIO11, CLK_OUT1,

EAC_TX_CLK

IO4

I/O

GPIO4, ADC2_CH0, TOUCH0, RTC_GPIO10, HSPIHD,

HS2_DATA1, SD_DATA1, EAC_TX_ER

IO9

I/O

GPIO9, HS1_DATA2, U1RXD, SD_DATA2

IO10

I/O

GPIO10, HS1_DATA3, U1TXD, SD_DATA3

IO5

I/O

GPIO5, HS1_DATA6, VSPICS0, EAC_RX_CLK

IO18

I/O

GPIO18, HS1_DATA7, VSPICLK

IO23

I/O

GPIO23, HS1_STROBE, VSPID

IO19

I/O

GPIO19, VSPIQ, U0CTS, EAC_TXD0

IO22

I/O

GPIO22, VSPIWP, U0RTS, EAC_TXD1

IO21

I/O

GPIO21, VSPIHD, EAC_TX_GA

TXD0

I/O

GPIO1, U0TXD, CLK_OUT3, EAC_RXD2

RXD0

I/O

GPIO3, U0RXD, CLK_OUT2

Sonraí Athbhreithnithe Crua-earraí Níl aon leaganacha roimhe seo ar fáil.
Doiciméid Ghaolmhara
· Bileog Sonraí ESP32-MINI-1 & ESP32-MINI-1U (PDF) · Sceimic ESP32-DevKitM-1 (PDF) · Leagan Amach PCB ESP32-DevKitM-1 (PDF) · Leagan Amach ESP32-DevKitM-1 (DXF) – Is féidir leat view é le Autodesk Viewar líne · Bileog Sonraí ESP32 (PDF) · Roghnóir Táirgí ESP
Le haghaidh doiciméid dearaidh eile don bhord, déan teagmháil linn ag sales@espressif.com.

Córais Espressif

13 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh
1.2.2 Software
Chun tús a chur le húsáid ESP-IDF ar ESP32, suiteáil an bogearra seo a leanas: · Toolschain chun cód a thiomsú le haghaidh ESP32 · Uirlisí a thógáil – CMake agus Ninja chun Feidhmchlár iomlán a thógáil le haghaidh ESP32 · ESP-IDF ina bhfuil API (leabharlanna bogearraí agus cód foinse) le haghaidh ESP32 agus scripteanna chun an Toolschain a oibriú go bunúsach

1.3 Suiteáil
Chun na bogearraí riachtanacha go léir a shuiteáil, cuirimid roinnt bealaí éagsúla ar fáil chun an tasc seo a éascú. Roghnaigh ceann de na roghanna atá ar fáil.
1.3.1 IDE

Nóta: Molaimid go mór an ESP-IDF a shuiteáil trí do IDE is fearr leat.
· Breiseán Eclipse · Síneadh VSCode

1.3.2 Suiteáil láimhe
Chun an nós imeachta láimhe a roghnú, roghnaigh de réir do chórais oibriúcháin.

Córais Espressif

14 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh
Socrú Caighdeánach Toolchain do Windows
Réamhrá Éilíonn ESP-IDF roinnt uirlisí réamhriachtanacha a shuiteáil ionas gur féidir leat firmware a thógáil do sceallóga tacaithe. I measc na n-uirlisí réamhriachtanacha tá Python, Git, tras-thiomsaitheoirí, uirlisí tógála CMake agus Ninja. Chun an Tosaigh seo a dhéanamh, úsáidfimid an Pras Ordú, ach tar éis ESP-IDF a shuiteáil is féidir leat Breiseán Eclipse nó IDE grafach eile le tacaíocht CMake a úsáid ina ionad. Nóta: Teorainneacha: – Ní mór don chonair suiteála do ESP-IDF agus d'Uirlisí ESP-IDF a bheith níos faide ná 90 carachtar. D'fhéadfadh go dteipfeadh ar thógáil mar thoradh ar chosáin suiteála atá ró-fhada. – Ní mór spásanna bána ná lúibíní a bheith sa chonair suiteála do Python nó ESP-IDF. – Níor cheart carachtair speisialta (neamh-ASCII) a bheith sa chonair suiteála do Python nó ESP-IDF mura bhfuil an córas oibriúcháin cumraithe le tacaíocht ó Unicode UTF-8. Is féidir leis an Riarthóir Córais an tacaíocht a chumasú tríd an bPainéal Rialaithe – Athraigh formáidí dáta, ama nó uimhreacha – Táb Riaracháin – Athraigh logán an chórais – seiceáil an rogha ó Bhéite: Úsáid Unicode UTF-8 le haghaidh tacaíocht teanga ar fud an domhain – Ceart go leor agus atosú an ríomhaire.
Suiteálaí Uirlisí ESP-IDF Is é an bealach is fusa chun réamhriachtanais ESP-IDFns a shuiteáil ná ceann de na Suiteálaithe Uirlisí ESP-IDF a íoslódáil.

Íoslódáil Suiteálaí Windows
Cad é an cás úsáide le haghaidh Suiteálaí Ar Líne agus As Líne? Tá Suiteálaí Ar Líne an-bheag agus ceadaíonn sé suiteáil gach scaoileadh atá ar fáil de ESP-IDF. Ní íoslódálfaidh an suiteálaí ach na spleáchais riachtanacha, lena n-áirítear Git For Windows, le linn an phróisis suiteála. Stórálann an suiteálaí na híoslódálacha. files san eolaire taisce %userprofile% espressif
Ní gá aon nasc líonra a bheith agat le haghaidh Suiteálaí As Líne. Tá na spleáchais riachtanacha go léir sa suiteálaí, lena n-áirítear Git For Windows.
Comhpháirteanna na suiteála Imscarann an suiteálaí na comhpháirteanna seo a leanas:
· Python Leabaithe · Tras-thiomsaitheoirí · OpenOCD · Uirlisí tógála CMake agus Ninja · ESP-IDF
Ceadaíonn an suiteálaí athúsáid a dhéanamh ar an eolaire atá ann cheana féin le ESP-IDF freisin. Is é %userpro an t-eolaire molta.file%Desktopesp-idf áit a bhfuil %userprofileIs é % d'eolaire baile.

Córais Espressif

15 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh
Ag Seoladh Timpeallacht ESP-IDF Ag deireadh an phróisis suiteála is féidir leat an rogha Rith Timpeallacht PowerShell ESP-IDF nó Rith Pras Ordú ESP-IDF (cmd.exe) a sheiceáil. Seolfaidh an suiteálaí timpeallacht ESP-IDF sa pras roghnaithe. Rith Timpeallacht PowerShell ESP-IDF:

Fíor 8: An Draoi Socraithe Uirlisí ESP-IDF a Chríochnú le Timpeallacht PowerShell Rith ESP-IDF
Rith Pras Ordú ESP-IDF (cmd.exe):
Ag Úsáid an Pras Ordaithe Maidir leis na céimeanna Tosaigh atá fágtha, úsáidfimid Pras Ordaithe Windows. Cruthaíonn Suiteálaí Uirlisí ESP-IDF aicearra sa roghchlár Tosaigh freisin chun Pras Ordaithe ESP-IDF a sheoladh. Seolann an aicearra seo an Pras Ordaithe (cmd.exe) agus ritheann sé an script export.bat chun na hathróga comhshaoil (PATH, IDF_PATH agus eile) a shocrú. Laistigh den phras ordaithe seo, tá na huirlisí suiteáilte go léir ar fáil. Tabhair faoi deara go bhfuil an aicearra seo sainiúil don eolaire ESP-IDF atá roghnaithe i Suiteálaí Uirlisí ESP-IDF. Má tá il-eolaire ESP-IDF agat ar an ríomhaire (m.sh.ample, chun oibriú le leaganacha éagsúla de ESP-IDF), tá dhá rogha agat iad a úsáid:
1. Cruthaigh cóip den aicearra a chruthaigh Suiteálaí Uirlisí ESP-IDF, agus athraigh eolaire oibre an aicearra nua go dtí an t-eolaire ESP-IDF is mian leat a úsáid.
2. Nó is féidir leat cmd.exe a rith, ansin athraigh go dtí an eolaire ESP-IDF is mian leat a úsáid, agus export.bat a rith. Tabhair faoi deara, murab ionann agus an rogha roimhe seo, go n-éilíonn an bealach seo go mbeidh Python agus Git i láthair i PATH. Má fhaigheann tú earráidí a bhaineann le Python nó Git gan aimsiú, bain úsáid as an gcéad rogha.
Na Céad Chéimeanna ar ESP-IDF Anois, ós rud é go gcomhlíontar na ceanglais go léir, tabharfaidh an chéad topaic eile treoir duit maidir le conas do chéad tionscadal a thosú.

Córais Espressif

16 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh Fíor 9: ESP-IDF PowerShell

Fíor 10: An Draoi Socraithe Uirlisí ESP-IDF a Chríochnú le Rith Pras Ordú ESP-IDF (cmd.exe)

Córais Espressif

17 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh

Fíor 11: Pras Ordaithe ESP-IDF

Córais Espressif

18 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh
Cabhróidh an treoir seo leat sna chéad chéimeanna agus ESP-IDF á úsáid agat. Lean an treoir seo chun tionscadal nua a thosú ar an ESP32 agus aschur na feiste a thógáil, a splancadh agus a mhonatóiriú. Tabhair faoi deara: Mura bhfuil ESP-IDF suiteáilte agat fós, téigh go Suiteáil agus lean na treoracha chun na bogearraí go léir a theastaíonn uait a fháil chun an treoir seo a úsáid.

Tosaigh Tionscadal Anois tá tú réidh chun d’fheidhmchlár a ullmhú le haghaidh ESP32. Is féidir leat tosú leis an tionscadal getstarted/hello_world ó ex.amples eolaire in ESP-IDF.
Tábhachtach: Ní thacaíonn córas tógála ESP-IDF le spásanna sna cosáin chuig ESP-IDF ná chuig tionscadail.
Cóipeáil an tionscadal get-started/hello_world chuig an eolaire ~/esp: cd %userprofile%esp xcopy /e /i %IDF_PATH%examplesget-startedhello_world hello_world
Nóta: Tá raon eis-ample tionscadail san examples eolaire in ESP-IDF. Is féidir leat aon tionscadal a chóipeáil ar an mbealach céanna a chuirtear i láthair thuas agus é a rith. Is féidir freisin exampcomhaid ina n-áit gan iad a chóipeáil ar dtús.

Ceangail Do Ghléas Anois ceangail do bhord ESP32 leis an ríomhaire agus seiceáil faoin gcalafort sraitheach atá an bord le feiceáil. Tosaíonn ainmneacha calafoirt sraitheacha le COM i Windows. Mura bhfuil tú cinnte conas ainm an chalafoirt sraitheach a sheiceáil, féach ar Nasc Sraitheach a Bhunú le ESP32 le haghaidh sonraí iomlána.
Nóta: Coinnigh an t-ainm calafoirt handy mar beidh ort é sna chéad chéimeanna eile.

Cumraigh Do Thionscadal Téigh chuig d’eolaire hello_world, socraigh ESP32 mar an sprioc, agus rith an fóntais chumraíochta tionscadail menuconfig.
CD Windows %userprofile%esphello_world idf.py socraigh sprioc esp32 idf.py cumraíocht roghchláir
Tar éis tionscadal nua a oscailt, ba chóir duit an sprioc a shocrú ar dtús le idf.py set-target esp32. Tabhair faoi deara go ndéanfar tógálacha agus cumraíochtaí atá ann cheana féin sa tionscadal, más ann dóibh, a ghlanadh agus a thosú sa phróiseas seo. Féadfar an sprioc a shábháil san athróg timpeallachta chun an chéim seo a scipeáil ar chor ar bith. Féach Roghnaigh an Sliseanna Sprioc: set-target le haghaidh tuilleadh eolais. Má rinneadh na céimeanna roimhe seo i gceart, feictear an roghchlár seo a leanas: Tá an roghchlár seo á úsáid agat chun athróga sonracha tionscadail a shocrú, m.sh., ainm agus pasfhocal líonra Wi-Fi, luas an phróiseálaí, srl. Féadfar an tionscadal a shocrú le menuconfig a scipeáil le haghaidh ohello_wordp, ós rud é seo...ampRitheann le leis an chumraíocht réamhshocraithe.
Aird: Má úsáideann tú bord ESP32-DevKitC leis an modúl ESP32-SOLO-1, nó bord ESP32-DevKitM-1 leis an modúl ESP32-MIN1-1(1U), cumasaigh mód croí aonair (CONFIG_FREERTOS_UNICORE) sa menuconfig sula ndéanann tú ex a splancadh.amples.

Córais Espressif

19 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh

Fíor 12: Cumraíocht tionscadail – Fuinneog bhaile
Nóta: D’fhéadfadh dathanna an roghchláir a bheith difriúil i do chríochfort. Is féidir leat an chuma a athrú leis an rogha –style. Rith idf.py menuconfig –help le haghaidh tuilleadh eolais.
Más rud é go bhfuil ceann de na boird forbartha a dtacaítear leo in úsáid agat, is féidir leat do fhorbairt a bhrostú trí Phacáiste Tacaíochta Boird a úsáid. Féach Leideanna Breise le haghaidh tuilleadh eolais.
Tóg an tionscadal Tóg an tionscadal trí rith:
idf.py thógáil
Déanfaidh an t-ordú seo an t-iarratas agus na comhpháirteanna ESP-IDF go léir a thiomsú, ansin ginfidh sé an bootloader, an tábla deighilte, agus na dénártha feidhmchláir.
$ idf.py build Ag rith cmake san eolaire /path/to/hello_world/build Ag cur “cmake -G Ninja –warn-uninitialized /path/to/hello_world” i gcrích… Tabhair rabhadh faoi luachanna neamhthosaithe. — Aimsíodh Git: /usr/bin/git (aimsíodh leagan “2.17.0”) — Ag tógáil comhpháirt aws_iot folamh mar gheall ar chumraíocht — Ainmneacha na gcomhpháirteanna: … — Cosáin na gcomhpháirteanna: …
… (níos mó línte aschuir an chórais tógála)
[527/527] Ag giniúint hello_world.bin esptool.py v2.3.1
Tógáil tionscadail críochnaithe. Chun splanc a chur air, rith an t-ordú 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 nó rith 'idf.py -p PORT flash'
Mura bhfuil aon earráidí ann, críochnóidh an tógáil tríd an firmware binary .bin a ghiniúint files.

Córais Espressif

20 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh
Splanc ar an nGléas Splanc na comhaid dhénártha a thóg tú díreach (bootloader.bin, partition-table.bin agus hello_world.bin) ar do bhord ESP32 tríd an méid seo a leanas a rith: idf.py -p PORT [-b BAUD] splanc
Cuir ainm calafoirt sraitheach do bhoird ESP32 in ionad PORT. Is féidir leat an ráta baud splancscáin a athrú freisin tríd an ráta baud atá uait a athsholáthar do BAUD. Is é 460800 an ráta baud réamhshocraithe. Le haghaidh tuilleadh eolais faoi argóintí idf.py, féach idf.py.
Nóta: Tógálann agus splancann an rogha splanc an tionscadal go huathoibríoch, mar sin ní gá idf.py build a rith.

An raibh Fadhbanna ann agus an Flasháil á déanamh? Má ritheann tú an t-ordú tugtha agus má fheiceann tú earráidí ar nós Theip ar nascadh, d'fhéadfadh roinnt cúiseanna a bheith leis seo. Ceann de na cúiseanna d'fhéadfadh a bheith fadhbanna a bhíonn ag esptool.py, an fóntais a ghlaonn an córas tógála air chun an tslis a athshocrú, idirghníomhú leis an tosaitheoir ROM, agus an firmware a splancadh. Réiteach simplí amháin le triail a bhaint as ná athshocrú láimhe a thuairiscítear thíos, agus mura gcabhraíonn sé leat is féidir leat tuilleadh sonraí a fháil faoi fhadhbanna féideartha i bhFabhtcheartú.
Athshocraíonn esptool.py ESP32 go huathoibríoch trí línte rialaithe DTR agus RTS an tslis tiontaire USB go sraitheach a dhearbhú, i.e., FTDI nó CP210x (le haghaidh tuilleadh eolais, féach Nasc Sraitheach a Bhunú le ESP32). Tá na línte rialaithe DTR agus RTS ceangailte le bioráin GPIO0 agus CHIP_PU (EN) ESP32, agus mar sin athraíonn an toirt.tagCuirfidh leibhéil e de DTR agus RTS ESP32 i mód Íoslódála Firmware. Mar shamplaample, seiceáil an sceiméad don bhord forbartha ESP32 DevKitC.
Go ginearálta, níor cheart go mbeadh aon fhadhbanna agat leis na boird forbartha oifigiúla esp-idf. Mar sin féin, ní féidir le esptool.py do chrua-earraí a athshocrú go huathoibríoch sna cásanna seo a leanas:
· Níl na línte DTR agus RTS ceangailte le GPIO0 agus CHIP_PU ar do chrua-earraí · Tá cumraíocht dhifriúil idir na línte DTR agus RTS · Níl aon línte rialaithe sraitheacha den sórt sin ann ar chor ar bith
Ag brath ar an gcineál crua-earraí atá agat, b’fhéidir go mbeadh sé indéanta do bhord ESP32 a chur de láimh i mód Íoslódála Firmware (athshocrú).
· I gcás boird forbartha arna dtáirgeadh ag Espressif, is féidir an fhaisnéis seo a fháil sna treoracha tosaithe nó sna treoracha úsáideora faoi seach.ampChun bord forbartha ESP-IDF a athshocrú de láimh, coinnigh síos an cnaipe Tosaithe (GPIO0) agus brúigh an cnaipe EN (CHIP_PU).
· I gcás cineálacha eile crua-earraí, déan iarracht GPIO0 a tharraingt anuas.

Córais Espressif

21 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh
(ar leanúint ón leathanach roimhe seo) Méid an splanc á chumrú… 3072 beart comhbhrúite go 103… Ag scríobh ag 0x00008000… (100 %) Scríobh 3072 beart (103 comhbhrúite) ag 0x00008000 i 0.0 soicind (éifeachtach 5962.8 kbit/s)… Hais sonraí fíoraithe. 26096 beart comhbhrúite go 15408… Ag scríobh ag 0x00001000… (100 %) Scríobh 26096 beart (15408 comhbhrúite) ag 0x00001000 i 0.4 soicind (éifeachtach 546.7 kbit/s)… Hais sonraí fíoraithe. 147104 beart comhbhrúite go 77364… Ag scríobh ag 0x00010000… (20%) Ag scríobh ag 0x00014000… (40%) Ag scríobh ag 0x00018000… (60%) Ag scríobh ag 0x0001c000… (80%) Ag scríobh ag 0x00020000… (100%) Scríobh 147104 beart (77364 comhbhrúite) ag 0x00010000 i 1.9 soicind (éifeachtach 615.5 kbit/s)… Hais sonraí fíoraithe.
Ag fágáil… Athshocrú crua le bioráin RTS… Arna dhéanamh
Mura bhfuil aon fhadhbanna ann faoi dheireadh an phróisis splanctha, atosóidh an bord agus cuirfidh sé theohello_worldpapplication ar bun. Más mian leat an Eclipse nó VS Code IDE a úsáid in ionad idf.py a rith, féach ar Eclipse Plugin, VSCode Extension.
Déan Monatóireacht ar an Aschur Chun a sheiceáil an bhfuil ohello_worldpis ag rith i ndáiríre, clóscríobh idf.py -p PORT monitor (Ná déan dearmad PORT a athsholáthar le hainm do phoirt sraitheach).
Seolann an t-ordú seo an feidhmchlár IDF Monitor:
$ idf.py -p Ag rith idf_monitor san eolaire […]/esp/hello_world/build Ag forghníomhú “python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_world/build/hello_world.elf”… — idf_monitor ar siúl 115200 —– Scoir: Ctrl+] | Roghchlár: Ctrl+T | Cabhair: Ctrl+T agus ina dhiaidh sin Ctrl+H –ets 8 Meitheamh 2016 00:22:57
chéad:0x1 (POWERON_RESET),tosaithe:0x13 (SPI_FAST_FLASH_BOOT) ets 8 Meitheamh 2016 00:22:57 …
Tar éis do na logaí tosaithe agus diagnóiseacha scrollú suas, ba cheart duit oHello world!p a fheiceáil priontáilte ag an bhfeidhmchlár.
… Haigh a dhomhan! Ag atosú i gceann 10 soicind… Is sliseanna esp32 é seo le 2 chroílár(a) LAP, WiFi/BT/BLE, sileacan athbhreithniú 1, splanc seachtrach 2MB Íosmhéid carn saor in aisce: 298968 beart Ag atosú i gceann 9 soicind… Ag atosú i gceann 8 soicind… Ag atosú i gceann 7 soicind…
Úsáid an t-aicearra Ctrl+] chun monatóir IDF a fhágáil.

Córais Espressif

22 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh
Má theipeann ar mhonatóir IDF go gairid i ndiaidh an uaslódála, nó, má fheiceann tú rud éigin randamach cosúil leis an méid atá tugtha thíos in ionad na dteachtaireachtaí thuas, is dócha go bhfuil criostal 26 MHz á úsáid ag do bhord. Úsáideann formhór na ndearaí boird forbartha 40 MHz, mar sin úsáideann ESP-IDF an mhinicíocht seo mar luach réamhshocraithe.

Má bhíonn fadhb den sórt sin agat, déan an méid seo a leanas: 1. Scoir an monatóir. 2. Téigh ar ais go dtí an roghchlár/cuir i bhfeidhm. 3. Téigh go Cumraíocht Chomhpháirte > Socruithe Crua-earraí > Príomhchumraíocht XTAL > Minicíocht Phríomh XTAL, ansin athraigh CONFIG_XTAL_FREQ_SEL go 26 MHz. 4. Ina dhiaidh sin, tóg agus splancaigh an feidhmchlár arís.
Sa leagan reatha de ESP-IDF, is iad seo a leanas na príomh-mhinicíochtaí XTAL a dtacaítear leo le ESP32:
· 26 MHz · 40 MHz
Nóta: Is féidir leat tógáil, splancadh agus monatóireacht a chomhcheangal in aon chéim amháin tríd an méid seo a leanas a rith: idf.py -p PORT flash monitor
Féach freisin: · Monatóir IDF le haghaidh aicearraí úsáideacha agus tuilleadh sonraí faoi úsáid a bhaint as monatóireacht IDF. · idf.py le haghaidh tagairt iomlán d’orduithe agus roghanna idf.py.
Sin a bhfuil uait chun tús a chur le ESP32! Anois tá tú réidh le triail a bhaint as seans eile.amples, nó téigh díreach chuig forbairt do chuid feidhmchlár féin.
Tábhachtach: Tá cuid de na sean-ampNí thacaíonn na comhaid le ESP32 mar nach bhfuil an crua-earraí riachtanach san áireamh in ESP32 agus mar sin ní féidir tacú leis. Má tá tú ag tógáil sean-earraíample, seiceáil an README le do thoil file don tábla Spriocanna Tacaithe. Má tá sé seo i láthair lena n-áirítear sprioc ESP32, nó mura bhfuil an tábla ann ar chor ar bith, an t-iarampOibreoidh sé ar ESP32.
Leideanna Breise
Fadhbanna ceadanna /dev/ttyUSB0 Le roinnt dáiltí Linux, féadfaidh tú an teachtaireacht earráide Theip ar an gcalafort /dev/ttyUSB0 a oscailt a fháil agus an ESP32 á splancadh. Is féidir é seo a réiteach tríd an úsáideoir reatha a chur leis an ngrúpa dial-out.
Comhoiriúnacht Python Tacaíonn ESP-IDF le Python 3.7 nó níos nuaí. Moltar do chóras oibriúcháin a uasghrádú go leagan is déanaí a chomhlíonann an riachtanas seo. I measc roghanna eile tá suiteáil Python ó fhoinsí nó úsáid córas bainistíochta leaganacha Python ar nós pyenv.
Tosaigh le Pacáiste Tacaíochta Boird Chun fréamhshamáirí a bhrostú ar roinnt boird forbartha, is féidir leat Pacáistí Tacaíochta Boird (BSPanna) a úsáid, rud a fhágann go bhfuil tús a chur le boird ar leith chomh héasca le cúpla glao feidhme.

Córais Espressif

23 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh

De ghnáth, tacaíonn BSP leis na comhpháirteanna crua-earraí go léir a chuirtear ar fáil ar an mbord forbartha. Seachas na feidhmeanna sainmhínithe bioráin agus tosaithe, tagann tiománaithe le BSP do na comhpháirteanna seachtracha amhail braiteoirí, taispeántais, códaic fuaime srl. Déantar na BSPanna a dháileadh trí Bhainisteoir Comhpháirteanna IDF, mar sin is féidir iad a fháil i gClárlann Comhpháirteanna IDF. Seo sampla den chineál seo.ampléargas ar conas ESP-WROVER-KIT BSP a chur le do thionscadal: idf.py add-dependency esp_wrover_kit
Níos mó exampIs féidir sonraí faoi úsáid BSP a fháil i bhfoirm BSPamples fillteán.
Doiciméid Ghaolmhara D’úsáideoirí ardleibhéil ar mian leo an próiseas suiteála a shaincheapadh: · Uirlisí ESP-IDF a nuashonrú ar Windows · Nasc Sraitheach a bhunú le ESP32 · Breiseán Eclipse · Síneadh VSCode · Monatóir IDF
Nuashonrú uirlisí ESP-IDF ar Windows
Suiteáil uirlisí ESP-IDF ag baint úsáide as script Ón Pras Ordaithe Windows, athraigh go dtí an eolaire ina bhfuil ESPIDF suiteáilte. Ansin rith:
suiteáil.bat
I gcás Powershell, athraigh go dtí an eolaire ina bhfuil ESP-IDF suiteáilte. Ansin rith:
suiteáil.ps1
Íoslódálfaidh agus suiteálfaidh sé seo na huirlisí is gá chun ESP-IDF a úsáid. Mura bhfuil an leagan sonrach den uirlis suiteáilte cheana féin, ní dhéanfar aon ghníomh. Íoslódálfar agus suiteálfar na huirlisí in eolaire a shonraítear le linn phróiseas Suiteálaí Uirlisí ESP-IDF. De réir réamhshocraithe, is é seo C:Úsáideoiríainmúsáideora.espressif.
Cuir uirlisí ESP-IDF le PATH ag baint úsáide as script easpórtála. Cruthaíonn suiteálaí uirlisí ESP-IDF aicearra roghchláir Tosaigh do Pras Ordú oESP-IDF. Osclaíonn an aicearra seo fuinneog Pras Ordú ina bhfuil na huirlisí go léir cheana féin.
ar fáil. I gcásanna áirithe, b’fhéidir gur mhaith leat oibriú le ESP-IDF i bhfuinneog Pras Ordaithe nár tosaíodh ag baint úsáide as an aicearra sin. Más amhlaidh atá, lean na treoracha thíos chun uirlisí ESP-IDF a chur le PATH. Sa phras ordaithe ina bhfuil ESP-IDF de dhíth ort, athraigh go dtí an t-eolaire ina bhfuil ESP-IDF suiteáilte, ansin forghníomhaigh export.bat:
cd % userprofile%espesp-idf export.bat
Nó, sa Powershell ina bhfuil ESP-IDF de dhíth ort, athraigh go dtí an eolaire ina bhfuil ESP-IDF suiteáilte, agus ansin forghníomhaigh export.ps1:
cd ~/esp/esp-idf onnmhairiú.ps1
Nuair a bheidh sé seo déanta, beidh na huirlisí ar fáil sa phras ordaithe seo.
Nasc Sraitheach a Bhunú le ESP32 Tugann an chuid seo treoir maidir le conas nasc sraitheach a bhunú idir ESP32 agus ríomhaire.

Córais Espressif

24 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh
Ceangail ESP32 le ríomhaire Ceangail an bord ESP32 leis an ríomhaire ag baint úsáide as an gcábla USB. Mura suiteálann tiománaí an ghléis go huathoibríoch, aithin an tslis tiontaire USB go sraitheach ar do bhord ESP32 (nó dongle tiontaire seachtrach), déan cuardach ar thiománaithe ar an idirlíon agus suiteáil iad. Seo thíos liosta de na sliseanna tiontaire USB go sraitheach atá suiteáilte ar fhormhór na mbord ESP32 arna dtáirgeadh ag Espressif mar aon le naisc chuig na tiománaithe:
· CP210x: Tiománaithe VCP Droichead USB go UART CP210x · FTDI: Tiománaithe Calafoirt COM Fíorúla FTDI Seiceáil treoir úsáideora an bhoird le haghaidh sliseanna tiontaire USB go sraitheach ar leith a úsáidtear. Is le haghaidh tagartha den chuid is mó atá na tiománaithe thuas. Faoi ghnáththosca, ba chóir na tiománaithe a bheith mar chuid de chóras oibriúcháin agus ba chóir iad a shuiteáil go huathoibríoch nuair a cheanglaítear an bord leis an ríomhaire.
Seiceáil an port ar Windows. Seiceáil an liosta de na calafoirt COM atá sainaitheanta i mBainisteoir Gléasanna Windows. Dícheangail ESP32 agus ceangail ar ais é, chun a fhíorú cén port a imíonn ón liosta agus a thaispeántar ar ais arís. Taispeánann na figiúirí thíos an port sraitheach do ESP32 DevKitC agus ESP32 WROVER KIT.

Fíor 13: Droichead USB go UART de ESP32-DevKitC i mBainisteoir Gléasanna Windows

Seiceáil an port ar Linux agus macOS Chun ainm na gléise a sheiceáil don phort sraitheach de do bhord ESP32 (nó dongle tiontaire seachtrach), rith an t-ordú seo faoi dhó, ar dtús agus an bord/dongle díphlugáilte, ansin agus é plugáilte isteach. Is é an port a thaispeántar an dara huair an ceann atá uait: Linux
ls /dev/tty*
macOS

Córais Espressif

25 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh

Fíor 14: Dhá Phort Sraitheach USB de chuid ESP-WROVER-KIT i mBainisteoir Gléasanna Windows

Córais Espressif

26 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh

ls /dev/cu.* Tabhair faoi deara: úsáideoirí macOS: mura bhfeiceann tú an port sraitheach, seiceáil an bhfuil na tiománaithe USB/sraitheach suiteáilte agat. Féach ar an Roinn Ceangail ESP32 le ríomhaire le haghaidh naisc chuig tiománaithe. I gcás macOS High Sierra (10.13), b'fhéidir go mbeidh ort ligean do na tiománaithe luchtú go sainráite freisin. Oscail Roghanna Córais -> Slándáil & Príobháideacht -> Ginearálta agus seiceáil an bhfuil teachtaireacht le feiceáil anseo faoi Bhogearraí Córais ón bhforbróir lp áit a bhfuil ainm an fhorbróra Silicon Labs nó FTDI.

Úsáideoir á chur leis an ngrúpa dialout ar Linux Ba chóir go mbeadh rochtain léite agus scríofa ag an úsáideoir atá logáilte isteach faoi láthair ar an gcalafort sraitheach thar USB. Ar fhormhór na ndáiltí Linux, déantar é seo tríd an úsáideoir a chur leis an ngrúpa dialout leis an ordú seo a leanas:
dialout sudo usermod -a -G $USER
ar Arch Linux déantar é seo tríd an úsáideoir a chur le grúpa uucp leis an ordú seo a leanas:
sudo usermod -a -G uucp $USER
Déan cinnte go ndéanann tú logáil isteach arís chun ceadanna léite agus scríofa a chumasú don sraithphort.
Fíoraigh an nasc sraitheach Anois fíoraigh go bhfuil an nasc sraitheach ag feidhmiú. Is féidir leat é seo a dhéanamh trí chlár críochfoirt sraitheach a úsáid trí sheiceáil an bhfaigheann tú aon aschur ar an teirminéal tar éis ESP32 a athshocrú. Is é 115200 an ráta baud consól réamhshocraithe ar ESP32.
Windows agus Linux Sa chás seoampÚsáidfimid Cliant SSH PuTTY atá ar fáil do Windows agus Linux araon. Is féidir leat cláir sraitheacha eile a úsáid agus paraiméadair chumarsáide a shocrú mar atá thíos. Rith an críochfort agus socraigh an port sraitheach aitheanta. Ráta baud = 115200 (más gá, athraigh é seo go dtí an ráta baud réamhshocraithe don tslis atá in úsáid), giotáin sonraí = 8, giotáin stad = 1, agus paireacht = N. Seo thíos samplaíampScáileáin de shocrú an chalafoirt agus paraiméadair tarchuir den sórt sin (a thuairiscítear go hachomair mar 115200-8-1-N) ar Windows agus Linux. Cuimhnigh an port sraitheach céanna a roghnú a shainaithin tú sna céimeanna thuas. Ansin oscail an port sraitheach sa chríochfort agus seiceáil an bhfeiceann tú aon loga a phriontáil ESP32. Braithfidh ábhar an loga ar an bhfeidhmchlár a lódáiltear chuig ESP32, féach Sampla.ampan Aschur.
Nóta: Dún an críochfort sraitheach tar éis a fhíorú go bhfuil an chumarsáid ag obair. Má choinníonn tú an seisiún críochfoirt ar oscailt, ní bheidh an port sraitheach inrochtana le haghaidh uaslódáil firmware níos déanaí.

macOS Chun an trioblóid a bhaineann le clár críochfoirt sraitheach a shuiteáil a shábháil duit, cuireann macOS an t-ordú screen ar fáil. · Mar a pléadh i Seiceáil port ar Linux agus macOS, rith:

ls /dev/cu.* · Ba chóir go bhfeicfeá aschur cosúil leis seo:

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

/dev/cu.SLAB_

· Athróidh an t-aschur ag brath ar an gcineál agus líon na mbord atá ceangailte le do ríomhaire. Ansin roghnaigh ainm gléis do bhoird agus rith (más gá, athraigh o115200pto an ráta baud réamhshocraithe den tslis atá in úsáid):

screen /dev/cu.device_name 115200 Cuir an t-ainm a fhaightear agus ls /dev/cu.* á rith in ionad ainm_gléise.

Córais Espressif

27 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh

Fíor 15: Cumarsáid Sraitheach a Shocrú i PuTTY ar Windows

Córais Espressif

28 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh

Fíor 16: Cumarsáid Sraitheach a Shocrú i PuTTY ar Linux

Córais Espressif

29 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh
· Is log éigin atá á lorg agat a thaispeántar ar an scáileán. Braithfidh ábhar an loga ar an bhfeidhmchlár atá lódáilte chuig ESP32, féach SamplaampAschur. Chun an seisiún scáileáin a fhágáil clóscríobh Ctrl-A + .
Nóta: Ná déan dearmad an seisiún scáileáin a fhágáil tar éis duit a fhíorú go bhfuil an chumarsáid ag obair. Mura ndéanann tú é sin agus mura ndúnann tú ach an fhuinneog críochfoirt, ní bheidh an port sraitheach inrochtana le haghaidh uaslódáil firmware níos déanaí.
ExampAschur An exampTaispeántar an log thíos. Athshocraigh an bord mura bhfeiceann tú aon rud. ets 8 Meitheamh 2016 00:22:57
chéad:0x5 (DEEPSLEEP_RESET),tosaithe:0x13 (SPI_FAST_FLASH_BOOT) ets 8 Meitheamh 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 stagtosaitheoir I (45) tosaithe: am tiomsaithe 18:48:10
…
Más féidir leat aschur loga inléite a fheiceáil, ciallaíonn sé go bhfuil an nasc sraitheach ag obair agus go bhfuil tú réidh le dul ar aghaidh leis an suiteáil agus ar deireadh an feidhmchlár a uaslódáil chuig ESP32.
Nóta: I gcás roinnt cumraíochtaí sreangaithe calafoirt sraitheacha, ní mór na bioráin sraitheacha RTS & DTR a dhíchumasú sa chlár críochfoirt sula dtosaíonn an ESP32 agus sula dtáirgtear aschur sraitheach. Braitheann sé seo ar an gcrua-earraí féin, níl an fhadhb seo ag formhór na mbord forbartha (lena n-áirítear gach bord Espressif). Bíonn an fhadhb ann má tá RTS & DTR sreangaithe go díreach chuig na bioráin EN & GPIO0. Féach ar dhoiciméadacht esptool le haghaidh tuilleadh sonraí.
Más rud é gur tháinig tú anseo ó Chéim 5. Céad Chéimeanna ar ESP-IDF agus bogearraí á suiteáil le haghaidh forbairt ESP32, is féidir leat leanúint ar aghaidh le Céim 5. Céad Chéimeanna ar ESP-IDF.
Monatóir IDF Is clár críochfoirt sraitheach den chuid is mó é Monatóir IDF a sheolann sonraí sraitheacha chuig agus ó phort sraitheach na ngléasanna sprice. Soláthraíonn sé roinnt gnéithe sainiúla IDF freisin. Is féidir Monatóir IDF a sheoladh ó thionscadal IDF trí idf.py monitor a rith.
Aicearraí Méarchláir Chun idirghníomhú éasca le Monatóir IDF, bain úsáid as na haicearraí méarchláir a thugtar sa tábla.

Córais Espressif

30 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh

Aicearra Méarchláir Ctrl+] Ctrl+T
· Ctrl+T
· Ctrl+] · Ctrl+P
· Ctrl+R
· Ctrl+F
· Ctrl+A (nó A)
· Ctrl+Y
· Ctrl+L
· Ctrl+I (nó I)
· Ctrl+H (nó H)
· Ctrl+X (nó X)
Ctrl+C

Gníomh

Cur síos

Scoir an clár Eochair éalaithe roghchláir Seol carachtar roghchláir féin chuig an gcianrialtán
Seol an carachtar scoir féin chuig an iargúlta
Athshocraigh an sprioc isteach sa luchtóir tosaithe chun an aip a chur ar sos tríd an líne RTS
Athshocraigh an bord sprice trí RTS
Tóg agus splanc an tionscadal

Tóg agus splanc an aip amháin

Stop/atosú priontáil aschuir loga ar an scáileán

Aschur loga stad/atosú sábháilte chuig file

Am stad/atosúamps

priontáil

Taispeáin gach aicearra méarchláir

Brúigh agus lean é le ceann de na heochracha a thugtar thíos.
Athshocraíonn sé an sprioc, isteach sa luchtóir tosaithe tríd an líne RTS (más ceangailte), ionas nach ritheann an bord tada. Úsáideach nuair is gá duit fanacht le gléas eile a thosú. Athshocraíonn sé an bord sprice agus atosaíonn sé an feidhmchlár tríd an líne RTS (más ceangailte).
Cuireann sé sos ar idf_monitor chun sprioc splanc an tionscadail a rith, ansin atosaíonn sé idf_monitor. Aon fhoinse athraithe fileDéantar na comhaid a aththiomsú agus ansin a athsplancadh. Ritheann an sprioc encrypted-flash má cuireadh tús le idf_monitor le hargóint -E. Cuireann sé sos ar idf_monitor chun an sprioc app-flash a rith, ansin atosaíonn sé idf_monitor. Cosúil leis an sprioc flash, ach ní thógtar agus ní athsplanctar ach an príomhaip. Ritheann an sprioc encrypted-app-flash má cuireadh tús le idf_monitor le hargóint -E. Scriosann sé na sonraí sraitheacha isteach go léir agus iad gníomhachtaithe. Ligeann sé sos tapa a chur agus aschur loga a scrúdú gan an monatóir a scor. Cruthaíonn sé file san eolaire tionscadail agus scríobhtar an t-aschur chuige sin file go dtí go ndíchumasaítear é seo leis an aicearra méarchláir chéanna (nó go scoireann Monatóir IDF). Is féidir le Monatóir IDF amchlár a phriontáilamp ag tús gach líne. An t-am is airdeamp is féidir an fhormáid a athrú leis an –timestampargóint líne ordaithe -formáid.

Scoir an clár

Cuir isteach ar an bhfeidhmchlár atá ag rith

Cuireann sé Monatóir IDF ar stad agus ritheann sé dífhabhtóir tionscadail GDB chun an feidhmchlár a dhífhabhtú ag am rithe. Éilíonn sé seo go mbeidh an rogha :ref:CONFIG_ESP_SYSTEM_GDBSTUB_RUNTIME cumasaithe.

Aon eochracha a bhrúitear, seachas Ctrl-] agus Ctrl-T, seolfar tríd an gcalafort sraitheach iad.

Gnéithe sainiúla IDF

Díchódú Uathoibríoch Seoltaí Aon uair a aschuireann ESP-IDF seoladh cód heicsidheachúlach den fhoirm 0x4_______, úsáideann Monatóir IDF addr2line_ chun an suíomh sa chód foinse a chuardach agus ainm na feidhme a aimsiú.
Má thuairteálann aip ESP-IDF agus má théann sí i scaoll, táirgtear dumpáil chlár agus rianú cúltaca, mar shampla an méid seo a leanas:

Córais Espressif

31 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh

Tharla Earráid Machnaimh Guru de chineál StoreProhibited ar chroílár 0. Ba é an eisceacht

gan láimhseáil.

Dumpáil clárúcháin:

: 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 LEITHSCÉAL:

0x0000001d

SEOLADH EXCVADDR: 0x00000000 LBEG : 0x4000c46c IASACHT : 0x4000c477 LCOUNT :

0x00000000

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

Cuireann Monatóir IDF tuilleadh sonraí leis an dumpáil:

Tharla Earráid Machnaimh Guru de chineál StoreProhibited ar chroílár 0. Ba é an eisceacht

gan láimhseáil.

Dumpáil clárúcháin:

: 0x400f360d PS

: 0x00060330 A0

: 0x800dbf56 A1

0x3ffb7e00

0x400f360d: déan_rud_a_thuairteáil ag /home/gus/esp/32/idf/examples/tosaigh/

haileo_domhan/príomh/./haileo_domhan_príomh.c:57

(líneáilte ag) inner_dont_crash ag /home/gus/esp/32/idf/examples/tosaigh/hello_

domhan/príomh/./hello_world_main.c:52

: 0x3ffb136c A3

: 0x00000005 A4

: 0x00000000 A5

0x00000000

: 0x00000000 A7

: 0x00000080 A8

: 0x00000000 A9

0x3ffb7dd0

A10

: 0x00000003 A11

: 0x00060f23 A12

: 0x00060f20 A13

0x3ffba6d0

A14

: 0x00000047 A15

: 0x0000000f SAR

: 0x00000019 LEITHSCÉAL:

0x0000001d

SEOLADH EXCVADDR: 0x00000000 LBEG : 0x4000c46c IASACHT : 0x4000c477 LCOUNT :

0x00000000

Backtrace: 0x400f360d:0x3ffb7e00 0x400dbf56:0x3ffb7e20 0x400dbf5e:0x3ffb7e40 0x400dbf82:0x3ffb7e60 0x400d071d:0x3ffb7e90 0x400f360d: do_something_to_crash at /home/gus/esp/32/idf/examples/get-started/ hello_world/main/./hello_world_main.c:57 (inlíneáilte ag) inner_dont_crash ag /home/gus/esp/32/idf/examples/get-started/hello_ world/main/./hello_world_main.c:52 0x400dbf56: ní_thiteann_an_tuairteáil_síos_ag /home/gus/esp/32/idf/examples/get-started/hello_ world/main/./hello_world_main.c:47 0x400dbf5e: ná tuairteáil ag /home/gus/esp/32/idf/examples/get-started/hello_world/ main/./hello_world_main.c:42 0x400dbf82: app_main ag /home/gus/esp/32/idf/examples/get-started/hello_world/main/ ./hello_world_main.c:33 0x400d071d: príomhthasc ag /home/gus/esp/32/idf/components/esp32/./cpu_start.c:254

Chun gach seoladh a dhíchódú, ritheann IDF Monitor an t-ordú seo a leanas sa chúlra: xtensa-esp32-elf-addr2line -pfiaC -e build/PROJECT.elf ADDRESS

Nóta: Socraigh an t-athróg timpeallachta ESP_MONITOR_DECODE go 0 nó glaoigh ar idf_monitor.py le líne ordaithe shonrach

Córais Espressif

32 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh
rogha: idf_monitor.py –disable-address-decoding chun díchódú seoltaí a dhíchumasú.
Athshocrú Sprioc ar Cheangal De réir réamhshocraithe, athshocróidh Monatóir IDF an sprioc nuair a cheanglaítear leis. Déantar athshocrú na sliseanna sprice ag baint úsáide as na línte sraitheacha DTR agus RTS. Chun cosc a chur ar Mhonatóir IDF an sprioc a athshocrú go huathoibríoch ar cheangal, glaoigh ar Mhonatóir IDF leis an rogha –no-reset (m.sh., idf_monitor.py –no-reset).
Nóta: Cuireann an rogha –no-reset an t-iompar céanna i bhfeidhm fiú agus Monatóir IDF á cheangal le port ar leith (m.sh., idf.py monitor –no-reset -p [PORT]).
Ag Seoladh GDB le GDBStub Is gné úsáideach dífhabhtaithe rith-ama é GDBStub a ritheann ar an sprioc agus a nascann leis an óstach thar an gcalafort sraitheach chun orduithe dífhabhtaithe a fháil. Tacaíonn GDBStub le horduithe ar nós cuimhne agus athróga a léamh, frámaí cruachta glaonna a scrúdú etc. Cé nach bhfuil GDBStub chomh solúbtha le JTAG dífhabhtú, níl aon chrua-earraí speisialta ag teastáil (mar shampla J)TAG (go droichead USB) toisc go ndéantar cumarsáid go hiomlán thar an gcalafort sraitheach. Is féidir sprioc a chumrú chun GDBStub a rith sa chúlra tríd an CONFIG_ESP_SYSTEM_PANIC a shocrú go GDBStub le linn rith-ama. Rithfidh GDBStub sa chúlra go dtí go seolfar teachtaireacht Ctrl+C thar an gcalafort sraitheach agus go gcuirfidh sé faoi deara go mbrisfidh an GDBStub an clár (i.e., go stopfaidh sé forghníomhú an chláir), rud a ligeann do GDBStub orduithe dífhabhtaithe a láimhseáil. Ina theannta sin, is féidir an láimhseálaí scaoill a chumrú chun GDBStub a rith ar thuairteáil tríd an CONFIG_ESP_SYSTEM_PANIC a shocrú go GDBStub ar scaoll. Nuair a tharlaíonn tuairteáil, cuirfidh GDBStub patrún teaghrán speisialta amach thar an gcalafort sraitheach chun a léiriú go bhfuil sé ag rith. Sa dá chás (i.e., an teachtaireacht Ctrl+C a sheoladh, nó an patrún teaghrán speisialta a fháil), seolfaidh Monatóir IDF GDB go huathoibríoch chun ligean don úsáideoir orduithe dífhabhtaithe a sheoladh. Tar éis do GDB imeacht, athshocraítear an sprioc tríd an líne sraitheach RTS. Mura bhfuil an líne seo ceangailte, is féidir le húsáideoirí a sprioc a athshocrú (trí bhrú ar an gcnaipe Athshocraigh ar an mbord).
Nóta: Sa chúlra, ritheann IDF Monitor an t-ordú seo a leanas chun GDB a sheoladh:
xtensa-esp32-elf-gdb -ex “socraigh baud sraitheach BAUD” -ex “sprioc PORT iargúlta” -ex cur isteach ar thógáil/TIONSCADAL.elf :idf_target:`Haigh AINM sliseanna`

Scagadh Aschuir Is féidir monatóir IDF a ghairm mar idf.py monitor –print-filter=”xyz”, áit a bhfuil –print-filter an paraiméadar le haghaidh scagadh aschuir. Is teaghrán folamh an luach réamhshocraithe, rud a chiallaíonn go bhfuil gach rud priontáilte.
Is féidir srianta ar a bhfuil le priontáil a shonrú mar shraith detag>: míreanna inatag> is é an tag sreangán agus Is carachtar ón tacar {N, E, W, I, D, V, *} é a thagraíonn do leibhéal le haghaidh logála.
Le haghaidh example, PRINT_FILTER=”tag1:W" a mheaitseálann agus a phriontálann na haschuir a scríobhadh le ESP_LOGW("tag1”, …) nó ag leibhéal foclach níos ísle, i.e. ESP_LOGE(“tag1″, …). Gan sonrú a nó ag baint úsáide as * réamhshocraithe go leibhéal Verbose.
Nóta: Bain úsáid as logáil phríomhúil chun na haschuir nach bhfuil uait a dhíchumasú ag an tiomsú tríd an leabharlann logála. Is réiteach tánaisteach é scagadh aschuir le monatóir IDF a d'fhéadfadh a bheith úsáideach chun na roghanna scagtha a choigeartú gan an feidhmchlár a aththiomsú.
D'aip tags ní mór gan spásanna, réaltaí *, ná idirstadanna a bheith ann : le bheith comhoiriúnach leis an ngné scagtha aschuir.
Mura leanann aisiompar an líne dheireanach den aschur i d’aip, d’fhéadfadh mearbhall a bheith ar an scagadh aschuir, i.e., tosaíonn an monatóir ag priontáil na líne agus faigheann sé amach ina dhiaidh sin nár cheart an líne a scríobh. Is fadhb aitheanta í seo agus is féidir í a sheachaint trí aisiompar a chur leis i gcónaí (go háirithe nuair nach leanann aon aschur díreach ina dhiaidh).

Córais Espressif

33 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh
ExampRialacha Scagtha:
· Is féidir * a úsáid chun aon cheann a mheaitseáil tags. Mar sin féin, an teaghrán PRINT_FILTER=”*:I tag1:E” maidir le tagNí phriontálann 1 ach earráidí, mar gheall ar an riail le haghaidh tagTá tosaíocht níos airde ag 1 thar an riail le haghaidh *.
· Is ionann an riail réamhshocraithe (folamh) agus *:V mar gheall ar gach rud a mheaitseálann tag ag an leibhéal Verbose nó níos ísle ciallaíonn sé gach rud a mheaitseáil.
· Cuireann “*:N” cosc ní hamháin ar aschuir ó fheidhmeanna logála, ach ar na priontaí a dhéanann printf, etc. freisin. Chun seo a sheachaint, bain úsáid as *:E nó leibhéal foclóireachta níos airde.
· Rialacha “tag1:V”, “tag1:v”, “tag1:”, “tag1:*”, agus “tagTá “1” coibhéiseach. · Riail “tag1:I tagIs ionann “1:E” agus “tag1:E” mar gheall ar aon tarlú dá bharr sin den rud céanna tag
Scríobhann an t-ainm an ceann roimhe sin. · Riail “tag1:mé tagPriontaí 2:W” amháin tag1 ag leibhéal foclóireachta an Eolais nó níos ísle agus tag2 ag an Rabhadh
leibhéal foclóireachta nó níos ísle. · Riail “tag1:mé tag2:I tagTá 3:N” cothrom go bunúsach leis an gceann roimhe seo mar gheall ar tagSonraíonn 3:N
go tagNíor cheart 3 a phriontáil. tag3:N sa riail “tag1:mé tag2:I tagTá níos mó brí ag baint le “3:N *:V” mar gan é tag3:N an
tagD’fhéadfaí 3 theachtaireacht a phriontáil; na hearráidí le haghaidh tag1 agus tagPriontálfar 2 ag an leibhéal foclóireachta sonraithe (nó níos ísle) agus priontálfar gach rud eile de réir réamhshocraithe.
Eiseamláir Scagtha Níos CastaampFuarthas an blúire loga seo a leanas gan aon roghanna scagtha:
luchtú:0x40078000,líon:13564 iontráil 0x40078d4c E (31) esp_image: tá beart draíochta neamhbhailí san íomhá ag 0x30000 W (31) esp_image: tá mód SPI neamhbhailí san íomhá ag 0x30000 255 E (39) tosaithe: Ní féidir an chuid den aip monarchan a thosú I (568) cpu_start: LAP Pro suas. I (569) heap_init: Ag tosú. RAM ar fáil le haghaidh leithdháileadh dinimiciúil: I (603) cpu_start: Cód úsáideora tosaithe LAP Pro D (309) light_driver: [light_init, 74]:status: 1, mód: 2 D (318) vfs: tá esp_vfs_register_fd_range rathúil don raon <54; 64) agus VFS ID 1 I (328) wifi: tasc tiománaí wifi: 3ffdbf84, prio:23, stack:4096, core=0
Tugtar an t-aschur gabhtha do na roghanna scagtha PRINT_FILTER=”wifi esp_image:E light_driver:I” thíos:
E (31) esp_image: tá beart draíochta neamhbhailí san íomhá ag 0x30000 I (328) wifi: tasc tiománaí wifi: 3ffdbf84, prio:23, stack:4096, core=0
Taispeánann na roghanna “PRINT_FILTER=”light_driver:D esp_image:N boot:N cpu_start:N vfs:N wifi:N *:V” an t-aschur seo a leanas:
luchtú:0x40078000,líon:13564 iontráil 0x40078d4c I (569) heap_init: Ag tosú. RAM ar fáil le haghaidh leithdháileadh dinimiciúil: D (309) tiománaí_solais: [light_init, 74]:stádas: 1, mód: 2
Fadhbanna Aitheanta le Monatóir IDF
Fadhbanna a Breathnaíodh ar Windows
· Ní oibríonn eochracha saigheada, chomh maith le roinnt eochracha eile, i GDB mar gheall ar theorainneacha Consól Windows. · Ó am go chéile, nuair a bhíonn oidf.pypexits ann, féadfaidh sé stopadh ar feadh suas le 30 soicind sula dtosaíonn Monatóir IDF arís. · Nuair a ritheann ogdbpis, féadfaidh sé stopadh ar feadh tamaill ghairid sula dtosaíonn sé ag cumarsáid leis an GDBStub.

Córais Espressif

34 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh le Socrú Caighdeánach Uirlisí do Linux agus macOS

Suiteáil Céim ar Chéim Is treoir mhionsonraithe é seo a threoróidh tú tríd an bpróiseas suiteála.
Timpeallacht Forbartha a Chur Ar Bun Seo iad na céimeanna chun an ESP-IDF a chur ar bun do do ESP32. · Céim 1. Réamhriachtanais a Shuiteáil · Céim 2. Faigh ESP-IDF · Céim 3. Na huirlisí a Chur Ar Bun · Céim 4. Na hathróga timpeallachta a Chur Ar Bun · Céim 5. Na Céad Chéimeanna ar ESP-IDF
Céim 1. Réamhriachtanais Suiteála Chun ESP-IDF a úsáid leis an ESP32, ní mór duit roinnt pacáistí bogearraí a shuiteáil bunaithe ar do Chóras Oibriúcháin. Cabhróidh an treoir thusála seo leat gach rud a shuiteáil ar chórais atá bunaithe ar Linux agus macOS.
D’Úsáideoirí Linux Chun tiomsú ag baint úsáide as ESP-IDF beidh ort na pacáistí seo a leanas a fháil. Braitheann an t-ordú atá le rith ar an dáileadh de Linux atá in úsáid agat:
· 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 update && sudo yum install git wget flex bison gperf python3 cmake ninja-build ccache dfu-util libusbx
Tacaítear le CentOS 7 fós ach moltar leagan 8 de CentOS le haghaidh eispéireas úsáideora níos fearr. · Arch: sudo pacman -S –need gcc git make flex bison gperf python cmake ninja ccache dfu-util libusb
Nóta: · Tá CMake leagan 3.16 nó níos nuaí ag teastáil le húsáid le ESP-IDF. Rith otools/idf_tools.py suiteáil cmakepto suiteáil leagan oiriúnach mura bhfuil ceann ag do leaganacha OS. · Mura bhfeiceann tú do dháileadh Linux sa liosta thuas, féach ar a dhoiciméadú le fáil amach cén ordú atá le húsáid le haghaidh suiteáil pacáiste.
I gcás úsáideoirí macOS, úsáidfidh ESP-IDF an leagan de Python atá suiteáilte de réir réamhshocraithe ar macOS. · Suiteáil CMake & Ninja build: Má tá HomeBrew agat, is féidir leat an méid seo a leanas a rith: brew install cmake ninja dfu-util Má tá MacPorts agat, is féidir leat an méid seo a leanas a rith: sudo port install cmake ninja dfu-util Seachas sin, féach ar leathanaigh bhaile CMake agus Ninja le haghaidh íoslódálacha suiteála macOS.

Córais Espressif

35 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh
· Moltar go láidir ccache a shuiteáil freisin le haghaidh tógálacha níos tapúla. Má tá HomeBrew agat, is féidir é seo a dhéanamh trí brew install ccache nó sudo port install ccache ar MacPorts.
Nóta: Má thaispeántar earráid mar seo le linn aon chéime: xcrun: earráid: cosán forbróra gníomhach neamhbhailí (/Library/Developer/CommandLineTools), xcrun ar iarraidh ag: /Library/Developer/CommandLineTools/usr/bin/xcrun
Ansin beidh ort na huirlisí líne ordaithe XCode a shuiteáil le leanúint ar aghaidh. Is féidir leat iad seo a shuiteáil trí xcode-select –install a rith.
Úsáideoirí Apple M1 Má úsáideann tú ardán Apple M1 agus má fheiceann tú earráid mar seo: RABHADH: tá eolaire don uirlis xtensa-esp32-elf leagan esp-2021r2-patch3-8.4.0 i láthair, ach ní bhfuarthas an uirlis EARRÁID: níl aon leaganacha suiteáilte den uirlis xtensa-esp32-elf. Rith 'install.sh' le do thoil chun é a shuiteáil.
nó: zsh: cineál LAP lochtach sa chomhad inrite: ~/.espressif/tools/xtensa-esp32-elf/esp-2021r2patch3-8.4.0/xtensa-esp32-elf/bin/xtensa-esp32-elf-gcc
Ansin beidh ort Apple Rosetta 2 a shuiteáil trí /usr/sbin/softwareupdate –install-rosetta –agree-to-license a rith.
Ag suiteáil Python 3 Bunaithe ar nótaí eisiúna macOS Catalina 10.15, ní mholtar Python 2.7 a úsáid agus ní bheidh Python 2.7 san áireamh de réir réamhshocraithe i leaganacha amach anseo de macOS. Seiceáil cén Python atá agat faoi láthair: python –version
Más cosúil le Python 2.7.17 an t-aschur, is é Python 2.7 an léirmhínitheoir réamhshocraithe atá agat. Más ea, seiceáil freisin an bhfuil Python 3 suiteáilte ar do ríomhaire cheana féin: python3 –version
Má thugann an t-ordú thuas earráid ar ais, ciallaíonn sé nach bhfuil Python 3 suiteáilte. Seo thíos forbhreathnú.view de na céimeanna chun Python 3 a shuiteáil.
· Is féidir suiteáil le HomeBrew a dhéanamh mar seo a leanas: brew install python3
· Má tá MacPorts agat, is féidir leat an méid seo a leanas a rith: sudo port install python38
Céim 2. Faigh ESP-IDF Chun feidhmchláir a thógáil don ESP32, beidh na leabharlanna bogearraí arna soláthar ag Espressif i stórlann ESP-IDF ag teastáil uait. Chun ESP-IDF a fháil, nascleanúint chuig d'eolaire suiteála agus clónáil an stórlann le git clone, ag leanúint na dtreoracha thíos atá sainiúil do do chóras oibriúcháin. Oscail an Críochfort, agus rith na horduithe seo a leanas:

Córais Espressif

36 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh

mkdir -p ~/esp cd ~/esp git clón -b v5.0.9 –athchúrsach https://github.com/espressif/esp-idf.git
Déanfar ESP-IDF a íoslódáil go ~/esp/esp-idf. Téigh i gcomhairle le Leaganacha ESP-IDF chun faisnéis a fháil faoin leagan ESP-IDF is cóir a úsáid i gcás ar leith.
Céim 3. Socraigh na huirlisí Chomh maith leis an ESP-IDF, ní mór duit na huirlisí a úsáideann ESP-IDF a shuiteáil freisin, amhail an tiomsaitheoir, an dífhabhtóir, pacáistí Python, srl., do thionscadail a thacaíonn le ESP32. cd ~/esp/esp-idf ./install.sh esp32
nó le cd sliogán Éisc ~/esp/esp-idf ./install.fish esp32
Suiteálann na horduithe thuas uirlisí le haghaidh ESP32 amháin. Más mian leat tionscadail a fhorbairt do níos mó spriocanna sliseanna, ba chóir duit iad uile a liostáil agus a rith mar shamplaample: cd ~/esp/esp-idf ./install.sh esp32,esp32s2
nó le cd sliogán Éisc ~/esp/esp-idf ./install.fish esp32,esp32s2
Chun uirlisí a shuiteáil do na spriocanna uile a dtacaítear leo, rith an t-ordú seo a leanas le do thoil: cd ~/esp/esp-idf ./install.sh all
nó le cd sliogán Éisc ~/esp/esp-idf ./install.fish all
Nóta: I gcás úsáideoirí macOS, má thaispeántar earráid mar seo le linn aon chéime:urlearráid oscailte [SSL: CERTIFICATE_VERIFY_FAILED] theip ar fhíorú teastais: ní féidir teastas an eisitheora áitiúil a fháil (_ssl.c:xxx)
Féadfaidh tú Install Certificates.command a rith i bhfillteán Python do ríomhaire chun deimhnithe a shuiteáil. Le haghaidh tuilleadh sonraí, féach Earráid Íoslódála agus Uirlisí ESP-IDF á Shuiteáil.

Malartach File Íoslódálacha Íoslódálann suiteálaí na n-uirlisí roinnt fileceangailte le hEisiúintí GitHub. Más mall an rochtain ar GitHub, is féidir athróg timpeallachta a shocrú chun freastalaí íoslódála Espressifns a roghnú le haghaidh íoslódálacha sócmhainní GitHub.

Nóta: Ní rialaíonn an socrú seo ach uirlisí aonair a íoslódáladh ó eisiúintí GitHub, ní athraíonn sé an URLa úsáidtear chun rochtain a fháil ar aon stórtha Git.

Chun freastalaí íoslódála Espressif a roghnú agus uirlisí á suiteáil agat, bain úsáid as an seicheamh orduithe seo a leanas agus install.sh á rith agat:

Córais Espressif

37 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh

cd ~/esp/esp-idf easpórtáil IDF_GITHUB_ASSETS=”dl.espressif.com/github_assets” ./install.sh
Cosán suiteála na n-uirlisí a shaincheapadh Suiteálann na scripteanna a thugtar isteach sa chéim seo uirlisí tiomsaithe a theastaíonn ó ESP-IDF laistigh den eolaire baile úsáideora: $HOME/.espressif ar Linux. Más mian leat na huirlisí a shuiteáil in eolaire difriúil, socraigh an athróg comhshaoil IDF_TOOLS_PATH sula ritheann tú na scripteanna suiteála. Déan cinnte go bhfuil ceadanna leordhóthanacha ag do chuntas úsáideora chun an cosán seo a léamh agus a scríobh. Má tá tú ag athrú IDF_TOOLS_PATH, déan cinnte go bhfuil sé socraithe go dtí an luach céanna gach uair a fhorghníomhaítear an script Suiteála (install.bat, install.ps1 nó install.sh) agus script Easpórtála (export.bat, export.ps1 nó export.sh).
Céim 4. Socraigh na hathróga comhshaoil Níl na huirlisí suiteáilte curtha leis an athróg comhshaoil PATH fós. Chun na huirlisí a úsáid ón líne ordaithe, ní mór roinnt athróga comhshaoil a shocrú. Soláthraíonn ESP-IDF script eile a dhéanann sin. Sa chríochfort ina bhfuil tú chun ESP-IDF a úsáid, rith:
. $HOME/esp/esp-idf/export.sh
nó le haghaidh iasc (níl tacaíocht ann ach ó leagan 3.0.0 d'iasc):
$HOME/esp/esp-idf/easpórtáil.iasc
Tabhair faoi deara an spás idir an ponc tosaigh agus an cosán! Más mian leat esp-idf a úsáid go minic, is féidir leat leasainm a chruthú chun export.sh a fhorghníomhú:
1. Cóipeáil agus greamaigh an t-ordú seo a leanas chuig do shellns profile (.profile, .bashrc, .zprofile, srl.)
ailias get_idf='. $HOME/esp/esp-idf/export.sh' 2. Athnuachan an chumraíocht tríd an seisiún críochfoirt a atosú nó trí fhoinse [cosán chuig pro] a rith.file],
le haghaidh example, foinse ~/.bashrc. Anois is féidir leat get_idf a rith chun an timpeallacht esp-idf a bhunú nó a athnuachan in aon seisiún críochfoirt. Go teicniúil, is féidir leat export.sh a chur le do shellns profile go díreach; ní mholtar é, áfach. Má dhéantar amhlaidh, cuirtear timpeallacht fhíorúil IDF i ngníomh i ngach seisiún críochfoirt (lena n-áirítear iad siúd nach bhfuil gá le IDF), rud a chuireann isteach ar chuspóir na timpeallachta fíorúla agus a théann i bhfeidhm ar bhogearraí eile is dócha.
Céim 5. Na Céad Chéimeanna ar ESP-IDF Anois, ós rud é go gcomhlíontar na ceanglais go léir, tabharfaidh an chéad topaic eile treoir duit maidir le conas do chéad tionscadal a thosú. Cabhróidh an treoir seo leat sna chéad chéimeanna ag baint úsáide as ESP-IDF. Lean an treoir seo chun tionscadal nua a thosú ar an ESP32 agus aschur na feiste a thógáil, a splancadh, agus a mhonatóiriú.
Nóta: Mura bhfuil ESP-IDF suiteáilte agat fós, téigh go dtí Suiteáil agus lean na treoracha chun na bogearraí go léir a theastaíonn uait a fháil chun an treoir seo a úsáid.

Tosaigh Tionscadal Anois tá tú réidh chun d’fheidhmchlár a ullmhú le haghaidh ESP32. Is féidir leat tosú leis an tionscadal getstarted/hello_world ó ex.amples eolaire in ESP-IDF.

Tábhachtach: Ní thacaíonn córas tógála ESP-IDF le spásanna sna cosáin chuig ESP-IDF ná chuig tionscadail.

Cóipeáil an tionscadal get-started/hello_world chuig an eolaire ~/esp:

Córais Espressif

38 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh
cd ~/esp cp -r $IDF_PATH/examples/get-started/hello_world .
Nóta: Tá raon eis-ample tionscadail san examples eolaire in ESP-IDF. Is féidir leat aon tionscadal a chóipeáil ar an mbealach céanna a chuirtear i láthair thuas agus é a rith. Is féidir freisin exampcomhaid ina n-áit gan iad a chóipeáil ar dtús.
Ceangail Do Ghléas Anois ceangail do bhord ESP32 leis an ríomhaire agus seiceáil faoin gcalafort sraitheach atá an bord le feiceáil. Tá na patrúin ainmniúcháin seo a leanas ag calafoirt sraitheacha:
· Linux: ag tosú le /dev/tty · macOS: ag tosú le /dev/cu. Mura bhfuil tú cinnte conas ainm an chalafoirt sraitheach a sheiceáil, féach ar Nasc Sraitheach a Bhunú le ESP32 le haghaidh sonraí iomlána.
Nóta: Coinnigh an t-ainm calafoirt handy mar beidh ort é sna chéad chéimeanna eile.
Cumraigh Do Thionscadal Téigh chuig d'eolaire hello_world, socraigh ESP32 mar an sprioc, agus rith an fóntais chumraíochta tionscadail menuconfig.cd ~/esp/hello_world idf.py set-target esp32 idf.py menuconfig
Tar éis tionscadal nua a oscailt, ba chóir duit an sprioc a shocrú ar dtús le idf.py set-target esp32. Tabhair faoi deara go ndéanfar tógálacha agus cumraíochtaí atá ann cheana sa tionscadal, más ann dóibh, a ghlanadh agus a thosú sa phróiseas seo. Is féidir an sprioc a shábháil san athróg timpeallachta chun an chéim seo a scipeáil ar chor ar bith. Féach Roghnaigh an Sliseanna Sprioc: set-target le haghaidh tuilleadh eolais. Má rinneadh na céimeanna roimhe seo i gceart, feictear an roghchlár seo a leanas:

Fíor 17: Cumraíocht tionscadail – Fuinneog bhaile Tá an roghchlár seo á úsáid agat chun athróga sonracha tionscadail a shocrú, m.sh., ainm agus pasfhocal líonra Wi-Fi, luas an phróiseálaí, srl. Is féidir an tionscadal a shocrú le menuconfig a scipeáil le haghaidh ohello_worldp, ós rud é go bhfuil an sampla seo...ampritheann sé le

Córais Espressif

39 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh
cumraíocht réamhshocraithe.
Aird: Má úsáideann tú bord ESP32-DevKitC leis an modúl ESP32-SOLO-1, nó bord ESP32-DevKitM-1 leis an modúl ESP32-MIN1-1(1U), cumasaigh mód croí aonair (CONFIG_FREERTOS_UNICORE) sa menuconfig sula ndéanann tú ex a splancadh.amples.
Nóta: D’fhéadfadh dathanna an roghchláir a bheith difriúil i do chríochfort. Is féidir leat an chuma a athrú leis an rogha –style. Rith idf.py menuconfig –help le haghaidh tuilleadh eolais.
Más rud é go bhfuil ceann de na boird forbartha a dtacaítear leo in úsáid agat, is féidir leat do fhorbairt a bhrostú trí Phacáiste Tacaíochta Boird a úsáid. Féach Leideanna Breise le haghaidh tuilleadh eolais.
Tóg an tionscadal Tóg an tionscadal trí rith:
idf.py thógáil
Déanfaidh an t-ordú seo an t-iarratas agus na comhpháirteanna ESP-IDF go léir a thiomsú, ansin ginfidh sé an bootloader, an tábla deighilte, agus na dénártha feidhmchláir.
$ idf.py build Ag rith cmake san eolaire /path/to/hello_world/build Ag cur “cmake -G Ninja –warn-uninitialized /path/to/hello_world” i gcrích… Tabhair rabhadh faoi luachanna neamhthosaithe. — Aimsíodh Git: /usr/bin/git (aimsíodh leagan “2.17.0”) — Ag tógáil comhpháirt aws_iot folamh mar gheall ar chumraíocht — Ainmneacha na gcomhpháirteanna: … — Cosáin na gcomhpháirteanna: …
… (níos mó línte aschuir an chórais tógála)
[527/527] Ag giniúint hello_world.bin esptool.py v2.3.1
Tógáil tionscadail críochnaithe. Chun splanc a chur air, rith an t-ordú 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 nó rith 'idf.py -p PORT flash'
Mura bhfuil aon earráidí ann, críochnóidh an tógáil tríd an firmware binary .bin a ghiniúint files.
Splanc ar an nGléas Splanc na comhaid dhénártha a thóg tú díreach (bootloader.bin, partition-table.bin agus hello_world.bin) ar do bhord ESP32 trí rith:
idf.py -p PORT [-b BAUD] flash
Cuir ainm calafoirt sraitheach do bhoird ESP32 in ionad PORT. Is féidir leat an ráta baud splancscáin a athrú freisin tríd an ráta baud atá uait a athsholáthar do BAUD. Is é 460800 an ráta baud réamhshocraithe. Le haghaidh tuilleadh eolais faoi argóintí idf.py, féach idf.py.
Nóta: Tógálann agus splancann an rogha splanc an tionscadal go huathoibríoch, mar sin ní gá idf.py build a rith.

Córais Espressif

40 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh

Oibríocht Gnáth Agus é ag splancadh, feicfidh tú log aschuir cosúil leis an méid seo a 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 sraitheach /dev/ttyUSB0 Ag ceangal…….._ Is é ESP32D0WDQ6 an tslis (leithscéal 0) Gnéithe: WiFi, BT, Croí-Dhá, Scéim Chódaithe Gan aon cheann Is é 40MHz an criostal MAC: 24:0a:c4:05:b9:14 Ag uaslódáil stub… Ag rith stub… Ag athrú ráta baud go 460800 Athraithe. Ag cumrú méid an splanc… Comhbhrúite 3072 beart go 103… Ag scríobh ag 0x00008000… (100 %) Scríobh 3072 beart (103 comhbhrúite) ag 0x00008000 i 0.0 soicind (éifeachtach 5962.8 kbit/s)… Hais sonraí fíoraithe. Comhbhrúite 26096 beart go 15408… Ag scríobh ag 0x00001000… (100 %) Scríobh 26096 beart (15408 comhbhrúite) ag 0x00001000 i 0.4 soicind (éifeachtach 546.7 kbit/s)… Hais sonraí fíoraithe. 147104 beart comhbhrúite go 77364… Ag scríobh ag 0x00010000… (20%) Ag scríobh ag 0x00014000… (40%) Ag scríobh ag 0x00018000… (60%) Ag scríobh ag 0x0001c000… (80%)
(leanann ar an leathanach seo chugainn)

Córais Espressif

41 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh
(ar leanúint ón leathanach roimhe seo) Ag scríobh ag 0x00020000… (100 %) Scríobh 147104 beart (77364 comhbhrúite) ag 0x00010000 i 1.9 soicind (éifeachtach 615.5 kbit/s)… Hais sonraí fíoraithe.
Ag fágáil… Athshocrú crua le bioráin RTS… Arna dhéanamh
Mura bhfuil aon fhadhbanna ann faoi dheireadh an phróisis splanctha, atosóidh an bord agus cuirfidh sé theohello_worldpapplication ar bun. Más mian leat an Eclipse nó VS Code IDE a úsáid in ionad idf.py a rith, féach ar Eclipse Plugin, VSCode Extension.
Déan Monatóireacht ar an Aschur Chun a sheiceáil an bhfuil ohello_worldpis ag rith i ndáiríre, clóscríobh idf.py -p PORT monitor (Ná déan dearmad PORT a athsholáthar le hainm do chalafoirt sraitheach). Seolann an t-ordú seo an feidhmchlár Monatóireachta IDF:
$ idf.py -p Ag rith idf_monitor san eolaire […]/esp/hello_world/build Ag forghníomhú “python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_world/build/hello_world.elf”… — idf_monitor ar siúl 115200 —– Scoir: Ctrl+] | Roghchlár: Ctrl+T | Cabhair: Ctrl+T agus ina dhiaidh sin Ctrl+H –ets 8 Meitheamh 2016 00:22:57
chéad:0x1 (POWERON_RESET),tosaithe:0x13 (SPI_FAST_FLASH_BOOT) ets 8 Meitheamh 2016 00:22:57 …
Tar éis do na logaí tosaithe agus diagnóiseacha scrollú suas, ba cheart duit oHello world!p a fheiceáil priontáilte ag an bhfeidhmchlár.
… Haigh a dhomhan! Ag atosú i gceann 10 soicind… Is sliseanna esp32 é seo le 2 chroílár(a) LAP, WiFi/BT/BLE, sileacan athbhreithniú 1, splanc seachtrach 2MB Íosmhéid carn saor in aisce: 298968 beart Ag atosú i gceann 9 soicind… Ag atosú i gceann 8 soicind… Ag atosú i gceann 7 soicind…
Chun monatóir IDF a fhágáil, bain úsáid as an aicearra Ctrl+]. Má theipeann ar mhonatóir IDF go gairid i ndiaidh an uaslódála, nó, má fheiceann tú bruscar randamach cosúil leis an méid atá tugtha thíos in ionad na dteachtaireachtaí thuas, is dócha go bhfuil criostal 26 MHz á úsáid ag do bhord. Úsáideann formhór na ndearaí boird forbartha 40 MHz, mar sin úsáideann ESP-IDF an mhinicíocht seo mar luach réamhshocraithe.

Má bhíonn fadhb den sórt sin agat, déan an méid seo a leanas:
1. Scoir an monatóir. 2. Téigh ar ais go dtí an roghchlár/cumraíocht. 3. Téigh go Cumraíocht Chomhpháirte > Socruithe Crua-earraí > Príomhchumraíocht XTAL > Príomh-XTAL
minicíocht, ansin athraigh CONFIG_XTAL_FREQ_SEL go 26 MHz. 4. Ina dhiaidh sin, tóg agus splancaigh an feidhmchlár arís.

Córais Espressif

42 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh
Sa leagan reatha de ESP-IDF, is iad seo a leanas na príomh-mhinicíochtaí XTAL a dtacaítear leo le ESP32:
· 26 MHz · 40 MHz
Nóta: Is féidir leat tógáil, splancadh agus monatóireacht a chomhcheangal in aon chéim amháin tríd an méid seo a leanas a rith: idf.py -p PORT flash monitor
Féach freisin: · Monatóir IDF le haghaidh aicearraí úsáideacha agus tuilleadh sonraí faoi úsáid a bhaint as monatóireacht IDF. · idf.py le haghaidh tagairt iomlán d’orduithe agus roghanna idf.py.
Sin a bhfuil uait chun tús a chur le ESP32! Anois tá tú réidh le triail a bhaint as seans eile.amples, nó téigh díreach chuig forbairt do chuid feidhmchlár féin.
Tábhachtach: Tá cuid de na sean-ampNí thacaíonn na comhaid le ESP32 mar nach bhfuil an crua-earraí riachtanach san áireamh in ESP32 agus mar sin ní féidir tacú leis. Má tá tú ag tógáil sean-earraíample, seiceáil an README le do thoil file don tábla Spriocanna Tacaithe. Má tá sé seo i láthair lena n-áirítear sprioc ESP32, nó mura bhfuil an tábla ann ar chor ar bith, an t-iarampOibreoidh sé ar ESP32.
Leideanna Breise
Fadhbanna ceadanna /dev/ttyUSB0 Le roinnt dáiltí Linux, féadfaidh tú an teachtaireacht earráide Theip ar an gcalafort /dev/ttyUSB0 a oscailt a fháil agus an ESP32 á splancadh. Is féidir é seo a réiteach tríd an úsáideoir reatha a chur leis an ngrúpa dial-out.
Comhoiriúnacht Python Tacaíonn ESP-IDF le Python 3.7 nó níos nuaí. Moltar do chóras oibriúcháin a uasghrádú go leagan is déanaí a chomhlíonann an riachtanas seo. I measc roghanna eile tá suiteáil Python ó fhoinsí nó úsáid córas bainistíochta leaganacha Python ar nós pyenv.
Tosaigh le Pacáiste Tacaíochta Boird Chun fréamhshamáirí a bhrostú ar roinnt boird forbartha, is féidir leat Pacáistí Tacaíochta Boird (BSPanna) a úsáid, rud a fhágann go bhfuil túsú boird ar leith chomh héasca le cúpla glao feidhme. De ghnáth, tacaíonn BSP leis na comhpháirteanna crua-earraí go léir a sholáthraítear ar an mbord forbartha. Seachas na feidhmeanna sainmhínithe bioráin agus túsaithe, tagann tiománaithe le BSP do na comhpháirteanna seachtracha amhail braiteoirí, taispeántais, códaic fuaime srl. Dáiltear na BSPanna trí Bhainisteoir Comhpháirteanna IDF, mar sin is féidir iad a fháil i gClárlann Comhpháirteanna IDF. Seo iar-chódóir.ampléargas ar conas ESP-WROVER-KIT BSP a chur le do thionscadal: idf.py add-dependency esp_wrover_kit
Níos mó exampIs féidir sonraí faoi úsáid BSP a fháil i bhfoirm BSPamples fillteán.
Leid: Nuashonrú ESP-IDF Moltar ESP-IDF a nuashonrú ó am go ham, de réir mar a shocraíonn leaganacha níos nuaí fabhtanna agus/nó a chuireann gnéithe nua ar fáil. Tabhair faoi deara go bhfuil tréimhse tacaíochta gaolmhar ag baint le gach leagan mór agus mion-eisiúna de ESP-IDF, agus nuair a bhíonn brainse eisiúna amháin ag druidim le deireadh a shaoil (EOL), moltar do gach úsáideoir a dtionscadail a uasghrádú go heisiúintí ESP-IDF níos déanaí, chun tuilleadh eolais a fháil faoi thréimhsí tacaíochta, féach Leaganacha ESP-IDF.

Córais Espressif

43 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 1. Tosaigh
Is é an bealach is simplí chun an nuashonrú a dhéanamh ná an fillteán esp-idf atá ann cheana a scriosadh agus é a chlónáil arís, amhail is dá mba rud é go raibh an suiteáil tosaigh a thuairiscítear i gCéim 2 á déanamh agat. Faigh ESP-IDF. Réiteach eile is ea gan ach a bhfuil athraithe a nuashonrú. Braitheann an nós imeachta nuashonraithe ar an leagan de ESP-IDF atá in úsáid agat. Tar éis ESP-IDF a nuashonrú, cuir an script Suiteála i gcrích arís, i gcás go n-éilíonn an leagan nua de ESP-IDF leaganacha difriúla d'uirlisí. Féach na treoracha ag Céim 3. Socraigh na huirlisí. Nuair a bheidh na huirlisí nua suiteáilte, nuashonraigh an timpeallacht ag baint úsáide as an script Easpórtála. Féach na treoracha ag Céim 4. Socraigh na hathróga comhshaoil.
Doiciméid Ghaolmhara · Nasc Sraitheach a Bhunú le ESP32 · Breiseán Eclipse · Síneadh VSCode · Monatóir IDF
1.4 Tóg Do Chéad Tionscadal
Más rud é go bhfuil ESP-IDF suiteáilte agat cheana féin agus mura bhfuil IDE in úsáid agat, is féidir leat do chéad tionscadal a thógáil ón líne ordaithe tar éis "Tosaigh Tionscadal ar Windows" nó "Tosaigh Tionscadal ar Linux agus macOS".
1.5 Díshuiteáil ESP-IDF
Más mian leat ESP-IDF a bhaint, lean Díshuiteáil ESP-IDF le do thoil.

Córais Espressif

44 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 2
Tagairt API
2.1 Coinbhinsiúin API
Déanann an doiciméad seo cur síos ar choinbhinsiúin agus ar thoimhdí atá coitianta i gComhéadain Chlársceidealaithe Feidhmchláir (APIanna) ESP-IDF. Soláthraíonn ESP-IDF roinnt cineálacha comhéadain chlársceidealaithe:
· Feidhmeanna C, struchtúir, enums, sainmhínithe cineáil agus macraí réamhphróiseálaí dearbhaithe sa cheanntásc poiblí filede chomhpháirteanna ESPIDF. Tá cur síos ar na feidhmeanna, na struchtúir agus na cineálacha seo ar leathanaigh éagsúla sa chuid Tagairt API den treoir ríomhchlárúcháin.
· Feidhmeanna córais tógála, athróga réamhshainithe agus roghanna. Tá siad seo doiciméadaithe sa treoir chórais tógála. · Is féidir roghanna Kconfig a úsáid sa chód agus sa chóras tógála (CMakeLists.txt) files. · Tá uirlisí óstach agus a bparaiméadair líne ordaithe mar chuid den chomhéadan ESP-IDF freisin. Is éard atá in ESP-IDF comhpháirteanna atá scríofa go sonrach do ESP-IDF chomh maith le leabharlanna tríú páirtí. I gcásanna áirithe, cuirtear fillteán ESP-IDF-shonrach leis an leabharlann tríú páirtí, rud a sholáthraíonn comhéadan atá níos simplí nó níos fearr comhtháite leis an gcuid eile d'áiseanna ESP-IDF. I gcásanna eile, cuirtear API bunaidh na leabharlainne tríú páirtí i láthair do na forbróirí feidhmchlár. Mínítear sna hailt seo a leanas cuid de ghnéithe APIanna ESP-IDF agus a n-úsáid.
2.1.1 Earráid a láimhseáil
Tugann formhór APIanna ESP-IDF cóid earráide ar ais atá sainmhínithe leis an gcineál esp_err_t. Féach an rannán Láimhseáil Earráide le haghaidh tuilleadh eolais faoi chur chuige láimhseála earráide. Tá liosta de na cóid earráide a thugann comhpháirteanna ESP-IDF ar ais sa Tagairt Cód Earráide.
2.1.2 Struchtúir chumraíochta
Tábhachtach: Tá túsú ceart struchtúr cumraíochta ina chuid thábhachtach chun an feidhmchlár a dhéanamh comhoiriúnach le leaganacha amach anseo de ESP-IDF.
Glacann formhór na bhfeidhmeanna tosaithe nó cumraíochta in ESP-IDF pointeoir chuig struchtúr cumraíochta mar argóint. Mar shamplaample:
45

Caibidil 2. Tagairt 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_amadóir; esp_err_t err = esp_timer_create(&mo_amadóir_args, &mo_amadóir);
Ní stórálann feidhmeanna tosaithe an pointeoir chuig an struchtúr cumraíochta riamh, mar sin tá sé sábháilte an struchtúr a leithdháileadh ar an stack.
Caithfidh an feidhmchlár gach réimse den struchtúr a thosú. Tá an méid seo a leanas mícheart:
esp_timer_create_args_t my_timer_args; my_timer_args.callback = &my_timer_callback; /* Mícheart! Níl na réimsí .arg agus .name tosaithe */ esp_timer_create(&my_timer_args, &my_timer);
An chuid is mó d'iar-ESP-IDFampÚsáideann les tosaitheoirí ainmnithe C99 le haghaidh tosaithe struchtúir, ós rud é go soláthraíonn siad bealach gonta chun fo-thacar réimsí a shocrú, agus na réimsí atá fágtha a thosú go nialas:
const esp_timer_create_args_t my_timer_args = { .callback = &my_timer_callback, /* Ceart, tá na réimsí .arg agus .name réamhthionscanta go nialas */
};
Ní thacaíonn an teanga C++ leis an comhréir tosaitheoirí ainmnithe go dtí C++20, ach tacaíonn tiomsaitheoir GCC go páirteach leis mar shíneadh. Agus APIanna ESP-IDF á n-úsáid i gcód C++, b'fhéidir go mbeadh sé ciallmhar an patrún seo a leanas a úsáid:
esp_timer_create_args_t my_timer_args = {}; /* Tá na réimsí uile réamh-thosaithe ag nialas */ my_timer_args.callback = &my_timer_callback;

Tosaitheoirí réamhshocraithe
I gcás roinnt struchtúr cumraíochta, soláthraíonn ESP-IDF macraí chun luachanna réamhshocraithe réimsí a shocrú:
httpd_config_t cumraíocht = HTTPD_DEFAULT_CONFIG(); /* Leathnaíonn HTTPD_DEFAULT_CONFIG go dtí tosaitheoir ainmnithe.
Tá na luachanna réamhshocraithe socraithe anois do na réimsí uile. Is féidir aon réimse a mhodhnú fós: */ config.server_port = 8081; httpd_handle_t server; esp_err_t err = httpd_start(&server, &config);
Moltar macraí tosaitheora réamhshocraithe a úsáid aon uair a sholáthraítear iad do struchtúr cumraíochta ar leith.

2.1.3 APIanna Príobháideacha
Ceanntásc áirithe fileTá APIanna sna s in ESP-IDF atá beartaithe lena n-úsáid i gcód foinse ESP-IDF amháin, agus ní ag na feidhmchláir. Ceanntásc den sórt sin fileIs minic a bhíonn `private` nó `esp_private` ina n-ainm nó ina gcosán. Ní bhíonn ach APIanna príobháideacha i gcomhpháirteanna áirithe, amhail hal. Féadfar APIanna príobháideacha a bhaint nó a athrú ar bhealach neamh-chomhoiriúnach idir eisiúintí beaga nó paiste.

2.1.4 Comhpháirteanna i sean-ample tionscadail
iar-ESP-IDFampTá réimse tionscadal sna comhaid a léiríonn úsáid APIanna ESP-IDF. Chun dúbláil chód a laghdú sa tslí a dtéann sé i bhfeidhm.amples, sainmhínítear cúpla cúntóir coitianta taobh istigh de chomhpháirteanna a úsáideann il-eispéirisamples.

Córais Espressif

46 Aiseolas ar an Doiciméad a Chur Isteach

Eisiúint v5.0.9

Caibidil 2. Tagairt API
Áirítear leis seo comhpháirteanna atá suite

Doiciméid / Acmhainní

Bord Forbartha ESP32 Dev Kitc Córais Espressif [pdfTreoir Úsáideora
Bord Forbartha ESP32 Dev Kitc, ESP32, Bord Forbartha Dev Kitc, Bord Forbartha Kitc, Bord Forbartha, Bord

Tagairtí

Lámhleabhar Úsáideora

Bord Forbartha ESP32 Dev Kitc

Eolas Táirge

Sonraíochtaí

Treoracha Úsáide Táirge

1. Tosaigh

1.1 Réamhrá

1.2 Na rudaí a bheidh uait

1.3 Suiteáil

1.4 Tóg Do Chéad Tionscadal

1.5 Díshuiteáil ESP-IDF

2. Tagairt API

Ceisteanna Coitianta (FAQ)

C: Conas is féidir liom fadhbanna coitianta le ESP32 a réiteach?

C: An féidir liom ESP-IDF a úsáid le micrea-rialaitheoirí eile?

Doiciméid / Acmhainní

Tagairtí

Fág trácht

Cealaigh freagra