Improve documentation for MTROTAProviderDelegate. (#27206)
Makes it clear how to handle BDX uris and file designators
diff --git a/src/darwin/Framework/CHIP/MTROTAProviderDelegate.h b/src/darwin/Framework/CHIP/MTROTAProviderDelegate.h
index 469741e..d9566b4 100644
--- a/src/darwin/Framework/CHIP/MTROTAProviderDelegate.h
+++ b/src/darwin/Framework/CHIP/MTROTAProviderDelegate.h
@@ -45,6 +45,13 @@
* If completion is passed a non-nil error, that will be converted into
* an error response to the client. Otherwise it must have a non-nil data,
* which will be returned to the client.
+ *
+ * When providing an OTA image, the imageURI in the
+ * MTROTASoftwareUpdateProviderClusterQueryImageResponseParams must be set to
+ * the file designator of the image. The completion will create the right BDX
+ * URI from that file designator, as needed. The file designator returned here
+ * via imageURI will be the same as the file designator passed to
+ * handleBDXTransferSessionBeginForNodeID:controller:fileDesignator:offset:completion:.
*/
- (void)handleQueryImageForNodeID:(NSNumber *)nodeID
controller:(MTRDeviceController *)controller
