Open Mower Wiki - User contributions [en]

Mini HOWTOs

2022-08-30T15:08:46Z

Cutdact: Add setup instructions for ROS Mobile

Here you can find various collected instructions on how to do various tasks related to the OpenMower project. Most are rather impressionistic and are not meant to be detailed, thoroughly tested guides, but more a quick notion on how to do something rather than having to be a detective and find out entirely on your own.

'''''Disclaimer'''''

''This material 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.''

== Warning ==
Please note that this project currently is in a very early stage! So don't go buying stuff right away! You will need to order and solder your own boards, since there are no assembled boards for sale yet.

Please make sure that you're actually allowed to build this device in your area. There may be laws / patents prohibiting you of doing so!

Please just be responsible and if you're not sure what you're doing, please don't do anything.

BTW the warranty of your brand new mower will obviously be void as soon as you modify it in any way, so be aware.

== List of Mini HOWTOs ==

* [[Simple set-up of a RTK base station]]
*[[Setting up ROS on a Raspberry Pi (intended to be the Rover -- OpenMower)]] (placeholder for now)
*[[Flashing firmware on the Pi Pico]]
*[[Flashing Xesc firmware]]
*[[Running an OpenMower simulation]]
*[[Setting up ROS Mobile]]

Setting up ROS Mobile

2022-08-30T15:06:51Z

Cutdact: add missing newline

'''NOTE: THIS CURRENTLY ONLY WORKS WITH THE DEVELOPMENT BRANCH'''

Example configuration for ROS-Mobile for use with OpenMower.

== Install ROS-Mobile ==

Either install ROS-Mobile through the Google Playstore or get the apk file from the [https://github.com/ROS-Mobile/ROS-Mobile-Android/blob/master/app/release/app-release.apk github repository]

== Configure ROS-Mobile ==

Start by adding a new configuration from the menu.

In the tab ''Master'', configure Master IP and Port to the device running OpenMower.

In the ''Details'' tab, Add the following:
[[File:Ros-mobile-viz.png|thumb|Viz example]]
* Add Joystick.
** Viz location: X = 4, Y = 4, Width = 4, Height = 4
** Publisher: Topic Name = joy_vel
* Add Record Dock Button.
** Viz location: X = 0, Y = 10, Width = 4, Height = 2
** Publisher: Topic Name = record_dock
** Parameters: Button text = Record dock
* Add Record Polygon Button.
** Viz location: X = 0, Y = 8, Width = 4, Height = 2
** Publisher: Topic Name = record_polygon
** Parameters: Button text = Record polygon
* Add Save Mowing Area Button.
** Viz location: X = 0, Y = 6, Width = 4, Height = 2
** Publisher: Topic Name = record_mowing
** Parameters: Button text = Save mowing area
* Add Save Navigation Area Button.
** Viz location: X = 0, Y = 4, Width = 4, Height = 2
** Publisher: Topic Name = record_navigation
** Parameters: Button text = Save navigation area

Setting up ROS Mobile

2022-08-30T15:06:03Z

Cutdact: ROS-Mobile setup page

'''NOTE: THIS CURRENTLY ONLY WORKS WITH THE DEVELOPMENT BRANCH'''
Example configuration for ROS-Mobile for use with OpenMower.

== Install ROS-Mobile ==

Either install ROS-Mobile through the Google Playstore or get the apk file from the [https://github.com/ROS-Mobile/ROS-Mobile-Android/blob/master/app/release/app-release.apk github repository]

== Configure ROS-Mobile ==

Start by adding a new configuration from the menu.

In the tab ''Master'', configure Master IP and Port to the device running OpenMower.

In the ''Details'' tab, Add the following:
[[File:Ros-mobile-viz.png|thumb|Viz example]]
* Add Joystick.
** Viz location: X = 4, Y = 4, Width = 4, Height = 4
** Publisher: Topic Name = joy_vel
* Add Record Dock Button.
** Viz location: X = 0, Y = 10, Width = 4, Height = 2
** Publisher: Topic Name = record_dock
** Parameters: Button text = Record dock
* Add Record Polygon Button.
** Viz location: X = 0, Y = 8, Width = 4, Height = 2
** Publisher: Topic Name = record_polygon
** Parameters: Button text = Record polygon
* Add Save Mowing Area Button.
** Viz location: X = 0, Y = 6, Width = 4, Height = 2
** Publisher: Topic Name = record_mowing
** Parameters: Button text = Save mowing area
* Add Save Navigation Area Button.
** Viz location: X = 0, Y = 4, Width = 4, Height = 2
** Publisher: Topic Name = record_navigation
** Parameters: Button text = Save navigation area

File:Ros-mobile-config.png

2022-08-30T15:04:40Z

Cutdact:

Configuration page

File:Ros-mobile-viz.png

2022-08-30T15:02:49Z

Cutdact:

Viz example

Running an OpenMower simulation

2022-08-05T17:37:58Z

Cutdact: Some spellchecking, updated launch file path, updated end path recording

== Introduction ==
You can test the OpenMower software stack yourself by running a simulation where you can record a map and then have it mowed in a simulation on-screen.

It's a bit rough around the edges, but it's a good way to see the software in action without hardware.

This mini-HOWTO is meant to save you a bit of detective work and get you started, not to be a comprehensive guide to the simulation.

== Prerequisites ==
You need the OpenMower software '''on a platform that has ROS and a graphical interface''' for rviz to be able to run and show the map. Ubuntu 20 on a desktop is a good choice, possibly on VM, VirtualBox is an excellent choice, if you do not already have a running Ubuntu 20 desktop environment.

* '''Install ROS on Ubuntu''': http://wiki.ros.org/noetic/Installation/Ubuntu - use the full install
** Note: make sure that you have the ROS environment set up in your terminal by <code>echo "source /opt/ros/noetic/setup.bash" >> ~/.bashrc</code> and log out and back in.
* '''Install the OpenMower software:''' Use the instructions here: [[Setting up ROS on a Raspberry Pi (intended to be the Rover -- OpenMower)]]
** Make sure that you have had <code>catkin_make</code> succeed (may take a few tries, often 4 or more)

You need to have a game controller for controlling the simulated bot.

== Making sure the OpenMower environment is sourced ==
''Whenever you are doing anything in a terminal with OpenMower'', you need to make sure that ROS knows your OpenMower workspace.

In every terminal that you use: <code>source ~/OpenMower/ROS/devel/setup.sh</code>

== Running the simulation ==

=== Recording a map ===
[[File:VirtualBox enable USB.png|thumb|Enable USB ports on VirtualBox]]
Attach your joystick to a USB port. If you are on a VirtualBox, make sure that the USB port of your joystick / gamepad is mapped into your Ubuntu environment (see illustration).

Open a terminal and execute

<code>roslaunch ~/OpenMower/ROS/src/open_mower_ros/open_mower/launch/sim_mower_logic.launch</code>
[[File:Simulation running.png|thumb|OpenMower simulation running]]
This will launch rviz where you can see the Rover and the map.

Use your joystick to record a map and a base. On my gamepad, the buttons are

* 1 - enable movement
* 2 - start path recording
* 4 + ↓ - end path recording
* 3 - register base

Then exit rviz and the map will be recorded in <code>~/.ros/map.bag</code>

If you want to record a new map, delete the old one, <code>rm ~/.ros/map.bag</code>

=== Running the simulation ===
<code>roslaunch ~/OpenMower/ROS/src/open_mower_ros/open_mower/launch/sim_mower_logic.launch</code>

This will launch rviz with the map and rqt_reconfigure where you can control various parameters of the simulation.

You will need to press <code>manual_start_mowing</code> in rqt_reconfigure to start the simulation. You will probably need to zoom out, find your area and then zoom in again on that in rviz.

== Diagnostics / debugging / issues ==

=== Joystick ===
[[File:Which joystick to use.png|thumb|Which joystick to use]]
Your joystick needs to be transmitting messages on the topic /joy. To test that it does:

* Run <code>roslaunch ~/OpenMower/ROS/src/open_mower_ros/open_mower/launch/sim_record_area.launch</code>
* In a new terminal run <code>rostopic echo /joy</code>
You should see messages from the joystick streaming on screen. Test that pressing buttons etc. is reflected in the messages.

If not:

* Check which joysticks your Ubuntu installation knows: <code>ls -l /dev/input/js*</code>
* Try to add/adjust which joystick the recorder uses in sim_record_area.launch to use the correct joystick, see illustration here.

===Buttons===
The control buttons can be edited here:
*movement activation button
**File: <code>~/OpenMower/ROS/src/open_mower_ros/open_mower/launch/sim_record_area.launch</code>
**Line 17: <code><param name="~enable_turbo_button" value="4"/></code>
*area and base recording buttons
**File: <code>~/OpenMower/ROS/src/open_mower_ros/mower_area_recorder/src/area_recorder.cpp</code>
**Lines 61 ff.

==Additional notes / info==

===rviz and OpenMower on different machines ===
This is all running on one platform - the OpenMower simulation AND the graphical interface, hence the choice of desktop to have a graphical environment. In the real situation, the Rover with the OpenMower software is running on a headless Pi. If you still want to have the ability to see paths and maps (which is possible) in rviz, you need to do that on a separate desktop environment. That is possible. You can use the environment that you set up here, but the Rover and on the Desktop must be on the same network and need a little setup in your <code>~/.bashrc</code> to see each other as being part of the same ROS installation.

'''On Rover, in <code>~/.bashrc</code>'''

<code>export ROS_HOSTNAME=192.168.1.126 # replace with your ip for your Rover</code>

<code>export ROS_MASTER_URI=<nowiki>http://192.168.1.126:11311</nowiki> # same as above</code>

'''On Desktop, in <code>~/.bashrc</code>'''

<code>export ROS_HOSTNAME=192.168.1.123 # replace with your ip for your Desktop environment</code>

<code>export ROS_MASTER_URI=<nowiki>http://192.168.1.126:11311</nowiki> # eplace with your ip for your Rover</code>

==== Note on network visibility and guests on VirtualBox====
To make your Ubuntu installation running as guest in VirtualBox be able to have an externally accessible ip number and be able to talk to the Rover, you must

#use a cabled network (not Wifi!!) to your computer that acts as host for VirtualBox and your Ubuntu guest OS
#use a <code>Bridged Adaptor</code> to the cabled interface for the network setup in VirtualBox for your Ubuntu host.