Протокол 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 байтів | Параметри, числа старшим байтом уперед |
| CRC16 | 2 байти | CRC-16/XMODEM (поліном 0x1021, початкове значення 0) від команди і даних |
| Кінець | 1 байт | 0x03 |
Основні команди
| Команда | № | Дані |
|---|---|---|
| COMM_FW_VERSION — версія прошивки | 0 | — |
| COMM_GET_VALUES — прочитати телеметрію | 4 | — |
| COMM_SET_DUTY — коефіцієнт заповнення | 5 | int32, duty × 100 000 |
| COMM_SET_CURRENT — струм мотора | 6 | int32, А × 1 000 |
| COMM_SET_CURRENT_BRAKE — струм гальмування | 7 | int32, А × 1 000 |
| COMM_SET_RPM — оберти | 8 | int32, ERPM |
| COMM_SET_POS — положення | 9 | int32, градуси × 1 000 000 |
| COMM_ALIVE — «я на зв'язку» | 30 | — |
| COMM_FORWARD_CAN — переслати команду іншому контролеру по CAN | 34 | ID контролера + вкладена команда |
Відповідь на 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 байтів | Числа старшим байтом уперед |
| CRC16 | 2 байти | Табличний CRC16 як у Modbus (початкове значення 0xFFFF) від команди і даних |
| Кінець | 1 байт | 0xDD |
Команди FTESC (протокол V1.6)
| Команда | № (hex) | Що робить |
|---|---|---|
| UART_OBTAIN_DATA_ONCE | 00 | Прочитати поточні дані |
| UART_CONTROL_AND_OBTAIN_DATA_ONCE | 02 | Керування і читання даних в одному пакеті (з V1.6 — також передача PAS) |
| UART_SET_DUTY | 03 | Коефіцієнт заповнення |
| UART_SET_CURRENT | 04 | Струм мотора, int32, А × 1 000 |
| UART_SET_CURRENT_GEAR | 05 | Струм + рівень швидкості: 0 — без рівня, 1 — низький, 2 — середній, 3 — високий, 4 — реверс |
| UART_SET_BRAKE_CURRENT | 06 | Струм гальмування |
| UART_CAN_FWARD | 10 | Переслати команду контролеру на CAN |
| UART_OBTAIN_FIRMWARE_VERSION | 11 | Версія прошивки |
| UART_KEEP_LIVE | 19 | Підтримка зв'язку |
| UART_SET_AUTO_OBTAIN_REALTIME_DATA | 1A | Автоматично надсилати дані |
| UART_OBTAIN_ALL_FTESC_ID | 1E | ID усіх контролерів на CAN |
| UART_SET_POSITION / UART_SET_SPEED | 26 / 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.