Running the Sniffer
[Simple Sniffer and Scanner Application]

Run the script ieee802154.py

Start the uracoli-wireshark bridge by typing python sniffer/ieee802154.py in a terminal window.

>python ieee802154.py
Enter Capture Port:/dev/ttyUSB0
uracoli sniffer to wireshark bridge V0.1
 OPTS:
 INPUT:  /dev/ttyUSB0, stb230 V0.1, channel=11, rate=OQPSK250
 OUTPUT: ieee802154
cmd:

The string behind "OUTPUT:" is the name of the capture interface.

Run Wireshark

Windows enter the interface name \\.\pipe\ieee802154 as life capture interface.

  Capture -> Start
  
Start wireshark

If wireshark is running, select in the menu Capture/Options or just type Ctrl-K, enter \. in the Interface field and confirm the dialog with START

Alternatively you can create a batch file/shell script, which starts wireshark directly with the option -i ieee802154.

images/wscfg.png

Now capture can be started by clicking this icon:

images/wsstart.png images/wsrun.png

Closing and Reopening a Session

If you want to save a packet capture logfile, you have to close the current session by selecting "Capture?Stop" or "Ctrl-E". After "Capture?Start", the wireshark window stays gray shaded. Switch to the ieee802154.{exe,py} window and type reopen. This will place the data of a pcap file header in the named pipe and will allow wireshark to proceed with the frame capturing.

Changing Channels and Modulation in a Capture Session

In the ieee802154.{exe,py} you can change channel (chan) and rate/modulation (rate) of the transceiver at any time without restarting the wireshark session. NOTE: In the wireshark logfile there is no information about the channel or rate/modulation setting stored.

Configuration

You get prompted for the name of the serial port. If you type help at the prompt, you get a list of available commands.

  Commands:
   reopen   - reopens the named pipe and places a pcap header,
              so that wireshark can reconnect.
   chan <n> - set IEEE 802.15.4 channel.
   rate <r> - set IEEE 802.15.4 data rate (e.g. BPSK20, OQPSK100, ...)
   devrst   - reinitialize the sniffer device
   debug    - start python debugger
   info     - show status of sniffer DEVIN
   verbose  - verbose command
   quit     - end session and terminate all threads
   help     - show command help

This documentation for µracoli was generated on Wed Mar 14 2012 by  doxygen 1.7.1