-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
34 additions
and
5 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,7 +1,36 @@ | ||
# mrs_uav_autostart | ||
# MRS UAV Autostart | ||
|
||
The ROS package for automating takeoff routine for UAVs. | ||
## General description | ||
The ROS package for automating takeoff routine for UAVs. The **Autostart** checks the availability of essential parts of the system and validity of received data. Once all modules and data are available, it waits for the UAV to be armed and switched to offboard mode. Then, after a __safety timeout__, it initiates the takeoff procedure. During the __safety timeout__ period, takeoff can be aborted by switching the mode back to manual or by disarming the UAV. | ||
|
||
> :warning: **Attention please: This README is outdated.** | ||
> | ||
> The MRS UAV System 1.5 is being released and this page needs updating. Please, keep in mind that the information on this page might not be valid. | ||
The **Autostart** performs following checks: | ||
|
||
* availability of [UAV Manager](https://github.com/ctu-mrs/mrs_uav_managers#uavmanager), | ||
* availability of [Control Manager](https://github.com/ctu-mrs/mrs_uav_managers#controlmanager), | ||
* availability of [Estimation Manager](https://github.com/ctu-mrs/mrs_uav_managers#estimationmanager), | ||
* connection to [HW Api](https://github.com/ctu-mrs/mrs_uav_hw_api#mrs-uav-hw-api-docs), | ||
* validity of current position of the UAV (takeoff outside safety area is not allowed), | ||
* limit on current maximum estimated velocity (UAV should be static before takeoff), | ||
* availability of data on additional user-specified topics. | ||
|
||
## Configuration and use | ||
|
||
### Custom topics check | ||
|
||
The **Autostart** node allows the user to specify additional topics that have to be available before initiating takeoff procedure. If this check is enabled and the latest message received on one of the specified topics is older than __timeout__, the takeoff of the UAV will not be allowed. | ||
|
||
```yaml | ||
preflight_check: | ||
topic_check: | ||
enabled: true | ||
timeout: 5.0 # [s] | ||
topics: [ | ||
"estimation_manager/uav_state", | ||
"/mission_controller/diagnostics" | ||
] | ||
``` | ||
|
||
## Dependencies | ||
|
||
* [mrs_lib](https://github.com/ctu-mrs/mrs_lib) | ||
* [mrs_msgs](https://github.com/ctu-mrs/mrs_msgs) |