Skip to content
Dmitry Starov edited this page Feb 19, 2021 · 9 revisions

English version


PlumPX32

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

Особенности платформы PlumPX32

PlumPX32 description scheme

  1. Встроенный модуль Bluetooth;
  2. Микроконтроллер STM32F407VGT6;
  3. Слот для карт памяти MicroSD;
  4. 4x порта мотора постоянного тока;
    1. 2x драйвера для 2-ух моторов постоянного тока;
  5. 8x портов вывода;
    1. 5x портов вывода с поддержкой ШИМ;
  6. Встроенный трехцветный светодиод;
  7. 5x встроенных кнопок управления;
  8. Интерфейс Arduino Uno;
  9. 8x портов ввода;
    1. 5x портов ввода с поддержкой ШИМ;
  10. 2x выведенных порта USART;
  11. 2x выведенных порта I2C.

А также:

  • Продуманная система питания;
  • Питание на всех внешних портах.

Особенности микроконтроллера STM32F407VGT6

  • Семейство Cortex-M4;
  • Разрядность: 32 бит;
  • Тактовая частота: 168 МГц;
  • Flash-память: 1 МБайт;
  • Оперативная память: 196 КБайт;
  • Поддержка инструкций DSP и чисел с плавающей точкой;
  • 16-битные таймеры: 2 базовых таймера, 8 таймеров общего назначения, 2 продвинутых таймера, 2 watchdog;
  • 2 32-битных таймера общего назначения;
  • RTC (часы реального времени);
  • Корпус LQFP100 (100 ножек).

Особенности версии PlumPX32 для языка программирования Python

Прошивка платформы PlumPX32 для программирования на языке Python состоит из встроенного интерпретатора языка MicroPython.

MicroPython — это реализация языка программирования Python 3, включающая основную часть подмножества стандартной библиотеки Python и оптимизированная для работы на микроконтроллерах.

Версия MicroPython для PlumPX32 базируется на прошивке MicroPython for PyBoard. Ознакомиться с документацией к ней вы можете на официальном сайте.

Для программирования платформы на языке Python необходимо установить драйвер. После успешной установки драйвера и подключения платформы к компьютеру в правильном режиме платформа отобразится на компьютере как съемное устройство с именем PYBFLASH.

PlumPX32 MicroPython API

API PlumPX32 для MicroPython представляет собой надстройку над загруженной в платформу прошивкой, позволяющей с удобством и простотой программировать платформу для использования устройств и программных компонентов Роботрек. Комплект надстройки содержит в себе следующие компоненты:

Обновление API

Для обновления API платформы необходимо:

  1. Скачать архив с последней версией API;
  2. Распаковать архив;
  3. Отформатировать устройство PLUMPX32;
  4. Скопировать файлы из распакованного архива на устройство PLUMPX32.

Поддержка устройств и программных компонентов Роботрек

На текущий момент API реализует поддержку следующих устройств и программных компонентов Роботрек:

Датчик Реализовано
Акселерометр / гироскоп ✔️
Внешний энкодер ✔️
Датчик вибрации ✔️
Датчик касания ✔️
Датчик магнитного поля ✔️
Датчик наклона ✔️
Датчик огня ✔️
Датчик света ✔️
Датчик температуры ✔️
Датчик цвета ✔️
ИК ПДУ ❌
ИК-датчик ✔️
Микрофон аналоговый ✔️
Микрофон цифровой ✔️
Ультразвуковой датчик расстояния ✔️
Исполнитель Реализовано
Аудиотрек ✔️
Мотор постоянного тока ✔️
Пьезоизлучатель ✔️
Динамик ✔️
Светодиод ✔️
Серводвигатель (большой) ✔️
Серводвигатель (малый) ✔️
Цветной сенсорный TFT дисплей ✔️
Программный компонент Реализовано
Bluetooth ДУ ✔️
Коннектор Нейротрек + Трекдуино ДУ ❌
Коннектор комплекса "Юный нейрофизиолог-инженер" ❌

Как пользоваться Wiki

В боковой панели вы можете увидеть структуру Wiki — в ней в иерархическом порядке находятся ссылки на модули API, а также на полезные статьи:

  • plumpx32 — домашняя страница
    • executor — пакет API исполнительных устройств
      • audiotrack — API Аудиотрек
      • display — API дисплея
      • led — API светодиодов
      • motor — API моторов
      • servo — API серводвигателя
      • sound — API звуковых устройств
    • sensor — пакет API датчиков
      • bt — API Роботрек ДУ
      • button — API датчиков касания
      • color — API датчика цвета
      • encoder — API энкодера
      • flame — API датчика огня
      • gyro — API гироскопа / акселерометра
      • ir — API ИК-датчика
      • light — API датчика света
      • magnetic — API датчика магнитного поля
      • mic — API микрофона
      • shock — API датчика вибрации
      • temperature — API датчика температуры
      • tilt — API датчика наклона
      • ultrasonic — API ультразвукового датчика
    • common — Общие функции и классы
    • pins — Определения допустимых портов
  • Использование REPL

Легенда

Наименования функций и прочие короткие участки кода;

.function_name()

Участки кода

from plumpx32.executor.motor import M1, M3

M1().run()
M3().run(50)

Участки кода в REPL

>>> display.color == Display.Color.WHITE
True
>>> display.color = Display.Color.RED
>>> display.color == Display.Color.BLUE
False
>>> display.color == Display.Color.RED
True

Конструкторы классов

class plumpx32.<device_type>.<package_name>.<class_name>(<argument1> [, <argument2>])

Здесь:

  • <device_type> — тип устройства:

    • sensor, если устройство является датчиком;
    • executor, если устройство является исполнителем.
  • <package_name> — название пакета (имя файла без расширения), в котором находится класс;

  • <class_name> — имя класса;

  • <argument1> — обязательный аргумент;

    У конструкторов и функций может не быть обязательных аргументов.

  • [, <argument2>] — список необязательных аргументов.

Для создания экземпляра класса с помощью конструктора необходимо использовать только имя класса и аргументы, но также необходимо импортировать пакет, в котором определен класс.

Важные замечания

Прочтите, пожалуйста. Это очень важно!

Использование встроенных драйверов устройств

Все описанные в данном Wiki драйвера устройств (датчики, исполнители и общие пакеты common.py и pins.py) обязательно должны быть импортированы при их использовании. Хорошим тоном считается импортирование только необходимых классов.

При импортировании необходимо указывать полный путь к пакету. Например, чтобы импортировать класс Plumpx32Pin из пакета pins.py необходимо написать следующий код:

from plumpx32.pins import Plumpx32Pin as Pins

В этом примере был использован элиасинг — сопоставление нового имени существующему объекту. После такого импортирования вы сможете обращаться к классу Plumpx32Pin по более короткому и удобному имени — Pins.

Примеры

1. Использование моторов M1 и M3

from plumpx32.executor.motor import M1, M3

M1().run() # запустить с встроенным значением мощности
M3().run(50) # запустить в половину мощности

2. Использование встроенной кнопки ВЛЕВО и встроенного светодиода

from plumpx32.sensor.button import ButtonLeft
from plumpx32.executor.led import BuiltinLED

if ButtonLeft().pressed():
    BuiltinLED().on(BuiltinLED().Color.GREEN)
else:
    BuiltinLED().off()

3. Использование инфракрасного датчика и дисплея

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)

Программирование платформы PlumPX32

Python — скриптовый язык с последовательным исполнением инструкций. Если вы привыкли программировать контроллеры на Arduino, то вы знаете, что там используются встроенные функции setup() и loop():

  • setup() используется для начальной настройки и инициализации используемых в дальнейшей программе объектов. Обычно эта функция выполняется единожды в начале работы программы, после чего управление передается функции loop();
  • loop() используется как петля исполнения, которая циклически повторяется раз за разом, пока работает сам контроллер.

В MicroPython же аналогом функции setup() является само тело программы. Функция loop() определяется пользователем как обычно, однако в отличие от Arduino ее циклический запуск необходимо реализовать явно после проведения всех необходимых определений и инициализаций:

<блок импортирования модулей>

<блок определений и инициализаций>

def loop():
    <логика работы платформы>

while True:
    loop()

Для тестирования и отладки вы можете использовать REPL.

Загрузка программы в платформу

Вы можете загружать код программы в платформу как с помощью копирования/вставки необходимых файлов на носитель PYBFLASH, так и с помощью непосредственного редактирования этих файлов в редакторе.

Использование отличных от main.py скриптов работы платформы

По умолчанию, логика работы платформы находится в скрипте 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()

Тогда вы можете использовать свой скрипт в качестве основного двумя способами:

  1. Подключив его в скрипте main.py через import <название вашего скрипта>:
    import my_script
    
    while True:
        my_script.loop()
  2. Вызвав его из скрипта boot.py с помощью команды pyb.main():
    import pyb
    
    pyb.main('my_script.py')

Использование среды разработки

Вы можете писать свои программы в обычном блокноте, но это не так удобно, как могло бы быть. Мы советуем использовать среды разработки для улучшения эффективности написания кода. Существуют среды разработки, разработанные специально для программирования микроконтроллерных плат на MicroPython, например, uPyCraft или Thonny.

Мы используем среду разработки Visual Studio Code с использованием кодового рабочего пространства, отвечающего за разделение текущего репозитория на отдельные компоненты, загружающего определения MicroPython для подсказок во время ввода, а также управляющего необходимыми для работы расширениями.

Использование среды разработки позволит вам увеличить скорость разработки за счет:

  • Подсветки синтаксиса, позволяющей визуально отличать различные составляющие вашей программы;
  • IntelliSense (подсказки во время ввода кода);
  • Встроенного подключения к REPL.

Clone this wiki locally