{"id":13493572,"url":"https://github.com/hongtat/tasmota-connect","last_synced_at":"2025-03-28T12:31:57.847Z","repository":{"id":45915759,"uuid":"242189573","full_name":"hongtat/tasmota-connect","owner":"hongtat","description":"Add your Tasmota devices as SmartThings devices","archived":false,"fork":false,"pushed_at":"2022-08-27T05:42:24.000Z","size":110,"stargazers_count":86,"open_issues_count":8,"forks_count":170,"subscribers_count":21,"default_branch":"master","last_synced_at":"2024-10-31T08:36:22.599Z","etag":null,"topics":["automation","home-automation","samsung","smart-home","smartlife","smartthings","sonoff","tasmota","tuya"],"latest_commit_sha":null,"homepage":"","language":"Groovy","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hongtat.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-02-21T17:02:39.000Z","updated_at":"2024-09-07T16:13:31.000Z","dependencies_parsed_at":"2022-08-30T07:12:49.746Z","dependency_job_id":null,"html_url":"https://github.com/hongtat/tasmota-connect","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hongtat%2Ftasmota-connect","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hongtat%2Ftasmota-connect/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hongtat%2Ftasmota-connect/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hongtat%2Ftasmota-connect/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hongtat","download_url":"https://codeload.github.com/hongtat/tasmota-connect/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246030538,"owners_count":20712395,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","home-automation","samsung","smart-home","smartlife","smartthings","sonoff","tasmota","tuya"],"created_at":"2024-07-31T19:01:16.729Z","updated_at":"2025-03-28T12:31:52.837Z","avatar_url":"https://github.com/hongtat.png","language":"Groovy","funding_links":["https://paypal.me/hongtat79/5usd"],"categories":["Groovy"],"sub_categories":[],"readme":"-----\n\n# NO LONGER SUPPORTED\n\nFollowing 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).\n\n-----\n\n**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).**\n\n**Tasmota Edge utilizes the latest SmartThings Edge platform technology.**\n\nPlease 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.\n\n\n-----\n\n..\n\n### Tasmota (Connect)\nTasmota (Connect) is a SmartApp \u0026 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.\n\nSee [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.\n\n\n[![GitHub stars](https://img.shields.io/github/stars/hongtat/tasmota-connect?style=for-the-badge)](https://github.com/hongtat/tasmota-connect/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/hongtat/tasmota-connect?style=for-the-badge)](https://github.com/hongtat/tasmota-connect/network)\n[![GitHub license](https://img.shields.io/github/license/hongtat/tasmota-connect?style=for-the-badge)](https://github.com/hongtat/tasmota-connect/blob/master/LICENSE)\n\n\n## Features\n* Full support for [SmartThings (new) App](https://play.google.com/store/apps/details?id=com.samsung.android.oneconnect) \n* Real-time device status\n* Pure Tasmota \u0026 SmartThings integration (No need for additional MQTT bridge)\n* Virtual Device (for RF / IR devices that can be controlled by a RF / IR bridge) \n\n## Requirement\n* Samsung SmartThings Hub v2 or v3\n* Official [Tasmota](https://github.com/arendst/Tasmota/releases) Firmware \u003e=8.10\n\n#### Tasmota Firmware\n\nFirmware | Description\n---- | ----\n**tasmota.bin** | The Tasmota version with most drivers. **RECOMMENDED RELEASE BINARY**\n**tasmota-sensors.bin** | The Sensors version adds more useful sensors.\n**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**\n\n## Installation\n\nFollow the instruction below, and update the SmartApp and Device Handlers codes regularly to receive the latest features.\n\n#### GitHub Install\n1. If you haven’t enabled GitHub integration, please visit here for [instructions](https://docs.smartthings.com/en/latest/tools-and-ide/github-integration.html).\n2. Sign in to SmartThings IDE: https://account.smartthings.com/login\n3. Under `My SmartApps` \u003e click `Settings` \u003e `Add new repository` \u003e enter the following:\n   * Owner: **hongtat**\n   * Name: **tasmota-connect**\n   * Branch: **master**\n4. Under `Update from Repo` \u003e click `tasmota-connect` \u003e Select all files \u003e Tick `Publish` \u003e then `Execute Update`\n5. Under `My Device Handlers` \u003e click `Settings` \u003e `Add new repository` \u003e enter the following:\n   * Owner: **hongtat**\n   * Name: **tasmota-connect**\n   * Branch: **master**\n6. Under `Update from Repo` \u003e click `tasmota-connect` \u003e Select all files \u003e Tick `Publish` \u003e then `Execute Update`\n7. Open your SmartThings mobile app\n8. Add Tasmota (Connect) SmartApp\n   * (New) Go to: `SmartApps` \u003e `+` \u003e `My SmartApps` \u003e `Tasmota (Connect)`\n   * (Classic) Go to: `Automation` \u003e `SmartApps` \u003e `Add a SmartApp` \u003e `My Apps` \u003e `Tasmota (Connect)`\n9. For SmartApp and Device Handler updates,\n   1. Sign in to SmartThings IDE: https://account.smartthings.com/login\n   2. Under `My SmartApps` \u003e `Update from Repo` \u003e click `tasmota-connect` \u003e Select all files \u003e Tick `Publish` \u003e then `Execute Update`\n   3. Under `My Device Handlers` \u003e `Update from Repo` \u003e click `tasmota-connect` \u003e Select all files \u003e Tick `Publish` \u003e then `Execute Update`\n\n#### Manual Installation\nFor Tasmota (Connect) to function correctly, please make sure you install the SmartApp and all Device Handlers.\n\n1. Sign in to SmartThings IDE: https://account.smartthings.com/login\n2. SmartApp Installation\n   1. Under `My SmartApps` \u003e choose `New SmartApp` \u003e `From Code`\n   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\n   3. Click \"***Save***\" and \"***Publish***\" it to yourself.\n3. Device Handler Installation\n   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:\n   2. Under `My Device Handlers` \u003e choose `Create New Device Handler` \u003e `From Code`\n   3. Paste the device code into the text box\n   4. Click \"***Save***\" and \"***Publish***\" it to yourself.\n4. For SmartApp and Device Handler updates, perform the same steps in manual installation.   \n\n## Adding your Tasmota devices\n1. Open your SmartThings mobile app\n2. Under `SmartApps`, select `Tasmota (Connect)`\n3. Tap `New Tasmota Device`, and select the Tasmota device you want to add\n4. Fill in the `IP address`, `username` (optional), `password` (optional) of the Tasmota device\n\n\n## Supported Tasmota Devices\n\nIt 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/).\n\nIf your Tasmota device is not listed below, choose a **Generic** device that is similar to your Tasmota device.\n\n* **Generic Switch** (1,2,3,4,5,6,7,8CH) - No Power Monitoring\n* **Generic Metering Switch** (1,2,3,4,5,6,7,8CH) - Power Monitoring\n* **Generic Dimmer Switch**\n* **Generic IR Bridge**\n* **Generic Light (CT)**\n* **Generic Light (RGB)**\n* **Generic Light (RGBW)**\n* Sonoff Basic\n* Sonoff RF\n* Sonoff TH\n* Sonoff Dual \u0026 Dual R2\n* Sonoff Pow \u0026 Pow R2\n* Sonoff 4CH \u0026 4CH Pro\n* Sonoff S20, S26\n* Sonoff S31\n* Sonoff Touch, T1 (1,2,3CH)\n* Sonoff RF Bridge\n* Sonoff iFan02, iFan03\n\n## Virtual Device\nA Virtual Device uses a RF or IR bridge to control or read your dumb RF / IR devices.\n\nVirtual Device | Usage\n---- | ----\nVirtual Switch          | Add a SmartThings generic switch that can be controlled by a RF / IR bridge (e.g. Sonoff RF Bridge).\nVirtual Shade           | Add a SmartThings shade/blind that can be controlled by a RF / IR bridge (e.g. Sonoff RF Bridge).\nVirtual Button          | Add RF/IR remote controller 1/2/4/6-button as SmartThings remote controller button.\u003cbr\u003e\u003cbr\u003eThe **Virtual 1-button** has additional capabilities: \u003cul\u003e\u003cli\u003ePush/Momentary Capability\u003c/li\u003e\u003cli\u003eMotion Sensor Capability (useful for Alexa)\u003c/li\u003e\u003c/ul\u003e\nVirtual Contact Sensor  | Add a RF contact sensor\nVirtual Motion Sensor   | Add a RF motion sensor\nVirtual Air Conditioner | Add a IR virtual air conditioner ([supported AC vendor/brands](https://tasmota.github.io/docs/Tasmota-IR/#sending-irhvac-commands)) \u003cbr\u003e\u003cbr\u003e(optional) Use a contact sensor to sense if the AC is ON or OFF.\n\n#### Configuring a Virtual Switch\n1. Choose a RF or IR Bridge\n2. Enter the Tasmota command to send for \"ON\" and \"OFF\"\n      \n      For RF, it has to be one of these formats\n      \n      * `Backlog RfSync \u003cvalue\u003e; RfLow \u003cvalue\u003e; RfHigh \u003cvalue\u003e; RfCode \u003cvalue\u003e`      \n      * `Backlog RfRaw \u003cvalue\u003e; RfRaw 0`\n         \u003e Note: RFRaw requires [Portisch Firmware](https://github.com/Portisch/RF-Bridge-EFM8BB1)\n     \n3. Optionally, enable `State tracking` to listen for RF codes (e.g. from RF remote) to simulate a Stateful device\n4. If you enable `State tracking`, enter the code that represents the \"ON\" and \"OFF\" state\n       \n   In the example below, the code is **70C70F**\n   \n   * \"RfReceived\":{\"Sync\":7110,\"Low\":210,\"High\":660,\"Data\":\"**70C70F**\",\"RfKey\":\"None\"}\n\n#### Configuring a Virtual Contact / Motion Sensor / Button\n1. Choose a RF Bridge\n2. Enter the RFReceived Data that represents \"OPEN\", \"CLOSE\", \"ACTIVE\", \"INACTIVE\" or button state\n             \n   In the example below, the code is **70C70F**\n   \n   * \"RfReceived\":{\"Sync\":7110,\"Low\":210,\"High\":660,\"Data\":\"**70C70F**\",\"RfKey\":\"None\"}\n\n#### Configuring a Virtual Air Conditioner\n1. Choose an IR Bridge\n2. Select air conditioner brand ([supported AC vendor/brands](https://tasmota.github.io/docs/Tasmota-IR/#sending-irhvac-commands))\n3. (Optional) Select a contact sensor to sense if the AC is ON or OFF\n\n## FAQ\n\n#### My Tasmota device is not responding?\n* Verify the IP address is correct and you are able to access your device via the IP address.\n* If you have added this device using other developer device type handler (DTH), please delete the device.\n* 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.\n* Ensure your Tasmota devices and SmartThings hub are assigned with static IP addresses.\n\n####  Where can I find out more about Tasmota command for sending/receiving IR / RF codes?\nPlease see under RF Bridge \u0026 IR Remote - https://tasmota.github.io/docs/Commands/\n\n#### The Tasmota (Connect) SmartApp is not showing up in SmartThings App?\n* Sign in to SmartThings IDE: https://account.smartthings.com/login \n* Verify that you have installed the codes in the correct SmartThings IDE Shard.\n* If you don't see your current devices under \"My Devices\", you are probably on the wrong shard.\n\n#### I'm unable to find the recently released features (or missing features or devices) in my SmartApp?\n* Please make sure you install the SmartApp and all Device Handlers, and update the codes regularly to receive the latest features\n\n#### I created a generic/metering switch with 2 (or more) channels, but it shows only 1 switch?\n* Please make sure you install the SmartApp and all Device Handlers, and update the codes regularly to receive the latest features\n\n#### I have feedback, questions, suggestion..\nPlease 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.\n\n## Support Us\n\nIf 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).\nThanks for your support.\n\n## License\nGPL-3.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhongtat%2Ftasmota-connect","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhongtat%2Ftasmota-connect","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhongtat%2Ftasmota-connect/lists"}