ams

Documentation

Overview

Package ams implements the AMS_AS5048 encoder

Index

• type AttrConfig
  • func (conf *AttrConfig) Validate(path string) ([]string, error)
• type Encoder
  • func (enc *Encoder) Close() error
  • func (enc *Encoder) GetPosition(ctx context.Context, positionType *encoder.PositionType, ...) (float64, encoder.PositionType, error)
  • func (enc *Encoder) GetProperties(ctx context.Context, extra map[string]interface{}) (map[encoder.Feature]bool, error)
  • func (enc *Encoder) ResetPosition(ctx context.Context, extra map[string]interface{}) error
• type I2CAttrConfig
  • func (cfg *I2CAttrConfig) ValidateI2C(path string) error

Types

type AttrConfig

type AttrConfig struct {
	BoardName string `json:"board"`
	// We include connection type here in anticipation for
	// future SPI support
	ConnectionType string `json:"connection_type"`
	*I2CAttrConfig `json:"i2c_attributes,omitempty"`
}

AttrConfig contains the connection information for configuring an AS5048 encoder.

func (*AttrConfig) Validate

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

Validate checks the attributes of an initialized config for proper values.

type Encoder

type Encoder struct {
	generic.Unimplemented
	// contains filtered or unexported fields
}

Encoder is a struct representing an instance of a hardware unit in AMS's AS5048 series of Hall-effect encoders.

func (*Encoder) Close

func (enc *Encoder) Close() error

Close stops the position loop of the encoder when the component is closed.

func (*Encoder) GetPosition

func (enc *Encoder) GetPosition(
	ctx context.Context, positionType *encoder.PositionType, extra map[string]interface{},
) (float64, encoder.PositionType, error)

GetPosition returns the total number of rotations detected by the encoder (rather than a number of pulse state transitions) because this encoder is absolute and not incremental. As a result a user MUST set ticks_per_rotation on the config of the corresponding motor to 1. Any other value will result in completely incorrect position measurements by the motor.

func (*Encoder) GetProperties

func (enc *Encoder) GetProperties(ctx context.Context, extra map[string]interface{}) (map[encoder.Feature]bool, error)

GetProperties returns a list of all the position types that are supported by a given encoder.

func (*Encoder) ResetPosition

func (enc *Encoder) ResetPosition(
	ctx context.Context, extra map[string]interface{},
) error

ResetPosition sets the current position measured by the encoder to be considered its new zero position.

type I2CAttrConfig

type I2CAttrConfig struct {
	I2CBus  string `json:"i2c_bus"`
	I2CAddr int    `json:"i2c_addr"`
}

I2CAttrConfig stores the configuration information for I2C connection.

func (*I2CAttrConfig) ValidateI2C

func (cfg *I2CAttrConfig) ValidateI2C(path string) error

ValidateI2C ensures all parts of the config are valid.