Git Product home page Git Product logo

jvandenaardweg / homebridge-homewizard-energy-socket Goto Github PK

View Code? Open in Web Editor NEW
8.0 5.0 0.0 2.91 MB

This verified 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.

License: MIT License

TypeScript 99.94% Shell 0.06%
apple-homekit homebridge homebridge-plugin homekit homekit-accessory homewizard homewizard-energy homewizard-energy-socket apple apple-home home-automation homebridge-plugins homewizard-energy-api

homebridge-homewizard-energy-socket's Introduction

npm   github   github   github sponsor   mit license

Homebridge plugin for HomeWizard Energy Socket

This verified 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
  • Use the Outlet In Use characteristic to trigger automations based on power consumption
  • 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. I do however have a way to trigger automations based on the Outlet In Use characteristic.

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 use DHCP Reservations for 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 homebridge-homewizard-energy-socket 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

By default the plugin will automatically discover the Energy Sockets in your network that have the "Local API" setting enabled using Multicast DNS. Multicast DNS is a feature of all routers. So unless you have changed these settings specifically, or using multiple different LAN networks, there should be no need to change any settings for this. It should just work.

More on this in the HomeWizard API documentation about Discovery.

If no Energy Sockets could be found, maybe this could help:

  • Verify if the Energy Sockets are still available/online in the Energy App
  • Verify if the Energy Sockets have the "Local API" setting enabled
  • Restart the Energy Sockets (unplug and plug them back in)
  • Restart the Homebridge plugin and/or server
  • If none of the above help, there probably is an issue with Multicast DNS in your network. Check your network settings and/or router settings to enable Multicast DNS. Or use the Energy Sockets config option for the plugin to manually add your Energy Sockets by using the IP address.

Still experience an issue? Please open an issue on GitHub.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.