Microsoft Docs

Your destination for all documentation, tutorials, and guides.

Azure IoT Hub with Windows IoT

This guide explores how to integrate Windows IoT devices with Azure IoT Hub, enabling seamless cloud connectivity, data management, and device control.

Introduction to Azure IoT Hub

Azure IoT Hub is a fully managed service that enables reliable and secure bidirectional communication between millions of Internet of Things (IoT) devices and a cloud-hosted back end. It provides device management capabilities, message routing, and integration with other Azure services.

Connecting Windows IoT to IoT Hub

The process involves provisioning your Windows IoT device and then configuring it to communicate with your IoT Hub instance. Here's a high-level overview:

  • Provisioning an IoT Hub: Create an IoT Hub instance in the Azure portal. You'll receive a connection string that your device will use.
  • Registering your device: Add your specific Windows IoT device as an identity within your IoT Hub. This grants it unique credentials.
  • Device SDK Integration: Utilize the Azure IoT SDKs for Windows IoT (available for C#, C++, and Node.js) to establish a connection and send/receive messages.

Key Concepts

  • Device Twins: A JSON document representing the state of your device, including desired properties and reported properties.
  • Direct Methods: Invokes a method on a specific device for direct command-and-control scenarios.
  • Device-to-Cloud Telemetry: Sending sensor data and other operational information from your device to IoT Hub.
  • Cloud-to-Device Messaging: Sending commands or data from the cloud back to your device.

Code Examples (C#)

Here's a simplified example demonstrating how to send a telemetry message from a Windows IoT device using the Azure IoT SDK:


using System;
using System.Text;
using System.Threading.Tasks;
using Microsoft.Azure.Devices.Client;

public class TelemetrySender
{
    static DeviceClient deviceClient;
    static string iotHubUri = "{your_iot_hub_uri}";
    static string deviceKey = "{your_device_key}";

    public static async Task SendDeviceToCloudMessagesAsync()
    {
        string deviceId = "{your_device_id}";
        string deviceConnectionString = $"HostName={iotHubUri};DeviceId={deviceId};SharedAccessKey={deviceKey}";

        deviceClient = DeviceClient.CreateFromConnectionString(deviceConnectionString, TransportType.Mqtt);

        Console.WriteLine("Sending messages to IoT Hub...");

        while (true)
        {
            string messageBody = $"{{ \"messageId\": {Guid.NewGuid()}, \"temperature\": {23.45}, \"humidity\": {56.78} }}";
            var message = new Message(Encoding.UTF8.GetBytes(messageBody));

            await deviceClient.SendEventAsync(message);
            Console.WriteLine($"\t{DateTime.UtcNow}: Sent message - {messageBody}");

            await Task.Delay(1000);
        }
    }

    // Add Main method to call SendDeviceToCloudMessagesAsync()
}

Troubleshooting and Best Practices

Ensure proper error handling, secure storage of credentials, and efficient message batching for optimal performance and reliability.

Next Steps

Explore the official Azure IoT documentation for advanced scenarios like device twins, direct methods, and integration with Azure services like Azure Stream Analytics and Azure Functions.