telit sr manager tool user guide r1

72
SR Manager Tool User Guide 1vv0300899 Rev.1 – 2011-02-04

Upload: svoicum

Post on 16-Apr-2015

110 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide

1vv0300899 Rev.1 – 2011-02-04

Page 2: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 2 of 72

APPLICABILITY TABLE

PRODUCT

ZE50/ZE60

ZE51/ZE61

TinyOne Pro (32kB)

TynyOne Lite 868MHz

ME50 868MHz

LE50 868MHz

SW Version

2G.00.01

Page 3: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 3 of 72

Disclaimer

The information contained in this document is the proprietary information of Telit Communications S.p.A. and its affiliates (“TELIT”).

The contents are confidential and any disclosure to persons other than the officers, employees, agents or subcontractors of the owner or licensee of this document, without the prior written consent of Telit, is strictly prohibited.

Telit makes every effort to ensure the quality of the information it makes available. Notwithstanding the foregoing, Telit does not make any warranty as to the information contained herein, and does not accept any liability for any injury, loss or damage of any kind incurred by use of or reliance upon the information.

Telit disclaims any and all responsibility for the application of the devices characterized in this document, and notes that the application of the device must comply with the safety standards of the applicable country, and where applicable, with the relevant wiring rules.

Telit reserves the right to make modifications, additions and deletions to this document due to typographical errors, inaccurate information, or improvements to programs and/or equipment at any time and without notice.

Such changes will, nevertheless be incorporated into new editions of this document.

Copyright: Transmittal, reproduction, dissemination and/or editing of this document as well as utilization of its contents and communication thereof to others without express authorization are prohibited. Offenders will be held liable for payment of damages. All rights are reserved.

Copyright © Telit Communications S.p.A. 2011.

Page 4: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 4 of 72

Contents

1.  Introduction ........................................................................................................... 6 

1.1.  Scope ............................................................................................................................ 6 

1.2.  Audience ....................................................................................................................... 6 

1.3.  Contact Information, Support ...................................................................................... 6 

1.4.  Open Source Licenses ................................................................................................. 6 1.4.1.  Wireshark ........................................................................................................................... 7 

1.5.  Document Organization ............................................................................................... 7 

1.6.  Text Conventions .......................................................................................................... 7 

1.7.  Related Documents ..................................................................................................... 7 

1.8.  Document History ........................................................................................................ 8 

2.  SRManagerTool Setup ............................................................................................ 9 

2.1.  Connecting to SRManagerTool .................................................................................... 9 

2.2.  SR Modules ................................................................................................................ 10 

2.3.  Downloading .............................................................................................................. 12 

2.4.  System Requirements ............................................................................................... 12 

2.5.  Installation ................................................................................................................. 12 

3.  SRManagerTool Description ................................................................................. 14 

3.1.  Execution .................................................................................................................... 14 

3.2.  Flashing ...................................................................................................................... 15 3.2.1.  Multiple Flashing Sessions ............................................................................................. 19 

3.3.  Analyzer ..................................................................................................................... 23 

3.4.  Management .............................................................................................................. 38 3.4.1.  Management of MeshLite Technology ............................................................................. 38 

3.4.1.1.  MeshLite Configuration Wizard ................................................................................ 43 3.4.2.  Management of WM-Bus Technology .............................................................................. 48 

3.4.2.1.  WM-Bus Configuration Wizard ................................................................................. 51 3.4.3.  Management of S-One Technology .................................................................................. 54 

3.4.3.1.  S-One Configuration Wizard ..................................................................................... 58 

Page 5: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 5 of 72

3.4.4.  Management of ZigBee Technology................................................................................. 62 3.4.4.1.  ZigBee Configuration Wizard .................................................................................... 65 

4.  ACRONYMS AND ABBREVIATIONS ....................................................................... 72 

Page 6: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 6 of 72

1. Introduction

1.1. Scope Scope of this document is supply an user guide for the Telit SRManagerTool.

1.2. Audience This User Guide is intended for Short Range Module users who want to program, manage and control the short range network activities.

1.3. Contact Information, Support For general contact, technical support, to report documentation errors and to order manuals, contact Telit Technical Support Center (TTSC) at:

[email protected] [email protected] [email protected] [email protected]

Alternatively, use:

http://www.telit.com/en/products/technical-support-center/contact.php

For detailed information about where you can buy the Telit modules or for recommendations on accessories and components visit:

http://www.telit.com

To register for product news and announcements or for product questions contact Telit Technical Support Center (TTSC).

Our aim is to make this guide as helpful as possible. Keep us informed of your comments and suggestions for improvements.

Telit appreciates feedback from the users of our information.

1.4. Open Source Licenses The SRManagerTool developed by Telit make use of Wireshark.

Page 7: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 7 of 72

1.4.1. Wireshark Wireshark is an open source application and is released under the GNU General Public License version 2.

1.5. Document Organization This document contains the following chapters:

“Chapter 1: “Introduction” provides a scope for this document, target audience, contact and support information, and text conventions.

“Chapter 2: “SRManagerTool Setup” gives instructions on how to setup the product.

“Chapter 3: “SRManagerTool Description” describes in details the features of the product.

“Chapter 4: “Acronyms and Abbreviations” lists acronyms and abbreviations used in the document.

1.6. Text Conventions

Danger – This information MUST be followed or catastrophic equipment failure or bodily injury may occur.

Caution or Warning – Alerts the user to important points about integrating the module, if these points are not followed, the module and end user equipment may fail or malfunction.

Tip or Information – Provides advice and suggestions that may be useful when integrating the module.

All dates are in ISO 8601 format, i.e. YYYY-MM-DD.

1.7. Related Documents [1] Telit ZigBee Democase Getting Started [2] Telit ZigBee Democase User Guide [3] Telit ZigBee PRO Democase User Guide [4] Telit ZigBee PRO Democase Getting Started

Page 8: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 8 of 72

[5] Telit M ONE Protocol Stack User Guide [6] Telit Mesh Democase User Guide [7] Telit Wireless M Bus User Guide [8] S-One Protocol Stack User Guide [9] Wireshark documents:

http://www.wireshark.org/docs/ http://wiki.wireshark.org/IEEE_802.15.4

1.8. Document History

Revision Date Changes 0 2010-11-18 First issue 1 2011-02-04 New Revision: 1.7 changed, 2.2 changed, 2.3

changed, 2.4 changed, 2.5 changed, 3.1 changed, 3.2 changed, 3.3 changed, 3.4.1 changed, 3.4.1.1 changed, 3.4.2 changed, 3.4.3 added; 3.4.3.1 added

Page 9: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 9 of 72

2. SRManagerTool Setup

2.1. Connecting to SRManagerTool 1. Connect the Board to the PC via the RS-232 connector with the serial cable 2. Connect the power supply to the board with the power supply

Fig. 2-1

SR Module

Page 10: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 10 of 72

2.2. SR Modules

Fig. 2-2

9V battery location

AC/DC Block connector

subD-9 serial connector

-ZE50/ZE60 -ZE51/ZE61

Power ON/OFF

Page 11: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 11 of 72

Fig. 2-3

-TinyOnePro -TinyOneLite -ME50-868 -LE50-868

9V battery location

AC/DC Block connector

subD-9 serial connector

PROG Switch

Page 12: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 12 of 72

2.3. Downloading Go to the Telit DownloadZone http://www.telit.com/en/products/download-zone.php and download the file:

TelitSRManagerToolInstaller.exe

2.4. System Requirements Windows XP 32 or 64-bit version, Windows Vista 32 or 64-bit version, Windows Seven 32 or

64-bit version

Microsoft .NET Framework 3.5 SP1 or later.

2.5. Installation SRManagerTool is a Windows application. It is compatible with Windows XP, Windows Vista, Windows Seven.

In order to install SRManagerTool on your computer:

1. Run the file TelitSRManagerToolInstaller.exe

2. Choose the folder where to install the Tool:

Fig. 2-4

Click Extract

Page 13: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 13 of 72

3. In the folder chosen will appear:

the folder TelitSRToolSetup(32-bit) or TelitSRToolSetup(64-bit) related to the OS version installed in the PC

the file TelitSRToolSetup.exe that is the 7zip file of the folder TelitSRToolSetup(32-bit)/(64-bit)

4. In the folder TelitSRToolSetup(32-bit)/(64-bit) will be present following folders:

The folder SRManagerTool that contains the executable SRManagerTool.exe, the library to manage the flashing SrSerialFlash.dll and the folder ConfigTool containing the xml files used by configuration wizard in order to check the accuracy of values inserted by the user for MeshLite and ZigBee technology/platform.

The SRManagerTool.exe does not need any installation.

The folder WindowsInstaller(32-bit)that contains the installer for the network packet analyzer Wireshark valid for 32-bit x86 processors or the folder WindowsInstaller(64-bit) that contains the installer for the network packet analyzer Wireshark valid for 64-bit AMD64/x86-64 processors

Do not move or change the file SrSerialFlash.dll and the folder ConfigTool

5. In order to install Wireshark run the related installer: wireshark-win32-1.4.0.exe or wireshark-win64-1.4.0.exe. Follow the instructions in the link: http://www.wireshark.org/docs/wsug_html_chunked/ChBuildInstallWinInstall.html

Page 14: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 14 of 72

3. SRManagerTool Description

SRManagerTool is the PC software developed by Telit in order to flash and manage SR modules and to analyze SR networks.

3.1. Execution Run SRManagerTool.exe

Fig. 3-1

Choose the technology to apply: ZigBee, MeshLite, WM-Bus or S-One

Then choose the Tool to apply

Page 15: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 15 of 72

3.2. Flashing The Flashing window collects the following information:

Platforms: different platforms for different technology are displayed

COM Port: serial port to use in order to connect the SR module to the PC

Firmware: the firmware file to flash in the SR module

Fig. 3-2

Select the right platform

Select the COM port

Browse and select the firmware file related to the technology:

MeshLite/platform Tiny Mesh:

DV.M0A.03.11-RC2.s19

DV.M1A.03.11-RC2.s19

Page 16: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 16 of 72

ZigBee:

platform ZE50/60, Stack ZB2007

EH.W00.11.53-B002-Coordinator.s28

EH.W01.11.53-B002-Router.s28

EH.W02.11.53-B002-EndDevice.s28

platform ZE51/61, Stack ZBPRO

FS.X00.11.00-B001.s28

FS.X01.11.00-B001.s28

FS.X02.11.00-B001.s28

MBUS:

platform Tiny WM-Bus:

DX.U00.01.02.s19

platform ME50:

GD.U00.01.00-B003.hex

GC.U00.01.01.hex (except for features described in document [7] section 2.6, 4.5 and 5)

SOne:

platform LE50:

GC.S00.01.01.hex

Power the SR board OFF (SW2) (see section 2.2) Connected the SR board to the serial COM Port Turn the programming switch ON (SW4) on the SR board (see section 2.2) Power the SR board ON (SW2) (see section 2.2) Click the Flashing button

Page 17: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 17 of 72

Fig. 3-3

Fig. 3-4

Page 18: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 18 of 72

A Pop up will show when flashing is finished.

Fig. 3-5

Click OK

Fig. 3-6

Click Close button in order to return to the Main Window

Click Close button in order to close the SRManagerTool

Flashing is a critical feature that may lead to unexpected behaviour if wrong firmware is flashed.

Page 19: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 19 of 72

3.2.1. Multiple Flashing Sessions The SRManagerTool allows multiple flashing sessions.

You can use the Flashing Tool until you have COM Ports available.

Fig. 3-7

Page 20: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 20 of 72

Fig. 3-8

Fig. 3-9

Page 21: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 21 of 72

For any flashing session a pop up will show when the flashing is finished

Fig. 3-10

Fig. 3-11

Page 22: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 22 of 72

The main Window will have the Close button not enabled until there is a Window alive

Fig. 3-12

Page 23: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 23 of 72

3.3. Analyzer The Analyzer window collects the following information:

Serial Port: serial port where is connected the SR Hardware Sniffer

Analyzer: the path where is installed the Wireshark analyzer

Analyzer is not available for technology SOne/platform LE50.

If the technology is MeshLite the Sniffer window is the following:

Fig. 3-13

Page 24: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 24 of 72

If the technology is ZigBee the Sniffer window collects also:

Radio Channel: radio channel of the ZigBee network to analyze

Manufacturer: the captured device used

Fig. 3-14

Page 25: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 25 of 72

If the technology is WM-Bus the Sniffer window collects also:

Mode: Mode of operation

Radio Channel: radio channel used only in case operating mode is R2

Fig. 3-15

Page 26: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 26 of 72

Once fixed the technology follow these steps:

Select the Serial Port

Browse and Select the Analyzer path

Select the Radio Channel, Mode and type of captured device if needed

ZigBee technology:

Fig. 3-16

Page 27: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 27 of 72

MeshLite technology:

Fig. 3-17

Be careful to select the Serial Port where the SR Hardware Sniffer is really connected, SRManagerTool can not check it and it leads to no packet captured.

Page 28: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 28 of 72

M-Bus technology:

Fig. 3-18

Page 29: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 29 of 72

Related to the technology, the right SR Hardware Sniffer has to be connected to the serial port selected in the Sniffer Window. SR Captured Devices:

ZigBee Technology:

In order to analyze a ZigBee Network with ZB2007:

Freescale Sniffer:

plug in the USB port the Freescale 1322X USB dongle.

If needed install drivers supplied in the Freescale CD

Telit Sniffer:

use the SRToolManager in order to flash a Telit module ZE50/ZE60 with the firmware EH.WS5.11.50-B001.s28 (See section Flashing).

When the module is flashed: o Switch the SR board OFF (SW2). o Turn the programming switch OFF (SW4) on the SR board. o Switch the SR board ON (SW2).

In order to analyze a ZigBee Network with ZBPRO:

Freescale Sniffer:

plug in the USB port the Freescale 1322X USB dongle.

If needed install drivers supplied in the Freescale CD

Telit Sniffer:

use the SRToolManager in order to flash a Telit module ZE51/ZE61 with the firmware FS.XS5.11.00-B001.s28 (See section Flashing).

When the module is flashed: o Switch the SR board OFF (SW2). o Turn the programming switch OFF (SW4) on the SR board. o Switch the SR board ON (SW2).

Page 30: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 30 of 72

MeshLite: use the SRToolManager in order to flash a Telit module TinyOnePro with the

firmware: TransparentSnifferTinyProBoard.s19 (See section Flashing). When the module is flashed:

o Switch the SR board OFF (SW2). o Turn the programming switch OFF (SW4) on the SR board. o Switch the SR board ON (SW2).

MBus:

use the SRToolManager in order to flash a Telit module TinyOneLite with the firmware: SnifferMBus_Board.s19 (See section Flashing). This Sniffer can be used for sniffing packets in a WMBus Network/Platform TinyOneLite as well as for sniffing packets in a WMBus Network/Platform ME50.

When the module is flashed: o Switch the SR board OFF (SW2). o Turn the programming switch OFF (SW4) on the SR board. o Switch the SR board ON (SW2).

Click Start

The SRManagerTool make use of the original Wireshark, network protocol analyser (Stable Release 1.4.0) downloaded from:

http://www.wireshark.org/download.html.After some seconds will appear the Wireshark analyzer

Page 31: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 31 of 72

Fig. 3-19

Page 32: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 32 of 72

ZigBee Technology: This is an example of ZigBee traffic:

Fig. 3-20

More information about the dissector can be found at the link: http://wiki.wireshark.org/IEEE_802.15.4

Page 33: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 33 of 72

During capturing packets process the user can stop capturing process and save for example into a captured file. To start another capturing packets process, Close Wireshark analyzer and Start another session from SRManagerTool.

SR Tools Analyzer does not detect an Acknowledge frame related to a long size data frame (len >= 80 Bytes) when Network Security is enabled and Telit Sniffer is used

SR Tools Analyzer does not detect a long size data frame (len >= 80 Bytes) when

Network Security is enabled and Freescale Sniffer is used.

Page 34: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 34 of 72

MeshLite Technology:

This is an example of MeshLite traffic:

Fig. 3-21

At the moment for MeshLite technology we are using Wireshark with no dissector, for this reason all raw RF packets in the network are displayed.

Page 35: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 35 of 72

During capturing packets process the user can stop capturing process and save for example into a captured file. To start another capturing packets process, Close Wireshark analyzer and Start another session from SRManagerTool.

Page 36: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 36 of 72

WM-Bus Technology:

This is an example of WM-Bus traffic:

Fig. 3-22

At the moment for WM-Bus technology we are using Wireshark with no dissector, for this reason all raw RF packets in the network are displayed.

Page 37: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 37 of 72

During capturing packets process the user can stop capturing process and save for example into a captured file. In order to start a capturing packets process, Close Wireshark analyzer and Start another session from SRManagerTool.

Page 38: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 38 of 72

3.4. Management The window Management is specific for the technology chosen.

The Management feature may lead to change critical parameters for normal behaviour.

3.4.1. Management of MeshLite Technology In order to use the Management features you have to select Serial Protocol information:

Serial Port: serial port where is connected the SR Module

Stuffing or Timeout protocol

Enable Flow Control

Page 39: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 39 of 72

In order to perform a commissioning session, connect the MeshLite module to the selected

serial port and put the module in configuration mode as follow: o Switch the SR board OFF (SW2). o Turn the programming switch OFF (SW4) on the SR board. o Switch the SR board ON (SW2) o Turn the programming switch ON (SW4) on the SR board.

In Configuration mode relating to ASCII commands the types DATA, PING and IO are not managed.

In order to use the terminal to send/receive data/command from/to the network, put the

module in working mode and put it into a MeshLite network (in the Management Window for ASCII command the types DATA, PING and IO are managed).

In working mode relating to ASCII commands the types DATA, PING and IO are managed.

Be care to select the Serial Port where the MeshLite module is really connected, SRManagerTool can not check it and it leads to no communication.

Once fixed the Serial Protocol Information and connected the module click the button Connect in order to connect to the Module.

Page 40: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 40 of 72

The previous window allows to send/receive Hex or ASCII commands to/from the MeshLite module.

In order to use correctly the Window, the right protocol must be selected.

The Stuffing Protocol waits for 0xAB at the start of the command and 0xCD at the end of the command.

The Timeout Protocol waits for 0x65 or 0x6E or 0x69 or 0x6B at the start of the command and 0x0D at the end of the command.

Select the Command Type

Page 41: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 41 of 72

If the Command Type selected is HEX:

fill the Raw command field to send.

If the Command Type selected is ASCII:

select the Type

fill the Recipient and Data fields to send

Click the button Send

You can read responses from module in the Text Box

For example:

Page 42: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 42 of 72

Starting from this window the user can open the configuration wizard clicking the button Configuration Wizard or disconnect from the MeshLite module clicking the button Disconnect (for example to select another Serial Protocol)

Page 43: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 43 of 72

3.4.1.1. MeshLite Configuration Wizard

The Configuration wizard allows configuring and reading registers of the TinyOne Pro modules/terminals with 32 kB flash memory and AllInOne Mesh firmware. The selection of one of the three module behaviours (end point, router, and coordinator) is possible at configuration time. It is not necessary to flash the module to switch from a behaviour to another since it’s all integrated in a unique firmware.

In order to configure correctly the AllInOne module it has to be in Configuration Mode (Prog switch ON).

In order to verify the accuracy of data written by the user in every textbox the tool needs a specific XML file. This file is closely linked together with the Mesh Lite firmware version. The files are provided by Telit and are stored in the folder ./ConfigTool/Mesh and the name of each file is composed in this way: Info_ML_<Maj>_<Min>.xml, where Maj and Min are the major and minor number of Mesh firmware version.

i.e.: if the firmware version is DV.M0A.03.112 the xml file name will be Info_ML_03_11.xml.

The user shall not modify the xml files; if the file is not present or corrupted the SRManagerTool returns a caution popup. In the future, when a new firmware version will be available, Telit will make available a new XML file for the SR Tool and the user will take care to put it in the correct folder. If the module is not connected to the selected serial port or it is not responding, the configuration wizard won’t start and it will show an error popup.

When the Configuration Wizard is started it shows the factory values

The values in the window have not been read from the module

Page 44: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 44 of 72

The button Apply All allows to configure registers with desired values, after filling the different fields and selecting the radio buttons, click on the button Apply All to configure the module:

If the Serial Protocol applied with Configuration Wizard is different from the previous selected in the Window Management (for example in Configuration Wizard is selected Stuffing protocol and in the Window Management was selected Timeout protocol or vice versa) after Apply All the user should close the Configuration Wizard, Disconnect from the module and then Connect to the module with the Serial protocol just applied. Otherwise the Management Tool can not communicate with the module.

Page 45: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 45 of 72

Page 46: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 46 of 72

The button Refresh Values allows to read registers value from the module

The button Restart Module leads to send ATO command to the module

The button Default Values leads to send ATR command: using this command it is possible to restore a great part of register default values; the difference with ATF command is that the module type will be not changed and the default values depend on the module type. If a module used as Coordinator receives the command

Page 47: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 47 of 72

ATR, restore all the default values but module type continues to have the value equals to 2 and the Client ID will be not changed (0xFF,0xFF). For the other module types the module type (register 306) does not change but the Client ID becomes 0x30, 0x30.

After sending this command it is mandatory to perform a module reboot clicking the button Restart Module, then clicking the button Refresh Values to read registers value from the module.

The button Factory Values leads to send the Hayes command ATF. The Hayes command ATF allows user restoring the “Factory” settings. It means that module type becomes 0x00, Network ID is 0x30, Client ID is 0x30, 0x30, and so on.

After sending this command it is mandatory to perform a module reboot clicking the button Restart Module, then clicking the button Refresh Values to read registers value from the module.

The button Load From File allows to configure registers with values stored in a configuration file (see for example MeshLite_Coordinator_Config_Default.txt, MeshLite_Router_Config_Default.txt, MeshLite_EndDevice_Config_Default.txt, MeshLite_AllType_Config_Factory.txt). After loaded the file click the button Apply All in order to set effectively the values.

The button Save To File allows to save the values present in the window in a file (for example in order to save a specific configuration).

Page 48: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 48 of 72

3.4.2. Management of WM-Bus Technology In order to use the Management features you have to select Serial Protocol information:

Serial Port: serial port where is connected the SR Module

Baudrate: the speed of the serial port (19200 bits/s default)

Enable Flow Control

Serial Wakeup

Connect the WM-Bus module to the serial port selected:

o Switch the SR board OFF (SW2). o Turn the programming switch OFF (SW4) on the SR board.

Page 49: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 49 of 72

o Switch the SR board ON (SW2).

Once fixed the Serial Protocol Information and connected to the module click the button Connect in order to connect to the WMBus Module.

The previous window allows to send Hex or ASCII commands to the MBus module:

Select the Command Type

If the Command Type selected is HEX:

fill the Raw Data field to send.

Page 50: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 50 of 72

If the Command Type selected is ASCII:

fill the Data field to send

Click the button Send

You can read responses from the module in the Text Box

For example:

Starting from this window the user can open the configuration wizard clicking the button Configuration Wizard or disconnect from the WM-Bus module clicking the button Disconnect (for example to select another Serial Protocol)

Page 51: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 51 of 72

3.4.2.1. WM-Bus Configuration Wizard

The Configuration wizard allows configuring and reading registers of the TinyOne Lite 868 MHz and ME50 868MHz modules.

When the Configuration Wizard is started it shows the default values.

The values in the window have not been read from the module

Radio Output Power +13dBm stands for +14dBm (available for ME50-868)

Page 52: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 52 of 72

The button Apply All allows to configure registers with desired values, after filling the different fields and selecting the radio buttons, click on the button Apply All to configure the module.

Page 53: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 53 of 72

The button Refresh Values allows to read registers value from the module.

The button Restart Module leads to send ATO command to the module.

Page 54: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 54 of 72

After the ATO command the user shall reconnect to the module in order to continue the configuration, otherwise the module is in operating mode.

The button Default Values leads to send ATR command: using this command it is possible to restore all parameters to their default values. After ATR command click button Refresh Values in order to refresh the window with default values read from the module.

The button Load From File allows to configure registers with values stored in a configuration file (see for example MBus_Default.txt). After loaded the file click the button Apply All in order to set effectively the values.

The button Save To File allows to save the values present in the window into a file (for example in order to save a specific configuration).

3.4.3. Management of S-One Technology In order to use the Management features you have to select Serial Protocol information:

Serial Port: serial port where is connected the SR Module

Baudrate: the speed of the serial port (19200 bits/s default)

Enable Flow Control

Page 55: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 55 of 72

Connect the S-One module to the serial port selected:

o Switch the SR board OFF (SW2). o Turn the programming switch OFF (SW4) on the SR board. o Switch the SR board ON (SW2).

Once fixed the Serial Protocol Information and connected to the module click the button Connect in order to connect to the S-One Module.

Page 56: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 56 of 72

The previous window allows to send Hex or ASCII commands to the S-One module:

Select the Command Type

If the Command Type selected is HEX:

fill the Raw Data field to send.

If the Command Type selected is ASCII:

fill the Data field to send

Click the button Send

You can read responses from the module in the Text Box

For example:

Page 57: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 57 of 72

After sent the ASCII command ATO, before Disconnect the module send the command +++

Starting from this window the user can open the configuration wizard clicking the button Configuration Wizard or disconnect from the S-One module clicking the button Disconnect (for example to select another Serial Protocol)

Page 58: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 58 of 72

3.4.3.1. S-One Configuration Wizard

The Configuration wizard allows configuring and reading registers of the LE50-868 MHz modules.

When the Configuration Wizard is started it shows the default values.

The values in the window have not been read from the module

Page 59: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 59 of 72

The button Apply All allows to configure registers with desired values, after filling the different fields and selecting the radio buttons, click on the button Apply All to configure the module.

Page 60: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 60 of 72

The button Refresh Values allows to read registers value from the module.

The button Restart Module leads to send ATO command to the module.

After the ATO command the user shall reconnect to the module in order to continue the configuration, otherwise the module is in operating mode.

The button Default Values leads to send ATR command:

Page 61: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 61 of 72

using this command it is possible to restore all parameters to their default values. After ATR command click button Refresh Values in order to refresh the window with default values read from the module.

The button Load From File allows to configure registers with values stored in a configuration file (see for example SOne_Default.txt). After loaded the file click the button Apply All in order to set effectively the values.

The button Save To File allows to save the values present in the window into a file (for example in order to save a specific configuration).

Page 62: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 62 of 72

3.4.4. Management of ZigBee Technology In order to use the Management features you have to select Serial Protocol information:

Serial Port: serial port where is connected the SR Module

the speed of the serial port is 115200 bits/s

Connect the ZigBee module to the serial port selected:

o Switch the SR board OFF (SW2). o Turn the programming switch OFF (SW4) on the SR board. o Switch the SR board ON (SW2).

Page 63: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 63 of 72

Once fixed the Serial Protocol Information and connected to the SR module click the button Connect in order to connect to the ZigBee Module.

The previous window allows to send Hex commands to the ZigBee module.

At the moment the Hex commands have to follow the general format:

With the exception of the command ‘+++’ (0x2b 0x2b 0x2b) that can be sent by this window.

Frame Length (1 Byte) Command (1 Byte) Payload (Variable)

Page 64: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 64 of 72

fill the Raw Data field to send.

Click the button Send

You can read responses from the module in the Text Box.

For example:

Starting from this window the user can open the configuration wizard clicking the button Configuration Wizard or disconnect from the ZigBee module clicking the button Disconnect (for example to select another Serial Protocol)

Page 65: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 65 of 72

3.4.4.1. ZigBee Configuration Wizard

The Configuration Wizard allows configuring and reading registers of the ZE50/ZE60 and ZE51/ZE61 (Coordinator, FFD, RFD) modules.

In order to verify the accuracy of data written by the user in every textbox the tool needs a specific XML file. This file is closely linked together with the ZigBee stack version and stack type. The files are provided by Telit and are stored in the folder ./ConfigTool/ZigBee and the name of each file is composed in this way: Info_ZB_<Type>_<Maj>_<Min>.xml, where Maj and Min are the major and minor number of stack version and Type is the stack type (PRO or 2007)

i.e.: if the stack version is EH.Z02.01.05-B002 the xml file name will be Info_ZB_2007_01_05.xml, where the 2007 type is caused by the ‘0’ after the ‘Z’ in the stack version string; if after the ‘Z’ there is a ‘1’ the firmware type will be PRO.

The user shall not modify the xml files; if the file is not present or corrupted the SRManagerTool returns a caution popup. In the future, when a new firmware version will be available, Telit will make available a new XML file for the SR Tool and the user will take care to put it in the correct folder. If the module is not connected to the selected serial port or it is not responding, the configuration wizard won’t start and it will show an error popup.

When the Configuration Wizard is started it shows the default values.

The values in the window have not been read from the module

Page 66: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 66 of 72

Coordinator:

Page 67: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 67 of 72

RFD:

Page 68: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 68 of 72

FFD:

Page 69: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 69 of 72

The button Apply All allows to configure registers with desired values, after filling the different fields and selecting the radio buttons, click on the button Apply All to configure the module.

Page 70: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 70 of 72

The button Refresh Values allows to read registers value from the module.

The button Hard Reset leads to restore default values.

After Hard Reset the user should reconnect to the module in order to continue the configuration.

The button Soft Reset leads to disconnect of the network.

Page 71: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 71 of 72

After Soft Reset the user should reconnect to the module in order to continue the configuration.

The button Start Network leads to start the network or to associate the device to the network.

The button Load From File allows to configure the module with values stored in a configuration file (see for example Coordinator_Default.Config.txt, FFD_Default_Config.txt, RFD_Default_Config.txt, Coordinator_Config.txt, FFD_Config.txt, RFD_Config.txt). After loaded the file click the button Apply All in order to set effectively the values.

The button Save To File allows to save the values present in the window into a file (for example in order to save a specific configuration).

At the moment due to a limitation on the SR firmware the following attributes are not managed: Bootloader Version and Application Version.

Page 72: Telit SR Manager Tool User Guide r1

SR Manager Tool User Guide 1vv0300899 Rev1 – 2011-02-04

Reproduction forbidden without written authorization from Telit Communications S.p.A.- All Rights Reserved. Page 72 of 72

4. ACRONYMS AND ABBREVIATIONS

SR: Short Range WM-Bus: Wireless M-Bus