Telegesis ETRX357 CI evaluation kit, Combined Interface, Five-In-One Device User Guide
Below you will find brief information for evaluation kit ETRX357 CI. This document provides a detailed guide on how to use the Telegesis Terminal for the combined interface and Five-In-One device firmware. The user guide introduces the pre-configured panels for both the CI and Five-In-One device and provides various application examples to help you understand how to use the terminal and the CI supported AT command sets.
advertisement
Telegesis
ETRX357 HA CI EVALUATION KITS
TG-UG-0501 ETRX3CIEVK
User Guide 0501r1
User Guide
Using Telegesis Terminal with HA Combined
Interface and Five-In-One Device Firmware
Combined Interface firmware version r300
Five-In-One Device firmware version r300
©2013 Telegesis (UK) Ltd ETRX357 CI EVK
Telegesis (UK) Limited
ETRX357 CI EVK
User Guide
Document No.
1
501
Table of Contents
1
Telegesis (UK) Limited
ETRX357 CI EVK
User Guide
Document No.
2
501
1. Introduction
Telegesis have launched the Home Automation 1.1 compliant ZigBee AT Command layer on the EM357 Ember platform. The ZigBee HA AT commands allow developers to build a ZigBee HA compliant Combined Interface without the need for any in-depth knowledge of the ZigBee PRO stack. To assist the user in working with the
Combined Interface (CI) AT command set, a Five-In-One device has been developed, which can be used with the CI for evaluating Telegesis HA implementations. The Five-In-One device includes five endpoints which can behave as an on/off output, level controllable output, light sensor, temperature sensor and on/off switch. More information about Five-in-One device can be found in the Five-In-One device AT Command set manual (TG-PM-
0506-FiveInOneDev-AT-Command-Manual).
Although a description of the supported AT command set has been included in the CI and Five-In-One device manuals (TG-PM-0505-CI-AT-Command-Manual and TG-PM-0506-FiveInOneDev-AT-Command-Manual), and the AT command set can work with a serial port communication tool (such as HyperTerminal), Telegesis
Terminal is recommended as an easy way to start practising with the Home Automation application. A preconfigured panel is provided as shown in Figure 1-1, which contains multiple buttons. It can be observed that each button has a specific name on it, for example Info, Bootloader, Help and so on. The user can easily click one of the buttons to issue an AT command.
Figure 1-1 Telegesis Terminal for CI and Five-In-One (5IN1) Device
This document provides a user guide to use this version of Telegesis Terminal. Following sections will introduce the preconfigured panels for both CI and Five-In-One Device, then give several examples of using the Telegesis
Terminal to implement applications, for example network form and join, publish price and so on.
2
Telegesis (UK) Limited
ETRX357 CI EVK
User Guide
Document No.
3
501
2. Telegesis Terminal Panel
This section introduces the pre-configured Telegesis Terminal panels of both CI and Five-In-One Device.
2.1 Combined Interface Panel
The CI panel can be used to control the CI module and issue commands as well as display local information or responses from the Five-In-One device. Figure 2-1 shows the buttons. It can be observed that the buttons are categorized into five groups: Module control, Network Management, ZDO, Binding, and Combined Interface. The function of the buttons will be introduced in a later section.
Figure 2-1 Button layout of the CI panel
3
Telegesis (UK) Limited
ETRX357 CI EVK
2.2 Five-In-One Device Panel
User Guide
Document No.
4
501
The Five-in-One device supports five endpoints (EP) (on/off output, level controllable output, light sensor, temperature sensor and on/off switch). It supports multiple HA server clusters. More information can be found in the Five-In-One At command set manual.
The Five-In-One Device panel, as shown in Figure 2-2, can be used to control the Five-In-One module and issue commands as well as display local information or response from other device (such as the CI). The panel contains buttons which are categorized into five groups: Module Control, 5 in 1 device commands, Network
Management, Binding and ZDO. The function of the buttons will be introduced in a later section.
Figure 2-2 Button layout of the CI panel
4
Telegesis (UK) Limited
ETRX357 CI EVK
2.3 Function of the Buttons
User Guide
Document No.
5
501
The following table maps the buttons with their linked AT commands and a brief description is also given. More information about a specific command and its prompt has been included in the CI or Five-In-One Device manual.
Button Name Linked AT Command Description
Info
Z-Reset
Module Control-R3xx (includes the buttons on both Five-In-One Device and CI panels)
ATI Display Product Identification Information
ATZ Software Reset (this will not change the previous Sregister settings such as link key and so on)
Factory Default
Bootloader
AT&F
AT+BLOAD
Restore Factory Defaults (Clear all S-Register setting)
Enter The Bootloader Menu (will used to update firmware )
S-Register
Display All S
ATS
AT+TOKDUMP
Get Illuminance (CI) AT+READATR
Get Temperature (CI) AT+READATR
Read/Write S-Register
Display All S-Register Settings
Read Illuminance Reading From Light Sensor
Read Temperature Reading From Temperature Sensor
MTO Start (CI)
MTO Stop (CI)
Local OnOff
Help
Form A NWK(CI)
Energy Scan
Scan for Pan
Join a Spec PAN
Join any PAN
Disas Remote
AT+MTOSTART
AT+MTOSTOP
AT+LONOFF
AT+HELP
AT+EN
AT+ESCAN
AT+PANSCAN
Network Management
Establish a Personal Area Network
Scan the background energy of all channels
Scan for active PANs
AT+JPAN
AT+JN
AT+DASSR
Start Many-to-One Function
Stop Many-to-One Function
Toggle Local LED for OnOff output server
Display All Available Commands
Join specific PAN
Join an open network with matched preconfigured link key
Disassociate Remote Node from PAN
5
Telegesis (UK) Limited
ETRX357 CI EVK
Address Table
Add addr entry
Disas Local
NWK Info
PJOIN
AT+ATABLE
AT+ASET
AT+DASSL
AT+N
AT+PJOIN
ID Request
EUI request
Node Descriptor
Power Des
ACT EP
Simple Des
Match Des
ANNCE
AT+IDREQ
AT+EUIREQ
AT+NODEDESC
AT+POWERDESC
AT+ACTEPDESC
AT+SIMPLEDESC
AT+MATCHREQ
AT+ANNCE
Local BTable
BSET
Remote BTable
DEI BTable
Bind to Remote
AT+LBTABLE
AT+BSET
AT+BTABLE
AT+BCLR
AT+BIND
Del Remote B
BindLight
UnbindLight
AT+UNBIND
AT+BINDLIGHT
AT+UNBINDLIGHT
End Device Bind AT+EBIND
Clear Binding(5in1) AT+CLEARBIND
User Guide
Document No.
Display Address Table
Add Address Entry in Local Address Table
Disassociate Local Node from PAN
Display Network Information
Switch on “Permit Joining” Flag
ZDO
Request n ode’s NodeID
Request node’s EUI
Request node’s descriptor
Request node’s power descriptor
Request node’s active endpoint list
Request endpoint’s simple descriptor
Find nodes which match a specific descriptor
Announce local device in the network
Binding
Display local binding table
Set local binding table entry
Display remote binding table
Clear local binding table entry
Create binding on remote device
Delete binding on remote device
Bind the on/off switch to a on/off output server
Unbind the on/off switch to a on/off output server
End Device Bind Command
Clear Local Binding Table
6
6
501
Telegesis (UK) Limited
ETRX357 CI EVK
Discover Device
Find Cluster(s)
Discover Attrs
Read Attribute
Write Attribute
Get Attribute (CI)
Set Attribute (CI)
Remote OnOff
Identify Remote
Identify Query
Add Group
View Group
Get Group MS
Remove Group
Remove All GP
Thermostat set
Add Scene
View Scene
Remove Scene
Remove All SC
Store Scene
Recall Scene
Get SC Member
User Guide
Document No.
7
501
AT+DISCOVER
Combined Interface Functions
Discover HA device on the HAN
AT+CLUSDISC
AT+ATTRDISC
AT+READATR
AT+WRITEATR
Discover all supported clusters on a remote device
Discover supported attributes on a remote device
Gets an attribute from a remote device which supports a specified cluster
Writes an attribute to a remote device which supports a specified cluster
AT+GETATR
AT+SETATR
AT+RONOFF
AT+IDENTIFY
Get value of a local ZCL attribute
Set value of a local ZCL attribute
Send a On/Off/Toggle command to target
Identify a remote endpoint
AT+IDQUERY
AT+GPADD
AT+GPVIEW
AT+GPGET
AT+GPRMV
AT+GPRMALL
Query a remote endpoint to check identify status
Add Group On Target Device
View Group Information Of Target Devices
Get Group Membership Information From Target Devices
Remove A Group Membership On Target Device
Remove All Group Associations On Target Device
AT+TSTATSET
AT+SCADD
AT+SCVIEW
AT+SCRMV
AT+SCRMALL
AT+SCSTORE
AT+SCRECAL
AT+SCGETMSH
Thermostat Set
Add Scenes
View Scenes
Remove Scenes
Remove All Scenes
Store Scenes
Recall Scenes
Get Membership
7
Telegesis (UK) Limited
ETRX357 CI EVK
Move to Level
LC Move
LC Step
LC Stop
Move to Color
Move Color
Step Color
Move to Hue
Move Hue
Step Hue
Move to Sat
Move Sat
Step Sat
Move to HS
Move ColorTemo
Door Lock
Set Attribute
Get Attribute
Discover Device
Find Cluster
Discover Attrs
Remote OnOff
Identify Remote
Identify Query
User Guide
Document No.
8
501
AT+LCMVTOLEV
AT+LCMV
AT+LCSTEP
AT+LCSTOP
AT+CCMVTOCOL
AT+CCMVCOL
AT+CCSTEPCOL
AT+CCMVTOHUE
AT+CCMVHUE
AT+CCSTEPHUE
AT+CCMVTOSAT
AT+CCMVSAT
AT+CCSTEPSAT
AT+CCMVTOHUS
AT+CCMVTOCT
Level Control Move to Level Command
Level Control Move Command
Level Control Step Command
Level Control Stop Command
Colour Control Move to Colour Command
Colour Control Move Colour Command
Colour Control Step Colour Command
Colour Control Move to Hue Command
Colour Control Move Hue Command
Colour Control Step Hue Command
Colour Control Move to Saturation Command
Colour Control Move Saturation Command
Colour Control Step Hue Command
Colour Control Move To Hue and Saturation Command
Colour Control Move to Colour Temperature Command
AT+DRLOCK Lock/Unlock Door
Five-In-One Devices Functions
AT+SETATR
AT+GETATR
Set value of a local ZCL attribute
Get value of a local ZCL attribute
AT+DISCOVER
AT+CLUSDISC
AT+ATTRDISC
AT+RONOFF
AT+IDENTIFY
AT+IDQUERY
Discover HA device on the HAN
Discover all supported clusters on a remote device
Discover supported attributes on a remote device
Send a On/Off/Toggle command to target
Identify a remote endpoint
Query a remote endpoint to check identify status
8
Telegesis (UK) Limited
ETRX357 CI EVK
Read Attribute AT+READATR
Write Attribute AT+WRITEATR
User Guide
Document No.
9
501
Gets an attribute from a remote device which supports a specified cluster
Writes an attribute to a remote device which supports a specified cluster
9
Telegesis (UK) Limited
ETRX357 CI EVK
User Guide
Document No.
10
501
3. Application Examples
This section gives several examples of utilizing Telegesis Terminal to test some HA applications upon the CI and
Five-In-One device. These applications are simple. The user can practice them to gain further understanding of the CI supported AT command sets before working on their own CI device or any device type supported by Five-
In-One device.
3.1 Network formation
In a HA network, the combined interface can be a coordinator, it supports the function of forming a HA network and permitting other nodes to join. Also it can be a router and join an existing HA network. In this document, the
Combined Interface is assumed to be a coordinator and the Five-In-One device acts as a router
The objective of this test is to test that the CI can form a HA network and the Five-In-One device can join the formed network with HA security settings.
3.1.1
Initial Condition
Set up the CI and the Five-In-One device (e.g. plug each into a PC)
Run Telegesis Terminal; choose the serial ports for both the CI and the Five-In-One device
3.1.2
Implementation Procedure
Item
1.
Test Step
Click the buttons in the CI panel:
Note
This is to forming a HA network.
Because the parameter has been configured as following: channel: 11, power:3, PANID 1456.
JPAN:11,1456,<EPID> prompt should be observed in
CI’s terminal, which means a HA network has been formed successfully.
The user can also input AT+EN with specific parameters in the Telegesis Terminal command line to form a network.
Network formation progress completed.
2. In the terminal for the CI, click Open the network for 60 seconds to permit joining
10
Telegesis (UK) Limited
ETRX357 CI EVK
User Guide
Document No.
3. Click the buttons in the Five-In-One
Device panel:
The Five-In-One device will scan for a HA network which is permitting joining and join it.
JPAN:11,1456,<EPID> prompt should be observed in
Five-In-
One Device’s terminal, which means the Five-
In-One Device network has joined the HA network successfully. In the mean time, it will broadcast a
Device Announcement and the terminal of CI will show prompt:
FFD:
<5in1’s EUI>,<5in1’s NodeID>
Note:
In the initial status, a green LED on the Five-In-One device carrier board is on, which means the Five-In-
One Device is not on any network. When it successfully joins CI, this LED will be off. When the
Five-In-One device leaves the network, the LED will be on again.
If the user is not sure about the number of HA networks in the experiment environment,
One device’s terminal.
button can be used on Five-In-
If there are more than one HA networks are currently permitting joining, the user can use
button and fill in the parameters (channel, PANID and EPANID),
11
501 then click formed).
to join a specific network (CI
4. Click the buttons in the Five-In-One
Device panel:
The Five-In-One Device terminal shows:
LeftPAN which means the Five-In-One Device has left the network.
Join and leave practice complete
11
Telegesis (UK) Limited
ETRX357 CI EVK
User Guide
Document No.
12
501
3.2 Use Identify Command
This test is to ascertain that the CI can send Identify commands to identify the Five-In-One device.
Assumption: The CI forms a HA network. When it turns on Permit Join, several nodes join the network. In such a case, the CI will receive a multiple device announcement and the Identify command can be used to locate an individual node.
The Five-In-One device uses on-board LED2 to indicate Identify status. When it receives an Identify command from the CI, it will blink LED2 for a time period which is specified by CI.
3.2.1
Initial Condition
Set up the CI and the Five-In-One device (e.g. plug each into a PC)
Run Telegesis Terminal; choose the serial ports for both the CI and the Five-In-One device
CI forms a network
Five-In-One device joins the CI’s network
3.2.2
Implementation Procedure
Item Test Step
1. Click the button in CI panel: The command line will show
Note
AT+IDENTIFY:<NodeID>,<EP>,0,0060<Enter Parameter here>
Please input Node ID and Endpoint (e.g.01) of the Five-In-One device and remove “<Enter Parameter here>”. The Node ID can be got from device announcement.
Then click button
The CI will send an Identify command to the Five-In-One device
Endpoint 0x01(on/off output)
2. When the Five-In-One device sends a default response to the CI.
The CI panel display a default response:
DEFTREP:<5in1’s NodeID>,<EP>,<ClusterID>,<CMDID>,<Status>
Note: if the status is not 00, it will be an error code.
In the meantime, LED2 on Five-In-One Device blinks for 60 seconds
3. Click the button in CI panel: The CI will send an Identify Query command to request the remaining identify time from the Five-In-One Device
4. The Five-In-One device sends a response back; the
CI panel will display it.
The CI panel will display an Identify Query response with remaining time.
12
Telegesis (UK) Limited
ETRX357 CI EVK
3.3 Send On/Off/Toggle command
User Guide
Document No.
13
501
The objective of this test is to test that the CI can send On/Off/Toggle command to control LEDs on the Five-In-
One device dev board.
The Five-In-One device uses the carrier board LED (coloured red) to indicate on/off status of on/off the output cluster. It utilizes LED2 (coloured green) on the dev board for level controllable output. Both LEDs can be turned on and off.
3.3.1
Initial Condition
Set up the CI and the Five-In-One device (e.g. plug each into a PC)
Run Telegesis Terminal; choose the serial ports for both the CI and the Five-In-One device
CI forms a network
Five-In-
One device joins the CI’s network
Set on/off attribute of on/off output of Five-In-One device to be in off status (By default, on/off attribute value is
0x00 and the red LED is off)
3.3.2
Implementation Procedure
Item Test Step
1. Click the button in CI panel:
Note
The CI will send a matchdescriptor request to find out the endpoints which support on/off output server (cluster ID: 0x0006)
Then the CI will receive multiple response:
DEV:<NodeID>,<EP>
If the HA network only have CI and Five-In-One device, one response containing two endpoints will be shown in CI’s terminal. Because the
Five-In-one device supports on/off server on its endpoint 0x01 and
0x02.
2. Click the button in CI panel: The command line will show
AT+RONOFF:<NodeID>,<EP>,0<Enter Parameter here>
Please input Node ID and Endpoint (01 or 02) of the Five-In-One device and remove “<Enter Parameter here>”. The node Id can be got from device announcement.
Then click button
The CI will send a Toggle command to the Five-In-One device Endpoint
0x01 or 0x02(on/off output or level controllable output)
An LED on the Five-In-One device will come on. (When ep 0x01 is used the red LED will glow. When ep 0x02 is used the green LED will come
13
Telegesis (UK) Limited
ETRX357 CI EVK
User Guide
Document No.
14
501
3. Repeat step 2 on).
In the meantime, the terminal shows TOGGLE:0000,01, which means the Five-In-One device receives a Toggle command from the CI on/off client whose Node ID is 0x0000, endpoint is 0x01
The LED will be turned off
4. Click the button in CI panel: The command line will show
AT+RONOFF:<NodeID>,<EP>,0<Enter Parameter here>
Please input Node ID and Endpoint (01 or 02) of the Five-In-One device and replace “<Enter Parameter here>” to 1. The Node ID can be got from device announcement. e.g: AT+RONOFF:0123,01,0,1
Then click button
The CI will send an On command to the Five-In-One device Endpoint
0x01 or 0x02(on/off output or level controllable output)
An LED on the Five-In-One device will come on. (When EP 0x01 is used the red LED will glow. When EP 0x02 is used the green LED will come on).
In the meantime, the terminal shows ON:0000,01, which means the
Five-In-One device receives a On command from the CI on/off client whose NodeID is 0x0000, endpoint is 0x01
5. Click the button in CI panel: The command line will show
AT+RONOFF:<NodeID>,<EP>,0<Enter Parameter here>
Please input Node ID and Endpoint (01 or 02) of the Five-In-One device and replace “<Enter Parameter here>” to 0. The node Id can be got from device announcement. e.g: AT+RONOFF:0123,01,0,0
Then click button
The CI will send a Off command to the Five-In-One device Endpoint
0x01 or 0x02(on/off output or level controllable output)
LED on the Five-In-One device will be off. (When EP 0x01 is used the red LED will glow. When EP 0x02 is used the green LED will come on).
14
Telegesis (UK) Limited
ETRX357 CI EVK
User Guide
Document No.
15
501
In the meantime, the terminal shows OFF:0000,01, which means the
Five-In-One device has received an Off command from the CI on/off client whose Node ID is 0x0000, endpoint is 0x01
3.4 Send Level Control command
The objective of this test is to test that the CI can send Level Control commands to control LED1 on the Five-In-
One device dev board.
The Five-In-One device uses the LED1 (bright green colour) on the dev board for level controllable output.
3.4.1
Initial Condition
Set up the CI and the Five-In-One device (e.g. plug each into a PC)
Run Telegesis Terminal; choose the serial ports for both the CI and the Five-In-One device
CI forms a network
Five-In-One device joins the CI’s network
Set current level of level controllable output of Five-In-One device to be 0 (By default, it is 0 and the LED1 is off).
3.4.2
Implementation Procedure
Item Test Step
1. Click the button in CI panel:
Note
The CI will send a matchdescriptor request to find out the endpoints which support on/off output server (cluster ID: 0x0008)
Then the CI will receive a response:
DEV:<NodeID>,<EP>
If the HA network only has CI and Five-In-One devices, one response will be shown in CI’s terminal, as the Five-In-one device supports level controllable server on its endpoint 0x02.
2. Click the button in CI panel: The command line will show
AT+LCMVTOLEV: <NodeID>,02,0,0,12,0066<Enter Parameter here>
Please input Node ID of the Five-In-One device and Endpoint (02) then remove “<Enter Parameter here>”. The Node ID can be obtained from the device announcement.
Then click button
The CI will send a MoveToLevel command to the Five-In-One device
Endpoint 0x02 (level controllable output). This command requests the
Five-In-One device level controllable output to move to level 0x12
LED1 on the Five-In-One device will dim on and stop at level 0x12 (if
15
Telegesis (UK) Limited
ETRX357 CI EVK
User Guide
Document No.
16
501
S64 and S65 keep the default settings, as these two register will affect the MAX and Min level of level controllable output. More information is available in the Five-In-One Device AT command set manual).
In the meantime, the terminal shows:
LCMVTOLV:0000,01,12,0066, which means the Five-In-One device receives a MoveToLevel command from the CI level control client whose NodeID is 0x0000, endpoint is 0x01
3. Repeat step 2 by changing the level parameter to 00
The LED will be turned off.
4. Click the button in CI panel: The command line will show
AT+LCMV: <NodeID>,<EP>,0,0,00,FF<Enter Parameter here>
Please input Node ID and Endpoint (01 or 02) of the Five-In-One device and replace “<Enter Parameter here>” to 1. The Node ID can be obtained from the device announcement.
Then click button
The CI will send a Move command to the Five-In-One device Endpoint
0x02(level controllable output) to request the Five-In-One device to increase level until reaches the Max level FF. (In the progress, the user can use on the CI panel to stop the move)
If there is no Stop command, the LED1 will be fully turned on after the specified transition time.
In the meantime, the terminal shows:
LCMV:0000,01,00,FF which means the Five-In-One device receives a move command from the CI whose NodeID is 0x0000, endpoint is 0x01
16
Telegesis (UK) Limited
ETRX357 CI EVK
User Guide
Document No.
3.5 Read Server Attributes (Illuminance and Temperature)
17
501
The objective of this test is to prove that the CI can send proper Read Attributes Requests to the Five-In-One device and the latter will then send a Read Attribute Response back. In addition, the CI should properly display the information carried by the response.
The Five-In-One device supports the illuminance measurement and temperature measurement server clusters.
These two clusters utilize the light sensor and temperature sensor on the dev board to provide real-time illuminance and temperature measurement. This test can demonstrate how the CI gets real-time sensor readings. Figure 1 shows the location of the two sensors.
Figure 1 Telegesis Dev Board
3.5.1
Initial Condition
Set up the CI and the Five-In-One device (e.g. plug each into a PC)
Run Telegesis Terminal; choose the serial ports for both the CI and the Five-In-One device
CI forms a network
Five-In-One device joins the CI
’s network
3.5.2
Implementation Procedure
Item Test Step
1. Click the button in CI panel: The command line will show
Note
AT+READATR:<NodeID>,03,0,0400,0000<Enter Parameter here>
Please input Node ID of the Five-In-On e device and remove “<Enter
Parameter here>
”
17
Telegesis (UK) Limited
ETRX357 CI EVK
User Guide
Document No.
18
501
Then click button
The CI will send a Read Attribute Request command to the Five-In-One device to request the Illuminance current measured value of illuminance
(Attribute ID: 0000)
2. When the Five-In-One device sends a response, the CI panel will display it.
The CI panel display a response for example:
ILLUMINANCE:1279,03,0000,00,060F
The four parameters are: NodeID, Endpoint, AttributeID, Status,
Attribute Value
Note: if the status is not 00, it will be an error code. In such a case, the
Attribute value will not be displayed.
The value 060F is the current reading of the illuminance sensor on the
Five-In-One Device
3. Cover the illuminance sensor and repeat step 1
Cover the sensor will change current reading
4. When the Five-In-One device sends a response, the CI panel will display it.
The CI panel display a response for example:
ILLUMINANCE:1279,03,0000,00,0000
As expected, the value of the current illuminance reading will have decreased. It becames to 0000, because it was fully shaded in the test.
Test of getting Illuminance reading completed.
5. Click the button in CI panel: The command line will show
AT+READATR:<NodeID>,04,0,0402,0000<Enter Parameter here>
Please input Node ID of the Five-In-One device and remove “<Enter
Parameter here>
”
Then click button
The CI will send a Read Attribute Request command to the Five-In-One device to request the current temperature (Attribute ID: 0000)
6. When the Five-In-One device sends a response, the CI panel will display it.
The CI panel displays a response for example:
TEMPERATURE:1279,04,0000,00,00DB
The four parameters are: NodeID, Endpoint, AttributeID, Status,
Attribute Value (temperature)
18
Telegesis (UK) Limited
ETRX357 CI EVK
User Guide
Document No.
19
501
Note: if the status is not 00, it will be an error code. In such a case, the
Attribute value will not be displayed.
The value 00DB is the current reading of the temperature sensor on the
Five-In-One Device
To convert the value:
00DB is a hexadecimal which is 219 in decimal.
Current temperature = got value(219)/10 = 21.9
0
C
7. Heat the temperature sensor and repeat step 1
This will change current reading
8. When the Five-In-One device sends back a response, the CI panel will display it.
The CI panel display a response for example:
TEMPERATURE:1279,04,0000,00,00E1
Current temperature = got value(225)/10 = 22.5
0
C
As expected, the value of current Temperature reading increased.
Test of getting Temperature reading completed.
In addition, the user can use AT+READATR to read other cluster attributes by using and fill the parameter. Information about AT+READATR command can be found in the Combined Interface AT command set manual.
Please note:
This document only gives some typical examples of the HA applications, which can be built using the CI and
Five-In-One device. The main purpose of this document is to provide a quick start guide for the user to be familiar with Telegesis HA AT Command set. In fact, the CI AT command set has more functions that can be utilized with a properly-selected series of AT commands. For instance, the user can use Add Group command to add group on the on/off output endpoint and level controllable output, then use a on/off command to turn both LEDs on or off. For more information about the AT commands, please check the provided manual.
19
Telegesis (UK) Limited
ETRX357 CI EVK
User Guide
Document No.
20
501
4. Use Physical Buttons on Five-In-One Device Dev Board
The Five-In-One device has six physical buttons on its dev board as shown in Figure 1. Four of the buttons can be used. They are button 1, 2, 3 and reset button. Reset button will trigger a reset. Button 1 is used to join and leave a HA network. Button 2 and 3 should be enabled with specific functions using S63. (Please check Five-In-
One Device manual for details).
4.1.1
Initial Condition
Set up the CI and the Five-In-One device (e.g. plug each into a PC)
Run Telegesis Terminal; choose the serial ports for both the CI and the Five-In-One device
CI forms a HA network and turns permit-join on
The Five-In-One device is not on any network (green LED on carrier board is on)
4.1.2
Implementation Procedure
Item
1. Press Button 1
Test Step Note
The Five-In-
One device will scan for CI’s network and attempt joining.
When it joined the network, the green LED carrier board turns off indicating “On NWK” status
The terminal of CI will show prompt:
FFD:
<5in1’s EUI>,<5in1’s NodeID>
2. Press Button 2 (the S63 is set to 0002 by default, Button 2 is used to turn on/off local on/off output)
The red LED on Five-In-
One device’s carrier board will be turned on.
3. Repeat step 2 The red LED on Five-In-
One device’s carrier board will be turned off.
4. Set S63 to 0000 Use Button as HA on/off switch (use the Five-In-One device’s endpoint 5)
5. Set local binding entry on the Five-In-
One device to bind the its on/off switch with CI’s on/off output (EP:0x0A)
Use and filled the parameter
AT+BSET:1,05,0006,
<CI’s EUI>,0a
P lease use just change the CI’s EUI and press
.
20
Telegesis (UK) Limited
ETRX357 CI EVK
6. Press Button 2
7. Press Button 2 again
8. Set S63 to 0003
9. Press Button 2 three times
10. Press Button 3 three times
User Guide
Document No.
The Five-In-One device will send a Toggle command to CI endpoint 0x0A (on/off output). Red LED on CI
USB will be turned on.
The Five-In-One device will send a Toggle command to CI endpoint 0x0A (on/off output). Red LED on CI
USB will be turned off.
Button 2 will be use to increase local level of level controllable output the Five-in-One device.
Button 3 will be use to decrease local level of level controllable output of the Five-in-One device.
The LED1 will dim on. Current level of level controllable output is increased. (This also can be check by using AT+GETATR:0008,0000 command on the Five-In-One device terminal to check the current level attribute.
The LED1 will dim off. Current level of level controllable output is decreased.
21
501
21
Telegesis (UK) Limited
ETRX357 CI EVK
5. Contact Information
Website:
E-mail: www.telegesis.com
Telegesis (UK) Ltd.
Abbey Barn Business Centre
Abbey Barn Lane
High Wycombe
Bucks
HP10 9QQ
United Kingdom
Tel: +44 (0)1494 510199
Fax: +44 (0) 5603 436999
User Guide
Document No.
22
501
22
advertisement
Key Features
- Network formation
- Identify Command
- On/Off/Toggle Command
- Level Control Command
- Read Server Attributes
- Physical Buttons
