Skip to main content

Code functions to control a Drone using clover

Project description

Colibri Code Functions

A Python library for controlling Colibri drones using the Clover framework.

Colibri Code Functions is a collaborative project developed by the Educa Drones team. It provides a simplified and intuitive interface for programming drone operations, built on top of the Clover framework for autonomous flight control.

Overview

This project abstracts complex drone control operations into easy-to-use modules, allowing developers to focus on mission logic rather than low-level flight operations. It's designed specifically for the Colibri drone line and integrates seamlessly with the Clover ecosystem.

Features

  • Camera Control - Manage drone camera operations and image capture
  • Servo Control - Control servo mechanisms for camera gimbal or payload manipulation
  • Drone Flight Control - Execute takeoff, landing, and autonomous flight operations
  • Task Management - Structure and schedule complex drone missions

Prerequisites

Before installing Colibri Code Functions, ensure you have the following:

  • Python 3.7 or higher
  • The Clover Framework installed and configured
  • A compatible Colibri drone (optional, but highly recommend)

Note: The Clover framework is required for this library to function properly. Please install it first following the official documentation.

Installation

Install Colibri Code Functions via pip:

pip3 install colibricf

Or, for development installation from the repository:

git clone https://github.com/EDUCA-DRONES/Colibri_CF.git
cd Colibri_CF
pip3 install -e .

Quick Start

from colibricf import Drone

drone = Drone()
drone.arm()
rospy.sleep(2)
drone.navigate_wait(x=0, y=0, z=self.TAKEOFF_ALTITUDE, frame_id='body', auto_arm=True)
drone.land_wait()

Project Structure

colibricf/
├── __init__.py       # Package initialization
├── drone.py          # Drone flight control
├── camera.py         # Camera operations
├── servo.py          # Servo control
└── task.py           # Task management and scheduling

Documentation

Examples

See the example.py file for complete usage examples.

Contributing

We welcome contributions! Please feel free to submit pull requests or open issues for bugs and feature requests.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For issues, questions, or contributions, please visit the GitHub repository.

For more information about the Clover framework, visit: https://clover.coex.tech/en/


Developed by: Educa Drones

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

colibricf-1.0.101.tar.gz (8.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

colibricf-1.0.101-py3-none-any.whl (8.3 kB view details)

Uploaded Python 3

File details

Details for the file colibricf-1.0.101.tar.gz.

File metadata

  • Download URL: colibricf-1.0.101.tar.gz
  • Upload date:
  • Size: 8.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for colibricf-1.0.101.tar.gz
Algorithm Hash digest
SHA256 f81fdf191bee3ad081e907c075be34ec85b2706114d592e8173919fb01e40408
MD5 ac9b96c9f1275cc7b3b2bd11ccade90a
BLAKE2b-256 eeed12583b862c34379c55ce6a0b705096a54bbb47788b51b8cc90382ff4dadc

See more details on using hashes here.

File details

Details for the file colibricf-1.0.101-py3-none-any.whl.

File metadata

  • Download URL: colibricf-1.0.101-py3-none-any.whl
  • Upload date:
  • Size: 8.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for colibricf-1.0.101-py3-none-any.whl
Algorithm Hash digest
SHA256 a32d159f66e50b6900692eb035779853ca2a1ed4cff6f83fe24c9391aab2fc50
MD5 770393369bedef5e08f82fbf9e7ebc81
BLAKE2b-256 95a0c8440b79339bc78857d2f168eb91c459c54c84d633c2481d21b4f5244bf6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page