Перейти до змісту

Апаратне забезпечення

Секція "Апаратне забезпечення" містить налаштування пінів та параметрів LED-стрічок, кнопок і деяких опціональних модулів (звук, батарея), а також “захисні” обмеження яскравості.

Доступні поля залежать від того, який апаратний профіль ви обрали в Загальні → Режим прошивки. Для плат JAAM частина пінів/параметрів зафіксована, тому деякі поля можуть бути приховані.

Warning

Неправильна конфігурація пінів може призвести до некоректної роботи або пошкодження обладнання.

LED-стрічки

У прошивці є три логічні стрічки:

  • Основна — “мапа” (регіони)
  • Фонова — підсвітка фону (опціонально)
  • Сервісна — індикатори стану (опціонально)

Note

Для вимкнення фонового/сервісного каналу зазвичай використовують пін -1.

Основна стрічка (пін)

Перейдіть: Апаратне забезпечення → Основна стрічка (пін)

Вказує GPIO, до якого підключена основна LED-стрічка.

Note

Для деяких профілів (плати JAAM) цей пін зафіксовано прошивкою, тому поле може бути приховане.

Основна стрічка (кількість)

Перейдіть: Апаратне забезпечення → Основна стрічка (кількість)

Це поле з’являється лише для профілю "Власна карта LED" — там прошивці потрібно знати фактичну кількість світлодіодів у мапі.

Для профілів із готовими картами кількість основних LED задається профілем автоматично.

Основна стрічка (формат кольору)

Перейдіть: Апаратне забезпечення → Основна стрічка (формат кольору)

Визначає порядок каналів кольору. Типово для більшості стрічок підходить NEO_GRB (рекомендовано).

Якщо кольори “переплутані” (наприклад, червоний виглядає як зелений) — спробуйте інший формат.

Основна стрічка (частота)

Перейдіть: Апаратне забезпечення → Основна стрічка (частота)

Доступні варіанти:

  • 400 КГц
  • 800 КГц (рекомендовано)

Якщо на 800 КГц стрічка працює нестабільно — можна спробувати 400 КГц.

Фонова стрічка

Перейдіть:

  • Апаратне забезпечення → Фонова стрічка (пін)
  • Апаратне забезпечення → Фонова стрічка (кількість)
  • Апаратне забезпечення → Фонова стрічка (формат кольору)
  • Апаратне забезпечення → Фонова стрічка (частота)

Основні правила:

  • щоб вимкнути фонову стрічку — задайте пін -1 або кількість 0
  • якщо фонову стрічку увімкнено — обов’язково вкажіть і пін, і кількість

Сервісна стрічка

Перейдіть:

  • Апаратне забезпечення → Сервісна стрічка (пін)
  • Апаратне забезпечення → Сервісна стрічка (формат кольору)
  • Апаратне забезпечення → Сервісна стрічка (частота)

Сервісна стрічка використовується як індикатор стану (живлення/зв’язок/дані тощо). У прошивці кількість сервісних LED фіксована (типово 5), тому в UI немає поля “кількість”.

Щоб вимкнути сервісну стрічку — задайте пін -1.

Tip

Загальні принципи підключення та живлення див. у wiki/hardware/led-mapping.md.

Кнопки

У блоці "Кнопки" можна вказати піни (якщо вони не зафіксовані апаратним профілем) і призначити дію на Single Click та Long Click.

Note

Значення піна -1 означає, що кнопка вимкнена.

Пін кнопки ½/3

Перейдіть:

  • Апаратне забезпечення → Пін кнопки 1
  • Апаратне забезпечення → Пін кнопки 2
  • Апаратне забезпечення → Пін кнопки 3

Для деяких плат (профілів) ці піни можуть бути зафіксовані та не показуватися в UI.

Touch-кнопка TTP223

Перейдіть:

  • Апаратне забезпечення → Підтримка touch-кнопки TTP223 для кнопки ½/3

Ця опція змінює логіку “активного рівня” для кнопки:

  • для механічної кнопки зазвичай використовується active LOW (кнопка на землю)
  • модуль TTP223 зазвичай дає HIGH при торканні, тому для нього активний рівень інший

Режим кнопки (Single Click)

Перейдіть:

  • Апаратне забезпечення → Режим кнопки 1 (Single Click)
  • (аналогічно для кнопки ⅔)

Типові дії зі списку:

  • Вимкнено
  • Перемикання режимів мапи
  • Перемикання режимів дисплею
  • Увімк./Вимк. мапу
  • Увімк./Вимк. дисплей
  • Увімк./Вимк. мапу та дисплей

Note

У списку може бути пункт "Увімк./Вимк. режим лампи" — його робота залежить від конкретної версії прошивки та реалізації режиму лампи.

Режим кнопки (Long Click)

Перейдіть:

  • Апаратне забезпечення → Режим кнопки 1 (Long Click)
  • (аналогічно для кнопки ⅔)

Окрім дій, аналогічних Single Click, для Long Click доступні додаткові варіанти:

  • Увімк./Вимк. режим нічної яскравості
  • Перезавантаження пристрою

Info

Режим примусової нічної яскравості не вимикається автоматично та впливає лише на яскравість LED.

Warning

Якщо доступне оновлення прошивки й увімкнено показ сповіщень про нову прошивку, довге натискання кнопки може запускати оновлення незалежно від обраної дії (це зроблено для швидкого оновлення з пристрою).

Звук (піни)

Перейдіть:

  • Апаратне забезпечення → Буззер (пін)
  • Апаратне забезпечення → DF Player (RX) (пін)
  • Апаратне забезпечення → DF Player (TX) (пін)

Ці піни мають сенс лише тоді, коли в секції "Звук" вибрано відповідне джерело (buzzer або DF Player).

Батарея

Перейдіть:

  • Апаратне забезпечення → Моніторинг батареї
  • Апаратне забезпечення → ADC пін батареї

Якщо моніторинг увімкнено і вказано ADC-пін (значення >= 0), прошивка читає напругу через analogRead() і розраховує її з урахуванням дільника напруги.

Note

Показання залежать від схеми підключення (дільник/калібрування) і можуть бути орієнтовними.

Обмеження яскравості (захист)

Мінімальна яскравість

Перейдіть: Апаратне забезпечення → Мінімальна яскравість

Задає “поріг” мінімальної яскравості, щоб прибрати мерехтіння LED на дуже малих значеннях.

Максимальна яскравість

Перейдіть:

  • Апаратне забезпечення → Я розумію ризики та приймаю відповідальність...
  • Апаратне забезпечення → Максимальна яскравість

Цей ліміт обмежує максимальну потужність стрічки.

Прошивка застосує користувацький максимум тільки якщо ви увімкнули підтвердження ризику. Додатково діє “жорстка стеля” безпеки (значення вище певного максимуму все одно буде обмежене прошивкою).

Warning

Збільшення максимальної яскравості може призвести до перегріву/високих струмів. Міняйте це значення лише якщо у вас відповідне живлення, проводка та охолодження.