gobot

package module
v0.0.0-...-885376e Latest Latest
Warning

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

Go to latest
Published: Aug 22, 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

Directories

Path Synopsis
api
platforms
i2c

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL