Device Management

This topic describes the API methods to implement multiple device management features. For example, get device details, modify device details, remove devices, get the instruction set of the device, and send commands.

Get device details

Parameters

Description of TYDevice

TYDeviceManager().queryDeviceInfo(of: "") { deviceInfo, error in
    guard error == nil else {
        print(error?.localizedDescription)
        return
    }
    let name = deviceInfo?.name
    let productID = deviceInfo?.productID
}

Get details of multiple devices in the same request

Parameters

Example

TYDeviceManager().queryDevicesInfo(of: idArray) { (deviceArray, error) in
    guard error == nil else {
        print(error?.localizedDescription)
        return
    }
    self.deviceList = deviceArray!
}

Rename a device

Parameters

Example

TYDeviceManager().modifyDeviceName(for: self.device!.id, to: self.newName) { (bool, error) in
    if bool == true {
        // Do something
    } else {
        // Do something
    }
}

Remove a device

Parameters

Example

TYDeviceManager().removeDevice("Your device ID") { (bool, error) in
    if bool == true {
        // Do something
        return
    }
    print(error?.localizedDescription)
}

Remove multiple devices in the same request

Parameters

Example

TYDeviceManager().removeDevice("Your device id") { success, error in
            
}

Restore default settings

Parameters

Example

TYDeviceManager().resetDevice(for: "Your device id") { success, error in
            
}

Get a list of sub-devices

Parameters

Description of TYPairedSubDevice

Example

TYDeviceManager().querySubDevices("Your device id") { (deviceArray, error) in
    guard error == nil else {
        print(error?.localizedDescription)
        return
    }
    let devices = deviceArray
}

Get the status of a single device

Parameters

Description of TYDeviceCommand

Example

TYDeviceManager().queryDeviceStatus(of: "Your device id") { commands, error in
        guard error == nil else {
            print(error?.localizedDescription)
        return
    }
    let devices = commands
}

Get the latest status of multiple devices in the same request

Parameters

Example

TYDeviceManager().queryDeviceStatus(of: "Your device id") { commands, error in
    guard error == nil else {
        print(error?.localizedDescription)
        return
    }
    let commands = commands
}

Get the instruction set of a category

Parameters

Description of TYCategoryStandardCommand

Description of TYStandardCommand

Example

TYDeviceManager().queryCommandSetFromCategory("") { command, error in
    guard error == nil else {
        print(error?.localizedDescription)
        return
    }
    let category = command?.category
    let commadns = command?.functions
}

Get the instruction set of a device

Parameters

Example

TYDeviceManager().queryCommandSetFromDeviceID("Your device id") { command, error in
    guard error == nil else {
        print(error?.localizedDescription)
        return
    }
    let category = command?.category
    let commadns = command?.functions
}

Get device properties

Parameters

Description of TYDeviceSpecification

Description of TYStandardStatus

Example

TYDeviceManager().queryDeviceSpecification(of: "Your category id") { specification, error in
    guard error == nil else {
        print(error?.localizedDescription)
        return
    }
    let category = specification?.category
    let functions = specification?.functions
    let status = specification?.status
}

Send a command

Parameters

Description of TYDeviceCommand

Example

 TYDeviceManager().sendCommands([dp1, dp2, dp3], to: "Your device ID") { (bool, error) in
    guard error == nil else {
        print("Faild")
        return
    }
    print("Succeed")
}