go-homewizard

README

go-homewizard

This package provides a Go client library for the HomeWizard devices. It supports both API v1 and v2.

Requirements

• For v1, the API must be enabled.
• For v2, you will need to create a user for your application on the device and manage a secure token. You can use my HomeWizard CLI for this.
• v2 uses HTTPS. By default, the client runs in insecure mode and does not verify the server's certificate. To enable secure mode, you will need to know the hostname in the certificate, which depends on your device's serial number. HomeWizard CLI determines this for you.
• Go 1.26+

Limitations

• v1 only supports the P1 Meter.
• The following parts of v2 are not implemented yet:
  • Batteries: go fund me! 😂
  • Telegram
  • WebSocket
• Not all devices support all API versions and their endpoints. This module makes no effort to reject unsupported calls. Refer to the API documentation to check which API version and endpoints are supported for your device.
• Only tested with HomeWizard P1 Meter. Support for other devices is implemented in v2, but only tested against the specifications. If you have an issue using a different device, please open an issue on Codeberg or submit a pull request.

Acknowledgements

• This module wouldn't be possible without HomeWizard's excellent API documentation and support.

Authors

• Christophe Lambin

License

This project is licensed under the MIT license.