hal

type BLEConnection interface {
	WriteCharacteristic(uuid string, data []byte) error
	ReadCharacteristic(uuid string) ([]byte, error)
	Subscribe(uuid string) (<-chan []byte, error)
	Unsubscribe(uuid string) error
	Disconnected() <-chan struct{}
	io.Closer
}

type BLEDevice struct {
	Address      string
	Name         string
	ServiceUUIDs []string
	RSSI         int
}

type CameraDevice struct {
	ID     string
	Name   string
	Facing string
}

type GATTService struct {
	UUID                string
	CharacteristicUUIDs []string
}

type Platform struct {
	// Serial discovery. Callback receives JSON-encoded []SerialPort snapshots.
	// Returns a stop function.
	SerialWatch func(cb func(ports []SerialPort)) (stop func())

	// Serial I/O. Handle-based: Open returns a handle, Read/Write/Close use it.
	SerialOpen func(path string, baudRate int) (handle int64, err error)
	// SerialRead returns up to maxLen bytes. Some platforms (Android) may
	// return more than maxLen; the caller (serialHandle) buffers the excess.
	SerialRead  func(handle int64, maxLen int) ([]byte, error)
	SerialWrite func(handle int64, data []byte) (int, error)
	SerialClose func(handle int64) error

	// BLE discovery. Callback receives periodic snapshots of visible devices.
	BLEWatch func(serviceUUIDs []string, cb func(devices []BLEDevice)) (stop func())

	// BLE connection. Handle-based.
	BLEConnect     func(address string) (handle int64, err error)
	BLEDisconnect  func(handle int64) error
	BLERead        func(handle int64, charUUID string) ([]byte, error)
	BLEWrite       func(handle int64, charUUID string, data []byte) error
	BLESubscribe   func(handle int64, charUUID string, cb func(data []byte)) error
	BLEUnsubscribe func(handle int64, charUUID string) error

	// BLE service discovery (called after Connect, returns discovered services).
	BLEServices func(handle int64) ([]GATTService, error)

	// BLE disconnect notification. Registers a callback that fires when
	// a connected peripheral disconnects unexpectedly (remote-initiated).
	BLEOnDisconnect func(handle int64, cb func())

	// ReadSensors returns a snapshot of all available no-permission sensors.
	ReadSensors func() []SensorReading
}

type SensorReading struct {
	ID    uint32
	Label string
	Kind  int32
	Unit  int32
	Value float64
}

type SerialPort struct {
	// Key is the platform-provided stable identifier for this device.
	// When set, it is used as the entity key instead of deriving one
	// from VendorID/SerialNumber/Name. The platform should set this
	// to whatever identifier remains constant across permission
	// changes and USB re-enumeration.
	Key              string
	Path             string
	StablePath       string
	Name             string
	VendorID         uint32
	ProductID        uint32
	SerialNumber     string
	ManufacturerName string
	ProductName      string
}

type StreamAdapter struct {
	// contains filtered or unexported fields
}