1. Manuals
  2. Brands
  3. Crossbow Manuals
  4. Gateway
  5. Stargate NetBridge
  6. User manual

Crossbow Stargate NetBridge User Manual

Stargate netbridge gateway user’s manual
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
Stargate NetBridge Gateway User's Manual
Revision A, October 2007
PN: 7430-0449-01

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the Stargate NetBridge and is the answer not in the manual?

Questions and answers

Summary of Contents for Crossbow Stargate NetBridge

  • Page 1 Stargate NetBridge Gateway User’s Manual Revision A, October 2007 PN: 7430-0449-01...
  • Page 2 © 2007 Crossbow Technology, Inc. All rights reserved. Information in this document is subject to change without notice. Crossbow, IRIS, MICA, TrueMesh and XMesh are registered trademarks of Crossbow Technology, Inc. Other product and trade names are trademarks or registered trademarks of their...

  • Page 3: Table Of Contents

    Data logging and Visualization using MoteView ...............27 Remote Connection using MoteView................27 MoteView at a Glance ....................28 Advanced Stargate NetBridge Administration ..............30 Remote Stargate NetBridge Administration ..............30 MoteExplorer Administration..................33 XServe Administration ....................33 Recovery of the XServe ....................37 Direct connection to a PC using Crossover cable ............
  • Page 4 Stargate NetBridge Gateway User’s Manual Other Accessories ......................51 Appendix C. Warranty and Support Information............52 10.1 Customer Service ..................... 52 10.2 Contact Directory ..................... 52 10.3 Return Procedure...................... 52 10.4 Warranty........................53 Page ii Doc. # 7430-0449-01 Rev. A...

  • Page 5: About This Document

    Stargate NetBridge Gateway User’s Manual About This Document The following annotations have been used to provide additional information. NOTE Note provides additional information about the topic. EXAMPLE Examples are given throughout the manual to help the reader understand the terminology.

  • Page 7: Introduction

    Stargate NetBridge Gateway User’s Manual 1 Introduction This User’s Manual describes the features and operation of the Stargate NetBridge embedded wireless sensor network gateway. 1.1 Stargate NetBridge Gateway Overview Stargate NetBridge is a Linux based embedded Wireless Sensor Network (WSN) gateway based on the Linksys NSLU2 device.

  • Page 8: Quick Start Wsn Kit Users

    • Remove the Stargate NetBridge gateway from its packaging. An included base can be used for upright operation. • The bag holding the Stargate NetBridge also contains an USB FLASH disk included in the package. Insert this device into the bottom USB port of the Stargate NetBridge labeled “Disk 1”.
  • Page 9 2.1.3 Run the GatewayConfig tool to find the IP address of the Stargate NetBridge In order to connect to the Stargate NetBridge its hostname or IP address has to be known. The GatewayConfig tool can help scan and find the IP address. Some networks will resolve the hostname properly so knowing the NetBridge’s IP address is not required.
  • Page 10 • Allow sometime for the scanning to complete and the GUI would display a list the Stargate NetBridge gateways that were found in your network. • Make a note of the IP address assigned to your hostname. Double-clicking on this IP address will open the MoteExplorer in a web browser.
  • Page 11 Stargate NetBridge Gateway User’s Manual 2.1.4 Start-up MoteExplorer The primary interface to the Stargate NetBridge can be accessed using a Web browser on a locally connected PC. In order to connect to the Stargate NetBridge its hostname or IP address has to be known.
  • Page 12 More information about MoteExplorer and its features can be found in the Chapter 5 of the manual. NOTE: To turn off the power, press the power button. This allows Stargate NetBridge to correctly shutdown the operating system and takes about 40 seconds. Page 6...

  • Page 13: Hardware Overview

    3 Hardware Overview 3.1 Stargate NetBridge Gateway The Stargate NetBridge gateway is an embedded Sensor Network gateway device. It is based on the Intel IXP420 XScale processor running at 266MHz. It features one wired Ethernet and two USB 2.0 ports. The device is further equipped with 8MB of program FLASH, 32MB of RAM and a 2GB USB 2.0 system disk.
  • Page 14 Program Flash 8 MB 32 MB USB Flash Disk 2 GB 3.1.2 Electrical Specifications The electrical specifications for the Stargate NetBridge Gateway are provided in Table 3-2. Table 3-2. Stargate NetBridge Gateway Electrical Specifications Parameter Operating Value Voltage supply 5.0 Volts...

  • Page 15: System Configuration

    “Disk 1” LED starts lighting up and the Status LED turns blinks green and yellow. A short beep indicates the completion of the boot procedure as well. The whole process takes about two minutes. After Stargate NetBridge has powered up, you should see the front indicators showing the following status. Table 4-1. Stargate NetBridge Gateway LED indicator...
  • Page 16 Stargate NetBridge Gateway User’s Manual inet addr:10.1.1.248 Bcast:10.1.1.255 Mask:255.255.255.0 inet6 addr: fe80::214:bfff:fe68:8ca1/64 Scope:Link UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:459986 errors:0 dropped:0 overruns:0 frame:0 TX packets:2527 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:100 RX bytes:32502391 (30.9 MiB) TX bytes:1142335 (1.0 MiB) Link encap:Local Loopback inet addr:127.0.0.1...

  • Page 17: Network Topologies

    1 user user 8399872 Sep 25 14:19 xserve_sqlite.db 4.3 Network Topologies For this user guide we will assume that the network to which the Stargate NetBridge is connected consists of a class C IP network (e.g., of the type 192.168.x.x). It is further assumed that this network consists of a NAT router with DHCP server capability, a WAN port connected to the Internet and LAN ports hosting the Stargate NetBridge and at least one local PC.

  • Page 18: Data Visualization Using Moteexplorer

    MoteExplorer URL address. Users can use either the hostname of their Stargate NetBridge written on a sticker attached to one side of the device or an IP Address. For users on a corporate or university network, the hostname should be enough to allow users to find the application through the browser.

  • Page 19: Login

    Stargate NetBridge Gateway User’s Manual The IP address of the Stargate NetBridge can be found either using the GatewayConfig tool (see GatewayConfig section) or can be found manually through your routers DHCP client table. To look up the IP address using your routers DHCP table, please refer to your routers manual.

  • Page 20: Map

    Stargate NetBridge Gateway User’s Manual The default user password can be changed using the ManageUser tool (refer to Section 7.3.4 ) Users who have modified the XServe Server process on the Stargate NetBridge to run on non- Advanced default ports can use the “...
  • Page 21 Stargate NetBridge Gateway User’s Manual view the sensor data place your mouse over the node and wait a second. A pop-up with the sensor data will appear. When on the network data overlay users will see Network routing information for each node.

  • Page 22: Charts

    Stargate NetBridge Gateway User’s Manual The Network Overlay also allows you to see the nodes neighbors visually as well as the nodes network information including its parent, route, neighbors, and battery voltage. To view this information, move your mouse over a node and pause for a second.
  • Page 23 Stargate NetBridge Gateway User’s Manual 5.4.1 Creating new charts New… When selecting the “ ” chart drop down, the user is shown a charting wizard to help them create a new chart. Users can select: • Chart Name: This is the name that is displayed on chart tab.
  • Page 24 Stargate NetBridge Gateway User’s Manual After completing the wizard MoteExplorer will retrieve the specified data and chart it. To view a specific value and time on the chart, place the mouse over the point and a pop up with the exact value and time will appear.
  • Page 25 Stargate NetBridge Gateway User’s Manual 5.4.2 Saving a chart Once a chart is created a user can save a given chart to be reloaded later. When the user select Save… the “ ” chart drop down a Save Chart wizard is displayed to the user. To save a chart the user must select a unique name for the chart.
  • Page 26 Stargate NetBridge Gateway User’s Manual 5.4.3 Loading a chart Once a chart is saved a user can load a given chart at a later date. When the user selects the Load… “ ” chart drop down a Load Chart wizard is displayed to the user. The list of saved charts is displayed in the drop down chooser.
  • Page 27 Stargate NetBridge Gateway User’s Manual 5.4.4 Deleting a saved chart Once a chart is saved a user can delete a given chart from MoteExplorer. When the user selects Delete… the “ ” chart drop down a Delete Chart wizard is displayed to the user. The list of saved charts is displayed in the drop down chooser.

  • Page 28: Network

    Stargate NetBridge Gateway User’s Manual 5.4.5 Viewing chart data Each chart is displayed as a named tab in the Charting window. Users can switch between charts by clicking on the named tab for the chart to be displayed. Unused charts can be closed by clicking on the X in the chart tab.
  • Page 29 Stargate NetBridge Gateway User’s Manual 5.5.1 Application Yield The Application Yield window displays hourly, daily and weekly display statistics for each type of data packet arriving from a node. Yield is displayed as a percentage over the given time range. In addition, the number of packets received by the server over the number of packets generated by the node is also displayed in parenthesis next to each yield number.
  • Page 30 Stargate NetBridge Gateway User’s Manual 5.5.2 Mesh Health The Mesh Health window displays per node health and neighbor statistics. The data displayed is the following: • Battery Voltage: This is the current battery voltage of the node. • Hop Count: This is the number network hops this node is from the base station gateway.
  • Page 31 Stargate NetBridge Gateway User’s Manual • Path Cost: The path cost is a metric which represents the quality of path to the base station going through that node. A path cost equal to the hop count of the node is considered a perfect path.

  • Page 32: Data

    Stargate NetBridge Gateway User’s Manual 5.6 Data The Data window in the MoteExplorer provides a tabular, searchable view of the current data from the sensor nodes. The top table displays the current data organized by time, node id, sensor, and reading. The data is continually updated as new data arrives from the mesh.

  • Page 33: Data Logging And Visualization Using Moteview

    Stargate NetBridge Gateway User’s Manual 6 Data logging and Visualization using MoteView This section describes how to use MoteView to remotely connect to the Stargate NetBridge and log/view data locally. 6.1 Remote Connection using MoteView The connection strategy involves serial forwarder connection to the XServe’s serial forwarder running on Stargate NetBridge and local data logging and visualization using MoteView.

  • Page 34: Moteview At A Glance

    Stargate NetBridge Gateway User’s Manual Sensor Board XMesh Application Name 5. In the tab, choose the that matches the firmware Application Name XMTS400 programmed into the Mote from dropdown (It should be if you are Done using Crossbow’s packaged WSN Kit). Click on NOTE: If you are unable to view the tables on a remote database, verify that the remote PC’s...
  • Page 35 Stargate NetBridge Gateway User’s Manual 4. Server / Error Messages: Displays a log of server events and incoming messages. Node List Toolbar/Menus Visualization Tabs Server Messages Figure 6-1. Screenshot of the MoteView GUI More information about MoteView and its features can be found in the MoteView User’s manual.

  • Page 36: Advanced Stargate Netbridge Administration

    The Stargate NetBridge is running a recent Debian Linux kernel. Users familiar with Debian can utilize all its features on the Stargate NetBridge as it conforms to the regular Debian setup. Note that the Stargate NetBridge is running on an ARM architecture CPU in “little- endian”...
  • Page 37 Stargate NetBridge uses Samba (SMB) to enable transfer of files between Stargate NetBridge and a PC. You can use Samba to map Stargate NetBridge directories to your PC (or you can use ssh and scp if you have Linux) and transfer MoteExplorer configuration files. To use Samba: •...
  • Page 38 Stargate NetBridge Gateway User’s Manual • Once your PC has connected the file directory on Stargate NetBridge will appear as a mapped drive on your PC Once the file manager window opens the Stargate NetBridge window, the files in the /usr/xserve directory can be read or written.

  • Page 39: Moteexplorer Administration

    See below for more information on XServe and XServe administration. 7.3 XServe Administration XServe is the Crossbow Gateway Server application which runs on each Stargate NetBridge. XServe analyzes and stores information about the mesh network and then displays that information through MoteExplorer.
  • Page 40 Stargate NetBridge Gateway User’s Manual Figure 7-1. XServe architecture • Raw Mesh Data Forwarder: XServe provides a direct interface to receive and send data to the mesh network. The data passes through XServe unprocessed. • Mesh Data Parser: XServe uses XML Configuration Files to describe and convert data from the mesh into meaningful sensor data.
  • Page 41 MoteExplorer Map, or saved Charting queries using MoteExplorer Charts. When connecting the Stargate NetBridge to a new network or resetting an existing network it is important to reset XServe’s database so that old values do not interfere with the new network.
  • Page 42 Delete Saved Database It is important to delete old saved databases in order to save space on the Stargate NetBridge. Once a saved database is no longer needed it is prudent to delete the saved database. Operation: 3 Enter database name to delete (Name used during save operation): <Database Name>...

  • Page 43: Recovery Of The Xserve

    ‘crossbow’. Users can manage the ‘admin’ user password using the manageusr command located on the Stargate NetBridge. To run the managedb command it is necessary to remotely SSH into the Stargate NetBridge (Section 7.1.1). Once you have accessed the Stargate NetBridge, the managedb command is located at /usr/xserve/scripts/nslu2/manageusr This script manages the MoteExplorer username and password.

  • Page 44: Direct Connection To A Pc Using Crossover Cable

    This Configuration requires crossover Ethernet cable. The Stargate NetBridge is configured to default to a static IP if no DHCP server can be found or an IP lease can not be obtained for other reasons. This default IP address is 192.168.1.77. Before connecting the Stargate NetBridge to a network without DHCP make sure that no other machine occupies this address.
  • Page 45 Stargate NetBridge Gateway User’s Manual Properties 2. Click on “ ”: 3. Scroll the embedded window all the way down and click on Internet Protocol (TCP/IP): 4. Fill out the form as shown, select the address 192.168.1.1, subnet mask 255.255.255.0 and gateway 192.168.1.1 manually, then press...

  • Page 46: Assigning Static Ip Address

    Stargate NetBridge Gateway User’s Manual If the Stargate NetBridge is connected properly with a cross-over cable and has been booted and running for at least two minutes you should be able to ping it using a Command window. The output should look similar to this: C:\>ping 192.168.1.77...

  • Page 47: Commercial Networks

    In this case it is recommended to run the gateway finder tool on a machine that is on the same subnet as the Stargate NetBridge or consult your system administrator. Often, commercial networks link DHCP and DNS which will allow connecting to the Stargate NetBridge by its name without knowing its IP address.

  • Page 48: Appendix A. Advanced Xserve Configuration

    Stargate NetBridge Gateway User’s Manual Appendix A. Advanced XServe Configuration 8.1 Configuring XServe XServe is configured through a set of XML Configuration files. Each file defines how a data packet from the mesh is parsed and converted into sensor data. It also describes which processing module will handle the sensor data and how it will be processed.
  • Page 49 Stargate NetBridge Gateway User’s Manual </XField> <XField name="mic" byteoffset="22" length="2" type="uint16"/> </XFields> … </XFieldExtractor> </XServeConfig> <XFieldExtractor> The root document of any XML Configuration file is . Field Extractor <XFieldExtractor> defines a single parser containing a set of fields, a filter, and any data sink parameters.
  • Page 50 Stargate NetBridge Gateway User’s Manual Attribute Description Required • • long • uint8 • uint16 • uint32 • uint64 • • string • float • double <XBitField> The < > tag is a specialized version of the < > tag, allowing the user to extract...
  • Page 51 Stargate NetBridge Gateway User’s Manual extract the necessary bytes with a logical AND. shift The number of bits to shift the resulting masked value to position the value correctly <XConversion> Each Field Definition maps the raw values from the packet to a named field. In most cases the value in the packet is a hardware specific value and is not in a format which is understandable by users or external applications.
  • Page 52 Stargate NetBridge Gateway User’s Manual The < > tag maps the variable in the function to a field name in the actual XConversionParam parser. This allows users to build generic equations to use over and over and then map the actual variables differently in each conversion function.
  • Page 53 Stargate NetBridge Gateway User’s Manual <XCond name="IsEqual"> <XFilterParam name="fieldname" value="board_id"/> <XFilterParam name="fieldvalue" value="0x83"/> </XCond> </XCondAnd> </XFilter> <XCondAnd> <XCondOr> <XCondNot> <XCond> The < > tag defines the name of the condition you wish to test. Currently the only condition XCond available is the IsEqual condition for a fieldname and a value. The IsEqual condition takes the fieldname and the fieldvalue as its parameters.
  • Page 54 Stargate NetBridge Gateway User’s Manual health: node id=%s parent=%s seq_no=%s\n battery = %s mv\n temperature = %s degC\n light: = %s ADC mv\n AccelX: = %s g, AccelY: = %s g\n MagX: = %s mgauss, MagY: = %s mgauss "/>...
  • Page 55 Stargate NetBridge Gateway User’s Manual a field in order. 8.1.2 Generic File Datasink The Generic File Datasink outputs data to a specified file. The field delimator, the header, and the file name are all configurable by a XML Configuration file.
  • Page 56 Stargate NetBridge Gateway User’s Manual <XDataSink name="Sensor Log Datasink"> <XDSParam name="sensorname" value="MTS310"/> <XDSParam name="columninfo" value="fieldname = nodeid, displayName = Node Id, displayOrder=1"/> <XDSParam name="columninfo" value="fieldname = parent, displayName = Parent Id, displayOrder = 2"/> <XDSParam name="columninfo" value="fieldName=voltage,displayName=Battery Voltage, displayOrder = 3,unitName=Volts, unitShortName=V"/>...

  • Page 57: Appendix B. Accessories

    Stargate NetBridge Gateway User’s Manual Appendix B. Accessories 9.1 Crossbow Accessories: Table 9-1.Supported Crossbow Base Station Units Model Description BU900CA MCIA2 Base Station BU2400CA MICAz Base Station BU2110CA IRIS Base Station MIB520CB USB Interface Board NOTE: Crossbow Telos and Imote2 motes can be connected via the USB port, however, Crossbow does not provide software support for such configurations.

  • Page 58: Appendix C. Warranty And Support Information

    Stargate NetBridge Gateway User’s Manual 10 Appendix C. Warranty and Support Information The Stargate NetBridge is a Crossbow modified Cisco/Linksys NSLU2 device. It is supported by Crossbow only. Please do not call Linksys or Cisco for support. 10.1 Customer Service...

  • Page 59: Warranty

    Stargate NetBridge Gateway User’s Manual 10.3.2 Identification and Protection If the equipment is to be shipped to Crossbow for service or repair, please attach a tag TO THE EQUIPMENT, as well as the shipping container(s), identifying the owner. Also indicate the service or repair required, the problems encountered and other information considered valuable to the service facility such as the list of information provided to request the RMA number.
  • Page 62 Crossbow Technology, Inc. 4145 N. First Street San Jose, CA 95134 Phone: 408.965.3300 Fax: 408.324.4840 Email: info@xbow.com...

Table of Contents