IAMMETER добавляет поддержку SunSpec Modbus/TCP: сопоставление моделей и руководство по интеграции
Прошивка IAMMETER i.91.065.18 добавляет карту целочисленных моделей счётчика SunSpec, доступную только для чтения, в существующую службу Modbus/TCP. Это даёт программному обеспечению, которое понимает модели SunSpec, стандартный способ обнаружить счётчик IAMMETER и считать выбранные электрические величины по локальной сети.
Это дополнение интерфейса, а не замена системы измерений. Счётчик продолжает собирать данные тем же способом. Существующие регистры IAMMETER Modbus, HTTP API, полезная нагрузка MQTT и настройки NEM остаются без изменений.
SunSpec определяет стандартные информационные модели устройств, которые можно отобразить в регистры хранения Modbus. Его карта начинается с маркера SunS, за которым следуют Common-модель и модели, специфичные для устройства; клиент может обнаружить их, последовательно считывая идентификатор и длину каждой модели. Пакет спецификаций SunSpec Modbus описывает схему обнаружения моделей, включая расположение адресов карты Modbus с нулевой базой и правила для нереализованных значений. SunSpec Modbus применяется в интеграциях распределённой энергетики, в том числе для счётчиков, инверторов и оборудования накопления энергии.
IAMMETER реализует специализированный набор данных счетчиков, доступный только для чтения. Эта реализация не сертифицирована SunSpec. Не рассматривайте эту функцию как сертификацию, полное соответствие SunSpec или гарантию того, что каждый сторонний клиент SunSpec будет работать без настройки.
Сопоставление текущей модели прошивки
| IAMMETER метр | Модель целочисленного счетчика SunSpec | Электрическая интерпретация |
|---|---|---|
| WEM3080 | 201 | Однофазный |
| WEM2067 | 202 | Split phase (Разделенная фаза) |
| WEM3050T | 203 | Трехфазная звезда |
| WEM3080T | 203 | Трехфазная звезда |
| WEM3046T | 203 | Трехфазная звезда |
| WEM3063T | 203 | Трехфазная звезда |
Эти строки описывают текущие сопоставления моделей встроенного ПО. Описанная здесь проверка физического устройства охватывает только WEM3080T; остальные перечисленные модели по-прежнему требуют тестирования устройства.
Для WEM2067 модель 202 представляет собой настоящую установку с расщепленной фазой. Он не описывает две несвязанные однофазные цепи как одно и то же электрическое устройство.
Код для модели 204 охватывается хост-тестированием, но прошивка еще не обнаруживает и не выбирает его автоматически для WEM3080TD. Поэтому в этой статье не утверждается о доступности модели 204. WEM3046TE также еще не прошел специальную проверку идентификации модели. Первый выпуск поддерживает только целочисленные модели: модели с плавающей запятой с 211 по 214 недоступны.
Что может прочитать клиент
Модели целочисленных счетчиков отображают фазовое напряжение, фазный ток, фазную активную мощность, общую активную мощность, частоту, фазный коэффициент мощности, а также пофазные и общие аккумуляторы импорта/экспорта активной энергии. Общая модель предоставляет идентификационные данные устройства, такие как модель, версия прошивки и серийный номер.
Энергия представлена в Wh на карте SunSpec; коэффициент мощности представлен в процентах. Точки общей энергии повторно используют существующие общие поля счетчика и семантику NEM. IAMMETER не пересчитывает сумму трех фаз путем добавления аккумуляторов фаз в это сопоставление. Поскольку настройка NEM влияет на значение этих аккумуляторов, клиент не должен предполагать, что полная энергия всегда равна сумме фазовой энергии.
В этой первой версии намеренно отсутствуют некоторые поля: реактивная мощность и реактивная энергия, полная мощность и полная энергия, многофазный общий коэффициент мощности и флаги событий. Их стандартные местоположения остаются в модели и возвращают соответствующий недоступный маркер. Клиент SunSpec должен распознавать недоступные значения, а не интерпретировать их как измерения.
Интерпретация напряжения имеет значение
Значения по фазам поступают от счётчика. Некоторые точки линейного напряжения выводятся для сопоставления модели:
- Линейное напряжение модели 202 — это
UA + UB. - Линейное напряжение модели 203 — это приближение фазного напряжения, умноженного на
√3; это не прямое измерение между линиями. Несимметричная система или отклонение угла фазы могут дать погрешность.
Это различие важно для приложений, которым нужно непосредственно измеренное линейное напряжение. Перед использованием производного значения для управления или решений о соответствии проверьте определение точки модели и схему подключения.
Соединение с Modbus/TCP
Включите существующую службу Modbus/TCP счетчика, затем подключитесь к его адресу LAN:
| Товар | Настройка |
|---|---|
| Хозяин | IP-адрес локальной сети измерителя |
| TCP-порт | 502 |
| Функция чтения | 03 — Read Holding Registers |
| Начальный адрес SunSpec | 40000 |
| Доступ для записи | Не поддерживается картой IAMMETER SunSpec |
Адреса в этом руководстве представляют собой адреса запросов Modbus, отсчитываемые от 0. Некоторые приложения отображают номера регистров, отсчитываемые от 1, поэтому проверьте их соответствие перед настройкой чтения; адрес с отклонением на единицу не вернет ожидаемый маркер.
Используйте код функции 03 для каждого прочтения ниже. Подсчеты регистров включают идентификатор модели и длину, если это применимо.
| Читать | Начальный адрес (отсчет от 0) | Количество регистров | Ожидаемый результат |
|---|---|---|---|
| Маркер SunSpec | 40000 |
2 | 0x5375, 0x6E53 (SunS) |
| Общая модель | 40002 |
68 | Идентификатор модели 1, длина 66, информация об устройстве |
| Модель счетчика | 40070 |
107 | Идентификатор модели 201, 202 или 203, длина 105, данные счетчика |
| Конечный маркер | 40177 |
2 | Идентификатор модели 0xFFFF, длина 0 |
Один запрос Modbus может прочитать не более 125 регистров, поэтому модели Common и счетчик считывайте отдельно. Клиенты должны узнавать идентификаторы и длины моделей, а не жестко запрограммировать предположения о каждой будущей последовательности моделей.
Целочисленные значения и масштабные коэффициенты
Целочисленные точки SunSpec используют масштабные коэффициенты. Преобразуйте исходное целое по формуле:
фактическое значение = целое из регистра × 10^масштабный коэффициент
Например:
W = 12345
W_SF = 1
фактическая активная мощность = 123450 W
Масштабные коэффициенты могут меняться с диапазоном. Считывайте полную модель счётчика в каждом цикле опроса, чтобы значение и его масштабный коэффициент приходили из одного и того же ответа. Не кэшируйте масштабные коэффициенты бессрочно.
Валидация и текущие ограничения
Валидация имеет две отдельные области:
– Проверка реализации: пройдены хост-тесты для макета модели, преобразования, переполнения, поведения только для чтения и регрессионной проверки для существующих регистров. Тестовый измерительный прибор WEM3080T подтвердил обнаружение модели 203 и непрерывное считывание, при этом напряжение и мощность проверялись по существующим интерфейсам HTTP и Modbus. Другие модели счетчиков и отдельные сторонние клиенты все еще нуждаются в дальнейших физических испытаниях.
- Проверка файла выпуска: прошивка
i.91.065.18была собрана, размещена для скачивания и скачана повторно для проверки файла. Этот точный файл выпуска не был прошит во время этого цикла проверки; приведенные выше результаты реализации не следует рассматривать как тест устройства загруженного файла выпуска.
Прошивка не включает ожидаемое улучшение TCP-фрейминга. В настоящее время он ожидает один полный запрос в операции приема. Разделенные или комбинированные запросы TCP могут закрыть соединение. Отправьте один запрос и дождитесь ответа перед следующим запросом, осознавая при этом, что это не устраняет все риски TCP-сегментации.
Где это применимо к установке IAMMETER
Для выбора архитектуры начните с решения для интеграции и самостоятельного размещения IAMMETER. В руководстве по локальным API и открытым интерфейсам сравниваются доступные интерфейсы счетчиков.
Используйте карту SunSpec при создании локального клиента для обнаружения и чтения моделей счетчиков SunSpec. Используйте существующую карту регистров IAMMETER Modbus/TCP, когда приложению требуются регистры, специфичные для IAMMETER. Существующий локальный путь Modbus остается полезным для интеграции счетчиков энергии Home Assistant, в то время как HTTP, MQTT и IAMMETER Cloud остаются независимыми опциями.
Загрузите прошивку: i.91.065.18.bin.
Перед обновлением следуйте инструкциям по обновлению прошивки IAMMETER и проверьте модель вашего измерителя, способ подключения и доступ к локальной сети. Это интерфейс данных только для чтения; он не обеспечивает управление инвертором, операции записи и не заявляет о полной совместимости со сторонними устройствами SunSpec.
Поделитесь интеграцией IAMMETER с SunSpec и получите 5 000–10 000 Reward Points
Используйте реальное оборудование, чтобы считывать данные счетчика IAMMETER через SunSpec. Результаты, полученные с помощью симулятора, не принимаются.
Участники, которые подготовят подробную документацию по интеграции и опубликуют ее на открытом форуме, после проверки IAMMETER могут получить 5 000–10 000 Reward Points. Размер вознаграждения зависит от качества и полноты документации.
Откройте страницу активности и нажмите Apply, чтобы принять участие.