ESP32MINI1
Brugermanual
Foreløbig v0.1
Espressif systemer
Copyright © 2021
Om denne manual
Denne brugervejledning viser, hvordan du kommer i gang med ESP32-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 leverer e-mail-notifikationer for at holde kunderne 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
1.1 Modul overview
LE MCU-modul, der har et rigt sæt periferiudstyr. Dette modul er et ideelt valg til en bred vifte af IoT-applikationer, lige fra hjemmeautomatisering, smart bygning, forbrugerelektronik til industriel kontrol, specielt velegnet til applikationer i et kompakt rum, såsom pærer, kontakter og fatninger. ESP32-MINI-1 er en meget integreret, lille Wi-Fi+Bluetooth ® +Bluetooth ® Dette modul kommer i to versioner:
- 85 °C version
- 105 °C version
Tabel 1. Specifikationer for ESP1MINI32
| Kategorier | genstande | Specifikationer |
|
Wi-Fi |
Protokoller | 802.11 b/g/n (802.11n op til 150 Mbps) |
| A-MPDU og A-MSDU aggregering og 0.4 µs vagtintervalstøtte | ||
| Frekvensområde | 2412 ~ 2484 MHz | |
|
Bluetooth® |
Protokoller | Protokoller v4.2 BR/EDR og Bluetooth® LE specifikationer |
| Radio | Klasse-1, klasse-2 og klasse-3 sender | |
| AFH | ||
| Lyd | CVSD og SBC | |
|
Hardware |
Modulgrænseflader |
SD-kort, UART, SPI, SDIO, I2C, LED PWM, Motor PWM, I2S, infrarød fjernbetjening, pulstæller, GPIO, berøringssensor, ADC, DAC, Two-Wire Automotive Interface (TWAI)TM, kompatibel med ISO11898-1) |
| Integreret krystal | 40 MHz krystal | |
| Integreret SPI flash | 4 MB | |
| Operation voltage/Strømforsyning | 3.0 V ~ 3.6 V | |
| Driftsstrøm | Gennemsnit: 80 mA | |
| Minimum strøm leveret af strømforsyningen | 500 mA | |
| Anbefalet driftstemperaturområde | 85 °C version: –40 °C ~ +85 °C; 105 °C version: –40 °C ~ +105 °C | |
| Fugtfølsomhedsniveau (MSL) | Niveau 3 |
1.2 Beskrivelse af ben
ESP32-MINI-1 har 55 ben. Se pindefinitioner i tabel 1-2.
Tabel 1. Pin-definitioner
| Navn | Ingen. | Type | Fungere |
| GND | 1, 2, 27, 38 ~ 55 | P | Jord |
| 3V3 | 3 | P | Strømforsyning |
| 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 |
Høj: aktiverer chippen Lav: chippen slukker Note: lad ikke stiften blive svævende |
| I34 | 9 | I | GPIO34, ADC1_CH6, RTC_GPIO4 |
| I35 | 10 | I | GPIO35, ADC1_CH7, RTC_GPIO5 |
| IO32 | 11 | I/O | GPIO32, XTAL_32K_P (32.768 kHz krystaloscillatorindgang), ADC1_CH4, TOUCH9, RTC_GPIO9 |
| IO33 | 12 | I/O | GPIO33, XTAL_32K_N (32.768 kHz krystaloscillatorudgang), ADC1_CH5, TOUCH8, RTC_GPIO8 |
| IO25 | 13 | I/O | GPIO25, DAC_1, ADC2_CH8, RTC_GPIO6, EMAC_RXD0 |
| IO26 | 14 | I/O | GPIO26, DAC_2, ADC2_CH9, RTC_GPIO7, EMAC_RXD1 |
| IO27 | 15 | I/O | GPIO27, ADC2_CH7, TOUCH7, RTC_GPIO17, EMAC_RX_DV |
| IO14 | 16 | I/O | GPIO14, ADC2_CH6, TOUCH6, RTC_GPIO16, MTMS, HSPICLK, HS2_CLK, SD_CLK, EMAC_TXD2 |
| IO12 | 17 | I/O | GPIO12, ADC2_CH5, TOUCH5, RTC_GPIO15, MTDI, HSPIQ, HS2_DATA2, SD_DATA2, EMAC_TXD3 |
| IO13 | 18 | I/O | GPIO13, ADC2_CH4, TOUCH4, RTC_GPIO14, MTCK, HSPID, HS2_DATA3, SD_DATA3, EMAC_RX_ER |
| IO15 | 19 | I/O | GPIO15, ADC2_CH3, TOUCH3, RTC_GPIO13, MTDO, HSPICS0, HS2_CMD, SD_CMD, EMAC_RXD3 |
| IO2 | 20 | I/O | GPIO2, ADC2_CH2, TOUCH2, RTC_GPIO12, HSPIWP, HS2_DATA0,
SD_DATA0 |
| IO0 | 21 | I/O | GPIO0, ADC2_CH1, TOUCH1, RTC_GPIO11, CLK_OUT1, EMAC_TX_CLK |
| IO4 | 22 | I/O | GPIO4, ADC2_CH0, TOUCH0, RTC_GPIO10, HSPIHD, HS2_DATA1, SD_DATA1, EMAC_TX_ER |
| NC | 23 | – | Ingen forbindelse |
| NC | 24 | – | Ingen forbindelse |
| IO9 | 25 | I/O | GPIO9, HS1_DATA2, U1RXD, SD_DATA2 |
| IO10 | 26 | I/O | GPIO10, HS1_DATA3, U1TXD, SD_DATA3 |
| NC | 28 | – | Ingen forbindelse |
| IO5 | 29 | I/O | GPIO5, HS1_DATA6, VSPICS0, EMAC_RX_CLK |
| IO18 | 30 | I/O | GPIO18, HS1_DATA7, VSPICLK |
| IO23 | 31 | I/O | GPIO23, HS1_STROBE, VSPID |
| IO19 | 32 | I/O | GPIO19, VSPIQ, U0CTS, EMAC_TXD0 |
Fortsættes på næste side
Tabel 1 – fortsat fra forrige side
| Navn | Ingen. | Type | Fungere |
| IO22 | 33 | I/O | GPIO22, VSPIWP, U0RTS, EMAC_TXD1 |
| IO21 | 34 | I/O | GPIO21, VSPIHD, EMAC_TX_EN |
| RXD0 | 35 | I/O | GPIO3, U0RXD, CLK_OUT2 |
| TXD0 | 36 | I/O | GPIO1, U0TXD, CLK_OUT3, EMAC_RXD2 |
| NC | 37 | – | Ingen forbindelse |
¹ Pins GPIO6, GPIO7, GPIO8, GPIO11, GPIO16 og GPIO17 på ESP32-U4WDH-chippen er forbundet til SPI-flashen integreret på modulet og føres ikke ud.
² For konfigurationer af perifere ben, se venligst Datablad i ESP32-serien.
Kom godt i gang med ESP32MINI1
2.1 Hvad du har brug for
For at udvikle applikationer til ESP32-MINI-1-modulet har du brug for:
- 1 x ESP32-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.
2.2 Hardwareforbindelse
- Lod ESP32-MINI-1-modulet til RF-testkortet som vist i figur 2-1.
- 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-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 pin er nedtrukket eller venstresvævende, vælges Download-tilstanden. For mere information om ESP32-MINI-1, se venligst ESP32-MINI-1 datablad.
2.3 Opsæt udviklingsmiljø
Espressif IoT Development Framework (forkortet ESP-IDF) er en ramme til udvikling af applikationer baseret på Espressif ESP32. Brugere kan udvikle applikationer med ESP32 i Windows/Linux/macOS baseret på ESP-IDF. Her tager vi Linux styresystem som en example.
2.3.1 Installationskrav
For at kompilere med ESP-IDF skal du have følgende pakker:
- CentOS 7:
sudo yum installer git wget flex bison gperf python cmake ninja−build ccache dfu−util - Ubuntu og Debian (en kommando opdeles i to linjer):
sudo apt−get install git wget flex bison gperf python python−pip python−setuptools cmake ninja −build-cache libffi −dev libssl −dev dfu−util - Bue:
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.
2.3.2 Hent ESPIDF
For at bygge applikationer til ESP32-MINI-1-modulet skal du bruge softwarebibliotekerne fra Espressif i ESP-IDF repository.
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 clone −−rekursiv https://github.com/espressif/esp−idf.git
ESP-IDF vil blive downloadet til ~/esp/esp-idf. Konsultere ESP-IDF versioner for information om, hvilken ESP-IDF version der skal bruges i en given situation.
2.3.3 Opsætning af værktøjer
Bortset fra ESP-IDF, skal du også installere de værktøjer, der bruges af ESP-IDF, såsom compileren, 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å én gang.
cd ~/esp/esp−idf
./ installer .sh
2.3.4 Opsæt 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-MINI-1-modulet.
2.4 Opret dit første projekt
2.4.1 Start et projekt
Nu er du klar til at forberede din ansøgning til ESP32-MINI-1-modulet. Du kan starte med kom i gang/hello_world projekt fra examples bibliotek i ESP-IDF.
Kopier get-started/hello_world til ~/esp bibliotek:
cd ~/esp
cp −r $IDF_PATH/examples/get−started/hello_world .
Der er en række af 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 examples på plads uden at kopiere dem først.
2.4.2 Tilslut din enhed
Tilslut nu dit ESP32-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 kortet afbrudt, derefter med tilsluttet. Den port, 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.
2.4.3 Konfigurer
Naviger til din 'hello_world'-mappe fra trin 2.4.1. Start et projekt, indstil ESP32-chippen som målet, og kør
projektkonfigurationsværktøjet 'menuconfig'.
cd ~/esp/hello_world
idf .py set−target esp32
idf .py menuconfig
Indstilling af målet med 'idf.py set-target esp32' skal gø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:
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.
2.4.4 Byg projektet
Byg projektet ved at køre:
idf .py build
Denne kommando vil kompilere applikationen og alle ESP-IDF-komponenter, derefter genererer den 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 byggesystemoutput) [527/527] Genererer 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.
2.4.5 Flash på enheden
Flash de binære filer, som du lige har bygget på dit ESP32-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.
Note:
Indstillingen 'flash' bygger og blinker automatisk projektet, så det er ikke nødvendigt at køre 'idf.py build'.
Kører esptool.py i mappen […]/ esp/hello_world
Udfører ”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
bootloader/bootloader. bin 0x8000 partition_table / partition −table.bin 0x10000 hello−world.bin
esptool .py v2.3.1
Tilslutning ….
Registrerer chiptype … ESP32
Chip er ESP32U4WDH (revision 3)
Funktioner: WiFi, BT, Single Core
Uploader stub...
Løbende stub...
Stub kører…
Ændring af baudrate til 460800
Ændret.
Konfigurerer flashstørrelse...
Auto-detekteret Flash-størrelse: 4MB
Flash-parametre indstillet til 0x0220
Komprimeret 22992 bytes til 13019...
Skrev 22992 bytes (13019 komprimeret) ved 0x00001000 på 0.3 sekunder (effektiv 558.9 kbit/s)...
Hash af data verificeret.
Komprimeret 3072 bytes til 82...
Skrev 3072 bytes (82 komprimeret) ved 0x00008000 på 0.0 sekunder (effektiv 5789.3 kbit/s)...
Hash af data verificeret.
Komprimeret 136672 bytes til 67544...
Skrev 136672 bytes (67544 komprimeret) ved 0x00010000 på 1.9 sekunder (effektiv 567.5 kbit/s)...
Hash af data verificeret.
Forlader …
Hård nulstilling via RTS-pin...
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.
2.4.6 skærm
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. nisse "…
−−− 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
fø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 esp32-chip med 1 CPU-kerne, WiFi/BT/BLE, siliciumrevision 3, 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-MINI-1-modulet! Nu er du klar til at prøve noget andet examples i ESP-IDF, eller gå direkte til at udvikle dine egne applikationer.
Læringsressourcer
3.1 Dokumenter, der skal læses
Følgende link indeholder dokumenter relateret til ESP32.
- ESP32 datablad
Dette dokument giver en introduktion til specifikationerne for ESP32-hardwaren, inklusive overview,
pindefinitioner, funktionsbeskrivelse, perifert interface, elektriske karakteristika mv. - ESP32 ECO V3 brugervejledning
Dette dokument beskriver forskelle mellem V3 og tidligere ESP32 silicium wafer revisioner. - ECO og løsninger til fejl i ESP32
Dette dokument beskriver hardwarefejl og løsninger i ESP32. - ESP-IDF programmeringsvejledning
Det er vært for omfattende dokumentation for ESP-IDF lige fra hardwarevejledninger til API-reference. - ESP32 teknisk referencemanual
Manualen giver detaljerede oplysninger om, hvordan du bruger ESP32-hukommelsen og ydre enheder. - ESP32 hardwareressourcer
Lynlåsen files omfatter skemaer, PCB-layout, Gerber og stykliste over ESP32-moduler og udviklingstavler. - ESP32 Hardware Design Retningslinjer
Retningslinjerne skitserer anbefalede designpraksis ved udvikling af selvstændige eller tilføjelsessystemer baseret på ESP32-serien af produkter, herunder ESP32-chippen, ESP32-modulerne og udviklingskort. - ESP32 AT Instruktionssæt og Examples
Dette dokument introducerer ESP32 AT-kommandoer, forklarer, hvordan man bruger dem, og giver f.eksamples af flere almindelige AT-kommandoer. - Bestillingsoplysninger om espressif-produkter
3.2 MustHave-ressourcer
Her er de ESP32-relaterede must-have ressourcer.
- ESP32 BBS
Dette er et Engineer-to-Engineer-fællesskab (E2E) til ESP32, hvor du kan stille spørgsmål, dele viden, udforske ideer og hjælpe med at løse problemer med andre ingeniører. - ESP32 GitHub
ESP32-udviklingsprojekter distribueres frit under Espressifs MIT-licens på GitHub. Det er etableret for at hjælpe udviklere med at komme i gang med ESP32 og fremme innovation og vækst af generel viden om hardware og software omkring ESP32-enheder. - ESP32 værktøjer
Dette er en webside, hvor brugere kan downloade ESP32 Flash Download Tools og zip file "ESP32 certificering og test".. - ESP-IDF
Denne webside linker brugere til den officielle IoT-udviklingsramme for ESP32. - ESP32 ressourcer
Denne websiden indeholder links til alle tilgængelige ESP32-dokumenter, SDK og værktøjer.
Revisionshistorie
| Dato | Version | Udgivelsesbemærkninger |
| 2021-01-14 | 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 NOGET FORSLAG, SPECIFIKATION ELLERAMPLE.
Ethvert ansvar, herunder ansvar for krænkelse af enhver ejendomsret, i forbindelse med 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 anerkendes hermed.
Copyright © 2021 Espressif Systems (Shanghai) Co., Ltd. Alle rettigheder forbeholdes.
Espressif systemer
ESP32-MINI-1 brugermanual (foreløbig v0.1)
www.espressif.com
Dokumenter/ressourcer
 |
ESPRESSIF ESP32-MINI-1 Meget integreret lille Wi-Fi+Bluetooth-modul [pdfBrugermanual ESP32MINI1, 2AC7Z-ESP32MINI1, 2AC7ZESP32MINI1, ESP32 -MINI -1 Meget integreret lille Wi-Fi Bluetooth-modul, ESP32 -MINI -1, meget integreret lille Wi-Fi Bluetooth-modul |
