FIXME **This page is not fully translated, yet. Please help completing the translation.**\\ //(remove this paragraph once the translation is finished)//


====== Installing an ODROID station in the Bolidozor network ======

This guide presumes a [[http://wiki.mlab.cz/doku.php?id=en:rmds02#radiova_meteoricka_detekcni_stanice_rmds02c|RMDS02C]] hardware version of the station with an [[http://wiki.mlab.cz/doku.php?id=cs:odroid-x2|Odroid-X2]] computer.

Installed operating system is Lubuntu 14.04 LTS.

===== OS image =====

<WRAP download> 
Download an [[http://space.astro.cz/bolidozor/support/odroid/lubuntu_odroidX2_Bolidozor.tar.bz2|OS image]] for station with [[http://wiki.mlab.cz/doku.php?id=en:odroid-x2|ODROID-X2]] computer in Bolidozor.
</WRAP>

The downloaded image has to be decompressed and copied onto an eMMC card. The name of the eMMC card can be found after inserting the card into a card reader and seeing the dmesg listing.   

  xz -d lubuntu_odroid.img.xz 
  sudo dd if=lubuntu_odroid.img of=/dev/sdb bs=1M
  sync

After copying the image to eMMC card, boot the ODROID and do the other settings directly in it.
Default login are as follows:
  * Username: odroid
  * Password: Bolidozor

===== Configuring the image =====

The image on the SD card has to be adjusted in order to function correctly in the network.

There is an account ‘odroid’ with password ‘odroid’ created in Lubuntu. The odroid user is sudoer. Change the password as soon as possible using passwd command.   

Change the station’s name in the following files

  /etc/hostname
  /etc/hosts
  
Chang the MAC address in the following file

  /etc/smsc95xx_mac_addr
  
A new MAC address can be generated directly from the [[http://serverfault.com/questions/299556/how-to-generate-a-random-mac-address-from-the-linux-command-line|command line]], using the following command:

  $(echo $FQDN|md5sum|sed 's/^\(..\)\(..\)\(..\)\(..\)\(..\).*$/02:\1:\2:\3:\4:\5/')

In this way a new address is generated based on an [[http://cs.wikipedia.org/wiki/FQDN|absolute domain name of the computer]]. Therefore it is necessary to first change the station’s name and only afterwards generate a new MAC address for odroid.

Change a time zone (set it to UT) and station’s location

  sudo dpkg-reconfigure tzdata
  
Sometimes it is also necessary to generate a local settings, e.g.:
  sudo locale-gen cs_CZ.UTF-8

Finally, expand the ext4 partition using GParted to the full size of the SD card. It is also possible to use odroid-config.

<WRAP info> You can find a more detailed information for installations from scratch or in case of difficulties with SW or HW at [[http://wiki.mlab.cz/doku.php?id=en:rmds02|MLAB wiki]]. Na předpřipraveném image pro síť Bolidozor by měly být hotové. (?? čo). Then you can follow with [[cs:odroid#spusteni_detekce_meteoru_na_stanici|launching a detection on a station]]</WRAP>
 
===== Launching a meteor detection on station =====

Before the first start, you have to copy a config file //nazev_binarky.json//  from directory containing [[cs:radio-observer|radio-observer]] source code to a home directory of ODROID user. This file has to be re-named according to the name of the station and it has to be changed according to the location of a folder where the data about detected meteors will be saved. 

<WRAP info> You can find a description of the Bolidozor network’s config file at  [[cs:radio-observer#konfiguracni_soubor|radio-observer]].</WRAP>


<WRAP important> 
Directories that will contain data about meteors, which the config file refer to, have to already exist. If they do not exist, create them.
</WRAP>

Run the detection using the script

  ~/Bolidozor/netstart.sh

The script can be run directly on the station or it can be redirected, via ssh, to a remote xserver.
An example of running ssh with redirecting to xserver of a computer that we kterého provádíme přihlášení (??)

  ssh odroid@nazev_stanice -X
  ~/Bolidozor/netstart.sh
  
==== Netstart.sh script description ====
  ulimit -c unlimited
  ~/Bolidozor/frequency_log.py 1 286.0788&
  jackd -d alsa -dhw:1&
  sleep 3
  qjackctl&
  sleep 4
  jacktrip -q 8 -r 3 -s&
  sleep 3
  ~/Bolidozor/ODROID3/ODROID3&
  sleep 3
  jack_connect alsa_in:capture_1 system:playback_1
  jack_connect alsa_in:capture_2 system:playback_2
  jack_connect ODROID3:midi_out system:playback_3

The above-mentioned sample script uses ODROID3 as a station’s name.

=== ulimit ===
Ensures saving a core dump if there is an exception in any application.

=== frequency_log.py ===
Automatically tunes the radio, so that the zázněj (??) of GRAVES carrier frequency was at 10.6 kHz.

=== jackd -d alsa -dhw:1& ===
Launches JACK server with an audio source from card 1. and using alsa driver.

=== qjackctl ===
It can be omited. It launches graphic application that helps to see if the server is running and what is connected to what (??).

=== jacktrip ===
Launches jacktrip client for transfer of audio data over a network.

=== ~/Bolidozor/jmeno_stanice/jmeno_stanice ===
Runs the radio-observer - detected meteors begin to be saved into a directory specified in .json config file.

=== jack_connect ===
Interconnects all application in case there is a monitoring station connected to the network.


===== Scripts for data upload =====

Source codes of [[en:data-uploader|data upload]] scripts can be found at [[https://github.com/bolidozor/RMDS-data-uploader|Bolidozor github]].

You can also find them on station in //~/git/RMDS-data-uploader//. In order to turn the data upload on, you have to change a //~/git/RMDS-data-uploader/config.py// config file according to your station’s name and location of files. Then you can run run.py in [[http://en.wikipedia.org/wiki/GNU_Screen|screen]].

  screen
  cd ~/git/RMDS-data-uploader/
  ./run.py

A running screen can be left using key shortcut CTRL-A followed by CTRL-D. When set correctly, the config.py uploader sorts the data and uploads them on the central data server space.astro.cz. 


===== Monitoring of detected meteors on PC =====

You can run a visualisation of detected meteors on any PC connected to LAN. Follow the sequence of commands (that can be placed to netmaster.sh script):

  jackd -r -d alsa&
  sleep 3
  qjackctl&
  sleep 3
  ~/git/pysdr/pysdr-waterfall&
  #~/git/pysdr/pysdr-waterfall -d ~/git/pysdr/detectors/meteor_echo.py&
  sleep 3
  ~/git/pysdr/whistle/whistle -p freqx,-10400:kbfir,41,0,400,100:freqx,400:amplify,200&
  sleep 3
  jack_netsource -H odroid -i2 -I1 -o0 -O0&

=== jackd ===
Runs a local JACK server.

=== qjackctl ===
A tool for connecting applications in JACK.

=== pysdr-waterfall ===

Launches waterfall visualisation. In our case, the [[en:pysdr|OpenGL waterfall display pySDR]] is installed in ~/git/pysdr directory. Pysdr can be dowloaded to this directory using the following command:

  git clone https://github.com/MLAB-project/pysdr


<WRAP tip> 
There is also a commented variant of launching the detection of meteors directly in the pysdr in the script.
</WRAP>

=== whistle ==
Generates sounds of meteors.

===  jack_netsource ===
Connects JACK to ODROID via network.

It is convenient to create a netstop.sh batch

  killall whistle
  killall jack_netsource
  killall jackd
  killall qjackctl

that will terminate everything. Pysdr-waterfall has to be terminated manually by closing its window.

If everything is running, we have to connect everything on both computers using qjackctl or jack_connect. 

Connecting the JACK components should look the following way on Odroid

{{:cs:jack:screenshot_from_2014-07-04_23_53_44.png?400|}}

{{:cs:jack:screenshot_from_2014-07-04_23_53_54.png?400|}}

and on PC:

{{:cs:jack:screenshot_from_2014-07-04_23_54_07.png?400|}}

{{:cs:jack:screenshot_from_2014-07-04_23_54_17.png?400|}}

This is how a meteor detected within the sound streem looks like in [[en:pysdr|pysdr]] 

{{:cs:pysdr:meteor_pysdr.jpg?500|}}

or in [[en:radio-observer|radio-observer]]

{{:cs:radio-observer:meteor_radio_observer.jpg?500|}}