Class WoSmartLock

Class representing a WoSmartLock device.

See

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

Hierarchy (view full)

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 lock log operateLock setDeviceName setKey unlock unlockNoUnlatch unsubscribeFromNotify getLockStatus parseServiceData validateResponse

Constructors

constructor

Properties

encryption_key

encryption_key: null | Buffer = null

iv

iv: null | Buffer = 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>)

      • (): Promise<void>

      • Returns Promise<void>

  • set onConnectHandler(func): void

  • Parameters

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

        • Returns Promise<void>

    Returns void

onDisconnectHandler

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

  • Returns (() => Promise<void>)

      • (): Promise<void>

      • Returns Promise<void>

  • set onDisconnectHandler(func): void

  • Parameters

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

        • Returns Promise<void>

    Returns void

Methods

command

  • command(reqBuf): Promise<Buffer>

  • Sends a command to the device and awaits a response.

    Parameters

    • reqBuf: Buffer

      The command buffer.

    Returns Promise<Buffer>

    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): Promise<Buffer>

  • Decrypts a buffer using AES-128-CTR.

    Parameters

    • data: Buffer

      The data to decrypt.

    Returns Promise<Buffer>

    • 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): 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): Promise<Buffer>

  • Sends an encrypted command to the device.

    Parameters

    • key: string

      The command key.

    Returns Promise<Buffer>

    • The response buffer.

getCharacteristics

getDeviceName

getIv

  • getIv(): Promise<Buffer>

  • Retrieves the IV from the device.

    Returns Promise<Buffer>

    • 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.

lock

  • lock(): Promise<number>

  • Locks the Smart Lock.

    Returns Promise<number>

    • The result of the lock operation.

log

  • log(level, message): 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, encrypt?): Promise<Buffer>

  • Operates the lock with the given command.

    Parameters

    • key: string

      The command key.

    • Optionalencrypt: boolean = true

      Whether to encrypt the command.

    Returns Promise<Buffer>

    • The response buffer.

setDeviceName

  • setDeviceName(name): 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, encryptionKey): 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

StaticparseServiceData

  • parseServiceData(serviceData, manufacturerData, emitLog): 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.

        • (level, message): void

        • Parameters

          • level: string
          • message: string

          Returns void

    Returns Promise<null | lockServiceData>

    • Parsed service data or null if invalid.

StaticvalidateResponse

Settings

Member Visibility

On This Page

Constructors
Properties
Accessors
Methods