Azure IoT / Mbed 2 deprecated iothub_client_sample_http

IoTHub raw messaging sample using HTTP

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

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

iothub_client_sample_http.c@83:2911682db006, 2018-01-17 (annotated)

Committer:
AzureIoTClient
Date:
Wed Jan 17 08:59:48 2018 -0800
Revision:
83:2911682db006
Parent:
82:031681808c6a 
1.1.30

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AzureIoTClient 18:e3e29fc771c9 1 // Copyright (c) Microsoft. All rights reserved.
AzureIoTClient 18:e3e29fc771c9 2 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
AzureIoTClient 18:e3e29fc771c9 3
AzureIoTClient 18:e3e29fc771c9 4 #include <stdio.h>
AzureIoTClient 18:e3e29fc771c9 5 #include <stdlib.h>
AzureIoTClient 18:e3e29fc771c9 6
AzureIoTClient 18:e3e29fc771c9 7 /* This sample uses the _LL APIs of iothub_client for example purposes.
AzureIoTClient 41:7a930aa6dc01 8 That does not mean that HTTP only works with the _LL APIs.
AzureIoTClient 41:7a930aa6dc01 9 Simply changing the using the convenience layer (functions not having _LL)
AzureIoTClient 41:7a930aa6dc01 10 and removing calls to _DoWork will yield the same results. */
AzureIoTClient 18:e3e29fc771c9 11
Azure.IoT Build 46:91bd03862871 12 #include "azure_c_shared_utility/threadapi.h"
Azure.IoT Build 46:91bd03862871 13 #include "azure_c_shared_utility/crt_abstractions.h"
Azure.IoT Build 46:91bd03862871 14 #include "azure_c_shared_utility/platform.h"
AzureIoTClient 79:e5cdb4c2307c 15 #include "azure_c_shared_utility/shared_util_options.h"
AzureIoTClient 18:e3e29fc771c9 16 #include "iothub_client_ll.h"
AzureIoTClient 18:e3e29fc771c9 17 #include "iothub_message.h"
AzureIoTClient 18:e3e29fc771c9 18 #include "iothubtransporthttp.h"
AzureIoTClient 18:e3e29fc771c9 19
AzureIoTClient 18:e3e29fc771c9 20 #ifdef MBED_BUILD_TIMESTAMP
AzureIoTClient 77:d4c04296120e 21 #define SET_TRUSTED_CERT_IN_SAMPLES
AzureIoTClient 77:d4c04296120e 22 #endif // MBED_BUILD_TIMESTAMP
AzureIoTClient 77:d4c04296120e 23
AzureIoTClient 77:d4c04296120e 24 #ifdef SET_TRUSTED_CERT_IN_SAMPLES
AzureIoTClient 18:e3e29fc771c9 25 #include "certs.h"
AzureIoTClient 77:d4c04296120e 26 #endif // SET_TRUSTED_CERT_IN_SAMPLES
AzureIoTClient 18:e3e29fc771c9 27
AzureIoTClient 39:405f9c637ba4 28 /*String containing Hostname, Device Id & Device Key in the format: */
AzureIoTClient 39:405f9c637ba4 29 /* "HostName=<host_name>;DeviceId=<device_id>;SharedAccessKey=<device_key>" */
AzureIoTClient 39:405f9c637ba4 30 /* "HostName=<host_name>;DeviceId=<device_id>;SharedAccessSignature=<device_sas_token>" */
AzureIoTClient 18:e3e29fc771c9 31 static const char* connectionString = "[device connection string]";
AzureIoTClient 39:405f9c637ba4 32
AzureIoTClient 48:07c7ca66634a 33
AzureIoTClient 18:e3e29fc771c9 34 static int callbackCounter;
AzureIoTClient 42:289de245ba1d 35 static bool g_continueRunning;
Azure.IoT Build 46:91bd03862871 36 static char msgText[1024];
Azure.IoT Build 46:91bd03862871 37 static char propText[1024];
Azure.IoT Build 46:91bd03862871 38 #define MESSAGE_COUNT 5
Azure.IoT Build 46:91bd03862871 39 #define DOWORK_LOOP_NUM 3
AzureIoTClient 18:e3e29fc771c9 40
AzureIoTClient 18:e3e29fc771c9 41
AzureIoTClient 18:e3e29fc771c9 42 typedef struct EVENT_INSTANCE_TAG
AzureIoTClient 18:e3e29fc771c9 43 {
AzureIoTClient 18:e3e29fc771c9 44 IOTHUB_MESSAGE_HANDLE messageHandle;
AzureIoTClient 47:bc18bf0e4a6a 45 size_t messageTrackingId; // For tracking the messages within the user callback.
AzureIoTClient 18:e3e29fc771c9 46 } EVENT_INSTANCE;
AzureIoTClient 18:e3e29fc771c9 47
AzureIoTClient 18:e3e29fc771c9 48 static IOTHUBMESSAGE_DISPOSITION_RESULT ReceiveMessageCallback(IOTHUB_MESSAGE_HANDLE message, void* userContextCallback)
AzureIoTClient 18:e3e29fc771c9 49 {
AzureIoTClient 18:e3e29fc771c9 50 int* counter = (int*)userContextCallback;
AzureIoTClient 18:e3e29fc771c9 51 const char* buffer;
AzureIoTClient 18:e3e29fc771c9 52 size_t size;
AzureIoTClient 41:7a930aa6dc01 53 MAP_HANDLE mapProperties;
AzureIoTClient 62:2320ad565fc3 54 const char* messageId;
AzureIoTClient 62:2320ad565fc3 55 const char* correlationId;
AzureIoTClient 76:e9a30712b6d7 56 const char* contentType;
AzureIoTClient 76:e9a30712b6d7 57 const char* contentEncoding;
AzureIoTClient 20:52f8298d7256 58
AzureIoTClient 62:2320ad565fc3 59 // Message properties
AzureIoTClient 62:2320ad565fc3 60 if ((messageId = IoTHubMessage_GetMessageId(message)) == NULL)
AzureIoTClient 62:2320ad565fc3 61 {
AzureIoTClient 62:2320ad565fc3 62 messageId = "<null>";
AzureIoTClient 62:2320ad565fc3 63 }
AzureIoTClient 62:2320ad565fc3 64
AzureIoTClient 62:2320ad565fc3 65 if ((correlationId = IoTHubMessage_GetCorrelationId(message)) == NULL)
AzureIoTClient 62:2320ad565fc3 66 {
AzureIoTClient 62:2320ad565fc3 67 correlationId = "<null>";
AzureIoTClient 62:2320ad565fc3 68 }
AzureIoTClient 62:2320ad565fc3 69
AzureIoTClient 83:2911682db006 70 if ((contentType = IoTHubMessage_GetContentTypeSystemProperty(message)) == NULL)
AzureIoTClient 83:2911682db006 71 {
AzureIoTClient 76:e9a30712b6d7 72 contentType = "<null>";
AzureIoTClient 83:2911682db006 73 }
AzureIoTClient 76:e9a30712b6d7 74
AzureIoTClient 83:2911682db006 75 if ((contentEncoding = IoTHubMessage_GetContentEncodingSystemProperty(message)) == NULL)
AzureIoTClient 83:2911682db006 76 {
AzureIoTClient 76:e9a30712b6d7 77 contentEncoding = "<null>";
AzureIoTClient 83:2911682db006 78 }
AzureIoTClient 76:e9a30712b6d7 79
AzureIoTClient 62:2320ad565fc3 80 // Message content
AzureIoTClient 18:e3e29fc771c9 81 if (IoTHubMessage_GetByteArray(message, (const unsigned char**)&buffer, &size) != IOTHUB_MESSAGE_OK)
AzureIoTClient 18:e3e29fc771c9 82 {
AzureIoTClient 18:e3e29fc771c9 83 printf("unable to retrieve the message data\r\n");
AzureIoTClient 18:e3e29fc771c9 84 }
AzureIoTClient 18:e3e29fc771c9 85 else
AzureIoTClient 18:e3e29fc771c9 86 {
AzureIoTClient 76:e9a30712b6d7 87 (void)printf("Received Message [%d]\r\n Message ID: %s\r\n Correlation ID: %s\r\n Content-Type: %s\r\n Content-Encoding: %s\r\n Data: <<<%.*s>>> & Size=%d\r\n",
AzureIoTClient 76:e9a30712b6d7 88 *counter, messageId, correlationId, contentType, contentEncoding, (int)size, buffer, (int)size);
AzureIoTClient 79:e5cdb4c2307c 89 if (size == (strlen("quit") * sizeof(char)) && memcmp(buffer, "quit", size) == 0)
AzureIoTClient 42:289de245ba1d 90 {
AzureIoTClient 42:289de245ba1d 91 g_continueRunning = false;
AzureIoTClient 42:289de245ba1d 92 }
AzureIoTClient 18:e3e29fc771c9 93 }
AzureIoTClient 18:e3e29fc771c9 94
AzureIoTClient 18:e3e29fc771c9 95 // Retrieve properties from the message
AzureIoTClient 20:52f8298d7256 96 mapProperties = IoTHubMessage_Properties(message);
AzureIoTClient 18:e3e29fc771c9 97 if (mapProperties != NULL)
AzureIoTClient 18:e3e29fc771c9 98 {
AzureIoTClient 18:e3e29fc771c9 99 const char*const* keys;
AzureIoTClient 18:e3e29fc771c9 100 const char*const* values;
AzureIoTClient 18:e3e29fc771c9 101 size_t propertyCount = 0;
AzureIoTClient 18:e3e29fc771c9 102 if (Map_GetInternals(mapProperties, &keys, &values, &propertyCount) == MAP_OK)
AzureIoTClient 18:e3e29fc771c9 103 {
AzureIoTClient 18:e3e29fc771c9 104 if (propertyCount > 0)
AzureIoTClient 18:e3e29fc771c9 105 {
AzureIoTClient 41:7a930aa6dc01 106 size_t index;
AzureIoTClient 20:52f8298d7256 107
AzureIoTClient 62:2320ad565fc3 108 printf(" Message Properties:\r\n");
AzureIoTClient 20:52f8298d7256 109 for (index = 0; index < propertyCount; index++)
AzureIoTClient 18:e3e29fc771c9 110 {
AzureIoTClient 18:e3e29fc771c9 111 printf("\tKey: %s Value: %s\r\n", keys[index], values[index]);
AzureIoTClient 18:e3e29fc771c9 112 }
AzureIoTClient 18:e3e29fc771c9 113 printf("\r\n");
AzureIoTClient 18:e3e29fc771c9 114 }
AzureIoTClient 18:e3e29fc771c9 115 }
AzureIoTClient 18:e3e29fc771c9 116 }
AzureIoTClient 18:e3e29fc771c9 117
AzureIoTClient 18:e3e29fc771c9 118 /* Some device specific action code goes here... */
AzureIoTClient 18:e3e29fc771c9 119 (*counter)++;
AzureIoTClient 18:e3e29fc771c9 120 return IOTHUBMESSAGE_ACCEPTED;
AzureIoTClient 18:e3e29fc771c9 121 }
AzureIoTClient 18:e3e29fc771c9 122
AzureIoTClient 18:e3e29fc771c9 123 static void SendConfirmationCallback(IOTHUB_CLIENT_CONFIRMATION_RESULT result, void* userContextCallback)
AzureIoTClient 18:e3e29fc771c9 124 {
AzureIoTClient 18:e3e29fc771c9 125 EVENT_INSTANCE* eventInstance = (EVENT_INSTANCE*)userContextCallback;
AzureIoTClient 49:2aa1b773af3c 126
AzureIoTClient 49:2aa1b773af3c 127 (void)printf("Confirmation[%d] received for message tracking id = %zu with result = %s\r\n", callbackCounter, eventInstance->messageTrackingId, ENUM_TO_STRING(IOTHUB_CLIENT_CONFIRMATION_RESULT, result));
AzureIoTClient 49:2aa1b773af3c 128
AzureIoTClient 18:e3e29fc771c9 129 /* Some device specific action code goes here... */
AzureIoTClient 18:e3e29fc771c9 130 callbackCounter++;
AzureIoTClient 18:e3e29fc771c9 131 IoTHubMessage_Destroy(eventInstance->messageHandle);
AzureIoTClient 18:e3e29fc771c9 132 }
AzureIoTClient 18:e3e29fc771c9 133
AzureIoTClient 18:e3e29fc771c9 134 void iothub_client_sample_http_run(void)
AzureIoTClient 18:e3e29fc771c9 135 {
AzureIoTClient 18:e3e29fc771c9 136 IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle;
AzureIoTClient 18:e3e29fc771c9 137
AzureIoTClient 18:e3e29fc771c9 138 EVENT_INSTANCE messages[MESSAGE_COUNT];
AzureIoTClient 20:52f8298d7256 139 double avgWindSpeed = 10.0;
AzureIoTClient 68:a8c0f61d8478 140 double minTemperature = 20.0;
AzureIoTClient 68:a8c0f61d8478 141 double minHumidity = 60.0;
AzureIoTClient 20:52f8298d7256 142 int receiveContext = 0;
Azure.IoT Build 46:91bd03862871 143
AzureIoTClient 42:289de245ba1d 144 g_continueRunning = true;
AzureIoTClient 18:e3e29fc771c9 145
AzureIoTClient 18:e3e29fc771c9 146 srand((unsigned int)time(NULL));
AzureIoTClient 18:e3e29fc771c9 147
AzureIoTClient 18:e3e29fc771c9 148 callbackCounter = 0;
AzureIoTClient 18:e3e29fc771c9 149
Azure.IoT Build 33:f8eb46ca453d 150 if (platform_init() != 0)
AzureIoTClient 18:e3e29fc771c9 151 {
Azure.IoT Build 33:f8eb46ca453d 152 printf("Failed to initialize the platform.\r\n");
AzureIoTClient 18:e3e29fc771c9 153 }
AzureIoTClient 18:e3e29fc771c9 154 else
AzureIoTClient 18:e3e29fc771c9 155 {
Azure.IoT Build 33:f8eb46ca453d 156 (void)printf("Starting the IoTHub client sample HTTP...\r\n");
AzureIoTClient 18:e3e29fc771c9 157
Azure.IoT Build 33:f8eb46ca453d 158 if ((iotHubClientHandle = IoTHubClient_LL_CreateFromConnectionString(connectionString, HTTP_Protocol)) == NULL)
AzureIoTClient 18:e3e29fc771c9 159 {
Azure.IoT Build 33:f8eb46ca453d 160 (void)printf("ERROR: iotHubClientHandle is NULL!\r\n");
AzureIoTClient 18:e3e29fc771c9 161 }
AzureIoTClient 18:e3e29fc771c9 162 else
AzureIoTClient 18:e3e29fc771c9 163 {
Azure.IoT Build 33:f8eb46ca453d 164 unsigned int timeout = 241000;
Azure.IoT Build 33:f8eb46ca453d 165 // Because it can poll "after 9 seconds" polls will happen effectively // at ~10 seconds.
Azure.IoT Build 33:f8eb46ca453d 166 // Note that for scalabilty, the default value of minimumPollingTime
Azure.IoT Build 33:f8eb46ca453d 167 // is 25 minutes. For more information, see:
Azure.IoT Build 33:f8eb46ca453d 168 // https://azure.microsoft.com/documentation/articles/iot-hub-devguide/#messaging
Azure.IoT Build 33:f8eb46ca453d 169 unsigned int minimumPollingTime = 9;
Azure.IoT Build 33:f8eb46ca453d 170 if (IoTHubClient_LL_SetOption(iotHubClientHandle, "timeout", &timeout) != IOTHUB_CLIENT_OK)
Azure.IoT Build 33:f8eb46ca453d 171 {
Azure.IoT Build 33:f8eb46ca453d 172 printf("failure to set option \"timeout\"\r\n");
Azure.IoT Build 33:f8eb46ca453d 173 }
AzureIoTClient 20:52f8298d7256 174
Azure.IoT Build 33:f8eb46ca453d 175 if (IoTHubClient_LL_SetOption(iotHubClientHandle, "MinimumPollingTime", &minimumPollingTime) != IOTHUB_CLIENT_OK)
AzureIoTClient 18:e3e29fc771c9 176 {
Azure.IoT Build 33:f8eb46ca453d 177 printf("failure to set option \"MinimumPollingTime\"\r\n");
Azure.IoT Build 33:f8eb46ca453d 178 }
Azure.IoT Build 33:f8eb46ca453d 179
AzureIoTClient 77:d4c04296120e 180 #ifdef SET_TRUSTED_CERT_IN_SAMPLES
Azure.IoT Build 33:f8eb46ca453d 181 // For mbed add the certificate information
AzureIoTClient 79:e5cdb4c2307c 182 if (IoTHubClient_LL_SetOption(iotHubClientHandle, OPTION_TRUSTED_CERT, certificates) != IOTHUB_CLIENT_OK)
Azure.IoT Build 33:f8eb46ca453d 183 {
Azure.IoT Build 33:f8eb46ca453d 184 printf("failure to set option \"TrustedCerts\"\r\n");
Azure.IoT Build 33:f8eb46ca453d 185 }
AzureIoTClient 77:d4c04296120e 186 #endif // SET_TRUSTED_CERT_IN_SAMPLES
Azure.IoT Build 33:f8eb46ca453d 187
Azure.IoT Build 33:f8eb46ca453d 188 /* Setting Message call back, so we can receive Commands. */
Azure.IoT Build 33:f8eb46ca453d 189 if (IoTHubClient_LL_SetMessageCallback(iotHubClientHandle, ReceiveMessageCallback, &receiveContext) != IOTHUB_CLIENT_OK)
Azure.IoT Build 33:f8eb46ca453d 190 {
Azure.IoT Build 33:f8eb46ca453d 191 (void)printf("ERROR: IoTHubClient_LL_SetMessageCallback..........FAILED!\r\n");
Azure.IoT Build 33:f8eb46ca453d 192 }
Azure.IoT Build 33:f8eb46ca453d 193 else
Azure.IoT Build 33:f8eb46ca453d 194 {
Azure.IoT Build 33:f8eb46ca453d 195 (void)printf("IoTHubClient_LL_SetMessageCallback...successful.\r\n");
Azure.IoT Build 33:f8eb46ca453d 196
Azure.IoT Build 33:f8eb46ca453d 197 /* Now that we are ready to receive commands, let's send some messages */
AzureIoTClient 42:289de245ba1d 198 size_t iterator = 0;
AzureIoTClient 68:a8c0f61d8478 199 double temperature = 0;
AzureIoTClient 68:a8c0f61d8478 200 double humidity = 0;
AzureIoTClient 42:289de245ba1d 201 do
AzureIoTClient 18:e3e29fc771c9 202 {
AzureIoTClient 42:289de245ba1d 203 if (iterator < MESSAGE_COUNT)
AzureIoTClient 18:e3e29fc771c9 204 {
AzureIoTClient 68:a8c0f61d8478 205 temperature = minTemperature + (rand() % 10);
AzureIoTClient 68:a8c0f61d8478 206 humidity = minHumidity + (rand() % 20);
AzureIoTClient 68:a8c0f61d8478 207 sprintf_s(msgText, sizeof(msgText), "{\"deviceId\":\"myFirstDevice\",\"windSpeed\":%.2f,\"temperature\":%.2f,\"humidity\":%.2f}", avgWindSpeed + (rand() % 4 + 2), temperature, humidity);
AzureIoTClient 42:289de245ba1d 208 if ((messages[iterator].messageHandle = IoTHubMessage_CreateFromByteArray((const unsigned char*)msgText, strlen(msgText))) == NULL)
Azure.IoT Build 33:f8eb46ca453d 209 {
AzureIoTClient 42:289de245ba1d 210 (void)printf("ERROR: iotHubMessageHandle is NULL!\r\n");
Azure.IoT Build 33:f8eb46ca453d 211 }
Azure.IoT Build 33:f8eb46ca453d 212 else
Azure.IoT Build 33:f8eb46ca453d 213 {
AzureIoTClient 42:289de245ba1d 214 MAP_HANDLE propMap;
AzureIoTClient 42:289de245ba1d 215
AzureIoTClient 42:289de245ba1d 216 messages[iterator].messageTrackingId = iterator;
Azure.IoT Build 33:f8eb46ca453d 217
AzureIoTClient 42:289de245ba1d 218 propMap = IoTHubMessage_Properties(messages[iterator].messageHandle);
AzureIoTClient 68:a8c0f61d8478 219 (void)sprintf_s(propText, sizeof(propText), temperature > 28 ? "true" : "false");
AzureIoTClient 68:a8c0f61d8478 220 if (Map_AddOrUpdate(propMap, "temperatureAlert", propText) != MAP_OK)
AzureIoTClient 42:289de245ba1d 221 {
AzureIoTClient 42:289de245ba1d 222 (void)printf("ERROR: Map_AddOrUpdate Failed!\r\n");
AzureIoTClient 42:289de245ba1d 223 }
AzureIoTClient 18:e3e29fc771c9 224
AzureIoTClient 83:2911682db006 225 (void)IoTHubMessage_SetContentTypeSystemProperty(messages[iterator].messageHandle, "application/json");
AzureIoTClient 83:2911682db006 226 (void)IoTHubMessage_SetContentEncodingSystemProperty(messages[iterator].messageHandle, "utf-8");
AzureIoTClient 76:e9a30712b6d7 227
AzureIoTClient 42:289de245ba1d 228 if (IoTHubClient_LL_SendEventAsync(iotHubClientHandle, messages[iterator].messageHandle, SendConfirmationCallback, &messages[iterator]) != IOTHUB_CLIENT_OK)
AzureIoTClient 42:289de245ba1d 229 {
AzureIoTClient 42:289de245ba1d 230 (void)printf("ERROR: IoTHubClient_LL_SendEventAsync..........FAILED!\r\n");
AzureIoTClient 42:289de245ba1d 231 }
AzureIoTClient 42:289de245ba1d 232 else
AzureIoTClient 42:289de245ba1d 233 {
AzureIoTClient 49:2aa1b773af3c 234 (void)printf("IoTHubClient_LL_SendEventAsync accepted message [%zu] for transmission to IoT Hub.\r\n", iterator);
AzureIoTClient 49:2aa1b773af3c 235
AzureIoTClient 42:289de245ba1d 236 }
AzureIoTClient 42:289de245ba1d 237
AzureIoTClient 42:289de245ba1d 238 }
AzureIoTClient 42:289de245ba1d 239 }
AzureIoTClient 42:289de245ba1d 240 IoTHubClient_LL_DoWork(iotHubClientHandle);
AzureIoTClient 42:289de245ba1d 241 ThreadAPI_Sleep(1);
AzureIoTClient 42:289de245ba1d 242
AzureIoTClient 42:289de245ba1d 243 iterator++;
AzureIoTClient 42:289de245ba1d 244 } while (g_continueRunning);
Azure.IoT Build 46:91bd03862871 245
AzureIoTClient 48:07c7ca66634a 246 (void)printf("iothub_client_sample_http has gotten quit message, call DoWork %d more time to complete final sending...\r\n", DOWORK_LOOP_NUM);
Azure.IoT Build 46:91bd03862871 247 for (size_t index = 0; index < DOWORK_LOOP_NUM; index++)
Azure.IoT Build 46:91bd03862871 248 {
Azure.IoT Build 46:91bd03862871 249 IoTHubClient_LL_DoWork(iotHubClientHandle);
Azure.IoT Build 46:91bd03862871 250 ThreadAPI_Sleep(1);
Azure.IoT Build 46:91bd03862871 251 }
Azure.IoT Build 33:f8eb46ca453d 252 }
Azure.IoT Build 33:f8eb46ca453d 253 IoTHubClient_LL_Destroy(iotHubClientHandle);
AzureIoTClient 18:e3e29fc771c9 254 }
Azure.IoT Build 33:f8eb46ca453d 255 platform_deinit();
AzureIoTClient 18:e3e29fc771c9 256 }
AzureIoTClient 18:e3e29fc771c9 257 }
AzureIoTClient 42:289de245ba1d 258
AzureIoTClient 42:289de245ba1d 259 int main(void)
AzureIoTClient 42:289de245ba1d 260 {
AzureIoTClient 48:07c7ca66634a 261 iothub_client_sample_http_run();
AzureIoTClient 48:07c7ca66634a 262 return 0;
AzureIoTClient 42:289de245ba1d 263 }