andriyp/carmen-dev-intel repository overview

⁠carmen

Carmen Robot Car project

⁠Linux

⁠Docker

For convenience it is recommended to use Docker containers. Please follow these steps to run Docker container on your machine.

1. Install Desktop OS Ubuntu Trusty or Xenial on your machine or in virtual machine
2. Install Docker-CE using these instructions⁠
3. In order to executed Docker without sudo please execute

sudo usermod -aG docker $USER

1. Logout and login to your machine again :)
2. In case if you have NVidia graphic card customized Docker could be installed which will utilize your GPU. Please follow these extra steps⁠.
3. For development the following⁠ docker image will be used for NVidia Docker this one⁠.
4. Use the following command to start ordinary Docker container

docker run -it --name carmen_dev -p 8080:8080 -p 8090:8090 -p 9090:9090 -e DISPLAY -e LOCAL_USER_ID=$(id -u) -v /tmp/.X11-unix:/tmp/.X11-unix:rw andriyp/carmen:latest

for NVidia Docker please use

nvidia-docker run -it --name carmen_dev -p 8080:8080 -p 8090:8090 -p 9090:9090 -e DISPLAY -e LOCAL_USER_ID=$(id -u) -v /tmp/.X11-unix:/tmp/.X11-unix:rw andriyp/carmen-dev-nvidia:latest

1. Black window of Terminator⁠ UI console will appear after some time.
2. You can use it's features to split terminal window⁠ into smaller terminals and run few commands in parallel (Ctrl+Shift+E).
3. If you want to run real robot add user to dialout group and restart Docker container

sudo usermod -a -G dialout user

In order to relaunch docker container after you closed Terminator window or rebooted machine please run

docker start carmen_dev

and for NVidia Docker

nvidia-docker start carmen_dev

After some time Terminator window will reappear.

⁠IDEs

In case if you want to run PyCharm in Docker container please run

pycharm

To launch QtCreator please run

qtcreator

For VSCode type

vscode

⁠URDF and RViz

In order to debug URDF please launch

roslaunch carmen_launch view_urdf.launch

To have a look on the state of the robot in RViz run

roslaunch carmen_launch rviz.launch

⁠Hardware

In order to launch ROS Serial node which will be communicating with MCU run the following command

roslaunch carmen_launch hardware.launch

Default port is /dev/ttyACM0 and baud is 115200.

In order to run command with custom port and\or baud please use parameters to pass these values e.g.

roslaunch carmen_launch hardware.launch port:=/dev/ttyUSB0 baud:=57600

Messages from MCU could be received using rostopic⁠ command.

In case if sensor reading need to checked from MCU. You need to know in which topic there readings are published. Let's assume it is /mcu_sensor_data. Please start hardware nodes as described above. After that please run this command

rostopic echo /mcu_sensor_data

In order to publish messages to MCU please use rostopic pub command.

Header files for messages could be found in this⁠ folder.

The following command will regenerate these headers with most recent changes in message files

rosrun carmen_hardware generate_messages.sh

⁠Windows

⁠Docker Desktop

For OS Windows it is recommended to use Docker Desktop containers. Please follow these steps to run Docker container on your machine.

1. Install Windows 10 on your machine or in virtual machine
2. Install Docker Desktop using these instructions⁠
3. For development the following⁠ docker image will be used.
4. Use the following command to start ordinary Docker container

docker run -d --name carmen_dev -p 8080:8080 -p 8181:8181 -p 8282:8282 -p 8090:8090 -p 9090:9090 andriyp/carmen-dev-web:latest

1. Command will spawn Docker container and exit.

In order to relaunch docker container please run

docker start carmen_dev

⁠IDEs

In Docker Desktop only Cloud9 web IDE is available. Open http://localhost:8181⁠ in your browser.