Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

homebridge-tasmota-control

grzegorz9141.9kMIT1.3.3

Homebridge plugin to control Tasmota flashed devices.

homebridge, homebridge-plugin, homekit, tasmota, hvac

readme

Homebridge Tasmota Control

verified-by-homebridge npm npm npm GitHub pull requests GitHub issues

Homebridge plugin for Tasmota flashed devices.

Package Requirements

Package Installation Role Required
Homebridge Homebridge Wiki HomeKit Bridge Required
Config UI X Config UI X Wiki Homebridge Web User Interface Recommended
Tasmota Control Plug-In Wiki Homebridge Plug-In Required

About The Plugin

  • Plugin work with Tasmota v6.0.0 and abowe.

  • Support Mitsubishi HVAC:

  • Precompiled ESP firmware for MiElHVAC are in firmware folder.

  • If You need firmware for specific ESP please go to Firmware for MiElHVAC and meke request.

    • Heater Cooler:
      • Power ON/OFF.
      • Operating mode AUTO/HEAT/COOL.
      • Temperature HEATING/COOLING/AUTO.
      • Fan speed OFF/QUIET/1/2/3/4/AUTO.
      • Swing mode AUTO/SWING.
      • Physical lock controls LOCK/UNLOCK.
      • Temperature display unit °F/°C.
    • Buttons:
      • For direct device control.
        • Power ON/OFF.
        • Operating mode HEAT/DRY/COOL/FAN/AUTO.
        • Fan speed OFF/QUIET/1/2/3/4/AUTO.
        • Vane H LEFT/LEFT MIDDLE/CENTER/RIGHT MIDDLE/RIGHT/SPLIT/SWING.
        • Vane V AUTO/UP/UP MIDDLE/CENTER/DOWN MIDDLE/DOWN/SWING.
        • Air direction INDIRECT/DIRECT/EVEN.
        • Prohibit POWER/MODE/TEMPERATURE/ALL.
        • Physical lock controls LOCK/UNLOCK.
        • Presets SET/UNSET.
    • Sensors:
      • For automation and notifications.
        • State sensors:
          • Power ON/OFF.
          • Operating mode HEAT/DRY/COOL/FAN/AUTO.
          • Fan speed OFF/QUIET/1/2/3/4/AUTO.
          • Vane H AUTO/1/2/3/4/5/SPLIT/SWING.
          • Vane V AUTO/1/2/3/4/5/SWING.
          • Air direction INDIRECT/DIRECT/EVEN.
          • Physical lock controls LOCK/UNLOCK.
          • Presets ACTIV/UNACTIV.
          • Operation stage NORMAL/DEFROST/PREHEAT/STANDBY.
          • Fan stage OFF/QUIET/1/2/3/4/5.
          • Mode stage AUTO OFF/AUTO FAN/AUTO HEAT/AUTO COOL.
          • Remote temperature.
        • Temperature sensors:
          • Room temperature.
          • Outdoor temperature.
    • Functions:
      • Frost protect

  • Supported relay devices:

    • Light - Power ON/OFF, Dimmer, Color Temperature, Hue, Saturation
    • Outlet - Power ON/OFF
    • Switch - Power ON/OFF

  • Supported Sensors:

    • Temperature - Temperature, Dew Point, Reference, Obj, Amb
    • Humidity
    • Carbon Dioxyde
    • Ambient Light
    • Motion

Configuration

  • Run this plugin as a Child Bridge (Highly Recommended), this prevent crash Homebridge if plugin crashes.
  • Install and use Homebridge Config UI X to configure this plugin (Highly Recommended).
  • The sample-config.json can be used as an alternative, make a backup copy before making any changes.

Key Description
name Here set the accessory Name to be displayed in Homebridge/HomeKit.
host Here set the Hsostname or Address IP of the Device.
auth If enabled, authorizatins credentials will be used for login.
user Here set the authorization Username.
passwd Here set the authorization Password.
disableAccessory If enabled, the accessory will be disabled.
miElHvac.heatDryFanMode Here select the operatiing mode for Heat, only for Mitsubishio AC.
miElHvac.coolDryFanMode Here select the operatiing mode for Cool, only for Mitsubishio AC.
miElHvac.autoDryFanMode Here select the operatiing mode for Auto, only for Mitsubishio AC.
miElHvac.temperatureSensor This enable extra Room temperature sensor to use with automations in HomeKit app.
miElHvac.temperatureSensorOutdoor This enable extra Outdoor temperature sensor to use with automations in HomeKit app.
miElHvac.remoteTemperatureSensor Object of remote temperature sensor.
miElHvac.remoteTemperatureSensor.enable This activate the function.
miElHvac.remoteTemperatureSensor.path Here set the path to the temperature sensor, the request need to return value.
miElHvac.remoteTemperatureSensor.refreshInterval Here set remote sensor refresh interval.
miElHvac.remoteTemperatureSensor.auth If enabled, authorizatins credentials will be used for remote sensor.
miElHvac.remoteTemperatureSensor.user Here set the authorization Username.
miElHvac.remoteTemperatureSensor.passwd Here set the authorization Password.
miElHvac.presets Array of presets sensors.
miElHvac.presets.name Here You can schange the Preset Name which is exposed to the Homebridge/HomeKit.
miElHvac.presets.mode Here set the operation mode.
miElHvac.presets.setTemp Here set the target temperature.
miElHvac.presets.fanSpeed Here set the fan speed.
miElHvac.presets.swingV Here set the vane vertical direction.
miElHvac.presets.swingH Here set the vane horizontal direction.
miElHvac.presets.displayType Here select display type in HomeKit, 0 - None/Disabled, 1 - Outlet, 2 - Switch, 3 - Motion Sensor, 4 - Occupancy Sensor, 5 - Contact Sensor.
miElHvac.buttons Array of buttons sensors.
miElHvac.buttons.name Here set Button Name which You want expose to the Homebridge/HomeKit.
miElHvac.buttons.mode Here select button function mode.
miElHvac.buttons.displayType Here select display type in HomeKit, 0 - None/Disabled, 1 - Outlet, 2 - Switch, 3 - Motion Sensor.
miElHvac.buttons.namePrefix Here enable/disable the accessory name as a prefix for button name.
miElHvac.sensors Array of sensors sensors.
miElHvac.sensors.name Here set Sensor Name which You want expose to the Homebridge/HomeKit.
miElHvac.sensors.mode Here select sensor function mode.
miElHvac.sensors.displayType Here select display type in HomeKit, 0 - None/Disabled, 1 - Motion Sensor, 2 - Occupancy Sensor, 3 - Contact Sensor.
miElHvac.sensors.namePrefix Here enable/disable the accessory name as a prefix for sensor name.
miElHvac.frostProtect Object of frost protect function.
miElHvac.frostProtect.enable This activate frost protect function.
miElHvac.frostProtect.lowTemp Here set the low temperature at which device start to frost protect.
miElHvac.frostProtect.highTemp Here set the high temperature at which device start to frost protect.
relaysNamePrefix Here enable/disable the accessory name as a prefix for relays name.
relaysDisplayType Here select characteristic display type for relays which are exposed in the HomeKit app.
lightsNamePrefix Here enable/disable the accessory name as a prefix for lights name.
sensorsNamePrefix Here enable/disable the accessory name as a prefix for sensors name.
loadNameFromDevice If enabled, the accessory name will be loaded direct from device.
refreshInterval Here set the data refresh time in (sec).
disableLogDeviceInfo If enabled, add ability to disable log device info by every connections device to the network.
disableLogInfo If enabled, disable log info, all values and state will not be displayed in Homebridge log console.
disableLogSuccess If enabled, disable logging device success.
disableLogWarn If enabled, disable logging device warnings.
disableLogError If enabled, disable logging device error.
enableDebugMode If enabled, deep log will be present in homebridge console.

changelog

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.3.0] - (13.03.2025)

Changes

  • added possibility to disable indyvidual accessory
  • bump dependencies
  • config schema updated
  • redme updated
  • cleanup

[1.2.2] - (07.02.2025)

Changes

  • stability and improvements

[1.2.0] - (31.01.2025)

Changes

  • added possibility to disable/enable log success, info, warn, error
  • bump dependencies
  • config schema updated
  • redme updated
  • cleanup

[1.1.8] - (05.01.2025)

Changes

  • fix HSB Color control
  • cleanup

[1.1.4] - (02.01.2025)

Changes

  • fix #19
  • code refactor
  • other small fixes
  • bump dependencies
  • cleanup

[1.1.0] - (30.11.2024)

Changes

  • move from commonJS to esm module
  • moved constants.json to constants.js
  • cleanup

[1.0.0] - (04.11.2024)

Changes

  • compatibility with Tasmota build from 04.11.2024
  • removed buttonsSensors config properties for MiElHVAC
  • added buttons array in config.json for MiElHVAC
  • added sensors array in config.json for MiElHVAC
  • added remote temperature sensor state to sensors for MiElHVAC
  • added operation stage to sensors for MiElHVAC
  • added fan stage to sensors for MiElHVAC
  • added mode stage to sensors for MiElHVAC
  • config.schema update
  • redme update
  • cleanup

[0.20.0] - (03.11.2024)

Changes

  • added remote temperature sensor to use as a external sensor for MiElHVAC
  • config.schema update
  • cleanup

[0.19.0] - (28.10.2024)

Changes

  • added remote temperature sensor state
  • config.schema update
  • cleanup

[0.18.1] - (24.10.2024)

Changes

  • added compresor frequency properties for MiElHVAC
  • fix config schema validation in upcomming Config UI X update
  • config.schema update
  • cleanup

[0.18.0] - (16.10.2024)

Changes

  • added frost protect function for MiElHVAC
  • config.schema update
  • redme update
  • cleanup

[0.17.0] - (14.10.2024)

Changes

  • compatibility with tasmota firmware build 14.10.2024
  • add AUTO function to vane horizontal
  • config.schema update
  • redme update
  • cleanup

[0.16.0] - (10.10.2024)

Changes

  • add prohibit functions (power, mode, temperature, all)
  • config.schema update
  • redme update
  • cleanup

[0.15.0] - (06.10.2024)

Changes

  • add buttons, sensors and presets to Mitsubishi AC device (MiElHVAC)
  • config.schema update
  • redme update
  • cleanup

[0.14.0] - (05.10.2024)

Changes

  • add categories for accessory to homekit (required remove and add accessory again, only one time)
  • fix #17
  • redme update
  • cleanup

[0.13.0] - (04.10.2024)

Changes

  • add room and outdoor temperature sensors services for MiElHVAC
  • config.schema update
  • redme update
  • cleanup

[0.12.0] - (04.10.2024)

Changes

  • add full support to control Mitsubishi AC devices, (MiElHVAC)
  • cleanup
  • config.schema update
  • redme update

[0.11.0] - (22.09.2024)

Changes

  • stability and performance improvements
  • logging refactor
  • cleanup

[0.10.36] - (14.08.2024)

Changes

  • hide passwords by typing and display in Config UI
  • remove return duplicate promises from whole code
  • bump dependencies
  • config schema updated
  • cleanup

[0.10.0] - (04.02.2024)

Changes

  • add support for PIR Motion Sensors
  • cleanup

[0.9.0] - (04.02.2024)

Changes

  • add support for Light - On/Off, Brightness, Color Temperature, Hue, Saturation
  • add possibility to disable/enable name prefix for relays, ligts, sensors
  • config schema updated
  • cleanup

[0.8.0] - (03.02.2024)

Changes

  • add support for Ambient Light and Carbon Dioxyde Sensors
  • cleanup

[0.7.0] - (03.02.2024)

Changes

  • add support for DS18x20 sensors
  • cleanup

[0.6.0] - (03.02.2024)

Changes

  • add support for Tasmota Sensors (Temperature, Humidity, DewPoint)
  • bump dependencies
  • cleanup

[0.5.0] - (01.02.2024)

Changes

  • add support for Tasmota FW. <= 12.1.1, thanks @xrayone912, #5
  • bump dependencies
  • cleanup

[0.4.13] - (31.12.2022)

Changes

  • bump dependencies

[0.4.12] - (06.12.2022)

Changes

  • update dependencies

[0.4.11] - (02.11.2022)

Changes

  • update dependencies

[0.4.10] - (25.08.2022)

Changes

  • added possibility to display log device info on every restart
  • config schema updated

[0.4.7] - (23.08.2022)

Changes

  • added display channel name instead device name

[0.4.6] - (12.08.2022)

Changes

  • finally fixed report wrong device state #4

[0.4.5] - (10.08.2022)

Changes

  • fix report wrong device state #4
  • code and logs refactor
  • add additional check configured host in config
  • update config schema

[0.4.4] - (23.07.2022)

Changes

  • refactor information service

[0.4.2] - (25.04.2022)

Changes

  • update dependencies

[0.4.1] - (08.04.2022)

Changes

  • update dependencies

[0.4.0] - (25.02.2022)

Added

  • automatically check channels count

Changes

  • removed channelsCount properties from config.json

[0.3.47] - (18.01.2022)

Changes

  • update dependencies

[0.3.46] - (17.01.2022)

Changes

  • update dependencies

[0.3.45] - (29.12.2021)

Changs

  • prepare directory and files synchronously

[0.3.44] - (28.12.2021)

Changs

  • update node minimum requirements

[0.3.43] - (28.12.2021)

Changs

  • code cleanup

[0.3.42] - (26.12.2021)

Changs

  • code cleanup

[0.3.41] - (25.12.2021)

Changs

  • catch error if happened on set state

[0.3.39] - (25.12.2021)

Changs

  • update config.schema

[0.3.38] - (24.12.2021)

Changs

  • initial release