homebridge-3em-energy-meter-adv
v1.1.3
Published
Homebridge plugin for implementing Shelly 3EM (or EM) Energy Meter functionality in Homekit (EVE third party app only).
Downloads
32
Maintainers
Readme
Homebridge 3em Energy Meter
Homebridge 3em Energy Meter is a plugin for Homebridge that implements Shelly 3EM energy metering functionality in Homekit.
This plugin uses http requests to a Shelly 3EM (or EM*) device, making it possible to retain the native Shelly cloud statistics (which use MQTT) and at the same time allow you to monitor your energy consumption via Homekit.
Please note that due to the fact that Apple does not support energy characteristics in Homekit, this plugin's accessory will only show values in the third-party homekit application "EVE".
[]
It will show in the EVE application the following values: Voltage (the average voltage of all 3 phases), Current (the accumulated Ampere of all 3 phases), Consumption (the accumulated Watts of all 3 phases) and the Total Consumption (the accumulated kWh of all 3 phases as calculated by Shelly API. Note in order to reset this value you must reset it in the Shelly app). A Total Cost and Projected Cost will show if you have specified the Energy Cost in the settings section of your EVE application. Total Consumption and Total Cost will feature the fakegato-history graph.
This application uses the cool fakegato plugin (simont77/fakegato-history).
Please also note that the sole purpose of this plugin is the energy metering feature of the Shelly 3em in order to monitor your 3 phase installation. The Shelly 3em features also an actuator (switch) which is not implemented in this plugin. If you need to use the switch in Homekit please use other plugins, like for example the very good homebridge-shelly (alexryd/homebridge-shelly) plugin.
Installation Instructions
You can easily install this plugin by using the superb Homebridge Config UI X. Search for "homebridge-3em-energy-meter" in the "Plugins" tab and install the plugin. After that fill out the configuration by using the "SETTINGS" link below the installed plugin.
Alternatively, can you install the plugin by
npm install -g homebridge-3em-energy-meter
and then edit your Homebridge's config.json to include the following in the accessories section:
{
"accessory": "3EMEnergyMeterAdv",
"name": "Energy Meter",
"ip": "192.168.0.1",
"auth": {
"user": "",
"pass": ""
},
"timeout": 5000,
"update_interval": 10000,
"negative_handling_mode": 0,
"use_pf": false,
"debug_log": false,
"serial": "123456789012345"
},
- "name" The Homekit Accessory Name.
- "ip" The IP address of your Shelly 3EM.
- "user" and "pass" If your Shelly 3EM local web page is password protected specify "user" and "pass".
- "timeout" The http/get request timeout in msec. This timeout must the less than the "update_interval", default is 5000.
- "update_interval" The interval for pulling values in msec. Must be greater than "timeout" setting, default is 10000.
- "use_pf" Enables the Power Factor (pf) usage when calculating Total Ampere.
- "negative_handling_mode" Defines what happens with negative values. Set to 0 to zero them or 1 to show them as absolute values.
- "debug_log" Enables the debug logging of the plugin, default is false.
- "serial" This sets the published serialNumber of the accessory. It is required to use an unique serial for fakegato-history to work correctly.
Shelly EM functionality is beta, please use at own risk as I could not test it on a real EM device. The creator of this plugin is not affiliated in any way with Shelly(Allterco) or EVE.