README.md 6.97 KB
Newer Older
garciay's avatar
garciay committed
# ETSI ITS protocols project


## General Information

This repositories contains the test specifications and test adapter code for ETSI ITS protocols testing.
ETSI ITS protocols project supports:
- ETSI EN 302 637-2: "Intelligent Transport Systems (ITS); Vehicular Communications; Basic Set of Applications; Part 2: Specification of Cooperative Awareness Basic Service"
- ETSI EN 102 637-3: "Intelligent Transport Systems (ITS); Vehicular Communications; Basic Set of Applications; Part 3: Specifications of Decentralized Environmental Notification Basic Service" 
- ETSI TS 103 301: "Intelligent Transport Systems (ITS); Vehicular Communications; Basic Set of Applications; Facilities layer protocols and communication requirements for infrastructure services"
- EN 302 636-5-1: "Intelligent Transport Systems (ITS); Vehicular Communications; GeoNetworking; Part 5: Transport Protocols; Sub-part 1: Basic Transport Protocol"
- EN 302 636-4-1: "Intelligent Transport Systems (ITS); Vehicular Communications; GeoNetworking; Part 4: Geographical addressing and forwarding for point-to-point and point-to-multipoint communications; Sub-part 1: Media-Independent Functionality"

In addition, it also support ITS Security as define by:
- ETSI TS 103 940: "Intelligent Transport Systems (ITS); Security; Security Architecture and Management".
- ETSI TS 102 941: "Intelligent Transport Systems (ITS); Security; Trust and Privacy Management technical specification"
- IEEE Std 1609.2™-2016: "IEEE Standard for Wireless Access in Vehicular Environments –Security Services for Applications and Management Messages"
- IEEE Std 1609.2a™-2017: "Standard for Wireless Access In Vehicular Environments – Security Services for Applications and Management Messages Amendment 1".

Contact information
Email at cti_support at etsi dot org

License
Unless specified otherwise, the content of this repository and the files contained are released under the ETSI Software License.
See the attached LICENSE file or visit
https://forge.etsi.org/etsi-software-license

## STFs

The following STFs were or are currently involved in the evolutions of the ETSI ITS protocols project:
- STF 405, STF 422, STF 424, STF 455, STF 462, STF 481, STF 484, STF 507, STF 517, STF 525, STF 538, STF 545


## Installation

garciay's avatar
garciay committed
The ETSI ITS protocols project builds and tests regularly on the following platforms:
garciay's avatar
garciay committed

  - Linux (Ubuntu)

### Using Vagrant

Pre-requisites on your host machine:
- Install [Virtualbox](https://www.virtualbox.org/manual/ch01.html)
- Install [Vagrant](https://www.vagrantup.com/intro/getting-started/)
- Credentials to access [ETSI forge](https://oldforge.etsi.org/!/#)
    - Set the environment variable USERNAME to your ETSI OEL account user name
    - Set the environment variable PASSWORD to your ETSI OEL account password

Procedure:
garciay's avatar
garciay committed
- On your host machine, open a command line session (PuTTY, DOS window...)
garciay's avatar
garciay committed
- From the ETSI ITS protocols project, clone the Vagrant folder
garciay's avatar
garciay committed
- In the file Vagrantfilem, odify the tag config.vm.provision replacing <username> & <password> strings by your ETSI credentials
garciay's avatar
garciay committed
- In the Vagrant folder, execute the following commands:

```sh
$ vagrant up --provider virtualbox --provision
...
```

NOTE The creation and the installations will take some time to achieve
- Stop vagrant virtual machine

```sh
$ vagrant halt
...
```

- Update the file 'Vagrantfile' to match with your networks configuration
- Re-start the vagrant virtual machine and log to to the machine

```sh
$ vagrant up
...
$ vagrant ssh
```

garciay's avatar
garciay committed
- Switch to the next clause (Usage)
garciay's avatar
garciay committed


### Using Docbox

Pre-requisites on your host machine:
- Install Virtualbox
- Install Docbox

Procedure:
garciay's avatar
garciay committed
- On your host machine, open a command line session (PuTTY, DOS window...)
garciay's avatar
garciay committed
- On your host machine, clone the ETSI ITS protocols project. NOTE that only Docbox folder and .jenkins.sh script file are required
- From the ETSI ITS protocols project root directory, execute the following commands:

```sh
$ ./.jenkins.sh
...
```

NOTE The creation and the installations will take some time to achieve
- Start the container

```sh
$ ./docker/run-container.sh
# su - etsi
```

- Switch to the next clause (Usage)


### From scratch

Pre-requisites:
- Install Virtualbox

Procedure:
- Install a new Linux Virtual machine (Mint, Debian...)
- Install the following packages
NOTE According to the Linux chosen, the package naming can be different
- Install Java
- Install Eclipse
- Install TITAN
- Create the user/group etsi/etsi
- Switch to the etsi account
- Clone the ETSI ITS protocols project
- ...
- Switch to the next clause (Usage)


## Usage

This clause describes how to compile and execute an Abstract Test Suite.
The procedures below illustrate how to run the CAM test suite. The same procedures will apply for any other ETSI ITS test suite.


Pre-requisites:
- Your machine is installed followimg one of the installation method describes in the previous clause
- Your are logged as 'etsi' user

Procedure using Eclipse TITAN:

Procedure in TITAN command line:
garciay's avatar
garciay committed
- Open several SSH session (PuTTY...)
garciay's avatar
garciay committed
- Change to the directory ~/dev/STF525_Its/src/AtsCAM/objs
- Edit the file ../etc/AtsCAM.cfg
- Update the following fields:
    - system.camPort.params
    - system.utPort.params
- Execute the following command:

```sh
$ ../bin/run-all.bash
# su - etsi
```
garciay's avatar
garciay committed

garciay's avatar
garciay committed
- The log files are located in ../logs folder. Yu can edit them using any editor or using the Eclipse TITAN log plugins
garciay's avatar
garciay committed
- Your machine is installed followimg one of the installation method describes in the previous clause


## Rebuild Wireshark with support of ETSI ITS Protocols

A specific version of Wireshark, based on official version 2.6.x, is available [here](https://github.com/YannGarcia/wireshark-for-ITS.git).

The following Pre-requisites applies to build it:
- Your machine is installed followimg one of the installation method describes in the previous clause
- Your are logged as 'etsi' user

The following procedure applies to build it:
- Open a SSH session (PuTTY...)
- Change to the directory ~/frameworks
- Execute the following comands to clone the project and switch to the branck

```sh
$ git clone https://github.com/YannGarcia/wireshark-for-ITS.git wireshark-for-ITS
$ git checkout ITS_Protocol_Support
```

- Create a folder ~/frameworks/wireshark-build
- Change to this folder
- Generate makefiles executing the following command

```sh
$ cmake ../wireshark-for-ITS
```

- Add specific compiler options the file epan/dissectors/CMakeFiles/dissectors.dir/flags.make:
    - Find the variable C_FLAGS
    - Append the following options: "-Wno-unused-const-variable -Wno-unsued-function "
- Build Wireshark/tshark executing the following command

```sh
$ make
```
garciay's avatar
garciay committed

garciay's avatar
garciay committed
- After the build, binaries are located in ~/frameworks/wireshark-build/run folder
- To distinguish this version of Wireshark from the others, a development tag 'ETSI ITS Protocols' is displayed on the GUI version
garciay's avatar
garciay committed

## How to Report a Bug

garciay's avatar
garciay committed
The ETSI ITS protocols project is under constant development, so it is possible that you will
garciay's avatar
garciay committed
encounter a bug while using it. Please report bugs at cti_support at etsi dot org.