The RadarLivre system is a mixed software-hardware solution based in the ASD-B technology for monitoring the airspace. The main components are:

• ADS-B receptor
• Software for interpreting the collected data
• Web server that receives the data and store them in a database
• Software for analising the collected information and detecting possible collision between the airplanes and geographical accidents
• Website that presents the data publicly.

This paper will help you get a copy of the project(client-side) to run it with your ADS-B receptor. If you are looking for the server-side, this is the repository. You need both to get the system running, so it is recomended that, if you plan on running in your local machine, install the server first.

This project was designed to run in ubuntu. You need to have these installed before installing the project. The other dependencies are covered when installing.

* Python 2.7

Follow these steps to install, configure and run the server.

HINT: The following commands in these boxes should be used in your terminal.

• Open the terminal by typing CTRL+ALT+T.

• Install Git

sudo apt-get install git

• Clone this repository from github where you want to have your copy installed.

git clone http://github.com/RadarLivre/RadarLivreCollector.git

• Enter the RadarLivre collector directory

cd RadarLivreCollector

• Run INSTALL.sh to install the dependencies.

sudo ./INSTALL.sh

• From now on, you need to have a running server to send the data. If you have not installed it yet and are planning on running it locally, you need to do it now. Now we have to create a superuser to manage collectors inside the server. Read the "Create Superuser" section of your server's README.

• Now, you need to add a collector. Read the "Insert new Collector" section of your server's README.

• Run CONFIGURE.sh and follow the instructions to configure your collector.

sudo ./CONFIGURE.sh

• With the collector configured, we are ready to start sending data. Start the receptor.

sudo ./start_receptor

Congratulations! Now that you you can access your server by going to http://127.0.0.1:8000 in your web browser. If you did it right and the collector is feeding the server, you should see the aircrafts that get close to your receptor. Don't worry if it doesn't show anything, as you just started feeding. The aircrafts will appear as they come close to your receptor's range. Remember that not every airplane have an ASD-B transceiver that you need to get data.

Once you have set up your collector, you can starting sending data by following these steps:

• Run the server (described at the server's README Deployment section).

• Open the terminal by typing CTRL+ALT+T.

• Enter the RadarLivre collector directory

cd RadarLivreCollector

• Start the receptor.

sudo ./start_receptor

Then, your server is going to show any ADS-B transceiver equipped aircraft that gets within range.

• You can stop sending data to the server by pressing CTRL+C(in the terminal).