Tasmota Device Management

Overview

Automated discovery and control of Tasmota-powered smart home devices (ESP8266/ESP32) on local networks. Includes network scanning, status monitoring, power control, dimming, color control, and inventory management.

Quick Start

Scan network for Tasmota devices:

python3 scripts/tasmota-discovery.py

Check device status:

python3 scripts/tasmota-control.py <IP> status 0

Control device:

python3 scripts/tasmota-control.py <IP> power on|off|toggle
python3 scripts/tasmota-control.py <IP> brightness 0-100
python3 scripts/tasmota-control.py <IP> color <hex-rgb>

Discovery

Network Scan

Run a full network scan to find all Tasmota devices:

python3 scripts/tasmota-discovery.py

The script: 1. Performs ping sweep to identify live hosts 2. Scans HTTP (port 80) on live hosts 3. Detects Tasmota via Server header (e.g., "Tasmota/13.1.0") 4. Confirms via JSON API (/cm?cmnd=status%200) 5. Retrieves device names, versions, and hardware

Output includes: - IP address - Device friendly name - Tasmota version - Hardware platform (ESP8266/ESP32) - Response time

Identification Signals

Tasmota devices are identified by: - Server header: Tasmota/<version> (<hardware>) - JSON API response: /cm?cmnd=status%200 returns structured status - Content keywords: "Tasmota" in HTML

Device Control

Power Control

Toggle or set power state:

# Toggle
python3 scripts/tasmota-control.py <IP> power toggle

# On/Off
python3 scripts/tasmota-control.py <IP> power on
python3 scripts/tasmota-control.py <IP> power off

Brightness (Dimmers)

Set brightness level (0-100):

python3 scripts/tasmota-control.py <IP> brightness 50

Works on devices with Dimmer support (check StatusSTS).

Color (RGB Lights)

Set RGB color (hex or comma-separated):

# Hex format
python3 scripts/tasmota-control.py <IP> color FF0000  # Red
python3 scripts/tasmota-control.py <IP> color 00FF00  # Green

# RGB comma format
python3 scripts/tasmota-control.py <IP> color 255,0,0

Works on devices with RGB support (AiYaTo-RGBCW, etc.).

Status Queries

Device Status

Retrieve status information:

# Basic status
python3 scripts/tasmota-control.py <IP> status 0

# All statuses
python3 scripts/tasmota-control.py <IP> status all

Status codes: - 0 = Status - Device info, friendly name, power state - 1 = StatusPRM - Parameters, uptime, MAC - 2 = StatusFWR - Firmware version, hardware - 3 = StatusLOG - Log settings - 4 = StatusNET - Network config (IP, gateway, WiFi) - 5 = StatusMQT - MQTT configuration - 9 = StatusTIM - Time, timezone, sunrise/sunset

Key Status Fields

StatusSTS (Status 0): - POWER - Current state (ON/OFF) - Dimmer - Brightness level (0-100) - Wifi.RSSI - Signal strength - Wifi.SSId - Connected WiFi network

StatusNET: - IPAddress - Device IP - Hostname - mDNS hostname - Mac - MAC address

Bulk Operations

Get All Device Status

python3 scripts/tasmota-status.py

Iterates through inventory file and shows power state for all devices.

Managing Inventory

Devices are tracked in a CSV inventory file. Format:

IP Address,Device Name,Version,Hardware,Response Time (ms)
192.168.1.116,Office Hall Light,13.1.0,ESP8266EX,53

After discovery, save output to inventory file for batch operations.

Common Tasks

Finding Labeled Devices

# Scan and grep for specific device names
python3 scripts/tasmota-discovery.py | grep "Kitchen"
python3 scripts/tasmota-discovery.py | grep "Bulb"

Checking All Lights

# Get status of all devices
python3 scripts/tasmota-status.py

Power Cycle a Device

# Off, wait 2s, on
python3 scripts/tasmota-control.py 192.168.1.116 power off
sleep 2
python3 scripts/tasmota-control.py 192.168.1.116 power on

Tasmota API Reference

Command Format

http://<IP>/cm?cmnd=<COMMAND>

Common Commands

Command	Description
Power	Toggle power
Power ON	Turn on
Power OFF	Turn off
Power TOGGLE	Toggle state
Status 0	Device status
Status 4	Network status
Dimmer <0-100>	Set brightness
Color <hex>	Set RGB color
Fade <ON|OFF>	Enable fade effects

Troubleshooting

Device Not Found

• Verify device is on same subnet
• Check device has HTTP server enabled (Webserver 2 in config)
• Ensure device is powered on and connected to WiFi
• Try direct HTTP request: curl http://<IP>/cm?cmnd=Status%200

Timeout Errors

• Device may be power saving (WiFi sleep)
• Network latency or packet loss
• Check device uptime for recent restarts

Unknown Power State

Some devices (BLE gateways, sensors) don't have power control. Check capability in StatusSTS.

Network Configuration

Tasmota devices typically: - Connect on WiFi channel 1-11 - Use DHCP (check StatusNET for current IP) - May respond to mDNS (hostname patterns: tasmota-XXXXXX) - Use HTTP on port 80 (standard)

Best Practices

• Scan during network maintenance windows (avoid peak usage)
• Cache inventory file to avoid repeated scans
• Use device friendly names for easier identification
• Set static IPs for critical devices (via Tasmota web UI or DHCP reservations)
• Group devices by location/function in inventory comments

Resources

scripts/tasmota-discovery.py

Network scanner that finds live hosts and identifies Tasmota devices via HTTP and JSON API.

scripts/tasmota-control.py

Device controller supporting power, brightness, color, and status queries via Tasmota JSON API.

scripts/tasmota-status.py

Bulk status checker that queries all devices in inventory and displays power states.