Používateľská príručka modulu internetu vecí ESPRESSIF ESP32-C3-MINI-1 Wi-Fi a Bluetooth
O tomto dokumente
Táto používateľská príručka ukazuje, ako začať s modulom ESP32-C3-MINI-1.
Aktualizácie dokumentov
Vždy si pozrite najnovšiu verziu na https://www.espressif.com/en/support/download/documents.
História revízií
Históriu revízií tohto dokumentu nájdete na poslednej strane.
Oznámenie o zmene dokumentácie
Espressif poskytuje e-mailové upozornenia, aby ste boli informovaní o zmenách v technickej dokumentácii. Prosím prihláste sa na www.espressif.com/en/subscribe.
Certifikácia
Stiahnite si certifikáty pre produkty Espressif z www.espressif.com/en/certificates
Koniecview
- Koniec moduluview
ESP32-C3-MINI-1 je modul Wi-Fi a Bluetooth LE na všeobecné použitie. Bohatá sada periférií a malé rozmery robia z tohto modulu ideálnu voľbu pre inteligentné domácnosti, priemyselnú automatizáciu, zdravotníctvo, spotrebnú elektroniku atď.
Tabuľka 1: Špecifikácie ESP32C3MINI1
kategórie Parametre Špecifikácie Wi-Fi Protokoly 802.11 b/g/n (až 150 Mbps) Frekvenčný rozsah 2412 ~ 2462 MHz Bluetooth® Protokoly Bluetooth® LE: Bluetooth 5 a Bluetooth mesh Rádio Vysielač triedy 1, triedy 2 a triedy 3 Hardvér
Modulové rozhrania GPIO, SPI, UART, I2C, I2S, periférne diaľkové ovládanie, LED PWM ovládač, všeobecný DMA ovládač, TWAI® ovládač (kompatibilný s ISO 11898-1), snímač teploty, SAR ADC Integrovaný kryštál 40 MHz kryštál Prevádzkový objemtage/Napájanie 3.0 V ~ 3.6 V Prevádzkový prúd Priemer: 80 mA Minimálny prúd dodávaný napájaním zásobovanie
500 mA Teplota okolia –40 °C ~ +105 °C Úroveň citlivosti na vlhkosť (MSL) Úroveň 3 - Popis pinu
Obrázok 1: Rozloženie kolíkov (hore View)
Modul má 53 pinov. Pozrite si definície pinov v tabuľke 2.
Informácie o konfiguráciách periférnych kolíkov nájdete v údajovom liste rodiny ESP32-C3.
Tabuľka 2: Definície pinov
Meno Nie Typ Funkcia GND 1, 2, 11, 14, 36-53 P Ground 3V3 3 P Napájanie 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
Vysoká: zapnuté, aktivuje čip. Nízka: vypnuté, čip sa vypne. Poznámka: Nenechávajte kolík EN plávať.
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
Začnite na ESP32C3MINI1
Čo potrebujete
Na vývoj aplikácií pre modul ESP32-C3-MINI-1 potrebujete:
- 1 x modul ESP32-C3-MINI-1
- 1 x testovacia doska Espressif RF
- 1 x doska USB-to-Serial
- 1 x kábel micro-USB
- 1 x PC s operačným systémom Linux
V tejto používateľskej príručke berieme ako príklad operačný systém Linuxample. Ďalšie informácie o konfigurácii v systémoch Windows a macOS nájdete v Sprievodcovi programovaním ESP-IDF.
Hardvérové pripojenie
- Prispájkujte modul ESP32-C3-MINI-1 k RF testovacej doske, ako je znázornené na obrázku 2.
- Pripojte RF testovaciu dosku k USB-to-Serial doske cez TXD, RXD a GND.
- Pripojte dosku USB-to-Serial k počítaču.
- Pripojte RF testovaciu dosku k počítaču alebo napájaciemu adaptéru, aby ste umožnili napájanie 5 V pomocou kábla Micro-USB.
- Počas sťahovania pripojte IO0 ku GND pomocou prepojky. Potom zapnite testovaciu dosku.
- Stiahnite si firmvér do flash. Podrobnosti nájdete v sekciách nižšie.
- Po stiahnutí odstráňte prepojku na IO0 a GND.
- Znova zapnite RF testovaciu dosku. ESP32-C3-MINI-1 sa prepne do pracovného režimu. Čip bude čítať programy z flash po inicializácii.
Poznámka
IO0 je z vnútornej logiky vysoko. Ak je IO0 nastavený na pull-up, zvolí sa Boot mode. Ak je tento kolík sťahovací alebo plávajúci,
Je vybratý režim sťahovania. Viac informácií o ESP32-C3 MINI-1 nájdete v údajovom liste ESP32-C3-MINI-1.
Nastavte vývojové prostredie
Espressif IoT Development Framework (skrátene ESP-IDF) je rámec pre vývoj aplikácií založených na čipoch Espressif. Používatelia môžu vyvíjať aplikácie s čipmi ESP vo Windows/Linux/macOS na základe ESP-IDF. Tu berieme operačný systém Linux ako example.
- Nainštalujte predpoklady
Na kompiláciu s ESP-IDF potrebujete získať nasledujúce balíčky:- CentOS 7:
1 sudo yum nainštalovať git wget flex bison gperf python cmake ninja-build ccache dfuutil - Ubuntu a Debian (jeden príkaz sa delí na dva riadky):
- sudo apt-get install git wget flex bison gperf python python-pip pythonsetuptools cmake
- ninja-build ccache libffi-dev libssl-dev dfu-util
- Oblúk:
- 1 sudo pacman -S – potrebný gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
Poznámka - Táto príručka používa adresár ~/esp v systéme Linux ako inštalačný priečinok pre ESP-IDF.
- Majte na pamäti, že ESP-IDF nepodporuje medzery v cestách.
- 1 sudo pacman -S – potrebný gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
- CentOS 7:
- Získajte ESPIDF
Na vytváranie aplikácií pre modul ESP32-C3-MINI-1 potrebujete softvérové knižnice, ktoré poskytuje Espressif v repozitári ESP-IDF.
Ak chcete získať ESP-IDF, vytvorte inštalačný adresár (~/esp), do ktorého stiahnete ESP-IDF a naklonujete úložisko pomocou „git clone“:- mkdir -p ~/esp
- cd ~/esp
- git klon – rekurzívny https://github.com/espressif/esp-idf.git
ESP-IDF sa stiahne do ~/esp/esp-idf. Informácie o verzii ESP-IDF, ktorá sa má použiť v danej situácii, nájdete vo verziách ESP-IDF.
- Nastaviť Nástroje
Okrem ESP-IDF musíte nainštalovať aj nástroje používané ESP-IDF, ako je kompilátor, debugger, balíky Python atď. ESP-IDF poskytuje skript s názvom 'install.sh', ktorý vám pomôže nastaviť nástroje. jedným ťahom.- cd ~/esp/esp-idf
- /install.sh
- Nastavte premenné prostredia
Nainštalované nástroje ešte nie sú pridané do premennej prostredia PATH. Aby boli nástroje použiteľné z príkazového riadku, musia byť nastavené niektoré premenné prostredia. ESP-IDF poskytuje ďalší skript 'export.sh', ktorý to robí. V termináli, kde budete používať ESP-IDF, spustite:- $HOME/esp/esp-idf/export.sh
Teraz je všetko pripravené, môžete postaviť svoj prvý projekt na module ESP32-C3 MINI-1.
- $HOME/esp/esp-idf/export.sh
Vytvorte svoj prvý projekt
- Začnite projekt
Teraz ste pripravení pripraviť svoju aplikáciu pre modul ESP32-C3-MINI-1. Môžete začať s projektom get-started/hello_world od examples v ESP-IDF.
Skopírujte get-started/hello_world do adresára ~/esp:- cd ~/esp
- cp -r $IDF_PATH/examples/get-started/hello_world .
Existuje celý rad example projekty v examples v ESP-IDF. Akýkoľvek projekt môžete skopírovať rovnakým spôsobom, ako je uvedené vyššie, a spustiť ho. Je možné postaviť aj exampbez toho, aby ste ich najskôr skopírovali.
Existuje celý rad example projekty v examples v ESP IDF. Akýkoľvek projekt môžete skopírovať rovnakým spôsobom, ako je uvedené vyššie, a spustiť ho. Je možné postaviť aj exampbez toho, aby ste ich najskôr skopírovali.
- Pripojte svoje zariadenie
Teraz pripojte váš modul ESP32-C3-MINI-1 k počítaču a skontrolujte, pod akým sériovým portom je modul viditeľný. Sériové porty v Linuxe začínajú '/dev/tty' vo svojich názvoch. Spustite príkaz uvedený nižšie dvakrát, najskôr pomocou
doska odpojená a potom zapojená. Port, ktorý sa objaví druhýkrát, je ten, ktorý potrebujete:- ls /dev/tty*
Poznámka
Majte po ruke názov portu, pretože ho budete potrebovať v ďalších krokoch.
- ls /dev/tty*
- Konfigurovať
Prejdite do svojho adresára 'hello_world' z kroku 2.4.1. Spustite projekt, nastavte ESP32-C3 ako cieľ a spustite pomôcku na konfiguráciu projektu 'menuconfig'.- cd ~/esp/hello_world
- idf.py set-target esp32c3
- idf.py menuconfig
Nastavenie cieľa pomocou 'idf.py set-target esp32c3' by sa malo vykonať raz, po otvorení nového projektu. Ak projekt obsahuje nejaké existujúce zostavy a konfiguráciu, budú vymazané a inicializované. Cieľ možno uložiť do premennej prostredia, aby sa tento krok vôbec vynechal. Ďalšie informácie nájdete v časti Výber cieľa.
Ak boli predchádzajúce kroky vykonané správne, zobrazí sa nasledujúca ponuka:
Obrázok 3: Domovské okno konfigurácie projektu
Farby ponuky sa môžu vo vašom termináli líšiť. Vzhľad môžete zmeniť pomocou možnosti „–style“. Pre ďalšie informácie spustite 'idf.py menuconfig –help'
- Zostavte projekt
Vytvorte projekt spustením:- idf.py b
Tento príkaz skompiluje aplikáciu a všetky komponenty ESP-IDF, potom vygeneruje bootloader, tabuľku oblastí a binárne súbory aplikácie.- $ idf.py zostava
- Spustenie cmake v adresári /path/to/hello_world/build
- Spúšťa sa „cmake -G Ninja –warn-uninicialized /path/to/hello_world“…
- Upozorniť na neinicializované hodnoty.
- — Nájdený Git: /usr/bin/git (nájdená verzia „2.17.0“)
- — Vytváranie prázdneho komponentu aws_iot kvôli konfigurácii
- — Názvy komponentov: …
- — Dráhy komponentov: …
- … (viac riadkov zostavovacieho systému
- [527/527] Generuje sa hello-world.bin
- esptool.py v2.3.1
- Stavba projektu dokončená. Ak chcete flashovať, spustite tento príkaz:
- ../../../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
- alebo spustite 'idf.py -p PORT flash'
Ak sa nevyskytnú žiadne chyby, zostavenie sa dokončí vygenerovaním binárneho súboru .bin firmvéru file.
- idf.py b
- Flash do zariadenia
Flashujte binárne súbory, ktoré ste práve zabudovali do svojho modulu ESP32-C3-MINI-1 spustením:- idf.py -p PORT [-b BAUD] blesk
Nahraďte PORT názvom sériového portu vášho modulu z kroku: Pripojte svoje zariadenie.
Môžete tiež zmeniť prenosovú rýchlosť blikača nahradením BAUD prenosovou rýchlosťou, ktorú potrebujete. Predvolená prenosová rýchlosť je 460800 XNUMX.
Ďalšie informácie o argumentoch idf.py nájdete na stránke idf.py.
- idf.py -p PORT [-b BAUD] blesk
Poznámka
Voľba 'flash' automaticky vytvára a flashuje projekt, takže spustenie 'idf.py build' nie je potrebné.
- …
- 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 načítanie oddielov 0x boot hell/partition-boot0. -svet.bin
- esptool.py v3.0
- Sériový port /dev/ttyUSB0
- Pripája sa….
- Čip je ESP32-C3
- Vlastnosti: Wi-Fi
- Kryštál má frekvenciu 40 MHz
- MAC: 7c:df:a1:40:02:a4
- Nahráva sa útržok…
- Bežecký výbežok…
- Stub beží…
- Zmena prenosovej rýchlosti na 460800
- Zmenené.
- Konfiguruje sa veľkosť blesku…
- Komprimované 3072 bajtov na 103…
- Zápis pri 0x00008000… (100 %)
- Napísal 3072 bajtov (103 komprimovaných) pri 0x00008000 za 0.0 sekundy (efektívne 4238.1 kbit/s)…
- Hash údajov overený.
- Komprimované 18960 bajtov na 11311…
- Zápis pri 0x00000000… (100 %)
- Napísal 18960 bajtov (11311 komprimovaných) pri 0x00000000 za 0.3 sekundy (efektívne 584.9 kbit/s)…
- Hash údajov overený.
- Komprimované 145520 bajtov na 71984…
- Zápis pri 0x00010000… (20 %)
- Zápis pri 0x00014000… (40 %)
- Zápis pri 0x00018000… (60 %)
- Zápis pri 0x0001c000… (80 %)
- Zápis pri 0x00020000… (100 %)
- Napísal 145520 bajtov (71984 komprimovaných) pri 0x00010000 za 2.3 sekundy (efektívne 504.4 kbit/s)…
- Hash údajov overený.
- Opúšťať…
- Tvrdý reset cez RTS pin…
- Hotovo
Ak všetko pôjde dobre, po odstránení prepojky na IO0 a GND a opätovnom zapnutí testovacej dosky sa spustí aplikácia „hello_world“.
Monitor
Ak chcete skontrolovať, či „hello_world“ skutočne beží, napíšte „idf.py -p PORT monitor“ (Nezabudnite nahradiť PORT názvom vášho sériového portu).
Tento príkaz spustí aplikáciu IDF Monitor:
- $ idf.py -p /dev/ttyUSB0 monitor
- Spustenie idf_monitor v adresári […]/esp/hello_world/build
- Spúšťa sa ”python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_world/build /hello-world.elf”…
- — idf_monitor na /dev/ttyUSB0 115200 —
- — Ukončiť: Ctrl+] | Menu: Ctrl+T | Pomocník: Ctrl+T nasledovaný Ctrl+H —
- ets 8. júna 2016 00:22:57
- rst:0x1 (POWERON_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
- ets 8. júna 2016 00:22:57
- …
Po spustení a diagnostických protokoloch nahor by ste mali vidieť „Ahoj svet!“ vytlačené aplikáciou.
- …
- Ahoj svet!
- Reštartovanie o 10 sekúnd…
- Ide o čip esp32c3 s 1 jadrom CPU, WiFi/BLE, 4 MB externého flashu
- Reštartovanie o 9 sekúnd…
- Reštartovanie o 8 sekúnd…
- Reštartovanie o 7 sekúnd…
Ak chcete ukončiť IDF monitor, použite skratku Ctrl+].
To je všetko, čo potrebujete, aby ste mohli začať s modulom ESP32-C3-MINI-1! Teraz ste pripravení vyskúšať iného bývaléhoampv ESP-IDF alebo prejdite priamo na vývoj vlastných aplikácií.
Vzdelávacie zdroje
- Dokumenty, ktoré musíte prečítať
Oboznámte sa, prosím, s nasledujúcimi dokumentmi: - Technický list rodiny ESP32-C3
Toto je úvod do špecifikácií hardvéru ESP32-C3 vrátane vyššieview, definície pinov,
funkčný popis, periférne rozhranie, elektrické charakteristiky atď. - Sprievodca programovaním ESP-IDF
Rozsiahla dokumentácia pre vývojový rámec ESP-IDF, od hardvérových sprievodcov až po API
referencie. - Technický referenčný manuál ESP32-C3
Podrobné informácie o používaní pamäte a periférií ESP32-C3. - Informácie o objednávaní produktov Espressif
Dôležité zdroje
Tu sú dôležité zdroje týkajúce sa ESP32-C3.
- ESP32 BBS
Komunita medzi inžiniermi a inžiniermi (E2E) pre produkty Espressif, kde môžete písať otázky, zdieľať znalosti, skúmať nápady a pomáhať pri riešení problémov s kolegami inžiniermi.
História revízií
Dátum |
Verzia | Poznámky k vydaniu |
2021-02-01 | V0.1 |
Predbežné vydanie |
Zrieknutie sa zodpovednosti a oznámenie o autorských právach
Informácie v tomto dokumente vrátane URL referencie, podlieha zmenám bez upozornenia.
VŠETKY INFORMÁCIE TRETEJ STRANY V TOMTO DOKUMENTE SA POSKYTUJÚ TAK, JAK SÚ, BEZ ZÁRUKY NA JEHO PRAVOSŤ A PRESNOSŤ. NA TOHTO DOKUMENT SA NEPOSKYTUJE ŽIADNA ZÁRUKA ZA JEHO PREDAJNOSŤ, NEPORUŠENIE PRÁVA, VHODNOSŤ NA AKÝKOĽVEK KONKRÉTNY ÚČEL, ANI NEPOSKYTUJE ŽIADNA ZÁRUKA INAK VYPLÝVAJÚCA Z AKÉHOKOĽVEK NÁVRHU, ŠPECIFIKÁCIE ALEBO SAMPLE.
Všetka zodpovednosť, vrátane zodpovednosti za porušenie akýchkoľvek vlastníckych práv, súvisiaca s používaním informácií v tomto dokumente, je odmietnutá. V tomto dokumente nie sú udelené žiadne výslovné alebo implikované licencie na akékoľvek práva duševného vlastníctva.
Logo člena Wi-Fi Alliance je ochrannou známkou Wi-Fi Alliance. Logo Bluetooth je registrovaná ochranná známka spoločnosti Bluetooth SIG.
Všetky obchodné názvy, ochranné známky a registrované ochranné známky uvedené v tomto dokumente sú majetkom ich príslušných vlastníkov a sú týmto uznané.
Copyright © 2021 Espressif Systems (Shanghai) Co., Ltd. Všetky práva vyhradené.
Dokumenty / zdroje
![]() |
Modul internetu vecí ESPRESSIF ESP32-C3-MINI-1 Wi-Fi a Bluetooth [pdfPoužívateľská príručka ESPC3MINI1, 2AC7Z-ESPC3MINI1, 2AC7ZESPC3MINI1, ESP32 -C3 -MINI- 1 Wi-Fi a Bluetooth modul internetu vecí, modul Wi-Fi a Bluetooth internet vecí, modul internetu vecí |