Azure IoT Hub Arduino Raspberry Pi Pico with Telemetry

Have started as blog on this here

Azure_IoT_Hub_RPI_Pico_LightSensor_WithCDM SKETCH is complete.

Has Direct Methods, CD Messages, Patches, Twins and Desired/Reported Properties.
Refactoring all bar Messages into separate source files.
Has been separated into a source library that could be added to another Sketch

Documentation

Detailed docmentation (16 posts) is now available on my blog site

About

Adds some functioanlity, such as reading environment telemetry to Azure/azure-sdk-for-c-arduino Rpi Pico example. This example has been added as a Pull Request to that repository which was pulled from the fork at djaus2/azure-sdk-for-c-arduino. The pull request was declined as third party sofwtare is used that is not under Microsoft's remit to keep updated. Hence the need to expand upon it here! (When merged in the original, it should be in the matching folder)

The first Sketch here (base) is that same proposed example Sketch and is in examples/Azure_IoT_Hub_RPI_Pico in the djaus2 fork.

Hardware

Using a Freenove Ultimate Starter Kit and Rpi Pico. See the ReadMe in the Base for further info.

Library

The Azure__IoT_Hub_Lib folder contains extended Azure Embedded C SDK functionlity as in Azure_IoT_Hub_RPI_Pico_LightSensor_WithCDM Sketch as a soutrce library,

Sketches

• Azure_IoT_Hub_RPI_Pico_Base
  • The base version. Work through the ReadMe there to get the Pico up and running with Azure IoT Hub
  • It also includes an addendum for porting the ESP8266 example to the Pico, from the original repository.
  • Only sends an incremented count as telemetry.
• Azure_IoT_Hub_RPI_Pico_DHT11
  • Reads a DHT11 sensor and sends Temperature and Pressure as Telemetry.
  • Makes use of formal generation of Json string.
  • This is a template for other sensors.
• Azure IoT Hub RPI Pico LDR
  • Reading light intensity using a Light Dependent Resistor (LDR) as per the DHT11 template.
• Azure_IoT_Hub_RPI_Pico_Thermistor
  • A Thermistor temperature sensor as per the DHT11 template.
  • Circuit and code quite similar to the LDR.
• Azure_IoT_Hub_RPI_Pico_BME280
  • Done Basic Mode (Telemetry only)
  • Get Temperature, Pressure and Humidity, in I2C mode
• Azure_IoT_Hub_RPI_Pico_LightSensor_WithCDM with Cloud to Device Messages and Commands
  • Messages: All Sketches will display Cloud to Device Messages to it. Unchanged
    • Custom CD Msg feedback is a work in progress.
  • This version will interpret a number of Cloud to Device Commands (Methods) and run them.
    • Now sends acknowledgment back to the cloud.
  • Device Twins
    • Device can GET the Device Twin Document and set the desired properties
    • The Device can receive and implement PATCHED properties
• Azure_IoT_Hub_RPI_Pico_BME280_WithCDM_
  • As per BME280 above
  • Also Direct Methods and Device Twins as above.
  • Get Temperature, Pressure and Humidity, in I2C mode
• Console Apps
  • Four console apps for exercisiong various IoT features.

2Do's

• Handle CD Messages, Methods, Device Twins . All done.
• Component Properties in Device Twin Document.

Setting up the IoT Hub

I have another repository that when cloned and opened in VS Code provides a menu driven context for creating and managing an Azure IoT Hub and releated entities. See:

Azure IoT Hub PowerShell Scripts

• Get an Azure Subscription (You can get a free one for a month or so).
• Clone the above repository and open the PS folder in VS Code and from a terminal run:

./get-iothub

New: Can generate C Header File Device connectivity for Azure SDK for C Arduino:
In get-iothub, Menu 6 then 1. Info at bottom.

• Select the subscription and login
• Create a new Group
• Create a new IoT Hub
• Create a new Device
• Get the Connectivity details (6. Environment Variables)
  • Menu Option 6 then 1. Info at bottom.
    Copy and paste into header file