INFLICT

From Navigators

(Difference between revisions)
Jump to: navigation, search
(Ubuntu/Debian)
(Common)
 
(35 intermediate revisions not shown)
Line 1: Line 1:
'''''NOTE: PAGE UNDER CONSTRUCTION'''''
'''''NOTE: PAGE UNDER CONSTRUCTION'''''
-
INFLICT (Integrated Network monitor and FauLt InjeCTor) is a integrated network monitor and fault-injection tool for IEEE 802.15.4 networks.
+
INFLICT (Integrated Network monitor and FauLt InjeCTor) is a integrated network monitor and fault injection tool for IEEE 802.15.4 networks.
== Team ==
== Team ==
Line 11: Line 11:
=== Students ===
=== Students ===
-
*[http://www.navigators.di.fc.ul.pt/wiki/Rui_Pedro_Caldeira Rui Pedro Caldeira]
+
*[http://www.navigators.di.fc.ul.pt/wiki/Rui_Pedro_Caldeira Rui Pedro Caldeira] - MSc Student/Main Developer
-
*[http://www.navigators.di.fc.ul.pt/wiki/Ricardo_Correia_Pinto Ricardo Correia Pinto]
+
*[http://www.navigators.di.fc.ul.pt/wiki/Ricardo_Correia_Pinto Ricardo Correia Pinto] - Co-advisor
-
*[http://www.navigators.di.fc.ul.pt/wiki/Jeferson_L._R._Souza Jeferson L. R. Sousa]
+
*[http://www.navigators.di.fc.ul.pt/wiki/Jeferson_L._R._Souza Jeferson L. R. Sousa] - Co-advisor
== Publications ==
== Publications ==
 +
*[http://www.navigators.di.fc.ul.pt/wiki/Project:KARYON KARYON Project:]<br />
 +
**Deliverable 3.2: [http://goo.gl/YQGJTb http://goo.gl/YQGJTb]<br />
 +
**Deliverable 3.3: [http://goo.gl/hxZcmE http://goo.gl/hxZcmE]<br />
 +
**Deliverable 3.5: [http://goo.gl/DWSsX9 http://goo.gl/DWSsX9]<br />
 +
**Rui Pedro Caldeira, Jeferson L. R. Souza, José Rufino, “[http://www.karyon-project.eu/wp-content/uploads/2014/12/FCUL-poster-3.pdf A Tool for Real-Time Assessment Through Fault Injection in IEEE 802.15.4 Networks]”, Poster in ''Final KARYON open workshop and technical review'', Borås, Sweden, Dec. 2014. <br />
 +
 +
*[http://www.navigators.di.fc.ul.pt/wiki/Project:READAPT READAPT Project:]<br />
 +
**Rui Pedro Caldeira, Jeferson L. R. Souza, Ricardo Correia Pinto, José Rufino, “[http://www.navigators.di.fc.ul.pt/wiki/Publication:A_Tool_for_Real-Time_Assessment_of_IEEE_802.15.4_Networks_Through_Fault_Injection A Tool for Real-Time Assessment of IEEE 802.15.4 Networks Through Fault Injection]”, in ''Proceedings of the 7th Simpósio de Informática (INFORUM)'', Covilhã, Portugal, Sept. 2015.
 +
**Rui Pedro Caldeira, Jeferson L. R. Souza, Ricardo Correia Pinto, José Rufino, “[http://www.navigators.di.fc.ul.pt/wiki/Publication:Caldeira2015Extreme Methods and Tools for Assessment of Wireless Networks in Extreme Environments]”, in ''Proceedings of the IEEE International Conference on Wireless for Space and Extreme Environments (WiSEE)'', Orlando, Florida, United States of America, Dec. 2015.
 +
== Pre-Requisites ==
== Pre-Requisites ==
*One [http://www.ubuntu.com/ Ubuntu]/[https://getfedora.org/ Fedora] based Linux System
*One [http://www.ubuntu.com/ Ubuntu]/[https://getfedora.org/ Fedora] based Linux System
-
*Two [http://www.atmel.com/microsite/AT86RF232/default.aspx Atmel AT86RF232 Low-Power 2.4GHz ISM Transceiver]
+
*One [http://www.microsoft.com/en-us/windows Microsoft Windows 7 or Higher] System if you follow section 4.1.2 of this tutorial
-
*One [http://www.trenz-electronic.de/products/fpga-boards/trenz-electronic/te0600.html Trenz Electronic TE0600-02 FPGA Board]
+
*One [http://www.atmel.com/tools/REB232ED-EK.aspx Atmel REB232ED-EK Evaluation Kit]
-
*One [http://shop.trenz-electronic.de/en/TE0603-03-GigaBee-XC6SLX-carrier-board GigaBee XC6SLX carrier board]
+
*One [http://www.atmel.com/tools/AVRJTAGICEMKII.aspx?tab=overview AVR JTAGICE mkII Programmer/Debugger]
-
== Required Software ==
+
=== Connectivity Requirements ===
 +
Ensure that the host has two RS232 Ports available or don't forget to acquire a RS232-to-USB converter for each port.
-
*[https://bitbucket.org/rcpinto/whipit/ WhiPIT Hardware Description] ([https://bitbucket.org/rcpinto/whipit/get/master.zip ZIP Download])
+
=== Board Connections ===
 +
In PORTE, connect the PIN0 of one board to PIN1 of the other board and vice-versa, doing the same with the pins 4 and 5.
 +
Also connect the general Ground pins of both boards.
-
*[https://bitbucket.org/rpcaldeira/thesis/ ChibiOS/RT with INFLICT Software] ([https://bitbucket.org/rpcaldeira/thesis/get/master.zip ZIP Download])
+
== Required Software ==
-
*[https://bitbucket.org/rpcaldeira/karyon-adapter/ Wireshark Adapter Application] ([https://bitbucket.org/rpcaldeira/karyon-adapter/get/master.zip ZIP Download])
+
*[http://git.lasige.di.fc.ul.pt/rcaldeira/KaryonAdapter/ Wireshark Adapter Application] ([http://git.lasige.di.fc.ul.pt/rcaldeira/KaryonAdapter/repository/archive.zip ZIP Download])
-
*[https://bitbucket.org/rpcaldeira/karyon-wireshark/ Wireshark Network Protocol Analyser] ([https://bitbucket.org/rpcaldeira/karyon-wireshark/get/master.zip ZIP Download])
+
*[http://git.lasige.di.fc.ul.pt/rcaldeira/KaryonWireshark/ Wireshark Network Protocol Analyser] ([http://git.lasige.di.fc.ul.pt/rcaldeira/KaryonWireshark/repository/archive.zip ZIP Download])
   
   
-
*[https://bitbucket.org/rpcaldeira/frame-generator/ Frame Generator] ([https://bitbucket.org/rpcaldeira/frame-generator/get/master.zip ZIP Download])
+
*[http://git.lasige.di.fc.ul.pt/rcaldeira/FrameGenerator/ Frame Generator] ([http://git.lasige.di.fc.ul.pt/rcaldeira/FrameGenerator/repository/archive.zip ZIP Download])
-
*[https://localhost LibreOffice Calc Statistics File Parsing SpreadSheet]
+
*[https://www.libreoffice.org/ LibreOffice]
 +
 
 +
*[https://localhost LibreOffice Statistical Processing Spreadsheet]
 +
 
 +
=== How to use INFLICT ===
 +
 
 +
There are two ways to use
 +
 
 +
==== Plain Binary Upload ====
 +
 
 +
*[http://localhost INFLICT Application - LINK TBD]
 +
 
 +
==== Get the source code and patch it with the INFLICT Software ====
 +
 
 +
*[http://www.atmel.com/tools/IEEE802_15_4MAC.aspx?tab=overview Atmel IEEE 802.15.4 MAC Version 2.8.0]
 +
*[http://www.atmel.com/microsite/atmel_studio6/default.aspx Atmel Studio 6]
 +
*[http://localhost Patch_File]
== Installation Instructions ==
== Installation Instructions ==
Line 47: Line 76:
For the purpose of this example, the chosen directory will be: '''/opt/INFLICT'''
For the purpose of this example, the chosen directory will be: '''/opt/INFLICT'''
-
==== Ubuntu/Debian ====
+
==== Ubuntu/Debian Package Installation ====
<pre>
<pre>
-
$ sudo apt-get -y install build-essential autoconf bison flex libtool libgtk2.0-dev libpcap-dev libc-ares-dev libsmi2-dev libgnutls-dev libgcrypt11-dev libkrb5-dev libcap2-bin libgeoip-dev libortp-dev libportaudio-dev  
+
$ sudo apt-get -y install build-essential autoconf bison flex libtool libgtk2.0-dev libpcap-dev libc-ares-dev
-
$ sudo apt-get -y install openjdk-7-jdk openjdk-7-jre msp430-libc gcc-msp430 msp430mcu git openssh-client
+
$ sudo apt-get -y install libsmi2-dev libgnutls-dev libgcrypt11-dev libkrb5-dev libcap2-bin libgeoip-dev libortp-dev libportaudio-dev  
 +
$ sudo apt-get -y install openjdk-7-jdk openjdk-7-jre git openssh-client
</pre>
</pre>
-
==== Fedora/RedHat/CentOS ====
+
==== Fedora/RedHat/CentOS Package Installation ====
<pre>
<pre>
-
$sudo yum -y groupinstall "Development Tools"
+
$ sudo yum -y groupinstall "Development Tools"
-
$sudo yum -y install bison flex gtk2-devel libpcap-devel c-ares-devel libsmi-devel gnutls-devel libgcrypt-devel krb5-devel GeoIP-devel ortp-devel portaudio-devel openssh msp430-binutils msp430-gcc msp430-libc msp430-libc git java-1.8.0-openjdk java-1.8.0-openjdk-devel
+
$ sudo yum -y install bison flex gtk2-devel libpcap-devel c-ares-devel libsmi-devel gnutls-devel libgcrypt-devel krb5-devel GeoIP-devel ortp-devel portaudio-devel
 +
$ sudo yum -y install openssh git java-1.8.0-openjdk java-1.8.0-openjdk-devel
</pre>
</pre>
-
==== Commom ====
+
==== Common ====
<pre>
<pre>
$ ssh-keyscan bitbucket.com >> ~/.ssh/known_hosts
$ ssh-keyscan bitbucket.com >> ~/.ssh/known_hosts
 +
$ cd /opt
$ cd /opt
$ sudo mkdir INFLICT
$ sudo mkdir INFLICT
$ cd INFLICT
$ cd INFLICT
-
$ git clone git@bitbucket.org:rcpinto/whipit.git
+
$ mkdir ODT
-
$ git clone git@bitbucket.org:rpcaldeira/thesis.git
+
$ mkdir BIN
-
$ git clone git@bitbucket.org:rpcaldeira/karyon-adapter.git
+
 
-
$ git clone git@bitbucket.org:rpcaldeira/karyon-wireshark.git
+
$ git clone git@git.lasige.di.fc.ul.pt:rcaldeira/KaryonAdapter.git
-
$ git clone git@bitbucket.org:rpcaldeira/frame-generator.git
+
$ git clone git@git.lasige.di.fc.ul.pt:rcaldeira/KaryonWireshark.git
-
$ wget TODO: ODT
+
$ git clone git@git.lasige.di.fc.ul.pt:rcaldeira/FrameGenerator.git
 +
$ cd ODT
 +
$ wget TODO: '''ODT'''
 +
$ cd ../BIN
 +
$ wget TODO: '''BIN'''
 +
 
 +
$ cd karyon-adapter/LaSIGE\ Bridge/
 +
$ make
 +
 
 +
$ cd ../..
 +
$ cd karyon-wireshark/Wireshark/
 +
$ ./autogen.sh
 +
$ ./configure --enable-setcap-install
 +
$ make
 +
 
 +
$ cd /usr/bin/
 +
$ sudo ln -s /opt/INFLICT/karyon-adapter/LaSIGE\ Bridge/wsadapter wsadapter
 +
$ sudo ln -s /opt/INFLICT/karyon-wireshark/Wireshark/wireshark karyon-wireshark
</pre>
</pre>

Latest revision as of 00:56, 13 December 2015

NOTE: PAGE UNDER CONSTRUCTION

INFLICT (Integrated Network monitor and FauLt InjeCTor) is a integrated network monitor and fault injection tool for IEEE 802.15.4 networks.

Contents

Team

Advisor

Students

Publications


Pre-Requisites

Connectivity Requirements

Ensure that the host has two RS232 Ports available or don't forget to acquire a RS232-to-USB converter for each port.

Board Connections

In PORTE, connect the PIN0 of one board to PIN1 of the other board and vice-versa, doing the same with the pins 4 and 5. Also connect the general Ground pins of both boards.

Required Software

How to use INFLICT

There are two ways to use

Plain Binary Upload

Get the source code and patch it with the INFLICT Software

Installation Instructions

Manual Installation

Introduction

For the purpose of this example, the chosen directory will be: /opt/INFLICT

Ubuntu/Debian Package Installation

$ sudo apt-get -y install build-essential autoconf bison flex libtool libgtk2.0-dev libpcap-dev libc-ares-dev
$ sudo apt-get -y install libsmi2-dev libgnutls-dev libgcrypt11-dev libkrb5-dev libcap2-bin libgeoip-dev libortp-dev libportaudio-dev 
$ sudo apt-get -y install openjdk-7-jdk openjdk-7-jre git openssh-client

Fedora/RedHat/CentOS Package Installation

$ sudo yum -y groupinstall "Development Tools"
$ sudo yum -y install bison flex gtk2-devel libpcap-devel c-ares-devel libsmi-devel gnutls-devel libgcrypt-devel krb5-devel GeoIP-devel ortp-devel portaudio-devel
$ sudo yum -y install openssh git java-1.8.0-openjdk java-1.8.0-openjdk-devel

Common

$ ssh-keyscan bitbucket.com >> ~/.ssh/known_hosts

$ cd /opt
$ sudo mkdir INFLICT
$ cd INFLICT
$ mkdir ODT
$ mkdir BIN

$ git clone git@git.lasige.di.fc.ul.pt:rcaldeira/KaryonAdapter.git
$ git clone git@git.lasige.di.fc.ul.pt:rcaldeira/KaryonWireshark.git
$ git clone git@git.lasige.di.fc.ul.pt:rcaldeira/FrameGenerator.git
$ cd ODT
$ wget TODO: '''ODT'''
$ cd ../BIN
$ wget TODO: '''BIN'''

$ cd karyon-adapter/LaSIGE\ Bridge/
$ make

$ cd ../..
$ cd karyon-wireshark/Wireshark/
$ ./autogen.sh
$ ./configure --enable-setcap-install
$ make

$ cd /usr/bin/
$ sudo ln -s /opt/INFLICT/karyon-adapter/LaSIGE\ Bridge/wsadapter wsadapter
$ sudo ln -s /opt/INFLICT/karyon-wireshark/Wireshark/wireshark karyon-wireshark

Bash Script

To ease the difficulty of the less experienced users, a Bash Script is provided in order to install automatically all the features of INFLICT. Download link will be available soon.

Acknowledgements and Related Projects

Personal tools
Navigators toolbox