driverkit

type Adapter interface {
	Name() string
	// SupportedCommands 返回命令白名单（server 拒绝未知命令）。
	SupportedCommands() []string
	// Open 打开设备并启动接收循环；onEvent 回调设备事件（适配器保证并发安全调用）。
	Open(ctx context.Context, cfg Config, onEvent func(Event)) (Device, error)
}

type CapabilityProvider interface {
	Capabilities() []model.Capability
}

type Command struct {
	ID   int64
	Cmd  string
	Args string
}

type Config struct {
	ID    string
	Name  string
	Port  string
	Baud  int
	Extra map[string]string
}

type DescriptorProvider interface {
	Descriptor(cfg Config) model.Descriptor
}

type DescriptorSource interface {
	Descriptor() model.Descriptor
}

type Device interface {
	ID() string
	// Snapshot 返回当前状态（含在线判定），必须并发安全。
	Snapshot() State
	// Send 执行命令。适配器负责命令白名单校验。
	Send(ctx context.Context, c Command) error
	// Done 在连接致命错误（拔线/端口死）时关闭，供上层监督重启。
	Done() <-chan struct{}
	Close() error
}

type Event struct {
	Type     string
	EntityID string
	At       time.Time
}

type State struct {
	Online    bool
	Raw       map[string]any
	UpdatedAt time.Time
}