ezopmp

Documentation

Overview

Package ezopmp is a motor driver for the hydrogarden pump

Index

• func NewMotor(ctx context.Context, deps registry.Dependencies, c *AttrConfig, name string, ...) (motor.LocalMotor, error)
• type AttrConfig
  • func (config *AttrConfig) Validate(path string) ([]string, error)
• type Ezopmp
  • func (m *Ezopmp) GoFor(ctx context.Context, mLPerMin, mins float64, extra map[string]interface{}) error
  • func (m *Ezopmp) GoTillStop(ctx context.Context, rpm float64, stopFunc func(ctx context.Context) bool) error
  • func (m *Ezopmp) GoTo(ctx context.Context, mLPerMin, mins float64, extra map[string]interface{}) error
  • func (m *Ezopmp) IsMoving(ctx context.Context) (bool, error)
  • func (m *Ezopmp) IsPowered(ctx context.Context, extra map[string]interface{}) (bool, float64, error)
  • func (m *Ezopmp) Position(ctx context.Context, extra map[string]interface{}) (float64, error)
  • func (m *Ezopmp) Properties(ctx context.Context, extra map[string]interface{}) (map[motor.Feature]bool, error)
  • func (m *Ezopmp) ResetZeroPosition(ctx context.Context, offset float64, extra map[string]interface{}) error
  • func (m *Ezopmp) SetPower(ctx context.Context, powerPct float64, extra map[string]interface{}) error
  • func (m *Ezopmp) Stop(ctx context.Context, extra map[string]interface{}) error
  • func (m *Ezopmp) Validate() error

Functions

func NewMotor

func NewMotor(ctx context.Context, deps registry.Dependencies, c *AttrConfig, name string,
	logger golog.Logger,
) (motor.LocalMotor, error)

NewMotor returns a motor(Ezopmp) with I2C protocol.

Types

type AttrConfig

type AttrConfig struct {
	BoardName   string `json:"board"`
	BusName     string `json:"i2c_bus"`
	I2CAddress  *byte  `json:"i2c_addr"`
	MaxReadBits *int   `json:"max_read_bits"`
}

AttrConfig is user config inputs for ezopmp.

func (*AttrConfig) Validate

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

Validate ensures all parts of the config are valid.

type Ezopmp

type Ezopmp struct {
	I2CAddress byte

	generic.Unimplemented
	// contains filtered or unexported fields
}

Ezopmp represents a motor connected via the I2C protocol.

func (*Ezopmp) GoFor

func (m *Ezopmp) GoFor(ctx context.Context, mLPerMin, mins float64, extra map[string]interface{}) error

GoFor sets a constant flow rate mLPerMin = rpm, mins = revolutions.

func (*Ezopmp) GoTillStop

func (m *Ezopmp) GoTillStop(ctx context.Context, rpm float64, stopFunc func(ctx context.Context) bool) error

GoTillStop is unimplemented.

func (*Ezopmp) GoTo

func (m *Ezopmp) GoTo(ctx context.Context, mLPerMin, mins float64, extra map[string]interface{}) error

GoTo uses the Dose Over Time Command in the EZO-PMP datasheet mLPerMin = rpm, mins = revolutions.

func (*Ezopmp) IsMoving

func (m *Ezopmp) IsMoving(ctx context.Context) (bool, error)

IsMoving returns whether or not the motor is currently moving.

func (*Ezopmp) IsPowered

func (m *Ezopmp) IsPowered(ctx context.Context, extra map[string]interface{}) (bool, float64, error)

IsPowered returns whether or not the motor is currently on, and how much power it's getting.

func (*Ezopmp) Position

func (m *Ezopmp) Position(ctx context.Context, extra map[string]interface{}) (float64, error)

Position will return the total volume dispensed.

func (*Ezopmp) Properties

func (m *Ezopmp) Properties(ctx context.Context, extra map[string]interface{}) (map[motor.Feature]bool, error)

Properties returns the status of optional features on the motor.

func (*Ezopmp) ResetZeroPosition

func (m *Ezopmp) ResetZeroPosition(ctx context.Context, offset float64, extra map[string]interface{}) error

ResetZeroPosition clears the amount of volume that has been dispensed.

func (*Ezopmp) SetPower

func (m *Ezopmp) SetPower(ctx context.Context, powerPct float64, extra map[string]interface{}) error

SetPower sets the percentage of power the motor should employ between -1 and 1. Negative power implies a backward directional rotational for this pump, it goes between 0.5ml to 105ml/min.

func (*Ezopmp) Stop

func (m *Ezopmp) Stop(ctx context.Context, extra map[string]interface{}) error

Stop turns the power to the motor off immediately, without any gradual step down.

func (*Ezopmp) Validate

func (m *Ezopmp) Validate() error

Validate if this config is valid.