INFLICT

From Navigators

(Difference between revisions)
Jump to: navigation, search
(Required Software)
(Common)
 
(25 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
 +
*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.atmel.com/tools/REB232ED-EK.aspx Atmel REB232ED-EK Evaluation Kit]
*One [http://www.atmel.com/tools/REB232ED-EK.aspx Atmel REB232ED-EK Evaluation Kit]
*One [http://www.atmel.com/tools/AVRJTAGICEMKII.aspx?tab=overview AVR JTAGICE mkII Programmer/Debugger]
*One [http://www.atmel.com/tools/AVRJTAGICEMKII.aspx?tab=overview AVR JTAGICE mkII Programmer/Debugger]
 +
 +
=== 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 ==
== Required Software ==
-
*INFLICT Application - LINK TBD
 
-
*[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 60: Line 93:
<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:rpcaldeira/karyon-adapter.git
+
$ mkdir ODT
-
$ git clone git@bitbucket.org:rpcaldeira/karyon-wireshark.git
+
$ mkdir BIN
-
$ git clone git@bitbucket.org:rpcaldeira/frame-generator.git
+
 
 +
$ 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'''
$ wget TODO: '''ODT'''
 +
$ cd ../BIN
 +
$ wget TODO: '''BIN'''
 +
$ cd karyon-adapter/LaSIGE\ Bridge/
$ cd karyon-adapter/LaSIGE\ Bridge/
$ make
$ make
 +
$ cd ../..
$ cd ../..
$ cd karyon-wireshark/Wireshark/
$ cd karyon-wireshark/Wireshark/
Line 74: Line 116:
$ ./configure --enable-setcap-install
$ ./configure --enable-setcap-install
$ make
$ make
 +
$ cd /usr/bin/
$ cd /usr/bin/
$ sudo ln -s /opt/INFLICT/karyon-adapter/LaSIGE\ Bridge/wsadapter wsadapter
$ sudo ln -s /opt/INFLICT/karyon-adapter/LaSIGE\ Bridge/wsadapter wsadapter

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