экопоток

подключается к продуктам Ecoflow

Текущий релиз
1.4.9
Разработчик
foxthefox
Лицензия
MIT

адаптер ecoflow-mqtt для ioBroker

подключается к продуктам Ecoflow ([ https://www.ecoflow.com ])

ПРЕДУПРЕЖДЕНИЕ

Этот адаптер использует неофициальную связь с устройствами. Неправильная связь или установка неверных значений могут повлиять на функциональность устройства и привести к его отключению от сервиса.

Данный адаптер создан на основе работы:

Учетные данные EF

На странице администратора (первая вкладка) необходимо ввести учетные данные MQQT для брокера MQQT.

  • Имя пользователя - что-то вроде "app-...."
  • Идентификатор пользователя — 19-значное число.
  • Пароль пользователя - буквенно-цифровой
  • ClientID — строка, начинающаяся с "ANDROID_...."

Есть 3 варианта:

  1. скрипт https://github.com/mmiller7/ecoflow-withoutflow/blob/main/cloud-mqtt/ecoflow_get_mqtt_login.sh
  2. Источник: https://energychain.github.io/site_ecoflow_mqtt_credentials/
  3. с помощью собственного алгоритма адаптера (нажатие кнопки), для этого необходимы имя пользователя и пароль ecoflow.

Настройки брокера mqqt установлены по умолчанию и обычно не требуют изменения.

!!! В случаях, когда MQTT-сервер отклоняет соединение, может быть полезно проверить вывод этого веб-сайта с помощью варианта №2; в некоторых случаях он вернет другой адрес MQTT-брокера !!!

Настройка и конфигурация устройства

Для добавления оборудования используйте вкладку «Конфигурация устройства(ов)».

Parametrizing the Powerstream or STREAM

  • добавить новую строку
  • Установите deviceID для (Power)Stream так, как показано в приложении, например, "HW51..../BK....".
  • дайте ему имя
  • выберите версию

Parametrizing the Powerstation

  • добавить новую строку
  • Установите идентификатор устройства Powerstation, как показано в приложении; строка может отличаться в зависимости от типа устройства.
  • дайте ему имя
  • выберите тип устройства
  • Если подключен дополнительный аккумуляторный блок, проверьте номер порта, к которому он подключен.

Parametrizing the Smart Plug

  • добавить новую строку
  • Установите идентификатор устройства Smart Plug, как показано в приложении, например, "HW52...".
  • дайте ему имя
  • установить тип на "вилка"

Parametrizing the Smartmeter

  • добавить новую строку
  • Установите идентификатор устройства Smartmeter (Shelly или EF) так, как он отображается в приложении. Если используется Shelly, имейте в виду, что идентификатор отличается от идентификатора самого устройства Shelly.
  • дайте ему имя
  • Установите тип на "Shelly3EM" или "EF smartmeter".

Parametrizing the Generator

  • добавить новую строку
  • Установите идентификатор устройства генератора, как показано в приложении, например, "DGEB...".
  • дайте ему имя
  • Установите тип на "Генератор".

Parametrizing the Smart Home Panel

  • добавить новую строку
  • Установите идентификатор устройства генератора, как показано в приложении, например, "SP10...".
  • дайте ему имя
  • Установите тип "SHP" или "SHP2".

Parametrizing the Power Kit & Hub

  • добавить новую строку
  • Установите идентификатор устройства (deviceID) комплекта питания, как показано в приложении, например, "M10...".
  • дайте ему имя
  • Установите тип на «Power Kit BP2000» или «Power Kit BP5000».
  • Если подключена вторая или третья батарея, отметьте её как slave1 или slave2.

Parametrizing the Power Ocean DC fit

  • добавить новую строку
  • Установите идентификатор устройства генератора, как показано в приложении, например, "HJ31...".
  • дайте ему имя
  • установить тип на "Power Ocean"
  • Если подключена вторая или третья батарея, отметьте её как slave1 или slave2.

Parametrizing the Wave

  • добавить новую строку
  • Установите идентификатор устройства Smart Plug, как показано в приложении, например, "KT21ZCH...".
  • дайте ему имя
  • установить тип на "Wave2"

Parametrizing the Glacier

  • добавить новую строку
  • Установите идентификатор устройства Smart Plug, как показано в приложении, например, "BX11ZCB...".
  • дайте ему имя
  • установить тип "Ледник"

Parametrizing the Alternator

  • добавить новую строку
  • Установите идентификатор устройства Smart Plug, как показано в приложении, например, "F371ZE...".
  • дайте ему имя
  • Установите тип на "Генератор переменного тока 800 Вт".

Для настройки MQTT-соединения с Home Assistant используйте вкладку "Homeassistant".

Parametrizing Homeassistant Connector

  • включить сервис
  • установить пользовательские настройки MQTT-брокера Home Assistant
  • установить параметры подключения MQTT-брокера Home Assistant
  • При необходимости выберите параметры отладки.

Модификация со стороны гиалуроновой кислоты:

  • Адаптер использует функцию обнаружения в Home Assistant, настройка точек данных в Home Assistant не требуется.
  • Дополнение MQTT ...

Обновление адаптера

Обычно достаточно установить следующую версию поверх старой. В некоторых случаях (например, 1.0.0) может потребоваться удалить всё дерево объектов. Если изменяются значения, связанные с точками данных, например, минимальное или максимальное значение диапазона, то необходимо:

  • остановить адаптер
  • удалены соответствующие точки данных
  • Запустите адаптер. После этого будут активированы новые диапазоны.

функции адаптера ioBroker

  • Указанные устройства подключаются к адаптеру через MQTT.
  • Адаптер фильтрует входящие сообщения от устройств. Внутри сохраняются только измененные значения.
  • Если приложение препятствует настройке при определенных условиях, то, как только это станет известно, проблема будет воспроизведена (например, если инвертор включен, когда уровень заряда батареи ниже минимального, вы увидите предупреждение в журнале).
  • Не вся информация известна, поэтому интерпретация статуса может быть неопределенной, что обычно обозначается знаком вопроса в конце.

Примечания к обновлению настроек точек данных (мин., макс., единица измерения и т. д.)

Если в новой версии адаптера изменены параметры точки данных (например, имя, единица измерения, максимальное значение), изменения не вступят в силу до тех пор, пока вы не выполните следующие действия:

  • остановить экземпляр адаптера
  • Удалите соответствующую точку данных или всю структуру объекта экземпляра адаптера.
  • запустить экземпляр адаптера

При запуске системы точки данных создаются, но не изменяются, если они уже существуют.

примечания к предупреждениям/ошибкам

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

Разъем/шлюз высокой доступности

  • Функция обнаружения MQTT в Home Assistant обеспечивает элегантный способ обмена информацией.
  • Функция обнаружения MQTT может быть не активирована, если брокер MQTT уже запущен в режиме высокой доступности; её необходимо включить во время перенастройки службы MQTT.
  • При каждом запуске адаптера iobroker все обнаруженные объекты передаются в HA (даже если они должны сохраняться в HA).
  • Адаптер iobroker фильтрует входящие сообщения от устройств. Внутри системы сохраняются и передаются в Home Assistant только измененные значения.
  • Если значение не задано при обновлении данных устройства, оно будет отображаться как неизвестное в Home Assistant.
  • Если устройство доступно, то его доступность отображается в списке подключенных устройств; эта информация передается "дочерним устройствам" (недоступность обрабатывается аналогичным образом).

некоторые_подсказки_для HA

аннотации к функциональности

  • Из-за синхронности обновления информации и передачи команд иногда могут наблюдаться состояния гонки. Так, например, после подачи команды на переключение можно наблюдать его многократное переключение туда-обратно, прежде чем оно зафиксируется в нужном положении.

Внедренные устройства и структура с указанием точек данных.

некоторое пояснение к данным устройства

  • число -> точка данных с числовым значением
  • уровень -> регулируемая точка данных с числовым значением, иногда также выбираемые значения, имеющие числовое представление.
  • переключатель -> регулируемая точка данных логическое значение
  • диагностический -> логический или многосостоятельный параметр, преобразованный в текст
  • строка -> точка данных только в текстовом формате
  • массив -> точка данных с массивом
  • Для преобразования значения в текст может использоваться непроверенный текст (обратная связь приветствуется), это обозначается знаком "?" в конце текста.

Электростанция

Ривер Макс

Ривер Про

Река 2 Макс

Ривер 2 Про

Река 3

Река 3 Плюс

Дельта Мини

Дельта

Дельта Макс

Дельта 2

Дельта 2 Макс

Дельта 3

Дельта 3 Плюс

Дельта 3 Макс Плюс

Дельта 3 Классик

Дельта Про

Дельта Про 3

Дельта Про Ультра

Панель «Умный дом»

Панель «Умный дом»

Панель «Умный дом» 2

Комплект питания и концентратор

Комплект питания

Power Ocean

Power Ocean DC

Power Ocean Plus

Power Ocean DC FIT

Генератор

Генератор

Двухтопливный генератор недоступен, но может быть реализован при наличии необходимых данных.

Powerstream & Stream

Powerstream

Поток AC

Stream AC PRO

Стрим Ультра

Потоковой инвертор

Также реализована версия на 800 Вт, единственное отличие — максимальная мощность 800 Вт. Приоритет питания: -> 0/false = приоритет питания от сети; -> 1/true = приоритет питания от батареи (зарядка).

Умные розетки

Умная розетка

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

Shelly3EM

Умный счетчик

Кондиционер Wave

Волна2

Волна3

Функция Wave недоступна, но может быть реализована при наличии данных.

Ледниковый холодильник

Ледник

Glacier Classic 55L

Генератор

Генератор

Зарядное устройство

Rapid Pro 320W

Неподдерживаемые устройства

Этот раздел создан для целей отладки. Пожалуйста, выберите устройство (Delta Pro3, Delta3, Delta3 Plus) и введите последовательный порт в добавленную строку. Предполагается, что неизвестное устройство использует протокол PROTOBUF. В логе будут созданы сообщения [PROTOBUF unknown], содержащие необработанную шестнадцатеричную телеграмму.

Список дел

  • Проверить забытые граничные условия для команд (запретить команду или дополнительное значение)
  • Проверьте команду звукового сигнала, если требуется реверсирование.
  • SlaveBattery DM, outWatts multiplication by 10
  • Дополнительные команды getCmds для значений SHP

Отказ от ответственности

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

Changelog

WORK IN PROGRESS

  • (foxthefox) new datapoints Delta2max

1.4.9 (npm)

  • (foxthefox) new device Strem Ultra X
  • (foxthefox) delta 3 plus backupReserveSoc in relation to Discharge Limit + 5%
  • (foxthefox) deltapro3 some max values adapted
  • (foxthefox) powerstream timeData
  • (foxthefox) corrections of max values in Stream series

1.4.8 (npm)

  • (foxthefox) new device Glacier Classic 55L support
  • (foxthefox) new device Delta 3 Max Plus support
  • (foxthefox) new device Stream AC support
  • (foxthefox) new device Rapid Pro 320W support #372
  • (foxthefox) enhancements on wave3
  • (foxthefox) corrections in river3plus for data processing
  • (foxthefox) corrections in D2M for command inv.cfgAcEnabled #340
  • (foxthefox) poweroceanplus set hrPwr/fromPv/romBat/fromGrid values to 0 for non transmitted datapoints in HeatingRodEnergyStreamShow
  • (foxthefox) poweroceanplus pcsActPwr max 20kW, pcsXPhase_amp max 60A
  • (foxthefox) corrections in BMSHeartBeatReport for river3/river3plus
  • (foxthefox) powGetSysLoad for streamAC/ACPro/Ultra set to 10kW, powGetSchuko 2100W
  • (foxthefox) new msg counter for received telegrams from EF-cloud (within 10s)
  • (foxthefox) correction of enBeep (dataLen=2) for Delta3/+/max+/pro
  • (foxthefox) correction of AC1/2/3 switching on SHP2 (issue #312)
  • (foxthefox) Stream AC timetask58x exclude
  • (foxthefox) correction of powerocean / powerocean+ (issue #378), new ENERGY_STREAM_DETAIL and switch for missing datapoint -> value = 0
  • (foxthefox) dev dependencies cleanup
  • (foxthefox) #415 powGetPvSum max=3600, sysGridConnectionPower max = 2500
  • (foxthefox) #422 Backup Reserve Soc as level Delta 3 Plus
  • (foxthefox) #417 Delta Pro 3, remainTime max= 12520, dcdcChgReqCur max = 150, invBusVol/llcBusVol mult=0.1

License

MIT License

Copyright (c) 2023-2026 foxthefox foxthefox@wysiwis.net

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.