6TiSCH/IEEE802.15.4e and 6LoWPAN Wireshark dissectors

Important: latest Wireshark version (from 2.5.0-370-ga3b4731eb) has everything you need to see all the details contained in the 6TiSCH frames.

Note: This dissector is developed based on Wireshark 2.0.3.

These dissectors extend the Wireshark IEEE802.15.4 dissectors with the following:

dissect the IEEE802.15.4 FCF for "version 2" frames (new in IEEE802.15.4e-2012)
dissect all Information Elements used in draft-6tisch-minimal
dissect IP-in-IP encapsulation
dissect the 6lo Paging and Routing Dispatch in 6LoWPAN
dissect the 6P protocol frame defined in draft-ietf-6tisch-6top-protocol

The source code of those dissectors is available as open-source code (BSD license). Although we are making final adjustments, you can use the code today. For now, you have to recompile Wireshark (instructions below); we will work on submitting this code to the Wireshark project once we are finished.

Build status

builder	build	outcome
OpenWSN builder	compile (6TiSCH Wireshark)	![Build Status](http://openwsn-builder.paris.inria.fr/buildStatus/icon?job=6TiSCH Wireshark)

On Windows

The following are the steps to install the dissector on a Windows machine. It has been tested on a computer with Windows 8.1-64-bit version installed.

Workspace

We assume the directory of workspace is C:\Development. The wireshark source code will be extracted at this directory.

Toolchain installation

Follow https://www.wireshark.org/docs/wsdg_html_chunked/ChSetupWin32.html to install the toolchain.

Get Source code and extract it to workspace

Download the wirehsark 2.0.3 source code and extract

  wget https://1.eu.dl.wireshark.org/src/all-versions/wireshark-2.0.3.tar.bz2
  7z x wireshark-2.0.3.tar.bz2
  7z x wireshark-2.0.3.tar -oC:\Development
  mv C:\Development\wireshark-2.0.3 C:\Development\wireshark
  rm *.tar*

Get 6TiSCH dissector source code and extract to wireshark source code

  cd C:\Development\
  git clone https://github.com/openwsn-berkeley/dissectors.git
  cd dissectors
  cp packet* C:\Development\wireshark\epan\dissectors

Install wireshark 64-bit

Open a windows command prompt

Setup virtual studio environment for 64-bit version by calling vcvars64.bat

  call "C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\bin\amd64\vcvars64.bat" > nul

Note: the command here uses the default installing directory when installs Virtual studio 2013. Change it accordingly if you have VS 2013 installed somewhere else.

Setup parameters

  set CYGWIN=nodosfilewarning
  set WIRESHARK_BASE_DIR=C:\Development
  set WIRESHARK_TARGET_PLATFORM=win64
  set QT5_BASE_DIR=C:\Qt\5.6\msvc2013_64
  set WIRESHARK_VERSION_EXTRA=-6tisch
  set WIRESHARK_CYGWIN_INSTALL_PATH=c:\cygwin64

Compile the source code

  mkdir C:\Development\wsbuild64
  cd C:\Development\wsbuild64
  cmake -DENABLE_CHM_GUIDES=on -G "Visual Studio 12 Win64" ..\wireshark
  msbuild /m /p:Configuration=RelWithDebInfo Wireshark.sln

Generate installer

  msbuild /m /p:Configuration=RelWithDebInfo nsis_package_prep.vcxproj
  msbuild /m /p:Configuration=RelWithDebInfo nsis_package.vcxproj

Executable File and installer

The executable file is located at: C:\Development\wsbuild64\run\RelWithDebInfo\Wireshark.exe

The installer is located at: C:\Development\wireshark\packaging\nsis\Wireshark-win64-2.0.3-6tisch.exe

Install wireshark 32-bit

Open a windows command prompt

Setup virtual studio environment for 32-bit version by calling vcvars32.bat

  call "C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\vcvars32.bat" > nul

Setup parameters

  set WIRESHARK_BASE_DIR=C:\Users\user\Desktop\Development
  set WIRESHARK_TARGET_PLATFORM=win32
  set QT5_BASE_DIR=C:\Qt_x86\5.6\msvc2013
  set WIRESHARK_VERSION_EXTRA=-6tisch
  set WIRESHARK_CYGWIN_INSTALL_PATH=c:\cygwin64

Get 6TiSCH dissector source code and extract to wireshark source code

  cd C:\Development\
  git clone https://github.com/openwsn-berkeley/dissectors.git
  cd dissectors
  cp packet* C:\Development\wireshark\epan\dissectors

Compile the source code

  mkdir C:\Development\wsbuild32
  cd C:\Development\wsbuild32
  cmake -DENABLE_CHM_GUIDES=on -G "Visual Studio 12" ..\wireshark
  msbuild /m /p:Configuration=RelWithDebInfo Wireshark.sln

Generate installer

  msbuild /m /p:Configuration=RelWithDebInfo nsis_package_prep.vcxproj
  msbuild /m /p:Configuration=RelWithDebInfo nsis_package.vcxproj

Executable File and installer

The executable file is located at: C:\Development\wsbuild32\run\RelWithDebInfo\Wireshark.exe

The installer is located at: C:\Development\wireshark\packaging\nsis\Wireshark-win32-2.0.3-6tisch.exe
Artifacts built by OpenWSN builder

Wireshark-win32-2.0.3-6tisch.exe

Wireshark-win64-2.0.3-6tisch.exe

on Linux (Ubuntu)

get the source code of dissector and wiresark

cd Desktop
wget https://1.eu.dl.wireshark.org/src/all-versions/wireshark-2.0.3.tar.bz2
tar xaf wireshark-2.0.3.tar.bz2
cd wireshark-2.0.3/epan
mv dissectors dissectors_old
git clone https://github.com/openwsn-berkeley/dissectors.git
cp -a --no-clobber dissectors_old/. dissectors
cd ..

Dependencies installation

sudo apt-get install -y qt5-default
sudo apt-get install -y libqt5multimedia5 libqt5multimediawidgets5
sudo apt-get install -y libgtk-3-dev
sudo apt-get install -y libpcap0.8-dev
sudo apt-get install -y bison flex

Configure and make

./configure
make

Run dissector and create deb package

To run the built wireshark

cd ~/Desktop/wireshark
./wireshark

To create the deb package

cd ~/Desktop/wireshark
dpkg-buildpackage -us -uc -rfakeroot

openwsn-berkeley / dissectors