Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hongtat/tasmota-connect

Add your Tasmota devices as SmartThings devices
https://github.com/hongtat/tasmota-connect

automation home-automation samsung smart-home smartlife smartthings sonoff tasmota tuya

Last synced: 10 days ago
JSON representation

Add your Tasmota devices as SmartThings devices

Awesome Lists containing this project

README 

        
-----



# NO LONGER SUPPORTED



Following the announcement of [The End of the SmartThings platform built on Grovvy](https://community.smartthings.com/t/the-end-of-groovy-has-arrived/246280), Tasmota (Connect) will no longer be supported and may not work after September 30, 2022, at 00:00 (PST).



-----



**Please migrate your devices to [Tasmota Edge](https://community.smartthings.com/t/st-edge-tasmota-edge-for-sonoff-tuya-many-other-esp-wifi-devices-over-2000-tasmota-supported-devices/241493).**



**Tasmota Edge utilizes the latest SmartThings Edge platform technology.**



Please see this [SmartThings Community - Tasmota Edge topic](https://community.smartthings.com/t/st-edge-tasmota-edge-for-sonoff-tuya-many-other-esp-wifi-devices-over-2000-tasmota-supported-devices/241493) for more information.



-----



..



### Tasmota (Connect)

Tasmota (Connect) is a SmartApp & Device Type for [Samsung SmartThings](https://www.smartthings.com/), that allows you to add your [Tasmota](https://github.com/arendst/Tasmota) devices as SmartThings devices.



See [SmartThings Community](https://community.smartthings.com/t/release-tasmota-connect-pure-tasmota-st-integration-real-time-status-for-sonoff-tuya-smartlife-other-esp8266-devices/187553) for feedback, questions and troubleshooting.



[![GitHub stars](https://img.shields.io/github/stars/hongtat/tasmota-connect?style=for-the-badge)](https://github.com/hongtat/tasmota-connect/stargazers)

[![GitHub forks](https://img.shields.io/github/forks/hongtat/tasmota-connect?style=for-the-badge)](https://github.com/hongtat/tasmota-connect/network)

[![GitHub license](https://img.shields.io/github/license/hongtat/tasmota-connect?style=for-the-badge)](https://github.com/hongtat/tasmota-connect/blob/master/LICENSE)



## Features

* Full support for [SmartThings (new) App](https://play.google.com/store/apps/details?id=com.samsung.android.oneconnect) 

* Real-time device status

* Pure Tasmota & SmartThings integration (No need for additional MQTT bridge)

* Virtual Device (for RF / IR devices that can be controlled by a RF / IR bridge) 



## Requirement

* Samsung SmartThings Hub v2 or v3

* Official [Tasmota](https://github.com/arendst/Tasmota/releases) Firmware >=8.10



#### Tasmota Firmware



Firmware | Description

---- | ----

**tasmota.bin** | The Tasmota version with most drivers. **RECOMMENDED RELEASE BINARY**

**tasmota-sensors.bin** | The Sensors version adds more useful sensors.

**tasmota-ir** | The InfraRed Receiver and transmitter version allowing all available protocols provided by library IRremoteESP8266 but without most other features. **RECOMMENDED firmware for IR Bridge**



## Installation



Follow the instruction below, and update the SmartApp and Device Handlers codes regularly to receive the latest features.



#### GitHub Install

1. If you haven’t enabled GitHub integration, please visit here for [instructions](https://docs.smartthings.com/en/latest/tools-and-ide/github-integration.html).

2. Sign in to SmartThings IDE: https://account.smartthings.com/login

3. Under `My SmartApps` > click `Settings` > `Add new repository` > enter the following:

   * Owner: **hongtat**

   * Name: **tasmota-connect**

   * Branch: **master**

4. Under `Update from Repo` > click `tasmota-connect` > Select all files > Tick `Publish` > then `Execute Update`

5. Under `My Device Handlers` > click `Settings` > `Add new repository` > enter the following:

   * Owner: **hongtat**

   * Name: **tasmota-connect**

   * Branch: **master**

6. Under `Update from Repo` > click `tasmota-connect` > Select all files > Tick `Publish` > then `Execute Update`

7. Open your SmartThings mobile app

8. Add Tasmota (Connect) SmartApp

   * (New) Go to: `SmartApps` > `+` > `My SmartApps` > `Tasmota (Connect)`

   * (Classic) Go to: `Automation` > `SmartApps` > `Add a SmartApp` > `My Apps` > `Tasmota (Connect)`

9. For SmartApp and Device Handler updates,

   1. Sign in to SmartThings IDE: https://account.smartthings.com/login

   2. Under `My SmartApps` > `Update from Repo` > click `tasmota-connect` > Select all files > Tick `Publish` > then `Execute Update`

   3. Under `My Device Handlers` > `Update from Repo` > click `tasmota-connect` > Select all files > Tick `Publish` > then `Execute Update`



#### Manual Installation

For Tasmota (Connect) to function correctly, please make sure you install the SmartApp and all Device Handlers.



1. Sign in to SmartThings IDE: https://account.smartthings.com/login

2. SmartApp Installation

   1. Under `My SmartApps` > choose `New SmartApp` > `From Code`

   2. Paste the SmartApp code [[link](https://github.com/hongtat/tasmota-connect/blob/master/smartapps/hongtat/tasmota-connect.src/tasmota-connect.groovy)] into the text box

   3. Click "***Save***" and "***Publish***" it to yourself.

3. Device Handler Installation

   1. Click on this [[link](https://github.com/hongtat/tasmota-connect/tree/master/devicetypes/hongtat)] to obtain the device handlers. For each of the device handlers, do the following:

   2. Under `My Device Handlers` > choose `Create New Device Handler` > `From Code`

   3. Paste the device code into the text box

   4. Click "***Save***" and "***Publish***" it to yourself.

4. For SmartApp and Device Handler updates, perform the same steps in manual installation.   



## Adding your Tasmota devices

1. Open your SmartThings mobile app

2. Under `SmartApps`, select `Tasmota (Connect)`

3. Tap `New Tasmota Device`, and select the Tasmota device you want to add

4. Fill in the `IP address`, `username` (optional), `password` (optional) of the Tasmota device



## Supported Tasmota Devices



It should work for most switches, lights (CCT, RGB, RGBW), dimmers, relays, plugs, power strips, sockets, wall outlets, fan controllers, RF motion/contact sensors, RF remote controllers, IR bridges and RF bridges listed in the [Tasmota Device Templates Repository](https://templates.blakadder.com/).



If your Tasmota device is not listed below, choose a **Generic** device that is similar to your Tasmota device.



* **Generic Switch** (1,2,3,4,5,6,7,8CH) - No Power Monitoring

* **Generic Metering Switch** (1,2,3,4,5,6,7,8CH) - Power Monitoring

* **Generic Dimmer Switch**

* **Generic IR Bridge**

* **Generic Light (CT)**

* **Generic Light (RGB)**

* **Generic Light (RGBW)**

* Sonoff Basic

* Sonoff RF

* Sonoff TH

* Sonoff Dual & Dual R2

* Sonoff Pow & Pow R2

* Sonoff 4CH & 4CH Pro

* Sonoff S20, S26

* Sonoff S31

* Sonoff Touch, T1 (1,2,3CH)

* Sonoff RF Bridge

* Sonoff iFan02, iFan03



## Virtual Device

A Virtual Device uses a RF or IR bridge to control or read your dumb RF / IR devices.



Virtual Device | Usage

---- | ----

Virtual Switch          | Add a SmartThings generic switch that can be controlled by a RF / IR bridge (e.g. Sonoff RF Bridge).

Virtual Shade           | Add a SmartThings shade/blind that can be controlled by a RF / IR bridge (e.g. Sonoff RF Bridge).

Virtual Button          | Add RF/IR remote controller 1/2/4/6-button as SmartThings remote controller button.

The **Virtual 1-button** has additional capabilities: 
    

  • Push/Momentary Capability
    • 

  • Motion Sensor Capability (useful for Alexa)
    • 



Virtual Contact Sensor  | Add a RF contact sensor

Virtual Motion Sensor   | Add a RF motion sensor

Virtual Air Conditioner | Add a IR virtual air conditioner ([supported AC vendor/brands](https://tasmota.github.io/docs/Tasmota-IR/#sending-irhvac-commands)) 

(optional) Use a contact sensor to sense if the AC is ON or OFF.



#### Configuring a Virtual Switch

1. Choose a RF or IR Bridge

2. Enter the Tasmota command to send for "ON" and "OFF"

      

      For RF, it has to be one of these formats

      

      * `Backlog RfSync ; RfLow ; RfHigh ; RfCode `      

      * `Backlog RfRaw ; RfRaw 0`

         > Note: RFRaw requires [Portisch Firmware](https://github.com/Portisch/RF-Bridge-EFM8BB1)

     

3. Optionally, enable `State tracking` to listen for RF codes (e.g. from RF remote) to simulate a Stateful device

4. If you enable `State tracking`, enter the code that represents the "ON" and "OFF" state

       

   In the example below, the code is **70C70F**

   

   * "RfReceived":{"Sync":7110,"Low":210,"High":660,"Data":"**70C70F**","RfKey":"None"}



#### Configuring a Virtual Contact / Motion Sensor / Button

1. Choose a RF Bridge

2. Enter the RFReceived Data that represents "OPEN", "CLOSE", "ACTIVE", "INACTIVE" or button state

             

   In the example below, the code is **70C70F**

   

   * "RfReceived":{"Sync":7110,"Low":210,"High":660,"Data":"**70C70F**","RfKey":"None"}



#### Configuring a Virtual Air Conditioner

1. Choose an IR Bridge

2. Select air conditioner brand ([supported AC vendor/brands](https://tasmota.github.io/docs/Tasmota-IR/#sending-irhvac-commands))

3. (Optional) Select a contact sensor to sense if the AC is ON or OFF



## FAQ



#### My Tasmota device is not responding?

* Verify the IP address is correct and you are able to access your device via the IP address.

* If you have added this device using other developer device type handler (DTH), please delete the device.

* If the device is still not responding, look at the Tasmota Console so that you can see exactly what is happening. e.g. The actions (on/off) that you've called in SmartThings App didn't appear in the Console, it's likely the SmartThings hub is unable to access the device.

* Ensure your Tasmota devices and SmartThings hub are assigned with static IP addresses.



####  Where can I find out more about Tasmota command for sending/receiving IR / RF codes?

Please see under RF Bridge & IR Remote - https://tasmota.github.io/docs/Commands/



#### The Tasmota (Connect) SmartApp is not showing up in SmartThings App?

* Sign in to SmartThings IDE: https://account.smartthings.com/login 

* Verify that you have installed the codes in the correct SmartThings IDE Shard.

* If you don't see your current devices under "My Devices", you are probably on the wrong shard.



#### I'm unable to find the recently released features (or missing features or devices) in my SmartApp?

* Please make sure you install the SmartApp and all Device Handlers, and update the codes regularly to receive the latest features



#### I created a generic/metering switch with 2 (or more) channels, but it shows only 1 switch?

* Please make sure you install the SmartApp and all Device Handlers, and update the codes regularly to receive the latest features



#### I have feedback, questions, suggestion..

Please use [SmartThings Community](https://community.smartthings.com/t/release-tasmota-connect-pure-tasmota-st-integration-real-time-status-for-sonoff-tuya-smartlife-other-esp8266-devices/187553) for feedback and questions.



## Support Us



If you find Tasmota (Connect) SmartApp useful and would like to support our efforts, please consider [_**making a donation via Paypal**_](https://paypal.me/hongtat79/5usd).

Thanks for your support.



## License

GPL-3.0