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:
Azure.IoT Build
Date:
Fri Mar 11 17:04:20 2016 -0800
Revision:
28:44b1d44d0d3b
Parent:
20:188fd25e65fc
Child:
34:e8375a90f09f
1.0.2

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