Pi4 with Raspbian Bookworm

Placeholder for Bookworm instructions. More to follow but as a start:

Burn an SD Card

• Download the Raspberry Pi Imager from https://www.raspberrypi.com/software/
• Run the tool, select your model of Pi, then select Bookworm 64-bit.
• Select your SD card and click Next and then Edit Settings. Make the following changes:
  • If you know your station ID set the Hostname to match it but in lower case. For example if your station is UK1234 set the hostname to uk1234
  • otherwise set the hostname to be something you'll remember
  • Set the username to rms and enter a password of your choice. Remember this!
  • Add your Wifi network details
  • Set the locale to UTC and the keyboard layout to match your keyboard.
  • save settings, and on the next screen click Yes and then Yes again
• Once the image has been burned, insert the SD card into your Pi power it on. The Pi will reboot a few times as it sets things up.

Configure the Operating System

• Login as the rms user you created above and run the following commands to install the system libraries required by RMS.

sudo apt-get install -y cmake git mplayer python3 python3-dev python3-tk python3-pip libblas-dev libatlas-base-dev liblapack-dev at-spi2-core libopencv-dev libffi-dev libssl-dev socat ntp libxml2-dev libxslt-dev imagemagick ffmpeg qt5-qmake python3-pyqt5 libqt5gstreamer-1.0-0 python3-pyqt5.qtmultimedia qtgstreamer-plugins-qt5 libqt5gstreamer-dev libqt5gstreamerui-1.0-0 libqt5gstreamerutils-1.0-0 python3-opencv libcairo2-dev

sudo apt-get install -y gobject-introspection libgirepository1.0-dev
sudo apt-get install -y gstreamer1.0-libav gstreamer1.0-plugins-bad

• now create a python environment for RMS and ensure its always active:

python -m venv ~/vRMS
echo source ~/vRMS/bin/activate >> ~/.bashrc
echo cd ~/source/RMS >> ~/.bashrc

We recommend at this point you logout and log back in, to pick up all the changes you've just made.

Install RMS

• Download the code:

mkdir ~/source
cd ~/source
git clone https://github.com/CroatianMeteorNetwork/RMS.git

• Activate the python environment, if not already active. The prompt will change to (vRMS) rms@yourhostname: if its active.

source ~/vRMS/bin/activate

• Now, set up Python in the environment we just created:

cd ~/source/RMS
pip install -U pip setuptools
pip install -r requirements.txt

• Configure git so that the script can stash changes in the repo and update the code:

git config --global user.email "rms@gmn.uwo.ca"
git config --global user.name "RMS"

• Ready the RMS software for use. This may take some time as the app is built and installed.

cd ~/source/RMS
python setup.py install
./Scripts/GenerateDesktopLinks.sh

Configure RMS

• Fnd your coordinates on the globe. Your location needs to be known very accurately to 5 decimal places for Meteor Science. Use GPS for this or an accurate map. Put this information in the .config file in the RMS directory. If you already have a stationID you can add this to the config file too.

nano ~/source/RMS/.config

• Now run RMS for the first time. You will be asked to confirm a number of system settings. You don't need to expand the filesystem so you can skip over that step.

 ./Scripts/RMS_FirstRun.sh

NB: If you have no station-ID yet, request one with the instructions shown on screen and then abort the script by pressing the Ctrl-C key combination. Once you have your station ID, add it into the .config file and rerun this step.

• Once you've finished the configuration steps, RMS will run an automated update and installation step. Eventually, you'll see a message that RMS is starting up. Let it start up to ensure there are no problems, then once its either waiting for night, or already capturing images, stop it by pressing Ctrl-C and letting the script run its tidy-up steps.

(more to come)