# 1 Overview

This document describes the steps required to install the AVRRZUSBSTICK image and Arch Rock 6LoWPAN Windows Service. After installation and configuration, they allow a user to manage an Arch Rock 6LoWPAN network and allow PC applications to communicate with Arch Rock IP/6LoWPAN Software Distribution embedded applications in the network.

Note that the Arch Rock 6LoWPAN Windows Service only works with Windows XP SP2

Note: Arch Rock encourages you to check out support site at: http://support.archrock.com/asd immediately for updates, bug fixes, and additional sample applications

# 2 Flashing the AVRRZUSBSTICK image

· Note that by default the AVRRZUSBSTICK does not have the Arch Rock image flashed.

· Note that you need access to two USB ports to flash the Arch Rock image.

· Refer to AVR2016: RZRAVEN Hardware User's Guide for more details on the programming interface of the AVRRZUSBSTICK.

Connect the JTAG programmer to the USB port. If you have not already installed your JTAG ICE programmer you will need to go through the windows installation process.

Connect AVRRZUSBSTICK to USB port

Attach the JTAG adapter included in the Raven kit to your JTAG programmer. Attach the 10-pin connector to the AVRRZUSBSTICK with the ATMEL logo facing away from the microcontroller on the key.

Start AVR studio. You need not open a project. Select Program AVR from the Tools menu, as shown below:

Under the Main tab, Select JTAG mode and the AT90USB1287 device. (This setting is used in the AVRRZUSBSTICK, but not in the AVRRAVENx) Click Read Signature and make sure that there are no error messages, as shown below:

Under the Fuse tab, confirm the fuse settings. They should be:

Extended: 0xFB

High: 0x91

Low 0xDE

Under the Program tab, check the boxes next to the Erase Device before programming and Verify Device after programming options.

Under the program tab, in the flash section, browse to the AVRRZUSBSTICK image provided in the ASD. The image is located at:

Arch Rock/binaries/UsbStick/AVRRZUSBSTICK.hex

Click program. Verify that there are no error messages. Detach the JTAG programmer.

Verify that the AVRRZUSBSTICK is attached to the USB port and the blue LED on the device is lit. If the LED is not lit, detach the device from the USB port, wait 5 seconds, and then re-attach the device to the USB port.

# 3 Arch Rock 6LoWPAN Windows Service

## 3.1 Installation

### 3.1.1 Running the windows installer

Run the windows installer located at:

Arch Rock/binaries/6LoWPAN-WINDOWS-SERVICE/ win6lowpanservice.exe

You may see the following error message:

Click on “Yes”

After installation, open Control Panel -> Network Connections and make sure the interface with the Device Name (not name) of Microsoft Loopback Adapter is “Connected”. If not, right click on the interface and choose “enable”

### 3.1.2 Starting the application

The 6LoWPAN service installs as a standard Windows service.

To start/stop/restart the service, simply right-click on My Computer in your Windows start menu and choose Manage to view the Computer Management screen.

Navigate on the left sidebar to Services and Applications, sub-menu Services.

When you single-click on Services, you will see a list of services installed on your Windows box. You will see the Arch Rock 6LoWPAN service in the list. To start, stop, and restart the service, you may right click on Arch Rock 6LoWPAN Service and choose Start, Stop, Restart etc.

By default, Windows installs the application as startup type Automatic, you may want to change the startup type to Manual so Arch Rock 6LoWPAN Windows service does not start automatically upon Windows startup.

## 3.2 Configuration

### 3.2.1 Option 1: Edit the configuration file directly

If you need to do any custom configuration, the rosetta.conf file is located in the installation directory, the default location is:

c:\Program Files\ArchRock\6LoWPAN\rosetta.conf

Currently, when you set the channel or PAN ID, it will be written to the configuration file. One way to reconfigure the channel and PAN ID is to edit rosetta.conf directly. Note that the service will need to be restarted as described in section 3.1.2 after modifying rosetta.conf

### 3.2.2 Option 2: Management GUI

Once the software is installed, point your web browser to

http://127.0.0.1:7673/index.html

All changes to the 6LoWPAN service are performed through the “router settings” page.

## 3.3 Un-installation

To uninstall Arch Rock 6LoWPAN Windows Service, run the Uninstall.exe executable in the installation directory. The default installation directory is:

C:\Program Files\ArchRock\6LoWPAN\

The executable removes the service; at this point you may delete the files in the installation directory.

## 3.4 Updating

To update the Arch Rock 6LoWPAN Windows Service, follow the directions in section 3.3 to uninstall the old software, and then follow the directions in section 3.1 to install the new software.

# 4 Startup procedures of Arch Rock 6LoWPAN Service and AVRRZUSBSTICK

As of the current release, the following startup procedure must be followed for proper operation:

1. Stop the Arch Rock 6LoWPAN Service
2. Detach the AVRRZUSBSTICK, if it is attached
3. Attach the AVRRZUSBSTICK;
4. Start the Arch Rock 6LoWPAN Service

# 5 Using the Management GUI

The Management GUI can be reached by pointing your browser to

http://127.0.0.1:7673/index.html

In order for correct operation of the management GUI, the startup procedure in section 4 must be followed.

## 5.1 Routing Table Tab

This page displays the entities in the 6LoWPAN network, along with their routing information.

Discover Nodes button forces all entities within radio distance to respond and thus show up in the Neighbor Table tab.

Rebuild Routing Tree button forces the AVRRZUSBSTICK to restart the routing tree building process.

## 5.2 DHCP Assignment Tab

The DHCP Assignment tab shows the entities that has been assigned addresses and their information.

## 5.3 Neighbor Table Tab

The Neighbor Table tab shows the entities within radio distance of the AVRRZUSBSTICK.

## 5.4 Router Settings Tab

The Router Settings tab shows the current settings of the Arch Rock 6LoWPAN router. In this case, it is the AVRRZUSBSTICK. One may also change the channel and PAN ID here.

# 6 Setting up an Arch Rock 6LoWPAN Windows Service enabled PC as a 6LoWPAN router

To enable a remote computer to access the nodes, you need to turn on TCP/IP forwarding on the Windows PC where the 6LoWPAN Windows Service is running. Here are the instructions from Microsoft:

http://support.microsoft.com/kb/315236

You will also need to set up the route on your remote computer to route to the 6LoWPAN prefix via the box running 6LoWPAN Windows Service.

# 7 Wireshark

Since Arch Rock mesh networks are IP based, not only can one use standard tools such as ping and telnet to interact with nodes in the network, one can also use standard diagnostic tools such as wireshark to debug the network.

The above screenshot shows the packet capture of a telnet session and a series on pings from a Windows machine to a Raven board. One simply has to install wireshark and start capture on “MS Loopback Interface”.

# 8 Troubleshooting

## 8.1 General troubleshooting comments

The AVRRZUSBSTICK must be flashed with the correct image and inserted in the USB port. The blue LED on the AVRRZUSBSTICK will turn on when the hardware is functioning correctly. The Arch Rock 6LoWPAN Windows Service must be started after the blue LED is on.

Note that out of the box the AVRRZUSBSTICK does not have the Arch Rock image flashed.

The Arch Rock 6LoWPAN Windows Service must be restarted after the AVRRZUSBSTICK has been detached from the USB port, following the procedure outlined in section 4.

## 8.2 The Management GUI does not load at all

Make sure the Arch Rock 6 LoWPAN Windows Service is started and the correct image for AVRRZUSBSTICK has been flashed on the hardware. The blue LED on the AVRRZUSBSTICK must be lit.

## 8.3 The “Router Settings” page does not display meaningful values

Restart the Arch Rock 6LoWPAN Windows Service, as described in section 4

## 8.4 The AVRRAVENx boards are not showing up in the network

Make sure that the channel and PAN ID shown in the management GUI matches the channel and PAN ID set in the AVRRAVENx firmware.

If you have more than one raven kit, make sure only one AVRRZUSBSTICK is on one channel at a time.

## 8.5 The connectivity to the AVRRAVENx boards is intermittent

Under the “Routing Table” tab in the management GUI, click on “Rebuild Routing Tree” to restore connectivity.

# 9 Support

Please visit http://support.archrock.com/asd for technical support and updates.