JeeWeetje/azure-iot-arduino-protocol-mqtt

Azure IoT MQTT Protocol library for Arduino

AzureIoTProtocol_MQTT - Azure IoT MQTT protocol library for Arduino

This library is a port of the compact implementation of the MQTT protocol from Microsoft Azure IoT device SDK for C to Arduino. Together with the AzureIoTHub, 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

1. Open the simplesample_mqtt 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_mqtt.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_mqtt.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_mqtt 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_mqtt.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_mqtt.c

6. Access the SparkFun Get Started tutorial to learn more about Microsoft Sparkfun Dev Kit.

7. Access the Huzzah Get Started tutorial to learn more about Microsoft Huzzah Dev Kit.

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_mqtt 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_mqtt.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_mqtt.c
9. Access the Feather M0 WiFi Get Started tutorial to learn more about Microsoft Feather M0 WiFi Dev Kit.

License

See LICENSE file.