Skip to content

Latest commit

 

History

History
630 lines (383 loc) · 23.3 KB

ft116_0_0.md

File metadata and controls

630 lines (383 loc) · 23.3 KB
layout title
documentation
FT116 - ZWave

{% include base.html %}

FT116 In-Wall Smart Switch

This describes the Z-Wave device FT116, manufactured by Fantem with the thing type UID of oomi_ft116_00_000.

The device is in the category of Wall Switch, defining Any device attached to the wall that controls a binary status of something, for ex. a light switch.

FT116 product image

The FT116 does not permanently listen for messages sent from the controller - it will periodically wake up automatically to check if the controller has messages to send, but will sleep most of the time to conserve battery life. Refer to the Wakeup Information section below for further information.

Overview

The In-Wall Switch is a Z-Wave Smart Switch specifically used to enable Z-Wave command and control (on/off) of any wall switches. It can report immediate wattage consumption or kWh energy usage over a period of time. In the event of power failure, non-volatile memory retains all programmed information relating to the units operating status.It can connect to 2 external manual switches to control the load ON/OFF independently. Its surface has a pin socket, which can be used for connecting to the touch panel, so you can also use the touch panel to control the In-Wall Switch.The In-Wall Switch is also a security Z-Wave device and supports Over The Air (OTA) feature for the products firmware upgrade.

Inclusion Information

Turn the primary controller of Z-Wave network into inclusion mode, short press the products Action button that you can find on the product's housing.

Exclusion Information

Turn the primary controller of Z-Wave network into exclusion mode, short press the products Action button that you can find on the product's housing.

Wakeup Information

The FT116 does not permanently listen for messages sent from the controller - it will periodically wake up automatically to check if the controller has messages to send, but will sleep most of the time to conserve battery life. The wakeup period can be configured in the user interface - it is advisable not to make this too short as it will impact battery life - a reasonable compromise is 1 hour.

The wakeup period does not impact the devices ability to report events or sensor data. The device can be manually woken with a button press on the device as described below - note that triggering a device to send an event is not the same as a wakeup notification, and this will not allow the controller to communicate with the device.

Channels

The following table summarises the channels available for the FT116 -:

Channel Name Channel ID Channel Type Category Item Type
Switch switch_binary switch_binary Switch Switch
Scene Number scene_number scene_number Number
Electric meter (watts) meter_watts meter_watts Energy Number
Electric meter (amps) meter_current meter_current Energy Number
Electric meter (kWh) meter_kwh meter_kwh Energy Number
Electric meter (volts) meter_voltage meter_voltage Energy Number
Alarm (heat) alarm_heat alarm_heat Fire Switch
Alarm (power) alarm_power alarm_power Energy Switch
Clock Time Offset time_offset time_offset Time Number

Switch

Switch the power on and off.

The switch_binary channel is of type switch_binary and supports the Switch item and is in the Switch category.

Scene Number

Triggers when a scene button is pressed.

The scene_number channel is of type scene_number and supports the Number item.

Electric meter (watts)

Indicates the instantaneous power consumption.

The meter_watts channel is of type meter_watts and supports the Number item and is in the Energy category. This is a read only channel so will only be updated following state changes from the device.

Electric meter (amps)

Indicates the instantaneous current consumption.

The meter_current channel is of type meter_current and supports the Number item and is in the Energy category. This is a read only channel so will only be updated following state changes from the device.

Electric meter (kWh)

Indicates the energy consumption (kWh).

The meter_kwh channel is of type meter_kwh and supports the Number item and is in the Energy category. This is a read only channel so will only be updated following state changes from the device.

Electric meter (volts)

Indicates the instantaneous voltage.

The meter_voltage channel is of type meter_voltage and supports the Number item and is in the Energy category. This is a read only channel so will only be updated following state changes from the device.

Alarm (heat)

Indicates if a heat alarm is triggered.

The alarm_heat channel is of type alarm_heat and supports the Switch item and is in the Fire category. This is a read only channel so will only be updated following state changes from the device.

The following state translation is provided for this channel to the Switch item type -:

Value Label
OFF OK
ON Alarm

Alarm (power)

Indicates if a power alarm is triggered.

The alarm_power channel is of type alarm_power and supports the Switch item and is in the Energy category. This is a read only channel so will only be updated following state changes from the device.

The following state translation is provided for this channel to the Switch item type -:

Value Label
OFF OK
ON Alarm

Clock Time Offset

Provides the current time difference for the devices time.

The time_offset channel is of type time_offset and supports the Number item and is in the Time category.

Device Configuration

The following table provides a summary of the 28 configuration parameters available in the FT116. Detailed information on each parameter can be found in the sections below.

Param Name Description
3 Current Overload Protection Current Overload Protection
4 Overheat protection Overheat protection
9 Instant Energy Autosend Interval Instant Energy Autosend Interval (SENSOR_MULTILEVEL_REPORT)
20 Output status after re-power Configure the output status after re-power on it
80 Group 1 notifications Group 1 notifications when the state of Nano Switch's load is changed
81 Group 3 notifications Notification to sent for Group 3 when using the external switch 1
82 Group 4 notifications Notification to sent for Group 4 when using the external switch 2
83 Configure the state of LED Configure the state of LED when it is in 3 modes
84 Night light mode LED state Set the ON/OFF time of the LED when it is in Night light mode
86 Set appointment 1 Set the ON time of output load.
87 Set appointment 2 Set the OFF time of output load
90 Enables/disables parameter 91 and 92 Enables/disables parameter 91 and 92
91 Set the threshold value of wattage Threshold change in wattage (in terms of wattage) to induce an automatic report
92 Set the threshold value of percent power Threshold percentage change in wattage for an automatic report
100 Set parameter 101-103 to default value Reset the parameter 101-103
100 Set parameter 101-103 to default value Reset the parameter 101-103
101 Set group 1 reports To set which reports need to be sent in Report group 1.
102 Set group 2 reports To set which reports need to be sent in Report group 2.
103 Set group 3 reports To set which reports need to be sent in Report group 3.
110 Reset the parameter 111-113 Set parameter 111-113 to default value.
111 Interval for automatic report group 1. Set the interval of automatic report for Report group 1.
112 Interval for automatic report group 2 Set the interval of automatic report for Report group 2.
113 Interval for automatic group 3 report Set the interval of automatic report for Report group 3
120 External switch mode for S1 Configure the external switch mode for S1
121 External switch mode for S2 Configure the external switch mode for S2
122 Control destination of external switch Set the control destination for external switch
252 Lock/unlock configuration parameters Lock/unlock configuration parameters
255 Reset the Nano Switch
Switch All Mode Set the mode for the switch when receiving SWITCH ALL commands

Parameter 3: Current Overload Protection

Current Overload Protection

The following option values may be configured -:

Value Description
0 Disable
1 (Default) Enable

The manufacturer defined default value is 1 ((Default) Enable).

This parameter has the configuration ID config_3_1 and is of type INTEGER.

Parameter 4: Overheat protection

Overheat protection

The following option values may be configured -:

Value Description
0 (Default) Disable
1 Enable

The manufacturer defined default value is 0 ((Default) Disable).

This parameter has the configuration ID config_4_1 and is of type INTEGER.

Parameter 9: Instant Energy Autosend Interval

Instant Energy Autosend Interval (SENSOR_MULTILEVEL_REPORT) Send SENSOR_MULTILEVEL_REPORT at this interval

0 means to not send Values in the range 0 to 255 may be set.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_9_1 and is of type INTEGER.

Parameter 20: Output status after re-power

Configure the output status after re-power on it

The following option values may be configured -:

Value Description
0 Last status
1 Always on
2 Always off

The manufacturer defined default value is 0 (Last status).

This parameter has the configuration ID config_20_1 and is of type INTEGER.

Parameter 80: Group 1 notifications

Group 1 notifications when the state of Nano Switch's load is changed To set which notification would be sent to the associated devices (Group 1) when the state of Nano Switch's load is changed. The following option values may be configured -:

Value Description
0 Send Nothing
1 Send Hail CC
2 Send Basic CC
3 Send Hail CC (External Switch)

The manufacturer defined default value is 3 (Send Hail CC (External Switch)).

This parameter has the configuration ID config_80_1 and is of type INTEGER.

Parameter 81: Group 3 notifications

Notification to sent for Group 3 when using the external switch 1 To set which notification would be sent to the associated nodes in association Group 3 when using the external switch 1 to switch the loads. The following option values may be configured -:

Value Description
0 Send Nothing
1 Send Basic Set CC

The manufacturer defined default value is 1 (Send Basic Set CC).

This parameter has the configuration ID config_81_1 and is of type INTEGER.

Parameter 82: Group 4 notifications

Notification to sent for Group 4 when using the external switch 2 To set which notification would be sent to the associated nodes in association Group 4 when using the external switch 2 to switch the loads. The following option values may be configured -:

Value Description
0 Send Nothing
1 Send Basic Set CC

The manufacturer defined default value is 1 (Send Basic Set CC).

This parameter has the configuration ID config_82_1 and is of type INTEGER.

Parameter 83: Configure the state of LED

Configure the state of LED when it is in 3 modes Configure the state of LED when it is in 3 modes (Energy mode, Momentary indicate mode, Night light mode) The following option values may be configured -:

Value Description
0 LED Follows Switch Status
1 Momentary indicate mode
2 Night light mode. The LED will remain ON state

The manufacturer defined default value is 0 (LED Follows Switch Status).

This parameter has the configuration ID config_83_1 and is of type INTEGER.

Parameter 84: Night light mode LED state

Set the ON/OFF time of the LED when it is in Night light mode 0 to 60 The minute time of OFF 256 to 316 The hour time of OFF 65536 to 65596 The minute time of ON 16777216 to 16777276 The hour time of ON Values in the range 0 to 0 may be set.

The manufacturer defined default value is 301991936.

This parameter has the configuration ID config_84_4 and is of type INTEGER.

Parameter 86: Set appointment 1

Set the ON time of output load. 65536 to 65543 The day value (Mon to Sun) 16777216 Enable the setting. 256 to 316 The hour value of ON time 16777215 Disable the setting. 0 to 60 The minute value of ON time Values in the range 0 to 0 may be set.

The manufacturer defined default value is 8327680.

This parameter has the configuration ID config_86_4 and is of type INTEGER.

Parameter 87: Set appointment 2

Set the OFF time of output load 256 to 316 The hour value of ON time 65536 to 65543 The day value (Mon to Sun) 16777215 Disable the setting. 0 to 60 The minute value of ON time 16777216 Enable the setting. Values in the range 0 to 8327680 may be set.

The manufacturer defined default value is 8327680.

This parameter has the configuration ID config_87_4 and is of type INTEGER.

Parameter 90: Enables/disables parameter 91 and 92

Enables/disables parameter 91 and 92

The following option values may be configured -:

Value Description
0 (Default) Disable
1 Enable

The manufacturer defined default value is 0 ((Default) Disable).

This parameter has the configuration ID config_90_1 and is of type INTEGER.

Parameter 91: Set the threshold value of wattage

Threshold change in wattage (in terms of wattage) to induce an automatic report

Values in the range 0 to 60000 may be set.

The manufacturer defined default value is 25.

This parameter has the configuration ID config_91_2 and is of type INTEGER.

Parameter 92: Set the threshold value of percent power

Threshold percentage change in wattage for an automatic report

Values in the range 0 to 100 may be set.

The manufacturer defined default value is 5.

This parameter has the configuration ID config_92_1 and is of type INTEGER.

Parameter 100: Set parameter 101-103 to default value

Reset the parameter 101-103

Values in the range 0 to 0 may be set.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_100_1_wo and is of type INTEGER. This is a write only parameter.

Parameter 100: Set parameter 101-103 to default value

Reset the parameter 101-103

Values in the range 0 to 0 may be set.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_100_1_wo and is of type INTEGER. This is a write only parameter.

Parameter 101: Set group 1 reports

To set which reports need to be sent in Report group 1.

The following option values may be configured -:

Value Description
1 Send Meter Report of energy (kWh)
2 Send Meter Report of wattage (W)
4 Send Meter Report of voltage (V)
8 Send Meter Report of current (A)

The manufacturer defined default value is 0.

This parameter has the configuration ID config_101_4 and is of type INTEGER.

Parameter 102: Set group 2 reports

To set which reports need to be sent in Report group 2.

The following option values may be configured -:

Value Description
1 Send Meter Report of energy (kWh)
2 Send Meter Report of wattage (W)
4 Send Meter Report of voltage (V)
8 Send Meter Report of current (A)

The manufacturer defined default value is 0.

This parameter has the configuration ID config_102_4 and is of type INTEGER.

Parameter 103: Set group 3 reports

To set which reports need to be sent in Report group 3.

The following option values may be configured -:

Value Description
1 Send Meter Report of voltage (V)
2 Send Meter Report of current (A)
4 Send Meter Report of wattage (W)
8 Send Meter Report of energy (kWh)

The manufacturer defined default value is 0.

This parameter has the configuration ID config_103_4 and is of type INTEGER.

Parameter 110: Reset the parameter 111-113

Set parameter 111-113 to default value.

Values in the range 0 to 0 may be set.

The manufacturer defined default value is 0.

This parameter has the configuration ID config_110_1 and is of type INTEGER.

Parameter 111: Interval for automatic report group 1.

Set the interval of automatic report for Report group 1.

Values in the range 1 to 2147483647 may be set.

The manufacturer defined default value is 600.

This parameter has the configuration ID config_111_4 and is of type INTEGER.

Parameter 112: Interval for automatic report group 2

Set the interval of automatic report for Report group 2.

Values in the range 1 to 2147483647 may be set.

The manufacturer defined default value is 600.

This parameter has the configuration ID config_112_4 and is of type INTEGER.

Parameter 113: Interval for automatic group 3 report

Set the interval of automatic report for Report group 3

Values in the range 1 to 2147483647 may be set.

The manufacturer defined default value is 600.

This parameter has the configuration ID config_113_4 and is of type INTEGER.

Parameter 120: External switch mode for S1

Configure the external switch mode for S1

The following option values may be configured -:

Value Description
0 Enter automatic identification mode
1 2-state switch mode
2 3 way switch mode
3 Momentary push button mode

The manufacturer defined default value is 0 (Enter automatic identification mode).

This parameter has the configuration ID config_120_1 and is of type INTEGER.

Parameter 121: External switch mode for S2

Configure the external switch mode for S2

The following option values may be configured -:

Value Description
0 Enter automatic identification mode
1 2-state switch mode
2 3 way switch mode
3 Momentary push button mode

The manufacturer defined default value is 0 (Enter automatic identification mode).

This parameter has the configuration ID config_121_1 and is of type INTEGER.

Parameter 122: Control destination of external switch

Set the control destination for external switch

The following option values may be configured -:

Value Description
1 control the output loads of itself
2 control the other nodes
3 control the output loads of itself and other nodes

The manufacturer defined default value is 3 (control the output loads of itself and other nodes).

This parameter has the configuration ID config_122_1 and is of type INTEGER.

Parameter 252: Lock/unlock configuration parameters

Lock/unlock configuration parameters

The following option values may be configured -:

Value Description
0 Unlock
1 Lock

The manufacturer defined default value is 0 (Unlock).

This parameter has the configuration ID config_252_1 and is of type INTEGER.

Parameter 255: Reset the Nano Switch

The following option values may be configured -:

Value Description
0 (Default) Reset all configuration parameters
1431655765 Reset and remove from network

The manufacturer defined default value is 0 ((Default) Reset all configuration parameters).

This parameter has the configuration ID config_255_4 and is of type INTEGER.

Switch All Mode

Set the mode for the switch when receiving SWITCH ALL commands.

The following option values may be configured -:

Value Description
0 Exclude from All On and All Off groups
1 Include in All On group
2 Include in All Off group
255 Include in All On and All Off groups

This parameter has the configuration ID switchall_mode and is of type INTEGER.

Association Groups

Association groups allow the device to send unsolicited reports to the controller, or other devices in the network. Using association groups can allow you to eliminate polling, providing instant feedback of a device state change without unnecessary network traffic.

The FT116 supports 3 association groups.

Group 1: Lifeline

The Lifeline association group reports device status to a hub and is not designed to control other devices directly. When using the Lineline group with a hub, in most cases, only the lifeline group will need to be configured and normally the hub will perform this automatically during the device initialisation. When the load state of Nano Switch (turn on/off the load) is changed, the Hail CC and Basic Report (configured by parameter 80) can be sent to the associated nodes in this group.

Association group 1 supports 5 nodes.

Group 2: Forward Group 2

Forward the Basic Set, Switch All, Scene Activation Set to associated nodes in Group 2 when the Dual Nano Switch receives the Basic Set, Switch All, Scene Activation Set commands from main controller.
(E.g. Send/forward Basic Set to control the other nodes in association Group 2)

Association group 2 supports 5 nodes.

Group 3: Send Basic Set to Group 3

Send Basic Set (configured by parameter 0x51 ) to the associated nodes in Group 3 when the external switch S1 is operated.
Note: The Switch Mode of external switch S1 should be identified successfully, which means that the value of Configuration parameter 0x78 should be non-zero, then the Basic Set can be sent to the associated nodes in Group 3 via triggering the S1 switch.

Association group 3 supports 5 nodes.

Technical Information

Endpoints

Endpoint 0

Command Class Comment
COMMAND_CLASS_SWITCH_BINARY_V1
COMMAND_CLASS_SWITCH_ALL_V1
COMMAND_CLASS_SCENE_ACTIVATION_V1
COMMAND_CLASS_SCENE_ACTUATOR_CONF_V1
COMMAND_CLASS_METER_V3
COMMAND_CLASS_ASSOCIATION_GRP_INFO_V1
COMMAND_CLASS_DEVICE_RESET_LOCALLY_V1
COMMAND_CLASS_ZWAVEPLUS_INFO_V1
COMMAND_CLASS_CONFIGURATION_V1
COMMAND_CLASS_ALARM_V4
COMMAND_CLASS_MANUFACTURER_SPECIFIC_V1
COMMAND_CLASS_POWERLEVEL_V1
COMMAND_CLASS_FIRMWARE_UPDATE_MD_V1
COMMAND_CLASS_CLOCK_V1
COMMAND_CLASS_ASSOCIATION_V2
COMMAND_CLASS_VERSION_V2

Documentation Links


Did you spot an error in the above definition or want to improve the content? You can contribute to the database here.