telloArduino

This is a Arduino library for controlling DJI tello through ESP32 Module.

This library controls the tello by sending commands via UDP as mentioned in the SDK documenatation in below link https://www.ryzerobotics.com/tello/downloads

Note: This library is compiled and tested with Arudino 1.8.13(Latest version of Arudino as of Nov/2020) with Wrover 32 hardware board. Please make sure to check if you have installed ESP32 board package you can find instructions here and the board chosen is the appropriate ESP board before compiling.

How to use the library ?

1. To download , enter "git clone https://github.com/akshayvernekar/telloArduino.git" in the terminal(Mac/linux) or command prompt(Windows) or click the DOWNLOAD ZIP button .

2. Place the "tello" folder in your arduinosketchfolder/libraries/ folder. You may need to create the libraries subfolder if its your first library. Restart the IDE.

3. In your Arduino Playground application go to Sketch > Include Library > choose "tello" from Contributed Libraries section to include this library in your skecth. Go to examples\tello_example.ino for example usage .

API usage

1. Create the object
Tello tello

2. Initialise the Object after your device gets the IP address
tello.init()

3 .Once the object is initalised you can use the various fubnctions to send commands to tello.
To take-off:
	bool takeoff();
	
For Tello auto land:
	bool land();
	
Set video stream on:
	bool startVideoStream();
	
Set video stream off:
	bool stopVideoStream();

Stop all motors immediately:
	bool turnOff();

Tello fly up with distance x cm(min:20cm , max = 500 cm):
	bool up(int x);
	
Tello fly down with distance x cm(min:20cm , max = 500 cm):	
	bool down(int x);
	
Tello fly left with distance x cm(min:20cm , max = 500 cm):
	bool left(int x);

Tello fly right with distance x cm(min:20cm , max = 500 cm):
	bool right(int x);

Tello fly forward with distance x cm(min:20cm , max = 500 cm):
	bool forward(int x);

Tello fly back with distance x cm(min:20cm , max = 500 cm):
	bool back(int x);

Tello rotate x degree clockwise(min:1, max:3600):
	bool rotate_clockwise(int deg);
	
Tello rotate x degree counter-clockwise	(min:1, max:3600):
	bool rotate_anticlockwise(int deg);
	
Ask Tello to flip front:
	bool flip_front();
	
Ask Tello to flip Right:
	bool flip_right();
	
Ask Tello to flip Left:
	bool flip_left();

Ask Tello to flip Back:
	bool flip_back();
	
Set speed to x cm/s:
	bool setSpeed(int x);

Send RC control via four channels(Yet to be implemented):
	bool sendRCcontrol(int x,int y,int z);
	
Set Wi-Fi with SSID password(Works only with EDU version, so havent tested):
	bool changeWifi(string ssid, string password);

@return for all the above commands: 
	true = if tello sent "ok" response for the command sent.
	false = if no response was received from tello, since the transmission is UDP 
		there might be packet loss and the response might have been lost.

Get Speed:
	int getSpeed();
	@return: speed value ranges from 1-100

Get Battery level percentage:
	int getBattery();
	@return: battery percentage 0-100
	
Get Current Flying time:
	int getTime();
	@return: time in seconds

Get current flying height:
	int getHeight();
	@return: height in cms value range 0-3000

Get temperature (°C):
	int getTemperature();
	@return: value range 0-90

Get barometer value (m):
	int getBaro();
	@return: value in meters

Using the example:

Replace the 'networkName' and 'networkPswd' with the SSID and password of your drone .