go-eCharger

Версии

Адаптер ioBroker для настенных зарядных устройств go-e Charger EV.

Этот адаптер интегрирует одну или несколько настенных зарядных устройств go-e Charger в вашу систему домашней автоматизации ioBroker. Он циклически опрашивает каждое зарядное устройство через его локальный HTTP API, предоставляет все необходимые данные в соответствии с настройками ioBroker и позволяет управлять зарядкой непосредственно из вашей системы умного дома.

Для получения более подробной информации об оборудовании go-e Charger посетите веб-сайт производителя: go-e GmbH .

Функции

• Поддерживает использование нескольких зарядных устройств go-e в рамках одного адаптера.

• мониторинг состояния автомобиля, мощности зарядки, тока зарядки, фаз сети и статистики энергопотребления.

• ChargeNOW – начните зарядку немедленно с настраиваемым током.

• ChargeManager – автоматическая зарядка избытка солнечной энергии: зарядный ток постоянно регулируется в зависимости от доступной солнечной энергии, учитывая потребление электроэнергии в доме и уровень заряда домашней батареи. Зарядку вашего электромобиля можно отложить до тех пор, пока домашняя батарея не достигнет настраиваемого минимального уровня заряда.

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

• Переключение между однофазной и трехфазной зарядкой (оборудование 3-го поколения и новее)

• Статистика энергопотребления по каждой RFID-карте (название карты, идентификатор и уровень заряженной энергии).

• Режим только для чтения для каждого настенного зарядного устройства — мониторинг только зарядного устройства без отправки каких-либо команд управления (без отпускания заряда, без зарядного тока, без переключения фаз), например, когда зарядка контролируется другим устройством или доступ управляется с помощью RFID-меток.

Протестировано с прошивками V033, V040.0, V041.0, V054.7, V054.11, V055.5, V055.7, V055.8, V56.1, V56.2, V56.8, V56.9, V56.11, V57.0, V57.1, V59.4, V60.0, V60.1, V60.2, V60.5, V60.6 и с параллельным подключением до 3 зарядных устройств.

Требования

• Для аппаратных устройств 3-го и 4-го поколений необходимо включить "HTTP API v1" в вашем приложении go-e.
• Для переключения фаз дополнительно необходимо включить "HTTP API v2" в вашем приложении go-e (для оборудования 3-го поколения и новее).

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

Добавьте по одной записи для каждого зарядного устройства go-e в список настенных зарядных устройств и укажите его IP-адрес. При желании присвойте каждому зарядному устройству имя.

Включите режим только для чтения для зарядного устройства, если адаптер должен только считывать данные и никогда не записывать их. В режиме только для чтения адаптер не отправляет никаких команд управления — ни команды разблокировки заряда, ни команды зарядного тока, ни команды переключения фаз. Состояния ChargeNOW и ChargeManager по-прежнему можно переключать, но они не влияют на работу зарядного устройства в режиме только для чтения. Используйте этот режим, если зарядка данного настенного зарядного устройства контролируется другой системой или управляется локально с помощью RFID-меток.

Длительность цикла опроса определяет, как часто адаптер считывает данные с зарядных устройств и регулирует зарядный ток (минимум 3 секунды, по умолчанию 10 секунд).

Ограничения тока для каждого настенного блока

Каждому зарядному устройству можно дополнительно задать минимальный и максимальный зарядный ток [А]. Эти параметры применяются как к ChargeManager (избыток солнечной энергии), так и к ChargeNOW, например, для регулирования мощности одного зарядного устройства или для балансировки нагрузки между несколькими устройствами, подключенными к общей сети.

• Значение0 означает «не установлено»: минимальное значение возвращается к техническому минимуму в 6 А, а максимальное — к максимальному зарядному току, установленному для всей установки, исходя из стандартных настроек.
• Максимальное количество зарядных устройств, устанавливаемое на один блок, позволяет снизить мощность зарядного устройства только ниже установленного предела, но никогда не превысить его.
• Если заданное минимальное значение окажется выше максимального, минимальное значение будет ограничено максимальным, и в журнал будет внесено предупреждение.

Адаптер также считывает текущие значения емкости, сообщаемые каждым зарядным устройством — абсолютный максимальный ток, ограничение тока кабеля и (через API v2) минимальный зарядный ток — и включает их в эффективные ограничения, поэтому зарядное устройство никогда не будет работать за пределами возможностей своего оборудования или подключенного кабеля. Обнаруженные значения емкости публикуются в видеWallbox_X.info.hardwareMaxChargeCurrent иWallbox_X.info.hardwareMinChargeCurrent чтобы помочь вам выбрать разумные значения за коробку.

Зарядка излишков солнечной энергии с помощью ChargeManager

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

Настройте идентификаторы объектов для следующих состояний:

• Доступная в настоящее время солнечная энергия [Вт]
• Текущее потребление электроэнергии в доме [Вт]
• Текущий уровень заряда вашей домашней батареи [%] (требуется только в режимах, учитывающих состояние батареи, см. режим «Домашняя батарея» ниже)

Входные требования

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

Если домашняя батарея не установлена, установите режим домашней батареи в положение «Отключено» (см. ниже). Состояние заряда батареи настраивать не нужно, и ChargeManager заряжает батарею исключительно за счет доступного избытка солнечной энергии. Предыдущий обходной путь с использованием вспомогательного состояния (постоянное состояние, установленное наSettings.Setpoint_HomeBatSoC ) больше не требуется.

Потребление электроэнергии настенным блоком в единицах домашнего потребления

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

Оставьте эту опцию отключенной, если выбранное состояние уже исключает потребление энергии настенным блоком.

Расчет

ChargeManager использует следующий расчет один раз за цикл опроса:

available power =
    solar power
  - home power consumption
  + wallbox power, if it is included in home power consumption
  - grid reserve
  + battery bonus (Battery priority mode only)

target current = floor(available power / 230 V / active phases)

На странице конфигурации ChargeManager шесть параметров позволяют настроить этот расчет:

• Режим работы домашней батареи (по умолчанию — Приоритет батареи ) — как учитывается состояние домашней батареи:
  • Отключено – домашний аккумулятор не используется. Состояние заряда батареи не требуется настраивать, и питание от батареи никогда не подается на автомобиль.
  • Минимальный уровень заряда батареи (SOC) – зарядка электромобиля заблокирована ниже этого значения.Settings.Setpoint_HomeBatSoC Однако батарея никогда не подает питание в автомобиль.
  • Приоритет батареи – как указано выше, плюс бонус за использование батареи, описанный ниже.
• Гистерезис уровня заряда батареи [%] (по умолчанию 0) – насколько уровень заряда может опуститься ниже минимального значения, прежде чем работающий контроллер остановится. Он предотвращает переключение режима разряда батареи на минимальное значение при каждом цикле; для запуска по-прежнему требуется полный минимальный уровень заряда.
• Максимальный срок службы батареи (SoC) [с] (по умолчанию 0 = выключено) – управление избыточным зарядом прекращается, если состояние SoC не обновлялось в течение этого времени, поэтому неработающий вспомогательный модуль не может незаметно поддерживать зарядку автомобиля.
• Резервная мощность сети [Вт] (по умолчанию 100) – мощность, сохраняемая в сети вместо того, чтобы выделяться автомобилю. Увеличьте её для обеспечения большего запаса мощности; установите значение на0 передать весь излишек автомобилю.
• Максимальный бонус батареи [Вт] (по умолчанию 2000) – сколько дополнительной энергии, помимо чисто солнечной, может быть потреблено, пока домашняя батарея находится выше минимального уровня заряда. Бонус составляет0 Когда уровень заряда батареи точно достигает минимального значения, он линейно возрастает до этого максимума по мере приближения к 100%, поэтому более полная батарея позволяет автомобилю заряжаться быстрее. Установите это значение.0 Заряжать аккумулятор исключительно за счет измеренного избытка солнечной энергии, не разряжая домашний аккумулятор в автомобиль.
• Минимальный ток ChargeManager [А] (по умолчанию 6) – избыточный зарядный ток, ниже которого зарядное устройство отключается после небольшой задержки. Это относится только к зарядке избыточного тока от солнечных батарей.

Максимальный зарядный ток [А] (по умолчанию 16, до 32) настраивается на странице стандартных настроек , а не здесь: это ограничение, действующее на всю систему общего электропитания (главный выключатель/защита цепи), а не значение, устанавливаемое в ChargeManager. Оно ограничивает ток, который адаптер когда-либо будет назначать любой настенной зарядной станции, как в ChargeManager (избыток солнечной энергии) , так и в ChargeNOW.

⚠️ Не устанавливайте максимальный зарядный ток выше, чем позволяет ваше зарядное устройство go-e и особенности вашей электропроводки. Модели зарядных устройств go-e рассчитаны на разные максимальные токи (например, 16 А или 32 А), и фактическое ограничение также зависит от вашего кабеля, вилки и проводки. Установка значения выше номинального значения оборудования/установки может привести к срабатыванию защитных устройств или повреждению оборудования. В случае сомнений, оставьте значение по умолчанию — 16 А.

В режимах, учитывающих состояние батареи, зарядка электромобиля отключена (см. ниже).Settings.Setpoint_HomeBatSoC Таким образом, приоритет отдается домашней батарее. Зарядка начинается, как только внутренний целевой ток достигает 10 А (или минимального тока, если он установлен выше). Расчетный ток ограничен заданным максимальным значением, а внутренний целевой ток изменяется не более чем на 1 А за цикл опроса, чтобы уменьшить резкие изменения.

Несколько настенных коробок на одном избыточном солнечном источнике энергии.

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

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

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

Включение ChargeManager

После запуска адаптера используйте указанные ниже состояния записи. Заменить экземпляр.0 и номер настенного ящика0 при необходимости.

Для дополнительной зарядки установитеChargeNOW кfalse иChargeManager кtrue Когда оба параметра включены, ChargeNOW имеет приоритет и использует настроенный режим.ChargeCurrent без учета имеющегося излишка.

Однофазная и трехфазная зарядка

На оборудовании третьего поколения и более новых версий,Charge3Phase выбирает фазовый режим:

• false однофазная зарядка
• true трехфазная зарядка

Поскольку в текущей реализации зарядка начинается, когда внутренний целевой ток превышает 9 А, эффективная начальная точка составляет 10 А. Это требует приблизительно 2,3 кВт в однофазном режиме или 6,9 кВт в трехфазном режиме после корректировки резерва и батареи. Таким образом, однофазный режим обеспечивает более широкий диапазон работы для небольших фотоэлектрических систем или при переменчивой погоде.

Автоматическое переключение фаз

Включите автоматическое переключение между 1- и 3-фазным режимом для каждой настенной розетки (только для устройств 3-го поколения и выше, по умолчанию отключено), чтобы ChargeManager мог выбирать фазовый режим из доступного избытка:

• После насыщения однофазной зарядки (превышения однофазного максимума) она переключается на три фазы , обеспечивая доступ к более высокому трехфазному лимиту.
• Когда избыток тока больше не может поддерживать минимальный трехфазный режим (~4,1 кВт при 6 А), он переключается на однофазный режим , поэтому уменьшающийся избыток тока продолжает заряжать однофазную сеть, вместо того чтобы остановиться.
• Разница между этими пороговыми значениями плюс время задержки предотвращает быстрое переключение туда-обратно, которое каждый раз прерывало бы зарядку.

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

Режимы работы

В режиме только для чтения эти состояния по-прежнему можно изменять, но соответствующая команда управления на зарядное устройство не отправляется.

Проверка и устранение неполадок

Прежде чем полагаться на автоматическую зарядку, проверьте выбранные состояния входных сигналов в представлении объекта ioBroker:

1. Ночью выработка солнечной энергии близка к нулю, а днем она соответствует текущей выработке.
2. Потребление электроэнергии в домашних условиях остается положительным и демонстрирует адекватную реакцию при включении бытовых потребителей.
3. Уровень заряда батареи остается в пределах от 0 до 100.
4. Все значения мощности выражены в Вт, а не в кВт.
5. Параметр «потребление от настенной зарядной станции» определяет, включена ли мощность зарядки в выбранное значение потребления электроэнергии в доме.
6. Wallbox_0.info.connection являетсяtrue .
7. Wallbox_0.Power.Charge ,Wallbox_0.Power.GridPhases и, на поддерживаемом оборудовании,Wallbox_0.Power.EnabledPhases содержат правдоподобные значения.

Для начала зарядки может потребоваться несколько циклов опроса, поскольку внутреннее целевое значение увеличивается всего на 1 А за цикл. При стандартном 10-секундном цикле и начальном целевом значении 0 А достижение стандартного начального значения 10 А может занять приблизительно 100 секунд.

Когда ChargeManager одновременно управляет несколькими настенными зарядными устройствами, избыток солнечной энергии распределяется между ними в порядке следования элементов в списке, поэтому первое устройство имеет приоритет, а последующие получают только оставшийся избыток (см. зарядку избытка солнечной энергии с помощью ChargeManager выше). Адаптер пока не устанавливает суммарный лимит тока для всех зарядных устройств, подключенных к общему предохранителю или линии питания, поэтому убедитесь, что сумма максимальных токов для каждого зарядного устройства остается в пределах мощности вашей установки.

Часовой

Этот адаптер использует библиотеки Sentry для автоматического сообщения разработчикам об исключениях и ошибках в коде. Для получения более подробной информации и сведений о том, как отключить отправку сообщений об ошибках, обратитесь к документации Sentry-Plugin !

Пожертвовать

Если вам понравился этот проект — или вы просто в хорошем настроении — подумайте о том, чтобы угостить меня пивом. За ваше здоровье! :beers:

Changelog

WORK IN PROGRESS

• (typhosj) admin: the wallbox list now explains that its order is the ChargeManager priority - the first entry receives the PV surplus first, later entries only the remainder
• (typhosj) ChargeManager: the PV surplus is now shared between all wallboxes instead of being offered to each one in full; wallboxes are served in configuration order, so the first entry has priority and later ones only receive the remaining surplus
• (typhosj) ChargeManager: a wallbox without a connected vehicle no longer reserves surplus and can no longer starve a wallbox that has a car waiting
• (hombach) ChargeManager: optional automatic 1-/3-phase switching per wallbox (gen 3+, off by default) - switches up when one-phase charging saturates and back down when the surplus can no longer sustain three phases, with a dwell time to prevent flapping
• (hombach) fixed: automatic phase switching no longer overwrites the manual Settings.Charge3Phase request - the automatic decision is now tracked internally, so the user's manual 1-/3-phase setting is preserved (and no longer persisted across restarts as if the user had set it)
• (hombach) docs: clarified the multi-wallbox behaviour (list order = priority) and noted that no combined current limit across wallboxes is enforced yet
• (hombach) updated axios
• (hombach) switch to iobroker testing 6.x
• (hombach) fixed repochecker warnings
• (hombach) added node 26 tests

1.6.1 (2026-09-04)

• (typhosj) fixed: a wallbox whose effective maximum charging current is below 10 A - e.g. an 8 A coded cable or a per-wallbox maximum of 8 A - was rejected as invalid ChargeManager input and never charged from PV surplus. Such a wallbox now starts charging at its own maximum

1.6.0 (2026-08-29)

• (hombach) added optional per-wallbox minimum and maximum charging current, applied to both ChargeManager and ChargeNOW and always kept within the installation-wide maximum
• (hombach) the per-wallbox current limits now also respect the charger's reported hardware caps (absolute max, cable limit, minimum charging current), published as info.hardwareMaxChargeCurrent / info.hardwareMinChargeCurrent
• (typhosj) ChargeManager: added home-battery modes (disabled, minimum SoC, battery priority); installations without a home battery no longer need a constant helper state
• (typhosj) ChargeManager: added a battery SoC hysteresis and an optional maximum SoC age so surplus control stops on stale battery data
• (hombach) admin: moved the maximum charging current to the standard settings tab and clarified that it is an installation-wide limit of the shared power supply, valid for all wallboxes and both charging modes

1.5.0 (2026-08-25)

• (hombach) ChargeManager: grid reserve power and maximum battery bonus are now configurable (defaults 100 W / 2000 W) (#852)
• (hombach) ChargeManager: minimum and maximum surplus charging current are now configurable, with the maximum raised to up to 32 A (#852)
• (hombach) the configurable maximum charging current now caps ChargeNOW as well
• (hombach) admin: moved the ChargeManager settings into their own configuration tab, separate from the standard settings
• (hombach) updated dependencies

1.4.1 (2026-08-23)

• (typhosj) refactored the ChargeManager control decision into a deterministic, unit-tested function (#846); behavior unchanged
• (hombach) fixed vulnerabilities
• (hombach) updated dependencies

1.4.0 (2026-08-10)

• (hombach) added info.unlockedByRFIDName with the name of the current session's RFID card, in parallel to unlockedByRFIDNo (#634)
• (hombach) projectUtils: use extendObject instead of setObject in forceMode so user customizations survive restarts
• (hombach) projectUtils: fixed min/max/step value of 0 being dropped from number state definitions
• (hombach) updated dependencies

License

MIT License

Copyright (c) 2020-2026 C.Hombach go-e-charger@homba.ch

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.