gp p202 um 00597 starter kit user manual

7/25/2019 GP P202 UM 00597 Starter Kit User Manual

1/16

Starter Kit User ManualDocument GP_P202_UM_00597

27 August 2008

Lindestraat 199240 Zele,BelgiumTel +32 (0) 52 45 87 20

Catharijnesingel 303511 GB Utrecht ,The NetherlandsTel +31 30 262 1157

[email protected]

GreenPeak Technologies 2008 GP_P202_UM_00597_Starter_Kit_User_Manual Page 1

GREENPEAK STARTER KITUSER MANUAL


2/16



TABLE OF CONTENTS1 Overview ................................................................................................................... 4 2 Preparing the PeakNodes ............................................................................................ 5

2.1 Powering up the PeakNodes ................................................................................ 5 2.2 PeakNet Association ........................................................................................... 6 2.3 IO connections ................................................................................................... 6

2.3.1 Technical spec IO ........................................................................................... 6 2.3.2 Important remark ........................................................................................... 6

3 GreenPeak Starter Kit Application ................................................................................ 7 3.1 Installation ......................................................................................................... 7 3.2 First Usage......................................................................................................... 7

3.2.1 Connection Settings ........................................................................................ 7

3.2.2 Starter Kit Application ..................................................................................... 9 3.3 Starting a network ............................................................................................ 10 3.4 JadeMonitor ..................................................................................................... 11 3.5 IO Section ........................................................................................................ 12 3.6 Using the Mesh Network ................................................................................... 14 3.7 PeakNet LPR vs. PeakNetZ ................................................................................ 15

4 The JadeConfigurator tool ......................................................................................... 16 5 Next steps ............................................................................................................... 16

DOCUMENT HISTORYdate version author noteJul 07 2005 4.1 Niek Van Dierdonck First releaseOct 25 2005 4.2 Wim De Kimpe Update for Ubiwave Starter Kit Release 2

Aug 11 2006 4.2b Kristoff Avermaete Adaptation to GPSK2 without UTIDec 11 2006 4.3 Kristoff Avermaete Update for Ubiwave Starter Kit Release 3Mar 08 2007 4.4 Kristoff Avermaete Standard source code distributionSep 05 2007 4.5 Bart Jonkers Update new Starter kit PC applicationOct 30 2007 4.6 Wim Van Houcke Introduced DB03 hardwareMay 9 2008 4.7 Tim Allemeersch Minor changesJune 9 2008 4.8 Tim Allemeersch Updated to new document numbering

August 26 2008 4.9 Tim Allemeersch Update to CM09 stack v1.5.0.1

REFERENCED DOCUMENTS

[1] PeakNet Serial Protocol Starter Kit, GreenPeak Technologies, June 2008,doc# GP_P202_IS_00627

[2] GP-DB-03 Hardware Description, GreenPeak Technologies, June 2008,doc# GP_P202_HD_00641


3/16



[3] JadeConfigurator User Manual, GreenPeak Technologies, June 2008,doc# GP_P202_HD_00626

[4] Portserver TS 8/16 serial-to-network connectivity (http://www.digi.com/ )
http://www.digi.com/products/serialservers/portserverts816.jsphttp://www.digi.com/products/serialservers/portserverts816.jsphttp://www.digi.com/products/serialservers/portserverts816.jsphttp://www.digi.com/products/serialservers/portserverts816.jsp


4/16



1 OverviewThis manual describes the GreenPeak Starter Kit (GPSK) and how to use the Starter Kit PC

application. All modules in a Starter Kit or Development Kit Enterprise come pre-flashed withthis application.

The GPSK PC application included in the Starter Kit and Development Kit Enterprise enablesthe customer to experience the power of wireless sensor networks and explore an exampleapplication in a matter of minutes. It displays the self-healing and self-organizing aspect ofthe GreenPeak communication stack, gives you the ability to evaluate PeakNet Z and PeakNetLPR (low-power routing), and helps you understand wireless mesh networking. However, theGreenPeak Starter Kit does not enable you to build a custom application on top of theGreenPeak communication stack. This feature is only included in the development kits.

The GreenPeak Starter Kit comprises of 5 wireless modules, a PC demo application

(GreenPeak Starter Kit application) which demonstrates both the network aspects and someof the IO functionality of the wireless mesh network ( cf. figure below ), a serial cable,batteries, a DC power adapter, and documentation.

PeakNode

PeakNode

PeakNode

PeakNode

PeakCoordinator /Serial Getaway

JadeMonitor

Serial Cable

Figure 1-1: GreenPeak Starter Kit overview

PeakNet Z or PeakNet LPR, the communication protocol running on all the wireless nodes,implements a full wireless mesh-network with self-forming, self-healing properties.

The Serial Gateway (coordinator) connects to a PC running the GPSK pc application, through aserial RS232 connection. For users who want to by-pass the complete API, the serial protocolrunning over this connection is described in a separate document[1]. This document is onlyincluded in the development kit, and not in the starter kit!

The remainder of this document will describe how to install the PC application, and how touse it to evaluate GreenPeaks communication stacks and hardware.


5/16



2 Preparing the PeakNodesThis chapter will describe how to power the PeakNodes, and how to understand the status

LEDs on the PeakNode. It will also describe the available IOs in the Starter Kit application.

2.1 Powering up the PeakNodes A Power source should be connected to the PeakCoordinator and PeakNodes. You maychoose to use batteries, and place three AAA batteries in the battery compartment of themodules. The battery compartment is accessed by unscrewing the screws on the back of thehousing. Alternatively the modules can be powered by connecting a 2,1mm DC jack to theside of the modules. Voltages between 3.5V and 6V can be applied. Centre is +, sleeve is -.We refer to [2] for more information on the power options.

*** Important Notice : When using a DC power adapter when batteries are installed in the

battery compartment, always use a 2.1mm jack. Otherwise, batteries might explode orleak.***

After connecting a power source, the module is powered on by moving the power switchtowards the DC jack as shown in the figure below.

On

Figure 2-1: Connectors GreenPeak Starter Kit Module


6/16



2.2 PeakNet AssociationWhen a PeakNode is powered, it will automatically search for a PeakCoordinator (Gateway) to

associate to. The Status LEDs of a PeakNode depict the association status and have thefollowing meaning:

Colour StatusRed The node is powered up (but not necessarily associated to a Gateway).Green The node is associated to a Gateway.

When the node has successfully joined a network, and you are using PeakNet Z, the red andgreen leds will be on. If you are using PeakNet LPR as communication stack, the red andgreen led blink periodically after the PeakNode has successfully joined a network. Each timethe red and green led blink, the module wakes up.

If only the green led is on, this means the booloader is running. If the green led is blinking,an error occurred and the module stopped working correctly.

2.3 IO connectionsEach PeakNode is factory configured with the following inputs and outputs:

2 digital outputs driving the orange User LEDs (3.3V logic)

2 digital inputs with internal pull-up resistor connected to the two user switches.

1 NTC temperature sensor

1 serial port

All inputs are sampled at 1 Hz sample rate. We refer to the hardware description [2] foradditional information on the available IOs.

2.3.1 Technical spec IO

Colour StatusDigital output maximal output current 4mADigital output nominal voltage 3,3VMinimum pull up resistance digital input 20kOhm

Serial Port Settings 9600 baud, 8 databits, 1 stopbit, no parity, no flow control

2.3.2 Important remark

The RS232 line driver will automatically shut down if no valid RS232 level is seen on the serialdata input, e.g. when no device is connected.


7/16



3 GreenPeak Starter Kit ApplicationThe GreenPeak Starter Kit comes pre-flashed with an application allowing you to sample the

IOs on the PeakNodes in the network. A PC application, giving you an overview of thenetwork topology, and the ability to remotely sample and set the IOs of the PeakNodes, isincluded.

When powered up, the PeakNodes automatically associate to the PeakCoordinator. In theGreenpeak Starter Kit, this coordinator also functions as a serial gateway; it allows you toaccess the remote nodes in the network from a PC connected to the coordinator module. TheJadeMonitor (as part of the Starter Kit PC application) gives an overview of the entire networkwhen connected physically to this gateway/coordinator. It provides the user with a real-timegraphical view of the network topology. The network intelligence of PeakNet, however, is notembedded in the JadeMonitor but rather in the coordinator module and the PeakNodes. Thismeans that the network can run stand-alone, without attaching a PC to the

gateway/coordinator module.

The IO part of the PC application displays the available digital and analog inputs on theremote nodes, and enables control of the digital outputs of the PeakNodes.

Next, this section will describe how to install this PC application, and how to use it.

3.1 InstallationSystem requirements:

Supported Operating Systems: Windows 2000, Windows 98, Windows ME,

Windows NT, and Windows XP (Microsoft Windows NT 4.0 requires Service Pack

6a). Currently, Windows Vista compatibility is being tested.

Physical connection: RS232 serial connection to the gateway

Start the installation process by running the installer: execute GPSK_Vx.x.x.x.msi found in the Tools directory of the software package. An installation wizard will start and guide youthrough the installation procedure. If the .NET Framework was not installed on your PC, errormessages indicating you must install it will pop-up. If needed 1, the Microsoft .NET Framework

Version 2 Redistributable Package can be downloaded from http://www.microsoft.com/ .

3.2 First Usage

3.2.1 Connection Settings

After installation, start the GPSK application by selecting its shortcut (GreenPeak Starter Kit) in the GreenPeak folder in the Windows start menu.

1 The framework is needed by the application; if the .Net framework is already installed, or if the .Netdevelopment environment is installed , then this step can be skipped
http://www.microsoft.com/downloads/details.aspx?FamilyID=0856eacb-4362-4b0d-8edd-aab15c5e04f5&displaylang=en%20)%20)http://www.microsoft.com/downloads/details.aspx?FamilyID=0856eacb-4362-4b0d-8edd-aab15c5e04f5&displaylang=en%20)%20)http://www.microsoft.com/downloads/details.aspx?FamilyID=0856eacb-4362-4b0d-8edd-aab15c5e04f5&displaylang=en%20)%20)http://www.microsoft.com/downloads/details.aspx?FamilyID=0856eacb-4362-4b0d-8edd-aab15c5e04f5&displaylang=en%20)%20)


8/16



Figure 3-1: The connection settings windowThe Connection settings window will appear as displayed in Figure 3-1 . The Connectionsettings window allows you to configure the connection to the gateway. The differentconnection types and their options are:

TcpClient: To connect to the TCP/IP gateway when the gateway acts like a TCP

server.

hostName: the host name or IP address of the gateway

portNumber: the TCP port number on which the gateway server listens

TcpServer: To start a TCP/IP server where the TCP/IP gateway can connect on

when it acts like a client.

portNumber: the TCP port number where the server should listen on.

Serial: To connect to the Serial Gateway through a serial port on your computer.

serialPort: The serial port on your computer that you use to connect to

the Serial Gateway.

baudrate: The baudrate that is used in the communication with the Serial

Gateway. Currently the Serial Gateway uses 9600 baud.

DigiClient: This setting is used to connect the Serial Gateway through a Digi

PortServer [4] to your computer.

hostName: the host name or IP address of the Digi PortServer

serialPortNumber: the number of the serial port on the Digi PortServer

baudrate: The baudrate that is used in the communication between the

Serial Gateway and the Digi PortServer. Currently the Serial Gateway

uses 9600 baud.

Select the settings that apply for you. For the starter kit in most cases this is Serial, COM1and 9600.


9/16



3.2.2 Starter Kit Application

After configuring the connection settings, press OK to apply the settings and start the

application. A screen similar as shown in Figure 3-3 is started. This PC application is dividedinto two main parts. The left s ide controls and displays the IO s of the nodes in the network,while the right side displays the network topology and links between the PeakNodes(JadeMonitor).

The next sections will discuss how to use this PC application to see the network topology,

*** Important remark: when you use a firewall on your computer, it might generate awarning when you launch the PC application. You have to prevent your firewall from blockingthe GPSK application by choosing Unblock in the pop -up screen.***

Figure 3-2: Windows XP firewall popup


10/16



Figure 3-3: GreenPeak Starter Kit main screen

3.3 Starting a networkIn the previous paragraph, we discussed how the PC application is installed, and how it isstarted. Next, we will discuss how you can build your first PeakNet network, and use the PCapplication to set and get the IOs from the nodes associated in the network .

Attach the delivered serial RS232 cable to the PC and to the gateway/coordinator

module.

Start the GPSK application as described in 3.2. If the gateway is already up and

running, the JadeMonitor will attach to it and show the presence of the

PeakCoordinator. Otherwise the JadeMonitor will attach to the PeakNet as soon

as it is powered on.

Power the other PeakNodes and they will automatically attach to the network and

show up in the JadeMonitor.

The next sections will further describe the different fields in the PC demo application.


11/16



3.4 JadeMonitorThe JadeMonitor shows the network connection of each PeakNode.

Figure 3-4 JadeMonitor part overviewEach node (Gateway and PeakNodes) is represented in the graphical window by a rectangle,showing the nodes identification number (ID). A coordinator always uses identificationnumber 0x0001.

The lines between the nodes indicate the existence of a wireless communication path. Thelinks represent all possible connections between the nodes, most often presenting manypossible routes from a source node to a destination node over intermediate nodes. The actualroute used to send packets from a node towards the coordinator is highlighted when clickingon a node (it may take a while before the path is highlighted). PeakNet will automaticallyselect a reliable route through the network. It will choose a route based on the link strength,congestion on the link, and hops from coordinator to evenly spread network traffic among the

routers.

The user has the option to insert a background picture (for instance a blueprint of thebuilding) by go ing to the JadeMonitor menu in the Options menu. After choosing abackground, the PeakNodes can be moved to a position that represents their physical locationby simply dragging and dropping them in to the correct position.

In the JadeMonitor men u, one can define which route is shown when a node is clicked: thetwo possibilities are upstream (to the coordinator) or downstream (from coordinator to node).One can also choose to give a link quality indication by showing the RSSI values of thedifferent links in the network.


12/16



3.5 IO Section A screenshot of the IO section is shown below.

Figure 3-5 IO part overview

The IO section contains a number of fields:

ID: displays the application ID of the node. When you hover your mouse over

this field, you will see the 64-bit MAC address of the node. The coordinator hasapplication ID 0x0000.

Temp: When using the communications module combined with the GP-DB-03

development board [2] (default in the starter kit), this field displays the ambient

temperature picked up by the NTC temperature sensor. When no sensor is

applied, the readout value is undefined;

Digital In: the state of this button represents the state of the user switches on

the modules. When a switch on a remote module is pressed, the state of this

button will change. We refer to [2] for additional information on the position ofthe user switches on the GP-DB-03 development board.


13/16



Digital Out: by clicking on the check boxes, digital out 0 resp. 1 is toggled on the

PeakNode with the corresponding MAC address. By default the corresponding

digital outputs are connected to the user LEDs of the starter kit modules. In this

way the status of these LEDs can be controller in the PC application.

Serial data can be transferred between the PC Demo application and the

connected PeakNodes. This can be controlled by selecting a node in the serial

box of the IO section and typing a text or a hex array followed by enter. The

serial data will be transferred towards the selected PeakNode and reproduced on

the nodes serial port. In the opposite direction a similar mechanism is

implemented. When a serial stream is sent to a PeakNodes serial port, this

stream is transferred towards the PC demo application. The data and its

destination are shown in the serial box of the IO section.

***Important remark: The microcontroller on the module has two UARTS available for serial

communication. Only one of these UARTS is connected to the serial port connector on the DB03

development board. The serial stream sent from the starter kit application data is by default sent to the

UART connected to the DB03 s serial port. The logging is sent on the other available UART, and can

thus not be seen by default when connecting a router to for instance the JadeLogger tool. To be able to

see the logging, y ou can click on the Disabl e button in the Enable Serial IO column in the IO section

of the PC application to wire the UART used for logging to the serial port on the DB03 development

board. When pressing the Enable button, the UART will again be used for forwarding the serial data

that was sent from the PC application.

When the SerialIO is enabled, you can connect a node to a PC using the serial port, and open a

HyperTerminal session. The settings for the session are shown in the figure below. Using the Starterkit

PC application you can now send serial data to that router node. The data is then shown in

HyperTerminal. Typing in HyperTerminal will send the characters to the coordinator. ***


14/16



The temperature chart displays the temperature course of the different nodes. When youright-click on the chart, you get a context menu which you can use to zoom on the chart,print or copy the chart. The temperature values received by the sensors are by defaultdisplayed in degrees Celsius. To switch to degrees Fahrenheit, go to the Options menu andthen choose Temperature Settings. Next, choose Fahrenheit. The temperature is nowdisplayed in Fahrenheit.

The IO section displays also the status of the node. When the node is connected to thenetwork it is displayed normally as shown in Figure 3-5. When a possible failure of a node isdetected, the line of the node is blinking. If the connection to the node could not be restoredthe line of the node is grayed out.

3.6 Using the Mesh NetworkThe Starter Kit has full self-forming, self-healing multi-hop behavior. This behavior can beeasily tested and demonstrated.

By clicking on a node in the GreenPeak PC application the route followed to send packetsfrom the node towards the coordinator is highlighted. If the routing of a certain node followsa multi hop path towards the coordinator, one could power down one of nodes in this routingpath. The PeakNet will notice this change and automatically repair the routing path usingother nodes to get to the coordinator. You can also choose to show the path the coordinatoruses to get to a re mote node by choosing the downstream option in the JadeMonitor menu(Options -> JadeMonitor).

PeakNets self-healing multi-hop behavior is also demonstrated by setting up a network andmoving one node across the demonstration site. It will keep its network association while thelink strength diminishes, until the link disappears, to be re-associated immediately when thenode is brought back into radio distance of any other node. The PeakNode will re-associatewith a node providing a link quality above a preset threshold. This re-association behavior isalso demonstrated by simply resetting or switching on/off the node.


15/16



3.7 PeakNet LPR vs. PeakNetZIn the Starter Kit, you have the choice between 2 types of network stacks, namely PeakNetZ

and PeakNet LPR. By default, the modules come pre-flashed with the PeakNet Z stack. Touse the PeakNet LPR stack, one most use the JadeConfigurator tool to upload this stack tothe modules. The different properties of the stacks are given in figure below.

PEAKNET Z

PeakNet Z is the ideal solution forapplications where some devices haveaccess to mains power and (optionally)other devices operate on batteries. Thenetwork consists of Full FunctionalityDevices (FFD), Reduced FunctionalityDevices (RFD) and one or more NetworkCoordinators.

All FFDs automatically become part of the

wireless mesh networks and take activepart of routing messages. Optionally theyconnect to sensors and actuators. TheRFDs interface to sensors and actuatorsand connect wirelessly to a nearby FFD. Asthey are set in a sleeping-state most of thetime, they consume very little power. TheRFD will not actively route messages forother devices. The Network is self-healingand self-forming and is managed by thecoordinator.

PEAKNET LPR

PeakNet Low Power (LPR) isGreenPeak's breakthrough approach towireless mesh networks. PeakNet LPRdoes not require always-on, mains-powered devices. All devices are low-power and still form a mesh and routemessages through the network.

The low-power routing meshing capabilityis obtained by occasionally waking up the

low power nodes along a synchronizedscheme. Hence devices can pass messagesthrough the network yet at the same timelive years on standard batteries.

Devices can be woken up according to apre-defined schedule, (e.g. the periodicmeasurement of room temperatures in aHVAC application, or when an exception"occurs (e.g. a smoke detector going inalarm), or on a combination of both.

F

C

R

F

F

F

F

R

R

R

R

R

C

F

R

Network Coordinator (C)

Full Functionality Device (FFD)

Reduced Functionality Device (RFD)

L

C

L

L

L

L

L

L

L

L

L L

C

L

Network Coordinator (C)

Low-power Router Device (LRD)


16/16



4 The JadeConfigurator toolThe JadeConfigurator tool enables you to read software/hardware information from a node. It

also enables you to choose your own Pan ID and channel the network will operate on. A finalfeature of the JadeConfigurator is the possibility to change the communication stack fromPeakNet Z to PeakNet LPR.

*** Important note: The JadeConfigurator tool has the option to define which stack to usein the Change stack type field. This field is only valid for the starter kit ! If you havebought a development kit enterprise, you cannot switch to PeakNet LPR using this field. Youwill have to recompile the embedded application, and reprogram the nodes with the newlygenerated .hex file using the update firmware field in the JadeConfigurator, using theJadeCreator tool, or using AVRstudio and the JTAG ICE mkII programmer. The modulesshipped in the development kit professional can only boot the PeakNet Z stack. PeakNet LPRis not included in the development kit professional.***

We refer to the JadeConfigurator user manual [3] on additional information on how to usethis tool.

5 Next stepsThe main purpose of the evaluation kit is to test GreenPeaks hardware and software onvarious aspects like:

Range;Throughput;Energy consumption;Mobility;Robustness;Ease-of-use;Self-healing, self-organizing aspect;Etc

We advise the user to experiment with the supplied nodes to fully understand the possibilitiesof a wireless sensor network. This can be done using the pre-flashed starter kit application.By using the JadeConfigurator tool one can choose a unique Pan ID and channel for hisnetwork, and change the communication stack from PeakNet Z (pre-flashed) to PeakNet LPR(Low power routing). The starter kit does not support the possibility to build a customapplication on top of the GreenPeak communication stack. This feature is only included in thedevelopment kit professional and enterprise.

Additional information on how to use the Starter Kit and the development tools can be foundin the documentation included with this kit. If some things might not be clear, or you havegeneral comments regarding the Starter Kit and its documentation, please [email protected] .
mailto:[email protected]:[email protected]:[email protected]

gp p202 um 00597 starter kit user manual

Documents