A Python plugin for Domoticz that creates several devices for the HomeWizard Wifi 3F kWh meter.
The HomeWizard Wi-Fi kWh meters are devices that can be installed in a modern power distribution system in your home. By default it sends all of its data to the HomeWizard servers but thanks to its local API you can read the device locally too. With this plugin you can use Domoticz to read the meter and store the data without using your internet connection.
Domoticz uses Python to run plugins. Use the installation instructions on the Domoticz wiki page to install Python. When Python is installed use these instructions to install this plugin.
To access the data from the Wifi 3 Phase kWh meter, you have to enable the API. You can do this in the HomeWizard Energy app (version 1.5.0 or higher). Go to Settings > Meters > Your meter, and turn on Local API.
The plugin is able to create several devices depending on the values that are read from your meter and that you enable when creating the hardware device. By default only the devices listed under Intial devices are created, even some of these may not be usefull for everyone but you can safely ignore those. Setting Mode 5 to 1, initially it is 0, enables all possible devices. Initial devices are, in the order the author thinks are most important:
- An energy meter that reads the counters of the totaled actual energy of all 3 phases drawn and/or fed back (kWh) together with the totaled average power per 5 minutes (Watt)
- Three energy meters who show the actual power of each phase (Watt); positive when used, negative when produced (PV or battery)
- Three meters who show the actual amperage per phase (A)
- Three meters who show the current voltage per phase (V)
- A Wi-Fi signal strength meter that shows the current signal strength from the Wi-Fi 3F kWh meter (%)
Additional devices, enabled when Mode5 is 1:
- An energy meter that shows the totaled apparent power of all 3 phases drawn and/or fed back (VA)
- Three energy meters who show the apparent power of the phases (VA)
- An energy meter that shows the totaled reactive power of all phases (VA)
- Three energy meters who show the reactive power of the phases (VA)
- A meter to show the totaled apparent current of the 3 phases (A)
- Three meters who show the apparent amperage of the separate phases (A)
- A meter to show the totaled reactive current of the 3 phases (A)
- Three meters to show the reactive current of the separate phases (A)
- Three meters to show the power factor of the 3 separate phases (%)
Actual power is the power that is really consumed and that is payed for. Apparent power is the power that passes between the source and the target. Reactive power is the power that is exchanged between the source and the target during a cycle; it is exchanged, so you have to dimension your circuit to cope with its current (i.e. the size of the fuse in your circuit), but it is not charged. Actual power is the difference between apparent power and reactive power. The power factor is the percentage of actual power compared the apparent power.
The configuration is pretty self explaining. You just need the IP address of your Wi-Fi 3F kWh meter or the name in your local network. Make sure the IP address is static DHCP so it won't change over time.
| Configuration | Explanation |
|---|---|
| IP address | The IP address of the Wi-Fi 3F kWh meter |
| Port | The port on which to connect (80 is default) |
| Data interval | The interval for the data devices to be refreshed |
| Mode5 | 0 when only initial devices need to generated |
| 1 when also these additional devices are wanted | |
| Debug | Used by the developer to test stuff |
The desing of this plugin is based on the Python set elements with is a list of values for an item in the set. In case you want less devices than the standard implemeted in this plugin, it is quite simple to change the set by commenting out the specific element in the set. Nothing else needs to change.