Python SDK fro the Tello EDU and RMTT drones, with all commands and more
Project description
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for tello_sdk-2.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ab5447e665cdf4defc2ecbe9d7f569af2b0fc0edbd5c72cfb7b403669817269b |
|
MD5 | 67a9e0554d510c2bf89eecbb4a37ffb9 |
|
BLAKE2b-256 | 6979190568bcad5230068b2fe20ab41a9a273d109c51200d119c2bfff5f5b089 |