Солнечная система Sigenergy

Адаптер для солнечных энергетических систем Sigenergy через Modbus TCP/RTU

Поддерживает протокол Sigenergy Modbus версии 2.9 (выпущен 13.05.2026).

Функции

• 📡 Modbus TCP (Ethernet / WLAN / Оптоволокно / 4G) — Порт 502
• 🔗 Modbus RTU (последовательный интерфейс RS485)
• ⚡ Полная поддержка регистров — Все регистры для установок, инверторов, PSS и PID соответствуют спецификации V2.9
• 🔋 Статистика батареи — Время до полной зарядки, оставшееся время, время работы в течение дня
• ☀️ Статистика солнечной энергетики — Уровень самопотребления, уровень автаркии
• 🔌 Зарядное устройство переменного тока (Sigen EVAC) — Дополнительно
• ⚡ Зарядное устройство постоянного тока — опционально
• 🏗️ PSS (Power Station Switch) — опционально, мониторинг распределительных устройств среднего и низкого напряжения и распределительных шкафов.
• 🔍 PID (детектирование изоляции фотоэлектрических панелей) — опционально
• 🌡️ Предварительный подогрев ESS — расписание по времени суток, 30 настраиваемых временных окон (M1-HYA/HYB)
• 📈 Расширенные регистры — интеллектуальные нагрузки 1–24, суммарная энергия, параметры сетевого кода
• ☀️ SigenMicro — Поддержка микроинверторов (автоматическое сканирование)
• 📊 Расчетные значения — Полученные статистические данные обновляются в каждом цикле опроса
• 🖥️ Виджеты VIS — Панели мониторинга потока энергии, состояния батареи и статистики.

Поддерживаемое оборудование

Требования

Адреса Modbus по умолчанию

Типы устройств

Начиная с версии 2.4.0, каждый экземпляр адаптера обрабатывает ровно один тип системы Sigenergy (строгое правило «либо/или»). Выберите тип на вкладке «Компоненты» — или используйте функцию «Автоматическое определение с устройства» , чтобы считать его с оборудования. Наборы регистров управляются в соответствии с примечаниями к модели официального протокола Modbus V2.9:

Одна точка подключения Modbus (IP/шина) = один экземпляр. SigenStor с дополнительными микроинверторами SigenMicro относится к одному экземпляру — микроинверторы являются аддитивным компонентом, а не отдельным типом. Существующие конфигурации до версии 2.4.0 переносятся автоматически (полученный тип регистрируется при запуске — пожалуйста, еще раз проверьте вкладку «Компоненты»).

Конфигурация

Вкладка "Подключение"

• Тип соединения : TCP (Ethernet) или последовательный (RS485)
• TCP Host : IP-адрес вашего инвертора
• TCP-порт : 502 (по умолчанию)
• Идентификатор Modbus предприятия : 247 (по умолчанию)
• Идентификатор Modbus инвертора : 1 (по умолчанию)

Вкладка «Компоненты»

Выберите, какие устройства установлены:

• Аккумулятор / ESS
• Фотоэлектрические панели
• Зарядное устройство переменного тока (EVAC)
• Зарядное устройство постоянного тока
• PSS (Power Station Switch)
• PID (обнаружение изоляции фотоэлектрических элементов)
• Предварительный нагрев ESS (только для M1-HYA/HYB)
• SigenMicro (микроинверторы)

Вкладка «Статистика»

Выберите, какие статистические показатели следует рассчитать:

• Время работы от батареи до полной зарядки
• оставшееся время работы батареи
• Ежедневное время зарядки
• Время работы батареи
• Коэффициент самопотребления
• Ставка автаркии

Объекты данных

Растение (plant.*)

Инвертор (inverter.*)

Статистика (statistics.*)

Аварийное переключение — защита внешних фотоэлектрических систем

Фон

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

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

• перегрузка системы управления батареями Sigenergy
• вызывает нестабильность напряжения или частоты в автономной энергосистеме
• могут быть повреждены в результате необычных условий эксплуатации

Единственное безопасное решение — немедленно отключить внешнюю систему, когда Sigenergy переходит в автономный режим.

Как адаптер обрабатывает это

Адаптер осуществляет мониторинг plant.onOffGridStatus заявляют в каждом цикле опросов.

При сбое в электросети (onOffGridStatus = 1 или 2):

• Все настроенные аварийные устройства мгновенно отключаются.
• Уведомление в Telegram отправляется (необязательно)

При возврате по сетке (onOffGridStatus = 0):

• Запускается настраиваемый таймер стабильности (по умолчанию: 10 минут).
• Если электросеть останется стабильной в течение всего периода, работа устройств будет восстановлена.
• Если во время работы таймера произойдет еще один сбой в электросети, таймер отменяется, и устройства остаются выключенными.
• При успешном восстановлении отправляется уведомление в Telegram (необязательно).

Включение функции

Шаг 1 — Вкладка «Компоненты»
Проверьте аварийный шлюз (автономное переключение) .
Вкладка «Аварийное переключение» становится видимой.

Шаг 2 — Вкладка «Аварийное переключение»

Устройства

Уведомления в Telegram (необязательно)

Пример — Балконная электростанция

Реле Shelly Plus 1 подключено последовательно с кабелем питания балконной электростанции. Его идентификатор состояния в ioBroker — [указать идентификатор состояния]. shelly.0.SHPLUS1-ABC123.Relay0.Switch.

Конфигурация:

• Устройство 1 : shelly.0.SHPLUS1-ABC123.Relay0.Switch
  → Реле открывается (false) при сбое в сети, закрывает (true) после стабильного восстановления

Теперь балконная электростанция защищена автоматически.

Виджеты VIS

Примечание: Все 7 виджетов предоставляются отдельным адаптером ioBroker.vis-2-widgets-sigenergy . Установите его вместе с этим адаптером, чтобы использовать виджеты в VIS-2.

Виджет потока энергии

Демонстрирует анимированный поток энергии между фотоэлектрической системой → батареей ↔ сетью → домом.

Виджет состояния батареи

Отображает индикатор уровня заряда батареи (SOC), значок уровня заряда батареи (SOH), время до полной/пустой зарядки, текущий уровень заряда.

Виджет обзора энергопотребления

Отображение в реальном времени всех четырех потоков мощности.

Виджет статистики

Сегодняшние показатели автономности, самопотребления, минимального/максимального уровня заряда батареи и времени автономной работы.

Виджет инвертора

Данные инвертора в режиме реального времени: мощность фотоэлектрической системы, частота сети, фазные напряжения, температура.

Виджет зарядного устройства переменного тока (EVAC)

Показания состояния и уровня заряда зарядной станции Sigen EVAC.

Виджет зарядного устройства постоянного тока

Показания состояния и уровня зарядного устройства постоянного тока.

Протокол связи

• Modbus TCP: режим TCP, полнодуплексный, порт 502 (ведомый).
• Modbus RTU: полудуплексный режим, 9600 бит/с, 8N1
• Минимальный интервал опроса: 1000 мс (1 секунда) согласно спецификации Sigenergy.
• Тайм-аут: 1000 мс согласно спецификации Sigenergy.

Документация

• 🇩🇪 Немецкая документация
• 🇷🇺 Документация на английском языке
• 🇳🇱 Документальные фильмы о Нидерландах
• 🇫🇷 Документация на французском языке
• 🇮🇹Итальянская документация
• 🇪🇸 Документация на испанском языке
• 🇵🇱 Документация польская
• 🇵🇹 Португальская документация
• 🇺🇦 Документация украинская
• 🇨🇳简体中文文档

Changelog

3.3.1 (2026-09-07)

• (ssbingo) fix: registers the device marks as not valid are no longer turned into plausible looking measurements. The protocol signals this by setting all bits ("Range:[0, 0xFFFFFFFE]. With value 0xFFFFFFFF, register is not valid.") and a device answers that way for a register that does not currently apply or that its firmware does not implement. The raw sentinel was scaled by the register gain, so it arrived as a reading that looks real: observed on a SigenStor EC 10.0 TP with a DC charger installed, dcCharger.runningState = 65535 (Appendix 14 only defines 0x00-0x0A), dcCharger.dischargingCurrent = 6553.5 A, dcCharger.currentDischargingCapacity = 42949672.95 kWh and dcCharger.currentDischargingDuration = 4294967295 s, while the neighbouring DC charger registers (rated power, PV generation, totals) returned real values. The same pattern appears outside the DC charger, e.g. plant.currentCtrlCmdValue = 655.35 %, plant.mergedAlarm7 = 65535, inverter.essMaxBatteryCellVoltage = 65.535 V and the ESS/PCS/grid limit registers as 4294967.295 kW. Such registers now report no value instead
• (ssbingo) fix: a register that reports no value no longer feeds the statistics calculation, which keeps the last known good reading instead

3.3.0 (2026-09-07)

• (ssbingo) fix: when the device rejects a grouped register read with a Modbus exception, the registers of that group are now read one by one and only the register(s) the device does not implement are excluded from further polling. Previously a single unsupported register silently disabled its whole group for the rest of the adapter runtime, e.g. dcCharger.runningState (31513) never received a value when the discharging registers 31514–31518 of the same group were rejected
• (ssbingo) feat: new state info.protocolVersion (number, e.g. 2.9) next to the textual info.protocolLevel, so widgets and scripts can adapt to the detected protocol version without parsing strings
• (ssbingo) feat: DC charger registers carry the protocol version that introduced them (since, from the V2.9 revision history: 31509–31511 V2.6, 31513 V2.8, 31514–31525 V2.9); registers newer than the detected protocol level are not requested, so a V2.8 device no longer gets its DC charger group rejected because of the V2.9 discharging registers
• (ssbingo) chore: grouped register reading moved to lib/readGroups.js and covered by unit tests
• (ssbingo) feat: all registers dated by the V2.9 revision history now carry since via a central PROTOCOL_SINCE table in lib/registers.js (plant 30088–30192 V2.6, 30194–30268 V2.7, 30276–30285 V2.8, 30272/30274/30286 V2.9, 40046–40048 V2.6, 40049–40068 V2.8, 40157–40159 V2.9, ESS preheating 50000–50183 V2.9; inverter 30613–30619 V2.6, 31066–31105 V2.8; DC charger 41002/41004 V2.9; all PSS and PID registers V2.9) and are skipped on devices with an older protocol level
• (ssbingo) fix: the one-time control register read (FC03) and the SigenMicro reader use the same per-register fallback as the input register readers; the control registers are read after the protocol detection so the version gating applies to them as well; ESS preheating polling is skipped below protocol V2.9
• (ssbingo) fix: corrected the protocol version marker in the names of the eleven cumulative energy states 30228-30268 from (V2.8) to (V2.7); the revision history of the V2.9 protocol document lists the cumulative energy interface 30196-30268 under V2.7

3.2.0 (2026-09-04)

• (MMeinhardt1) feat: new state statistics.emsWorkMode exposing the EMS work mode as plain text, so consumers do not need the common.states lookup table
• (MMeinhardt1) feat: added EMS work mode 6 (Virtual Power Plant) to the register description and the mode map
• (MMeinhardt1) change: the *HM duration states now hold a bare H:MM value with unit h, instead of embedding an h suffix in the value itself
• (MMeinhardt1) fix: statistics objects are created with extendObjectAsync, so corrected units and roles reach installations where the object already exists
• (ssbingo) chore: admin minimum requirement lowered back to >= 7.8.23 to keep serving admin 7.x installations
• (ssbingo) fix: restored the JSDoc parameter descriptions on _formatMinutesAsHM to keep npm run lint warning-free
• (ssbingo) chore: repository checker findings — track .vscode/settings.json deliberately, bump @alcalzone/release-script-plugin-license to 5.2.2, pin testing-action-deploy to the major version again

3.1.2 (2026-08-06)

• (ssbingo) chore: resolved all 28 npm audit findings (3 critical, 11 high) — development tooling only, the published adapter is unchanged
• (ssbingo) chore: removed @iobroker/dev-server; it was the sole source of the critical findings via the deprecated request and xmldom packages, for which no fixed release exists. This also removes the npm start / npm run watch scripts
• (ssbingo) chore: added overrides lifting transitive dev dependencies onto patched versions
• (ssbingo) chore: removed main.test.js, an unused create-adapter template stub

3.1.1 (2026-08-05)

• (ssbingo) chore: security updates for transitive dependencies (brace-expansion 1.1.18, axios 1.19.0, fast-uri 3.1.5, socket.io-parser 4.2.7)

3.1.0 (2026-08-05)

• (MMeinhardt1) feat: statistics module improvements — new states pvToBatteryPower, batteryToHousePower, gridImportToday, gridExportToday, currentSoc, currentPvPower and h:mm formatted durations for all time statistics
• (MMeinhardt1) feat: daily statistics (SOC min/max, coverage time, grid energy, charging time) are restored from persisted states and now survive an adapter restart mid-day
• (MMeinhardt1) change: batteryDailyChargeTime now reports the cumulative time spent charging today instead of the time until the battery was first full
• (MMeinhardt1) fix: battery coverage time is accumulated incrementally instead of being derived from the capped history buffer, which only spanned ~1 hour
• (ssbingo) chore: minimum requirements raised — js-controller >= 6.0.11, admin >= 8.0.0, Node.js >= 22
• (ssbingo) fix: add missing admin i18n translations for the new battery flow power option across all 11 languages
• (ssbingo) chore: update dependencies (@iobroker/adapter-core 3.4.3, @iobroker/testing 5.3.0, @types/node 22.20.1, ws 8.21.1, actions/setup-node v7, testing-action-deploy 1.5.2)

3.0.10 (2026-06-29)

• (ssbingo) chore: bump js-yaml from 4.1.1 to 4.3.0

3.0.9 (2026-06-29)

• (ssbingo) chore: pin CI actions to major version (@v1) instead of patch version

3.0.8 (2026-06-29)

• (ssbingo) fix: add missing i18n translations for SigenMicro scan UI strings (es, fr, it, nl, pl, pt, uk, zh-cn)

3.0.7 (2026-06-28)

• (ssbingo) chore: update dependencies (@iobroker/adapter-core 3.4.1, @types/node 22.20.0, testing-action-adapter 1.1.1, testing-action-deploy 1.5.0, http-proxy-middleware 3.0.7)

3.0.6 (2026-06-14)

• (ssbingo) fix: remove duplicate common.license field — licenseInformation already present

3.0.5 (2026-06-14)

• (ssbingo) fix: add missing license field to io-package.json common block

3.0.4 (2026-06-14)

• (ssbingo) fix: emergency Telegram notification now sent only once per grid-failure event (not repeated every poll); device switching limited to 3 attempts max (initial + 2 retries) while off-grid

3.0.3 (2026-06-13)

• (ssbingo) fix: remove non-functional welcomeText from io-package.json; add visible warning staticText in Emergency Switching config tab (yellow box, i18n in all 11 languages)

3.0.2 (2026-06-13)

• (ssbingo) fix: ESLint/Prettier errors in emergency switching methods — remove unused variable, fix indentation, add JSDoc @param types

3.0.1 (2026-06-13)

• (ssbingo) feat: add welcomeText to io-package.json — multilingual notice about emergency gateway switching feature

3.0.0 (2026-06-13)

• (ssbingo) feat: emergency gateway switching — automatic disconnection of external PV systems (balcony power plants, micro-inverters) on grid failure; configurable stability timer on grid return; optional Telegram notifications
• (ssbingo) docs: emergency switching documentation added in all 11 languages

2.5.2 (2026-06-12)

• (ssbingo) fix: URL-encode spaces in Buy Me a Coffee button src — image was not rendering on GitHub

2.5.1 (2026-06-12)

• (ssbingo) fix: correct instanceObject role for info.modelType from 'info.name' to 'text' (W1133/W1135 adapter-checker warnings)

2.5.0 (2026-06-12)

• (ssbingo) Architectural write safety: Modbus writes are rejected in the write dispatcher itself when the target register is not valid for the configured device type (models gating in onStateChange, plant guard for SigenMicro-only)
• (ssbingo) TypeScript type check fixed — new lib/adapter-config.d.ts with full AdapterConfig declaration, typed modbus-serial constructor, ioBroker.CommonType/SettableObject annotations; new npm run check script passes with 0 errors
• (ssbingo) ESLint configuration allows JSDoc @type tags in this checked-JavaScript project (jsdoc/check-tag-names with typed:false)

2.4.0 (2026-06-12)

• (ssbingo) Device type architecture: mandatory selector (SigenStor / Sigen Hybrid / Sigen PV M1-HYB / PV-only inverter / SigenMicro-only) with strict either/or register gating per protocol V2.9 model footnotes
• (ssbingo) Sigen Hybrid and PV-only inverters (Sigen PV / PV Max) officially supported
• (ssbingo) Auto-detect device type from hardware in the admin UI (registers 30500 / 31024)
• (ssbingo) Model verification on startup — warns when configuration and detected hardware mismatch (new state info.modelType)
• (ssbingo) Dynamic PV string registers: PV5-PV16 voltage/current enabled by the string count reported in register 31025
• (ssbingo) PCC power factor controls (40157/40158) gated to Sigen PV M1-HYB; ESS preheating gated to M1-HYB; DC charger and grid code gated to SigenStor/Sigen Hybrid
• (ssbingo) Automatic migration of pre-2.4.0 configurations and cleanup of channels that are invalid for the selected device type

2.3.4 (2026-06-12)

• (ssbingo) fix: correct protocol level detection — use proper register quantities for probes, descend from V2.9 to V2.6, distinguish transport errors from device exceptions to avoid false pre-V2.6 report

2.3.3 (2026-06-11)

• (ssbingo) fix: suppress repeated register read warnings after first occurrence for plant/inverter/acCharger/dcCharger/pss/pid; subsequent failures log at debug level only

2.3.2 (2026-06-10)

• (ssbingo) fix: show 'pre-V2.6' instead of 'unknown' when device responds but has no extended plant registers; add per-probe debug log with Modbus exception message

2.3.1 (2026-06-10)

• (ssbingo) feat: detect Modbus protocol level on startup by probing registers 30088/30200/30228/30286; read firmware version (30525); log result and store as info.protocolLevel state

2.3.0 (2026-06-10)

• (ssbingo) feat: add common.states enum maps for emsWorkMode/runningState/remoteEmsMode/dcCharger.runningState; wire PSS/PID/AC Charger write registers (FC06/FC10) with subscribe and onStateChange handlers

2.2.7 (2026-06-10)

• (ssbingo) fix: add missing native defaults enableSmartLoads/enableCumulativeEnergy/enableGridCode to io-package.json
• (ssbingo) fix: update register 30003 desc with V2.7 EMS modes 5 (FullFeedIn) and 9 (Custom)

2.2.6 (2026-06-10)

• (ssbingo) feat: V2.9 register audit — add missing register 30279 (current control command value), move DC Charger PV registers 31509/31511 to dcCharger namespace, fix ESS Preheating TOU time gain (null→1)
• (ssbingo) feat: implement control write-back for plant.control., plant.gridCode., inverter.control., dcCharger.control. (FC06/FC10); read RW holding registers on startup
• (ssbingo) fix: suppress repeated ESS Preheating warn after device reports unsupported registers; downgrade control register startup read errors to debug

2.2.4 (2026-06-10)

• (ssbingo) fix: implement ESS Preheating TOU polling (FC03, 50000–50183, 94 registers) and write-back via onStateChange; add encodeValue to ModbusConnection

2.2.3 (2026-06-10)

• (ssbingo) fix: add 25 missing admin i18n keys for PSS, PID, ESS Preheating, Extended Registers across all 11 languages

2.2.2 (2026-06-09)

• (ssbingo) docs: update all READMEs to Modbus Protocol V2.9 — add PSS, PID, ESS Preheating, Extended Registers, SigenMicro; correct protocol version reference

2.2.1 (2026-06-09)

• (ssbingo) fix: correct PSS register table to 122 entries per official spec V2.9 (addresses, gains, types); fix PSS write registers to 6 WO entries; fix PID registers 33055-33060 (types, gains, 2 missing entries)

2.2.0 (2026-06-09)

• (ssbingo) feat: PSS (Power Station Switch) and PID (PV Insulation Detection) support; ESS Preheating TOU schedule registers; new admin options for PSS/PID slave IDs

2.1.1 (2026-06-09)

• (ssbingo) fix: wire feature flags (enableSmartLoads, enableCumulativeEnergy, enableGridCode) into polling and object creation; add Extended Registers admin tab

2.1.0 (2026-06-09)

• (ssbingo) feat: extended statistics — plant statistics (30088–30097), smart loads 1–24 (30098–30193), cumulative energy (30194–30271), adjustment feedback (30613–30619), grid code parameters (40049–40068)

2.0.0 (2026-06-09)

• (ssbingo) feat: Modbus Protocol V2.9 — new plant/inverter/DC charger registers, remove deprecated registers, extend enums

License

MIT License

Copyright (c) 2026 ssbingo s.sternitzke@online.de

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.