{"id":47660242,"url":"https://github.com/dzerik/sber-mqtt-bridge","last_synced_at":"2026-04-22T10:01:05.247Z","repository":{"id":346352959,"uuid":"1189513161","full_name":"dzerik/sber-mqtt-bridge","owner":"dzerik","description":"Sber Smart Home MQTT Bridge — HACS integration for Home Assistant. Control HA devices via Salut voice assistants and Sber Smart Home app.","archived":false,"fork":false,"pushed_at":"2026-04-22T08:24:39.000Z","size":4391,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-22T09:27:37.925Z","etag":null,"topics":["custom-component","hacs","hacs-integration","home-assistant","home-assistant-custom-component","home-automation","homeassistant-integration","iot","mqtt","mqtt-bridge","python","salut","sber","sber-salut","sber-smart-home","sberdevices","smart-home","smarthome","voice-control","zigbee"],"latest_commit_sha":null,"homepage":"https://dzerik.github.io/sber-mqtt-bridge/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dzerik.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":".github/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-23T11:54:28.000Z","updated_at":"2026-04-22T08:08:29.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/dzerik/sber-mqtt-bridge","commit_stats":null,"previous_names":["dzerik/sber-mqtt-bridge"],"tags_count":71,"template":false,"template_full_name":null,"purl":"pkg:github/dzerik/sber-mqtt-bridge","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dzerik%2Fsber-mqtt-bridge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dzerik%2Fsber-mqtt-bridge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dzerik%2Fsber-mqtt-bridge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dzerik%2Fsber-mqtt-bridge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dzerik","download_url":"https://codeload.github.com/dzerik/sber-mqtt-bridge/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dzerik%2Fsber-mqtt-bridge/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32130776,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-22T08:34:57.708Z","status":"ssl_error","status_checked_at":"2026-04-22T08:34:55.583Z","response_time":58,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["custom-component","hacs","hacs-integration","home-assistant","home-assistant-custom-component","home-automation","homeassistant-integration","iot","mqtt","mqtt-bridge","python","salut","sber","sber-salut","sber-smart-home","sberdevices","smart-home","smarthome","voice-control","zigbee"],"created_at":"2026-04-02T10:59:35.052Z","updated_at":"2026-04-22T10:01:05.240Z","avatar_url":"https://github.com/dzerik.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sber Smart Home ⟷ Home Assistant MQTT Bridge\n\n[![HACS](https://img.shields.io/badge/HACS-Custom-41BDF5.svg)](https://hacs.xyz)\n[![GitHub Release](https://img.shields.io/github/v/release/dzerik/sber-mqtt-bridge)](https://github.com/dzerik/sber-mqtt-bridge/releases)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE.txt)\n[![Tests](https://img.shields.io/badge/tests-1760+-brightgreen)](tests/hacs/)\n[![CI](https://img.shields.io/github/actions/workflow/status/dzerik/sber-mqtt-bridge/ci.yml?label=CI)](https://github.com/dzerik/sber-mqtt-bridge/actions)\n\n**[English documentation](README_ENG.md)** | **[Документация (GitHub Pages)](https://dzerik.github.io/sber-mqtt-bridge/)**\n\n\u003e [!IMPORTANT]\n\u003e **🧪 PUBLIC TESTING — Ищем тестеров!**\n\u003e\n\u003e Проект перешёл в стадию **публичного тестирования**. Базовая функциональность стабильна,\n\u003e но разнообразие реальных устройств Home Assistant огромно, и нам нужна ваша помощь,\n\u003e чтобы выявить edge-cases и довести маппинг до ума.\n\u003e\n\u003e **Как помочь:**\n\u003e - Установите интеграцию через HACS и подключите ваши устройства к Сбер\n\u003e - Поделитесь опытом в [Tester Feedback](https://github.com/dzerik/sber-mqtt-bridge/issues/new?template=tester_feedback.yml) —\n\u003e   что работает, что нет, какие модели устройств вы пробовали\n\u003e - Явные баги — в [Bug Report](https://github.com/dzerik/sber-mqtt-bridge/issues/new?template=bug_report.yml)\n\u003e\n\u003e API и конфигурация ещё могут меняться до релиза `2.0.0`. Спасибо всем, кто тестирует!\n\n---\n\n\u003e *«Салют, включи свет на кухне»* — и ваш Zigbee-выключатель, подключённый к Home Assistant, послушно выполняет команду.\n\nЕсли вы собирали умный дом на Home Assistant, вы знаете это чувство: всё работает, автоматизации летают, дашборд выглядит идеально — но стоит кому-то из домашних попросить Салют выключить свет, и выясняется, что два мира ничего друг о друге не знают.\n\n**Sber Smart Home MQTT Bridge** решает ровно эту проблему. Это нативная интеграция Home Assistant, которая делает ваши устройства HA видимыми для экосистемы Сбер — голосовых ассистентов Салют, приложения Сбер Умный дом — без отдельных серверов, аддонов или костылей. Один компонент, одна настройка через UI, и два мира начинают работать как один.\n\nИдея простая: взять лучшее от каждой экосистемы. Home Assistant — это тысячи интеграций, гибкие автоматизации и сильное сообщество. Сбер — это голосовые ассистенты, удобное мобильное приложение и растущая линейка умных устройств. Этот мост позволяет использовать оба мира одновременно, не выбирая между ними.\n\n## Как это работает\n\nИнтеграция устанавливает MQTT-соединение с облаком Sber, транслирует ваши HA-устройства в формат Сбер Умного дома и мгновенно синхронизирует состояния в обе стороны. Команды от Салют превращаются в вызовы HA-сервисов, а изменения в HA моментально отражаются в приложении Сбер.\n\n```mermaid\nflowchart LR\n    HA[\"🏠 Home Assistant\\n(ваши устройства)\"]\n    Bridge[\"🔌 Sber MQTT Bridge\\n(эта интеграция)\"]\n    Cloud[\"☁️ Облако Sber\\n(MQTT broker)\"]\n    App[\"🗣️ Салют / Приложение Сбер\\n(голос и мобильное управление)\"]\n\n    HA \u003c--\u003e Bridge \u003c--\u003e Cloud \u003c--\u003e App\n```\n\n## Возможности\n\n- Нативная интеграция HA -- устанавливается через HACS, без дополнительных аддонов\n- Настройка через UI -- полностью из интерфейса Home Assistant\n- Массовый выбор устройств -- добавить все, по категориям, по меткам (labels), или поштучно\n- Переопределение типов устройств -- смена категории Sber для каждого entity через UI или YAML\n- **Связывание entity (Entity Linking)** -- привязка датчиков батареи, влажности, температуры к основному устройству: одно физическое устройство = одно устройство в Сбер\n- Автоопределение связанных entity по общему `device_id` в мастере добавления\n- Умная дедупликация -- если устройство имеет и `light` и `switch`, выбирается более функциональный вариант\n- Синхронизация в реальном времени -- изменения в HA мгновенно видны в Сбер (debounce 100мс)\n- Голосовое управление через всех ассистентов Сбер (Салют, Афина, Джой)\n- **28 категорий Sber (27 типов устройств + hub)** с автоматическим маппингом\n- YAML-кастомизация -- sber_type, sber_name, sber_room, sber_nicknames, sber_groups, sber_features и другое\n- Фильтрация по меткам (labels) -- экспорт entity по меткам HA\n- Интеграция с HA Repairs -- автоматическое обнаружение проблем (отсутствующие entity, проблемы подключения)\n- Сохранение переопределений -- переименования и комнаты из приложения Сбер переживают перезапуск HA\n- Автоматическая повторная публикация конфигурации, когда Sber запрашивает неизвестные entity\n- Валидация протокола через Pydantic -- строгая типизация JSON-сообщений Sber\n- **Автоматическое обнаружение дрейфа спецификации Sber** -- еженедельный CI-scraper тянет каноничные схемы с `developers.sber.ru`, сравнивает с нашими моделями и открывает PR при расхождениях (см. `tools/fetch_sber_schemas.py`, `tools/codegen.py`)\n- **Runtime-валидация типов features** -- сгенерированный из документации Sber словарь `FEATURE_TYPES` ловит несоответствия (напр. PIR как BOOL вместо ENUM) до отправки в облако\n- **Валидация обязательных features (✔︎ markers)** -- `CATEGORY_OBLIGATORY_FEATURES` автоматически собирается из таблицы \"Доступные функции устройства\" Sber и гарантирует, что устройство эмитит полный набор обязательных функций (напр. `valve` без `open_percentage` ловится до публикации)\n- Мониторинг подключения и диагностика\n- Отслеживание подтверждения устройств -- видно, какие устройства Sber подтвердил\n- Автоматическое переподключение с экспоненциальной задержкой (5сек -\u003e 5мин)\n- SSL сертификат (настраивается)\n- Переводы: английский и русский\n- CI/CD: ruff, pytest, HACS validation, hassfest, Sber spec drift detection\n- **1760+ тестов**\n\n## Ключевые фичи v1.10\n\n### Типизированные константы (sber_constants.py)\n\nМодуль `sber_constants.py` содержит строго типизированные `StrEnum`-константы для всего протокола Sber:\n- **SberFeature** — 61 ключ признаков устройств (все feature-имена протокола)\n- **SberValueType** — типы значений (`BOOL`, `INT`, `ENUM`, `COLOUR`, `FLOAT`)\n- **HAState** — состояния Home Assistant (`on`, `off`, `open`, `closed` и др.)\n- **MqttTopicSuffix** — суффиксы MQTT-топиков\n\n### Pydantic-хелперы для значений\n\nФункции-фабрики для формирования значений протокола Sber:\n- `make_state()` — создание структуры состояния\n- `make_bool_value()` — булево значение\n- `make_integer_value()` — целочисленное значение (возвращает строку согласно спецификации Sber)\n- `make_enum_value()` — enum-значение\n- `make_colour_value()` — цветовое значение HSV\n\n### HA Context propagation\n\nКоманды от Sber передаются в Home Assistant с заполненным `Context`, что обеспечивает корректную атрибуцию в журнале (logbook). В логах HA видно, что команда пришла именно от Sber-интеграции.\n\n### Value change diffing\n\nМетод `has_significant_change()` сравнивает новое состояние со старым перед каждой публикацией. Это исключает лишние MQTT publish при незначительных изменениях (например, при поллинге HA без реального изменения значения).\n\n### Online status logic\n\nЛогика онлайн-статуса дифференцирована по типу сенсора:\n- **Event-based** binary_sensors (движение, дверь, протечка): `unknown` = **online** (датчик ждёт события)\n- **Value-based** сенсоры (температура, влажность): `unknown` = **offline** (нет данных = нет связи)\n- Значок **\"Loading...\"** в панели означает, что HA ещё не получил ни одного состояния от entity\n\n## Поддерживаемые типы устройств\n\n| Домен HA | Категория Sber | Возможности | Роли связывания |\n|----------|----------------|-------------|-----------------|\n| `light` | light | Вкл/выкл, яркость, цвет (HSV), цветовая температура | -- |\n| `light` (LED-лента) | led_strip | LED-лента с цветом/яркостью | -- |\n| `switch` | relay | Вкл/выкл | -- |\n| `switch` (розетка) | socket | Вкл/выкл (иконка розетки в Сбер) | -- |\n| `script` | relay | Запуск скрипта | -- |\n| `button` | relay | Нажатие кнопки | -- |\n| `cover` | curtain | Открыть/закрыть/стоп, позиция 0-100% | -- |\n| `cover` (жалюзи) | window_blind | Открыть/закрыть/стоп, позиция 0-100% | -- |\n| `climate` | hvac_ac | Вкл/выкл, температура, вентилятор, качание, режим | temperature |\n| `climate` (радиатор) | hvac_radiator | Вкл/выкл, температура (25-40C) | -- |\n| `climate` (обогреватель) | hvac_heater | Обогреватель | -- |\n| `climate` (тёплый пол) | hvac_underfloor_heating | Тёплый пол | -- |\n| `sensor` (температура) | sensor_temp | Показания температуры (точность 0.1C) | battery, signal_strength, humidity |\n| `sensor` (влажность) | sensor_humidity | Показания влажности (0-100%) | battery, signal_strength, temperature |\n| `binary_sensor` (движение) | sensor_pir | Обнаружение движения | battery, signal_strength |\n| `binary_sensor` (дверь) | sensor_door | Состояние открыто/закрыто | battery, signal_strength |\n| `binary_sensor` (протечка) | sensor_water_leak | Обнаружение протечки | battery, signal_strength |\n| `binary_sensor` (дым) | sensor_smoke | Датчик дыма | battery, signal_strength |\n| `binary_sensor` (газ) | sensor_gas | Датчик утечки газа | battery, signal_strength |\n| `input_boolean` | scenario_button | Клик / двойной клик | -- |\n| `valve` | valve | Открыть/закрыть вентиль | -- |\n| `humidifier` | hvac_humidifier | Вкл/выкл, влажность, режим работы | humidity |\n| `fan` | hvac_fan | Вентилятор | -- |\n| `fan` (очиститель воздуха) | hvac_air_purifier | Очиститель воздуха | -- |\n| `water_heater` | hvac_boiler | Бойлер/водонагреватель | -- |\n| `water_heater` (чайник) | kettle | Умный чайник | -- |\n| `media_player` | tv | Телевизор | -- |\n| `vacuum` | vacuum_cleaner | Робот-пылесос | -- |\n| -- (только через override) | intercom | Домофон | -- |\n\n\u003e [!IMPORTANT]\n\u003e **Протестировано на реальном оборудовании: 12 из 28 категорий** (light, climate, curtain, valve, fan, sensor_pir, sensor_temp, sensor_water_leak, humidifier, tv, scenario_button, hub).\n\u003e 16 категорий ещё не проверены на физических устройствах -- нужна помощь сообщества!\n\u003e\n\u003e **[Полный статус тестирования устройств](https://dzerik.github.io/sber-mqtt-bridge/devices/#статус-тестирования-на-реальном-оборудовании)**\n\n## Подготовка -- Настройка Sber Studio\n\nПеред установкой интеграции нужно получить MQTT-учётные данные от Sber.\n\n### Шаг 1: Регистрация в Sber Studio\n\n1. Перейдите на [Sber Studio](https://developers.sber.ru/studio/workspaces/)\n2. Войдите с вашим Sber ID (тот же аккаунт, что и в приложении Сбер Умный дом)\n3. Создайте рабочее пространство, если его ещё нет\n\n### Шаг 2: Создание проекта интеграции\n\n1. В Sber Studio перейдите в раздел **Умный дом**\n2. Нажмите **Создать проект**\n3. Выберите тип **MQTT-интеграция**\n4. Дайте проекту имя (например, \"Home Assistant Bridge\")\n\n### Шаг 3: Получение MQTT-учётных данных\n\n1. Откройте настройки проекта\n2. Найдите раздел **MQTT-подключение**\n3. Скопируйте **Логин** и **Пароль** -- они понадобятся в HA\n4. Адрес брокера: `mqtt-partners.iot.sberdevices.ru`, порт: `8883`\n\nПодробная инструкция: [Документация Sber MQTT-to-Cloud](https://developers.sber.ru/docs/ru/smarthome/mqtt-diy/mqtt-to-diy)\n\n### Шаг 4: Привязка в приложении Сбер\n\n1. Откройте приложение **Сбер Умный дом** на телефоне\n2. Перейдите в **Настройки** \u003e **Подключенные сервисы**\n3. Ваша MQTT-интеграция должна появиться -- включите её\n4. Устройства появятся в приложении после подключения моста\n\n## Установка\n\n### HACS (рекомендуется)\n\n[![Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.](https://my.home-assistant.io/badges/hacs_repository.svg)](https://my.home-assistant.io/redirect/hacs_repository/?owner=dzerik\u0026repository=sber-mqtt-bridge\u0026category=integration)\n\nНажмите кнопку выше — HACS откроется на странице репозитория, останется только нажать **Download**.\n\nИли вручную:\n\n1. Откройте **HACS** в Home Assistant\n2. Нажмите меню (три точки) \u003e **Пользовательские репозитории**\n3. Добавьте `https://github.com/dzerik/sber-mqtt-bridge` с категорией **Интеграция**\n4. Найдите **\"Sber Smart Home MQTT Bridge\"** и нажмите **Установить**\n5. **Перезагрузите Home Assistant**\n\n### Ручная установка\n\n1. Скачайте [последний релиз](https://github.com/dzerik/sber-mqtt-bridge/releases)\n2. Скопируйте папку `custom_components/sber_mqtt_bridge/` в `config/custom_components/` вашего HA\n3. Перезагрузите Home Assistant\n\n## Настройка\n\n### Первоначальная настройка\n\n1. Перейдите в **Настройки** \u003e **Устройства и службы** \u003e **Добавить интеграцию**\n2. Найдите **\"Sber Smart Home MQTT Bridge\"**\n3. Введите учётные данные MQTT:\n\n| Параметр | Обязательный | По умолчанию | Описание |\n|----------|-------------|--------------|----------|\n| MQTT Логин | Да | -- | Логин из проекта Sber Studio |\n| MQTT Пароль | Да | -- | Пароль из проекта Sber Studio |\n| MQTT Брокер | Нет | `mqtt-partners.iot.sberdevices.ru` | Адрес брокера |\n| MQTT Порт | Нет | `8883` | Порт брокера (TLS) |\n| Проверять SSL | Нет | `true` | Проверка сертификата брокера |\n\n### Выбор устройств\n\nПосле настройки перейдите в параметры интеграции для выбора устройств. Доступны пять режимов:\n\n| Режим | Описание |\n|-------|----------|\n| **Выбрать вручную** | Выбрать отдельные устройства из списка с поиском. Здесь же можно удалять. |\n| **Добавить по категории** | Выбрать категории (Свет, Переключатели и т.д.) с количеством устройств. Добавляет все устройства из выбранных категорий. Существующий выбор сохраняется. |\n| **Добавить по метке** | Выбрать метки (labels) HA для экспорта всех entity с этими метками. |\n| **Добавить ВСЕ** | Один клик: добавить все поддерживаемые устройства в Sber. |\n| **Удалить ВСЕ** | Очистить весь список. |\n\n**Переопределение типов устройств**: В меню Параметры можно переопределить категорию Sber для любого entity. Например, изменить `switch` с `relay` на `socket`, чтобы он отображался как умная розетка в приложении Сбер.\n\n**Умная дедупликация**: Если Zigbee-устройство регистрирует и `light.кухня` и `switch.кухня`, включается только `light` (более богатый API с яркостью/цветом). Приоритет: light \u003e cover \u003e climate \u003e humidifier \u003e valve \u003e sensor \u003e switch \u003e script \u003e button.\n\n### YAML-кастомизация\n\nВы можете точно настроить отображение entity в Sber через `configuration.yaml`:\n\n```yaml\nsber_mqtt_bridge:\n  entity_config:\n    light.kitchen:\n      sber_type: light           # Переопределить категорию Sber\n      sber_name: \"Свет на кухне\" # Имя в приложении Сбер\n      sber_room: \"Кухня\"         # Назначение комнаты\n      sber_nicknames:            # Альтернативные имена для голосового управления\n        - \"основной свет\"\n        - \"потолочный свет\"\n      sber_groups:               # Группы устройств\n        - \"kitchen_lights\"\n      sber_features_add:         # Добавить возможности Sber\n        - \"colour_setting\"\n      sber_features_remove:      # Убрать возможности Sber\n        - \"colour_temp\"\n      sber_partner_meta: {}      # Пользовательские метаданные партнёра\n      sber_parent_id: \"light.living_room\"  # ID родительского устройства\n```\n\n| Параметр | Описание |\n|----------|----------|\n| `sber_type` | Переопределить автоматически определённую категорию Sber (например, `relay` -\u003e `socket`) |\n| `sber_name` | Пользовательское имя устройства в приложении Сбер и для голосовых команд |\n| `sber_room` | Комната в Sber (переопределяет назначение из приложения) |\n| `sber_nicknames` | Альтернативные имена для голосового управления |\n| `sber_groups` | ID групп для объединения устройств в Sber |\n| `sber_features_add` | Дополнительные возможности Sber для публикации |\n| `sber_features_remove` | Возможности Sber для отключения |\n| `sber_partner_meta` | Пользовательские метаданные, передаваемые в Sber |\n| `sber_parent_id` | Entity ID родительского устройства для иерархической группировки |\n\n### Связывание entity (Entity Linking)\n\nСвязывание entity позволяет привязать вспомогательные HA-сущности (датчик батареи, уровень сигнала, влажность, температура) к основному устройству Sber. Это отражает физическую реальность: один Zigbee-датчик создаёт несколько entity в HA, но должен выглядеть как одно устройство в приложении Сбер.\n\n**Без связывания**: датчик протечки с датчиком батареи создаёт два отдельных устройства Sber.\n**Со связыванием**: уровень заряда батареи автоматически включается в состояние датчика протечки — одно устройство, полные данные.\n\n#### Поддерживаемые роли по категории Sber\n\n| Категория Sber | Доступные роли |\n|----------------|----------------|\n| sensor_water_leak | battery, signal_strength |\n| sensor_pir | battery, signal_strength |\n| sensor_door | battery, signal_strength |\n| sensor_temp | battery, signal_strength, humidity |\n| sensor_humidity | battery, signal_strength, temperature |\n| hvac_ac | temperature |\n| hvac_humidifier | humidity |\n\n#### Процесс в мастере добавления\n\n1. Выберите тип устройства и основную entity.\n2. Мастер автоматически определяет связанные entity, разделяющие один `device_id` в HA.\n3. Совместимые entity предвыбраны (отображаются зелёными). Несовместимые отображаются серым с пометкой \"(not supported)\".\n4. Укажите имя и подтвердите.\n5. Привязанные entity исчезают из списка доступных entity — ими управляет основное устройство.\n\nДанные привязанных entity (уровень батареи, уровень сигнала и т.д.) включаются в каждую публикацию состояния основного устройства в Sber. Изменение состояния привязанной entity вызывает немедленную повторную публикацию состояния основного устройства.\n\n### Sidebar Panel (встроенная панель управления)\n\nИнтеграция добавляет собственную панель в боковое меню Home Assistant (SPA-приложение):\n\n| Вкладка | Описание |\n|---------|----------|\n| **Devices** | Таблица всех экспортируемых устройств: имя, entity_id, категория Sber, статус онлайн, подтверждение от Sber |\n| **Add Device Wizard** | Мастер добавления: выбор типа устройства, основной entity и связанных entity (battery, signal и др.) |\n| **DevTools** | Отладочный инструмент: raw конфиг и состояния, лог MQTT-сообщений в реальном времени |\n\n**Entity Preview в мастере добавления**: при выборе типа устройства мастер показывает предварительный просмотр того, как entity будет выглядеть в Sber — какие features будут опубликованы.\n\n### Управление устройствами в приложении Сбер\n\nПосле добавления устройств:\n\n1. Откройте приложение **Сбер Умный дом**\n2. Устройства появятся автоматически (может занять 10-30 секунд)\n3. **Переименовать устройство**: нажмите на устройство \u003e иконка настроек \u003e измените имя\n4. **Назначить комнату**: нажмите на устройство \u003e иконка настроек \u003e выберите комнату\n5. **Голосовое управление**: скажите *\"Салют, включи свет на кухне\"*\n\n**Примеры голосовых команд:**\n- *\"Салют, включи свет в гостиной\"*\n- *\"Салют, выключи все розетки\"*\n- *\"Салют, какая температура в спальне?\"*\n- *\"Салют, закрой шторы\"*\n- *\"Салют, установи температуру 23 градуса\"*\n- *\"Салют, включи увлажнитель\"*\n\n**Примечание**: Переименования и назначения комнат, сделанные в приложении Сбер, сохраняются локально в интеграции и будут включены в будущие публикации конфигурации. Эти данные сохраняются при перезапуске HA.\n\n## Устранение неполадок\n\n| Проблема | Решение |\n|----------|---------|\n| Не удаётся подключиться | Проверьте учётные данные в Sber Studio. Убедитесь, что проект активен. |\n| Ошибки SSL | Попробуйте отключить \"Проверять SSL\" в настройках интеграции (для нестандартных CA). |\n| Устройства не появляются в Сбер | Проверьте Параметры \u003e выберите устройства. Проверьте логи HA на предупреждения маппинга. |\n| Устройства появляются и исчезают | Проверьте логи HA на сообщения о переподключении. Убедитесь в стабильности интернета. |\n| Дублирование устройств | Удалите дубли в Параметры \u003e ручной режим. Или \"Удалить ВСЕ\", затем \"Добавить ВСЕ\" для чистого сброса. |\n| Датчики показывают неверные значения | Включите отладочные логи и проверьте маппинг entity в логах. |\n| Пропавшие entity или проблемы подключения | Проверьте **Настройки \u003e Ремонт** -- интеграция автоматически создаёт уведомления о типичных проблемах. |\n\n### Отладка через DevTools (Sidebar Panel)\n\nВкладка **DevTools** в Sidebar Panel предоставляет инструменты для отладки без перезапуска HA:\n- **Raw Config** — полная конфигурация устройств в формате JSON, который отправляется в Sber\n- **Raw States** — текущие состояния всех устройств в Sber-формате\n- **MQTT Log** — лог MQTT-сообщений в реальном времени (входящие и исходящие)\n\n### HA Repairs (Ремонт)\n\nИнтеграция использует систему Repairs в Home Assistant для уведомления о проблемах. Перейдите в **Настройки** \u003e **Ремонт** для просмотра активных проблем:\n- Отсутствующие entity, которые были ранее экспортированы\n- Ошибки подключения MQTT\n- Проблемы конфигурации\n\n### Отладочные логи\n\nДобавьте в `configuration.yaml`:\n\n```yaml\nlogger:\n  logs:\n    custom_components.sber_mqtt_bridge: debug\n```\n\nУвидите:\n- `MQTT \u003c- topic (N bytes)` -- каждое входящее MQTT сообщение\n- `Sber -\u003e HA command: entity_id [ключи]` -- детали команды\n- `HA -\u003e Sber state: entity_id = состояние` -- публикация состояний\n- `Entity xxx -\u003e Sber категория (домен, device_class)` -- решения маппинга\n- `Sber error (#N): {...}` -- ошибки от облака Sber\n\n### Диагностика\n\nПерейдите в **Настройки** \u003e **Устройства и службы** \u003e **Sber Smart Home MQTT Bridge** \u003e **три точки** \u003e **Скачать диагностику**. Файл содержит:\n- Статус подключения и время работы\n- Счётчики сообщений (получено, отправлено, ошибки)\n- Список подтверждённых/неподтверждённых устройств\n- Конфигурацию устройств\n\n## Торговые марки и правовая информация\n\nВсе названия продуктов, логотипы и бренды, упомянутые в этом проекте, являются собственностью их владельцев:\n\n- **Сбер**, **SberDevices**, **Салют**, **Сбер Умный дом** -- торговые марки [Сбер](https://www.sber.ru/) (ПАО Сбербанк).\n- **Home Assistant** -- торговая марка проекта [Home Assistant](https://www.home-assistant.io/).\n- **HACS** (Home Assistant Community Store) -- независимый проект сообщества.\n\nЭтот проект не связан, не одобрен и не спонсирован Сбером, SberDevices или проектом Home Assistant. Это независимая интеграция с открытым исходным кодом.\n\n## Ссылки\n\n- [Документация проекта (GitHub Pages)](https://dzerik.github.io/sber-mqtt-bridge/)\n- [API Reference](https://dzerik.github.io/sber-mqtt-bridge/api/)\n- [Портал разработчиков Sber Smart Home](https://developers.sber.ru/docs/ru/smarthome)\n- [Регистрация в Sber Studio](https://developers.sber.ru/docs/ru/smarthome/space/registration)\n- [Руководство MQTT-to-Cloud](https://developers.sber.ru/docs/ru/smarthome/mqtt-diy/mqtt-to-diy)\n- [Поддерживаемые категории устройств](https://developers.sber.ru/docs/ru/smarthome/c2c/devices)\n\n## Участие в разработке\n\nСмотрите [CONTRIBUTING.md](CONTRIBUTING.md) для настройки среды разработки и рекомендаций.\n\n## Лицензия\n\n[MIT](LICENSE.txt)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdzerik%2Fsber-mqtt-bridge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdzerik%2Fsber-mqtt-bridge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdzerik%2Fsber-mqtt-bridge/lists"}