You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: racs2_demos_on_spaceros/README.md
+66-9
Original file line number
Diff line number
Diff line change
@@ -7,30 +7,87 @@ The Dockerfile installs all of the prerequisite system dependencies along with t
7
7
This is RACS2 Bridge demo for Curiosity Mars rover.
8
8
9
9
## Building the Demo Docker
10
-
To build:
10
+
11
+
The demo image builds on top of the `spaceros`, `moveit2`, `space_robots` images.
12
+
To build the docker image, first ensure the `spaceros` base image is available either by [building it locally](https://github.com/space-ros/space-ros) or pulling it.
13
+
14
+
Then build the `moveit2`, `space_robots` and `racs2_demos_on_spaceros` demo images:
15
+
11
16
```bash
17
+
git clone https://github.com/space-ros/docker.git
18
+
cd docker/moveit2
19
+
./build.sh
20
+
cd ../space_robots
21
+
./build.sh
22
+
cd ../../
12
23
./build.sh
13
24
```
14
-
For detail and please read docker/racs2_demos_on_spaceros/README.md
For instractions after entering docker, please read docker/racs2_demos_on_spaceros/README.md
39
+
Depending on the host computer, you might need to remove the ```--gpus all``` flag in ```run.sh```, which uses your GPUs.
24
40
41
+
## Running the Demos
25
42
26
-
## Reference
43
+
### Curiosity Mars rover demo
44
+
Launch the rover demo (calling Terminal 1):
45
+
```bash
46
+
source install/setup.bash
47
+
ros2 launch mars_rover mars_rover.launch.py
48
+
```
27
49
28
-
*[RACS2 Bridge by Japan Aerospace Exploration Agency (JAXA)](https://github.com/jaxa/racs2_bridge)
50
+
#### RACS2 Bridge demo
29
51
30
-
*[Hiroki Kato and Tatsuhiko Saito, "RACS2: the ROS2 and cFS System - launched" Flight Software Workshop 2023.](https://drive.google.com/drive/folders/1C9fokWGDl2e4NfgX_ZU3f98FfPe9udwQ)
52
+
##### Running racs2 bridge node
53
+
Open a new terminal (calling Terminal 2) and attach to the currently running container:
54
+
55
+
```bash
56
+
docker exec -it <container-name> bash
57
+
source install/setup.bash
58
+
ros2 run bridge_py_s bridge_py_s_node --ros-args --params-file ./src/bridge_py_s/config/params.yaml
59
+
```
60
+
61
+
##### Running cFS bridge app & run_app app
62
+
Open a new terminal (calling Terminal 3) and attach to the currently running container:
63
+
64
+
```bash
65
+
docker exec -it <container-name> bash
66
+
cd~/racs2_ws
67
+
cd cfs/build/exe/cpu1/
68
+
./core-cpu1
69
+
```
70
+
71
+
**Executing commands to the rover must be done with this terminal active.**
31
72
32
-
*[Hiroki Kato and Tatsuhiko Saito, "ROS and cFS System (RACS): Easing Space Robotic Development post-opensource activities and ROS2 integration" Flight Software Workshop 2021.](https://drive.google.com/file/d/11L48doT_pRNs7R0hdChPALqJO849TvV2/view?usp=drive_web)
33
73
74
+
##### Available Commands
34
75
76
+
Drive commands to the rover are input via keyboard in Terimnal 3. The keymap is as follows.
35
77
78
+
* "w": Drive the rover forward
79
+
* "s": Drive the rover backward
80
+
* "a": Turn left
81
+
* "d": Turn right
82
+
* "x": Stop the rover
36
83
84
+
##### Nodes
85
+

86
+
87
+
## Reference
88
+
89
+
*[RACS2 bridge project by Japan Aerospace Exploration Agency (JAXA)](https://github.com/jaxa/racs2_bridge)
90
+
91
+
*[Hiroki Kato and Tatsuhiko Saito, "RACS2: the ROS2 and cFS System - launched" Flight Software Workshop 2023.](https://drive.google.com/drive/folders/1C9fokWGDl2e4NfgX_ZU3f98FfPe9udwQ)
92
+
93
+
*[Hiroki Kato and Tatsuhiko Saito, "ROS and cFS System (RACS): Easing Space Robotic Development post-opensource activities and ROS2 integration" Flight Software Workshop 2021.](https://drive.google.com/file/d/11L48doT_pRNs7R0hdChPALqJO849TvV2/view?usp=drive_web)
0 commit comments