Mission template software: Difference between revisions

From Rsewiki
 
(12 intermediate revisions by 2 users not shown)
Line 2: Line 2:


This is an example software in C++ to access both raspberry camera and REGBOT, and with an example mission controlled from the raspberry.
This is an example software in C++ to access both raspberry camera and REGBOT, and with an example mission controlled from the raspberry.
====Get software====


Get the ROBOBOT software from the svn repository:
Get the ROBOBOT software from the svn repository:
Line 10: Line 12:


  svn up
  svn up
====Compile====


To be able to compile the demo software CMAKE needs also to use the user installed library (raspicam installed above),  
To be able to compile the demo software CMAKE needs also to use the user installed library (raspicam installed above),  
Line 30: Line 34:
It should print that the camera is open and connected to the robot (bidge).
It should print that the camera is open and connected to the robot (bidge).


====Software structure====
===Software structure===
 
The sound system can be used for debugging, e.g. add a C++ line like:
 
system("espeak \"bettina reached point 3\" -ven+f4 -a30 -s130");
 
This line makes the robot say "bettina reached point 3" the parameters "-a30" turns amplitude down to 30%, "-ven+f4" sets language to english with female voice 4 and "-s130" makes the speech a little slower and easier to understand.
It requires that espeak is installed (sudo apt install espeak).
 
To use on Raspberry pi, it is better to use
 
system("espeak \"Mission paused.\" -ven+f4 -s130 -a60 2>/dev/null &");
 
The "2>/dev/null" tell that error messages should be dumped, and the final "&" say that it should run in the background (not to pause the mission).
 
===AruCo Marker===
 
The camera class contains some functions to detect Aruco markers.
It it described in more details on [[AruCo Markers]].
 
===Software documentation (doxygen)===


The software is structures as shown in figure 1 below.
[[File:inherit_graph_2.png | 200px]]


[[file:mission-software.png | 500px]]
Figure: generated with doxygen http://aut.elektro.dtu.dk/robobot/doc/html/classes.html


Figure 1. The example mission software intended as basis for full mission control. In the main.cpp file, three objects are created: bridge (UBridge reg(127.0.0.1)), camera (UCamera cam()) and mission (UMission mission(&reg, &cam)). The bridge handles communication and stores all data from the robot and the gamepad. The camera can capture images and image processing is intended here. The mission object is intended for splitting long missions into mission snippets that the REGBOT can execute.


The mission class has access to robot data and the camera at all times using the pointers "bot->" and "cam->". e.g. the heading (relative to the start position) and if the yellow gamepad button is pressed, can be fetched as:
The classes that inherit from UData are classes that makes data available for the mission, e.g. joystick buttons (in UJoy) event flags (in UEvent) or IR distance data (in UIRdist).


float heading = bot->pose->h;
The classes that inherit from URun has a thread running to receive data from an external source, e.g. UBridge that handles communication with the ROBOBOT_BRIDGE.
bool yellowButton = bot->joy->button[3];


Details about the data code may be found in the upose.cpp, uinfo.cpp, ujoy.cpp, umotor.cpp ... files.
The camera class (UCamera) is intended to do the image processing.


The sound system can be used for debugging, e.g. add a C++ line like:
====HTML documentation - Doxygen====


system("espeak \"bettina reached point 3\" -ven+f4 -a30 -s130");
To generate doxygen html files go to mission directory and run doxygen.


This line makes the robot say "bettina reached point 3" the parameters "-a30" turns amplitude down to 30%, "-ven+f4" sets language to english with female voice 4 and "-s130" makes the speech a little slower and easier to understand.
cd ~/mission
It requires that espeak is installed (sudo apt install espeak).
doxygen Doxyfile


====Software documentation (doxygen)====
then open the index.html with a browser.


[[File:inherit_graph_2.png | 200px]]
If doxygen is not installed, then install using


generated with doxygen http://aut.elektro.dtu.dk/robobot/doc/html/classes.html
sudo apt install doxygen

Latest revision as of 12:47, 12 January 2020

ROBOBOT mission demo C++

This is an example software in C++ to access both raspberry camera and REGBOT, and with an example mission controlled from the raspberry.

Get software

Get the ROBOBOT software from the svn repository: 

svn checkout svn://repos.gbar.dtu.dk/jcan/regbot/mission mission

or just update if there already 

svn up

Compile

To be able to compile the demo software CMAKE needs also to use the user installed library (raspicam installed above), so add the following line to ~/.bashrc: 

export CMAKE_PREFIX_PATH=/usr/local/lib

Then build Makefiles and compile: 

cd ~/mission
mkdir -p build
cd build
cmake ..
make

Then test-run the application: 

./mission

It should print that the camera is open and connected to the robot (bidge).

Software structure

The sound system can be used for debugging, e.g. add a C++ line like: 

system("espeak \"bettina reached point 3\" -ven+f4 -a30 -s130");

This line makes the robot say "bettina reached point 3" the parameters "-a30" turns amplitude down to 30%, "-ven+f4" sets language to english with female voice 4 and "-s130" makes the speech a little slower and easier to understand. It requires that espeak is installed (sudo apt install espeak).

To use on Raspberry pi, it is better to use 

system("espeak \"Mission paused.\" -ven+f4 -s130 -a60 2>/dev/null &");

The "2>/dev/null" tell that error messages should be dumped, and the final "&" say that it should run in the background (not to pause the mission).

AruCo Marker

The camera class contains some functions to detect Aruco markers. It it described in more details on AruCo Markers.

Software documentation (doxygen)

Figure: generated with doxygen http://aut.elektro.dtu.dk/robobot/doc/html/classes.html


The classes that inherit from UData are classes that makes data available for the mission, e.g. joystick buttons (in UJoy) event flags (in UEvent) or IR distance data (in UIRdist).

The classes that inherit from URun has a thread running to receive data from an external source, e.g. UBridge that handles communication with the ROBOBOT_BRIDGE.

The camera class (UCamera) is intended to do the image processing.

HTML documentation - Doxygen

To generate doxygen html files go to mission directory and run doxygen. 

cd ~/mission
doxygen Doxyfile

then open the index.html with a browser.

If doxygen is not installed, then install using 

sudo apt install doxygen
Retrieved from "https://rsewiki.electro.dtu.dk/index.php?title=Mission_template_software&oldid=4239"