[[PageOutline]]

= Troubleshooting =

This page give solutions to common issues.

When you have an issue, please first check that you have done all the necessary steps to have a functional environment:
* [wiki:prerequisite Prerequisite]
* [wiki:setup Setup your computer]
* [wiki:toolchain/install Install toolchains]

== Problem executing a tool ==

If you receive a message like ''No such file or directory'' when executing FlairGCS, try recompiling all like described [wiki:compile_all here].

It can be a problem of a toolchain installed in a different location from the one who compiled the tools.

== Graphical problem with the simulator ==

* verify if your graphic drivers are well installed for the toolchain, see [wiki:toolchain/install here].
* check if ''/dev/shm'' is clean. It should not contain files like ''sem.simu_*'' or ''simu_*''. The files are shared memories between control and simulation part; they should be destroyed when all programs are closed. You can safely remove it manually if not.
* if problem is still present, make [https://devel.hds.utc.fr/software/flair/newticket a new ticket] describing your problem and the output message of the simulator.

== Problem when updating the repositories ==

If you have changed something on the versioned files and if these changes are not committed, you will have a conflict when updating these files (with ''svn up command''). This can occur when you recompiled [wiki:compile_all all stuffs].

So be sure that you get the version of the files from the server when you update the repositories by answering ''tf'' to the conflict question. Otherwise, you will stay with the older versions. In doubt you can erase your local repositories and [wiki:repo/sync checkout them again], but be sure not to erase your personal work.
Another solution is to [wiki:compile_all compile all] again after the update.



== Dualshock 3 controller acting as a mouse ==

On recent kernel (>=4.13), ds3 is seen as a mouse, which is disturbing. You can launch this command to disable it:
{{{
/usr/bin/xinput set-prop 'Sony PLAYSTATION(R)3 Controller' 'Device Enabled' 0
}}}

Note that this is integrated in flair script to launch ds3 controller.

== Deprecated ==

Here is some troubleshootings which are deprecated in the current Flair version.

They can be useful if you are not working on the last version, or to give some hints on unresolved problem.

=== LibGL error with Ubuntu 16.04 and Intel Graphics ===

When you try to launch the flair simulator, you have a LibGL error and the GUI doesn't appear while your using the Intel graphic drivers ? The problem is linked to a wrong place where to find some libs. So, you have to copy them :
  *  sudo cp -a /usr/lib/x86_64-linux-gnu/libdrm.so* /usr/lib/x86_64-linux-gnu/libdrm_nouveau.so* /usr/lib/x86_64-linux-gnu/mesa

Relauch Flair, all should work.

=== Simulator no longer working ===

If simulator was working and now it does not, maybe there is a problem with graphic driver which were updated on your system.

Output of simulator can be:
{{{
Connecting to 127.0.0.1:9000
System is little endian
Irrlicht Engine version 1.8.1
Linux 4.4.0-47-generic #68-Ubuntu SMP Wed Oct 26 19:39:52 UTC 2016 x86_64
X Error of failed request:  BadValue (integer parameter out of range for operation)
  Major opcode of failed request:  154 (GLX)
  Minor opcode of failed request:  24 (X_GLXCreateNewContext)
  Value in failed request:  0x0
  Serial number of failed request:  34
  Current serial number in output stream:  35
}}}

In this case check the file ''/opt/robomap3/1.7.3/core2-64/toolchain.cmake''. There is a line like this:
{{{
set(LIBGL_PATH /usr/lib/nvidia-352)
}}}
If graphic driver has changed, this directory will no longer contain a libGL.so file. So you need to change the path with the new one.

Then recompile all like described [wiki:compile_all here].

__NOTE__: you can also reinstall the toolchain in order to set the good path.