gobot

package module
v0.0.0-...-86e32b9 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Jul 28, 2014 License: Apache-2.0 Imports: 12 Imported by: 0

README

Gobot

http://gobot.io/

Gobot is a framework using the Go programming language (http://golang.org/) for robotics, physical computing, and the Internet of Things.

It provides a simple, yet powerful way to create solutions that incorporate multiple, different hardware devices at the same time.

Want to use Ruby or Javascript on robots? Check out our sister projects Artoo (http://artoo.io) and Cylon.js (http://cylonjs.com/)

Build Status Coverage Status

Examples

Gobot with Arduino
package main

import (
	"time"

	"github.com/hybridgroup/gobot"
	"github.com/hybridgroup/gobot/platforms/firmata"
	"github.com/hybridgroup/gobot/platforms/gpio"
)

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

	firmataAdaptor := firmata.NewFirmataAdaptor("arduino", "/dev/ttyACM0")
	led := gpio.NewLedDriver(firmataAdaptor, "led", "13")

	work := func() {
		gobot.Every(1*time.Second, func() {
			led.Toggle()
		})
	}

	robot := gobot.NewRobot("bot",
		[]gobot.Connection{firmataAdaptor},
		[]gobot.Device{led},
		work,
	)

	gbot.AddRobot(robot)

	gbot.Start()
}
Gobot with Sphero
package main

import (
	"fmt"
	"time"

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

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

	adaptor := sphero.NewSpheroAdaptor("sphero", "/dev/rfcomm0")
	driver := sphero.NewSpheroDriver(adaptor, "sphero")

	work := func() {
		gobot.Every(3*time.Second, func() {
			driver.Roll(30, uint16(gobot.Rand(360)))
		})
	}

	robot := gobot.NewRobot("sphero",
		[]gobot.Connection{adaptor},
		[]gobot.Device{driver},
		work,
	)

	gbot.AddRobot(robot)

	gbot.Start()
}

Hardware Support

Gobot has a extensible system for connecting to hardware devices. The following robotics and physical computing platforms are currently supported:

Support for many devices that use General Purpose Input/Output (GPIO) have a shared set of drivers provided using the cylon-gpio module:

  • GPIO <=> Drivers
    • Analog Sensor
    • Button
    • Digital Sensor
    • LED
    • Motor
    • Servo

Support for devices that use Inter-Integrated Circuit (I2C) have a shared set of drivers provided using the gobot-i2c module:

  • I2C <=> Drivers
    • BlinkM
    • HMC6352
    • Wii Nunchuck Controller

More platforms and drivers are coming soon...

Getting Started

Install Gobot with: go get -u github.com/hybridgroup/gobot

API:

Gobot includes a RESTful API to query the status of any robot running within a group, including the connection and device status, and execute device commands.

To activate the API, require the github.com/hybridgroup/gobot/api package and instantiate the API like this:

  gbot := gobot.NewGobot()
  api.NewAPI(gbot).Start()

You can also specify the api host and port, and turn on authentication:

  gbot := gobot.NewGobot()
  server := api.NewAPI(gbot)
  server.Port = "4000"
  server.Username = "Gort"
  server.Password = "klaatu"
  server.Start()

You may access the robeaux AngularJS interface with Gobot by navigating to http://localhost:3000/index.html.

Documentation

We're busy adding documentation to our web site at http://gobot.io/ please check there as we continue to work on Gobot

Thank you!

Contributing

  • All active development is in the dev branch. New or updated features must be added to the dev branch. Hotfixes will be considered on the master branch in situations where it does not alter behaviour or features, only fixes a bug.
  • All patches must be provided under the Apache 2.0 License
  • Please use the -s option in git to "sign off" that the commit is your work and you are providing it under the Apache 2.0 License
  • Submit a Github Pull Request to the appropriate branch and ideally discuss the changes with us in IRC.
  • We will look at the patch, test it out, and give you feedback.
  • Avoid doing minor whitespace changes, renamings, etc. along with merged content. These will be done by the maintainers from time to time but they can complicate merges and should be done seperately.
  • Take care to maintain the existing coding style.
  • golint and go fmt your code.
  • Add unit tests for any new or changed functionality.
  • All pull requests should be "fast forward"
    • If there are commits after yours use “git rebase -i <new_head_branch>”
    • If you have local changes you may need to use “git stash”
    • For git help see progit which is an awesome (and free) book on git

License

Copyright (c) 2013-2014 The Hybrid Group. Licensed under the Apache 2.0 license.

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func After 

func After(t time.Duration, f func())

After triggers the passed function after `t` duration.

func Every 

func Every(t time.Duration, f func())

Every triggers f every `t` time until the end of days.

func Expect 

func Expect(t *testing.T, a interface{}, b interface{})

func FromScale 

func FromScale(input, min, max float64) float64

func NewTestAdaptor 

func NewTestAdaptor(name string) *testAdaptor

func NewTestDriver 

func NewTestDriver(name string, adaptor *testAdaptor) *testDriver

func NewTestStruct 

func NewTestStruct() *testStruct

func On 

func On(e *Event, f func(s interface{}))

func Publish 

func Publish(e *Event, val interface{})

func Rand 

func Rand(max int) int

func ToScale 

func ToScale(input, min, max float64) float64

func Version 

func Version() string

Types

type Adaptor 

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

func NewAdaptor 

func NewAdaptor(name string, adaptorType string, v ...interface{}) *Adaptor

func (*Adaptor) Connected 

func (a *Adaptor) Connected() bool

func (*Adaptor) Name 

func (a *Adaptor) Name() string

func (*Adaptor) Params 

func (a *Adaptor) Params() map[string]interface{}

func (*Adaptor) Port 

func (a *Adaptor) Port() string

func (*Adaptor) SetConnected 

func (a *Adaptor) SetConnected(b bool)

func (*Adaptor) SetName 

func (a *Adaptor) SetName(s string)

func (*Adaptor) ToJSON 

func (a *Adaptor) ToJSON() *JSONConnection

func (*Adaptor) Type 

func (a *Adaptor) Type() string

type AdaptorInterface 

type AdaptorInterface interface {
	Finalize() bool
	Connect() bool
	Port() string
	Name() string
	Type() string
	Connected() bool
	SetConnected(bool)
	SetName(string)
	Params() map[string]interface{}
	ToJSON() *JSONConnection
}

type Connection 

type Connection AdaptorInterface

type Device 

type Device DriverInterface

type Driver 

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

func NewDriver 

func NewDriver(name string, driverType string, v ...interface{}) *Driver

func (*Driver) Adaptor 

func (d *Driver) Adaptor() AdaptorInterface

func (*Driver) AddCommand 

func (d *Driver) AddCommand(name string, f func(map[string]interface{}) interface{})

func (*Driver) AddEvent 

func (d *Driver) AddEvent(name string)

func (*Driver) Command 

func (d *Driver) Command(name string) func(map[string]interface{}) interface{}

func (*Driver) Commands 

func (d *Driver) Commands() map[string]func(map[string]interface{}) interface{}

func (*Driver) Event 

func (d *Driver) Event(name string) *Event

func (*Driver) Events 

func (d *Driver) Events() map[string]*Event

func (*Driver) Interval 

func (d *Driver) Interval() time.Duration

func (*Driver) Name 

func (d *Driver) Name() string

func (*Driver) Pin 

func (d *Driver) Pin() string

func (*Driver) SetInterval 

func (d *Driver) SetInterval(t time.Duration)

func (*Driver) SetName 

func (d *Driver) SetName(s string)

func (*Driver) SetPin 

func (d *Driver) SetPin(pin string)

func (*Driver) ToJSON 

func (d *Driver) ToJSON() *JSONDevice

func (*Driver) Type 

func (d *Driver) Type() string

type DriverInterface 

type DriverInterface interface {
	Start() bool
	Halt() bool
	Adaptor() AdaptorInterface
	SetInterval(time.Duration)
	Interval() time.Duration
	SetName(string)
	Name() string
	Pin() string
	SetPin(string)
	Command(string) func(map[string]interface{}) interface{}
	Commands() map[string]func(map[string]interface{}) interface{}
	AddCommand(string, func(map[string]interface{}) interface{})
	Events() map[string]*Event
	Event(string) *Event
	AddEvent(string)
	Type() string
	ToJSON() *JSONDevice
}

type Event 

type Event struct {
	Chan      chan interface{}
	Callbacks []func(interface{})
}

func NewEvent 

func NewEvent() *Event

func (*Event) Read 

func (e *Event) Read()

func (*Event) Write 

func (e *Event) Write(data interface{})

type Gobot 

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

func NewGobot 

func NewGobot() *Gobot

func (*Gobot) AddCommand 

func (g *Gobot) AddCommand(name string, f func(map[string]interface{}) interface{})

func (*Gobot) AddRobot 

func (g *Gobot) AddRobot(r *Robot) *Robot

func (*Gobot) Command 

func (g *Gobot) Command(name string) func(map[string]interface{}) interface{}

func (*Gobot) Commands 

func (g *Gobot) Commands() map[string]func(map[string]interface{}) interface{}

func (*Gobot) Robot 

func (g *Gobot) Robot(name string) *Robot

func (*Gobot) Robots 

func (g *Gobot) Robots() *robots

func (*Gobot) Start 

func (g *Gobot) Start()

func (*Gobot) ToJSON 

func (g *Gobot) ToJSON() *JSONGobot

type JSONConnection 

type JSONConnection struct {
	Name    string `json:"name"`
	Port    string `json:"port"`
	Adaptor string `json:"adaptor"`
}

type JSONDevice 

type JSONDevice struct {
	Name       string          `json:"name"`
	Driver     string          `json:"driver"`
	Connection *JSONConnection `json:"connection"`
	Commands   []string        `json:"commands"`
}

type JSONGobot 

type JSONGobot struct {
	Robots   []*JSONRobot `json:"robots"`
	Commands []string     `json:"commands"`
}

type JSONRobot 

type JSONRobot struct {
	Name        string            `json:"name"`
	Commands    []string          `json:"commands"`
	Connections []*JSONConnection `json:"connections"`
	Devices     []*JSONDevice     `json:"devices"`
}

type NullReadWriteCloser 

type NullReadWriteCloser struct{}

func (NullReadWriteCloser) Close 

func (NullReadWriteCloser) Close() error

func (NullReadWriteCloser) Read 

func (NullReadWriteCloser) Read(b []byte) (int, error)

func (NullReadWriteCloser) Write 

func (NullReadWriteCloser) Write(p []byte) (int, error)

type Robot 

type Robot struct {
	Name string

	Work func()
	// contains filtered or unexported fields
}

func NewRobot 

func NewRobot(name string, v ...interface{}) *Robot

func NewTestRobot 

func NewTestRobot(name string) *Robot

func (*Robot) AddCommand 

func (r *Robot) AddCommand(name string, f func(map[string]interface{}) interface{})

func (*Robot) AddConnection 

func (r *Robot) AddConnection(c Connection) Connection

func (*Robot) AddDevice 

func (r *Robot) AddDevice(d Device) Device

func (*Robot) Command 

func (r *Robot) Command(name string) func(map[string]interface{}) interface{}

func (*Robot) Commands 

func (r *Robot) Commands() map[string]func(map[string]interface{}) interface{}

func (*Robot) Connection 

func (r *Robot) Connection(name string) Connection

func (*Robot) Connections 

func (r *Robot) Connections() *connections

func (*Robot) Device 

func (r *Robot) Device(name string) Device

func (*Robot) Devices 

func (r *Robot) Devices() *devices

func (*Robot) Start 

func (r *Robot) Start()

func (*Robot) ToJSON 

func (r *Robot) ToJSON() *JSONRobot

Source Files

View all Source files

Directories

Path Synopsis
api
robeaux
platforms
ardrone
beaglebone
digispark
firmata
gpio
i2c
joystick
leap
neurosky
opencv
pebble
spark
sphero

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.