Skip to content
This repository was archived by the owner on Sep 16, 2025. It is now read-only.

Commit a2f9d7e

Browse files
committed
Merge branch 'master' of github.com:micro-ROS/micro-ROS_demobox_demo into HEAD
2 parents a43eaf6 + 6b361ee commit a2f9d7e

File tree

1 file changed

+13
-12
lines changed

1 file changed

+13
-12
lines changed

demo_box/doc/demo_box_tutorial.md

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Micro-ROS Power and Distance Sensors Demo
22

3-
This demo illustrates micro-ROS capabilities and showcases the integration of micro-ROS with ROS 2 tools. Besides, it enables the comparison of micro-ROS and ROS 2 outcomes.
3+
This demo illustrates the micro-ROS capabilities and showcases the integration of micro-ROS with ROS 2 tools. Besides, it enables the comparison of micro-ROS and ROS 2 outcomes.
44

55
The use-case consists in a ROS2-controlled [Raspberry Pi 4](https://www.raspberrypi.org/products/raspberry-pi-4-model-b/?resellerType=home) with a [TFMini](https://www.sparkfun.com/products/14588) sensor that measures the <span style="color:magenta">distance</span> to a target object and a micro-ROS-controlled [Olimex STM32-E407](https://www.olimex.com/Products/ARM/ST/STM32-E407/open-source-hardware) board with the similar TFMini sensor, which measures the <span style="color:magenta"> distance</span> to the same object. The demo explores another micro-ROS-controlled Olimex STM32-E407 board, which measures the <span style="color:magenta">power consumption</span> of both Raspberry Pi 4 and Olimex STM32-E407 boards for distance measurements, using [INA219](https://www.antratek.com/ina-219-dc-current-sensor) sensors. The last component, a tablet display, visualizes measurement results using standard ROS 2 tools (rqt).
66

@@ -86,7 +86,7 @@ The following is a list of the demo hardware:
8686

8787

8888
## How to build the micro-ROS demo system on Olimex STM32-E407
89-
Use a PC workstation with the Docker installation to prepare the environment for setting up Demo Box applications in a docker container:
89+
The environment for setting up the Demo Box applications will be perform within a docker:
9090
- Download the micro-ROS base Foxy image from [the Docker Hub](https://hub.docker.com/), then run a docker container
9191

9292
```
@@ -105,7 +105,7 @@ apt-get -y install python3-pip
105105
colcon build
106106
source install/local_setup.bas
107107
```
108-
- Create the Nuttx firmware on Olimex-E407 with Demo Box sensor applications
108+
- Create the Nuttx firmware on Olimex-E407 with the Demo Box sensor applications
109109
```
110110
ros2 run micro_ros_setup create_firmware_ws.sh nuttx olimex-stm32-e407
111111
cd firmware/NuttX
@@ -115,16 +115,11 @@ git checkout -t origin/ucs_demo_f
115115
cd ..
116116
```
117117
Build an flash the firmware:
118-
- Set the config profile variable to select the demo distance or demo power application
118+
- Set the configuration profile variable to select the demo distance or demo power application
119119

120120
```
121121
CFG_PROFILE=demo_distance_romfs
122122
```
123-
or
124-
125-
```
126-
CFG_PROFILE=demo_power_romfs
127-
```
128123

129124
- Build the application
130125

@@ -135,14 +130,20 @@ cd firmware/apps/nshlib/
135130
../../NuttX/tools/mkromfsimg.sh -nofat ../../NuttX/
136131
cd /uros_ws/
137132
ros2 run micro_ros_setup build_firmware.sh
138-
ros2 run micro_ros_setup flash_firmware.sh
139133
```
140134
- Connect ST-Link/V2 to Olimex STM32-E407 JTAG interface and flash the firmware
141135

142136
```
143137
ros2 run micro_ros_setup flash_firmware.sh
144138
```
145139

140+
- Repeat the procedure _Build the application_ with the Olimex used for monitoring the current consumption but before, the configuration needs to be changed as follow:
141+
142+
```
143+
CFG_PROFILE=demo_power_romfs
144+
```
145+
146+
146147
## How to build the ROS 2 demo system on a tablet
147148

148149
Use a tablet with Ubuntu 20.04 LTS (Focal Fossa) installation:
@@ -209,7 +210,7 @@ sudo apt install ros-foxy-ros-base
209210
sudo apt install python3-colcon-common-extensions
210211
```
211212

212-
- Install ROS 2 Demo Box packeges
213+
- Install ROS 2 Demo Box packages
213214

214215
```
215216
cd ~/
@@ -232,7 +233,7 @@ network:
232233
version: 2
233234
```
234235

235-
- Switch off serial console adjusting the /boot/firmware/cmdline.txt file
236+
- Switch off the serial console by adjusting the /boot/firmware/cmdline.txt file
236237

237238
```
238239
net.ifnames=0 dwc_otg.lpm_enable=0 root=LABEL=writable rootfstype=ext4 elevator=deadline rootwait fixrtc

0 commit comments

Comments
 (0)