Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nischcodes/homebridge-wiz-net
Control Wiz products over network.
https://github.com/nischcodes/homebridge-wiz-net
homebridge homebridge-plugin wiz-connected
Last synced: 2 months ago
JSON representation
Control Wiz products over network.
- Host: GitHub
- URL: https://github.com/nischcodes/homebridge-wiz-net
- Owner: nischcodes
- License: mit
- Created: 2022-11-13T11:53:42.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2022-11-13T19:13:48.000Z (about 2 years ago)
- Last Synced: 2024-10-17T02:22:33.854Z (3 months ago)
- Topics: homebridge, homebridge-plugin, wiz-connected
- Language: TypeScript
- Homepage:
- Size: 51.8 KB
- Stars: 5
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# homebridge-wiz-net
Control Wiz products over network.
## Based of
- [kpsuperplane/homebridge-wiz-lan](https://github.com/kpsuperplane/homebridge-wiz-lan#readme)
## Currently supports
- Wiz Plugs/Outlets (ESP10_SOCKET_06, ESP25_SOCKET_01)
# Installation
Make sure your bulbs are already set up via the Wiz app and you have "Allow Local Communication" set to ON in your settings.
1. Install homebridge using: `npm install -g homebridge`
2. Install this plugin using: `npm install -g homebridge-wiz-net`
3. Update your configuration file. See the sample below.
# Configuration
Simple Configuration:
```javascript
{
"platform": "WizSmartHome",
"name": "WizSmartHome",
}
```
Full configuration options:
```javascript
{
"platform": "WizSmartHome",
"name": "Wiz",
// [Optional] Port for bulbs to connect to your server
// Default: 38900
"port": 38900,
// [Optional] Enable scenes support for your bulbs
// Default: false
"enableScenes": false,
// [Optional] UDP Broadcast address for bulb discovery
// Default: 255.255.255.255
"broadcast": "255.255.255.255",
// [Optional] Your server's IP address
// Default: Autodiscovered
"address": "192.168.0.1",
// [Optional] Manual list of IP addresses of bulbs
// Useful if UDP broadcast doesn't work for some reason
// Default: None
"devices": [
{ "host": "192.168.0.2" },
{ "host": "192.168.0.3" },
{ "host": "192.168.0.4" },
// ...
]
}
```
## Some Notes
### Color
The Wiz bulbs strongly distinguish between RGB color modes and Kelvin color modes, **the latter being significantly brighter**. Unfortunately, HomeKit is not very good at handling both at the same time, [yielding weird errors if you try to add both characteristics](https://github.com/home-assistant/home-assistant/pull/30756).
Luckily, even if we only enable the color mode, we still get a nice temperature picker. Problem is, the color temperature is given in standard HSV. As such, this app will try to guess which one to best use given a color, and you will notice some significant brightness variance switching between a "temp" hue and a "color" hue.
**In particular, since the Wiz bulbs only support up to 6500K, this means that only the top-ish half of the temperature picker is actually bright**
# Development
Ideas from http://blog.dammitly.net/2019/10/cheap-hackable-wifi-light-bulbs-or-iot.html?m=1
## Contributing
Mostly built for my own personal use - so no active development. Feel free to fork and contribute.
## How bulbs are discovered
Make a UDP broadcast to port 38899 with the following content:
```
{"method":"registration","params":{"phoneMac":"","register":false,"phoneIp":""}}
```
You will get a response on port 38900 with the following content:
```
{"method":"registration","env":"pro","result":{"mac":"","success":true}}
```
# License
See LICENSE file