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:
Sat Jan 28 09:37:24 2017 -0800
Revision:
56:99dabe3ce9ff
Parent:
51:718bee5b02c2
Child:
64:0cdbc7c1cecc
1.1.6

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
AzureIoTClient 19:253a0a1ea1c5 14 #ifdef ARDUINO
AzureIoTClient 49:6f4fa05511db 15 #include "AzureIoTHub.h"
AzureIoTClient 19:253a0a1ea1c5 16 #else
Azure.IoT Build 41:4080293252bc 17 #include "azure_c_shared_utility/threadapi.h"
Azure.IoT Build 41:4080293252bc 18 #include "azure_c_shared_utility/platform.h"
AzureIoTClient 17:3abbcd6aac9f 19 #include "serializer.h"
AzureIoTClient 17:3abbcd6aac9f 20 #include "iothub_client_ll.h"
AzureIoTClient 17:3abbcd6aac9f 21 #include "iothubtransporthttp.h"
AzureIoTClient 19:253a0a1ea1c5 22 #endif
AzureIoTClient 17:3abbcd6aac9f 23
AzureIoTClient 17:3abbcd6aac9f 24 #ifdef MBED_BUILD_TIMESTAMP
AzureIoTClient 17:3abbcd6aac9f 25 #include "certs.h"
AzureIoTClient 17:3abbcd6aac9f 26 #endif // MBED_BUILD_TIMESTAMP
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 17:3abbcd6aac9f 38 WITH_ACTION(TurnFanOn),
AzureIoTClient 17:3abbcd6aac9f 39 WITH_ACTION(TurnFanOff),
AzureIoTClient 17:3abbcd6aac9f 40 WITH_ACTION(SetAirResistance, int, Position)
AzureIoTClient 17:3abbcd6aac9f 41 );
AzureIoTClient 17:3abbcd6aac9f 42
AzureIoTClient 17:3abbcd6aac9f 43 END_NAMESPACE(WeatherStation);
AzureIoTClient 17:3abbcd6aac9f 44
AzureIoTClient 17:3abbcd6aac9f 45
AzureIoTClient 17:3abbcd6aac9f 46 EXECUTE_COMMAND_RESULT TurnFanOn(ContosoAnemometer* device)
AzureIoTClient 17:3abbcd6aac9f 47 {
AzureIoTClient 17:3abbcd6aac9f 48 (void)device;
AzureIoTClient 17:3abbcd6aac9f 49 (void)printf("Turning fan on.\r\n");
AzureIoTClient 17:3abbcd6aac9f 50 return EXECUTE_COMMAND_SUCCESS;
AzureIoTClient 17:3abbcd6aac9f 51 }
AzureIoTClient 17:3abbcd6aac9f 52
AzureIoTClient 17:3abbcd6aac9f 53 EXECUTE_COMMAND_RESULT TurnFanOff(ContosoAnemometer* device)
AzureIoTClient 17:3abbcd6aac9f 54 {
AzureIoTClient 17:3abbcd6aac9f 55 (void)device;
AzureIoTClient 17:3abbcd6aac9f 56 (void)printf("Turning fan off.\r\n");
AzureIoTClient 17:3abbcd6aac9f 57 return EXECUTE_COMMAND_SUCCESS;
AzureIoTClient 17:3abbcd6aac9f 58 }
AzureIoTClient 17:3abbcd6aac9f 59
AzureIoTClient 17:3abbcd6aac9f 60 EXECUTE_COMMAND_RESULT SetAirResistance(ContosoAnemometer* device, int Position)
AzureIoTClient 17:3abbcd6aac9f 61 {
AzureIoTClient 17:3abbcd6aac9f 62 (void)device;
AzureIoTClient 17:3abbcd6aac9f 63 (void)printf("Setting Air Resistance Position to %d.\r\n", Position);
AzureIoTClient 17:3abbcd6aac9f 64 return EXECUTE_COMMAND_SUCCESS;
AzureIoTClient 17:3abbcd6aac9f 65 }
AzureIoTClient 17:3abbcd6aac9f 66
AzureIoTClient 17:3abbcd6aac9f 67 void sendCallback(IOTHUB_CLIENT_CONFIRMATION_RESULT result, void* userContextCallback)
AzureIoTClient 17:3abbcd6aac9f 68 {
AzureIoTClient 42:fc9ef8d266b3 69 unsigned int messageTrackingId = (unsigned int)(uintptr_t)userContextCallback;
AzureIoTClient 17:3abbcd6aac9f 70
AzureIoTClient 42:fc9ef8d266b3 71 (void)printf("Message Id: %u Received.\r\n", messageTrackingId);
AzureIoTClient 17:3abbcd6aac9f 72
AzureIoTClient 17:3abbcd6aac9f 73 (void)printf("Result Call Back Called! Result is: %s \r\n", ENUM_TO_STRING(IOTHUB_CLIENT_CONFIRMATION_RESULT, result));
AzureIoTClient 17:3abbcd6aac9f 74 }
AzureIoTClient 17:3abbcd6aac9f 75
AzureIoTClient 17:3abbcd6aac9f 76 static void sendMessage(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, const unsigned char* buffer, size_t size)
AzureIoTClient 17:3abbcd6aac9f 77 {
AzureIoTClient 17:3abbcd6aac9f 78 static unsigned int messageTrackingId;
AzureIoTClient 17:3abbcd6aac9f 79 IOTHUB_MESSAGE_HANDLE messageHandle = IoTHubMessage_CreateFromByteArray(buffer, size);
AzureIoTClient 17:3abbcd6aac9f 80 if (messageHandle == NULL)
AzureIoTClient 17:3abbcd6aac9f 81 {
AzureIoTClient 17:3abbcd6aac9f 82 printf("unable to create a new IoTHubMessage\r\n");
AzureIoTClient 17:3abbcd6aac9f 83 }
AzureIoTClient 17:3abbcd6aac9f 84 else
AzureIoTClient 17:3abbcd6aac9f 85 {
AzureIoTClient 17:3abbcd6aac9f 86 if (IoTHubClient_LL_SendEventAsync(iotHubClientHandle, messageHandle, sendCallback, (void*)(uintptr_t)messageTrackingId) != IOTHUB_CLIENT_OK)
AzureIoTClient 17:3abbcd6aac9f 87 {
AzureIoTClient 17:3abbcd6aac9f 88 printf("failed to hand over the message to IoTHubClient");
AzureIoTClient 17:3abbcd6aac9f 89 }
AzureIoTClient 17:3abbcd6aac9f 90 else
AzureIoTClient 17:3abbcd6aac9f 91 {
AzureIoTClient 17:3abbcd6aac9f 92 printf("IoTHubClient accepted the message for delivery\r\n");
AzureIoTClient 17:3abbcd6aac9f 93 }
AzureIoTClient 17:3abbcd6aac9f 94 IoTHubMessage_Destroy(messageHandle);
AzureIoTClient 17:3abbcd6aac9f 95 }
AzureIoTClient 17:3abbcd6aac9f 96 free((void*)buffer);
AzureIoTClient 17:3abbcd6aac9f 97 messageTrackingId++;
AzureIoTClient 17:3abbcd6aac9f 98 }
AzureIoTClient 17:3abbcd6aac9f 99
AzureIoTClient 17:3abbcd6aac9f 100 /*this function "links" IoTHub to the serialization library*/
AzureIoTClient 17:3abbcd6aac9f 101 static IOTHUBMESSAGE_DISPOSITION_RESULT IoTHubMessage(IOTHUB_MESSAGE_HANDLE message, void* userContextCallback)
AzureIoTClient 17:3abbcd6aac9f 102 {
AzureIoTClient 17:3abbcd6aac9f 103 IOTHUBMESSAGE_DISPOSITION_RESULT result;
AzureIoTClient 17:3abbcd6aac9f 104 const unsigned char* buffer;
AzureIoTClient 17:3abbcd6aac9f 105 size_t size;
AzureIoTClient 17:3abbcd6aac9f 106 if (IoTHubMessage_GetByteArray(message, &buffer, &size) != IOTHUB_MESSAGE_OK)
AzureIoTClient 17:3abbcd6aac9f 107 {
AzureIoTClient 17:3abbcd6aac9f 108 printf("unable to IoTHubMessage_GetByteArray\r\n");
AzureIoTClient 56:99dabe3ce9ff 109 result = IOTHUBMESSAGE_ABANDONED;
AzureIoTClient 17:3abbcd6aac9f 110 }
AzureIoTClient 17:3abbcd6aac9f 111 else
AzureIoTClient 17:3abbcd6aac9f 112 {
AzureIoTClient 17:3abbcd6aac9f 113 /*buffer is not zero terminated*/
AzureIoTClient 17:3abbcd6aac9f 114 char* temp = malloc(size + 1);
AzureIoTClient 17:3abbcd6aac9f 115 if (temp == NULL)
AzureIoTClient 17:3abbcd6aac9f 116 {
AzureIoTClient 17:3abbcd6aac9f 117 printf("failed to malloc\r\n");
AzureIoTClient 56:99dabe3ce9ff 118 result = IOTHUBMESSAGE_ABANDONED;
AzureIoTClient 17:3abbcd6aac9f 119 }
AzureIoTClient 17:3abbcd6aac9f 120 else
AzureIoTClient 17:3abbcd6aac9f 121 {
AzureIoTClient 19:253a0a1ea1c5 122 EXECUTE_COMMAND_RESULT executeCommandResult;
AzureIoTClient 19:253a0a1ea1c5 123
AzureIoTClient 56:99dabe3ce9ff 124 (void)memcpy(temp, buffer, size);
AzureIoTClient 17:3abbcd6aac9f 125 temp[size] = '\0';
AzureIoTClient 19:253a0a1ea1c5 126 executeCommandResult = EXECUTE_COMMAND(userContextCallback, temp);
AzureIoTClient 17:3abbcd6aac9f 127 result =
AzureIoTClient 17:3abbcd6aac9f 128 (executeCommandResult == EXECUTE_COMMAND_ERROR) ? IOTHUBMESSAGE_ABANDONED :
AzureIoTClient 17:3abbcd6aac9f 129 (executeCommandResult == EXECUTE_COMMAND_SUCCESS) ? IOTHUBMESSAGE_ACCEPTED :
AzureIoTClient 17:3abbcd6aac9f 130 IOTHUBMESSAGE_REJECTED;
AzureIoTClient 17:3abbcd6aac9f 131 free(temp);
AzureIoTClient 17:3abbcd6aac9f 132 }
AzureIoTClient 17:3abbcd6aac9f 133 }
AzureIoTClient 17:3abbcd6aac9f 134 return result;
AzureIoTClient 17:3abbcd6aac9f 135 }
AzureIoTClient 17:3abbcd6aac9f 136
AzureIoTClient 17:3abbcd6aac9f 137 void simplesample_http_run(void)
AzureIoTClient 17:3abbcd6aac9f 138 {
Azure.IoT Build 28:44b1d44d0d3b 139 if (platform_init() != 0)
AzureIoTClient 17:3abbcd6aac9f 140 {
Azure.IoT Build 28:44b1d44d0d3b 141 printf("Failed to initialize the platform.\r\n");
AzureIoTClient 17:3abbcd6aac9f 142 }
AzureIoTClient 17:3abbcd6aac9f 143 else
AzureIoTClient 17:3abbcd6aac9f 144 {
Azure.IoT Build 28:44b1d44d0d3b 145 if (serializer_init(NULL) != SERIALIZER_OK)
AzureIoTClient 17:3abbcd6aac9f 146 {
Azure.IoT Build 28:44b1d44d0d3b 147 (void)printf("Failed on serializer_init\r\n");
AzureIoTClient 17:3abbcd6aac9f 148 }
AzureIoTClient 17:3abbcd6aac9f 149 else
AzureIoTClient 17:3abbcd6aac9f 150 {
Azure.IoT Build 28:44b1d44d0d3b 151 IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle = IoTHubClient_LL_CreateFromConnectionString(connectionString, HTTP_Protocol);
Azure.IoT Build 28:44b1d44d0d3b 152 int avgWindSpeed = 10;
AzureIoTClient 17:3abbcd6aac9f 153
Azure.IoT Build 28:44b1d44d0d3b 154 srand((unsigned int)time(NULL));
Azure.IoT Build 28:44b1d44d0d3b 155
Azure.IoT Build 28:44b1d44d0d3b 156 if (iotHubClientHandle == NULL)
AzureIoTClient 17:3abbcd6aac9f 157 {
Azure.IoT Build 28:44b1d44d0d3b 158 (void)printf("Failed on IoTHubClient_LL_Create\r\n");
AzureIoTClient 17:3abbcd6aac9f 159 }
AzureIoTClient 17:3abbcd6aac9f 160 else
AzureIoTClient 17:3abbcd6aac9f 161 {
Azure.IoT Build 28:44b1d44d0d3b 162 // Because it can poll "after 9 seconds" polls will happen
Azure.IoT Build 28:44b1d44d0d3b 163 // effectively at ~10 seconds.
Azure.IoT Build 28:44b1d44d0d3b 164 // Note that for scalabilty, the default value of minimumPollingTime
Azure.IoT Build 28:44b1d44d0d3b 165 // is 25 minutes. For more information, see:
Azure.IoT Build 28:44b1d44d0d3b 166 // https://azure.microsoft.com/documentation/articles/iot-hub-devguide/#messaging
Azure.IoT Build 28:44b1d44d0d3b 167 unsigned int minimumPollingTime = 9;
Azure.IoT Build 28:44b1d44d0d3b 168 ContosoAnemometer* myWeather;
Azure.IoT Build 28:44b1d44d0d3b 169
Azure.IoT Build 28:44b1d44d0d3b 170 if (IoTHubClient_LL_SetOption(iotHubClientHandle, "MinimumPollingTime", &minimumPollingTime) != IOTHUB_CLIENT_OK)
AzureIoTClient 17:3abbcd6aac9f 171 {
Azure.IoT Build 28:44b1d44d0d3b 172 printf("failure to set option \"MinimumPollingTime\"\r\n");
Azure.IoT Build 28:44b1d44d0d3b 173 }
Azure.IoT Build 28:44b1d44d0d3b 174
Azure.IoT Build 28:44b1d44d0d3b 175 #ifdef MBED_BUILD_TIMESTAMP
Azure.IoT Build 28:44b1d44d0d3b 176 // For mbed add the certificate information
Azure.IoT Build 28:44b1d44d0d3b 177 if (IoTHubClient_LL_SetOption(iotHubClientHandle, "TrustedCerts", certificates) != IOTHUB_CLIENT_OK)
Azure.IoT Build 28:44b1d44d0d3b 178 {
Azure.IoT Build 28:44b1d44d0d3b 179 (void)printf("failure to set option \"TrustedCerts\"\r\n");
Azure.IoT Build 28:44b1d44d0d3b 180 }
Azure.IoT Build 28:44b1d44d0d3b 181 #endif // MBED_BUILD_TIMESTAMP
Azure.IoT Build 28:44b1d44d0d3b 182
Azure.IoT Build 28:44b1d44d0d3b 183 myWeather = CREATE_MODEL_INSTANCE(WeatherStation, ContosoAnemometer);
Azure.IoT Build 28:44b1d44d0d3b 184 if (myWeather == NULL)
Azure.IoT Build 28:44b1d44d0d3b 185 {
Azure.IoT Build 28:44b1d44d0d3b 186 (void)printf("Failed on CREATE_MODEL_INSTANCE\r\n");
AzureIoTClient 17:3abbcd6aac9f 187 }
AzureIoTClient 17:3abbcd6aac9f 188 else
AzureIoTClient 17:3abbcd6aac9f 189 {
Azure.IoT Build 28:44b1d44d0d3b 190 if (IoTHubClient_LL_SetMessageCallback(iotHubClientHandle, IoTHubMessage, myWeather) != IOTHUB_CLIENT_OK)
AzureIoTClient 17:3abbcd6aac9f 191 {
Azure.IoT Build 28:44b1d44d0d3b 192 printf("unable to IoTHubClient_SetMessageCallback\r\n");
Azure.IoT Build 28:44b1d44d0d3b 193 }
Azure.IoT Build 28:44b1d44d0d3b 194 else
Azure.IoT Build 28:44b1d44d0d3b 195 {
Azure.IoT Build 28:44b1d44d0d3b 196 myWeather->DeviceId = "myFirstDevice";
Azure.IoT Build 28:44b1d44d0d3b 197 myWeather->WindSpeed = avgWindSpeed + (rand() % 4 + 2);
AzureIoTClient 17:3abbcd6aac9f 198 {
Azure.IoT Build 28:44b1d44d0d3b 199 unsigned char* destination;
Azure.IoT Build 28:44b1d44d0d3b 200 size_t destinationSize;
AzureIoTClient 51:718bee5b02c2 201 if (SERIALIZE(&destination, &destinationSize, myWeather->DeviceId, myWeather->WindSpeed) != CODEFIRST_OK)
AzureIoTClient 17:3abbcd6aac9f 202 {
Azure.IoT Build 28:44b1d44d0d3b 203 (void)printf("Failed to serialize\r\n");
AzureIoTClient 17:3abbcd6aac9f 204 }
AzureIoTClient 17:3abbcd6aac9f 205 else
AzureIoTClient 17:3abbcd6aac9f 206 {
Azure.IoT Build 28:44b1d44d0d3b 207 IOTHUB_MESSAGE_HANDLE messageHandle = IoTHubMessage_CreateFromByteArray(destination, destinationSize);
Azure.IoT Build 28:44b1d44d0d3b 208 if (messageHandle == NULL)
AzureIoTClient 17:3abbcd6aac9f 209 {
Azure.IoT Build 28:44b1d44d0d3b 210 printf("unable to create a new IoTHubMessage\r\n");
AzureIoTClient 17:3abbcd6aac9f 211 }
AzureIoTClient 17:3abbcd6aac9f 212 else
AzureIoTClient 17:3abbcd6aac9f 213 {
Azure.IoT Build 28:44b1d44d0d3b 214 if (IoTHubClient_LL_SendEventAsync(iotHubClientHandle, messageHandle, sendCallback, (void*)1) != IOTHUB_CLIENT_OK)
Azure.IoT Build 28:44b1d44d0d3b 215 {
Azure.IoT Build 28:44b1d44d0d3b 216 printf("failed to hand over the message to IoTHubClient");
Azure.IoT Build 28:44b1d44d0d3b 217 }
Azure.IoT Build 28:44b1d44d0d3b 218 else
Azure.IoT Build 28:44b1d44d0d3b 219 {
Azure.IoT Build 28:44b1d44d0d3b 220 printf("IoTHubClient accepted the message for delivery\r\n");
Azure.IoT Build 28:44b1d44d0d3b 221 }
AzureIoTClient 17:3abbcd6aac9f 222
Azure.IoT Build 28:44b1d44d0d3b 223 IoTHubMessage_Destroy(messageHandle);
Azure.IoT Build 28:44b1d44d0d3b 224 }
Azure.IoT Build 28:44b1d44d0d3b 225 free(destination);
AzureIoTClient 17:3abbcd6aac9f 226 }
Azure.IoT Build 28:44b1d44d0d3b 227 }
Azure.IoT Build 28:44b1d44d0d3b 228
Azure.IoT Build 28:44b1d44d0d3b 229 /* wait for commands */
Azure.IoT Build 28:44b1d44d0d3b 230 while (1)
Azure.IoT Build 28:44b1d44d0d3b 231 {
Azure.IoT Build 28:44b1d44d0d3b 232 IoTHubClient_LL_DoWork(iotHubClientHandle);
Azure.IoT Build 28:44b1d44d0d3b 233 ThreadAPI_Sleep(100);
AzureIoTClient 17:3abbcd6aac9f 234 }
AzureIoTClient 17:3abbcd6aac9f 235 }
AzureIoTClient 17:3abbcd6aac9f 236
Azure.IoT Build 28:44b1d44d0d3b 237 DESTROY_MODEL_INSTANCE(myWeather);
AzureIoTClient 17:3abbcd6aac9f 238 }
Azure.IoT Build 28:44b1d44d0d3b 239 IoTHubClient_LL_Destroy(iotHubClientHandle);
AzureIoTClient 17:3abbcd6aac9f 240 }
Azure.IoT Build 28:44b1d44d0d3b 241 serializer_deinit();
AzureIoTClient 17:3abbcd6aac9f 242 }
Azure.IoT Build 28:44b1d44d0d3b 243 platform_deinit();
AzureIoTClient 17:3abbcd6aac9f 244 }
AzureIoTClient 17:3abbcd6aac9f 245 }