Швидке підключення Wi-Fi через Bluetooth (Web Bluetooth)

Налаштування підключення контролера oCBot до вашої домашньої мережі Wi-Fi може бути виконано миттєво безпосередньо через веб-браузер завдяки технології Web Bluetooth та стандарту Improv Wi-Fi.

Цей метод дозволяє уникнути ручного підключення до тимчасових точок доступу Wi-Fi (Access Point) контролера та введення IP-адрес. Усе налаштування відбувається бездротово через Bluetooth в один клік.

Як це працює (Дворівнева архітектура)#

1. На стороні контролера (oCBot): Якщо плата ESP32 не має збережених параметрів Wi-Fi, вона автоматично запускає вбудований сервіс BLE Improv (з низьким споживанням пам'яті NimBLE). Контролер транслює у Bluetooth-ефір своє ім'я (наприклад, oCBot Provisioning) та очікує підключення.
2. На стороні порталу (UA Distillery): Браузер, використовуючи API Web Bluetooth, сканує локальний ефір, підключається до GATT-сервісу контролера, зчитує поточний статус і надсилає зашифровані Wi-Fi SSID та пароль.

Покрокова інструкція користувача#

Крок 1. Перевірка вимог безпеки#

Технологія Web Bluetooth з міркувань безпеки дозволена браузерами виключно при роботі через захищене з'єднання HTTPS (або з локальної адреси localhost).

• Переконайтеся, що ви відкрили кабінет UA Distillery за адресою з префіксом https:// (наприклад, https://app-distill.the.in.ua/).

Крок 2. Відкриття майстра підключення#

1. У вашому кабінеті перейдіть до розділу «oCBot» -> вкладка «Мої контроллери».
2. Натисніть кнопку «Додати» у верхньому правому куті.
3. У модальному вікні, що з'явиться, оберіть вкладку «Швидке підключення».

Крок 3. Пошук та спарювання#

1. Натисніть кнопку «Почати налаштування» (Bluetooth-індикатор почне пульсувати, сигналізуючи про сканування).
2. Браузер відкриє системне вікно з переліком доступних Bluetooth-пристроїв.
3. Оберіть пристрій із назвою «oCBot Provisioning» та натисніть «Зіставити» (Pair).

Крок 4. Авторизація на пристрої (за потреби)#

Деякі модифікації контролерів oCBot для безпеки вимагають підтвердження фізичної присутності користувача:

• Якщо статус-індикатор у модалці показує «Очікування авторизації», натисніть фізичну кнопку завантаження/BOOT (або іншу кнопку, призначену для безпеки) на вашому ESP32.

Крок 5. Передача Wi-Fi реквізитів#

1. Після успішної авторизації в модальному вікні з'явиться форма введення Wi-Fi.
2. Вкажіть назву вашої домашньої Wi-Fi мережі (SSID) та пароль до неї.
3. Натисніть кнопку «Підключити пристрій».

Дані буде миттєво передано на ESP32. Контролер змінить стан на «Connecting...», запише параметри у флеш-пам'ять і виконає перезапуск для підключення до вашого роутера.