homebridge-mqtt-blinds-tasmota

This is a homebridge plugin to control blinds/shutters via mqtt.

Installation

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

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

Configuration

config.json example (generic)

{
    "bridge": {
        "name": "homebridge",
        "username": "CC:22:3D:E3:CE:30",
        "port": 51826,
        "pin": "031-45-154"
    },
    "accessories": [{
      "accessory": "mqtt-blinds-tasmota",
      "name": "Living Room Blind",
      "manufacturer": "DIY",
      "model": "Prototype",
      "serialNumberMAC": "01.01.01.01",
      "mqttBrokerUrl": "mqtt://192.168.0.10:1883",
      "mqttUsername": "username",
      "mqttPassword": "password",
      "mqttTopic": "my_blind",
      "mqttShutterIndex": "1",
    }
    ],

    "platforms": [
    ]
}

Basic

Variable	Description	Example
accessory	Name of the accessory plugin.	mqtt-blinds-tasmota
name	Name for your blinds.	Living Room Blind
manufacturer	Manufacturer of your blind	DIY
model	Model of your blind.	Prototype
serialNumberMAC	Serial number of your blind.	01.01.01.01

MQTT

Basics

Variable	Description	Example
mqttBrokerUrl	IP Adress of your MQTT Broker	mqtt://192.168.0.10:1883
mqttUsername	Your MQTT Broker username	username
mqttPassword	Your MQTT Broker password	password
mqttTopic	The main topic of your blind	my_blind
mqttShutterIndex	The shutter index in tasmota (could be 1 to 4)	1

Optional override

Use these variables to override the computed topics (mqttTopic + mqttShutterIndex).

Variable	Description	Example	Default Value
mqttResultTopic	Topic to get position from 0 to 100.	/stat/my_blind/RESULT	/stat/{mqttTopic}/RESULT
mqttCommandTopic	Topic to set position from 0 to 100.	/cmnd/my_blind/ShutterPosition1	/cmnd/{mqttTopic}/ShutterPosition{mqttShutterIndex}
mqttTeleTopic	Telemetry topic position from 0 to 100.	/tele/my_blind/ShutterPosition1	/tele/{mqttTopic}/ShutterPosition{mqttShutterIndex}
mqttShutterName	Shutter name as seen in tasmota.	Shutter1	Shutter{mqttShutterIndex}