INTEGRATION GUIDE
ELAN® INTEGRATION for TAHOMA® SWITCH
VERSION 1.1 | OCTOBER 2024 | Prepared by PROJECT SERVICES
[Zigbee logo] [RTS logo] Radio Technology Somfy
TABLE OF CONTENTS
I. INTRODUCTION
The Somfy Organization's strength has been demonstrated with 50 years of experience in motorization. As leaders in the shading industry with innovative and modern solutions for homes and commercial buildings, Somfy offers the widest range of strong, quiet motors and controls for all types of applications and technologies.
Who is this Guide for?
This guide is aimed at providing support and guidance to ELAN® Integrators for achieving complete automation of Zigbee® and Radio Technology Somfy® (RTS) motors with the TaHoma® switch.
What does this Guide contain?
The sections of this guide contain walkthroughs and methods of controlling Zigbee and RTS devices using the TaHoma® switch(es) as the bridge between ELAN and Smart Shading by Somfy.
For questions or assistance please contact technical support:
(800) 22-SOMFY (76639)
Get answers to your questions from our Somfy FAQ page: www.somfysystems.com/en-us/support/faq
Follow the steps to access Service & Support.
How should this Guide be used?
This guide is intended to be used as a reference manual.
II. OVERVIEW
The Somfy TaHoma® switch provides a single platform for Somfy Zigbee and RTS with a wide range of interior and exterior applications.
- The TaHoma system supports up to 60 Zigbee motors (max. 50 WireFree), 10 smart plugs, 15 remotes, and 40 channels of RTS.
- Join up to 10 TaHoma switch hubs for multi-zone control (RTS only).
- The TaHoma system supports a maximum of 40 scenes with schedules per install.
Each TaHoma switch is connected to Wi-Fi or directly to the local area network by an optional Ethernet adaptor for IP Integration with third-party control systems. TaHoma is compatible with the Somfy Synergy™ API.
Details of this controller and commissioning instructions are available in the Somfy TaHoma pro Dealer Version Programming Guide.
RESOURCES & APPLICATIONS
Visit www.somfypro.com for the following guides:
- Somfy TaHoma pro Dealer Version Programming Guide
- Somfy RTS Pocket Programming Guide
Subscribe to the Somfy YouTube Channel www.youtube.com/somfysystems
Visit Somfy U for all the training you need – your pace, your place www.somfyu.com
Visit the Google Play or iOS App Store for the TaHoma by Somfy app:
[App Store Icons - Google Play and iOS App Store]
SYSTEM REQUIREMENTS
- PC running Windows 10 or higher
- ELAN Management Cloud v1.3.0 or higher
- ELAN Core Module 8.3.11 or higher
[ELAN logo] Management Cloud™
III. INSTALLATION
BUTTONS & INDICATORS
TaHoma® switch #1871037 / TaHoma® switch (with ethernet adaptor) #1871038
TOP LED BEHAVIOR:
- BLUE: WI-FI SETTING PROCESS
- WHITE: WI-FI SEARCH - 2 TIMES, WI-FI LOST - 1 TIME
- RED: SCENE STOPPED - SOLID, CONNECTION OUTAGE - BLINKING
- OFF: STANDING BY
- AMBER: RESTARTING
- GREEN: TAHOMA PRO MODE
BOTTOM LED BEHAVIOR:
- WHITE: POWERED, CONNECTED TO CLOUD SERVER - SOLID (CAN BE DEACTIVATED)
- RED: POWERED, NOT CONNECTED TO CLOUD SERVER - SOLID
- OFF: NOT POWERED
Buttons: Scene 1 Button, Stop Button, Scene 2 Button (Control customized scene 1, Stop scene underway, Control customized scene 2)
Ports: Micro USB Port (Connect power or Ethernet Adaptor), Reset Button (PRESS & HOLD to reset TaHoma switch)
TaHoma® Ethernet Adaptor #9028054
(Sold Separately or included with #1871038)
Connect for a wired local area network connection.
- Micro USB (Connect to TaHoma® switch for power and Ethernet)
- Ethernet Port (Connect to network router or switch)
LED BEHAVIOR:
- GREEN: ETHERNET CONNECTION
- AMBER: DATA TRANSFER
Ysia 1 & 5 Zigbee Remotes
Ensure the remote is powered. Pressing any button will illuminate the LED(s). Status LED will blink RED if the battery level is not sufficient for programming. NOTE: Check the charge of the batteries in the remote.
Buttons: UP Button, MY/STOP Button, DOWN Button, Channel Selection Button (To select channel), Programming Button (To pair and reset products)
Indicators: Status LED Indicator (Commands and Zigbee network activity), Channel LED Indicator (Show channel selected)
[Ysia 1 Zigbee #1871153 logo] [Ysia 5 Zigbee #1871154 logo]
Plug-in Power Supply Required (Included with TaHoma® switch)
Connect to line-voltage to power TaHoma switch.
- Power Supply (Plug-in Transformer to line-voltage outlet)
- Micro USB (Connect power to TaHoma switch)
- Standard USB (Connect cable to Transformer)
WAKING THE MOTOR
Ensure the motor has required power available.
Using a small paper clip or similar, BRIEFLY PRESS the Programming Button on the head of the motor OR PLUG IN the battery supply/charger.
The motor will jog (briefly move up and down), and the LED will illuminate GREEN for 2 seconds. The LED will blink AMBER continuously during programming.
Motor Types & Indicators
DRAPERY MOTOR
Components: Programming Button, Motor Status LED
[Diagram description: Shows a drapery motor with programming button and status LED.]
ROLLER MOTORS
Components: Motor Status LED, Programming Button
[Diagram description: Shows roller motors (Sonesse® 40 120V AC Zigbee, Sonesse® 30 24V DC Zigbee) with status LED and programming button.]
TILT MOTOR
Components: Motor Status LED, Programming Button
[Diagram description: Shows a tilt motor (Sonesse® 30 ULTRA WireFree Li-Ion Zigbee) with status LED and programming button.]
CORD LIFT MOTOR
Components: Motor Status LED, Programming Button
[Diagram description: Shows a cord lift motor with status LED and programming button.]
Smart Plug Zigbee #1871217
Ensure the Smart Plug is plugged into a properly powered outlet. QR Code and power button are on opposite sides of the plug.
LED BEHAVIOR:
- RED (SOLID 3s): NOT CONNECTED, POWERED - OUTPUT OFF
- AMBER/GREEN (FLASHING): PAIRING MODE
- GREEN (SOLID 3s): CONNECTED, POWERED - OUTPUT ON
- OFF: NOT PAIRED, NOT POWERED
Components: Power Button
MOTOR STATUS LED BEHAVIOR (for Tilt/Cord Lift Motors)
- AMBER: MOTOR IS NOT SET IN SETTING MODE / IN ADJUSTMENT MODE
- GREEN: MOTOR IS CHARGING / CONFIRMED SETTING
- RED: LOW BATTERY CHARGE, THERMAL PROTECTION, IMPOSSIBLE SETTING
- NOT ILLUMINATED: ONCE PAIRED AND OPERATIONAL
IV. SYSTEM PREPARATION
SOMFY SYSTEM
A fully operational TaHoma system is required prior to ELAN programming. The TaHoma system supports up to 60 Zigbee motors (max. 50 WireFree), 10 smart plugs, 15 remotes, and 40 channels of RTS.
RTS devices programmed to an RTS channel will only receive commands from the associated TaHoma switch hub. Hubs must be placed within 25-35' of the devices they control.
- Confirm with the Shade Commissioning Agent that the TaHoma switch firmware is up to date.
- An Integration Report is generated in the TaHoma app which will include the TaHoma switch PIN and IP address.
- Ensure that a DHCP Reservation via MAC Address of the TaHoma switch is being used.
- Third-Party Integration must first be enabled in the TaHoma app (see Appendix A).
ELAN SYSTEM
A fully operational ELAN system is required prior to TaHoma integration.
V. SET UP
DOWNLOAD DRIVER
- OPEN the ELAN Management Cloud.
- SELECT "Marketplace” (Marketplace is the Shopping Cart icon).
- ENTER "somfy" in the Search field.
- SELECT "Somfy TaHoma".
- SELECT "FREE". The file will download to the default web browser Downloads folder.
[Screenshot description: ELAN Management Cloud Marketplace showing Somfy TaHoma driver available for download.]
IMPORT TAHOMA DRIVER
Import the latest TaHoma driver from the ELAN Marketplace. A fully operational TaHoma system is required prior to ELAN programming.
- In the ELAN Management Cloud, LAUNCH the Configurator.
- SELECT "Lighting".
- SELECT the "Lighting Interfaces" arrow or RIGHT-CLICK "Lighting Interfaces".
- SELECT "Add New Lighting Interface...".
- SELECT "Search Folder".
- SELECT the driver folder where the Somfy TaHoma driver was downloaded.
- SELECT "OK".
[Screenshot description: ELAN Configurator showing the process of adding a new lighting interface.]
ADD INTERFACE DRIVER
A fully operational TaHoma system is required prior to ELAN programming. For multiple TaHoma installations, repeat the steps below for each additional TaHoma switch.
- ENTER an associated location name for the TaHoma switch in the Name field.
- SELECT "Somfy TaHoma" in Device Type list.
- SELECT "OK".
[Screenshot description: Dialog box to add a new lighting interface, selecting Somfy TaHoma.]
NETWORK SET UP
Third-Party Integration must be enabled in the TaHoma app. Refer to the Integration Report for the TaHoma switch IP address. Ensure that a DHCP Reservation via MAC Address of the TaHoma switch is being used. Shades will auto-populate when communication is established.
- ENTER the IP Address of the TaHoma in the IP Address field.
- SELECT "Apply".
- In the TaHoma app Partners section, SELECT "ELAN" (see Appendix A).
- CONFIRM the Status displays "Ok". The Status will change to GREEN when communication is successfully established.
Select and rename each device listed to the appropriate location where necessary.
[Screenshot description: ELAN Configurator showing network setup for Somfy TaHoma, including IP address and status.]
DEVICE TEST
See Appendix B of this guide for a list of Somfy TaHoma specific commands and actions. RTS motors do not report positional feedback. RTS motors are capable of one programmable "my" or favorite position that requires an End Raise/Lower command when the motor is at rest.
Test RTS Motors
- SELECT an RTS Device [SHADE].
- SELECT any of the three commands under Device Testing.
[Diagram description: Device Testing interface for RTS Motors with buttons: Begin Raise, Begin Lower, End Raise/Lower.]
Test Zigbee Motor [SHADE] Profile
NOTE: Zigbee devices will appear as a shade for Raise and Lower commands.
- SELECT a Zigbee [SHADE].
- SELECT any of the three commands under Device Testing.
[Diagram description: Device Testing interface for Zigbee [SHADE] motors with buttons: Begin Raise, Begin Lower, End Raise/Lower.]
Test Zigbee Motor [DIMMER] Profile
NOTE: Zigbee devices will appear as a dimmer for percentage commands.
- SELECT a Zigbee [DIMMER].
- SELECT any of the percentage commands under Device Testing.
[Diagram description: Device Testing interface for Zigbee [DIMMER] motors with buttons: Off, On (Last Level), On Full, Go to 60%, Go to 50%, Go to 40%, Go to 90%, Go to 30%, Go to 80%, Go to 20%, Go to 70%, Go to 10%.]
Test Smart Plug
- SELECT a Smart Plug [SWITCH].
- SELECT any of the two commands under Device Testing.
[Diagram description: Device Testing interface for Smart Plug with buttons: Off, On.]
APPENDIX
[APPENDIX A] ENABLE THIRD-PARTY INTEGRATION
Steps within the TaHoma by Somfy app:
- OPEN the TaHoma by Somfy app.
- SELECT the Menu icon in the bottom bar.
- SELECT "Partner systems".
- SELECT "ELAN".
- SELECT "Continue".
The Integration Report will display all connected products.
[Screenshot description: TaHoma app interface showing Partner systems integration options, including ELAN.]
[APPENDIX B] AVAILABLE COMMANDS & ACTIONS
TAHOMA ZIGBEE [SHADE] COMMANDS
Command | Action |
---|---|
Begin Lower | Moves blind to the fully closed position |
Begin Raise | Moves blind to the fully open position |
End Raise/Lower | Stops blind when moving |
TAHOMA ZIGBEE [DIMMER] COMMANDS
Command | Action |
---|---|
Off | Moves blind to the fully closed position |
On Full | Moves blind to the fully open position |
On (last level) | Last ON position |
Go to % | Percentage positions between 90% & 10% |
TAHOMA SMART PLUG [SWITCH] COMMANDS
Command | Action |
---|---|
On | Turns power on to lighting or small appliance |
Off | Turns power off to lighting or small appliance |
TAHOMA RTS [SHADE] COMMANDS
Command | Action |
---|---|
Begin Lower | Moves blind to the fully closed position |
Begin Raise | Moves blind to the fully open position |
End Raise/Lower | Stops blind movement or moves blind to the programmed "my" position if the blind is at rest |