Перейти к содержимому
ДомоСфера Облако Умный дом и телеметрия
01

Подключение хаба к облаку

Инструкция подходит для Хаб Core и Хаб Pro. Перед началом убедитесь, что у вас есть доступ к роутеру, мобильный телефон с приложением и питание для контроллера.

Проверьте оборудование

Распакуйте хаб, подключите адаптер питания и дождитесь ровного индикатора питания. Если хаб подключается по Ethernet, соедините его свободным портом с роутером.

Создайте дом в приложении

В приложении выберите «Добавить дом», укажите адрес объекта и название помещения. Название помогает различать квартиры, дома и офисы в облачном профиле.

Привяжите хаб к аккаунту

Нажмите «Добавить контроллер», отсканируйте QR-код на корпусе и подтвердите парным кодом. Не публикуйте QR-код и парный код в открытых чатах.

Настройте домашнюю сеть

Используйте сеть 2,4 ГГц для Wi-Fi-устройств. Для Zigbee-датчиков достаточно питания хаба: они подключаются напрямую к его радиомодулю.

Добавьте первые устройства

Переведите датчик в режим сопряжения и выберите его в приложении. После добавления проверьте, что устройства появились в нужной комнате.

Создайте сценарий и проверьте телеметрию

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

02

Примеры конфигурации

Примеры показывают структуру настроек. Секреты и парные коды нужно хранить отдельно и не добавлять в публичные файлы.

hub.yaml — базовая конфигурация
hub:
  name: "Квартира-Север"
  cloud:
    endpoint: "wss://cloud.smart-dev.homes/v1/telemetry"
    tls: true
    pairing_token: "ХРАНИТЬ-В-СЕКРЕТНОМ-МЕСТЕ"
  network:
    ethernet: true
    wifi_fallback: true
  zigbee:
    channel: 15
    permit_join_seconds: 60
sensors.json — пример устройства
{
  "device_id": "aq-living-01",
  "model": "Aqua Pro",
  "room": "Гостиная",
  "capabilities": [
    "leak_state",
    "temperature"
  ],
  "scenarios": [
    {
      "when": "leak_state == wet",
      "then": "notify",
      "message": "Протечка в гостиной"
    }
  ]
}
Диагностическая команда
domosphere-cli doctor --endpoint cloud.smart-dev.homes --format table
03

Схема сетевого взаимодействия

Сценарии выполняются на хабе. Облако получает события по защищённому соединению и хранит историю телеметрии.

Схема подключения устройств к хабу, домашней сети и облаку ДатчикиZigbee / Wi-Fi ХабЛокальные сценарии ОблакоИстория и уведомления Роутер и выход в интернет

Требования к сети

  • Исходящее HTTPS и WSS к облачным endpoint.
  • Стабильный DHCP-арендованный адрес хаба.
  • Открытая синхронизация времени NTP.
  • Не переносите парные коды в логи.

Схема упрощена: фактические адреса могут отличаться и публикуются в документации вашей версии прошивки.

04

Диагностика подключения

Выберите симптом и получите последовательность проверки. Рекомендации соответствуют типовой процедуре подключения.