node-red-contrib-tasmotas

Support for Tasmota devices in SmartHome projects using Node-RED.

The goal of this project is to allow using and configuring devices flashed with Tasmota firmware in Node-RED.

Getting Started

Prerequisites

• Node-RED - see the installation guide
• Node.js >= 18
• An MQTT broker (e.g. Mosquitto) reachable by both Node-RED and your Tasmota devices

Installation

cd ~/.node-red
npm install node-red-contrib-tasmotas

Then restart Node-RED.

Concepts

Each physical Tasmota device is represented by a Device config node, which in turn references a shared MQTT Broker config node for the MQTT connection. Flow nodes (Switch, Light, Sensor, ...) reference a Device node and can be placed multiple times across different flows.

Optionally, a project-wide Manager node can group and manage all Tasmota devices on the local network: it can discover device IP addresses automatically, and download and cache device configurations locally. The Manager's functions (list devices, scan the network, send raw HTTP commands, ...) are accessed from a flow through one or more Config nodes.

RF (433 MHz) devices follow a similar pattern: an RF Bridge node represents a Tasmota RF bridge device, an optional RF Manager groups RF codes/timings across bridges, and RF Device nodes represent individual remotes/sensors.

Available Nodes

Flow nodes

| Node | Type | Description | | --- | --- | --- | | Switch | tasmota-switch | A Tasmota power/relay channel | | PulseTime | tasmota-pulsetime | Timer / auto-off configuration for a switch channel | | Shutter | tasmota-shutter | A Tasmota shutter/cover device | | Sensor | tasmota-sensor | Generic sensor telemetry | | Button | tasmota-button | Physical button/switch input events | | Light | tasmota-light | A Tasmota light (on/off, dimmer, color temperature, color) | | Generic | tasmota-generic | Raw access to a device's MQTT stat/tele messages and commands | | RF Bridge | tasmota-rf-bridge | A Tasmota RF bridge device; sends/receives raw RF codes | | RF Device | tasmota-rf-device | A single RF remote/sensor tracked by an RF Manager | | Config | tasmota-config | Access to a Manager's functions (list devices, scan network, HTTP commands, ...) - see the command reference |

Config nodes

| Node | Type | Description | | --- | --- | --- | | MQTT Broker | tasmota-mqtt-broker | The MQTT broker connection shared by all devices | | Device | tasmota-device | A single Tasmota device, referenced by the flow nodes above | | Manager | tasmota-manager | Optional project-wide device management (discovery, device database, config cache) - includes the AP-fallback recovery assistant, see the recovery guide | | RF Manager | tasmota-rf-manager | Optional grouping of RF Bridge/RF Device nodes; tracks RF codes and timings |

Example flows

[
    {
        "id": "6a5b4f7667dd5e93",
        "type": "tab",
        "label": "Shutter",
        "disabled": false,
        "info": "",
        "env": []
    },
    {
        "id": "4a234e775ccbd052",
        "type": "tasmota-shutter",
        "z": "6a5b4f7667dd5e93",
        "device": "1a88b745512d3c2f",
        "name": "relais_01_2",
        "outputs": 1,
        "sendDevice": true,
        "uidisabler": false,
        "idx": "1",
        "swapSwitches": false,
        "x": 530,
        "y": 120,
        "wires": [
            [
                "173b7fc0310f7798"
            ]
        ]
    },
    {
        "id": "54ad039d5c179adb",
        "type": "ui_button",
        "z": "6a5b4f7667dd5e93",
        "name": "btnOpen",
        "group": "371d8c5139241499",
        "order": 4,
        "width": "2",
        "height": "1",
        "passthru": true,
        "label": "Open",
        "tooltip": "",
        "color": "",
        "bgcolor": "",
        "className": "",
        "icon": "",
        "payload": "Open",
        "payloadType": "str",
        "topic": "topic",
        "topicType": "msg",
        "x": 300,
        "y": 80,
        "wires": [
            [
                "4a234e775ccbd052"
            ]
        ]
    },
    {
        "id": "fe89380a84ee2180",
        "type": "ui_button",
        "z": "6a5b4f7667dd5e93",
        "name": "btnStop",
        "group": "371d8c5139241499",
        "order": 5,
        "width": "2",
        "height": "1",
        "passthru": true,
        "label": "Stop",
        "tooltip": "",
        "color": "",
        "bgcolor": "",
        "className": "",
        "icon": "",
        "payload": "Stop",
        "payloadType": "str",
        "topic": "topic",
        "topicType": "msg",
        "x": 300,
        "y": 120,
        "wires": [
            [
                "4a234e775ccbd052"
            ]
        ]
    },
    {
        "id": "bf703ba05b46bd54",
        "type": "ui_button",
        "z": "6a5b4f7667dd5e93",
        "name": "btnClose",
        "group": "371d8c5139241499",
        "order": 6,
        "width": "2",
        "height": "1",
        "passthru": true,
        "label": "Close",
        "tooltip": "",
        "color": "",
        "bgcolor": "",
        "className": "",
        "icon": "",
        "payload": "Close",
        "payloadType": "str",
        "topic": "topic",
        "topicType": "msg",
        "x": 300,
        "y": 160,
        "wires": [
            [
                "4a234e775ccbd052"
            ]
        ]
    },
    {
        "id": "28bd8cdef12145c0",
        "type": "inject",
        "z": "6a5b4f7667dd5e93",
        "name": "Open",
        "props": [
            {
                "p": "payload"
            },
            {
                "p": "topic",
                "vt": "str"
            }
        ],
        "repeat": "",
        "crontab": "",
        "once": false,
        "onceDelay": 0.1,
        "topic": "",
        "payload": "true",
        "payloadType": "bool",
        "x": 110,
        "y": 80,
        "wires": [
            [
                "54ad039d5c179adb"
            ]
        ]
    },
    {
        "id": "4e6548fa30e15d75",
        "type": "inject",
        "z": "6a5b4f7667dd5e93",
        "name": "Stop",
        "props": [
            {
                "p": "payload"
            },
            {
                "p": "topic",
                "vt": "str"
            }
        ],
        "repeat": "",
        "crontab": "",
        "once": false,
        "onceDelay": 0.1,
        "topic": "",
        "payload": "true",
        "payloadType": "bool",
        "x": 110,
        "y": 120,
        "wires": [
            [
                "fe89380a84ee2180"
            ]
        ]
    },
    {
        "id": "2a84975211385b32",
        "type": "inject",
        "z": "6a5b4f7667dd5e93",
        "name": "Close",
        "props": [
            {
                "p": "payload"
            },
            {
                "p": "topic",
                "vt": "str"
            }
        ],
        "repeat": "",
        "crontab": "",
        "once": false,
        "onceDelay": 0.1,
        "topic": "",
        "payload": "true",
        "payloadType": "bool",
        "x": 110,
        "y": 160,
        "wires": [
            [
                "bf703ba05b46bd54"
            ]
        ]
    },
    {
        "id": "173b7fc0310f7798",
        "type": "ui_slider",
        "z": "6a5b4f7667dd5e93",
        "name": "sldPosition",
        "label": "Position (%)",
        "tooltip": "",
        "group": "371d8c5139241499",
        "order": 3,
        "width": 0,
        "height": 0,
        "passthru": false,
        "outs": "end",
        "topic": "position",
        "topicType": "str",
        "min": 0,
        "max": "100",
        "step": 1,
        "className": "",
        "x": 510,
        "y": 40,
        "wires": [
            [
                "4a234e775ccbd052"
            ]
        ]
    },
    {
        "id": "1a88b745512d3c2f",
        "type": "tasmota-device",
        "manager": "f940f2077062977f",
        "broker": "5aa6ea16b4019c7c",
        "device": "relais_01",
        "name": "",
        "ip": "",
        "host": "shutter-01",
        "mac": "",
        "version": "0x8020003",
        "module": "6",
        "relais": "0",
        "friendlynames": "Living Room Shutter,Tasmota2,Tasmota3,Tasmota4,Tasmota5,Tasmota6,Tasmota7,Tasmota8",
        "fullTopic": "tasmota/%topic%/%prefix%",
        "cmndPrefix": "cmnd",
        "statPrefix": "stat",
        "telePrefix": "tele",
        "qos": "1"
    },
    {
        "id": "371d8c5139241499",
        "type": "ui_group",
        "name": "Shutter",
        "tab": "192fba4f7dfe1303",
        "order": 3,
        "disp": true,
        "width": "6",
        "collapse": false,
        "className": ""
    },
    {
        "id": "f940f2077062977f",
        "type": "tasmota-manager",
        "dbUri": "http://192.168.1.50/tasmota-db/",
        "name": "home",
        "network": "192.168.1.0/24"
    },
    {
        "id": "5aa6ea16b4019c7c",
        "type": "tasmota-mqtt-broker",
        "name": "home-broker",
        "broker": "192.168.1.5",
        "port": "1883",
        "clientid": "nodered",
        "usetls": false,
        "keepalive": "60",
        "cleansession": true
    },
    {
        "id": "192fba4f7dfe1303",
        "type": "ui_tab",
        "name": "Home",
        "icon": "dashboard",
        "disabled": false,
        "hidden": false
    }
]

[
    {
        "id": "77d5c6af1fe840b4",
        "type": "tab",
        "label": "Demos",
        "disabled": false,
        "info": "",
        "env": []
    },
    {
        "id": "174c17b3de7ab86d",
        "type": "tasmota-config",
        "z": "77d5c6af1fe840b4",
        "manager": "f940f2077062977f",
        "name": "",
        "x": 480,
        "y": 40,
        "wires": [
            [
                "e2d9f1385c172bb7"
            ]
        ]
    },
    {
        "id": "e2d9f1385c172bb7",
        "type": "ui_button",
        "z": "77d5c6af1fe840b4",
        "name": "btnListDevices",
        "group": "2f46a384e76104ab",
        "order": 2,
        "width": "3",
        "height": "1",
        "passthru": true,
        "label": "List Devices",
        "tooltip": "",
        "color": "",
        "bgcolor": "",
        "className": "",
        "icon": "",
        "payload": "",
        "payloadType": "str",
        "topic": "listDevices",
        "topicType": "str",
        "x": 280,
        "y": 120,
        "wires": [
            [
                "6cce4cdb225f4a84"
            ]
        ]
    },
    {
        "id": "dc56ad3bc5b7d983",
        "type": "inject",
        "z": "77d5c6af1fe840b4",
        "name": "",
        "props": [
            {
                "p": "payload"
            },
            {
                "p": "topic",
                "vt": "str"
            }
        ],
        "repeat": "",
        "crontab": "",
        "once": false,
        "onceDelay": 0.1,
        "topic": "",
        "payload": "",
        "payloadType": "date",
        "x": 100,
        "y": 120,
        "wires": [
            [
                "e2d9f1385c172bb7"
            ]
        ]
    },
    {
        "id": "316a1f7181cb2b78",
        "type": "ui_button",
        "z": "77d5c6af1fe840b4",
        "name": "btnScanNetwork",
        "group": "2f46a384e76104ab",
        "order": 1,
        "width": "3",
        "height": "1",
        "passthru": true,
        "label": "Scan Network",
        "tooltip": "",
        "color": "",
        "bgcolor": "",
        "className": "",
        "icon": "",
        "payload": "",
        "payloadType": "str",
        "topic": "scanNetwork",
        "topicType": "str",
        "x": 280,
        "y": 40,
        "wires": [
            [
                "174c17b3de7ab86d"
            ]
        ]
    },
    {
        "id": "c7f3b9d36c15552c",
        "type": "inject",
        "z": "77d5c6af1fe840b4",
        "name": "",
        "props": [
            {
                "p": "payload"
            },
            {
                "p": "topic",
                "vt": "str"
            }
        ],
        "repeat": "",
        "crontab": "",
        "once": false,
        "onceDelay": 0.1,
        "topic": "",
        "payload": "",
        "payloadType": "date",
        "x": 100,
        "y": 40,
        "wires": [
            [
                "316a1f7181cb2b78"
            ]
        ]
    },
    {
        "id": "6cce4cdb225f4a84",
        "type": "tasmota-config",
        "z": "77d5c6af1fe840b4",
        "manager": "f940f2077062977f",
        "name": "",
        "x": 480,
        "y": 120,
        "wires": [
            [
                "8f0f28a299bc0c1a"
            ]
        ]
    },
    {
        "id": "9c86b2f7206d318c",
        "type": "ui_dropdown",
        "z": "77d5c6af1fe840b4",
        "name": "listDevices",
        "label": "Devices",
        "tooltip": "",
        "place": "Select option",
        "group": "2f46a384e76104ab",
        "order": 3,
        "width": 0,
        "height": 0,
        "passthru": true,
        "multiple": false,
        "options": [
            {
                "label": "",
                "value": "",
                "type": "str"
            }
        ],
        "payload": "",
        "topic": "topic",
        "topicType": "msg",
        "className": "",
        "x": 270,
        "y": 180,
        "wires": [
            [
                "1a648cda449ab9e2"
            ]
        ]
    },
    {
        "id": "8f0f28a299bc0c1a",
        "type": "change",
        "z": "77d5c6af1fe840b4",
        "name": "selectDevice",
        "rules": [
            {
                "t": "set",
                "p": "options",
                "pt": "msg",
                "to": "payload",
                "tot": "msg"
            },
            {
                "t": "set",
                "p": "payload",
                "pt": "msg",
                "to": "selectedDevice",
                "tot": "flow"
            }
        ],
        "action": "",
        "property": "",
        "from": "",
        "to": "",
        "reg": false,
        "x": 650,
        "y": 120,
        "wires": [
            [
                "9c86b2f7206d318c"
            ]
        ]
    },
    {
        "id": "1a648cda449ab9e2",
        "type": "change",
        "z": "77d5c6af1fe840b4",
        "name": "saveSelectedDevice",
        "rules": [
            {
                "t": "set",
                "p": "selectedDevice",
                "pt": "flow",
                "to": "payload",
                "tot": "msg"
            }
        ],
        "action": "",
        "property": "",
        "from": "",
        "to": "",
        "reg": false,
        "x": 520,
        "y": 180,
        "wires": [
            []
        ]
    },
    {
        "id": "72723dcceee41964",
        "type": "ui_button",
        "z": "77d5c6af1fe840b4",
        "name": "btnHttpStatus",
        "group": "2f46a384e76104ab",
        "order": 4,
        "width": "3",
        "height": "1",
        "passthru": true,
        "label": "GetStatus",
        "tooltip": "",
        "color": "",
        "bgcolor": "",
        "className": "",
        "icon": "",
        "payload": "",
        "payloadType": "str",
        "topic": "Status",
        "topicType": "str",
        "x": 280,
        "y": 260,
        "wires": [
            [
                "f2ae1cfd81260ed5"
            ]
        ]
    },
    {
        "id": "36673f844c6a0dde",
        "type": "inject",
        "z": "77d5c6af1fe840b4",
        "name": "",
        "props": [
            {
                "p": "payload"
            },
            {
                "p": "topic",
                "vt": "str"
            }
        ],
        "repeat": "",
        "crontab": "",
        "once": false,
        "onceDelay": 0.1,
        "topic": "",
        "payload": "",
        "payloadType": "date",
        "x": 100,
        "y": 260,
        "wires": [
            [
                "72723dcceee41964"
            ]
        ]
    },
    {
        "id": "f2ae1cfd81260ed5",
        "type": "change",
        "z": "77d5c6af1fe840b4",
        "name": "selectDevice",
        "rules": [
            {
                "t": "set",
                "p": "action",
                "pt": "msg",
                "to": "httpCommand",
                "tot": "str"
            },
            {
                "t": "set",
                "p": "ip",
                "pt": "msg",
                "to": "selectedDevice",
                "tot": "flow"
            }
        ],
        "action": "",
        "property": "",
        "from": "",
        "to": "",
        "reg": false,
        "x": 490,
        "y": 260,
        "wires": [
            [
                "30cb09640e5e9604"
            ]
        ]
    },
    {
        "id": "30cb09640e5e9604",
        "type": "tasmota-config",
        "z": "77d5c6af1fe840b4",
        "manager": "f940f2077062977f",
        "name": "",
        "x": 680,
        "y": 260,
        "wires": [
            [
                "9233e13b42e92bdb"
            ]
        ]
    },
    {
        "id": "9233e13b42e92bdb",
        "type": "ui_text",
        "z": "77d5c6af1fe840b4",
        "group": "2f46a384e76104ab",
        "order": 5,
        "width": 0,
        "height": 0,
        "name": "txtFriendlyName",
        "label": "FriendlyName",
        "format": "{{msg.payload.Status.FriendlyName[0]}}",
        "layout": "row-spread",
        "className": "",
        "x": 280,
        "y": 320,
        "wires": []
    },
    {
        "id": "f940f2077062977f",
        "type": "tasmota-manager",
        "dbUri": "",
        "name": "home",
        "network": "192.168.1.0/24"
    },
    {
        "id": "2f46a384e76104ab",
        "type": "ui_group",
        "name": "Control",
        "tab": "192fba4f7dfe1303",
        "order": 1,
        "disp": true,
        "width": "6",
        "collapse": false,
        "className": ""
    },
    {
        "id": "192fba4f7dfe1303",
        "type": "ui_tab",
        "name": "Home",
        "icon": "dashboard",
        "disabled": false,
        "hidden": false
    }
]

Both examples use node-red-dashboard (ui_* nodes) for their UI controls.

Roadmap

• Per-node configuration reference (all fields explained)
• More usage examples beyond the two flows above

Changelog

See CHANGELOG.md.

Disclaimer

The software is provided as-is under the MIT license. The author cannot be held responsible for any unintended behaviours.

Thanks

If you like our ideas and want to support further development, you can donate here: