Skip to content

Commit

Permalink
added outdated warnings
Browse files Browse the repository at this point in the history
  • Loading branch information
klaxalk committed Oct 8, 2023
1 parent 81ef7dc commit 350768b
Show file tree
Hide file tree
Showing 29 changed files with 108 additions and 88 deletions.
4 changes: 4 additions & 0 deletions docs/hardware/motor_tests.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@ title: Motor tests
parent: Hardware
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# Motor tests
All motor tests are done with a Turnigy MultiStar BLheli_32 51A ESC, with the 32.7 BLheli firmware. [ESC config](https://github.com/ctu-mrs/uav_core/blob/master/miscellaneous/blheli32_esc_config/T650/T650_M1.ini) is available in our repository.
Current and voltage measurements are done by the ESC and thrust is measured with a 5 kg load cell, coupled with a HX711 amplifier.
Expand Down
4 changes: 4 additions & 0 deletions docs/hardware/post_installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@ title: Post installation guide
parent: Hardware
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# Linux SWAP size increase

TODO
Expand Down
4 changes: 4 additions & 0 deletions docs/hardware/px4_configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@ title: PX4 Configuration
parent: Hardware
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# Pixhawk setup on a new drone
Follow this guide to setup a new drone with the Pixhawk autopilot for the MRS UAV system.

Expand Down
4 changes: 4 additions & 0 deletions docs/introduction/how_to_compile.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ parent: Introduction
nav_order: 99
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

We use [catkin tools](https://catkin-tools.readthedocs.io/en/latest/) to manage our ROS workspaces.
Make sure you are located within the workspace when issuing the following commands.
If your workspace is sourced, you can `cd` to the workspace by:
Expand Down
4 changes: 4 additions & 0 deletions docs/introduction/how_to_update.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ parent: Introduction
nav_order: 98
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# How to update the mrs_uav_system

This manual assumes you have already installed the [mrs_uav_system](https://github.com/ctu-mrs/mrs_uav_system) and you want to update package(s) of the MRS system.
Expand Down
4 changes: 4 additions & 0 deletions docs/introduction/suggested_reading.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ parent: Introduction
nav_order: 1
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# Mandatory readings for newcomers

Nowadays, doing research in this field is not just about the theory and occasional lab experiment.
Expand Down
4 changes: 4 additions & 0 deletions docs/simulation/custom_world.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ parent: Simulation
nav_order: 3
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# How to start the simulation with a custom world

![](fig/custom_world.jpg)
Expand Down
4 changes: 4 additions & 0 deletions docs/simulation/drone_spawner.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ parent: Simulation
nav_order: 2
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# About

The `mrs_drone_spawner` is a ROS node written in Python, which allows you to dynamically add drones into your Gazebo simulation.
Expand Down
4 changes: 4 additions & 0 deletions docs/simulation/howto.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ parent: Simulation
nav_order: 1
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# How to start the simulation
If you have everything installed and compiled, the next step is to test it in the simulation.
Running the simulation consists of several steps, which are usually **automated** using a **tmuxinator** script.
Expand Down
4 changes: 4 additions & 0 deletions docs/simulation/simulation_motor_thrust.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ parent: Simulation
nav_order: 6
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# Gazebo Motor parameters

* **Pixhawk** controller output is shaped via function
Expand Down
4 changes: 4 additions & 0 deletions docs/simulation/simulation_speed.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ parent: Simulation
nav_order: 4
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# Run Simulation Faster than Real-time

Simulation In The Loop (SITL) can be run faster or slower than real-time.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ parent: catkin
grand_parent: Software
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# Managing Workspaces

This guide is an important and mandatory reading for all MRS members.
Expand Down
4 changes: 4 additions & 0 deletions docs/software/gdb.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@ title: Debugging with GDB
parent: Software
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# Debugging with GDB

If you're experiencing crashes of your C/C++ ROS node/nodelet or if your program is not behaving as expected in general and you want to inspect it, you can reach for a debugger.
Expand Down
4 changes: 4 additions & 0 deletions docs/software/gitman.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@ title: Gitman
parent: Software
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# Gitman "submodule" manager

Gitman, a git project manager, is a program for resolving dependency between multiple git repositories.
Expand Down
4 changes: 4 additions & 0 deletions docs/software/hector_slam.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@ title: Hector SLAM
parent: Software
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# Hector SLAM

Hector slam ([github.com/tu-darmstadt-ros-pkg/hector_slam](http://github.com/tu-darmstadt-ros-pkg/hector_slam)) is a 2D LIDAR SLAM.
Expand Down
4 changes: 4 additions & 0 deletions docs/software/known_issues.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@ title: Known Issues
parent: Software
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

## RTK Frame Issue

It has been noted at times that the UAV could find itself under the safety area's minimum-Z height specified. If a tmux flight session is started on the UAV before the RTK fix is fully acquired, it sets its local origin at this start time and can then end up finding itself below ground height even when it is using the height sensor. This issue will show up in trajectory reference as "Start point / pose of the trajectory is outside the safety area".
Expand Down
4 changes: 4 additions & 0 deletions docs/software/mavros.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ parent: Software
nav_order: 97
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# Mavros

[Mavros](https://github.com/mavlink/mavros) provides an interface between the [uav_core](https://github.com/ctu-mrs/uav_core) and the [Pixhawk](https://pixhawk.org/) flight controller.
Expand Down
4 changes: 4 additions & 0 deletions docs/software/mrs_utils.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ parent: Software
nav_order: 99
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# MRS Utilities

MRS Utilities contains various useful tools for development and testing.
Expand Down
4 changes: 4 additions & 0 deletions docs/software/ros_remote.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@ title: ROS remote
parent: Software
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# Connecting to ROS core remotely

ROS allows multiple computers to communicate and share topics and services via a local network.
Expand Down
4 changes: 4 additions & 0 deletions docs/system/bashrc_configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ parent: The UAV system
nav_order: 5
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# What is .basrc?:

You can find the `.bashrc` file in the home folder of the UAV's onboard computer, it is a hidden file.
Expand Down
4 changes: 4 additions & 0 deletions docs/system/custom_configs.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ parent: The UAV system
nav_order: 6
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# How to use custom config files for uav_core modules

## Motivation
Expand Down
20 changes: 0 additions & 20 deletions docs/system/flying_without_mrs_odom.md

This file was deleted.

4 changes: 4 additions & 0 deletions docs/system/frames_of_reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ parent: The UAV system
nav_order: 1
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# Frames of Reference

As described in the [Transformations](transformations.md) manual, the MRS control system enables to send commands to a UAV in all coordinate frames for which a transformation to the control frame exists.
Expand Down
4 changes: 4 additions & 0 deletions docs/system/preparing_for_a_real-world_experiment.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ parent: The UAV system
nav_order: 7
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

# Preparing for a real-world experiment:

This guide is intended for newcomers to the MRS group who are planning a real-world experiment, and it is therefore specific to the UAV platforms and setup used by the MRS group. But all the ideas are also applicable to other people.
Expand Down
4 changes: 4 additions & 0 deletions docs/system/relative_commands.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ parent: The UAV system
nav_order: 9
---

| :warning: **Attention please: This page is outdated.** |
| :--- |
| The MRS UAV System 1.5 is being released and this page needs updating. Plase, keep in mind that the information on this page might not ve valid. |

## tl;dr:
If you're setting a setpoint reference relative to the current UAV pose, do not use the pose from the [state estimator](https://github.com/ctu-mrs/mrs_uav_odometry) to calculate the new setpoint.
Use the UAV pose from the "commanded pose" topic (currently named `control_manager/position_cmd`) to avoid drift.
Expand Down
Loading

0 comments on commit 350768b

Please sign in to comment.