plugging

Documentation

Overview

Package plugging conceptualises the act of plugging devices into the VCS ports. This includes the panel in addition to the various peripherals that plug into the player ports (ie. controllers, savekey, etc.)

Index

• type Monitorable
• type PlugMonitor
• type PortID

Types

type Monitorable

type Monitorable interface {
	AttachPlugMonitor(m PlugMonitor)
}

Moniterable implementations are capable of having a PlugMonitor attached to it. The VCS Ports themselves are monitorable but we also use this mechanism in the "auto" controller type and in the future, devices like the Quadtari will be implemented similarly.

It is expected that such implementations will call PlugMonitor.Plugged() as required. Note that PlugMonitor.Plugged() should not be called on the event of AttachPlugMonitor except in the special case of the ports.Ports type

Implementations of Monitorable should also test peripherals that are daisy-chained and call AttachPlusMonitor() as appropriate.

if a, ok := periph.daisychain.(pluggin.Monitorable); ok {
	a.AttachPlugMonitor(m)
}

type PlugMonitor

type PlugMonitor interface {
	Plugged(port PortID, description string)
}

PlugMonitor interface implementations will be notified of newly plugged peripherals.

type PortID

type PortID string

PortID differentiates the different ports in the VCS into which peripherals can be plugged.

const (
	Unplugged   PortID = "Unplugged"
	LeftPlayer  PortID = "Left"
	RightPlayer PortID = "Right"
	Panel       PortID = "Panel"
)

List of defined PortIDs.

We could potentially extend this to support a future Quadtari implementation.