Package detail

homebridge-enphase-envoy

grzegorz91428.7kMIT10.1.0

Homebridge plugin for Photovoltaic Energy System manufactured by Enphase.

homebridge, homebridge-plugin, envoy, enphase

readme

Homebridge Enphase Envoy

About The Plugin

The homebridge-enphase-envoy plugin integrates Enphase Envoy solar energy monitoring systems with Homebridge, allowing HomeKit users to track solar production, consumption, and battery status directly in the Apple Home app. With real-time energy insights, automation possibilities, and Siri voice control, this plugin enhances smart home energy management by seamlessly connecting your Enphase Envoy system to the HomeKit ecosystem.

Requirements

Package	Installation	Role	Required
Homebridge	Homebridge Wiki	HomeKit Bridge	Required
Config UI X	Config UI X Wiki	Homebridge Web User Interface	Recommended
Enphase Envoy	Plug-In Wiki	Homebridge Plug-In	Required

Supported hardware

Firmware v5 through v8
System Envoy S, IQ Gateway, IQ Load Controller, IQ Combiner
Q-Relays Q-RELAY-1P Q-RELAY-3P
AC Batteries AC Battery Storage
Meters Production, Consumption, Storage
Microinverters M215, M250, IQ6, IQ7, IQ8
Encharges IQ Battery 3, IQ Battery 10, IQ Battery 5P, IQ Battery 3T, IQ Battery 10T
Ensemble/Enpower IQ System Controller, IQ System Controller 2
WirelessKit Communications Kit
Generator

Exposed accessories in the Apple Home app

Monitoring Sensors

System Data Refresh
Production State, Power State, Power Level, Energy State, Energy Level, Current, Voltage, Frequency, Power Factor
Consumption Power State, Power Level, Energy State, Energy Level, Current, Voltage, Frequency, Power Factor
Q-Relay State
Enpower Grid State
Encharge: State, Grid State, Backup Level, Dry Contacts
Solar Grid State
Encharge Profile: Self Consumption, Savings, Economy, Full Backup
Grid:
- Mode:
  - Enpower Grid On, Grid Off, Multimode Grid On, Multimode Grid Off, Grid Tied, Grid Forming
  - Encharge Grid On, Grid Off, Multimode Grid On, Multimode Grid Off, Grid Tied, Grid Forming
  - Solar Grid On, Grid Off, Multimode Grid On, Multimode Grid Off, Grid Tied, Grid Forming
- Quality:
  - Production Current (A), Voltage (V), Power Factor (cos Fi), Frequency (Hz)
  - Consumption Total Current (A), Voltage (V), Power Factor (cos Fi), Frequency (Hz),
  - Consumption Net Current (A), Voltage (V), Power Factor (cos Fi), Frequency (Hz),
Generator State, Mode

Control Switches, Outlets, Lightbulbs

System Data Refresh, Lock Control
Production State, Power Mode, Power State, Power Level
AC Battery Energy State, Backup Level Summary, Backup Level
Enpower Grid State, Dry Contacts
Encharge Energy State Summary, Backup Level Summary, Energy State, Backup Level
Encharge Profile
- Self Consumption Activate, Set Reserve
- Savings Activate, Set Reserve
- Economy Activate, Set Reserve
- Full Backup Activate
Generator State, Mode
PLC Level State

Notes

Token authentication (v7.0+) - Tokens can be generated automatically with the Enlighten username (email address) and password or external tools. Tokens generated with Enlighten credentials are automatically refreshed while those generated with external tools are not.
Envoy password is detected automatically or can be added in the configuration if already changed by user.
Installer password is generated automatically (firmware < v7.0+).
Envoy device ID is detected automatically.
Supports Production State Conrol and PLC Level Check (firmware v7.0+ requires installer credentials).
For the best experience and to display all data, please use the Controller or Eve apps.
External integrations include: REST and MQTT.

Configuration

Running this plugin as a Child Bridge is highly recommended. This prevents Homebridge from crashing if the plugin crashes.
Installation and use of Homebridge Config UI X to configure this plugin is highly recommended.
The sample-config.json can be edited and used as an alternative for advanced users.

Key	Subkey	Type	Description
`name`		string	Envoy Enphase Gateway accessory name to be displayed in Home app
`host`		string	The Envoy Enphase Gateway `IP Address` or `Hostname`. If not supplied, defaults to `envoy.local`. For firmware v7.0+, please set the `IP Address`.
`displayType`		number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Light Bulb, `2` - Fan, `3` - Humidity Sensor, `4` - Carbon Monoxide Sensor
`envoyFirmware7xxTokenGenerationMode`		number	How you will obtain the token: `0` - Envoy Password (firmware < v7.0), `1` - Enlighten Credentials, `2` - Your Own Generated Token
`envoyPasswd`		string	Envoy password (only if U already changed the default password)
`enlightenUser`		string	Enlighten username
`enlightenPasswd`		string	Enlighten password
`envoyToken`		string	Token if you selected `2 - Your Own Generated Token` for envoyFirmware7xxTokenGenerationMode
`envoyTokenInstaller`		boolean	Enable if you are using the installer token
`lockControl`		boolean	Enable if you want to use auto lock control
`productionStateSensor`		key	`Production State Sensor` for production state monitoring
	`name`	string	Accessory name for Home app
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`plcLevelControl`		key	`PLC Level Control` for PLC level check (firmware v7.0+ require installer credentials)
	`name`	string	Accessory name for Home app
	`displayType`	number	Accessory type for Home app: `0` - None/Disabled, `1` - Switch, `2` - Outlet, `3` - Lightbulb
	`namePrefix`	boolean	Use accessory name for prefix
`powerProductionSummary`		number	`Power Summary`, in `W`, of all microinverters. This will be used to calculate the display power level in the Home app `0-100 %`
`powerProductionLevelSensors`		key	`Power Level Sensor` for production monitoring
	`name`	string	Accessory name for Home app
	`compareMode`	string	Comparison mode: `<`, `<=`, `==`, `>`, `>=`, `!=`
	`powerLevel`	number	Power production level in `W` to compare to sensor that was triggered
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`energyProductionLifetimeOffset`		number	`Energy Offset` in `Wh` for production (if needed) `+/-`
`energyProductionLevelSensors`		key	`Energy Level Sensor` for production monitoring
	`name`	string	Accessory name for Home app
	`compareMode`	string	Comparison mode: `<`, `<=`, `==`, `>`, `>=`, `!=`
	`energyLevel`	number	Energy production level in `Wh` to compare to sensor that was triggered
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`gridProductionQualitySensors`		key	`Power Level Sensor` for production monitoring
	`name`	string	Accessory name for Home app
	`compareMode`	string	Comparison mode: `<`, `<=`, `==`, `>`, `>=`, `!=`
	`compareType`	string	Comparison type: `Current`, `Voltage`, `Frequency`, `Power Factor`
	`compareLevel`	number	Level to compare to sensor that was triggered
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`powerConsumptionTotalLevelSensors`		key	`Power Level Sensor` for total consumption monitoring
	`name`	string	Accessory name for Home app
	`compareMode`	string	Comparison mode `<`, `<=`, `==`, `>`, `>=`, `!=`
	`powerLevel`	number	Total power consumption level in `W` to compare to power level sensor that was triggered
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`energyConsumptionTotalLifetimeOffset`		number	`Energy Offset` in `Wh` for total consumption (if needed) `+/-`
`energyConsumptionTotalLevelSensors`		key	`Energy Level Sensor` for total consumption monitoring
	`name`	string	Accessory name for Home app
	`compareMode`	string	Comparison mode `<`, `<=`, `==`, `>`, `>=`, `!=`
	`energyLevel`	number	Energy level total in `Wh` to compare to sensor that was triggered
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`gridConsumptionTotalQualitySensors`		key	`Power Level Sensor` for production monitoring
	`name`	string	Accessory name for Home app
	`compareMode`	string	Comparison mode: `<`, `<=`, `==`, `>`, `>=`, `!=`
	`compareType`	string	Comparison type: `Current`, `Voltage`, `Frequency`, `Power Factor`
	`compareLevel`	number	Level to compare to sensor that was triggered
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`powerConsumptionNetLevelSensors`		key	`Power Level Sensor` for net power consumption level monitoring
	`name`	string	Accessory name for Home app
	`compareMode`	string	Comparison mode `<`, `<=`, `==`, `>`, `>=`, `!=`
	`powerLevel`	number	Net power consumption power level in `W` to compare for the sensor that was triggered
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`energyConsumptionNetLifetimeOffset`		number	`Energy Offset` in `Wh` for consumption `Net` (if needed) `+/-`
`energyConsumptionNetLevelSensors`		key	`Energy Level Sensor` for net consumption monitoring
	`name`	string	Accessory name for Home app
	`compareMode`	string	Comparison mode `<`, `<=`, `==`, `>`, `>=`, `!=`
	`energyLevel`	number	Net energy comsumption level in `Wh` to compare to sensor that was triggered
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`gridConsumptionNetQualitySensors`		key	`Power Level Sensor` for production monitoring
	`name`	string	Accessory name for Home app
	`compareMode`	string	Comparison mode: `<`, `<=`, `==`, `>`, `>=`, `!=`
	`compareType`	string	Comparison type: `Current`, `Voltage`, `Frequency`, `Power Factor`
	`compareLevel`	number	Level to compare to sensor that was triggered
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`qRelayStateSensor`		key	`Q-Relay State Sensor` for monitoring. If `State ON`, the contact was opened.
	`name`	string	Accessory name for Home app
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
	`multiphase`	boolean	Enables multiphase support, if present
`acBatterieName`		string	AC Bettery Accessory name for Home app, if not set will use default name
`acBatterieBackupLevelSummaryAccessory`		key	`AC Batteries Backup Level Summary Accessory` in Home app, if present
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Light Bulb, `2` - Fan, `3` - Humidity Sensor, `4` - Carbon Monoxide Sensor, `5` - Battery
	`minSoc`	boolean	Minimum SoC level in (%) for ac batteries backup level summary
`acBatterieBackupLevelAccessory`		key	`AC Battery Backup Level Accessory` in Home app, if present
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Light Bulb, `2` - Fan, `3` - Humidity Sensor, `4` - Carbon Monoxide Sensor, `5` - Battery
	`minSoc`	boolean	Minimum SoC level in (%) for ac battery backup level
`enpowerGridStateControl`		key	`Enpower Grid State Control` for `Grid ON/OFF` control from HomeKit
	`name`	string	Accessory name for Home app
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Switch, `2` - Outlet, `3` - Lightbulb
	`namePrefix`	boolean	Use accessory name for prefix
`enepowerGridStateSensor`		key	`Enpower Grid State Sensor` for monitoring. If `Grid ON`, the contact was opened.
	`name`	string	Accessory name for Home app
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`enpowerGridModeSensors`		key	`Enpower Grid Mode Sensors` for monitoring. If the `Mode` matches, the contact was opened.
	`name`	string	Accessory name for Home app
	`gridMode`	string	Grid mode: `Grid On`, `Grid Off`, `Multimode Grid On`, `Multimode Grid Off`, `Grid Tied`, `Grid Forming`
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`enchargeName`		string	Encharge Accessory name for Home app, if not set will use default name
`enchargeBackupLevelSummaryAccessory`		key	`Encharge Backup Level Summary Accessory` in Home app, if present
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Light Bulb, `2` - Fan, `3` - Humidity Sensor, `4` - Carbon Monoxide Sensor, `5` - Battery
	`minSoc`	boolean	Minimum SoC level in (%) for encharges backup level summary
`enchargeBackupLevelAccessory`		key	`Encharge Backup Level Accessory` in Home app, if present
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, , `1` - Battery
	`minSoc`	boolean	Minimum SoC level in (%) for encharges backup level summary
`enchargeStateSensor`		key	`Encharge State Sensor` for monitoring. If `State ON`, the contact was opened.
	`name`	string	Accessory name for Home app
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`enchargeProfileControls`		key	`Encharge Profile Controls` for `Profile` control from HomeKit
	`name`	string	Accessory name for Home app
	`profile`	string	Profile: `Savings`, `Economy`, `Full Backup`, `Self Consumption`
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Lightbulb
`enchargeProfileSensors`		key	`Encharge Profile Sensors` for monitoring. If the `Profile` matches, the contact was opened.
	`name`	string	Accessory name for Home app
	`profile`	string	Profile: `Savings`, `Economy`, `Full Backup`, `Self Consumption`
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`enechargeGridStateSensor`		key	`Encharge Grid State Sensor` for monitoring. If `Grid ON`, the contact was opened.
	`name`	string	Accessory name for Home app
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`enchargeGridModeSensors`		key	`Encharge Grid Mode Sensors` for monitoring. If the `Mode` matches, the contact was opened.
	`name`	string	Accessory name for Home app
	`gridMode`	string	Grid mode: `Multimode Grid On`, `Multimode Grid Off`
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`enchargeBackupLevelSensors`		key	`Encharge Backup Level Sensors` for monitoring. If the `Level` matches, the contact was opened.
	`name`	string	Accessory name for Home app
	`compareMode`	string	Comparison mode: `<`, `<=`, `==`, `>`, `>=`
	`backupLevel`	number	Backup level in `%` to compare to sensor that was triggered
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`solarGridStateSensor`		key	`Solar Grid State Sensor` for monitoring. If `Grid ON`, the contact was opened.
	`name`	string	Accessory name for Home app
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`solarGridModeSensors`		key	`Solar Grid Mode Sensors` for monitoring. If the `Mode` matches, the contact was opened.
	`name`	string	Accessory name for Home app
	`gridMode`	string	Grid mode: `Grid On`, `Grid Off`, `Multimode Grid On`, `Multimode Grid Off`, `Grid Tied`, `Grid Forming`
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`enpowerDryContactsControl`		boolean	Enables `Dry Contacts` control and exposes `Switches` in Home app
`enpowerDryContactsSensor`		boolean	Enables `Dry Contacts` monitoring and exposes `Sensors` in Home app
`generatorStateControl`		key	`Generator State Control` for `Generator OFF/ON` control in Home app
	`name`	string	Accessory name for Home app
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Switch, `2` - Outlet, `3` - Lightbulb
	`namePrefix`	boolean	Use accessory name for prefix
`generatorStateSensor`		key	`Generator State Sensor` for `State` monitoring. If `State not Off`, the contact was opened.
	`name`	string	Accessory name for Home app
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`generatorModeContol`		key	`Generator Mode Control`, for `Generator OFF/ON/AUTO` control in Home app
	`name`	string	Accessory name for Home app
	`mode`	string	Grid mode: `Off`, `On`, `Auto`
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Switch, `2` - Outlet, `3` - Lightbulb
`generatorModeSensors`		key	`Generator Mode Sensors` for monitoring, if the `Mode` matches, the contact was opened.
	`name`	string	Accessory name for Home app
	`mode`	string	Grid mode: `Off`, `On`, `Auto`
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`acBatterieBackupLevelAccessory`		key	`AC Battery Backup Level Accessory` in Home app, if present
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, , `1` - Battery
	`minSoc`	boolean	Minimum SoC level in (%) for ac battery backup level summary
`dataRefreshControl`		key	`Data Refresh Control` from HomeKit.
	`name`	string	Accessory name for Home app
	`displayType`	number	Here select the tile type to be displayed in Home app: `0` - None/Disabled, `1` - Switch, `2` - Outlet, `3` - Lightbulb
	`namePrefix`	boolean	Use accessory name for prefix
`dataRefreshSensor`		key	`Data Refresh Sensor` for monitoring. If operating, the contact was opened.
	`name`	string	Accessory name for Home app
	`displayType`	number	Accessory type to be displayed in Home app: `0` - None/Disabled, `1` - Motion Sensor, `2` - Occupancy Sensor, `3` - Contact Sensor
	`namePrefix`	boolean	Use accessory name for prefix
`productionDataRefreshTime`		number	`Production Data` refresh time (seconds)
`liveDataRefreshTime`		number	`Live Data` refresh time (seconds)
`ensembleDataRefreshTime`		number	`Ensemble Data` refresh time (seconds)
`disableLogDeviceInfo`		boolean	Disables log device info for every connected device to the network
`disableLogInfo`		boolean	Disables to the Homebridge log console
`disableLogSuccess`		boolean	Disables logging of device success
`disableLogWarn`		boolean	Disables logging of device warnings
`disableLogError`		boolean	Disables logging of device errors
`enableDebugMode`		boolean	Verbose logging to the Homebridge console
`restFul`		key	REST service
	`enable`	boolean	Enables REST service to start automatically and respond to any request
	`port`	number	`Port` for REST service
	`debug`	boolean	Enables verbose logging to the Homebridge console for REST service
`mqtt`		key	MQTT broker
	`enable`	boolean	Enables MQTT broker to start automatically and publish available data
	`host`	string	`IP Address` or `Hostname` for MQTT Broker
	`port`	number	`Port` for MQTT broker (default to 1883)
	`clientId`	string	`Client Id` of MQTT broker (optional)
	`prefix`	string	`Prefix` for `Topic` (optional)
	`auth`	boolean	Enables MQTT broker authorization credentials
	`user`	string	MQTT broker user
	`passwd`	string	MQTT Broker password
	`debug`	boolean	Enables verbose logging to the Homebridge console for the MQTT broker

REST Integration

REST POST calls must include a content-type header of application/json. Path status response all available paths.

Method	URL	Path	Response	Type
GET	`http//ip:port`	`token`, `info`, `home`, `inventory`, `microinvertersstatus`, `meters`, `metersreading`, `metersreports`, `detaileddevicesdata`, `microinvertersdata`, `qrelaysdata`, `metersdata`, `production`, `productionpdm`, `energypdm`, `productionct`,`powerandenergydata`, `acbatterydata`, `ensembleinventory`, `ensemblestatus`, `enchargesettings`, `tariff`, `drycontacts`, `drycontactssettings`, `generator`, `generatorsettings`, `gridprofile`, `livedata`, `productionstate`, `plclevel`, `datasampling`.	`{wNow: 2353}`	JSON

Method	URL	Key	Value	Type	Description
POST	`http//ip:port`	`DataSampling`	`true`, `false`	boolean	Data sampling Start/Stop
	`http//ip:port`	`PowerProductionState`	`true`, `false`	boolean	Production state On/Off
	`http//ip:port`	`PlcLevel`	`true`	boolean	Check Plc Level On
	`http//ip:port`	`EnchargeProfile`	`self-consumption`, `savings`, `economy`, `fullbackup`	string	Set encharge profile
	`http//ip:port`	`EnpowerGridState`	`true`, `false`	boolean	Grid state On/Off
	`http//ip:port`	`GeneratorMode`	`off`, `on`, `auto`	string	Generator mode Off/On/Auto

MQTT Integration

Subscribe using JSON { "EnchargeProfile": "savings" }

Method	Topic	Message	Type
Publish	`Token`, `Info`, `Home`, `Inventory`, `Microinverters Status`, `Meters`, `Meters Reading`, `Meters Reports`, `Detailed Devices Data`, `Microinverters Data`, `Q-Relays Data`, `Meters Data`, `Production`, `Production Pdm`, `Energy Pdm`, `Production CT`, `Power And Energy Data`, `AC Battery Data`, `Ensemble Inventory`, `Ensemble Status`, `Encharge Settings`, `Tariff`, `Dry Contacts`, `Dry Contacts Settings`, `Generator`, `Generator Settings`, `Grid Profile`, `Live Data`, `Production State`, `PLC Level`, `Data Sampling`	`{wNow: 2353}`	JSON

Method	Topic	Key	Value	Type	Description
Subscribe	`Set`	`DataSampling`	`true`, `false`	boolean	Data sampling Start/Stop
	`Set`	`ProductionState`	`true`, `false`	boolean	Production state On/Off
	`Set`	`PlcLevel`	`true`	boolean	Check Plc Level On
	`Set`	`EnchargeProfile`	`self-consumption`, `savings`, `economy`, `fullbackup`	string	Set encharge profile
	`Set`	`EnpowerGridState`	`true`, `false`	boolean	Grid state On/Off
	`Set`	`GeneratorMode`	`off`, `on`, `auto`	string	Generator mode Off/On/Auto

changelog

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Note!!!

after update to v10.0.0 and above the accessory and bridge need to be removed from the homebridge / Home.app and added again

[10.1.0] - (01.07.2025)

Changes

fix update plc level for microinverters
added lockcontrol system for envoy section

[10.0.3] - (29.06.2025)

Changes

fix scale plc level to 100%

[10.0.2] - (29.06.2025)

Changes

fix generator mode
changed RESTFul path powermode to productionstate
changed MQTT set key PowerProductionState to ProductionState
stability and performance improvements
redme updated
cleanup

[10.0.1] - (25.06.2025)

Changes

fix RESTFul detaileddevicesdata and token paths
fix Mqtt token refresh
redme updated

[10.0.0] - (24.06.2025)

Changes

full code refactor
stability and performance improvements
added many detailed data for microinverters, meters, qrelays
RESTFul code refactor and updated
cleanup custom characteristics
cleanup
readme updated
many more small changes

[9.20.1] - (15.06.2025)

Changes

fix #202
cleanup

[9.20.0] - (14.06.2025)

Changes

stability and performance improvements
added devicesdata, metersRportsto to the RESTFul rquests
added Energy and Productin Consumption Total service if present
added energyLifetimeUpload characteristic for Production(mean self consumption) and Consumption Net(mean upload to the grid)
added node.js 24 support
bump dependencies
redme updated
cleanup

[9.19.0] - (04.06.2025)

Changes

added microinverters additional data (voltage, frequency, temperature, energy today, yesterday, last seven days, lifetime)
redme updated
cleanup

[9.18.0] - (30.05.2025)

Changes

removed extra production control accessory
added production control in the main lightbulb accessory
added control lock accessory to prevent device control accidentially
- device control possible after unlock
- locked automatically 30sec after unlock
config UI updated
redme updated
cleanup

[9.17.7] - (28.05.2025)

Changes

stability and performance improvements
cleanup

[9.17.5] - (27.05.2025)

Changes

prevent update meters characteristics if value are not valid

[9.17.4] - (27.05.2025)

Changes

fix voltage divide
cleanup

[9.17.3] - (27.05.2025)

Changes

fix power peak update characteristics
cleanup

[9.17.2] - (26.05.2025)

Changes

cleanup

[9.17.1] - (26.05.2025)

Changes

fix #199

[9.17.0] - (26.05.2025)

Changes

removed duplicated power and energy state sensors, the state sensor can be create by level sensors > 0
removed meters refresh time
fix consumption power peak detected
refactor production all code
refsctor charcteristics update
added conparator (!==) to sensors
config UI improvements
mqtt clientId and prefix updated
redme update
cleanup

[9.16.0] - (21.05.2025)

Changes

added grid quality sensors for(Current, Voltage, Frequency, Power Factor) if meters are installed
fix qRelay state update
redme update
cleanup

[9.15.0] - (18.05.2025)

Changes

fix #198
refactor code of production and consumption data update (support fw. >= 8.2.4xx)
bump dependencies
redme update
cleanup

[9.14.6] - (12.05.2025)

Changes

fix #197
bump dependencies

[9.14.4] - (09.05.2025)

Changes

fix read meters reading with envoy firmware 8.3.xx
better handle some errors/warn
bump dependencies
cleanup

[9.14.3] - (20.04.2025)

Changes

fix #195
fix #196
cleanup

[9.14.2] - (20.04.2025)

Changes

many cleanup and optimizations
cleanup

[9.14.1] - (18.04.2025)

Changes

fix namePrefix and call production state even not supported

[9.14.0] - (18.04.2025)

Changes

added multiphase support for q-relay sensor
digestauth refactor
passwdcalc refactor
envoytoken refactor
redme update
cleanup

[9.13.4] - (18.04.2025)

Changes

fix power peak level display and detected in consumption total and net
cleanup

[9.13.3] - (18.04.2025)

Changes

fix reference error in debug mode
cleanup

[9.13.2] - (17.04.2025)

Changes

fix microinverters publish in v9.13.0 and v9.13.1
refresh grid profile and update status in runtime
display in envoy db size and percent full of db only if supported
display update status in envoy only if supported
stability and performance optimizations
cleanup

[9.13.1] - (16.04.2025)

Changes

RESTFul and MQTT update
stability and performance optimizations
redme update
cleanup

[9.13.0] - (15.04.2025)

Changes

added pdm energy and production data to RESTFul and MQTT for Envoy FW >= 8.2.4xx
removed production all from RESTFul and MQTT
redme update
cleanup

[9.12.6] - (08.04.2025)

Changes

fix stop data sampling if error occured durig cookie refresh
fix set correct accessory category
added production state data refresh timer
config UI improvements in section Envoy
config schema updated
redme update
cleanup

[9.12.0] - (05.04.2025)

Changes

after update the plc level refresh control need to be configued again
after update the production state control and sensor need to be configued again
added production state sensor
config UI improvements in section Envoy
config schema updated
bump dependencies
redme update
cleanup

[9.11.0] - (03.04.2025)

Changes

after update the credentials method need to be configued again
after update the dry contact sensor and control need to be configued again
config UI improvements
config schema updated
bump dependencies
redme update
cleanup

[9.10.9] - (30.03.2025)

Changes

fix energyConsumptionNetStateSensor UI
config schema updated

[9.10.8] - (28.03.2025)

Changes

stability and performance improvements
config schema updated
cleanup

[9.10.7] - (26.03.2025)

Changes

fix #192

[9.10.6] - (26.03.2025)

Changes

fix Q-Relay state monitoring sensor

[9.10.5] - (25.03.2025)

Changes

added Q-Relay state monitoring sensor
stability and performance improvements
config schema updated
redme updated
cleanup

[9.10.0] - (23.03.2025)

Changes

added possibility to select accessory type for Envoy
added possibility to select accessory type for AC Battery, indyvidual and summary
added possibility to select accessory type for Encharge, indyvidual and summary
added possibility to set min SoC for light bulb Encharge accessory #191
stability and performance improvements
config schema updated
redme updated
cleanup

[9.9.10] - (21.03.2025)

Changes

fix #190
cleanup

[9.9.9] - (21.03.2025)

Changes

fix #189
cleanup

[9.9.8] - (20.03.2025)

Changes

config UI improvements from #185
config schema updated

[9.9.7] - (20.03.2025)

Changes

added possibility to set custom encharge name displayed in the home app, closes #188
added possibility to disable/display encharge light bulb accessory in the home app
bump dependencies
config schema updated
redme updated
cleanup

[9.9.4] - (19.03.2025)

Changes

fix backup level sensor update #186
config UI improvements #185
config schema updated
cleanup

[9.9.3] - (18.03.2025)

Changes

added default values to fix #183
cleanup

[9.9.2] - (15.03.2025)

Changes

fix #182
cleanup

[9.9.1] - (15.03.2025)

Changes

fix #181
cleanup

[9.9.0] - (14.03.2025)

Changes

added possibility to disable indyvidual accessory
added read production all (pcm, rgm, eim) and consumption (eim)
fix debug log
bump dependencies
config schema updated
redme updated
cleanup

[9.8.7] - (04.03.2025)

Changes

token handling improvements
digest installer and envoy handling improvements
error handling improvements
cleanup

[9.8.6] - (02.03.2025)

Changes

token and cookie handling improvements
impulse generator corect start state
cleanup

[9.8.5] - (28.02.2025)

Changes

token and digest authorization handling improvements
bump dependencies
cleanup

[9.8.4] - (27.02.2025)

Changes

token handling improvements
plugin start time improvements
cleanup

[9.8.3] - (26.02.2025)

Changes

bump dependencies

[9.8.2] - (26.02.2025)

Changes

refactor start external integrations
bump dependencies
cleanup

[9.8.0] - (20.02.2025)

Changes

fix enpower grid state error
added encharge grid state sensor
added solar grid state sensor
bump dependencies
cleanup

[9.7.6] - (18.02.2025)

Changes

stability and improvements
chore(config): tweak wording, thanks @nstuyvesant
Updates to the read me (spelling, punctuation, clarification), thanks @nstuyvesant
bump dependencies
cleanup

[9.7.5] - (15.02.2025)

Changes

moved custom characteristics and services to seperate file
added new opt_cheduless properties to storage setting
stability and improvements
cleanup

[9.7.4] - (07.02.2025)

Changes

stability and improvements

[9.7.3] - (04.02.2025)

Changes

update RESTFul

[9.7.0] - (16.01.2025)

Changes

added possibility to disable/enable log success, info, warn, error
config schema updated
redme updated
cleanup

[9.6.12] - (03.01.2025)

Changes

limit microinverters count to 70 due #175
fix powerLevel characteristics warning
fix display only active phase in live data

[9.6.10] - (18.12.2024)

Changes

update encharges led status
fix apparent power in live data
cleanup

[9.6.9] - (17.12.2024)

Changes

fix livedData characteristics warning #173
cleanup

[9.6.8] - (16.12.2024)

Changes

increase data refresh time issue #172
bump dependencies
cleanup

[9.6.6] - (06.12.2024)

Changes

better handle of error and cookies
bump dependencies
config.schema updated
cleanup

[9.6.5] - (03.12.2024)

Changes

check JWT toke is installer or user
add JWT Token installer option if use own generated token
config.schema updated
redme updated
cleanup

[9.6.4] - (02.12.2024)

Changes

prevent crasch if PLC Level is enabled and credentials data is not installer

[9.6.3] - (02.12.2024)

Changes

prevent crasch if production control is enabled and credentials data is not installer

[9.6.0] - (30.11.2024)

Changes

move from commonJS to esm module
moved constants.json to constants.js
cleanup

[9.5.3] - (28.11.2024)

Changes

better handle cookie and own token
config schema updated
cleanup

[9.5.2] - (28.11.2024)

Changes

fix display duplicate credentials in UI
better handle cookie and token
bump dependencies
config schema updated
cleanup

[9.5.1] - (20.11.2024)

Changes

fix reference error before initialization

[9.5.0] - (19.11.2024)

Changes

added possibility to select compare mode for power and energy level sensors
config schema updated
readme updated
cleanup

[9.4.4] - (18.11.2024)

Changes

fix data refresh after error occured
fix validate own token

[9.4.3] - (17.11.2024)

Changes

fix #163
added node 23 support
jwt token get and check refactor
correct some logs wording
cleanup

[9.4.2] - (11.11.2024)

Changes

fix reconnect if error ocurred during start
correct some logs wording
config.schema updated
cleanup

[9.4.1] - (30.10.2024)

Changes

fix stop data updating after error occured #161
added config schema validation
update dependencies
config.schema updated
cleanup

[9.4.0] - (17.09.2024)

Changes

added encharge profile sensors
fix battery/encharge state and backup level delay
fix grid state sensor
move some message to warn
use async/await for impulse generator
update dependencies
cleanup

[9.3.5] - (31.08.2024)

Changes

required upcomming homebridge 2.x.x required
fix #153
error handle improvements
increase axios timeout to 25sec
cleanup

[9.3.4] - (27.08.2024)

Changes

fix restFul data sampling response
fix duplicate start run afer error occur
fix characteristic Rest Power warning
increase axios timeout to 20sec
cleanup

[9.3.3] - (23.08.2024)

Changes

fix #151

[9.3.0] - (23.08.2024)

Changes

add control over RESTFul POST JSON Object
fix RESRFul enable
add timeout to axios
return axios error message instead of object if exist

[9.2.9] - (21.08.2024)

Changes

fix energy level sensors
refactor backbone app code to get envoy dev id
refactor envoy password calculate code
refactor installer password calculate code
add some warn message and allow app working without some not mandatory data

[9.2.8] - (20.08.2024)

Changes

fix encharge live data display
fix data refresh control
fix backup level sensors
cleanup

[9.2.6] - (19.08.2024)

Changes

fix #149

[9.2.5] - (19.08.2024)

Changes

fix correct display error instead empty object
move some error to warn and prevent to reconnect to envoy

[9.2.4] - (19.08.2024)

Changes

fix #150
fix voltage divide
correct some error logs
cleanup

[9.2.3] - (18.08.2024)

Changes

use warn instead error for not required data
cleanup

[9.2.2] - (18.08.2024)

Changes

fix #149
loging refactor
corect catch error
cleanup

[9.2.0] - (16.08.2024)

Changes

add generator mode Off/On/Auto control from home app as a extra tiles
arf profile refactor
cleanup

[9.1.3] - (16.08.2024)

Changes

decrease homebridge requirements to 1.8.0

[9.1.2] - (16.08.2024)

Changes

dynamically display arf profile only if supported

[9.1.1] - (16.08.2024)

Changes

fix PLC Level warning #148

[9.1.0] - (16.08.2024)

Changes

added enchrge profile cintrol over mqtt
added enpower state control over mqtt
added generator mode control over mqtt
cleanup

[9.0.2] - (14.08.2024)

Changes

fix threw new error characteristics

[9.0.1] - (14.08.2024)

Changes

fix corect remove sensitive data from config mqtt
remove sensitive data from debug log
hide passwords, tokens, serial numbers, by typing and display in Config UI
remove return duplicate promises from whole code

[9.0.0] - (14.08.2024)

Changes

After update to v9.0.0 RESTFull and MQTT config settings need to be updated

support for Homebridge v2.0.0
full code refactor
RESTFul and MQTT config refactor
renamed config properties, supportProductionPowerMode to supportPowerProductionState
renamed config properties, powerProductionControl to powerProductionStateControl
system data refresh
- added native control from home app as a extra tile
- added control direct from envoy section, 3rd party app
- added state sensor
plc level refresh:
- added native control from home app as a extra tile
power production:
- added native control from home app as a extra tile
generator:
- added state native control from home app as a extra tile
- added state direct control from envoy section, 3rd party app
- added state sensor
- added mode sensors
enpower:
- added grid state native control from home app as a extra tile
- added grid state control direct from envoy section, 3rd party appp
- added grid state sensor
- added dry contacts native control from home app as a extra tile
- added dry contacts state sensors
encharge:
- added state sensor
- added profile native control from home app as a extra tile
other changes
- added possibility to enable accessory name as a prefix for all services
- stability and performance improvements
- dependencies updated
- config schema updated
- bug fixes
- cleanup

[8.1.1] - (04.08.2024)

Changes

fix display and publish ensemble status and sensors

[8.1.0] - (04.08.2024)

Changes

added new ensemble/encharge/solar sensor profile, grid-tied and grid-forming
config schema updated
redme updated
cleanup

[8.0.2] - (04.08.2024)

Changes

fix #142.
fix characteristic name for encharge profile
add missing optional characteristic for enphaseWirelessConnectionKitService
redme updated
cleanup

[8.0.0] - (07.07.2024)

Changes

After update to v8.0.0 and above from plevious version all sennsors need to be activated in plugin config again

added possibility to set indyvidual characteristic type for sensors, 0 - None/Disabled, 1 - Motion Sensor, 2 - Occupancy Sensor, 3 - Contact Sensor.
config schema updated
redme updated
cleanup

[7.16.0] - (23.06.2024)

Changes

added possibility to use Your own generated Token #140
config schema updated
redme updated
cleanup

[7.15.4] - (18.06.2024)

Changes

bump node modules ws #139

[7.15.3] - (18.06.2024)

Changes

polling code refactor, added impulse generator
remove production properties from Q-Relay accessory
cleanup

[7.15.2] - (09.06.2024)

Changes

remove possibility to enable/disable support for live data and ensemble status, now is check automatically
moved refresh ensemble status refres time to envoy section
config schema updated
cleanup

[7.15.1] - (08.06.2024)

Changes

added compare mode to the encharge backup level sensors
config schema updated

[7.15.0] - (08.06.2024)

Changes

added encharge backup level sensors
readme updated
config schema updated
cleanup

[7.14.9] - (08.06.2024)

Changes

refactor check JWT token
refactor check arf profile
correct some logs
cleanup

[7.14.8] - (01.06.2024)

Changes

fix 401 error after envoy reboot and refresh cocies
fix characteristics warning for arf profile
increase time for check token expired = bump dependencies
cleanup

[7.14.5] - (12.05.2024)

Changes

refactor token check and request
added infot about token time expired
cleanup

[7.14.4] - (06.05.2024)

Changes

stop data polling if token expired, start after refreshed
fixed power peak handle
refactor code in passwords calculation and check jwt token

[7.14.0] - (27.04.2024)

Changes

added support to check and control Production Power Mode, firmware 7.x.x required installer credentials data
added support to check PLC Level, firmware 7.x.x required installer credentials data
added support to check and control Production Power Mode over MQTT protocol, firmware 7.x.x required installer credentials data
added support to check PLC Level over MQTT protocol, firmware 7.x.x required installer credentials data
config.schema updated
cleanup

[7.13.0] - (27.04.2024)

Changes

After update to v7.13.0 and above from plevious version the refresh time need to be configured again

changed data refresh time from (ms) go (sec) and precision 0.5
prevent to set refresh time to 0, now minimum is 0.5 sec
config.schema updated
cleanup

[7.11.14] - (26.02.2024)

Changes

fix #127
fix #126
fix #125
cleanup

[7.11.0] - (11.02.2024)

Changes

After update to v7.11.0 and above from plevious version the grid mode sensors need to be configured again

added support to create multiple enpower/encharge/solar grid mode sensors and select grid mode to match
config.schema updated
cleanup

[7.10.0] - (10.02.2024)

Changes

added support for Envoy Firmware 8.x.x
added support for storage CT meters
fixed #114
config.schema updated
cleanup

[7.9.0] - (01.01.2024)

Changes

added #118
added state and level lightbulb for ac bateries and encharges
config.schema updated
cleanup

[7.8.0] - (23.12.2023)

Changes

After update to v7.8.0 and above from plevious version the sensors need to be configured again

added #117
added possibility to set custom name for sensors
added possibility to activate/deactivate sensors
added possibility to create multiple sensors for power and energy level
config.schema updated
cleanup

[7.7.5] - (05.12.2023)

Changes

fix missing aasync/wait for microinverters data update
refactor code in section data update
fix characteristic warning #115
better handle to fix #112
config.schema updated
cleanup

[7.7.4] - (02.12.2023)

Changes

fix #112
cleanup

[7.7.3] - (29.11.2023)

Changes

fix #112
cleanup

[7.7.2] - (26.11.2023)

Changes

added debug log for services prepare
prepare for generators support
cleanup

[7.7.1] - (26.11.2023)

Changes

dynamically add Live Data characteristics based on installed devices
cleanup

[7.7.0] - (26.11.2023)

Changes

added Live Data PV cheracteristics to the HomeKit
added Live Data Storage cheracteristics to the HomeKit
added Live Data Grid cheracteristics to the HomeKit
added Live Data Load cheracteristics to the HomeKit
added Live Data Generator cheracteristics to the HomeKit
fix #85
config schema updated
cleanup

[7.5.0] - (20.10.2023)

Changes

After update to v7.5.0 and above from plevious version the sensors need to be configured again

added Power State contact sensor (Consumption Total) for automations and notifications in HomeKit
added Energy State contact sensor (Consumption Total) for automations and notifications in HomeKit
added Energy Level contact sensor (Consumption Total) for automations and notifications in HomeKit
added Power State contact sensor (Consumption Net) for automations and notifications in HomeKit
added Energy State contact sensor (Consumption Net) for automations and notifications in HomeKit
added Energy Level contact sensor (Consumption Net) for automations and notifications in HomeKit
added Enpower Grid State contact sensor for automations and notifications in HomeKit
added Encharge Grid State contact sensor for automations and notifications in HomeKit
added Solar Grid State contact sensor for automations and notifications in HomeKit
bump node to min 18.x.x and homebridge to 1.6
config schema updated
redme update
cleanup

[7.4.0] - (25.07.2023)

Changes

added Energy State contact sensor for production monitoring, which can be used for notification and automations in HomeKit.
added Energy Level contact sensor for production monitoring, which can be used for notification and automations in HomeKit.
config schema updated
cleanup

[7.3.0] - (20.07.2023)

Changes

added Power Production On/Off contact sensor for production monitoring, which can be used for notification and automations in HomeKit.
Use encodeURIComponent in EnvoyToken URLs - thanks @chrisjshull
config schema updated
cleanup

[7.2.0] - (17.07.2023)

Changes

added power production level (0-100%) displayed as brightness level in Home app based on all microinvertzers power configured in plugin config
config schema updated

[7.1.0] - (16.07.2023)

Changes

added accessory switch to display in Home app curren state of power production, if Production Power > 0 then switch is ON
config schema updated

[7.0.0] - (14.07.2023)

After Update to this version need to make corespondent changes in plugin config

Changes

added support to get JWT Token automatically from enlighten server using user credentials data
added support to check expired JWT Token and get new if expired
added debug for RESTFul server
added token to the RESTFul server request
added Token to the MQTT publisher
config schema updated
cleanup

Removed properties

envoyFirmware7xxToken

Added properties

enlightenUser
enlightenPasswd
envoySerialNumber

[6.7.0] - (27.02.2023)

Changes

added powerful RESTFul server to use with own automations
cleanup
config.schema updated

[6.6.0] - (26.02.2023)

Changes

added for ensemble summary Rest Power
added for ensemble summary AGG Max Energy
added for ensemble summary Encharges AGG SoC
added for ensemble summary Encharges AGG Rated Power
added for ensemble summary bias frequency, voltage for phasa L2/B and L3/C
prevent HB crash if for some reason prepare accessory fail
properties updated/added
bump dependencies
cleanup

[6.5.0] - (17.01.2023)

Changes

added possibility to set refresh time for live dta, meters data and production ct

[6.4.1] - (16.01.2023)

Changes

fix wirreles konnections kit crash

[6.4.0] - (15.01.2023)

Changes

code cleanup
config schema updated
stability improvements
reduce memory and cpu ussage
added Power Peak contact sensors for production, consumption total/net which can be used for notification and automations in HomeKit.
fix display wirelesskit characteristics hovewer is not instlled
fix #73

[6.3.2] - (14.01.2023)

Changes

fix #71
fix #72
fix read grid profile name
added new properties to ensemble status data
added profile data to mqtt

[6.3.1] - (12.01.2023)

Changes

code cleanup
stability and performance improvement

[6.3.0] - (10.01.2023)

Changes

added possibility enable/disable support to check Laive Data
Envoy cpu load reduction
code cleanup
performance improvement

[6.2.0] - (10.01.2023)

Changes

added possibility enable/disable support to check Ensemble Status
code cleanup/refactor
config schema updated

[6.1.0] - (09.01.2023)

Changes

fix #70
added possibility enable/disable support to check PLC Level
added possibility enable/disable support to check/control production Power Mode
code cleanup

[6.0.9] - (09.01.2023)

Changes

fix #69
added missing promise
code cleanup
some log corrections

[6.0.8] - (05.01.2023)

Changes

code cleanup
log units and text corrections
added auto check plc communication level on startup
added encharges plc level characteristic

[6.0.7] - (30.12.2022)

Changes

fixed wireless connection kit set to true

[6.0.6] - (30.12.2022)

Changes

fixed wireless connection kit characteristics

[6.0.5] - (29.12.2022)

Changes

fixed ensembles, encharges and enpowers read data #66
publish live data to MQTT if Envoy firmware >= 7.x.x
bump dependencies

[6.0.4] - (14.12.2022)

Changes

code optimize

[6.0.3] - (14.12.2022)

Changes

fix axios instance with token

[6.0.2] - (14.12.2022)

Changes

digestAuth code refactor
code cleanup

[6.0.1] - (13.12.2022)

Changes

fixed JWT authorization proces and store cookies for data request
code optimization
big thanks @NoSnow3 and @BenouGui for test

[6.0.0] - (11.12.2022)

Changes

added support for Envoy with firmware 7.x.x and Token Authorization
config schema updated
big thanks @NoSnow3 for test

[5.9.7] - (06.12.2022)

Changes

bump dependencies

[5.9.6] - (15.09.2022)

Changes

fix refresh inventory data
bump dependencies

[5.9.4] - (10.09.2022)

Changes

cleanup
fix mqtt
bump dependencies

[5.9.3] - (29.08.2022)

Changes

cleanup
update mqtt topics

[5.9.2] - (26.08.2022)

Changes

cleanup

[5.9.1] - (26.08.2022)

Changes

convert password generator to iuse promises async/await
cleanup

[5.9.0] - (25.08.2022)

Changes

added installer password generator, no need generate it manually in external generator
config schema updated

[5.8.4] - (25.08.2022)

Changes

rebuild refresh data process
config schema updated
cosmetics changes

[5.8.3] - (23.08.2022)

Changes

fix #55

[5.8.2] - (21.08.2022)

Changes

code cleanup
better fix Power characteristic warning negative value #54

[5.8.1] - (13.08.2022)

Changes

fix Power characteristic warning negative value #54

[5.8.0] - (12.08.2022)

Changes

added possibility automatically 'Power peak reset' every day, week, month
config schema updated

[5.7.8] - (08.08.2022)

Changes

fix #53

[5.7.7] - (08.08.2022)

Changes

fix production Power peak detected state
rebuild log

[5.7.6] - (07.08.2022)

Changes

fix auto/manual consumptions 'Power peak reset and save'
log updated
properties in code updated

[5.7.3] - (07.08.2022)

Changes

fix auto 'Power peak reset' at midnight

[5.7.2] - (06.08.2022)

Changes

fix characteristic 'Power peak reset' warning

[5.7.1] - (06.08.2022)

Changes

fix update button state characteristics for power peak reset

[5.7.0] - (06.08.2022)

Changes

added possibility to manuall reset Power peak (in accessory using button)
added possibility to automatically reset Power peak at midnight (in plugin setting configurable)
updated config schema

[5.6.22] - (06.08.2022)

Changes

rename Power Max to Power Peak
added extra refresh data for production (microinverters)

[5.6.21] - (03.08.2022)

Changes

fix #52

[5.6.20] - (03.08.2022)

Changes

added possibility to disable display device info in log after plugin restart
check required properties to create accessory
correct some logs typos

[5.6.15] - (02.08.2022)

Changes

fix refresh power and energy production data if no meters are installed

[5.6.14] - (02.08.2022)

Changes

fix display undefinded Power and Energy type if no meters are installed

[5.6.13] - (23.07.2022)

Changes

refactor information service

[5.6.12] - (11.05.2022)

Changes

fix #50

[5.6.9] - (25.04.2022)

Changes

update dependencies

[5.6.8] - (25.04.2022)

Changes

refactor send mqtt message

[5.6.7] - (24.04.2022)

Changes

update config.schema.json

[5.6.6] - (30.03.2022)

Changes

prevent poll Meters Reading Data if no Meters are installed
prevent poll Microinverters Power Data if envoy password is not set

[5.6.5] - (30.03.2022)

Changes

refresh time for Meters Reading Data to 1,5sec and Production CT Data to 3 sec.

[5.6.4] - (29.03.2022)

Changes

fixed read microinverters data (error 401) if envoy uses standard password, fix #48

[5.6.3] - (29.03.2022)

Added

debug mode for MQTT Client -

Changes

update check state data
update debug logging
removed refresh interval
update config schema
removed Entrez Authorization functionality for Envoy with firmware 7.x.x at this time

[5.6.1] - (20.02.2022)

Added

wrire envoy device id to file

[5.6.0] - (19.02.2022)

Added

Entrez Authorization for Envoy with firmware 7.x.x (test phase)

[5.5.0] - (17.02.2022)

Added

MQTT Client, publish all PV installation data
Debug mode
Prepare for entrez authorization

Changes

update dependencies
code refactor

[5.4.34] - (18.01.2022)

Changes

update dependencies

[5.4.33] - (17.01.2022)

Changes

update dependencies

[5.4.32] - (29.12.2021)

prepare directory and files synchronously

[5.4.30] - (28.12.2021)

update node minimum requirements

[5.4.29] - (20.11.2021)

Changes

cosmetics

[5.4.21] - (25.09.2021)

Changes

code cleanup

[5.4.19] - (24.09.2021)

Changes

WARNING - after this update nedd to remove and add accessory to the HomeKit again

code cleanup
stability improvements

[5.4.18] - (24.09.2021)

Changes

code cleanup
fix wrong voltage display, 1-phase instalation

[5.4.17] - (19.09.2021)

Changes

code cleanup

[5.4.15] - (09.09.2021)

Changes

bump dependencies
stability improvements
performance improvements

[5.4.14] - (05.09.2021)

Changes

bump dependencies

[5.4.13] - (04.09.2021)

Changes

bump dependencies

[5.4.1] - (22.08.2021)

Changes

removed envoyDevId property, now is detect automatically

[5.4.0] - (21.08.2021)

Changes

removed urllib
added digestAuth method to Axios
code rebuild and cleanup
some fixes and improvements

[5.3.1] - (21.08.2021)

Changes

charcterristics data format fixes
added grid profile characteristic for ensemble
code rebuild and cleanup

[5.3.0] - (17.08.2021)

Changes

added wireless connection kit characteristics
code rebuild and cleanup

[5.2.15] - (16.08.2021)

Changes

finally fixed not reconized ensemble (enpower and encharges) devices in previous versions

[5.2.0] - (15.08.2021)

Changes

added possibility Enable/Disable Power Production (in envoy section)

[5.1.0] - (13.08.2021)

Changes

added system Power Production state(in envoy section)
added enpower status service
fixed not reconized ensemble (enpower and encharges) devices in previous versions
updated SKU and Part Nr.
code rebuild and cleanup
other fixes and improvements

[5.0.0] - (05.08.2021)

Changes

removed deprecated inherits and moved all characterictics to use ES6 class

[4.9.0] - (03.08.2021)

Changes

added support for Ensemble (Enpowers and Encharges)
fixed wrong named Encharges to AC Batteries
other fixes and performance improvements

[4.8.0] - (12.03.2021)

Changes

added possibility to check communications level of all devces on user request
fixed many small bugs
code cleanup

[4.7.0] - (04.03.2021)

Changes

update config.chema
fixed many small bugs
correct identyfi all hardware
code cleanup

[4.6.0] - (24.02.2021)

Changes

added Characteristics for Apparent and Reactive Power
fixed some bugs

Important note v4.5.0 and above

Version 4.5.0 and above need to be used with Homebridge min. v1.3.0.

[4.5.0] - (23.02.2021)

Changes

code rebuild, use Characteristic.onSet/onGet
require Homebridge 1.3.x or above

[4.4.0] - (10.02.2021)

Changs

restored possibility to set own user and password for envoy
added characteristic for communication level Q-Relays, Encharges, Microinverters
added characteristic for all data from Encharges
other improvements and fixes

[4.3.0] - (07.02.2021)

Changs

added more characteristics for encharges
added characteristics for Current, Voltage and Power Factor
fixed reported bugs

[4.2.0] - (03.02.2021)

Changs

added evnoy characteristics
fixes and corrections

[4.1.0] - (02.02.2021)

Changs

removed envoyUser, envoyPasswd, Firmware and SerialNumber, now detect the data automatically
data refresh improvements
reconfigured config schema
other fixes and corrections

Important note v4.0.0 and above

Version 4.0.0 whole new concept.

[4.0.0] - (30.01.2021)

Changs

refactoring whole code
added Characteristics for Q-Relay, Meters, Microinverters, Encharges
added whole base of status code all displayes in EVE or Controller app
added and present state and power of all devices (Envoy, Q-Relay, Meters, Microinverters, Encharges)
code cleanup and many more

[3.6.0] - (29.01.2021)

Changs

read Laast and Max Power of indyvidual inverters
code rebuild

[3.5.15] - (29.01.2021)

Changs

list all devices in log with its status

Important note v3.5.0 and above

Version 3.5.0 detect automatically all installed devices, please check Your config after update to this version.

[3.5.0] - (29.01.2021)

Changs

full automatic check installed devices, Envoy, Inverters, Q-Relay, Meters, Encharges
rebuild config

[3.4.3] - (29.01.2021)

Changs

added check for installed Q-Relay
added check for installed Encharge
added check for installed Meters
reconfigured config menu
code rebuild

[3.3.15] - (26.01.2021)

Changs

power Net and Total Max fixes

[3.3.9] - (01.01.2021)

Changs

bump dependiencies

[3.3.5] - (22.10.2020)

Changs

added encharge storage energy offset
added possibility to select consumtion meter CT - Load only/Load with Solar production
update config.schema

[3.2.0] - (08.09.2020)

Changs

added async/await function to read deviceInfo and updateStatus

[3.1.0] - (06.09.2020)

Changs

completly reconfigured config schema

[3.0.15] - (05.09.2020)

Changs

changed Characteristic.StatusActive to custom Characteristic.PowerMaxDetected

[3.0.8] - (05.09.2020)

Fix

fix wrong display power detection state

[3.0.7] - (04.09.2020)

Added

added Characteristic.StatusActive to identify Max Power Detection

[3.0.4] - (04.09.2020)

Fix

fix no display Last Seven Days energy

[3.0.3] - (04.09.2020)

Changes

code cleanup

Important note

Ab verion v3.0.0 accesory moved to Power Meter custom Characteristic, due to Apple HomeKit limitations right now only in EVE app displayed correctly, in HomeKit displayed as 'Unsupported'. If U want to use old CO2 sensor style just still with 2.x.x version

[3.0.0] - (02.09.2020)

New

accesory moved to Power Meter, due to Apple HomeKit limitations right now only in EVE app displayed, in HomeKit displayed as 'Unsupported'.
added possibility to set lifetime energy offset for production, and consumption.
added support for encharge storage.

[2.3.0] - (28.08.2020)

Added

added energy production and consumption tile (Today, Last 7D, Lifetime).

[2.2.0] - (27.08.2020)

Added

added possibility to display minus values, exported power to grid.

[2.1.3] - (27.08.2020)

Added

added extra accessory to present Total or Total and Net Consumption. Selectable in consumption power meter option.

[2.0.6] - (27.08.2020)

Added

added extra accessory to present Total Power Consumption if consumption Power meter is selected

[1.1.2] - (25.08.2020)

Changes

performance improvements
other small fixes

[1.1.0] - (09.08.2020)

Added

performance improvements

[1.0.3] - (02.07.2020)

Fixed

fixed #2 crash if no production meters are installed

[1.0.1] - (29.06.2020)

Fixed

fixed display energy and power values

[1.0.0] - (28.06.2020)

Added

added possibility select consumption power meter

[0.4.6] - (27.06.2020)

Fixed

fixed display energy symbol in the log

[0.4.5] - (27.06.2020)

Added

added in the log possibility read all power and energy value

[0.3.5] - (17.06.2020)

Fixed

corrections in config.schema.json

[0.3.0] - (15.06.2020)

Added

added possibility to select production meter

[0.2.0] - (010.06.2020)

Added

stored max. Power Production too the file
config.host now use 'envoy.local' path or Your configured iP adress

[0.1.1] - (08.06.2020)

Fixed

many fixes and more info in log

[0.0.30] - (05.06.2020)

working release

[0.0.1] - (05.06.2020)

initial release