bebop

README

Bebop

The Bebop from Parrot is an inexpensive quadcopter that is controlled using WiFi. It includes a built-in front-facing HD video camera, as well as a second lower resolution bottom facing video camera.

How to Install

go get -d -u github.com/hybridgroup/gobot/... && go install github.com/hybridgroup/gobot/platforms/bebop

How to Use

package main

import (
	"time"

	"github.com/hybridgroup/gobot"
	"github.com/hybridgroup/gobot/platforms/bebop"
)

func main() {
	gbot := gobot.NewGobot()

	bebopAdaptor := bebop.NewBebopAdaptor("Drone")
	drone := bebop.NewBebopDriver(bebopAdaptor, "Drone")

	work := func() {
    drone.HullProtection(true)
		gobot.On(drone.Event("bebop:flying"), func(data interface{}) {
			gobot.After(3*time.Second, func() {
				drone.Land()
			})
		})
		drone.TakeOff()
	}

	robot := gobot.NewRobot("drone",
		[]gobot.Connection{bebopAdaptor},
		[]gobot.Device{drone},
		work,
	)
	gbot.AddRobot(robot)

	gbot.Start()
}

How to Connect

The Bebop is a WiFi device, so there is no additional work to establish a connection to a single drone. However, in order to connect to multiple drones, you need to perform some configuration steps on each drone via SSH.

Bebop now has (incomplete) telemetry support, and Gobot events will be posted by the driver for many types of onboard event. Events that may be posted (where supported) are provided as a slice of strings as bebop.BebopEvents. Events are all prefixed with "bebop:" so that autoposted events from Bebop drivers won't clutter or clobber the event system for other robots.

Documentation

Overview

Package bebop provides the Gobot adaptor and driver for the Parrot Bebop.

Installing:

go get -d -u github.com/hybridgroup/gobot/... && go install github.com/hybridgroup/gobot/platforms/bebop

For more information refer to the bebop README: https://github.com/hybridgroup/gobot/tree/master/platforms/bebop

Index

• type BebopAdaptor
  • func NewBebopAdaptor(name string) *BebopAdaptor
  • func (a *BebopAdaptor) Connect() (errs []error)
  • func (a *BebopAdaptor) Finalize() (errs []error)
  • func (a *BebopAdaptor) Name() string
  • func (a *BebopAdaptor) Telemetry() chan bbtelem.TelemetryPacket
• type Driver
  • func NewBebopDriver(connection *BebopAdaptor, name string) *Driver
  • func (a *Driver) Backward(speed int)
  • func (a *Driver) Clockwise(speed int)
  • func (a *Driver) Connection() gobot.Connection
  • func (a *Driver) CounterClockwise(speed int)
  • func (a *Driver) Debug(f func(string, []byte))
  • func (a *Driver) Down(speed int)
  • func (a *Driver) Forward(speed int)
  • func (a *Driver) Halt() (errs []error)
  • func (a *Driver) HullProtection(protect bool) error
  • func (a *Driver) Land()
  • func (a *Driver) Left(speed int)
  • func (a *Driver) Name() string
  • func (a *Driver) Outdoor(outdoor bool) error
  • func (a *Driver) Right(speed int)
  • func (a *Driver) Start() (errs []error)
  • func (a *Driver) StartRecording() error
  • func (a *Driver) Stop()
  • func (a *Driver) StopRecording() error
  • func (a *Driver) StopTelemetry() error
  • func (a *Driver) TakeOff()
  • func (a *Driver) Up(speed int)
  • func (a *Driver) Video() chan []byte

Types

type BebopAdaptor

type BebopAdaptor struct {
	// contains filtered or unexported fields
}

BebopAdaptor is gobot.Adaptor representation for the Bebop

func NewBebopAdaptor

func NewBebopAdaptor(name string) *BebopAdaptor

NewBebopAdaptor returns a new BebopAdaptor

func (*BebopAdaptor) Connect

func (a *BebopAdaptor) Connect() (errs []error)

Connect establishes a connection to the ardrone

func (*BebopAdaptor) Finalize

func (a *BebopAdaptor) Finalize() (errs []error)

Finalize terminates the connection to the ardrone

func (*BebopAdaptor) Name

func (a *BebopAdaptor) Name() string

Name returns the BebopAdaptors Name

func (*BebopAdaptor) Telemetry

func (a *BebopAdaptor) Telemetry() chan bbtelem.TelemetryPacket

Telemetry returns a channel on which to receive Telemetry from the device.

type Driver

type Driver struct {
	gobot.Eventer
	// contains filtered or unexported fields
}

Driver is gobot.Driver representation for the Bebop

func NewBebopDriver

func NewBebopDriver(connection *BebopAdaptor, name string) *Driver

NewBebopDriver creates an BebopDriver with specified name.

func (*Driver) Backward

func (a *Driver) Backward(speed int)

Backward causes the drone go forward, controls the pitch. speed can be a value from `0` to `100`.

func (*Driver) Clockwise

func (a *Driver) Clockwise(speed int)

Clockwise causes the drone to spin in clockwise direction speed can be a value from `0` to `100`.

func (*Driver) Connection

func (a *Driver) Connection() gobot.Connection

Connection returns the Drivers Connection

func (*Driver) CounterClockwise

func (a *Driver) CounterClockwise(speed int)

CounterClockwise the drone to spin in counter clockwise direction speed can be a value from `0` to `100`.

func (*Driver) Debug

func (a *Driver) Debug(f func(string, []byte))

Debug registers a given function to subscribe to all known Bebop Events, including "unknown" and "error"

func (*Driver) Down

func (a *Driver) Down(speed int)

Down makes the drone reduce altitude. speed can be a value from `0` to `100`.

func (*Driver) Forward

func (a *Driver) Forward(speed int)

Forward causes the drone go forward, controls the pitch. speed can be a value from `0` to `100`.

func (*Driver) Halt

func (a *Driver) Halt() (errs []error)

Halt halts the Driver

func (*Driver) HullProtection

func (a *Driver) HullProtection(protect bool) error

HullProtection tells the drone if the hull/prop protectors are attached. This is needed to adjust flight characteristics of the Bebop.

func (*Driver) Land

func (a *Driver) Land()

Land causes the drone to land

func (*Driver) Left

func (a *Driver) Left(speed int)

Left causes the drone to bank to the left, controls the roll, which is a horizontal movement using the camera as a reference point. speed can be a value from `0` to `100`.

func (*Driver) Name

func (a *Driver) Name() string

Name returns the Drivers Name

func (*Driver) Outdoor

func (a *Driver) Outdoor(outdoor bool) error

Outdoor tells the drone if flying Outdoor or not. This is needed to adjust flight characteristics of the Bebop.

func (*Driver) Right

func (a *Driver) Right(speed int)

Right causes the drone to bank to the right, controls the roll, which is a horizontal movement using the camera as a reference point. speed can be a value from `0` to `100`.

func (*Driver) Start

func (a *Driver) Start() (errs []error)

Start starts the Driver. This spins out a goroutine to read telemetry from the adaptor and post events;

func (*Driver) StartRecording

func (a *Driver) StartRecording() error

StartRecording starts the recording video to the drones interal storage

func (*Driver) Stop

func (a *Driver) Stop()

Stop makes the drone to hover in place.

func (*Driver) StopRecording

func (a *Driver) StopRecording() error

StopRecording stops a previously started recording

func (*Driver) StopTelemetry

func (a *Driver) StopTelemetry() error

StopTelemetry stops further telemetry messages being posted to the event queue, and closes the channel from the adaptor also.

func (*Driver) TakeOff

func (a *Driver) TakeOff()

TakeOff makes the drone start flying

func (*Driver) Up

func (a *Driver) Up(speed int)

Up makes the drone gain altitude. speed can be a value from `0` to `100`.

func (*Driver) Video

func (a *Driver) Video() chan []byte

Video returns a channel which raw video frames will be broadcast on