ESPRESSIF ESP32-C3-MINI-1 Wi-Fi un Bluetooth lietiskā interneta moduļa lietotāja rokasgrāmata
Par šo dokumentu
Šī lietotāja rokasgrāmata parāda, kā sākt darbu ar ESP32-C3-MINI-1 moduli.
Dokumentu atjauninājumi
Lūdzu, vienmēr skatiet jaunāko versiju https://www.espressif.com/en/support/download/documents.
Pārskatīšanas vēsture
Lai iegūtu informāciju par šī dokumenta pārskatīšanas vēsturi, lūdzu, skatiet pēdējo lapu.
Paziņojums par dokumentācijas izmaiņām
Espressif nodrošina e-pasta paziņojumus, lai jūs informētu par izmaiņām tehniskajā dokumentācijā. Lūdzu abonēt plkst www.espressif.com/en/subscribe.
Sertifikācija
Lejupielādējiet Espressif produktu sertifikātus no www.espressif.com/en/certificates
Beigāsview
- Modulis beidziesview
ESP32-C3-MINI-1 ir universāls Wi-Fi un Bluetooth LE modulis. Bagātīgais perifērijas ierīču komplekts un mazais izmērs padara šo moduli par ideālu izvēli viedām mājām, rūpnieciskajai automatizācijai, veselības aprūpei, plaša patēriņa elektronikai utt.
1. tabula: ESP32C3MINI1 specifikācijas
Kategorijas Parametri Specifikācijas Wi-Fi Protokoli 802.11 b/g/n (līdz 150 Mb/s) Frekvenču diapazons 2412 ~ 2462 MHz Bluetooth® Protokoli Bluetooth® LE: Bluetooth 5 un Bluetooth tīkls Radio Klases-1, klases-2 un klases-3 raidītājs Aparatūra
Moduļu saskarnes GPIO, SPI, UART, I2C, I2S, tālvadības pults perifērijas ierīce, LED PWM kontrolieris, vispārējais DMA kontrolieris, TWAI® kontrolieris (saderīgs ar ISO 11898-1), temperatūras sensors, SAR ADC Integrēts kristāls 40 MHz kristāls Darbības apjomstage/barošanas avots 3.0 V ~ 3.6 V Darba strāva Vidējais: 80 mA Minimālā strāva, ko nodrošina jauda piegāde
500 mA Apkārtējās vides temperatūra –40 °C ~ +105 °C Mitruma jutības līmenis (MSL) 3. līmenis - Pin Apraksts
1. attēls. Tapas izkārtojums (augšā View)
Modulim ir 53 tapas. Sk. spraudīšu definīcijas 2. tabulā.
Perifērijas tapas konfigurācijas skatiet ESP32-C3 ģimenes datu lapā.
2. tabula. Pin definīcijas
Vārds Nē. Tips Funkcija GND 1, 2, 11, 14, 36-53 P Zemējums 3V3 3 P Barošanas avots NC 4 — NC IO2 5 I/O/T GPIO2, ADC1_CH2, FSPIQ IO3 6 I/O/T GPIO3, ADC1_CH3 NC 7 — NC EN
8
I
Augsts: ieslēgts, iespējo mikroshēmu. Zems: izslēgts, mikroshēma tiek izslēgta. Piezīme. Neatstājiet EN tapu peldošu.
NC 9 — NC NC 10 — NC IO0 12 I/O/T GPIO0, ADC1_CH0, XTAL_32K_P IO1 13 I/O/T GPIO1, ADC1_CH1, XTAL_32K_N NC 15 — NC IO10 16 I/O/T GPIO10, FSPICS0 NC 17 — NC IO4 18 I/O/T GPIO4, ADC1_CH4, FSPIHD, MTMS IO5 19 I/O/T GPIO5, ADC2_CH0, FSPIWP, MTDI IO6 20 I/O/T GPIO6, FSPICLK, MTCK IO7 21 I/O/T GPIO7, FSPID, MTDO IO8 22 I/O/T GPIO8 IO9 23 I/O/T GPIO9 NC 24 — NC NC 25 — NC IO18 26 I/O/T GPIO18 IO19 27 I/O/T GPIO19 NC 28 — NC NC 29 — NC RXD0 30 I/O/T GPIO20, U0RXD, TXD0 31 I/O/T GPIO21, U0TXD NC 32 — NC NC 33 — NC NC 34 — NC NC 35 — NC
Sāciet darbu ar ESP32C3MINI1
Kas jums nepieciešams
Lai izstrādātu lietojumprogrammas ESP32-C3-MINI-1 modulim, jums ir nepieciešams:
- 1 x ESP32-C3-MINI-1 modulis
- 1 x Espressif RF testēšanas dēlis
- 1 x USB uz seriālo plati
- 1 x mikro-USB kabelis
- 1 x dators, kurā darbojas Linux
Šajā lietotāja rokasgrāmatā mēs uzskatām Linux operētājsistēmu kā piemēruample. Lai iegūtu papildinformāciju par konfigurāciju operētājsistēmās Windows un macOS, lūdzu, skatiet ESP-IDF programmēšanas rokasgrāmatu.
Aparatūras savienojums
- Pielodējiet ESP32-C3-MINI-1 moduli pie RF pārbaudes plates, kā parādīts 2. attēlā.
- Savienojiet RF pārbaudes plati ar USB-seriālo plati, izmantojot TXD, RXD un GND.
- Pievienojiet USB-serial plati datoram.
- Savienojiet RF pārbaudes plati ar datoru vai strāvas adapteri, lai iespējotu 5 V barošanu, izmantojot mikro-USB kabeli.
- Lejupielādes laikā savienojiet IO0 ar GND, izmantojot džemperi. Pēc tam ieslēdziet pārbaudes paneli.
- Lejupielādējiet programmaparatūru zibatmiņā. Sīkāku informāciju skatiet tālāk esošajās sadaļās.
- Pēc lejupielādes noņemiet IO0 un GND džemperi.
- Atkal ieslēdziet RF pārbaudes paneli. ESP32-C3-MINI-1 pārslēgsies uz darba režīmu. Pēc inicializācijas mikroshēma nolasīs programmas no zibatmiņas.
Piezīme
IO0 ir iekšēji augsts loģikas līmenis. Ja IO0 ir iestatīts uz augšu, tiek atlasīts sāknēšanas režīms. Ja šī tapa ir nolaižama vai atstāta peldoša,
Ir atlasīts lejupielādes režīms. Lai iegūtu papildinformāciju par ESP32-C3 MINI-1, lūdzu, skatiet ESP32-C3-MINI-1 datu lapu.
Iestatiet attīstības vidi
Espressif IoT izstrādes ietvars (īsumā ESP-IDF) ir ietvars lietojumprogrammu izstrādei, pamatojoties uz Espressif mikroshēmām. Lietotāji var izstrādāt lietojumprogrammas ar ESP mikroshēmām operētājsistēmā Windows/Linux/macOS, pamatojoties uz ESP-IDF. Šeit mēs uzskatām Linux operētājsistēmu kā bijušoample.
- Instalējiet priekšnosacījumus
Lai kompilētu ar ESP-IDF, jums jāiegūst šādas pakotnes:- CentOS 7:
1 sudo yum instalēt git wget flex bison gperf python cmake ninja-build ccache dfuutil - Ubuntu un Debian (viena komanda sadalās divās rindās):
- sudo apt-get instalēt git wget flex bison gperf python python-pip pythonsetuptools cmake
- ninja-build ccache libffi-dev libssl-dev dfu-util
- Arka:
- 1 sudo pacman -S —needed gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
Piezīme - Šajā rokasgrāmatā direktorijs ~/esp operētājsistēmā Linux tiek izmantots kā ESP-IDF instalācijas mape.
- Ņemiet vērā, ka ESP-IDF neatbalsta atstarpes ceļos.
- 1 sudo pacman -S —needed gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
- CentOS 7:
- Iegūstiet ESPIDF
Lai izveidotu lietojumprogrammas ESP32-C3-MINI-1 modulim, jums ir nepieciešamas programmatūras bibliotēkas, ko nodrošina Espressif ESP-IDF repozitorijā.
Lai iegūtu ESP-IDF, izveidojiet instalācijas direktoriju (~/esp), lai lejupielādētu ESP-IDF un klonētu repozitoriju ar “git clone”:- mkdir -p ~/esp
- cd ~/esp
- git clone – rekursīvs https://github.com/espressif/esp-idf.git
ESP-IDF tiks lejupielādēts mapē ~/esp/esp-idf. Informāciju par to, kuru ESP-IDF versiju izmantot konkrētā situācijā, skatiet sadaļā ESP-IDF versijas.
- Iestatiet rīkus
Papildus ESP-IDF jums ir jāinstalē arī ESP-IDF izmantotie rīki, piemēram, kompilators, atkļūdotājs, Python pakotnes utt. ESP-IDF nodrošina skriptu ar nosaukumu "install.sh", lai palīdzētu iestatīt rīkus. vienā piegājienā.- cd ~/esp/esp-idf
- /install.sh
- Iestatiet vides mainīgos
Instalētie rīki vēl nav pievienoti PATH vides mainīgajam. Lai rīkus varētu izmantot no komandrindas, ir jāiestata daži vides mainīgie. ESP-IDF nodrošina citu skriptu “export.sh”, kas to dara. Terminālī, kurā izmantosit ESP-IDF, palaidiet:- $HOME/esp/esp-idf/export.sh
Tagad viss ir gatavs, jūs varat izveidot savu pirmo projektu uz ESP32-C3 MINI-1 moduļa.
- $HOME/esp/esp-idf/export.sh
Izveidojiet savu pirmo projektu
- Sāciet projektu
Tagad esat gatavs sagatavot pieteikumu ESP32-C3-MINI-1 modulim. Varat sākt ar projektu get-started/hello_world no examples direktorijā ESP-IDF.
Kopēt get-started/hello_world uz ~/esp direktoriju:- cd ~/esp
- cp -r $IDF_PATH/piemamples/get-started/hello_world .
Ir virkne example projekti bijušajāamples direktorijā ESP-IDF. Jūs varat kopēt jebkuru projektu tādā pašā veidā, kā parādīts iepriekš, un palaist to. Ir iespējams arī būvēt examples vietā, vispirms tos nekopējot.
Ir virkne example projekti bijušajāamples direktorijā ESP IDF. Jūs varat kopēt jebkuru projektu tādā pašā veidā, kā parādīts iepriekš, un palaist to. Ir iespējams arī būvēt examples vietā, vispirms tos nekopējot.
- Pievienojiet ierīci
Tagad pievienojiet ESP32-C3-MINI-1 moduli datoram un pārbaudiet, zem kura seriālā porta modulis ir redzams. Linux seriālo portu nosaukumos sākas ar “/dev/tty”. Divas reizes izpildiet tālāk norādīto komandu, vispirms ar
dēlis ir atvienots no kontaktligzdas, pēc tam ar pievienots. Ports, kas parādās otro reizi, ir tas, kas jums nepieciešams:- ls /dev/tty*
Piezīme
Saglabājiet porta nosaukumu, jo tas būs nepieciešams nākamajās darbībās.
- ls /dev/tty*
- Konfigurēt
No 2.4.1. darbības pārejiet uz direktoriju hello_world. Sāciet projektu, iestatiet ESP32-C3 kā mērķi un palaidiet projekta konfigurācijas utilītu "menuconfig".- cd ~/esp/hello_world
- idf.py set-target esp32c3
- idf.py menuconfig
Mērķa iestatīšana ar “idf.py set-target esp32c3” ir jāveic vienreiz pēc jauna projekta atvēršanas. Ja projektā ir ietverti daži esošie būvējumi un konfigurācija, tie tiks notīrīti un inicializēti. Mērķi var saglabāt vides mainīgajā, lai šo darbību vispār izlaistu. Papildinformāciju skatiet sadaļā Mērķa atlase.
Ja iepriekšējās darbības ir veiktas pareizi, tiek parādīta šāda izvēlne:
3. attēls. Projekta konfigurācijas sākuma logs
Izvēlnes krāsas jūsu terminālī var atšķirties. Jūs varat mainīt izskatu, izmantojot opciju “–style”. Lai iegūtu papildu informāciju, lūdzu, palaidiet 'idf.py menuconfig –help'
- Izveidojiet projektu
Veidojiet projektu, palaižot:- idf.py b
Šī komanda apkopos lietojumprogrammu un visus ESP-IDF komponentus, pēc tam ģenerēs sāknēšanas ielādētāju, nodalījuma tabulu un lietojumprogrammu bināros failus.- $ idf.py build
- Palaiž cmake direktorijā /path/to/hello_world/build
- Notiek “cmake -G Ninja –warn-unitialized /path/to/hello_world” izpilde…
- Brīdiniet par neinicializētām vērtībām.
- — Atrasts Git: /usr/bin/git (atrasta versija “2.17.0”)
- — Izveidojiet tukšu aws_iot komponentu konfigurācijas dēļ
- — Komponentu nosaukumi: …
- — Komponentu ceļi: …
- … (vairāk sistēmas izveides rindu
- [527/527] Tiek ģenerēts hello-world.bin
- esptool.py v2.3.1
- Projekta izveide pabeigta. Lai mirgotu, palaidiet šo komandu:
- ../../../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
- vai palaidiet "idf.py -p PORT flash"
Ja kļūdu nav, būvēšana tiks pabeigta, ģenerējot programmaparatūras bināro failu .bin file.
- idf.py b
- Zibspuldze uz ierīces
Atjauniniet bināros failus, ko tikko izveidojāt savā ESP32-C3-MINI-1 modulī, palaižot:- idf.py -p PORTS [-b BAUD] zibspuldze
Aizstājiet PORT ar sava moduļa seriālā porta nosaukumu sadaļā Darbība: pievienojiet ierīci.
Varat arī mainīt zibspuldzes pārraides ātrumu, aizstājot BAUD ar nepieciešamo datu pārraides ātrumu. Noklusējuma datu pārraides ātrums ir 460800.
Papildinformāciju par idf.py argumentiem skatiet idf.py.
- idf.py -p PORTS [-b BAUD] zibspuldze
Piezīme
Opcija "flash" automātiski veido un mirgo projektu, tāpēc "idf.py build" palaišana nav nepieciešama.
- …
- esptool.py –chip esp32c3 -p /dev/ttyUSB0 -b 460800 –before=default_reset –after =hard_reset write_flash –flash_mode dio –flash_freq 80m –flash_size 2MB 0x 8000 partition0otboload0 boot0x 10000x XNUMX partitionXNUMX-table_load. -world.bin
- esptool.py v3.0
- Seriālais ports /dev/ttyUSB0
- Notiek savienojuma izveide…
- Mikroshēma ir ESP32-C3
- Funkcijas: Wi-Fi
- Kristāls ir 40 MHz
- MAC: 7c:df:a1:40:02:a4
- Notiek faila augšupielāde…
- Darbojas...
- Skriešanas pārtraukums…
- Bodu ātruma maiņa uz 460800
- Mainīts.
- Notiek zibspuldzes izmēra konfigurēšana…
- Saspiests 3072 baiti līdz 103…
- Rakstīšana ar 0x00008000… (100 %)
- 3072 sekundēs ierakstīja 103 baitus (0 saspiesti) ar ātrumu 00008000 x 0.0 (efektīvs 4238.1 kbit/s)…
- Pārbaudīts datu sajaukums.
- Saspiests 18960 baiti līdz 11311…
- Rakstīšana ar 0x00000000… (100 %)
- 18960 sekundēs ierakstīja 11311 0 baitus (00000000 0.3 saspiests) ar ātrumu 584.9 x XNUMX (efektīvs XNUMX kbit/s)…
- Pārbaudīts datu sajaukums.
- Saspiests 145520 baiti līdz 71984…
- Rakstīšana ar 0x00010000… (20 %)
- Rakstīšana ar 0x00014000… (40 %)
- Rakstīšana ar 0x00018000… (60 %)
- Rakstīšana ar 0x0001c000… (80 %)
- Rakstīšana ar 0x00020000… (100 %)
- Uzrakstīja 145520 71984 baitus (0 00010000 saspiesti) ar ātrumu 2.3x504.4 XNUMX sekundēs (efektīvi XNUMX kbit/s)…
- Pārbaudīts datu sajaukums.
- Aiziet…
- Cietā atiestatīšana, izmantojot RTS tapu…
- Gatavs
Ja viss norit labi, pēc IO0 un GND džempera noņemšanas un testēšanas paneļa atkārtotas ieslēgšanas sāk darboties lietojumprogramma hello_world.
Monitors
Lai pārbaudītu, vai “hello_world” patiešām darbojas, ierakstiet “idf.py -p PORT monitor” (neaizmirstiet aizstāt PORT ar seriālā porta nosaukumu).
Šī komanda palaiž lietojumprogrammu IDF Monitor:
- $ idf.py -p /dev/ttyUSB0 monitors
- Palaiž idf_monitor direktorijā […]/esp/hello_world/build
- Notiek “python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_world/build /hello-world.elf” izpilde…
- — idf_monitor uz /dev/ttyUSB0 115200 —
- — Iziet: Ctrl+] | Izvēlne: Ctrl+T | Palīdzība: Ctrl+T, kam seko Ctrl+H —
- ets 8. jūnijs 2016 00:22:57
- pirmais:0x1 (POWERON_RESET),sāknēšana:0x13 (SPI_FAST_FLASH_BOOT)
- ets 8. jūnijs 2016 00:22:57
- …
Pēc startēšanas un diagnostikas žurnālu ritināšanas uz augšu, jums vajadzētu redzēt “Sveika pasaule!” izdrukā aplikācija.
- …
- Sveika pasaule!
- Restartēšana pēc 10 sekundēm…
- Šī ir esp32c3 mikroshēma ar 1 CPU kodolu, WiFi/BLE, 4MB ārējo zibspuldzi
- Restartēšana pēc 9 sekundēm…
- Restartēšana pēc 8 sekundēm…
- Restartēšana pēc 7 sekundēm…
Lai izietu no IDF monitora, izmantojiet saīsni Ctrl+].
Tas ir viss, kas jums nepieciešams, lai sāktu darbu ar ESP32-C3-MINI-1 moduli! Tagad esat gatavs izmēģināt kādu citu bijušoampESP-IDF vai dodieties tieši uz savu lietojumprogrammu izstrādi.
Mācību resursi
- Jālasa dokumenti
Lūdzu, iepazīstieties ar šādiem dokumentiem: - ESP32-C3 ģimenes datu lapa
Šis ir ievads ESP32-C3 aparatūras specifikācijās, tostarp vairākāsview, piespraudes definīcijas,
funkcionālais apraksts, perifērijas saskarne, elektriskās īpašības utt. - ESP-IDF programmēšanas rokasgrāmata
Plaša ESP-IDF izstrādes ietvara dokumentācija, sākot no aparatūras ceļvežiem līdz API
atsauce - ESP32-C3 tehniskā uzziņu rokasgrāmata
Detalizēta informācija par ESP32-C3 atmiņas un perifērijas ierīču lietošanu. - Espressif produktu pasūtīšanas informācija
Svarīgi resursi
Šeit ir sniegti svarīgi ar ESP32-C3 saistītie resursi.
- ESP32 BBS
Inženieru līdz inženieru (E2E) kopiena Espressif produktiem, kurā varat izlikt jautājumus, dalīties zināšanās, izpētīt idejas un palīdzēt atrisināt problēmas ar citiem inženieriem.
Pārskatīšanas vēsture
Datums |
Versija | Izlaiduma piezīmes |
2021-02-01 | V0.1 |
Iepriekšēja izlaidums |
Atruna un autortiesību paziņojums
Informācija šajā dokumentā, tai skaitā URL atsauces, var tikt mainītas bez brīdinājuma.
VISA ŠAJĀ DOKUMENTĀ IESPĒJAMĀ TREŠĀS PERSONAS INFORMĀCIJA TIEK SNIEGTA TĀDA, KĀ IR TĀ IR, BEZ GARANTIJĀM PAR TĀS AUTENTISKUMU UN PRECIZITĀTI. ŠAM DOKUMENTAM NETIEK NOTEIKTAS GARANTIJAS PAR TĀ TIRDZNIECĪBU, NEPĀRKĀPUMĀM, PIEMĒROTĪBU JEBKĀDĀM KONKRĒTAM MĒRĶIEM, UN NEKAS CITĀDI IZRIETOTS NO PRIEKŠLIKUMA, SPECIFIKĀCIJAS VAI S.AMPLE.
Tiek noraidīta visa atbildība, tostarp atbildība par jebkādu īpašumtiesību pārkāpumiem, kas attiecas uz šajā dokumentā esošās informācijas izmantošanu. Šeit netiek piešķirtas nekādas tiešas vai netiešas licences uz intelektuālā īpašuma tiesībām.
Wi-Fi Alliance Member logotips ir Wi-Fi Alliance preču zīme. Bluetooth logotips ir Bluetooth SIG reģistrēta preču zīme.
Visi šajā dokumentā minētie tirdzniecības nosaukumi, preču zīmes un reģistrētās preču zīmes ir to attiecīgo īpašnieku īpašums, un ar šo tiek atzīts.
Autortiesības © 2021 Espressif Systems (Shanghai) Co., Ltd. Visas tiesības paturētas.
Dokumenti / Resursi
![]() |
ESPRESSIF ESP32-C3-MINI-1 Wi-Fi un Bluetooth lietiskā interneta modulis [pdfLietotāja rokasgrāmata ESPC3MINI1, 2AC7Z-ESPC3MINI1, 2AC7ZESPC3MINI1, ESP32 -C3 -MINI- 1 Wi-Fi un Bluetooth lietiskā interneta modulis, Wi-Fi un Bluetooth lietiskā interneta modulis, lietiskā interneta modulis |