Android Matter SDK

// Get connected device pointer
val devicePtr = suspendCoroutine<Long> { cont ->
    controller.getConnectedDevicePointer(nodeId,
        object : GetConnectedDeviceCallback {
            override fun onDeviceConnected(ptr: Long) = cont.resume(ptr)
            override fun onConnectionFailure(id: Long, e: Exception) =
                cont.resumeWithException(e)
        })
}

// Create OnOff cluster instance and send command
val cluster = ChipClusters.OnOffCluster(devicePtr, endpointId)
cluster.toggle(object : ChipClusters.DefaultClusterCallback {
    override fun onSuccess() { /* device toggled */ }
    override fun onError(ex: Exception) { /* handle error */ }
})

// 1. PartsList on endpoint 0: which endpoints exist
val root = ChipClusters.DescriptorCluster(devicePtr, 0)
root.readPartsListAttribute(object :
    ChipClusters.DescriptorCluster.PartsListAttributeCallback {
    override fun onSuccess(endpoints: List<Int>) {
        endpoints.forEach { ep -> readEndpoint(devicePtr, ep) }
    }
    override fun onError(ex: Exception) { /* handle error */ }
})

// 2. DeviceTypeList / ServerList on each endpoint: what it is, which clusters
fun readEndpoint(devicePtr: Long, ep: Int) {
    val descriptor = ChipClusters.DescriptorCluster(devicePtr, ep)
    descriptor.readDeviceTypeListAttribute(object :
        ChipClusters.DescriptorCluster.DeviceTypeListAttributeCallback {
        override fun onSuccess(types: List<ChipStructs.DescriptorClusterDeviceTypeStruct>) {
            // A lock endpoint returns 0x000A (Door Lock) and 0x0011 (Power Source)
            types.forEach { Log.d(TAG, "EP$ep type=0x%04X rev=%d".format(it.deviceType, it.revision)) }
        }
        override fun onError(ex: Exception) {}
    })
    descriptor.readServerListAttribute(object :
        ChipClusters.DescriptorCluster.ServerListAttributeCallback {
        override fun onSuccess(clusters: List<Long>) { /* e.g. [3, 29, 47, 257] */ }
        override fun onError(ex: Exception) {}
    })
}

// 3. Optional features of a cluster: FeatureMap (global attribute 0xFFFC)
ChipClusters.DoorLockCluster(devicePtr, 1).readFeatureMapAttribute(object :
    ChipClusters.LongAttributeCallback {
    override fun onSuccess(value: Long) {
        val supportsFingerprint = (value and (1L shl 2)) != 0L  // bit 2 = FGP
    }
    override fun onError(ex: Exception) {}
})