README

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) ;-)

MacWyznawca.pl Jaromir Kopp

Installation

sudo npm install -g homebridge-mqtt-threestate-light-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",
            "dimmerSet": "cmnd/sonoff/Dimmer", //Optional
            "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"

Usage no npm install needed!