Python Tello

This is a library for easy usage of the Ryze Tello drone education edition.
Current Version: 2.1.0 Alpha
SDK 3.0 is here and tested! Documentation in progress!

Requirements:

• Python installed on your system or as a VS Code extension
• Ryze Tello EDU Edition (get one here)
• This package

Quickstart

This quickstart focuses on the file edition. To get instructions for the live edition, go to Tello Live Edition Guide

import telloFile # Imports library
tello = telloFile.Tello() # Sets var tello as the class
tello.connect() # Initializes SDK mode (more below)

(WRITEHERE.py)

Usage

The library consists of callable functions. To see set functions, please go here To see complex functions, please go here To see examples, please go here

tello.connect()

Initializes SDK mode. Must be run as the first function every time the script runs.
Possible responses: ok / error
Example:

tello.connect()

tello.takeoff()

Automatic takeoff.
Possible responses: ok / error
Example:

tello.takeoff()

tello.land()

Automatic landing.
Possible responses: ok / error
Example:

tello.land()

tello.video_stream_on()

Enable video stream.
Camera functionality under development
Possible responses: ok / error
Example:

tello.streamon()

tello.video_stream_off()

Disable video stream.
Camera functionality under development
Possible responses: ok / error
Example:

tello.streamoff()

tello.emergency()

Stops all motors immediately.
Danger of drone falling!
Possible responses: ok / error
Parameters:

• reason: String, optional. Reason for stopping motors.
  Example:

tello.emergency('The drone has hit a wall')

tello.stop()

Stops all movement and hovers in the air.
Possible responses: ok / error
Example:

tello.stop()

tello.up(x)

Ascends to x cm off the ground.
Possible responses: ok / error
Parameters:

• x: Integer. Height in cm. Allowed values: 20-500
  Example:

tello.up(30)

tello.down(x)

Descends to x cm off the ground.
Possible responses: ok / error
Parameters:

• x: Integer. Height in cm. Allowed values: 20-500
  Example:

tello.down(100)

tello.left(x)

Goes left for x cm.
Possible responses: ok / error
Parameters:

• x: Integer. Distance in cm. Allowed values: 20-500
  Example:

tello.left(249)

tello.right(x)

Goes right for x cm.
Possible responses: ok / error
Parameters:

• x: Integer. Distance in cm. Allowed values: 20-500
  Example:

tello.right(23)

tello.forward(x)

Goes forwards for x cm.
Possible responses: ok / error
Parameters:

• x: Integer. Distance in cm. Allowed values: 20-500
  Example:

tello.forward(500)

tello.back(x)

Goes backwards for x cm.
Possible responses: ok / error
Parameters:

• x: Integer. Distance in cm. Allowed values: 20-500
  Example:

tello.back(65)

tello.cw(x)

Rotates clockwise for x degrees.
Possible responses: ok / error
Parameters:

• x: Integer. Degrees to turn. Allowed values: 1-360
  Example:

tello.cw(100)

tello.ccw(x)

Rotates counter-clockwise for x degrees.
Possible responses: ok / error
Parameters:

• x: Integer. Degrees to turn. Allowed values: 1-360
  Example:

tello.ccw(359)

tello.flip(x)

Flips drone in x direction.
Possible responses: ok / error
Parameters:

• x: String. Direction to flip. Allowed values: 'f' (forwards), 'b' (backwards), 'l' (left), 'r' (right)
  Example:

tello.flip('l')

tello.throw_fly()

Toss the drone in the air within 5 seconds of receiving response to takeoff
Possible responses: ok / error
Example:

tello.throw_fly()

tello.motor_on()

Turns on motors (at a slow RPM)
Possible responses: ok / error
Example:

tello.motor_on()

tello.motor_off()

Turns off motors (use motor_on() first)
Possible responses: ok / error
Example:

tello.motor_off()

tello.throw_fly()

Turns off motors (use tello.motoron() first)
Possible responses: ok / error
Example:

tello.motoroff()

tello.end()

Ends the program.
Possible responses: ok / Thrown error
Example:

tello.end()

Version history:

2.1.0-alpha

• Tested all new EXT commands
• Tested most other new commands
• setup.py changes (long-description)
• deepsource.toml changes (max-line-limt: 100)
• tello.set_display_ascii_character() is still being tested.

2.0.5-alpha

• setup.py changes
• Re-releasing on pip

2.0.4-alpha

• Readded .deepsource.toml
• Hopefully fixed pip 'No Description provided' issue

2.0.3-alpha

• Reorganized structure for PyPi
• Added LICENSE.txt (MIT License)
• Added setup.cfg
• Added setup.py and configured for PyPi
• Added tello-sdk/init.py
• We're pip installable now!

2.0.2-alpha

• Style fixes
• Started work on going pip-ready :)
• Changed all print to logging (for easier debugging)
• Added debugging and tips options to Tello class

2.0.1-alpha

• Small fixes

2.0-alpha

• All new Tello SDK 3.0 commands implemented!
• Small potential bug/style fixes
• This is an Alpha version, so it is not stable, by any means!

1.1.2-alpha

• Potential bug fixes
• Security issue fix
• Performance optimizations
• Remodel of init function

1.1-beta:

• Implementation of some Tello SDK 3.0 commands
• Naming changes
• Functions now return the response
• In development: camera functions, customization, SDK 3.0 full implementation
• V1.1.1: spelling fix

1.0-beta:

• Implement most of Tello SDK 2.0 commands
• Documentation started
• tello.run() command for executing any command straight to the drone.