Специальные функции | Special Functions

Special Functions (SF) в EdgeTX — это “таблица действий”

если Trigger (условие/переключатель) активен → выполнить действие (звук, вибрация, лог на SD, скриншот, override канала, тренер и т. п.). Это слой “что делать”, который удобнее всего строить поверх слоя условий в Logical Switches. ↩

1) Как мыслить про Special Functions

Одна строка SF почти всегда читается так:

Trigger истинно → Function выполняется (и/или поддерживается активной), если строка Enable включена.

Базовые поля одинаковые у всех функций: Trigger, Function, Enable, а дальше (в зависимости от функции) появляются Value / CH / Repeat / Interval и т. п. ↩

Что может быть Trigger

Любой “переключатель” в понимании EdgeTX: физический тумблер/кнопка, Logical Switch, иногда — состояния/виртуальные источники (включая условия, собранные логикой). Практически это означает: сложную логику собирайте в LS, а в SF ставьте уже “понятный триггер” (L01=LowBat, L02=Armed, L03=Landing …). ↩

Enable ≠ Trigger

• Trigger определяет когда срабатывать.
• Enable — “вообще разрешено ли этой строке работать”. Отключённая строка не выполнится ни при каких условиях. ↩

Почему важны Copy/Paste/Insert

На экране SF есть стандартные операции: Edit/Copy/Paste/Insert/Clear/Delete/Enable/Disable. Это реально ускоряет жизнь, когда вы делаете пачку похожих строк (например, 3 разных предупреждения) или вставляете новую строку “между” уже настроенными. ↩

2) Важная системная настройка для 3‑позиционных тумблеров

В Radio Settings есть параметр Play delay (sw. mid pos) — минимальное время (в мс), которое переключатель должен провести в среднем положении, чтобы Special Function успела активироваться. Это сделано, чтобы при щелчке из “низ” в “верх” SF не срабатывала “случайно” на пролёте через середину. 2

Если вы часто вешаете SF на среднее положение 3‑позиционного тумблера (SA‑mid), эта настройка может радикально уменьшить “лишние” озвучки/события.

3) Repeat и режим !1x: как не получить “спам” при старте

У многих “аудио/вибро/экранных” функций есть Repeat с вариантами:

• !1x — не выполнять при старте, даже если Trigger уже активен
• 1x — выполнить один раз
• 1s … 60s — повторять раз в N секунд, пока Trigger активен ↩

Это ключ к аккуратному UX: например, если тумблер уже стоит в положении “ARM” при выборе модели, !1x поможет не проигрывать “ARMED!” сразу при загрузке.

4) Список функций: что делает каждая и где чаще применяется

Ниже — по функциям из актуального мануала (v2.12), с практическими комментариями.

Adjust (Adjust Global Variable)

Меняет выбранную Global Variable. Режимы: Constant / Mixer Source / Global var / Inc/Decrement (установка константой, следование источнику, копирование из другой GV, инкремент/декремент). ↩
Практика: “на лету” менять rates/expo/лимиты, громкость предупреждений, чувствительность — через GV, а через SF делать шаг +/-.

Audio Amp Off (select radios)

Отключает аудиоусилитель (на некоторых передатчиках), чтобы из динамика не шли помехи/фон. ↩

Backlight

Управляет яркостью подсветки от выбранного источника; при этом яркость ограничена значениями On/Off, заданными в Radio Setup → Backlight Screen. ↩

BgMusic / BgMusic II

• BgMusic — крутит выбранный .wav в цикле, пока активна функция; файл должен быть в SOUNDS/(language)/ на SD. ↩
• BgMusic II — временно приостанавливает то, что играет через BgMusic. ↩
  Практика: BgMusic — “музыка на столе”, BgMusic II — “пауза при ARM/telemetry loss/включении варьо”.

Haptic

Включает виброотклик, настраиваются паттерн (0–4) и Repeat (включая !1x). ↩
Практика: отдельная вибрация на ARM, на low battery, на failsafe.

Inst. Trim (Instant Trim)

Ставит триммеры в текущие значения соответствующих стиков. ↩
Практика: быстрый “подхват” тримов при первичной настройке (осторожно — на земле и осознанно).

Lua Script

Запускает Lua-скрипт из /SCRIPTS/FUNCTIONS/ на SD; скрипты, которые рисуют на экране, так запускать нельзя. Есть Repeat: ON (пока активен Trigger) или 1x. ↩

No Touch

Отключает тач-интерфейс на радиостанциях с экраном. ↩
Есть хороший “how-to”: тач можно отключать как глобальной функцией или специальной (на модель). И важная деталь: customizable switches или logical switches нельзя использовать в global functions, но можно через Special Function на модель. 3

Override (Channel Override)

Жёстко перезаписывает выбранный канал значением -100 … +100, игнорируя микшеры. ↩
Практика: это мощно и опасно. Делайте:

• очень явный Trigger (часто momentary-кнопка),
• тест на земле,
• и, если возможно, “маску” через логический переключатель (например, разрешать override только при disarm).

Play Sound

Проигрывает встроенный системный звук (SD‑пак не нужен) + Repeat (!1x/1x/1–60s). ↩
Практика: быстрые “бипы” без возни с файлами.

Play Track

Проигрывает выбранный .wav с SD + Repeat (!1x/1x/1–60s). ↩
Практика: голосовые объявления режимов, предупреждения, чеклисты.

Бонус про аудио-организацию: в EdgeTX есть продвинутый механизм “model dependent audio”: файлы можно класть в /SOUNDS/<lang>/<model_name>/ и получать авто‑проигрывания по событиям (например, SA-up.wav, а также события для логических переключателей L1-up.wav / L1-down.wav). Это отдельный подход, который иногда удобнее, чем плодить SF на каждое положение. 4

Play Value

Озвучивает значение выбранного источника (входы, стики, pots, GV, телеметрия, каналы и т. п.) + Repeat. ↩
Практика: “RxBt 7.3 volts” раз в 10 секунд при low battery.

RacingMode

Включает low-latency “racing mode” для FrSky Archer RS; также должен быть включён в настройках External RF Module. ↩

Reset (Reset Timer)

Сбрасывает Timer 1/2/3 / Flight / Telemetry (что именно сбрасывается — см. Reset Telemetry). ↩
Полезный факт: “Reset session” (в Reset Telemetry) не только сбрасывает датчики/таймеры, но и сбрасывает состояния logical switches и прогоняет проверки как при загрузке модели (throttle/switch checks, checklist и т. д.). 5

Screenshot

Сохраняет скриншот в .bmp в папку SCREENSHOT на SD. ↩

SD Logs

Пишет .csv лог в LOGS на SD, с Interval 0.1s … 25.5s. Важные нюансы:

• при каждой активации создаётся новый файл (если функция была активна как минимум “достаточно долго”, как указано в настройке),
• лог не стартует, если на SD меньше 50 MB свободного места. ↩
  Практика: логировать только “в полёте/заезде” (через ARM или “Flight active” LS), чтобы потом легко сопоставлять файл с сессией.

Set (Set Timer)

Устанавливает Timer 1/2/3 в значение 00:00:00 … 08:59:59. ↩

SetFailsafe

Записывает “custom failsafe” для выбранного модуля (Internal/External) равным текущим положениям стиков при срабатывании. Работает только если в RF‑модуле failsafe стоит в режим custom. ↩
Практика: делать отдельный “failsafe set” триггер, защищённый от случайного нажатия.

Set Main Screen

Переключает главный экран на указанный номер (как в Screen Settings). Есть Repeat, который позволяет “возвращать” экран обратно через N секунд, даже если пользователь вручную ушёл на другой. ↩

Trainer

Включает режим тренера, можно выбрать что отдаётся ученику: Axis/Rud/Ele/Thr/Ail/Chans. ↩
Связанный факт: в EdgeTX есть виртуальный “trainer switch” Tnr, который ON, когда тренер‑линк активен — его можно использовать как условие в логике/функциях. 6

Vario

Включает “пищалку варьометра” (тон меняется при наборе/снижении). ↩
Важно: в Telemetry прямо указано, что для работы варио его нужно включить через Vario Special или Global Function. 7

Volume

Меняет громкость, источник изменения выбирается в выпадающем списке Volume. ↩

5) Практические “рецепты” (типовые связки LS → SF)

Рецепт A: Low battery alert “по уму” (без срабатываний на просадках)

Официальный how-to предлагает ровно эту архитектуру:

1. Logical Switch: RxBt < 7.4V + Delay (например 10 секунд), чтобы просадки на газе не триггерили алерт. 8
2. Special Function: Trigger = L01, Function = Play Value, Value = RxBt, Repeat = например 10s. 8

Рецепт B: “Анти-случайный тач” в полёте

• SF: Trigger = ARM (или Lxx=Armed), Function = No Touch, Enable = ON. ↩
  Если хотите тумблер “Touch ON/OFF” — пример есть в how-to, плюс там же предупреждение про глобальные функции и ограничение на customizable/logical switches в global functions. 3

Рецепт C: Логирование только во время сессии

• LS: “модель активна” (например, ARM true)
• SF: Trigger = этот LS, Function = SD Logs, Interval = 0.2–1.0s (по задаче) ↩
  Плюс держите в голове требование про 50 MB свободного места, иначе лог просто не начнётся. ↩

Рецепт D: Скриншот “на кнопку”

• SF: Trigger = momentary‑кнопка, Function = Screenshot
  Складывается в SCREENSHOT/*.bmp. ↩

Рецепт E: Вариометр только в нужном режиме

1. В Telemetry → Variometer выбираете источник (датчик высоты/скорости набора). 7
2. В SF включаете Vario только в нужном Flight Mode/при ARM, чтобы не “пищало” на земле. ↩

6) Про “глобальные” функции и почему они иногда внезапно “не работают”

В EdgeTX есть Global Functions (действуют на все модели), и Special Functions (внутри модели). В новых версиях логика включения глобальных функций завязана на видимость вкладки через Enabled Features. Исторически в v2.9 даже отдельно отмечали, что настройка “Use Global Functions” была убрана, и глобальные функции отключаются, когда вкладка скрыта. 9

В актуальном разделе Enabled Features есть важная оговорка: если выключить вкладку “Global / Special Functions”, это отключит настроенные global/special functions для этой модели. 10

7) Хорошая “архитектура” модели: LS = условия, SF = действия

Рабочий шаблон (который масштабируется и не превращается в хаос):

1. В Logical Switches делаете “человеческие условия”: L01=Armed, L02=LowBat, L03=TimerRunning, L04=LandingMode…
2. В Special Functions вешаете на них действия: Play Value/Track, Haptic, SD Logs, Set Main Screen и т. д. ↩

Это почти всегда проще, чем пытаться “впихнуть” сложные условия напрямую в триггер SF, особенно когда потом нужно менять логику или переиспользовать её в миксах.

Похожее в категории "СОФТ"

• Логические переключатели | Logical Switches

  Цель: создать виртуальные 2‑позиционные переключатели, которые включаются/выключаются по логическому выражению (true/false), и затем использовать их везде, где EdgeTX принимает обычный физический переключатель.