Доставка Новою поштою по всій Україні

Протокол UART VESC і Flipsky FT: керування з Arduino та ESP32

5 хв читання
Протокол UART VESC і Flipsky FT: керування з Arduino та ESP32

Через UART контролером можна керувати з Arduino, ESP32, Raspberry Pi чи будь-якої плати з послідовним портом: задавати струм, оберти, коефіцієнт заповнення і читати напругу, температуру, оберти. Розбираємо формат пакетів для контролерів на базі VESC і для контролерів Flipsky серії FT — вони різні, хоча зовні схожі.

Якщо вам потрібен лише пульт або дисплей, протокол знати не треба — достатньо під'єднати пристрій до UART і вибрати тип контролера. Цей розділ — для тих, хто пише власну програму. Загальне порівняння UART, PPM і CAN — у статті «UART, PPM і CAN у VESC — що вибрати».

Під'єднання

  • Три дроти: TX контролера → RX плати, RX контролера → TX плати, загальний мінус (GND). Живлення 5 В з контролера можна використати для невеликої плати.
  • Рівні 3,3 В. UART контролерів працює на 3,3 В. ESP32 і STM32 під'єднуються напряму; для Arduino на 5 В (Uno, Nano) ставлять перетворювач рівнів або хоча б подільник на лінії TX плати.
  • Параметри порту: 115 200 біт/с, 8 біт даних, без парності, 1 стоповий біт. Однакові для VESC і для FT.

Контролери на базі VESC

Налаштування у VESC Tool

У App Settings → General виберіть застосунок UART (або PPM and UART, якщо паралельно потрібен пульт по PPM). Швидкість порту задається в App Settings → UART, за замовчуванням 115 200. Збережіть налаштування кнопкою запису.

Формат пакета

ПолеРозмірЗначення
Початок1 байт0x02, якщо дані до 255 байт; 0x03 — з дво­байтовою довжиною
Довжина1–2 байтиКількість байтів команди і даних
Команда1 байтНомер команди
ДаніN байтівПараметри, числа старшим байтом уперед
CRC162 байтиCRC-16/XMODEM (поліном 0x1021, початкове значення 0) від команди і даних
Кінець1 байт0x03

Основні команди

Команда№Дані
COMM_FW_VERSION — версія прошивки0—
COMM_GET_VALUES — прочитати телеметрію4—
COMM_SET_DUTY — коефіцієнт заповнення5int32, duty × 100 000
COMM_SET_CURRENT — струм мотора6int32, А × 1 000
COMM_SET_CURRENT_BRAKE — струм гальмування7int32, А × 1 000
COMM_SET_RPM — оберти8int32, ERPM
COMM_SET_POS — положення9int32, градуси × 1 000 000
COMM_ALIVE — «я на зв'язку»30—
COMM_FORWARD_CAN — переслати команду іншому контролеру по CAN34ID контролера + вкладена команда

Відповідь на COMM_GET_VALUES містить температуру транзисторів і мотора, середні струми мотора і батареї, коефіцієнт заповнення, оберти, напругу батареї, витрачені ампер- і ват-години, тахометр і код помилки. Точний порядок полів залежить від версії прошивки — звіряйтеся з файлом commands.c вашої версії.

Приклади пакетів

Прочитати телеметрію:      02 01 04 40 84 03
Струм мотора 10 А:          02 05 06 00 00 27 10 40 C5 03
Коефіцієнт заповнення 0,2:  02 05 05 00 00 4E 20 29 F6 03

10 А × 1 000 = 10 000 = 0x00002710; 0,2 × 100 000 = 20 000 = 0x00004E20.

Команди керування треба повторювати частіше, ніж задано в Timeout (App Settings → General, за замовчуванням 1 000 мс). Якщо команди перестануть надходити — наприклад, зависне плата, — контролер сам вимкне мотор.

Для Arduino і ESP32 є готова бібліотека VescUart: вона формує пакети, рахує CRC і розбирає відповідь COMM_GET_VALUES. Через COMM_FORWARD_CAN одна плата керує кількома контролерами, з'єднаними по CAN, — про саму шину читайте в статті «CAN-шина VESC».

Контролери Flipsky серії FT

Контролери FT85BD, FT60BD, FT85BS, FT85RS мають власний протокол FTESC. Будова пакета схожа, але маркери, контрольна сума і номери команд інші — бібліотеки для VESC з ними не працюють.

Формат пакета FTESC

ПолеРозмірЗначення
Початок1 байт0xAA, якщо дані до 255 байт; 0xBB — з дво­байтовою довжиною
Довжина1–2 байтиКількість байтів команди і даних
Команда1 байтНомер команди
ДаніN байтівЧисла старшим байтом уперед
CRC162 байтиТабличний CRC16 як у Modbus (початкове значення 0xFFFF) від команди і даних
Кінець1 байт0xDD

Команди FTESC (протокол V1.6)

Команда№ (hex)Що робить
UART_OBTAIN_DATA_ONCE00Прочитати поточні дані
UART_CONTROL_AND_OBTAIN_DATA_ONCE02Керування і читання даних в одному пакеті (з V1.6 — також передача PAS)
UART_SET_DUTY03Коефіцієнт заповнення
UART_SET_CURRENT04Струм мотора, int32, А × 1 000
UART_SET_CURRENT_GEAR05Струм + рівень швидкості: 0 — без рівня, 1 — низький, 2 — середній, 3 — високий, 4 — реверс
UART_SET_BRAKE_CURRENT06Струм гальмування
UART_CAN_FWARD10Переслати команду контролеру на CAN
UART_OBTAIN_FIRMWARE_VERSION11Версія прошивки
UART_KEEP_LIVE19Підтримка зв'язку
UART_SET_AUTO_OBTAIN_REALTIME_DATA1AАвтоматично надсилати дані
UART_OBTAIN_ALL_FTESC_ID1EID усіх контролерів на CAN
UART_SET_POSITION / UART_SET_SPEED26 / 27Положення / швидкість

Приклади пакетів:

Прочитати поточні дані:  AA 01 00 40 BF DD
Струм мотора 10 А:        AA 05 04 00 00 27 10 FC CF DD

Команди прямого керування струмом працюють лише тоді, коли у Flipsky ESC Tool тип вхідного сигналу (Input Signal Type) встановлено в OFF. Якщо там стоїть UART, контролер чекає на пульт Flipsky, а не на вашу плату.

Повний опис протоколу (англійською) і приклад обробника пакетів мовою C від Flipsky — на сторінці завантаження FlipSky Tool у розділі «Для розробників».

Часті питання

Яка швидкість UART у VESC за замовчуванням?

115 200 біт/с. Змінюється у VESC Tool: App Settings → UART → Baudrate. Для контролерів FT — теж 115 200.

Чи можна одночасно під'єднати пульт по UART і свою плату?

До одного порту — ні. Пульт можна перевести на PPM, а UART віддати під плату. Або використати CAN для плати.

Чому контролер не реагує на команди?

Перевірте, що TX і RX перехрещені, спільний мінус під'єднано, швидкість однакова, а у VESC Tool вибрано застосунок UART. Для FT — що Input Signal Type стоїть OFF. І що команди надходять частіше, ніж Timeout.

Чи підійде бібліотека VescUart для контролерів FT?

Ні. У FT інші маркери пакета, контрольна сума і номери команд. Для них використовуйте приклад коду Flipsky.

Залишились питання? Підкажемо з вибором контролера, підключенням і налаштуванням.
Написати нам

Товари зі статті

Інші статті