tello-edu-py

Tello EDU 2.0 SDK API implemented in Python.

Building

1. Install build dependencies

~/tello-edu-py $ pip install -r requirements/build

2. Build as a module via pip

~/tello-edu-py $ pip install . # must be in root of project

Usage

Since this is a wrapper library for the Tello EDU protocol, follow instructions for setting up a Tello EDU drone before proceeding.

Requirements

• python 3.11.x

Examples of how the tello-edu-protocol library is used can be found under examples/.

Simple example with movement:

import asyncio
import tello_edu_protocol as tello
from tello_edu_protocol.commands import (
    takeoff,
    cw,
    forward,
    land
)


async def main() -> None:
    # timeout in seconds (20s) means that the library will
    # wait 20 seconds for a response before throwing an error.
    # Every command called for `drone` shares this timeout duration.
    # Command list can be found under `tello-edu-protocol/commands.py`
    # and corresponds to the SDK documentation.
    async with tello.conn(timeout=20) as drone:
        await drone.command(takeoff)      # send takeoff command
	await drone.command(forward, 40)  # fly forward 40cm
	await drone.command(cw, 180)      # turn around (180deg)
	await drone.command(forward, 40)  # fly forward 40cm
	await drone.command(land)         # land drone


if __name__ == '__main__':
    asyncio.run(main())

Contributing

While this project is intended for use by our lab group, contributions are welcome.

1. Clone this repository

~ $ git clone https://github.com/zaruhev/tello-edu-py

2. In tello-edu-py, install dev dependencies

~/tello-edu-py $ pip install -r requirements/dev

Unit Testing

Unit tests should be written under tests/. At the base of tests/ is a requirements.txt which should be used to install dependencies before testing. requirements/dev must also be installed?

~/tello-edu-py $ pip install -r tests/requirements.txt

To run tests, call test.py located in the base directory.

~/tello-edu-py $ py test.py

Note: It is required that this test is run using a 3.11 version of python. If your machine natively has a different version of python, install python v3.11.x and run test.py via that version:

~/tello-edu-py $ /path/to/python3.11 test.py

Changelog

v0.2.0 - Added functional components for the drone commands. See examples.