ESPRESSIF ESP32-C3-MINI-1 Wi-Fi og Bluetooth Internet of Things Module Brukerhåndbok
Om dette dokumentet
Denne brukerveiledningen viser hvordan du kommer i gang med ESP32-C3-MINI-1-modulen.
Dokumentoppdateringer
Vennligst referer alltid til den nyeste versjonen på https://www.espressif.com/en/support/download/documents.
Revisjonshistorie
For revisjonshistorikk for dette dokumentet, se siste side.
Melding om endring av dokumentasjon
Espressif gir e-postvarsler for å holde deg oppdatert på endringer i teknisk dokumentasjon. Vennligst abonner på www.espressif.com/en/subscribe.
Sertifisering
Last ned sertifikater for Espressif-produkter fra www.espressif.com/en/certificates
Overview
- Modul overview
ESP32-C3-MINI-1 er en generell Wi-Fi- og Bluetooth LE-modul. Det rike settet med periferiutstyr og en liten størrelse gjør denne modulen til et ideelt valg for smarte hjem, industriell automasjon, helsevesen, forbrukerelektronikk, etc.
Tabell 1: ESP32C3MINI1-spesifikasjoner
Kategorier Parametere Spesifikasjoner Wi-Fi Protokoller 802.11 b/g/n (opptil 150 Mbps) Frekvensområde 2412 ~ 2462 MHz Bluetooth® Protokoller Bluetooth® LE: Bluetooth 5 og Bluetooth mesh Radio Klasse-1, klasse-2 og klasse-3 sender Maskinvare
Modulgrensesnitt GPIO, SPI, UART, I2C, I2S, eksternt fjernkontrollutstyr, LED PWM-kontroller, generell DMA-kontroller, TWAI® kontroller (kompatibel med ISO 11898-1), temperatursensor, SAR ADC Integrert krystall 40 MHz krystall Drift voltage/Strømforsyning 3.0 V ~ 3.6 V Driftsstrøm Gjennomsnitt: 80 mA Minimum strøm levert av kraft levere
500 mA Omgivelsestemperatur –40 °C ~ +105 °C Fuktighetsfølsomhetsnivå (MSL) Nivå 3 - Pin Beskrivelse
Figur 1: Pinnelayout (øverst View)
Modulen har 53 pinner. Se pinnedefinisjoner i tabell 2.
For konfigurasjoner av perifere pinner, se ESP32-C3 Family Datasheet.
Tabell 2: Pin-definisjoner
Navn Ingen. Type Funksjon GND 1, 2, 11, 14, 36-53 P Bakke 3V3 3 P Strømforsyning 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
Høy: på, aktiverer brikken. Lav: av, brikken slås av. Merk: Ikke la EN-pinnen flyte.
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
Kom i gang med ESP32C3MINI1
Hva du trenger
For å utvikle applikasjoner for ESP32-C3-MINI-1-modulen trenger du:
- 1 x ESP32-C3-MINI-1 modul
- 1 x Espressif RF testbrett
- 1 x USB-til-seriekort
- 1 x Micro-USB-kabel
- 1 x PC som kjører Linux
I denne brukerveiledningen tar vi Linux-operativsystemet som et eksample. For mer informasjon om konfigurasjonen på Windows og macOS, se ESP-IDF Programmeringsveiledning.
Maskinvaretilkobling
- Lodd ESP32-C3-MINI-1-modulen til RF-testkortet som vist i figur 2.
- Koble RF-testkortet til USB-til-seriekortet via TXD, RXD og GND.
- Koble USB-til-seriekortet til PC-en.
- Koble RF-testkortet til PC-en eller en strømadapter for å aktivere 5 V strømforsyning, via Micro-USB-kabelen.
- Under nedlasting, koble IO0 til GND via en jumper. Slå deretter "PÅ" testbrettet.
- Last ned firmware til flash. For detaljer, se avsnittene nedenfor.
- Etter nedlasting fjerner du jumperen på IO0 og GND.
- Slå på RF-testbrettet igjen. ESP32-C3-MINI-1 vil bytte til arbeidsmodus. Brikken vil lese programmer fra flash ved initialisering.
Note
IO0 er internt logisk høy. Hvis IO0 er satt til pull-up, velges Boot-modus. Hvis denne pinnen er nedtrekkbar eller venstresvevende, vil den
Nedlastingsmodus er valgt. For mer informasjon om ESP32-C3 MINI-1, se ESP32-C3-MINI-1 datablad.
Sett opp utviklingsmiljø
Espressif IoT Development Framework (ESP-IDF forkortet) er et rammeverk for utvikling av applikasjoner basert på Espressif-brikkene. Brukere kan utvikle applikasjoner med ESP-brikker i Windows/Linux/macOS basert på ESP-IDF. Her tar vi Linux operativsystem som eksample.
- Installer Forutsetninger
For å kompilere med ESP-IDF må du få følgende pakker:- Cent OS 7:
1 sudo yum installer git wget flex bison gperf python cmake ninja-build ccache dfuutil - Ubuntu og Debian (en kommando deler seg i to linjer):
- sudo apt-get install git wget flex bison gperf python python-pip pythonsetuptools cmake
- ninja-bygg ccache libffi-dev libssl-dev dfu-util
- Bue:
- 1 sudo pacman -S –needed gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
Note - Denne veiledningen bruker katalogen ~/esp på Linux som en installasjonsmappe for ESP-IDF.
- Husk at ESP-IDF ikke støtter mellomrom i baner.
- 1 sudo pacman -S –needed gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
- Cent OS 7:
- Skaff deg ESPIDF
For å bygge applikasjoner for ESP32-C3-MINI-1-modulen, trenger du programvarebibliotekene levert av Espressif i ESP-IDF-depotet.
For å få ESP-IDF, lag en installasjonskatalog (~/esp) for å laste ned ESP-IDF til og klone depotet med 'git clone':- mkdir -p ~/esp
- cd ~/esp
- git klone –rekursiv https://github.com/espressif/esp-idf.git
ESP-IDF vil bli lastet ned til ~/esp/esp-idf. Se ESP-IDF-versjoner for informasjon om hvilken ESP-IDF-versjon som skal brukes i en gitt situasjon.
- Sett opp Verktøy
Bortsett fra ESP-IDF, må du også installere verktøyene som brukes av ESP-IDF, for eksempel kompilatoren, debuggeren, Python-pakkene osv. ESP-IDF gir et skript kalt 'install.sh' for å hjelpe med å sette opp verktøyene på en gang.- cd ~/esp/esp-idf
- /install.sh
- Sett opp miljøvariabler
De installerte verktøyene er ennå ikke lagt til PATH-miljøvariabelen. For å gjøre verktøyene brukbare fra kommandolinjen, må noen miljøvariabler angis. ESP-IDF gir et annet skript 'export.sh' som gjør det. I terminalen der du skal bruke ESP-IDF, kjør:- $HOME/esp/esp-idf/export.sh
Nå er alt klart, du kan bygge ditt første prosjekt på ESP32-C3 MINI-1-modulen.
- $HOME/esp/esp-idf/export.sh
Lag ditt første prosjekt
- Start et prosjekt
Nå er du klar til å forberede søknaden din for ESP32-C3-MINI-1-modulen. Du kan starte med get-started/hello_world-prosjektet fra examples-katalogen i ESP-IDF.
Kopier get-started/hello_world til ~/esp-katalogen:- cd ~/esp
- cp -r $IDF_PATH/eksamples/get-started/hello_world .
Det finnes en rekke eksample prosjekter i eksamples-katalogen i ESP-IDF. Du kan kopiere ethvert prosjekt på samme måte som presentert ovenfor og kjøre det. Det er også mulig å bygge eksamples på plass, uten å kopiere dem først.
Det finnes en rekke eksample prosjekter i eksamples-katalog i ESP IDF. Du kan kopiere ethvert prosjekt på samme måte som presentert ovenfor og kjøre det. Det er også mulig å bygge eksamples på plass, uten å kopiere dem først.
- Koble enheten din
Koble nå ESP32-C3-MINI-1-modulen til datamaskinen og sjekk under hvilken seriell port modulen er synlig. Serielle porter i Linux starter med '/dev/tty' i navnene deres. Kjør kommandoen nedenfor to ganger, først med
kortet frakoblet, deretter med plugget inn. Porten som vises andre gang er den du trenger:- ls /dev/tty*
Note
Hold portnavnet lett tilgjengelig ettersom du trenger det i de neste trinnene.
- ls /dev/tty*
- Konfigurer
Naviger til 'hello_world'-katalogen din fra trinn 2.4.1. Start et prosjekt, sett ESP32-C3 som målet og kjør prosjektkonfigurasjonsverktøyet 'menuconfig'.- cd ~/esp/hello_world
- idf.py set-target esp32c3
- idf.py menykonfigurasjon
Å sette målet med 'idf.py set-target esp32c3' bør gjøres én gang, etter å ha åpnet et nytt prosjekt. Hvis prosjektet inneholder noen eksisterende bygg og konfigurasjoner, vil de bli slettet og initialisert. Målet kan lagres i miljøvariabelen for å hoppe over dette trinnet i det hele tatt. Se Velge mål for mer informasjon.
Hvis de forrige trinnene er utført riktig, vises følgende meny:
Figur 3: Hjemmevindu for prosjektkonfigurasjon
Fargene på menyen kan være forskjellige i terminalen din. Du kan endre utseendet med alternativet '–stil'. Vennligst kjør 'idf.py menuconfig –help' for mer informasjon
- Bygg prosjektet
Bygg prosjektet ved å kjøre:- idf.py b
Denne kommandoen vil kompilere applikasjonen og alle ESP-IDF-komponenter, og deretter generere bootloader, partisjonstabell og applikasjonsbinære filer.- $ idf.py build
- Kjører cmake i katalogen /path/to/hello_world/build
- Utfører «cmake -G Ninja –warn-uninitialized /path/to/hello_world»...
- Advar om uinitialiserte verdier.
- — Funnet Git: /usr/bin/git (funnet versjon ”2.17.0”)
- — Bygging av tom aws_iot-komponent på grunn av konfigurasjon
- — Komponentnavn: …
- — Komponentbaner: …
- … (flere linjer med byggesystem ute
- [527/527] Genererer hello-world.bin
- esptool.py v2.3.1
- Prosjektbygging ferdig. For å blinke, kjør denne kommandoen:
- ../../../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
- eller kjør 'idf.py -p PORT flash'
Hvis det ikke er noen feil, vil byggingen fullføres ved å generere den binære fastvaren .bin file.
- idf.py b
- Flash på enheten
Flash binærfilene du nettopp bygde på ESP32-C3-MINI-1-modulen ved å kjøre:- idf.py -p PORT [-b BAUD] blink
Erstatt PORT med modulens serieportnavn fra trinn: Koble til enheten.
Du kan også endre overføringshastigheten for flasher ved å erstatte BAUD med overføringshastigheten du trenger. Standard overføringshastighet er 460800.
For mer informasjon om idf.py-argumenter, se idf.py.
- idf.py -p PORT [-b BAUD] blink
Note
Alternativet "flash" bygger og blinker prosjektet automatisk, så det er ikke nødvendig å kjøre "idf.py build".
- …
- 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/partition_x0bin oppstarts-tx0-0 oppstartbar partisjon-tx10000. -verden.bin
- esptool.py v3.0
- Seriell port /dev/ttyUSB0
- Kobler til….
- Brikken er ESP32-C3
- Funksjoner: Wi-Fi
- Krystall er 40MHz
- MAC: 7c:df:a1:40:02:a4
- Laster opp stubb …
- Kjører stubb...
- Stubb kjører...
- Endring av overføringshastighet til 460800
- Endret.
- Konfigurerer blitsstørrelse …
- Komprimert 3072 byte til 103...
- Skriver på 0x00008000... (100 %)
- Skrev 3072 byte (103 komprimert) på 0x00008000 på 0.0 sekunder (effektiv 4238.1 kbit/s)...
- Hash av data bekreftet.
- Komprimert 18960 byte til 11311...
- Skriver på 0x00000000... (100 %)
- Skrev 18960 byte (11311 komprimert) på 0x00000000 på 0.3 sekunder (effektiv 584.9 kbit/s)...
- Hash av data bekreftet.
- Komprimert 145520 byte til 71984...
- Skriver på 0x00010000... (20 %)
- Skriver på 0x00014000... (40 %)
- Skriver på 0x00018000... (60 %)
- Skriver på 0x0001c000... (80 %)
- Skriver på 0x00020000... (100 %)
- Skrev 145520 byte (71984 komprimert) på 0x00010000 på 2.3 sekunder (effektiv 504.4 kbit/s)...
- Hash av data bekreftet.
- Forlater …
- Hard tilbakestilling via RTS-pin...
- Ferdig
Hvis alt går bra, begynner "hello_world"-applikasjonen å kjøre etter at du har fjernet jumperen på IO0 og GND, og slår på testbrettet igjen.
Følge
For å sjekke om "hello_world" faktisk kjører, skriv inn 'idf.py -p PORT monitor' (Ikke glem å erstatte PORT med navnet på den serielle porten).
Denne kommandoen starter IDF Monitor-applikasjonen:
- $ idf.py -p /dev/ttyUSB0-skjerm
- Kjører idf_monitor i katalogen […]/esp/hello_world/build
- Utfører ”python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_world/build /hello-world.elf”...
- — idf_monitor på /dev/ttyUSB0 115200 —
- — Avslutt: Ctrl+] | Meny: Ctrl+T | Hjelp: Ctrl+T etterfulgt av Ctrl+H —
- ets 8. juni 2016 00:22:57
- rst:0x1 (POWERON_RESET), boot:0x13 (SPI_FAST_FLASH_BOOT)
- ets 8. juni 2016 00:22:57
- …
Etter oppstart og diagnoselogger ruller opp, bør du se "Hallo verden!" skrives ut av applikasjonen.
- …
- Hei verden!
- Starter på nytt om 10 sekunder...
- Dette er esp32c3-brikke med 1 CPU-kjerne, WiFi/BLE, 4MB ekstern blits
- Starter på nytt om 9 sekunder...
- Starter på nytt om 8 sekunder...
- Starter på nytt om 7 sekunder...
For å avslutte IDF-skjermen, bruk snarveien Ctrl+].
Det er alt du trenger for å komme i gang med ESP32-C3-MINI-1-modulen! Nå er du klar til å prøve en annen eksamples i ESP-IDF, eller gå rett til å utvikle dine egne applikasjoner.
Læringsressurser
- Må lese dokumenter
Gjør deg kjent med følgende dokumenter: - ESP32-C3 familiedatablad
Dette er en introduksjon til spesifikasjonene til ESP32-C3-maskinvaren, inkludert overview, pin-definisjoner,
funksjonsbeskrivelse, perifert grensesnitt, elektriske egenskaper, etc. - ESP-IDF programmeringsveiledning
Omfattende dokumentasjon for ESP-IDF utviklingsrammeverk, alt fra maskinvareveiledninger til API
henvisning. - ESP32-C3 teknisk referansehåndbok
Detaljert informasjon om hvordan du bruker ESP32-C3-minnet og eksterne enheter. - Bestillingsinformasjon for Espressif-produkter
Viktige ressurser
Her er de viktige ESP32-C3-relaterte ressursene.
- ESP32 BBS
Ingeniør-til-ingeniør (E2E) fellesskap for Espressif-produkter hvor du kan legge ut spørsmål, dele kunnskap, utforske ideer og hjelpe til med å løse problemer med andre ingeniører.
Revisjonshistorie
Dato |
Versjon | Utgivelsesnotater |
2021-02-01 | V0.1 |
Foreløpig utgivelse |
Ansvarsfraskrivelse og opphavsrettserklæring
Informasjon i dette dokumentet, inkludert URL referanser, kan endres uten varsel.
ALL TREDJEPARTS INFORMASJON I DETTE DOKUMENTET LEVERES SOM DEN ER UTEN GARANTIER FOR EKTEHETEN OG NØYAKTIGHETEN. DETTE DOKUMENTET GES INGEN GARANTI FOR SALGBARHET, IKKE-KRENKELSE, EGNETHET FOR NOEN BESTEMT FORMÅL, ELLER GJELDER NOEN GARANTI SOM ER ELLER UTSTYRT AV NOEN FORSLAG, SPESIFIKASJONER ELLERAMPLE.
Alt ansvar, inkludert ansvar for brudd på eventuelle eiendomsrettigheter, knyttet til bruk av informasjon i dette dokumentet fraskrives. Ingen lisenser uttrykt eller underforstått, ved estoppel eller på annen måte, til noen immaterielle rettigheter er gitt her.
Wi-Fi Alliance Member-logoen er et varemerke for Wi-Fi Alliance. Bluetooth-logoen er et registrert varemerke for Bluetooth SIG.
Alle varenavn, varemerker og registrerte varemerker nevnt i dette dokumentet tilhører deres respektive eiere, og er herved anerkjent.
Copyright © 2021 Espressif Systems (Shanghai) Co., Ltd. Alle rettigheter reservert.
Dokumenter / Ressurser
![]() |
ESPRESSIF ESP32-C3-MINI-1 Wi-Fi og Bluetooth Tingenes Internett-modul [pdfBrukerhåndbok ESPC3MINI1, 2AC7Z-ESPC3MINI1, 2AC7ZESPC3MINI1, ESP32 -C3 -MINI- 1 Wi-Fi og Bluetooth Internet of Things-modul, Wi-Fi og Bluetooth Internet of Things-modul, Internet of Things-modul |