== The OpenMower Community Wiki ==

Welcome to the OpenMower Community Wiki!

This WIKI was only just started on 2022-04-22, but we'll collaborate on getting good information on the OpenMower project collected here.

If you want to contribute to the Wiki: [https://discord.gg/jE7QNaSxW7 join the Discord], ask at the [https://discord.com/channels/958476543846412329/967345181013725194 #wiki-authors channel] for a wiki account and a wiki admin will create one.

Also head over to the [https://discord.com/channels/958476543846412329/967345181013725194 #wiki-authors channel] if you want talk about wiki related stuff.

== How to Get Started ==

One of the first steps currently is to browse around the discord and understand what the project is about. You can also have a look at Clemens' second video ([https://www.youtube.com/watch?v=_bImqD-pQSA here]) of the project that details how to assemble the bot.

First: Check the '''[[FAQ]]'''

When you're ready, you can have a look at the '''[[Building the Mower]]''' section to see the Bill of Materials and steps required and check out '''[[Builder Road Map]]''' for a practical take on what to do.

<big>(Note this wiki is in progress and not complete yet, but we're working on it!)</big>

<big>'''⚡ Before checking out the community wiki head over to the Official Documentation at [https://openmower.de/ openmower.de] ⚡'''</big>

==Resources==

===[[FAQ]]===

<big>There is a continually evolving [[FAQ]] that is a good starting point for understanding the project and getting answers to some key questions.</big>

===[[Project overview|Project overview and timeline]]===

Current status and future goals - [[Project overview|See it here]]

===Hardware Revisions===

Open Mower hardware revisions, changelog, info: [https://openmower.de/docs/versions/ Moved to the official docs]

===[[System Image|Software Installation]] ''Old bare metal installation - not for users''===

On this page, you can find steps how to install a basic OpenMower system image.

===[[Running OpenMower]]===

On this page, you can find steps how to run the OpenMower software.
We're doing:
- Starting the Software
- Magnetometer Calibration
- Recording a Map
- Starting the Mowing Process

===[[Mini HOWTOs]]===

On this page, you can find small HOWTOs for various things. Set [[Mini HOWTOs|here]]

===Where to find more information===

The entry points for more information are:

*[https://discord.com/channels/958476543846412329/958476543846412331 The Discord for the project]
*[https://discord.com/channels/958476543846412329/958476543846412332 Annoncements in the Discord]
*[https://youtube.com/c/ClemensElflein/videos YouTube]
*[https://github.com/ClemensElflein/OpenMower Open Mower Main GitHub Repo - Overall and hardware]
*[https://github.com/ClemensElflein/open_mower_ros Open Mower GitHub Repo for the ROS logic in the OpenMower]
*[https://github.com/ClemensElflein/xESC xESC Motor Controller Repo (custom part for main board)]

==How to contribute==

At the moment, there are different ways to contribute:

*Building your own mower, testing the software and reporting bugs / committing fixes on the github repository

*If you're not scared to see the inside of some mowers, please help us understand more about how they are built following instructions in the '''[[Mower Dissection]]''' page.

*And finally, [https://www.patreon.com/ClemensElflein Patreon to support Clemens' amazing work]

==Disclaimer==

''This Wiki is provided as-is and free of charge. No guarantees of any kind are made that the information contained herein is exact or correct or does not violate any local regulations or cause any security risk. Any use you make of any information given here is at your own discretion and risk.''

2022-08-09T21:49:42Z

Potter-91: /* Opening a Serial Terminal */

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:

#A Raspberry Pi 4 (4GB or more recommended, [[System Image#Enable Swap (optional, needed for Pi with <= 2GB RAM)|2GB works with swap, see here]])
#An SD card
#A soldered OpenMower mainboard

==Installing the Base System==

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

=== 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:

#[https://www.raspberrypi.com/software/ Get the Raspberry Pi Imager software]
#Select the correct operating system: ''Other-general-purpose OS > Ubuntu > Ubuntu Server 20.04.4 LTS (RPI 3/4/400) 64-bit''
#Insert your SD card into your PC and select it in the ''Storage'' part of the software
#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 <code>/boot/config.txt</code> file with the one provided here: [https://github.com/ClemensElflein/OpenMower/blob/main/configs/RaspberryPiConfig/config.txt]

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 ===
[[File:SerialRedirect.png|thumb|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:
# Flash the SerialRedirect firmware into your Pico. Get it here: https://github.com/ClemensElflein/OpenMower/tree/main/Firmware/SerialRedirect/bin
# Provide your mainboard with power
# Plug your Pico into a computer. A virtual COM port should appear
# Connect to the COM port (I'm using minicom, see image on the right), then press enter to start the Raspberry Pi.
#The Pi boots and a serial terminal will appear.

Now you can login with the default credentials:

username: <code>ubuntu</code>

password: <code>ubuntu</code>

Note that you will need to change the password immediately.

=== Disable Boot Interrupt ===
[[File:Image.png|thumb|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:
<syntaxhighlight lang="bash">
setenv bootdelay -2
saveenv
reset
</syntaxhighlight>
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: <code>sudo apt remove unattended-upgrades</code>

- I like to add the following to <code>cmdline.txt</code> in order to fsck on boot: <code>fsck.mode=force fsck.repair=yes</code>

- I prefer to use a 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:<syntaxhighlight lang="bash" line="1">
# 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
</syntaxhighlight>

=== 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:<syntaxhighlight lang="bash">
# If dpkg throws an error like
# dpkg: error processing package ... (--install):
# dependency problems - leaving unconfigured
# you need some dependencies, correct them by running:
sudo apt install -f
# and then try it again

# 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.38-1_all.deb
sudo dpkg -i comitup_1.38-1_all.deb
rm comitup_1.38-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
</syntaxhighlight>

=== 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: <code>sudo nano /boot/firmware/cmdline.txt</code>

and remove the <code>console=serial0,115200</code> 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:<syntaxhighlight lang="bash">
sudo apt install build-essential git
</syntaxhighlight>

=== 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:<syntaxhighlight lang="bash" line="1">
sudo apt install gfortran
git clone https://github.com/rtklibexplorer/RTKLIB
cd RTKLIB
git checkout tags/b34c
cd app/consapp/
make -j4
sudo make install
</syntaxhighlight>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:<syntaxhighlight lang="bash" line="1">
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
</syntaxhighlight>You can test if it was a success by running:<syntaxhighlight>
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
</syntaxhighlight>

== 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:<syntaxhighlight lang="bash" line="1">
# 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
</syntaxhighlight>We only need to register the ROS installation in your .bashrc file. This will enable you to call ROS specific commands from your terminal:<syntaxhighlight lang="bash">
# 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
</syntaxhighlight>

=== 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:

<syntaxhighlight lang="bash" line="1">
# Clone the GitHub Repository:
git clone --recursive https://github.com/ClemensElflein/open_mower_ros.git

# Get rosdep, only needed once
sudo apt install python3-rosdep
sudo rosdep init
rosdep update

# Get the dependencies using rosdep
cd open_mower_ros/
rosdep install --from-paths src --ignore-src --default-yes

# Finally, build the sources (do -j4 only on 8GB Raspberry Pis). This will take a while!
catkin_make -j1

# Copy the default configuration file to your home directory
cp open_mower_ros/src/open_mower/config/mower_config.sh.example ~/mower_config.sh

# The next step is to also source the OpenMower ROS install
# If you're using bash (default on Ubuntu):
echo "source /home/ubuntu/open_mower_ros/devel/setup.sh" >> ~/.bashrc
echo "source /home/ubuntu/mower_config.sh" >> ~/.bashrc
source ~/.bashrc

# Else if you're using zsh
echo "source /home/ubuntu/open_mower_ros/devel/setup.zsh" >> ~/.zshrc
echo "source /home/ubuntu/mower_config.sh" >> ~/.zshrc
source ~/.zshrc
</syntaxhighlight>At this point the OpenMower software is successfully installed! You will need to configure the OpenMower software and then you're finally ready to mow.

== Some Additional Issues ==

=== I'm using an external WiFi dongle for better coverage, but sometimes it doesn't work ===
It seems that the Ubuntu sometimes puts external WiFi dongles to sleep. To prevent this, we create a service which disables powersave:<syntaxhighlight lang="bash" line="1">
# Enter this to create the service
sudo systemctl --full --force edit wifi_powersave@.service

# Paste the following:
[Unit]
Description=Set WiFi power save %i
After=sys-subsystem-net-devices-wlan1.device

[Service]
Type=oneshot
RemainAfterExit=yes
ExecStart=/sbin/iw dev wlan1 set power_save %i

[Install]
WantedBy=sys-subsystem-net-devices-wlan1.device

# Save and exit, then activate using:
sudo systemctl disable wifi_powersave@on.service
sudo systemctl enable wifi_powersave@off.service
</syntaxhighlight>

OLD Bare Metal System Image

2022-08-09T21:48:01Z

Potter-91: /* Flashing Ubuntu to SD Card */

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:

#A Raspberry Pi 4 (4GB or more recommended, [[System Image#Enable Swap (optional, needed for Pi with <= 2GB RAM)|2GB works with swap, see here]])
#An SD card
#A soldered OpenMower mainboard

==Installing the Base System==

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

=== 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:

#[https://www.raspberrypi.com/software/ Get the Raspberry Pi Imager software]
#Select the correct operating system: ''Other-general-purpose OS > Ubuntu > Ubuntu Server 20.04.4 LTS (RPI 3/4/400) 64-bit''
#Insert your SD card into your PC and select it in the ''Storage'' part of the software
#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 <code>/boot/config.txt</code> file with the one provided here: [https://github.com/ClemensElflein/OpenMower/blob/main/configs/RaspberryPiConfig/config.txt]

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 ===
[[File:SerialRedirect.png|thumb|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:
# Flash the SerialRedirect firmware into your Pico. Get it here: https://github.com/ClemensElflein/OpenMower/tree/main/Firmware/SerialRedirect/bin
# Provide your mainboard with power
# Plug your Pico into a computer. A virtual COM port should appear
# Connect to the COM port (I'm using minicom, see image on the right), then press enter to start the Raspberry Pi.
#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 ===
[[File:Image.png|thumb|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:
<syntaxhighlight lang="bash">
setenv bootdelay -2
saveenv
reset
</syntaxhighlight>
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: <code>sudo apt remove unattended-upgrades</code>

- I like to add the following to <code>cmdline.txt</code> in order to fsck on boot: <code>fsck.mode=force fsck.repair=yes</code>

- I prefer to use a 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:<syntaxhighlight lang="bash" line="1">
# 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
</syntaxhighlight>

=== 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:<syntaxhighlight lang="bash">
# If dpkg throws an error like
# dpkg: error processing package ... (--install):
# dependency problems - leaving unconfigured
# you need some dependencies, correct them by running:
sudo apt install -f
# and then try it again

# 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.38-1_all.deb
sudo dpkg -i comitup_1.38-1_all.deb
rm comitup_1.38-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
</syntaxhighlight>

=== 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: <code>sudo nano /boot/firmware/cmdline.txt</code>

and remove the <code>console=serial0,115200</code> 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:<syntaxhighlight lang="bash">
sudo apt install build-essential git
</syntaxhighlight>

=== 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:<syntaxhighlight lang="bash" line="1">
sudo apt install gfortran
git clone https://github.com/rtklibexplorer/RTKLIB
cd RTKLIB
git checkout tags/b34c
cd app/consapp/
make -j4
sudo make install
</syntaxhighlight>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:<syntaxhighlight lang="bash" line="1">
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
</syntaxhighlight>You can test if it was a success by running:<syntaxhighlight>
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
</syntaxhighlight>

== 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:<syntaxhighlight lang="bash" line="1">
# 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
</syntaxhighlight>We only need to register the ROS installation in your .bashrc file. This will enable you to call ROS specific commands from your terminal:<syntaxhighlight lang="bash">
# 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
</syntaxhighlight>

=== 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:

<syntaxhighlight lang="bash" line="1">
# Clone the GitHub Repository:
git clone --recursive https://github.com/ClemensElflein/open_mower_ros.git

# Get rosdep, only needed once
sudo apt install python3-rosdep
sudo rosdep init
rosdep update

# Get the dependencies using rosdep
cd open_mower_ros/
rosdep install --from-paths src --ignore-src --default-yes

# Finally, build the sources (do -j4 only on 8GB Raspberry Pis). This will take a while!
catkin_make -j1

# Copy the default configuration file to your home directory
cp open_mower_ros/src/open_mower/config/mower_config.sh.example ~/mower_config.sh

# The next step is to also source the OpenMower ROS install
# If you're using bash (default on Ubuntu):
echo "source /home/ubuntu/open_mower_ros/devel/setup.sh" >> ~/.bashrc
echo "source /home/ubuntu/mower_config.sh" >> ~/.bashrc
source ~/.bashrc

# Else if you're using zsh
echo "source /home/ubuntu/open_mower_ros/devel/setup.zsh" >> ~/.zshrc
echo "source /home/ubuntu/mower_config.sh" >> ~/.zshrc
source ~/.zshrc
</syntaxhighlight>At this point the OpenMower software is successfully installed! You will need to configure the OpenMower software and then you're finally ready to mow.

== Some Additional Issues ==

=== I'm using an external WiFi dongle for better coverage, but sometimes it doesn't work ===
It seems that the Ubuntu sometimes puts external WiFi dongles to sleep. To prevent this, we create a service which disables powersave:<syntaxhighlight lang="bash" line="1">
# Enter this to create the service
sudo systemctl --full --force edit wifi_powersave@.service

# Paste the following:
[Unit]
Description=Set WiFi power save %i
After=sys-subsystem-net-devices-wlan1.device

[Service]
Type=oneshot
RemainAfterExit=yes
ExecStart=/sbin/iw dev wlan1 set power_save %i

[Install]
WantedBy=sys-subsystem-net-devices-wlan1.device

# Save and exit, then activate using:
sudo systemctl disable wifi_powersave@on.service
sudo systemctl enable wifi_powersave@off.service
</syntaxhighlight>