genericlinux

Documentation

Overview

Package genericlinux implements a Linux-based board making heavy use of sysfs (https://en.wikipedia.org/wiki/Sysfs). This does not provide a board model itself but provides the underlying logic for any Linux/sysfs based board.

Package genericlinux is for Linux boards, and this particular file is for digital interrupt pins using the ioctl interface, indirectly by way of mkch's gpio package.

Package genericlinux is for Linux boards, and this particular file is for GPIO pins using the ioctl interface, indirectly by way of mkch's gpio package.

Package genericlinux is for Linux boards. This particular file is for using sysfs to interact with PWM devices. All of these functions are idempotent: you can double-export a pin or double-close it with no problems.

Index

• func GetGPIOBoardMappingFromPinDefs(pinDefs []PinDefinition) (map[string]GPIOBoardMapping, error)
• func GetGPIOBoardMappings(modelName string, boardInfoMappings map[string]BoardInformation) (map[string]GPIOBoardMapping, error)
• func NewBoard(ctx context.Context, conf resource.Config, convertConfig ConfigConverter, ...) (board.Board, error)
• func RegisterBoard(modelName string, gpioMappings map[string]GPIOBoardMapping)
• type Board
  • func (b *Board) AnalogByName(name string) (board.Analog, error)
  • func (b *Board) AnalogNames() []string
  • func (b *Board) Close(ctx context.Context) error
  • func (b *Board) DigitalInterruptByName(name string) (board.DigitalInterrupt, error)
  • func (b *Board) DigitalInterruptNames() []string
  • func (b *Board) GPIOPinByName(pinName string) (board.GPIOPin, error)
  • func (b *Board) Reconfigure(ctx context.Context, _ resource.Dependencies, conf resource.Config) error
  • func (b *Board) SetPowerMode(ctx context.Context, mode pb.PowerMode, duration *time.Duration) error
  • func (b *Board) StreamTicks(ctx context.Context, interrupts []board.DigitalInterrupt, ch chan board.Tick, ...) error
  • func (b *Board) WriteAnalog(ctx context.Context, pin string, value int32, extra map[string]interface{}) error
• type BoardInformation
• type Config
  • func (conf *Config) Validate(path string) ([]string, error)
• type ConfigConverter
  • func ConstPinDefs(gpioMappings map[string]GPIOBoardMapping) ConfigConverter
• type GPIOBoardMapping
• type LinuxBoardConfig
• type NoBoardFoundError
  • func (err NoBoardFoundError) Error() string
• type PinDefinition
  • func (conf *PinDefinition) UnmarshalJSON(text []byte) error
  • func (conf *PinDefinition) Validate(path string) error
• type PinDefinitions

Functions

func GetGPIOBoardMappingFromPinDefs

func GetGPIOBoardMappingFromPinDefs(pinDefs []PinDefinition) (map[string]GPIOBoardMapping, error)

GetGPIOBoardMappingFromPinDefs attempts to find a compatible board-pin mapping using the pin definitions.

func GetGPIOBoardMappings

func GetGPIOBoardMappings(modelName string, boardInfoMappings map[string]BoardInformation) (map[string]GPIOBoardMapping, error)

GetGPIOBoardMappings attempts to find a compatible GPIOBoardMapping for the given board.

func NewBoard

func NewBoard(
	ctx context.Context,
	conf resource.Config,
	convertConfig ConfigConverter,
	logger logging.Logger,
) (board.Board, error)

NewBoard is the constructor for a Board.

func RegisterBoard

func RegisterBoard(modelName string, gpioMappings map[string]GPIOBoardMapping)

RegisterBoard registers a sysfs based board of the given model.

Types

type Board

type Board struct {
	resource.Named
	// contains filtered or unexported fields
}

Board implements a component for a Linux machine.

func (*Board) AnalogByName

func (b *Board) AnalogByName(name string) (board.Analog, error)

AnalogByName returns the analog pin by the given name if it exists.

func (*Board) AnalogNames

func (b *Board) AnalogNames() []string

AnalogNames returns the names of all known analog pins.

func (*Board) Close

func (b *Board) Close(ctx context.Context) error

Close attempts to cleanly close each part of the board.

func (*Board) DigitalInterruptByName

func (b *Board) DigitalInterruptByName(name string) (board.DigitalInterrupt, error)

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

func (*Board) DigitalInterruptNames

func (b *Board) DigitalInterruptNames() []string

DigitalInterruptNames returns the names of all known digital interrupts.

func (*Board) GPIOPinByName

func (b *Board) GPIOPinByName(pinName string) (board.GPIOPin, error)

GPIOPinByName returns a GPIOPin by name.

func (*Board) Reconfigure

func (b *Board) Reconfigure(
	ctx context.Context,
	_ resource.Dependencies,
	conf resource.Config,
) error

Reconfigure reconfigures the board with interrupt pins, spi and i2c, and analogs.

func (*Board) SetPowerMode

func (b *Board) 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 (*Board) StreamTicks

func (b *Board) StreamTicks(ctx context.Context, interrupts []board.DigitalInterrupt, ch chan board.Tick,
	extra map[string]interface{},
) error

StreamTicks starts a stream of digital interrupt ticks.

func (*Board) WriteAnalog

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

WriteAnalog writes the value to the given pin.

type BoardInformation

type BoardInformation struct {
	PinDefinitions []PinDefinition
	Compats        []string
}

BoardInformation details pin definitions and device compatibility for a particular board.

type Config

type Config struct {
	AnalogReaders     []mcp3008helper.MCP3008AnalogConfig `json:"analogs,omitempty"`
	DigitalInterrupts []board.DigitalInterruptConfig      `json:"digital_interrupts,omitempty"`
}

A Config describes the configuration of a board and all of its connected parts.

func (*Config) Validate

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

Validate ensures all parts of the config are valid.

type ConfigConverter

type ConfigConverter = func(resource.Config, logging.Logger) (*LinuxBoardConfig, error)

ConfigConverter is a type synonym for a function to turn whatever config we get during reconfiguration into a LinuxBoardConfig, so that we can reconfigure based on that. We return a pointer to a LinuxBoardConfig instead of the struct itself so that we can return nil if we encounter an error.

func ConstPinDefs

func ConstPinDefs(gpioMappings map[string]GPIOBoardMapping) ConfigConverter

ConstPinDefs takes in a map from pin names to GPIOBoardMapping structs, and returns a ConfigConverter that will use these pin definitions in the underlying config. It is intended to be used for board components whose pin definitions are built into the RDK, such as the BeagleBone or Jetson boards.

type GPIOBoardMapping

type GPIOBoardMapping struct {
	GPIOChipDev    string
	GPIO           int
	GPIOName       string
	PWMSysFsDir    string // Absolute path to the directory, empty string for none
	PWMID          int
	HWPWMSupported bool
}

GPIOBoardMapping represents a GPIO pin's location locally within a GPIO chip and globally within sysfs.

type LinuxBoardConfig

type LinuxBoardConfig struct {
	AnalogReaders     []mcp3008helper.MCP3008AnalogConfig
	DigitalInterrupts []board.DigitalInterruptConfig
	GpioMappings      map[string]GPIOBoardMapping
}

LinuxBoardConfig is a struct containing absolutely everything a genericlinux board might need configured. It is a union of the configs for the customlinux boards and the genericlinux boards with static pin definitions, because those components all use the same underlying code but have different config types (e.g., only customlinux can change its pin definitions during reconfiguration). The LinuxBoardConfig struct is a unification of the two of them. Whenever we go through reconfiguration, we convert the provided config into a LinuxBoardConfig, and then reconfigure based on it.

type NoBoardFoundError

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

A NoBoardFoundError is returned when no compatible mapping is found for a board during GPIO board mapping.

func (NoBoardFoundError) Error

func (err NoBoardFoundError) Error() string

type PinDefinition

type PinDefinition struct {
	Name            string `json:"name"`
	DeviceName      string `json:"device_name"` // name of the pin's chip's device, within /dev
	LineNumber      int    `json:"line_number"` // relative line number on chip
	PwmChipSysfsDir string `json:"pwm_chip_sysfs_dir,omitempty"`
	PwmID           int    `json:"pwm_id,omitempty"`
}

PinDefinition describes a gpio pin on a linux board.

func (*PinDefinition) UnmarshalJSON

func (conf *PinDefinition) UnmarshalJSON(text []byte) error

UnmarshalJSON handles setting defaults for pin configs. Int values default to -1.

func (*PinDefinition) Validate

func (conf *PinDefinition) Validate(path string) error

Validate ensures all parts of the config are valid.

type PinDefinitions

type PinDefinitions struct {
	Pins []PinDefinition `json:"pins"`
}

PinDefinitions describes a list of pins on a linux board.