Telegesis ETRX357-LR Command Manual
  1. Manuals
  2. Brands
  3. Telegesis Manuals
  4. Control Unit
  5. ETRX357-LR
  6. Command manual

Telegesis ETRX357-LR Command Manual

Zigbee module at-command dictionary
Hide thumbs Also See for ETRX357-LR:
Table of Contents

Advertisement

Quick Links

Telegesis
ETRX3 series
©2015 Telegesis (UK) Ltd
ETRX3 Series ZigBee Module
AT-Command Dictionary
Firmware R309
EmberZNet 5.4.0 stack
TG-ETRXn-R309-AT-Commands
AT-Command Dictionary 3.09
AT Command Manual July 2015 (Rev 3.09)

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the ETRX357-LR and is the answer not in the manual?

Questions and answers

Related Manuals for Telegesis ETRX357-LR

Summary of Contents for Telegesis ETRX357-LR

  • Page 1 Telegesis TG-ETRXn-R309-AT-Commands AT-Command Dictionary 3.09 ETRX3 series ETRX3 Series ZigBee Module AT-Command Dictionary Firmware R309 EmberZNet 5.4.0 stack ©2015 Telegesis (UK) Ltd AT Command Manual July 2015 (Rev 3.09)

  • Page 2: Table Of Contents

    NOTES ON ENERGY LEVELS AND LQI ............... 116 Interpreting LQI ......................116 Interpreting RSSI Energy Levels .................. 117 TRADEMARKS ....................... 118 DISCLAIMER ........................118 CONTACT INFORMATION ..................... 118 ©2015 Telegesis (UK) Ltd - 2 - AT Command Manual (Rev 3.09)
  • Page 3 APPENDIX A. FORMING A SECURE NETWORK ............119 APPENDIX B. BOOTLOADING NEW FIRMWARE ............120 13.1 Bootloading through the serial port ................120 13.2 Bootloading over the air ....................121 ©2015 Telegesis (UK) Ltd - 3 - AT Command Manual (Rev 3.09)

  • Page 4: Introduction

    - ETRX3USB - ZigBee Communications Gateway The Telegesis ZigBee modules have been designed to be built into any device and provide a low cost, low power ZigBee solution based on the industry leading EmberZNet ZigBee stack. Integration into a wide range of applications is made easy using a simple AT-style software interface and advanced hardware design.

  • Page 5: Network Topology

    ® 1.7 A Note on ZigBee Compliance The Telegesis R300 firmware has been tested and certified for MSP (manufacturer specific profile) compliance by a test house appointed by the ZigBee Alliance. ©2015 Telegesis (UK) Ltd - 5 -...

  • Page 6: Important Notes

    (i) Be at least an adopting member of the ZigBee Alliance in the year you release your product (ii) Implement a public application profile If you intend to get your product certified feel free to contact Telegesis for additional information. Also if you intend to build a product compliant to a public application profile (e.g. Home Automation, Smart Energy) feel free to contact us to discuss your options.

  • Page 7: At Style Command Conventions

    When bit 7 of S12 is set each individual reply or prompt is additionally started with the STX and ended with the ETX character to aid the interpretation of the incoming strings on a host processor. ©2015 Telegesis (UK) Ltd - 7 -...

  • Page 8: Parameters

    32-bit hexadecimal number representing the reading of S1A <data> Custom Data <ClusterList> A list of 16 bit cluster identifiers in hexadecimal representation <FirmwareRevision> The Firmware Revision Number Table 2: Different formats of parameters ©2015 Telegesis (UK) Ltd - 8 - AT Command Manual (Rev 3.09)

  • Page 9: Prompt Overview

    RAW:snn,<data> A raw message has been received with strength snn dBm SDATA:[<EUI64>,],<ioread>,<ADC0>, A data message has been received at the sink. <ADC1>,<sequenceNo>,<Vcc> ADC data is ADC0 & ADC1 ©2015 Telegesis (UK) Ltd - 9 - AT Command Manual (Rev 3.09)
  • Page 10 More than 16 energy scan reports have been recently received by the network manager indicating high packet loss ENTERING BLOAD Passthrough bootloading has been initiated from another node Table 3: Prompt Overview ©2015 Telegesis (UK) Ltd - 10 - AT Command Manual (Rev 3.09)

  • Page 11: Device Overview

    2.3.2 Non-ZigBee types Sink. The sink is a Telegesis feature. When a node is defined as a sink by setting S10 bit 4, it can broadcast its address to the rest of the network. Other nodes can then send messages to the sink node using AT+SCAST or various built-in functions.
  • Page 12 Address table entry. Range 00-06. Entry 05 is a sink address, entry 06 is the source address of the last received UCAST, SCAST or MCAST that arrived at endpoint 1 with profile C091 and cluster 0002 (ie the default Telegesis parameters). Binding table entry. Range 10-24 (hexadecimal). Entry FE causes a search of the table for the first entry whose source endpoint and cluster ID matches registers S40 and S42.

  • Page 13: At Command Overview

    AT+SN Scan Network AT+KEYUPD Update the Network Key (ZDO) AT+BECOMETC Make Local Device the Trust Centre AT+BECOMENM Make the local device Network Manager Change the network’s channel AT+CCHANGE ©2015 Telegesis (UK) Ltd - 13 - AT Command Manual (Rev 3.09)
  • Page 14 Request End Device Binding (ZDO) Time-related commands AT+SETTIME Set the Local Time AT+GETTIME Get the Local Time AT+SYNCTIME Synchronize the Local Time with Time Server Table 5: Command Overview ©2015 Telegesis (UK) Ltd - 14 - AT Command Manual (Rev 3.09)

  • Page 15: Module Control & Configuration Commands

    Module Performs a software reset All non-volatile S Registers keep the user defined values, if the module was part of a PAN it will remain part of it. ● SW release R300 ©2015 Telegesis (UK) Ltd - 15 - AT Command Manual (Rev 3.09)
  • Page 16 Please note that the bootloader will run at a baudrate of 115k2, no parity, 8 data bits regardless of the current serial port settings. ● SW release R300 ©2015 Telegesis (UK) Ltd - 16 - AT Command Manual (Rev 3.09)
  • Page 17 13 must be used for recovering. For more information on over-the-air firmware upgrading please refer to the Development Kit Manual. ● SW release R300 ©2015 Telegesis (UK) Ltd - 17 - AT Command Manual (Rev 3.09)
  • Page 18 When writing an individual bit by specifying [x[x]], <data> can only be either 0 or 1. ● SW release R300 ©2015 Telegesis (UK) Ltd - 18 - AT Command Manual (Rev 3.09)
  • Page 19 Only in case the errorcode is 00 the write When writing an individual bit by specifying operation has been completed successfully. [x[x]], <data> can only be either 0 or 1. ● SW release R302 ©2015 Telegesis (UK) Ltd - 19 - AT Command Manual (Rev 3.09)
  • Page 20 Registers. The data format for each individual display all the registers of a remote device. S-register is given in the S-register description in section 4. ● SW release R300 ©2015 Telegesis (UK) Ltd - 20 - AT Command Manual (Rev 3.09)

  • Page 21: Network Control & Configuration Commands

    PAN already. provided IDs are used instead of random ones, given the selected IDs are not already in use by other networks within range ● SW release R300 ©2015 Telegesis (UK) Ltd - 21 - AT Command Manual (Rev 3.09)
  • Page 22 If bit E of S0F is set the response includes RSSI Use on: and LQI All nodes Note Scanning for active PANs can take up to 4 seconds when dd=3 ● SW release R300 ©2015 Telegesis (UK) Ltd - 22 - AT Command Manual (Rev 3.09)
  • Page 23 COO. S02 and S03. Remote Action Prompt On the Trust Centre / Coordinator NEWNODE:<node EUI64>, <Network address>,<parent EUI64> ● SW release R300 ©2015 Telegesis (UK) Ltd - 23 - AT Command Manual (Rev 3.09)
  • Page 24 PAN <errorcode> represents the error code explained Use on in section 3. All Devices Instruct local device to leave the PAN. ● SW release R300 ©2015 Telegesis (UK) Ltd - 24 - AT Command Manual (Rev 3.09)
  • Page 25 <power> the node’s output power in dBm, <channel> the IEEE 802.15.4 radio channel (11- 26), <PID> the node’s PAN ID and <EPID> the node’s extended PAN ID. ● SW release R302 ©2015 Telegesis (UK) Ltd - 25 - AT Command Manual (Rev 3.09)
  • Page 26 Can be used to find the identity of all ZigBee devices in the network including non-Telegesis devices. Note Also the local node can be the target of this command (e.g.
  • Page 27 ZigBee Specification. In case of an error an errorcode other than 00 will be displayed and the prompt will end after the errorcode. ● SW release R303 ©2015 Telegesis (UK) Ltd - 27 - AT Command Manual (Rev 3.09)
  • Page 28 <Network address> is its Network address. In case an extended response has been requested the requested Network addresses from the associated devices list are listed as well. ● SW release R302 ©2015 Telegesis (UK) Ltd - 28 - AT Command Manual (Rev 3.09)
  • Page 29 As with all unicasts after successful transmission the sequence number of the unicast is stated using “SEQ:XX” prompt. When acknowledged not) accompanying “ACK:XX” (or “NACK:XX”) prompt is displayed. ● SW release R302 ©2015 Telegesis (UK) Ltd - 29 - AT Command Manual (Rev 3.09)
  • Page 30 As with all unicasts after successful transmission the sequence number of the unicast is stated using “SEQ:XX” prompt. When acknowledged not) accompanying “ACK:XX” (or “NACK:XX”) prompt is displayed. ● SW release R302 ©2015 Telegesis (UK) Ltd - 30 - AT Command Manual (Rev 3.09)
  • Page 31 Use on “SEQ:XX” prompt. When All Devices using acknowledged not) accompanying “ACK:XX” (or “NACK:XX”) prompt is displayed. ● SW release R302 ©2015 Telegesis (UK) Ltd - 31 - AT Command Manual (Rev 3.09)
  • Page 32 Use on using “SEQ:XX” prompt. When All Devices acknowledged not) accompanying “ACK:XX” (or “NACK:XX”) prompt is displayed. ● SW release R302 ©2015 Telegesis (UK) Ltd - 32 - AT Command Manual (Rev 3.09)
  • Page 33 Use on the sequence number of the unicast is stated All Devices using “SEQ:XX” prompt. When acknowledged not) accompanying “ACK:XX” (or “NACK:XX”) prompt is displayed. ● SW release R302 ©2015 Telegesis (UK) Ltd - 33 - AT Command Manual (Rev 3.09)
  • Page 34 2 hexadecimal digits as 8 bit hexadecimal numbers separated by commas. Examples AT+MATCHREQ:C091,01,0002,02,0004,000B AT+MATCHREQ:C091,00,01,0004 AT+MATCHREQ:C091,01,0002,00 Use on All Devices ● SW release R302 ©2015 Telegesis (UK) Ltd - 34 - AT Command Manual (Rev 3.09)
  • Page 35 For a description of the LQI reading please see section 7. <EUI64> is the identifier and <Network address> the Network address of the sending device ● SW release R302 ©2015 Telegesis (UK) Ltd - 35 - AT Command Manual (Rev 3.09)
  • Page 36 Network addresses starting with the remote node listing all nodes along the path to the local node <errorcode> represents the error code explained in section 3. ● SW release R302 ©2015 Telegesis (UK) Ltd - 36 - AT Command Manual (Rev 3.09)
  • Page 37 Use on <errorcode> represents the error code explained All devices except COO in section 3. ● SW release R300 ©2015 Telegesis (UK) Ltd - 37 - AT Command Manual (Rev 3.09)
  • Page 38 R309 AT Commands +SN – Scan Network Execute Command Response AT+SN[:nn] OK or ERROR<errorcode> All Telegesis devices which are up to nn hops Prompts FFD:<EUI64>,<Network address>[,syy,zz] away are listed. If nn = 01 only direct MED:<EUI64>,<Network address>[,syy,zz] neighbours will reply and nn = 00 will search the SED:<EUI64>,<Network address>[,syy,zz]...
  • Page 39 The Network Manager can change the radio channel and the <errorcode> represents the error code explained PAN ID. in section 3. Use on Router ● SW release R304 ©2015 Telegesis (UK) Ltd - 39 - AT Command Manual (Rev 3.09)

  • Page 40: Messaging

    The address table is volatile and its contents are lost if the device is powered down. Use on All Devices ● SW release R300 ©2015 Telegesis (UK) Ltd - 40 - AT Command Manual (Rev 3.09)
  • Page 41 01. <errorcode> represents the error code explained in section 3. Note SEDs and MEDs cannot receive multicast messages Use on All Devices ● SW release R300 ©2015 Telegesis (UK) Ltd - 41 - AT Command Manual (Rev 3.09)
  • Page 42 (set bit 0 of S10 to disable attaching EUI64 outgoing messages). RSSI and LQI are shown if bit 6 of S0F is set. ● SW release R300 ©2015 Telegesis (UK) Ltd - 42 - AT Command Manual (Rev 3.09)
  • Page 43 0 of S10 to disable attaching the EUI64 to outgoing messages). RSSI and LQI are shown if bit 6 of S0F is set. ● SW release R300 ©2015 Telegesis (UK) Ltd - 43 - AT Command Manual (Rev 3.09)
  • Page 44 (set bit 0 of S10 to disable attaching EUI64 outgoing messages). RSSI and LQI are shown if bit 6 of S0F is set. ● SW release R300 ©2015 Telegesis (UK) Ltd - 44 - AT Command Manual (Rev 3.09)
  • Page 45 (set bit 0 of S10 to disable attaching EUI64 outgoing messages). RSSI and LQI are shown if bit 6 of S0F is set. ● SW release R300 ©2015 Telegesis (UK) Ltd - 45 - AT Command Manual (Rev 3.09)
  • Page 46 (set bit 0 of S10 to disable attaching EUI64 outgoing messages). RSSI and LQI are shown if bit 6 of S0F is set. ● SW release R300 ©2015 Telegesis (UK) Ltd - 46 - AT Command Manual (Rev 3.09)
  • Page 47 (set bit 0 of S10 to disable attaching EUI64 outgoing messages). RSSI and LQI are shown if bit 6 of S0F is set. ● SW release R300 ©2015 Telegesis (UK) Ltd - 47 - AT Command Manual (Rev 3.09)
  • Page 48 (set bit 0 of S10 to disable attaching EUI64 outgoing messages). RSSI and LQI are shown if bit 6 of S0F is set. ● SW release R300 ©2015 Telegesis (UK) Ltd - 48 - AT Command Manual (Rev 3.09)
  • Page 49 (set bit 0 of S10 to disable attaching EUI64 outgoing messages). RSSI and LQI are shown if bit 6 of S0F is set. ● SW release R300 ©2015 Telegesis (UK) Ltd - 49 - AT Command Manual (Rev 3.09)
  • Page 50 250ms pass between sending +++ and the previous character. Use on All Devices ● SW release R302 ©2015 Telegesis (UK) Ltd - 50 - AT Command Manual (Rev 3.09)
  • Page 51 Plays a tune on a remote devboard if the Beeper is connected. Useful to identify remote nodes. See devkit manual for details about connecting a buzzer to the ETRXn. ● SW release R300 ©2015 Telegesis (UK) Ltd - 51 - AT Command Manual (Rev 3.09)
  • Page 52 AT+UCAST. SEQ and ACK are only reported when cluster 0002 is used. Use on All Devices ● SW release R309 ©2015 Telegesis (UK) Ltd - 52 - AT Command Manual (Rev 3.09)
  • Page 53 AT+UCASTB. SEQ and ACK are only reported when cluster 0002 is used. Use on All Devices ● SW release R309 ©2015 Telegesis (UK) Ltd - 53 - AT Command Manual (Rev 3.09)
  • Page 54 SEDs and MEDs cannot receive multicast messages As a broadcast command, AT+SENDMCAST is subject to the same limit of message rate as AT+MCAST. Use on All Devices ● SW release R309 ©2015 Telegesis (UK) Ltd - 54 - AT Command Manual (Rev 3.09)
  • Page 55 SEDs and MEDs cannot receive multicast messages As a broadcast command, AT+SENDMCAST is subject to the same limit of message rate as AT+MCAST. Use on All Devices ● SW release R309 ©2015 Telegesis (UK) Ltd - 55 - AT Command Manual (Rev 3.09)
  • Page 56 <DstPAN> - 16 bit hexadecimal number representing destination PAN ID. <ProfileID> - 16 bit hexadecimal number representing profile ID. e.g. 0x0104 for Home automation, 0xC091 for Telegesis profile. <ClusterID> - 16 bit hex number representing Cluster ID. <Payload> - Command payload, formatted as ASCII hex data.
  • Page 57 RSSI, or <data> in case bit 9 of S0E is set. Displaying the data can also be disabled by setting bit D of S0E. ● SW release R300 ©2015 Telegesis (UK) Ltd - 57 - AT Command Manual (Rev 3.09)

  • Page 58: Binding Management (Etrx3 Series Only)

    All parameters must have exactly the correct number of characters Use mode 2 when the source or destination is a coordinator or sink Use on All Devices ● SW release R307 ©2015 Telegesis (UK) Ltd - 58 - AT Command Manual (Rev 3.09)
  • Page 59 In case of an error an errorcode other than 00 will be displayed and Use on the prompt will end after the errorcode. All devices ● SW release R307 ©2015 Telegesis (UK) Ltd - 59 - AT Command Manual (Rev 3.09)
  • Page 60 (e.g. use address table entry FF as the address) All parameters must have exactly the correct number of characters Use on All devices ● SW release R307 ©2015 Telegesis (UK) Ltd - 60 - AT Command Manual (Rev 3.09)
  • Page 61 (e.g. use address table entry FF as the address) Unbind:0000,00 Example AT+UNBIND:0000,3,000d6f000059474e,01, ACK:01 abcd,000D6F0000123456,01 Note All parameters must have exactly the correct number of characters Use on All devices ● SW release R307 ©2015 Telegesis (UK) Ltd - 61 - AT Command Manual (Rev 3.09)
  • Page 62 No output clusters (note final comma) NOT_SUPPORTED INVALID_EP All parameters must have exactly the correct TIMEOUT number of characters NO_MATCH Use on All devices ● SW release R309 ©2015 Telegesis (UK) Ltd - 62 - AT Command Manual (Rev 3.09)

  • Page 63: Time-Related Commands

    0 hours, 0 minutes, 0 seconds, on the 1 of January, 2000 UTC <errorcode> represents the error code explained in section 3. ● SW release R309 ©2015 Telegesis (UK) Ltd - 63 - AT Command Manual (Rev 3.09)
  • Page 64 The target shall support the time server cluster. To exchange this message without interfering with any of the other message types, the local endpoint 0x63 (99) is used for this exchange. ● SW release R309 ©2015 Telegesis (UK) Ltd - 64 - AT Command Manual (Rev 3.09)

  • Page 65: List Of Error Codes

    ZDP Invalid Request Type ZDP Device not Found ZDP Invalid Endpoint ZDP Not Active ZDP Not Supported ZDP Timeout ZDP No Match ZDP Table Full ZDP No Entry ZDP No Descriptor ©2015 Telegesis (UK) Ltd - 65 - AT Command Manual (Rev 3.09)
  • Page 66 Unknown tag detected in .EBL image (wrong file format?) Invalid .EBL header signature (wrong file type for chip?) An invalid length was detected in the .EBL image (corrupt file?) ©2015 Telegesis (UK) Ltd - 66 - AT Command Manual (Rev 3.09)

  • Page 67: Registers

    S23 Immediate functionality at IRQ0 (/) (/) S24 Immediate functionality at IRQ1 (/) (/) S25 Immediate functionality at IRQ2 (/) (/) S26 Immediate functionality at IRQ3 (/) (/) Password Protected Registers ©2015 Telegesis (UK) Ltd - 67 - AT Command Manual (Rev 3.09)
  • Page 68 S4C Endpoint 2 Output Cluster List (/) (/) S4D Mobile End Device Poll Timeout (/) (/) S4E End Device Poll Timeout (/) (/) S4F MAC Timeout (/) (/) Table 6: S-Register Overview ©2015 Telegesis (UK) Ltd - 68 - AT Command Manual (Rev 3.09)

  • Page 69: Recovery Of The Factory Default Settings

    To factory reset a module, connect it to the PC’s serial port and execute the Factory Reset Tool (downloadable from www.telegesis.com). When pressing the Reset button on the Reset Tool you are prompted to cause a hardware reset to the module by pulling the module’s reset line low for more than 100ms (done by pressing the reset button on the...

  • Page 70: S-Registers For Network Setup

    Becomes effective bit E of S11. When Joining or establishing a PAN Storage Factory Default Non-Volatile ETRX3 LRS-Variants: -17 Others: 3 ● SW release R305 ©2015 Telegesis (UK) Ltd - 70 - AT Command Manual (Rev 3.09)
  • Page 71 S03 will be joined unless S03 is set to all 0’s. In this case the next best PAN which allows joining is joined. Storage Factory Default Non-Volatile 0000000000000000 ● SW release R300 ©2015 Telegesis (UK) Ltd - 71 - AT Command Manual (Rev 3.09)
  • Page 72 For an FFD, S06 is the ID of the node via which the local node joined the Operations R LOCAL R REMOTE Factory Default Storage Non-Volatile ● SW release R300 ©2015 Telegesis (UK) Ltd - 72 - AT Command Manual (Rev 3.09)
  • Page 73 This key is transmitted to all joining nodes and ATS08=<key>:<password> can be encrypted using the link key. ATREMS:<address>,08=<key>:<password> Becomes effective Only when establishing a PAN Factory Default Storage 00000000000000000000000000000000 Non Volatile ● SW release R300 ©2015 Telegesis (UK) Ltd - 73 - AT Command Manual (Rev 3.09)
  • Page 74 Write operation PAN. ATS09=<key>:<password> ATREMS:<address>,09=<key>:<password> Becomes effective When Joining or establishing a PAN Storage Non Volatile Factory Default 00000000000000000000000000000000 ● SW release R300 ©2015 Telegesis (UK) Ltd - 74 - AT Command Manual (Rev 3.09)

  • Page 75: S-Registers For Module Setup

    Bit 1: Set: Disable received interpan messages Bit 0: Set: Do not allow other nodes to join the network via this node Factory Default 0000 ● SW release R301 ©2015 Telegesis (UK) Ltd - 75 - AT Command Manual (Rev 3.09)
  • Page 76 W LOCAL Note that the password must have exactly 8 W REMOTE characters. Write operation ATS0C=<NEW>:<OLD> ATREMS:<address>,0C=<NEW>:<OLD> Becomes effective Instantly Storage Non-Volatile Factory Default password ● SW release R300 ©2015 Telegesis (UK) Ltd - 76 - AT Command Manual (Rev 3.09)
  • Page 77 Bit 3: Set: Disable JPAN prompt Bit 2: Set: Disable PWRCHANGE:nn prompt Bit 1: Set: Disable OK prompt Bit 0: Set: Disable ERROR:XX prompt Factory Default 0000 ● SW release R300 ©2015 Telegesis (UK) Ltd - 77 - AT Command Manual (Rev 3.09)
  • Page 78 Non-Volatile Bit A: Set: Add remote endpoint and Network address to ACK and NACK prompts for profile IDs other than the Telegesis one Bit 9: Set: Disable SWRITE prompt Bit 8: Set: Show unhandled messages received by Endpoints 1 and above Bit 7: Set: Hide “AddrResp”...
  • Page 79 Bit 1: Set: Send unicast messages unacknowledged Bit 0: Set: Don’t attach EUI64 to NWK frame when sending a message. Factory Default 0000 ● SW release R302 ©2015 Telegesis (UK) Ltd - 79 - AT Command Manual (Rev 3.09)
  • Page 80 Bit 2: Set: IRQ1 on falling edge Bit 1: Set: IRQ0 on rising edge Bit 0: Set: IRQ0 on falling edge Factory Default 0005 ● SW release R301 ©2015 Telegesis (UK) Ltd - 80 - AT Command Manual (Rev 3.09)

  • Page 81: I/O Related S-Registers

    2 set: 2 stop bits instead of one bit 1 set: odd parity enabled bit 0 set: even parity enabled Factory Default 0500 ● SW release R300 ©2015 Telegesis (UK) Ltd - 81 - AT Command Manual (Rev 3.09)
  • Page 82 Note The ETRX357’s current consumption may benefit from the use of pull-ups or pull-downs where inputs are otherwise unconnected. Storage Non-Volatile ● SW release R300 S14 – Reserved ©2015 Telegesis (UK) Ltd - 82 - AT Command Manual (Rev 3.09)
  • Page 83 5 reserved (PA5) bit 4 reserved (PA4) bit 3 reserved (PA3) bit 2 reserved (PA2) bit 1 reserved (PA1) bit 0 reserved (PA0) Factory Default 00000600 ● SW release R300 ©2015 Telegesis (UK) Ltd - 83 - AT Command Manual (Rev 3.09)
  • Page 84 S16 which is loaded after boot-up, soft or hard R/W REMOTE reset. Becomes effective After Soft or Hard Reset Storage Factory Default Non-Volatile ETRX3: 000142CC ● SW release R300 ©2015 Telegesis (UK) Ltd - 84 - AT Command Manual (Rev 3.09)
  • Page 85 S18 which is loaded after boot-up, soft or hard R/W REMOTE reset. Becomes effective After Soft or Hard Reset Storage Factory Default Non-Volatile ETRX3: 00000000 ● SW release R300 ©2015 Telegesis (UK) Ltd - 85 - AT Command Manual (Rev 3.09)
  • Page 86 12MHz. When reaching top I R/W REMOTE PB7 is set, given that the PWM is enabled in S11. Operations Instantly Factory Default Defined in S1C Storage Volatile ● SW release R300 ©2015 Telegesis (UK) Ltd - 86 - AT Command Manual (Rev 3.09)
  • Page 87 R/W REMOTE Becomes effective After Soft or Hard Reset Storage Factory Default Non-Volatile 1D4C (800Hz 50% m/s ratio) ● SW release R300 ©2015 Telegesis (UK) Ltd - 87 - AT Command Manual (Rev 3.09)
  • Page 88 A/D converter has not been Operations R LOCAL enabled. R REMOTE Becomes effective Range ETRX3: 0000 – 2EE0 (0 – 12000) Instantly Storage Instant Reading of analogue input ● SW release R300 ©2015 Telegesis (UK) Ltd - 88 - AT Command Manual (Rev 3.09)
  • Page 89 A/D converter has not been enabled. Operations R LOCAL Range R REMOTE ETRX3: 0000 – 2EE0 (0 – 12000) Becomes effective Instantly Storage Instant Reading of analogue input ● SW release R300 ©2015 Telegesis (UK) Ltd - 89 - AT Command Manual (Rev 3.09)

  • Page 90: S-Registers Defining The Functionality Of The Module

    If set to 0 the functionality is disabled. Please R/W REMOTE section list available functionalities. Becomes effective Instantly Storage Non-Volatile Factory Default 0001 (Wakeup to power mode 0) ● SW release R300 ©2015 Telegesis (UK) Ltd - 90 - AT Command Manual (Rev 3.09)
  • Page 91 Becomes effective Instantly Note PB0 is used internally on the ETRX357(HR)- Factory Default LRS and is not available to the user 0000 (none) Storage Non-Volatile ● SW release R300 ©2015 Telegesis (UK) Ltd - 91 - AT Command Manual (Rev 3.09)
  • Page 92 If set to 0 the functionality is disabled. Please R/W REMOTE section list available functionalities. Becomes effective Instantly Storage Non-Volatile Factory Default 0000 (none) ● SW release R300 ©2015 Telegesis (UK) Ltd - 92 - AT Command Manual (Rev 3.09)
  • Page 93 If set to 0 the functionality is disabled. Please R/W LOCAL section list available R/W REMOTE functionalities. Becomes effective Instantly Storage Factory Default Non-Volatile 0000 (none) ● SW release R302 ©2015 Telegesis (UK) Ltd - 93 - AT Command Manual (Rev 3.09)
  • Page 94 If set to 0 the functionality is disabled. Please R/W REMOTE see section 5 for a list of the functionalities. Becomes effective Instantly Storage Non-Volatile Factory Default 8010 (end devices poll parent) ● SW release R300 ©2015 Telegesis (UK) Ltd - 94 - AT Command Manual (Rev 3.09)
  • Page 95 5 for a list of the functionalities. Becomes effective Instantly Storage Non-Volatile Factory Default 821E (advertise sink for 30 hops and create aggregation routes to COO and sinks) ● SW release R300 ©2015 Telegesis (UK) Ltd - 95 - AT Command Manual (Rev 3.09)
  • Page 96 R/W REMOTE see section 5 for a list of the functionalities. Becomes effective Instantly Storage Non-Volatile Factory Default 8014 (leave network if I am alone) ● SW release R300 ©2015 Telegesis (UK) Ltd - 96 - AT Command Manual (Rev 3.09)
  • Page 97 5 for a list of the functionalities. Becomes effective Instantly Storage Non-Volatile Factory Default 8015 (if not part of a network do AT+JN) ● SW release R300 ©2015 Telegesis (UK) Ltd - 97 - AT Command Manual (Rev 3.09)
  • Page 98 If set to 0 the functionality is disabled. Please R/W REMOTE see section 5 for a list of the functionalities. Becomes effective Instantly Storage Non-Volatile Factory Default 0000 ● SW release R302 ©2015 Telegesis (UK) Ltd - 98 - AT Command Manual (Rev 3.09)
  • Page 99 If set to 0 the functionality is disabled. Please R/W LOCAL see section 5 for a list of the functionalities. R/W REMOTE Becomes effective Instantly Storage Factory Default Non-Volatile 0000 ● SW release R300 ©2015 Telegesis (UK) Ltd - 99 - AT Command Manual (Rev 3.09)
  • Page 100 If set to 0 the functionality is disabled. Please R/W LOCAL see section 5 for a list of the functionalities. R/W REMOTE Becomes effective Instantly Storage Non-Volatile Factory Default 0000 ● SW release R300 ©2015 Telegesis (UK) Ltd - 100 - AT Command Manual (Rev 3.09)
  • Page 101 If set to 0 the functionality is disabled. Please R/W LOCAL see section 5 for a list of the functionalities. R/W REMOTE Becomes effective Instantly Storage Factory Default Non-Volatile 0000 ● SW release R300 ©2015 Telegesis (UK) Ltd - 101 - AT Command Manual (Rev 3.09)
  • Page 102 Contains Text which is used by some of the Up to 50 characters actions described in section 5. Operations R/W LOCAL R/W REMOTE Becomes effective Instantly Factory Default Storage Non-Volatile BUTTON3 ● SW release R300 ©2015 Telegesis (UK) Ltd - 102 - AT Command Manual (Rev 3.09)
  • Page 103 The Supply voltage of the device in mV. nnnn Operations Where nnnn represents the supply voltage in R LOCAL R REMOTE Becomes effective Factory Default Storage Volatile ● SW release R300 ©2015 Telegesis (UK) Ltd - 103 - AT Command Manual (Rev 3.09)

  • Page 104: Advanced Settings

    Becomes effective Instantly Note As for S3E Factory Default Storage 0000 Non-Volatile ● SW release R300 ©2015 Telegesis (UK) Ltd - 104 - AT Command Manual (Rev 3.09)
  • Page 105 Where ss is the hexadecimal source endpoint R/W LOCAL and dd is the hexadecimal destination endpoint. R/W REMOTE Becomes effective After Soft or Hard Reset Storage Factory Default Non-Volatile 0101 ● SW release R300 ©2015 Telegesis (UK) Ltd - 105 - AT Command Manual (Rev 3.09)
  • Page 106 Operations The cluster ID of any xCAST message R/W LOCAL R/W REMOTE Becomes effective After Soft or Hard Reset Factory Default Storage 0002 Non-Volatile ● SW release R300 ©2015 Telegesis (UK) Ltd - 106 - AT Command Manual (Rev 3.09)
  • Page 107 XXXXXXXX some of the build in functionality Operations R/W LOCAL R/W REMOTE Becomes effective Instantly Factory Default Storage 00000000 Volatile R303 – upgraded to 32-bit ● SW release ©2015 Telegesis (UK) Ltd - 107 - AT Command Manual (Rev 3.09)
  • Page 108 Register defining the Device ID of the Node’s XXXX endpoint 2 The 16 bit device ID. Operations R/W LOCAL R/W REMOTE Becomes effective Instantly Factory Default 0000 Storage Non-Volatile ● SW release R302 ©2015 Telegesis (UK) Ltd - 108 - AT Command Manual (Rev 3.09)
  • Page 109 The list may have any R/W REMOTE length from 0 to 12 clusters Example Becomes effective ATS4B=1101,000D Instantly Storage Factory Default Non-Volatile 0000 ● SW release R302 ©2015 Telegesis (UK) Ltd - 109 - AT Command Manual (Rev 3.09)
  • Page 110 After Soft or Hard Reset Note The timer tested according to S4D continues to run in Power Mode 3 Factory Default Storage 0014 Non-Volatile ● SW release R302 ©2015 Telegesis (UK) Ltd - 110 - AT Command Manual (Rev 3.09)
  • Page 111 After Soft or Hard Reset nacked when no ack is received. The default value is 7680ms. The maximum is 30s Storage Non-Volatile Maximum 7530 Factory Default 1E00 ● SW release R302 ©2015 Telegesis (UK) Ltd - 111 - AT Command Manual (Rev 3.09)

  • Page 112: Build In Functionality

    Note 1: this has no effect on an End Device. Note 2: only execute this function every few minutes or devices may leave the PAN unexpectedly. Note 3: The actual code in the register needs to be 801E ©2015 Telegesis (UK) Ltd - 112 - AT Command Manual (Rev 3.09)
  • Page 113 02XX If I am a Sink advertise me for x hops (max. no. of hops: 30). If I am a COO create aggregation routes needed for Trust Centre. NB message does not reach end devices when parent already knows a sink address 0300 Increment S46 0301 Decrement S46 ©2015 Telegesis (UK) Ltd - 113 - AT Command Manual (Rev 3.09)
  • Page 114 4XXX Change data direction of the I/O port to the LSBs. 53xx Toggle I/Oxx 54xx Flash I/Oxx (pull low) for 250ms 55xx Set I/Oxx to 0 56xx Set I/Oxx to 1 Table 7. Built-in functions ©2015 Telegesis (UK) Ltd - 114 - AT Command Manual (Rev 3.09)

  • Page 115: Etrx357 Power Consumption (Provisional Data)

    If no means of waking up from any of the power down modes has been defined and the module appears unresponsive the Telegesis factory default resetter can be used to reset the modules factory defaults via the serial port.

  • Page 116: Notes On Energy Levels And Lqi

    Cost 254 - 255 247 - 253 200 - 246 0 - 199 Table 10: LQI/Cost relationship ©2015 Telegesis (UK) Ltd - 116 - AT Command Manual (Rev 3.09)

  • Page 117: Interpreting Rssi Energy Levels

    They utilize the RX gain settings and the output level of the ADC within its algorithm. The linear range of RSSI is specified to be 40dB over all temperatures. At room temperature, the linear range is approximately 60dB (-90 dBm to -30dBm). ©2015 Telegesis (UK) Ltd - 117 - AT Command Manual (Rev 3.09)

  • Page 118: Trademarks

    We reserve the right to make modifications and/or improvements without prior notification. All information is correct at time of issue. Telegesis (UK) Ltd. does not convey any license under its patent rights or assume any responsibility for the use of the described product.

  • Page 119: Appendix A. Forming A Secure Network

    Telegesis devices and register settings, and vice-versa. The use of a pre-defined Trust Centre Link Key can avoid all these problems. ZigBee PRO normally uses a Network Key common to all devices for general network traffic, and a Trust Centre Link Key common to all devices for key distribution.

  • Page 120: Appendix B. Bootloading New Firmware

    The process of bootloading an application file through the serial port or over the air is described more fully in the ETRX357 Development Kit Product Manual. For convenience the main points are described here also, as they relate to Telegesis Terminal. Other terminal applications can be used provided they support the XMODEM protocol.

  • Page 121: Bootloading Over The Air

    <cr> character to the serial port which implies that the latter is available for use, so it may be easier to just use the AT+BLOAD command. ©2015 Telegesis (UK) Ltd - 121 - AT Command Manual (Rev 3.09)

This manual is also suitable for:

Etrx357Etrx3 seriesEtrx357-lrsEtrx357hrEtrx357hr-lrEtrx357hr-lrs ... Show all

Table of Contents