plugin

type Attribute struct {
	server.Attribute
	CanControl bool `json:"can_control"`
}

type Client interface {
	DevicesDiscover(ctx context.Context) <-chan DiscoverResponse
	GetAttributes(device entity.Device) (DeviceInstances, error)
	SetAttributes(device entity.Device, data json.RawMessage) (result []byte, err error)
	IsOnline(entity.Device) bool

	OTA(d entity.Device, firmwareURL string) error

	// Connect 连接设备
	Connect(identity, pluginID string, authParams map[string]string) (DeviceInstances, error)
	// Disconnect 与设备断开连接
	Disconnect(identity, pluginID string, authParams map[string]string) error

	// DeviceConfig 设备的配置
	DeviceConfig(entity.Device) DeviceConfig
	// DeviceConfigs 所有设备的配置
	DeviceConfigs() []DeviceConfig
}

type Config struct {
	Name           string         `yaml:"name" json:"name" validate:"required"`                       // 插件名称
	Version        string         `yaml:"version" json:"version" validate:"required"`                 // 版本
	Info           string         `yaml:"info" json:"info"`                                           // 介绍
	SupportDevices []DeviceConfig `yaml:"support_devices" json:"support_devices" validate:"required"` // 支持的设备
}

type DeviceConfig struct {
	Model string     `json:"model" yaml:"model"`
	Name  string     `json:"name" yaml:"name"`
	Type  DeviceType `json:"type" yaml:"type"` // 设备类型

	Logo         string `json:"logo" yaml:"logo"`                 // 设备logo相对路径
	Control      string `json:"control" yaml:"control"`           // 设备控制页面相对路径
	Provisioning string `json:"provisioning" yaml:"provisioning"` // 设备置网页面相对路径
	PluginID     string `json:"-"`
}

type DeviceInfo struct {
	Identity     string
	Model        string
	Manufacturer string
	Version      string
}

type DeviceInstances struct {
	Identity  string     `json:"identity"`
	Instances []Instance `json:"instances"`

	// OTASupport 是否支持OTA
	OTASupport bool `json:"ota_support"`
}

type DeviceType string

type DiscoverResponse struct {
	Name         string `json:"name"`
	Identity     string `json:"identity"`
	Model        string `json:"model"`
	Manufacturer string `json:"manufacturer"`
	PluginID     string `json:"plugin_id"`
	LogoURL      string `json:"logo_url"`
	AuthRequired bool   `json:"auth_required"`
}

type Info struct {
	Logo         string `json:"logo" yaml:"control"`              // 设备logo地址相对路径
	Control      string `json:"control" yaml:"control"`           // 设备控制页面相对路径
	Provisioning string `json:"provisioning" yaml:"provisioning"` // 设备置网页面相对路径
	Compress     string `json:"compress" yaml:"compress"`         // 压缩包地址
}

type Instance struct {
	Type       string      `json:"type"`
	InstanceId int         `json:"instance_id"`
	Attributes []Attribute `json:"attributes"`
}

type Manager interface {
	// LoadPlugins 加载并返回所有插件
	LoadPlugins() (map[string]*Plugin, error)
	// GetPlugin 加载并返回插件
	GetPlugin(id string) (*Plugin, error)
}

type OnDeviceStateChange func(d entity.Device, attr entity.Attribute) error

type Plugin struct {
	Config `yaml:",inline"`
	ID     string `json:"id" yaml:"id"`
	Brand  string `json:"brand" yaml:"brand"`
	Image  string `json:"image" yaml:"image"`
	Source string `json:"source" yaml:"source"` // 插件来源
	AreaID uint64 `json:"area_id" yaml:"area_id"`
}