Ватты на экране: что проверить у розетки с измерением мощности

Карточка умной розетки может показывать мощность и напряжение, но при переносе данных в другой сервис легко потерять единицу или выбрать соседнее поле с похожим названием. Для проверки интеграции полезно посмотреть, что именно передаётся под подписью "мощность" и как приложение преобразует исходное число.

В справочнике есть несколько разных полей

Google ElectricalPowerMeasurement описывает activePower в милливаттах, apparentPower в милливольт-амперах и reactivePower в реактивных милливольт-амперах. Напряжение voltage передаётся в милливольтах. Эти атрибуты имеют разные названия и единицы, поэтому сводить их к одной неподписанной колонке при экспорте нельзя.

Для поддерживаемых видов измерений предусмотрен список характеристик точности accuracy. Поле ranges содержит измерительные диапазоны, а numberOfMeasurementTypes сообщает максимальное число типов измерений, которые способен передавать узел. Справочник предусматривает необязательные поля, конкретный прибор может предоставлять только часть описанного набора.

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

Проверка без догадок по графику

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

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

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

Измерение и управление нагрузкой

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

Если измерение используется как условие автоматизации, заранее опишите действие при недоступных или устаревших данных. Порог имеет смысл только вместе с единицей и подтверждённым назначением показателя. Сценарий должен быть понятен другому человеку, который позже откроет настройки и увидит число без истории его появления.

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

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

Исходник: ElectricalPowerMeasurementTrait.Attributes, Google, документация Google Home Developers. Язык оригинала: английский. Режим: сокращённый перевод и редакционная адаптация. Использованы разделы Public properties: activePower, apparentPower, reactivePower, voltage, accuracy, ranges, numberOfMeasurementTypes.

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