This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
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. Please submit any contribution directly to azure-iot-sdks.
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 - Install the
AzureIoTUtility
library via the Arduino IDE Library Manager - Install the
AzureIoTProtocol_MQTT
library via the Arduino IDE Library Manager
Simple Sample Instructions
MKR1000 or Zero + Wifi101
- Open the
simplesample_http
example from the Arduino IDE File->Examples->AzureIoTHub menu. - Install the
WiFi101
library from the Arduino IDE Library Manager. - Install the
NTPClient
library from the Arduino IDE Library Manager. - Install the
RTCZero
library from the Arduino IDE Library Manager. - 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.
- Update IoT Hub Connection string in simplesample_http.c
ESP8266
Sparkfun Thing, Adafruit Feather Huzzah, or generic ESP8266 board
-
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
-
Open the
simplesample_http
example from the Arduino IDE File->Examples->AzureIoTHub menu. -
Update the sketch as directed by comments in the sample to support the ESP8266 board.
-
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.
-
Update IoT Hub Connection string in simplesample_http.c
-
Access the SparkFun Get Started tutorial to learn more about Microsoft Sparkfun Dev Kit.
-
Access the Huzzah Get Started tutorial to learn more about Microsoft Huzzah Dev Kit.
Adafruit Feather M0
- 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
- Install the Adafruit WINC1500 wifi library
- Install the
RTCZero
library from the Arduino IDE Library Manager. - Install the
NTPClient
library from the Arduino IDE Library Manager. - Open the
simplesample_http
example from the Arduino IDE File->Examples->AzureIoTHub menu. - Update the sketch as directed by comments in the sample to support the ESP8266 board.
- 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.
- Update IoT Hub Connection string in simplesample_http.c
- Access the Feather M0 WiFi Get Started tutorial to learn more about Microsoft Feather M0 WiFi Dev Kit.
License
See LICENSE file.