SOMFY TaHoma RTS/Zigbee Smartphone and Tablet... Quick setup guide

INTEGRATION GUIDE
INTEGRATION for
TAHOMA® ZIGBEE & RTS

TABLE OF CONTENTS
I. INTRODUCTION --------------------------------------------------- 3
II. OVERVIEW ------------------------------------------------------- 4
DECRIPTION
RESOURCES & APPLICATIONS
SYSTEM REQUIREMENTS
III. INSTALLATION ---------------------------------------------------- 5
CONNECTIONS & INDICATORS
IV. SYSTEM PREPARATION ---------------------------------------------6
SOMFY SYSTEM
CRESTRON SYSTEM
V. SET UP ----------------------------------------------------------- 7
ADD TAHOMA MOTOR CONTROL
ADD TAHOMA SMART PLUG CONTROL
REFRESH AUTHENTICATION TOKEN
OPEN XPANEL
APPENDIX ------------------------------------------------------------ 11
A. ENABLE THIRD-PARTY INTEGRATION
B. AVAILABLE COMMANDS & ACTIONS
2of 13
VERSION 1.0 | JUNE2022 | Prepared by PROJECT SERVICES
CRESTRON® INTEGRATION for TAHOMA®
INTEGRATION GUIDE

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 Crestron Integrators for achieving complete
automation of Zigbee® and Radio Technology Somfy® (RTS) motors and the Somfy TaHoma® Smartphone
and Tablet Interface.
What does this Guide contain?
The sections of this guide contain walkthroughs and methods of controlling Zigbee and RTS motors using the
TaHoma® Smartphone and Tablet Interface as the bridge between Crestron and Smart Shading by Somfy.
For questions or assistance please contact technical support:
(800) 22-SOMFY (76639)
technical[email protected]
How to use this Guide?
This guide is designed as a reference manual.
I. INTRODUCTION
3of 13

4of 13
SYSTEM REQUIREMENTS
PC running Windows 10 or higher
Crestron SIMPL Windows
Crestron 3 or 4 Series Processor
Crestron Somfy TaHoma Module
II. OVERVIEW
DESCRIPTION
The Somfy TaHoma® Smartphone and Tablet Interface provides a single platform for Somfy Zigbee and RTS with
a wide range of interior and exterior applications.
•The TaHoma system supports up to 50 Zigbee devices and 40 RTS channels
•Install up to 10 TaHoma Interfaces as zone controllers to increase the RTS range (RTS only)
•The TaHoma system can support a maximum of 40 scenes with schedules per install
Each TaHoma Interface 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 Smartphone and Tablet Interface Programming Guide.
RESOURCES & APPLICATIONS
Visit www.somfypro.com for the following guides:
•Somfy TaHoma Smartphone and Tablet Interface 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
iOS App Store
Google Play Store
Visit the Google Play or iOS App Store for the Somfy TaHoma North America App:

5of 13
CONNECTIONS & INDICATORS
III. INSTALLATION
Configuration Button
Press to enter Wi-Fi Mode
for set up
Micro USB Port
Connect power or
Ethernet Adaptor
REAR
PLUG-IN POWER SUPPLY REQUIRED
(Included with TaHoma Interface)
Connect to line-voltage to power TaHoma Interface
Micro USB
Connect power to TaHoma
Interface
Standard USB
Connect cable to
Transformer
Power Supply
Plug-in Transformer to line-
voltage outlet
LED BEHAVIOR:
BLUE
DIRECTLY CONNECTED
Wi-Fi MODE
RED
POWERED,
NOT CONNECTED
TO CLOUD SERVER
ORANGE
STARTNG UP
GREEN
CONNECTED TO NETWORK
FRONT TaHoma® Ethernet Adaptor #1870470 (Sold Separately)
Connect for a wired local area network connection
Micro USB
Connect to TaHoma Interface for
power and Ethernet
Micro USB Port
Connect power through
Ethernet Adaptor
Ethernet Port
Connect to network
router or switch LED BEHAVIOR:
GREEN
ETHERNET CONNECTION
YELLOW
DATA TRANSFER
TaHoma® RTS/Zigbee Smartphone and Tablet Interface
#1811731 (With base stand included with TaHoma Interface)

6of 13
A fully operational Crestron system is required prior to Crestron programming. Reference the Integration Report for the TaHoma Interface IP address.
A Somfy TaHoma Command Processor is required for each TaHoma Interface installed. Up to 10 Command Processors are available per project.
1) In SIMPL Windows, OPEN the “Somfy TaHoma v1.2 Demo CP3.smw” file
2) Go to the Program View, SELECT the “S-3.1 : Somfy TaHoma v1.2 Command Processor” module
3) Go to the Detail View, ENTER the TaHoma IP address in the “IPAddress” field
IV. SYSTEM PREPARATION
SOMFY SYSTEM
CRESTRON SYSTEM
A fully operational TaHoma system is required prior to Crestron programming. The TaHoma system supports up to 50 Zigbee devices and 40
channels of RTS. RTS devices programmed to an RTS channel will only receive commands from the associated TaHoma Interface.
Interfaces must be placed within 23-35 feet of the devices they control.
•Confirm with the Shade Commissioning Agent that the TaHoma Interface firmware is up to date
•An Integration Report is generated in the TaHoma App which will include the TaHoma Interface PIN and IP address
•Ensure that a DHCP Reservation via MAC Address of the TaHoma Interface is being used
•Third-Party Integration must first be enabled in the TaHoma App (see Appendix A)

7of 13
V. SET UP
ADD TAHOMA MOTOR CONTROL
1) Go to the Program View, SELECT the “S-3.3.2 : Somfy Tahoma v1.2 Motor Control” module
2) Go to the Detail View, ENTER the motor address in the “Target_ID” field
3) In the Device Info section, ENTER the motor name in the “Label” field
Reference the Integration Report in the TaHoma App to gather the motor addresses.
4) In the Button Bar, SELECT the Convert/Compile button to transfer the program to the Crestron Controller
To add multiple motor controls, COPY an existing module, PASTE it within the folder, repeat Steps 2-3 to rename each new control

ADD TAHOMA SMART PLUG CONTROL
8of 13
1) Go to the Program View, SELECT the “S-3.4.1 : Somfy TaHoma v1.2 Switch Control” module
2) Go to the Detail View, ENTER the smart plug address in the “Target_ID” field
3) In the Device Info section, ENTER the device name in the “Label” field
Reference the Integration Report in the TaHoma App to gather the smart plug addresses.
To add multiple smart plug controls, COPY an existing module, PASTE it within the folder, repeat Steps 2-3 to rename each new control
4) In the Button Bar, SELECT the Convert/Compile button to transfer the program to the Crestron Controller

An authentication token is required for Third-Party Integration. See Appendix A of this guide to enable Third-Party Integration in the TaHoma App.
If a Somfy TaHoma Interface is removed, the new TaHoma will need to request a new token.
1) CONFIRM Third-Party Integration for Crestron is enabled in the TaHoma App (see Appendix A)
2) In SIMPL Windows Program View, SELECT the “S-3.1 : Somfy TaHoma v1.2 Command Processor” module
3) Go to the Detail View, SELECT “//Refresh” to refresh the authentication token
REFRESH AUTHENTICATION TOKEN
9of 13

REFRESH AUTHENTICATION TOKEN
10 of 13
1) OPEN the “Somfy TaHoma v1.2 Demo XPANEL.c3p” file
2) SELECT “Options”
3) SELECT “Host Settings”
4) ENTER the IP address of the Crestron Controller in the “Hostname/IP Address” field
5) SELECT “Connect”
6) Use the Controls to test operation of the devices
OPEN XPANEL
See Appendix B of this guide for a list of Somfy TaHoma specific commands and actions. RTS motors do not report positional feedback.
The Position slider will not display percent levels for RTS motors.

11 of 13
APPENDIX
[APPENDIX A] ENABLE THIRD-PARTY INTEGRATION
1) OPEN the TaHoma North America App
2) SELECT the “Menu” icon in the bottom bar
3) SELECT “Third-Party Integration”
4) SELECT “Crestron” to view the Integration Report
5) SELECT “Continue” at the Warning
6) SELECT “Enable/Refresh Integrations”
7) SELECT “Ok”

[APPENDIX B] AVAILABLE COMMANDS & ACTIONS
12 of 13
TAHOMA ZIGBEE COMMANDS
Close Moves blind to the fully closed position
Open Moves blind to the fully open position
Stop Stops blind when moving
My Moves blind to the programmed “my” position if blind is at rest
Position Moves blind to a percent position closed (0-100)
TAHOMA RTS COMMANDS
Close Moves blind to the fully closed position
Open Moves blind to the fully open position
Stop Stops blind when moving
My Moves blind to the programmed “my” position if blind is at rest
Tilt Up Tilts blind up (only available for tilt blinds)
Tilt Down Tilts blind down (only available for tilt blinds)
TAHOMA SMART PLUG COMMANDS
On Turns power on to lighting or small appliance
Off Turns power off to lighting or small appliance
Toggle Sequence controls lighting or small appliance on-off

© Somfy Systems, Inc. 6/2022. All brands, products and trademarks are the property of their respective owners.
PS-IG20
V 1.0
ABOUT SOMFY
SOMFY® has been improving everyday life for more than 270 million people by designing and
manufacturing intelligent motorization solutions for interior window coverings and exterior solar
protections. Somfy innovates to automate and connect shades, blinds, draperies, awnings, rolling
shutters, exterior screens & pergolas for commercial and residential buildings in 58 countries
across the globe. With 170+ million motors produced over the last half century, Somfy is
committed to creating reliable and sustainable solutions that promote the best way of living and
well-being for all.
FOR QUESTIONS OR ASSISTANCE PLEASE CONTACT TECHNICAL SUPPORT:
(800) 22-SOMFY (76639)
technicalsupport[email protected]om
SOMFY SYSTEMS INC
SOMFY NORTH AMERICAN HEADQUARTERS
121 Herrod Blvd.
Dayton, NJ 08810
P: [phone]
F: [phone]
FLORIDA
1200 SW 35th Ave.
Boynton Beach, FL 33426
F: [phone]
CALIFORNIA
15301 Barranca Parkway
Irvine, CA 92618-2201
F: [phone]
SOMFY ULC
SOMFY Canada Division
6411 Edwards Blvd
Mississauga, ON L5T 2P7
P: [phone]
F: [phone]
www.somfypro.com
13 of 13