The last steps

From Global Meteor Network
Jump to navigation Jump to search

WARNING: THIS IS A PAGE IN PROGRESS! DO NOT FOLLOW IT IF YOU ARE LOOKING FOR THE BUILDING OF A CAMERA FROM SCRATCH

Ahoj! In this section, you will put your camera into the production stream on the server side by finishing configuration of RMS software in Linux.

Automated setup via script

ADD TEXT and SCREENSHOTS!!! The script will guide you through this process, but you will need these in advance:

  • Station code - you have requested it previously - if not please do so now by sending an email to denis.vida@gmail.com with short introduction, stating that you are building the camera, stating from which country you are and asking for the station code. You will need it later when setting up the RMS software once your camera is fully installed and positioned.
  • GPS coordinates of your camera - see the script, it is explaining how to obtain these or scroll down and check section "Determining the location of the camera"

Once you got this information, proceed with the automated configuration script.

This is what you should see when you boot your raspberry and connect to it via VNC (or anydesk):

The first boot raspi.png

Follow the instructions on the screen:

  • Press Q to continue
  • Press ENTER to continue

Now the script will explain what lies ahead of you:

The first boot raspi 1.png

Follow the instructions on the screen:

  • If you have flashed this SD card yourself, press ENTER.

Now the script will open a new window and give you exact instructions on how to expand the filesystem (to use the full capacity of the SD card/USB key). Follow these instructions:

The first boot raspi 2.png

Now wait for the boot of your Raspberry Pi and once it is up, connect to it usual way. Unfortunately, you will need to do all the previous steps except for the Filesystem expansion, where instead of pressing ENTER, you will press Q this time and then the script will check Internet connection and asks you to change the password - please do so, use a strong password and save it in your favourite Password manager (e.g. KeePass). You will be asked to provide the current password, which is "rmsraspberry" without quotes.

The first boot raspi 3.png

Now the SSH keys used to upload data to the GMN server will be generated - press ENTER, wait until the SSH keys are generated. Don't send the SSH key to Denis yet, wait until we are done, so you can provide GPS coordinates as well.

The first boot raspi 4.png

Press ENTER to continue. Now the RMS will update itself, please wait until done (this may take a lot of time).

Manual setup via command line

Capture software

The recording program is called RMS.StartCapture. A script that auto-updates the code is called RMS_FirstRun and it will start automatically when the RPi boots up, after which the recording loop will start. Note that during the update procedure, the config file will be reset. Please wait until the update is done, and your old config file will be copied back.

The capture will automatically start with sundown and stop with sunrise, although this is very dependent on the correct location of the camera being entered in the configuration file (see the Configuration section below). Configuration Changing the system password If you haven’t changed your password during the initial configuration through the terminal window, so we strongly recommend that you change it.


How to do it:

Boot up your RPi. Open the terminal by clicking Start (RPi icon) → Accessories → Terminal In the window that pops up, type passwd and press enter. You will be asked to enter your current password - which is raspberry or rmsraspberry - and then your new password. Keep this new password in a secure place.

Determining the location of the camera

To participate in the network you will need a unique station code. We will generate one for you once you let us know the exact geographical location of the camera. Measuring the precise location of the camera is very important for triangulating meteor trajectories - the location of you camera will not be shared with anyone without your consent.

How to do it: Use a GPS app on your smartphone to measure the location by holding the phone close to the camera and write down the latitude, longitude and elevation. In the worst case, use Google Maps. Please use the precision for the longitude and latitude of at least 5 decimal places (or to within one “), and the elevation to a meter.

Generating an SSH key

Every morning all meteor detections from the previous night are uploaded to the server, where trajectories and orbits of meteors are estimated. The system uses a secure way of talking to our server at the University of Western Ontario, and for that to work you need to generate an SSH key for your RPi and send it to us.

How to do it: Boot up your RPi Open the terminal by clicking Start (RPi icon) → Accessories → Terminal Type: ssh-keygen -t rsa -m PEM and press enter You will be asked where to save the SSH key, but just press enter. If it asks you to overwrite the existing key, type y and press enter. You will be asked for a passphrase two times. Don’t type anything and just press enter both times. Type cat ~/.ssh/id_rsa.pub and press enter. Your SSH key will be printed to the terminal. The key starts with “ssh-rsa”, followed by a long string of characters, and it ends with “pi@raspberry”. Copy the whole key and send it to yourself via e-mail, or in any other way to keep it for later.

Obtaining the station code

Send an e-mail to denis.vida@gmail.com with a short description of your camera, the country where the camera is located in, the geographical coordinates and the SSH key you have generated and copied in the step above. Also, send an approximate pointing of the camera - the azimuth measured from due North, and the elevation. You can measure the azimuth using a compass (or an compass app), and you can eyeball the elevation (0 degrees being the horizon, 90 degrees the zenith, i.e. straight up). You will receive your unique station code within a period of several days at most. The station code consists of the ISO Alpha-2 country code followed by four alphanumeric characters, e.g. US00A2.

Modifying the configuration file

Boot up your RPi On the desktop there is a file called “RMS config”, open it. Under the “[System]” section, write the station ID and the coordinates of your camera, which should look something like this: [System] stationID: CA0003 latitude: 42.7961 ; +N in degrees longitude: -81.84219 ; +E in degrees elevation: 312 ; meters

Make sure to leave a space before the semicolon at the end of the line! For example: Good: latitude: 42.7961 ; +N in degrees Bad: latitude: 42.7961; +N in degrees

Under the “[Upload]” section, change:

upload_enabled: false

To:

upload_enabled: true

Save the file by pressing File → Save. All done!


Making a detection mask

If there is something in the field of view of the camera, e.g. a tree, a building, roof, etc., it may interfere with the detection. The way to fix this is to create a detection mask.

If you don’t have anything in your field of view, you don’t have to do anything!


Alternatively you may ask Denis to help you with the detection mask @ denis.vida@gmail.com.

Calibration

After the first clear night of operation, the system will image some stars. Let Denis know @ denis.vida@gmail.com that your station uploaded some good data to the server, and based on that we will generate an astrometric plate. The plate is basically a way of converting image coordinates to celestial coordinates, and you will need to put on your RPi once we send it to you. We will send you a platepar_cmn2010.cal file, just ask us for one!

Download the platepar_cmn2010.cal to your RPi. Copy it into ~/source/RMS/ All done! Your system will automatically calibrate the data it records every night, and this data will be used to estimate meteor trajectories and orbits on the server!

If you want to do the calibration yourself, you can do that yourself on your Raspberry Pi following this video - it is fun and you will try software called SkyFit2:


You are now done with this section and now you may proceed with the optional steps, please make sure to at least go through the optional steps. Back to the signpost page.