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
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