Project:Sandbox

Function Description
This chapter describes how to implement localization function for all kind of product profile. Localization means that the TXA100 can take control of the whole installation and make some visual effect or physical effect to a specific product and/or channel. During Localization mode, devices couldn't be controlled by group address write (TXA100 configurator becomes the only way to control leds and outputs of the installation) Since this mechanism stop normal use of device, each product has a security timeout to leave this localization mode. So, the configurator has to periodically set the localization mode to ensure that it remains the only way to control the installation.

Physical effect : The easy controller (TXA100) can invoke physical command on actuator in order to test physical connections between output channels and actuators (ligths, shutters, etc.) Visual effect : The easy controller can ask for a product or a channel to highlight information on the product itself. It can be a led notification or buzzer sound. Information report : The product can report front push button event to the controller.

FEC Product
For FEC product these mechanism is provided by A_NetworkParameter_Write knx services on Easy mode device Object. Activation of localization mode is done with PID_LOCALISATION_MODE (60) on Broadcast Individual Address (0x0000) (data : 0x01 for activation and 0x00 for deactivation). For FEC devices, the TXA100 should repeat the localisation mode every 60 s. Physical and Visual effect have to be done with PID_LOCALISATION_COMMAND (62) on Broadcast or Product Individual Address with value as below :

where :
 * CCCCCCCC CCCCCCCC:  the channel number of devices from 1 (16 bits format)
 *  S:  Start (1), Stop (0)
 *  P:  Physical (0), Visual (1) effect command

Information report is received by the TXA100 through A_NetworkParameter_InfoReport and PID_LOCALISATION_REPORT (61) with these data event Filter should be "(" + DataLink.P_APCI + "=" + APCI.NETWORKPARAM_RESPONSE + ")" and the event handler should check the Object type (18) and PID (61)

where :
 * CCCCCCCC CCCCCCCC : the channel number of devices from 1 (16 bits format) or 0 for all channels of the device

Visual Effect
Localisation for TP SEC product is done through a dedicated type of channel called Localisation Channel. The configurator used GroupValueWrite KNX service

This kind of channel is present in the DD2 response of the product and the TXA100 catalog.

Depending of the number of localizable channel of the TP SEC device, you can find 4 localisation channel type : Each of those channel type are composed of 2 Datapoint : Localisation mode datapoint is used to activation localisation mode of the device : Channel Activation is used to start and stop each channel of of the product. Depending of the number of localisable channels, this datapoint have 1 bit of data for each localisable channel. Exemple below set visual effect for channels number 1, 4 and 14 (B0b0: channel 1, B0b3: channel 4, B1b5: Channel 14)
 * 00091FF00800 : for up to 8 localizable channels
 * 00091FF10800 : for up to 16 localizable channels
 * 00091FF20800 : for up to 24 localizable channels
 * 00091FF30800 : for up to 32 localizable channels
 * Localisation mode : 1 bit input datapoint (Index 1)
 * Channel Activation : 8, 16, 24 or 32 bits input/ouptut datapoint (Index 2)
 * Value 1 : The device will enter in localisation mode
 * Value 0 : The device will leave its localisation mode

TXA100 during configuration should deploy GroupAddress silently en these datapoint for all TP SEC devices :

Localisation mode datapoint : Same address for all devices 0xC000

Channel activation datapoint : One common address for all devices 0xC0FF AND one individual group address 0xC00x in this range [0x0C01, 0xC0FE]. Individual Group Address should be used as transmit group address. In the TX100, the individual group address for channel activation datapoint is calculated depnding on the Individual address. For example, a device with physical address 0x0215 should have an individual group adress for channel activation datapoint equals to 0xC015.

Information Report
Information Report is done by the Channel activation datapoint. When user push one button on the device, the product send channel activation datapoint ont its indivudual group address (0xC00X). Only one bit in this GroupValueWrite message should be set by the product.