Stop! Before you proceed:

This Get Started Guide is an older version and it is neither maintained nor supported anymore.

It is kept here for reference only and should not be used for any new development.

If you’re looking for a Get Started guide to the Espressif ESP32 there are two alternatives available:

1. Azure IoT SDK for C which uses a bare metal approach (no RTOS) and support for Arduino IDE.
2. Azure IoT middleware for FreeRTOS which uses ESP-IDF.

ESP32_AzureIoT - Azure IoT Hub library for esp32 devices in Arduino

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

Currently supported hardware

• ESP32 based boards with esp32/arduino
  • M5Stack

It should also work for other esp32 boards.

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.8.5

SimpleMQTT and GetStarted Instructions

1. Install esp32 board support into your Arduino IDE.

   • Start Arduino and open Preferences window.
   • Enter esp32 package URL https://dl.espressif.com/dl/package_esp32_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 esp32 platform.
   • Select your esp32 board from Tools > Board menu after installation

2. Open the SimpleMQTT or GetStartedexample from the Arduino IDE File->Examples->ESP32 Azure IoT Arduino.

3. Update Wifi SSID/Password and IoT Hub Connection string in ino file

   • 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 Get Started tutorial to learn more about how to get started with physical devices.

Contributing

There are a couple of ways you can contribute to this repo:

• Ideas, feature requests and bugs: We are open to all ideas and we want to get rid of bugs! Use the Issues section to either report a new issue, provide your ideas or contribute to existing threads.
• Documentation: Found a typo or strangely worded sentences? Submit a PR!
• Code: Contribute bug fixes, features or design changes.

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

Code of Conduct

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.

License

See LICENSE file.