README_template.md

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.

{{title}}

Contributors

Pull request caution!

All of the files in these Arduino library directories are auto-generated by the Azure IoT C SDK release process, so pull requests cannot be accepted in this repo. Your Arduino-specific contributions will be welcomed with open arms in these locations:

• AzureIoTHub Arduino-specific sources
• AzureIoTProtocol_HTTP sources
• AzureIoTProtocol_MQTT Arduino-specific sources
• AzureIoTUtility Arduino-specific sources

Contributions for code that is not Arduino-specific can be made to the Azuure IoT C SDK

Currently supported hardware

• Atmel SAMD Based boards
  • 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.12
• Install the AzureIoTHub library via the Arduino IDE Library Manager
• Install the AzureIoTUtility library via the Arduino IDE Library Manager
• Install the AzureIoTProtocol_{{protocol_uc}} library via the Arduino IDE Library Manager

Simple Sample Instructions

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_{{protocol_lc}} example from the Arduino IDE File->AzureIoTHub->ESP8266->Examples menu.

3. Update Wifi SSID/Password and IoT Hub Connection string in iot_configs.h

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

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

5. 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 Arduino SAMD Boards and Adafruit SAMD Boards 1.0.7 or later.
   • Select your Adafruit Feather M0 from Tools > Board menu after installation
2. Install the WiFi101 library from the Arduino IDE Library Manager.
3. Install the RTCZero library from the Arduino IDE Library Manager.
4. Open the simplesample_{{protocol_lc}} example from the Arduino IDE File->AzureIoTHub->M0->Examples menu.
5. Update Wifi SSID/Password and IoT Hub Connection string in iot_configs.h
   • Ensure you are using a wifi network that does not require additional manual steps after connection, such as opening a web browser.
6. Access the Feather M0 WiFi Get Started tutorial to learn more about Microsoft Feather M0 WiFi Dev Kit.

License

See LICENSE file.