sv.tv
Aeotec - Pioneers of Smart Home, SmartThings, Matter & Zigbee
Instructions for Aeotec models including: Pico Smart Things integrated Shutter, Pico Smart, Things integrated Shutter, integrated Shutter, Shutter
Aeotec Pico Shutter user guide : Aeotec Help Desk
File Info : application/pdf, 21 Pages, 833.49KB
DocumentDocumentAEOTEC Engineering Specification Pico Shutter AEOTEC Engineering Specification Engineering Specification Pico Switch Document No. Description SPEC-ZGA004 Written By Date Reviewed By Date Approved By Date AEOTEC Engineering Specification Version 0.1 0.2 0.3 0.4 0.5 Date 2022.07.05 2022.08.22 2023.07.28 2023.08.25 2023.10.17 REVISION RECORD Brief description of changes First revision. modify modify Add scenes modify AEOTEC Engineering Specification Table of Content 1 INTERFACES & ACCESSORIES ..........................................................................................................................................1 2 FEATURES & SPECIFICATIONS .........................................................................................................................................2 2.1 Structural Characteristics...............................................................................................................................................2 2.2 Hardware Characteristics ..............................................................................................................................................2 2.3 Software Characteristics ................................................................................................................................................2 3 PRODUCT QUICK START..................................................................................................................................................3 3.1 Important safety information ........................................................................................................................................3 3.2 How to install the product .............................................................................................................................................3 3.3 How to join the product into centralized network .........................................................................................................3 3.3.1 Using Action Button...................................................................................................................................................3 3.3.2 Using Install Code ......................................................................................................................................................3 3.4 How to join the product into ZLL network (as a Touch Link target) ...............................................................................3 3.5 How to join other ZLL device into network (as a touch link initiator).............................................................................4 3.6 How to create a distributed network .............................................................................................................................4 3.7 How to open network (created a distributed network) .................................................................................................4 3.8 How to send On/Off cluster to the binding node ...........................................................................................................4 3.9 How to send Level Control cluster to binding node........................................................................................................4 3.10 How to finding and binding as a initiator ..............................................................................................................4 3.11 How to into identify modeas a find and bind target ..............................................................................................4 3.12 How to factory reset ......................................................................................................................................................5 3.13 How to Calibration Travel ..............................................................................................................................................5 3.13.1 Preparation............................................................................................................................................................5 3.13.2 Automatic Calibration (endpoint 1) ...........................................................................................................5 3.13.3 Manual Calibration (endpoint 2) .................................................................................................................5 4 SOFTWARE FUNCTION DEFINITION ................................................................................................................................7 4.1 User Behavior Interaction ..............................................................................................................................................7 4.1.1 ZigBee Button ............................................................................................................................................................7 4.1.2 External Switch ..........................................................................................................................................................8 4.2 Device type.....................................................................................................................................................................9 4.3 Device Simple Descriptor ...............................................................................................................................................9 4.4 Basic Cluster [0x0000]..................................................................................................................................................10 4.5 Device Temperature Configuration [0x0002] ...............................................................................................................11 4.6 Identify Cluster [0x0003]..............................................................................................................................................11 4.7 Groups [0x0004] ..........................................................................................................................................................11 AEOTEC Engineering Specification 4.8 Scenes [0x0005] ...........................................................................................................................................................11 4.9 Alarm [0x0009] ............................................................................................................................................................11 4.10 Time [0x000A]..............................................................................................................................................................12 4.11 Windows Covering [0x0102] ........................................................................................................................................12 4.12 ZLL commissioning [0x1000]........................................................................................................................................14 4.13 OTA Upgrade [0x00019]...............................................................................................................................................14 4.14 Switch Type Configuration [0xFD00]............................................................................................................................14 4.15 Window Configuration Cluster [0xFD03] .....................................................................................................................15 AEOTEC Engineering Specification 1 INTERFACES & ACCESSORIES Te r m i n o l o g y Action Button Indicator Light Description Used for networking and resetting. Used for indicating the current state of the product. Page 1 AEOTEC Engineering Specification 2 FEATURES & SPECIFICATIONS 2.1 Structural Characteristics Parameter Product Identifier Dimensions Color Usage Operating Temperature Relative Humidity Value Pico ShutterZGA004 44mm x 40mm x 21.5mm White For indoor use. 32~104°F (0~40°C) 8%~80% 2.2 Hardware Characteristics Parameter ZigBee Module RF TX Power Indicator Light Color Buttons and Connectors Input Voltage Battery Included Output Rating Input Capacity Working Current Power Consumption Over-Heat Protection Built-in Sensors Surge Protection Value EFR32MG21 Max: 20dBm Blue Action Button (x1) AU EU US (100-240V),50/60Hz No 3.6A 2 Channel@Support Momentary Button/Rocker Switch(On-off Switch)/SPDT Switch MAX: 150mA@230VAC,50Hz MAX: 1.0W Support Temperature Sensor which to overheating protection. Support 2.3 Software Characteristics Parameter Wireless Technology Stack ZigBee logical device type Profile Device Device Type ZigBee Compliant Platform Manufacturer compatible Over The Air (OTA) Factory Reset Value ZigBee [2.4Ghz] ZigBee 3.0 Router Home Automation [0x0104] HA/LO Profile HA Window Covering EFR32MG21x Family EmberZNet 6.10.3 AEOTEC LIMITED [0x1310] Backwards compatible to ZHA (ZigBee Home Automation) Backwards compatible to ZLL (ZigBee Light Link) profile Support Support Page 2 AEOTEC Engineering Specification 3 PRODUCT QUICK START 3.1 Important safety information Please read this Engineering Specification carefully for correct and effective use. Failure to follow the recommendations set forth by AEOTEC Limited may be dangerous or cause a violation of the law. The manufacturer, importer, distributor, and/or reseller will not be held responsible for any loss or damage resulting from not following any instruction in this guide or in other materials. 3.2 How to install the product The product needs to be wired according to the diagram above. 3.3 How to join the product into centralized network This product can be included and operated in any ZigBee 3.0 network with other ZigBee certified devices from other manufacturers and/or other applications. 3.3.1 Using Action Button 1. Set your ZigBee coordinator open network and allow to join a device into a network during a time. Refer to the Coordinator's manual if you are unsure of how to perform this step. 2. Make sure the product is powered. Its LED will be breathing blue light all the time. 3. Click Action Button twice, it will quickly flash blue light until it is joined into the network. 4. If joining fails, it will come back to breathing blue light; repeat steps 1 to 3. Contact us for further support if needed. 5. If joining succeeds, it will turn to blue light. Now, this product is a part of your ZigBee home control system. You can configure it and its automations via your ZigBee system; please refer to your software's user guide for precise instructions. 3.3.2 Using Install Code Products can be joined into a ZigBee network by scanning the Install Code QR Code present on the product with a coordinator providing inclusion. No further action is required and the product will be joined automatically. Note: What Is an Install Code? ZigBee installation codes, sometimes also referred to as "install codes," are provided as a means for a device to join a ZigBee network in a reasonably secure fashion. The installation code itself is a random value installed on the joining device at manufacturing time, and is used to encrypt the initial network key transport from the ZigBee network's centralized Trust Center device (the coordinator) to the joining device. The installation code can be thought of as similar to the PIN code on Bluetooth devices when two devices are paired. The PIN code is provided as an authorization code for the parent device so that the joining device knows it is receiving information securely, such as when a hands-free headset is paired to a smartphone. 3.4 How to join the product into ZLL network (as a Touch Link target) 1. Product is always in touchlink target mode and can be joined to other networks by Touchlink commission; 2. Place the remote device within 10cm of the product. 2. When touchlink in communication, the indicator light will flash; Page 3 AEOTEC Engineering Specification 3. If joining fails, it will come back to breathing blue light; 4. If joining succeeds, it will turn to blue light. Now, this product is a part of your ZigBee home control system. You can configure it and its automations via your ZigBee system; please refer to your software's user guide for precise instructions. 3.5 How to join other ZLL device into network (as a touch link initiator) 1. Press and hold Action Button for 2 to 5S and release. 2. Indicator Light will become turns on slowly and turns off quickly. 3. Held Close to the ZLL device (10cm apart). 3.6 How to create a distributed network 1. Press and hold Action Button for 17S. 2. Indicator Light will become constantly on or off. 3.7 How to open network (created a distributed network) The prerequisite is that a distributed network has been created. 1. Click Action Button 2 times. The device open network for 180 seconds, can join other nodes into the existed network. 2. Indicator Light will blink slowly. 3.8 How to send On/Off cluster to the binding node 1. Click extern switch 1 time 2. Product will send on off cluster to the binding node; 3.9 How to send Level Control cluster to binding node 1. Press and hold extern switch (just apply to momentary type) 2. Product will send the Level Control cluster to the binding node; Send every 200ms, increasing / decreasing step by 5. 3.10 How to finding and binding as a initiator When the value of attribute 0x0012 of 0xFD00 cluster is 0. 1. Click extern switch 1/2 three times, the endpoint 3 enters find and bind initiator mode for 5 seconds, indicator light turns on quickly and turns off slowly. When the value of attribute 0x0012 of 0xFD00 cluster is 1. 1. Click extern switch 1 three times, the endpoint 4 enters find and bind initiator mode for 5 seconds, indicator light turns on quickly and turns off slowly. 2. Click extern switch 2 three times, the endpoint 5 enters find and bind initiator mode for 5 seconds, indicator light turns on quickly and turns off slowly. 3.11 How to into identify modeas a find and bind target 1. Click Action Button 5 times, the endpoint 1 into identify mode, LED will quickly flash. Page 4 AEOTEC Engineering Specification 2. Click Action Button 6 times, the endpoint 2 into identify mode, LED will slowly flash. 3. Product enters the identify mode for 180 seconds. 3.12 How to factory reset If the primary coordinator is missing or inoperable, you may need to reset the device to factory settings. Make sure the product is powered. To complete the reset process manually, press and hold the Action Button for at least 10s. The Indicator Light will become breathing blue light, which indicates the reset operation is successful. Otherwise, please try again. Contact us for further support if needed. 3.13 How to Calibration Travel 3.13.1 Preparation The movement direction of the motor should be correct, with 0% corresponding to fully open and 100% corresponding to fully closed. You can change the wiring or use the command to reverse (Bit 0 of the mode attribute) 3.13.2 Automatic Calibration (endpoint 1) There are two ways to enter calibration mode for endpoint 1 (Roll Shade), which are to send the command (Bit 1 of the mode attribute) to endpoint 1, or click external switch 1 six times. The product will automatically complete calibration, and the intermediate process does not require manual operation. When the operating mode is 0, this time is from the open limit to the close limit of the motor. When the operating mode is 1, this time includes slats tilting time. 3.13.3 Manual Calibration (endpoint 2) Preparation: 1. The motor must run to closed limit before starting calibration. 2. Please set the operation mode to 1 (shutter mode). There are two ways to enter calibration mode for endpoint 2 (Shutter), which are to send the command (Bit 1 of the mode attribute) to endpoint 2, or click external switch 2 six times. During calibration, manual operation is required. When the calibration is started, the shutter moves to 0 degrees, when reaches 0 degrees, press the extern switch 2 once, and the shutter will rotate again. When it reaches 180 degrees, press the extern switch 2 again to complete the calibration. The time is the slats tilting full turn time. Page 5 AEOTEC Engineering Specification Page 6 AEOTEC Engineering Specification 4 SOFTWARE FUNCTION DEFINITION 4.1 User Behavior Interaction 4.1.1 ZigBee Button User behavior Power OFF Power ON Click Action Button 1 time Click Action Button 2 times Click Action Button 3 times Click Action Button 4 times Click Action Button 5 times Click Action Button 6 times Press and hold Action Button for [1, 2s) Press and hold Action Button for [2, 5s) Press and hold Action Button for [5, 10s) Press and hold Action Button for [10, 12s) outside network Inside network N/A N/A 1, All relays will keep turning off state. 1, All relays will keep turning off state. 2, The device start the touchlink target process automatically. Touch Link lasts only 3 seconds if no request for Touch Link is scanned. Enter the ZigBee3.0 initial start up. The LED will blink quickly. That should last for about 180 sec. The LED will flash quickly until the device is joined to the gateway. If device is not joined within 180 sec. The LED will breathing blue light. 3, The led will turn on for 1 seconds, then breathing. Normal transfer->Stop->Reserve transfer- Normal transfer->Stop->Reserve transfer->stop- >stop->Normal transfer->Stop->... >Normal transfer->Stop->... Indicator Light will become flash breathing. Indicator LED will synchronize to the status of the relays. Support being joined by coordinator or router. Indicator Light will quickly flash blue light until it is joined into the network. It will become constantly blue light after being assigned a Short ID. If joining succeeds, it will become regular light mode (constantly blue light or off). If joining fails, it will return breathing blue light. Central network mode: Nothing to be done Distribute network mode: The device open network for 180 seconds, can join other nodes into the existed network. Indicator Light will blink slowly. Starting to identify the type of the external Starting to identify the type of the external switch switch 1. Indicator Light will blink quickly 1. Indicator Light will blink quickly Starting to identify the type of the external Starting to identify the type of the external switch switch 2. Indicator Light will blink slowly 2. Indicator Light will blink slowly No function Endpoint 1 into find and bind target mode, this progress will continue to 180s. Indicator Light will blink quickly No function Endpoint 2 into find and bind target mode, this progress will continue to 180s. Indicator Light will blink slowly No function, Indicator Light will become off when press, and become breathing when release. Indicator Light will become off when press, and turns ON/OFF dependent on motor moving state when release. No function, Indicator LED will become breathing. Trigger the device to start Touch Link initiator mode. Indicator Light will become on when press, and become turns on slowly and turns off quickly when release. No function, Indicator LED will become breathing. Indicator Light will flash even faster when press, and become regular light mode when release. Factory reset a central network node. Factory reset a central network node When the time reaches 10s, Factory Reset is When the time reaches 10s, Factory Reset is performed after release. The product will performed after release. The product will perform perform factory reset. Indicator Light will factory reset. Indicator Light will become become breathing blue light, which breathing blue light, which indicates the reset indicates the reset operation is successful. operation is successful. Otherwise, please try Page 7 AEOTEC Engineering Specification Press and hold Action Button for [17s] Otherwise, please try again. again. Factory reset and form and join a distributed Factory reset and form and join a distributed network. If network. If joining succeeds, it will become regular joining succeeds, it will become regular light mode light mode (constantly blue light or off) (constantly blue light or off) 4.1.2 External Switch User behavior outside network Inside network Press and hold two Change between momentary movement / continuous movement modes. switch at the same Indicator Light will blink quickly 2 seconds. time for 5 seconds Momentary Switch Switch Action Function 1 S1 Function 2 Function 1 Click 1 times Click 2 times Send Scene recall Id = 1 Send Scene recall Id = 2 control local= 1: Send Scene recall Local motor up/stop Id = 6 Send covering up/stop to binding node control local= 0: send On Off to binding node If outside network, it will Start to join ZigBee network Indicator Light Send Scene recall will blink quickly. Id = 7 Click 3 times Send Scene recall Id = 3 Send Scene recall Id = 8 Click 4 times Find and binding initiator Click 6 times Calibration ep1 Hold (min. 2 seconds) Send Scene recall Id = 4 control local= 1: Local motor up Send covering up to binding node control local= 0: send Level Move up/down to binding node Send Scene recall Id = 9 Release Send Scene recall Id = 5 control local= 1: Local motor stop Send covering stop to binding node control local= 0: send Level stop to binding node Send Scene recall Id = 10 S2 Function 2 control local= 1: Local motor down/stop Send covering down/stop to binding node control local= 0: send On Off to binding node If outside network, it will Start to join ZigBee network Indicator Light will blink quickly. Find and binding initiator Calibration ep2 control local= 1: Local motor down Send covering down to binding node control local= 0: send Level Move up/down to binding node control local= 1: Local motor stop Send covering stop to binding node control local= 0: send Level stop to binding node Toggle Switch and SPDT: Switch S1 S2 Page 8 AEOTEC Engineering Specification Action Click 1 times Click 2 times Click 4 times Click 6 times Click 8 times Click 12 times Function 1 Function 2 Function 1 control local= 1: Local motor up/stop Send covering up/stop to binding node control local= 0: send On Off to binding node Send Scene recall Id = 1 If outside network, it will Start to join ZigBee network Indicator Light will blink quickly. Send Scene recall Id = 6 Send Scene recall Id = 2 Send Scene recall Id = 7 Send Scene recall Id = 3 Send Scene recall Id = 8 Find and binding initiator Calibration ep1 Indicator Light will blink slowly Function 2 control local= 1: Local motor up/stop Send covering up/stop to binding node control local= 0: send On Off to binding node If outside network, it will Start to join ZigBee network Indicator Light will blink quickly. Find and binding initiator Calibration ep2 Indicator Light will blink slowly Mark: 1. Group ID of send scenes recall command Can be configured, refer to control local attribute of 0xFD00 Cluster. 2. Find and binding initiator mode The progress will continue to 3S, indicator light will become turns on quickly and turns off slowly. 4.2 Device type ZigBee Logical Device type Router 4.3 Device Simple Descriptor ZigBee Security type ZigBee 3.0 Security Endpoint endpoint1 Device id 0x0202 HA Window Covering Endpoint2 0x0202 HA Window Covering Cluster id (Server) 0x0000 (Basic) 0x0002 (Device Temperature Configuration) 0x0003 (Identify) 0x0004 (Groups) 0x0005 (Scenes) 0x0009 (Alarms) 0x0102 (Window Covering) 0xFD03 (Window Configuration) 0x0000 (Basic) 0x0003 (Identify) 0x0004 (Groups) Cluster id (Client) 0x000A (Time) 0x0019 (OTA Upgrade) Page 9 AEOTEC Engineering Specification Endpoint3 0x0203 HA Window Covering Controller 0x0005 (Scenes) 0x0102 (Window Covering) 0x0000 (Basic) 0x0003 (Identify) Endpoint4 0x0830 LO Non-color Scene Controller 0x0000 (Basic) 0x0003 (Identify) 0x1000 (ZLL Commissioning) 0xFD00 (switch type configuration) Endpoint5 0x0830 LO Non-color Scene Controller 0x0000 (Basic) 0x0003 (Identify) 0xFD00 (switch type configuration) Endpoint242 0x0061 GP Proxy Basic 0x0003 (Identify) 0x0004 (Groups) 0x0005 (Scenes) 0x0102 (Window Covering) 0x0003 (Identify) 0x0004 (Groups) 0x0005 (Scenes) 0x0006 (On/Off) 0x0008 (Level Control) 0x1000 (ZLL Commissioning) 0x0003 (Identify) 0x0004 (Groups) 0x0005 (Scenes) 0x0006 (On/Off) 0x0008 (Level Control) 0x0021 (Green Power) 4.4 Basic Cluster [0x0000] This cluster supports an interface to the node or physical device. It provides attributes and commands for determining basic information, setting user information such as location, and resetting to factory defaults. Command: Command Identifier Description Remarks 0x00 Reset to Factory Defaults Reset to Factory Defaults Command Generated: NULL Attributes: Identifier 0x0000 0x0001 0x0002 0x0003 0x0004 0x0005 0x0006 0x0007 0x0008 0x0009 0x000a 0x000b 0x000d 0x000e 0x0012 0x0013 0x0014 0x4000 Name ZCL Version Application Version Stack Version HW Version Manufacturer Name Model Identifier Date Code Power Source Generic Device-Class Generic Device-Type Product Code Product URL Serial Number Product Label Device Enabled Alarm Mask Disable Local Config SW Build ID Type uint8 uint8 uint8 uint8 string string string enum8 enum8 enum8 octstr string string string bool map8 map8 string Range 0x00-0xff 0x00-0xff 0x00-0xff 0x00-0xff 0-32 bytes 0-32 bytes 0-16 bytes 0x00-0xff 0x00-0xff 0x00-0xff 8 bytes 20 bytes 40 bytes 0/1 000000xx 000000xx 0 to 16 bytes Access Read Only Read Only Read Only Read Only Read Only Read Only Read Only Read Only Read Only Read Only Read Only Read Only Read Only Read Only Read Write Read Write Read Write Read Write Default 0x08 0x41 0x00 0x01 AEOTEC ZGA004 -0x01 0xff 0xff (MAC) www.aeotec.com (SN) (Install Code) 1 0 0 1.0.1 Note: Application Version format: fv.sv.tv (0.0.0 3.3.15) Shortened name fv sv Full name First version Second version Description . The first bit, 2 bits, numbers 1 ~ 3, when sv bit is full, fv++ . fv counts from 1 . The second bit, 2 bits, numbers 0 ~ 3, when the tv bit is full, sv++ . Value range: 0 ~ 3 Page 10 AEOTEC Engineering Specification . sv counts from 0 tv Third version . The third, 4 bits, numbers 0-15, test once, tv++ . tv counts from 0 4.5 Device Temperature Configuration [0x0002] Attributes for determining information about a device's internal temperature, and for configuring under/over temperature alarms for temperatures that are outside the device's operating range. Command Received: NULL Command Generated: NULL Attributes: Identifier Name 0x0000 Current temperature 0x0002 Max Temp Experienced 0x0003 Over Temp Total Dwell 0x0010 Device Temp Alarm Mask 0x0012 High Temp Threshold 0x0014 High Temp Dwell Trip Point Type int16 int16 unt16 map8 int16 Unt24 Range -200 to +200 -200 to +200 0x0000 to 0xffff 0000 00xx -200 to +200 0 to 0xffffff Access Read Only Read Only Read Only Read Write Read Write Read Write Default 25 (C) 80 (C) 0x0000 0x02 (too high) 50 (C) 60 (S) Reporting: Client/Server Attribute Min Interval(S) Max Interval(S) Reportable change Server Current temperature 1 600 10 4.6 Identify Cluster [0x0003] Attributes and commands to put a device into an Identification mode (e.g., flashing a light), that indicates to an observer e.g., an installer - which of several devices it is, also to request any device that is identifying itself to respond to the initiator. Identify effect events Blink Breathe Okay Channel change effect Flashing 2 times Flashing 4 times Flashing 6 times Flashing 8 times 4.7 Groups [0x0004] The cluster provides the capability for group addressing. Attributes: Identifier Name Type Range Access Default 0x0000 Name Support map8 x0000000 Read Only 0 4.8 Scenes [0x0005] The scenes cluster provides attributes and commands for setting up and recalling scenes. Maximum Number of Scenes is 16. 4.9 Alarm [0x0009] Id Set Name Identifier Name Type Page 11 Value Access Default AEOTEC Engineering Specification Alarm Information 0x0000 Support alarm code: Alarm Count uint16 R 0 Alarm code Description 0x16 Over Current L1 (Greater than 3.5A) (need to be explicitly reset by user, and the operation of the relay is prohibited) 0x17 Over Current L2 (Greater than 3.5A) (need to be explicitly reset by user, and the operation of the relay is prohibited) 0x23 US: Under Voltage (Less than 95V) EU/ANZ: Under Voltage (Less than 200V) (reset automatically when the conditions that cause are no longer active 0x24 US: Over Voltage (Greater than 125V) EU/ANZ: Over Voltage (Greater than 260V) (reset automatically when the conditions that cause are no longer active 0x86 Temperature Exceeded (Greater than 50) Turn Off the Relay(Greater than 80) (reset automatically when the conditions that cause are no longer active 4.10 Time [0x000A] This cluster provides a basic interface to a real-time clock. 4.11 Windows Covering [0x0102] There are two endpoints that support Windows Covering Cluster Server. The specific information is as follows: endpoint Endpoint 1 Endpoint 2 Windows Covering Type Roller Shade Shutter Receive Command Up/Open, Down/Close, Stop, Go To Lift Percentage Up/Open, Down/Close, Stop, Go To tilt Percentage Attribution Report Current Position - Lift Percentage Current Position Tilt Percentage Generated Command Up/Open, Down/Close, Stop Endpoint 1 is used to control Lift, Endpoint 2 is used to control Tilt. If a window support Lift and Tilt, need to control the two endpoints, for example, operate endpoint 1 first and then endpoint 2. Attribution: Id Set Name Identifier Name Window Covering Information 0x0000 0x0001 Window Covering Type Physical Closed Limit Lift Type enum8 uint16 Access R R Default Operating modes = 0: Ep1:0x00 (Roller shade) Operating modes = 1: Ep1: 0x06(Shutter) Ep2:0x06(Shutter) 60000 cm(600S) Page 12 AEOTEC Engineering Specification Window Covering Settings 0x0002 0x0003 0x0004 0x0005 0x0006 0x0007 0x0008 0x0009 0x0010 0x0011 0x0012 0x0013 0x0014 0x0015 0x0016 0x0017 0x0018 0x0019 Config/Status Physical Closed Limit Tilt uint16 R Current Position Lift uint16 R Current Position Tilt uint16 R Number of Actuations Lift uint16 R Number of Actuations Tilt uint16 R Config/Status R Current Position Lift Percentage uint8 RSP Current Position Tilt Percentage uint8 RSP Installed Open Limit Lift uint16 R Installed Closed Limit Lift uint16 R Installed Open Limit Tilt uint16 R Installed Closed Limit Tilt uint16 R Velocity-Lift uint16 RW Acceleration Time-Lift uint16 RW Deceleration Time-Lift uint16 RW Mode map8 RW Intermediate Set points Lift octstr RW Intermediate Set points Tilt octstr RW 10000 cm(100S) 0 cm 0 cm 0 0 0x0A=00001010 0xFF (unknown) 0xFF (unknown) 0cm 6000cm(60S) 0cm 300cm(3.0S) 0 0 0 0x08 1,0x0000 1,0x0000 Bit Bit7 Bit6 Bit5 Bit4 Bit3 Bit2 Bit1 Bit0 Des 0 0=Timer 0=Timer 0=Tilt control is 1=Lift control is 0=Commands 1=Online 0=Not Controlled Controlled Open Loop Closed Loop are normal Operational Mode Bit Bit3 Bit2 Bit1 Bit0 Des 0=LEDs are off 1=LEDs display feedback 0=running normally 1=in maintenance mode 0=run is normal mode 1=run in calibration mode 0 = direction is normal 1=direction is reversed Receive Command Command ID 0x00 0x01 0x02 0x05 0x08 Description 1 Up / Open Down / Close Stop Go to Lift Percentage (Only endpoint 1) Go to Tilt Percentage (Only endpoint 2) Attribution Report Description 2 Go to Installed Open Limit Go to Installed Close Limit Stop run Between Installed Open Limit and Installed Closed Limit 0% = Installed Open Limit, 100%= Installed Closed Limit Between Installed Open Limit and Installed Closed Limit 0% = Installed Open Limit, 100%= Installed Closed Limit Attribution 0x0008 0x0009 Description Current Position - Lift Percentage (Only endpoint 1) Current Position Tilt Percentage (Only endpoint 2) Report Interval When the motor is running, the attribution will report itself with 1 second period. When the motor is running, the attribution will report itself with 1 second period. Note: In order to be compatible with third-party platforms, like Home assistant, Smarthings, Endpoint2 also supports use Lift percentage command to control Tilt function,and it will report Lift percentage and tilt percentage of Tilt position. Page 13 AEOTEC Engineering Specification Generated Command Command ID 0x00 0x01 0x02 Description Up / Open Down / Close Stop External SW SW1 SW2 SW1 or SW2 Note: If the product has not calibration, when a command is sent (or pressed action button or external switch), the product will automatically enter calibration mode before executing the command. 4.12 ZLL commissioning [0x1000] The touchlink commissioning cluster shall have a cluster identifier of 0x1000. Those commands in the touchlink commissioning command set shall be sent using the profile identifier, 0xc05e whereas those commands in the commissioning utility command set shall sent using the profile identifier, 0x0104. Command Received: 4.13 OTA Upgrade [0x00019] The main goal of Over The Air Upgrade cluster is to provide an interoperable mean for devices from different manufacturers to upgrade each other's image. Additionally, the OTA Upgrade cluster defines a mechanism by which security credentials, logs and configuration file types are accessible by offering a solution that utilizes a set of optional and mandatory commands. Firmware information: Command Identifier Description Manufacture ID Image Type 0x1310 0x7C04 4.14 Switch Type Configuration [0xFD00] Manufacturer ID is required when reading and writing attributes. The manufacturer code is 0x1310. Attributes and commands for configuring switch type. Command Received: NULL Command Generated: NULL Attributes: Identifier Name Type Range Access Default 0x0000 Switch Type enum8 0x00-0xFF Read/Write 0x01 0x0010 Switch Actions enum8 0x00-0xFF Read/Write 0x02 0x0011 controls enum8 0x00-0x01 Read/Write 0x01 0x0012 Group ID uint16 0x0001-0xFFF7 Read/Write 0x0001 Switch Type: Value Description Page 14 AEOTEC Engineering Specification 0x00 Toggle 0x01 Momentary 0x04 Into Auto Recognize Mode 0x02-0x03, 0x05-0xFF Not support Switch Actions: Value State 2 (Press) State 1 (release) 0x00 On Off 0x01 Off On 0x02 Toggle Toggle controls: Value Description 0x00 control local disable and endpoint 4/5 enter Bind and find mode 0x01 control local enable and endpoint 3 enter Bind and find mode Group ID: Value Description 0x0001---0xFFF7 Group ID for sending scene commands 4.15 Window Configuration Cluster [0xFD03] ID Name 0x0001 Operating modes 0x0002 time of slats tilting full turn 0x0003 Slats position Type Access Remarks Default uint8 Read/ 0x00: Roll Shade modeonly up/down 0x00 Write functions, and endpoint 2 cannot be used 0x01: shutter mode (equipped with up/down function and angle transfer function) uin16 Read/ Set the time, required by the slats, to make a full 300 Write turn (180 degrees). The unit is 0.01 second. NOTE: If the set time is too long and a full turn was already performed, the device will start to move up or down for the remaining time. uin8 Read/ 0- Slats don't return to the previously set 1 Write position. 1- Slats return to the previously set position only Page 15 AEOTEC Engineering Specification after being activated via the gateway (hub). 2 - Slats return to the previously set position in case they were activated via the gateway (hub), ZigBee Button, External Switch operation. NOTE: Not valid for open/close limit positions. Not valid when operating modes is 0 0x0004 time of moving up/down uin16 Read/ The time when the motor moves from the open 6000 Write limit to the close limit. The unit is 0.01 second. 0x0005 time of momentary uint16 Read/ The time of motor action during momentary 500 movement Write movement. The unit is 1ms. 0x0006 momentary movement/ uint8 continuous movement Read/ 0x00: momentary movement 0x01 Write 0x01: continuous movement NOTE: Press and hold two external switch at the same time for 5 seconds, change between 2 modes. Indicator Light will blink quickly. 0x0007 time of motor response uin8 Read/ The time of motor response. The unit is 0.01 30 Write second. 0x0008 Automatic verification of fully open and fully closed positions uin8 Read/ When the curtains are fully open and fully 1 Write closed, the travel limit switch will be used to determine whether the limit point has been reached. If the limit point is reached, it will immediately stop. If not, the timeout for running is 5 seconds. 0x00: Disable 0x01: Enable Receive Command Command ID 0x00 Description 1 Reach limit Description 2 Reaching limit during manual calibration. Page 16