Skip to content

Commit

Permalink
updated readme
Browse files Browse the repository at this point in the history
  • Loading branch information
kratkvit committed Jan 16, 2024
1 parent 51f6ecf commit e21e445
Showing 1 changed file with 34 additions and 5 deletions.
39 changes: 34 additions & 5 deletions README.md
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)

0 comments on commit e21e445

Please sign in to comment.