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.

Committer:
Azure.IoT Build
Date:
Fri Jul 01 10:43:55 2016 -0700
Revision:
46:91bd03862871
Parent:
42:289de245ba1d
Child:
47:bc18bf0e4a6a
1.0.10

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
AzureIoTClient 20:52f8298d7256 12 #ifdef ARDUINO
AzureIoTClient 20:52f8298d7256 13 #include "AzureIoT.h"
AzureIoTClient 20:52f8298d7256 14 #else
Azure.IoT Build 46:91bd03862871 15 #include "azure_c_shared_utility/threadapi.h"
Azure.IoT Build 46:91bd03862871 16 #include "azure_c_shared_utility/crt_abstractions.h"
Azure.IoT Build 46:91bd03862871 17 #include "azure_c_shared_utility/platform.h"
AzureIoTClient 18:e3e29fc771c9 18 #include "iothub_client_ll.h"
AzureIoTClient 18:e3e29fc771c9 19 #include "iothub_message.h"
AzureIoTClient 18:e3e29fc771c9 20 #include "iothubtransporthttp.h"
AzureIoTClient 20:52f8298d7256 21 #endif
AzureIoTClient 18:e3e29fc771c9 22
AzureIoTClient 18:e3e29fc771c9 23 #ifdef MBED_BUILD_TIMESTAMP
AzureIoTClient 18:e3e29fc771c9 24 #include "certs.h"
AzureIoTClient 18:e3e29fc771c9 25 #endif // MBED_BUILD_TIMESTAMP
AzureIoTClient 18:e3e29fc771c9 26
AzureIoTClient 39:405f9c637ba4 27 /*String containing Hostname, Device Id & Device Key in the format: */
AzureIoTClient 39:405f9c637ba4 28 /* "HostName=<host_name>;DeviceId=<device_id>;SharedAccessKey=<device_key>" */
AzureIoTClient 39:405f9c637ba4 29 /* "HostName=<host_name>;DeviceId=<device_id>;SharedAccessSignature=<device_sas_token>" */
AzureIoTClient 18:e3e29fc771c9 30 static const char* connectionString = "[device connection string]";
AzureIoTClient 39:405f9c637ba4 31
AzureIoTClient 18:e3e29fc771c9 32 static int callbackCounter;
AzureIoTClient 42:289de245ba1d 33 static bool g_continueRunning;
Azure.IoT Build 46:91bd03862871 34 static char msgText[1024];
Azure.IoT Build 46:91bd03862871 35 static char propText[1024];
Azure.IoT Build 46:91bd03862871 36 #define MESSAGE_COUNT 5
Azure.IoT Build 46:91bd03862871 37 #define DOWORK_LOOP_NUM 3
AzureIoTClient 18:e3e29fc771c9 38
AzureIoTClient 18:e3e29fc771c9 39
AzureIoTClient 18:e3e29fc771c9 40 typedef struct EVENT_INSTANCE_TAG
AzureIoTClient 18:e3e29fc771c9 41 {
AzureIoTClient 18:e3e29fc771c9 42 IOTHUB_MESSAGE_HANDLE messageHandle;
AzureIoTClient 18:e3e29fc771c9 43 int messageTrackingId; // For tracking the messages within the user callback.
AzureIoTClient 18:e3e29fc771c9 44 } EVENT_INSTANCE;
AzureIoTClient 18:e3e29fc771c9 45
AzureIoTClient 18:e3e29fc771c9 46 static IOTHUBMESSAGE_DISPOSITION_RESULT ReceiveMessageCallback(IOTHUB_MESSAGE_HANDLE message, void* userContextCallback)
AzureIoTClient 18:e3e29fc771c9 47 {
AzureIoTClient 18:e3e29fc771c9 48 int* counter = (int*)userContextCallback;
AzureIoTClient 18:e3e29fc771c9 49 const char* buffer;
AzureIoTClient 18:e3e29fc771c9 50 size_t size;
AzureIoTClient 41:7a930aa6dc01 51 MAP_HANDLE mapProperties;
AzureIoTClient 20:52f8298d7256 52
AzureIoTClient 18:e3e29fc771c9 53 if (IoTHubMessage_GetByteArray(message, (const unsigned char**)&buffer, &size) != IOTHUB_MESSAGE_OK)
AzureIoTClient 18:e3e29fc771c9 54 {
AzureIoTClient 18:e3e29fc771c9 55 printf("unable to retrieve the message data\r\n");
AzureIoTClient 18:e3e29fc771c9 56 }
AzureIoTClient 18:e3e29fc771c9 57 else
AzureIoTClient 18:e3e29fc771c9 58 {
AzureIoTClient 18:e3e29fc771c9 59 (void)printf("Received Message [%d] with Data: <<<%.*s>>> & Size=%d\r\n", *counter, (int)size, buffer, (int)size);
AzureIoTClient 42:289de245ba1d 60 if (memcmp(buffer, "quit", size) == 0)
AzureIoTClient 42:289de245ba1d 61 {
AzureIoTClient 42:289de245ba1d 62 g_continueRunning = false;
AzureIoTClient 42:289de245ba1d 63 }
AzureIoTClient 18:e3e29fc771c9 64 }
AzureIoTClient 18:e3e29fc771c9 65
AzureIoTClient 18:e3e29fc771c9 66 // Retrieve properties from the message
AzureIoTClient 20:52f8298d7256 67 mapProperties = IoTHubMessage_Properties(message);
AzureIoTClient 18:e3e29fc771c9 68 if (mapProperties != NULL)
AzureIoTClient 18:e3e29fc771c9 69 {
AzureIoTClient 18:e3e29fc771c9 70 const char*const* keys;
AzureIoTClient 18:e3e29fc771c9 71 const char*const* values;
AzureIoTClient 18:e3e29fc771c9 72 size_t propertyCount = 0;
AzureIoTClient 18:e3e29fc771c9 73 if (Map_GetInternals(mapProperties, &keys, &values, &propertyCount) == MAP_OK)
AzureIoTClient 18:e3e29fc771c9 74 {
AzureIoTClient 18:e3e29fc771c9 75 if (propertyCount > 0)
AzureIoTClient 18:e3e29fc771c9 76 {
AzureIoTClient 41:7a930aa6dc01 77 size_t index;
AzureIoTClient 20:52f8298d7256 78
AzureIoTClient 18:e3e29fc771c9 79 printf("Message Properties:\r\n");
AzureIoTClient 20:52f8298d7256 80 for (index = 0; index < propertyCount; index++)
AzureIoTClient 18:e3e29fc771c9 81 {
AzureIoTClient 18:e3e29fc771c9 82 printf("\tKey: %s Value: %s\r\n", keys[index], values[index]);
AzureIoTClient 18:e3e29fc771c9 83 }
AzureIoTClient 18:e3e29fc771c9 84 printf("\r\n");
AzureIoTClient 18:e3e29fc771c9 85 }
AzureIoTClient 18:e3e29fc771c9 86 }
AzureIoTClient 18:e3e29fc771c9 87 }
AzureIoTClient 18:e3e29fc771c9 88
AzureIoTClient 18:e3e29fc771c9 89 /* Some device specific action code goes here... */
AzureIoTClient 18:e3e29fc771c9 90 (*counter)++;
AzureIoTClient 18:e3e29fc771c9 91 return IOTHUBMESSAGE_ACCEPTED;
AzureIoTClient 18:e3e29fc771c9 92 }
AzureIoTClient 18:e3e29fc771c9 93
AzureIoTClient 18:e3e29fc771c9 94 static void SendConfirmationCallback(IOTHUB_CLIENT_CONFIRMATION_RESULT result, void* userContextCallback)
AzureIoTClient 18:e3e29fc771c9 95 {
AzureIoTClient 18:e3e29fc771c9 96 EVENT_INSTANCE* eventInstance = (EVENT_INSTANCE*)userContextCallback;
AzureIoTClient 18:e3e29fc771c9 97 (void)printf("Confirmation[%d] received for message tracking id = %d with result = %s\r\n", callbackCounter, eventInstance->messageTrackingId, ENUM_TO_STRING(IOTHUB_CLIENT_CONFIRMATION_RESULT, result));
AzureIoTClient 18:e3e29fc771c9 98 /* Some device specific action code goes here... */
AzureIoTClient 18:e3e29fc771c9 99 callbackCounter++;
AzureIoTClient 18:e3e29fc771c9 100 IoTHubMessage_Destroy(eventInstance->messageHandle);
AzureIoTClient 18:e3e29fc771c9 101 }
AzureIoTClient 18:e3e29fc771c9 102
AzureIoTClient 18:e3e29fc771c9 103 void iothub_client_sample_http_run(void)
AzureIoTClient 18:e3e29fc771c9 104 {
AzureIoTClient 18:e3e29fc771c9 105 IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle;
AzureIoTClient 18:e3e29fc771c9 106
AzureIoTClient 18:e3e29fc771c9 107 EVENT_INSTANCE messages[MESSAGE_COUNT];
AzureIoTClient 20:52f8298d7256 108 double avgWindSpeed = 10.0;
AzureIoTClient 20:52f8298d7256 109 int receiveContext = 0;
Azure.IoT Build 46:91bd03862871 110
AzureIoTClient 42:289de245ba1d 111 g_continueRunning = true;
AzureIoTClient 18:e3e29fc771c9 112
AzureIoTClient 18:e3e29fc771c9 113 srand((unsigned int)time(NULL));
AzureIoTClient 18:e3e29fc771c9 114
AzureIoTClient 18:e3e29fc771c9 115 callbackCounter = 0;
AzureIoTClient 18:e3e29fc771c9 116
Azure.IoT Build 33:f8eb46ca453d 117 if (platform_init() != 0)
AzureIoTClient 18:e3e29fc771c9 118 {
Azure.IoT Build 33:f8eb46ca453d 119 printf("Failed to initialize the platform.\r\n");
AzureIoTClient 18:e3e29fc771c9 120 }
AzureIoTClient 18:e3e29fc771c9 121 else
AzureIoTClient 18:e3e29fc771c9 122 {
Azure.IoT Build 33:f8eb46ca453d 123 (void)printf("Starting the IoTHub client sample HTTP...\r\n");
AzureIoTClient 18:e3e29fc771c9 124
Azure.IoT Build 33:f8eb46ca453d 125 if ((iotHubClientHandle = IoTHubClient_LL_CreateFromConnectionString(connectionString, HTTP_Protocol)) == NULL)
AzureIoTClient 18:e3e29fc771c9 126 {
Azure.IoT Build 33:f8eb46ca453d 127 (void)printf("ERROR: iotHubClientHandle is NULL!\r\n");
AzureIoTClient 18:e3e29fc771c9 128 }
AzureIoTClient 18:e3e29fc771c9 129 else
AzureIoTClient 18:e3e29fc771c9 130 {
Azure.IoT Build 33:f8eb46ca453d 131 unsigned int timeout = 241000;
Azure.IoT Build 33:f8eb46ca453d 132 // Because it can poll "after 9 seconds" polls will happen effectively // at ~10 seconds.
Azure.IoT Build 33:f8eb46ca453d 133 // Note that for scalabilty, the default value of minimumPollingTime
Azure.IoT Build 33:f8eb46ca453d 134 // is 25 minutes. For more information, see:
Azure.IoT Build 33:f8eb46ca453d 135 // https://azure.microsoft.com/documentation/articles/iot-hub-devguide/#messaging
Azure.IoT Build 33:f8eb46ca453d 136 unsigned int minimumPollingTime = 9;
Azure.IoT Build 33:f8eb46ca453d 137 if (IoTHubClient_LL_SetOption(iotHubClientHandle, "timeout", &timeout) != IOTHUB_CLIENT_OK)
Azure.IoT Build 33:f8eb46ca453d 138 {
Azure.IoT Build 33:f8eb46ca453d 139 printf("failure to set option \"timeout\"\r\n");
Azure.IoT Build 33:f8eb46ca453d 140 }
AzureIoTClient 20:52f8298d7256 141
Azure.IoT Build 33:f8eb46ca453d 142 if (IoTHubClient_LL_SetOption(iotHubClientHandle, "MinimumPollingTime", &minimumPollingTime) != IOTHUB_CLIENT_OK)
AzureIoTClient 18:e3e29fc771c9 143 {
Azure.IoT Build 33:f8eb46ca453d 144 printf("failure to set option \"MinimumPollingTime\"\r\n");
Azure.IoT Build 33:f8eb46ca453d 145 }
Azure.IoT Build 33:f8eb46ca453d 146
Azure.IoT Build 33:f8eb46ca453d 147 #ifdef MBED_BUILD_TIMESTAMP
Azure.IoT Build 33:f8eb46ca453d 148 // For mbed add the certificate information
Azure.IoT Build 33:f8eb46ca453d 149 if (IoTHubClient_LL_SetOption(iotHubClientHandle, "TrustedCerts", certificates) != IOTHUB_CLIENT_OK)
Azure.IoT Build 33:f8eb46ca453d 150 {
Azure.IoT Build 33:f8eb46ca453d 151 printf("failure to set option \"TrustedCerts\"\r\n");
Azure.IoT Build 33:f8eb46ca453d 152 }
Azure.IoT Build 33:f8eb46ca453d 153 #endif // MBED_BUILD_TIMESTAMP
Azure.IoT Build 33:f8eb46ca453d 154
Azure.IoT Build 33:f8eb46ca453d 155 /* Setting Message call back, so we can receive Commands. */
Azure.IoT Build 33:f8eb46ca453d 156 if (IoTHubClient_LL_SetMessageCallback(iotHubClientHandle, ReceiveMessageCallback, &receiveContext) != IOTHUB_CLIENT_OK)
Azure.IoT Build 33:f8eb46ca453d 157 {
Azure.IoT Build 33:f8eb46ca453d 158 (void)printf("ERROR: IoTHubClient_LL_SetMessageCallback..........FAILED!\r\n");
Azure.IoT Build 33:f8eb46ca453d 159 }
Azure.IoT Build 33:f8eb46ca453d 160 else
Azure.IoT Build 33:f8eb46ca453d 161 {
Azure.IoT Build 33:f8eb46ca453d 162 (void)printf("IoTHubClient_LL_SetMessageCallback...successful.\r\n");
Azure.IoT Build 33:f8eb46ca453d 163
Azure.IoT Build 33:f8eb46ca453d 164 /* Now that we are ready to receive commands, let's send some messages */
AzureIoTClient 42:289de245ba1d 165 size_t iterator = 0;
AzureIoTClient 42:289de245ba1d 166 do
AzureIoTClient 18:e3e29fc771c9 167 {
AzureIoTClient 42:289de245ba1d 168 if (iterator < MESSAGE_COUNT)
AzureIoTClient 18:e3e29fc771c9 169 {
AzureIoTClient 42:289de245ba1d 170 sprintf_s(msgText, sizeof(msgText), "{\"deviceId\": \"myFirstDevice\",\"windSpeed\": %.2f}", avgWindSpeed + (rand() % 4 + 2));
AzureIoTClient 42:289de245ba1d 171 if ((messages[iterator].messageHandle = IoTHubMessage_CreateFromByteArray((const unsigned char*)msgText, strlen(msgText))) == NULL)
Azure.IoT Build 33:f8eb46ca453d 172 {
AzureIoTClient 42:289de245ba1d 173 (void)printf("ERROR: iotHubMessageHandle is NULL!\r\n");
Azure.IoT Build 33:f8eb46ca453d 174 }
Azure.IoT Build 33:f8eb46ca453d 175 else
Azure.IoT Build 33:f8eb46ca453d 176 {
AzureIoTClient 42:289de245ba1d 177 MAP_HANDLE propMap;
AzureIoTClient 42:289de245ba1d 178
AzureIoTClient 42:289de245ba1d 179 messages[iterator].messageTrackingId = iterator;
Azure.IoT Build 33:f8eb46ca453d 180
AzureIoTClient 42:289de245ba1d 181 propMap = IoTHubMessage_Properties(messages[iterator].messageHandle);
AzureIoTClient 42:289de245ba1d 182 sprintf_s(propText, sizeof(propText), "PropMsg_%d", iterator);
AzureIoTClient 42:289de245ba1d 183 if (Map_AddOrUpdate(propMap, "PropName", propText) != MAP_OK)
AzureIoTClient 42:289de245ba1d 184 {
AzureIoTClient 42:289de245ba1d 185 (void)printf("ERROR: Map_AddOrUpdate Failed!\r\n");
AzureIoTClient 42:289de245ba1d 186 }
AzureIoTClient 18:e3e29fc771c9 187
AzureIoTClient 42:289de245ba1d 188 if (IoTHubClient_LL_SendEventAsync(iotHubClientHandle, messages[iterator].messageHandle, SendConfirmationCallback, &messages[iterator]) != IOTHUB_CLIENT_OK)
AzureIoTClient 42:289de245ba1d 189 {
AzureIoTClient 42:289de245ba1d 190 (void)printf("ERROR: IoTHubClient_LL_SendEventAsync..........FAILED!\r\n");
AzureIoTClient 42:289de245ba1d 191 }
AzureIoTClient 42:289de245ba1d 192 else
AzureIoTClient 42:289de245ba1d 193 {
AzureIoTClient 42:289de245ba1d 194 (void)printf("IoTHubClient_LL_SendEventAsync accepted message [%zu] for transmission to IoT Hub.\r\n", iterator);
AzureIoTClient 42:289de245ba1d 195 }
AzureIoTClient 42:289de245ba1d 196
AzureIoTClient 42:289de245ba1d 197 }
AzureIoTClient 42:289de245ba1d 198 }
AzureIoTClient 42:289de245ba1d 199 IoTHubClient_LL_DoWork(iotHubClientHandle);
AzureIoTClient 42:289de245ba1d 200 ThreadAPI_Sleep(1);
AzureIoTClient 42:289de245ba1d 201
AzureIoTClient 42:289de245ba1d 202 iterator++;
AzureIoTClient 42:289de245ba1d 203 } while (g_continueRunning);
Azure.IoT Build 46:91bd03862871 204
Azure.IoT Build 46:91bd03862871 205 (void)printf("iothub_client_sample_mqtt has gotten quit message, call DoWork %d more time to complete final sending...\r\n", DOWORK_LOOP_NUM);
Azure.IoT Build 46:91bd03862871 206 for (size_t index = 0; index < DOWORK_LOOP_NUM; index++)
Azure.IoT Build 46:91bd03862871 207 {
Azure.IoT Build 46:91bd03862871 208 IoTHubClient_LL_DoWork(iotHubClientHandle);
Azure.IoT Build 46:91bd03862871 209 ThreadAPI_Sleep(1);
Azure.IoT Build 46:91bd03862871 210 }
Azure.IoT Build 33:f8eb46ca453d 211 }
Azure.IoT Build 33:f8eb46ca453d 212 IoTHubClient_LL_Destroy(iotHubClientHandle);
AzureIoTClient 18:e3e29fc771c9 213 }
Azure.IoT Build 33:f8eb46ca453d 214 platform_deinit();
AzureIoTClient 18:e3e29fc771c9 215 }
AzureIoTClient 18:e3e29fc771c9 216 }
AzureIoTClient 42:289de245ba1d 217
AzureIoTClient 42:289de245ba1d 218 int main(void)
AzureIoTClient 42:289de245ba1d 219 {
AzureIoTClient 42:289de245ba1d 220 iothub_client_sample_http_run();
AzureIoTClient 42:289de245ba1d 221 return 0;
AzureIoTClient 42:289de245ba1d 222 }