The last steps
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.
The script will guide you through this process, but you will need these in advance:
Automated setup via script
ADD TEXT and SCREENSHOTS!!!
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.