Azure IoT SDK with QCS610 SoC

The main objective of this application is to get familiar with the QCS610 SoC and the Azure IoT SDK. It is designed to integrate the Azure IoT SDK with the development kit, control the camera recording, and send the status of camera recording to Azure IoT-hub.

1. Ubuntu System 18.04 or above
2. Install ADB tool (Android debugging bridge) on host system
3. Valid Microsoft Azure user account
4. Install python3.5 or above on the host system

1. Building the camera application:

Step-1 : Enter below command to set up the cross-compilation environment on the host system.

$ git clone <source repository>
$ cd <source repository>
$ source /usr/local/oecore-x86_64/environment-setup-armv7ahf-neon-oe
-linux-gnueabi


Step-2 : Build the camera application binary using command below. Note: before you start building, to add secure communication open the main.c file and replace the connection string details with device primary connection string.

$CC main.c video_record.c -o iottest `pkg-config --cflags --libs gstreamer-1.0` -I
./azureiot/ -L ./lib -liothub_client -laziotsharedutil -liothub_client_mqtt_transport -
liothub_client_amqp_transport -luamqp -lumqtt -lparson

Step-3 : Initialize the target board with root access.

$ adb root
$ adb remount
$ adb shell mount -o remount,rw /
$ adb forward tcp:8900 tcp:8900

Step-4 : Push the application binary and Azure IoT shared library to the target board with adb command.

$ adb push iottest /data/azure/
$ adb push lib/ /data/azure/
2. Execute the binary file in the target environment.

To start the application, run the below commands on the QCS610 board,

$ adb shell
/#

To enable Wi-Fi connectivity on target board

/# wpa_supplicant -Dnl80211 -iwlan0 -c /etc/misc/wifi/wpa_supplicant
.conf -ddddt &
/# dhcpcd wlan0


Export the shared library to the LD_LIBRARY_PATH

/ # export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/data/azure/lib/
/# cd data/azure/

To start the application run below command

/# ./iottest

Once the above command is executed, the platform is designed to wait for the command from the IoT hub and take the required action.

3. Event monitoring on Azure IoT hub,

Open the new terminal on the host system
Install azure cli on host system

$ curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash

Login to azure

$ az login

This will open the default browser, and you can enter your login credentials. After login, following command can be used to monitor the device messages.

$ az iot hub monitor-events --hub-name <iot hub name> --device-id <devicename>
4. For sending command from IoT hub to device

Open the new terminal on the host system and traverse to the repo directory. Edit the cloud2device.py file and replace the ‘CONNECTION_STRING’ details with IoT hub primary connection string and replace the ‘DEVICE_ID’ details with device name.

Install ‘azure iot-hub' on the host device.

$ pip install azure-iot-hub

Execute the python script and send the commands via command line option

To start the video streaming on the QCS610 development kit.

$ python3 cloud2device.py starttcp

To stop the current streaming on the QCS610 development kit.

$ python3 cloud2device.py stoptcp

Once the development kit receives the command, it will start streaming the video. It will also send the camera status to the IoT hub, and the message can be shown on the event monitoring terminal.

To see the live streaming, open the new terminal in the host system and enter the below command. Also make sure you have installed the ‘vlc player’ on the host system in order to view video playback.

$ adb forward tcp:8900 tcp:8900
$ vlc -vvv tcp://127.0.0.1:8900