Class WoSmartLock

Class representing a WoSmartLock device.

See

https://github.com/OpenWonderLabs/SwitchBotAPI-BLE/blob/latest/devicetypes/lock.md

Hierarchy (View Summary)

Constructors

constructor

Properties

encryption_key iv key_id Result

Accessors

address connectionState friendlyName id model modelName onConnectHandler onDisconnectHandler

Methods

command connect decrypt disconnect discoverServices encrypt encryptedCommand getCharacteristics getDeviceName getIv info internalConnect lock log operateLock setDeviceName setKey unlock unlockNoUnlatch unsubscribeFromNotify getLockStatus parseServiceData validateResponse

Constructors

constructor

Properties

encryption_key

encryption_key: null | Buffer<ArrayBufferLike> = null

iv

iv: null | Buffer<ArrayBufferLike> = null

key_id

key_id: string = ''

StaticResult

Result: { ERROR: number; SUCCESS: number; SUCCESS_LOW_BATTERY: number } = ...

Accessors

address

  • get address(): string

    Returns string

connectionState

  • get connectionState(): string

    Returns string

friendlyName

id

  • get id(): string

    Returns string

model

modelName

onConnectHandler

  • get onConnectHandler(): () => Promise<void>

    Returns () => Promise<void>

  • set onConnectHandler(func: () => Promise<void>): void

    Parameters

    • func: () => Promise<void>

    Returns void

onDisconnectHandler

  • get onDisconnectHandler(): () => Promise<void>

    Returns () => Promise<void>

  • set onDisconnectHandler(func: () => Promise<void>): void

    Parameters

    • func: () => Promise<void>

    Returns void

Methods

command

  • command(reqBuf: Buffer): Promise<Buffer<ArrayBufferLike>>

    Sends a command to the device and awaits a response.

    Parameters

    • reqBuf: Buffer

      The command buffer.

    Returns Promise<Buffer<ArrayBufferLike>>

    A Promise that resolves with the response buffer.

connect

  • connect(): Promise<void>

    Connects to the device.

    Returns Promise<void>

    A Promise that resolves when the connection is complete.

decrypt

  • decrypt(data: Buffer): Promise<Buffer<ArrayBufferLike>>

    Decrypts a buffer using AES-128-CTR.

    Parameters

    • data: Buffer

      The data to decrypt.

    Returns Promise<Buffer<ArrayBufferLike>>

    • The decrypted data.

disconnect

  • disconnect(): Promise<void>

    Disconnects from the device.

    Returns Promise<void>

    A Promise that resolves when the disconnection is complete.

discoverServices

encrypt

  • encrypt(str: string): Promise<string>

    Encrypts a string using AES-128-CTR.

    Parameters

    • str: string

      The string to encrypt.

    Returns Promise<string>

    • The encrypted string in hex format.

encryptedCommand

  • encryptedCommand(key: string): Promise<Buffer<ArrayBufferLike>>

    Sends an encrypted command to the device.

    Parameters

    • key: string

      The command key.

    Returns Promise<Buffer<ArrayBufferLike>>

    • The response buffer.

getCharacteristics

getDeviceName

getIv

  • getIv(): Promise<Buffer<ArrayBufferLike>>

    Retrieves the IV from the device.

    Returns Promise<Buffer<ArrayBufferLike>>

    • The IV buffer.

info

  • info(): Promise<null | object>

    Gets general state info from the Smart Lock.

    Returns Promise<null | object>

    • The state object or null if an error occurred.

internalConnect

  • internalConnect(): Promise<void>

    Internal method to handle the connection process.

    Returns Promise<void>

    A Promise that resolves when the connection is complete.

lock

  • lock(): Promise<number>

    Locks the Smart Lock.

    Returns Promise<number>

    • The result of the lock operation.

log

  • log(level: string, message: string): Promise<void>

    Logs a message with the specified log level.

    Parameters

    • level: string

      The severity level of the log (e.g., 'info', 'warn', 'error').

    • message: string

      The log message to be emitted.

    Returns Promise<void>

operateLock

  • operateLock(key: string, encrypt?: boolean): Promise<Buffer<ArrayBufferLike>>

    Operates the lock with the given command.

    Parameters

    • key: string

      The command key.

    • Optionalencrypt: boolean = true

      Whether to encrypt the command.

    Returns Promise<Buffer<ArrayBufferLike>>

    • The response buffer.

setDeviceName

  • setDeviceName(name: string): Promise<void>

    Sets the device name.

    Parameters

    • name: string

      The new device name.

    Returns Promise<void>

    A Promise that resolves when the name is set.

setKey

  • setKey(keyId: string, encryptionKey: string): Promise<void>

    Initializes the encryption key info for valid lock communication.

    Parameters

    • keyId: string

      The key ID.

    • encryptionKey: string

      The encryption key.

    Returns Promise<void>

unlock

  • unlock(): Promise<number>

    Unlocks the Smart Lock.

    Returns Promise<number>

    • The result of the unlock operation.

unlockNoUnlatch

  • unlockNoUnlatch(): Promise<number>

    Unlocks the Smart Lock without unlatching the door.

    Returns Promise<number>

    • The result of the unlock operation.

unsubscribeFromNotify

StaticgetLockStatus

  • getLockStatus(code: number): string

    Parameters

    • code: number

    Returns string

StaticparseServiceData

  • parseServiceData(
        serviceData: Buffer,
        manufacturerData: Buffer,
        emitLog: (level: string, message: string) => void,
    ): Promise<null | lockServiceData>

    Parses the service data from the SwitchBot Strip Light.

    Parameters

    • serviceData: Buffer

      The service data buffer.

    • manufacturerData: Buffer

      The manufacturer data buffer.

    • emitLog: (level: string, message: string) => void

      The function to emit log messages.

    Returns Promise<null | lockServiceData>

    • Parsed service data or null if invalid.

StaticvalidateResponse

  • validateResponse(res: Buffer): Promise<number>

    Parameters

    • res: Buffer

    Returns Promise<number>

Settings

Member Visibility

On This Page

Constructors
Properties
Accessors
Methods