ESP32MINI1
Manual de usuario

Preliminar v0.1
Sistemas Espressif
Copyright © 2021

Sobre este manual
Este manual de usuario mostra como comezar co módulo ESP32-MINI-1.
Actualizacións de documentos
Consulte sempre a última versión en https://www.espressif.com/en/support/download/documents.
Historial de revisións
Para consultar o historial de revisións deste documento, consulte a última páxina.
Notificación de cambio de documentación
Espressif ofrece notificacións por correo electrónico para manter os clientes actualizados sobre os cambios na documentación técnica. Subscríbete en www.espressif.com/en/subscribe.
Certificación
Descargar certificados para produtos Espressif de www.espressif.com/en/certificates.

Acabadoview

1.1 Módulo rematadoview
Módulo LE MCU que ten un rico conxunto de periféricos. Este módulo é unha opción ideal para unha gran variedade de aplicacións IoT, que van desde a domótica, a construción intelixente, a electrónica de consumo ata o control industrial, especialmente axeitado para aplicacións nun espazo compacto, como lámpadas, interruptores e enchufes. ESP32-MINI-1 é un módulo Wi-Fi+Bluetooth ® +Bluetooth ® moi integrado e de pequeno tamaño. Este módulo vén en dúas versións:

• Versión 85 °C
• Versión 105 °C

Táboa 1. Especificacións ESP1MINI32

Categorías	Elementos	Especificacións
Wi-Fi	Protocolos	802.11 b/g/n (802.11n ata 150 Mbps)
		Agregación A-MPDU e A-MSDU e 0.4 µs soporte de intervalo de garda
	Rango de frecuencias	2412 ~ ​​2484 MHz
Bluetooth®	Protocolos	Protocolos v4.2 BR/EDR e Bluetooth® Especificacións de LE
	Radio	Transmisor de clase 1, clase 2 e clase 3
		AFH
	Audio	CVSD e SBC
Hardware	Interfaces de módulos	Tarxeta SD, UART, SPI, SDIO, I2C, LED PWM, Motor PWM, I2S, mando a distancia por infravermellos, contador de pulsos, GPIO, sensor táctil, ADC, DAC, interface automotriz de dous cables (TWAITM, compatible con ISO11898-1)
	Cristal integrado	Cristal de 40 MHz
	Flash SPI integrado	4 MB
	Vol. Operativotage/Fuente de alimentación	3.0 V ~ 3.6 V
	Corrente de funcionamento	Media: 80 mA
	Corriente mínima entregada pola fonte de alimentación	500 mA
	Rango de temperatura de funcionamento recomendado	Versión 85 °C: –40 °C ~ +85 °C; Versión 105 °C: –40 °C ~ +105 °C
	Nivel de sensibilidade á humidade (MSL)	Nivel 3

1.2 Descrición do pin
ESP32-MINI-1 ten 55 pinos. Consulte as definicións dos pinos na Táboa 1-2.

Táboa 1. Definicións de pinos

Nome	Non.	Tipo	Función
GND	1, 2, 27, 38 ~ 55	P	Terra
3V3	3	P	Fonte de alimentación
I36	4	I	GPIO36, ADC1_CH0, RTC_GPIO0
I37	5	I	GPIO37, ADC1_CH1, RTC_GPIO1
I38	6	I	GPIO38, ADC1_CH2, RTC_GPIO2
I39	7	I	GPIO39, ADC1_CH3, RTC_GPIO3
EN	8	I	Alto: activa o chip Baixo: o chip apágase Nota: non deixes o pin flotando
I34	9	I	GPIO34, ADC1_CH6, RTC_GPIO4
I35	10	I	GPIO35, ADC1_CH7, RTC_GPIO5
IO32	11	E/S	GPIO32, XTAL_32K_P (entrada de oscilador de cristal de 32.768 kHz), ADC1_CH4, TOUCH9, RTC_GPIO9
IO33	12	E/S	GPIO33, XTAL_32K_N (saída de oscilador de cristal de 32.768 kHz), ADC1_CH5, TOUCH8, RTC_GPIO8
IO25	13	E/S	GPIO25, DAC_1, ADC2_CH8, RTC_GPIO6, EMAC_RXD0
IO26	14	E/S	GPIO26, DAC_2, ADC2_CH9, RTC_GPIO7, EMAC_RXD1
IO27	15	E/S	GPIO27, ADC2_CH7, TOUCH7, RTC_GPIO17, EMAC_RX_DV
IO14	16	E/S	GPIO14, ADC2_CH6, TOUCH6, RTC_GPIO16, MTMS, HSPICLK, HS2_CLK, SD_CLK, EMAC_TXD2
IO12	17	E/S	GPIO12, ADC2_CH5, TOUCH5, RTC_GPIO15, MTDI, HSPIQ, HS2_DATA2, SD_DATA2, EMAC_TXD3
IO13	18	E/S	GPIO13, ADC2_CH4, TOUCH4, RTC_GPIO14, MTCK, HSPID, HS2_DATA3, SD_DATA3, EMAC_RX_ER
IO15	19	E/S	GPIO15, ADC2_CH3, TOUCH3, RTC_GPIO13, MTDO, HSPICS0, HS2_CMD, SD_CMD, EMAC_RXD3
IO2	20	E/S	GPIO2, ADC2_CH2, TOUCH2, RTC_GPIO12, HSPIWP, HS2_DATA0, SD_DATA0
IO0	21	E/S	GPIO0, ADC2_CH1, TOUCH1, RTC_GPIO11, CLK_OUT1, EMAC_TX_CLK
IO4	22	E/S	GPIO4, ADC2_CH0, TOUCH0, RTC_GPIO10, HSPIHD, HS2_DATA1, SD_DATA1, EMAC_TX_ER
NC	23	–	Non hai conexión
NC	24	–	Non hai conexión
IO9	25	E/S	GPIO9, HS1_DATA2, U1RXD, SD_DATA2
IO10	26	E/S	GPIO10, HS1_DATA3, U1TXD, SD_DATA3
NC	28	–	Non hai conexión
IO5	29	E/S	GPIO5, HS1_DATA6, VSPICS0, EMAC_RX_CLK
IO18	30	E/S	GPIO18, HS1_DATA7, VSPICLK
IO23	31	E/S	GPIO23, HS1_STROBE, VSPID
IO19	32	E/S	GPIO19, VSPIQ, U0CTS, EMAC_TXD0

Continúa na páxina seguinte

Táboa 1 – Continúa da páxina anterior

Nome	Non.	Tipo	Función
IO22	33	E/S	GPIO22, VSPIWP, U0RTS, EMAC_TXD1
IO21	34	E/S	GPIO21, VSPIHD, EMAC_TX_EN
RXD0	35	E/S	GPIO3, U0RXD, CLK_OUT2
TXD0	36	E/S	GPIO1, U0TXD, CLK_OUT3, EMAC_RXD2
NC	37	–	Non hai conexión

¹ Os pinos GPIO6, GPIO7, GPIO8, GPIO11, GPIO16 e GPIO17 do chip ESP32-U4WDH están conectados ao flash SPI integrado no módulo e non se saen.
² Para configuracións de pin periféricos, consulte Folla de datos serie ESP32.

Comeza en ESP32MINI1

2.1 O que necesitas
Para desenvolver aplicacións para o módulo ESP32-MINI-1 necesitas:

• 1 x módulo ESP32-MINI-1
• 1 x placa de proba Espressif RF
• 1 x placa USB a serie
• 1 x cable micro-USB
• 1 x PC con Linux

Nesta guía de usuario, tomamos como exemplo o sistema operativo Linuxample. Para obter máis información sobre a configuración en Windows e macOS, consulte Guía de programación ESP-IDF.

2.2 Conexión de hardware

1. Solde o módulo ESP32-MINI-1 á placa de proba de RF como se mostra na Figura 2-1.
   
2. Conecte a placa de proba de RF á placa USB a serie mediante TXD, RXD e GND.
3. Conecte a placa USB a serie ao PC.
4. Conecte a placa de proba de RF ao PC ou a un adaptador de alimentación para activar a fonte de alimentación de 5 V a través do cable Micro-USB.
5. Durante a descarga, conecte IO0 a GND mediante un puente. A continuación, activa o taboleiro de probas.
6. Descargar firmware en flash. Para obter máis información, consulte as seccións a continuación.
7. Despois da descarga, elimina o puente en IO0 e GND.
8. Enciende de novo a placa de proba de RF. ESP32-MINI-1 cambiará ao modo de traballo. O chip lerá programas desde o flash despois da inicialización.

Nota:
IO0 é internamente alto. Se IO0 está configurado como pull-up, selecciónase o modo de arranque. Se este alfinete está desplegable ou deixa flotando, seleccionouse o modo Descarga. Para obter máis información sobre ESP32-MINI-1, consulte a folla de datos ESP32-MINI-1.

2.3 Configurar o contorno de desenvolvemento
O Espressif IoT Development Framework (ESP-IDF para abreviar) é un marco para desenvolver aplicacións baseado no Espressif ESP32. Os usuarios poden desenvolver aplicacións con ESP32 en Windows/Linux/macOS baseadas en ESP-IDF. Aquí tomamos o sistema operativo Linux como exemploample.

2.3.1 Requisitos previos de instalación
Para compilar con ESP-IDF necesitas obter os seguintes paquetes:

• CentOS 7:
  sudo yum install git wget flex bison gperf python cmake ninja-build ccache dfu-util
• Ubuntu e Debian (un comando divídese en dúas liñas):
  sudo apt−get install git wget flex bison gperf python python−pip python−setuptools cmake ninja −build-cache libffi −dev libssl −dev dfu−util
• Arco:
  sudo Pacman −S −−necesario gcc git make flex bison gperf python−pip cmake ninja ccache dfu−util
  Nota:
• Esta guía usa o directorio ~/esp en Linux como cartafol de instalación de ESP-IDF.
• Teña en conta que ESP-IDF non admite espazos nos camiños.

2.3.2 Obter ESPIDF
Para crear aplicacións para o módulo ESP32-MINI-1, necesitas as bibliotecas de software proporcionadas por Espressif en Repositorio ESP-IDF.
Para obter ESP-IDF, cree un directorio de instalación ( ~/esp) para descargar ESP-IDF e clone o repositorio con 'git clone':
mkdir −p ~/esp
cd ~/esp
git clone −−recursivo https://github.com/espressif/esp−idf.git

ESP-IDF descargarase en ~/esp/esp-idf. Consultar Versións ESP-IDF para obter información sobre a versión de ESP-IDF a utilizar nunha situación determinada.

2.3.3 Configurar ferramentas
Ademais do ESP-IDF, tamén cómpre instalar as ferramentas utilizadas por ESP-IDF, como o compilador, o depurador,
Paquetes Python, etc. ESP-IDF proporciona un script chamado 'install.sh' para axudar a configurar as ferramentas dunha soa vez.
cd ~/esp/esp−idf
./ instalar .sh
2.3.4 Configurar variables de ambiente
As ferramentas instaladas aínda non se engadiron á variable de ambiente PATH. Para que as ferramentas sexan utilizables desde a liña de comandos, débense establecer algunhas variables de ambiente. ESP-IDF proporciona outro script 'export.sh' que fai iso. No terminal onde vai usar ESP-IDF, executa:
. $HOME/esp/esp−idf/export.sh

Agora todo está listo, podes construír o teu primeiro proxecto no módulo ESP32-MINI-1.
2.4 Crea o teu primeiro proxecto
2.4.1 Iniciar un proxecto
Agora está preparado para preparar a súa solicitude para o módulo ESP32-MINI-1. Podes comezar co comezar/hello_world proxecto do exampdirectorio les en ESP-IDF.
Copia get-started/hello_world no directorio ~/esp:
cd ~/esp
cp −r $IDF_PATH/examples/get−started/hello_world .

Hai unha gama de example proxectos no examples directorio en ESP-IDF. Pode copiar calquera proxecto do mesmo xeito que se presentou anteriormente e executalo. Tamén é posible construír examples no lugar, sen copialos primeiro.

2.4.2 Conecta o teu dispositivo
Agora conecte o seu módulo ESP32-MINI-1 ao ordenador e comprobe en que porto serie está visible o módulo. Os portos serie en Linux comezan con '/dev/tty' nos seus nomes. Executa o seguinte comando dúas veces, primeiro coa placa desenchufada, despois coa enchufada. O porto que aparece a segunda vez é o que necesitas:
ls /dev/tty*
Nota:
Mantén o nome do porto a man xa que o necesitarás nos seguintes pasos.

2.4.3 Configurar
Navega ata o teu directorio 'hello_world' desde o paso 2.4.1. Inicie un proxecto, configure o chip ESP32 como destino e execute
utilidade de configuración do proxecto 'menuconfig'.
cd ~/esp/hello_world
idf .py set−target esp32
idf .py menuconfig
Establecer o destino con 'idf.py set-target esp32' debería facerse unha vez, despois de abrir un novo proxecto. Se o proxecto contén algunhas compilacións e configuracións existentes, borraranse e inicializaranse. O destino pódese gardar na variable de ambiente para omitir este paso. Consulte Selección do destino para obter información adicional.
Se os pasos anteriores se realizaron correctamente, aparecerá o seguinte menú:

As cores do menú poden ser diferentes no teu terminal. Podes cambiar a aparencia coa opción '–style'. Executa "idf.py menuconfig –help" para obter máis información.

2.4.4 Construír o Proxecto
Constrúe o proxecto executando:
compilación idf .py
Este comando compilará a aplicación e todos os compoñentes ESP-IDF, despois xerará o cargador de arranque, a táboa de particións e os binarios da aplicación.
$ idf .py compilar
Executando cmake no directorio /path/to/hello_world/build
Executando "cmake −G Ninja −−warn−non inicializado /path/to/hello_world"...
Avisar sobre valores non inicializados.
−− Git atopado: /usr/bin/git (versión atopada "2.17.0")
−− Creando un compoñente aws_iot baleiro debido á configuración
−− Nomes dos compoñentes: …
−− Camiños dos compoñentes: …
… (máis liñas de saída do sistema de compilación) [527/527] Xerando ola −world.bin esptool .py v2.3.1
Completouse a construción do proxecto. Para flashear, executa este comando:
../../../ 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 ou executa ' idf .py −p PORT flash'

Se non hai erros, a compilación rematará xerando o firmware binario .bin file.
2.4.5 Flashear no dispositivo
Flashea os binarios que acabas de construír no teu módulo ESP32-MINI-1 executando:
idf .py −p PORT [−b BAUD] flash
Substitúe PORT co nome do porto serie do módulo do Paso: Conecte o dispositivo. Tamén pode cambiar a velocidade en baudios do intermitente substituíndo BAUD pola velocidade en baudios que necesite. A taxa de transmisión predeterminada é 460800.
Para obter máis información sobre os argumentos de idf.py, consulte idf.py.
Nota:
A opción "flash" constrúe e fai flash automaticamente o proxecto, polo que non é necesario executar "idf.py build".

Executando esptool.py no directorio […]/esp/hello_world
Executando ”python […]/ esp−idf/components/esptool_py/esptool/esptool.py −b 460800 write_flash
@flash_project_args ”…
esptool .py −b 460800 write_flash −−flash_mode dio −−flash_size detect −−flash_freq 40m 0x1000
cargador de arranque/cargador de arranque. bin 0x8000 partition_table / partition −table.bin 0x10000 hello−world.bin
esptool .py v2.3.1
Conectando….
Detectando tipo de chip... ESP32
O chip é ESP32U4WDH (revisión 3)
Características: WiFi, BT, núcleo único
Cargando talón...
Esbozo de execución...
Estubo correndo...
Cambiando a velocidade en baudios a 460800
Cambiado.
Configurando o tamaño do flash...
Tamaño do flash detectado automaticamente: 4 MB
Parámetros de flash establecidos en 0x0220
Comprimido 22992 bytes a 13019...
Escribiu 22992 bytes (13019 comprimidos) en 0x00001000 en 0.3 segundos (efectivo 558.9 kbit/s)...
Comprobouse o hash de datos.
Comprimido 3072 bytes a 82...
Escribiu 3072 bytes (82 comprimidos) en 0x00008000 en 0.0 segundos (efectivo 5789.3 kbit/s)...
Comprobouse o hash de datos.
Comprimido 136672 bytes a 67544...
Escribiu 136672 bytes (67544 comprimidos) en 0x00010000 en 1.9 segundos (efectivo 567.5 kbit/s)...
Comprobouse o hash de datos.
Saíndo…
Restablecemento completo mediante pin RTS...
Se todo vai ben, a aplicación "hello_world" comezará a executarse despois de quitar o jumper de IO0 e GND e volver a encender a placa de proba.
2.4.6 Monitor
Para comprobar se "hello_world" está en execución, escriba 'idf.py -p PORT monitor' (non esqueza substituír PORT co nome do seu porto serie).
Este comando inicia a aplicación IDF Monitor:
$ idf .py −p /dev/ttyUSB0 monitor
Executando idf_monitor no directorio […]/esp/hello_world/build
Executando ”python […]/ esp−idf/tools/idf_monitor.py −b 115200 […]/ esp/hello_world/build/ hello −world. elfo "...
−−− idf_monitor en /dev/ttyUSB0 115200 −−−−−
Saír: Ctrl+] | Menú: Ctrl+T | Axuda: Ctrl+T seguido de Ctrl+H −−ets
8 de xuño de 2016 00:22:57
primeiro :0x1 ​​(POWERON_RESET), arranque:0x13 (SPI_FAST_FLASH_BOOT)
8 de xuño de 2016 ás 00:22:57…
Despois de que os rexistros de inicio e diagnóstico se despracen cara arriba, deberías ver "Ola mundo!" impreso pola aplicación.
…
Ola mundo!
Reiniciando en 10 segundos...
Este é un chip esp32 con 1 núcleo de CPU, WiFi/BT/BLE, revisión de silicona 3, flash externo de 4MB
Reiniciando en 9 segundos...
Reiniciando en 8 segundos...
Reiniciando en 7 segundos...
Para saír do monitor IDF use o atallo Ctrl+].
Isto é todo o que precisa para comezar co módulo ESP32-MINI-1! Agora estás listo para probar outro examples en ESP-IDF, ou vai directamente a desenvolver as túas propias aplicacións.

Recursos de aprendizaxe

3.1 Documentos obrigatorios
A seguinte ligazón ofrece documentos relacionados co ESP32.

• Folla de datos ESP32
  Este documento ofrece unha introdución ás especificacións do hardware ESP32, incluíndo máisview,
  definicións de pin, descrición funcional, interface periférica, características eléctricas, etc.
• Guía de usuario ESP32 ECO V3
  Este documento describe as diferenzas entre as revisións V3 e anteriores das obleas de silicio ESP32.
• ECO e solucións para erros en ESP32
  Este documento detalla as erratas de hardware e as solucións alternativas no ESP32.
• Guía de programación ESP-IDF
  Alberga unha ampla documentación para ESP-IDF que vai desde guías de hardware ata referencias de API.
• Manual técnico de referencia ESP32
  O manual ofrece información detallada sobre como usar a memoria ESP32 e os periféricos.
• Recursos de hardware ESP32
  O zip files inclúen os esquemas, o deseño de PCB, Gerber e a lista de BOM dos módulos ESP32 e placas de desenvolvemento.
• Pautas de deseño de hardware ESP32
  As directrices describen as prácticas de deseño recomendadas ao desenvolver sistemas autónomos ou complementarios baseados na serie de produtos ESP32, incluído o chip ESP32, os módulos ESP32 e as placas de desenvolvemento.
• Conxunto de instrucións ESP32 AT e Examples
  Este documento presenta os comandos ESP32 AT, explica como usalos e proporciona examparquivos de varios comandos AT comúns.
• Información de pedido de produtos Espressif

3.2 Recursos imprescindibles
Aquí tes os recursos imprescindibles relacionados co ESP32.

• ESP32 BBS
  Esta é unha comunidade de enxeñeiro a enxeñeiro (E2E) para ESP32 onde podes publicar preguntas, compartir coñecementos, explorar ideas e axudar a resolver problemas con compañeiros enxeñeiros.
• ESP32 GitHub
  Os proxectos de desenvolvemento ESP32 distribúense libremente baixo a licenza MIT de Espressif en GitHub. Establécese para axudar aos desenvolvedores a comezar con ESP32 e fomentar a innovación e o crecemento do coñecemento xeral sobre o hardware e o software que rodean os dispositivos ESP32.
• Ferramentas ESP32
  Este é un webpáxina onde os usuarios poden descargar ESP32 Flash Download Tools e o zip file "Certificación e proba ESP32".
• ESP-IDF
  Isto webA páxina enlaza os usuarios ao marco oficial de desenvolvemento de IoT para ESP32.
• Recursos ESP32
  Isto webA páxina ofrece ligazóns a todos os documentos, SDK e ferramentas ESP32 dispoñibles.

Historial de revisións

Data	Versión	Notas de lanzamento
2021-01-14	V0.1	Liberación preliminar

www.espressif.com

Aviso de exención de responsabilidade e copyright
Información deste documento, incluíndo URL referencias, está suxeita a cambios sen previo aviso.
TODA A INFORMACIÓN DE TERCEIRAS NESTE DOCUMENTO PROPORCIONASE TAL COMO SEN GARANTÍAS SOBRE A SÚA AUTENTICIDADE E PRECISIÓN.
A ESTE DOCUMENTO NON SE OFRECE NINGUNHA GARANTÍA POLA SÚA COMERCIABILIDADE, NON INFRACCIÓN, ADECUACIÓN PARA NINGÚN FIN PARTICULAR, NIN NINGUNHA GARANTÍA DERIVADA DE NINGUNHA PROPOSTA, ESPECIFICACIÓN OU ​​S.AMPLE.
Declinan toda responsabilidade, incluída a responsabilidade pola infracción de calquera dereito de propiedade, relacionada co uso da información deste documento. Non se conceden licenzas expresas ou implícitas, por exclusión ou doutra forma, de ningún dereito de propiedade intelectual.
O logotipo do membro da Wi-Fi Alliance é unha marca comercial de Wi-Fi Alliance. O logotipo de Bluetooth é unha marca rexistrada de Bluetooth SIG.
Todos os nomes comerciais, marcas comerciais e marcas rexistradas mencionados neste documento son propiedade dos seus respectivos propietarios e, polo presente, recoñécense.
Copyright © 2021 Espressif Systems (Shanghai) Co., Ltd. Todos os dereitos reservados.

Sistemas Espressif
Manual de usuario ESP32-MINI-1 (v0.1 preliminar)
www.espressif.com

Documentos/Recursos

ESPRESSIF ESP32-MINI-1 Módulo Wi-Fi+Bluetooth de pequeno tamaño altamente integrado [pdfManual do usuario ESP32MINI1, 2AC7Z-ESP32MINI1, 2AC7ZESP32MINI1, ESP32 -MINI -1 Módulo Bluetooth Wi-Fi de pequeno tamaño altamente integrado, ESP32 -MINI -1, Módulo Bluetooth de Wi-Fi de pequeno tamaño altamente integrado

Referencias

• Manual de usuario