Device Information

Last Updated on : 2023-10-07 05:53:17download

A device information query can return the following information.

  • The device ID.
  • The IP address of the device.
  • The local IP address of the device.
  • The time zone of the device.
  • The MAC address.
  • The signal strength of the device.
  • The Integrated Circuit Card Identification Number (ICCID) of the device.
  • The connectivity of the device.
  • The device channel (for Zigbee devices only).
  • The manufacturer of the device (for third-party Matter devices only).
  • The reference signal received power (RSRP) of the device (for LTE Cat.1 devices only).

The data returned by the device information query comes from multiple sources, each with a different response time. The total time does not exceed five seconds, but specific devices take more than five seconds to return data.

API description

/**
 *get device detail info
 *
 *@param deviceId deviceId
 *@param callback callback
 */
fun getDeviceDetailInfo(deviceId: String, callback: DeviceDetailInfoCallback)

Parameter description

Parameters Type Description
deviceId String The device ID.
callback DeviceDetailInfoCallback DeviceDetailInfoCallback callback.

Example

val detailInfoManager = ThingDeviceDetailKit.getInstance().getDeviceInfoManager()
detailInfoManager.getDeviceDetailInfo(deviceId,object :DeviceDetailInfoCallback{
    override fun onDeviceDetailInfoResult(deviceDetailInfo: DeviceDetailInfo?) {

    }
})

Return data (DeviceDetailInfo class)

Property Type Description
ip String The IP address of the device.
mac String The MAC address of the device.
rsrp String The RSRP value, indicating the network signal strength of the device. This parameter applies to LTE Cat.1 devices only.
iccid String The ICCID, the unique ID of the SIM card. This parameter applies to LTE Cat.1 devices only.
lanIp String The local IP address of the device.
devId String The device ID.
channel String The channel ID. This parameter applies to Zigbee gateways only.
timezone String The time zone of the device.
wifiSignal Integer The Wi-Fi signal strength of the device.
netStrength String The signal strength of the device.
vendorName String The manufacturer of the device. This parameter applies to third-party Matter devices only.
connectAbility ConnectAbility Device connectivity:
  • UNKNOWN
  • PHONE
  • GATEWAY
  • PHONE_AND_GATEWAY