Настройки интерфейса командной строки VTX в Betaflight
Содержание
Настройки VTX через CLI
Начиная с версии Betaflight 3.3.0, приведённые ниже настройки CLI можно использовать для конфигурации адресуемых видеопередатчиков (например, TBS SmartAudio и IRC-Tramp), подключённых к полётному контроллеру.
Особенности работы
- При запуске настройки применяются к передатчику.
- Если конфигурация видео изменяется через меню OSD (CMS) или по протоколу MSP (например, через Lua-скрипт в Taranis/OpenTX), настройки обновляются.
- Можно настроить частоту через USB/CLI, даже если видеопередатчик выключен.
- После сохранения и перезагрузки система запустится на новой частоте.
Параметр vtx_freq
Есть параметр vtx_freq, который работает следующим образом:
- Если vtx_band=0 и vtx_freq≠0, то при старте на передатчик будет установлена частота из vtx_freq (в МГц).
- Если оба параметра равны 0, настройки игнорируются.
- Если vtx_band≠0 и подключён видеопередатчик, то vtx_freq при старте будет установлен в текущее значение частоты (в МГц).
Важно для Betaflight 4.1+
Параметры vtx_band, vtx_channel, vtx_power актуальны для версий Betaflight до 4.1, где были встроены значения по умолчанию.
В Betaflight 4.1 и новее для управления VTX необходимо настроить таблицу VTX, где вы самостоятельно определяете диапазоны, каналы и уровни мощности в соответствии с местными нормами.
Основные параметры CLI
vtx_band = #
Допустимый диапазон: 0–5
| 0 | Пользовательский (ручная настройка частоты через vtx_freq) |
| 1 | A (Boscam A / TBS / RC305) |
| 2 | B (Boscam B) |
| 3 | E (Boscam E / DJI) |
| 4 | F (IRC NexWave / Fatshark) |
| 5 | Raceband |
vtx_channel = #
Допустимый диапазон: 1–8
vtx_power = #
Допустимый диапазон: 0–5
Для SmartAudio:
| 0 | 25 мВт |
| 1 | 25 мВт |
| 2 | 200 мВт |
| 3 | 500 мВт |
| 4 | 800 мВт |
Для TBS Unify Nano:
| 0 | 25 мВт |
| 1 | 25 мВт |
| 2 | 50 мВт |
Для IRC-Tramp:
| 0 | 25 мВт |
| 1 | 25 мВт |
| 2 | 100 мВт |
| 3 | 200 мВт |
| 4 | 400 мВт |
| 5 | 600 мВт |
vtx_low_power_disarm = ON|OFF
- ON: При разоружении коптера мощность VTX устанавливается на минимальное значение (
vtx_power=1). - OFF: Мощность остаётся на заданном уровне (
vtx_power).
Исключение: Если сработал failsafe приёмника, мощность не снижается.
vtx_freq = ####
Допустимый диапазон: 0–5999 (МГц)
- Если vtx_band≠0 и VTX подключён → отображает текущую частоту в МГц.
- Если vtx_band=0 → устанавливает частоту в МГц.
- Если vtx_band=0 и vtx_freq=0 → настройки не передаются на VTX.
Примеры использования
Пример базовой настройки
Чтобы настроить VTX на диапазон F (Fatshark) и канал 6 (5840 МГц), введите в CLI:
set vtx_band = 4
set vtx_channel = 6
save
Настройки применятся после сохранения и перезагрузки. Успешность можно проверить командой:
get vtx_freq
(должна отобразиться текущая частота в МГц)
Таблица частот 5.8 ГГц
| Диапазон | Канал 1 | Канал 2 | Канал 3 | Канал 4 | Канал 5 | Канал 6 | Канал 7 | Канал 8 |
|---|---|---|---|---|---|---|---|---|
| A | 5865 | 5845 | 5825 | 5805 | 5785 | 5765 | 5745 | 5725 |
| B | 5733 | 5752 | 5771 | 5790 | 5809 | 5828 | 5847 | 5866 |
| E | 5705 | 5685 | 5665 | 5645 | 5885 | 5905 | 5925 | 5945 |
| F | 5740 | 5760 | 5780 | 5800 | 5820 | 5840 | 5860 | 5880 |
| R | 5658 | 5695 | 5732 | 5769 | 5806 | 5843 | 5880 | 5917 |
Легенда: A = Boscam A / TBS / RC305, B = Boscam B, E = Boscam E / DJI, F = IRC NexWave / Fatshark, R = Raceband
Управление VTX через вспомогательный канал (AUX)
Формат команды:
vtx <индекс> <aux_канал> <vtx_band> <vtx_channel> <vtx_power> <начало_диапазона> <конец_диапазона>
Пример: Настройка 3-позиционного переключателя
Настройка 3-позиционного переключателя на Aux3 для переключения уровней мощности (1/2/3):
vtx 0 2 0 0 1 900 1200 # Позиция 1: мощность 1 (25 мВт)
vtx 1 2 0 0 2 1300 1700 # Позиция 2: мощность 2 (200 мВт)
vtx 2 2 0 0 3 1800 2100 # Позиция 3: мощность 3 (500 мВт)
Важные моменты:
- Номер aux_канала указывается с нуля (0 = Aux1, 1 = Aux2, 2 = Aux3 и т. д.).
- Если
vtx_band,vtx_channelилиvtx_powerравны 0, текущие настройки не изменяются. - Если включён vtx_low_power_disarm=ON, он имеет приоритет над командами
vtx.
