ESPRESSIF ESP32-C3-MINI-1 Wi-Fi- ja Bluetooth esineiden internet -moduulin käyttöopas
Tietoja tästä asiakirjasta
Tämä käyttöopas näyttää kuinka pääset alkuun ESP32-C3-MINI-1-moduulin kanssa.
Asiakirjan päivitykset
Katso aina uusin versio https://www.espressif.com/en/support/download/documents.
Versiohistoria
Katso tämän asiakirjan versiohistoria viimeiseltä sivulta.
Asiakirjojen muutosilmoitus
Espressif lähettää sähköposti-ilmoituksia pitääkseen sinut ajan tasalla teknisten asiakirjojen muutoksista. Ole hyvä ja tilaa osoitteessa www.espressif.com/en/subscribe.
Sertifiointi
Lataa sertifikaatit Espressif-tuotteille osoitteesta www.espressif.com/en/certificates
Yliview
- Moduuli ohiview
ESP32-C3-MINI-1 on yleiskäyttöinen Wi-Fi- ja Bluetooth LE -moduuli. Runsas oheislaitteiden sarja ja pieni koko tekevät tästä moduulista ihanteellisen valinnan älykotiin, teollisuusautomaatioon, terveydenhuoltoon, kulutuselektroniikkaan jne.
Taulukko 1: ESP32C3MINI1 Tekniset tiedot
Luokat Parametrit Tekniset tiedot Wi-Fi Protokollat 802.11 b/g/n (jopa 150 Mbps) Taajuusalue 2412 ~ 2462 MHz Bluetooth® Protokollat Bluetooth® LE: Bluetooth 5 ja Bluetooth mesh Radio Luokka-1, luokka-2 ja luokka-3 lähetin Laitteisto
Moduulien rajapinnat GPIO, SPI, UART, I2C, I2S, kaukosäätimen oheislaite, LED PWM -ohjain, yleinen DMA-ohjain, TWAI® säädin (yhteensopiva ISO 11898-1:n kanssa), lämpötila-anturi, SAR ADC Integroitu kristalli 40 MHz kristalli Käyttö voltage/virtalähde 3.0 V ~ 3.6 V Käyttövirta Keskimääräinen: 80 mA Virran toimittama vähimmäisvirta toimittaa
500 mA Ympäristön lämpötila –40 °C ~ +105 °C Kosteusherkkyystaso (MSL) Taso 3 - Pin Kuvaus
Kuva 1: Pin-asettelu (ylä View)
Moduulissa on 53 nastaa. Katso nastan määritelmät taulukosta 2.
Katso oheislaitteiden pin-kokoonpanot ESP32-C3-perheen tietosivusta.
Taulukko 2: Pin-määritykset
Nimi Ei. Tyyppi Toiminto GND 1, 2, 11, 14, 36-53 P Maadoitus 3V3 3 P Virtalähde 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
Korkea: päällä, ottaa sirun käyttöön. Low: pois päältä, siru sammuu. Huomautus: Älä jätä EN-nastaa kellumaan.
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
Aloita ESP32C3MINI1
Mitä tarvitset
Sovellusten kehittämiseen ESP32-C3-MINI-1-moduulille tarvitset:
- 1 x ESP32-C3-MINI-1 moduuli
- 1 x Espressif RF -testauslevy
- 1 x USB-sarjakortti
- 1 x mikro-USB-kaapeli
- 1 x PC Linuxilla
Tässä käyttöoppaassa otamme Linux-käyttöjärjestelmän esimerkkinäample. Lisätietoja Windowsin ja macOS:n määrityksistä on ESP-IDF-ohjelmointioppaassa.
Laitteistoyhteys
- Juota ESP32-C3-MINI-1-moduuli RF-testauslevyyn kuvan 2 mukaisesti.
- Liitä RF-testauskortti USB-sarjakorttiin TXD-, RXD- ja GND-liitäntöjen kautta.
- Liitä USB-sarjakortti tietokoneeseen.
- Kytke RF-testauskortti PC:hen tai virtasovittimeen 5 V:n virransyöttöä varten Micro-USB-kaapelilla.
- Yhdistä latauksen aikana IO0 GND:hen jumpperin kautta. Kytke sitten testitaulu ”ON”.
- Lataa laiteohjelmisto flashiin. Katso lisätietoja alla olevista osioista.
- Lataamisen jälkeen irrota hyppyjohdin IO0:stä ja GND:stä.
- Käynnistä RF-testauskortti uudelleen. ESP32-C3-MINI-1 siirtyy työtilaan. Siru lukee ohjelmat flashistä alustuksen yhteydessä.
Huom
IO0 on sisäisesti logiikka korkea. Jos IO0 on asetettu pull-up-tilaan, käynnistystila valitaan. Jos tämä tappi vedetään alas tai jätetään kellumaan,
Lataustila on valittu. Jos haluat lisätietoja ESP32-C3 MINI-1:stä, katso ESP32-C3-MINI-1 Datasheet.
Määritä kehitysympäristö
Espressif IoT Development Framework (lyhyesti ESP-IDF) on viitekehys Espressif-siruihin perustuvien sovellusten kehittämiseen. Käyttäjät voivat kehittää sovelluksia ESP-siruilla Windows/Linux/macOS ESP-IDF-pohjaisesti. Tässä otamme Linux-käyttöjärjestelmän entisenäample.
- Asenna edellytykset
Kääntääksesi ESP-IDF:n kanssa sinun on hankittava seuraavat paketit:- Cent OS 7:
1 sudo yum asennus git wget flex bison gperf python cmake ninja-build ccache dfuutil - Ubuntu ja Debian (yksi komento jakautuu kahdelle riville):
- sudo apt-get asennus git wget flex bison gperf python python-pip pythonsetuptools cmake
- ninja-build ccache libffi-dev libssl-dev dfu-util
- Kaari:
- 1 sudo pacman -S –eded gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
Huom - Tämä opas käyttää hakemistoa ~/esp Linuxissa ESP-IDF:n asennuskansiona.
- Muista, että ESP-IDF ei tue välilyöntejä poluissa.
- 1 sudo pacman -S –eded gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
- Cent OS 7:
- Hanki ESPIDF
ESP32-C3-MINI-1-moduulin sovellusten rakentamiseen tarvitaan Espressifin ESP-IDF-varastossa toimittamat ohjelmistokirjastot.
Saadaksesi ESP-IDF, luo asennushakemisto (~/esp), josta voit ladata ESP-IDF:n ja kloonata arkisto 'git clone':lla:- mkdir -p ~/esp
- cd ~/esp
- git-klooni – rekursiivinen https://github.com/espressif/esp-idf.git
ESP-IDF ladataan kansioon ~/esp/esp-idf. Katso ESP-IDF-versioista tietoa siitä, mitä ESP-IDF-versiota tietyssä tilanteessa käytetään.
- Määritä työkalut
ESP-IDF:n lisäksi sinun on asennettava myös ESP-IDF:n käyttämät työkalut, kuten kääntäjä, debuggeri, Python-paketit jne. ESP-IDF tarjoaa skriptin nimeltä "install.sh" työkalujen määrittämiseksi. yhdellä kertaa.- cd ~/esp/esp-idf
- /install.sh
- Määritä ympäristömuuttujat
Asennettuja työkaluja ei ole vielä lisätty PATH-ympäristömuuttujaan. Jotta työkalut olisivat käyttökelpoisia komentoriviltä, on asetettava joitain ympäristömuuttujia. ESP-IDF tarjoaa toisen komentosarjan "export.sh", joka tekee sen. Suorita terminaalissa, jossa aiot käyttää ESP-IDF:ää:- $HOME/esp/esp-idf/export.sh
Nyt kaikki on valmis, voit rakentaa ensimmäisen projektisi ESP32-C3 MINI-1 -moduulille.
- $HOME/esp/esp-idf/export.sh
Luo ensimmäinen projektisi
- Aloita projekti
Nyt olet valmis valmistelemaan hakemuksesi ESP32-C3-MINI-1-moduulia varten. Voit aloittaa get-started/hello_world-projektilla examples-hakemisto ESP-IDF:ssä.
Kopioi get-started/hello_world ~/esp-hakemistoon:- cd ~/esp
- cp -r $IDF_PATH/esimamples/get-started/hello_world .
Siellä on valikoima example projekteja examples-hakemisto ESP-IDF:ssä. Voit kopioida minkä tahansa projektin yllä esitetyllä tavalla ja suorittaa sen. On myös mahdollista rakentaa mmamples paikoillaan kopioimatta niitä ensin.
Siellä on valikoima example projekteja examples-hakemisto ESP IDF:ssä. Voit kopioida minkä tahansa projektin yllä esitetyllä tavalla ja suorittaa sen. On myös mahdollista rakentaa mmamples paikoillaan kopioimatta niitä ensin.
- Liitä laite
Liitä nyt ESP32-C3-MINI-1 moduuli tietokoneeseen ja tarkista missä sarjaportissa moduuli näkyy. Linuxin sarjaporttien nimet alkavat '/dev/tty'. Suorita alla oleva komento kaksi kertaa, ensin komennolla
kortti irrotettuna, sitten kytkettynä. Portti, joka tulee näkyviin toisen kerran, on se, jota tarvitset:- ls /dev/tty*
Huom
Pidä portin nimi käden ulottuvilla, sillä tarvitset sitä seuraavissa vaiheissa.
- ls /dev/tty*
- Määritä
Siirry 'hello_world'-hakemistoosi vaiheesta 2.4.1. Aloita projekti, aseta ESP32-C3 kohteeksi ja suorita projektin määritysapuohjelma "menuconfig".- cd ~/esp/hello_world
- idf.py set-target esp32c3
- idf.py valikkokonfig
Kohteen asettaminen komennolla 'idf.py set-target esp32c3' tulee tehdä kerran uuden projektin avaamisen jälkeen. Jos projekti sisältää olemassa olevia koontiversioita ja määrityksiä, ne tyhjennetään ja alustetaan. Kohde voidaan tallentaa ympäristömuuttujaan tämän vaiheen ohittamiseksi. Lisätietoja on kohdassa Kohteen valitseminen.
Jos edelliset vaiheet on tehty oikein, seuraava valikko tulee näkyviin:
Kuva 3: Projektin konfiguroinnin aloitusikkuna
Valikon värit voivat olla erilaisia terminaalissasi. Voit muuttaa ulkoasua vaihtoehdolla '–style'. Suorita 'idf.py menuconfig –help' saadaksesi lisätietoja
- Rakenna projekti
Rakenna projekti ajamalla:- idf.py b
Tämä komento kääntää sovelluksen ja kaikki ESP-IDF-komponentit ja luo sitten käynnistyslataimen, osiotaulukon ja sovellusbinaarit.- $ idf.py build
- Suoritetaan cmake hakemistossa /polku/hello_world/build
- Suoritetaan ”cmake -G Ninja –warn-unitialized /path/to/hello_world”…
- Varoita alustamattomista arvoista.
- — Löytyi Git: /usr/bin/git (löytyi versio ”2.17.0”)
- — Tyhjän aws_iot-komponentin rakentaminen määrityksen vuoksi
- — Komponenttien nimet: …
- — Komponenttipolut:…
- … (lisää riviä rakentaa järjestelmä ulos
- [527/527] Luodaan hello-world.bin
- esptool.py v2.3.1
- Projektin rakentaminen valmis. Flashia varten suorita tämä komento:
- ../../../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
- tai suorita "idf.py -p PORT flash"
Jos virheitä ei ole, koontiversio päättyy luomalla laiteohjelmiston binaaritiedosto .bin file.
- idf.py b
- Flash laitteeseen
Päivitä ESP32-C3-MINI-1-moduuliin juuri rakentamasi binaarit suorittamalla:- idf.py -p PORT [-b BAUD] salama
Korvaa PORT moduulisi sarjaportin nimellä kohdassa Vaihe: Liitä laite.
Voit myös muuttaa flasherin siirtonopeutta korvaamalla BAUD tarvitsemallasi tiedonsiirtonopeudella. Oletussiirtonopeus on 460800.
Lisätietoja idf.py-argumenteista on osoitteessa idf.py.
- idf.py -p PORT [-b BAUD] salama
Huom
Vaihtoehto "flash" rakentaa ja vilkkuu projektin automaattisesti, joten "idf.py build" -ohjelman suorittaminen ei ole välttämätöntä.
- …
- esptool.py –siru 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 osio0otboload0.biner0/partition10000-table_xer. -world.bin
- esptool.py v3.0
- Sarjaportti /dev/ttyUSB0
- Yhdistetään….
- Siru on ESP32-C3
- Ominaisuudet: Wi-Fi
- Crystal on 40 MHz
- MAC: 7c:df:a1:40:02:a4
- Ladataan tynkä…
- Juoksu tynkä…
- Stub käynnissä…
- Siirretään tiedonsiirtonopeudeksi 460800
- Muutettu.
- Määritetään salaman kokoa…
- Pakattu 3072 tavua 103…
- Kirjoitetaan 0x00008000… (100 %)
- Kirjoitti 3072 tavua (103 pakattuna) nopeudella 0x00008000 0.0 sekunnissa (tehollinen 4238.1 kbit/s)…
- Tietojen hajautus varmistettu.
- Pakattu 18960 tavua 11311…
- Kirjoitetaan 0x00000000… (100 %)
- Kirjoitti 18960 tavua (11311 pakattuna) nopeudella 0x00000000 0.3 sekunnissa (tehollinen 584.9 kbit/s)…
- Tietojen hajautus varmistettu.
- Pakattu 145520 tavua 71984…
- Kirjoitetaan 0x00010000… (20 %)
- Kirjoitetaan 0x00014000… (40 %)
- Kirjoitetaan 0x00018000… (60 %)
- Kirjoitetaan 0x0001c000… (80 %)
- Kirjoitetaan 0x00020000… (100 %)
- Kirjoitti 145520 tavua (71984 pakattuna) nopeudella 0x00010000 2.3 sekunnissa (tehollinen 504.4 kbit/s)…
- Tietojen hajautus varmistettu.
- Poistutaan…
- Kova nollaus RTS-pinnillä…
- Tehty
Jos kaikki menee hyvin, "hello_world" -sovellus alkaa toimia, kun irrotat IO0:n ja GND:n hyppyjohtimen ja käynnistät testauslevyn uudelleen.
Monitor
Tarkistaaksesi, onko "hello_world" todella käynnissä, kirjoittamalla "idf.py -p PORT monitor" (älä unohda korvata PORT sarjaportin nimellä).
Tämä komento käynnistää IDF Monitor -sovelluksen:
- $ idf.py -p /dev/ttyUSB0-näyttö
- Suoritetaan idf_monitor hakemistossa […]/esp/hello_world/build
- Suoritetaan ”python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_world/build /hello-world.elf”…
- — idf_monitor /dev/ttyUSB0 115200 —
- — Lopeta: Ctrl+] | Valikko: Ctrl+T | Ohje: Ctrl+T ja sitten Ctrl+H —
- ets 8. kesäkuuta 2016 00:22:57
- rst:0x1 (POWERON_RESET),käynnistys:0x13 (SPI_FAST_FLASH_BOOT)
- ets 8. kesäkuuta 2016 00:22:57
- …
Kun käynnistys- ja diagnostiikkalokit vieritetään ylöspäin, sinun pitäisi nähdä "Hei maailma!" tulostetaan sovelluksella.
- …
- Hei maailma!
- Käynnistetään uudelleen 10 sekunnin kuluttua…
- Tämä on esp32c3-siru, jossa on 1 CPU-ydin, WiFi/BLE, 4 Mt ulkoinen salama
- Käynnistetään uudelleen 9 sekunnin kuluttua…
- Käynnistetään uudelleen 8 sekunnin kuluttua…
- Käynnistetään uudelleen 7 sekunnin kuluttua…
IDF-näytöstä poistutaan pikanäppäimellä Ctrl+].
Siinä on kaikki mitä tarvitset päästäksesi alkuun ESP32-C3-MINI-1-moduulin kanssa! Nyt olet valmis kokeilemaan muita exiäamples ESP-IDF:ssä tai mene suoraan kehittämään omia sovelluksiasi.
Oppimisresurssit
- Pakolliset asiakirjat
Ole hyvä ja tutustu seuraaviin asiakirjoihin: - ESP32-C3-perheen tietolehti
Tämä on johdanto ESP32-C3-laitteiston spesifikaatioihin, mukaan lukien yliview, pin määritelmät,
toiminnallinen kuvaus, oheisliitäntä, sähköiset ominaisuudet jne. - ESP-IDF ohjelmointiopas
Laaja dokumentaatio ESP-IDF-kehityskehykselle aina laitteisto-oppaista API:hen
viite. - ESP32-C3 tekninen viiteopas
Yksityiskohtaiset tiedot ESP32-C3-muistin ja oheislaitteiden käytöstä. - Espressif-tuotteiden tilaustiedot
Tärkeät resurssit
Tässä on tärkeitä ESP32-C3:een liittyviä resursseja.
- ESP32 BBS
Engineer-to-Engineer (E2E) -yhteisö Espressif-tuotteille, jossa voit lähettää kysymyksiä, jakaa tietoa, tutkia ideoita ja auttaa ratkaisemaan ongelmia muiden insinöörien kanssa.
Versiohistoria
Päivämäärä |
Versio | Julkaisutiedot |
2021-02-01 | V0.1 |
Alustava julkaisu |
Vastuuvapauslauseke ja tekijänoikeusilmoitus
Tämän asiakirjan tiedot, mukaan lukien URL viitteitä, voidaan muuttaa ilman erillistä ilmoitusta.
KAIKKI TÄSSÄ ASIAKIRJASSA SISÄLTÄVÄT KOLMANSIEN OSAPUOLEN TIEDOT TOIMITETAAN SELLAISENAAN ILMAN MITÄÄN TAKUITA NIIDEN AITOMUUDELLE JA TARKKUKSELLE. TÄLLÄ ASIAKIRJALLA EI ANNETA MITÄÄN TAKUUTA SEN KAUPPAKELPOISUUDESTA, LOUKKAUKSESTA, SOVELTUVUUDESTA MINKÄÄN TIETTYYN TARKOITUKSEEN EIKÄ MITÄÄN EHDOTUKSESTA, TIEDOTUKSESTA TAI JOHDANTOISTA TAKUITA EI MUUTEN.AMPLE.
Kaikki vastuu, mukaan lukien vastuu mahdollisten omistusoikeuksien loukkauksista, liittyen tämän asiakirjan tietojen käyttöön, on irtisanoutunut. Tässä ei myönnetä minkäänlaisia immateriaalioikeuksia koskevia nimenomaisia tai epäsuoria lisenssejä, estoppel tai muutoin.
Wi-Fi Alliance Member -logo on Wi-Fi Alliancen tavaramerkki. Bluetooth-logo on Bluetooth SIG:n rekisteröity tavaramerkki.
Kaikki tässä asiakirjassa mainitut kauppanimet, tavaramerkit ja rekisteröidyt tavaramerkit ovat omistajiensa omaisuutta, ja ne tunnustetaan.
Copyright © 2021 Espressif Systems (Shanghai) Co., Ltd. Kaikki oikeudet pidätetään.
Asiakirjat / Resurssit
![]() |
ESPRESSIF ESP32-C3-MINI-1 Wi-Fi- ja Bluetooth esineiden internet -moduuli [pdfKäyttöopas ESPC3MINI1, 2AC7Z-ESPC3MINI1, 2AC7ZESPC3MINI1, ESP32 -C3 -MINI- 1 Wi-Fi- ja Bluetooth esineiden internet -moduuli, Wi-Fi- ja Bluetooth esineiden internet -moduuli, esineiden internet -moduuli |