Repository navigation
Home
PlumPX32 — это современная многофункциональная микроконтроллерная платформа на базе микроконтроллера STM32F407VGT6.

- Встроенный модуль Bluetooth;
- Микроконтроллер
STM32F407VGT6; - Слот для карт памяти MicroSD;
- 4x порта мотора постоянного тока;
- 2x драйвера для 2-ух моторов постоянного тока;
- 8x портов вывода;
- 5x портов вывода с поддержкой ШИМ;
- Встроенный трехцветный светодиод;
- 5x встроенных кнопок управления;
- Интерфейс
Arduino Uno; - 8x портов ввода;
- 5x портов ввода с поддержкой ШИМ;
- 2x выведенных порта USART;
- 2x выведенных порта I2C.
А также:
- Продуманная система питания;
- Питание на всех внешних портах.
- Семейство
Cortex-M4; - Разрядность: 32 бит;
- Тактовая частота: 168 МГц;
- Flash-память: 1 МБайт;
- Оперативная память: 196 КБайт;
- Поддержка инструкций
DSPи чисел с плавающей точкой; - 16-битные таймеры: 2 базовых таймера, 8 таймеров общего назначения, 2 продвинутых таймера, 2 watchdog;
- 2 32-битных таймера общего назначения;
-
RTC(часы реального времени); - Корпус
LQFP100(100 ножек).
Прошивка платформы PlumPX32 для программирования на языке Python состоит из встроенного интерпретатора языка MicroPython.
MicroPython — это реализация языка программирования Python 3, включающая основную часть подмножества стандартной библиотеки Python и оптимизированная для работы на микроконтроллерах.
Версия MicroPython для PlumPX32 базируется на прошивке MicroPython for PyBoard. Ознакомиться с документацией к ней вы можете на официальном сайте.
Для программирования платформы на языке Python необходимо установить драйвер. После успешной установки драйвера и подключения платформы к компьютеру в правильном режиме платформа отобразится на компьютере как съемное устройство с именем PYBFLASH.
API PlumPX32 для MicroPython представляет собой надстройку над загруженной в платформу прошивкой, позволяющей с удобством и простотой программировать платформу для использования устройств и программных компонентов Роботрек. Комплект надстройки содержит в себе следующие компоненты:
- Скрипт
boot.py, описывающий поведение платформы сразу после загрузки. По умолчанию основная задача данного скрипта — запустить основной скрипт; - Скрипт
main.py, описывающий логику работы робота, управляемого платформой; - Файл конфигурации
pybcdc.ini, содержащий данные настроек платформы для использования с ПК под управлением ОСWindows. - Модуль
plumpx32, содержащий:- Модуль
executor— набор модулей драйверов для исполнительных устройствРоботрек; - Модуль
sensor— набор модулей драйверов для датчиковРоботрек; - Файл
common.py— набор общих функций и классов, используемых в других модулях и упрощающих программирование платформы; - Файл
pins.py— набор определений имеющихся в платформе пинов, дающий простой именованный доступ к необходимым пинам.
- Модуль
Для обновления API платформы необходимо:
- Скачать архив с последней версией API;
- Распаковать архив;
- Отформатировать устройство
PYBFLASH; - Скопировать файлы из директории
./PYBFLASHраспакованного архива на устройствоPYBFLASH.
На текущий момент API реализует поддержку следующих устройств и программных компонентов Роботрек:
| Датчик | Реализовано |
|---|---|
| Акселерометр / гироскоп | ✔️ |
| Внешний энкодер | ✔️ |
| Датчик вибрации | ✔️ |
| Датчик касания | ✔️ |
| Датчик магнитного поля | ✔️ |
| Датчик наклона | ✔️ |
| Датчик огня | ✔️ |
| Датчик света | ✔️ |
| Датчик температуры | ✔️ |
| Датчик цвета | ✔️ |
| ИК ПДУ | ❌ |
| ИК-датчик | ✔️ |
| Микрофон аналоговый | ✔️ |
| Микрофон цифровой | ✔️ |
| Ультразвуковой датчик расстояния | ✔️ |
| Исполнитель | Реализовано |
|---|---|
| Аудиотрек | ✔️ |
| Мотор постоянного тока | ✔️ |
| Пьезоизлучатель | ✔️ |
| Динамик | ✔️ |
| Светодиод | ✔️ |
| Серводвигатель (большой) | ✔️ |
| Серводвигатель (малый) | ✔️ |
| Цветной сенсорный TFT дисплей | ✔️ |
| Программный компонент | Реализовано |
|---|---|
| Bluetooth ДУ | ✔️ |
| Коннектор Нейротрек + Трекдуино ДУ | ❌ |
| Коннектор комплекса "Юный нейрофизиолог-инженер" | ❌ |
Python — скриптовый язык с последовательным исполнением инструкций. Если вы привыкли программировать контроллеры на Arduino, то вы знаете, что там используются встроенные функции setup() и loop():
-
setup()используется для начальной настройки и инициализации используемых в дальнейшей программе объектов. Обычно эта функция выполняется единожды в начале работы программы, после чего управление передается функцииloop(); -
loop()используется как петля исполнения, которая циклически повторяется раз за разом, пока работает сам контроллер.
В MicroPython же аналогом функции setup() является само тело программы. Функция loop() определяется пользователем как обычно, однако в отличие от Arduino ее циклический запуск необходимо реализовать явно после проведения всех необходимых определений и инициализаций:
<блок импортирования модулей>
<блок определений и инициализаций>
def loop():
<логика работы платформы>
while True:
loop()Для тестирования и отладки вы можете использовать REPL.
Вы можете загружать код программы в платформу как с помощью копирования/вставки необходимых файлов на носитель PYBFLASH, так и с помощью непосредственного редактирования этих файлов в редакторе.
По умолчанию, логика работы платформы находится в скрипте main.py, однако, вы можете программировать логику в скрипте с другим названием. Например, пусть логика работы вашей программы сохранена в файле my_script.py со следующим содержанием:
from plumpx32.executor.motor import M1
from pyb import delay
def loop():
M1().run(100)
delay(100)
M1().stop()
delay(100)
while True:
loop()Тогда вы можете использовать свой скрипт в качестве основного двумя способами:
- Подключив его в скрипте
main.pyчерезimport <название вашего скрипта>:import my_script while True: my_script.loop()
- Вызвав его из скрипта
boot.pyс помощью командыpyb.main():import pyb pyb.main('my_script.py')
Все описанные в данном Wiki драйвера устройств (датчики, исполнители и общие пакеты common.py и pins.py) обязательно должны быть импортированы при их использовании. Хорошим тоном считается импортирование только необходимых классов.
При импортировании необходимо указывать полный путь к пакету. Например, чтобы импортировать класс Plumpx32Pin из пакета pins.py необходимо написать следующий код:
from plumpx32.pins import Plumpx32Pin as PinsВ этом примере был использован элиасинг — сопоставление нового имени существующему объекту. После такого импортирования вы сможете обращаться к классу
Plumpx32Pinпо более короткому и удобному имени —Pins.
from plumpx32.executor.motor import M1, M3
M1().run() # запустить с встроенным значением мощности
M3().run(50) # запустить в половину мощностиfrom plumpx32.sensor.button import ButtonLeft
from plumpx32.executor.led import BuiltinLED
if ButtonLeft().pressed():
BuiltinLED().on(BuiltinLED().Color.GREEN)
else:
BuiltinLED().off()from plumpx32.sensor.ir import IRSensor
from plumpx32.executor.display import Display
from plumpx32.pins import Plumpx32Pin as Pins
from plumpx32.common import amap
from pyb import delay
display = Display(Pins.UART.UART1)
irs = IRSensor(Pins.In.IN1)
while True:
brightness = int(amap(irs.read(), 0, 1023, 255, 0))
color = Display.Color.from_rgb(brightness, brightness, brightness)
display.clear(color)
delay(100)Вы можете писать свои программы в обычном блокноте, но это не так удобно, как могло бы быть. Мы советуем использовать среды разработки для улучшения эффективности написания кода. Существуют среды разработки, разработанные специально для программирования микроконтроллерных плат на MicroPython, например, uPyCraft или Thonny.
Мы используем среду разработки Visual Studio Code с использованием кодового рабочего пространства, отвечающего за разделение текущего репозитория на отдельные компоненты, загружающего определения MicroPython для подсказок во время ввода, а также управляющего необходимыми для работы расширениями.
Использование среды разработки позволит вам увеличить скорость разработки за счет:
- Подсветки синтаксиса, позволяющей визуально отличать различные составляющие вашей программы;
- IntelliSense (подсказки во время ввода кода);
- Встроенного подключения к REPL.