Открытие приложения
Есть два способа открыть веб-приложение RBgrid. Это одно и то же приложение, и в обоих случаях ваши данные идут напрямую из браузера на ваш хаб по домашней сети.
- На webapp.rbgrid.io: ничего устанавливать не нужно. Вы открываете нашу страницу и подключаете её к адресу вашего хаба.
- С вашего хаба: приложение один раз устанавливается на хаб, затем вы открываете адрес хаба.
Можно пользоваться обоими способами и переключаться в любой момент: настройки, точки и история хранятся на хабе, а не в приложении.
Какой способ выбрать
| На webapp.rbgrid.io | С вашего хаба | |
|---|---|---|
| Установка | Не нужна. | Установить пакет один раз и заново после каждого выпуска. |
| Версия приложения | Всегда последняя. | Та, которую вы установили. |
| Интернет | Нужен, чтобы загрузить страницу. | Не нужен: приложение работает только по домашней Wi-Fi; даже его шрифты входят в пакет. |
| Куда идут данные | Из браузера напрямую на хаб. Через наши серверы они не проходят. | Из браузера напрямую на хаб. |
| Браузеры | Проверено в Chrome и Edge. Браузер один раз спрашивает разрешение на доступ к устройствам в локальной сети. | Любой современный браузер. |
| Где можно пользоваться | На компьютере в той же сети, что и хаб. | На компьютере или телефоне в той же сети, что и хаб. |
Ни один способ не даёт доступа к хабу извне дома. Для этого используйте собственный VPN в вашу домашнюю сеть. Если вы используете Home Assistant, его собственный удалённый доступ показывает данные хаба из MQTT, но не приложение RBgrid.
Открыть приложение на webapp.rbgrid.io
- На компьютере в той же сети, что и хаб, откройте
https://webapp.rbgrid.ioв Chrome или Edge. - На экране подключения введите адрес хаба в поле IP или URL устройства, например
192.168.1.50, и выберите Подключить. - Браузер спросит, может ли этот сайт обращаться к устройствам в локальной сети. Нажмите Разрешить. Спрашивает он только один раз.
Браузер запоминает последний адрес, поэтому в следующий раз приложение откроется на вашем хабе.
Если вы ответили отказом или приложение пишет «Хаб по этому адресу не отвечает.», разрешите доступ в настройках сайта браузера (Local network access) и подключитесь снова. Проверьте и адрес: это адрес хаба в вашей домашней сети, а не 192.168.4.1.
Начиная с прошивки хаба v1.1.3, хаб всегда принимает приложение RBgrid по адресам https://webapp.rbgrid.io и https://demo.rbgrid.io; ничего настраивать не нужно. Хаб на v1.1.2 или более старой версии принимает любой сайт, если вы не ограничили его в Настройки → Доступ из браузера (CORS): тогда добавьте туда https://webapp.rbgrid.io. → Настройки: доступ из браузера
Установить приложение на хаб
Приложение поставляется отдельным пакетом с каждым выпуском, rbgrid-ui_<version>.zip: папка kit/ и файл ui-manifest.json. Установите его на хаб через API хаба: загрузите каждый файл из kit/, затем примените манифест. Команды приведены в разделе Сборка и прошивка и в описании выпуска.
- Если вы задали API-токен, передавайте его с каждым вызовом.
- Замена атомарная: хаб переключается на новое приложение только после того, как весь пакет пришёл и проверен.
Затем откройте http://<hub address>/. Приложение откроется на «Обзоре» этого хаба. Если хаб ещё не настроен, баннер сообщит «Хаб ещё с заводскими настройками»; кнопка Настроить → открывает мастер настройки.
Пока пакет приложения не установлен, по адресу хаба виден только минимальный встроенный экран прошивки; API при этом работает.
Обновить приложение на хабе
Установите новый пакет так же; он заменит старый. Приложение и прошивка обновляются отдельно: обновление прошивки по воздуху сохраняет установленное приложение, а установка приложения не меняет прошивку. После обновления прошивки установите пакет приложения из того же выпуска.
Безопасность
В обоих случаях приложение обменивается с хабом данными по обычному HTTP в домашней сети. Изменения на хабе защищаются, когда вы задаёте API-токен (Настройки → Безопасность). На прошивке хаба v1.1.2 и новее приложение предупреждает, пока токена нет или пока у собственной Wi-Fi сети хаба стоит пароль первой настройки; предупреждение пропадает, когда сделано и то и другое.
Хаб отвечает на запросы браузера только со своих собственных страниц и из приложения RBgrid. Другие сайты не могут использовать ваш хаб из браузера посетителя, если вы сами не добавите их в Настройки → Доступ из браузера (CORS).
Несколько хабов
В боковом меню выберите Сменить. Введите адрес другого хаба в поле IP или URL устройства и нажмите Подключить. Открыть демо-режим показывает приложение с примерными данными.
- На webapp.rbgrid.io вы можете подключаться таким образом к любому из своих хабов, ничего на них не настраивая.
- В приложении, которое отдаёт один хаб, другой хаб должен принимать адрес первого. Хабы на v1.1.3 и новее принимают только перечисленные сайты, поэтому добавьте
http://<first hub's address>в Настройки → Доступ из браузера (CORS) на другом хабе.
Попробовать без хаба
demo.rbgrid.io запускает то же приложение со встроенными примерными домами. Оно не подключено ни к какому хабу.