1. Цели урока

• Понимать, что делает экран Display и как он связан с телеметрией модели.
• Настроить до 4 телеметрических экранов типов Nums, Bars, Script.
• Собрать “панель пилота”: линк, питание, GPS/режимы — в удобном виде.
• Научиться избегать типовых ошибок: “пустой экран”, “вечно полный бар”, “скрипт не появляется в списке”.

Ментальная модель:
Telemetry  → “что приходит с модели” (датчики)
Display    → “как это показать пилоту” (экраны/ячейки/бары/скрипт)

2. Что такое Display и как он связан с Telemetry

Назначение и лимит экранов

Экран Display — это настройка телеметрических экранов, которые показываются при нажатии [TELE]. Можно настроить до четырёх экранов; каждый экран выбирается как Nums, Bars или Script.

Типы экранов:
- Nums   = 8 ячеек со значениями
- Bars   = 4 полосы + RSSI полоса внизу
- Script = запуск telemetry Lua-скрипта

Как открыть (TELE / PAGE>)

Открыть телеметрические экраны можно кнопкой [TELE] из главного вида. На сам экран Display часто переходят со страницы Telemetry кнопкой [PAGE>].

Навигация (типовой маршрут):
Main View → [MDL] → Model Settings → Telemetry → [PAGE>] → Display
Main View → [TELE] → просмотр настроенных телеметрических экранов

Минимальные “предусловия”

Частая путаница

3. Тип Nums (числа): 8 ячеек, верхняя строка и Timer1

Как устроен экран

Nums показывает числовые значения выбранных источников в сетке 2×4 (8 ячеек). Верхняя строка дополнительно показывает служебную информацию (имя модели, напряжение батареи аппаратуры, время). Если в модели настроен Timer1, он заменяет имя модели в верхней строке.

Nums = 8 слотов (удобно группировать):
Левый столбец: "линк + питание"
Правый столбец: "навигация/режимы/высота"

Как выбирать источники

• Безопасность: линк и питание (например Rqly / RSSI, RXBt, TPWR).
• Ориентирование: таймеры, режим полёта (если есть датчик FM), GPS‑параметры (Sats, Alt).
• Редко‑нужно: “отладочные” датчики — лучше унести на отдельный экран.

Готовые раскладки

Nums (пример логики слотов, не строгий список):
[1] Rqly     [2] TPWR
[3] RXBt     [4] Curr (если есть)
[5] Capa     [6] Sats (если есть)
[7] Alt      [8] FM (если есть)

Nums:
[1] 1RSS   [2] 2RSS
[3] Rqly   [4] RSNR
[5] TRSS   [6] TQly
[7] TPWR   [8] RFMD

Типичные ошибки

4. Тип Bars (полосы): min/max и RSSI‑бар снизу

Как устроен экран Bars

Bars показывает полосы (бар‑графики) для выбранных источников. Экран состоит из 4 строк (4 настраиваемых бара). Дополнительно внизу отображается 5‑я полоса со значением RSSI.

Bars = 4 настраиваемых полосы + (внизу) RSSI полоса
Для каждой из 4 полос нужно задать:
- Source
- Min
- Max

Как правильно задать min/max

Min/Max определяют, как “растягивается” шкала бара. Если диапазон слишком широкий — бар будет почти всегда “пустой”. Если слишком узкий — будет “вечно полный”.

Пример мышления (без привязки к конкретной батарее):
- Для процентов/качества (часто 0..100): Min=0, Max=100
- Для “напряжения”: Min = порог, где уже опасно; Max = полностью заряжено
- Для “мощности”: Min=0; Max = максимальная мощность вашего профиля

Готовые наборы баров

Bars:
1) Rqly  (Min=0   Max=100)
2) RXBt  (Min=... Max=...)
3) Curr  (Min=0   Max=...)
4) Capa  (Min=0   Max=...)

Внизу автоматически:
RSSI bar

Bars:
1) Rqly  (0..100)
2) RSNR  (Min=... Max=...)
3) TPWR  (0..MaxPower)
4) RFMD  (Min=... Max=...)  ; удобно видеть смену rate/mode

Внизу:
RSSI bar

Типичные ошибки

5. Тип Script (Lua): папка SCRIPTS/TELEMETRY и базовый каркас

Где должен лежать скрипт

Тип Script запускает телеметрический Lua‑скрипт. Чтобы он появился в списке выбора, файл должен быть на SD‑карте в папке SCRIPTS/TELEMETRY.

SD-карта (важное место):
/SCRIPTS/TELEMETRY/your_script.lua

Если положить скрипт в другую папку (например TOOLS или FUNCTIONS),
он может не появиться в списке Display → Script.

Минимальный каркас telemetry‑скрипта

Телеметрические Lua‑скрипты в EdgeTX должны возвращать таблицу интерфейса (как минимум run), например: return { run = my_run, ... }.

-- Минимальный "живой" каркас (идея)
local function my_run(event)
  lcd.clear()
  lcd.drawText(1, 1, "Telemetry Script", 0)

  -- Обычно делают выход по EVT_EXIT_BREAK
  if event == EVT_EXIT_BREAK then
    return 1 -- сигнал EdgeTX: закрыть экран/выйти
  end
  return 0
end

return { run = my_run }

Практика эксплуатации

• Скрипты удобно использовать как “дашборд” (например для FPV/ELRS/CRSF) или как спец‑инструмент.
• Если скрипт использует телеметрию, он будет “пустым”, пока датчики не обнаружены и не обновляются.
• Для установки готовых скриптов часто достаточно копирования в SCRIPTS/TELEMETRY (иногда вместе с папкой‑зависимостями).

Типичные ошибки

6. Порядок настройки и “идеальная” структура 4 экранов

Пошаговый алгоритм настройки

1. Проверьте, что датчики есть: Telemetry → Sensors → Discover New.
2. Перейдите в Display (из Telemetry по [PAGE>] или через меню модели).
3. Выберите экран 1…4 → [Enter] → задайте тип: Nums / Bars / Script.
4. Заполните ячейки (Nums) или строки (Bars) нужными источниками.
5. Для Bars обязательно задайте min/max для каждой строки.
6. Нажмите [Return], чтобы выйти из настройки экрана.
7. Проверьте результат через [TELE] в главном виде.

Микро-лайфхак:
После настройки Display сразу проверьте:
- значения не "---"
- цифры читаемы (единицы/точность настроены в Sensor Configuration)
- бары имеют "ход" (не 0%/100% постоянно)

Nums vs Bars vs Script

Рекомендуемый комплект из 4 экранов

Экран 1 (Nums): линк + питание + таймер
Экран 2 (Bars): Rqly / RXBt / Curr / Capa (или другие 4 ключевые)
Экран 3 (Nums): GPS/высота/режимы (если используете)
Экран 4 (Script): dashboard (если пользуетесь Lua), иначе "отладка"

Если на экране пусто

7. Практика: типовые задачи (с решениями)

Блок 1: Nums (инструментальная панель)

Решение (шаги):
1) Display → Screen 1 → [Enter]
2) Type: Nums
3) Заполнить 8 ячеек (пример):
   Rqly, TPWR, RXBt, Curr, Capa, Sats, Alt, FM
4) [Return] → выйти
5) [TELE] в главном виде → проверить

Решение (шаги):
1) Model Settings → Setup → Timer 1
2) Режим: например ON или Throttle (по вашему сценарию)
3) Вернуться в Main View → [TELE]
4) Убедиться, что в верхней строке теперь Timer1 (а не имя модели)

Блок 2: Bars (контроль диапазонов)

Решение (шаги):
1) Display → Screen 2 → [Enter]
2) Type: Bars
3) Для каждой строки:
   - выбрать Source
   - поставить Min/Max (пример: для Rqly: 0..100)
4) [Return] → выйти
5) [TELE] → проверить вживую (движение баров)

Решение:
В Bars внизу всегда отображается 5-я полоса со значением RSSI.
Она не занимает одну из 4 строк и не настраивается как обычные строки.

Блок 3: Script (подключение Lua)

Решение (шаги):
1) Подключить SD-карту к ПК
2) Скопировать файл .lua в /SCRIPTS/TELEMETRY/
3) На пульте: Display → Screen 3 (или 4) → Type: Script
4) Выбрать скрипт в списке
5) [TELE] → открыть и проверить работу

Решение (мини-чек):
1) Путь: файл действительно в /SCRIPTS/TELEMETRY/ ?
2) Имя/расширение: .lua (а не .txt), нет “двойного расширения”
3) Скрипт возвращает интерфейс: есть "return { run = ... }"

8. Чек‑лист самопроверки знаний

Отметьте пункты, которые вы действительно понимаете и можете применить без подсказок.