protocol

Documentation

Overview

Package protocol implements the LIFX LAN protocol.

This package is not designed to used directly by end users, other than to specify a protocol version when creating a new Client from the golifx package.

The currently implemented protocol versions are:

V2

Index

• type V2
  • func (p *V2) Close() error
  • func (p *V2) CloseSubscription(sub *common.Subscription) error
  • func (p *V2) Discover() error
  • func (p *V2) NewSubscription() (*common.Subscription, error)
  • func (p *V2) SetClient(client common.Client)
  • func (p *V2) SetColor(color common.Color, duration time.Duration) error
  • func (p *V2) SetPower(state bool) error
  • func (p *V2) SetPowerDuration(state bool, duration time.Duration) error

Types

type V2

type V2 struct {
	// Port determines UDP port for this protocol instance
	Port int
	// Reliable enables reliable comms, requests ACKs for all operations to
	// ensure they're delivered (recommended)
	Reliable bool

	sync.RWMutex
	// contains filtered or unexported fields
}

V2 implements the LIFX LAN protocol version 2.

func (*V2) Close

func (p *V2) Close() error

Close closes the protocol driver, no further communication with the protocol is possible

func (*V2) CloseSubscription

func (p *V2) CloseSubscription(sub *common.Subscription) error

CloseSubscription is a callback for handling the closing of subscriptions.

func (*V2) Discover

func (p *V2) Discover() error

Discover initiates device discovery, this may be a noop in some future protocol versions. This is called immediately when the client connects to the protocol

func (*V2) NewSubscription

func (p *V2) NewSubscription() (*common.Subscription, error)

NewSubscription returns a new *common.Subscription for receiving events from this protocol.

func (*V2) SetClient

func (p *V2) SetClient(client common.Client)

SetClient sets the client on the protocol for bi-directional communication

func (*V2) SetColor

func (p *V2) SetColor(color common.Color, duration time.Duration) error

SetColor changes the color globally, on all lights, transitioning over the specified duration

func (*V2) SetPower

func (p *V2) SetPower(state bool) error

SetPower sets the power state globally, on all devices

func (*V2) SetPowerDuration

func (p *V2) SetPowerDuration(state bool, duration time.Duration) error

SetPowerDuration sets the power state globally, on all devices, transitioning over the specified duration