OLD Bare Metal System Image

This page will guide you through the steps to install a basic system image.

On this image you will have the ROS base system, the OpenMower installation, local configuration for your mower and some tools to help you work with the mower.

Prerequisites

In order to follow this guide, you will need the following:

1. A Raspberry Pi 4 (4GB or more recommended, 2GB works with swap, see below)
2. An SD card
3. A soldered OpenMower mainboard

Installing the Base System

There is also a YouTube video explaining the steps in this section: https://youtu.be/_bImqD-pQSA?t=562

Flashing Ubuntu to SD Card

The first step is to install the base system. We're using Ubuntu 20.04 Server for the Raspberry Pi. This is, because this image gives us best support ROS Noetic.

Installing the base image is easy:

1. Get the Raspberry Pi Imager software [1]
2. Select the correct operating system: Other-general-purpose OS > Ubuntu > Ubuntu Server 20.04.4 LTS (RPI 3/4/400)
3. Insert your SD card into your PC and select it in the Storage part of the software
4. Click write and wait for the process to finish

Once you have successfully flashed your image, remove the SD for your PC and reinsert it again.

Then replace the /boot/config.txt file with the one provided here: [2]

This will enable all hardware serial ports on the Raspberry Pi.

Note:

You can theoretically configure networking in this step as well, but I'm not recommending it. This is, because the networking information file gets only copied once and if you have an error it won't work. We need an interactive terminal in the next step anyways.

Once you have done this step, you can eject the SD card and plug it into your Raspberry Pi 4.

Opening a Serial Terminal

Serial Terminal: minicom -D /dev/ttyACM0

This step is needed for the following sections. The goal is to have a serial terminal to do basic config (networking etc) easily.

The easiest way of doing so is:

1. Flash the SerialRedirect firmware into your Pico. Get it here: https://github.com/ClemensElflein/OpenMower/tree/main/Firmware/SerialRedirect/bin
2. Provide your mainboard with power
3. Plug your Pico into a computer. A virtual COM port should appear
4. Connect to the COM port (I'm using minicom, see image on the right), then press enter to start the Raspberry Pi.
5. The Pi boots and a serial terminal will appear.

Now you can login with the default credentials:

username: ubuntu

password: ubuntu

Note that you will need to change the password immediately.

Disable Boot Interrupt

Commands needed to disable boot interrupt on serial input.

The Raspberry Pi boot loader will interrupt the boot sequence if data is sent through the main serial port of the Raspberry Pi. Since we're connecting "nosiy" hardware to the port, this will always interrupt the boot sequence and we need to disable this feature.

In order to do this, reboot the Pi (sudo reboot) and send anything during the count-down in the bootloader (check the YouTube video linked above, if you're not sure).

Then enter the following commands into the bootloader prompt:

setenv bootdelay -2
saveenv
reset

The Pi should reboot and the count-down should be gone.

Some Settings

Here are some miscellaneous settings I think are a good idea for an OpenMower install.

[TODO]

Disable unattended upgrades:

sudo apt remove unattended-upgrades

I like to use static IP

Enable Swap (optional, needed for Pi with <= 2GB RAM)

Compiling the OpenMower software will need more than 2GB of RAM. In order to still do this on a Pi with <= 2GB of RAM, we will add a 2GB swap file to the system by entering the following commands:

# Create a new 2GB swap file
sudo fallocate -l 2G /swapfile
# Change permissions, so that only root can read and write
sudo chmod 600 /swapfile
# Create swap space in the file
sudo mkswap /swapfile
# Add it to the fstab
echo '/swapfile swap swap defaults 0 0' | sudo tee -a /etc/fstab /swapfile swap swap defaults 0 0
# Reboot to activate
sudo reboot

# Check if it's activated
sudo swapon --show

Installing a WiFi Hot-Spot (optional, but recommended)

Since we will be configuring the WiFi interface, make sure that you have connected Etherent to your Raspberry Pi for this step.

As soon as you have closed your mower's enclosure, you won't have physical access to your Raspberry Pi anymore. If for some reason it's unable to connect to your WiFi (e.g. you have changed your password), you would need to open the case to get access to the SD card or Ethernet port on the Pi to regain access.

To prevent this, we're going to install a hot-spot software which helps you to connect to WiFi by opening a hot-spot each time the Pi cannot connect to a known WiFi connection.

Now is the best time to do this, because we have a serial terminal anyways and can mess with the network interfaces without shutting us out of the system!

Just use the following commands for this:

# We need to get a patched version of the network manager for this
wget https://davesteele.github.io/comitup/deb/python3-networkmanager_2.2-1dss02_all.deb
sudo dpkg -i python3-networkmanager_2.2-1dss02_all.deb
rm python3-networkmanager_2.2-1dss02_all.deb
# We also need some python dependencies
sudo apt install python3-cachetools python3-cairo libcairo2
# Install comitup using latest version from the website
wget https://davesteele.github.io/comitup/deb/comitup_1.37-1_all.deb
sudo dpkg -i comitup_1.37-1_all.deb
rm comitup_1.37-1_all.deb
# Disable resolved
sudo systemctl mask systemd-resolved.service
# Remove resolv.conf for some reason
sudo rm /etc/resolv.conf
# Edit comitup.conf to change the wifi name (set ap-name to whatever. I used open-mower-<nn>)
sudo nano /etc/comitup.conf
# Reboot the Pi, the WiFi should be working
sudo reboot
# Log into your pi again and check if DNS is working (e.g. ping google.com). If it's not working edit the following:
sudo nano /etc/NetworkManager/NetworkManager.conf
# and add the following line to the [main] section: dns=8.8.8.8
# reboot again, it should work
sudo reboot

Disable Serial Console

Now that we have setup the network and can access the Pi even if our WiFi is not in range, we need to disable that serial console so that we can use the serial port for hardware.

To do this, enter: sudo nano /boot/firmware/cmdline.txt

and remove the console=serial0,115200 part of the line.

Save the file and reboot. You should still see the bootloader output, but no serial output after that.

Installing Tools

If you're happy with your basic Ubuntu setup, it's time to install some tools required for the OpenMower

General Dependencies

Just install them with apt:

sudo apt install build-essential git

STR2STR (optional, recommended; only needed if you're using NTRIP, so probably most of you)

We need a newer version than the one available in apt, so install it from source:

sudo apt install gfortran
git clone https://github.com/rtklibexplorer/RTKLIB
cd RTKLIB
git checkout tags/b34c
cd RTKLIB/app/consapp/
make -j4
sudo make install

You should now be able to run str2str from anywhere.

OpenOCD (optional, recommended; only needed if you want to flash Pico from Raspberry Pi)

We need to get the OpenOCD version from the Raspberry Pi foundation, because the "original" one doesn't have the Pico support built in yet.

Install it from source:

sudo apt install automake autoconf build-essential texinfo libtool libftdi-dev libusb-1.0-0-dev pkg-config
git clone https://github.com/raspberrypi/openocd.git --recursive --branch rp2040 --depth=1
cd openocd
./bootstrap
./configure --enable-ftdi --enable-sysfsgpio --enable-bcm2835gpio
make -j4
sudo make install

You can test if it was a success by running:

ubuntu@ubuntu:~$ openocd -v
Open On-Chip Debugger 0.11.0-g610f137-dirty (2022-06-07-00:39)
Licensed under GNU GPL v2
For bug reports, read
	http://openocd.org/doc/doxygen/bugs.html

Installing ROS and OpenMower

We're using ROS Noetic for the OpenMower project. In this step we will install it, get the OpenMower sources, build the sources and create a basic configuration file for your mower.

Install ROS Noetic

Since we're running Ubuntu 20.04 installing ROS is as easy as running the following commands:

# Get the ROS apt repository
sudo sh -c 'echo "deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main" > /etc/apt/sources.list.d/ros-latest.list'
curl -s https://raw.githubusercontent.com/ros/rosdistro/master/ros.asc | sudo apt-key add -

# Install the ROS base system
sudo apt update
sudo apt install ros-noetic-ros-base

We only need to register the ROS installation in your .bashrc file. This will enable you to call ROS specific commands from your terminal:

# If you're using bash (default on Ubuntu):
echo "source /opt/ros/noetic/setup.bash" >> ~/.bashrc
source ~/.bashrc

# Else if you're using zsh
echo "source /opt/ros/noetic/setup.zsh" >> ~/.zshrc
source ~/.zshrc

Installing OpenMower Software

Now we're finally able to install the OpenMower software. First, we're checking out the current version of the sources, then we're getting the dependencies and finally we're building the sources.