A simple IoTHub sample using HTTP as transport

Dependencies:   EthernetInterface NTPClient iothub_client iothub_http_transport mbed-rtos mbed wolfSSL serializer azure_c_shared_utility

This sample showcases the usage of Azure IoT client libraries with the HTTP transport for sending/receiving raw messages from an IoT Hub.

Committer:
AzureIoTClient
Date:
Tue Mar 20 10:34:44 2018 -0700
Revision:
82:cd9623d73c6b
Parent:
78:4b96969617b3
Child:
89:e4502f210191
1.2.1

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AzureIoTClient 17:3abbcd6aac9f 1 // Copyright (c) Microsoft. All rights reserved.
AzureIoTClient 17:3abbcd6aac9f 2 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
AzureIoTClient 17:3abbcd6aac9f 3
AzureIoTClient 17:3abbcd6aac9f 4 #include <stdlib.h>
AzureIoTClient 17:3abbcd6aac9f 5
AzureIoTClient 17:3abbcd6aac9f 6 #include <stdio.h>
AzureIoTClient 17:3abbcd6aac9f 7 #include <stdint.h>
AzureIoTClient 17:3abbcd6aac9f 8
AzureIoTClient 17:3abbcd6aac9f 9 /* This sample uses the _LL APIs of iothub_client for example purposes.
AzureIoTClient 17:3abbcd6aac9f 10 That does not mean that HTTP only works with the _LL APIs.
AzureIoTClient 17:3abbcd6aac9f 11 Simply changing the using the convenience layer (functions not having _LL)
AzureIoTClient 17:3abbcd6aac9f 12 and removing calls to _DoWork will yield the same results. */
AzureIoTClient 17:3abbcd6aac9f 13
Azure.IoT Build 41:4080293252bc 14 #include "azure_c_shared_utility/threadapi.h"
Azure.IoT Build 41:4080293252bc 15 #include "azure_c_shared_utility/platform.h"
AzureIoTClient 17:3abbcd6aac9f 16 #include "serializer.h"
AzureIoTClient 17:3abbcd6aac9f 17 #include "iothub_client_ll.h"
AzureIoTClient 17:3abbcd6aac9f 18 #include "iothubtransporthttp.h"
AzureIoTClient 17:3abbcd6aac9f 19
AzureIoTClient 17:3abbcd6aac9f 20 #ifdef MBED_BUILD_TIMESTAMP
AzureIoTClient 73:124496f755ab 21 #define SET_TRUSTED_CERT_IN_SAMPLES
AzureIoTClient 73:124496f755ab 22 #endif // MBED_BUILD_TIMESTAMP
AzureIoTClient 73:124496f755ab 23
AzureIoTClient 73:124496f755ab 24 #ifdef SET_TRUSTED_CERT_IN_SAMPLES
AzureIoTClient 17:3abbcd6aac9f 25 #include "certs.h"
AzureIoTClient 73:124496f755ab 26 #endif // SET_TRUSTED_CERT_IN_SAMPLES
AzureIoTClient 17:3abbcd6aac9f 27
AzureIoTClient 19:253a0a1ea1c5 28 /*String containing Hostname, Device Id & Device Key in the format: */
AzureIoTClient 19:253a0a1ea1c5 29 /* "HostName=<host_name>;DeviceId=<device_id>;SharedAccessKey=<device_key>" */
AzureIoTClient 17:3abbcd6aac9f 30 static const char* connectionString = "[device connection string]";
AzureIoTClient 17:3abbcd6aac9f 31
AzureIoTClient 17:3abbcd6aac9f 32 // Define the Model
AzureIoTClient 17:3abbcd6aac9f 33 BEGIN_NAMESPACE(WeatherStation);
AzureIoTClient 17:3abbcd6aac9f 34
AzureIoTClient 17:3abbcd6aac9f 35 DECLARE_MODEL(ContosoAnemometer,
AzureIoTClient 17:3abbcd6aac9f 36 WITH_DATA(ascii_char_ptr, DeviceId),
AzureIoTClient 20:188fd25e65fc 37 WITH_DATA(int, WindSpeed),
AzureIoTClient 64:0cdbc7c1cecc 38 WITH_DATA(float, Temperature),
AzureIoTClient 64:0cdbc7c1cecc 39 WITH_DATA(float, Humidity),
AzureIoTClient 17:3abbcd6aac9f 40 WITH_ACTION(TurnFanOn),
AzureIoTClient 17:3abbcd6aac9f 41 WITH_ACTION(TurnFanOff),
AzureIoTClient 17:3abbcd6aac9f 42 WITH_ACTION(SetAirResistance, int, Position)
AzureIoTClient 17:3abbcd6aac9f 43 );
AzureIoTClient 17:3abbcd6aac9f 44
AzureIoTClient 17:3abbcd6aac9f 45 END_NAMESPACE(WeatherStation);
AzureIoTClient 17:3abbcd6aac9f 46
AzureIoTClient 64:0cdbc7c1cecc 47 static char propText[1024];
AzureIoTClient 17:3abbcd6aac9f 48
AzureIoTClient 17:3abbcd6aac9f 49 EXECUTE_COMMAND_RESULT TurnFanOn(ContosoAnemometer* device)
AzureIoTClient 17:3abbcd6aac9f 50 {
AzureIoTClient 17:3abbcd6aac9f 51 (void)device;
AzureIoTClient 17:3abbcd6aac9f 52 (void)printf("Turning fan on.\r\n");
AzureIoTClient 17:3abbcd6aac9f 53 return EXECUTE_COMMAND_SUCCESS;
AzureIoTClient 17:3abbcd6aac9f 54 }
AzureIoTClient 17:3abbcd6aac9f 55
AzureIoTClient 17:3abbcd6aac9f 56 EXECUTE_COMMAND_RESULT TurnFanOff(ContosoAnemometer* device)
AzureIoTClient 17:3abbcd6aac9f 57 {
AzureIoTClient 17:3abbcd6aac9f 58 (void)device;
AzureIoTClient 17:3abbcd6aac9f 59 (void)printf("Turning fan off.\r\n");
AzureIoTClient 17:3abbcd6aac9f 60 return EXECUTE_COMMAND_SUCCESS;
AzureIoTClient 17:3abbcd6aac9f 61 }
AzureIoTClient 17:3abbcd6aac9f 62
AzureIoTClient 17:3abbcd6aac9f 63 EXECUTE_COMMAND_RESULT SetAirResistance(ContosoAnemometer* device, int Position)
AzureIoTClient 17:3abbcd6aac9f 64 {
AzureIoTClient 17:3abbcd6aac9f 65 (void)device;
AzureIoTClient 17:3abbcd6aac9f 66 (void)printf("Setting Air Resistance Position to %d.\r\n", Position);
AzureIoTClient 17:3abbcd6aac9f 67 return EXECUTE_COMMAND_SUCCESS;
AzureIoTClient 17:3abbcd6aac9f 68 }
AzureIoTClient 17:3abbcd6aac9f 69
AzureIoTClient 17:3abbcd6aac9f 70 void sendCallback(IOTHUB_CLIENT_CONFIRMATION_RESULT result, void* userContextCallback)
AzureIoTClient 17:3abbcd6aac9f 71 {
AzureIoTClient 42:fc9ef8d266b3 72 unsigned int messageTrackingId = (unsigned int)(uintptr_t)userContextCallback;
AzureIoTClient 17:3abbcd6aac9f 73
AzureIoTClient 42:fc9ef8d266b3 74 (void)printf("Message Id: %u Received.\r\n", messageTrackingId);
AzureIoTClient 17:3abbcd6aac9f 75
AzureIoTClient 17:3abbcd6aac9f 76 (void)printf("Result Call Back Called! Result is: %s \r\n", ENUM_TO_STRING(IOTHUB_CLIENT_CONFIRMATION_RESULT, result));
AzureIoTClient 17:3abbcd6aac9f 77 }
AzureIoTClient 17:3abbcd6aac9f 78
AzureIoTClient 17:3abbcd6aac9f 79 static void sendMessage(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, const unsigned char* buffer, size_t size)
AzureIoTClient 17:3abbcd6aac9f 80 {
AzureIoTClient 17:3abbcd6aac9f 81 static unsigned int messageTrackingId;
AzureIoTClient 17:3abbcd6aac9f 82 IOTHUB_MESSAGE_HANDLE messageHandle = IoTHubMessage_CreateFromByteArray(buffer, size);
AzureIoTClient 17:3abbcd6aac9f 83 if (messageHandle == NULL)
AzureIoTClient 17:3abbcd6aac9f 84 {
AzureIoTClient 17:3abbcd6aac9f 85 printf("unable to create a new IoTHubMessage\r\n");
AzureIoTClient 17:3abbcd6aac9f 86 }
AzureIoTClient 17:3abbcd6aac9f 87 else
AzureIoTClient 17:3abbcd6aac9f 88 {
AzureIoTClient 17:3abbcd6aac9f 89 if (IoTHubClient_LL_SendEventAsync(iotHubClientHandle, messageHandle, sendCallback, (void*)(uintptr_t)messageTrackingId) != IOTHUB_CLIENT_OK)
AzureIoTClient 17:3abbcd6aac9f 90 {
AzureIoTClient 17:3abbcd6aac9f 91 printf("failed to hand over the message to IoTHubClient");
AzureIoTClient 17:3abbcd6aac9f 92 }
AzureIoTClient 17:3abbcd6aac9f 93 else
AzureIoTClient 17:3abbcd6aac9f 94 {
AzureIoTClient 17:3abbcd6aac9f 95 printf("IoTHubClient accepted the message for delivery\r\n");
AzureIoTClient 17:3abbcd6aac9f 96 }
AzureIoTClient 17:3abbcd6aac9f 97 IoTHubMessage_Destroy(messageHandle);
AzureIoTClient 17:3abbcd6aac9f 98 }
AzureIoTClient 17:3abbcd6aac9f 99 free((void*)buffer);
AzureIoTClient 17:3abbcd6aac9f 100 messageTrackingId++;
AzureIoTClient 17:3abbcd6aac9f 101 }
AzureIoTClient 17:3abbcd6aac9f 102
AzureIoTClient 17:3abbcd6aac9f 103 /*this function "links" IoTHub to the serialization library*/
AzureIoTClient 17:3abbcd6aac9f 104 static IOTHUBMESSAGE_DISPOSITION_RESULT IoTHubMessage(IOTHUB_MESSAGE_HANDLE message, void* userContextCallback)
AzureIoTClient 17:3abbcd6aac9f 105 {
AzureIoTClient 17:3abbcd6aac9f 106 IOTHUBMESSAGE_DISPOSITION_RESULT result;
AzureIoTClient 17:3abbcd6aac9f 107 const unsigned char* buffer;
AzureIoTClient 17:3abbcd6aac9f 108 size_t size;
AzureIoTClient 17:3abbcd6aac9f 109 if (IoTHubMessage_GetByteArray(message, &buffer, &size) != IOTHUB_MESSAGE_OK)
AzureIoTClient 17:3abbcd6aac9f 110 {
AzureIoTClient 17:3abbcd6aac9f 111 printf("unable to IoTHubMessage_GetByteArray\r\n");
AzureIoTClient 56:99dabe3ce9ff 112 result = IOTHUBMESSAGE_ABANDONED;
AzureIoTClient 17:3abbcd6aac9f 113 }
AzureIoTClient 17:3abbcd6aac9f 114 else
AzureIoTClient 17:3abbcd6aac9f 115 {
AzureIoTClient 17:3abbcd6aac9f 116 /*buffer is not zero terminated*/
AzureIoTClient 17:3abbcd6aac9f 117 char* temp = malloc(size + 1);
AzureIoTClient 17:3abbcd6aac9f 118 if (temp == NULL)
AzureIoTClient 17:3abbcd6aac9f 119 {
AzureIoTClient 17:3abbcd6aac9f 120 printf("failed to malloc\r\n");
AzureIoTClient 56:99dabe3ce9ff 121 result = IOTHUBMESSAGE_ABANDONED;
AzureIoTClient 17:3abbcd6aac9f 122 }
AzureIoTClient 17:3abbcd6aac9f 123 else
AzureIoTClient 17:3abbcd6aac9f 124 {
AzureIoTClient 19:253a0a1ea1c5 125 EXECUTE_COMMAND_RESULT executeCommandResult;
AzureIoTClient 19:253a0a1ea1c5 126
AzureIoTClient 56:99dabe3ce9ff 127 (void)memcpy(temp, buffer, size);
AzureIoTClient 17:3abbcd6aac9f 128 temp[size] = '\0';
AzureIoTClient 19:253a0a1ea1c5 129 executeCommandResult = EXECUTE_COMMAND(userContextCallback, temp);
AzureIoTClient 17:3abbcd6aac9f 130 result =
AzureIoTClient 17:3abbcd6aac9f 131 (executeCommandResult == EXECUTE_COMMAND_ERROR) ? IOTHUBMESSAGE_ABANDONED :
AzureIoTClient 17:3abbcd6aac9f 132 (executeCommandResult == EXECUTE_COMMAND_SUCCESS) ? IOTHUBMESSAGE_ACCEPTED :
AzureIoTClient 17:3abbcd6aac9f 133 IOTHUBMESSAGE_REJECTED;
AzureIoTClient 17:3abbcd6aac9f 134 free(temp);
AzureIoTClient 17:3abbcd6aac9f 135 }
AzureIoTClient 17:3abbcd6aac9f 136 }
AzureIoTClient 17:3abbcd6aac9f 137 return result;
AzureIoTClient 17:3abbcd6aac9f 138 }
AzureIoTClient 17:3abbcd6aac9f 139
AzureIoTClient 17:3abbcd6aac9f 140 void simplesample_http_run(void)
AzureIoTClient 17:3abbcd6aac9f 141 {
Azure.IoT Build 28:44b1d44d0d3b 142 if (platform_init() != 0)
AzureIoTClient 17:3abbcd6aac9f 143 {
Azure.IoT Build 28:44b1d44d0d3b 144 printf("Failed to initialize the platform.\r\n");
AzureIoTClient 17:3abbcd6aac9f 145 }
AzureIoTClient 17:3abbcd6aac9f 146 else
AzureIoTClient 17:3abbcd6aac9f 147 {
Azure.IoT Build 28:44b1d44d0d3b 148 if (serializer_init(NULL) != SERIALIZER_OK)
AzureIoTClient 17:3abbcd6aac9f 149 {
Azure.IoT Build 28:44b1d44d0d3b 150 (void)printf("Failed on serializer_init\r\n");
AzureIoTClient 17:3abbcd6aac9f 151 }
AzureIoTClient 17:3abbcd6aac9f 152 else
AzureIoTClient 17:3abbcd6aac9f 153 {
Azure.IoT Build 28:44b1d44d0d3b 154 IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle = IoTHubClient_LL_CreateFromConnectionString(connectionString, HTTP_Protocol);
Azure.IoT Build 28:44b1d44d0d3b 155 int avgWindSpeed = 10;
AzureIoTClient 64:0cdbc7c1cecc 156 float minTemperature = 20.0;
AzureIoTClient 64:0cdbc7c1cecc 157 float minHumidity = 60.0;
AzureIoTClient 17:3abbcd6aac9f 158
Azure.IoT Build 28:44b1d44d0d3b 159 srand((unsigned int)time(NULL));
Azure.IoT Build 28:44b1d44d0d3b 160
Azure.IoT Build 28:44b1d44d0d3b 161 if (iotHubClientHandle == NULL)
AzureIoTClient 17:3abbcd6aac9f 162 {
Azure.IoT Build 28:44b1d44d0d3b 163 (void)printf("Failed on IoTHubClient_LL_Create\r\n");
AzureIoTClient 17:3abbcd6aac9f 164 }
AzureIoTClient 17:3abbcd6aac9f 165 else
AzureIoTClient 17:3abbcd6aac9f 166 {
Azure.IoT Build 28:44b1d44d0d3b 167 // Because it can poll "after 9 seconds" polls will happen
Azure.IoT Build 28:44b1d44d0d3b 168 // effectively at ~10 seconds.
Azure.IoT Build 28:44b1d44d0d3b 169 // Note that for scalabilty, the default value of minimumPollingTime
Azure.IoT Build 28:44b1d44d0d3b 170 // is 25 minutes. For more information, see:
Azure.IoT Build 28:44b1d44d0d3b 171 // https://azure.microsoft.com/documentation/articles/iot-hub-devguide/#messaging
Azure.IoT Build 28:44b1d44d0d3b 172 unsigned int minimumPollingTime = 9;
Azure.IoT Build 28:44b1d44d0d3b 173 ContosoAnemometer* myWeather;
Azure.IoT Build 28:44b1d44d0d3b 174
Azure.IoT Build 28:44b1d44d0d3b 175 if (IoTHubClient_LL_SetOption(iotHubClientHandle, "MinimumPollingTime", &minimumPollingTime) != IOTHUB_CLIENT_OK)
AzureIoTClient 17:3abbcd6aac9f 176 {
Azure.IoT Build 28:44b1d44d0d3b 177 printf("failure to set option \"MinimumPollingTime\"\r\n");
Azure.IoT Build 28:44b1d44d0d3b 178 }
Azure.IoT Build 28:44b1d44d0d3b 179
AzureIoTClient 73:124496f755ab 180 #ifdef SET_TRUSTED_CERT_IN_SAMPLES
Azure.IoT Build 28:44b1d44d0d3b 181 // For mbed add the certificate information
Azure.IoT Build 28:44b1d44d0d3b 182 if (IoTHubClient_LL_SetOption(iotHubClientHandle, "TrustedCerts", certificates) != IOTHUB_CLIENT_OK)
Azure.IoT Build 28:44b1d44d0d3b 183 {
Azure.IoT Build 28:44b1d44d0d3b 184 (void)printf("failure to set option \"TrustedCerts\"\r\n");
Azure.IoT Build 28:44b1d44d0d3b 185 }
AzureIoTClient 73:124496f755ab 186 #endif // SET_TRUSTED_CERT_IN_SAMPLES
Azure.IoT Build 28:44b1d44d0d3b 187
Azure.IoT Build 28:44b1d44d0d3b 188 myWeather = CREATE_MODEL_INSTANCE(WeatherStation, ContosoAnemometer);
Azure.IoT Build 28:44b1d44d0d3b 189 if (myWeather == NULL)
Azure.IoT Build 28:44b1d44d0d3b 190 {
Azure.IoT Build 28:44b1d44d0d3b 191 (void)printf("Failed on CREATE_MODEL_INSTANCE\r\n");
AzureIoTClient 17:3abbcd6aac9f 192 }
AzureIoTClient 17:3abbcd6aac9f 193 else
AzureIoTClient 17:3abbcd6aac9f 194 {
Azure.IoT Build 28:44b1d44d0d3b 195 if (IoTHubClient_LL_SetMessageCallback(iotHubClientHandle, IoTHubMessage, myWeather) != IOTHUB_CLIENT_OK)
AzureIoTClient 17:3abbcd6aac9f 196 {
Azure.IoT Build 28:44b1d44d0d3b 197 printf("unable to IoTHubClient_SetMessageCallback\r\n");
Azure.IoT Build 28:44b1d44d0d3b 198 }
Azure.IoT Build 28:44b1d44d0d3b 199 else
Azure.IoT Build 28:44b1d44d0d3b 200 {
Azure.IoT Build 28:44b1d44d0d3b 201 myWeather->DeviceId = "myFirstDevice";
Azure.IoT Build 28:44b1d44d0d3b 202 myWeather->WindSpeed = avgWindSpeed + (rand() % 4 + 2);
AzureIoTClient 64:0cdbc7c1cecc 203 myWeather->Temperature = minTemperature + (rand() % 10);
AzureIoTClient 64:0cdbc7c1cecc 204 myWeather->Humidity = minHumidity + (rand() % 20);
AzureIoTClient 17:3abbcd6aac9f 205 {
Azure.IoT Build 28:44b1d44d0d3b 206 unsigned char* destination;
Azure.IoT Build 28:44b1d44d0d3b 207 size_t destinationSize;
AzureIoTClient 64:0cdbc7c1cecc 208 if (SERIALIZE(&destination, &destinationSize, myWeather->DeviceId, myWeather->WindSpeed, myWeather->Temperature, myWeather->Humidity) != CODEFIRST_OK)
AzureIoTClient 17:3abbcd6aac9f 209 {
Azure.IoT Build 28:44b1d44d0d3b 210 (void)printf("Failed to serialize\r\n");
AzureIoTClient 17:3abbcd6aac9f 211 }
AzureIoTClient 17:3abbcd6aac9f 212 else
AzureIoTClient 17:3abbcd6aac9f 213 {
Azure.IoT Build 28:44b1d44d0d3b 214 IOTHUB_MESSAGE_HANDLE messageHandle = IoTHubMessage_CreateFromByteArray(destination, destinationSize);
Azure.IoT Build 28:44b1d44d0d3b 215 if (messageHandle == NULL)
AzureIoTClient 17:3abbcd6aac9f 216 {
Azure.IoT Build 28:44b1d44d0d3b 217 printf("unable to create a new IoTHubMessage\r\n");
AzureIoTClient 17:3abbcd6aac9f 218 }
AzureIoTClient 17:3abbcd6aac9f 219 else
AzureIoTClient 17:3abbcd6aac9f 220 {
AzureIoTClient 64:0cdbc7c1cecc 221 MAP_HANDLE propMap = IoTHubMessage_Properties(messageHandle);
AzureIoTClient 64:0cdbc7c1cecc 222 (void)sprintf_s(propText, sizeof(propText), myWeather->Temperature > 28 ? "true" : "false");
AzureIoTClient 64:0cdbc7c1cecc 223 if (Map_AddOrUpdate(propMap, "temperatureAlert", propText) != MAP_OK)
AzureIoTClient 64:0cdbc7c1cecc 224 {
AzureIoTClient 64:0cdbc7c1cecc 225 printf("ERROR: Map_AddOrUpdate Failed!\r\n");
AzureIoTClient 64:0cdbc7c1cecc 226 }
AzureIoTClient 64:0cdbc7c1cecc 227
Azure.IoT Build 28:44b1d44d0d3b 228 if (IoTHubClient_LL_SendEventAsync(iotHubClientHandle, messageHandle, sendCallback, (void*)1) != IOTHUB_CLIENT_OK)
Azure.IoT Build 28:44b1d44d0d3b 229 {
Azure.IoT Build 28:44b1d44d0d3b 230 printf("failed to hand over the message to IoTHubClient");
Azure.IoT Build 28:44b1d44d0d3b 231 }
Azure.IoT Build 28:44b1d44d0d3b 232 else
Azure.IoT Build 28:44b1d44d0d3b 233 {
Azure.IoT Build 28:44b1d44d0d3b 234 printf("IoTHubClient accepted the message for delivery\r\n");
Azure.IoT Build 28:44b1d44d0d3b 235 }
AzureIoTClient 17:3abbcd6aac9f 236
Azure.IoT Build 28:44b1d44d0d3b 237 IoTHubMessage_Destroy(messageHandle);
Azure.IoT Build 28:44b1d44d0d3b 238 }
Azure.IoT Build 28:44b1d44d0d3b 239 free(destination);
AzureIoTClient 17:3abbcd6aac9f 240 }
Azure.IoT Build 28:44b1d44d0d3b 241 }
Azure.IoT Build 28:44b1d44d0d3b 242
Azure.IoT Build 28:44b1d44d0d3b 243 /* wait for commands */
Azure.IoT Build 28:44b1d44d0d3b 244 while (1)
Azure.IoT Build 28:44b1d44d0d3b 245 {
Azure.IoT Build 28:44b1d44d0d3b 246 IoTHubClient_LL_DoWork(iotHubClientHandle);
Azure.IoT Build 28:44b1d44d0d3b 247 ThreadAPI_Sleep(100);
AzureIoTClient 17:3abbcd6aac9f 248 }
AzureIoTClient 17:3abbcd6aac9f 249 }
AzureIoTClient 17:3abbcd6aac9f 250
Azure.IoT Build 28:44b1d44d0d3b 251 DESTROY_MODEL_INSTANCE(myWeather);
AzureIoTClient 17:3abbcd6aac9f 252 }
Azure.IoT Build 28:44b1d44d0d3b 253 IoTHubClient_LL_Destroy(iotHubClientHandle);
AzureIoTClient 17:3abbcd6aac9f 254 }
Azure.IoT Build 28:44b1d44d0d3b 255 serializer_deinit();
AzureIoTClient 17:3abbcd6aac9f 256 }
Azure.IoT Build 28:44b1d44d0d3b 257 platform_deinit();
AzureIoTClient 17:3abbcd6aac9f 258 }
AzureIoTClient 17:3abbcd6aac9f 259 }