OTA Requestor Refactoring -- Part 1

.github/.wordlist.txt

@@ -542,6 +542,7 @@ lightin
 LightingColor
 LightingState
 LinkSoftwareAndDocumentationPack
+LinuxOTARequestorDriver
 LocalConfigDisabled
 localhost
 localstatedir
@@ -694,9 +695,13 @@ optionsMask
 optionsOverride
 orgs
 OTA
+OTADownloader
+OTAImageProcessorDriver
 OTAProviderIpAddress
 OTAProviderNodeId
 OTAProviderSerialPort
+OTARequestor
+OTARequestorDriver
 OTARequesterImpl
 OTARequestorSerialPort
 OTBR
@@ -851,7 +856,10 @@ SERIALDEVICE
 SerialNumber
 ServiceId
 SetDns
+SetImageProcessorDelegate
+SetOtaRequestorDriver
 SetpointRaiseLower
+SetRequestorInstance
 SetUpPINCode
 SetupQRCode
 sexualized

examples/ota-requestor-app/linux/BUILD.gn

@@ -16,7 +16,10 @@ import("//build_overrides/build.gni")
 import("//build_overrides/chip.gni")
 
 executable("chip-ota-requestor-app") {
-  sources = [ "main.cpp" ]
+  sources = [
+    "LinuxOTARequestorDriver.cpp",
+    "main.cpp",
+  ]
 
   deps = [
     "${chip_root}/examples/ota-requestor-app/ota-requestor-common",

examples/ota-requestor-app/linux/LinuxOTAImageProcessor.h

@@ -0,0 +1,45 @@
+/*
+ *
+ *    Copyright (c) 2021 Project CHIP Authors
+ *    All rights reserved.
+ *
+ *    Licensed under the Apache License, Version 2.0 (the "License");
+ *    you may not use this file except in compliance with the License.
+ *    You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *    Unless required by applicable law or agreed to in writing, software
+ *    distributed under the License is distributed on an "AS IS" BASIS,
+ *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *    See the License for the specific language governing permissions and
+ *    limitations under the License.
+ */
+
+/* This file contains the decalarions for the Linux implementation of the
+ * the OTAImageProcessorDriver interface class
+ */
+
+#include "app/clusters/ota-requestor/OTAImageProcessor.h"
+
+class LinuxOTAImageProcessor : public OTAImageProcessorDriver
+{
+
+    // Virtuial functions from OTAImageProcessorDriver -- start
+    // Open file, find block of space in persistent memory, or allocate a buffer, etc.
+    CHIP_ERROR PrepareDownload() { return CHIP_NO_ERROR; }
+
+    // Must not be a blocking call to support cases that require IO to elements such as // external peripherals/radios
+    CHIP_ERROR ProcessBlock(chip::ByteSpan & data) { return CHIP_NO_ERROR; }
+
+    // Close file, close persistent storage, etc
+    CHIP_ERROR Finalize() { return CHIP_NO_ERROR; }
+
+    chip::Optional<uint8_t> PercentComplete() { return chip::Optional<uint8_t>(0); }
+
+    // Clean up the download which could mean erasing everything that was written,
+    // releasing buffers, etc.
+    CHIP_ERROR Abort() { return CHIP_NO_ERROR; }
+
+    // Virtuial functions from OTAImageProcessorDriver -- end
+};

examples/ota-requestor-app/linux/LinuxOTARequestorDriver.cpp

@@ -0,0 +1,34 @@
+/*
+ *
+ *    Copyright (c) 2021 Project CHIP Authors
+ *    All rights reserved.
+ *
+ *    Licensed under the Apache License, Version 2.0 (the "License");
+ *    you may not use this file except in compliance with the License.
+ *    You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *    Unless required by applicable law or agreed to in writing, software
+ *    distributed under the License is distributed on an "AS IS" BASIS,
+ *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *    See the License for the specific language governing permissions and
+ *    limitations under the License.
+ */
+
+/* This file contains the Linux implementation of the  OTAImageProcessorDriver
+ * interface class
+ */
+
+#include "LinuxOTARequestorDriver.h"
+
+// A call into the application logic to give it a chance to allow or stop the Requestor
+// from proceeding with actual image download. Returning TRUE will allow the download
+// to proceed, returning FALSE will abort the download process.
+bool LinuxOTARequestorDriver::CheckImageDownloadAllowed()
+{
+    return true;
+}
+
+// Notify the application that the download is complete and the image can be applied
+void LinuxOTARequestorDriver::ImageDownloadComplete() {}

examples/ota-requestor-app/linux/LinuxOTARequestorDriver.h

@@ -0,0 +1,38 @@
+/*
+ *
+ *    Copyright (c) 2021 Project CHIP Authors
+ *    All rights reserved.
+ *
+ *    Licensed under the Apache License, Version 2.0 (the "License");
+ *    you may not use this file except in compliance with the License.
+ *    You may obtain a copy of the License at
+ *
+ *        http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *    Unless required by applicable law or agreed to in writing, software
+ *    distributed under the License is distributed on an "AS IS" BASIS,
+ *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *    See the License for the specific language governing permissions and
+ *    limitations under the License.
+ */
+
+/* This file contains the decalarions for the Linux implementation of the
+ * the OTARequestorDriver interface class
+ */
+#include "app/clusters/ota-requestor/OTARequestorDriver.h"
+
+class LinuxOTARequestorDriver : public OTARequestorDriver
+{
+
+    // Virtual functions from OTARequestorDriver -- start
+
+    // A call into the application logic to give it a chance to allow or stop the Requestor
+    // from proceeding with actual image download. Returning TRUE will allow the download
+    // to proceed, returning FALSE will abort the download process.
+    bool CheckImageDownloadAllowed();
+
+    // Notify the application that the download is complete and the image can be applied
+    void ImageDownloadComplete();
+
+    // Virtual functions from OTARequestorDriver -- end
+};