# Request for external integration for TINECO vacuum cleaner/mop **URL:** \ **Category:** Demandes livrées\ **Created:** [October 16, 2026, 7:31pm UTC](https://community.gladysassistant.com/t/demande-d-integration-externe-pour-robot-aspirateur-laveur-tineco/11319 "2026-10-16T19:31:29Z")\ **Posts on this page:** 17\ **Page:** 1
**Author:** ![Steph38230](https://gladys-assistant-community.b-cdn.net/letter_avatar_proxy/v4/letter/s/3e96dc/32.png) [@Steph38230](https://community.gladysassistant.com/u/Steph38230)\ **Post date:** [October 16, 2026, 7:31pm UTC](https://community.gladysassistant.com/t/demande-d-integration-externe-pour-robot-aspirateur-laveur-tineco/11319/1 "2026-10-16T19:31:29Z")
External integration to control TINECO vacuum cleaners like the S7 Strech The integration exists on HA - [GitHub - wheeller123/Tineco-Integration: Home Assistant custom integration for Tineco vacuum cleaners · GitHub](https://github.com/wheeller123/Tineco-Integration) #### Data Structure (Decoded Payload) The vacuum cleaner’s status return contains a JSON object with abbreviated keys: - **`wm` (Working Mode)** : - `1` = Standby - `2` = Charging - `3` = In Operation - `8` = Self-cleaning - `9` = OTA Update - `13` = Drying / Flashdry - **`e2` / `e3` (Water tank alert bitmasks)** : - Dirty water tank full: checked by `e2 & 256` (or `e3 & 4096`). - Clean water tank empty: checked by `e2 & 64` (or `e3 & 8192`). - **`battery`** : Remaining battery percentage. - **`vs`** : Online status. - **`ms` / `vl`** : Silent mode (`ms: 0` or `1`) and volume level (`vl: 1` low, `2` medium, `3` high). - **Additional controls** : Suction power (120W, 150W), spray flow, brush lighting. ---
**Author:** ![GBoulvin](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/gboulvin/32/10006_2.png) [@GBoulvin](https://community.gladysassistant.com/u/GBoulvin)\ **Post date:** [October 16, 2026, 7:33pm UTC](https://community.gladysassistant.com/t/demande-d-integration-externe-pour-robot-aspirateur-laveur-tineco/11319/2 "2026-10-16T19:33:39Z")
I’ll run Claude on it 😉 ---
**Author:** ![prohand](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/prohand/32/15713_2.png) [@prohand](https://community.gladysassistant.com/u/prohand)\ **Post date:** [October 16, 2026, 7:36pm UTC](https://community.gladysassistant.com/t/demande-d-integration-externe-pour-robot-aspirateur-laveur-tineco/11319/3 "2026-10-16T19:36:01Z")
He was faster than me 😅 ---
**Author:** ![Steph38230](https://gladys-assistant-community.b-cdn.net/letter_avatar_proxy/v4/letter/s/3e96dc/32.png) [@Steph38230](https://community.gladysassistant.com/u/Steph38230)\ **Post date:** [October 16, 2026, 7:38pm UTC](https://community.gladysassistant.com/t/demande-d-integration-externe-pour-robot-aspirateur-laveur-tineco/11319/4 "2026-10-16T19:38:04Z")
You guys are machines… 🤣 Now every evening you need to plan 1 hour to go through the integration list and see the new features ---
**Author:** ![GBoulvin](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/gboulvin/32/10006_2.png) [@GBoulvin](https://community.gladysassistant.com/u/GBoulvin)\ **Post date:** [October 16, 2026, 8:05pm UTC](https://community.gladysassistant.com/t/demande-d-integration-externe-pour-robot-aspirateur-laveur-tineco/11319/5 "2026-10-16T20:05:11Z")
Voilà, it’s ready. On the store within the hour or, if you’re in a hurry, manually: [Build and publish image · gboulvin/Gladys-Tineco@ad8eee7 · GitHub](https://github.com/gboulvin/Gladys-Tineco/actions/runs/38959283115/attempts/1#summary-117169985239) And the little message that goes with it: The integration connects your Tineco account devices (Floor One S3, S5, S7, S7 Flashdry, S7 Stretch, iFloor… everything shown in the Tineco app) to Gladys via the Tineco cloud, just like the official app. ## **What it reports** - **Status** (standard Gladys vacuum) and **detailed activity** : cleaning, self-cleaning, drying, charging, updating, idle, offline - **Battery** and **charging in progress** - **Clean water tank** (empty) and **dirty water tank** (full) - **Voice volume** , **voice announcements** , and **brush lighting** (on equipped models), controllable from Gladys - **Cloud / unreachable** badge when the device is off or not on Wi-Fi ## **Scenes** - Triggers: **cleaning started** , **cleaning finished** (with duration), **self-cleaning finished** (the ideal time to be notified to empty the dirty water bin 😉), **tank alert** - Actions: **read a device** (outputs usable as conditions: battery, activity, tanks…), adjust volume, turn off voice announcements, turn on/off the brush light ## **Dashboard widgets** - **Tineco device** : battery gauge, activity, tanks, 24-hour battery history, and “Refresh” button - **Tineco overview** : one line per device, in orange if a tank requires your attention ## **Installation** 1. Install the **Tineco** integration from the integrations catalog. 2. Enter the email, password, and **country** of your Tineco account. 3. On first connection, Tineco sends you a **verification code by email** : enter it in “Verification Code” and save (only once). 4. Create your devices from the **Discovery** tab. The integration is available in **French, English, German, and Spanish**. ## **To know** Tineco does not publish an API: the integration relies on the app protocol, documented by the community (thanks to the author of [Tineco-HACS-Integration](https://github.com/wheeller123/Tineco-HACS-Integration) and the payload decoding shared on this forum). Not all models report all values: your feedback (model + what works / doesn’t work) is welcome to improve it! - Source code and documentation: [GitHub - gboulvin/Gladys-Tineco · GitHub](https://github.com/gboulvin/Gladys-Tineco) - Bugs and suggestions: [Issues · gboulvin/Gladys-Tineco · GitHub](https://github.com/gboulvin/Gladys-Tineco/issues) Happy cleaning! 🧹 ---
**Author:** ![Steph38230](https://gladys-assistant-community.b-cdn.net/letter_avatar_proxy/v4/letter/s/3e96dc/32.png) [@Steph38230](https://community.gladysassistant.com/u/Steph38230)\ **Post date:** [October 16, 2026, 8:16pm UTC](https://community.gladysassistant.com/t/demande-d-integration-externe-pour-robot-aspirateur-laveur-tineco/11319/6 "2026-10-16T20:16:06Z")
I installed it and linked it to my account and entered the verification code. When I test the connection, I get a message saying that the connection is OK but that it cannot find any device linked to this account. However, in the TINECO app on my phone, I can access my S7 cordless vacuum cleaner. ![image](https://gladys-assistant-community.b-cdn.net/uploads/default/original/3X/c/2/c2ac8f573c46e496d04b86019a70bf773e42a4b8.png) ---
**Author:** ![GBoulvin](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/gboulvin/32/10006_2.png) [@GBoulvin](https://community.gladysassistant.com/u/GBoulvin)\ **Post date:** [October 16, 2026, 8:17pm UTC](https://community.gladysassistant.com/t/demande-d-integration-externe-pour-robot-aspirateur-laveur-tineco/11319/7 "2026-10-16T20:17:13Z")
Could you give me a log? In the integration → Logs ---
**Author:** ![Steph38230](https://gladys-assistant-community.b-cdn.net/letter_avatar_proxy/v4/letter/s/3e96dc/32.png) [@Steph38230](https://community.gladysassistant.com/u/Steph38230)\ **Post date:** [October 16, 2026, 8:17pm UTC](https://community.gladysassistant.com/t/demande-d-integration-externe-pour-robot-aspirateur-laveur-tineco/11319/8 "2026-10-16T20:17:53Z")
```auto [2026-10-16T20:07:46.731Z] [INFO] Starting the Tineco integration... [2026-10-16T20:07:46.962Z] [INFO] [gladys-sdk] connected to Gladys (http://172.30.0.1:80) [2026-10-16T20:07:47.015Z] [ERROR] [tineco] Tineco: Tineco e-mail or password missing [2026-10-16T20:09:46.311Z] [INFO] [tineco-session] Tineco verification code sent by e-mail [2026-10-16T20:09:46.311Z] [INFO] [tineco] Waiting for the Tineco verification code [2026-10-16T20:10:24.835Z] [INFO] [tineco-session] Tineco app device verified [2026-10-16T20:10:25.988Z] [INFO] [tineco-session] Tineco session open, 0 appliance(s) [2026-10-16T20:10:28.482Z] [INFO] [tineco-session] Tineco session open, 0 appliance(s) [2026-10-16T20:11:05.105Z] [INFO] [tineco-session] Tineco session open, 0 appliance(s) [2026-10-16T20:11:24.663Z] [INFO] [tineco-session] Tineco session open, 0 appliance(s) [2026-10-16T20:13:14.770Z] [INFO] [tineco-session] Tineco session open, 0 appliance(s) ``` ---
**Author:** ![GBoulvin](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/gboulvin/32/10006_2.png) [@GBoulvin](https://community.gladysassistant.com/u/GBoulvin)\ **Post date:** [October 16, 2026, 8:26pm UTC](https://community.gladysassistant.com/t/demande-d-integration-externe-pour-robot-aspirateur-laveur-tineco/11319/9 "2026-10-16T20:26:08Z")
Thanks for the feedback and the log! The connection works: it’s the list of devices returned by Tineco that is empty. Could you: 1. update the integration to **v1.0.2. If you installed it manually, you need to delete** the previous one; 2. check that the **Account Country** is indeed the one from the Tineco app (Profile \> Settings), then save and click on **Test the connection** ; 3. if no device still appears, copy the log line that contains **« Answer shape »** : it contains no personal data and will tell me where Tineco stores your devices. ---
**Author:** ![Steph38230](https://gladys-assistant-community.b-cdn.net/letter_avatar_proxy/v4/letter/s/3e96dc/32.png) [@Steph38230](https://community.gladysassistant.com/u/Steph38230)\ **Post date:** [October 16, 2026, 8:32pm UTC](https://community.gladysassistant.com/t/demande-d-integration-externe-pour-robot-aspirateur-laveur-tineco/11319/10 "2026-10-16T20:32:56Z")
I checked on the app and my account is set to « France » ```auto [2026-10-16T20:29:39.539Z] [INFO] [tineco-session] Tineco session open, 0 appliance(s) [2026-10-16T20:29:39.539Z] [WARN] [tineco-session] No appliance in the device list of the FR servers. Check the account country. Answer shape: { code: "0000", msg: "操作成功", time: number, data: [], success: boolean } ``` ---
**Author:** ![GBoulvin](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/gboulvin/32/10006_2.png) [@GBoulvin](https://community.gladysassistant.com/u/GBoulvin)\ **Post date:** [October 16, 2026, 8:40pm UTC](https://community.gladysassistant.com/t/demande-d-integration-externe-pour-robot-aspirateur-laveur-tineco/11319/11 "2026-10-16T20:40:37Z")
Good news! We found the cause: the integration requested the list of devices with the wrong user ID, so Tineco responded with an empty list. This is fixed in **v1.0.3**. Can you update the integration, click on **Test Connection** , then open the **Discovery** tab? Your S7 should appear. If not, please send me the new « Answer shape » line from the log. Sorry for the back and forth 😉 ---
**Author:** ![Steph38230](https://gladys-assistant-community.b-cdn.net/letter_avatar_proxy/v4/letter/s/3e96dc/32.png) [@Steph38230](https://community.gladysassistant.com/u/Steph38230)\ **Post date:** [October 16, 2026, 8:42pm UTC](https://community.gladysassistant.com/t/demande-d-integration-externe-pour-robot-aspirateur-laveur-tineco/11319/12 "2026-10-16T20:42:12Z")
Too strong !!! ![image](https://gladys-assistant-community.b-cdn.net/uploads/default/original/3X/8/0/80647a3eafaed110b8c4947b62b567b30d115083.png) ---
**Author:** ![Steph38230](https://gladys-assistant-community.b-cdn.net/letter_avatar_proxy/v4/letter/s/3e96dc/32.png) [@Steph38230](https://community.gladysassistant.com/u/Steph38230)\ **Post date:** [October 16, 2026, 8:47pm UTC](https://community.gladysassistant.com/t/demande-d-integration-externe-pour-robot-aspirateur-laveur-tineco/11319/13 "2026-10-16T20:47:27Z")
![image](https://gladys-assistant-community.b-cdn.net/uploads/default/original/3X/0/e/0eb7b41fd5876a3660cc9410d794841284cb31f9.jpeg) ---
**Author:** ![GBoulvin](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/gboulvin/32/10006_2.png) [@GBoulvin](https://community.gladysassistant.com/u/GBoulvin)\ **Post date:** [October 16, 2026, 8:50pm UTC](https://community.gladysassistant.com/t/demande-d-integration-externe-pour-robot-aspirateur-laveur-tineco/11319/14 "2026-10-16T20:50:30Z")
Cool! Just be aware that if you installed it « manually » in developer mode, no updates to the integration will be proposed in the future. I recommend using the store for production purposes 😉 ---
**Author:** ![Steph38230](https://gladys-assistant-community.b-cdn.net/letter_avatar_proxy/v4/letter/s/3e96dc/32.png) [@Steph38230](https://community.gladysassistant.com/u/Steph38230)\ **Post date:** [October 16, 2026, 8:55pm UTC](https://community.gladysassistant.com/t/demande-d-integration-externe-pour-robot-aspirateur-laveur-tineco/11319/15 "2026-10-16T20:55:40Z")
I would reinstall it as soon as it appears on the integrations page. ---
**Author:** ![cursor-bot](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/cursor-bot/32/22252_2.png) [@cursor-bot](https://community.gladysassistant.com/u/cursor-bot)\ **Post date:** [October 29, 2026, 10:50am UTC](https://community.gladysassistant.com/t/demande-d-integration-externe-pour-robot-aspirateur-laveur-tineco/11319/16 "2026-10-29T10:50:29Z")
Hi @Steph38230! The Tineco vacuum cleaners are in the catalog. The integration was published by @GBoulvin, and you have it in service in 1.0.3. For future updates, go through the Integrations page. A manually installed copy, in developer mode, will not offer the next versions. @GBoulvin reminded us of this earlier in the thread. I’m moving this topic to « Delivered Requests ». If there’s still a case that doesn’t match, open a new topic: it will be easier to follow. ---
**Author:** ![cursor-bot](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/cursor-bot/32/22252_2.png) [@cursor-bot](https://community.gladysassistant.com/u/cursor-bot)\ **Post date:** [October 29, 2026, 10:50am UTC](https://community.gladysassistant.com/t/demande-d-integration-externe-pour-robot-aspirateur-laveur-tineco/11319/17 "2026-10-29T10:50:35Z")