Home page new - caHome page new - ca
SomfyPro - USA - usSomfyPro - USA - us
Somfy FAQ for Motorized Blinds, Shades, Awnings & More
Somfy USomfy U
Installation Guide for somfy models including: 1871038 Ta Homa Switch, 1871038, Ta Homa Switch, Homa Switch, Switch
Somfy ation
Products - us
File Info : application/pdf, 18 Pages, 2.69MB
DocumentDocumentINTEGRATION GUIDE SAVANT INTEGRATION for TAHOMA® SWITCH INTEGRATION GUIDE SAVANT INTEGRATION for TAHOMA® VERSION 1.1 | MARCH 2025 | Prepared by PROJECT SERVICES TABLE OF CONTENTS I. INTRODUCTION --------------------------------------------------- 3 II. OVERVIEW ------------------------------------------------------- 4 RESOURCES & APPLICATIONS SYSTEM REQUIREMENTS III. INSTALLATION ---------------------------------------------------- 5 BUTTONS & INDICATORS IV. SYSTEM PREPARATION --------------------------------------------- 7 SOMFY SYSTEM SAVANT SYSTEM V. SET UP ----------------------------------------------------------- 7 ADD TAHOMA PROFILE NETWORK SETUP REQUEST AUTHORIZATION TOKEN ADD ZIGBEE PRODUCTS ADD RTS PRODUCTS APPENDIX ------------------------------------------------------------ 16 A. ENABLE THIRD-PARTY INTEGRATION B. AVAILABLE COMMANDS & ACTIONS 2 of 18 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 SAVANT Integrators for achieving complete automation of ZigBee® and Radio Technology Somfy® (RTS) motors with the Somfy TaHoma® switch. What does this Guide contain? The sections of this guide contain walkthroughs and methods of controlling Zigbee and RTS motors using the TaHoma® switch as the bridge between SAVANT 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. 3 of 18 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 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: SCAN ME SYSTEM REQUIREMENTS Mac OS Savant Racepoint Blueprint Version 9.2.2 or newer Somfy TaHoma Profile Version 1.5 or newer NOTE: Savant does not support the control of Somfy tilt products or lighting devices (Somfy Smart Plugs & Lighting Receivers). 4 of 18 III. INSTALLATION BUTTONS & INDICATORS 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 TaHoma® switch #1871037 TaHoma® switch (with ethernet adaptor) #1871038 Scene 1 Button Stop Button Scene 2 Button Control customized Stop scene Control customized scene 1 underway scene 2 Micro USB Port Connect power or Ethernet Adaptor BOTTOM LED BEHAVIOR: WHITE POWERED, CONNECTED TO CLOUD SERVER SOLID (CAN BE DEACTIVATED) RED POWERED, NOT CONNECTED TO CLOUD SERVER - SOLID OFF NOT POWERED 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 Micro USB Port Connect power through Ethernet Adaptor 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 Status LED Indicator Commands and Zigbee network activity Ysia 1 Zigbee #1871153 Ysia 5 Zigbee #1871154 UP Button MY/STOP Button 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 DOWN Button Channel LED Indicator Show channel selected Channel Selection Button To select channel Programming Button To pair and reset products 5 of 18 BUTTONS & INDICATORS 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. ROLLER MOTORS Motor Status LED Sonesse® 40 120V AC Zigbee shown above DRAPERY MOTOR Programming Button Programming Button Sonesse® 30 24V DC Zigbee shown above Sonesse® 30 ULTRA WireFree Li-Ion Zigbee shown above (Same for Sonesse® WireFree motors) MOTOR STATUS LED BEHAVIOR: 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 CORD LIFT MOTOR Programming Button Motor Status LED Motor Status LED March 2019 Rev C 6 of 18 IV. SYSTEM PREPARATION SOMFY SYSTEM A fully operational TaHoma system is required prior to SAVANT 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) SAVANT SYSTEM A fully operational SAVANT system is required prior to TaHoma integration. · SAVANT programming should be complete including the System Host and network devices V. SET UP ADD TAHOMA PROFILE A Somfy TaHoma switch profile is required for each TaHoma switch installed. 1) SEARCH for and SELECT Somfy TaHoma in the Library 2) DRAG-AND-DROP the TaHoma Profile into the configuration 3) SELECT "Shared Equipment" Note: The component must be added to the Shared Equipment Zone. 4) ENTER a profile name in the Component Name field 5) SELECT "Choose" 6) REPEAT step 2 for each TaHoma switch installed 7 of 18 NETWORK SETUP 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. Multiple TaHoma profiles need to be included for all TaHoma boxes in the same project. 1) SELECT "Ethernet" under Control Ports for the TaHoma Profile 2) SELECT "Network Device" and CHOOSE the Ethernet Port to use 3) ENTER the IP Address of the TaHoma, then SELECT "OK" 4) CONFIRM the TaHoma profiles added are connected to the Ethernet Ports of the Network Device 8 of 18 5) SELECT "Generate Services," then WAIT for the process to complete 6) SELECT "Upload to Master," then SELECT "Save and Upload," then WAIT for the Progress to complete 7) BROWSE for a file location, NAME the configuration file, then SELECT "Upload" 8) OPEN the System Monitor and ensure the Savant System Host is online NOTE: The upload is complete when the status circle changes from RED to GREEN. 9 of 18 REQUEST AUTHORIZATION TOKEN An Authorization Token is required for Third-Party Integration and must be enabled first in the TaHoma app (see Appendix A). An Authorization Token is required for each Somfy TaHoma profile installed. 1) CREATE a new service, SELECT "General Programmable Service Requests" 2) SELECT the "+" Button , ENTER "Create Token", then SELECT "Create" 3) DOUBLE-CLICK on the "Create Token" request added to the Service Requests 4) SEARCH for the shade controller 5) DOUBLE-CLICK on the "Shade_Blind Controller" to open it 6) In the Function drop-down, SELECT "Shade_controller" 7) In the Resource drop-down, SELECT "Custom" 8) In the Action drop-down, SELECT "TokenRefresh" 9) SELECT "File", then "Save", then CLOSE the service screens 10) SELECT "Generate Services", WAIT for the process to complete, then CLOSE the service screens 11) SELECT "File", then SELECT "Save As", then NAME the configuration and SELECT "Save" 10 of 18 12) SELECT "Service Events" 13) SELECT the Host device in the Service list 14) SELECT the "Create Token" in the Event drop-down list, then SELECT "Send Event" 15) SELECT "System State" 16) ENTER "token" in the Search field 17) COPY the appropriate value for the TaHoma Profile under the State Value column Note: If there are multiple TaHoma switch hubs, copy the correct Token for the applicable TaHoma. 11 of 18 18) OPEN the TaHoma Profile "Inspector Window" 19) SELECT "State Variables" in the Show drop-down, then Select "token" 20) PASTE the value copied in step 7 into the Initial Value field 21) FOLLOW steps 5-8 of the Network Setup section of this guide 12 of 18 ADD ZIGBEE PRODUCTS To add Zigbee devices, follow the steps below. Refer to the Integration Report for the TaHoma motor addresses (see Appendix A). NOTE: Savant does not support the control of Somfy tilting products or lighting devices (Somfy Smart Plugs & Lighting Receivers). 1) SELECT "Tools" 2) SELECT "Settings" 3) SELECT "Shades" 4) SELECT "+" to add a device 5) SELECT the appropriate TaHoma profile from the Controller drop-down 6) SELECT a Location 7) SELECT an entity to use from the Entity drop-down SHADE TYPE RTS Shade Zigbee Shade Zigbee Shade Group ENTITY TO USE Shade Individual Variable Shade Shade FEEDBACK AND SCENES NO YES NO 8) ENTER a name for the device under the Label column 9) ENTER the device address from the TaHoma Integration Report in the Address column NOTE: Use the numeric device ID after zigbee. or RTS. and before the # or / (see Appendix A for integration report) 10) SELECT "Done" 11) FOLLOW steps 5-8 of the Network Setup section of this guide 13 of 18 ADD RTS PRODUCTS To add and control RTS devices, follow the steps below. Refer to the Integration Report for the TaHoma motor addresses (see Appendix A). 1) Follow the steps from Add TaHoma Profile Section 2) Follow the steps from Network Setup Section using the same IP Address 3) SELECT the new "TaHoma Profile" 4) SELECT "Show Inspector" on the Toolbar 5) ENTER "Tahoma RTS" into the Device Name field 6) SELECT "State Variables" in the Show drop-down menu 7) TYPE "RTS" (Capitalized) in the Initial Value field Default Initial Value: Zigbee 8) REPEAT steps 1 through 7 for each TaHoma switch hub 9) SELECT "Generate Services" on the Toolbar 10) SELECT "Done" 14 of 18 11) SELECT "Tools" 12) SELECT "Settings" 13) SELECT "Shades" 14) SELECT "+" to add a device 15) SELECT the appropriate TaHoma profile from the Controller drop-down 16) SELECT a Location for the Shade 17) SELECT "Shade" from the Entity drop-down menu SHADE TYPE RTS Shade Zigbee Shade Zigbee Shade Group ENTITY TO USE Shade Individual Variable Shade Shade FEEDBACK AND SCENES NO YES NO 18) ENTER a name for the device under the Label column 19) ENTER the device address from the TaHoma Integration Report in the Address column NOTE: Use the numeric device ID after zigbee. or RTS. and before the # or / (see Appendix A for integration report) 20) SELECT "Done" 21) FOLLOW steps 5-8 of the Network Setup section of this guide 15 of 18 APPENDIX [APPENDIX A] ENABLE THIRD-PARTY INTEGRATION 1) OPEN the TaHoma by Somfy app 2) SELECT the Menu icon in the bottom bar 3) SELECT "Partner systems" 4) SELECT "SAVANT" 5) SELECT "Continue" NOTE: The Integration Report will display all connected products. 16 of 18 [APPENDIX B] AVAILABLE COMMANDS & ACTIONS NOTE: Savant does not support integration with the following Somfy products: · Tilt Motors · Motor Receivers · Lighting devices: · Smart Plugs · Lighting Receivers Close Open Stop My Slider TAHOMA ZIGBEE COMMANDS Moves blind to the fully closed position Moves blind to the fully open position Stops blind when moving Moves blind to the programmed "my" position if blind is at rest (Requires SAVANT custom programming) Moves blind to a percent openness (0-100) Close Open Stop My TAHOMA RTS COMMANDS Moves blind to the fully closed position Moves blind to the fully open position Stops blind when moving Moves blind to the programmed "my" position if blind is at rest (Requires SAVANT custom programming) 17 of 18 © Somfy Systems, Inc. · MARCH 2025 All brands, products, and trademarks are the property of their respective owners. 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. About Somfy® For over 50 years, Somfy has been pioneering innovative motorization and automated solutions for window coverings and exterior shading products. With comfort, ease of use, security, and sustainability in mind, our seamless and connected solutions are designed to help people make the move to living spaces impactful for humans and with a reduced impact on nature. New Jersey 121 Herrod Blvd. Dayton, NJ 08810 T: (609) 395-1300 F: (609) 395-1776 Somfy Systems, Inc. T: (800) 22-SOMFY www.somfypro.com Florida 1200 SW 35th Ave. Boynton Beach, FL 33426 T: (561) 995-0335 F: (561) 995-7502 California 15301 Barranca Pkwy. Irvine, CA 92618-2201 T: (949) 727-3510 F: (949) 727-3775 PS- IG43 V 1 .1 Somfy ULC T: (800) 66-SOMFY www.somfypro.ca Canada 6411 Edwards Blvd. Mississauga, ON L5T 2P7 T: (905) 564-6446 F: (905) 238-1491 18 of 18