Homebridge plugin to control Sonoff relays with OEM firmware. It uses the same API as the iOS app to communicate with your devices.
The platform will dynamically add/remove devices based on what is configured in your eWeLink account.
It has been tested with the Sonoff basic relays. I have performed testing with up to two relays associated to my account.
The plugin will only support one eWeLink account.
It is possible to continue to use the OEM functionality (eWeLink app, Google Home integration); this plugin requires no modification to the relay's firmware.
This is a fork of homebridge-ewelink, which is not being actively updated. There is another package named homebridge-ewelin-plus which is not updated for 6 months at the time of writing. The name is inspired by Apple's naming convention.
This fork have the following notable changes / improvements:
- Support login with phone number / email and password, which save your time from obtaining the authentication token with Charles once in a while.
- Support sending heartbeat on the WebSocket connection, which greatly reduce the interval of reconnects, hence better stability.
- Support obtaining the correct API / WebSocket API host automatically, so you don't need to obtain these information with Charles.
The code is of suboptimal quality. It was a quick-and-dirty plugin; feel free to contribute & improve.
Assuming that you've already downloaded the eWeLink app on your iOS device & have configured it:
- Install the plugin
sudo npm -g install homebridge-ewelink-max
- Add to the platforms[] section of config.json.
phoneNumber- The login phone number of your ewelink account, do not include this if you login with emailemail- The login email of your ewelink account, do not include this if you login with phone numberpassword- Your ewelink account login passwordimei- This can be any valid UUID, get one with an online generator
- Restart Homebridge
{
"bridge": {
"name": "Homebridge",
"username": "XX:XX:XX:XX:XX:XX",
"port": 51826,
"pin": "123-45-678"
},
"description": "Your description here",
"accessories": [
],
"platforms": [
{
"platform" : "eWeLink",
"name" : "eWeLink",
"phoneNumber" : "+12345678901",
"password" : "your-login-password",
"imei" : "01234567-89AB-CDEF-0123-456789ABCDEF"
}
]
}
If you use email login, the platform section should look like this:
{
"platform" : "eWeLink",
"name" : "eWeLink",
"email" : "[email protected]",
"password" : "your-login-password",
"imei" : "01234567-89AB-CDEF-0123-456789ABCDEF"
}
An authentication token is generated every time your device's app logs in to the eWeLink service.
You can only have one authentication token per user account.
Therefore if you use the HomeKit app and eWeLink app at the same time, they will fight each other for the login session. They should both work individually. You can leave homebridge running when using the eWeLink app.
I've attempted to make the logging as useful as possible. If you have any suggestions, please open an issue on GitHub.
[12/13/2017, 9:39:05 PM] [eWeLink] A total of [1] accessories were loaded from the local cache
[12/13/2017, 9:39:05 PM] [eWeLink] Requesting a list of devices from eWeLink HTTPS API at [https://us-api.coolkit.cc:8080]
[12/13/2017, 9:39:06 PM] [eWeLink] eWeLink HTTPS API reports that there are a total of [1] devices registered
[12/13/2017, 9:39:06 PM] [eWeLink] Evaluating if devices need to be removed...
[12/13/2017, 9:39:06 PM] [eWeLink] Verifying that all cached devices are still registered with the API. Devices that are no longer registered with the API will be removed.
[12/13/2017, 9:39:06 PM] [eWeLink] Device [Fan] is regeistered with API. Nothing to do.
[12/13/2017, 9:39:06 PM] [eWeLink] Evaluating if new devices need to be added...
[12/13/2017, 9:39:06 PM] [eWeLink] Device with ID [XXXXXXX] is already configured. Ensuring that the configuration is current.
[12/13/2017, 9:39:06 PM] [eWeLink] Updating recorded Characteristic.On for [Fan] to [false]. No request will be sent to the device.
[12/13/2017, 9:39:06 PM] [eWeLink] Setting power state to [off] for device [Fan]
[12/13/2017, 9:39:06 PM] [eWeLink] API key retrieved from web service is [XXXXXXX]
[12/13/2017, 9:39:06 PM] [eWeLink] Connecting to the WebSocket API at [wss://us-long.coolkit.cc:8080/api/ws]
[12/13/2017, 9:39:06 PM] [eWeLink] Sending login request [{"action":"userOnline","userAgent":"app","version":6,"nonce":"151321914688000","apkVesrion":"1.8","os":"ios","at":"XXXXXXX","apikey":"xxxxxxx","ts":"1513219146","model":"iPhone10,6","romVersion":"11.1.2","sequence":1513219146880}]
[12/13/2017, 9:39:06 PM] [eWeLink] WebSocket messge received: {"error":0,"apikey":"xxxxxxx","config":{"hb":1,"hbInterval":145},"sequence":"1513219146880"}
Hey Siri, turn on the fan
[12/13/2017, 9:39:09 PM] [eWeLink] Setting power state to [on] for device [Fan]
[12/13/2017, 9:39:09 PM] [eWeLink] WebSocket messge received: {"error":0,"deviceid":"XXXXXXX","apikey":"XXXXXXX","sequence":"1513219149620"}
[12/13/2017, 9:39:11 PM] [eWeLink] Setting power state to [off] for device [Fan]
[12/13/2017, 9:39:12 PM] [eWeLink] WebSocket messge received: {"error":0,"deviceid":"XXXXXXX","apikey":"XXXXXXX","sequence":"1513219151735"}
The plugin will also listen for announcements via a persistent web socket. This allows you to control the device from the likes of Google Home & have Homebridge be kept up-to-date
Hey Google, turn on the fan
[12/13/2017, 9:41:50 PM] [eWeLink] Update message received for device [XXXXXXX]
[12/13/2017, 9:41:50 PM] [eWeLink] Updating recorded Characteristic.On for [Fan] to [true]. No request will be sent to the device.
[12/13/2017, 9:41:50 PM] [eWeLink] Setting power state to [on] for device [Fan]
[12/13/2017, 9:41:50 PM] [eWeLink] WebSocket messge received: {"error":0,"deviceid":"XXXXXXX","apikey":"XXXXXXX","sequence":"1513219310003"}
https://github.com/websockets/ws/wiki/Websocket-client-implementation-for-auto-reconnect