homebridge-homewizard-energy-socket

Homebridge plugin for HomeWizard Energy Socket

This Homebridge plugin exposes your HomeWizard Energy Sockets to Apple HomeKit. So you can use the Home App to switch your Energy Sockets on or off and integrate the Energy Sockets into your Home Automations.

Features

• Control Energy Sockets from within the Home App
• Use Energy Sockets in your Home Automations
• Automatically discovers Energy Sockets in your network

This plugin does not provide a way to show the current power consumption of the Energy Sockets. This is a limitation of HomeKit and not of this plugin.

Getting started

For Homebridge to communicate with your Energy Sockets, it is required to enable the "Local API" setting and disable the "Switch lock" setting from within the HomeWizard Energy App. You must do this for each Energy Socket you want to expose in the Home App. It is also advised to assign fixed/static IP addresses to each Energy Socket in your network to improve reliability.

1. Enabling the Local API setting and disable the Switch lock setting

1. Open your HomeWizard Energy app
2. Go to settings and choose "Meters"
3. Tap on each Energy Socket you want to use and follow step 4 and 5
4. Enable the "Local API" setting
5. Disable the "Switch lock" setting

More on this on the HomeWizard support page: Integrating Energy with other systems (API)

2. Installation of the plugin bridge

This package is published on NPM, so available on the Homebridge plugin page

1. Go to your Homebridge UI and click on "Plugins"
2. Search for HomeWizard Energy and select the plugin Homebridge HomeWizard Energy Socket from @jvandenaardweg and click "Install"
3. On the plugin Settings, set the name you want to use for this plugin, or leave it empty to use the default. Click Save.
4. Click the little QR code icon for the plugin and enable the bridge. Save it and restart Homebridge.
5. After restarting Homebridge, click the QR code icon again and scan the QR code with your iPhone using the Home App. This will add the plugin bridge to your Home App.
6. Your Energy Sockets should now be available to configure in the Home App

Make sure to read this Wiki article about Identifying the Energy Socket in the Home App

Troubleshooting

After enabling the plugin, the plugin will automatically discover the Energy Sockets in your network that have the "Local API" setting enabled using Multicast DNS. More on this in the HomeWizard API documentation about Discovery.

If no Energy Sockets could be found:

• There probably is an issue with Multicast DNS in your network. Check your network settings and/or router settings to enable Multicast DNS.
• Try a restart of the Homebridge plugin and/or server
• Verify if the Energy Sockets are still available/online in the Energy App.

Changelog

1.2.1

11 December 2022

• fix: run setAsyncCharacteristics on new instance of accessory 5ecaa0a
• chore: release v1.2.1 6a03062
• chore: update docs on error we throw 7ca003b
• chore: add test todo 4c75005