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

Trackduino Pro

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

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

Trackduino Pro 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 ножек).

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

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

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

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

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

Trackduino Pro MicroPython API

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

Обновление API

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

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

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

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

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

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

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

  • trackduino — домашняя страница
    • 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 trackduino.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 trackduino.<device_type>.<package_name>.<class_name>(<argument1> [, <argument2>])

Здесь:

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

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

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

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

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

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

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

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

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

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

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

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

from trackduino.pin import Pin

Примеры

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

from trackduino.executor.motor import M1, M3

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

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

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

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

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

from trackduino.sensor.ir import IRSensor
from trackduino.executor.display import Display
from trackduino.pin import Pin
from trackduino.common import amap
from pyb import delay

display = Display(Pin.UART.UART1)
irs = IRSensor(Pin.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)

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

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 trackduino.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