Manual d'usuari del mòdul d'Internet de les coses per Wi-Fi i Bluetooth ESPRESSIF ESP32-C3-MINI-1

Sobre aquest document
Aquest manual d'usuari mostra com començar amb el mòdul ESP32-C3-MINI-1.

Actualitzacions de documents
Si us plau, consulteu sempre la darrera versió a https://www.espressif.com/en/support/download/documents.

Historial de revisions
Per a l'historial de revisions d'aquest document, consulteu l'última pàgina.

Notificació de canvi de documentació
Espressif proporciona notificacions per correu electrònic per mantenir-vos actualitzat sobre els canvis a la documentació tècnica. Si us plau, subscriu-te a www.espressif.com/en/subscribe.

Certificació
Descarregar certificats per als productes Espressif de www.espressif.com/en/certificats

Acabatview

1. Mòdul acabatview
   ESP32-C3-MINI-1 és un mòdul Wi-Fi i Bluetooth LE de propòsit general. El ric conjunt de perifèrics i una mida petita fan d'aquest mòdul una opció ideal per a llars intel·ligents, automatització industrial, assistència sanitària, electrònica de consum, etc.
   Taula 1: Especificacions ESP32C3MINI1
   

   Categories	Paràmetres	Especificacions
   Wi-Fi	Protocols	802.11 b/g/n (fins a 150 Mbps)
   	Interval de freqüència	2412 ~ ​​2462 MHz
   Bluetooth®	Protocols	Bluetooth® LE: Bluetooth 5 i malla Bluetooth
   	Ràdio	Transmissor de classe 1, classe 2 i classe 3
   Maquinari	Interfícies de mòduls	GPIO, SPI, UART, I2C, I2S, perifèric de control remot, controlador LED PWM, controlador general DMA, TWAI® controlador (compatible amb ISO 11898-1), sensor de temperatura, SAR ADC
   	Cristall integrat	Cristall de 40 MHz
   	Vol. Operatiutage/Font d'alimentació	3.0 V ~ 3.6 V
   	Corrent de funcionament	Mitjana: 80 mA
   	Corrent mínima subministrada per la potència subministrament	500 mA
   	Temperatura ambient	–40 °C ~ +105 °C
   	Nivell de sensibilitat a la humitat (MSL)	Nivell 3

3. Descripció del pin
   Figura 1: Disseny del pin (a dalt View)
   
   El mòdul té 53 pins. Vegeu les definicions de pins a la taula 2.
   Per a les configuracions de pins perifèrics, consulteu el full de dades de la família ESP32-C3.
   Taula 2: Definicions de pins
   

   Nom	No.	Tipus	Funció
   GND	1, 2, 11, 14, 36-53	P	Terra
   3V3	3	P	Font d'alimentació
   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	Alt: activat, activa el xip. Baix: apagat, el xip s'apaga. Nota: no deixeu flotant el pin EN.
   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

Comença a ESP32C3MINI1

El que necessites

Per desenvolupar aplicacions per al mòdul ESP32-C3-MINI-1 necessiteu:

• 1 x mòdul ESP32-C3-MINI-1
• 1 x Placa de prova Espressif RF
• 1 x placa USB a sèrie
• 1 x cable micro-USB
• 1 x PC amb Linux

En aquesta guia d'usuari, prenem el sistema operatiu Linux com a exempleample. Per obtenir més informació sobre la configuració a Windows i macOS, consulteu la Guia de programació ESP-IDF.

Connexió de maquinari

1. Soldeu el mòdul ESP32-C3-MINI-1 a la placa de prova de RF tal com es mostra a la figura 2.
   
2. Connecteu la placa de prova de RF a la placa USB a sèrie mitjançant TXD, RXD i GND.
3. Connecteu la placa USB a sèrie al PC.
4. Connecteu la placa de prova de RF a l'ordinador o a un adaptador d'alimentació per activar l'alimentació de 5 V mitjançant el cable Micro-USB.
5. Durant la descàrrega, connecteu IO0 a GND mitjançant un pont. A continuació, activeu "ON" el tauler de proves.
6. Baixeu el firmware al flash. Per obtenir més informació, consulteu les seccions següents.
7. Després de la descàrrega, traieu el pont a IO0 i GND.
8. Torneu a engegar la placa de proves de RF. ESP32-C3-MINI-1 canviarà al mode de treball. El xip llegirà els programes del flash després de la inicialització.
   Nota
   IO0 és una lògica interna alta. Si IO0 està configurat com a pull-up, es selecciona el mode d'arrencada. Si aquest pin és desplegable o deixa flotant, el
   El mode de descàrrega està seleccionat. Per obtenir més informació sobre ESP32-C3 MINI-1, consulteu el full de dades ESP32-C3-MINI-1.

Configurar l'entorn de desenvolupament

L'Espressif IoT Development Framework (ESP-IDF per abreujar) és un marc per desenvolupar aplicacions basades en els xips Espressif. Els usuaris poden desenvolupar aplicacions amb xips ESP a Windows/Linux/macOS basats en ESP-IDF. Aquí prenem el sistema operatiu Linux com a exempleample.

1. Instal·leu els requisits previs
   Per compilar amb ESP-IDF cal que obtingueu els paquets següents:
   • CentOS 7:
     1 sudo yum install git wget flex bison gperf python cmake ninja-build ccache dfuutil
   • Ubuntu i Debian (una comanda es divideix en dues línies):
     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
   • Arc:
     • 1 sudo pacman -S –necessita gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
       Nota
     • Aquesta guia utilitza el directori ~/esp a Linux com a carpeta d'instal·lació per a ESP-IDF.
     • Tingueu en compte que ESP-IDF no admet espais als camins.
2. Obteniu ESPIDF
   Per crear aplicacions per al mòdul ESP32-C3-MINI-1, necessiteu les biblioteques de programari proporcionades per Espressif al repositori ESP-IDF.
   Per obtenir ESP-IDF, creeu un directori d'instal·lació (~/esp) per descarregar ESP-IDF i clonar el repositori amb 'git clone':
   1. mkdir -p ~/esp
   2. cd ~/esp
   3. git clone –recursiu https://github.com/espressif/esp-idf.git
      ESP-IDF es baixarà a ~/esp/esp-idf. Consulteu les versions d'ESP-IDF per obtenir informació sobre quina versió d'ESP-IDF cal utilitzar en una situació determinada.
3. Configura Eines
   A part de l'ESP-IDF, també heu d'instal·lar les eines utilitzades per ESP-IDF, com ara el compilador, el depurador, els paquets Python, etc. ESP-IDF proporciona un script anomenat 'install.sh' per ajudar a configurar les eines. d'una vegada.
   1. cd ~/esp/esp-idf
   2. /install.sh
4. Configura variables d'entorn
   Les eines instal·lades encara no s'han afegit a la variable d'entorn PATH. Per fer que les eines es puguin utilitzar des de la línia d'ordres, cal establir algunes variables d'entorn. ESP-IDF proporciona un altre script 'export.sh' que fa això. Al terminal on utilitzareu ESP-IDF, executeu:
   • $HOME/esp/esp-idf/export.sh
     Ara tot està preparat, podeu crear el vostre primer projecte amb el mòdul ESP32-C3 MINI-1.

Crea el teu primer projecte 

1. Inicieu un projecte
   Ara ja esteu preparat per preparar la vostra sol·licitud per al mòdul ESP32-C3-MINI-1. Podeu començar amb el projecte get-started/hello_world de l'examples directori a ESP-IDF.
   Copieu get-started/hello_world al directori ~/esp:
   1. cd ~/esp
   2. cp -r $IDF_PATH/examples/get-started/hello_world .
      Hi ha un ventall d'example projectes a l'examples directori a ESP-IDF. Podeu copiar qualsevol projecte de la mateixa manera que s'ha presentat anteriorment i executar-lo. També és possible construir examples al seu lloc, sense copiar-les abans.
      Hi ha un ventall d'example projectes a l'examples directori a ESP IDF. Podeu copiar qualsevol projecte de la mateixa manera que s'ha presentat anteriorment i executar-lo. També és possible construir examples al seu lloc, sense copiar-les abans.
2. Connecteu el dispositiu
   Ara connecteu el vostre mòdul ESP32-C3-MINI-1 a l'ordinador i comproveu a quin port sèrie és visible el mòdul. Els ports sèrie a Linux comencen amb "/dev/tty" als seus noms. Executeu l'ordre següent dues vegades, primer amb el
   tauler desconnectat i després connectat. El port que apareix per segona vegada és el que necessiteu:
   • ls /dev/tty*
     Nota
     Mantingueu el nom del port a mà, ja que el necessitareu als passos següents.
3. Configura
   Navegueu al vostre directori "hello_world" des del pas 2.4.1. Inicieu un projecte, configureu ESP32-C3 com a objectiu i executeu la utilitat de configuració del projecte "menuconfig".
   1. cd ~/esp/hello_world
   2. idf.py set-target esp32c3
   3. idf.py menuconfig
      L'establiment de l'objectiu amb 'idf.py set-target esp32c3' s'ha de fer una vegada, després d'obrir un nou projecte. Si el projecte conté algunes compilacions i configuracions existents, s'esborraran i s'inicializaran. L'objectiu es pot desar a la variable d'entorn per ometre aquest pas. Consulteu Selecció de l'objectiu per obtenir informació addicional.
      Si els passos anteriors s'han fet correctament, apareix el següent menú:
      Figura 3: Finestra d'inici de configuració del projecte
      
      Els colors del menú poden ser diferents al vostre terminal. Podeu canviar l'aparença amb l'opció '–style'. Si us plau, executeu 'idf.py menuconfig –help'per a més informació
4. Construeix el Projecte
   Creeu el projecte executant:
   1. idf.py b
      Aquesta ordre compilarà l'aplicació i tots els components ESP-IDF i, a continuació, generarà el carregador d'arrencada, la taula de particions i els binaris de l'aplicació.
      1. $ idf.py build
      2. S'està executant cmake al directori /path/to/hello_world/build
      3. S'està executant "cmake -G Ninja –warn-uninitialized /path/to/hello_world"...
      4. Adverteix sobre valors no inicialitzats.
      5. — S'ha trobat Git: /usr/bin/git (versió trobada "2.17.0")
      6.  — Creació del component aws_iot buit a causa de la configuració
      7. — Noms dels components: …
      8. — Rutes dels components: …
      10. … (més línies de sistema de construcció fora
      12. [527/527] S'està generant hello-world.bin
      13. esptool.py v2.3.1
      15. Construcció del projecte completada. Per flashejar, executeu aquesta comanda:
      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. o executeu "idf.py -p PORT flash"
          Si no hi ha errors, la construcció finalitzarà generant el .bin binari del microprogramari file.
5. Flasheja al dispositiu
   Feu clic als binaris que acabeu de crear al vostre mòdul ESP32-C3-MINI-1 executant:
   1. idf.py -p PORT [-b BAUD] flash
      Substituïu PORT pel nom del port sèrie del vostre mòdul del Pas: Connecteu el vostre dispositiu.
      També podeu canviar la velocitat en baudis del flasher substituint BAUD per la velocitat en baudis que necessiteu. La velocitat de transmissió predeterminada és 460800.
      Per obtenir més informació sobre els arguments idf.py, vegeu idf.py.
      

Nota
L'opció 'flash' crea i parpelleja automàticament el projecte, de manera que no cal executar 'idf.py build'.

1. …
2. esptool.py –chip esp32c3 -p /dev/ttyUSB0 -b 460800 –before=default_reset –després de =hard_reset write_flash –flash_mode dio –flash_freq 80m –flash_size 2MB 0x 8000 partition_load_table_loaderbin. hola -world.bin
3. esptool.py v3.0
4. Port sèrie /dev/ttyUSB0
5. Connectant….
6. El xip és ESP32-C3
7. Característiques: Wi-Fi
8. El cristall és de 40 MHz
9. MAC: 7c:df:a1:40:02:a4
10. S'està penjant el taló…
11. Corrent taló...
12. Stub corrent...
13. Canviant la velocitat de transmissió a 460800
14. Canviat.
15. S'està configurant la mida del flaix...
16. S'han comprimit 3072 bytes a 103...
17. S'està escrivint a 0x00008000... (100 %)
18. Va escriure 3072 bytes (103 comprimits) a 0x00008000 en 0.0 segons (efectiu 4238.1 kbit/s)...
19. Hash de dades verificades.
20. S'han comprimit 18960 bytes a 11311...
21. S'està escrivint a 0x00000000... (100 %)
22. Va escriure 18960 bytes (11311 comprimits) a 0x00000000 en 0.3 segons (efectiu 584.9 kbit/s)...
23. Hash de dades verificades.
24. S'han comprimit 145520 bytes a 71984...
25. S'està escrivint a 0x00010000... (20 %)
26. S'està escrivint a 0x00014000... (40 %)
27. S'està escrivint a 0x00018000... (60 %)
28. S'està escrivint a 0x0001c000... (80 %)
29. S'està escrivint a 0x00020000... (100 %)
30. Va escriure 145520 bytes (71984 comprimits) a 0x00010000 en 2.3 segons (efectiu 504.4 kbit/s)...
31. Hash de dades verificades.
33. Sortint…
34. Restabliment dur mitjançant el pin RTS...
35. Fet

Si tot va bé, l'aplicació "hello_world" començarà a executar-se després de treure el pont a IO0 i GND i tornar a engegar la placa de proves.

Monitor

Per comprovar si "hello_world" s'està executant, escriviu 'idf.py -p PORT monitor' (no oblideu substituir PORT pel nom del vostre port sèrie).
Aquesta ordre llança l'aplicació IDF Monitor:

1. $ idf.py -p /dev/ttyUSB0 monitor
2. S'està executant idf_monitor al directori […]/esp/hello_world/build
3. S'està executant ”python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_world/build /hello-world.elf”…
4. — idf_monitor a /dev/ttyUSB0 115200 —
5. — Surt: Ctrl+] | Menú: Ctrl+T | Ajuda: Ctrl+T seguit de Ctrl+H —
6. ets 8 de juny de 2016 00:22:57
8. rst:0x1 (POWERON_RESET), arrencada:0x13 (SPI_FAST_FLASH_BOOT)
9. ets 8 de juny de 2016 00:22:57
10. …

Després de desplaçar-se cap amunt els registres d'inici i de diagnòstic, hauríeu de veure "Hola món!" imprès per l'aplicació.

1. …
2. Hola món!
3. Reiniciant en 10 segons...
4. Es tracta d'un xip esp32c3 amb 1 nucli de CPU, WiFi/BLE, flaix extern de 4MB
5. Reiniciant en 9 segons...
6. Reiniciant en 8 segons...
7. Reiniciant en 7 segons...

Per sortir del monitor IDF, utilitzeu la drecera Ctrl+].

Això és tot el que necessiteu per començar amb el mòdul ESP32-C3-MINI-1! Ara ja estàs preparat per provar un altre exampa ESP-IDF, o aneu directament a desenvolupar les vostres pròpies aplicacions.

Recursos d'aprenentatge

1. Documents imprescindibles
   Si us plau, familiaritzeu-vos amb els documents següents:
2. Full de dades de la família ESP32-C3
   Aquesta és una introducció a les especificacions del maquinari ESP32-C3, inclòs mésview, definicions de pins,
   descripció funcional, interfície perifèrica, característiques elèctriques, etc.
3. Guia de programació ESP-IDF
   Amplia documentació per al marc de desenvolupament ESP-IDF, que va des de guies de maquinari fins a API
   referència.
4. Manual tècnic de referència ESP32-C3
   Informació detallada sobre com utilitzar la memòria ESP32-C3 i els perifèrics.
5. Informació de comandes de productes Espressif
   

Recursos importants

Aquests són els recursos importants relacionats amb ESP32-C3.

• ESP32 BBS
  Comunitat d'enginyer a enginyer (E2E) per als productes Espressif on podeu publicar preguntes, compartir coneixements, explorar idees i ajudar a resoldre problemes amb altres enginyers.

Historial de revisions

Data	Versió	Notes de publicació
2021-02-01	V0.1	Alliberament preliminar

 

Exempció de responsabilitat i avís de drets d'autor
Informació d'aquest document, inclòs URL referències, està subjecte a canvis sense previ avís.
TOTA LA INFORMACIÓ DE TERCERS EN AQUEST DOCUMENT ES PROPORCIONA TAL CUAL SENSE GARANTIA DE LA SEVA AUTENTICITAT I EXACTITUD. AQUEST DOCUMENT NO ES PROPORCIONA CAP GARANTIA PER LA SEVA COMERCIABILITAT, NO INFRACCIÓ, ADEQUACIÓ PER A QUALSEVOL PROPÒSIT PARTICULAR, NI CAP GARANTIA DERIVADA DE CAP PROPOSTA, ESPECIFICACIÓ O S.AMPLE.
Es descarta de tota responsabilitat, inclosa la responsabilitat per infracció de qualsevol dret de propietat, relacionada amb l'ús de la informació d'aquest document. No s'atorga aquí cap llicència expressa o implícita, per preclusió o d'una altra manera, sobre cap dret de propietat intel·lectual.
El logotip de Wi-Fi Alliance Member és una marca comercial de Wi-Fi Alliance. El logotip de Bluetooth és una marca comercial registrada de Bluetooth SIG.
Tots els noms comercials, marques comercials i marques comercials registrades esmentades en aquest document són propietat dels seus respectius propietaris, i per la present es reconeixen.
Copyright © 2021 Espressif Systems (Shanghai) Co., Ltd. Tots els drets reservats.

https://www.espressif.com/

Documents/Recursos

Mòdul d'Internet de les coses per Wi-Fi i Bluetooth ESPRESSIF ESP32-C3-MINI-1 [pdfManual d'usuari ESPC3MINI1, 2AC7Z-ESPC3MINI1, 2AC7ZESPC3MINI1, ESP32 -C3 -MINI- 1 Mòdul d'Internet de les coses Wi-Fi i Bluetooth, Mòdul d'Internet de les coses Wi-Fi i Bluetooth, Mòdul d'Internet de les coses

Referències

• Manual d'usuari