adafruit-circuitpython-azureiot 2.4.1

Azure IoT Hub

To interact with Azure IoT Hub, you will need to create a hub, and a register a device inside that hub. There is a free tier available, and this free tier allows up to 8,000 messages a day, so try not to send messages too often if you are using this tier.

• Open the Azure Portal.

• Follow the instructions in Microsoft Docs to create an Azure IoT Hub and register a device.

• Copy the devices Primary or secondary connection string, and add this to your secrets.py file.

You can find the device connection string by selecting the IoT Hub in the Azure Portal, selecting Explorer -> IoT devices, then selecting your device.

Locating the device in the IoT hub blade

Then copy either the primary or secondary connection string using the copy button next to the value.

Copy the primary connection string

Connect your device to Azure IoT Hub

from adafruit_azureiot import IoTHubDevice

device = IoTHubDevice(wifi, secrets["device_connection_string"])
device.connect()

Once the device is connected, you will regularly need to run a loop to poll for messages from the cloud.

while True:
    device.loop()
    time.sleep(1)

Send a device to cloud message

message = {"Temperature": temp}
device.send_device_to_cloud_message(json.dumps(message))

Receive device to cloud messages

def cloud_to_device_message_received(body: str, properties: dict):
    print("Received message with body", body, "and properties", json.dumps(properties))

# Subscribe to cloud to device messages
device.on_cloud_to_device_message_received = cloud_to_device_message_received

Receive direct methods

def direct_method_invoked(method_name: str, payload) -> IoTResponse:
    print("Received direct method", method_name, "with data", str(payload))
    # return a status code and message to indicate if the direct method was handled correctly
    return IoTResponse(200, "OK")

# Subscribe to direct methods
device.on_direct_method_invoked = direct_method_invoked

Update reported properties on the device twin

This is not supported on Basic tier IoT Hubs, only on the free and standard tiers.

patch = {"Temperature": temp}
device.update_twin(patch)

Subscribe to desired property changes on the device twin

This is not supported on Basic tier IoT Hubs, only on the free and standard tiers.

def device_twin_desired_updated(desired_property_name: str, desired_property_value, desired_version: int):
    print("Property", desired_property_name, "updated to", str(desired_property_value), "version", desired_version)

# Subscribe to desired property changes
device.on_device_twin_desired_updated = device_twin_desired_updated

Azure IoT Central

To use Azure IoT Central, you will need to create an Azure IoT Central app, create a device template and register a device against the template.

• Head to Azure IoT Central

• Follow the instructions in the Microsoft Docs to create an application. Every tier is free for up to 2 devices.

• Follow the instructions in the Microsoft Docs to create a device template.

• Create a device based off the template, and select Connect to get the device connection details. Store the ID Scope, Device ID and either the Primary or secondary Key in your secrets.py file.

The connect button

The connection details dialog

secrets = {
    # WiFi settings
    "ssid": "",
    "password": "",

    # Azure IoT Central settings
    "id_scope": "",
    "device_id": "",
    "key": ""
}

Connect your device to your Azure IoT Central app

from adafruit_azureiot import IoTCentralDevice

device = IoTCentralDevice(wifi, secrets["id_scope"], secrets["device_id"], secrets["key"])
device.connect()

Once the device is connected, you will regularly need to run a loop to poll for messages from the cloud.

while True:
    device.loop()
    time.sleep(1)

Send telemetry

message = {"Temperature": temp}
device.send_telemetry(json.dumps(message))

Listen for commands

def command_executed(command_name: str, payload) -> IoTResponse:
    print("Command", command_name, "executed with payload", str(payload))
    # return a status code and message to indicate if the command was handled correctly
    return IoTResponse(200, "OK")

# Subscribe to commands
device.on_command_executed = command_executed

Update properties

device.send_property("Desired_Temperature", temp)

Listen for property updates

def property_changed(property_name, property_value, version):
    print("Property", property_name, "updated to", str(property_value), "version", str(version))

# Subscribe to property updates
device.on_property_changed = property_changed

Learning more about Azure IoT services

If you want to learn more about setting up or using Azure IoT Services, check out the following resources:

• Azure IoT documentation on Microsoft Docs

• IoT learning paths and modules on Microsoft Learn - Free, online, self-guided hands on learning with Azure IoT services