ESPRESSIF ESP32-C3-MINI-1 Wi-Fi és Bluetooth tárgyak internete modul felhasználói kézikönyv
Erről a dokumentumról
Ez a felhasználói kézikönyv bemutatja az ESP32-C3-MINI-1 modul használatának megkezdését.
Dokumentumfrissítések
Kérjük, mindig olvassa el a legújabb verziót https://www.espressif.com/en/support/download/documents.
Revíziótörténet
A dokumentum felülvizsgálati előzményeiért tekintse meg az utolsó oldalt.
Értesítés a dokumentáció változásáról
Az Espressif e-mailben értesíti Önt a műszaki dokumentáció változásairól. Kérjük, iratkozzon fel a címen www.espressif.com/en/subscribe.
Tanúsítvány
Töltse le az Espressif termékek tanúsítványait innen www.espressif.com/en/certificates
Felettview
- Modul végeview
Az ESP32-C3-MINI-1 egy általános célú Wi-Fi és Bluetooth LE modul. A gazdag perifériakészlet és a kis méret ideális választássá teszi ezt a modult okosotthonok, ipari automatizálás, egészségügy, fogyasztói elektronika stb.
1. táblázat: ESP32C3MINI1 specifikációk
Kategóriák Paraméterek Műszaki adatok Wi-Fi Protokollok 802.11 b/g/n (150 Mbps-ig) Frekvencia tartomány 2412 ~ 2462 MHz Bluetooth® Protokollok Bluetooth® LE: Bluetooth 5 és Bluetooth mesh Rádió Class-1, Class-2 és Class-3 adó Hardver
Modul interfészek GPIO, SPI, UART, I2C, I2S, távirányító periféria, LED PWM vezérlő, általános DMA vezérlő, TWAI® vezérlő (ISO 11898-1 szabványnak megfelelő), hőmérséklet-érzékelő, SAR ADC Integrált kristály 40 MHz-es kristály Működési voltage/Tápegység 3.0 V ~ 3.6 V Üzemi áram Átlagos: 80 mA A táp által szállított minimális áramerősség kínálat
500 mA Környezeti hőmérséklet –40 °C ~ +105 °C Nedvességérzékenységi szint (MSL) 3. szint - Pin Leírás
1. ábra: Pin-elrendezés (Felső View)
A modul 53 érintkezős. Lásd a tű definícióit a 2. táblázatban.
A perifériás érintkezők konfigurációjával kapcsolatban tekintse meg az ESP32-C3 család adatlapját.
2. táblázat: Pin-definíciók
Név Nem. Írja be Funkció GND 1, 2, 11, 14, 36-53 P Föld 3V3 3 P Tápegység 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
High: be, engedélyezi a chipet. Alacsony: ki, a chip kikapcsol. Megjegyzés: Ne hagyja lebegni az EN csapot.
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
Az ESP32C3MINI1 használatának megkezdése
Amire szüksége van
Az ESP32-C3-MINI-1 modulhoz való alkalmazások fejlesztéséhez szüksége lesz:
- 1 db ESP32-C3-MINI-1 modul
- 1 x Espressif RF tesztelőtábla
- 1 x USB-soros kártya
- 1 x Micro-USB kábel
- 1 x Linuxot futtató PC
Ebben a használati útmutatóban a Linux operációs rendszert vesszük példakéntample. A Windows és a macOS konfigurációjával kapcsolatos további információkért tekintse meg az ESP-IDF programozási útmutatót.
Hardver csatlakozás
- Forrassza az ESP32-C3-MINI-1 modult az RF tesztelőkártyára a 2. ábrán látható módon.
- Csatlakoztassa az RF-tesztelő kártyát az USB-soros kártyához TXD, RXD és GND segítségével.
- Csatlakoztassa az USB-soros kártyát a számítógéphez.
- Csatlakoztassa az RF-tesztelő kártyát a számítógéphez vagy egy hálózati adapterhez, hogy engedélyezze az 5 V-os tápellátást a Micro-USB kábelen keresztül.
- Letöltés közben csatlakoztassa az IO0-t a GND-hez egy jumperen keresztül. Ezután kapcsolja „BE” a teszttáblát.
- Töltse le a firmware-t a flash-be. A részletekért lásd az alábbi szakaszokat.
- A letöltés után távolítsa el a jumpert az IO0-ról és a GND-ről.
- Kapcsolja be újra az RF-tesztelő kártyát. Az ESP32-C3-MINI-1 munkamódba kapcsol. A chip az inicializáláskor flash-ről olvas programokat.
Jegyzet
Az IO0 belül logikailag magas. Ha az IO0 felhúzásra van állítva, a rendszerindítási mód van kiválasztva. Ha ez a tű lehúzható vagy lebegve marad, a
Letöltési mód van kiválasztva. Az ESP32-C3 MINI-1-ről további információkért tekintse meg az ESP32-C3-MINI-1 adatlapot.
Fejlesztői környezet beállítása
Az Espressif IoT Development Framework (röviden ESP-IDF) az Espressif chipeken alapuló alkalmazások fejlesztésének keretrendszere. A felhasználók ESP-chipekkel rendelkező alkalmazásokat fejleszthetnek Windows/Linux/macOS rendszerben ESP-IDF alapú. Itt a Linux operációs rendszert vesszük példakéntample.
- Telepítse az előfeltételeket
Az ESP-IDF-fel való fordításhoz a következő csomagokat kell beszereznie:- CentOS 7:
1 sudo yum install git wget flex bison gperf python cmake ninja-build ccache dfuutil - Ubuntu és Debian (egy parancs két sorra szakad):
- sudo apt-get install git wget flex bison gperf python python-pip pythonsetuptools cmake
- ninja-build ccache libffi-dev libssl-dev dfu-util
- Boltív:
- 1 sudo pacman -S – szükséges gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
Jegyzet - Ez az útmutató a ~/esp könyvtárat használja Linuxon az ESP-IDF telepítési mappájaként.
- Ne feledje, hogy az ESP-IDF nem támogatja a szóközöket az útvonalakban.
- 1 sudo pacman -S – szükséges gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
- CentOS 7:
- Szerezze be az ESPIDF-et
Az ESP32-C3-MINI-1 modulhoz való alkalmazások készítéséhez szüksége van az Espressif által az ESP-IDF lerakatban található szoftverkönyvtárra.
Az ESP-IDF beszerzéséhez hozzon létre egy telepítési könyvtárat (~/esp) az ESP-IDF letöltéséhez, és klónozza a tárat a „git clone” segítségével:- mkdir -p ~/esp
- cd ~/esp
- git klón – rekurzív https://github.com/espressif/esp-idf.git
Az ESP-IDF az ~/esp/esp-idf fájlba lesz letöltve. Tekintse meg az ESP-IDF verziók oldalt, hogy megtudja, melyik ESP-IDF verziót kell használni egy adott helyzetben.
- Állítsa be az Eszközöket
Az ESP-IDF-en kívül telepítenie kell az ESP-IDF által használt eszközöket is, például a fordítót, a hibakeresőt, a Python-csomagokat stb. Az ESP-IDF egy „install.sh” nevű szkriptet biztosít az eszközök beállításához. egyben.- cd ~/esp/esp-idf
- /install.sh
- Állítsa be a környezeti változókat
A telepített eszközök még nincsenek hozzáadva a PATH környezeti változóhoz. Ahhoz, hogy az eszközök parancssorból használhatóak legyenek, be kell állítani néhány környezeti változót. Az ESP-IDF egy másik „export.sh” szkriptet biztosít, amely ezt teszi. A terminálon, ahol az ESP-IDF-et használni fogja, futtassa:- $HOME/esp/esp-idf/export.sh
Most minden készen áll, megépítheti első projektjét az ESP32-C3 MINI-1 modulon.
- $HOME/esp/esp-idf/export.sh
Készítse el első projektjét
- Indítson el egy projektet
Most készen áll az ESP32-C3-MINI-1 modul alkalmazásának előkészítésére. Kezdheti a get-started/hello_world projekttel plamples könyvtár az ESP-IDF-ben.
A get-started/hello_world másolása a ~/esp könyvtárba:- cd ~/esp
- cp -r $IDF_PATH/plamples/get-started/hello_world .
Van egy sor plample projektek az examples könyvtár az ESP-IDF-ben. Bármely projektet a fent bemutatott módon másolhatja, és futtathatja. Építeni is lehet plamplemásolása nélkül.
Van egy sor plample projektek az examples könyvtár az ESP IDF-ben. Bármely projektet a fent bemutatott módon másolhatja, és futtathatja. Építeni is lehet plamplemásolása nélkül.
- Csatlakoztassa a készüléket
Most csatlakoztassa az ESP32-C3-MINI-1 modult a számítógéphez, és ellenőrizze, hogy melyik soros port alatt látható a modul. A Linux soros portjai a „/dev/tty” előtaggal kezdődnek a nevükben. Futtassa kétszer az alábbi parancsot, először a
kártya kihúzva, majd bedugva. A másodszor megjelenő port az, amelyre szüksége van:- ls /dev/tty*
Jegyzet
Tartsa kéznél a port nevét, mert szüksége lesz rá a következő lépésekben.
- ls /dev/tty*
- Konfigurálás
Keresse meg a 'hello_world' könyvtárát a 2.4.1 lépéstől. Indítson el egy projektet, állítsa be az ESP32-C3-at célként, és futtassa a „menuconfig” projektkonfigurációs segédprogramot.- cd ~/esp/hello_world
- idf.py set-target esp32c3
- idf.py menuconfig
A cél beállítását az „idf.py set-target esp32c3” paranccsal egyszer kell elvégezni, egy új projekt megnyitása után. Ha a projekt tartalmaz néhány meglévő buildet és konfigurációt, akkor azok törlődnek és inicializálódnak. A cél elmenthető a környezeti változóba, hogy kihagyja ezt a lépést. További információkért lásd: A cél kiválasztása.
Ha az előző lépéseket megfelelően végezte el, a következő menü jelenik meg:
3. ábra: Projektkonfiguráció kezdőablak
A menü színei eltérőek lehetnek a terminálon. A megjelenést a „–style” opcióval módosíthatja. További információkért futtassa az 'idf.py menuconfig –help' parancsot
- Építsd meg a Projektet
A projekt létrehozása a következő futtatással:- idf.py b
Ez a parancs lefordítja az alkalmazást és az összes ESP-IDF összetevőt, majd létrehozza a rendszertöltőt, a partíciós táblát és az alkalmazás binárisokat.- $ idf.py build
- A cmake futtatása a /path/to/hello_world/build könyvtárban
- A „cmake -G Ninja –warn-uninitialized /path/to/hello_world” végrehajtása…
- Figyelmeztetés az inicializálatlan értékekre.
- - Talált Git: /usr/bin/git (talált verzió: "2.17.0")
- — Üres aws_iot komponens létrehozása a konfiguráció miatt
- — Összetevők neve: …
- — Alkatrész útvonalak: …
- … (további felépítési sorok
- [527/527] Hello-world.bin generálása
- esptool.py v2.3.1
- A projekt felépítése kész. A villogáshoz futtassa ezt a parancsot:
- ../../../components/esptool_py/esptool/esptool.py -p (PORT) -b 921600 write_flash –flash_ mód 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
- vagy futtassa az "idf.py -p PORT flash" parancsot
Ha nincs hiba, a build a firmware bináris .bin generálásával fejeződik be file.
- idf.py b
- Flash rá a készülékre
Felvillanthatja az ESP32-C3-MINI-1 modulra épített bináris fájlokat a következő futtatással:- idf.py -p PORT [-b BAUD] vaku
Cserélje ki a PORT-ot a modul soros portjának nevére a Lépés: Eszköz csatlakoztatása részben.
A flasher adatátviteli sebességét úgy is módosíthatja, hogy a BAUD-t a szükséges átviteli sebességre cseréli. Az alapértelmezett adatátviteli sebesség 460800.
Az idf.py argumentumokkal kapcsolatos további információkért lásd az idf.py webhelyet.
- idf.py -p PORT [-b BAUD] vaku
Jegyzet
A „flash” opció automatikusan felépíti és felvillantja a projektet, így az „idf.py build” futtatása nem szükséges.
- …
- 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 hello 0x 8000 partition0otboload0 bo.biner0/partition10000xtable_xer. -world.bin
- esptool.py v3.0
- Soros port /dev/ttyUSB0
- Csatlakozás….
- A chip ESP32-C3
- Jellemzők: Wi-Fi
- A kristály 40 MHz
- MAC: 7c:df:a1:40:02:a4
- Csonk feltöltése…
- Futás csonk…
- Stub running…
- Az adatátviteli sebesség módosítása 460800-ra
- Megváltozott.
- A vaku méretének beállítása…
- 3072 bájtból 103-re tömörítve…
- Írás 0x00008000… (100 %)
- 3072 bájtot írt (103 tömörítés) 0x00008000 sebességgel 0.0 másodperc alatt (effektív 4238.1 kbit/s)…
- Az adatok kivonatolása ellenőrizve.
- 18960 bájtból 11311-re tömörítve…
- Írás 0x00000000… (100 %)
- 18960 bájtot írt (11311 tömörítve) 0x00000000 sebességgel 0.3 másodperc alatt (effektív 584.9 kbit/s)…
- Az adatok kivonatolása ellenőrizve.
- 145520 bájtból 71984-re tömörítve…
- Írás 0x00010000… (20 %)
- Írás 0x00014000… (40 %)
- Írás 0x00018000… (60 %)
- Írás 0x0001c000… (80 %)
- Írás 0x00020000… (100 %)
- 145520 bájtot írt (71984 tömörítve) 0x00010000 sebességgel 2.3 másodperc alatt (effektív 504.4 kbit/s)…
- Az adatok kivonatolása ellenőrizve.
- Kilépő…
- Hard reset RTS tűvel…
- Kész
Ha minden jól megy, a „hello_world” alkalmazás elindul, miután eltávolította a jumpert az IO0-ról és a GND-ről, és újra bekapcsolta a teszttáblát.
Monitor
Annak ellenőrzéséhez, hogy a „hello_world” valóban fut-e, írja be az „idf.py -p PORT monitor” parancsot (ne felejtse el a PORT szót a soros port nevére cserélni).
Ez a parancs elindítja az IDF Monitor alkalmazást:
- $ idf.py -p /dev/ttyUSB0 monitor
- Az idf_monitor futtatása a […]/esp/hello_world/build könyvtárban
- A „python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_world/build /hello-world.elf” végrehajtása…
- — idf_monitor on /dev/ttyUSB0 115200 —
- — Kilépés: Ctrl+] | Menü: Ctrl+T | Súgó: Ctrl+T, majd Ctrl+H —
- ets 8. június 2016., 00:22:57
- első:0x1 (POWERON_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
- ets 8. június 2016., 00:22:57
- …
Az indítási és diagnosztikai naplók felfelé görgetése után a „Hello world!” üzenetnek kell megjelennie. kinyomtatja az alkalmazás.
- …
- Helló világ!
- Újraindítás 10 másodperc múlva…
- Ez egy esp32c3 chip 1 CPU maggal, WiFi/BLE-vel, 4MB külső vakuval
- Újraindítás 9 másodperc múlva…
- Újraindítás 8 másodperc múlva…
- Újraindítás 7 másodperc múlva…
Az IDF monitorból való kilépéshez használja a Ctrl+] billentyűparancsot.
Ez minden, amire szüksége van az ESP32-C3-MINI-1 modul használatának megkezdéséhez! Most készen áll arra, hogy kipróbáljon egy másik example az ESP-IDF-ben, vagy folytassa a saját alkalmazások fejlesztését.
Tanulási források
- El kell olvasni a dokumentumokat
Kérjük, ismerkedjen meg az alábbi dokumentumokkal: - ESP32-C3 család adatlap
Ez egy bevezetés az ESP32-C3 hardver specifikációiba, beleértve a hardvertview, gombostű definíciók,
funkcionális leírás, periféria interfész, elektromos jellemzők stb. - ESP-IDF programozási útmutató
Kiterjedt dokumentáció az ESP-IDF fejlesztési keretrendszerhez, a hardver útmutatóktól az API-ig
referencia. - ESP32-C3 Műszaki kézikönyv
Részletes információ az ESP32-C3 memória és perifériák használatáról. - Espressif termékek rendelési információi
Fontos források
Itt vannak az ESP32-C3-hoz kapcsolódó fontos források.
- ESP32 BBS
Mérnöktől mérnökig (E2E) közösség az Espressif termékekhez, ahol kérdéseket tehet fel, megoszthatja tudását, felfedezhet ötleteket és segíthet megoldani a problémákat mérnöktársaival.
Revíziótörténet
Dátum |
Változat | Kiadási megjegyzések |
2021-02-01 | V0.1 |
Előzetes kiadás |
Jogi nyilatkozat és szerzői jogi megjegyzés
A dokumentumban található információk, beleértve URL hivatkozások, előzetes értesítés nélkül változhatnak.
A HARMADIK FÉL EZEN DOKUMENTUMBAN BIZTOSÍTOTT MINDEN INFORMÁCIÓT AZ ÉRTÉKELÉSÉRE ÉS PONTOSSÁGÁRA VONATKOZÓ GARANCIA NÉLKÜL ÁLLÍTOTT. A JELEN DOKUMENTUM ELADHATÓSÁGÁRA VONATKOZÓAN NINCS GARANCIA AZ ELADHATÓSÁGÁRA, JOGSÉRTÉSÉRE, BÁRMILYEN CÉLRA VALÓ ALKALMAZÁSÁRA, ÉS NEM EGYÉBEN GARANCIA NEM KERÜL BÁRMILYEN JAVASLATBÓL, ELŐÍRÁSBÓL VAGY S.AMPLE.
A jelen dokumentumban található információk felhasználásával kapcsolatos minden felelősséget, beleértve a tulajdonjogok megsértéséért való felelősséget is, kizárunk. A jelen dokumentumban semmilyen szellemi tulajdonjogra vonatkozó kifejezett vagy hallgatólagos engedélyt nem adunk, sem megtorpanással, sem más módon.
A Wi-Fi Alliance Member logó a Wi-Fi Alliance védjegye. A Bluetooth logó a Bluetooth SIG bejegyzett védjegye.
A jelen dokumentumban említett összes kereskedelmi név, védjegy és bejegyzett védjegy a megfelelő tulajdonosok tulajdona, és ezúton elismerjük.
Copyright © 2021 Espressif Systems (Shanghai) Co., Ltd. Minden jog fenntartva.
Dokumentumok / Források
![]() |
ESPRESSIF ESP32-C3-MINI-1 Wi-Fi és Bluetooth tárgyak internete modul [pdf] Felhasználói kézikönyv ESPC3MINI1, 2AC7Z-ESPC3MINI1, 2AC7ZESPC3MINI1, ESP32 -C3 -MINI- 1 Wi-Fi és Bluetooth tárgyak internete modul, Wi-Fi és Bluetooth tárgyak internete modul, tárgyak internete modul |