dmxconnect/hardware/interfaces.go

package hardware

import "context"

// Peripheral represents the methods used to manage a peripheral (input or output hardware)
type Peripheral interface {
	Connect(context.Context) error                         // Connect the peripheral
	SetEventCallback(func(any))                            // Callback is called when an event is emitted from the peripheral
	Disconnect(context.Context) error                      // Disconnect the peripheral
	Activate(context.Context) error                        // Activate the peripheral
	Deactivate(context.Context) error                      // Deactivate the peripheral
	SetSettings(context.Context, map[string]any) error     // Set a peripheral setting
	SetDeviceProperty(context.Context, uint32, byte) error // Update a device property
	WaitStop() error                                       // Properly close the peripheral

	GetInfo() PeripheralInfo     // Get the peripheral information
	GetSettings() map[string]any // Get the peripheral settings
}

// PeripheralInfo represents a peripheral information
type PeripheralInfo struct {
	Name         string         `yaml:"name"`     // Name of the peripheral
	SerialNumber string         `yaml:"sn"`       // S/N of the peripheral
	ProtocolName string         `yaml:"protocol"` // Protocol name of the peripheral
	Settings     map[string]any `yaml:"settings"` // Peripheral settings
}

// PeripheralFinder represents how compatible peripheral drivers are implemented
type PeripheralFinder interface {
	Initialize() error                                                   // Initializes the protocol
	OnArrival(cb func(p PeripheralInfo))                                 // Callback function when a peripheral arrives
	OnRemoval(cb func(p PeripheralInfo))                                 // Callback function when a peripheral goes away
	Start(context.Context) error                                         // Start the detection
	WaitStop() error                                                     // Waiting for finder to close
	ForceScan()                                                          // Explicitly scans for peripherals
	RegisterPeripheral(context.Context, PeripheralInfo) (string, error)  // Registers a new peripheral data
	UnregisterPeripheral(context.Context, PeripheralInfo) error          // Unregisters an existing peripheral
	GetPeripheralSettings(string) (map[string]any, error)                // Gets the peripheral settings
	SetPeripheralSettings(context.Context, string, map[string]any) error // Sets the peripheral settings
	GetName() string                                                     // Get the name of the finder
}