--- title: "Somfy TaHoma – jaluzele și rulouri io și RTS (API local)" description: "Control rulouri, copertine și jaluzele Somfy io și motoare RTS din TapHome prin API-ul local al gateway-ului TaHoma (Developer Mode) — fără cloud." url: "https://taphome.com/ro/compatibility/somfy-tahoma-http/" language: ro lastmod: 2026-11-04 generator: hugo ai: topics: ["http","gateway","blinds","shutters","awnings","io-homecontrol","rts","rest-api","mdns"] questions: ["Există în TapHome un șablon pentru Somfy?","Pot integra jaluzelele Somfy în TapHome prin gateway-ul TaHoma?","Cum obțin tokenul Bearer din Developer Mode al gateway-ului Somfy TaHoma pentru TapHome?","Cum găsesc deviceURL-ul unui motor Somfy pentru șablonul TapHome?","Poate TapHome controla motoarele Somfy RTS?","Au nevoie motoarele Somfy cu fir, fără radio, de un gateway TaHoma în TapHome?"] --- # Somfy TaHoma – jaluzele și rulouri io și RTS (API local) Comunicație: Packet Parser → HTTP - [Site-ul oficial Somfy](https://www.somfy.com) - [Pagina produsului Somfy TaHoma Switch](https://www.somfy.co.uk/products/1870600/tahoma-switch) Șablonul Somfy TaHoma conectează TapHome la un gateway Somfy TaHoma (de exemplu TaHoma Switch) prin API-ul local oficial al gateway-ului, pe care Somfy îl numește Developer Mode. Motoarele se asociază cu gateway-ul ca de obicei în aplicația TaHoma by Somfy; TapHome comunică doar cu gateway-ul, prin HTTPS pe portul 8443 în rețeaua locală, fără conexiune la cloud. Șablonul controlează poziția rulourilor și copertinelor io-homecontrol, poziția și unghiul lamelelor jaluzelelor exterioare io-homecontrol și trimite motoarelor RTS unidirecționale comenzile Deschide, My, Stop și Închide. > [!WARNING] > **Șablon al comunității — încă netestat cu TapHome.** Șablonul a fost generat în portalul TapHome din documentația Somfy pentru Developer Mode; numele stărilor și comenzilor dispozitivelor provin din surse ale comunității (Somfy nu le enumeră). A fost testat doar cu un gateway simulat pe un TapHome Core 2025.2 local, nu cu un gateway TaHoma real și nici cu motoare Somfy reale, iar experiența din teren este binevenită. Descărcați fișierul XML de pe această pagină sau din portalul TapHome: [Somfy TaHoma — șablon al comunității](https://portal.taphome.com/portal/community/somfy-tahoma-http), și importați-l ca modul nou. **[Somfy TaHoma — io and RTS shading motors (Developer Mode, local API)](https://portal.taphome.com/ro/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] > **Motoarele Somfy cu fir nu au nevoie de gateway.** Un motor Somfy de 230 V fără receptor radio (de exemplu Somfy WT, patru conductori — PE, N, sus, jos) este controlat de TapHome direct cu module cu relee, ca orice alt motor de umbrire — vedeți [Cerințe → Umbrire](https://taphome.com/ro/docs/setup/requirements/#shading). Acest șablon este pentru motoarele radio (io-homecontrol sau RTS) asociate cu un gateway TaHoma. ## Gateway-uri acceptate Potrivit Somfy, Developer Mode funcționează pe marea majoritate a gateway-urilor TaHoma. **Nu este disponibil** pe: - TaHoma box sau Somfy box din prima generație (formă pătrată) - Connectivity Kit ## Conexiunea hardware Nu este necesar niciun cablaj. Gateway-ul TaHoma și TapHome Core trebuie să fie în aceeași rețea locală. Gateway-ul folosește un certificat semnat de autoritatea autosemnată Overkiz; șablonul se conectează ignorând erorile de certificat, deci nu trebuie instalat niciun certificat. ## Configurare ### Activarea Developer Mode și crearea unui token 1. Deschideți aplicația **TaHoma by Somfy**. 2. Mergeți la **Configure the installation › Access the parameters** al gateway-ului TaHoma. 3. Atingeți **de 7 ori** PIN-ul gateway-ului (de exemplu 2001-1234-5678) — Developer Mode se activează și pornește API-ul local al gateway-ului. 4. În meniul **Developer Mode**, generați un token. Tokenul poate fi citit și copiat doar la creare — salvați-l imediat. Se pot genera mai multe tokenuri; dacă un token se pierde, generați unul nou și introduceți-l în TapHome. ### Găsirea adreselor dispozitivelor Fiecare motor asociat cu gateway-ul are o adresă, `deviceURL`. Adresele se obțin din lista de dispozitive a gateway-ului, cu tokenul — de exemplu de pe un computer din aceeași rețea: ``` curl -k -H "Authorization: Bearer " https://:8443/enduser-mobile-web/1/enduserAPI/setup/devices ``` Găsiți motorul după `label` (numele din aplicația TaHoma) și copiați-i `deviceURL` exact așa cum este afișat. Șablonul îl codifică singur pentru cerere. | Protocol | Format | Exemplu | |---|---|---| | io-homecontrol | `io://{gateway-pin}/{device-id}` | `io://1234-5678-9012/4820485` | | RTS | `rts://{gateway-pin}/{device-id}` | `rts://1234-5678-9012/987654321` | Același răspuns arată ce acceptă fiecare motor: `definition.states` și `definition.commands`. Șablonul așteaptă starea `core:ClosureState` și comanda `setClosure` la un rulou sau o copertină, `core:ClosureState`, `core:SlateOrientationState` și `setClosureAndOrientation` la o jaluzea și `open`, `my`, `stop` și `close` la un motor RTS. Un motor a cărui definiție nu conține aceste nume nu va funcționa cu dispozitivul respectiv. ### Parametrii de import | Parametru de import | Descriere | Valoare substituent | |---|---|---| | `GatewayAddress` | Adresa IP sau numele de gazdă al gateway-ului TaHoma, de exemplu `gateway-1234-5678-9012.local` | `192.168.1.100` | | `BearerToken` | Tokenul din Developer Mode | (gol) | | `SlideDeviceUrl` | `deviceURL` al ruloului sau copertinei io | `io://1234-5678-9012/12345678` | | `BlindDeviceUrl` | `deviceURL` al jaluzelei io | `io://1234-5678-9012/12345678` | | `RtsDeviceUrl` | `deviceURL` al motorului RTS | `rts://1234-5678-9012/12345678` | Dacă folosiți adresa IP, rezervați-o pentru gateway în router, ca să nu se schimbe. Șablonul are câte un dispozitiv din fiecare tip. Ștergeți dispozitivele de care nu aveți nevoie. Pentru alte motoare, importați din nou șablonul cu celelalte adrese — fiecare import adaugă un modul de gateway cu propriile dispozitive — și ștergeți dispozitivele în plus, sau modificați variabila `DeviceUrl` a unui dispozitiv. ## Funcțiile dispozitivului ### Gateway Modulul citește gateway-ul la fiecare 30 s și afișează trei atribute de service: **Versiunea protocolului** (versiunea API-ului local), **ID gateway** (PIN-ul gateway-ului) și **Starea conectivității** (de exemplu OK). La un token greșit, modulul afișează eroarea „Check Bearer token in TaHoma By Somfy app → Developer Mode”. ### Rulouri și copertine io - **Rulou / copertină io** — poziția unui rulou sau a unei copertine io-homecontrol. Gateway-ul raportează 0 = complet deschis și 100 = complet închis; în TapHome 0 % este complet sus și 100 % complet jos, aceeași direcție. Dispozitivul citește poziția la fiecare 5 s și mișcă motorul cu comanda `setClosure`. ### Jaluzele exterioare io - **Jaluzea exterioară io** — poziția și unghiul lamelelor unei jaluzele exterioare io-homecontrol. Ambele sunt trimise împreună într-o singură comandă `setClosureAndOrientation`, astfel încât o schimbare a poziției trimite și unghiul actual al lamelelor, iar o schimbare a lamelelor poziția actuală. Când TapHome schimbă simultan poziția și lamelele, comanda identică este trimisă o singură dată. ### Motoare RTS Motoarele RTS (Radio Technology Somfy) folosesc radio unidirecțional: primesc comenzi, dar nu își raportează poziția. | Valoare | Comandă | Acțiune | |---|---|---| | Deschide | `open` | Mișcare în sus / deschidere completă | | My | `my` | Deplasare în poziția preferată memorată în motor | | Stop | `stop` | Oprirea mișcării | | Închide | `close` | Mișcare în jos / închidere completă | - **Motor RTS** — după fiecare comandă, comutatorul arată **Pregătit**, astfel încât aceeași comandă poate fi trimisă din nou, de exemplu Închide după ce motorul a fost mișcat cu propria telecomandă. Alegerea Pregătit trimite Stop. Niciun dispozitiv nu mișcă un motor la pornirea TapHome Core: își preiau starea de la gateway, nu din ultima valoare din TapHome. ### Cum comunică șablonul cu gateway-ul Toate apelurile merg la `https://:8443/enduser-mobile-web/1/enduserAPI` cu antetul `Authorization: Bearer `; fără token funcționează doar `GET /apiVersion`. Fiecare dispozitiv io își citește stările din `/setup/devices/{deviceURL}/states` la fiecare 5 s, iar toate dispozitivele trimit comenzi prin `POST /exec/apply`. Somfy nu impune o limită de apeluri pentru API-ul local, dar avertizează că apelurile prea dese supraîncarcă gateway-ul și întârzie controlul motoarelor — țineți cont de asta când sunt multe motoare pe un singur gateway. ## Depanare ### Eroarea „Check Bearer token in TaHoma By Somfy app → Developer Mode” Gateway-ul a răspuns cu HTTP 401: tokenul este greșit sau nu a fost copiat complet. Generați un token nou în aplicația TaHoma by Somfy › Developer Mode și introduceți-l în TapHome. ### Eroare de dispozitiv „Device unavailable (HTTP …)” Gateway-ul nu cunoaște adresa. Verificați dacă `deviceURL` este copiat exact din `GET /setup/devices` — necodificat, fără spații — și dacă aparține tipului corect de dispozitiv. ### Eroare de dispozitiv „Closure state not available” Gateway-ul a răspuns, dar fără starea `core:ClosureState`. Verificați `definition.states` ale motorului. Unele copertine raportează în schimb starea `core:DeploymentState` (0 = retrasă, 100 = desfășurată); pe aceasta șablonul nu o citește. ### Gateway-ul arată un dispozitiv ca indisponibil, dar acesta funcționează Unele versiuni de firmware TaHoma raportează dispozitivele io ca indisponibile (`available: false`), deși funcționează normal — semnalat către Somfy în depozitul Developer Mode. Șablonul nu folosește acest indicator și nu afișează nicio eroare din cauza lui. ### Motorul RTS nu se mișcă Comenzile RTS sunt semnale radio unidirecționale fără confirmare de livrare, de aceea TapHome nu afișează nicio eroare când motorul nu reacționează. Verificați dacă motorul este în raza radio a gateway-ului și dacă se mișcă din aplicația TaHoma by Somfy. ### Numele de gazdă al gateway-ului nu este accesibil Dacă `gateway-{pin}.local` nu se rezolvă, folosiți adresa IP a gateway-ului — o găsiți în router. Developer Mode trebuie să rămână activat: el este cel care activează API-ul local al gateway-ului. ## Dispozitive disponibile Gateway Somfy TaHoma Modul Atribute de service | | | |------------------------|-------------------------------------------------------------------------------------------------------------| | Versiunea protocolului | Versiunea API-ului local raportată de gateway | | ID gateway | PIN-ul gateway-ului (de exemplu 1234-5678-9012), același PIN care face parte din adresa fiecărui dispozitiv | | Starea conectivității | Starea conectivității raportată de gateway, de exemplu OK | Variabile personalizate `BearerToken` (string) Tokenul API-ului local TaHoma, creat în aplicația TaHoma by Somfy › Developer Mode; modulul și fiecare dispozitiv îl trimit ca '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. Rulou / copertină io Glisare Poziția unui rulou sau a unei copertine io-homecontrol — 0 % complet deschis, 100 % complet închis, aceeași direcție ca în gateway numeric (0–100) Unitate: % json\_path Variabilă: `DeviceUrl` — Adresa motorului în gateway-ul TaHoma (deviceURL din GET /setup/devices), de exemplu io://1234-5678-9012/4820485 Jaluzea exterioară io Jaluzea Poziția și unghiul lamelelor unei jaluzele exterioare io-homecontrol — ambele sunt trimise împreună într-o singură comandă numeric (0–100) Unitate: % json\_path Variabilă: `DeviceUrl` — Adresa jaluzelei în gateway-ul TaHoma (deviceURL), de exemplu io://1234-5678-9012/5932104 Motor RTS Comutator cu mai multe valori Comenzi pentru un motor RTS unidirecțional — Deschide, My (poziția preferată), Stop sau Închide; RTS nu raportează poziția, de aceea comutatorul arată Pregătit după fiecare comandă enum numeric Valori / Stări: Pregătit · Deschide · My · Stop · Închide Variabilă: `DeviceUrl` — Adresa motorului RTS în gateway-ul TaHoma (deviceURL), de exemplu rts://1234-5678-9012/987654321 **Conexiune:** Packet Parser → HTTP • Nume gazdă: `gateway-{pin}.local.local` Îmbunătățiri posibile (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. ## Surse - 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 ## Documentație asociată - [Packet Parser Integration](https://taphome.com/ro/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/ro/docs/integration/packet-parser/) - [Funcții Packet parser](https://taphome.com/ro/docs/script/packet-parser/) - [Funcții de parsare](https://taphome.com/ro/docs/script/parsing-functions/)