ESP Azure IoT SDK
Table of Contents
The ESP Azure IoT SDK is based on Azure IoT C SDK and enables users to connect their ESP32 based devices to the Azure IoT hub. It provides some examples which can help understand most common use cases.
You will basically just need a development host and an ESP32 development board to get started.
Development Host Setup
This project is to be used with Espressif's IoT Development Framework, ESP IDF. Follow these steps to get started:
- Setup ESP IDF development environment by following the steps here.
- In a separate folder, clone the esp-azure project as follows (please note the --recursive option, which is required to clone the various git submodules required by esp-azure)
$ git clone --recursive https://github.com/espressif/esp-azure.git
Note that if you ever change the branch or the git head of either esp-idf or esp-azure, ensure that all the submodules of the git repo are in sync by executing
git submodule update --init --recursive
Setting up Azure IoT Hub
- Create an Azure IoT Hub by following the documentation here.
Note: When selecting the "Pricing and scale tier", there is also an option to select , F1: Free tier, which should be sufficient for basic evaluation.
- Copy the IoT Hub
Connection string - primary keyfrom the Azure IoT Hub. This will be required later. The screenshot below will help you locate it.
- Connection string - primary key sample:
Setting up Azure CLI
- Install Azure CLI
- From your terminal, execute the
azcommand to verify that the installation was successful. Output will be like this:
$ az Welcome to Azure CLI! --------------------- Use `az -h` to see available commands or go to https://aka.ms/cli. ...
- Install the Azure IoT CLI extension using
$ az extension add --name azure-cli-iot-ext
After that, you should be able to use azure CLI to manage your iot-device. A list of useful Azure CLIs can be found here
Creating an Azure IoT Device
- Login to Azure CLI using
$ az login
- Create a new device using
$ az iot hub device-identity create -n [IoTHub Name] -d [Device ID]
- Get connection string for your device using
$ az iot hub device-identity show-connection-string -n [IoTHub Name] -d [Device ID]
- Device connection string sample:
- This will be required in the examples
To see various events and the data being exchanged between the device and IoT hub from your command line, run the following command:
$ az iot hub monitor-events -n [IoTHub Name] --login '[Connection string - primary key]'
Note the single quotes for the connection string. Without them, the command wont work as desired.
To monitor activity on your ESP device, run:
$ make monitor
Some common problems can be fixed by disabling the firewall.
You can try with the followings, if your build fails:
$ git submodule update --init --recursive
- Check the compiler version and verify that it is the correct one for your ESP IDF version.
- Check if the IDF_PATH is set correctly
- Clean the project with
make cleanand if required, using
rm -rf build sdkconfig sdkconfig.old
Ensure that the device connection string received from Azure IoT Hub are correct.