farukc/AzureIoTHub

Azure IoT library for the Arduino

AzureIoTHub - Azure IoT Hub library for Arduino

This library is a port of the Microsoft Azure IoT device SDK for C to Arduino. It allows you to use several Arduino compatible boards with Azure IoT Hub.

Currently supported hardware:

• Atmel SAMD Based boards
  • Arduino/Genuino MKR1000
  • Arduino/Genuino Zero and WiFi Shield 101
  • Adafruit Feather M0
• ESP8266 based boards with esp8266/arduino
  • SparkFun Thing
  • Adafruit Feather Huzzah

Prerequisites

You should have the following ready before beginning with any board:

• Setup your IoT hub
• Provision your device and get its credentials
• Arduino IDE 1.6.8
• Install the AzureIoTHub library via the Arduino IDE Library Manager

Simple Sample Instructions

MKR1000 or Zero + Wifi101

1. Open the simplesample_http example from the Arduino IDE File->Examples->AzureIoTHub menu.
2. Install the WiFi101 library from the Arduino IDE Library Manager.
3. Install the NTPClient library from the Arduino IDE Library Manager.
4. Install the RTCZero library from the Arduino IDE Library Manager.
5. Update Wifi SSID/Password in simplesample_http.ino
   • Ensure you are using a wifi network that does not require additional manual steps after connection, such as opening a web browser.
6. Update IoT Hub Connection string in simplesample_http.c

ESP8266

Sparkfun Thing, Adafruit Feather Huzzah, or generic ESP8266 board

1. Install esp8266 board support into your Arduino IDE.

   • Start Arduino and open Preferences window.
   • Enter http://arduino.esp8266.com/stable/package_esp8266com_index.json into Additional Board Manager URLs field. You can add multiple URLs, separating them with commas.
   • Open Boards Manager from Tools > Board menu and install esp8266 platform 2.2.0 or later
   • Select your ESP8266 board from Tools > Board menu after installation

2. Open the simplesample_http example from the Arduino IDE File->Examples->AzureIoTHub menu.

3. Update the sketch as directed by comments in the sample to support the ESP8266 board.

4. Update Wifi SSID/Password in simplesample_http.ino

   • Ensure you are using a wifi network that does not require additional manual steps after connection, such as opening a web browser.

5. Update IoT Hub Connection string in simplesample_http.c

Adafruit Feather M0

1. Install Feather M0 board support into your Arduino IDE.
   • Start Arduino and open Preferences window.
   • Enter https://adafruit.github.io/arduino-board-index/package_adafruit_index.json into Additional Board Manager URLs field. You can add multiple URLs, separating them with commas.
   • Open Boards Manager from Tools > Board menu and install Adafruit SAMD Boards 1.0.7 or later.
   • Select your Adafruit Feather M0 from Tools > Board menu after installation
2. Install the Adafruit WINC1500 wifi library
3. Install the RTCZero library from the Arduino IDE Library Manager.
4. Install the NTPClient library from the Arduino IDE Library Manager.
5. Open the simplesample_http example from the Arduino IDE File->Examples->AzureIoTHub menu.
6. Update the sketch as directed by comments in the sample to support the ESP8266 board.
7. Update Wifi SSID/Password in simplesample_http.ino
   • Ensure you are using a wifi network that does not require additional manual steps after connection, such as opening a web browser.
8. Update IoT Hub Connection string in simplesample_http.c

License

See LICENSE file.