Термостат показывает "нагрев": что именно сейчас включено

В приложении выбран режим нагрева, температура уже достигнута, а оборудование в этот момент может ожидать следующего цикла. Чтобы прочитать такую карточку, нужно видеть, какое именно состояние она показывает. Схема Google TemperatureSetting разделяет несколько полей, которые в простом интерфейсе легко принять за один признак "включено".

Режим и текущая работа

Поле thermostatMode описывает выбранный режим устройства, activeThermostatMode сообщает о текущем активном режиме, а значение none означает отсутствие активного режима в этот момент. Набор допустимых вариантов объявляется для конкретного устройства через availableThermostatModes. Поэтому наличие слова heat в общей документации не подтверждает поддержку нагрева любой подключённой моделью.

Измеренная температура среды и целевая температура тоже передаются отдельно. Для одиночной цели используется setpoint, в режиме heatcool предусмотрены нижняя и верхняя границы. Схема позволяет указать минимальное расстояние между этими границами через bufferRangeCelsius. Это часть описания интеграции, конкретные ограничения проверяют у самого оборудования.

В командах и состояниях температура передаётся в градусах Цельсия, даже если пользователь выбирает отображение по Фаренгейту. Документ также предусматривает устройства, которые только принимают команды, и устройства, у которых доступно лишь чтение состояния. Возможность прочитать температуру сама по себе не подтверждает возможность изменить её через эту интеграцию.

Что проверить в своей карточке

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

При первом знакомстве с интеграцией выберите разрешённую производителем настройку и проследите, что возвращается после команды. Сохранилась ли цель после повторного открытия карточки, совпадает ли она с локальным экраном и не отклонило ли устройство значение за пределами доступного диапазона? Это проверка согласованности управления, делать вывод об эффективности отопления по одному такому действию оснований нет.

Для диапазона heatcool проверяйте обе границы вместе. Если приложение изменяет одну из них автоматически, выясните, связано ли это с минимальным расстоянием, расписанием или правилами конкретной модели. Страница API описывает формат полей, но не устанавливает комфортную температуру для всех домов и не объясняет устройство вашей системы отопления.

Где сохраняется расписание

Отдельно разберитесь, кто хранит расписание и кто отправляет команды: сам термостат, домашний контроллер или облачный сервис. Владелец может видеть одну карточку, хотя доступ с телефона и локальное регулирование имеют разные зависимости. Условия работы при потере интернета нужно проверять по документации модели и используемой платформы.

Зафиксируйте доступные режимы и назначение полей рядом с настройками автоматизации. Это особенно полезно, если позже меняется приложение или добавляется второй источник команд. Изменение цели по расписанию должно оставлять понятное объяснение для человека, который вручную выставил другую температуру несколько минут назад.

Источник и права

Исходник: Smart Home TemperatureSetting Trait Schema, Google, документация Google Home Developers. Язык оригинала: английский. Режим: сокращённый перевод и редакционная адаптация. Использованы разделы Device ATTRIBUTES, Device STATES, команды установки температуры и диапазона.

Текст оригинала опубликован по Creative Commons Attribution 4.0 International. Материал переведён на русский, сокращён и перестроен; программные примеры и тестовые задания опущены, добавлены пояснения и бытовые ситуации редакции. Адаптацию подготовило издание команды sentibox. Google и участники OpenThread не проверяли и не одобряли эту публикацию. Оригинальная схема редакции также доступна по CC BY 4.0.