ESPRESSIF ESP32-C3-MINI-1 Wi-Fi och Bluetooth Internet of Things Module Användarmanual

ESPRESSIF ESP32-C3-MINI-1 Wi-Fi och Bluetooth Internet of Things Module Användarmanual

Om detta dokument
Denna användarmanual visar hur du kommer igång med ESP32-C3-MINI-1-modulen.

Dokumentuppdateringar
Se alltid den senaste versionen på https://www.espressif.com/en/support/download/documents.

Revisionshistorik
För revisionshistorik för detta dokument, se sista sidan.

Meddelande om ändring av dokumentation
Espressif tillhandahåller e-postmeddelanden för att hålla dig uppdaterad om ändringar i teknisk dokumentation. Vänligen prenumerera på www.espressif.com/en/subscribe.

Certifiering
Ladda ner certifikat för Espressif-produkter från www.espressif.com/en/certifikat

Innehåll dölja

1 Överview

2 Kom igång med ESP32C3MINI1

2.1 Vad du behöver

2.2 Hårdvaruanslutning

2.3 Konfigurera utvecklingsmiljö

2.4 Skapa ditt första projekt

Överview

Modul överview
ESP32-C3-MINI-1 är en allmän Wi-Fi- och Bluetooth LE-modul. Den rika uppsättningen kringutrustning och en liten storlek gör denna modul till ett idealiskt val för smarta hem, industriell automation, hälsovård, hemelektronik, etc.
Tabell 1: Specifikationer för ESP32C3MINI1

Kategorier	Parametrar	Specifikationer
Wi-Fi	Protokoll	802.11 b/g/n (upp till 150 Mbps)
Wi-Fi	Frekvensområde	2412 ~ 2462 MHz
Bluetooth^®	Protokoll	Bluetooth^® LE: Bluetooth 5 och Bluetooth mesh
Bluetooth^®	Radio	Klass-1, klass-2 och klass-3 sändare
Hårdvara	Modulgränssnitt	GPIO, SPI, UART, I2C, I2S, kringutrustning för fjärrkontroll, LED PWM-kontroller, allmän DMA-kontroller, TWAI^® kontroller (kompatibel med ISO 11898-1), temperatursensor, SAR ADC
	Integrerad kristall	40 MHz kristall
	Operation voltage/Strömförsörjning	3.0 V ~ 3.6 V
	Driftström	Medel: 80 mA
	Minsta ström som levereras av kraft förse	500 mA
	Omgivningstemperatur	–40 °C ~ +105 °C
	Fuktkänslighetsnivå (MSL)	Nivå 3

Pin Beskrivning
Figur 1: Stiftlayout (Överst View)

Modulen har 53 stift. Se stiftdefinitioner i Tabell 2.
För perifera stiftkonfigurationer, se ESP32-C3 Family Datasheet .
Tabell 2: Pin-definitioner

Namn	Inga.	Typ	Fungera
GND	1, 2, 11, 14, 36-53	P	Jord
3V3	3	P	Strömförsörjning
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ög: på, aktiverar chipet. Låg: av, chippet stängs av. Obs: Lämna inte EN-stiftet flytande.
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 igång med ESP32C3MINI1

Vad du behöver

För att utveckla applikationer för ESP32-C3-MINI-1-modulen behöver du:

1 x ESP32-C3-MINI-1 modul

1 x Espressif RF testkort
1 x USB-till-seriekort

1 x Micro-USB-kabel
1 x PC som kör Linux

I den här användarhandboken tar vi Linux operativsystem som ett example. För mer information om konfigurationen på Windows och macOS, se ESP-IDF Programmeringsguide.

Hårdvaruanslutning

Löd ESP32-C3-MINI-1-modulen till RF-testkortet som visas i figur 2.

Anslut RF-testkortet till USB-till-seriekortet via TXD, RXD och GND.
Anslut USB-till-seriekortet till datorn.

Anslut RF-testkortet till PC:n eller en strömadapter för att aktivera 5 V strömförsörjning, via Micro-USB-kabeln.
Under nedladdning, anslut IO0 till GND via en bygel. Slå sedan på testbrädan.

Ladda ner firmware till flash. För detaljer, se avsnitten nedan.
Efter nedladdning, ta bort bygeln på IO0 och GND.

Slå på RF-testkortet igen. ESP32-C3-MINI-1 växlar till arbetsläge. Chipet kommer att läsa program från flash vid initiering.
Notera
IO0 är internt logiskt hög. Om IO0 är inställd på pull-up, väljs Boot-läget. Om denna stift är neddragbar eller lämnas flytande,
Nedladdningsläget är valt. För mer information om ESP32-C3 MINI-1, se ESP32-C3-MINI-1 datablad.

Konfigurera utvecklingsmiljö

Espressif IoT Development Framework (förkortat ESP-IDF) är ett ramverk för att utveckla applikationer baserade på Espressif-chips. Användare kan utveckla applikationer med ESP-chips i Windows/Linux/macOS baserat på ESP-IDF. Här tar vi Linux operativsystem som ett example.

Installera förutsättningar
För att kompilera med ESP-IDF behöver du skaffa följande paket:
- Cent OS 7:
  1 sudo yum installera git wget flex bison gperf python cmake ninja-build ccache dfuutil
- Ubuntu och Debian (ett kommando delas upp i två rader):
  1. sudo apt-get install git wget flex bison gperf python python-pip pythonsetuptools cmake
  2. ninja-build ccache libffi-dev libssl-dev dfu-util
- Båge:
  - 1 sudo pacman -S –behövs gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
    Notera
  - Den här guiden använder katalogen ~/esp på Linux som en installationsmapp för ESP-IDF.
  - Tänk på att ESP-IDF inte stöder mellanslag i sökvägar.
Skaffa ESPIDF
För att bygga applikationer för ESP32-C3-MINI-1-modulen behöver du mjukvarubiblioteken som tillhandahålls av Espressif i ESP-IDF-förrådet.
För att få ESP-IDF, skapa en installationskatalog (~/esp) för att ladda ner ESP-IDF till och klona förvaret med 'git clone':
1. mkdir -p ~/esp
2. cd ~/esp
3. git clone –rekursiv https://github.com/espressif/esp-idf.git
  ESP-IDF kommer att laddas ner till ~/esp/esp-idf. Konsultera ESP-IDF Versions för information om vilken ESP-IDF version som ska användas i en given situation.
Konfigurera Verktyg
Förutom ESP-IDF måste du också installera verktygen som används av ESP-IDF, såsom kompilatorn, debuggern, Python-paketen, etc. ESP-IDF tillhandahåller ett skript som heter 'install.sh' för att hjälpa till att ställa in verktygen på en gång.
1. cd ~/esp/esp-idf
2. /install.sh
Ställ in miljövariabler
De installerade verktygen har ännu inte lagts till i miljövariabeln PATH. För att göra verktygen användbara från kommandoraden måste vissa miljövariabler ställas in. ESP-IDF tillhandahåller ett annat skript 'export.sh' som gör det. I terminalen där du ska använda ESP-IDF, kör:
- $HOME/esp/esp-idf/export.sh
  Nu är allt klart, du kan bygga ditt första projekt på ESP32-C3 MINI-1-modulen.

Skapa ditt första projekt

Starta ett projekt
Nu är du redo att förbereda din ansökan för ESP32-C3-MINI-1-modulen. Du kan börja med get-started/hello_world-projektet från examples-katalogen i ESP-IDF.
Kopiera get-started/hello_world till ~/esp-katalogen:
1. cd ~/esp
2. cp -r $IDF_PATH/examples/get-started/hello_world .
  Det finns en rad example projekt i examples-katalogen i ESP-IDF. Du kan kopiera vilket projekt som helst på samma sätt som ovan och köra det. Det går även att bygga exampfiler på plats, utan att kopiera dem först.
  Det finns en rad example projekt i examples-katalogen i ESP IDF. Du kan kopiera vilket projekt som helst på samma sätt som ovan och köra det. Det går även att bygga exampfiler på plats, utan att kopiera dem först.
Anslut din enhet
Anslut nu din ESP32-C3-MINI-1-modul till datorn och kontrollera under vilken serieport modulen är synlig. Seriella portar i Linux börjar med '/dev/tty' i deras namn. Kör kommandot nedan två gånger, först med
kortet urkopplat, sedan med anslutet. Porten som visas andra gången är den du behöver:
- ls /dev/tty*
  Notera
  Håll portnamnet till hands eftersom du behöver det i nästa steg.

Konfigurera
Navigera till din 'hello_world'-katalog från steg 2.4.1. Starta ett projekt, ställ in ESP32-C3 som mål och kör projektkonfigurationsverktyget 'menuconfig'.
1. cd ~/esp/hello_world
2. idf.py set-target esp32c3
3. idf.py menuconfig
  Att ställa in målet med 'idf.py set-target esp32c3' bör göras en gång efter att ett nytt projekt har öppnats. Om projektet innehåller några befintliga builds och konfigurationer kommer de att rensas och initieras. Målet kan sparas i miljövariabeln för att överhuvudtaget hoppa över detta steg. Se Välja mål för ytterligare information.
  Om de föregående stegen har utförts korrekt visas följande meny:
  Figur 3: Projektkonfiguration Hem-fönster
  
  Färgerna på menyn kan vara olika i din terminal. Du kan ändra utseendet med alternativet '–stil'. Kör 'idf.py menuconfig –help' för ytterligare information
Bygg projektet
Bygg projektet genom att köra:
1. idf.py b
  Detta kommando kommer att kompilera applikationen och alla ESP-IDF-komponenter och sedan generera starthanteraren, partitionstabellen och applikationens binära filer.
  1. $ idf.py build
  2. Kör cmake i katalogen /path/to/hello_world/build
  3. Kör ”cmake -G Ninja –warn-uninitialized /path/to/hello_world”...
  4. Varna för oinitierade värden.
  5. — Hittade Git: /usr/bin/git (hittad version ”2.17.0”)
  6. — Bygger tom aws_iot-komponent på grund av konfiguration
  7. — Komponentnamn: …
  8. — Komponentvägar: …
  10. … (fler rader av byggsystem ute
  12. [527/527] Genererar hello-world.bin
  13. eptool.py v2.3.1
  15. Projektbygget är klart. För att blinka, kör detta kommando:
  16. ../../../components/esptool_py/esptool/esptool.py -p (PORT) -b 921600 write_flash –flash_ mode dio
  17. –flash_size detect –flash_freq 40m 0x10000 build/hello world.bin build 0x1000
  18. build/bootloader/bootloader.bin 0x8000 build/partition_table/partition-table.bin
  19. eller kör 'idf.py -p PORT flash'
    Om det inte finns några fel kommer konstruktionen att slutföras genom att generera den fasta programvarans binära .bin file.
Flash på enheten
Flasha binärfilerna som du just byggde på din ESP32-C3-MINI-1-modul genom att köra:
1. idf.py -p PORT [-b BAUD] blixt
  Byt ut PORT med modulens seriella portnamn från Steg: Anslut din enhet.
  Du kan också ändra överföringshastigheten för blixten genom att ersätta BAUD med den överföringshastighet du behöver. Standardöverföringshastigheten är 460800.
  För mer information om idf.py-argument, se idf.py.

Notera
Alternativet "flash" bygger och blinkar automatiskt projektet, så att köra "idf.py build" är inte nödvändigt.

…
esptool.py –chip esp32c3 -p /dev/ttyUSB0 -b 460800 –before=default_reset –after =hård_återställ write_flash –flash_mode dio –flash_freq 80m –flash_size 2MB 0x 8000/partition_x0bin bootload-tx0bin uppstartsbar/partition_x0bin. -world.bin

eptool.py v3.0
Seriell port /dev/ttyUSB0
Ansluter….

Chipet är ESP32-C3
Funktioner: Wi-Fi
Kristallen är 40MHz

MAC: 7c:df:a1:40:02:a4
Laddar upp stubb...
Kör stubb...

Stubben springer...
Ändra överföringshastighet till 460800
Ändrats.

Konfigurerar blixtstorlek...
Komprimerad 3072 byte till 103...
Skriver på 0x00008000... (100 %)

Skrev 3072 byte (103 komprimerade) vid 0x00008000 på 0.0 sekunder (effektiv 4238.1 kbit/s)...
Hash av data verifierad.
Komprimerad 18960 byte till 11311...

Skriver på 0x00000000... (100 %)
Skrev 18960 byte (11311 komprimerade) vid 0x00000000 på 0.3 sekunder (effektiv 584.9 kbit/s)...
Hash av data verifierad.

Komprimerad 145520 byte till 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 komprimerade) vid 0x00010000 på 2.3 sekunder (effektiv 504.4 kbit/s)...
Hash av data verifierad.

Lämnar...
Hård återställning via RTS-stift...
Gjort

Om allt går bra, börjar "hello_world"-applikationen att köras efter att du tagit bort bygeln på IO0 och GND och startat testkortet igen.

Övervaka

För att kontrollera om "hello_world" verkligen körs, skriv 'idf.py -p PORT monitor' (Glöm inte att ersätta PORT med ditt seriella portnamn).
Detta kommando startar IDF Monitor-applikationen:

$ idf.py -p /dev/ttyUSB0 monitor
Kör idf_monitor i katalogen […]/esp/hello_world/build
Kör ”python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_world/build /hello-world.elf”...

— idf_monitor på /dev/ttyUSB0 115200 —
— Avsluta: Ctrl+] | Meny: Ctrl+T | Hjälp: Ctrl+T följt 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

Efter start och diagnostikloggar rulla uppåt bör du se "Hello world!" skrivs ut av applikationen.

Hej världen!
Startar om om 10 sekunder...
Detta är esp32c3-chip med 1 CPU-kärna, WiFi/BLE, 4MB extern blixt

Startar om om 9 sekunder...
Startar om om 8 sekunder...
Startar om om 7 sekunder...

För att avsluta IDF-monitorn använd genvägen Ctrl+].

Det är allt du behöver för att komma igång med ESP32-C3-MINI-1-modulen! Nu är du redo att prova något annat examples i ESP-IDF, eller gå direkt till att utveckla dina egna applikationer.

Lärresurser

Måste läsa dokument
Vänligen bekanta dig med följande dokument:

ESP32-C3 Family Datablad
Detta är en introduktion till specifikationerna för ESP32-C3-hårdvaran, inklusive överview, pindefinitioner,
funktionsbeskrivning, perifert gränssnitt, elektriska egenskaper m.m.
ESP-IDF programmeringsguide
Omfattande dokumentation för ESP-IDF-utvecklingsramverket, allt från hårdvaruguider till API
referens.
ESP32-C3 teknisk referensmanual
Detaljerad information om hur du använder ESP32-C3-minnet och kringutrustning.

Beställningsinformation för Espressif-produkter

Viktiga resurser

Här är de viktiga ESP32-C3-relaterade resurserna.

ESP32 BBS
Engineer-to-Engineer (E2E) Community för Espressif-produkter där du kan ställa frågor, dela kunskap, utforska idéer och hjälpa till att lösa problem med andra ingenjörer.

Revisionshistorik

Datum	Version	Release notes
2021-02-01	V0.1	Preliminär release

Ansvarsfriskrivning och upphovsrättsmeddelande
Information i detta dokument, inklusive URL referenser, kan ändras utan föregående meddelande.
ALL TREDJE PARTS INFORMATION I DETTA DOKUMENT TILLHANDAHÅLLS I BEFINTLIGT SKICK UTAN GARANTIER FÖR DESS ÄKTHET OCH RIKTIGHET. INGEN GARANTI TILLHANDAHÅLLS DETTA DOKUMENT FÖR SÄLJBARHET, EJ INTRÄNGD, LÄMPLIGHET FÖR NÅGOT SÄRSKILT ÄNDAMÅL, ELLER GÖR NÅGON GARANTI SOM PÅ ANNAT SÄTT UPPSTÅR UR NÅGOT FÖRSLAG, SPECIFIKATIONER ELLERAMPLE.
Allt ansvar, inklusive ansvar för intrång i eventuella äganderätter, relaterat till användningen av informationen i detta dokument friskrivs. Inga licenser, uttryckliga eller underförstådda, genom estoppel eller på annat sätt, till några immateriella rättigheter beviljas häri.
Wi-Fi Alliance Members logotyp är ett varumärke som tillhör Wi-Fi Alliance. Bluetooth-logotypen är ett registrerat varumärke som tillhör Bluetooth SIG.
Alla varumärken, varumärken och registrerade varumärken som nämns i detta dokument tillhör sina respektive ägare och erkänns härmed.
Copyright © 2021 Espressif Systems (Shanghai) Co., Ltd. Med ensamrätt.

https://www.espressif.com/

Dokument/resurser

ESPRESSIF ESP32-C3-MINI-1 Wi-Fi och Bluetooth Internet of Things-modul [pdf] Användarmanual
ESPC3MINI1, 2AC7Z-ESPC3MINI1, 2AC7ZESPC3MINI1, ESP32 -C3 -MINI- 1 Wi-Fi och Bluetooth Internet of Things-modul, Wi-Fi och Bluetooth Internet of Things-modul, Internet of Things-modul

Referenser

Användarmanual