Tellojs!

The easy-to-use javascript (uses ts) library for tello drones.

Quick Start

First, make sure you have Deno installed. Learn how to here. We also recommend using vscode and installing the Deno extension for better dev experience.

If you have the vscode extension, open the command palette and run > Deno: initialize workspace configuration, and say yes to the promps

Next, create a file called mod.ts like this:

Replace insert version with the version when you go here. (i.e. v1.0.3)

// mod.ts
import DroneController from "https://deno.land/x/tellojs@INSERT_VERSION/mod.ts";

const drone = new DroneController();

await drone.connect();
await drone.enqueue(
  drone.takeOff(),
);
await drone.disconnect();

By default, it'll connect to the drone based on these options. You can pass different connection ports and whatnot in JSON to the drone controller. The code itself is pretty self-explanatory- it connects to the drone, queues the takeoff command, then lands and disconnects the drone via drone.disconnect().

The enqueue command is pretty important, as it ensures that commands are running once the previous command has been ran, rather than relying on time. You can even stack multiple enqueue commands, or abstract it out into a file or loop. That being said, time isn't out of the question. For example:

//...
await drone.enqueue(
  drone.takeOff(),
  drone.xMovement(100),
  drone.wait(2000), //waits 2000ms, or 2 seconds before continuing
  drone.zMovement(100)
);
//...

If you want to see all the commands, see the API reference or the deno documentation (probably more up-to-date.)

API Reference

Here is the list of commands you can send the drone:

  • emergency: Stops the propellers and lands the drone immediatly
  • execute: Execute any command on the drone
  • flip: Flip in a direction
  • goto Go to a location based on coordiantes
  • land: Land the drone (part of disconnect)
  • rotate: Spin the drone
  • speed: Set the speed of the drone
  • takeOff: Take off- put the drone in the air
  • wait: Wait time in milliseconds
  • wifi: Set custom wifi credentials or access point credentials
  • xMovement: Move forward and backwards
  • yMovement: Move up and down
  • zMovement: Move left or right

You can also view specifics about the commands (and see a more up-to-date list too) here

Note that we don't support all the commands related to mission pads. Use the execute() function to send your own commands to the drone. A full list of the commands is available on the SDK 2.0 User Guide.

Credits and More Information

Made by @quick007 and @Blocksnmore

Mainly reverse-engineered from the SDK 2.0 User Guide

Loosely based on a repo by jsolderitsch for udp connection information