JDK Tahoma Switch Quick App User Guide

June 15, 2024
JDK

MANUAL
Installation manual
Tahoma Switch Quick App
Version: 1.0
Date: 07-04-2023

jdkbenelux.com
All rights reserved. Information from this document may not be reproduced, stored or transferred in any form without written permission from JDK Benelux.

Introduction

The instruction is written for installers working with the FIBARO PRO smart home system. The document contains information about the installation procedure of the Tahoma Switch.

Requirements

  1. Somfy Tahoma Switch
  2. Somfy Tahoma Quick App For HC3/HC3L
  3. FIBARO Home Center 3 Lite (Min. FW versie 5.140)

Firmware
The Quick App has been tested with Somfy TaHoma switch firmware 1.15 and Home Center 3 (Lite) firmware 5.140.

Device support

The Quick App supports at least the following Somfy device types. Important:

  1. If a device type is missing, please contact us for a test programme to build it into the Quick App.
  2. Tilting an IO blind has not been tested. If you own an IO blind, please contact JDK for a test programme to build this into the Quick App.
NL ENG
Luifel Awning
Buitenscherm Exterior Screen
Exterieur Jaloezieën Exterior Venetian Blind
Garagedeur Garage Door
Pergola Pergola
Rolluik Roller Shutter
Scherm Screen
Jaloezie Venetian Blind
Stekker (IO) Plug (IO)
Raam Window
Zon sensor (IO) Sun sensor (IO)

My button
The favourite position button in the Home Center 3 child device, is automatically assigned to the my button of the Somfy device. This also makes it possible to use the my command with the Home Center 3.

Status of RTS and IO devices in the FIBARO HC3/HC3L
Somfy devices working with the RTS protocol only support 1-way communication and therefore cannot report status. This is not due to the Quick App, but is a feature of the Somfy RTS protocol. The status is therefore not updated in the Home Center 3 either. You should be aware of this when creating scenes with the Home Center 3.The status of devices using the IO protocol is updated in the Home Center 3 and in the TaHoma app.

Somfy configuration

Installation of the Somfy TaHoma switch is beyond the scope of this manual. Before proceeding, ensure that the TaHoma switch box:

  1. Connected to the same (Wi-Fi) network the Home Center 3 is connected to;
  2. The Somfy products you want to control with the HC3 are connected to the TaHoma switch;
  3. The Somfy products are functioning properly via the TaHoma app on your phone and/or tablet.
    Tip : reserve the IP address in the router’s DHCP settings.

Activate the local API

  1. Go to https://www.somfy.nl/;
  2. Click on My Account;
  3. Login with your Somfy credentials
  4. Under My products you will see the TaHoma switch, click OPEN;
  5. Click the Activate development mode button;
  6. If the activation is succeeded you’ll see the developer mode is activated.
    This mode activates the local API on your TaHoma box and enables communication with your Home Center 3.

Installation of the Tahoma Switch Quick App

  1. Log in on the FIBARO Home Center 3;
  2. Go to Settings -> 1. Devices;
  3. Click on the + to add a device;
  4. Select in the pop-up ‘other device’
  5. Select upload file;
  6. Open the file Somfy_TaHomaSwitch(xxx).fqax;
  7. The Quick App is now installed and visible in the list of devices;

Configuratie van de Tahoma Switch Quick App

  1. Go to Settings -> 1. Devices;

  2. Click on the new Somfy TaHoma switch device;

  3. Select the Variables tab;

  4. Enter the following variables;
    userId| Somfy.nl username
    ---|---
    userPassword| Somfy.nl password
    gatewayPIN| Unique PIN of Tahoma Switch, located on the bottom
    of the box or found on Somfy.co.uk at devices
    gatewayIP| The IP address of the Tahoma Box.
    Tip: Reserve this address in the router’s DHCP
    settings.

  5. Click the Save button to save the Quick App variables.

  6. Now the Quick App will log in once to the Somfy cloud environment to generate a unique token to enable communication between your Home Center 3 and your Somfy TaHoma switch;

  7. Once successful, the devices available in the TaHoma switch will be added to the Home Center 3.

1 The variable gatewayToken is automatically populated with a unique token after the Quick App successfully logs in to the Somfy server.
2 The variable updateInterval defaults to 5000 milliseconds (5 seconds). You can change this yourself if necessary. Please note, if you set the update interval very short it is possible that the Home Center 3 and/or Somfy TaHoma switch will be overloaded!

Device role setting

Note: If a blind is installed, the type is not automatically set in the HC3. This must be defined yourself in the Generic options of the device:

If the RTS venetian blind support tilting , you can control the blinds through a LUA scene with the following commands:
1 hub.call(deviceId, “tiltPositive”, 5)
hub.call(deviceId, “tiltNegative”, 5)
How far per command the slats tilt can be determined by adjusting the value 5. This may be a value between 1 and 15. The recommendation is to perform this in steps of 5.
Important : Tilting an IO blind has not been tested. If you own an IO blind, please contact JDK for a test programme to build this into the Quick App.
1 Tilting using the second slider in the HC3 device does not work. This is because Somfy performs this function incrementally and the HC3 works with a 0-100 value. These two control principles are not compatible with each other. This is not a bug in the Quick App.

Managing the Somfy devices

If you add or remove Somfy devices to the TaHoma switch, you can sync them back to your Home Center 3 by clicking the button: ‘Reload devices’ in the Somfy Quick App.
In short, devices that no longer exist on the TaHoma switch are then automatically removed in the Home Center 3 and new devices are automatically added.
Please note that when replacing defective Somfy products, in existing scenes, change the id of the old device to the id of the new device!

Generate new token
In the unlikely event of a problem with the Somfy token, you can easily generate a new token by clicking the Generate new token button in the Somfy Quick App.
The old token is then automatically deleted on the Somfy cloud server and the TaHoma switch.

controlling Somfy devices through Yubii App, Scenes and Profiles

Block Scenes
The motor can be controlled via scenes with the following actions: level, open, close, stop and favourite position.
Thereby, the level can only be operated if the motor feedback the status to the Tahoma Switch.

Scenarios (Morning & Evening)
The blinds are assigned as a ‘Roller Shutter’ in the system.
This means you can include the motor in the simple scenarios. The scenarios are designed to open/close blinds based on a specific time. Moreover, the scenarios can be customised via the Yubii App.

Profiles
The status of the blinds can be set via the Profiles. This makes it easy to close all blinds when you are absent.
When you are present, you can then open the blinds again. Setting the trigger for a profile can be done via the scenes or manually via the Yubii App.

Frequently asked questions

Can I also control Somfy motors without the Tahoma Switch with the FIBARO HC3/HC3L?

Somfy motors can only be operated without a Tahoma Switch if the motor is not equipped with RF, for example RTS and IO. If the motors uses one of these protocols, you cannot operate the motor without a Tahoma switch

Why doesn't the slider of the blind work like with a Roller Shutter 3?

Tilting using the second slider in the HC3 device does not work. This is because Somfy performs this function incrementally and the HC3 works with a 0-100 value. These two control principles are not compatible with each other. This is not a bug in the Quick App.

Can I control the Somfy motor via a Z-Wave switch or remote control?

Yes, you can control the position of the motor with scene activation of a Z-Wave switch or remote control. For example: with 1x press close the motor, 2x press open the motor, 3x press to favourite position.

Can I operate and position the Somfy motor via a Z-Wave switch or remote control?

No, this is not possible. With Z-Wave actors, we can interconnect the modules using associations. With IP integration, this is not possible.

Can the Quick App also read the status of the Somfy motor?

Somfy devices working with the RTS protocol only support 1-way communication and therefore cannot report status. This is not due to the Quick App, but is a feature of the Somfy RTS protocol. The status is therefore not updated in the Home Center 3 either. You should be aware of this when creating scenes with the Home Center 3. The status of devices using the IO protocol is updated in the Home Center 3 and in the TaHoma app.

My device is not recognised, what now?

If a device type is missing, contact us for a test programme to build it into the Quick App.

References

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>

Related Manuals