Telegesis TG-ETRXn-UG-01-104 User Manual

Etrxn wireless mesh networking modules

Advertisement

Quick Links

Telegesis (UK) Limited
ETRX1 and ETRX2
ETRXn WIRELESS MESH NETWORKING MODULES
©2008 Telegesis (UK) Ltd
TG-ETRXn-UG-01-104
Firmware R2xx User Guide
Telegesis
TG-ETRXn-UG-01-104
User Guide
ETRXn User Guide (Rev 1.04)
1
1.04

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the TG-ETRXn-UG-01-104 and is the answer not in the manual?

Questions and answers

Summary of Contents for Telegesis TG-ETRXn-UG-01-104

  • Page 1 TG-ETRXn-UG-01-104 Telegesis (UK) Limited User Guide 1.04 ETRX1 and ETRX2 TG-ETRXn-UG-01-104 ETRXn WIRELESS MESH NETWORKING MODULES Firmware R2xx User Guide Telegesis ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 2: Table Of Contents

    Device-specific registers (S2D-S35) ..............23 SPECIALISED I/O ....................24 Tone Generation at Pin I/O3 ................. 24 6.1.1 ETRX1 Settings ....................24 6.1.2 ETRX2 Settings ....................25 REVIVING AN UNRESPONSIVE MODULE ............26 SECURITY ......................26 ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 3: Introduction

    ASCII strings. You can use your own application software, a tool such as HyperTerminal, or our own Telegesis Terminal which is a free download from our website. To use it, first install .NET Framework Version 1.1 Redistributable Package from Microsoft. This is currently available at www.microsoft.com/downloads/details.aspx?familyid=262D25E3-F589-4842-8157-...
  • Page 4 1.04 ETRX1 and ETRX2 Note: Telegesis Terminal is not a GUI that interprets the AT commands and sends instructions to the ETRX2 in another format. It does not alter the AT commands in any way – the ETRX2 receives them exactly as described here and in the AT Command Manual. Likewise, if you are writing your own terminal application, it should send and receive data as formatted in our manuals.
  • Page 5 “ATI” command to be sent to the local module. After executing a command the module will prompt “OK” or an error code as explained in the AT command dictionary. ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 6 In this example three additional modules were detected: one ZigBee Coordinator (COO), one ZigBee Router (FFD) and one Sleepy End Device (SED). For an explanation of the device types see Section 3.2. ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 7 Having identified which module is which you can now give each module a name using the Telegesis Terminal software. To do this, right click on the entry in the “Discover Devices” window (as shown in Figure 6) and enter the name when prompted to do so. Please note that this name is not written to the module itself, it only represents a temporary name which can be used to simplify the evaluation process using the Telegesis Terminal software.
  • Page 8 If you have used the “Configure” button, your button window will resemble Figure 7 and Figure 8 and the device table Figure 9. Figure 7. "LED" buttons after a “Configure” operation Figure 8. "IDENT" buttons after a “Configure” operation Figure 9. Device table after a “Configure” operation ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 9: Network Management

    So far we have set up all of the hardware required for a meshing network, identified and named the individual modules using the Telegesis Terminal Software and actioned a few simple commands in order to learn the functionality of the AT-Style command line interface.
  • Page 10: Device Types

    Messages may then pass across the network in more than one “hop”. The Telegesis AT command driven software supports point-to-point messages travelling up to six hops and broadcast messages travelling up to ten hops through the network.
  • Page 11: Network Establishment And Maintenance

    (a “star” topology), there is no point in defining the ZEDs as mobile since there is no other parent to adopt them. In the Telegesis AT command software each routing device can have up to eight sleepy end devices and up to eight mobile end devices.
  • Page 12: At+Dassl - Disassociate Local Node

    R1xx into a single command. Optionally the RSSI and LQI readings between the remote device and the local device can be displayed if bit 6 of register S06 is set as described in section 5. ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 13: At+Remsn - Scan For Remote Device"S Direct Neighbours

    If there is a risk that a node may drop out and be re-captured by a different PAN, security modes should be invoked (see section 8). ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 14: Data Transmission

    The character string can include <CR>, <LF> and non-displayable bytes. Each receiving node sends the message “BCAST:<EUI64>,xx=<data>” to its serial port (<EUI64> being the transmitting node and xx the string length). ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 15: Raw Data

    There can be only one sink in a network. If an existing sink receives a message that another node has declared itself also to be a sink, the first sink‟s function is cancelled and the relevant register bit (S06, bit 8) is cleared. ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 16: Channels

    To open a channel use the “AT+OPCHAN:” command followed by the serial number of the device to which you want to open that channel. Alternatively you can use the “Open” button in the “Channel” section of the Telegesis Terminal Software. By default the remote node will automatically accept the channel if bit C of S6 is cleared.
  • Page 17: Registers

    PAN, unless F 15 of S08 is set. In this case changes take effect instantly. Actual values for the ETRX2 are {3, 2, 1, -1, -2, -3, -4, -5, -6, -7, -8, -9, -11, -12, ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 18: Module Setup (S04-S0A)

    For a more detailed description of these last two points please refer to the respective command description in the AT command dictionary. Finally, on the ETRX1 bit F should always read 0. If not please contact Telegesis. On the ETRX2 this bit is unused.
  • Page 19: I/O-Related Registers (S0B-S14)

    F8 hexadecimal which suits the devboard having three inputs (Buttons 2-4) and five outputs (LEDs 1-4 and Beeper). Table 1 shows the mapping of the devboard pins to the I/O of the ETRX1 and ETRX2 module. ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 20 Set bit 7 of S0F to 0 (note we can access each bit individually) The described operations can be executed using the ATS command as shown in Figure 13 below: 1 Only available on the ETRX2 ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 21: Event Management (S15-S28)

    IRQ1 on a rising(falling) edge of I/O pin 1. The default actions defined in S15 and S16 is to wake the module up to power mode 0 on either interrupt. ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 22: Timers

    When selecting a battery, note that it must be able to supply the peak current when the ETRXn is transmitting – see the ETRX2 or ETRX2PA product manual for data. ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 23: Functionality Text (S2B-S2C)

    On the ETRX2 the wake-up on serial port activity can be enabled by setting bit 5. By setting bit 6 the module can be configured to output the analogue A/D reference voltage on I/O0 during an A/D ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 24: Specialised I/O

    The contents of Timer/Counter Control Register TCCR2 are shown in Table 4, the last row giving suggested values for a simple tone. ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 25: Etrx2 Settings

    6.1.2 ETRX2 Settings On the ETRX2 S2F represents the top value of a 16-bit counter incrementing at 12MHz. Whenever the top value is reached the counter restarts from zero and I/O3 is set. ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 26: Reviving An Unresponsive Module

    If the module is completely unresponsive, it may be in power mode 3 or the serial port settings may have been altered. Go to the “Download software” page of the Telegesis website and download software. Connect the module‟s serial port to your PC and run the Factory Default Utility Factory Reset Tool;...
  • Page 27: Network Commissioning

    The key is always used for message encryption even if secured joining is not in effect. ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 28: Application Examples

    10 Application Examples In this section there is a list of suggested applications using the ETRXn module. This list will never be exhaustive, but should give you an idea about the great flexibility and versatility of the Telegesis ETRXn Wireless Meshing Module.
  • Page 29: Serial Port Replacement

    Telegesis is also happy to offer custom firmware development for the ETRX2 range of products. 10.6 Developing Your Own Firmware 11 Feel free to develop your own firmware to go on to the ETRX2 and use the modules as hardware only.
  • Page 30: Built-In Functionality

    PAN. Note: It takes about 80 seconds for a neighbour to age out of the neighbour table. By default this action is executed every 61 seconds using timer/counter2 (S1B and S1C). ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 31 <EUI64> is the sender‟s ID, <xxxx> is the reading of the I/O port, <yyyy> is the reading of A/D0 and <zzzz> is the reading of A/D1 0101 Same as 0100, but if applicable the timer will restart. ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 32 Sends the contents of S2B as a RAW transmission. If applicable the timer will stop. 0121 Same as 0120, but if applicable the timer will restart. 0122 Sends the contents of S2C as a RAW transmission. If applicable the timer will stop. ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 33 Same as function 3002 but the timer will restart. 400x Start timer x. If applicable the timer will stop. 401x Start timer x. If applicable the timer will restart. 402x Toggle timer x. If applicable the timer will stop. ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 34: Glossary

    Link Quality Indication Microcontroller unit Mobile end device Personal area network Reduced function device RSSI Received signal strength indication Sleepy end device ZigBee coordinator ZigBee End Device ZigBee Router 13 Module Pinouts ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 35 Telegesis (UK) Limited TG-ETRXn-UG-01-103 User Guide 1.04 ETRX1 and ETRX2 Table 6. ETRX1 pinout ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)
  • Page 36: 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...
  • Page 37: References

    Telegesis (UK) Limited Marlow Business Centre 84 Station Road Marlow Bucks SL7 1NX Tel: +44 (0)1628 894347 Fax: +44 (0)1628 894333 17 References Telegesis www.telegesis.com Ember www.ember.com Atmel www.atmel.com ® ZigBee Alliance www.zigbee.org ©2008 Telegesis (UK) Ltd ETRXn User Guide (Rev 1.04)

Table of Contents