--- title: "Somfy TaHoma – io és RTS árnyékolók (helyi API)" description: "Somfy io redőnyök, napellenzők, lamellás redőnyök és RTS motorok vezérlése a TapHome-ból a TaHoma átjáró helyi API-ján (Developer Mode) — felhő nélkül." url: "https://taphome.com/hu/compatibility/somfy-tahoma-http/" language: hu lastmod: 2026-11-04 generator: hugo ai: topics: ["http","gateway","blinds","shutters","awnings","io-homecontrol","rts","rest-api","mdns"] questions: ["Van TapHome sablon a Somfyhoz?","Integrálhatók a Somfy árnyékolók a TapHome-ba a TaHoma átjárón keresztül?","Hogyan szerezhető meg a Somfy TaHoma Developer Mode Bearer tokenje a TapHome-hoz?","Hogyan található meg egy Somfy motor deviceURL-je a TapHome sablonhoz?","Tudja a TapHome vezérelni a Somfy RTS motorokat?","Kell-e TaHoma átjáró a TapHome-ban a rádió nélküli, vezetékes Somfy motorokhoz?"] --- # Somfy TaHoma – io és RTS árnyékolók (helyi API) Kommunikáció: Packet Parser → HTTP - [A Somfy hivatalos weboldala](https://www.somfy.com) - [Somfy TaHoma Switch termékoldal](https://www.somfy.co.uk/products/1870600/tahoma-switch) A Somfy TaHoma sablon a TapHome-ot egy Somfy TaHoma átjáróval (például TaHoma Switch) köti össze az átjáró hivatalos helyi API-ján keresztül, amelyet a Somfy Developer Mode-nak nevez. A motorokat a szokásos módon a TaHoma by Somfy alkalmazásban kell párosítani az átjáróval; a TapHome csak az átjáróval kommunikál, HTTPS-en a 8443-as porton a helyi hálózatban, felhőkapcsolat nélkül. A sablon vezérli az io-homecontrol redőnyök és napellenzők helyzetét, az io-homecontrol kültéri lamellás redőnyök helyzetét és lamellaszögét, az egyirányú RTS motoroknak pedig Nyitás, My, Stop és Zárás parancsot küld. > [!WARNING] > **Közösségi sablon — a TapHome-mal még nincs tesztelve.** A sablon a TapHome portálon készült a Somfy Developer Mode dokumentációjából; az eszközállapotok és parancsok nevei közösségi forrásokból származnak (a Somfy nem sorolja fel őket). Csak egy szimulált átjáróval tesztelték egy helyi TapHome Core 2025.2-n, valódi TaHoma átjáróval és valódi Somfy motorokkal nem, a gyakorlati tapasztalatokat szívesen fogadjuk. Az XML-t letöltheted ezen az oldalon vagy a TapHome portálon: [Somfy TaHoma — közösségi sablon](https://portal.taphome.com/portal/community/somfy-tahoma-http), és importáld új modulként. **[Somfy TaHoma — io and RTS shading motors (Developer Mode, local API)](https://portal.taphome.com/hu/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] > **A vezetékes Somfy motorokhoz nem kell átjáró.** A rádióvevő nélküli 230 V-os Somfy motort (például Somfy WT, négy vezeték — PE, N, fel, le) a TapHome közvetlenül relémodulokkal vezérli, mint bármely más árnyékolómotort — lásd [Követelmények → Árnyékolás](https://taphome.com/hu/docs/setup/requirements/#shading). Ez a sablon a TaHoma átjáróval párosított rádiós (io-homecontrol vagy RTS) motorokhoz készült. ## Támogatott átjárók A Somfy szerint a Developer Mode a TaHoma átjárók túlnyomó többségén működik. **Nem érhető el**: - az 1. generációs (négyzet alakú) TaHoma boxon vagy Somfy boxon - a Connectivity Kiten ## Hardveres csatlakozás Kábelezésre nincs szükség. A TaHoma átjárónak és a TapHome Core-nak ugyanabban a helyi hálózatban kell lennie. Az átjáró a saját aláírású Overkiz hitelesítésszolgáltató által aláírt tanúsítványt használ; a sablon a tanúsítványhibák figyelmen kívül hagyásával csatlakozik, így tanúsítványt nem kell telepíteni. ## Konfiguráció ### A Developer Mode bekapcsolása és token létrehozása 1. Nyisd meg a **TaHoma by Somfy** alkalmazást. 2. Lépj a TaHoma box **Configure the installation › Access the parameters** menüjébe. 3. Koppints **7-szer** az átjáró PIN-kódjára (például 2001-1234-5678) — bekapcsol a Developer Mode, és elindul az átjáró helyi API-ja. 4. A **Developer Mode** menüben hozz létre egy tokent. A token csak a létrehozásakor olvasható és másolható — azonnal mentsd el. Több token is létrehozható; ha egy token elveszik, hozz létre újat, és add meg a TapHome-ban. ### Az eszközcímek megkeresése Minden, az átjáróval párosított motornak van egy címe, a `deviceURL`. A címeket az átjáró eszközlistája adja meg a tokennel — például egy ugyanabban a hálózatban lévő számítógépről: ``` curl -k -H "Authorization: Bearer " https://:8443/enduser-mobile-web/1/enduserAPI/setup/devices ``` Keresd meg a motort a `label` alapján (a TaHoma alkalmazásban megadott név), és másold ki a `deviceURL` értékét pontosan úgy, ahogy látható. A sablon a kéréshez maga kódolja. | Protokoll | Formátum | Példa | |---|---|---| | io-homecontrol | `io://{gateway-pin}/{device-id}` | `io://1234-5678-9012/4820485` | | RTS | `rts://{gateway-pin}/{device-id}` | `rts://1234-5678-9012/987654321` | Ugyanez a válasz mutatja, mit támogat az egyes motor: `definition.states` és `definition.commands`. A sablon redőnynél vagy napellenzőnél a `core:ClosureState` állapotot és a `setClosure` parancsot, lamellás redőnynél a `core:ClosureState`, `core:SlateOrientationState` és `setClosureAndOrientation` nevet, RTS motornál pedig az `open`, `my`, `stop` és `close` parancsot várja. Az a motor, amelynek definíciójában ezek a nevek nincsenek meg, az adott eszközzel nem fog működni. ### Importálási paraméterek | Importálási paraméter | Leírás | Helykitöltő | |---|---|---| | `GatewayAddress` | A TaHoma átjáró IP-címe vagy hosztneve, például `gateway-1234-5678-9012.local` | `192.168.1.100` | | `BearerToken` | Token a Developer Mode-ból | (üres) | | `SlideDeviceUrl` | Az io redőny vagy napellenző `deviceURL` címe | `io://1234-5678-9012/12345678` | | `BlindDeviceUrl` | Az io lamellás redőny `deviceURL` címe | `io://1234-5678-9012/12345678` | | `RtsDeviceUrl` | Az RTS motor `deviceURL` címe | `rts://1234-5678-9012/12345678` | Ha IP-címet használsz, foglald le az átjárónak a routerben, hogy ne változzon. A sablonban minden fajtából egy eszköz van. Töröld azokat az eszközöket, amelyekre nincs szükséged. További motorokhoz importáld újra a sablont a többi címmel — minden importálás egy átjárómodult ad hozzá saját eszközökkel — és töröld a fölösleges eszközöket, vagy módosítsd egy eszköz `DeviceUrl` változóját. ## Eszközfunkciók ### Átjáró A modul 30 másodpercenként kiolvassa az átjárót, és három szervizattribútumot mutat: **Protokollverzió** (a helyi API verziója), **Átjáró azonosító** (az átjáró PIN-kódja) és **Kapcsolati állapot** (például OK). Hibás token esetén a modul ezt a hibát mutatja: „Check Bearer token in TaHoma By Somfy app → Developer Mode”. ### io redőnyök és napellenzők - **io redőny / napellenző** — az io-homecontrol redőny vagy napellenző helyzete. Az átjáró 0 = teljesen nyitva és 100 = teljesen zárva értéket jelent; a TapHome-ban 0 % a teljesen felhúzott és 100 % a teljesen leengedett helyzet, ugyanabban az irányban. Az eszköz 5 másodpercenként kiolvassa a helyzetet, és a `setClosure` paranccsal mozgatja a motort. ### io lamellás redőnyök - **io lamellás redőny** — az io-homecontrol kültéri lamellás redőny helyzete és lamellaszöge. Mindkettő együtt megy egy `setClosureAndOrientation` paranccsal, így a helyzet módosítása az aktuális lamellaszöget, a lamellák módosítása pedig az aktuális helyzetet is elküldi. Ha a TapHome egyszerre módosítja a helyzetet és a lamellákat, az azonos parancs csak egyszer megy ki. ### RTS motorok Az RTS (Radio Technology Somfy) motorok egyirányú rádiót használnak: fogadják a parancsokat, de a helyzetüket nem jelentik. | Érték | Parancs | Művelet | |---|---|---| | Nyitás | `open` | Felfelé mozgás / teljes nyitás | | My | `my` | A motorban tárolt kedvenc helyzetbe állás | | Stop | `stop` | A mozgás leállítása | | Zárás | `close` | Lefelé mozgás / teljes zárás | - **RTS motor** — minden parancs után a kapcsoló **Kész** állapotot mutat, így ugyanaz a parancs újra elküldhető, például Zárás azután, hogy a motort a saját távirányítójával mozgatták. A Kész kiválasztása Stop parancsot küld. Egyik eszköz sem mozgat motort a TapHome Core indulásakor: az állapotot az átjárótól veszik át, nem a TapHome utolsó értékéből. ### Hogyan kommunikál a sablon az átjáróval Minden hívás a `https://:8443/enduser-mobile-web/1/enduserAPI` címre megy az `Authorization: Bearer ` fejléccel; token nélkül csak a `GET /apiVersion` működik. Minden io eszköz 5 másodpercenként kiolvassa az állapotait a `/setup/devices/{deviceURL}/states` címről, és minden eszköz a `POST /exec/apply` hívással küld parancsot. A Somfy nem korlátozza a helyi API hívásainak számát, de figyelmeztet, hogy a túl gyakori hívások túlterhelik az átjárót, és késleltetik a motorok vezérlését — gondolj erre, ha egy átjárón sok motor van. ## Hibaelhárítás ### „Check Bearer token in TaHoma By Somfy app → Developer Mode” hiba Az átjáró HTTP 401-gyel válaszolt: a token hibás, vagy nem teljesen lett kimásolva. Hozz létre új tokent a TaHoma by Somfy alkalmazásban (Developer Mode), és add meg a TapHome-ban. ### „Device unavailable (HTTP …)” eszközhiba Az átjáró nem ismeri a címet. Ellenőrizd, hogy a `deviceURL` pontosan a `GET /setup/devices` válaszából van-e kimásolva — kódolás és szóközök nélkül —, és hogy a megfelelő eszközfajtához tartozik-e. ### „Closure state not available” eszközhiba Az átjáró válaszolt, de a `core:ClosureState` állapot nélkül. Ellenőrizd a motor `definition.states` listáját. Egyes napellenzők helyette a `core:DeploymentState` állapotot jelentik (0 = behúzva, 100 = kinyitva); ezt a sablon nem olvassa. ### Az átjáró elérhetetlennek mutat egy eszközt, pedig működik Egyes TaHoma firmware-ek az io eszközöket elérhetetlennek jelentik (`available: false`), pedig normálisan működnek — ezt a Developer Mode tárolójában jelentették a Somfynak. A sablon ezt a jelzőt nem használja, és miatta nem mutat hibát. ### Az RTS motor nem mozdul Az RTS parancsok egyirányú rádiójelek kézbesítési visszaigazolás nélkül, ezért a TapHome nem mutat hibát, ha a motor nem reagál. Ellenőrizd, hogy a motor az átjáró rádiós hatótávolságán belül van-e, és hogy mozdul-e a TaHoma by Somfy alkalmazásból. ### Az átjáró hosztneve nem érhető el Ha a `gateway-{pin}.local` név nem oldódik fel, használd az átjáró IP-címét — megtalálod a routerben. A Developer Mode-nak bekapcsolva kell maradnia: ez engedélyezi az átjáró helyi API-ját. ## Elérhető eszközök Somfy TaHoma átjáró Modul Szerviz attribútumok | | | |--------------------|------------------------------------------------------------------------------------------------| | Protokollverzió | A helyi API verziója, amelyet az átjáró jelent | | Átjáró azonosító | Az átjáró PIN-kódja (például 1234-5678-9012), ugyanaz a PIN, amely minden eszköz címének része | | Kapcsolati állapot | Az átjáró által jelentett kapcsolati állapot, például OK | Egyéni változók `BearerToken` (string) A TaHoma helyi API tokenje, amely a TaHoma by Somfy alkalmazásban készül (Developer Mode); a modul és minden eszköz 'Authorization: Bearer <token>' formában küldi 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 redőny / napellenző Csúszka Az io-homecontrol redőny vagy napellenző helyzete — 0 % teljesen nyitva, 100 % teljesen zárva, ugyanabban az irányban, mint az átjáróban numeric (0–100) Egység: % json\_path Változó: `DeviceUrl` — A motor címe a TaHoma átjáróban (deviceURL a GET /setup/devices válaszából), például io://1234-5678-9012/4820485 io lamellás redőny Redőny Az io-homecontrol kültéri lamellás redőny helyzete és lamellaszöge — mindkettő egy paranccsal együtt megy numeric (0–100) Egység: % json\_path Változó: `DeviceUrl` — A lamellás redőny címe a TaHoma átjáróban (deviceURL), például io://1234-5678-9012/5932104 RTS motor Többértékű kapcsoló Parancsok az egyirányú RTS motorhoz — Nyitás, My (kedvenc helyzet), Stop vagy Zárás; az RTS nem jelenti a helyzetet, ezért a kapcsoló minden parancs után Kész állapotot mutat enum numeric Értékek / Állapotok: Kész · Nyitás · My · Stop · Zárás Változó: `DeviceUrl` — Az RTS motor címe a TaHoma átjáróban (deviceURL), például rts://1234-5678-9012/987654321 **Kapcsolat:** Packet Parser → HTTP • Hostname: `gateway-{pin}.local.local` Lehetséges fejlesztések (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. ## Források - 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 ## Kapcsolódó dokumentáció - [Packet Parser integráció](https://taphome.com/hu/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hu/docs/integration/packet-parser/) - [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/) - [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/)