Table of Contents

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 RMDS02C hardware version of the station with an Odroid-X2 computer.

Installed operating system is Lubuntu 14.04 LTS.

OS image

Download an OS image for station with ODROID-X2 computer in Bolidozor.

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:

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 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 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.

You can find a more detailed information for installations from scratch or in case of difficulties with SW or HW at MLAB wiki. Na předpřipraveném image pro síť Bolidozor by měly být hotové. (?? čo). Then you can follow with launching a detection on a station

Launching a meteor detection on station

Before the first start, you have to copy a config file nazev_binarky.json from directory containing 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.

You can find a description of the Bolidozor network’s config file at radio-observer.

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

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 data upload scripts can be found at 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 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 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

There is also a commented variant of launching the detection of meteors directly in the pysdr in the script.

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

and on PC:

This is how a meteor detected within the sound streem looks like in pysdr

or in radio-observer