pca9685

Documentation

Overview

Package pca9685 implements a PCA9685 HAT. It's probably also a generic PCA9685 but that has not been verified yet.

Package pca9685 is unimplemented for Macs.

Index

• type Config
  • func (conf *Config) Validate(path string) ([]string, error)
• type PCA9685
  • func New(ctx context.Context, deps resource.Dependencies, conf resource.Config, ...) (*PCA9685, error)
  • func (pca *PCA9685) AnalogReaderByName(name string) (board.AnalogReader, bool)
  • func (pca *PCA9685) AnalogReaderNames() []string
  • func (pca *PCA9685) DigitalInterruptByName(name string) (board.DigitalInterrupt, bool)
  • func (pca *PCA9685) DigitalInterruptNames() []string
  • func (pca *PCA9685) GPIOPinByName(pin string) (board.GPIOPin, error)
  • func (pca *PCA9685) GPIOPinNames() []string
  • func (pca *PCA9685) I2CByName(name string) (board.I2C, bool)
  • func (pca *PCA9685) I2CNames() []string
  • func (pca *PCA9685) ModelAttributes() board.ModelAttributes
  • func (pca *PCA9685) Reconfigure(ctx context.Context, deps resource.Dependencies, conf resource.Config) error
  • func (pca *PCA9685) SPIByName(name string) (board.SPI, bool)
  • func (pca *PCA9685) SPINames() []string
  • func (pca *PCA9685) SetFrequency(ctx context.Context, frequency float64) error
  • func (pca *PCA9685) SetPowerMode(ctx context.Context, mode pb.PowerMode, duration *time.Duration) error
  • func (pca *PCA9685) Status(ctx context.Context, extra map[string]interface{}) (*commonpb.BoardStatus, error)
  • func (pca *PCA9685) WriteAnalog(ctx context.Context, pin string, value int32, extra map[string]interface{}) error

Types

type Config

type Config struct {
	BoardName  string `json:"board_name,omitempty"`
	I2CName    string `json:"i2c_name,omitempty"`
	I2CBus     string `json:"i2c_bus,omitempty"`
	I2CAddress *int   `json:"i2c_address,omitempty"`
}

Config describes a PCA9685 board attached to some other board via I2C.

func (*Config) Validate

func (conf *Config) Validate(path string) ([]string, error)

Validate ensures all parts of the config are valid.

type PCA9685

type PCA9685 struct {
	resource.Named
	resource.AlwaysRebuild
	resource.TriviallyCloseable
	// contains filtered or unexported fields
}

PCA9685 is a general purpose 16-channel 12-bit PWM controller.

func New

func New(ctx context.Context, deps resource.Dependencies, conf resource.Config, logger logging.Logger) (*PCA9685, error)

New returns a new PCA9685 residing on the given bus and address.

func (*PCA9685) AnalogReaderByName

func (pca *PCA9685) AnalogReaderByName(name string) (board.AnalogReader, bool)

AnalogReaderByName returns the analog reader by the given name if it exists.

func (*PCA9685) AnalogReaderNames

func (pca *PCA9685) AnalogReaderNames() []string

AnalogReaderNames returns the names of all known analog readers.

func (*PCA9685) DigitalInterruptByName

func (pca *PCA9685) DigitalInterruptByName(name string) (board.DigitalInterrupt, bool)

DigitalInterruptByName returns the interrupt by the given name if it exists.

func (*PCA9685) DigitalInterruptNames

func (pca *PCA9685) DigitalInterruptNames() []string

DigitalInterruptNames returns the names of all known digital interrupts.

func (*PCA9685) GPIOPinByName

func (pca *PCA9685) GPIOPinByName(pin string) (board.GPIOPin, error)

GPIOPinByName returns a GPIOPin by name.

func (*PCA9685) GPIOPinNames

func (pca *PCA9685) GPIOPinNames() []string

GPIOPinNames returns the names of all known GPIO pins.

func (*PCA9685) I2CByName

func (pca *PCA9685) I2CByName(name string) (board.I2C, bool)

I2CByName returns the i2c by the given name if it exists.

func (*PCA9685) I2CNames

func (pca *PCA9685) I2CNames() []string

I2CNames returns the names of all known I2Cs.

func (*PCA9685) ModelAttributes

func (pca *PCA9685) ModelAttributes() board.ModelAttributes

ModelAttributes returns attributes related to the model of this board.

func (*PCA9685) Reconfigure

func (pca *PCA9685) Reconfigure(ctx context.Context, deps resource.Dependencies, conf resource.Config) error

Reconfigure reconfigures the board atomically and in place.

func (*PCA9685) SPIByName

func (pca *PCA9685) SPIByName(name string) (board.SPI, bool)

SPIByName returns the SPI by the given name if it exists.

func (*PCA9685) SPINames

func (pca *PCA9685) SPINames() []string

SPINames returns the names of all known SPIs.

func (*PCA9685) SetFrequency

func (pca *PCA9685) SetFrequency(ctx context.Context, frequency float64) error

SetFrequency sets the global PWM frequency for the pca.

func (*PCA9685) SetPowerMode

func (pca *PCA9685) SetPowerMode(ctx context.Context, mode pb.PowerMode, duration *time.Duration) error

SetPowerMode sets the board to the given power mode. If provided, the board will exit the given power mode after the specified duration.

func (*PCA9685) Status

func (pca *PCA9685) Status(ctx context.Context, extra map[string]interface{}) (*commonpb.BoardStatus, error)

Status returns the board status which is always empty.

func (*PCA9685) WriteAnalog

func (pca *PCA9685) WriteAnalog(ctx context.Context, pin string, value int32, extra map[string]interface{}) error

WriteAnalog writes the value to the given pin.