Class WoRGBICWWFloorLamp

StaticEFFECTS

activeConnection

• get activeConnection(): ConnectionType | undefined

  Get active connection type (property accessor for convenience)

  Returns ConnectionType | undefined

deviceType

• get deviceType(): string

  Get device type (property accessor for convenience)

  Returns string

id

• get id(): string | undefined

  Get device ID (property accessor for convenience)

  Returns string | undefined

mac

• get mac(): string | undefined

  Get MAC address (property accessor for convenience)

  Returns string | undefined

name

• get name(): string

  Get device name (property accessor for convenience)

  Returns string

getActiveConnection

• getActiveConnection(): ConnectionType | undefined

  Get active connection type

  Returns ConnectionType | undefined

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>

getCircuitBreakerAPI

• getCircuitBreakerAPI(): CircuitBreaker

  Get circuit breaker for API

  Returns CircuitBreaker

getCircuitBreakerBLE

• getCircuitBreakerBLE(): CircuitBreaker

  Get circuit breaker for BLE

  Returns CircuitBreaker

getConnectionTracker

• getConnectionTracker(): ConnectionTracker

  Get connection tracker for this device

  Returns ConnectionTracker

getDeviceType

• getDeviceType(): string

  Get device type

  Returns string

getFallbackHandlerManager

• getFallbackHandlerManager(): FallbackHandlerManager

  Get fallback handler manager

  Returns FallbackHandlerManager

getId

• getId(): string

  Get device ID

  Returns string

getInfo

• getInfo(): DeviceInfo

  Get device information

  Returns DeviceInfo

getMAC

• getMAC(): string | undefined

  Get MAC address (if available)

  Returns string | undefined

getName

• getName(): string

  Get device name

  Returns string

getStatus

• getStatus(): Promise<RGBICBulbStatus>

  Get device status (inherited from WoBulb, centralized fallback)

  Returns Promise<RGBICBulbStatus>

hasAPI

• hasAPI(): boolean

  Check if API is available for this device

  Returns boolean

hasBLE

• hasBLE(): boolean

  Check if BLE is available for this device

  Returns boolean

pollIfNeeded

• pollIfNeeded(interval?: number): Promise<DeviceStatus | undefined>

  Poll device status if needed (passive polling)

  Parameters

  • interval: number = PASSIVE_POLL_INTERVAL

  Returns Promise<DeviceStatus | undefined>

pollNeeded

• pollNeeded(interval?: number): boolean

  Returns true if device should be polled (passive polling interval elapsed)

  Parameters

  • interval: number = PASSIVE_POLL_INTERVAL

  Returns boolean

registerFallbackHandler

• registerFallbackHandler(
      handler: FallbackHandler,
      options?: FallbackHandlerOptions,
  ): string

  Register a custom fallback handler

  Parameters

  • handler: FallbackHandler
  • Optionaloptions: FallbackHandlerOptions

  Returns string

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>

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>

setBrightness

• setBrightness(brightness: number): Promise<boolean>

  Set brightness (0-100)

  Parameters

  • brightness: number

  Returns Promise<boolean>

setCircuitBreakerEnabled

• setCircuitBreakerEnabled(enabled: boolean): void

  Enable or disable circuit breaker

  Parameters

  • enabled: boolean

  Returns void

setColor

• setColor(red: number, green: number, blue: number): Promise<boolean>

  Set RGB color

  Parameters

  • red: number
  • green: number
  • blue: number

  Returns Promise<boolean>

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>

setColorTemperature

• setColorTemperature(temperature: number): Promise<boolean>

  Set color temperature (2700-6500K)

  Parameters

  • temperature: number

  Returns Promise<boolean>

setConnectionIntelligenceEnabled

• setConnectionIntelligenceEnabled(enabled: boolean): void

  Enable or disable connection intelligence

  Parameters

  • enabled: boolean

  Returns void

setEffect

• setEffect(effectName: string, speed?: number): Promise<boolean>

  Set preset light effect

  Parameters

  • effectName: string
  • speed: number = 100

  Returns Promise<boolean>

setFallbackEnabled

• setFallbackEnabled(enabled: boolean): void

  Enable or disable fallback

  Parameters

  • enabled: boolean

  Returns void

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>

setPreferredConnection

• setPreferredConnection(type: ConnectionType): void

  Set preferred connection type

  Parameters

  • type: ConnectionType

  Returns void

setRetryEnabled

• setRetryEnabled(enabled: boolean): void

  Enable or disable retry logic

  Parameters

  • enabled: boolean

  Returns void

setSegmentColor

• setSegmentColor(
      segmentId: number,
      red: number,
      green: number,
      blue: number,
  ): Promise<boolean>

  Set color for individual LED segment

  Parameters

  • segmentId: number

    Segment identifier (0-based index)

  • red: number

    Red value (0-255)

  • green: number

    Green value (0-255)

  • blue: number

    Blue value (0-255)

  Returns Promise<boolean>

setSegmentEffect

• setSegmentEffect(
      segmentId: number,
      effectName: string,
      speed?: number,
  ): Promise<boolean>

  Set effect for individual LED segment

  Parameters

  • segmentId: number

    Segment identifier (0-based index)

  • effectName: string

    Effect name from RGBIC_EFFECTS

  • speed: number = 50

    Effect speed (1-100, default: 50)

  Returns Promise<boolean>

turnOff

• turnOff(): Promise<boolean>

  Turn off

  Returns Promise<boolean>

turnOn

• turnOn(): Promise<boolean>

  Turn on

  Returns Promise<boolean>

unregisterFallbackHandler

• unregisterFallbackHandler(id: string): boolean

  Unregister a fallback handler

  Parameters

  • id: string

  Returns boolean

updateInfo

• updateInfo(newInfo: Partial<DeviceInfo>): void

  Update device information

  Parameters

  • newInfo: Partial<DeviceInfo>

  Returns void

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>