Prepared files and menu structure for demos subsection in tutorials section.

ralph-lange · ralph-lange · commit 51a3a6fab69b · 2019-07-15T08:13:30.000+02:00
Signed-off-by: Ralph Lange (CR/AEE1) &lt;ralph.lange@de.bosch.com&gt;
diff --git a/_data/docs.yml b/_data/docs.yml
@@ -18,6 +18,10 @@
    - tutorials/advanced/6lowpan_nuttx_rpi
    - tutorials/advanced/tracing
 
+- title: Demos
+  docs:
+   - tutorials/demos/kobuki_demo
+
 - title: Concepts
   docs:
    - concepts/rtos
diff --git a/_docs/tutorials/demos/kobuki_demo/index.md b/_docs/tutorials/demos/kobuki_demo/index.md
@@ -0,0 +1,13 @@
+---
+title: Kobuki Demo
+permalink: /docs/tutorials/demos/kobuki_demo/
+redirect_from: /docs/tutorials/demos/
+---
+
+The micro-ROS Kobuki Demo illustrates the use of micro-ROS on the Kobuki platform, which is the mobile base of the well-known Turtlebot 2 research robot.
+
+The basic idea and working principle of this demo is as follows: Instead of a laptop running ROS, the Kobuki is equipped with a STM32 F4 microcontroller only. This STM32 F4 runs the micro-ROS stack and a port of the [thin_kobuki driver](https://github.com/Lab-RoCoCo/thin_drivers), which interacts with the robot's firmware (which runs on a built-in microcontroller). The STM32 F4 communicates the sensor data via DDS-XRCE to a remote laptop running a standard ROS 2 stack, the micro-ROS agent and rviz. At the same time, using the other direction of communication, the Kobuki can be remote-controlled.
+
+![Illustration of idea and working principle](working_principle.png)
+
+To run this demo yourself, follow the instructions given in [https://github.com/micro-ROS/micro-ROS_kobuki_demo](https://github.com/micro-ROS/micro-ROS_kobuki_demo)
diff --git a/_docs/tutorials/demos/kobuki_demo/working_principle.png b/_docs/tutorials/demos/kobuki_demo/working_principle.png
diff --git a/_includes/docs_nav.html b/_includes/docs_nav.html
@@ -10,6 +10,9 @@
   {% if page.path contains "_docs/tutorials" and section.title contains "Tutorials" %}
     {% assign should_show_this_menu = true %}
   {% endif %}
+  {% if page.path contains "_docs/tutorials" and section.title contains "Demos" %}
+    {% assign should_show_this_menu = true %}
+  {% endif %}
   {% if should_show_this_menu == true %}
   <div class="panel panel-default">
     <div class="panel-heading">
