Repository navigation
Home
Trackduino Pro — это современная многофункциональная микроконтроллерная платформа на базе микроконтроллера 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 ножек).
Прошивка платформы Trackduino Pro для программирования на языке Python состоит из встроенного интерпретатора языка MicroPython.
MicroPython — это реализация языка программирования Python 3, включающая основную часть подмножества стандартной библиотеки Python и оптимизированная для работы на микроконтроллерах.
Версия MicroPython для Trackduino Pro базируется на прошивке MicroPython for PyBoard. Ознакомиться с документацией к ней вы можете на официальном сайте.
Для программирования платформы на языке Python необходимо установить драйвер. После успешной установки драйвера и подключения платформы к компьютеру в правильном режиме платформа отобразится на компьютере как съемное устройство с именем PYBFLASH.
API Trackduino Pro для MicroPython представляет собой надстройку над загруженной в платформу прошивкой, позволяющей с удобством и простотой программировать платформу для использования устройств и программных компонентов Роботрек. Комплект надстройки содержит в себе следующие компоненты:
- Скрипт
boot.py, описывающий поведение платформы сразу после загрузки. По умолчанию основная задача данного скрипта — запустить основной скрипт; - Скрипт
main.py, описывающий логику работы робота, управляемого платформой; - Файл конфигурации
pybcdc.ini, содержащий данные настроек платформы для использования с ПК под управлением ОСWindows. - Модуль
trackduino, содержащий:- Модуль
executor— набор модулей драйверов для исполнительных устройствРоботрек; - Модуль
sensor— набор модулей драйверов для датчиковРоботрек; - Файл
common.py— набор общих функций и классов, используемых в других модулях и упрощающих программирование платформы; - Файл
pins.py— набор определений имеющихся в платформе пинов, дающий простой именованный доступ к необходимым пинам.
- Модуль
Для обновления API платформы необходимо:
- Скачать архив с последней версией API;
- Распаковать архив;
- Отформатировать устройство
TRACKDUINO-PRO32; - Скопировать файлы из распакованного архива на устройство
TRACKDUINO-PRO32.
На текущий момент API реализует поддержку следующих устройств и программных компонентов Роботрек:
| Датчик | Реализовано |
|---|---|
| Акселерометр / гироскоп | ✔️ |
| Внешний энкодер | ✔️ |
| Датчик вибрации | ✔️ |
| Датчик касания | ✔️ |
| Датчик магнитного поля | ✔️ |
| Датчик наклона | ✔️ |
| Датчик огня | ✔️ |
| Датчик света | ✔️ |
| Датчик температуры | ✔️ |
| Датчик цвета | ✔️ |
| ИК ПДУ | ❌ |
| ИК-датчик | ✔️ |
| Микрофон аналоговый | ✔️ |
| Микрофон цифровой | ✔️ |
| Ультразвуковой датчик расстояния | ✔️ |
| Исполнитель | Реализовано |
|---|---|
| Аудиотрек | ✔️ |
| Мотор постоянного тока | ✔️ |
| Пьезоизлучатель | ✔️ |
| Динамик | ✔️ |
| Светодиод | ✔️ |
| Серводвигатель (большой) | ✔️ |
| Серводвигатель (малый) | ✔️ |
| Цветной сенсорный TFT дисплей | ✔️ |
| Программный компонент | Реализовано |
|---|---|
| Bluetooth ДУ | ✔️ |
| Коннектор Нейротрек + Трекдуино ДУ | ❌ |
| Коннектор комплекса "Юный нейрофизиолог-инженер" | ❌ |
В боковой панели вы можете увидеть структуру Wiki — в ней в иерархическом порядке находятся ссылки на модули API, а также на полезные статьи:
-
trackduino— домашняя страница-
executor— пакет 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)>>> display.color == Display.Color.WHITE
True
>>> display.color = Display.Color.RED
>>> display.color == Display.Color.BLUE
False
>>> display.color == Display.Color.RED
Trueclass 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 Pinfrom trackduino.executor.motor import M1, M3
M1().run() # запустить с встроенным значением мощности
M3().run(50) # запустить в половину мощностиfrom trackduino.sensor.button import ButtonLeft
from trackduino.executor.led import BuiltinLED
if ButtonLeft().pressed():
BuiltinLED().on(BuiltinLED().Color.GREEN)
else:
BuiltinLED().off()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)Python — скриптовый язык с последовательным исполнением инструкций. Если вы привыкли программировать контроллеры на Arduino, то вы знаете, что там используются встроенные функции setup() и loop():
-
setup()используется для начальной настройки и инициализации используемых в дальнейшей программе объектов. Обычно эта функция выполняется единожды в начале работы программы, после чего управление передается функцииloop(); -
loop()используется как петля исполнения, которая циклически повторяется раз за разом, пока работает сам контроллер.
В MicroPython же аналогом функции setup() является само тело программы. Функция loop() определяется пользователем как обычно, однако в отличие от Arduino ее циклический запуск необходимо реализовать явно после проведения всех необходимых определений и инициализаций:
<блок импортирования модулей>
<блок определений и инициализаций>
def loop():
<логика работы платформы>
while True:
loop()Для тестирования и отладки вы можете использовать REPL.
Вы можете загружать код программы в платформу как с помощью копирования/вставки необходимых файлов на носитель PYBFLASH, так и с помощью непосредственного редактирования этих файлов в редакторе.
По умолчанию, логика работы платформы находится в скрипте 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()Тогда вы можете использовать свой скрипт в качестве основного двумя способами:
- Подключив его в скрипте
main.pyчерезimport <название вашего скрипта>:import my_script while True: my_script.loop()
- Вызвав его из скрипта
boot.pyс помощью командыpyb.main():import pyb pyb.main('my_script.py')
Вы можете писать свои программы в обычном блокноте, но это не так удобно, как могло бы быть. Мы советуем использовать среды разработки для улучшения эффективности написания кода. Существуют среды разработки, разработанные специально для программирования микроконтроллерных плат на MicroPython, например, uPyCraft или Thonny.
Мы используем среду разработки Visual Studio Code с использованием кодового рабочего пространства, отвечающего за разделение текущего репозитория на отдельные компоненты, загружающего определения MicroPython для подсказок во время ввода, а также управляющего необходимыми для работы расширениями.
Использование среды разработки позволит вам увеличить скорость разработки за счет:
- Подсветки синтаксиса, позволяющей визуально отличать различные составляющие вашей программы;
- IntelliSense (подсказки во время ввода кода);
- Встроенного подключения к REPL.