ESPRESSIF ESP32-C3-MINI-1 Wi-Fi og Bluetooth Internet of Things Modul Brugervejledning
Om dette dokument
Denne brugervejledning viser, hvordan du kommer i gang med ESP32-C3-MINI-1 modulet.
Dokumentopdateringer
Se venligst altid den seneste version på https://www.espressif.com/en/support/download/documents.
Revisionshistorie
For revisionshistorik for dette dokument henvises til sidste side.
Meddelelse om ændring af dokumentation
Espressif giver e-mail-meddelelser for at holde dig opdateret om ændringer i teknisk dokumentation. Tilmeld dig venligst på www.espressif.com/en/subscribe.
Certificering
Download certifikater til Espressif-produkter fra www.espressif.com/en/certifikater
Overview
- Modul overview
ESP32-C3-MINI-1 er et generel Wi-Fi- og Bluetooth LE-modul. Det rige sæt af periferiudstyr og en lille størrelse gør dette modul til et ideelt valg til smarte hjem, industriel automation, sundhedspleje, forbrugerelektronik osv.
Tabel 1: Specifikationer for ESP32C3MINI1
Kategorier Parametre Specifikationer Wi-Fi Protokoller 802.11 b/g/n (op til 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 Hardware
Modulgrænseflader GPIO, SPI, UART, I2C, I2S, fjernbetjeningsudstyr, LED PWM-controller, generel DMA-controller, TWAI® controller (kompatibel med ISO 11898-1), temperatursensor, SAR ADC Integreret krystal 40 MHz krystal Operation voltage/Strømforsyning 3.0 V ~ 3.6 V Driftsstrøm Gennemsnit: 80 mA Minimum strøm leveret af strøm levere
500 mA Omgivelsestemperatur –40 °C ~ +105 °C Fugtfølsomhedsniveau (MSL) Niveau 3 - Pin Beskrivelse
Figur 1: Pin-layout (øverst View)
Modulet har 53 ben. Se pindefinitioner i tabel 2.
Se venligst ESP32-C3 Family Datasheet for konfigurationer af perifere ben.
Tabel 2: Pin-definitioner
Navn Ingen. Type Fungere GND 1, 2, 11, 14, 36-53 P Jord 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øj: tændt, aktiverer chippen. Lav: slukket, chippen slukker. Bemærk: Efterlad ikke EN-stiften flydende.
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 godt i gang med ESP32C3MINI1
Hvad du har brug for
For at udvikle applikationer til ESP32-C3-MINI-1-modulet har du brug for:
- 1 x ESP32-C3-MINI-1 modul
- 1 x Espressif RF testplade
- 1 x USB-til-seriel kort
- 1 x Micro-USB-kabel
- 1 x PC, der kører Linux
I denne brugervejledning tager vi Linux-operativsystemet som et example. For mere information om konfigurationen på Windows og macOS, se venligst ESP-IDF Programmeringsvejledning.
Hardwareforbindelse
- Lod ESP32-C3-MINI-1-modulet til RF-testkortet som vist i figur 2.
- Tilslut RF-testkortet til USB-til-seriekortet via TXD, RXD og GND.
- Tilslut USB-til-seriekortet til pc'en.
- Tilslut RF-testkortet til pc'en eller en strømadapter for at aktivere 5 V strømforsyning via mikro-USB-kablet.
- Under download skal du forbinde IO0 til GND via en jumper. Tænd derefter for testpladen.
- Download firmware til flash. For detaljer, se afsnittene nedenfor.
- Efter download skal du fjerne jumperen på IO0 og GND.
- Tænd for RF-testkortet igen. ESP32-C3-MINI-1 skifter til arbejdstilstand. Chippen vil læse programmer fra flash ved initialisering.
Note
IO0 er internt logisk høj. Hvis IO0 er indstillet til pull-up, vælges Boot-tilstand. Hvis denne stift trækkes ned eller efterlades svævende, vil den
Downloadtilstand er valgt. For mere information om ESP32-C3 MINI-1, se venligst ESP32-C3-MINI-1 datablad.
Opsæt udviklingsmiljø
Espressif IoT Development Framework (forkortet ESP-IDF) er en ramme til udvikling af applikationer baseret på Espressif-chips. Brugere kan udvikle applikationer med ESP-chips i Windows/Linux/macOS baseret på ESP-IDF. Her tager vi Linux styresystem som en example.
- Installer forudsætninger
For at kompilere med ESP-IDF skal du have følgende pakker:- CentOS 7:
1 sudo yum installer git wget flex bison gperf python cmake ninja-build ccache dfuutil - Ubuntu og Debian (en kommando opdeles i to linjer):
- sudo apt-get install git wget flex bison gperf python python-pip pythonsetuptools cmake
- ninja-build ccache libffi-dev libssl-dev dfu-util
- Bue:
- 1 sudo pacman -S – nødvendig gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
Note - Denne vejledning bruger mappen ~/esp på Linux som en installationsmappe til ESP-IDF.
- Husk, at ESP-IDF ikke understøtter mellemrum i stier.
- 1 sudo pacman -S – nødvendig gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
- CentOS 7:
- Hent ESPIDF
For at bygge applikationer til ESP32-C3-MINI-1-modulet skal du bruge softwarebibliotekerne fra Espressif i ESP-IDF-lageret.
For at få ESP-IDF skal du oprette en installationsmappe (~/esp) for at downloade ESP-IDF til og klone depotet med 'git clone':- mkdir -p ~/esp
- cd ~/esp
- git klon –rekursiv https://github.com/espressif/esp-idf.git
ESP-IDF vil blive downloadet til ~/esp/esp-idf. Se ESP-IDF-versioner for information om, hvilken ESP-IDF-version der skal bruges i en given situation.
- Konfigurer værktøjer
Bortset fra ESP-IDF, skal du også installere de værktøjer, der bruges af ESP-IDF, såsom compiler, debugger, Python-pakker osv. ESP-IDF giver et script ved navn 'install.sh' for at hjælpe med at opsætte værktøjerne på en gang.- cd ~/esp/esp-idf
- /install.sh
- Konfigurer miljøvariabler
De installerede værktøjer er endnu ikke tilføjet til PATH-miljøvariablen. For at gøre værktøjerne anvendelige fra kommandolinjen, skal nogle miljøvariabler indstilles. ESP-IDF leverer et andet script 'export.sh', som gør det. I terminalen, hvor du skal bruge ESP-IDF, skal du køre:- $HOME/esp/esp-idf/export.sh
Nu er alt klar, du kan bygge dit første projekt på ESP32-C3 MINI-1 modul.
- $HOME/esp/esp-idf/export.sh
Opret dit første projekt
- Start et projekt
Nu er du klar til at forberede din ansøgning til ESP32-C3-MINI-1 modul. Du kan starte med get-started/hello_world-projekt fra examples bibliotek i ESP-IDF.
Kopier get-started/hello_world til ~/esp bibliotek:- cd ~/esp
- cp -r $IDF_PATH/eksamples/get-started/hello_world .
Der er en række example projekter i examples bibliotek i ESP-IDF. Du kan kopiere ethvert projekt på samme måde som vist ovenfor og køre det. Det er også muligt at bygge exampfiler på plads uden at kopiere dem først.
Der er en række example projekter i examples bibliotek i ESP IDF. Du kan kopiere ethvert projekt på samme måde som vist ovenfor og køre det. Det er også muligt at bygge exampfiler på plads uden at kopiere dem først.
- Tilslut din enhed
Tilslut nu dit ESP32-C3-MINI-1 modul til computeren og tjek under hvilken seriel port modulet er synligt. Serielporte i Linux starter med '/dev/tty' i deres navne. Kør kommandoen nedenfor to gange, først med
kort frakoblet, derefter med tilsluttet. Porten, der vises anden gang, er den, du skal bruge:- ls /dev/tty*
Note
Hold portnavnet ved hånden, da du skal bruge det i de næste trin.
- ls /dev/tty*
- Konfigurer
Naviger til din 'hello_world'-mappe fra trin 2.4.1. Start et projekt, indstil ESP32-C3 som målet og kør projektkonfigurationsværktøjet 'menuconfig'.- cd ~/esp/hello_world
- idf.py sæt-mål esp32c3
- idf.py menuconfig
Indstilling af målet med 'idf.py set-target esp32c3' skal udføres én gang efter åbning af et nyt projekt. Hvis projektet indeholder nogle eksisterende builds og konfigurationer, vil de blive ryddet og initialiseret. Målet kan gemmes i miljøvariablen for overhovedet at springe dette trin over. Se Valg af mål for yderligere oplysninger.
Hvis de foregående trin er udført korrekt, vises følgende menu:
Figur 3: Projektkonfiguration Hjem-vindue
Farverne på menuen kan være forskellige i din terminal. Du kan ændre udseendet med muligheden '–stil'. Kør venligst 'idf.py menuconfig –help' for yderligere information
- Byg projektet
Byg projektet ved at køre:- idf.py b
Denne kommando vil kompilere applikationen og alle ESP-IDF-komponenter, og derefter generere bootloader, partitionstabellen og applikationsbinære filer.- $ idf.py build
- Kører cmake i mappen /path/to/hello_world/build
- Udfører ”cmake -G Ninja –warn-uninitialized /path/to/hello_world”...
- Advar om ikke-initialiserede værdier.
- — Fundet Git: /usr/bin/git (fundet version ”2.17.0”)
- — Opbygning af tom aws_iot-komponent på grund af konfiguration
- — Komponentnavne: …
- — Komponentstier: …
- … (flere linjer med byggesystem ude
- [527/527] Generering af hello-world.bin
- esptool.py v2.3.1
- Projektopbygning færdig. For at blinke, kør denne kommando:
- ../../../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 kør 'idf.py -p PORT flash'
Hvis der ikke er nogen fejl, afsluttes buildet ved at generere firmwaren binær .bin file.
- idf.py b
- Flash på enheden
Flash de binære filer, som du lige har bygget på dit ESP32-C3-MINI-1-modul ved at køre:- idf.py -p PORT [-b BAUD] flash
Udskift PORT med dit moduls serielle portnavn fra Trin: Tilslut din enhed.
Du kan også ændre flasherens baudrate ved at erstatte BAUD med den baudrate, du har brug for. Standard baudraten er 460800.
For mere information om idf.py-argumenter, se idf.py.
- idf.py -p PORT [-b BAUD] flash
Note
Indstillingen 'flash' bygger og blinker automatisk projektet, så det er ikke nødvendigt at kø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 bootload-tx0bin. -verden.bin
- esptool.py v3.0
- Seriel port /dev/ttyUSB0
- Tilslutning….
- Chip er ESP32-C3
- Funktioner: Wi-Fi
- Krystal er 40MHz
- MAC: 7c:df:a1:40:02:a4
- Uploader stub...
- Kører stub...
- Stub kører...
- Ændring af baudrate til 460800
- Ændret.
- Konfigurerer flashstørrelse...
- Komprimeret 3072 bytes til 103...
- Skriver til 0x00008000... (100 %)
- Skrev 3072 bytes (103 komprimeret) ved 0x00008000 på 0.0 sekunder (effektiv 4238.1 kbit/s)...
- Hash af data verificeret.
- Komprimeret 18960 bytes til 11311...
- Skriver til 0x00000000... (100 %)
- Skrev 18960 bytes (11311 komprimeret) ved 0x00000000 på 0.3 sekunder (effektiv 584.9 kbit/s)...
- Hash af data verificeret.
- Komprimeret 145520 bytes til 71984...
- Skriver til 0x00010000... (20 %)
- Skriver til 0x00014000... (40 %)
- Skriver til 0x00018000... (60 %)
- Skriver ved 0x0001c000... (80 %)
- Skriver til 0x00020000... (100 %)
- Skrev 145520 bytes (71984 komprimeret) ved 0x00010000 på 2.3 sekunder (effektiv 504.4 kbit/s)...
- Hash af data verificeret.
- Forlader...
- Hård nulstilling via RTS-pin...
- Færdig
Hvis alt går godt, begynder "hello_world"-applikationen at køre, efter at du har fjernet jumperen på IO0 og GND og tændt for testkortet igen.
Overvåge
For at kontrollere, om "hello_world" faktisk kører, skriv 'idf.py -p PORT monitor' (Glem ikke at erstatte PORT med dit serielle portnavn).
Denne kommando starter IDF Monitor-applikationen:
- $ idf.py -p /dev/ttyUSB0 skærm
- Kører idf_monitor i mappen […]/esp/hello_world/build
- Udfører ”python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_world/build /hello-world.elf”...
- — idf_monitor på /dev/ttyUSB0 115200 —
- — Afslut: Ctrl+] | Menu: Ctrl+T | Hjælp: Ctrl+T efterfulgt af 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
- …
Efter opstart og diagnostiske logfiler er rullet op, bør du se "Hej verden!" udskrives af applikationen.
- …
- Hej verden!
- Genstarter om 10 sekunder...
- Dette er esp32c3-chip med 1 CPU-kerne, WiFi/BLE, 4MB ekstern flash
- Genstarter om 9 sekunder...
- Genstarter om 8 sekunder...
- Genstarter om 7 sekunder...
Brug genvejen Ctrl+] for at afslutte IDF-skærmen.
Det er alt, hvad du behøver for at komme i gang med ESP32-C3-MINI-1-modulet! Nu er du klar til at prøve en anden examples i ESP-IDF, eller gå direkte til at udvikle dine egne applikationer.
Læringsressourcer
- Skal læse dokumenter
Gør dig bekendt med følgende dokumenter: - ESP32-C3 familie datablad
Dette er en introduktion til specifikationerne for ESP32-C3 hardware, inklusive overview, pindefinitioner,
funktionsbeskrivelse, perifert interface, elektriske karakteristika mv. - ESP-IDF programmeringsvejledning
Omfattende dokumentation for ESP-IDF udviklingsramme, lige fra hardwareguider til API
reference. - ESP32-C3 teknisk referencemanual
Detaljerede oplysninger om, hvordan du bruger ESP32-C3-hukommelsen og ydre enheder. - Bestillingsoplysninger om espressif-produkter
Vigtige ressourcer
Her er de vigtige ESP32-C3-relaterede ressourcer.
- ESP32 BBS
Engineer-to-Engineer (E2E) Community for Espressif-produkter, hvor du kan stille spørgsmål, dele viden, udforske ideer og hjælpe med at løse problemer med andre ingeniører.
Revisionshistorie
Dato |
Version | Udgivelsesbemærkninger |
2021-02-01 | V0.1 |
Foreløbig udgivelse |
Ansvarsfraskrivelse og meddelelse om ophavsret
Oplysninger i dette dokument, herunder URL referencer, kan ændres uden varsel.
ALLE TREDJEPARTS OPLYSNINGER I DETTE DOKUMENT LEVERES SOM DE ER UDEN GARANTIER FOR DETS ÆGTIGHED OG NØJAGTIGHED. DETTE DOKUMENT LEVERES INGEN GARANTI FOR DETTE SALGBARHED, IKKE-KRÆNKELSE, EGNETHED TIL NOGET BESTEMT FORMÅL, ELLER ER INGEN GARANTI, DER ER ANDET OPSTÅET AF NOGEN FORSLAG, SPECIFIKATION ELLERAMPLE.
Ethvert ansvar, herunder ansvar for krænkelse af enhver ejendomsret, relateret til brugen af oplysningerne i dette dokument fraskrives. Ingen licenser udtrykkeligt eller underforstået, ved estoppel eller på anden måde, til nogen intellektuelle ejendomsrettigheder er givet heri.
Wi-Fi Alliance Member-logoet er et varemærke tilhørende Wi-Fi Alliance. Bluetooth-logoet er et registreret varemærke tilhørende Bluetooth SIG.
Alle handelsnavne, varemærker og registrerede varemærker nævnt i dette dokument tilhører deres respektive ejere og er hermed anerkendt.
Copyright © 2021 Espressif Systems (Shanghai) Co., Ltd. Alle rettigheder forbeholdes.
Dokumenter/ressourcer
![]() |
ESPRESSIF ESP32-C3-MINI-1 Wi-Fi og Bluetooth Internet of Things-modul [pdfBrugermanual 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 |