4.2 Zigbee Console Commands

The ZigBee application support includes implementation of a serial console that allows control and monitoring of the ZigBee device over a serial connection using a terminal program (HyperTerminal, Tera Term, and so on ) on a PC.
Note: These commands are mainly used for testing or demonstration purpose. The end customer application may or may not use this command based approach. but the code implementation used in these commands internally uses global zigbee stack API's, which can be taken as reference for API usage.

Setup

  • To enable the use of console, In MPLAB Code Configurator (MCC), Connect Zigbee console in the Zigbee device component to USART Driver Component and to SERCM0 component (for WBZ Curiosity Board) as illustrated below.

  • Configure the SERCOM0 component as shown in the below figure to set the uart baud rate, parity, data bits and Sercom Tx and Rx pins

    Select system component in project graph
    Important:

    Direct - Digital peripheral is enabled on the default dedicated pins and can operate with Maximum Clock Frequency

    PPS - Digital peripheral is enabled on pins selected by the MCC pin configurator and can operate with Maximum Clock Frequency/2

  • The MCC configurator also gives the flexibility to select commands based on different Groups. It is highly modularised.
  • The MCC generated code for console can be seen in application folder:
  • On the PC side virtual COM port connection that corresponds to the board shall have following settings:BAUD RATE: 115200 (as configured in SERCOM configuration)- PARITY: None- DATA BITS: 8- STOP BITS: 1- FLOW CONTROL: None

  • Additionally, local echo and sending line ends with line feeds shall be enabled in the PC serial terminal application.

Commands

Once the COM port is opened in the PC terminal application, the console commands can be entered in terminal application. Type ‘help’ to list the help commands type as shown in below figure.

Help

Command Syntax

Response

Description

help

Commands:

zdoHelp

commissioningHelp

zclHelp

Shows supported help sections.

The console commands are categorized into three sections commissioningHelp, zdoHelp & zclHelp.

commissioningHelpCommands:Refer Commissioning HelpcommissioningHelp list the command that are related to commissioning of the Zigbee device.
zdoHelpCommands: Refer ZDO HelpzdoHelp list the group of commands that are categorized to zdo (zigbee device object) functionality.
zclHelpCommands: Refer ZCL HelpzclHelp list the group of commands that are categorized to zcl (zigbee cluster library) functionality. The clusters are specific to device type and the zclHelp list commands based on clusters that are supported in the device type of the project

Commissioning Help

When commissioning Help is entered in the terminal application, the device lists all the supported commands that are related to commissioning of the zigbee device.

Command Syntax

Response

Description

invokeCommissioning < mode > < gid >

e.g.: invokeCommissioning 4 0

Nwk Formation: Success

CommissioningStatus = 0

Invokes commissioning with the groupid (bdbCommissioningGroupID) and input modes enabled

- 1 - Touchlink

- 2 - Steering

- 4 - Forming

- 8 - Finding and Binding

Multiple modes can be enabled. Details of different commissioning methods is explained here

getAppDeviceType

e.g.: getAppDeviceType

HADeviceType = 0x0007

Request for Application Device Type

The response 7 indicate that the device is combined interface

Refer Application Device Type Responses table for more details

getDeviceType

e.g.: getDeviceType

DeviceType = 2

Request for Zigbee Device Type

The response 2 indicate that device is of type Zigbee Coordinator

Refer Zigbee Device Type table for more details

getExtAddr

e.g.: getExtAddr

0000000000000bee

Return the extended Address (MAC Address) of the Zigbee device

Here 0x0000000000000bee is the extended address

getNetworkAddress

e.g.: getNetworkAddress

0000

Return the network address / short address of the zigbee device.

Here 0000 is the network address of the Zigbee device in hex format

getChannel

e.g.: getChannel

25

Return the current operational channel

Here the device is operating in channel 25

setExtAddr < upper > < lower >

eg(in hex): setExtAddr 0xaabbccdd 0x1122334

eg(in dec): setExtAddr 2864434397 287454020

-

Set the extended Address (MAC Address) of the Zigbee device

Here 0xaabbccdd11223344 is the extended address. The extended address is IEEE address purchased from IEEE and will be programmed in OTP page of module. So, this setExtAddr is needed only for testing purpose.

setPrimaryChannelMask < mask >

e.g.: setPrimaryChannelMask 0x2108800

Set Primary channel mask

Here the primary channel mask is set to channels to 11,15,20&25

setSecondaryChannelMask < mask >

e.g.: setSecondaryChannelMask 0x2108800

Set Secondary channel mask

Here the Secondary channel mask is set to channels to 11,15,20&25

powerOff

e.g.: powerOff

Emulates Power off of the device by disabling RF. reset command or press the reset button of the device is required to return to power on status

reset

e.g.: reset

Zigbee Device Initialized: Type Help for Commands

Perform HW reset for the device. Upon reset the device will attempt to restore data from NVM and apply it instead of starting as factory new

resetToFN

e.g.: resetToFN

Zigbee Device Initialized: Type Help for Commands

Resets the device to Factory New state by deleting network and application data from NVM. However, this command does not reset the outgoing NWK security counter, and hence device is able to join its previous network.

formAndSteer

e.g.: formAndSteer

Nwk Formation: Success

Steering: Success

CommissioningStatus = 0

Forms a network and steers. This command is same as using invokeCommissioning 6 0

formSteerAndFB

e.g.: formSteerAndFB

Nwk Formation: Success

Steering: Success

Device joined: Address 0x256a MACID 0x000000000000aabb ExtendedPANID 0x0000000000000bee

addGroupResponseInd()

Finding & Binding: Success

CommissioningStatus = 0

forms network, steers and initiate Finding & Binding. This command is same as using invokeCommissioning 0xE 0

SetInstallCode < ext_addr_upper > < ext_addr_lower > < code >

e.g.: SetInstallCode 0xAABBCCDD 0x11223344 B5C305D51669B239C6A52397937A40D3FE83

Status = 0

Sets the install code

Here 0xAABBCCDD 0x11223344 is the for the extended address 0xaabbccdd11223344

Here the product key is “83FE D340 7A93 9723 A5C6 39B2 6916 D505 C3B5”

SetAllowRemoteTCpolicyChange < type >

e.g.: SetAllowRemoteTCpolicyChange 1

-

Enable/Disable Trust Center policy

1 – enables Remote Tust center Policy Change

0 - 1 – disables Remote Tust center Policy Change

SetInstallCodeDevice < code >

e.g.: SetInstallCodeDevice B5C305D51669B239C6A52397937A40D3FE83

Status = 0

Sets the install code

Here the product key is “83FE D340 7A93 9723 A5C6 39B2 6916 D505 C3B5”

setAllowTLResetToFN < type >

e.g.: setAllowTLResetToFN 1

-

Set the device to allow to accept Touch Link reset to FN

1 – allow Touch Link Reset To Factory New

0 – disallow Touch Link Reset To Factory New

SetTLRole < initiator >

e.g.: SetTLRole 1

-

Sets the Touchlink role

1 – initiator

0 - target

setTCLKExchangeMethod < method >

-

Set Touch Link exchange method

setTCLKMaxRetryAttempts < attempt >

Set Touchlink Max retry attempt

setTCRequireKeyExchange < require >

e.g.: setTCRequireKeyExchange 1

-

Enable or disable Trust Center Key exchange

setGlobalKey < option >

e.g.: setGlobalKey 1

-

Set Global Link (for testing)

0 - HA Link key will be used

[0x5a,0x69,0x67,0x42,0x65,0x65,0x41,0x6c,0x6c,0x69,0x61,0x6e,0x63,0x65,0x30,0x39]

1 – [0xd0, 0xd1 …. 0xdf]

2 – [0xc0, 0xc1 …. 0xcf]

3 – [0x66, 0xB6, 0x90, 0x09, 0x81, 0xE1, 0xEE, 0x3C, 0xA4, 0x20, 0x6B, 0x6B, 0x86, 0x1C, 0x02, 0xBB]

Here in the example setGlobalKey 1 the key used will be [0xd0, 0xd1, 0xd2, 0xd3, 0xd4, 0xd5, 0xd6, 0xd7, 0xd8, 0xd9, 0xdA, 0xdb, 0xdc, 0xdd, 0xde, 0xdf]

setPermitJoin < duration >

e.g.: setPermitJoin 180

setPermitJoinRsp 0

Allow other devices to join the network for the specified duration (in secs)

Here the zigbee device allow other devices to join the network for a duration of 180 sec.

setPermitJoinRsp 0 - indicate that a ZDO MGMT_PERMIT_JOINING_CLID packet is send.

ZDO Help

When zdoHelp is entered in the terminal application, the device lists all the supported commands that are related to network management and information gathering.

Command Syntax

Response

Description

activeEpReq < DstAddr > < nwkAddrOfInterest >

e.g.: activeEpReq 0x7766 0x7766

This console command requests the list of all active endpoints on a

remote device.

Here the DstAddr is the short / network address of the remote device to which Active_EP_req command (ClusterID=0x0005) will be send.

nwkAddrOfInterest is the short address of the remote device for which the active endpoint list is required.

This activeEpReq should be a unicast to the remote device itself or to an alternative device that contains the discovery information of the remote device

bindReq <addrMode> < DstAddr > < extDstAddrHigh > < extDstAddrLow > < ClusterId >

BindRsp 0

This console command requests a remote node to insert an entry to its binding table.

Here addrMode specifies the format of DstAddr.

Refer Address Mode table for more details.

DstAddr is the short address of the remote device.

extDstAddrHigh & extDstAddrLow is the extended address of the destination device.

ep is the destination endpoint for the binding entry.

ClusterId is the cluster on the source device that is bound to the destination.

bindReq2 < addrMode> < DstAddr > < extSrcAddrHigh > < extDstAddrHigh> < extDstAddrLow / GroupID> < ep_Src > < ep_Dst > < ClusterId >

BindRsp 0

This console command requests a remote node to insert an entry to its binding table.

Here addrMode specifies the format of DstAddr.

DstAddr is the short address of the remote device.

extSrcAddrHigh & extSrcAddrLow is the extended address of the source device. extDstAddrHigh & extSrcAddrLow is the extended address of the destination device.

Refer Address Mode table for more details.

ep_Src is the source endpoint for the binding entry.

ep_Dst is the destination endpoint for the binding entry.

ClusterId is the cluster on the source device that is bound to the destination.

ieeeAddrReq < dstAddr > < nwkAddOfInt > < reqType >

example: ieeeAddrReq 0x7011 0x7011 0

This console command requests the IEEE (extended) address of a remote node with a given short (network) address.

dstAddr is the short address of the remote device to which IEEE_addr_req command (ClusterID=0x0001) will be send.

nwkAddOfInt is the short address of the remote device for which the extended address (IEEE address) is required.

reqType is Request type for this command.

0 - SINGLE_RESPONSE_REQUESTTYPE - Only the address of the target device is requested

1 - EXTENDED_RESPONSE_REQUESTTYPE - Address of all target's child nodes (only end devices) are also requested.

macBanNode < extAddrHigh > < extAddrLow > < shortAddr > < cost > < rssi >

example: macBanNode 0xaabbccdd 0x11223344 0x7011 0xFF -100

This console command bans any frame from the node or correct link cost for all the frames.

extAddrHigh & extAddrLow - extended address of the node affected.

shortAddr - short address of the node affected. If the short address of banned node is unknown then pass 0xFFFE (MAC_NO_SHORT_ADDR).

cost - link cost value for all the frames received from the node. If node shall be baned - use link cost value 0xFF (LINK_COST_VALUE_NODE_BANNED).

macResetBanTable

example: macResetBanTable

Done

This console command reset the ban table and reloads from the config server.

matchDescReq < nwkAddr > < srcEp >

example: matchDescReq 0xFFFD 0x20

This Command launches a search for devices that have endpoints supporting at least one of the specified clusters.

nwkAddr: is the short / network address of the remote device to which Match_Desc_req command (ClusterID=0x0006) will be send.

srcEp is the endpoint to be found.

Here 0xFFFD is the broadcast address of the device which have rx on idle enabled. (RX_ON_WHEN_IDLE_ADDR)

NodeDescReq < dstnwkAddr > < nwkAddrOfInt >

example: NodeDescReq 0xb389 0xb389

This console command requests the node descriptor of a remote device. (Node descriptor contains information about the capabilities of the ZigBee node)

dstnwkAddr is the short address of the remote device to which Node_Desc_req command (ClusterID=0x0001) will be send.

nwkAddrOfInt is the short address of the remote device or to an alternative device for which the node descriptor is required.

nwkAddrReq < dstAddr > < ieeeAddOfIntHigh > < ieeeAddOfIntLow > < reqType >

nwkAddrReq 0xb670 0xaabbccdd 0x1223344 0

This console command requests the short address (network address) of a remote node with a given Extended address (IEEE address).

dstAddr is the short address of the remote device to which NWK_addr_req command (ClusterID=0x0000) will be send.

ieeeAddOfIntHigh & ieeeAddOfIntLow is the extended (IEEE) address to be matched by the Remote

Device.

reqType is Request type for this command.

0 - SINGLE_RESPONSE_REQUESTTYPE - Only the address of the target device is requested

1 - EXTENDED_RESPONSE_REQUESTTYPE - Addresses of all target's child nodes (only end devices) are also requested.

sendBeaconReq

example: sendBeaconReq

This console command sends a beacon request. All other coordinators and routers will respond with a beacon.

sendMgmtBindReq < address > < startIndex >

example: sendMgmtBindReq 0x2de0 0

MgmtBindRsp 0

This console command retrieves the content of the binding table from a remote device.

address is the short address of the remote device to which Mgmt_Bind_req command (ClusterID=0x0033) will be send.

startIndex is the starting Index for the requested elements of the Binding Table.

Here MgmtBindRsp 0 indicate success response.

sendMgmtLeaveReq < dstShortAddr > < devExtAddrHigh > < devExtAddrLow > < rejoin > < removeChildren >

example: sendMgmtLeaveReq 0xd108 0xaabbccdd 0x11223344 0 1

LeaveRsp 0

This console command requests network leave either for a current device or a remote device.

dstShortAddr is the short address of the remote device to which Mgmt_Leave_req command (ClusterID=0x0034) will be send.

devExtAddrHigh & devExtAddrLow is the extended address of the device that should leave the network.

rejoin = 1: the device being asked to leave from the current parent is requested to rejoin the network.

rejoin = 0: the device being asked to leave will not rejoin the network.

removeChildren = 1: the device being asked to leave the network is also being asked to remove its child devices. Otherwise, it has a value of 0.

Here LeaveRsp 0 indicate success response.

sendMgmtLqiReq < address > < startIndex >

example: sendMgmtLqiReq 0xd108 0

MgmtLqiRsp 0

This console command obtains the list of a remote device’s neighbors,

along with corresponding LQI values.

address: is the short address of remote device to which Mgmt_Lqi_req command (ClusterID=0x0031) will be send.

startIndex: is the Starting Index for the requested elements of the Neighbor Table

sendMgmtPermitJoin < dstAddr > < dur > < tcSig >

example: sendMgmtPermitJoin 0xd108 60 0

setPermitJoinRsp 0

This console command configures the target node to allow other nodes to enter the network via MAC association (joining the network for the first time) through this node.

dstAddr: is the short address of remote device to which Mgmt_Permit_Joining_req command (ClusterID=0x0036) will be send.

dur: is time span in seconds during which the ZigBee coordinator or router will allow associations. The value 0x00 or 0xff indicate that permission is disabled or enabled permanently, respectively.

tcSig = 1: indicating a request to change the Trust Center policy

sendNwkMgmtUpdateReq < channel > < scanDuration > < nwkAddr >

example: sendNwkMgmtUpdateReq 20 0xfe 0xd108

Update Done

This console command sends a remote device about the update of network configuration parameters such as channel, Scan duration,network address etc.

Channel: indicate which channels are to be scanned.

scanDuration = 0 to 5: (ZDO_MGMT_ED_SCAN_DUR_0 to ZDO_MGMT_ED_SCAN_DUR_5)request to perform an ED scan with duration depending exponentially on the parameter value.

scanDuration = 0xFE: request to change the working channel.

scanDuration = 0xFF: request to change the device scanChannels and nwkManagerAddr values to those contained in the request.

nwkAddr: is the short address of remote device to which Mgmt_NWK_Update_req command (ClusterID=0x0038) will be send.

The example shows the sendNwkMgmtUpdateReq command which request remote device 0xd108 to change the channel.

simpleDescReq < nwkAddr > < dstEp >

example: simpleDescReq 0xb670 0x23

This console command requests the simple descriptor of the specified endpoint on a remote node. The simple descriptor contains information specific to each endpoint contained in that node.

nwkAddr: is the short address of remote device to which Simple_Desc_req (ClusterID=0x0004) will be send.

dstEp: The endpoint on the destination.

unbindReq <addrMode> < DstAddr > < extDstAddrHigh > < extDstAddrLow > < ep > < ClusterId >

UnBindRsp 0

Requests a remote node to remove an entry from its binding table with the specified сlusterID, source and destination endpoint and extended address.

Here addrMode specifies the format of DstAddr.

Refer Address Mode table for more details.

DstAddr: is the short address of the remote device.

extDstAddrHigh & extDstAddrLow: is the extended address of the destination device.

ep: is the destination endpoint for the binding entry.

ClusterId: is the cluster on the source device that is bound to the destination.

unbindReq2 < addrMode> < DstAddr > < extSrcAddrHigh > < extDstAddrHigh> < extDstAddrLow / GroupID> < ep_Src > < ep_Dst > < ClusterId >

UnBindRsp 0

Requests a remote node to remove an entry from its binding table with the specified сlusterID, source and destination endpoint and extended address.

Here addrMode specifies the format of DstAddr. Refer Address Mode table for more details.

DstAddr: is the short address of the remote device.

extSrcAddrHigh & extSrcAddrLow: is the extended address of the source device.

extDstAddrHigh & extDstAddrLow: is the extended address of the destination device.

ep_Src: is the source endpoint for the binding entry.

ep_Dst: is the destination endpoint for the binding entry.

ClusterId: is the cluster on the source device that is bound to the destination.

ZCL Help

ZCL Help command lists the supported commands related to ZCL functionality. As the clusters and attributes are specific to device type, the list of commands also dependent on the device type of the project.
Table 4-2. General

Command Syntax

Description

readAttribute<addrMode> <addr> <ep> <clusterId> <attId>

Read value of specified attribute on specified cluster from remote device

writeAttribute<addrMode> <addr> <ep> <ClusterId> <attrId> <type> <attrValue1><attrSize>

Sends Write Attribute command for specified attribute and cluster

configureReporting<addrMode> <addr> <ep> <min> <max>

Configure reporting of the occupancy sensor with min and max values

configureReportingWRC<addrMode> <addr> <ep> <ClusterId> <attrId> <type> <min> <max> <repChange>

Configure reporting of the occupancy sensor with min and max values

resetToFactoryDefaults<addrMode> <addr> <ep>

reset all clusters to factory defaults

Table 4-3. Supported Commands in Device Types which has Identify, Basic and Group Cluster supported: All Devices

Command Syntax

Description

setTargetType<type> <addr> <ep>

Set as target(1)/initiator(0)

getGroupMembership<addrMode> <addr> <ep> <count> <groupId1> <groupId2> <groupId3> <groupId4> <groupId5>

Sends the Get Group Membership command.(count)specifies how many group IDs following it should be considered, but five values must be provided as group IDs always.

identify<addrMode> <addr> <ep> <idTime(secs)>

Sends the Identify command to the specified node(s)

identifyQuery<addrMode> <addr> <ep>

Sends the Identify Query command

triggerEffect<addrMode> <addr> <ep> <eftId> <eftVar>

Sends trigger effect command

addGroup<addrMode> <addr> <ep> <group>

Sends the Addr Group command to the specified node(s).

addGroupIfIdentifying<addrMode> <addr> <ep> <groupId>

Sends the Addr Group If Identifying command(s).

removeGroup<addrMode> <addr> <ep> <group>

Sends the Remove Group command to the specified node(s).

viewGroup<addrMode> <addr> <ep> <group>

Sends the View Group command t

resetTargetToFN

reset the target to factory new

Table 4-4. "Lights" Specific Commands

The device implements light specific client clusters supports below commands: Combined Interface, Color Scene Controller

Command Syntax

Description

addScene<addrMode> <addr> <ep> <groupId> <sceneId> <transitionTime> <onOff> <level>

Sends the Add Scene command

viewScene<addrMode> <addr> <ep> <groupId> <sceneId>

Sends the View Scene command

removeScene<addrMode> <addr> <ep> <groupId> <sceneId>

Sends the Remove Scene command

removeAllScene<addrMode> <addr> <ep> <groupId>

Sends the Remove All Scene command

storeScene<addrMode> <addr> <ep> <groupId> <sceneId>

Sends the Store Scene command

recallScene<addrMode> <addr> <ep> <groupId> <sceneId>

Sends the Recall Scene command

addSceneToDL<addrMode> <addr> <ep> <groupId> <sceneId> <transitionTime> <onOff> <level>

Sends the Store Scene command

getSceneMembership<addrMode> <addr> <ep> <groupId>

Sends the Get Scene Membership command

onOff<addrMode> <addr> <ep> <"-on"/"-off">

Turn the specified light device(s) on or off

offWithEffect<addrMode> <addr> <ep> <effectId> <effectVariant>

Sends off with effect command

onWithRecallGlobalScene<addrMode> <addr> <ep>

Sends on the Recall Global scene command

onWithTimedOff<addrMode> <addr> <ep> <onOffCtrl> <onTime> <offWaitTime>

Sends on with timed off

moveToLevel<addrMode> <addr> <ep> <level> <transitionTime> <onOff> <optMask> <optOvrd>

Send the Move to level (with On/Off) command

move<addrMode> <addr> <ep> <rate> <onOff>

Send the Move (with On/Off) command

step<addrMode> <addr> <ep> <mode> <stepSize> <transitionTime> <onOff>

Send the Step (with On/Off) command

stop<addrMode> <addr> <ep> <onOff>

Send the Stop (with On/Off) command

Table 4-5. IAS ACE

Command Syntax

Description

IASACEArmCommand <addrMode> <addr> <ep> <ArmMode> <Arm/Code> <Zone/Id>

Sends IAS ACE Arm command to the CI(CIE) along with Arm mode with its code to the zoneId

IASACEBypassCommand <addrMode> <addr> <ep> <zone_numbers> <zone_id1> <zone_id2> <zone_id3> <arm_code_code>

Sends IAS ACE Bypass command with the listof zoneIds along with the code to the CI (CIE)

IASACEEmergencyCommand <addrMode> <addr> <ep>

Sends IAS ACE Emergency command to the CI (CIE)

IASACEFireCommand <addrMode> <addr> <ep>

Sends IAS ACE Fire command to the CI (CIE)

IASACEPanicCommand <addrMode> <addr> <ep>

Sends IAS ACE Panic command to the CI (CIE)

IASACEGetZoneIdMapCommand <addrMode> <addr> <ep>

Sends IAS ACE Get Zone Id Map command to the CI (CIE)

IASACEGetZoneIdInformationCommand <addrMode> <addr> <ep> <zone_id>

Sends IAS ACE Get Zone Information Command to get the complete information of the zoneId

IASACEGetPanelStatusCommand <addrMode> <addr> <ep>

Sends IAS ACE Get Panel Status command to the CI(CIE) to get the Panel's status

IASACEGetZoneStatusCommand <addrMode> <addr> <ep> <starting_zone_id> <max_number_zoneids> <zonestatus_maskflag> <zonestatus_mask>

Sends IAS ACE Get Zone Status Command to get the Zone status. The command would list the starting zoneId with the maximum number to read from there

ZoneEnrollReqCmd <addrMode> <addr> <ep> <zone_type> <manuf_code>

Sends IAS Zone Enroll Request Command to the CI (CIE) as part of Zone Enrollment

ZoneStatusChangeNotifiCmd <addrMode> <addr> <ep> <zonestatus> <ext_status>

Sends IAS Zone Status Change. a notification to the CI(CIE)

ZoneStatusChange <Device_Spec_Bits>

To change the internal zone status to trigger a change notification to the CI(CIE)

GetByPassZoneList <addrMode> <addr> <ep>

Sends IAS ACE GetByPassZone list which were already bypassed and part of the bypass table

Table 4-6. Thermostat

Command Syntax

Description

setOccupancy <0- UnOccupied/ 1- Occupied>

Sets the Occupancy State either to Occupied / Unoccupied

clusterAttrInitDefault <ClusterID>

Inititalizes all Attributes to default value

setOccupancyState <state>

Sets the Occupancy state to either Occupied or Unoccupied

setOccupancySensorType <sensorType>

Sets the Occupancy Sensor Type

triggerAlarm <ClusterId> <alarmCode> <Raise/Clear>

Triggers Alarm either to Raise / Clear with the Alarm Code

setAlarmMask <ClusterId> <alarmMask>

Sets the Alarmmask

resetAlarms

Resets the alarm

Table 4-7. Additional Commands Supported by the Coordinator/Combined Interface Device

Command Syntax

Description

readReporting<addrMode> <addr> <ep> <clusterId> <attrId>

Read reporting from specified cluster server

thermSetPointChange <addrMode> <addr> <ep> <setPtmode> <amount>

Sends thermostat Set Point Change Command along with the mode and amount

setUTCTime <dd:mm:yr:hr:min:sec>

Sets the UTC time

readTime

Reads the current time

setTimeZoneAndDST <timeZone> <dstStart> <dstEnd> <dstShift>

Sets the time zone and DST

setTimeStatus<addrMode> <addr> <ep> <ClusterId> <alarmCode>

Sets the time status of the device

resetAlarm<addrMode> <addr> <ep> <ClusterId> <alarmCode>

resets the alarm with its code

alarmCmd <addrMode> <addr> <ep> <resetAllAlarm/getAlarm/resetAlarmLog>

Alarm Command which could be resetAllAlarm/getAlarm/resetAlarmLog

IasAceGetPanelStatusChangedCommand<addrMode> <addr> <ep> <panel_status> <seconds_remaining> <audible_noti> <alarmStatus>

Sends Panel Status Changed Command to the Ace device with its status and seconds remaining for the change with actions to be taken w.r.t alarmstatus and its audible notification

IasAceZoneStatusChangedCommand<addrMode> <addr> <ep> <zoneId> <zone_status> <audible> <zone_label>

Sends Zone status Changed command to the Ace device with its status along with audible details and zone label

ZoneInitiateNormalOperatingModeCommand<addrMode> <addr> <ep>

Sends to initiate Normal Operating mode at the Ace device

ZoneInitiateTestModeCommand<addrMode> <addr> <ep> <Test_Mode_Duration> <Current Zone Sensitiivity Level>

Sends to initiate Test operating Mode at the Ace device with its duration for the same with its current zone sensitivity level

Command Syntax

Response

Description

readAttribute < addrMode > < addr > < ep > < clusterId > < attrId >

e.g.: readAttribute -s 0x24b8 0x23 0x0006 0x0000

Attribute operation response received: status = 0x00

<-Read attribute (AttrId:0x0) response: success, Attr value = 0

This console command read value of specified attribute on specified cluster from remote device using.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device for which the read attribute zcl command (ZCL_READ_ATTRIBUTES_COMMAND_ID) to be send.

ep: The endpoint on the remote device that is to be read.

clusterId: Unsigned 16-bit Cluster identifier whose attribute need to be read.

attrId: Attribute ID of the Attribute that need to be read.

Here in example command, -s indicate that address mode is short address, 0x24b8 is the short address of the remote device, 0x23 is endpoint of the remote device i.e., extend color light,0x0006 is the OnOff ClusterID and 0x00 is the attributeID for OnOff attribute

writeAttribute < addrMode > < addr > < ep > < clusterId > < attrId > < type > < attrValue1,2.. > < attrSize >

example: writeAttribute -s 0x24b8 0x23 0x0006 0x4001 0x21 0x01 0x02

Attribute operation response received: status = 0x00

<-Write attribute response: success

This console command sends Write Attribute command for specified attribute and cluster to a remote device.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device for which the writes attribute zcl command to be send (ZCL_WRITE_ATTRIBUTES_COMMAND_ID).

ep: The endpoint on the remote device that is to be written.

clusterId: Unsigned 16-bit Cluster identifier whose attribute need to be written.

attrId: Attribute ID of the Attribute that need to be written.

type: Attribute Type

attrValue: attribute value that need to be written

attrSize: Size of the attribute data

Here in example command, -s indicate that address mode is short address, 0x24b8 is the short address of the remote device, 0x23 is endpoint of the remote device i.e., extend color light,0x0006 is the OnOff ClusterID and 0x4001 is the attributeID for OnTime attribute, 0x21 is the attribute type (ZCL_U16BIT_DATA_TYPE_ID, refer ZCL_AttributeType_t in zigbee application for details)

0x01 is the attribute value and 0x02 is the size of attribute data.

writeAttributeNoResp < addrMode > < addr > < ep > < clusterId > < attrId > < type > < attrValue1,2.. > < attrSize >

example: writeAttributeNoResp -s 0x24b8 0x23 0x0006 0x4001 0x21 0x01 0x02

No Response

This console command sends Write Attribute command for specified attribute and cluster to a remote device and specifies the remote devices not to send a response.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device for which the write attribute no response zcl command to be send (ZCL_WRITE_ATTRIBUTES_NO_RESPONSE_COMMAND_ID).

ep: The endpoint on the remote device that is to be written.

clusterId: Unsigned 16-bit Cluster identifier whose attribute need to be written.

attrId: Attribute ID of the Attribute that need to be written.

type: Attribute Type

attrValue: attribute value that need to be written

attrSize: Size of the attribute data

Here in example command, -s indicate that address mode is short address, 0x24b8 is the short address of the remote device, 0x23 is endpoint of the remote device i.e., extend color light,0x0006 is the OnOff ClusterID and 0x4001 is the attributeID for OnTime attribute, 0x21 is the attribute type (ZCL_U16BIT_DATA_TYPE_ID, refer ZCL_AttributeType_t in zigbee application for details)

0x01 is the attribute value and 0x02 is the size of attribute data.

configureReporting < addrMode > < addr > < ep > < clusterId > < attrId > < type > < min > < max >

eg: configureReporting -s 0x1593 0x23 0x0006 0x00 0x10 0x01 0x02

Attribute operation response received: status = 0x00

This console command is used to change the reporting timeout on the remote device.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device for which the configure reporting zcl command to be send (ZCL_CONFIGURE_REPORTING_COMMAND_ID).

ep: The endpoint on the remote device that is to be written.

clusterId: Unsigned 16-bit Cluster identifier whose attribute need to be configured.

attrId: Attribute ID of the Attribute that need to be configured.

type: Attribute Type

min: the minimum reporting interval in seconds, between issuing reports of the specified attribute.

max: the maximum reporting interval in seconds, between issuing reports of the specified attribute

The min and max reporting interval field is 16 bits (Unsigned) in length.

Here in example command, -s indicate that address mode is short address*, 0x1593* is the short address of the remote device, 0x23 is endpoint of the remote device i.e., extend color light,0x0006 is the OnOff ClusterID and 0x00 is the attributeID for OnOff attribute, 0x10 is the attribute type (ZCL_BOOLEAN_DATA_TYPE_ID, refer ZCL_AttributeType_t in zigbee application for details) 1 in the min reporting interval (1 sec) & 2 in the min reporting interval (2 sec)

configureReportingWRC < addrMode > < addr > < ep > < clusterId > < attrId > < type > < min > < max > < repChange >

eg: configureReportingWRC -s 0x1593 0x23 0x0006 0x00 0x10 0x01 0x02 0x00

Attribute operation response received: status = 0x00

This console command Sends configure reporting with reportable Change to specified cluster server.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device for which the configure reporting zcl command to be send (ZCL_CONFIGURE_REPORTING_COMMAND_ID).

ep: The endpoint on the remote device that is to be written.

clusterId: Unsigned 16-bit Cluster identifier whose attribute need to be configured.

attrId: Attribute ID of the Attribute that need to be configured.

type: Attribute Type

min: the minimum reporting interval in seconds, between issuing reports of the specified attribute.

max: the maximum reporting interval in seconds, between issuing reports of the specified attribute

The min and max reporting interval field is 16 bits in length.

Here in example command, -s indicate that address mode is short address*, 0x1593* is the short address of the remote device, 0x23 is endpoint of the remote device i.e., extend color light,0x0006 is the OnOff ClusterID and 0x00 is the attributeID for OnOff attribute, 0x10 is the attribute type (ZCL_BOOLEAN_DATA_TYPE_ID, refer ZCL_AttributeType_t in zigbee application for details) 1 in the min reporting interval (1 sec) & 2 in the min reporting interval (2 sec)

readReporting < addrMode > < addr > < ep > < clusterId > < attrId >

eg: readReporting -s 0x1593 0x23 0x0006 0x00

Attribute operation response received: status = 0x00

<-Read Reporting Attribute (0x0) response: success

min = 1 max = 2 direction = 0 attributeType = 16 reportableChange = 0

This console command read reporting configuration from specified cluster server.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device for which the read reporting zcl command to be send (ZCL_READ_REPORTING_CONFIGURATION_COMMAND_ID).

ep: The endpoint on the remote device of which reporting configuration need to be read.

clusterId: Unsigned 16-bit Cluster identifier whose attribute need to be configured.

attrId: Attribute ID of the Attribute that need to be configured.

Here in example command, -s indicate that address mode is short address*, 0x1593* is the short address of the remote device, 0x23 is endpoint of the remote device i.e., extend color light,0x0006 is the OnOff ClusterID and 0x00 is the attributeID for OnOff attribute.

addGroup < addrMode > < addr > < ep > < gid >

example: addGroup -s 0x1593 0x23 0x1234

addGroupResponseInd()

This console command sends zcl Add Group command to remote device which allows the sending device to add group membership in a particular group for one or more endpoints on the receiving device.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device to which addgroup zcl command to be send.

ep: The endpoint on the remote device that needs to be added in the group.

gid: Unsigned 16-bit identifier for a group.

Here in example command, -s indicate that address mode is short address*, 0x1593* is the short address of the remote device, 0x23 is endpoint of the remote device. 0x1234 is theGroupID. This command will create/add device 0x1593 into Group 0x1234. The device can be controlled using GroupID also e.g.: onOff -g 0x1234 0x23 -toggle.

addGroupIfIdentifying < addrMode > < addr > < ep > < gid >

example: addGroupIfIdentifying -s 0x1593 0x23 0xabcd

No Response

This console command sends the Add Group If Identifying zcl command to remote device which allows the sending device to add group membership in a particular group for one or more endpoints on the receiving device, on condition that it is identifying itself. Identifying functionality is controlled using the identify cluster.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device to which addgroup zcl command to be send.

ep: The endpoint on the remote device that needs to be added in the group.

gid: Unsigned 16-bit identifier for a group.

Here in example command, -s indicate that address mode is short address*, 0x1593* is the short address of the remote device, 0x23 is endpoint of the remote device. 0xabcd is theGroupID.

getGroupMembership < addrMode > < addr > < ep > < count > < groupId1 > < groupId2 > < groupId3 > < groupId4 > < groupId5 >

e.g.: getGroupMembership -s 0x1593 0x23 1 0x1234 0 0 0 0

getGroupMembershipResponse()

groupCount = 1

groupId = 0x1234

This console command sends the Get Group Membership zcl command to remote device which allows the sending device to inquire about the group membership of the receiving device.

specifies how many

group IDs following it should be

considered, but five values must be

provided as group IDs always.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device to which get group membership zcl command to be send.

ep: The endpoint on the remote device.

count: specifies how many group IDs following it should be considered, but five values must be

provided as group IDs always.

groupId1 to groupId5: Unsigned 16-bit identifier for a group

Here in example command, -s indicate that address mode is short address*, 0x1593* is the short address of the remote device, 0x23 is endpoint of the remote device. 1 is count, 0x1234,0,0,0,0are the GroupID’s.

removeAllGroups < addrMode > < addr > < ep >

example: removeAllGroups -s 0x1593 0x23

No Response

This command sends Remove All Group zcl command to remote device which allows the sending device to direct the receiving device to remove all group associations.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device to which get remove all group zcl command to be send.

ep: The endpoint on the remote device.

Here in example command, -s indicate that address mode is short address*, 0x1593* is the short address of the remote device, 0x23 is endpoint of the remote device.

removeGroup < addrMode > < addr> < ep > < gid>

example: removeGroup -s 0x1593 0x23 0x1234

removeGroupResponseInd(): groupId = 0x1234

This command sends remove group zcl command to remote device which allows the sender to request the receiving device to remove the membership from the specified group.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device to which get remove group zcl command to be send.

ep: The endpoint on the remote device.

gid: Unsigned 16-bit identifier for a group.

Here in example command, -s indicate that address mode is short address*, 0x1593* is the short address of the remote device, 0x23 is endpoint of the remote device. 0x1234 is theGroupID.

viewGroup < addrMode > < addr> < ep > < gid>

example: viewGroup -s 0x1593 0x23 0x1234

viewGroupResponse(): status = 0x00 groupId = 0x1234

This command sends view group zcl command to remote device which allow the sending device to request that the receiving device to respond

with a view group response command containing the information of the requested GroupID.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device to which get view group zcl command to be send.

ep: The endpoint on the remote device.

gid: Unsigned 16-bit identifier for a group.

Here in example command, -s indicate that address mode is short address*, 0x1593* is the short address of the remote device, 0x23 is endpoint of the remote device. 0x1234 is theGroupID.

resetTargetToFN

example: resetTargetToFN

Status = 1

Reset the Touchlink target to factory new

setTargetType < type >

example: setTargetType 1

Done

This console commands set touchlink device type as target / initiator

1 – target

0 – initiator

SetbdbJoinUsesInstallCodeKey < value >

example: SetbdbJoinUsesInstallCodeKey 1

No Response

This console command sets the install code usage at the trust center.

1 - TC will allow only install code devices to join.

0 – otherwise.

resetToFactoryDefaults < addrMode > < addr > < ep >

example: resetToFactoryDefaults -s 0xcbb4 0x23

No Response

This console command reset all cluster attributes to factory defaults.

disableDefaultResp < value >

example: disableDefaultResp 1

No Response

This console command Disable/Enable default response for ZCL command

0 – enable

1 –disable

addSceneToDL < addrMode > < addr > < ep > < groupId > < sceneId > < transitionTime > < onOff > < level >

e.g.: addSceneToDL -s 0x8d7f 0x23 0x1234 0x10 60 1 0xff

Add scene response: status = 0x00

groupId = 0x1234

sceneId = 0x11

This console command sends scene zcl command to dimmable light device which allow the sending device to request that the dimmable light device to add an entry in its Scene Table with the given sceneID.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

groupId: Unsigned 16-bit identifier for a group.

sceneId: 8-bit unique identifier within group groupId, which is used to identify this scene.

transitionTime: Unsigned 16-bit time value which will take for the device to change from its current state to the requested state.

onOff: 1-bit onOff value 1 or 0.

level: 8-bit light brightness level (0 - 0xff, where 0xff is max brightness).

Here in example command, -s indicate that address mode is short address*, 0x1593* is the short address of the remote device, 0x23 is endpoint of the remote device. 0x1234 is theGroupID. 0x10 is the sceneID, 60 is the transitionTime, 1 is the onOff value and 0xff is the light level.

Note: Ensure that a group with ID 0x1234 is created before executing this command (eg: addGroup -s 0x8d7f 0x23 0x1234).

addSceneToTH < addrMode > < addr > < ep > < groupId > < sceneId > < transitionTime > < occupiedCoolingSetpoint > < occupiedHeatingSetpoint > < systemMode >

No Response

This console command sends Add Scene zcl command to Thermostat device to add an entry in its Scene Table with the given sceneID.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

groupId: Unsigned 16-bit identifier for a group.

sceneId: 8-bit unique identifier within group groupId, which is used to identify this scene.

transitionTime: Unsigned 16-bit time value which will take for the device to change from its current state to the requested state.

occupiedCoolingSetpoint: signed 16-bit, Occupied Cooling Setpoint Attribute specifies the cooling mode setpoint when the room is occupied.

occupiedHeatingSetpoint: signed 16-bit, occupied Heating Setpoint Attribute specifies the heating mode setpoint when the room is occupied.

systemMode: (Unsigned 8-bit) System Mode attribute specifies the current operating mode of the thermostat.

Note: Ensure that a group is created before executing this command. (using addGroup console command).

getSceneMembership < addrMode > < addr > < ep > < groupId >

e.g.: getSceneMembership -s 0x8d7f 0x23 0x123

Note: No Response

This console command sends Get Scene Membership zcl command to remote device. The Get Scene Membership command can be used to find an unused scene number within the group.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

groupId: Unsigned 16-bit identifier for a group.

Here in example command, -s indicate that address mode is short address*, 0x1593* is the short address of the remote device, 0x23 is endpoint of the remote device. 0x1234 is theGroupID.

move < addrMode > < addr > < ep > < mode > < rate > < onOff > < optMask > < optOvrd >

e.g. Down: move -s 0x3bb6 0x23 1 0x7f 0 0 0

e.g. Up: move -s 0x3bb6 0x23 0 0x7f 1 0 0

Observe the change in LED level in light (dimmable) device.

This console command sends Move zcl command to remote light device.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

mode: move up or down.

0x00 – Up

0x01 – Down

rate: specifies the rate of movement in units per second.

onOff: 1-bit onOff value 1 - On or 0 - Off.

optMask: options mask

optOvrd: options override

Here in first example command, -s indicate that address mode is short address*,* 0x3bb6* is the short address of the remote device, 0x23 is endpoint of the remote device. 1 is the down mode. 0x7f is the rate. 1 indicates on/off and 0 & 0 are options mask and options override.

moveToLevel < addrMode > < addr > < ep > < level > < transitionTime > < onOff > < optMask > < optOvrd >

e.g.: moveToLevel -s 0xe015 0x23 0x7f 0x000c 1 0 0

Observe the change in LED level in light (dimmable) device.

This console command sends Move to level zcl command to remote device which request the remote light (dimmable) to move from its current level to the given level.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

level: unsigned 8-bit value which holds brightness level of the light(dimmable) device.

transitionTime: unsigned 16-bit value which specifies time taken to move to the new level.

onOff: 1-bit onOff value 1 - On or 0 - Off.

optMask: options mask

optOvrd: options override

Here in example command, -s indicate that address mode is short address, 0xe015 is the short address of the remote device, 0x23 is endpoint of the remote device. 0x7f is the new brightness level for the light (dimmable). 0x000c is the transition time. 1 indicates on/off and 0 & 0 are options mask and options override.

offWithEffect < addrMode > < addr > < ep > < effectId > < effectVariant >

e.g: offWithEffect -s 0xe015 0x23 0x01 0x00

Observe the change in LED level in light (dimmable) device.

This console command sends Off With Effect zcl command to remote light device request the devices to be turned off using enhanced ways of fading.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

effectId: unsigned 8-bits in length and specifies the fading effect to use when switching the device off.

0 - Delayed All Off

1 - Dying Light

effectVariant: unsigned 8-bits in length and is used to indicate which variant of the effect.

effectID

effectVariant

Description

0x00

0x00

Fade to off in 0.8 Secs

0x00

0x01

No fade

0x00

0x02

50% dim down in 0.8 seconds then fade to off in 12 secs

0x01

0x00

20% dim up in 0.5s then fade to off in 1 sec

Here in example command, -s indicate that address mode is short address, 0xe015 is the short address of the remote device, 0x23 is endpoint of the remote device. 0x01 is the effectId

onWithRecallGlobalScene < addrMode > < addr > < ep >

e.g.: onWithRecallGlobalScene -s 0xbaf4 0x23

Observe the change in LED level in light (dimmable) device.

This console command sends on with Recall Global sceneI zcl command to remote device which request remote device to recall the settings when the device was turned off.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

Here in example command, -s indicate that address mode is short address, 0xbaf4 is the short address of the remote device, 0x23 is endpoint of the remote device.

onWithTimedOff < addrMode > < mode > < ep > < onOffCtrl > < onTime > < offWaitTime >

e.g.: onWithTimedOff -s 0xbaf4 0x23 0 300 0

Observe the light get turned on immediately and turns off after 30 sec

This console command sends on with Timed Off scene zcl command which request the remote devices to be turned on for a specific duration (as specified in onTime duration) with a guarded off duration (offWaitTime).

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

onOffCtrl: Control field specifies whether the On with Timed Off command is to be processed unconditionally or only when the OnOff attribute is equal to 0x01.

0 - command shall be processed unconditionally.

1 – command shall accepted if the OnOff attribute is equal to 0x01.

onTime: unsigned 16-bit value which specifies the length of time (in 1/10ths second) that the device is to remain “on”.

offWaitTime: duration prevent turning back on the device for On with Timed Off commands received during this time.

Here in example command, -s indicate that address mode is short address, 0xbaf4 is the short address of the remote device, 0x23 is endpoint of the remote device. 0 is onOffCtrl which means On with Timed Off command is processed unconditionally. 300 is onTime of 30 seconds and 0 is the offWaitTime.

recallScene < addrMode > < addr > < ep > < groupId > < sceneId > < transitionTime >

e.g.: recallScene -s 0xbaf4 0x23 0x1234 0x10 3

This console command sends recall scene zcl command which request the remote devices to locate the entry in its Scene Table with the Group ID and Scene ID and then set the corresponding scene.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

groupId: Unsigned 16-bit identifier for a group.

sceneId: 8-bit unique identifier within group groupId, which is used to identify this scene.

transitionTime: Unsigned 16-bit time value which will take for the device to change from its current state to the requested state.

Here in example command, -s indicate that address mode is short address, 0xbaf4* is the short address of the remote device, 0x23 is endpoint of the remote device. 0x1234 is the GroupID. 0x10 is the sceneID and 3 is the transition time.

removeAllScenes < addrMode > < addr > < ep > < groupId >

e.g.: removeAllScenes -s 0x666e 0x23 0x1234

Remove all scenes response: status = 0x00

groupId = 0x1234

This console command sends remove all scene zcl command which request the remote devices to remove from its Scene Table all entries with this Group ID.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

groupId: Unsigned 16-bit identifier for a group.

Here in example command, -s indicate that address mode is short address, 0x666e is the short address of the remote device, 0x23 is endpoint of the remote device. 0x1234 is the GroupID.

removeScene < addrMode > < addr > < ep > < groupId > < sceneId >

eg: removeScene -s 0x666e 0x23 0x1234 0x10

Remove scene response: status = 0x00

groupId = 0x1234

sceneId = 0x10

This console command sends remove scene zcl command which request the remote devices to remove from its Scene Table the entry with this

Scene ID and group ID.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

groupId: Unsigned 16-bit identifier for a group.

sceneId: unsigned 8-bit unique identifier within group.

Here in example command, -s indicate that address mode is short address, 0x666e is the short address of the remote device, 0x23 is endpoint of the remote device. 0x1234 is the GroupID. 0x10 is the sceneID.

step < addrMode > < addr > < ep > < mode > < stepSize > < transitionTime > < onOff > < optMask > < optOvrd >

e.g.: step -s 0x6776 0x23 0x00 0x0f 300 1 0 0

Observe the change in brightness of the light.

This console command sends step zcl command which request the remote devices to move from its current level in an up or down direction (mode) in stepSize. Each step command will increment / decrement brightness of the light device till reaches the maximum / minimum level allowed for the device.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

mode: move up or down.

0x00 – Up.

0x01 – Down

stepSize: unsigned 8-bit value. stepsize is a change in the CurrentLevel by step size value.

transitionTime: Unsigned 16-bit time value in tenths of a second which will take for the device to change from its current state to the requested state.

onOff: 1-bit onOff value 1 or 0.

optMask: options mask

optOvrd: options override

Here in example command, -s indicate that address mode is short address, 0x6776 is the short address of the remote device, 0x23 is endpoint of the remote device. 0x00 indicates up mode. 0x0f is the stepsize, the brightness of the light will increase by 15(0x0f) units. 300 is the transition time. 1 is the onOff value. 0, 0 is the options mask and options override value.

stop < addrMode > < addr > < ep > < onOff > < optMask > < optOvrd >

e.g.: stop -s 0x6776 0x23 0 0 0

This console command sends stop zcl command which request the remote devices to terminate any Move to Level, Move or Step command

(and their 'with On/Off' variants) currently in process.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

mode: move up or down.

onOff: 1-bit onOff value 1 or 0.

optMask: options mask

optOvrd: options override

storeScene < addrMode > < addr > < ep > < groupId > < sceneId >

e.g.: storeScene -s 0x6776 0x23 0x1234 0x10

Store scene response: status = 0x00

groupId = 0x1234

sceneId = 0x10

This console command sends store scene zcl command which request the remote devices to add an entry in the Scene Table with the SceneID and Group ID given in the command, and all extension field sets corresponding to the current state of other clusters on the device.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

groupId: Unsigned 16-bit identifier for a group.

sceneId: unsigned 8-bit unique identifier within group.

Here in example command, -s indicate that address mode is short address, 0x6776 is the short address of the remote device, 0x23 is endpoint of the remote device. 0x1234 is the GroupID. 0x10 is the sceneID.

triggerEffect < addrMode > < addr > < ep > < effectId > < effectVariant >

e.g: triggerEffect -s 0x6776 0x23 0x01 0

Observe the change in Light device

This console command sends trigger effect zcl command to remote device which allows the support of feedback to the user, such as a certain light effect. It is used to allow an implementation to provide visual feedback to the user under certain circumstances such as a color light turning green when it has successfully connected to a network.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

effectId: 8-bits in length and specifies the identify effect to use.

effectVariant: 8-bits in length and is used to indicate which variant of the effect, indicated in the effect identifier field.

Effect Identifier

Effect

Description

0x00

link

Light is turned on/off once.

0x01

Breathe

Light turned on/off over 1 second and repeated 15 times.

0x02

Okay

Colored light turns green for 1 second; noncolored light flashes twice.

0x0b

Channel Change

Colored light turns orange for 8 seconds

noncolored light switches to maximum brightness for 0.5s and then minimum brightness for 7.5s

0xfe

Finish Effect

Complete the current effect sequence before terminating.

0xff

Stop Effect

Terminate the effect as soon as possible.

Here in example command, -s indicate that address mode is short address, 0x6776 is the short address of the remote device, 0x23 is endpoint of the remote device. 1 is the Breath effectId and 0 is the effectVariant.

viewScene < addrMode > < addr > < ep > < groupId > < sceneId >

e.g.: viewScene -s 0x6776 0x23 0x1234 0x10

View scene response: status = 0x00

groupId = 0x1234

sceneId = 0x10

transitionTime = 0x0000

This console command sends view scene zcl command to remote device. On receipt of this command, the remote device checks for the entry in scene table for specified sceneID and responds the scene information.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

groupId: Unsigned 16-bit identifier for a group.

sceneId: unsigned 8-bit unique identifier within group.

Here in example command, -s indicate that address mode is short address, 0x6776 is the short address of the remote device, 0x23 is endpoint of the remote device. 0x1234 is the GroupID. 0x10 is the sceneID.

onOff < addrMode > < addr > < ep > < onOff_ID >

e.g.: onOff -s 0x6776 0x23 -toggle

Observe the light, The light gets toggled (on or off).

This console command sends on, off or toggle zcl command, which request the remote devices to turn off or turn on or toggle the light.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

onOff_ID: hold on, off or toggle parameter.

-on : Turns on the light.

-off : Turns off the light.

-toggle: Toggle the light.

Here in example command, -s indicate that address mode is short address, 0x6776 is the short address of the remote device, 0x23 is endpoint of the remote device. ‘*-toggle*’ toggles the current state of the light.

identify < addrMode > < addr > < ep > < idTime >

e.g.: identify -s 0x6776 0x23 10

Observe the light. The light flashes for 10 seconds

This console command sends identify zcl command to remote devices which request to the remote to start / stop identifying procedure. The identifying procedure consists of flashing a light with a period of 0.5 seconds which helps an observer to identify the device from several devices.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

idTime: specifies identification duration (in seconds) which device continues to identify.

Here in example command, -s indicate that address mode is short address, 0x6776 is the short address of the remote device, 0x23 is endpoint of the remote device. 10 is the identify time in seconds.

identifyQuery < addrMode > < addr > < ep >

e.g.: identifyQuery -s 0x6776 0x23

This console command sends identify query zcl command to remote devices which allows the sending device to request the target or targets to respond if they are currently identifying themselves.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

moveToHue < addrMode > < addr > < ep > < hue > < direction > < transitTime > < optMask > < optOvrd >

e.g.: moveToHue -s 0x6776 0x23 0x5A 1 50 0 0

This console command sends move to hue zcl command to remote devices which request the remote device to move its current hue to the value given in the Hue field

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

hue: unsigned 8-bit hue value of light, ranges from 0 - 254.

direction: direction of the hue movement.

Direction

Description

0x00

Shortest Distance

0x01

Longest Distance

0x02

Up

0x03

Down

transitTime: Unsigned 16-bit time value which will take for the device to change from its current hue to the requested hue (1/10ths of a second).

optMask: options mask.

optOvrd: options override.

Here in example command, -s indicate that address mode is short address, 0x6776 is the short address of the remote device, 0x23 is endpoint of the remote device. 0x5A is new hue value. 1 is the direction to hue to fade (longest distance). 50 is the transition time i.e.seconds. 0, 0 is the options mask and options override value.

moveHue < addrMode > < addr > < ep > < moveMode > < rate > < optMask > < optOvrd >

e.g.: moveHue -s 0x6776 0x23 1 5 0 0

Observe change in light color continuously

This console command sends move hue zcl command to remote devices which request the remote device to move its current hue in an up or down direction in a continuous fashion.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

moveMode: up or down direction of hue attribute.

Move Mode

Description

0x00

Stop

0x01

Up

0x02

Reserved

0x03

Down

rate: rate of movement of hue in steps per second.

optMask: options mask.

optOvrd: options override.

Here in example command, -s indicate that address mode is short address, 0x6776 is the short address of the remote device, 0x23 is endpoint of the remote device. 1 is the moveMode for moving the hue attribute in up direction. 5 is the rate of change of hue in seconds. 0, 0 is the options mask and options override value.

stepHue < addrMode > < addr > < ep > < stepMode > < stepSize > < transitTime > < optMask > < optOvrd >

e.g.: stepHue -s 0x6776 0x23 1 0x1f 10 0 0

Observe change in light color.

This console command sends step Hue zcl command which request the remote devices to move from its current hue (color) in an up or down direction (mode) in stepSize. Each step command will increment / decrement hue of the light device till reaches the maximum / minimum hue value allowed for the device.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

stepMode: move up or down.

0x01 – Up.

0x03 – Down

stepSize: unsigned 8-bit value. stepsize is a change in the CurrentHue by step size value.

transitTime: Unsigned 8-bit time value in tenths of a second which will take for the device to change from its current state to the requested state.

optMask: options mask.

optOvrd: options override.

Here in example command, -s indicate that address mode is short address, 0x6776 is the short address of the remote device, 0x23 is endpoint of the remote device. 1 is the Up direction. 0x1f (31) is the step size. 10 is the transition time. 0, 0 is the options mask and options override value.

moveToSaturation < addrMode > < addr > < ep > < saturation > < transitTime > < optMask > < optOvrd>

e.g.: moveToSaturation -s 0x1984 0x23 0xef 10 0 0

Observe change in light saturation.

This console command sends move to saturation zcl command which request the remote devices to move from its current saturation to the value given in the Saturation field.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

saturation: unsigned 8-bit saturation value of light which ranges from range 0 to 254.

transitTime: Unsigned 16-bit time value which will take for the device to change from its current saturation to the requested saturation (1/10ths of a second).

optMask: options mask.

optOvrd: options override.

Here in example command, -s indicate that address mode is short address, 0x1984 is the short address of the remote device, 0x23 is endpoint of the remote device. 0xef is new hue value. 10 is the transition time. 0, 0 is the options mask and options override value.

moveSaturation < addrMode > < addr > < ep > < moveMode > < rate > < optMask > < optOvrd >

eg.: moveSaturation -s 0x1984 0x23 1 0x05 0 0

Observe change in light saturation.

This console command sends move saturation zcl command to remote devices which request the remote device to move its current saturation in an up or down direction in a continuous fashion.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

moveMode: up or down direction of hue attribute.

Move Mode

Description

0x00

Stop

0x01

Up

0x02

Reserved

0x03

Down

rate: unsigned 8-bit, rate of movement of hue in steps per second.

optMask: options mask.

optOvrd: options override.

Here in example command, -s indicate that address mode is short address, 0x1984 is the short address of the remote device, 0x23 is endpoint of the remote device. 1 is the Up moveMode for moving the saturation in up direction. 0x05 is the rate of change of hue in seconds. 0, 0 is the options mask and options override value.

stepSaturation < addrMode > < addr > < ep > < stepMode > < stepSize > < transitTime > < optMask > < optOvrd >

e.g.: stepSaturation -s 0x1984 0x23 1 0x1f 10 0 0

Observe change in light saturation.

This console command sends step Saturation zcl command which requests the remote devices to move from its current saturation in an up or down direction (mode) in stepSize. Each step command will increment / decrement saturation of the light device till reaches the maximum / minimum saturation value allowed for the device.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

stepMode: move up or down.

0x01 – Up.

0x03 – Down

stepSize: unsigned 8-bit value. stepsize is a change in the CurrentHue by step size value.

transitTime: Unsigned 16-bit time value in tenths of a second which will take for the device to change from its current state to the requested state.

optMask: options mask.

optOvrd: options override.

Here in example command, -s indicate that address mode is short address, 0x1984 is the short address of the remote device, 0x23 is endpoint of the remote device. 1 is the Up direction. 0x1f (31) is the step size. 10 is the transition time. 0, 0 is the options mask and options override value.

moveToHueAndSaturation < addrMode > < addr > < ep > < hue > < saturation > < transitTime > < optMask > < optOvrd >

e.g.: moveToHueAndSaturation -s 0x1984 0x23 0x1f 0xef 10 0 0

Observe change in light hue and saturation.

This console command sends move to hue and saturation zcl command to remote devices which request the remote device to move its current hue and saturation to the value given in the Hue and Saturation field.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

hue: unsigned 8-bit hue value of light, ranges from 0 – 254.

saturation: unsigned 8-bit saturation value of light which ranges from range 0 to 254.

transitTime: Unsigned 16-bit time value which will take for the device to change from its current saturation to the requested saturation (1/10ths of a second).

optMask: options mask.

optOvrd: options override.

Here in example command, -s indicate that address mode is short address, 0x1984 is the short address of the remote device, 0x23 is endpoint of the remote device. 0x1f is new hue value and 0xef is the new saturation value. 10 is the transition time. 0, 0 is the options mask and options override value.

moveToColor < addrMode > < addr > < ep > < colorX > < colorY > < transitTime > < optMask > < optOvrd >

e.g.: moveToColor -s 0x1984 0x23 0xa501 0xca53 10 0 0

Observe change in light color.

This console command sends move to hue and saturation zcl command to remote devices which request the remote device to move from its current color to the color given in the ColorX and ColorY fields.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

colorX: color given in the ColorX across the CIE xyY Color Space, range from 0 to 65279.

colorY: color given in the ColorY across the CIE xyY Color Space, range from 0 to 65279.

transitTime: Unsigned 16-bit time value in tenths of a second which will take for the device to change from its current state to the requested state.

optMask: options mask.

optOvrd: options override.

Here in example command, -s indicate that address mode is short address, 0x1984 is the short address of the remote device, 0x23 is endpoint of the remote device. 0xa501 0xca53 is the xy color. 10 is the transition time. 0, 0 is the options mask and options override value.

moveColor < addrMode > < addr > < ep > < rateX > < rateY > < optMask > < optOvrd >

e.g.: moveColor -s 0xfd3d 0x23 10 12 0 0

Observe change in light color.

This console command sends move color zcl command to remote devices which request the remote device to move its current color in an up or down direction in a continuous fashion.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

rateX: signed 16-bit, rate of movement in steps per second for colorX.

rateY: signed 16-bit, rate of movement in steps per second for colorY.

optMask: options mask.

optOvrd: options override.

stepColor < addrMode > < addr > < ep > < stepX > < stepY > < transitTime > < optMask > < optOvrd >

e.g.: stepColor -s 0xfd3d 0x23 0x1f 0x1f 100 0 0

Observe change in light color.

This console command sends step Color zcl command which request the remote devices to move from its current color by the color step indicated.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

stepX: signed 16-bit, specify the change to be added to the device's CurrentX attribute.

stepY: signed 16-bit, specify the change to be added to the device's CurrentY attribute.

transitTime: Unsigned 16-bit time value which will take for the device to change from its current state to the requested state.

optMask: options mask.

optOvrd: options override.

moveToColorTemperature < addrMode > < addr > < ep > < colorTemp > < transitTime > < optMask > < optOvrd >

e.g.: moveToColorTemperature -s 0xfd3d 0x23 0x1fff 10 0 0

Observe change in light color.

This console command sends move to color temperature zcl command which request the remote devices to move from its current color to the color given by the Color Temperature.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

colorTemp: unsigned 16-bit color temperature value ranges from range 1 to 65279

transitTime: Unsigned 16-bit time value which will take for the device to change from its current saturation to the requested saturation (1/10ths of a second).

enhancedMoveToHue < addrMode > < addr > < ep > < enhancedHue > < direction > < transitTime > < optMask > < optOvrd >

e.g.: enhancedMoveToHue -s 0xbc3c 0x23 0x7f00 1 500 0 0

Observe change in light color.

This console command sends move to enhanced move to hue zcl command which requests light to be moved in a smooth continuous transition from their current hue to a target hue.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

enhancedHue: unsigned 16-bit value represents non-equidistant steps along the CIE 1931 color triangle, ranges (0x0000 to 0xffff)

direction: direction of the hue movement.

Direction

Description

0x00

Shortest Distance

0x01

Longest Distance

0x02

Up

0x03

Down

transitTime: Unsigned 16-bit time value which will take for the device to change from its current hue to the requested hue (1/10ths of a second).

optMask: options mask.

optOvrd: options override.

enhancedMoveHue < addrMode > < addr > < ep > < moveMode > < rate > < optMask > < optOvrd >

e.g.: enhancedMoveHue -s 0x7db6 0x23 1 5 0 0

Observe change in light color.

This console command sends enhanced move hue zcl command to remote devices which request the light to move from its current enhanced hue in an up or down direction in a continuous fashion.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

moveMode: up or down direction of hue attribute.

Move Mode

Description

0x00

Stop

0x01

Up

0x02

Reserved

0x03

Down

rate: unsigned 16-bit, rate of movement of hue in steps per second.

optMask: options mask.

optOvrd: options override.

enhancedStepHue < addrMode > < addr > < ep > < stepMode > < stepSize > < transitTime > < optMask > < optOvrd >

e.g.: enhancedStepHue -s 0xbc3c 0x23 0 0x1f 10 0 0

Observe change in light color.

This console command sends enhanced step Hue zcl command which request the remote devices to move from its current enhanced hue in an up or down direction (mode) in stepSize. Each step command will increment / decrement hue of the light device till reaches the maximum / minimum enhanced hue value allowed for the device.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

stepMode: move up or down.

0x01 – Up.

0x03 – Down

stepSize: unsigned 16-bit value. stepsize is a change in the enhanced current Hue by step size value.

transitTime: Unsigned 16-bit time value in tenths of a second which will take for the device to change from its current state to the requested state.

optMask: options mask.

optOvrd: options override.

enhancedMoveToHueAndSaturation < addrMode > < addr > < ep > < enhancedHue > < saturation > < transitTime > < optMask > < optOvrd >

e.g.: enhancedMoveToHueAndSaturation -s 0xbc3c 0x23 0x3fff 0xef 10 0 0

Observe change in light color.

This console command sends enhanced move to hue and saturation zcl command to remote devices which request the remote device to move its enhanced current hue and saturation to the value given in the enhanced Hue and Saturation field.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

enhancedHue: unsigned 16-bit value represents non-equidistant steps along the CIE 1931 color triangle, ranges (0x0000 to 0xffff)

saturation: unsigned 8-bit saturation value of light which ranges from range 0 to 254.

transitTime: Unsigned 16-bit time value which will take for the device to change from its current saturation to the requested saturation (1/10ths of a second).

optMask: options mask.

optOvrd: options override.

colorLoopSet < addrMode > < addr > < ep > < updateFlags > < action > < direction > < time > < startHue > < optMask > < optOvrd >

e.g.: colorLoopSet -s 0xbc3c 0x23 0x0f 0x01 0x01 30 0xefff 0 0

Observe change in light color.

This console command sends color loop set zcl command to remote devices which allows remote light to cycle through its

range of hues.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

updateFlags: unsigned 8-bit value that specifies which color loop attributes to update before the color loop is started.

* Bit 0 – Update Action

* Bit 1 - Update Direction

* Bit 2 - Update Time

* Bit 3 - Update Start Hue

* Bit 4-7 - Reserved

action: unsigned 8-bit value which specifies the action to take for the color loop if the Update Action sub-field of the Update Flags field is set to 1

* 0x00 - De-activate the color loop.

* 0x01 - Activate the color loop from the value in the ColorLoopStartEnhancedHue field.

* 0x02 - Activate the color loop from the value of the EnhancedCurrentHue attribute.

direction: specifies the direction for the color loop if the Update Direction

field of the Update Flags field is set to 1

* 0x00 - Decrement the hue in the color loop.

* 0x01 - Increment the hue in the color loop.

time: unsigned 16-bit value that specifies the number of seconds over which to perform a full color loop if the Update Time field of the Update Flags field is set to 1

startHue: unsigned 16-bit value that specifies the starting hue to use for the color loop if the Update Start Hue field of the Update Flags field is set to 1

optMask: options mask.

optOvrd: options override.

stopMoveStep < addrMode > < addr > < ep > < optMask > < optOvrd >

e.g.: stopMoveStep -s 0xbc3c 0x23 0 0

Observe change in light color get stops.

This console command sends stop move step zcl command to remote devices to terminate any Move to, Move or Step command currently in process.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

optMask: options mask.

optOvrd: options override.

moveColorTemperature < addrMode > < addr > < ep > < moveMode > < rate > < colorTempMin > < colorTempMax > < optMask > < optOvrd >

eg: moveColorTemperature -s 0xbc3c 0x23 0x01 60 0x000f 0xfe00 0 0

Observe change in light color

This console command sends stop move step zcl command to remote devices which request the remote device to move from its current color temperature in an up or down direction in a continuous fashion.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details. addr: is the short address of the remote device. ep: The endpoint on the remote device. moveMode: up or down direction of hue attribute.

Figure 4-3. 

Move Mode

Description

0x00

Stop

0x01

Up

0x02

Reserved

0x03

Down

rate: unsigned 16-bit value that holds the rate of movement of color temperature in steps per second. colorTempMin: unsigned 16-bit value that specifies the lower bound on the ColorTemperature attribute (range 1 to 65279). colorTempMax: unsigned 16-bit value that specifies the upper bound on the ColorTemperature attribute (range 1 to 65279). optMask: options mask. optOvrd: options override.

stepColorTemperature < addrMode > < addr > < ep > < stepMode > < stepSize > < transitTime > < colorTempMin > < colorTempMax > < optMask > < optOvrd >

e.g: stepColorTemperature -s 0xbc3c 0x23 0x00 0x01ff 10 0x000f 0xfe00 0 0

Observe change in light color.

This console command sends step color temperature zcl command which request the remote devices to move its current color temperature in an up or down direction by one step.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

stepMode: move up or down.

0x01 – Up.

0x03 – Down

stepSize: unsigned 16-bit value that specifies the change to be added / subtracted from the current value of the device’s color temperature.

transitTime: Unsigned 16-bit time value in tenths of a second which will take for the device to change from its current state to the requested state.

colorTempMin: unsigned 16-bit value that specifies the lower bound on the ColorTemperature attribute (range 1 to 65279).

colorTempMax: unsigned 16-bit value that specifies the upper bound on the ColorTemperature attribute (range 1 to 65279).

optMask: options mask.

optOvrd: options override.

enhancedAddScene < addrMode > < addr > < ep > < group > < scene > < trTime > < onOff > < level > < X > < Y > < enHue > < sat > < colorLoopActv > < colorLoopDir > < colorLoopTime > < colorTemp >

This console command sends enhanced add scene zcl command which allow the sending device to request that the light device to add an entry in its Scene Table with the given sceneID and parameter in the payload.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

group: Unsigned 16-bit identifier for a group.

scene: 8-bit unique identifier within group, which is used to identify this scene.

trTime: Unsigned 16-bit time value which will take for the device to change from its current state to the requested state.

onOff: 1-bit onOff value 1 or 0.

level: 8-bit light brightness level (0 - 0xff, where 0xff is max brightness).

X: color given in the ColorX across the CIE xyY Color Space, range from 0 to 65279.

Y: color given in the ColorY across the CIE xyY Color Space, range from 0 to 65279.

enHue: unsigned 16-bit value represents non-equidistant steps along the CIE 1931 color triangle, ranges (0x0000 to 0xffff)

sat: unsigned 8-bit saturation value of light which ranges from range 0 to 254.

colorLoopActv: unsigned 8-bit value which specifies the action to take for the color loop. (refer colorLoopSet command-action parameter)

colorLoopDir: specifies the direction for the color loop

colorTemp: unsigned 16-bit color temperature value ranges from range 1 to 65279

enhancedAddSceneToTH < addrMode > < addr > < ep > < groupId > < sceneId > < transitionTime > < occupiedCoolingSetpoint > < occupiedHeatingSetpoint > < systemMode >

This console command sends Enhanced Add Scene zcl command to Thermostat device to add an entry in its Scene Table with the given sceneID and parameter in the payload.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

groupId: Unsigned 16-bit identifier for a group.

sceneId: 8-bit unique identifier within group, which is used to identify this scene.

transitionTime: Unsigned 16-bit time value which will take for the device to change from its current state to the requested state.

occupiedCoolingSetpoint: signed 16-bit, Occupied Cooling Setpoint Attribute specifies the cooling mode setpoint when the room is occupied.

occupiedHeatingSetpoint: signed 16-bit, occupied Heating Setpoint Attribute specifies the heating mode setpoint when the room is occupied.

systemMode: (Unsigned 8-bit) System Mode attribute specifies the current operating mode of the thermostat.

copyScene < addrMode > < addr > < ep > < mode > < groupFrom > < sceneFrom > < groupTo > < sceneTo >

e.g.: copyScene -s 0xbc3c 0x23 0x1234 0x10 0xabcd 0xa1

Copy scene response: status = 0x00

This console command sends copy scene zcl command to a remote device and request it to copy scenes from one group/scene identifier pair to

another group/scene identifier pair.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

mode: specify how the scene copy is to proceed.

1 - all scenes are to be copied.

0 – otherwise.

groupFrom: Unsigned 16-bit value which specifies the identifier of the group from which the scene is to be copied.

sceneFrom: Unsigned 8-bits value which specifies the identifier of the scene from which the scene is to be copied.

groupTo: Unsigned 16-bit value which specifies the identifier of the group to which the scene is to be copied.

sceneTo: Unsigned 8-bits value which specifies the identifier of the scene to which the scene is to be copied.

enhancedViewScene < addrMode > < addr > < ep > < groupId > < sceneId >

e.g.: enhancedViewScene -s 0xbc3c 0x23 0x1234 0x10

Enhanced view scene response: status = 0x00

groupId = 0x1234

sceneId = 0x10

transitionTime = 0x0258

This console command sends enhanced view scene zcl command to remote device. On receipt of this command, the remote device checks for the entry in scene table for specified sceneID and responds the scene information.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

groupId: Unsigned 16-bit identifier for a group.

sceneId: unsigned 8-bit unique identifier within group.

sendEndpointInfo < shortAddr > < ep >

e.g.: sendEndpointInfo 0xbc3c 0x23

This console command sends endpoint information zcl command. The endpoint information command is used to inform the remote endpoint about the general information of the local endpoint.

shortAddr: is the short address of the remote device.

ep: The endpoint on the remote device.

getGroupIdentifiers < shortAddr > < ep > < startIndex >

e.g.: getGroupIdentifiers 0xbc3c 0x23 0

getGroupIdentifiersResponseInd()

total=1, startIndex=0, count=1

group id=0x1234, type=0x00

This console command sends Get Group Identifiers zcl command. The get group identifiers request command is used to retrieve the actual group identifiers that the endpoint is using in its multicast communication in controlling different (remote) devices.

shortAddr: is the short address of the remote device.

ep: The endpoint on the remote device.

startIndex is the starting Index for the requested elements of the Group Table.

getEndpointList < shortAddr > < ep > < startIndex >

e.g.: getEndpointList 0xbc3c 0x23 0

getEndpointListResponseInd()

total=1, startIndex=0, count=1

endpoint networkAddress=0xbc3c, endpointId=0x23, profileId=0x0104, deviceId=0x010d, version=0x01

This console command sends Get endpoint list zcl command. The get endpoint list request command is used to retrieve addressing information for each endpoint the device is using in its unicast communication in controlling different (remote) devices.

shortAddr: is the short address of the remote device.

ep: The endpoint on the remote device.

startIndex is the starting Index for the requested elements.

setTimeStatus < master > < synchronized > < masterZoneDst > < superseding >

e.g.: setTimeStatus 1 1 1 0

This console command set the time status of this device.

master: This parameter set the master bit of the TimeStatus attribute. The Master bit specifies whether the real time clock corresponding to the Time attribute is internally set to the time standard.

1 – master clock

0 – not master clock

synchronized: This parameter set the synchronized bit of the TimeStatus attribute. The Synchronized bit specifies whether Time has been set over the ZigBee network to synchronize it to the time standard.

1 – synchronized

0 – not synchronized

masterZoneDst: This parameter set the masterZoneDst bit of the TimeStatus attribute. The MasterZoneDst bit specifies whether the TimeZone, DstStart, DstEnd and DstShift attributes are set internally to correct values for the location of the clock.

1 – master for Time Zone and DST

0 – not master for Time Zone and DST

superseding: This parameter set the Superseding bit of the TimeStatus attribute.

1 – time synchronization should be superseded.

0 - time synchronization should not be superseded.

IasAceGetPanelStatusChangedCommand < addrMode > < addr > < ep > < panel_status > < seconds_remaining > < audible_noti > < alarmstatus >

This command updates ACE clients in the system of changes to panel status recorded by the ACE server.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

panel_status: 8-bit enum as described in below table

Panel Status Enum

Description

0x00

Panel disarmed(all zones disarmed) and ready to arm

0x01

Armed Stay

0x02

Armed night

0x03

Armed Away

0x04

Exit Delay

0x05

Entry delay

0x06

Not ready to arm

0x07

In Alarm

0x08

Arming Stay

0x09

Arming Night

0x0a

Arming away

seconds_remaining: Indicates the number of seconds remaining for the server to be in the state indicated in the Panel Status

parameter.

audible_noti: Provide the ACE client with information on which type of audible notification it should make for the zone

status change.

Audible Notification

Description

0x00

Mute

0x01

Default Sound

0x80-0xff

Manufacturer specific

alarmstatus: 8-bit enum that provides the ACE client with information on the type of alarm the panel.

Alarm Status

Description

0x00

No Alarm

0x01

Burglar

0x02

fire

0x03

Emergency

0x04

Police Panic

0x05

Fire Panic

0x06

Emergency Panic (i.e, medical issue)

IasAceZoneStatusChangedCommand < addrMode > < addr > < ep > < zoneId > < zone_status > < audible > < zone_label >

This command updates ACE clients in the system of changes to zone status recorded by the ACE server.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

zoneId: unsigned 8-bit parameter which is used to store information for each Zone enrolled by the CIE

zone_status: unsigned 8-bitvparameter which hold the current value of the ZoneStatus attribute.

audible: Provide the ACE client with information on which type of audible notification it should make for the zone status change.

Audible Notification

Description

0x00

Mute

0x01

Default Sound

0x80-0xff

Manufacturer specific

zone_label: string parameter which provides the Zone Label stored in the IAS CIE.
ZoneInitiateNormalOperatingModeCommand<a name="_"ZoneInitiateNormalOperatingModeCommand > < addrMode > < addr > < ep >

This console command sends initiate Normal Operating mode at the Ace device.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

ZoneInitiateTestModeCommand<a name="_"ZoneInitiateTestModeCommand> < addrMode > < addr > < ep > < Test_Mode_Duration > < Current_Zone_Sensitivity Level >

Sends to initiate Test operating Mode at the Ace device with its dutaion for the same with its current zone sensitivity level.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

Test_Mode_Duration: Specifies the duration, in seconds, for which the IAS Zone server will operate in its test mode.

Current_Zone_Sensitivity_Level: Specifies the sensitivity level the IAS Zone server will use for the duration of the Test Mode and with which it must update its CurrentZoneSensitivityLevel attribute.

setPointChange < addrMode > < addr > < ep > < setpointmode > < amount > Sends thermostat Set Point Change Command along with the mode and amount
resetAlarm < addrMode > < addr > < ep > < alarmId > < clusterID >

This console command sends reset alarm zcl command to a remote device and request to resets a specific alarm. This is needed for some alarms that do not reset automatically.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

alarmId: specfies the alarm condition when alarm is generated.

Alarm ID

Description

0

Supply voltage too low

1

Supply voltage too high

2

Power missing phase

3

System Pressure too low

4

System Pressure too high

5

Dry running

6

Motor temperature too high

7

Pump motor has fatal failure

8

Electronic temperature too high

9

Pump blocked

10

Sensor failure

11

Electronic non fatal failure

12

Elctronic fatal failure

13

General fault

clusterID: is the cluster on the source device that is bound to the destination.
resetAllAlarms < addrMode > < addr > < ep >

This console command sends reset all alarm zcl command to a remote device and request to resets a all alarm.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

resetAlarmLog < addrMode > < addr > < ep >

This console command sends reset alarm log zcl command to a remote device and request it to clear the alarm table.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

getAlarm < addrMode > < addr > < ep >

This console command sends reset alarm log zcl command to a remote device and request it to clear the alarm table.

addrMode: specifies the format of DstAddr. Refer Address Mode table for more details.

addr: is the short address of the remote device.

ep: The endpoint on the remote device.

onOffQ

e.g.: onOffQ

0

The console command shows the current on/off status of light

currentLevelQ

e.g.: currentLevelQ

127

The console command shows the current level of light

Important Notes

Parameters: The command parameters has the dependency on ZCL specification, like intended cluster ID, attribute ID. the following few examples illustrate , how the user can get these dependent parameter details from MCC configurator or from header file or through some other commands. By typing any command, it displays the details on what parameters it expects. The parameters values can be sent as hex value with 0x prefixed or as decimal values without any prefix.
  • [addrMode] -> Address mode
    Table 4-8. Address Mode table

    Allowed Values

    Description

    -g

    Group address. The group ID which was used while commissioning.command ref

    -e

    Extended/MAC address.command ref

    -b

    No address

    -sor Any other values

    Network Short address.command ref
  • [ep] -> Each device will have application end point. This value can be taken from MCC configurator.

  • [clusterId] -> Each device type supports number of mandatory and optional clusters as per zigbee device specification. The intended cluster ID can be taken from MCC configurator.

  • [attrId] -> Each cluster supports number of mandatory and optional attributes as per zigbee device specification. The intended attribute ID can be taken from MCC configurator.

  • [type][attrSize] -> Attribute type and size is ZCL spec defined and is little tricky part. This has to be get from the specific cluster include file from code.
Examples
  • Read the attribute of on/off cluster and on/off attribute using network address mode from CI. From the above screen shots for different parameters for destination device (on/off light device)

    Command: readAttribute
    ->Read Attribute for specified cluster: readAttribute [addrMode][addr][ep][clusterId][attrId]
    example
    readAttribute 0x0 0xfe38 0x20 0x0006 0x0000
    <-Read attribute (AttrId:0x0) response: success, Attr value = 0
  • OnOff command
    Command: onOff
    Sends On/Off command: onOff [addrMode][addr][ep][onOff: -on for On, -off for Off]
    example
    onOff 0x0 0xfe38 0x20 -on
Table 4-9. Application Device Type Responses

Device ID

Device ID Type

Description

0x0006

HA_REMOTE_CONTROL_DEVICE_ID

Remote Control device

0x0007

HA_COMBINED_INTERFACE_ID

Combined Interface

0x0100

HA_ON_OFF_LIGHT_DEVICE_ID

Home Automation On/Off Light

0x0101

HA_DIMMABLE_LIGHT_DEVICE_ID

Home Automation Dimmable Light

0x0103

HA_ON_OFF_LIGHT_SWITCH_DEVICE_ID

Home Automation On/Off Light Switch

0x0104

HA_DIMMER_SWITCH_DEVICE_ID

Home Automation Dimmer Switch

0x0106

HA_LIGHT_SENSOR_DEVICE_ID

Home Automation Light Sensor

0x0107

HA_OCCUPANCY_SENSOR_DEVICE_ID

Home Automation Occupancy Sensor

0x0301

HA_THERMOSTAT_DEVICE_ID

Home Automation Thermostat device

0x0302

HA_TEMPERATURE_SENSOR_DEVICE_ID

Home Automation Temperature Sensor

0x0400

HA_IAS_CIE_DEVICE_ID

Home Automation IAS Control and Indicating Equipment

0x0401

HA_IAS_ACE_DEVICE_ID

Home Automation IAS Ancillary Control Equipment

0x0402

HA_IAS_ZONE_DEVICE_ID

Home Automation IAS Zone

0x0403

HA_IAS_WD_DEVICE_ID

Home Automation IAS Warning Device

0x0100

ZLO_ON_OFF_LIGHT_DEVICE_ID

ZLO (ZigBee Lighting & Occupancy)On/Off Light

0x0101

ZLO_DIMMABLE_LIGHT_DEVICE_ID

ZLO Dimmable Light

0x0102

ZLO_COLOR_DIMMABLE_LIGHT_DEVICE_ID

ZLO Color Dimmable Light

0x0103

ZLO_ON_OFF_LIGHT_SWITCH_DEVICE_ID

ZLO On/Off Light Switch

0x0104

ZLO_DIMMER_SWITCH_DEVICE_ID

ZLO Dimmer Switch

0x0105

ZLO_COLOR_DIMMER_SWITCH_DEVICE_ID

ZLO Color Dimmer Switch

0x0106

ZLO_LIGHT_SENSOR_DEVICE_ID

ZLO Light Sensor

0x0107

ZLO_OCCUPANCY_SENSOR_DEVICE_ID

ZLO Occupancy Sensor

0x0108

ZLO_ON_OFF_BALLAST_DEVICE_ID

ZLO On/Off Ballast

0x0109

ZLO_DIMMABLE_BALLAST_DEVICE_ID

ZLO Dimmable Ballast

0x010A

ZLO_ON_OFF_PLUG_IN_UNIT_DEVICE_ID

ZLO On/off Plug-in unit

0x010B

ZLO_DIMMABLE_PLUG_IN_UNIT_DEVICE_ID

ZLO Dimmable Plug-in unit

0x010C

ZLO_COLOR_TEMPERATURE_LIGHT_DEVICE_ID

ZLO Color Temperature light

0x010D

ZLO_EXTENDED_COLOR_LIGHT_DEVICE_ID

ZLO Extended Color light

0x010E

ZLO_LIGHT_LEVEL_SENSOR_DEVICE_ID

ZLO Light level Sensor

0x0800

ZLO_COLOR_CONTROLLER_DEVICE_ID

ZLO Color Controller

0x0810

ZLO_COLOR_SCENE_CONTROLLER_DEVICE_ID

ZLO Color Scene Controller

0x0820

ZLO_NON_COLOR_CONTROLLER_DEVICE_ID

ZLO Non Color Controller

0x0830

ZLO_NON_COLOR_SCENE_CONTROLLER_DEVICE_ID

ZLO Non-color scene remote

0x0840

ZLO_CONTROL_BRIDGE_DEVICE_ID

ZLO Control bridge

0x0850

ZLO_ON_OFF_SENSOR_DEVICE_ID

ZLO On/off Sensor

0x0401

ZLO_IAS_ACE_DEVICE_ID

ZLO On/off Sensor

0x0F00

ZLO_CUSTOM_DEVICE_ID

ZLO custom device

0x0060

GP_PROXY_DEVICE_ID

Green Power Advanced proxy

0x0061

GP_PROXY_BASIC_DEVICE_ID

Green Power Proxy basic

0x0062

GP_TARGET_PLUS_DEVICE_ID

Green Power Sink

0x0063

GP_TARGET_DEVICE_ID

Green Power Sink Basic

0x0064

GP_COMMISSIONING_TOOL_DEVICE_ID

Green Power Commissioning tool

0x0065

GP_COMBO_DEVICE_ID

Green Power Combo(sink & proxy)

0x0066

GP_COMBO_BASIC_DEVICE_ID

Green Power Combo basic

Table 4-10. Zigbee Device Type

Device ID

Device ID Type

Description

0x02

TEST_DEVICE_TYPE_ZIGBEE_COORDINATOR

Zigbee Coordinator

0x03

TEST_DEVICE_TYPE_ZIGBEE_ROUTER

Zigbee Router

0x04

TEST_DEVICE_TYPE_ZIGBEE_END_DEVICE

Zigbee End Device

0x07

TEST_DEVICE_TYPE_ZGP_TH

Combo basic Device with certification support

0x08

TEST_DEVICE_TYPE_ZGP_COMBO_BASIC

Combo basic Device