The main repository for the ICUAS 2022 UAV competition.
ICUAS 2022 Competition build status |
---|
You can either manually install the UAV software stack by following uav_ros_simulation instruction or simply use Docker insted.
To install Docker on your system execute the following command:
curl https://raw.githubusercontent.com/larics/uav_ros_simulation/main/installation/dependencies/docker.sh | bash
Checkout CHANGELOG.md
for any new changes added to this project.
Feel free to use Discussions tab to exchange ideas and ask questions.
Consider opening an Issue if you have troubles with the simulation setup.
NOTE - If the challenge does not setup correctly it is (probably) not your fault! Components are subject to some changes during the competition so most problems should be solved by updating packages. Try following the troubleshooting recommendation. If the problem persists please post an issue.
In case there are new changes to the challenge repository:
git pull origin main --rebase
catkin build
In case the Docker container simulation is not working correctly (e.g. an update happened):
git pull lmark1/uav_ros_simulation:[[DISTRO]]
In case the simulation inside the Docker container is (still) not working correctly:
./docker_build.sh --build-args "--no-cache --pull" --[[DISTRO]]
If you're building all the packages natively, navigate to the uav_ros_simulation
folder and do the following:
git pull origin main
./installation/install.sh
# Navigate to catkin workspace (default is uav_ws)
catkin build
Update all the, manually installed, required dependencies as follows:
git pull origin main
catkin build
Required dependencies are as follows:
melodic_electromagnet_dev
You can either manually build all the packages on your system using the catkin build
command.
Alternatively, to build the ICUAS2022 Competition solution image please execute the following command:
./docker_build.sh
Additional arguments:
--focal
- Build Docker image for Focal distro--focal-nogpu
- Build Docker image for Focal distro (no dedicated graphics card)--bionic
- Build Docker image for Bionic distra (default)--build-args
- Append additional Docker build arguments, e.g. --no-cacheTo automatically start and setup the challenge navigate to startup/challenge
and run:
./start.sh
This should automatically setup and start the challenge, as well as run your code.
There are three worlds available for the challenge. If you want to start the challenge with different world you can run:
./start.sh N
where N can be 1, 2 or 3 depending on the world you want to load.
session.yml
file.custom_config
folder.NOTE If you are unfamiliar with the Docker or Tmux commands please check out this quick-start guide.
NOTE If you choose to run the challenge inside the docker environment, please run the container first using:
./docker_run.sh
Additional arguments:
--focal
- Run Focal distro container--focal-nogpu
- Run Focal distro container (no dedicated graphics card)--bionic
- Run Bionic distro container--run-args
- Append additional Docker run arguments, e.g. --rmNOTE Keep in mind this will start a new container so any changes you make inside that container will be lost if you remove the container.
The idea of the container is to easily integrate your code with the challenge flight stack. To do so, please add your code diretcly to this ROS package since it is copied to the container. Furthermore, feel free to edit Dockerfile.focal
or Dockerfile.bionic
files to
get all the resources and build your solution.
UAV simulation template startup. Tmux session is running on the left side, with Gazebo client positioned on the right. |
For your reference, we have set up trajectory planning using TOPP-RA, which you can use by publishing to two topics:
tracker/input_pose
- Send a waypoint (PoseStamped) to TOPP-RA. TOPP-RA then interpolates trajectory between current UAV pose and the target waypoint, and sends trajectory points (MultiDOFJointTrajectoryPoint) to topic position_hold/trajectory
with a given rate. The position controller of the UAV receives the trajectory point as a reference and commands the motors. tracker/input_trajectory
- Generate a trajectory using the given sampled path in form of waypoints (MultiDOFJointTrajectory). TOPP-RA then interpolates trajectory from the current UAV pose to the first point of the trajectory, and interpolates trajectory between sampled path points. Once trajectory is interpolated, each trajectory point is sent as a reference to the position controller via the position_hold/trajectory
topicTo control the UAV directly, and to publish the trajectory that you generated via your solution, you need to use the following topic:
position_hold/trajectory
- Publish a trajectory point directly to the UAV position controlCurrent position reference (last one sent to the position controller of the UAV) can be obtained via carrot/pose
topic, while current pose of the UAV (in simulation) is available at mavros/global_position/local
topic.
Configuration files are placed in the startup/challenge/custom_config
folder.
More details on the challenge can be found in the competition rulebook http://www.uasconferences.com/2022_icuas/uav-competition-rulebook-and-faq/ 0 | |
---|---|
UAV setup for the ICUAS 2022 challenge. |
challenge_started
- After True
is published on this topic the challenge is setup correctly and you can safely run your code.spawn_ball
- You can manually call this service at any point to reset the ball at the UAV.uav_magnet/gain
- When you want to detach the ball from the magnetic gripper, publish a 0
gain on this topic.NOTE If you detach the ball by setting the UAV magnet gain to 0
and want to spawn another ball using the spawn_ball
service, you will have to reset the gain to 1.0
in order for the UAV magnet to become active again.