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@46:91bd03862871, 2016-07-01 (annotated)
- 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?
User | Revision | Line number | New 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 | } |