ESPRESSIF ESP32-C3-MINI-1 Wi-Fi и Bluetooth модул Интернет на нещата Ръководство за потребителя
Относно този документ
Това ръководство за потребителя показва как да започнете с модула ESP32-C3-MINI-1.
Актуализации на документи
Моля, винаги препращайте към най-новата версия на https://www.espressif.com/en/support/download/documents.
История на ревизиите
За историята на ревизиите на този документ, моля, вижте последната страница.
Уведомление за промяна на документацията
Espressif предоставя известия по имейл, за да ви държи в течение за промените в техническата документация. Моля, абонирайте се на www.espressif.com/en/subscribe.
Сертификация
Изтеглете сертификати за продукти Espressif от www.espressif.com/en/certificates
крайview
- Модулът приключиview
ESP32-C3-MINI-1 е Wi-Fi и Bluetooth LE модул с общо предназначение. Богатият набор от периферни устройства и малкият размер правят този модул идеален избор за интелигентни домове, индустриална автоматизация, здравеопазване, потребителска електроника и др.
Таблица 1: Спецификации на ESP32C3MINI1
Категории Параметри Спецификации Wi-Fi протоколи 802.11 b/g/n (до 150 Mbps) Честотен диапазон 2412 ~ 2462 MHz Bluetooth® протоколи Bluetooth® LE: Bluetooth 5 и Bluetooth мрежа Радио Предавател клас-1, клас-2 и клас-3 Хардуер
Модулни интерфейси GPIO, SPI, UART, I2C, I2S, периферно устройство за дистанционно управление, LED PWM контролер, общ DMA контролер, TWAI® контролер (съвместим с ISO 11898-1), температурен сензор, SAR ADC Интегриран кристал 40 MHz кристал Работен обемtagд/Захранване 3.0 V ~ 3.6 V Работен ток Средно: 80 mA Минимален ток, доставян от захранването доставка
500 mA Температура на околната среда –40 °C ~ +105 °C Ниво на чувствителност към влага (MSL) Ниво 3 - ПИН Описание
Фигура 1: Оформление на щифтове (отгоре View)
Модулът има 53 пина. Вижте дефинициите на щифтове в Таблица 2.
За конфигурации на периферни щифтове, моля, вижте листа с данни за семейството ESP32-C3.
Таблица 2: Дефиниции на щифтове
Име не Тип функция GND 1, 2, 11, 14, 36-53 P Земя 3V3 3 P Захранване 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
Високо: включено, активира чипа. Ниско: изключено, чипът се изключва. Забележка: Не оставяйте щифта 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
Започнете с ESP32C3MINI1
Какво ви трябва
За разработване на приложения за модул ESP32-C3-MINI-1 са ви необходими:
- 1 x ESP32-C3-MINI-1 модул
- 1 x Espressif RF тестова дъска
- 1 x USB-към-серийна платка
- 1 x Micro-USB кабел
- 1 x компютър с Linux
В това ръководство за потребителя ние приемаме операционната система Linux като примерampле За повече информация относно конфигурацията на Windows и macOS, моля, вижте Ръководството за програмиране на ESP-IDF.
Хардуерна връзка
- Запоете модула ESP32-C3-MINI-1 към RF тестовата платка, както е показано на Фигура 2.
- Свържете платката за RF тестване към платката USB-to-Serial чрез TXD, RXD и GND.
- Свържете USB към серийната платка към компютъра.
- Свържете RF тестовата платка към компютъра или захранващ адаптер, за да активирате 5 V захранване, чрез Micro-USB кабел.
- По време на изтегляне свържете IO0 към GND чрез джъмпер. След това включете тестовата платка.
- Изтеглете фърмуера във флаш. За подробности вижте секциите по-долу.
- След изтегляне премахнете джъмпера на IO0 и GND.
- Включете отново RF тестовата платка. ESP32-C3-MINI-1 ще премине в работен режим. Чипът ще чете програми от флаш при инициализация.
Забележка
IO0 е вътрешно логически висок. Ако IO0 е настроен на изтегляне, се избира режимът на стартиране. Ако този щифт е падащ надолу или е оставен да плава,
Избран е режим на изтегляне. За повече информация относно ESP32-C3 MINI-1, моля, вижте листа с данни на ESP32-C3-MINI-1.
Настройте среда за разработка
Espressif IoT Development Framework (ESP-IDF за кратко) е рамка за разработване на приложения, базирани на чиповете Espressif. Потребителите могат да разработват приложения с ESP чипове в Windows/Linux/macOS, базирани на ESP-IDF. Тук ние приемаме операционната система Linux като примерampле.
- Инсталирайте предварителните условия
За да компилирате с ESP-IDF, трябва да получите следните пакети:- CentOS 7:
1 sudo yum инсталирайте git wget flex bison gperf python cmake ninja-build ccache dfuutil - Ubuntu и Debian (една команда се разделя на два реда):
- sudo apt-get инсталирате git wget flex bison gperf python python-pip pythonsetuptools cmake
- ninja-build ccache libffi-dev libssl-dev dfu-util
- Арка:
- 1 sudo pacman -S –необходим gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
Забележка - Това ръководство използва директорията ~/esp на Linux като инсталационна папка за ESP-IDF.
- Имайте предвид, че ESP-IDF не поддържа интервали в пътеки.
- 1 sudo pacman -S –необходим gcc git make flex bison gperf python-pip cmake ninja ccache dfu-util
- CentOS 7:
- Вземете ESPIDF
За да създавате приложения за модула ESP32-C3-MINI-1, имате нужда от софтуерните библиотеки, предоставени от Espressif в ESP-IDF хранилището.
За да получите ESP-IDF, създайте инсталационна директория (~/esp), за да изтеглите ESP-IDF и клонирайте хранилището с 'git clone':- mkdir -p ~/esp
- cd ~/особено
- git клонинг – рекурсивен https://github.com/espressif/esp-idf.git
ESP-IDF ще бъде изтеглен в ~/esp/esp-idf. Консултирайте се с ESP-IDF версии за информация коя версия на ESP-IDF да използвате в дадена ситуация.
- Настройте инструменти
Освен ESP-IDF, вие също трябва да инсталирате инструментите, използвани от ESP-IDF, като компилатор, дебъгер, Python пакети и т.н. ESP-IDF предоставя скрипт с име 'install.sh', за да помогне за настройката на инструментите наведнъж.- cd ~/esp/esp-idf
- /install.sh
- Настройте променливи на средата
Инсталираните инструменти все още не са добавени към променливата на средата PATH. За да направите инструментите използваеми от командния ред, трябва да бъдат зададени някои променливи на средата. ESP-IDF предоставя друг скрипт 'export.sh', който прави това. В терминала, където ще използвате ESP-IDF, стартирайте:- $HOME/esp/esp-idf/export.sh
Сега всичко е готово, можете да изградите първия си проект върху модул ESP32-C3 MINI-1.
- $HOME/esp/esp-idf/export.sh
Създайте своя първи проект
- Стартирайте проект
Вече сте готови да подготвите вашето приложение за модул ESP32-C3-MINI-1. Можете да започнете с проект get-started/hello_world от examples директория в ESP-IDF.
Копирайте get-started/hello_world в директория ~/esp:- cd ~/особено
- cp -r $IDF_PATH/прamples/get-started/hello_world .
Има редица example проекти в examples директория в ESP-IDF. Можете да копирате всеки проект по същия начин, както е представен по-горе, и да го стартирате. Възможно е и изграждане на ексampфайловете на място, без първо да ги копирате.
Има редица example проекти в examples директория в ESP IDF. Можете да копирате всеки проект по същия начин, както е представен по-горе, и да го стартирате. Възможно е и изграждане на ексampфайловете на място, без първо да ги копирате.
- Свържете вашето устройство
Сега свържете вашия ESP32-C3-MINI-1 модул към компютъра и проверете под кой сериен порт се вижда модулът. Серийните портове в Linux започват с '/dev/tty' в имената си. Изпълнете командата по-долу два пъти, първо с
платката е изключена, след това с включена. Портът, който се появява втори път, е този, от който се нуждаете:- ls /dev/tty*
Забележка
Дръжте името на порта под ръка, тъй като ще ви трябва в следващите стъпки.
- ls /dev/tty*
- Конфигуриране
Придвижете се до вашата директория 'hello_world' от стъпка 2.4.1. Стартирайте проект, задайте ESP32-C3 като цел и стартирайте помощната програма за конфигуриране на проекта 'menuconfig'.- cd ~/esp/hello_world
- idf.py set-target esp32c3
- idf.py menuconfig
Задаването на целта с 'idf.py set-target esp32c3' трябва да се направи веднъж, след отваряне на нов проект. Ако проектът съдържа някои съществуващи компилации и конфигурации, те ще бъдат изчистени и инициализирани. Целта може да бъде запазена в променлива на средата, за да пропуснете тази стъпка изобщо. Вижте Избор на цел за допълнителна информация.
Ако предишните стъпки са извършени правилно, се появява следното меню:
Фигура 3: Начален прозорец за конфигуриране на проекта
Цветовете на менюто може да са различни във вашия терминал. Можете да промените външния вид с опцията '–style'. Моля, стартирайте 'idf.py menuconfig –help' за допълнителна информация
- Изградете проекта
Изградете проекта, като изпълните:- idf.py b
Тази команда ще компилира приложението и всички ESP-IDF компоненти, след което ще генерира буутлоудъра, таблицата на дяловете и двоичните файлове на приложението.- $ idf.py компилация
- Изпълняване на cmake в директория /път/към/hello_world/build
- Изпълнява се ”cmake -G Ninja –warn-uninitialized /path/to/hello_world”…
- Предупреждение за неинициализирани стойности.
- — Намерен Git: /usr/bin/git (намерена версия ”2.17.0”)
- — Изграждане на празен компонент aws_iot поради конфигурация
- — Имена на компоненти: …
- — Пътища на компонентите: …
- … (излязоха още редове на системата за изграждане
- [527/527] Генериране на hello-world.bin
- esptool.py v2.3.1
- Изграждането на проекта завършено. За да мигате, изпълнете тази команда:
- ../../../components/esptool_py/esptool/esptool.py -p (PORT) -b 921600 write_flash –flash_ режим дио
- –flash_size detect –flash_freq 40m 0x10000 build/hello world.bin build 0x1000
- build/bootloader/bootloader.bin 0x8000 build/partition_table/partition-table.bin
- или стартирайте 'idf.py -p PORT flash'
Ако няма грешки, компилацията ще завърши чрез генериране на двоичния фърмуер .bin file.
- idf.py b
- Flash върху устройството
Флаширайте двоичните файлове, които току-що сте изградили във вашия модул ESP32-C3-MINI-1, като изпълните:- idf.py -p PORT [-b BAUD] мига
Заменете PORT с името на серийния порт на вашия модул от Стъпка: Свържете вашето устройство.
Можете също да промените скоростта на предаване на мигане, като замените BAUD със скоростта на предаване, от която се нуждаете. Скоростта на предаване по подразбиране е 460800.
За повече информация относно аргументите idf.py вижте idf.py.
- idf.py -p PORT [-b BAUD] мига
Забележка
Опцията 'flash' автоматично изгражда и мига проекта, така че не е необходимо да изпълнявате 'idf.py build'.
- …
- 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/boot loader.bin 0x10000 здравей -world.bin
- esptool.py v3.0
- Сериен порт /dev/ttyUSB0
- Свързване...
- Чипът е ESP32-C3
- Характеристики: Wi-Fi
- Кристалът е 40MHz
- MAC: 7c:df:a1:40:02:a4
- Качване на мъничка...
- Изпълнява се мъничка...
- Стъпка работи…
- Промяна на скоростта на предаване на 460800
- Променено.
- Размерът на светкавицата се конфигурира…
- Компресирани 3072 байта до 103…
- Писане при 0x00008000... (100 %)
- Записа 3072 байта (103 компресирани) при 0x00008000 за 0.0 секунди (ефективни 4238.1 kbit/s)…
- Хешът на данните е проверен.
- Компресирани 18960 байта до 11311…
- Писане при 0x00000000... (100 %)
- Записа 18960 байта (11311 компресирани) при 0x00000000 за 0.3 секунди (ефективни 584.9 kbit/s)…
- Хешът на данните е проверен.
- Компресирани 145520 байта до 71984…
- Писане при 0x00010000... (20 %)
- Писане при 0x00014000... (40 %)
- Писане при 0x00018000... (60 %)
- Писане при 0x0001c000... (80 %)
- Писане при 0x00020000... (100 %)
- Написа 145520 байта (71984 компресирано) при 0x00010000 за 2.3 секунди (ефективно 504.4 kbit/s)…
- Хешът на данните е проверен.
- Напускане…
- Твърдо нулиране чрез RTS щифт...
- Готово
Ако всичко върви добре, приложението “hello_world” започва да работи, след като премахнете джъмпера на IO0 и GND и отново включите тестовата платка.
Монитор
За да проверите дали „hello_world“ наистина работи, въведете „idf.py -p PORT monitor“ (Не забравяйте да замените PORT с името на вашия сериен порт).
Тази команда стартира приложението IDF Monitor:
- $ idf.py -p /dev/ttyUSB0 монитор
- Изпълняване на idf_monitor в директория […]/esp/hello_world/build
- Изпълнение на ”python […]/esp-idf/tools/idf_monitor.py -b 115200 […]/esp/hello_world/build /hello-world.elf”…
- — idf_monitor на /dev/ttyUSB0 115200 —
- — Изход: Ctrl+] | Меню: Ctrl+T | Помощ: Ctrl+T последвано от Ctrl+H —
- ets 8 юни 2016 г. 00:22:57
- rst:0x1 (POWERON_RESET),зареждане:0x13 (SPI_FAST_FLASH_BOOT)
- ets 8 юни 2016 г. 00:22:57
- …
След като стартирате и диагностичните регистрационни файлове превъртите нагоре, трябва да видите „Здравей свят!“ разпечатан от приложението.
- …
- здравей свят!
- Рестартиране след 10 секунди…
- Това е esp32c3 чип с 1 CPU ядро, WiFi/BLE, 4MB външна флаш памет
- Рестартиране след 9 секунди…
- Рестартиране след 8 секунди…
- Рестартиране след 7 секунди…
За да излезете от монитора на IDF, използвайте прекия път Ctrl+].
Това е всичко, от което се нуждаете, за да започнете с модула ESP32-C3-MINI-1! Сега сте готови да опитате някой друг бившamples в ESP-IDF или отидете направо към разработването на свои собствени приложения.
Ресурси за обучение
- Трябва да прочетете документи
Моля, запознайте се със следните документи: - Лист с данни за семейството ESP32-C3
Това е въведение в спецификациите на хардуера ESP32-C3, включително overview, дефиниции на пинове,
функционално описание, периферен интерфейс, електрически характеристики и др. - Ръководство за програмиране на ESP-IDF
Обширна документация за рамката за разработка на ESP-IDF, варираща от ръководства за хардуер до API
справка. - ESP32-C3 Технически справочник
Подробна информация за това как да използвате паметта и периферните устройства ESP32-C3. - Информация за поръчка на продукти Espressif
Важни ресурси
Ето важните ресурси, свързани с ESP32-C3.
- ESP32 BBS
Общност от инженер към инженер (E2E) за продукти на Espressif, където можете да публикувате въпроси, да споделяте знания, да изследвате идеи и да помагате за решаването на проблеми с колеги инженери.
История на ревизиите
Дата |
Версия | Бележки по изданието |
2021-02-01 | V0.1 |
Предварително освобождаване |
Отказ от отговорност и известие за авторски права
Информация в този документ, включително URL препратки, подлежи на промяна без предизвестие.
ВСЯКАТА ИНФОРМАЦИЯ ЗА ТРЕТИ СТРАНИ В ТОЗИ ДОКУМЕНТ СЕ ПРЕДОСТАВЯ КАКВАТО Е, БЕЗ НИКАКВИ ГАРАНЦИИ ЗА АВТЕНТИЧНОСТТА И ТОЧНОСТТА ѝ. КЪМ ТОЗИ ДОКУМЕНТ НЕ ПРЕДОСТАВЯ ГАРАНЦИЯ ЗА ТЪРГОВИЯТА МУ, НЕНАРУШЕНИЕТО, ПРИГОДНОСТТА ЗА КАКВАТО И ДА СЕ КОНКРЕТНА ЦЕЛ, НИКТО ДА ПРОИЗТИРА ГАРАНЦИЯ В ДРУГИЧНОТО ИЗВЪРШИВАНЕ ОТ КАКВО ПРЕДЛОЖЕНИЕ, СПЕЦИФИКАЦИЯ ИЛИ СAMPLE.
Отказва се всякаква отговорност, включително отговорност за нарушаване на права на собственост, свързани с използването на информацията в този документ. Тук не се предоставят никакви лицензи, изрични или подразбиращи се, чрез estoppel или по друг начин, за каквито и да било права на интелектуална собственост.
Логото на Wi-Fi Alliance Member е търговска марка на Wi-Fi Alliance. Логото на Bluetooth е регистрирана търговска марка на Bluetooth SIG.
Всички търговски имена, търговски марки и регистрирани търговски марки, споменати в този документ, са собственост на съответните им собственици и с настоящото се потвърждават.
Copyright © 2021 Espressif Systems (Shanghai) Co., Ltd. Всички права запазени.
Документи / Ресурси
![]() |
ESPRESSIF ESP32-C3-MINI-1 Wi-Fi и Bluetooth модул за Интернет на нещата [pdf] Ръководство за потребителя ESPC3MINI1, 2AC7Z-ESPC3MINI1, 2AC7ZESPC3MINI1, ESP32 -C3 -MINI- 1 Wi-Fi и Bluetooth модул за интернет на нещата, Wi-Fi и Bluetooth модул за интернет на нещата, модул за интернет на нещата |