Homebridge-washingmachine-pow NPM

homebridge-washingmachine-pow

Creating and maintaining Homebridge plugins consume a lot of time and effort, if you would like to share your appreciation, feel free to "Star" or donate.

Click here to review more of my plugins.

Info

This is a dynamic platform plugin for Homebridge to control the state of your washingmachine(s) used with Sonoff POW (R2) with Telegram notification Support

This Plugin creates a Outlet Accessory with FakeGato functionality to check the power, which will be triggered when the current power is greater or equal than "startValue" defined in config.json

You can also set up the notifier to get a Telegram notification with customized messages and markdown capability when the current running program starts and/or finishes!

Installation instructions

After Homebridge has been installed:

sudo npm i -g homebridge-washingmachine-pow@latest

Basic configuration

{
 "bridge": {
   ...
 },
 "accessories": [
   ...
 ],
 "platforms": [
   {
     "platform": "WMPow",
     "debug": true,
     "devices":[
       {
         "name": "Washingmachine",
         "ip": "192.168.178.134",
         "port": 1883,
         "username": "test",
         "password": "test",
         "manufacturer": "ITEAD",
         "model": "Sonoff Pow",
         "serialNumber": "12345",
         "topics": {
           "energyGet": "tele/sonoffpow/SENSOR",
           "stateGet": "tele/sonoffpow/STATE",
           "statusGet": "stat/sonoffpow/POWER",
           "statusSet": "cmnd/sonoffpow/power",
           "resetSet": [
             "cmnd/sonoffpow/EnergyReset1",
             "cmnd/sonoffpow/EnergyReset2",
             "cmnd/sonoffpow/EnergyReset3"
           ]
         },
         "onValue": "ON",
         "offValue": "OFF",
         "startValue": 3
       }
     ],
     "telegram":{
       "active": true,
       "token": "TelegramToken",
       "chatID": "TelegramChatID",
       "messages": {
         "started": "*Washingmachine:* started!",
         "finished": "*Washingmachine:* finished!"
       }
     }
   }
 ]
}

See Example Config for more details.

Options

Attributes	Required	Usage
platform	Yes	Must be WMPow
debug	No	Enables additional output in the log.
devices.name	Yes	Name of the device/accessory (Must be unique!)
devices.ip	Yes	Address of your MQTT broker
devices.port	No	Port of your MQTT Service (Default: 1883)
devices.username	No	Username for the MQTT Service (If no username setted up, just leave blank)
devices.password	No	Password for the MQTT Service (If no password setted up, just leave blank)
devices.manufacturer	No	Manufacturer name for display in the Home app.
devices.model	No	Model name for display in the Home app.
devices.serialNumber	No	Serialnumber for display in the Home app.
topics.energyGet	Yes	Topic for energy telemetry information.
topics.stateGet	Yes	Topic for cyclic telemetry information.
topics.statusGet	Yes	Status of switch.
topics.statusSet	Yes	Command topic to set switch.
topics.resetSet	Yes	Command topic(s) to reset energy information.
devices.onValue	No	Client ON message for switch.
devices.offValue	No	Client OFF message for switch.
devices.startValue	No	Current Power Consumption when device is active
telegram.active	No	Activate/Deactivate notifier (Default: false)
telegram.token	No	Telegram Bot Token
telegram.chatID	No	Telegram Chat ID
telegram.messages.started	No	Own message when motion sensor triggers on (if you dont want to get this notification, just remove from config)
telegram.messages.finished	No	Own message when motion sensor triggers off (if you dont want to get this notification, just remove from config)

Power Report

The plugin works with the latest version of Tasmota (at the time of writing v9.3.1). If you want to have a more precise output of the power consumption, you can write the following command via the Tasmote page of the device under "Console" and confirm it with "Enter".

PowerDelta 1

1 stands for the percentage change in power consumption. This means that a change of 1% will send a message via MQTT, which the plugin will then process and show to you via EVE.

Supported clients

This plugin has been verified to work with the following apps on iOS 12.2 and iOS 12.3 Beta:

iOS 14+
Apple Home
All 3rd party apps like Elgato Eve etc.
Homebridge v1.1.6+

Contributing

You can contribute to this homebridge plugin in following ways:

Report issues and help verify fixes as they are checked in.
Review the source code changes.
Contribute bug fixes.
Contribute changes to extend the capabilities

Pull requests are accepted.

Troubleshooting

If you have any issues with the plugin then you can run this plugin in debug mode, which will provide some additional information. This might be useful for debugging issues. Just enable debug in your config and restart homebridge.