# 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