Skip to content
A Python interface for the Ryze Tello drone.
Branch: master
Clone or download
Pull request Compare This branch is 12 commits ahead of microlinux:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples
testing
.gitignore
README.md
main.py
tello.py

README.md

A Python interface for the Ryze Tello drone.

inital fork date: 9 February 2019
This code and documentation is based on the Tello SDK documentation as of 3/19/2018.

The tello module provides a Tello class, which interacts with the Tello API.

The Tello has an IP of 192.168.10.1. The device sending commands must be connected to the Tello WiFi network and have an IP in the 192.168.10.0/24 range.

Tello Object

Tello objects require a minimum of 2 parameters to initialize, the local IP address and port to bind.

drone = tello.Tello('192.168.10.2', 8888)

Methods that require distance or speed parameters expect feet or MPH. Include parameter imperial=False for meters and KPH.

drone = tello.Tello('192.168.10.2', 8888, imperial=False)

If you send a command to the Tello and it doesn't respond within .3 seconds, a RuntimeError is raised. You may specify the number of seconds to wait with the timeout parameter.

drone = tello.Tello('192.168.10.2', 8888, imperial=False, timeout=.5)

When you initialize a Tello object, it attempts to connect to the Tello and enter command mode. If this fails, a RuntimeError is raised.

Once initialized, a number of methods are available to send commands to the Tello. It will respond with OK, FALSE or a numeric value, which the methods return.

These methods do what you'd expect. Responses are OK or FALSE.

Tello.takeoff()
Tello.land()

Methods that perform vertical or horizontal movements require a single parameter, distance. Responses are OK or FALSE.

The unit of distance is feet or meters. The SDK accepts distances of 1 to 500 centimeters. Realistically, this translates to .1 - 5 meters or .7 - 16.4 feet.

Tello.move_forward(distance)
Tello.move_backward(distance)
Tello.move_right(distance)
Tello.move_left(distance)
Tello.move_up(distance)
Tello.move_down(distance)

Methods that rotate require a single parameter, degrees. The SDK accepts values from 1 to 360. Responses are OK or FALSE.

Tello.rotate_cw(degrees)
Tello.rotate_ccw(degrees)

The method to set speed requires a single parameter, speed. Responses are OK or FALSE.

The unit of speed is KPH or MPH. The SDK accepts speeds from 1 to 100 centimeters/second. Realistically, this translates to .1 to 3.6 KPH or .1 to 2.2 MPH.

Tello.set_speed(speed)

The method to flip requires a single parameter, direction. The SDK accepts l, r, f, b, lf, lb, rf or rb. Responses are OK or FALSE.

Tello.flip(direction)

Methods that retrieve information from the Tello take no parameters. Responses are numeric values.

Get current speed in KPH or MPH:

Tello.get_speed()

Get percent battery life remaining:

Tello.get_battery()

Get elapsed flight time in seconds:

Tello.get_flight_time()

Example main.py

import tello
import time

drone = tello.Tello('192.168.10.2', 8888)

drone.takeoff()
time.sleep(5)

drone.set_speed(2)
time.sleep(1)

drone.move_up(3)
time.sleep(5)

drone.move_forward(10)
time.sleep(10)

drone.rotate_cw(180)
time.sleep(5)

drone.move_forward(10)
time.sleep(10)

drone.land()

print 'Flight time: %s' % drone.get_flight_time()
You can’t perform that action at this time.