Ошибки и коды · Инструкция
Matter-лампа добавилась, но нет цвета или температуры: почему так
Проблема не всегда в приложении. В Matter набор доступных органов управления строится из объявленного типа устройства и характеристик, поэтому контроллер может честно показывать только то, что реально экспонирует лампа через Matter.
Короткий ответ
Если Matter-лампа после добавления показывает только ON/OFF или яркость, сначала проверьте, какой Matter device type она объявляет. Color Temperature Light должен поддерживать Color Control для температуры, а Extended Color Light — расширенные цветовые возможности; простой Dimmable/On-Off Light этих функций может не иметь.
Сначала отделите ограничение типа от ошибки интерфейса
В спецификации Google Home для Matter различаются On/Off Light, Dimmable Light, Color Temperature Light и Extended Color Light. У первых двух цвет не является обязательной возможностью, а у последних Color Control входит в набор. Поэтому найдите точное название модели и её заявленный Matter‑тип или перечень функций. Если производитель обещает только диммирование, отсутствие Kelvin/RGB — нормальное поведение. Если заявлен tunable white или color, переходите к проверке контроллера, прошивки и способа добавления.
Совет: Не делайте factory reset до того, как сверили заявленные Matter-возможности: сброс не добавит функцию, которой нет в device type.
Что проверить, если цвет должен быть
- Обновите приложение-контроллер и прошивку лампы через фирменное приложение, если производитель это поддерживает.
- Перезапустите Matter hub/контроллер и приложение, затем снова откройте карточку устройства.
- Проверьте, не добавлена ли лампа через другую интеграцию, которая предоставляет только базовые ON/OFF/Level команды.
- Если есть multi-admin, сравните возможности в другом Matter-контроллере: это помогает отделить проблему устройства от интерфейса.
- Только после этого удаляйте устройство и выполняйте повторное commissioning по коду Matter.
Важно: При удалении устройства из экосистемы убедитесь, что у вас сохранён Matter setup code или есть физический доступ к QR-коду.
Признаки разных причин
- Нет даже яркости — возможно устройство определяется как On/Off Light.
- Есть яркость, но нет Kelvin — проверьте Dimmable Light против Color Temperature Light.
- Есть Kelvin, но нет RGB — возможно это tunable white, а не Extended Color Light.
- В фирменном приложении цвет есть, а через Matter нет — сравните заявленный набор Matter-функций и версию прошивки.
Предупреждение: Фирменная функция и Matter-функция — не одно и то же: производитель может давать эффект или сцену только в своём приложении.
Почему повторное добавление помогает не всегда
Commissioning заново полезен, если контроллер получил некорректное состояние или интеграция обновилась после прошивки. Но если лампа изначально объявляется как Dimmable Light, повторное сканирование QR-кода не превратит её в Extended Color Light. Аналогично, приложение может специально не выводить отдельный элемент управления для редкой характеристики, даже если базовый кластер присутствует. Поэтому оптимальная последовательность — сначала документация и обновления, затем сравнение в другом контроллере и только потом сброс. Так вы не потеряете рабочие автоматизации без необходимости.
Как отличить ограничение лампы от сбоя контроллера
Добавьте лампу в родное приложение производителя и сравните доступные функции с Matter‑контроллером. Если цвет или температура есть у производителя, но отсутствуют через Matter, проблема может быть в опубликованных Matter‑возможностях, прошивке или реализации контроллера. Если функций нет нигде, вероятнее всего, сама модель их не поддерживает. После обновления прошивки удаляйте и добавляйте устройство заново только если обычная синхронизация не вернула нужные controls.
Что учитывать
В спецификации Google Home для Matter различаются On/Off Light, Dimmable Light, Color Temperature Light и Extended Color Light. У первых двух цвет не является обязательной возможностью, а у последних Color Control входит в набор. Поэтому найдите точное название модели и её заявленный Matter‑тип или перечень функций. Если производитель обещает только диммирование, отсутствие Kelvin/RGB — нормальное поведение. Если заявлен tunable white или color, переходите к проверке контроллера, прошивки и…
Источники и проверка
Инструкция составлена редакцией N1RO на 2026-09-23. Перед действием сверьте актуальные условия на официальном сайте сервиса или производителя.