background image

Telegesis (UK) Limited 

 

 

TG-ETRXn-UG-01-103 

18 

User Guide 

1.04 

ETRX1 and ETRX2 

 

 
©2008 Telegesis (UK) Ltd 

 

ETRXn User Guide (Rev 1.04) 

 

-14, -17, -20, -26, -43}  Entering a value not on this list (such as 

–19) will resulted in the next lowest 

output  power.    Also  on  the  ETRX2  specifying  a  power  level  of  4  will  enable  the  boost  mode 
increasing both output power as well as sensitivity. 

S03

 

This  register  contains  the  128-bit  encryption  key.    To  learn  more  about  security  please  refer  to 
chapter 8.  Please note that a 128-bit number is represented by 32 hexadecimal characters.  For 
security reasons this register is write only and requires a password to be written to. 

5.3  Module Setup (S04-S0A) 

S04 

This register contains a user readable name which can be up to 20 bytes long.  This name has no 
impact on the functionality and can be used to identify modules. 

S05 

In  analogy  to the  user  definable  name this  16-bit  register  can  be  read  and  written  by  the  user  to 
identify  the  module  and  has  no  impact  on  functionality.    Writing  to  this  register  is  password 
protected as shown in the AT command dictionary. 

S06 

This is the main function register defining the behaviour of the module.  Bits 0 to 4 and B define the 
security mechanisms used for joining and maintaining networks as described in section 8.  If bit 6 
is set, the RSSI and LQI of the last hop will be displayed for all devices reporting in.  If bit 8 is set 
the local unit will become the network‟s data sink.  Bits 9 and A define whether the unit is a RFD 
(end device) and select whether it is a sleepy or a mobile sleepy end device.  If bit C is set the user 
will be prompted to accept a channel which has been requested by a remote node, if cleared the 
channel will be accepted automatically.  Setting bit D disables the possibility to have more than one 
ucast or scast transmission in flight at any one time which might simplify host controller interaction.  
Setting  bit  E  enables  multiple  reads  from  remote  S-

Registers  using  “ATSREM”  at  any  one  time.  

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. 

S07 

In  the  extended  function  register  many  of  the  prompts  which  may  show  during  operation  can  be 
disabled to make interaction with a host microcontroller easier. 

S08 

This is the second extended function register allowing more prompts to be disabled.  Furthermore  
setting bit F makes changes to S02 take effect instantly as previously described.  Setting bit E of 
S08 to 1 enables I/O7 to indicate the power mode of the module by driving the pin high if in power 
mode  >  2  and  driving  it  low  otherwise.    In  order  for  this  to  work  I/O7  must  be  defined  to  be  an 
output.  Setting bit D activates a 1 second character timeout for xCASTB and channel operation.  
Where  this bit is set those commands will be aborted if no data is received on the local serial port 
for more than  1 second.   Finally setting bit C disables the mechanism causing a node to discard 
and search for a new sink where three transmissions to the sink have failed. 

S09 

This register contains the password and therefore cannot be read remotely or locally.  In order to 
change a module‟s password you need to state the current password as shown in the command 
dictionary. 

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

Page 1: ...is UK Limited TG ETRXn UG 01 104 1 User Guide 1 04 ETRX1 and ETRX2 Telegesis 2008 Telegesis UK Ltd ETRXn User Guide Rev 1 04 TG ETRXn UG 01 104 ETRXn WIRELESS MESH NETWORKING MODULES Firmware R2xx Use...

Page 2: ...s 12 3 3 10 AT REMSN Scan for remote device s direct neighbours 13 3 3 11 AT LINKCHECK Check link parameters with a neighbour 13 3 3 12 AT PING Indicate presence in the network 13 3 3 13 ATS ATSREM Re...

Page 3: ...nd of this document a number of possible application scenarios are listed in order to show the versatility of the ETRXn modules Some of the details will vary from one firmware version to another this...

Page 4: ...ach development board which forms part of your set up and connect at least one development board to a PC using the serial or USB cable provided Figure 1 Development board with module mounted Power up...

Page 5: ...n establishes the connection to the ETRXn module on the development board Figure 3 Setup of the Serial Connection The module will accept commands starting with the AT prefix after it has booted up suc...

Page 6: ...a separate PAN simply use the AT DASSL command to leave the current PAN and try joining the correct PAN using the AT JN command Network establishment and maintenance is described in more detail in Sec...

Page 7: ...de and use the AT PANSCAN or AT JN command this will reveal the pre existing PAN you can join it and then either carry on using it or disassociate the remote nodes and start afresh In order to find ou...

Page 8: ...ide Rev 1 04 Figure 6 Device Naming 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 op...

Page 9: ...u wish to transmit preceded by an equal sign If you do not know the syntax of a command hold the mouse pointer over the respective button and the tool tip text will display the format of the command a...

Page 10: ...constantly be awake in order to fulfil its routing responsibilities whereas a ZED can spend its life in sleep mode as it has no routing responsibilities ZRs consequently consume more power than ZEDs t...

Page 11: ...nce every second When sending a unicast from an end device the unit will keep polling for the acknowledgement until it has been received or the transmission has timed out regardless of the configured...

Page 12: ...etwork to join if there is more than one network available 3 3 5 AT PANSCAN Scan for all available channels AT PANSCAN will produce a list of all available channels from which you can manually choose...

Page 13: ...alone of register xx 3 4 Managing a Network Previously we used the AT SN command to scan the network for other nodes Having found them we were able to interact with those nodes by referencing them us...

Page 14: ...t Due to the potential presence of alternative routes packets may not arrive at their destination in the order they have been sent and also the timing of messages may vary The worst case delay for dat...

Page 15: ...ber In case you prefer to wait until the ACK or NACK has been received simply set bit D of S06 and no transmission number will be issued Instead the response will be either OK if an ACK has been recei...

Page 16: ...esis Terminal Software By default the remote node will automatically accept the channel if bit C of S6 is cleared Where bit C of S6 is set the user on the remote end will be prompted that a channel ha...

Page 17: ...module is powered down Note that some register changes take effect immediately while others are deferred typically until a reset The registers fall into groups shown below 5 2 Radio Setup S00 S03 S00...

Page 18: ...e user will be prompted to accept a channel which has been requested by a remote node if cleared the channel will be accepted automatically Setting bit D disables the possibility to have more than one...

Page 19: ...he initial non volatile setting of the output buffer S0F after reset and power up S11 The input buffer of the I O port representing the current logic levels on the module s input pins S12 Reading of t...

Page 20: ...n is defined to be an input and the output buffer is set to logic 1 then an internal pull up is activated given that bit D of S2E has been set to enable internal pull ups globally For current sensitiv...

Page 21: ...pressing a button on the devboard forces the respective I O to ground Note the commands AT ADLOC and AT ADREM of the R1xx firmware have been removed Simply read registers S12 S13 5 5 Event Management...

Page 22: ...out of the neighbour table 3 F0 1 min 0016 In case I am not joined to a network scan for and join the next best network and restart the timer Table 2 Timer defaults Example for a Development kit board...

Page 23: ...leep User defined 3 Asleep Asleep Off Asleep Asleep Off Table 3 Power modes In power mode 2 the timers will keep running although both the radio and the MCU are asleep When a timed action is executed...

Page 24: ...2F controls variable frequency signal volatile S30 Initial Value of S2F non volatile S31 also controls variable frequency signal volatile ETRX2 only S32 Initial Value of S31 non volatile ETRX2 only 6...

Page 25: ...no prescaling 0 1 0 clk 8 0 1 1 clk 64 1 0 0 clk 256 1 0 1 clk 1024 1 1 0 External clock 1 1 1 External clock Table 5 Prescaler ratios The frequency at the module s output pin is given by ftone 8MHz 2...

Page 26: ...nctional impact on the operation of I O3 until the special function pin is enabled by setting bit F of S2E 7 Reviving An Unresponsive Module If the module is completely unresponsive it may be in power...

Page 27: ...ethod is less secure as the encryption key is passed over the air and could be intercepted To avoid requiring the coordinator in order to let a new node join the network this decision can also be made...

Page 28: ...DC readings to sink This will make the sensor send its temperature information to the sink periodically As in the previous option the sensor could be an end device in power mode 2 thus being battery o...

Page 29: ...he great shortcomings of point to point radio in automation Telegesis have also assembled the ETRX2 module into units with a USB ETRX2USB and compact flash interface ETRX2CF which is very suitable for...

Page 30: ...In case this was triggered by a timer the timer will stop 0005 Change to power mode 0 In case this was triggered by a timer the timer will restart 0006 Change to power mode 1 In case this was triggere...

Page 31: ...018 but restart the timer 001A Copy the inputs of the remote device whose EUI64 is defined in S2C to the outputs of the local device and stop the timer 001B Same as function 001A but restart the timer...

Page 32: ...10 Sends the reading of the I O and the two analogue ports as well as an 8 bit transmission counter which increments with every transmission to the network s sink and if no sink is known the unit will...

Page 33: ...the serial port a SCAST containing these characters is sent to the network s sink If no sink is known a sink is searched instead After 3 unsuccessful transmissions the sink is assumed unavailable and...

Page 34: ...and if applicable the timer will stop Bxxx 12 Change data direction of the I O port to the LSB s xxx and if applicable the timer will restart Glossary AES Advanced Encryption Standard COO Coordinator...

Page 35: ...Telegesis UK Limited TG ETRXn UG 01 103 35 User Guide 1 04 ETRX1 and ETRX2 2008 Telegesis UK Ltd ETRXn User Guide Rev 1 04 Vcc GND Vcc A D1 A D2 I O7 I O6 I 05 I O4 RTS Table 6 ETRX1 pinout...

Page 36: ...registered trademarks and products names are the sole property of their respective owners 15 Disclaimer Product and Company names and logos referenced may either be trademarks or registered trademarks...

Page 37: ...elegesis UK Ltd ETRXn User Guide Rev 1 04 Telegesis UK Limited Marlow Business Centre 84 Station Road Marlow Bucks SL7 1NX UK Tel 44 0 1628 894347 Fax 44 0 1628 894333 17 References Telegesis www tele...

Reviews: