--- title: "Somfy TaHoma – žaluzie a rolety io a RTS (lokální API)" description: "Ovládání rolet, markýz a žaluzií Somfy io i motorů RTS z TapHome přes lokální API brány TaHoma (Developer Mode) — bez cloudu." url: "https://taphome.com/cs/compatibility/somfy-tahoma-http/" language: cs lastmod: 2026-11-04 generator: hugo ai: topics: ["http","gateway","blinds","shutters","awnings","io-homecontrol","rts","rest-api","mdns"] questions: ["Je v TapHome šablona pro Somfy?","Dají se žaluzie Somfy integrovat do TapHome přes bránu TaHoma?","Jak získat token Bearer z režimu Developer Mode brány Somfy TaHoma pro TapHome?","Jak zjistit deviceURL motoru Somfy pro šablonu TapHome?","Umí TapHome ovládat motory Somfy RTS?","Potřebují drátové motory Somfy bez rádia v TapHome bránu TaHoma?"] --- # Somfy TaHoma – žaluzie a rolety io a RTS (lokální API) Komunikace: Packet Parser → HTTP - [Oficiální stránka Somfy](https://www.somfy.com) - [Produktová stránka Somfy TaHoma Switch](https://www.somfy.co.uk/products/1870600/tahoma-switch) Šablona Somfy TaHoma propojuje TapHome s bránou Somfy TaHoma (například TaHoma Switch) přes oficiální lokální API brány, které Somfy nazývá Developer Mode. Motory se s bránou spárují jako obvykle v aplikaci TaHoma by Somfy; TapHome komunikuje jen s bránou, přes HTTPS na portu 8443 v lokální síti, bez připojení ke cloudu. Šablona ovládá polohu rolet a markýz io-homecontrol, polohu a natočení lamel venkovních žaluzií io-homecontrol a jednosměrným motorům RTS posílá příkazy Otevřít, My, Stop a Zavřít. > [!WARNING] > **Komunitní šablona — zatím neotestovaná s TapHome.** Šablona vznikla v portálu TapHome z dokumentace Somfy k režimu Developer Mode; názvy stavů a příkazů zařízení pocházejí z komunitních zdrojů (Somfy je nevyjmenovává). Otestovaná byla jen se simulátorem brány na lokálním TapHome Core 2025.2, ne se skutečnou bránou TaHoma ani se skutečnými motory Somfy, a zkušenosti z praxe jsou vítané. XML stáhnete na této stránce nebo v portálu TapHome: [Somfy TaHoma — komunitní šablona](https://portal.taphome.com/portal/community/somfy-tahoma-http), a importujete ho jako nový modul. **[Somfy TaHoma — io and RTS shading motors (Developer Mode, local API)](https://portal.taphome.com/cs/portal/community/somfy-tahoma-http)** — Somfy, HTTP. Somfy TaHoma gateway over its official local API (Developer Mode, HTTPS 8443, token): io roller shutters and awnings with position, io venetian blinds with slats, RTS motors as commands without feedback. > [!NOTE] > **Drátové motory Somfy bránu nepotřebují.** Motor Somfy na 230 V bez rádiového přijímače (například Somfy WT, čtyři vodiče — PE, N, nahoru, dolů) ovládá TapHome přímo reléovými moduly jako každý jiný motor stínění — viz [Požadavky → Stínění](https://taphome.com/cs/docs/setup/requirements/#shading). Tato šablona je pro motory s rádiem (io-homecontrol nebo RTS) spárované s bránou TaHoma. ## Podporované brány Podle Somfy funguje Developer Mode na velké většině bran TaHoma. **Není dostupný** na: - TaHoma box nebo Somfy box 1. generace (čtvercový tvar) - Connectivity Kit ## Hardwarové připojení Žádná kabeláž není potřeba. Brána TaHoma a TapHome Core musí být ve stejné lokální síti. Brána používá certifikát podepsaný vlastní autoritou Overkiz; šablona se připojuje s ignorováním chyb certifikátu, takže není třeba instalovat žádný certifikát. ## Konfigurace ### Zapnutí režimu Developer Mode a vytvoření tokenu 1. Otevřete aplikaci **TaHoma by Somfy**. 2. Přejděte do **Configure the installation › Access the parameters** vaší brány TaHoma. 3. **7krát** klepněte na PIN brány (například 2001-1234-5678) — zapne se Developer Mode a spustí se lokální API brány. 4. V nabídce **Developer Mode** vygenerujte token. Token lze přečíst a zkopírovat jen při vytvoření — hned si ho uložte. Tokenů lze vygenerovat více; pokud se token ztratí, vygenerujte nový a zadejte ho v TapHome. ### Zjištění adres zařízení Každý motor spárovaný s bránou má adresu, `deviceURL`. Adresy zjistíte ze seznamu zařízení brány s tokenem — například z počítače ve stejné síti: ``` curl -k -H "Authorization: Bearer " https://:8443/enduser-mobile-web/1/enduserAPI/setup/devices ``` Motor najděte podle `label` (název z aplikace TaHoma) a jeho `deviceURL` zkopírujte přesně tak, jak je zobrazená. Šablona si ji pro požadavek zakóduje sama. | Protokol | Formát | Příklad | |---|---|---| | io-homecontrol | `io://{gateway-pin}/{device-id}` | `io://1234-5678-9012/4820485` | | RTS | `rts://{gateway-pin}/{device-id}` | `rts://1234-5678-9012/987654321` | Tatáž odpověď ukazuje, co každý motor podporuje: `definition.states` a `definition.commands`. Šablona očekává stav `core:ClosureState` a příkaz `setClosure` u rolety nebo markýzy, `core:ClosureState`, `core:SlateOrientationState` a `setClosureAndOrientation` u žaluzie a `open`, `my`, `stop` a `close` u motoru RTS. Motor, jehož definice tyto názvy nemá, s daným zařízením fungovat nebude. ### Parametry importu | Parametr importu | Popis | Zástupná hodnota | |---|---|---| | `GatewayAddress` | IP adresa nebo název hostitele brány TaHoma, například `gateway-1234-5678-9012.local` | `192.168.1.100` | | `BearerToken` | Token z režimu Developer Mode | (prázdné) | | `SlideDeviceUrl` | `deviceURL` rolety nebo markýzy io | `io://1234-5678-9012/12345678` | | `BlindDeviceUrl` | `deviceURL` žaluzie io | `io://1234-5678-9012/12345678` | | `RtsDeviceUrl` | `deviceURL` motoru RTS | `rts://1234-5678-9012/12345678` | Pokud použijete IP adresu, rezervujte ji pro bránu v routeru, aby se neměnila. Šablona má od každého druhu jedno zařízení. Zařízení, která nepotřebujete, smažte. Pro další motory importujte šablonu znovu s dalšími adresami — každý import přidá modul brány s vlastními zařízeními — a nadbytečná zařízení smažte, nebo změňte proměnnou `DeviceUrl` zařízení. ## Možnosti zařízení ### Brána Modul čte bránu každých 30 s a ukazuje tři servisní atributy: **Verze protokolu** (verze lokálního API), **ID brány** (PIN brány) a **Stav připojení** (například OK). Při nesprávném tokenu modul ukáže chybu „Check Bearer token in TaHoma By Somfy app → Developer Mode“. ### Rolety a markýzy io - **io roleta / markýza** — poloha rolety nebo markýzy io-homecontrol. Brána hlásí 0 = zcela otevřená a 100 = zcela zavřená; v TapHome je 0 % zcela nahoře a 100 % zcela dole, stejný směr. Zařízení čte polohu každých 5 s a motorem pohybuje příkazem `setClosure`. ### Venkovní žaluzie io - **io venkovní žaluzie** — poloha a natočení lamel venkovní žaluzie io-homecontrol. Obojí se posílá společně jedním příkazem `setClosureAndOrientation`, takže změna polohy pošle i aktuální natočení lamel a změna lamel aktuální polohu. Když TapHome změní polohu i lamely najednou, stejný příkaz jde jen jednou. ### Motory RTS Motory RTS (Radio Technology Somfy) jsou jednosměrné rádio: příkazy přijímají, ale svou polohu nehlásí. | Hodnota | Příkaz | Činnost | |---|---|---| | Otevřít | `open` | Pohyb nahoru / zcela otevřít | | My | `my` | Přejít do oblíbené polohy uložené v motoru | | Stop | `stop` | Zastavit pohyb | | Zavřít | `close` | Pohyb dolů / zcela zavřít | - **Motor RTS** — po každém příkazu přepínač ukáže **Připraveno**, takže tentýž příkaz lze poslat znovu, například Zavřít poté, co se motorem pohnulo jeho vlastním ovladačem. Volba Připraveno pošle Stop. Žádné ze zařízení nepohne motorem při startu TapHome Core: stav berou z brány, ne z poslední hodnoty v TapHome. ### Jak šablona komunikuje s bránou Všechna volání jdou na `https://:8443/enduser-mobile-web/1/enduserAPI` s hlavičkou `Authorization: Bearer `; bez tokenu funguje jen `GET /apiVersion`. Každé zařízení io čte své stavy z `/setup/devices/{deviceURL}/states` každých 5 s a všechna zařízení posílají příkazy přes `POST /exec/apply`. Somfy pro lokální API nestanovuje žádný limit volání, ale upozorňuje, že příliš častá volání bránu přetíží a zpozdí ovládání motorů — pamatujte na to při mnoha motorech na jedné bráně. ## Řešení problémů ### Chyba „Check Bearer token in TaHoma By Somfy app → Developer Mode“ Brána odpověděla HTTP 401: token je nesprávný nebo nebyl zkopírován celý. Vygenerujte nový token v aplikaci TaHoma by Somfy › Developer Mode a zadejte ho v TapHome. ### Chyba zařízení „Device unavailable (HTTP …)“ Brána adresu nezná. Zkontrolujte, zda je `deviceURL` zkopírovaná přesně z `GET /setup/devices` — nezakódovaná, bez mezer — a zda patří ke správnému druhu zařízení. ### Chyba zařízení „Closure state not available“ Brána odpověděla, ale bez stavu `core:ClosureState`. Zkontrolujte `definition.states` motoru. Některé markýzy hlásí místo něj stav `core:DeploymentState` (0 = zatažená, 100 = vysunutá); ten šablona nečte. ### Brána ukazuje zařízení jako nedostupné, ale funguje Některé verze firmwaru TaHoma hlásí zařízení io jako nedostupná (`available: false`), i když fungují normálně — nahlášeno Somfy v repozitáři Developer Mode. Šablona tento příznak nepoužívá a chybu kvůli němu neukáže. ### Motor RTS se nepohne Příkazy RTS jsou jednosměrné rádiové signály bez potvrzení doručení, proto TapHome neukáže chybu, když motor nezareaguje. Zkontrolujte, zda je motor v rádiovém dosahu brány a zda se pohne z aplikace TaHoma by Somfy. ### Název hostitele brány není dostupný Pokud se `gateway-{pin}.local` nepřeloží, použijte IP adresu brány — najdete ji v routeru. Developer Mode musí zůstat zapnutý: právě ten zapíná lokální API brány. ## Dostupná zařízení Brána Somfy TaHoma Modul Servisní atributy | | | |-----------------|---------------------------------------------------------------------------------------------| | Verze protokolu | Verze lokálního API, kterou hlásí brána | | ID brány | PIN brány (například 1234-5678-9012), tentýž PIN, který je součástí adresy každého zařízení | | Stav připojení | Stav připojení, který hlásí brána, například OK | Vlastní proměnné `BearerToken` (string) Token lokálního API TaHoma, vytvořený v aplikaci TaHoma by Somfy › Developer Mode; modul i každé zařízení ho posílají jako 'Authorization: Bearer <token>' TaHoma by Somfy app → Configure the installation → Access the parameters of your TaHoma box → tap the gateway PIN 7 times → Developer Mode → generate a token. The token can be copied only when it is created; enter it as the import parameter Bearer token. io roleta / markýza Posuvný Poloha rolety nebo markýzy io-homecontrol — 0 % zcela otevřená, 100 % zcela zavřená, stejný směr jako v bráně numeric (0–100) Jednotka: % json\_path Proměnná: `DeviceUrl` — Adresa motoru v bráně TaHoma (deviceURL z GET /setup/devices), například io://1234-5678-9012/4820485 io venkovní žaluzie Žaluzie Poloha a natočení lamel venkovní žaluzie io-homecontrol — obojí se posílá společně jedním příkazem numeric (0–100) Jednotka: % json\_path Proměnná: `DeviceUrl` — Adresa žaluzie v bráně TaHoma (deviceURL), například io://1234-5678-9012/5932104 Motor RTS Vícestavový přepínač Příkazy pro jednosměrný motor RTS — Otevřít, My (oblíbená poloha), Stop nebo Zavřít; RTS polohu nehlásí, proto přepínač po každém příkazu ukáže Připraveno enum numeric Hodnoty / Stavy: Připraveno · Otevřít · My · Stop · Zavřít Proměnná: `DeviceUrl` — Adresa motoru RTS v bráně TaHoma (deviceURL), například rts://1234-5678-9012/987654321 **Připojení:** Packet Parser → HTTP • Hostname: `gateway-{pin}.local.local` Možná vylepšení (6) - Event-driven state updates — Somfy recommends reading /setup at start and then fetching events at most once per second; the listener expires after 10 minutes without a fetch. The template polls the states of each device every 5 s instead. - Automatic device discovery — The gateway lists every paired device with its deviceURL, label, controllableName and definition. The template does not create devices from it; the installer enters one deviceURL per device. - Open / Close / Stop / My on io motors — io roller shutters and venetian blinds accept the same commands as RTS; the template drives them by position only (setClosure / setClosureAndOrientation). - Awnings that report the deployment instead of the closure — Awnings of type io:HorizontalAwningIOComponent may report core:DeploymentState (0 = retracted, 100 = deployed) instead of core:ClosureState; the roller shutter device reads ClosureState only. - Cancel running executions — Cancels all running commands launched from the local API. - Availability of a motor — The device description carries available and the state core:StatusState; some gateway firmware reports io devices as unavailable although they work (reported in the Developer Mode repository), so the template does not use it. ## Zdroje - Somfy TaHoma Developer Mode — README (activation, token, certificate, mDNS, supported gateways) [github.com](https://github.com/Somfy-Developer/Somfy-TaHoma-Developer-Mode) 2026-11-04 - Somfy TaHoma local API — OpenAPI specification [somfy-developer.github.io](https://somfy-developer.github.io/Somfy-TaHoma-Developer-Mode/) 2026-11-04 ## Související dokumentace - [Integrace Packet Parser](https://taphome.com/cs/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/cs/docs/integration/packet-parser/) - [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/) - [Funkce pro parsování](https://taphome.com/cs/docs/script/parsing-functions/)