Plugin to HomeBridge optimized to work with firmware Sonoff-Tasmota, MQTT.
Switch branches/tags
Nothing to show
Clone or download
Latest commit 61fb4eb Jun 1, 2018

README.md

homebridge-mqtt-switch-tasmota

Plugin to HomeBridge optimized for work with Itead Sonoff and Electrodragon Relay Board hardware and firmware Sonoff-Tasmota via MQTT. It acts as a switch or light bulb or outlet (depending of configuration).

Like this? Please buy me a beer (or coffee) ;-) Donate a coder

MacWyznawca.pl Jaromir Kopp

Installation

sudo npm install -g homebridge-mqtt-switch-tasmota

Sample HomeBridge Configuration (complete)

{

"bridge": {
    "name": "Homebridge",
    "username": "CC:22:3D:E3:CE:30",
    "port": 51826,
    "pin": "031-45-154"
},

"description": "This is an example configuration file. You can use this as a template for creating your own configuration file.",

"platforms": [],
  "accessories": [
    {
		"accessory": "mqtt-switch-tasmota",
		"switchType": "outlet",
	
		"name": "NAME OF THIS ACCESSORY",
	
		"url": "mqtt://MQTT–BROKER-ADDRESS",
		"username": "MQTT USER NAME",
		"password": "MQTT PASSWORD",
	
		"topics": {
			"statusGet": "stat/sonoff/RESULT",
			"statusSet": "cmnd/sonoff/POWER",
			"stateGet": "tele/sonoff/STATE"
		},
		"onValue": "ON",
		"offValue": "OFF",
	
		"activityTopic": "tele/sonoff/LWT",
        "activityParameter": "Online",
    
		"startCmd": "cmnd/sonoff/TelePeriod",
		"startParameter": "60",
		
		"manufacturer": "ITEAD",
		"model": "Sonoff",
		"serialNumberMAC": "MAC OR SERIAL NUMBER OR EMPTY"
	}
]

}

Sample HomeBridge Configuration (minimal)

{

"bridge": {
    "name": "Homebridge",
    "username": "CC:22:3D:E3:CE:30",
    "port": 51826,
    "pin": "031-45-154"
},

"description": "This is an example configuration file. You can use this as a template for creating your own configuration file.",

"platforms": [],

"accessories": [
    {
		"accessory": "mqtt-switch-tasmota",
	
		"name": "NAME OF THIS ACCESSORY",
	
		"url": "mqtt://MQTT–BROKER-ADDRESS",
		"username": "MQTT USER NAME",
		"password": "MQTT PASSWORD",
	
		"topics": {
			"statusGet": "stat/sonoff/POWER",
			"statusSet": "cmnd/sonoff/POWER"
		}
	}
]

}

Sample HomeBridge Lightbulb Configuration (minimal)

{

"bridge": {
    "name": "Homebridge",
    "username": "CC:22:3D:E3:CE:30",
    "port": 51826,
    "pin": "031-45-154"
},

"description": "This is an example configuration file. You can use this as a template for creating your own configuration file.",

"platforms": [],

"accessories": [
    {
		"accessory": "mqtt-switch-tasmota",
	    "switchType": "lightbulb",
		
		"name": "NAME OF THIS ACCESSORY",
	
		"url": "mqtt://MQTT–BROKER-ADDRESS",
		"username": "MQTT USER NAME",
		"password": "MQTT PASSWORD",
	
		"topics": {
			"statusGet": "stat/sonoff/POWER",
			"statusSet": "cmnd/sonoff/POWER"
		}
	}
]

}

Description of the configuration file.

"switchType": "outlet" - outlet for outlet emulation, "lightbulb"** - lightbulb for light bulb emulation or empty for switch.

sonoff in topic - topics name of Your Sonoff switch.

"stateGet": "tele/sonoff/STATE" - topic for cyclic telemetry information.

"activityTopic": "tele/sonoff/LWT" - last will topic for check online state.

"activityParameter": "Online" - last will payload for online state.

"startCmd": "cmnd/sonoff/TelePeriod" - command sent after the connection.

"startParameter": "60" - payload for startCmd.

"statusGet": "stat/sonoff/RESULT" - is for Tasmota firmware relays only! For toher use: "statusGet": "stat/sonoff/POWER"