ESPRESSIF ESP32-C3-MINI-1 Wi-Fi- und Bluetooth-Internet-of-Things-Modul – Benutzerhandbuch
Informationen zu diesem Dokument
Dieses Benutzerhandbuch zeigt die ersten Schritte mit dem ESP32-C3-MINI-1-Modul.
Dokumentaktualisierungen
Bitte beziehen Sie sich immer auf die neuste Version https://www.espressif.com/en/support/download/documents.
Änderungsverlauf
Den Revisionsverlauf dieses Dokuments finden Sie auf der letzten Seite.
Benachrichtigung über Änderung der Dokumentation
Espressif stellt E-Mail-Benachrichtigungen bereit, um Sie über Änderungen an der technischen Dokumentation auf dem Laufenden zu halten. Bitte abonnieren Sie unter www.espressif.com/en/subscribe.
Zertifizierung
Laden Sie Zertifikate für Espressif-Produkte herunter www.espressif.com/en/certificates
Überview
- Modul überview
ESP32-C3-MINI-1 ist ein universelles Wi-Fi- und Bluetooth LE-Modul. Der umfangreiche Peripherieumfang und die geringe Größe machen dieses Modul zur idealen Wahl für Smart Homes, Industrieautomation, Gesundheitswesen, Unterhaltungselektronik usw.
Tabelle 1: ESP32C3MINI1-Spezifikationen
Kategorien Parameter Technische Daten W-lan Protokolle 802.11 b/g/n (bis zu 150 Mbit/s) Frequenzbereich 2412 ~ 2462 MHz Bluetooth® Protokolle Bluetooth® LE: Bluetooth 5 und Bluetooth Mesh Radio Klasse-1, Klasse-2 und Klasse-3 Sender Hardware
Modulschnittstellen GPIO, SPI, UART, I2C, I2S, Fernbedienungsperipherie, LED-PWM-Controller, allgemeiner DMA-Controller, TWAI® Controller (kompatibel mit ISO 11898-1), Temperatursensor, SAR ADC Integrierter Kristall 40 MHz Quarz Betriebsvolumentage/Stromversorgung 3.0 V bis 3.6 V Betriebsstrom Durchschnitt: 80 mA Von der Stromversorgung gelieferter Mindeststrom liefern
500 mA Umgebungstemperatur –40 °C ~ +105 °C Feuchtigkeitsempfindlichkeit (MSL) Stufe 3 - Pin Beschreibung
Abbildung 1: Pin-Layout (Oben View)
Das Modul hat 53 Pins. Siehe Pin-Definitionen in Tabelle 2.
Informationen zu peripheren Pin-Konfigurationen finden Sie im Datenblatt der ESP32-C3-Familie .
Tabelle 2: Pindefinitionen
Name NEIN. Typ Funktion Masse 1, 2, 11, 14, 36-53 P Boden 3V3 3 P Stromversorgung 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: an, aktiviert den Chip. Low: aus, der Chip schaltet sich aus. Hinweis: Lassen Sie den EN-Pin nicht schwebend.
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
Erste Schritte mit ESP32C3MINI1
Was du brauchst
Um Anwendungen für das Modul ESP32-C3-MINI-1 zu entwickeln, benötigen Sie:
- 1 x ESP32-C3-MINI-1-Modul
- 1 x Espressif HF-Testplatine
- 1 x USB-zu-Seriell-Karte
- 1 x Micro-USB-Kabel
- 1 x PC mit Linux
In diesem Benutzerhandbuch nehmen wir das Linux-Betriebssystem als Beispielample. Weitere Informationen zur Konfiguration unter Windows und macOS finden Sie im ESP-IDF-Programmierhandbuch.
Hardware-Verbindung
- Löten Sie das ESP32-C3-MINI-1-Modul an die HF-Testplatine, wie in Abbildung 2 gezeigt.
- Verbinden Sie die HF-Testplatine über TXD, RXD und GND mit der USB-to-Serial-Platine.
- Schließen Sie die USB-to-Serial-Karte an den PC an.
- Schließen Sie das HF-Testboard über das Micro-USB-Kabel an den PC oder ein Netzteil an, um eine 5-V-Stromversorgung zu ermöglichen.
- Verbinden Sie während des Downloads IO0 über einen Jumper mit GND. Schalten Sie dann die Testplatine „EIN“.
- Laden Sie die Firmware in den Flash herunter. Einzelheiten finden Sie in den folgenden Abschnitten.
- Entfernen Sie nach dem Download den Jumper auf IO0 und GND.
- Schalten Sie die HF-Testplatine erneut ein. ESP32-C3-MINI-1 wechselt in den Arbeitsmodus. Der Chip liest bei der Initialisierung Programme aus dem Flash.
Notiz
IO0 ist intern logisch hoch. Wenn IO0 auf Pull-Up eingestellt ist, wird der Boot-Modus ausgewählt. Wenn dieser Pin Pull-Down ist oder schwebend gelassen wird,
Der Download-Modus ist ausgewählt. Weitere Informationen zu ESP32-C3 MINI-1 finden Sie im Datenblatt zu ESP32-C3-MINI-1.
Entwicklungsumgebung einrichten
Das Espressif IoT Development Framework (kurz ESP-IDF) ist ein Framework zur Entwicklung von Anwendungen auf Basis der Espressif-Chips. Benutzer können Anwendungen mit ESP-Chips in Windows/Linux/macOS basierend auf ESP-IDF entwickeln. Hier nehmen wir das Linux-Betriebssystem als Example.
- Installieren Sie die Voraussetzungen
Um mit ESP-IDF zu kompilieren, benötigen Sie die folgenden Pakete:- CentOS 7:
1 sudo yum install git wget flex bison gperf python cmake ninja-build ccache dfuutil - Ubuntu und Debian (ein Befehl wird in zwei Zeilen aufgeteilt):
- sudo apt-get installiere git wget flex bison gperf python python-pip pythonsetuptools cmake
- ninja-build ccache libffi-dev libssl-dev dfu-util
- Bogen:
- 1 sudo pacman -S –needed gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
Notiz - Diese Anleitung verwendet das Verzeichnis ~/esp unter Linux als Installationsordner für ESP-IDF.
- Beachten Sie, dass ESP-IDF keine Leerzeichen in Pfaden unterstützt.
- 1 sudo pacman -S –needed gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
- CentOS 7:
- Holen Sie sich ESPIDF
Um Anwendungen für das ESP32-C3-MINI-1-Modul zu erstellen, benötigen Sie die von Espressif im ESP-IDF-Repository bereitgestellten Softwarebibliotheken.
Um ESP-IDF zu erhalten, erstellen Sie ein Installationsverzeichnis (~/esp), um ESP-IDF herunterzuladen und das Repository mit „git clone“ zu klonen:- mkdir -p ~/esp
- cd ~/bes
- git clone –rekursiv https://github.com/espressif/esp-idf.git
ESP-IDF wird in ~/esp/esp-idf heruntergeladen. Informationen dazu, welche ESP-IDF-Version in einer bestimmten Situation verwendet werden soll, finden Sie unter ESP-IDF-Versionen.
- Werkzeuge einrichten
Abgesehen von ESP-IDF müssen Sie auch die von ESP-IDF verwendeten Tools installieren, z. B. den Compiler, Debugger, Python-Pakete usw. ESP-IDF stellt ein Skript namens „install.sh“ bereit, um die Einrichtung der Tools zu erleichtern auf einmal.- cd ~/esp/esp-idf
- /install.sh
- Umgebungsvariablen einrichten
Die installierten Tools werden noch nicht zur Umgebungsvariable PATH hinzugefügt. Um die Tools über die Kommandozeile nutzbar zu machen, müssen einige Umgebungsvariablen gesetzt werden. ESP-IDF bietet ein weiteres Skript „export.sh“, das dies tut. Führen Sie in dem Terminal, in dem Sie ESP-IDF verwenden möchten, Folgendes aus:- $HOME/esp/esp-idf/export.sh
Jetzt ist alles bereit, Sie können Ihr erstes Projekt auf dem ESP32-C3 MINI-1-Modul erstellen.
- $HOME/esp/esp-idf/export.sh
Erstellen Sie Ihr erstes Projekt
- Starten Sie ein Projekt
Jetzt können Sie Ihre Anwendung für das ESP32-C3-MINI-1-Modul vorbereiten. Sie können mit dem Projekt get-started/hello_world von ex beginnen.amples-Verzeichnis in ESP-IDF.
Kopieren Sie get-started/hello_world in das Verzeichnis ~/esp:- cd ~/bes
- cp -r $IDF_PATH/examples/get-started/hello_world .
Es gibt eine Reihe von Example projekte in der examples-Verzeichnis in ESP-IDF. Sie können jedes Projekt wie oben beschrieben kopieren und ausführen. Es ist auch möglich, ex . zu bauenampDateien an Ort und Stelle, ohne sie vorher zu kopieren.
Es gibt eine Reihe von Example projekte in der examples-Verzeichnis in ESP IDF. Sie können jedes Projekt auf die gleiche Weise wie oben beschrieben kopieren und ausführen. Es ist auch möglich, ExampDateien an Ort und Stelle, ohne sie vorher zu kopieren.
- Verbinden Sie Ihr Gerät
Schließen Sie nun Ihr ESP32-C3-MINI-1-Modul an den Computer an und prüfen Sie, unter welchem seriellen Port das Modul sichtbar ist. Serielle Ports beginnen in Linux mit '/dev/tty' im Namen. Führen Sie den folgenden Befehl zweimal aus, zuerst mit dem
Karte ausgesteckt, dann wieder eingesteckt. Der Port, der beim zweiten Mal erscheint, ist der, den Sie brauchen:- ls /dev/tty*
Notiz
Halten Sie den Portnamen bereit, da Sie ihn in den nächsten Schritten benötigen.
- ls /dev/tty*
- Konfigurieren
Navigieren Sie in Schritt 2.4.1 zu Ihrem Verzeichnis „hello_world“. Starten Sie ein Projekt, legen Sie ESP32-C3 als Ziel fest und führen Sie das Projektkonfigurationsprogramm „menuconfig“ aus.- CD ~/esp/hello_world
- idf.py set-target esp32c3
- idf.py menuconfig
Das Setzen des Ziels mit 'idf.py set-target esp32c3' sollte einmalig nach dem Öffnen eines neuen Projekts erfolgen. Wenn das Projekt einige vorhandene Builds und Konfigurationen enthält, werden diese gelöscht und initialisiert. Das Ziel kann in einer Umgebungsvariable gespeichert werden, um diesen Schritt überhaupt zu überspringen. Weitere Informationen finden Sie unter Auswählen des Ziels.
Wenn die vorherigen Schritte korrekt durchgeführt wurden, erscheint das folgende Menü:
Abbildung 3: Startfenster der Projektkonfiguration
Die Farben des Menüs können in Ihrem Terminal anders sein. Sie können das Erscheinungsbild mit der Option „–style“ ändern. Führen Sie für weitere Informationen bitte „idf.py menuconfig –help“ aus.
- Erstellen Sie das Projekt
Erstellen Sie das Projekt, indem Sie Folgendes ausführen:- idf.py b
Dieser Befehl kompiliert die Anwendung und alle ESP-IDF-Komponenten und generiert anschließend den Bootloader, die Partitionstabelle und die Anwendungsbinärdateien.- $ idf.py-Build
- Ausführen von cmake im Verzeichnis /path/to/hello_world/build
- Ausführen von „cmake -G Ninja –warn-uninitialized /path/to/hello_world“…
- Warnen Sie vor nicht initialisierten Werten.
- — Git gefunden: /usr/bin/git (Version „2.17.0“ gefunden)
- — Erstellen einer leeren aws_iot-Komponente aufgrund der Konfiguration
- — Komponentennamen: …
- — Komponentenpfade: …
- … (mehr Zeilen des Build-Systems heraus
- [527/527] Erzeuge hello-world.bin
- esptool.py v2.3.1
- Projektaufbau abgeschlossen. Führen Sie zum Flashen diesen Befehl aus:
- ../../../components/esptool_py/esptool/esptool.py -p (PORT) -b 921600 write_flash –flash_ mode dio
- –flash_size erkennen –flash_freq 40m 0x10000 build/hallo welt.bin build 0x1000
- build/bootloader/bootloader.bin 0x8000 build/partition_table/partition-table.bin
- oder führen Sie 'idf.py -p PORT flash' aus
Wenn keine Fehler auftreten, wird der Build mit der Generierung der Firmware-Binärdatei .bin abgeschlossen file.
- idf.py b
- Auf das Gerät flashen
Flashen Sie die Binärdateien, die Sie gerade erstellt haben, auf Ihr ESP32-C3-MINI-1-Modul, indem Sie Folgendes ausführen:- idf.py -p PORT [-b BAUD] blinken
Ersetzen Sie PORT durch den Namen des seriellen Anschlusses Ihres Moduls aus Schritt: Verbinden Sie Ihr Gerät.
Sie können auch die Flasher-Baudrate ändern, indem Sie BAUD durch die benötigte Baudrate ersetzen. Die Standard-Baudrate ist 460800.
Weitere Informationen zu idf.py-Argumenten finden Sie unter idf.py.
- idf.py -p PORT [-b BAUD] blinken
Notiz
Die Option „flash“ erstellt und flasht das Projekt automatisch, sodass das Ausführen von „idf.py build“ nicht erforderlich ist.
- …
- 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_table/partition-table.bin 0x0 bootloader/bootloader.bin 0x10000 hallo-welt.bin
- esptool.py v3.0
- Serielle Schnittstelle /dev/ttyUSB0
- Verbinden….
- Chip ist ESP32-C3
- Eigenschaften: WLAN
- Kristall ist 40MHz
- MAC: 7c:df:a1:40:02:a4
- Stub wird hochgeladen…
- Laufstummel…
- Stummel läuft…
- Baudrate auf 460800 ändern
- Geändert.
- Flash-Größe konfigurieren…
- Komprimiert 3072 Bytes zu 103…
- Schreiben bei 0x00008000… (100 %)
- 3072 Bytes (103 komprimiert) bei 0x00008000 in 0.0 Sekunden geschrieben (effektiv 4238.1 kbit/s)…
- Hash der Daten verifiziert.
- Komprimiert 18960 Bytes zu 11311…
- Schreiben bei 0x00000000… (100 %)
- 18960 Bytes (11311 komprimiert) bei 0x00000000 in 0.3 Sekunden geschrieben (effektiv 584.9 kbit/s) …
- Hash der Daten verifiziert.
- Komprimiert 145520 Bytes zu 71984…
- Schreiben bei 0x00010000… (20 %)
- Schreiben bei 0x00014000… (40 %)
- Schreiben bei 0x00018000… (60 %)
- Schreiben bei 0x0001c000… (80 %)
- Schreiben bei 0x00020000… (100 %)
- Schrieb 145520 Bytes (71984 komprimiert) bei 0x00010000 in 2.3 Sekunden (effektiv 504.4 kbit/s)…
- Hash der Daten verifiziert.
- Verlassen…
- Hard-Reset über RTS-Pin…
- Erledigt
Wenn alles gut geht, wird die Anwendung „hello_world“ ausgeführt, nachdem Sie den Jumper auf IO0 und GND entfernt und die Testplatine wieder eingeschaltet haben.
Monitor
Um zu überprüfen, ob „hello_world“ tatsächlich ausgeführt wird, geben Sie „idf.py -p PORT monitor“ ein (vergessen Sie nicht, PORT durch den Namen Ihrer seriellen Schnittstelle zu ersetzen).
Dieser Befehl startet die Anwendung IDF Monitor:
- $ idf.py -p /dev/ttyUSB0 überwachen
- Ausführen von idf_monitor im Verzeichnis […]/esp/hello_world/build
- Ausführen von „python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_world/build /hello-world.elf“…
- — idf_monitor auf /dev/ttyUSB0 115200 —
- — Beenden: Strg+] | Menü: Strg+T | Hilfe: Strg+T gefolgt von Strg+H —
- et 8. Juni 2016 00:22:57
- rst:0x1 (POWERON_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
- et 8. Juni 2016 00:22:57
- …
Nachdem die Start- und Diagnoseprotokolle nach oben gescrollt haben, sollten Sie „Hallo Welt!“ sehen. von der Anwendung ausgedruckt.
- …
- Hallo Welt!
- Neustart in 10 Sekunden…
- Dies ist ein esp32c3-Chip mit 1 CPU-Kern, WiFi/BLE, 4 MB externem Flash
- Neustart in 9 Sekunden…
- Neustart in 8 Sekunden…
- Neustart in 7 Sekunden…
Verwenden Sie zum Beenden des IDF-Monitors die Tastenkombination Strg+].
Das ist alles, was Sie brauchen, um mit dem ESP32-C3-MINI-1-Modul loszulegen! Jetzt sind Sie bereit, einige andere Beispiele auszuprobieren.ampDateien in ESP-IDF oder gehen Sie direkt zur Entwicklung Ihrer eigenen Anwendungen.
Lernressourcen
- MustRead-Dokumente
Bitte machen Sie sich mit folgenden Dokumenten vertraut: - Datenblatt der ESP32-C3-Familie
Dies ist eine Einführung in die Spezifikationen der ESP32-C3-Hardware, einschließlich Overview, Pin-Definitionen,
Funktionsbeschreibung, Peripherieschnittstelle, elektrische Eigenschaften usw. - ESP-IDF-Programmierhandbuch
Umfangreiche Dokumentation für das ESP-IDF-Entwicklungsframework, von Hardwarehandbüchern bis hin zu API
Referenz. - ESP32-C3 Technisches Referenzhandbuch
Detaillierte Informationen zur Verwendung des ESP32-C3-Speichers und der Peripheriegeräte. - Bestellinformationen für Espressif-Produkte
Wichtige Ressourcen
Hier sind die wichtigen ESP32-C3-bezogenen Ressourcen.
- ESP32 BBS
Engineer-to-Engineer (E2E)-Community für Espressif-Produkte, in der Sie Fragen stellen, Wissen austauschen, Ideen erkunden und gemeinsam mit anderen Ingenieuren Probleme lösen können.
Änderungsverlauf
Datum |
Version | Versionshinweise |
2021-02-01 | V0.1 |
Vorläufige Veröffentlichung |
Haftungsausschluss und Urheberrechtshinweis
Informationen in diesem Dokument, einschließlich URL Referenzen, können ohne vorherige Ankündigung geändert werden.
ALLE INFORMATIONEN VON DRITTANBIETERN IN DIESEM DOKUMENT WERDEN OHNE MÄNGELGEWÄHR OHNE GEWÄHRLEISTUNG FÜR IHRE AUTHENTIZITÄT UND GENAUIGKEIT ZUR VERFÜGUNG GESTELLT. FÜR DIESES DOKUMENT WIRD KEINE GEWÄHRLEISTUNG FÜR SEINE MARKTGÄNGIGKEIT, NICHTVERLETZUNG VON RECHTEN DRITTER, EIGNUNG FÜR EINEN BESTIMMTEN ZWECK GEWÄHRT, NOCH ERGIBT SICH EINE SONSTIGE GEWÄHRLEISTUNG, DIE SICH AUS VORSCHLÄGEN, SPEZIFIKATIONEN ODER SAMPLE.
Jegliche Haftung, einschließlich der Haftung für die Verletzung von Schutzrechten, im Zusammenhang mit der Verwendung der Informationen in diesem Dokument wird ausgeschlossen. Hierin werden keine ausdrücklichen oder stillschweigenden Lizenzen, weder durch Rechtsverwirkung noch auf andere Weise, an geistigen Eigentumsrechten gewährt.
Das Wi-Fi Alliance-Mitgliedslogo ist eine Marke der Wi-Fi Alliance. Das Bluetooth-Logo ist ein eingetragenes Warenzeichen von Bluetooth SIG.
Alle in diesem Dokument erwähnten Handelsnamen, Warenzeichen und eingetragenen Warenzeichen sind Eigentum ihrer jeweiligen Inhaber und werden hiermit anerkannt.
Copyright © 2021 Espressif Systems (Shanghai) Co., Ltd. Alle Rechte vorbehalten.
Dokumente / Ressourcen
![]() |
ESPRESSIF ESP32-C3-MINI-1 Wi-Fi- und Bluetooth-Internet-of-Things-Modul [pdf] Benutzerhandbuch ESPC3MINI1, 2AC7Z-ESPC3MINI1, 2AC7ZESPC3MINI1, ESP32 -C3 -MINI- 1 Wi-Fi und Bluetooth Internet der Dinge Modul, Wi-Fi und Bluetooth Internet der Dinge Modul, Internet der Dinge Modul |