Make ota-requestor-app build and run

[holbrookt]

Problem

• ota-requestor-app does not build or do anything useful right now
  • it was submitted as a starting point for further development
• fixes Implement OTA Software Update cluster (Client side) #2861 and Implement BDX synchronous receiver role over CRMP #2865

We need an OTA Requestor reference app in order to validate ota-provider-app and other OTA Provider devices. This should also serve as a reference for how to add OTA Requestor functionality to other applications.

Change overview

• add program argument for Provider Node ID to connect to
• use Device::EstablishConnectivity() to connect to Provider device and define connection callbacks
  • call QueryImage if/when connection is successful
  • start BDX transfer when QueryImageResponse is received
• initialize Controller with crypto info
• set kExpectResponse flag for BDX exchange
• error handling and logging fixes/improvements
• remove OTA Requestor cluster from zap file (until [ota-requestor-app] Handle AnnounceOTAProvider #9522 is fixed)
• edit README instructions
• add ota-requestor-app build to CI

Testing

• tested against ota-provider-app with instructions in README.md (requires CHIPDevice: add access to ExchangeManager, fix SessionHandle getter #9734 and [ota-provider-app] fix location parsing and BDX sender #9733)

[todo]

would be nicer to encapsulate these globals and the callbacks in some sort of class

connectedhomeip/examples/ota-requestor-app/linux/main.cpp

Lines 59 to 69 in 73a8f82

	// TODO: would be nicer to encapsulate these globals and the callbacks in some sort of class
	chip::Messaging::ExchangeContext * exchangeCtx = nullptr;
	Device * providerDevice = nullptr;
	BdxDownloader bdxDownloader;
	void OnQueryImageResponse(void * context, uint8_t status, uint32_t delayedActionTime, uint8_t * imageURI, uint32_t softwareVersion,
	chip::ByteSpan updateToken, bool userConsentNeeded, chip::ByteSpan metadataForRequestor)
	{
	ChipLogDetail(SoftwareUpdate, "%s", __FUNCTION__);
	TransferSession::TransferInitData initOptions;
	initOptions.TransferCtlFlags = chip::bdx::TransferControlFlags::kReceiverDrive;

---

This comment was generated by todo based on a TODO comment in 73a8f82 in #9740. cc @holbrookt.

[todo]

blocked because arrays are being generated as uint8_t

connectedhomeip/examples/ota-requestor-app/linux/main.cpp

Lines 118 to 128 in 73a8f82

	constexpr uint8_t testProtocolsSupported = 0; // TODO: blocked because arrays are being generated as uint8_t
	uint8_t locationBuf[3] = { 'U', 'S', '\0' };
	ByteSpan location(locationBuf);
	constexpr bool clientCanConsent = false;
	ByteSpan metadata(locationBuf);
	err = cluster.Associate(device, kOtaProviderEndpoint);
	if (err != CHIP_NO_ERROR)
	{
	ChipLogError(SoftwareUpdate, "Associate() failed: %s", chip::ErrorStr(err));
	return;

---

This comment was generated by todo based on a TODO comment in 73a8f82 in #9740. cc @holbrookt.

[todo]

- OpCreds should only be generated for pairing command

connectedhomeip/examples/ota-requestor-app/linux/main.cpp

Lines 252 to 262 in 73a8f82

	// TODO - OpCreds should only be generated for pairing command
	// store the credentials in persistent storage, and
	// generate when not available in the storage.
	err = mOpCredsIssuer.GenerateNOCChainAfterValidation(mStorage.GetLocalNodeId(), 0, ephemeralKey.Pubkey(), rcacSpan,
	icacSpan, nocSpan);
	SuccessOrExit(err);
	initParams.ephemeralKeypair = &ephemeralKey;
	initParams.controllerRCAC = rcacSpan;
	initParams.controllerICAC = icacSpan;
	initParams.controllerNOC = nocSpan;

---

This comment was generated by todo based on a TODO comment in 73a8f82 in #9740. cc @holbrookt.

[todo]

something more elegant than appending to a local file

connectedhomeip/examples/ota-requestor-app/ota-requestor-common/BDXDownloader.cpp

Lines 79 to 89 in 73a8f82

	// TODO: something more elegant than appending to a local file
	// TODO: while convenient, we should not do a synchronous block write in our example application - this is bad practice
	std::ofstream otaFile(outFilePath, std::ifstream::out | std::ifstream::ate | std::ifstream::app);
	otaFile.write(reinterpret_cast<const char *>(event.blockdata.Data), event.blockdata.Length);
	if (event.blockdata.IsEof)
	{
	err = mTransfer.PrepareBlockAck();
	VerifyOrReturn(err == CHIP_NO_ERROR,
	ChipLogError(BDX, "%s: PrepareBlockAck failed: %s", __FUNCTION__, chip::ErrorStr(err)));
	mIsTransferComplete = true;

---

This comment was generated by todo based on a TODO comment in 73a8f82 in #9740. cc @holbrookt.

[todo]

while convenient, we should not do a synchronous block write in our example application - this is bad practice

connectedhomeip/examples/ota-requestor-app/ota-requestor-common/BDXDownloader.cpp

Lines 80 to 90 in 73a8f82

	// TODO: while convenient, we should not do a synchronous block write in our example application - this is bad practice
	std::ofstream otaFile(outFilePath, std::ifstream::out | std::ifstream::ate | std::ifstream::app);
	otaFile.write(reinterpret_cast<const char *>(event.blockdata.Data), event.blockdata.Length);
	if (event.blockdata.IsEof)
	{
	err = mTransfer.PrepareBlockAck();
	VerifyOrReturn(err == CHIP_NO_ERROR,
	ChipLogError(BDX, "%s: PrepareBlockAck failed: %s", __FUNCTION__, chip::ErrorStr(err)));
	mIsTransferComplete = true;
	}

---

This comment was generated by todo based on a TODO comment in 73a8f82 in #9740. cc @holbrookt.

[todo]

support this as a list once ember adds list support

connectedhomeip/examples/ota-requestor-app/linux/main.cpp

Lines 122 to 132 in dd13ad2

	EMBER_ZCL_OTA_DOWNLOAD_PROTOCOL_BDX_SYNCHRONOUS; // TODO: support this as a list once ember adds list support
	const uint8_t locationBuf[] = { 'U', 'S' };
	ByteSpan exampleLocation(locationBuf);
	constexpr bool kExampleClientCanConsent = false;
	ByteSpan metadata;
	err = cluster.Associate(device, kOtaProviderEndpoint);
	if (err != CHIP_NO_ERROR)
	{
	ChipLogError(SoftwareUpdate, "Associate() failed: %s", chip::ErrorStr(err));
	return;

---

This comment was generated by todo based on a TODO comment in dd13ad2 in #9740. cc @holbrookt.