da

type BasicCapability interface {
	Capability() Capability
	Name() string
}

type Capability uint16

type CapabilityAdded struct {
	// Device with new capability.
	Device Device
	// Capability being added.
	Capability Capability
}

type CapabilityRemoved struct {
	// Device with new capability.
	Device Device
	// Capability being added.
	Capability Capability
}

type Device interface {
	// Gateway returns the parent gateway.
	Gateway() Gateway
	// Identifier returns a unique identifier for this device.
	Identifier() Identifier
	// Capabilities returns a slice of capabilities this Device supports.
	Capabilities() []Capability
	// Capability returns the concrete implementation of the capability.
	Capability(Capability) BasicCapability
}

type DeviceAdded struct {
	// Device added.
	Device Device
}

type DeviceRemoved struct {
	// Device removed.
	Device Device
}

type Gateway interface {
	// ReadEvent from the gateway about devices, this must always be serviced. context.DeadlineExceeded will be
	// returned if the context expires during a read. Use this mechanism if you can not indefinitely wait for an event.
	ReadEvent(context.Context) (interface{}, error)

	// Capabilities returns a list of all Capabilities that the gateway can support.
	Capabilities() []Capability

	// Self fetches a device which represents the gateway, this allows a gateway to have optional capabilities.
	Self() Device

	// Devices fetch a list of all devices on the gateway, including its self.
	Devices() []Device

	// Start the gateway, including any background routines required. The context is only for the process of starting
	// a gateway.
	Start(context.Context) error

	// Stop the gateway, including any background routines required. Gateways are not required to be reusable,
	// and a new gateway should be created if a restart is required. The context is only for the process of stopping
	// a gateway.
	Stop(context.Context) error
}

type Identifier interface {
	// String from identifier.
	String() string
}