Skip to content

Commit 29bd05f

Browse files
committed
add launch control page
Signed-off-by: ismetatabay <[email protected]>
1 parent 2045a6c commit 29bd05f

File tree

4 files changed

+88
-1
lines changed

4 files changed

+88
-1
lines changed

docs/how-to-guides/integrating-autoware/launch-autoware/.pages

+1
Original file line numberDiff line numberDiff line change
@@ -7,3 +7,4 @@ nav:
77
- Launch localization: localization
88
- Launch perception: perception
99
- Launch planning: planning
10+
- Launch control: control

docs/how-to-guides/integrating-autoware/launch-autoware/control/images/control_launch_flow.svg

+4
Loading
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
# Control Launch Files
2+
3+
## Overview
4+
5+
The Autoware control stacks start
6+
launching at `autoware_launch.xml` as we mentioned at [Launch Autoware](../index.md) page.
7+
The `autoware_launch` package includes `tier4_control_component.launch.xml`
8+
for starting control launch files invocation from `autoware_launch.xml`.
9+
This diagram describes some of the Autoware control launch files flow at `autoware_launch` and `autoware.universe` packages.
10+
11+
<figure markdown>
12+
![control-launch-flow](images/control_launch_flow.svg){ align=center }
13+
<figcaption>
14+
Autoware control launch flow diagram
15+
</figcaption>
16+
</figure>
17+
18+
!!! note
19+
20+
The Autoware project is a large project.
21+
Therefore, as we manage the Autoware project, we utilize specific
22+
arguments in the launch files.
23+
ROS 2 offers an argument-overriding feature for these launch files.
24+
Please refer to [the official ROS 2 launch documentation](https://docs.ros.org/en/humble/Tutorials/Intermediate/Launch/Using-ROS2-Launch-For-Large-Projects.html#parameter-overrides) for further information.
25+
For instance,
26+
if we define an argument at the top-level launch,
27+
it will override the value on lower-level launches.
28+
29+
## tier4_control_component.launch.xml
30+
31+
The `tier4_control_component.launch.xml` launch file is the main control component launch at the `autoware_launch` package.
32+
This launch file calls `planning.launch.xml` at [tier4_planning_launch](https://github.com/autowarefoundation/autoware.universe/tree/main/launch/tier4_planning_launch) package from `autoware.universe` repository.
33+
We can modify planning launch arguments at tier4_planning_component.launch.xml.
34+
Also,
35+
we can add any other necessary arguments
36+
that we want
37+
to change it since `tier4_planning_component.launch.xml` is the top-level launch file of other planning launch files.
38+
Here are some predefined planning launch arguments:
39+
40+
- **`lateral_controller_mode:`** This argument determines the lateral controller algorithm.
41+
The default value is `mpc`.
42+
If you want to set it to `pure pursuit`, you can make the change in the
43+
tier4_control_component.launch.xml file:
44+
45+
```diff
46+
- <arg name="lateral_controller_mode" default="mpc"/>
47+
+ <arg name="lateral_controller_mode" default="pure_pursuit"/>
48+
```
49+
50+
- **`enable_autonomous_emergency_braking:`** This argument enables the autonomous emergency braking at some
51+
specific conditions.
52+
PLease refer to [Autonomous emergency braking (AEB)](https://autowarefoundation.github.io/autoware.universe/main/control/autonomous_emergency_braking/) page for
53+
more information.
54+
If you want to enable it, you can do in the
55+
`tier4_control_component.launch.xml` file:
56+
57+
```diff
58+
- <arg name="enable_autonomous_emergency_braking" default="false"/>
59+
+ <arg name="enable_autonomous_emergency_braking" default="true"/>
60+
```
61+
62+
- **`enable_predicted_path_checker:`** This argument enables the predicted path checker module,
63+
please refer to [Predicted Path Checker](https://autowarefoundation.github.io/autoware.universe/main/control/predicted_path_checker/) page for
64+
more information.
65+
If you want to enable it, you can do in the
66+
`tier4_control_component.launch.xml` file:
67+
68+
```diff
69+
- <arg name="enable_predicted_path_checker" default="false"/>
70+
+ <arg name="enable_predicted_path_checker" default="true"/>
71+
```
72+
73+
!!! note
74+
75+
You can also use this arguments as command line arguments:
76+
```bash
77+
ros2 launch autoware_launch autoware.launch.xml ... enable_predicted_path_checker:=true lateral_controller_mode:=pure_pursuit ...
78+
```
79+
80+
The predefined arguments in `tier4_control_component.launch.xml`
81+
have been explained above, but there are numerous control arguments
82+
included in the `autoware_launch` control config parameters.

docs/how-to-guides/integrating-autoware/launch-autoware/index.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ We will explain how to run and launch autoware with these modules:
1010
- [Localization](./localization)
1111
- [Perception](./perception)
1212
- [Planning](./planning)
13-
- Control
13+
- [Control](./control)
1414

1515
## Pre-requirements of launching Autoware with real vehicle
1616

0 commit comments

Comments
 (0)