ble

package
v1.1.0 Latest Latest
Warning

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

 Go to latest Published: Jan 9, 2017 License: Apache-2.0, Apache-2.0 Imports: 7 Imported by: 0

README

Bluetooth LE

The Gobot BLE adaptor makes it easy to interact with Bluetooth LE aka Bluetooth 4.0 using Go.

It is written using the gatt package fork by Currant Labs of the package from Paypal. Thank you!

Learn more about Bluetooth LE at http://en.wikipedia.org/wiki/Bluetooth_low_energy

This package also includes drivers for several well-known BLE Services:

  • Battery Service
  • Device Information Service
  • Generic Access Service

How to Install

go get gobot.io/x/gobot && go install gobot.io/x/gobot/platforms/ble
OSX

You need to have XCode installed to be able to compile code that uses the Gobot BLE adaptor on OSX. This is because the gatt package uses a CGo based implementation.

Ubuntu

Everything should already just compile on most Linux systems.

How To Connect

When using BLE a "peripheral" aka "server" is something you connect to such a a pulse meter. A "central" aka "client" is what does the connecting, such as your computer or mobile phone.

You need to know the BLE ID of the peripheral you want to connect to. The Gobot BLE client adaptor also lets you connect to a peripheral by friendly name.

OSX

To run any of the Gobot BLE code you must use the GODEBUG=cgocheck=0 flag in order to get around some of the issues in the CGo-based implementation.

For example:

GODEBUG=cgocheck=0 go run examples/minidrone.go 8b2f8032290143e18fc7c426619632e8

OSX uses its own Bluetooth ID system which is different from the IDs used on Linux. The code calls thru the XPC interfaces provided by OSX, so as a result does not need to run under sudo.

Ubuntu

On Linux the BLE code will need to run as a root user account. The easiest way to accomplish this is probably to use go build to build your program, and then to run the requesting executable using sudo.

For example:

go build examples/minidrone.go
sudo ./minidrone AA:BB:CC:DD:EE
Windows

Hopefully coming soon...

How to Use

Here is an example that uses the BLE "Battery" service to retrieve the current change level of the peripheral device:

package main

import (
	"fmt"
	"os"
	"time"

	"gobot.io/x/gobot"
	"gobot.io/x/gobot/platforms/ble"
)

func main() {
	bleAdaptor := ble.NewClientAdaptor(os.Args[1])
	battery := ble.NewBatteryDriver(bleAdaptor)

	work := func() {
		gobot.Every(5*time.Second, func() {
			fmt.Println("Battery level:", battery.GetBatteryLevel())
		})
	}

	robot := gobot.NewRobot("bleBot",
		[]gobot.Connection{bleAdaptor},
		[]gobot.Device{battery},
		work,
	)

	robot.Start()
}

Documentation

Overview

Package ble provides the Gobot adaptor for Bluetooth LE.

It also includes drivers for several well-known BLE Services:

- Battery Service - Device Information Service - Generic Access Service

For more information refer to the README: https://github.com/hybridgroup/gobot/blob/master/platforms/ble/README.md

Index

Constants

This section is empty.

Variables

View Source 
var DefaultClientOptions = []gatt.Option{
	gatt.LnxMaxConnections(1),
	gatt.LnxDeviceID(-1, false),
}

TODO: handle other OS defaults besides Linux

Functions

This section is empty.

Types

type BatteryDriver added in v1.0.0 

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

BatteryDriver represents the Battery Service for a BLE Peripheral

func NewBatteryDriver added in v1.0.0 

func NewBatteryDriver(a *ClientAdaptor) *BatteryDriver

NewBatteryDriver creates a BatteryDriver

func (*BatteryDriver) Connection added in v1.0.0 

func (b *BatteryDriver) Connection() gobot.Connection

Connection returns the Driver's Connection to the associated Adaptor

func (*BatteryDriver) GetBatteryLevel added in v1.0.0 

func (b *BatteryDriver) GetBatteryLevel() (level uint8)

GetBatteryLevel reads and returns the current battery level

func (*BatteryDriver) Halt added in v1.0.0 

func (b *BatteryDriver) Halt() (err error)

Halt stops battery driver (void)

func (*BatteryDriver) Name added in v1.0.0 

func (b *BatteryDriver) Name() string

Name returns the Driver name

func (*BatteryDriver) SetName added in v1.0.0 

func (b *BatteryDriver) SetName(n string)

SetName sets the Driver name

func (*BatteryDriver) Start added in v1.0.0 

func (b *BatteryDriver) Start() (err error)

Start tells driver to get ready to do work

type ClientAdaptor added in v1.0.0 

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

Represents a Client Connection to a BLE Peripheral

func NewClientAdaptor added in v1.0.0 

func NewClientAdaptor(uuid string) *ClientAdaptor

NewClientAdaptor returns a new ClientAdaptor given a uuid

func (*ClientAdaptor) Connect added in v1.0.0 

func (b *ClientAdaptor) Connect() (err error)

Connect initiates a connection to the BLE peripheral. Returns true on successful connection.

func (*ClientAdaptor) ConnectHandler added in v1.0.0 

func (b *ClientAdaptor) ConnectHandler(p gatt.Peripheral, err error)

func (*ClientAdaptor) Disconnect added in v1.0.0 

func (b *ClientAdaptor) Disconnect() (err error)

Disconnect terminates the connection to the BLE peripheral. Returns true on successful disconnect.

func (*ClientAdaptor) DisconnectHandler added in v1.0.0 

func (b *ClientAdaptor) DisconnectHandler(p gatt.Peripheral, err error)

func (*ClientAdaptor) DiscoveryHandler added in v1.0.0 

func (b *ClientAdaptor) DiscoveryHandler(p gatt.Peripheral, a *gatt.Advertisement, rssi int)

func (*ClientAdaptor) Finalize added in v1.0.0 

func (b *ClientAdaptor) Finalize() (err error)

Finalize finalizes the BLEAdaptor

func (*ClientAdaptor) Name added in v1.0.0 

func (b *ClientAdaptor) Name() string

func (*ClientAdaptor) Peripheral added in v1.0.0 

func (b *ClientAdaptor) Peripheral() gatt.Peripheral

func (*ClientAdaptor) ReadCharacteristic added in v1.0.0 

func (b *ClientAdaptor) ReadCharacteristic(sUUID string, cUUID string) (data []byte, err error)

ReadCharacteristic returns bytes from the BLE device for the requested service and characteristic

func (*ClientAdaptor) Reconnect added in v1.0.0 

func (b *ClientAdaptor) Reconnect() (err error)

Reconnect attempts to reconnect to the BLE peripheral. If it has an active connection it will first close that connection and then establish a new connection. Returns true on Successful reconnection

func (*ClientAdaptor) SetName added in v1.0.0 

func (b *ClientAdaptor) SetName(n string)

func (*ClientAdaptor) StateChangeHandler added in v1.0.0 

func (b *ClientAdaptor) StateChangeHandler(d gatt.Device, s gatt.State)

func (*ClientAdaptor) Subscribe added in v1.0.0 

func (b *ClientAdaptor) Subscribe(sUUID string, cUUID string, f func([]byte, error)) (err error)

Subscribe subscribes to notifications from the BLE device for the requested service and characteristic

func (*ClientAdaptor) UUID added in v1.0.0 

func (b *ClientAdaptor) UUID() string

func (*ClientAdaptor) WriteCharacteristic added in v1.0.0 

func (b *ClientAdaptor) WriteCharacteristic(sUUID string, cUUID string, data []byte) (err error)

WriteCharacteristic writes bytes to the BLE device for the requested service and characteristic

type DeviceInformationDriver added in v1.0.0 

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

DeviceInformationDriver represents the Device Information Service for a BLE Peripheral

func NewDeviceInformationDriver added in v1.0.0 

func NewDeviceInformationDriver(a *ClientAdaptor) *DeviceInformationDriver

NewDeviceInformationDriver creates a DeviceInformationDriver

func (*DeviceInformationDriver) Connection added in v1.0.0 

func (b *DeviceInformationDriver) Connection() gobot.Connection

Connection returns the Driver's Connection to the associated Adaptor

func (*DeviceInformationDriver) GetFirmwareRevision added in v1.0.0 

func (b *DeviceInformationDriver) GetFirmwareRevision() (revision string)

GetFirmwareRevision returns the firmware revision for the BLE Peripheral

func (*DeviceInformationDriver) GetHardwareRevision added in v1.0.0 

func (b *DeviceInformationDriver) GetHardwareRevision() (revision string)

GetHardwareRevision returns the hardware revision for the BLE Peripheral

func (*DeviceInformationDriver) GetManufacturerName added in v1.0.0 

func (b *DeviceInformationDriver) GetManufacturerName() (manufacturer string)

GetManufacturerName returns the manufacturer name for the BLE Peripheral

func (*DeviceInformationDriver) GetModelNumber added in v1.0.0 

func (b *DeviceInformationDriver) GetModelNumber() (model string)

GetModelNumber returns the model number for the BLE Peripheral

func (*DeviceInformationDriver) GetPnPId added in v1.0.0 

func (b *DeviceInformationDriver) GetPnPId() (model string)

GetPnPId returns the PnP ID for the BLE Peripheral

func (*DeviceInformationDriver) Halt added in v1.0.0 

func (b *DeviceInformationDriver) Halt() (err error)

Halt stops driver (void)

func (*DeviceInformationDriver) Name added in v1.0.0 

func (b *DeviceInformationDriver) Name() string

Name returns the Driver name

func (*DeviceInformationDriver) SetName added in v1.0.0 

func (b *DeviceInformationDriver) SetName(n string)

SetName sets the Driver name

func (*DeviceInformationDriver) Start added in v1.0.0 

func (b *DeviceInformationDriver) Start() (err error)

Start tells driver to get ready to do work

type GenericAccessDriver added in v1.1.0 

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

GenericAccessDriver represents the Generic Access Service for a BLE Peripheral

func NewGenericAccessDriver added in v1.1.0 

func NewGenericAccessDriver(a *ClientAdaptor) *GenericAccessDriver

NewGenericAccessDriver creates a GenericAccessDriver

func (*GenericAccessDriver) Connection added in v1.1.0 

func (b *GenericAccessDriver) Connection() gobot.Connection

Connection returns the Driver's Connection to the associated Adaptor

func (*GenericAccessDriver) GetAppearance added in v1.1.0 

func (b *GenericAccessDriver) GetAppearance() string

GetAppearance returns the appearance string for the BLE Peripheral

func (*GenericAccessDriver) GetDeviceName added in v1.1.0 

func (b *GenericAccessDriver) GetDeviceName() string

GetDeviceName returns the device name for the BLE Peripheral

func (*GenericAccessDriver) Halt added in v1.1.0 

func (b *GenericAccessDriver) Halt() (err error)

Halt stops driver (void)

func (*GenericAccessDriver) Name added in v1.1.0 

func (b *GenericAccessDriver) Name() string

Name returns the Driver name

func (*GenericAccessDriver) SetName added in v1.1.0 

func (b *GenericAccessDriver) SetName(n string)

SetName sets the Driver name

func (*GenericAccessDriver) Start added in v1.1.0 

func (b *GenericAccessDriver) Start() (err error)

Start tells driver to get ready to do work

type Service added in v1.0.0 

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

Represents a BLE Peripheral's Service

func NewService added in v1.0.0 

func NewService(sUuid string, service *gatt.Service) *Service

NewService returns a new BLE Service given a uuid

Source Files

View all Source files

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.