Giter Club home page Giter Club logo

tello's Introduction

tello Go Package

This tello package provides an unofficial, easy-to-use, standalone API for the Ryze Tello® drone.

Disclaimer

Tello is a registered trademark of Ryze Tech. The author of this package is in no way affiliated with Ryze, DJI, or Intel.

The package has been developed by gathering together information from a variety of sources on the Internet (especially https://tellopilots.com) and by examining data packets sent to/from the Tello. The package will probably be extended as more knowledge of the drone's protocol is obtained.

Use this package at your own risk. The author(s) is/are in no way responsible for any damage caused either to or by the drone when using this software.

Features

The following features have been implemented...

  • Stick-based flight control, ie. for joystick, game-, or flight-controller
  • Drone built-in flight commands, eg. Takeoff(), PalmLand()
  • Macro-level flight control, eg. Forward(), Up()
  • Autopilot flight control, eg. AutoFlyToHeight(), AutoFlyToXY()
  • Video stream support
  • Enriched flight-data (some log data is added)
  • Picture taking/saving support
  • Multiple drone support - Untested

See ImplementationChart.md for full details of what functions are currently implemented.

Documentation should be available locally via godoc, or via godoc.org.

An example application using this package is available at telloterm.

Here is an example of just about the simplest use of the package...

package main
import (
  "log"
  "time"
  "github.com/SMerrony/tello"
)

func main() {
  	drone := new(tello.Tello)
  err := drone.ControlConnectDefault()
  if err != nil {
    log.Fatalf("%v", err) 
  }

  drone.TakeOff()
  time.Sleep(10 * time.Second)
  drone.Land()
  drone.ControlDisconnect()
}

Concepts

Connection Types

The drone provides two types of connection: a 'control' connection which handles all commands to and from the drone including flight, status and (still) pictures, and a 'video' connection which provides an H.264 video stream from the forward-facing camera.

You must establish a control connection to use the drone, but the video connection is optional and cannot be started unless a control connection is running.

Funcs vs. Channels

Certain functionality is made available in two forms: single-shot function calls and streaming (channel) data flows. Eg. GetFlightData() vs. StreamFlightData(), and UpdateSticks() vs. StartStickListener().

Use whichever paradigm you prefer, but be aware that the channel-based calls should return immediately (the channels are buffered) whereas the function-based options could conceivably cause your application to pause very briefly if the Tello is very busy; in practice, the author has not found this to be an issue.

tello's People

Contributors

filippobottega avatar smerrony avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

tello's Issues

Tello doesn't takeoff

Expected Behavior

Hello,
I'have connected my laptop to Tello network and I run the demo code using the debug:

package main
import (
  "log"
  "time"
  "github.com/SMerrony/tello"
)

func main() {
  	drone := new(tello.Tello)
  err := drone.ControlConnectDefault()
  if err != nil {
    log.Fatalf("%v", err) 
  }

  drone.TakeOff()
  time.Sleep(10 * time.Second)
  drone.Land()
  drone.ControlDisconnect()
}

Current Behavior

I have no errors from the execution but Tello drone didn't takeoff.

Your Environment

  • Go Version used: go version go1.10.3 windows/amd64
  • Tello Package Version or Date: 31/07/2018
  • Operating System and version: Windows 10 1083

Python wrapper for repo

Hello,

First of all, thank you for your github.

Sadly, I do not know how to use Go, that is why I wanted to ask if there is any Python wrapper for this git that you know of? or if anyone has implemented this.

Thank you

Arshad

Picture is not transferred correctly when any chunk is received twice

Expected Behavior

Picture is successfully received even when flying in area with heavy signal interference.

Current Behavior

It is almost impossible to capture picture in locations with high signal interference, due to bug I have discovered and fixed in this commit. (But unfortunately this commit contains also another improvements for communication, so it isn't easy to see, where exactly the fix is.)

Current implementation of picture transfer is counting every received chunk and rejects all chunks when piece already have received 8 chunks. In situation, where any chunk is received twice, there will be some chunks missing in that piece. As result whole image is not saved.

Possible Solution

Move this line in tello.go (on line 347):
tello.fileTemp.pieces[thisChunk.pieceNum].numChunks++

To the inside of if body on line 342:
if !already {

This causes only properly received chunks to be counted and (so far during my testing) every image to be received.

Steps to Reproduce (for bugs)

  1. Connect to tello
  2. Take some pictures (10+)
  3. Save pictures
  4. Disconnect from tello
  5. Some pictures might be missing based on interference between drone and your WiFi adapter

Your Environment

  • Go Version used: go version go1.11.5 linux/amd64
  • Tello Package Version or Date: 401f34d
  • Operating System and version: Arch Linux

After a failed Connect, retries always return already connecting error

Expected Behavior

Once a connection attempt has failed, things should be reset to allow future attempts.

Current Behavior

After initial failure, always get a "Tello connection atempt already in progress" error.

Your Environment

  • Go Version used: 1.10.3
  • Tello Package Version or Date: v0.8.0
  • Operating System and version: Win10 and Ubuntu 18.04

Land command appears to be ignored

I tried running telloterm and using your library and ran into the same issue- if I send a takeoff command and then a land command even a few seconds later, the land command is ignored. In the basic example you provide, takeoff, wait 10s and land works, but as soon as I try less time- say 1s or 3s- the land command is ignored.

I'm going to implement the basic UDP comms and see if I can replicate this.

Here's the exact code I'm using:

package main

import (
	"fmt"
	"log"

	"github.com/SMerrony/tello"
)

func basicTakeOffAndLandingDemo() {
	fmt.Println("Demo: Connect, takeoff, hover, land")
	fmt.Println("Connecting to drone...")

	drone := new(tello.Tello)
	err := drone.ControlConnectDefault()
	if err != nil {
		log.Fatalf("%v", err)
	}

	drone.TakeOff()
	time.Sleep(3 * time.Second) // 1 second doesn't work
	drone.Land()
	drone.ControlDisconnect()

	fmt.Println("Disconnected from drone...")
}

func main() {
	basicTakeOffAndLandingDemo()
}

gRPC support

Hello,
I'd like to use tello library from C# or VB.NET. I think that gRPC may be a solution to consume this library from a .NET desktop application.
What do you think about implementing a gRPC server?

Thank you,
Filippo.

ControlDisconnect() can hang after reconnecting

Expected Behavior

ControlDisconnect() should always succeed.

Current Behavior

After connecting, disconnecting, (re)connecting, the next ControlDisconnect call hangs.

Possible Solution

Looks as if the semaphore channels are blocking.

Autopilot wrong direction

Expected Behavior

Current Behavior

Possible Solution

maybe add Autofly (direction,distance) like scratch or python but can adjust speed ( more than 1m/s ) and more range (more than 5 m) like now

Steps to Reproduce (for bugs)

Context

many times

Your Environment

  • Go Version used: 1.10.3
  • Tello Package Version or Date: V1.03.33.01
  • Operating System and version: Windows 10 pro build 1803

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.