Uživatelská příručka k modulu Internet věcí ESPRESSIF ESP32-C3-MINI-1 Wi-Fi a Bluetooth
O tomto dokumentu
Tato uživatelská příručka ukazuje, jak začít s modulem ESP32-C3-MINI-1.
Aktualizace dokumentů
Vždy se prosím podívejte na nejnovější verzi na https://www.espressif.com/en/support/download/documents.
Historie revizí
Historii revizí tohoto dokumentu naleznete na poslední stránce.
Oznámení o změně dokumentace
Espressif poskytuje e-mailová upozornění, abyste byli informováni o změnách technické dokumentace. Odebírejte prosím na www.espressif.com/en/subscribe.
Osvědčení
Stáhněte si certifikáty pro produkty Espressif z www.espressif.com/en/certificates
Nadview
- Modul skončilview
ESP32-C3-MINI-1 je modul Wi-Fi a Bluetooth LE pro všeobecné použití. Bohatá sada periferií a malá velikost činí z tohoto modulu ideální volbu pro chytré domácnosti, průmyslovou automatizaci, zdravotnictví, spotřební elektroniku atd.
Tabulka 1: Specifikace ESP32C3MINI1
kategorie Parametry Specifikace Wi-Fi Protokoly 802.11 b/g/n (až 150 Mb/s) Frekvenční rozsah 2412 ~ 2462 MHz Bluetooth® Protokoly Bluetooth® LE: Bluetooth 5 a Bluetooth mesh Rádio Vysílač třídy 1, třídy 2 a třídy 3 Železářské zboží
Rozhraní modulu GPIO, SPI, UART, I2C, I2S, periferie dálkového ovládání, řadič LED PWM, obecný řadič DMA, TWAI® ovladač (kompatibilní s ISO 11898-1), teplotní senzor, SAR ADC Integrovaný krystal 40 MHz krystal Provozní objemtage/Napájení 3.0 V ~ 3.6 V Provozní proud Průměr: 80 mA Minimální proud dodávaný výkonem zásobování
500 mA Okolní teplota –40 °C ~ +105 °C Úroveň citlivosti na vlhkost (MSL) Úroveň 3 - Popis pinu
Obrázek 1: Rozložení kolíků (nahoře View)
Modul má 53 pinů. Viz definice pinů v tabulce 2.
Informace o konfiguraci periferních kolíků naleznete v datovém listu rodiny ESP32-C3.
Tabulka 2: Definice pinů
Jméno Žádný. Typ Funkce GND 1, 2, 11, 14, 36-53 P Země 3V3 3 P Napájení 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á: zapnuto, povolí čip. Nízká: vypnuto, čip se vypne. Poznámka: Nenechávejte kolík EN plavat.
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čněte na ESP32C3MINI1
Co potřebujete
K vývoji aplikací pro modul ESP32-C3-MINI-1 potřebujete:
- 1 x modul ESP32-C3-MINI-1
- 1 x testovací deska Espressif RF
- 1 x deska USB-to-Serial
- 1 x kabel micro-USB
- 1 x PC s operačním systémem Linux
V této uživatelské příručce bereme jako příklad operační systém Linuxample. Další informace o konfiguraci ve Windows a macOS najdete v ESP-IDF Programming Guide.
Hardwarové připojení
- Připájejte modul ESP32-C3-MINI-1 k RF testovací desce, jak je znázorněno na obrázku 2.
- Připojte RF testovací desku k USB-to-Serial desce přes TXD, RXD a GND.
- Připojte desku USB-to-Serial k počítači.
- Připojte RF testovací desku k PC nebo napájecímu adaptéru, abyste umožnili napájení 5 V pomocí kabelu Micro-USB.
- Během stahování propojte IO0 s GND pomocí propojky. Poté testovací desku zapněte.
- Stáhněte si firmware do flash. Podrobnosti viz sekce níže.
- Po stažení odstraňte propojku na IO0 a GND.
- Znovu zapněte RF testovací desku. ESP32-C3-MINI-1 se přepne do pracovního režimu. Čip bude číst programy z flash po inicializaci.
Poznámka
IO0 je vnitřně logické vysoké. Pokud je IO0 nastaveno na pull-up, je vybrán režim Boot. Pokud je tento kolík stahovací nebo ponechán plovoucí,
Je vybrán režim stahování. Další informace o ESP32-C3 MINI-1 naleznete v katalogovém listu ESP32-C3-MINI-1.
Nastavení vývojového prostředí
Espressif IoT Development Framework (zkráceně ESP-IDF) je framework pro vývoj aplikací založených na čipech Espressif. Uživatelé mohou vyvíjet aplikace s čipy ESP ve Windows/Linux/macOS založené na ESP-IDF. Zde bereme operační systém Linux jako example.
- Nainstalujte předpoklady
Ke kompilaci s ESP-IDF potřebujete získat následující balíčky:- Cent OS 7:
1 sudo yum nainstalovat git wget flex bison gperf python cmake ninja-build ccache dfuutil - Ubuntu a Debian (jeden příkaz se rozdělí na dva řádky):
- sudo apt-get install git wget flex bison gperf python python-pip pythonsetuptools cmake
- ninja-build ccache libffi-dev libssl-dev dfu-util
- Oblouk:
- 1 sudo pacman -S – potřeba gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
Poznámka - Tato příručka používá adresář ~/esp v systému Linux jako instalační složku pro ESP-IDF.
- Mějte na paměti, že ESP-IDF nepodporuje mezery v cestách.
- 1 sudo pacman -S – potřeba gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
- Cent OS 7:
- Získejte ESPIDF
Chcete-li vytvářet aplikace pro modul ESP32-C3-MINI-1, potřebujete softwarové knihovny poskytované společností Espressif v úložišti ESP-IDF.
Chcete-li získat ESP-IDF, vytvořte instalační adresář (~/esp), do kterého stáhněte ESP-IDF a naklonujte úložiště pomocí 'git clone':- mkdir -p ~/esp
- cd ~/esp
- git klon – rekurzivní https://github.com/espressif/esp-idf.git
ESP-IDF bude staženo do ~/esp/esp-idf. Informace o tom, kterou verzi ESP-IDF použít v dané situaci, najdete ve verzích ESP-IDF.
- Nastavit Nástroje
Kromě ESP-IDF musíte také nainstalovat nástroje používané ESP-IDF, jako je kompilátor, debugger, balíčky Pythonu atd. ESP-IDF poskytuje skript s názvem 'install.sh', který vám pomůže nastavit nástroje. na jeden zátah.- cd ~/esp/esp-idf
- /install.sh
- Nastavte proměnné prostředí
Nainstalované nástroje ještě nejsou přidány do proměnné prostředí PATH. Aby byly nástroje použitelné z příkazového řádku, musí být nastaveny některé proměnné prostředí. ESP-IDF poskytuje další skript 'export.sh', který to dělá. V terminálu, kde budete používat ESP-IDF, spusťte:- $HOME/esp/esp-idf/export.sh
Nyní je vše připraveno, můžete postavit svůj první projekt na modulu ESP32-C3 MINI-1.
- $HOME/esp/esp-idf/export.sh
Vytvořte svůj první projekt
- Spusťte projekt
Nyní jste připraveni připravit aplikaci pro modul ESP32-C3-MINI-1. Můžete začít s projektem get-started/hello_world od examples v ESP-IDF.
Zkopírujte get-started/hello_world do adresáře ~/esp:- cd ~/esp
- cp -r $IDF_PATH/examples/get-started/hello_world .
Existuje řada example projekty v examples v ESP-IDF. Jakýkoli projekt můžete zkopírovat stejným způsobem, jak je uvedeno výše, a spustit jej. Je také možné postavit exampsoubory na místě, aniž byste je nejprve zkopírovali.
Existuje řada example projekty v exampadresář les v ESP IDF. Jakýkoli projekt můžete zkopírovat stejným způsobem, jak je uvedeno výše, a spustit jej. Je také možné postavit exampsoubory na místě, aniž byste je nejprve zkopírovali.
- Připojte zařízení
Nyní připojte váš modul ESP32-C3-MINI-1 k počítači a zkontrolujte, pod jakým sériovým portem je modul viditelný. Sériové porty v Linuxu začínají v názvu '/dev/tty'. Spusťte níže uvedený příkaz dvakrát, nejprve pomocí
deska je odpojena a poté připojena. Port, který se objeví podruhé, je ten, který potřebujete:- ls /dev/tty*
Poznámka
Mějte po ruce název portu, protože jej budete potřebovat v dalších krocích.
- ls /dev/tty*
- Konfigurovat
Přejděte do svého adresáře 'hello_world' z kroku 2.4.1. Spusťte projekt, nastavte ESP32-C3 jako cíl a spusťte konfigurační nástroj projektu 'menuconfig'.- cd ~/esp/hello_world
- idf.py set-target esp32c3
- idf.py menuconfig
Nastavení cíle pomocí 'idf.py set-target esp32c3' by mělo být provedeno jednou, po otevření nového projektu. Pokud projekt obsahuje některá existující sestavení a konfigurace, budou vymazány a inicializovány. Cíl lze uložit do proměnné prostředí a tento krok vůbec přeskočit. Další informace naleznete v části Výběr cíle.
Pokud byly předchozí kroky provedeny správně, zobrazí se následující nabídka:
Obrázek 3: Domovské okno Konfigurace projektu
Barvy nabídky se mohou ve vašem terminálu lišit. Vzhled můžete změnit volbou '–style'. Pro další informace spusťte 'idf.py menuconfig –help'
- Sestavte projekt
Sestavte projekt spuštěním:- idf.py b
Tento příkaz zkompiluje aplikaci a všechny komponenty ESP-IDF, poté vygeneruje bootloader, tabulku oddílů a binární soubory aplikace.- $ idf.py sestavení
- Spuštění cmake v adresáři /path/to/hello_world/build
- Probíhá „cmake -G Ninja –warn-uninicialized /path/to/hello_world“…
- Varovat před neinicializovanými hodnotami.
- — Nalezen Git: /usr/bin/git (nalezená verze „2.17.0“)
- — Vytvoření prázdné komponenty aws_iot kvůli konfiguraci
- — Názvy součástí: …
- — Cesty součástí: …
- … (více řádků sestavení systému
- [527/527] Generování hello-world.bin
- esptool.py v2.3.1
- Stavba projektu dokončena. Chcete-li flashovat, spusťte tento pří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/table_partition_table/partition-table.bin
- nebo spusťte 'idf.py -p PORT flash'
Pokud se nevyskytnou žádné chyby, sestavení se dokončí vygenerováním binárního souboru .bin firmwaru file.
- idf.py b
- Flash do zařízení
Flashujte binární soubory, které jste právě zabudovali do modulu ESP32-C3-MINI-1 spuštěním:- idf.py -p PORT [-b BAUD] flash
Nahraďte PORT názvem sériového portu vašeho modulu z kroku: Připojení zařízení.
Přenosovou rychlost blikání můžete také změnit nahrazením BAUD přenosovou rychlostí, kterou potřebujete. Výchozí přenosová rychlost je 460800 XNUMX.
Další informace o argumentech idf.py naleznete v tématu idf.py.
- idf.py -p PORT [-b BAUD] flash
Poznámka
Možnost 'flash' automaticky vytvoří a flashuje projekt, takže spouštění 'idf.py build' není nutné.
- …
- 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 2 MB 0x 8000 zavádění 0x 0 partition_table. -svět.bin
- esptool.py v3.0
- Sériový port /dev/ttyUSB0
- Spojovací….
- Čip je ESP32-C3
- Vlastnosti: Wi-Fi
- Krystal má frekvenci 40 MHz
- MAC: 7c:df:a1:40:02:a4
- Nahrávání útržku…
- Běžící pahýl…
- Stub běží…
- Změna přenosové rychlosti na 460800
- Změněno.
- Konfigurace velikosti blesku…
- Zkomprimováno 3072 bajtů na 103…
- Zápis na 0x00008000… (100 %)
- Napsal 3072 bajtů (103 komprimovaných) při 0x00008000 za 0.0 sekundy (efektivní 4238.1 kbit/s)…
- Hash dat ověřen.
- Zkomprimováno 18960 bajtů na 11311…
- Zápis na 0x00000000… (100 %)
- Napsal 18960 bajtů (11311 komprimovaných) při 0x00000000 za 0.3 sekundy (efektivní 584.9 kbit/s)…
- Hash dat ověřen.
- Zkomprimováno 145520 bajtů na 71984…
- Zápis na 0x00010000… (20 %)
- Zápis na 0x00014000… (40 %)
- Zápis na 0x00018000… (60 %)
- Zápis na 0x0001c000… (80 %)
- Zápis na 0x00020000… (100 %)
- Napsal 145520 bajtů (71984 komprimováno) při 0x00010000 za 2.3 sekundy (efektivní 504.4 kbit/s)…
- Hash dat ověřen.
- Odcházení…
- Tvrdý reset přes RTS pin…
- Hotovo
Pokud vše půjde dobře, po odstranění propojky na IO0 a GND a opětovném zapnutí testovací desky se spustí aplikace „hello_world“.
Monitor
Chcete-li zkontrolovat, zda „hello_world“ skutečně běží, napište 'idf.py -p PORT monitor' (Nezapomeňte nahradit PORT názvem vašeho sériového portu).
Tento příkaz spustí aplikaci IDF Monitor:
- $ idf.py -p /dev/ttyUSB0 monitor
- Spuštění idf_monitor v adresáři […]/esp/hello_world/build
- Spouštění ”python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_world/build /hello-world.elf”…
- — idf_monitor na /dev/ttyUSB0 115200 —
- — Konec: Ctrl+] | Menu: Ctrl+T | Nápověda: Ctrl+T následovaná Ctrl+H —
- ets 8. června 2016 00:22:57
- rst:0x1 (POWERON_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
- ets 8. června 2016 00:22:57
- …
Po spuštění a diagnostických protokolech rolování nahoru by se mělo zobrazit „Ahoj světe!“ vytištěné aplikací.
- …
- Ahoj světe!
- Restartování za 10 sekund…
- Jedná se o čip esp32c3 s 1 CPU jádrem, WiFi/BLE, 4MB externí flash
- Restartování za 9 sekund…
- Restartování za 8 sekund…
- Restartování za 7 sekund…
Pro ukončení IDF monitoru použijte klávesovou zkratku Ctrl+].
To je vše, co potřebujete, abyste mohli začít s modulem ESP32-C3-MINI-1! Nyní jste připraveni vyzkoušet další exampv ESP-IDF, nebo přejděte rovnou k vývoji vlastních aplikací.
Výukové zdroje
- Dokumenty, které musíte přečíst
Seznamte se prosím s následujícími dokumenty: - Katalogový list rodiny ESP32-C3
Toto je úvod ke specifikacím hardwaru ESP32-C3, včetně přesview, definice pinů,
funkční popis, periferní rozhraní, elektrické charakteristiky atd. - Průvodce programováním ESP-IDF
Rozsáhlá dokumentace pro vývojový rámec ESP-IDF, od hardwarových příruček po API
odkaz. - Technický referenční manuál ESP32-C3
Podrobné informace o použití paměti a periferií ESP32-C3. - Informace pro objednání produktů Espressif
Důležité zdroje
Zde jsou důležité zdroje související s ESP32-C3.
- ESP32 BBS
Komunita mezi inženýry a inženýry (E2E) pro produkty Espressif, kde můžete klást otázky, sdílet znalosti, zkoumat nápady a pomáhat řešit problémy s kolegy inženýry.
Historie revizí
Datum |
Verze | Poznámky k vydání |
2021-02-01 | V0.1 |
Předběžné vydání |
Zřeknutí se odpovědnosti a upozornění na autorská práva
Informace v tomto dokumentu, včetně URL reference, podléhá změnám bez upozornění.
VŠECHNY INFORMACE TŘETÍCH STRAN V TOMTO DOKUMENTU JSOU POSKYTOVÁNY TAK JAK JSOU, BEZ ŽÁDNÝCH ZÁRUK NA JEHO PRAVOSTI A PŘESNOST. NA TENTO DOKUMENT SE NEPOSKYTUJE ŽÁDNÁ ZÁRUKA ZA JEHO PRODEJNOST, NEPORUŠENÍ PRÁV, VHODNOST PRO JAKÝKOLI KONKRÉTNÍ ÚČEL A NEVZTAHUJE SE ŽÁDNÁ ZÁRUKA JINAK VYPLÝVAJÍCÍ Z JAKÉHOKOLI NÁVRHU, SPECIFIKACE NEBO SAMPLE.
Veškerá odpovědnost, včetně odpovědnosti za porušení jakýchkoliv vlastnických práv, týkající se použití informací v tomto dokumentu, se zříká. Nejsou zde uděleny žádné vyjádřené nebo předpokládané licence k právům duševního vlastnictví, ať už estoppelem nebo jinak.
Logo člena Wi-Fi Alliance je ochrannou známkou Wi-Fi Alliance. Logo Bluetooth je registrovaná ochranná známka společnosti Bluetooth SIG.
Všechny obchodní názvy, ochranné známky a registrované ochranné známky uvedené v tomto dokumentu jsou majetkem příslušných vlastníků a jsou tímto uznávány.
Copyright © 2021 Espressif Systems (Shanghai) Co., Ltd. Všechna práva vyhrazena.
Dokumenty / zdroje
![]() |
Modul internetu věcí ESPRESSIF ESP32-C3-MINI-1 Wi-Fi a Bluetooth [pdfUživatelská příručka ESPC3MINI1, 2AC7Z-ESPC3MINI1, 2AC7ZESPC3MINI1, ESP32 -C3 -MINI- 1 Wi-Fi a Bluetooth modul internetu věcí, modul Wi-Fi a Bluetooth Internet věcí, modul internetu věcí |