Microsoft Azure IoT SDKs

This repository contains both IoT device SDKs and IoT service SDKs. Device SDKs enable you connect client devices to Azure IoT Hub. Service SDKs enable you to manage your IoT Hub service instance.

Visit http://azure.com/iotdev to learn more about developing applications for Azure IoT.

Microsoft Azure IoT device SDKs

The Microsoft Azure IoT device SDKs contain code that facilitate building devices and applications that connect to and are managed by Azure IoT Hub services.

Devices and data sources in an IoT solution can range from a simple network-connected sensor to a powerful, standalone computing device. Devices may have limited processing capability, memory, communication bandwidth, and communication protocol support. The IoT device SDKs enable you to implement client applications for a wide variety of devices.

This repository contains the following IoT device SDKs:

• Azure IoT device SDK for C
• Azure IoT device SDK for Node.js
• Azure IoT device SDK for Java
• Azure IoT device SDK for .NET
• Azure IoT device SDK for Python

Each language SDK includes sample code and documentation in addition to the library code. The API reference documentation is here.

OS platforms and hardware compatibility

Azure IoT device SDKs can be used with a broad range of OS platforms and devices. The minimum requirements are for the device platform to support the following:

• Being capable of establishing an IP connection: only IP-capable devices can communicate directly with Azure IoT Hub.
• Support TLS: required to establish a secure communication channel with Azure IoT Hub.
• Support SHA-256: necessary to generate the secure token for authenticating the device with the service.
• Have a Real Time Clock or implement code to connect to an NTP server: necessary for both establishing the TLS connection and generating the secure token for authentication.
• Having at least 64KB of RAM: the memory footprint of the SDK depends on the SDK and protocol used as well as the platform targeted. The smallest footprint is achieved using the C SDK targeting microcontrollers.

You can find an exhaustive list of the OS platforms the various SDKs have been tested against on our OS Platforms and hardware compatibility page. Note that you might still be able to use the SDKs on OS and hardware platforms that are not listed on this page: all the SDKs are open sourced and designed to be portable. If you have suggestions, feedback or issues to report, refer to the Contribution and Support sections below.

Microsoft Azure IoT service SDKs

The Azure IoT Service SDKs help you to build applications that interact with your devices and manage device identities in your IoT hub.

• Azure IoT service SDK for .Net
• Azure IoT service SDK for Node.js
• Azure IoT service SDK for Java

Samples

Whithin the repository, you can find various types of simple samples that can help you get started. Below is a complete list of all these simple samples. In addition to these simple samples, you can find a long list of getting started guides that describe all the steps necessary to run the simple samples on a wide variety of devices and platforms. And if you are looking for end to end samples that show how to do simple analytics and processing of the data generated by your device using Azure services such as Stream Analytics, Big Data, Machine Learning and others, check out our E2E samples gallery.

• C device SDK:
  • Simple sample using AMQP: shows how to connect to IoT Hub and send and receive serialized messages using the AMQP protocol and the serializer utility.
  • Simple sample using HTTP: shows how to connect to IoT Hub and send and receive serialized messages using the HTTP protocol and the serializer utility.
  • Simple sample using MQTT: shows how to connect to IoT Hub and send and receive serialized messages using the MQTT protocol and the serializer utility.
  • Temperature sensor anomaly sample: shows a simple application that sends temperature data to IoT Hub and receives alarms, using real data when running on an MBED board and simulated data when run on Windows.
  • Azure IoT Suite Remote Monitoring device sample: shows how to connect a device to an Azure IoT Suite Remote Monitoring preconfigured solution.
• C# device SDK:
  • Simple .Net sample using AMQP: Shows how to connect to IoT Hub and send and receive raw messages using the AMQP protocol.
  • Simple .Net sample using HTTP: Shows how to connect to IoT Hub and send and receive raw messages using the HTTP protocol.
  • Simple .Net sample using MQTT: Shows how to connect to IoT Hub and send and receive raw messages using the MQTT protocol.
  • Simple UWP C++ sample: Shows how to connect to IoT Hub and send and receive raw messages in a C++ UWP application.
  • Simple UWP JS sample: Shows how to connect to IoT Hub and send and receive raw messages in a JavaScript UWP application.
  • Simple UWP C# sample: Shows how to connect to IoT Hub and send and receive raw messages in a C# UWP application.
  • Simple .Net Micro Framework 4.3 sample: Shows how to connect to IoT Hub and send and receive raw messages from a device running .Net Micro Framework 4.3.
  • Simple .Net Micro Framework 4.2 sample: Shows how to connect to IoT Hub and send and receive raw messages from a device running .Net Micro Framework 4.2.
• Java device SDK:
  • Simple send sample: Shows how to connect and send messages to IoT Hub, passing the protocol of your choices as a parameter.
  • Simple send/receive sample: Shows how to connect then send and receive messages to and from IoT Hub, passing the protocol of your choices as a parameter.
  • Simple send serialized messages sample: Shows how to connect and send serialized messages to IoT Hub, passing the protocol of your choices as a parameter.
  • Simple sample handling messages received: : Shows how to connect to IoT Hub and manage messages received from IoT Hub, passing the protocol of your choices as a parameter.
• Java service SDK:
  • Device manager sample: Shows how to work with the device ID registry of IoT Hub.
  • Service client sample: Shows how to send Cloud to Device messages through IoT Hub.
• Node device SDK:
  • Simple device sample: Shows how to connect to IoT Hub and send and receive messages using Node.js on a device.
  • Send batch: Shows how to connect to IoT Hub and send a batch of messages using Node.js on a device.
  • Azure IoT Suite Remote Monitoring device sample: Shows how to connect a device runnig Node.js to an Azure IoT Suite remote Monitoring preconfigured solution.
• Node service SDK:
  • Registry manager simple sample: Shows how to manage the device ID registry of IoT Hub from a Node.js application.
  • Bulk Registry sample: Shows how to create a set of device IDs in the device ID registry of IoT Hub in bulk from a Node.js application.
  • Simple Cloud to Device messaging sample : Shows how to send messages to a device from a Node.js application through IoT Hub.
• Python device SDK:
  • Simple Sample: shows how to connect to IoT Hub and send and receive messages using the AMQP, MQTT or HTTP protocol.
  • Class Sample using AMQP: shows how to connect to IoT Hub with a HubManager class to send and receive messages using the AMQP protocol.

Contribution, feedback and issues

If you encounter any bugs, have suggestions for new features or if you would like to become an active contributor to this project please follow the instructions provided in the contribution guidelines.

Support

If you are having issues using one of the packages or using the Azure IoT Hub service that go beyond simple bug fixes or help requests that would be dealt within the issues section of this project, the Microsoft Customer Support team will try and help out on a best effort basis. To engage Microsoft support, you can create a support ticket directly from the Azure portal. Escalated support requests for Azure IoT Hub SDKs development questions will only be available Monday thru Friday during normal coverage hours of 6 a.m. to 6 p.m. PST. Here is what you can expect Microsoft Support to be able to help with:

• Client SDKs issues: If you are trying to compile and run the libraries on a supported platform, the Support team will be able to assist with troubleshooting or questions related to compiler issues and communications to and from the IoT Hub. They will also try to assist with questions related to porting to an unsupported platform, but will be limited in how much assistance can be provided. The team will be limited with trouble-shooting the hardware device itself or drivers and or specific properties on that device.
• IoT Hub / Connectivity Issues: Communication from the device client to the Azure IoT Hub service and communication from the Azure IoT Hub service to the client. Or any other issues specifically related to the Azure IoT Hub.
• Portal Issues: Issues related to the portal, that includes access, security, dashboard, devices, Alarms, Usage, Settings and Actions.
• REST/API Issues: Using the IoT Hub REST/APIs that are documented in the documentation.

Additional resources

In addition to the language SDKs, this repository (azure-iot-sdks) contains the following folders:

/build

This folder contains various build scripts to build the libraries.

/doc

This folder contains the following documents that are relevant to all the language SDKs:

• Set up IoT Hub describes how to configure your Azure IoT Hub service.
• Manage IoT Hub describes how to provision devices in your Azure IoT Hub service.
• FAQ contains frequently asked questions about the SDKs and libraries.
• OS Platforms and hardware compatibility describes the SDK compatibility with different OS platforms as well as specific device configurations.

/tools

This folder contains tools you will find useful when you are working with IoT Hub and the device SDKs.

• iothub-explorer: describes how to use the iothub-explorer node.js tool to provision a device for use in IoT Hub, monitor the messages from the device, and send commands to the device.
• Device Explorer: this tool enables you to perform operations such as manage the devices registered to an IoT hub, view device-to-cloud messages sent to an IoT hub, and send cloud-to-device messages from an IoT hub. Note this tool only runs on Windows.