Arduino nano RP2040 and portenta H7 samples (#51)

* Merging nano and portenta samples

* Addressing comments

* Addressing comments Central Arduino Nano

* Addressing comments Central Arduino Portenta

* Adding support for ECCX08 with hmac update

* Renaming and removing mbedtls includes

* Adding install instructions for ArduinoECCX08

* Addressing comments

Author: RLeclair

examples/Azure_IoT_Central_Arduino_Nano_RP2040_Connect/AzureIoT.cpp

@@ -0,0 +1,104 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// SPDX-License-Identifier: MIT
+
+/*
+ * Azure_IoT_PnP_Template.cpp implements the IoT Plug and Play template
+ * specific for the Arduino Nano RP2040 Connect board.
+ */
+ 
+#ifndef AZURE_IOT_PNP_TEMPLATE_H
+#define AZURE_IOT_PNP_TEMPLATE_H
+
+#include "AzureIoT.h"
+
+/*
+ * @brief     Initializes internal components of this module.
+ * @remark    It must be called once by the application, before any other function
+ *            call related to Azure IoT.
+ */
+void azure_pnp_init();
+
+/*
+ * @brief     Returns the model id of the IoT Plug and Play template implemented by this device.
+ * @remark    Every IoT Plug and Play template has a model id that must be informed by the 
+ *            device during Azure IoT provisioning and connection with the Azure IoT Hub.
+ * @return    az_span       An `az_span` containing the model id implemented by this module.
+ */
+const az_span azure_pnp_get_model_id();
+
+/*
+ * @brief     Sends the device description to Azure IoT Central.
+ * @remark    Azure IoT Central expects the application to send a description of device and its capabilities.
+ *            This function generates a description of the Arduino Nano RP2040 Connect and sends it to
+ *            Azure IoT Central.
+ *
+ * @param[in]    azure_iot     A pointer the azure_iot_t instance with the state of the Azure IoT client.
+ * @param[in]    request_id    An unique identification number to correlate the response with when
+ *                             `on_properties_update_completed` (set in azure_iot_config_t) is invoked.
+ * @return       int           0 if the function succeeds, non-zero if any error occurs.
+ */
+int azure_pnp_send_device_info(azure_iot_t* azure_iot, uint32_t request_id);
+
+/*
+ * @brief     Sets with which minimum frequency this module should send telemetry to Azure IoT Central.
+ * @remark    `azure_pnp_send_telemetry` is used to send telemetry, but it will not send anything
+ *            unless enough time has passed since the last telemetry has been published.
+ *            This delay is defined internally by `telemetry_frequency_in_seconds`,
+ *            set initially to once every 10 seconds.
+ *
+ * @param[in]    frequency_in_seconds    Period of time, in seconds, to wait between two consecutive
+ *                                       telemetry payloads are sent to Azure IoT Central.
+ */
+void azure_pnp_set_telemetry_frequency(size_t frequency_in_seconds);
+
+/*
+ * @brief     Sends telemetry implemented by this IoT Plug and Play application to Azure IoT Central.
+ * @remark    The IoT Plug and Play template implemented by this device is specific to the
+ *            Arduino Nano RP2040 Connect board, which contains several sensors. The template
+ *            defines telemetry data points for temperature, humidity, pressure, altitude, 
+ *            luminosity, magnetic field, rolling and pitch angles, as well as acceleration. All of 
+ *            these data are read from the board sensors and sent to Azure IoT Central when 
+ *            `azure_pnp_send_telemetry` is called. This function must be called frequently enough, 
+ *            no slower than the frequency set with `azure_pnp_set_telemetry_frequency` (or the 
+ *            default frequency of 10 seconds).
+ *            
+ * @param[in]    azure_iot    A pointer to a azure_iot_t instance, previously initialized 
+ *                            with `azure_iot_init`.
+ *                            
+ * return        int          0 on success, non-zero if any failure occurs.
+ */
+int azure_pnp_send_telemetry(azure_iot_t* azure_iot);
+
+/*
+ * @brief     Handles a command when it is received from Azure IoT Central.
+ * @remark    This function will perform the task requested by the command received 
+ *            (if the command matches the expected name) and sends back a response to 
+ *            Azure IoT Central.
+ *
+ * @param[in]    azure_iot          A pointer to a azure_iot_t instance, previously initialized 
+ *                                  with `azure_iot_init`.
+ * @param[in]    command_request    The `command_request_t` instance containing the details of the 
+ *                                  device command.
+ *
+ * return        int                0 on success, non-zero if any failure occurs.
+ */
+int azure_pnp_handle_command_request(azure_iot_t* azure_iot, command_request_t command_request);
+
+/*
+ * @brief     Handles a payload with writable properties received from Azure IoT Central.
+ * @remark    This function will consume the writable properties update received 
+ *            and send back a response to Azure IoT Central.
+ * 
+ * @param[in]    azure_iot     A pointer to a azure_iot_t instance, previously initialized 
+ *                             with `azure_iot_init`.
+ * @param[in]    properties    Raw properties writable-properties payload received from Azure.
+ * @param[in]    request_id    The request ID of the response that is sent to the Azure IoT Central.
+ *                             In Azure IoT Plug and Play, a response to a writable-property update is
+ *                             itself a reported-property (device-side property) update, so it gets a 
+ *                             a response from Azure with the same request ID provided here as argument.
+ *
+ * return        int           0 on success, non-zero if any failure occurs.
+ */
+int azure_pnp_handle_properties_update(azure_iot_t* azure_iot, az_span properties, uint32_t request_id);
+
+#endif // AZURE_IOT_PNP_TEMPLATE_H

examples/Azure_IoT_Central_Arduino_Nano_RP2040_Connect/AzureIoT.h

@@ -0,0 +1,24 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// SPDX-License-Identifier: MIT
+
+// Wifi
+#define IOT_CONFIG_WIFI_SSID              "SSID"
+#define IOT_CONFIG_WIFI_PASSWORD          "PWD"
+
+// Azure IoT Central
+#define IOT_CONFIG_DPS_ID_SCOPE           "ID Scope"
+#define IOT_CONFIG_DEVICE_ID              "Device ID"
+#define IOT_CONFIG_DEVICE_KEY             "Device Key"
+
+// User-agent (url-encoded) provided by the MQTT client to Azure IoT Services.
+// When developing for your own Arduino-based platform, please follow the format '(ard;<platform>)'.
+#define IOT_CONFIG_AZURE_SDK_CLIENT_USER_AGENT "c%2F" AZ_SDK_VERSION_STRING "(ard;nanorp2040connect)"
+
+// For how long the MQTT password (SAS token) is valid, in minutes.
+// After that, the sample automatically generates a new password and re-connects.
+#define IOT_CONFIG_MQTT_PASSWORD_LIFETIME_IN_MINUTES 60
+
+// Time Zone Offset
+#define IOT_CONFIG_TIME_ZONE -8
+#define IOT_CONFIG_TIME_ZONE_DAYLIGHT_SAVINGS_DIFF 1
+#define IOT_CONFIG_DAYLIGHT_SAVINGS true