Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bastion-rnd/turtle_32_board
Руководство по работе и базовые примеры для отладочной платы Turtle32
https://github.com/bastion-rnd/turtle_32_board
arduino-ide cpp esp32 espressif microcontroller micropython
Last synced: 9 days ago
JSON representation
Руководство по работе и базовые примеры для отладочной платы Turtle32
- Host: GitHub
- URL: https://github.com/bastion-rnd/turtle_32_board
- Owner: Bastion-RND
- Created: 2024-04-02T14:36:56.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2024-10-15T08:09:49.000Z (4 months ago)
- Last Synced: 2025-01-18T20:57:25.009Z (18 days ago)
- Topics: arduino-ide, cpp, esp32, espressif, microcontroller, micropython
- Language: CMake
- Homepage: https://bast.ru
- Size: 85.2 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
***
)
***
Это небольшое руководство с основными учебными материалами для работы с платой Turtle32. Здесь вы можете найти примеры кода на разных языках и в разных средах разработки. Само руководство будет разделено на два оснвных раздела по языкам программирования:
* MicroPython (Thonny IDE, esptool)
* C/C++ (Espressif IDE, Arduino, PlatformIO)
**Внимание! При использовании одного языка программирования, вы не сможете программмировать плату на другом языке. Эти режимы программирования взаимоисключающие. Читайте о перезаписи загрузчика в разделе [Перезапись загрузчика](#перезапись-загрузчика)**.
Здесь вы сможете найти основные руководства по установке и первичной настройке среды, а также десять примеров по работе с платой, которые можно использовать в своих проектах. Для тех, кто только погружается в разработку и не знает с чего начать, то предлагаем сразу перейти в раздел [С чего начать?](#с-чего-начать).
Быстрая навигация по гайду:
- [С чего начать?](#с-чего-начать)
- [Установка драйверов](#установка-драйверов)
- [Руководство по MicroPython](#руководство-по-micropython)
- [Thonny IDE](#thonny-ide)
- [esptool](#esptool)
- [Руководство по C/C++](#руководство-по-сс)
- [Arduino](#arduino)
- [Espressif IDE](#espressif-ide)
- [PlatformIO](#platformio)
- [Перезапись загрузчика](#перезапись-загрузчика)
***
## С чего начать?
Стоит начать с выбора языка программмирования, на котором будет вестись разработка. В выборе языка вы можете руководствоваться любыми принципами, подойдет любой из языков. Можно сказать только то, что большинство разработчиков используют С/С++, поскольку MicroPython сравнительно новый фреймворк для работы. Если вы хотите начать свой путь с программирования на MicroPython, то начинать стоило бы с использования и настройки Thonny IDE. В случае с использованием C/C++, то стоит начать с использования Arduino, который предоставляет большое количество библиотек и более облегченный вариант программирования. Все эти среды предлагают достаточно понятный и удобный интерфейс для пользователя. За тем, как исользовать и настраивать среду можно переходить в соответсвующие разделы, MicroPython - [Thonny IDE](#thonny-ide) и С/C++ - [Arduino](#arduino). Там расположен гайд по установке и запуску первой программы. Пример программы можно взять в папке ```Python Examples``` или ```C C++ Examples```, к примеру можно взять код из примера ```Blink```.
***
## Установка драйверов
Для работы с платой на любом из языков программирования и любой из сред необходимо установить драйвера чипа CH34x. В папке ```drivers``` скачиваете zip архив и запускаете файл, который там храниться. В открывшемся окне нажимаете на кнопку Install. После чего можно переходить непосредственно к настройке среды и программированию.
***
## Руководство по MicroPython
Для программирования микроконтроллеров с использованием MicroPython предлагается использование двух разных сред:
* Thonny IDE
* esptool
**Перед началом чтения следующего раздела убедитесь, что прошли раздел** [Установка драйверов](#установка-драйверов)
### Thonny IDE
Программа устанавливается довольно просто и легко. Для этого необходимо перейти на сайт разработчика и скачать файл установщик.
Ещё одним из преимуществ можно выделить наличие русского языка как одного из оснвных языков интерфейса. Для этого заходите в раздел настроек и выбираете нужный язык. Переключите текущий интерпретатор Python на MicroPython с платой ESP32 на интересующем COM-порте (перед этим плату необходимо подключить к компьютеру).
Если это первое использование платы или же до этого вы программировали на C/С++, то необходимо будет дополнительно записать на микроконтроллер ядро MicroPython для дальнейшей работы, то есть перепрошить микроконтроллер, заменив содержание его FLASH памяти.
В открывшемся окошке выбираете параметры нашей платы - семейство микроконтроллера ESP32 S3 и вариант Espressif ESP32 S3. После чего наживаете на кнопку Install и ожидаете загрузки прошивки. Это может занять пару минут.
Появившееся окошко в терминале с таким содержанием будет говорить вам об успешности выполненных действий. Это и послужит сигналом к началу работы с платой.
В окошке сбоку вы можете увидеть как файлы, находящиеся на вашем устройстве, так и файлы, которые находятся на микроконтроллере. Сначала в любом из проектов первым будет исполняться файл ```boot.py```, затем остальные.
Для запуска файла достаточно будет нажать на зеленую кнопку в верхней части экрана. **_Ура-Ура!_**
***
### esptool
Для установки вам необходим Python. Установочный пакет для него можно и нужно скачать на официальном сайте. После установки Python на ваш компьютер, в командной строке (или терминале) введите команду ```pip install esptool```. Для проверки того, что установка прошла успешно нужно ввести в терминале команду ```esptool.py -h``` или, если вы используете Windows, - ```esptool.exe -h```. Вы увидите всю подсказку по данному модулю. Следующим шагом необходимо [скачать прошивку с официального сайта](https://micropython.org/download/ESP32_GENERIC_S3/) или найти ее в папке ```drivers```. Устанавливаете прошивку с помощью esptool, не забыв перед установкой отформатировать плату при помощи этой команды.
```esptool.py --port COM3 erase_flash```
**При использовании команд помните, что порт может отличаться. Посмотреть порт можно при помощи диспетчера устроств в разделе ```Порты (COM и LPT)```**
```esptool.py --port COM3 --baud 460800 write_flash --flash_size=detect 0 D:\esp32s3.bin```, где *D:\esp32s3.bin* это путь к файлу с его названием, где лежит ваша прошивка.
Для загрузки собственной прошивки можно использовать следующую команду (при этом ваш код должен загружаться в формате *.bin*).
```esptool.py -b 460800 --before=default_reset --after=hard_reset write_flash --flash_mode dio --flash_freq 20m --flash_size 4MB 0x0 bootloader.bin 0x10000 my_app-0x01000.bin 0x8000 partition-table.bin 0xd000 ota_data_initial.bin```
***
## Руководство по С/С++
Для программирования микроконтроллеров с использованием MicroPython предлагается использование трех разных сред:
* Arduino
* Espressif IDE
* PlatformIO
**Перед началом чтения следующего раздела убедитесь, что прошли раздел** [Установка драйверов](#установка-драйверов)
***
### Arduino
Установка Arduino IDE является несложной и довольно понятной. Открываете установщик и следуете указаниям по установке. Запускаете IDE и приступаете к настройке среды программирования. Для того, чтобы иметь доступ к файлам прошивки ESP32, необходимо перейти в по пути ```Файл->Настройки``` и в строку *"Дополнительные ссылки для менеджера плат"* необходимо вставить следующую ссылку, а после нажать на кнопку "Ок":
```https://dl.espressif.com/dl/package_esp32_index.json```
Далее необходимо перейти по пути ```Инструменты->Плата``` (по умолчанию стоит Arduino Uno) и выбрать Менеджер плат.
В открывшемся окне сверху пишете в поисковой строке "esp32" и начинаете поиск. Устанавливаете пакет данных от Espressif Systems. Ожидаете окончания скачивания, это может занять некоторое время.
После снова повторяете процесс выбора платы и переходите ```Инструменты->Плата->ESP32 Arduino``` и выбираете ESP32S3 Dev Module.
Для загрузки кода теперь необходимо выбрать порт. Далее необходимо перейти по пути ```Инструменты->Порт```, выбираете доступный порт, к которому подключена плата.
Ура-Ура! Теперь можно программировать плату и прошивать собственным кодом.
***
### Espressif IDE
Работа в этой IDE может использоваться в нескольких доступных версиях. Как установка плагина для ```VSCode``` или собственное приложение. Начнем наш гайд с установки Espressif IDE. Возьмите установочный файл с [официального источника](https://github.com/espressif/idf-eclipse-plugin/blob/master/docs/Espressif-IDE-Windows-Installer.md). Выбираете язык установки и проходите далее. На одном из шагов установки вы сможете дополнительно выбрать какие дополнительные данные о микроконтроллерах вы подгружаете. Дополнительно убедитесь, что у вас выбрана опция ESP32S3.
В конце установки вы можете увидеть несколько дополнительных параметров. Их вы оставляете и нажимаете на кнопку Finish.
После этого откроется несколько терминалов с процессом установки. Ожидаете её завершения и после чего сможете приступить к запуску самой IDE.
Открываете проект, который хотите протестировать на плате. К примеру, мигание светодиодом. И проводите основную настройку среды для запуска. Выбираете свой проект в поле ```Launch config``` и выбираете плату ESP32S3 в поле ```Launch target```. После чего нажимаете на кнопку загрузки прошивки, выбираете порт к которому подключена плата и наблюдаете за результатом. Первая сборка проекта может занять длительное время. Для дополнительных сведений о работе с IDE можно обраться к [официальной документации на GitHub](https://github.com/espressif/idf-eclipse-plugin?tab=readme-ov-file#create-a-new-project).
Так же дополнительно можно воспользоваться и расширением для VSCode. Запускаете приложение и открываете раздел Extensions, это можно сделать сочетанием клавиш ```Ctrl+Shift+X``` или кликнув на соответсвующую иконку. В поисковой строке наберите ```ESP-IDF Extension```, ищите и устанавливайте.
В Visual Studio выберите меню "View" и "Command Palette" и введите [configure esp-idf extension]. После этого выберете ESP-IDF: Configure ESP-IDF Extension. Перед вами откроется такого вида окно. В открывшемся окне выберете вариант ```Express```.
Здесь вам предоставляется возможность выбрать версию IDF и путь, куда файлы будут загружены. Это может занять некоторое время. По завершению установки можно приступать к созданию проекта.
На боковой панели теперь присутвует значок Espressif, который позволит быстро перейти к расширению. В верхней части экрана при помощи command можете создать новый проект.
Для того, чтобы загрузить проект, необходимо его сбилдить. Это делается при помощи команды ```ESP-IDF: Build your Project``` в меню "View" и "Command Palette" или сочетанием клавиш ```Ctrl+E+B```. Первый билд может быть довольно долгим. Перед загрузкой необходимо выбрать порт и саму плату, выбираете esp32s3 в нижнем левом углу. Для того, чтобы загрузить код в микрокнтроллер, воспользуйтесь командой ```ESP-IDF: Flash your Project``` в меню "View" и "Command Palette" или сочетанием клавиш ```Ctrl+E+F```.
***
### PlatformIO
Так же дополнительно можно воспользоваться и расширением для VSCode. Запускаем приложение и открываем раздел Extensions, это можно сделать сочетанием клавиш ```Ctrl+Shift+X``` или кликнув на соответсвующую иконку. В поисковой строке набираете ```PlatformIO```, ищете и устанавливаете. После чего в боковой части экрана у вас появиться иконка расширения. нажимаете на нее и попадаете на главный экран, где выбираете опцию создать новый проект и выбираете необходимые настройки для создания проекта. В параметрах ```Board``` выбираете вариант с esp32s3.
После чего можем открыть ваш проект или создать его. Для того, чтобы загрузить проект перед этим необходимо его собрать, то есть сделать build проекта. Это можно сделать при помощи сочетания клавиш ```Ctrl+Alt+B``` или при помощи команды ```PlatformIO: Build``` в меню "View" и "Command Palette".
В случае, если все прошло удачно и в коде нет никаких ошибок вы увидите сообщение в терминале о том, что все было выполнено. Далее вы можете загружать код на микроконтроллер. Это можно сделать при помощи сочетания клавиш ```Ctrl+Alt+U``` или при помощи команды ```PlatformIO: Upload``` в меню "View" и "Command Palette".
***
## Перезапись загрузчика
Для того, чтобы программировать, используя язык MicroPython, или наоборот после программирования на MicroPython и перейти на С/С++, необходимо будет стереть память микроконтроллера и загрузить новую прошивку при помощи esptool. Подробнее об установке читайте в соответствующем разделе про [esptool](#esptool), там находится информация о его установке. Необходимые файлы прошивки находятся в ```drivers```. Для прошивки нового загрузчика необходимо запустить командную строку и прописать следующую команду:
```esptool.py --port COM3 erase_flash```
**При использовании команд помните - порт может отличаться. Посмотреть порт можно при помощи диспетчера устроство в разделе ```Порты (COM и LPT)```**
После чего можно будет загружать новую необходимую прошивку, для этого используете следующую прошивку:
```esptool.py --port COM3 --baud 460800 write_flash --flash_size=detect 0 D:\esp32s3.bin```, где *D:\esp32s3.bin* это путь к файлу с его названием, где лежит ваша прошивка.