EnOcean capt2web User Manual

EnOcean
User manual
November 16, 2009
Contents
1 Introduction 5
1.1 Packet content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.2 Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.3 External Interfaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2 Quick start guide 8
2.1 Operation requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.2 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
3 EnOcean 11
3.1 Protocol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
4 User Interface 13
4.1 Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
4.2 Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
5 On-line data logging 17
6 Settings 19
6.1 Monitoring Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
6.2 IP address settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
7 USB console 22
7.1 Installing the Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
7.2 Connecting to the Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
7.3 Using the Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
7.4 Firmware Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
8 Troubleshooting tips 28
9 Important information 29
9.1 Intended use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
9.2 No warranty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
9.3 Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
9.4 Disclaimer of liability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
9.5 Copyright for the manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
9.6 Disclaimer for the manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
9.7 Contact . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Conformity 32
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
List of Tables
1.1 Packet content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1.2 capt2web specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
3.1 List of EnOcean Radio Protocol fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
3.2 List capture information fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
3.3 List of EnOcean Radio Protocol types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
List of Figures
2.1 capt2web hardware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.2 capt2web main application screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
3.1 Example of a captured packet in the packet view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
4.1 Packet View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
4.2 Table View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
4.3 CSV View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
4.4 Timeline View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
4.5 Detail View. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
4.6 Defining a filter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
4.7 Defining several rules. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
5.1 USB view in the web interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
6.1 Static IP address settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
6.2 Automatic IP address configuration using DHCP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
7.1 Windows Hardware Wizard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
7.2 Choose Location Dialog. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
7.3 capt2web Hardware was found. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
7.4 Properly installed capt2web module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
7.5 Screen shot of the console interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
7.6 Link to firmware update page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
7.7 Firmware update site. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
Chapter 1
Introduction
capt2web is a device to monitor wireless networks. Due to its small form factor it can be placed right in the best place
for wireless network traffic to be monitored. It provides a full-featured web based capture monitor software that
runs in all common web-browsers. Thus, the monitoring software can be accessed using any computer, independent
from the computer’s operating system. For common operation, neither hardware nor software installation applies
for the monitoring computer.
This document covers instructions for the use of capt2web . The first chapter contains the specifications of capt2web
. A quick start guide follows, that describes in short terms how to get capt2web into operation for the first time. In
the third part, the web interface, being the main user interface, is described. Especially focussing on the different
views of captured data.
The following chapters cover additional features such as data logging on an USB mass storage, console mode for
configuration and the firmware update.
Please make sure to read the instructions carefully.
If there are still open questions after reading this manual, contact STZEDN for support.
1.1 Packet content
Item Comment
capt2web module Hardware device for wireless protocol monitoring
Power supply 230VAC /6.0VDC, 800mA
Support CD CD containing manuals and the USB driver, necessary for console connection
CAT5 Ethernet cable
Mini-USB-A plug to USB-A socket adaptor to attach a USB mass storage device
USB extension for mass storage device connection
USB-A to Mini-USB cable to connect to capt2web with the console
Table 1.1: Packet content
Please, only use the cables and adaptors provided together with capt2web .
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
CHAPTER 1. INTRODUCTION page 6
1.2 Specifications
Parameter Minimum Typical Maximum
Module dimensions
Length 117 mm
Width 79 mm
Height 24 mm
Power Requirements
Supply voltage 5.5V DC 6.0V DC 7.5V DC
Current consumption 200mA 350mA 450mA
Environmental conditions
Temperature Range 0◦C 25◦C 40◦C
Table 1.2: capt2web specifications
1.3 External Interfaces
1.3.1 Ethernet connection
The capt2web module contains a full duplex 10/100Mbps Ethernet interface. Use the CAT5 cable supplied to connect
the device to an Ethernet switch or directly to a computer. The interface is Auto-MDIX capable. It requires no special
cable, such as a crossover cable, to directly connect it to a computer, but the connection type is automatically
recognized.
Instructions for the configuration of the Ethernet interface, especially IP settings, can be found in chapter 6 and 7.3.
1.3.2 USB interface
capt2web provides a full-speed USB on-the-go port on its Mini-USB connector. The USB on-the-go (OTG) functionality
allows the capt2web module either to act as an USB device or Host depending on the type of end point connected to
it. This provides maximum flexibility.
Host mode: the port supports USB mass storage devices for continuous data logging. See chapter 5 for details.
Client Mode: capt2web module acts as a CDC device providing a console interface to configure your device and
display information about it. See chapter 7 for details.
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
CHAPTER 1. INTRODUCTION page 7
1.3.3 Power Supply
capt2web can be powered either using the power adaptor provided (5.5V to 7.5V DC, center positive) or over a USB
CDC connection. As the power consumption is up to 450mA, the power supply over the USB interface requires an
active USB hub. Please use primarily the AC-DC adaptor provided with capt2web to guarantee its function. Both
power supplies can be connected in parallel without any interaction. When connecting capt2web for the first time to
a computer, make sure that the AC-DC adaptor is attached to permit proper installing of the CDC drivers.
For a mass storage device attached to the USB port, make sure to consume less than 100mA. In case of doubt, please
contact STZEDN before attaching devices.
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
Chapter 2
Quick start guide
2.1 Operation requirements
In order to operate the capt2web , you must have the following:
A computer equiped with a network port (network adaptor: standard Ethernet 10/100 Base-T)
A compatible web browser. capt2web was tested with the following browsers:
Mozilla Firefox 3.x or higher
Microsoft Internet Explorer 6 and higher
Opera 9.6x or higher
Safari 4 or higher
A reader for PDF-documents to access the documentation.
For configuring capt2web using the console interface, you further need:
A USB port
The required user privileges to install the CDC drivers (only once).
Long-term data logging further requires a formatted USB mass storage device (USB memory stick). The data on the
storage are not deleted due to logging. Please do not use a bus-powered USB hard disk together with capt2web to
prevent damage.
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
CHAPTER 2. QUICK START GUIDE page 9
2.2 Installation
Figure 2.1: capt2web hardware
1. Connect the power supply unit to the socket labelled "Power"
2. Plug the power supply in a 230VAC outlet.
åThe green power LED inside capt
2
web will be turned on, when powered.
3. Network connection for capt2web
(a) Assign a static IP address within the range of capt2web ’s address to your computer and establish a direct
connection using the provided Ethernet patch cable.
OR
(b) Connect capt2web to your local network using the provided Ethernet patch cable.
Each capt2web is configured with a default static IP address. It is printed on the
back label on the capt2web ; this address can also be changed permanently. If the
address configuration is not matching your network settings (IP address and/or sub
net mask), please configure the IP address using the console as described in the cor-
responding chapter of the user manual. Please contact your local network adminis-
trator before connecting any network device to your network.
4. Start a web browser and type the IP address of capt2web in the address field.
5. Start a capture by pressing the "Start" button on the web page.
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
CHAPTER 2. QUICK START GUIDE page 10
Figure 2.2: capt2web main application screen
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
Chapter 3
EnOcean
3.1 Protocol
The EnOcean radio modules communicate in the ISM band of 868MHz with a data rate of up to 125kB/s. Sending
the smallest telegram occupies the channel for 0.6ms.
The transceiver modules from EnOcean are shipped with the EnOcean Radio Protocol (ERP), which capt2web is able
to capture and display in a packet-, list- or CSV view.
Figure 3.1: Example of a captured packet in the packet view
In each view, telegrams are separated in different fields. The fields corresponding to fields in an EnOcean radio
telegram protocol field are:
Name Description
ORG Packet type.
Data Data contained in the packet. This field applies to packets of the RPS and 4BS.
SID 32bit/16bit ID of the sender.
STAT Status byte. The content of this field is defined by the device specific protocol. E.g.
repeaters use this field as counter as well.
Table 3.1: List of EnOcean Radio Protocol fields.
Additional fields show information obtained during capture and are not part of the EnOcean Radio Protocol:
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
CHAPTER 3. ENOCEAN page 12
Name Description
Timestamp Time when the telegram was captured by the sniffer.
RSSI A value in the range of 0...255 to indicating a qualitative value about the Receive
Signal Strength Indicator(RSSI). The EnOcean transceiver outputs an analog sig-
nal for every telegram received and the value displayed in this column is the digital
equivalent.
Table 3.2: List capture information fields.
The following most frequently used telegram types are interpreted by capt2web :
Name ORG (hex) Description
RPS 05 Telegram from a PTM switch module (e.g. PTM 100 or PTM200)
1BS 06 1 Byte telegram from a STM sensor module (e.g. STM250).
4BS 07 4 Byte telegram from a CTM module
Table 3.3: List of EnOcean Radio Protocol types.
Other telegram types are supported as well. To get a complete list with description, please refer to the documentation
provided by EnOcean1for the corresponding radio module.
1
http://www.enocean.de
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
Chapter 4
User Interface
4.1 Views
4.1.1 Packet View
Figure 4.1: Packet View.
In the packet view all received packets are shown from top to bottom as received over the air. New packets are
appended at the bottom of the list, while the list scrolls up automatically over the time.
One line represents one packet.
Different blocks delimit the various fields of the protocol such as header and data sections.
The first two fields, however, contain the time, when the packet was captured by the capt2web and the radio link
quality as reported by the RF receiver.
Protocol sections not active for the selected packet are hidden.
Each field of the packet has two rows:
The name of the protocol section.
The data of the protocol section in hexadecimal notation.
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
CHAPTER 4. USER INTERFACE page 14
4.1.2 Table View
Figure 4.2: Table View.
Much like the packet view (see chapter 4.1.1), the table view lists received packets in ascending time order. In
contrast to the packet view, one column for each protocol section is defined.
Each packet is listed in a row. Columns active for the corresponding packet type are filled with the hexadecimal
values of the data.
Scroll bars on the bottom and the left allow to navigate through the capture.
Left clicking on a table row selects the containing packet for further investigation, either in the detail view (see
chapter 4.1.5 or in the time line (see chapter 4.1.4).
4.1.3 CSV View
Figure 4.3: CSV View.
The CSV view can be used to easily export captured packets to other programs for external evaluation.
The delimiter character, which separates the fields is set by default to a semicolon ’;’. However, you can enter a
different character the input text field "Delimiter". To change it enter your desired delimiter and press set. The
delimiters are changed immediately.
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
CHAPTER 4. USER INTERFACE page 15
4.1.4 Timeline View
Figure 4.4: Timeline View.
Additionally to the mian window, a second section is used to provide additional information about the radio activity.
In the timeline, all received packets are drawn categorised by ports and addresses.
In the first view lines the activities on the several ports are shown. The ports may represent different radio settings
for the internal modules connected. Each coloured box marks an activity on the port.
The next lines display the received packets categorised by address. Selecting a packet in the timeline automatically
selects it in the main window as well and vice versa.
4.1.5 Detail View
Figure 4.5: Detail View.
The detail view expands the protocol sections with further details as listed in the table- or packet views. Additional
protocol specific information can be retrieved from this view.
To display the details of a specific packet in the detail view, select any packet in either the packet-4.1.1, the table
4.1.2 or the time line view 4.1.4. The same packet will be selected across all views and you can inspect its extended
information in the detail view.
Running the mouse over a specific packet highlights the packet in the different views without selecting. For selecting
and packet detail investigation, left-clicking is necessary.
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
CHAPTER 4. USER INTERFACE page 16
4.2 Filter
capt2web allows to define filter rules to concentrate on packets of interest. So e.g. it is possible to only display the
packets received at one port or to hide all packets of a special device.
For defining the filter rules open the tab "Filter".
By default,one dummy filter is displayed. For each filter, some options are possible:
The field, for which the rule has to be applied.
The logic operation the value is compared to (==, !=, >, <, >=, <=).
The value which has to be used for comparison.
Figure 4.6: Defining a filter.
To set a filter press the button "Enable". The icon at the top of the screen is switched to green.
The rules are applied to all views and all already received packets. If new packets are detected, they are stored to
the local packet memory, but they are only displayed if they meet the filter rules. So if the filter is disabled, older
packets, which were not covered by the filters, may appear.
If there have to be defined several rules, press "+" at the top of the filter tab. A further rule box is opened. To
combine multiple rules, select the desired operation next to the set-button:
AND: To display a packet, all rules have to be true.
OR: At least one rule has to be true to display the packet.
Figure 4.7: Defining several rules.
To remove a rule, select it by left-clicking and press the remove button "-".
After each rule changing the button "Enable" has to be pressed to recalculate the views.
For disabling all filters, click "Disable". The icon at the top of the screen is switched to red.
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
Chapter 5
On-line data logging
capt2web supports logging capture data to a file on a mass storage device. This allows to log data over an extended
period of time without a running browser application.
If you have a mass storage device connected to your capt2web module’s USB port, you have the possibility to save a
session’s captured data to a file on the storage device.
Mass storage devices must be formatted with FAT12, FAT16 or FAT32, with a maximum capacity of 4GBytes.
Logging to a file is controlled by the USB view in the web interface as shown in figure 5.1.
Figure 5.1: USB view in the web interface.
To check the current USB mode click on the button "Refresh". There are three different modes:
Terminal Mode Your device is running as a client in terminal mode See chapter 7 for details.
Not Connected There is no end point connected to the USB port.
Connected You have a mass storage device connected. The content of the root directory on the mass storage
device is shown. Each file can be downloaded.
When connected and no logging is running, the capture files can be downloaded by clicking on the link of the files.
The files can be stored to your local file system.
Start a log by clicking on the button "Start Logging". An input box prompts for the file name of the new capture file.
Consider the following:
Type a file name in the format ’8.3’. Maximum 8 characters file name and maximum 3 characters for the file
name extension.
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
CHAPTER 5. ON-LINE DATA LOGGING page 18
File names are case insensitive.
If a file with the given name already exists, the existing file will be deleted and overwritten with the new
capture data.
Files can only be written to the root folder of the mass storage device.
Do not remove the mass storage device while logging.
Once logging is active, the links in the file list are disabled, the logging file is marked writing and the button "Stop
Logging" becomes active.
To stop logging, click on the button "Stop Logging"
Always remember to close a started logging session via the stop button and do not
unplug the mass storage device while logging is in process. This will cause the actually
written log file to be useless.
With a plugged USB storage device, the list of files in the root directory of the mass storage device is shown. To
download the file to your computer, click on the link of the file. Note that a download can only be started if USB
capturing is in idle mode and no log files are currently written.
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
Chapter 6
Settings
This chapter describes the settings of capt2web that can be changed using the web interface. Some settings, such as
the IP address configuration, can also be modified using the console. See chapter 7.3 for details. Restoring factory
default settings, however, is only available through the console.
After changing the settings there are two possibilities:
Update settings: Press the "Update" button to apply the settings for test purpose. The settings are not saved
permanently. If the power supply is disconnected, the former settings are reloaded.
Store settings: After pressing the "Store" button, the new settings are applied and saved permanently in non-
volatile memory on capt2web .
During run-time, the settings can be updated temporarily. Once power to capt2web
is down, the settings are lost. To retain the settings during power down make sure to
"store" settings.
6.1 Monitoring Settings
In tab "Settings" the global settings of the wireless monitor may be changed:
Interval: Time in milliseconds the browser calls for packet updates.
The standard value is one request per second. To achieve a real-time impression, a 500ms update rate might
be appropriate.
Limit: Maximum number of packets to display in the different views such as packet view or the time line. The
more packets are chosen, the more resources are required by the computer’s web browser.
These settings are specific to the current browser session and are never stored permanently. If there are several users
using the current capt2web , all users may have different settings.
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
CHAPTER 6. SETTINGS page 20
6.2 IP address settings
The IP address settings of capt2web must be changed to fit the requirements of the network capt2web is connected
to. Please check with the network administrator to find out about the correct settings in order to prevent IP address
conflicts. An IP address conflict occurs when two clients (multiple capt2web or capt2web and PC) in a network use
the same IP address.
It must be ensured, that an unique IP address is assigned to each capt2web within
the network. Upon an IP address conflict, the network may not work properly for a
longer period, even after the failure has been removed.
Two possibilities exist for the IP address configuration:
1. Static IP address
The IP address and the subnet mask are entered manually.
2. Automatic IP address configuration using DHCP
All settings are assigned by the local DHCP server.
Figure 6.1: Static IP address settings
If a static IP address is used, the IP address and the correct Subnet Mask must be entered. See figure 6.1.
If capt2web should be accessible from another network, then the gateway IP address must be entered. This is also
to set in case capt2web should be accessible from the Internet through a router. Make sure to install port-forwarding
on the router and to set the IP address of the router as gateway IP address in capt2web .
Figure 6.2: Automatic IP address configuration using DHCP
If the IP address should be assigned dynamically through DHCP, switch "Automatic (DHCP)" to "Yes" (see figure 6.2).
Note that all IP address information will be retrieved by the DHCP server in the network, such as Subnet mask
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
CHAPTER 6. SETTINGS page 21
and gateway IP address. Therefore, these fields are disabled, when DHCP is selected. When retrieving the network
settings via DHCP, the assigned IP address cannot be predicted. Two approaches overcome this issue:
Console connection to the capt2web to find out the correct address.
Use the menu command ip on the console. See chapter 7.3 for details. But this approach may fail if e.g. due
to power failure a new address is assigned during device operation.
Access using a unique host name
Optionally, an unique host name for the capt2web can be set. Typically the capt2web can be accessed directly
from the browser using the host name rather than the fixed IP address.
By default, an individual static IP address is configured in the capt2web . Please check the label on the back. Using
this address, capt2web is accessible if the dynamic address retrieval should fail.
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
Chapter 7
USB console
The capt2web module provides a console interface that allows you to configure your device and to display several
information such as the current configuration.
7.1 Installing the Console
First time connecting to the USB console you will have to install the included driver capt2web.inf. For a proper
installation stick to the following steps:
1. If you connect your capt2web device with one of your PC’s USB Ports for the first time, the Windows Hardware
Wizard should appear asking you if it should search the Windows Update Site for the required driver. Please
choose "No, not this time" as shown in figure 7.1 and click "Next".
Figure 7.1: Windows Hardware Wizard.
2. Next step is to tell the wizard not to install the driver automatically. Rather you choose the option "Install from
a list or specific location" to speed up the installation. The dialog is shown in figure 7.2.
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
CHAPTER 7. USB CONSOLE page 23
Figure 7.2: Choose Location Dialog.
3. The next Question, where to look for the files, you have to answer with the option "Don’t search. I will choose
the driver to install".
4. The wizard asks you to select a specific hardware type the driver belongs to. Please choose "Ports (COM &
LPT)".
5. In the next dialog you have to tell the wizard where to find the driver to install. For that click the button "Have
Disk" and in the following dialog point to the capt2web.inf driver installation file on your local file system.
After this step the dialog should list the capt2web Terminal Driver as shown in figure 7.3. Click "Next" to
proceed and ignore the following Warning Message by clicking "Continue Anyway".
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
CHAPTER 7. USB CONSOLE page 24
Figure 7.3: capt2web Hardware was found.
6. After these steps the capt2web Terminal CDC should be properly installed and be displayed in your Device
Manager with its associated COM Port. Figure 7.4 shows an example of an installed capt2web module.
Figure 7.4: Properly installed capt2web module
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
CHAPTER 7. USB CONSOLE page 25
7.2 Connecting to the Console
After you have installed the capt2web Console driver as described in section 7.1 you can connect to the targets USB
Console using a simple terminal program such as HyperTerminal included in MS Windows or putty. Connect to your
target using a speed of 115200 baud, 8 data bits, no parity, 1 stop bit and no flow control. If the connection was
established type "help" to display all possible commands.
7.3 Using the Console
Once connected to the USB console, there is a set of commands available to configure the capt2web device and to
display internal information:
help Displays all available console menu commands.
cfg Switch to configuration settings level of the menu.
list List all configuration settings with their names, values and a description.
To change a configuration setting, use the web interface settings panel. See chapter 6 for details.
store Save the current configuration to non-volatile memory.
If a setting value is displayed with an asterisk (*) in the list of configuration settings (command list),
this means that the setting was updated but not stored to the non-volatile memory of capt2web . If using
the command store, all (!) settings will be stored to non-volatile memory and remain even when
power to capt2web is lost.
restore Restore factory default settings.
This command deletes all changes to the settings and reloads the factory default settings. Note, that this
affects only the settings but not the firmware, in case a new firmware was installed.
eth Show information about the Ethernet state.
This command dumps extended information about the Ethernet driver.
ip Show IP address configuration.
Without an argument, the current IP address in use is shown.
If automatic IP address configuration is used, the address printed out here is the address assigned by the
DHCP server. If resolving the address through DHCP fails, capt2web falls back to its statically configured
IP address.
set <IP Address> [Subnet Mask] Set a new IP address , the subnet mask (e.g. 255.255.255.0) is optional.
auto Automatically configure IP address using DHCP.
Figure 7.5 shows a screen shot of the console interface described above.
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
CHAPTER 7. USB CONSOLE page 26
Figure 7.5: Screen shot of the console interface.
7.4 Firmware Update
The firmware of your capt2web module can be updated via the "Settings" tab in the web interface. On the tab’s
bottom you will find a link "Open upload page ..." to open the according site.
Figure 7.6: Link to firmware update page.
This site displays the current firmware version, hardware revision and target configuration. The update site is shown
in figure 7.7
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
CHAPTER 7. USB CONSOLE page 27
Figure 7.7: Firmware update site.
To update your target’s firmware follow the steps below:
1. Choose the firmware file your device should be updated to by clicking the "Browse" button and selecting the
according file.
2. Upload the file via the "Start Upload" button.
3. Once the upload finishes, the firmware version, hardware revision and device configuration of the chosen
upload file will be displayed. Also, the button "Update firmware" appears. Click this button to start update
your devices firmware. Notice the blinking LEDs of the device.
4. Once the LEDs stop blinking, your firmware update is finished.
Before updating your capt2web device always run it with the included power supply
adaptor and do not use power over USB. It is very important not to disconnect the
target from the power supply during the update process since this will cause a broken
firmware and can’t be fixed by yourself. In case your device doesn’t restart properly
after an update, please contact STZEDN.
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
Chapter 8
Troubleshooting tips
Problems related to accessing the web page of capt2web
– Q: capt2web is configured to automatically retrieve its IP address using DHCP. How can I find out the IP
address of capt2web ? A: The easiest way is, if your DHCP and DNS server setup supports resolving the
host name. Then you are able to access capt2web directly by http://<hostname> without entering
the IP address. See chapter 6.2 for details.
If your server does not support host names, connect to the console with a PC and enter the command
ip<ENTER><ENTER> (see chapter 7.3). This will display the IP address capt
2
web is using.
– Q: When I connect capt2web directly to my PC, I cannot access the web site using the IP address configured
in capt2web ?
A: Follow these steps:
Check, if the network interface on your computer has link. If not, make sure, it is configured to
detect link speed automatically (auto-negotiation enabled).
Check which IP address your interface is using. Under Windows, open a command prompt and type
ipconfig. This will show the IP address and subnet mask of your interface. Check with the
console (see chapter 7.3), which IP address is configured in capt2web . If your Windows computer’s
IP address is in the address range 169.254.X.X, this means that the interface is configured to
get an IP address assigned automatically. Either change the IP address to a static IP or configure
the capt2web IP address and subnet mask to 169.254.X.X:255.255.0.0 using the console
menu. Make sure, the IP address differs from the IP address of your computer.
Try to ping the capt2web module using the command prompt.
Problems related to capturing and displaying data
– Q: When I reload the page and I start the capture again, some "old" packets are displayed again, even though
I cleared the packet list previously.
A: Note, that reloading the page is similar as if you were restarting a PC application. The fact that
you cleared the packet list previously will not be "remembered". What happens is, that the first time
the browser is accessing capt2web again, it will retrieve all packets that are currently available in the
ring-buffer of capt2web . Just click on the button "Clear packets" again.
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
Chapter 9
Important information
9.1 Intended use
The equipment is designed to monitor wireless networks in dry and dust-free rooms. Any usage other than de-
scribed in this manual is not permitted. Please read the operating instructions thoroughly and keep them for further
reference.
Do not open the case of capt2web . Warranty is void when the case was opened other than by STZEDN.
Only use the cables and adaptors provided together with capt2web .
Contact your local network administrator before operating capt2web in a network.
9.2 No warranty
capt2web is provided “as is” and use of capt2web is at user’s risk. STZEDN expressly disclaims all warranties,
representations of conditions of any kind, express or implied or statutory, including but not limited to, any warranty
of merchantable quality or fitness for a particular purpose and any warranty that capt2web is delivered free of
any third party claims by way of infringement or otherwise. STZEDN does not warrant nor make any condition
or representations that the functions contained in capt2web will meet the requirements of the customer, that the
operation of capt2web will be uninterrupted nor error free that defects in capt2web will be corrected. Further,
STZEDN does not warrant or make any conditions or representations regarding the use or the results of the use of
capt2web in terms of its correctness, accuracy, reliability or otherwise. No oral or written information or advice given
by STZEDN or others shall create a warranty, condition or representation or in any way extend the scope of the “as
is" provision of capt2web .
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
CHAPTER 9. IMPORTANT INFORMATION page 30
9.3 Trademarks
Windows is a registered trademark of the Microsoft Corporation. All other trademarks, registered trademarks and
product names are the sole property of their respective owners.
9.4 Disclaimer of liability
The entire risk as to the results and performance of this of capt2web is assumed by the user. Neither STZEDN
nor its affiliates, distributors, resellers, suppliers, agents, officers and directors shall have any liability to the user
or to any other person or entity for any damages howsoever caused including, but not limited to, direct, indirect,
incidental, special, general, consequential, punitive or exemplary damages whatsoever including, but not limited to,
loss of revenue or profit, damages to property or persons, lost or damaged data, or other commercial or economic
loss, even if STZEDN has been advised of the possibility of such damages or they are foreseeable, or for claims by
third party. STZEDN’s maximum aggregate liability and that of its affiliates, distributors, resellers, suppliers, agents,
officers and directors to the customer shall not exceed the amount paid by the customer for capt2web . This section
shall apply whether or not the breach, default, non-performance of failure is a breach of fundamental condition or
term, or a fundamental breach. In no event shall STZEDN be liable to the other party for any loss or injuries to
earnings, profits or good will, or for any incidental, special, punitive or consequential damages of any person or
entity whether arising in contract, tort or otherwise, even if either party has been advised of the possibility of such
damages.
9.5 Copyright for the manual
Copyright 2009. stzedn. All rights reserved.
9.6 Disclaimer for the manual
STZEDN has taken care in preparation of this manual, but make no expressed or implied warranty of any kind and
assume no responsibility for errors or omissions. No liability is assumed for incidental or consequential damages in
connection with or arising out of the use of the information or programs contained herein. Information contained
in this publication regarding device applications and the like is provided only for your convenience and may be
superseded by updates and is subject to change without notice.
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
CHAPTER 9. IMPORTANT INFORMATION page 31
9.7 Contact
Address: Steinbeis Transferzentrum für Embedded Design and Networking
at the Baden-Württemberg Cooperative State University, Lörrach
Prof. Dr. Axel Sikora
Hangstraße 46-50
D - 79539 Lörrach, Germany
Phone: +49 - 7634 6949340
Fax: +49 - 7634 5049886
Email: info@stzedn.de
Web: http://www.stzedn.de
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
EC - Declaration of conformity
We
Steinbeis Transferzentrum für Embedded Design and Networking
at the Baden-Württemberg Cooperative State University, Lörrach
Hangstraße 46-50
D - 79539 Lörrach, Germany
herewith declare that the product
Type: capt2web
Version: EnOcean
complies with the requirements and the provisions of the
Directive 1999/5/EC of the European Parliament and of the council of 9 march 1999 on Radio equipment
and Telecommunications Terminal Equipment and the mutual recognition of their conformity and Annex III
(Conformity Assessment procedure referred to in article 10 (4)).
We furthermore declare that the following parts of standards and documents have been applied:
EN 301 489-3
EN 300 220-3
EN EN 300 220-1
Furthermore the LVD is fulfilled:
EN 60950-1
Place and date of issue Loerrach, November 16, 2009
Name, function and signature of authorised person Prof.Dr.-Ing. Axel Sikora, Head of Transfer Center
Steinbeis Transfer Center Embedded Design and Networking Baden-Württemberg Cooperative State University Lörrach Prof. Dr.-Ing. Axel Sikora
Loading...