Кнопки¶

JAAM Fusion підтримує до 3 кнопок: Button 1, Button 2, Button 3.

Кожній кнопці можна призначити 2 різні дії:

Single Click (коротке натискання)
Long Click (довге натискання)

Налаштування кнопок виконуються у вебінтерфейсі в секції "Апаратне забезпечення".

Підключення¶

У прошивці кнопки налаштовуються як INPUT_PULLUP, тобто підтягування до “1” виконується внутрішнім резистором ESP32.

Механічна кнопка¶

Типовий варіант підключення для механічної кнопки:

GPIO (кнопка) → кнопка → GND

У цьому випадку кнопка працює як active LOW (натискання замикає на землю).

Touch‑кнопка на модулі TTP223¶

Якщо ви використовуєте модуль TTP223, його вихід зазвичай дає HIGH при торканні.

Підключення (типово):

VCC → 3.3V
GND → GND
OUT → GPIO (кнопка)

У налаштуваннях потрібно увімкнути підтримку TTP223 для відповідної кнопки.

Де налаштовується¶

Перейдіть у вебінтерфейсі:

Апаратне забезпечення → Кнопки

Там є групи полів для кожної кнопки:

Пін кнопки ½/3 (значення -1 означає, що кнопка вимкнена)
Підтримка touch‑кнопки TTP223 для кнопки ½/3
Режим кнопки X (Single Click)
Режим кнопки X (Long Click)

Note

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

Дії (режими кнопок)¶

Списки режимів у прошивці задаються окремо для Single Click і Long Click.

Single Click¶

Доступні дії:

Вимкнено
Перемикання режимів мапи
Перемикання режимів дисплею
Увімк./Вимк. мапу
Увімк./Вимк. дисплей
Увімк./Вимк. мапу та дисплей
Увімк./Вимк. режим лампи (може бути доступно залежно від збірки/прошивки)
Передати керування в Home Assistant

Long Click¶

Доступні дії:

усі дії, як у Single Click
Увімк./Вимк. режим нічної яскравості
Перезавантаження пристрою
Передати керування в Home Assistant

Note

У списку можуть зустрічатися дії для режиму “Лампа” (наприклад, збільшити/зменшити яскравість). Їх робота залежить від поточної реалізації у прошивці.

Home Assistant (кнопки як події)¶

Режим "Передати керування в Home Assistant" означає, що натискання кнопки не виконує локальну дію на пристрої. Натомість пристрій транслює натискання як подію в Home Assistant через WebSocket API (публікує подію у WebSocket), а Home Assistant вже споживає/обробляє її та виконує автоматизації.

Дивіться: Home Assistant

Важливий нюанс: пріоритет оновлення прошивки¶

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

Звук при натисканні¶

Якщо увімкнути Звук → Сигнали при натисканні кнопки, прошивка може відтворювати короткий звук для Single Click і Long Click.

Дивіться: Звук

Піни на платах JAAM (профілі)¶

Для “готових” апаратних профілів JAAM прошивка задає частину пінів автоматично.

JAAM 1.3: Button 1 → GPIO 35
JAAM 2.1: Button 1 → GPIO 4, Button 2 → GPIO 2
JAAM 3.⅔.0: Button 1 → GPIO 5, Button 2 → GPIO 2, Button 3 → GPIO 4

Детальніше по платах:

Troubleshooting¶

Кнопка не реагує¶

Перевірте:

пін кнопки задано коректно (не -1)
є спільний GND
для механічної кнопки підключення зроблено як “GPIO → кнопка → GND”
якщо використовуєте TTP223 — увімкнено "Підтримка touch‑кнопки TTP223" для цієї кнопки

Довге натискання запускає оновлення, хоча вибрана інша дія¶

Це очікувана поведінка, коли оновлення доступне та увімкнено сповіщення про нову прошивку (довге натискання має пріоритет).