Class WoStripLight3

Strip Light 3 Device Uses same logic as Color Bulb

Hierarchy (View Summary)

WoBulb
- WoStripLight3

Constructors

constructor

new WoStripLight3(
    info: DeviceInfo,
    options?: {
        apiClient?: OpenAPIClient;
        bleConnection?: BLEConnection;
        circuitBreakerConfig?: CircuitBreakerConfig;
        enableCircuitBreaker?: boolean;
        enableConnectionIntelligence?: boolean;
        enableFallback?: boolean;
        enableRetry?: boolean;
        logLevel?: number;
        preferredConnection?: ConnectionType;
        retryConfig?: RetryConfig;
    },
): WoStripLight3
Parameters
- info: DeviceInfo
- options: {
      apiClient?: OpenAPIClient;
      bleConnection?: BLEConnection;
      circuitBreakerConfig?: CircuitBreakerConfig;
      enableCircuitBreaker?: boolean;
      enableConnectionIntelligence?: boolean;
      enableFallback?: boolean;
      enableRetry?: boolean;
      logLevel?: number;
      preferredConnection?: ConnectionType;
      retryConfig?: RetryConfig;
  } = {}
Returns WoStripLight3
Inherited from WoBulb.constructor
- Defined in devices/base.ts:122

Properties

`Static`EFFECTS

EFFECTS: Record<string, number> = ...

Preset effect name to effect ID mapping

Accessors

activeConnection

get activeConnection(): ConnectionType | undefined
Get active connection type (property accessor for convenience)

Returns ConnectionType | undefined
Inherited from WoBulb.activeConnection
- Defined in devices/base.ts:305

deviceType

get deviceType(): string
Get device type (property accessor for convenience)

Returns string
Inherited from WoBulb.deviceType
- Defined in devices/base.ts:277

id

get id(): string | undefined
Get device ID (property accessor for convenience)

Returns string | undefined
Inherited from WoBulb.id
- Defined in devices/base.ts:249

mac

get mac(): string | undefined
Get MAC address (property accessor for convenience)

Returns string | undefined
Inherited from WoBulb.mac
- Defined in devices/base.ts:291

name

get name(): string
Get device name (property accessor for convenience)

Returns string
Inherited from WoBulb.name
- Defined in devices/base.ts:263

Methods

getActiveConnection

getActiveConnection(): ConnectionType | undefined
Get active connection type

Returns ConnectionType | undefined
Inherited from WoBulb.getActiveConnection
- Defined in devices/base.ts:298

getBasicInfo

getBasicInfo(): Promise<CommandResult>
Get basic device info (universal settings retrieval) Returns: battery, firmware, device-specific settings, etc. Command: 0x57 0x02 (BLE), 'getBasicInfo' (API)

Example usage: const info = await device.getBasicInfo(); console.log(info);

Returns a CommandResult object with device info fields.

Returns Promise<CommandResult>
Inherited from WoBulb.getBasicInfo
- Defined in devices/base.ts:778

getCircuitBreakerAPI

getCircuitBreakerAPI(): CircuitBreaker
Get circuit breaker for API

Returns CircuitBreaker
Inherited from WoBulb.getCircuitBreakerAPI
- Defined in devices/base.ts:881

getCircuitBreakerBLE

getCircuitBreakerBLE(): CircuitBreaker
Get circuit breaker for BLE

Returns CircuitBreaker
Inherited from WoBulb.getCircuitBreakerBLE
- Defined in devices/base.ts:874

getConnectionTracker

getConnectionTracker(): ConnectionTracker
Get connection tracker for this device

Returns ConnectionTracker
Inherited from WoBulb.getConnectionTracker
- Defined in devices/base.ts:867

getDeviceType

getDeviceType(): string
Get device type

Returns string
Inherited from WoBulb.getDeviceType
- Defined in devices/base.ts:270

getFallbackHandlerManager

getFallbackHandlerManager(): FallbackHandlerManager
Get fallback handler manager

Returns FallbackHandlerManager
Inherited from WoBulb.getFallbackHandlerManager
- Defined in devices/base.ts:905

getId

getId(): string
Get device ID

Returns string
Inherited from WoBulb.getId
- Defined in devices/base.ts:242

getInfo

getInfo(): DeviceInfo
Get device information

Returns DeviceInfo
Inherited from WoBulb.getInfo
- Defined in devices/base.ts:235

getMAC

getMAC(): string | undefined
Get MAC address (if available)

Returns string | undefined
Inherited from WoBulb.getMAC
- Defined in devices/base.ts:284

getName

getName(): string
Get device name

Returns string
Inherited from WoBulb.getName
- Defined in devices/base.ts:256

getStatus

getStatus(): Promise<BulbStatus>
Get device status (BLE-first/API-fallback, centralized)

Returns Promise<BulbStatus>
Inherited from WoBulb.getStatus
- Defined in devices/wo-bulb.ts:192

hasAPI

hasAPI(): boolean
Check if API is available for this device

Returns boolean
Inherited from WoBulb.hasAPI
- Defined in devices/base.ts:319

hasBLE

hasBLE(): boolean
Check if BLE is available for this device

Returns boolean
Inherited from WoBulb.hasBLE
- Defined in devices/base.ts:312

pollIfNeeded

pollIfNeeded(interval?: number): Promise<DeviceStatus | undefined>
Poll device status if needed (passive polling)
Parameters
- interval: number = PASSIVE_POLL_INTERVAL
Returns Promise<DeviceStatus | undefined>
Inherited from WoBulb.pollIfNeeded
- Defined in devices/base.ts:223

pollNeeded

pollNeeded(interval?: number): boolean
Returns true if device should be polled (passive polling interval elapsed)
Parameters
- interval: number = PASSIVE_POLL_INTERVAL
Returns boolean
Inherited from WoBulb.pollNeeded
- Defined in devices/base.ts:213

registerFallbackHandler

registerFallbackHandler(
handler: FallbackHandler,
options?: FallbackHandlerOptions,
): string
Register a custom fallback handler
Parameters
- handler: FallbackHandler
- Optionaloptions: FallbackHandlerOptions
Returns string
Inherited from WoBulb.registerFallbackHandler
- Defined in devices/base.ts:888

sendCommandSequence

sendCommandSequence(commands: (() => Promise<boolean>)[]): Promise<boolean>
Send multiple commands in sequence (all must succeed) Used for Strip Light 3 and complex light patterns
Parameters
- commands: (() => Promise<boolean>)[]
Returns Promise<boolean>
Inherited from WoBulb.sendCommandSequence
- Defined in devices/wo-bulb.ts:238

sendMultipleCommands

sendMultipleCommands(commands: (() => Promise<boolean>)[]): Promise<boolean>
Send multiple commands (returns true if any succeed) Used for fallback operations with complex light patterns
Parameters
- commands: (() => Promise<boolean>)[]
Returns Promise<boolean>
Inherited from WoBulb.sendMultipleCommands
- Defined in devices/wo-bulb.ts:260

setBrightness

setBrightness(brightness: number): Promise<boolean>
Set brightness (0-100)
Parameters
- brightness: number
Returns Promise<boolean>
Inherited from WoBulb.setBrightness
- Defined in devices/wo-bulb.ts:74

setCircuitBreakerEnabled

setCircuitBreakerEnabled(enabled: boolean): void
Enable or disable circuit breaker
Parameters
- enabled: boolean
Returns void
Inherited from WoBulb.setCircuitBreakerEnabled
- Defined in devices/base.ts:851

setColor

setColor(red: number, green: number, blue: number): Promise<boolean>
Set RGB color
Parameters
- red: number
- green: number
- blue: number
Returns Promise<boolean>
Inherited from WoBulb.setColor
- Defined in devices/wo-bulb.ts:139

setColorTemp

setColorTemp(minTemp: number, maxTemp: number, temp: number): Promise<boolean>
Set color temperature with min/max bounds For advanced bulbs that support color temperature range control
Parameters
- minTemp: number
- maxTemp: number
- temp: number
Returns Promise<boolean>
Inherited from WoBulb.setColorTemp
- Defined in devices/wo-bulb.ts:101

setColorTemperature

setColorTemperature(temperature: number): Promise<boolean>
Set color temperature (2700-6500K)
Parameters
- temperature: number
Returns Promise<boolean>
Inherited from WoBulb.setColorTemperature
- Defined in devices/wo-bulb.ts:86

setConnectionIntelligenceEnabled

setConnectionIntelligenceEnabled(enabled: boolean): void
Enable or disable connection intelligence
Parameters
- enabled: boolean
Returns void
Inherited from WoBulb.setConnectionIntelligenceEnabled
- Defined in devices/base.ts:843

setEffect

setEffect(effectName: string, speed?: number): Promise<boolean>
Set preset light effect
Parameters
- effectName: string
- speed: number = 100
Returns Promise<boolean>
Inherited from WoBulb.setEffect
- Defined in devices/wo-bulb.ts:176

setFallbackEnabled

setFallbackEnabled(enabled: boolean): void
Enable or disable fallback
Parameters
- enabled: boolean
Returns void
Inherited from WoBulb.setFallbackEnabled
- Defined in devices/base.ts:835

setMode

setMode(mode: string | number): Promise<CommandResult>
Universal mode setting command BLE: 0x57 0x03 [modeByte] API: 'setMode' (if available)
Parameters
- mode: string | number
  Mode value (number or string, per-device enum recommended)
  
  Example usage: await device.setMode('auto') await device.setMode(1)
  
  Returns a CommandResult object indicating success and mode info.
Returns Promise<CommandResult>
Inherited from WoBulb.setMode
- Defined in devices/base.ts:802

setPreferredConnection

setPreferredConnection(type: ConnectionType): void
Set preferred connection type
Parameters
- type: ConnectionType
Returns void
Inherited from WoBulb.setPreferredConnection
- Defined in devices/base.ts:827

setRetryEnabled

setRetryEnabled(enabled: boolean): void
Enable or disable retry logic
Parameters
- enabled: boolean
Returns void
Inherited from WoBulb.setRetryEnabled
- Defined in devices/base.ts:859

turnOff

turnOff(): Promise<boolean>
Turn off

Returns Promise<boolean>
Inherited from WoBulb.turnOff
- Defined in devices/wo-bulb.ts:65

turnOn

turnOn(): Promise<boolean>
Turn on

Returns Promise<boolean>
Inherited from WoBulb.turnOn
- Defined in devices/wo-bulb.ts:56

unregisterFallbackHandler

unregisterFallbackHandler(id: string): boolean
Unregister a fallback handler
Parameters
- id: string
Returns boolean
Inherited from WoBulb.unregisterFallbackHandler
- Defined in devices/base.ts:898

updateInfo

updateInfo(newInfo: Partial<DeviceInfo>): void
Update device information
Parameters
- newInfo: Partial<DeviceInfo>
Returns void
Inherited from WoBulb.updateInfo
- Defined in devices/base.ts:819

verifyEncryptionKey

verifyEncryptionKey(): Promise<boolean>
Verifies the BLE encryption key by attempting a status read with encryption. Throws an error if the key is invalid or the device rejects the command.

Returns Promise<boolean>
Inherited from WoBulb.verifyEncryptionKey
- Defined in devices/wo-bulb.ts:36

Class WoStripLight3

Hierarchy (View Summary)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns WoStripLight3

Properties

StaticEFFECTS

Accessors

activeConnection

Returns ConnectionType | undefined

deviceType

Returns string

id

Returns string | undefined

mac

Returns string | undefined

name

Returns string

Methods

getActiveConnection

Returns ConnectionType | undefined

getBasicInfo

Returns Promise<CommandResult>

getCircuitBreakerAPI

Returns CircuitBreaker

getCircuitBreakerBLE

Returns CircuitBreaker

getConnectionTracker

Returns ConnectionTracker

getDeviceType

Returns string

getFallbackHandlerManager

Returns FallbackHandlerManager

getId

Returns string

getInfo

Returns DeviceInfo

getMAC

Returns string | undefined

getName

Returns string

getStatus

Returns Promise<BulbStatus>

hasAPI

Returns boolean

hasBLE

Returns boolean

pollIfNeeded

Parameters

Returns Promise<DeviceStatus | undefined>

pollNeeded

Parameters

Returns boolean

registerFallbackHandler

Parameters

Returns string

sendCommandSequence

Parameters

Returns Promise<boolean>

sendMultipleCommands

Parameters

Returns Promise<boolean>

setBrightness

Parameters

Returns Promise<boolean>

setCircuitBreakerEnabled

Parameters

Returns void

setColor

Parameters

Returns Promise<boolean>

setColorTemp

Parameters

Returns Promise<boolean>

`Static`EFFECTS