homebridge-mqtt-tasmota

This is an all-in-one homebridge plugin to control various tasmota devices via MQTT.

Since tasmota MQTT topics are well known for a given device type, all the MQTT topics will be computed according to the device name (%topic% in the tasmota settings).

Requirements

• A MQTT broker (mosquitto for instance)
• A tasmota flashed device (v9.3 or up)
• Homebridge (v1.0.0 or up)

Compatible with

• Sonoff devices :
  • RFR3
  • MINI
  • POWR2
  • iFan03
  • S26
  • 4CHPROR2
  • 433 RF Bridge (with smoke alarms)
  • T1 (dual switch)
• Homemade ESP8266 Temperature sensor
• Generic RGB LED strip controller
• Probably all other devices supporting tasmota

Installation

If you are new to homebridge, please first read the homebridge documentation. To install the plugin use:

sudo npm install homebridge-mqtt-tasmota -g

Configuration example

Here is homebridge config.json example:

{
    "bridge": {
        "name": "homebridge",
        "username": "CC:22:3D:E3:CE:30",
        "port": 51826,
        "pin": "031-45-154"
    },
    "accessories": [
        {
            "accessory": "mqtt-tasmota",
            "type": "blinds",
            "name": "Living Room Blinds #1",
            "url": "mqtt://192.168.0.3",
            "topic": "living_room_shutter",
            "index": "1"
        },
        {
            "accessory": "mqtt-tasmota",
            "type": "blinds",
            "name": "Living Room Blinds #2",
            "url": "mqtt://192.168.0.3",
            "topic": "living_room_shutter",
            "index": "2"
        },
        {
            "accessory": "mqtt-tasmota",
            "type": "switch",
            "name": "Lounge",
            "url": "mqtt://192.168.0.3",
            "topic": "lounge_switch"
        },
        {
            "accessory": "mqtt-tasmota",
            "type": "switch",
            "name": "Dual Switch 1",
            "url": "mqtt://192.168.0.3",
            "topic": "dual_switch",
            "index": "1"
        },
        {
            "accessory": "mqtt-tasmota",
            "type": "switch",
            "name": "Dual Switch 2",
            "url": "mqtt://192.168.0.3",
            "topic": "dual_switch",
            "index": "2"
        },
        {
            "accessory": "mqtt-tasmota",
            "type": "lightbulb",
            "name": "RGB Led strip",
            "url": "mqtt://192.168.0.3",
            "topic": "lounge_rgb"
        },
        {
            "accessory": "mqtt-tasmota",
            "type": "smoke",
            "name": "Kitchen Smoke",
            "url": "mqtt://192.168.0.3",
            "topic": "smoke_alarm_kitchen"
        },
        {
            "accessory": "mqtt-tasmota",
            "type": "doorbell",
            "name": "Main Door Bell",
            "url": "mqtt://192.168.0.3",
            "topic": "door_bell"
        },
        {
            "accessory": "mqtt-tasmota",
            "type": "sensor",
            "name": "Lounge Temp&Humidity",
            "url": "mqtt://192.168.0.3",
            "topic": "lounge_temp"  
        },
        {
            "accessory": "mqtt-tasmota",
            "type": "fan",
            "name": "Fan",
            "url": "mqtt://192.168.0.3",
            "topic": "lounge_fan"
        },
        {
            "accessory": "mqtt-tasmota",
            "type": "valve",
            "name": "Garden Irrigation",
            "url": "mqtt://192.168.0.3",
            "topic": "garden_irrigation",
            "icon": "irrigation"
        }
    ]
}

Supported accessories

One single mqtt-tasmota type is supported, with type being one of:

• blinds
• doorbell
• fan
• lightbulb
• smoke
• switch
• sensor (for both temperature and humidity)
• temperature (for temperature only)
• valve

Settings

Variable	Description	Default	Example	Optional
Basic Settings
accessory	Name of the accessory plugin.		mqtt-tasmota
type	Type of the accessory (as mentioned above)		blinds
name	Name for your device.		Living Room Blind
debug	Debug incoming MQTT messages for the device	false	true	✅
manufacturer	Manufacturer of your device	DIY	DIY	✅
model	Model of your blind.	Prototype	Prototype	✅
serialNumberMAC	Serial number of your device.	01.01.01.01	01.01.01.01	✅
MQTT Settings
url	MQTT broker URL.		mqtt://192.168.0.10:1883
username	Your MQTT Broker username		username	✅
password	Your MQTT Broker password		password	✅
topic	MQTT topic part related to the device. (will be used to compose actual tasmota topics)		my_blind
teleTopic	Telemetry topic (for instance position of shutter from 0 to 100)	/tele/{topic}/SENSOR	/tele/my_blind/SENSOR	✅
commandTopic	Command topic (for instance to set position of shutter to set position from 0 to 100)	/cmnd/{topic}/ShutterPosition{index}	/cmnd/my_blind/ShutterPosition1	✅
resultTopic	Result topic (for instance to get shutter position from 0 to 100)	/stat/{topic}/RESULT	/stat/my_blind/RESULT	✅
shutterName	Shutter name as seen in tasmota.	Shutter{index}	Shutter1	✅
For devices with multiple accessories like switch, lightbulb, valve, shutter
index	The device index in tasmota (could be 1 to 4)		1	✅

About the valve accessory support

Tasmota does not have an actual behaviour for an irrigation system or similar system, but it can be setup with some simple rules within the device.

For instance, if I want to setup a faucet that will be triggered by a click, and then will stay ON for 30 minutes, I can have these rules in tasmota:

Rule1
  ON Power1#state=1 DO backlog RuleTimer1 1800; RuleTimer8 10; ENDON
  ON Rules#Timer=1 DO Power1 off ENDON
  ON Rules#Timer=8 DO RuleTimer8 10 ENDON
  ON Power1#state=0 DO RuleTimer0 0 ENDON
;
Rule1 1

This will start a timer once the button state changed to ON. Then, every 10 seconds a second timer will publish the current timer state to MQTT. This way, the homebridge accessors will be able to display the remaining time left. After 30 minutes the power button will be set to OFF.

Furthermore, you can also do a schedule with timers to enable automatic irrigation schedule, or like I do, program a swimming pool filtration motor:

timers on;
Timer1 {"Enable":1,"Mode":0,"Time":"23:00","Window":0,"Days":"1111111","Repeat":1,"Output":1,"Action":1};
Timer2 {"Enable":1,"Mode":0,"Time":"03:00","Window":0,"Days":"1111111","Repeat":1,"Output":1,"Action":1};
Timer3 {"Enable":1,"Mode":0,"Time":"09:00","Window":0,"Days":"1111111","Repeat":1,"Output":1,"Action":1};
Timer4 {"Enable":1,"Mode":0,"Time":"15:00","Window":0,"Days":"1111111","Repeat":1,"Output":1,"Action":1};
Timer5 {"Enable":1,"Mode":0,"Time":"19:00","Window":0,"Days":"1111111","Repeat":1,"Output":1,"Action":1};

TODO

• for malfunctioning devices, get their state at startup and show them as broken
• create a platform API and enable auto-discover of all tasmota devices
• add logs for sensors (temp, hum, watt, ...)

Contributing

Adding support for a new device type should be as simple as add a new device_type.js file in the src directory Then:

• add the device type in the main src/ìndex.js file
• add a dedicated section in the config.schema.json file if necessary