Microsoft Azure IoT Device Library
Project description
Azure IoT Device SDK
The Azure IoT Device SDK for Python provides functionality for communicating with the Azure IoT Hub for both Devices and Modules.
Note that this SDK is currently in preview, and is subject to change.
Features
The SDK provides the following clients:
-
Device Client
- Send telemetry messages to Azure IoT Hub
- Receive Cloud-to-Device (C2D) messages from the Azure IoT Hub
-
Module Client
- Supports Azure IoT Edge Hub and Azure IoT Hub
- Send telemetry messages to a Hub or to another Module
- Receive Input messages from a Hub or other Modules
These clients are available with an asynchronous API, as well as a blocking synchronous API for compatibility scenarios. We recommend you use Python 3.7+ and the asynchronous API.
| Python Version | Asynchronous API | Synchronous API |
|---|---|---|
| Python 3.5+ | YES | YES |
| Python 3.4 | NO | YES |
| Python 2.7 | NO | YES |
Installation
pip install azure-iot-device
Set up an IoT Hub and create a Device Identity
-
Install the Azure CLI (or use the Azure Cloud Shell) and use it to create an Azure IoT Hub.
az iot hub create --resource-group <your resource group> --name <your IoT Hub name>
- Note that this operation make take a few minutes.
-
Add the IoT Extension to the Azure CLI, and then register a device identity
az extension add --name azure-cli-iot-ext az iot hub device-identity create --hub-name <your IoT Hub name> --device-id <your device id>
-
Retrieve your Device Connection String using the Azure CLI
az iot hub device-identity show-connection-string --device-id <your device id> --hub-name <your IoT Hub name>
It should be in the format:
HostName=<your IoT Hub name>.azure-devices.net;DeviceId=<your device id>;SharedAccessKey=<some value>
Send a simple telemetry message
-
Begin monitoring for telemetry on your IoT Hub using the Azure CLI
az iot hub monitor-events --hub-name <your IoT Hub name> --output table
-
On your device, set the Device Connection String as an enviornment variable called
IOTHUB_DEVICE_CONNECTION_STRING.Windows
set IOTHUB_DEVICE_CONNECTION_STRING=<your connection string here>
- Note that there are NO quotation marks around the connection string.
Linux
export IOTHUB_DEVICE_CONNECTION_STRING="<your connection string here>"
-
Copy the following code that sends a single message to the IoT Hub into a new python file on your device, and run it from the terminal or IDE (requires Python 3.7+):
import os import asyncio from azure.iot.device.aio import IoTHubDeviceClient from azure.iot.device import auth async def main(): # Fetch the connection string from an enviornment variable conn_str = os.getenv("IOTHUB_DEVICE_CONNECTION_STRING") # Create an authentication provider using the connection string auth_provider = auth.from_connection_string(conn_str) # Create instance of the device client using the authentication provider device_client = IoTHubDeviceClient.from_authentication_provider(auth_provider, "mqtt") # Connect the device client. await device_client.connect() # Send a single message print("Sending message...") await device_client.send_event("This is a message that is being sent") print("Message successfully sent!") # finally, disconnect await device_client.disconnect() if __name__ == "__main__": asyncio.run(main())
-
Check the Azure CLI output to verify that the message was received by the IoT Hub. You should see the following output:
Starting event monitor, use ctrl-c to stop... event: origin: <your Device name> payload: This is a message that is being sent
-
Your device is now able to connect to Azure IoT Hub!
Additional Samples
Check out the samples repository for example code showing how the SDK can be used in a variety of scenarios, including:
- Sending multiple telemetry messages at once.
- Receiving Cloud-to-Device messages.
- Using Edge Modules with the Azure IoT Edge Hub.
- Legacy scenarios for Python 2.7 and 3.4
Getting help and finding API docs
Our SDK makes use of docstrings which means you cand find API documentation directly through Python with use of the help command:
>>> from azure.iot.device import IoTHubDeviceClient
>>> help(IoTHubDeviceClient)
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file azure-iot-device-2.0.0rc3.tar.gz.
File metadata
- Download URL: azure-iot-device-2.0.0rc3.tar.gz
- Upload date:
- Size: 33.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | ac640f42ea696c7c7368bc4da5caffbd2d57e790527541a376e9706389e58a4b |
|
| MD5 | c377974aeb288b13cdd282ff9790c110 |
|
| BLAKE2b-256 | 3a5fd04929ef48af7da4396f913bc7e5acc55d121d62dbdb6bf3d9c67e021276 |
File details
Details for the file azure_iot_device-2.0.0rc3-py2.py3-none-any.whl.
File metadata
- Download URL: azure_iot_device-2.0.0rc3-py2.py3-none-any.whl
- Upload date:
- Size: 45.7 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.0 requests-toolbelt/0.9.1 tqdm/4.31.1 CPython/3.7.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b2ff5fedf2e309d950a1f271f8e77893b019450d5412ade8126a8be6e7aaad50 |
|
| MD5 | 12df88d243e71fa09a900dcf3c04a841 |
|
| BLAKE2b-256 | deda4160ea65d8a62aa66f2951a59ed6547e1934405b79735f95e167d7dbf254 |
