hms

homebridge-mqtt-switch-tasmota

Plugin to HomeBridge optimized to work with firmware Sonoff-Tasmota, MQTT.

Showing:

Popularity

Downloads/wk

15

GitHub Stars

58

Maintenance

Last Commit

3yrs ago

Contributors

8

Package

Dependencies

1

Size (min+gzip)

27.6KB

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

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

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial