Microsoft Azure IoTHub client libraries

Dependents:   sht15_remote_monitoring RobotArmDemo iothub_client_sample_amqp f767zi_mqtt ... more

This library implements the Microsoft Azure IoTHub client library. The code is replicated from https://github.com/Azure/azure-iot-sdks

Committer:
Azure.IoT Build
Date:
Thu Feb 04 11:28:52 2016 -0800
Revision:
34:578a1a3636cc
Parent:
33:b372b0efcd20
Child:
36:67300d5a4c1f
1.0.0

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AzureIoTClient 16:deba40344375 1 // Copyright (c) Microsoft. All rights reserved.
AzureIoTClient 16:deba40344375 2 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
AzureIoTClient 16:deba40344375 3
AzureIoTClient 16:deba40344375 4 #include <stdlib.h>
AzureIoTClient 16:deba40344375 5 #ifdef _CRTDBG_MAP_ALLOC
AzureIoTClient 16:deba40344375 6 #include <crtdbg.h>
AzureIoTClient 16:deba40344375 7 #endif
AzureIoTClient 16:deba40344375 8 #include "gballoc.h"
AzureIoTClient 16:deba40344375 9 #include "string.h"
AzureIoTClient 16:deba40344375 10 #include "string_tokenizer.h"
AzureIoTClient 16:deba40344375 11
AzureIoTClient 16:deba40344375 12 #include "iothub_client_ll.h"
AzureIoTClient 16:deba40344375 13 #include "iothub_client_private.h"
AzureIoTClient 16:deba40344375 14 #include "doublylinkedlist.h"
AzureIoTClient 33:b372b0efcd20 15 #include "iothub_client_version.h"
AzureIoTClient 16:deba40344375 16
AzureIoTClient 16:deba40344375 17 #include "iot_logging.h"
AzureIoTClient 16:deba40344375 18
AzureIoTClient 16:deba40344375 19 #define LOG_ERROR LogError("result = %s\r\n", ENUM_TO_STRING(IOTHUB_CLIENT_RESULT, result));
AzureIoTClient 16:deba40344375 20 #define INDEFINITE_TIME ((time_t)(-1))
AzureIoTClient 16:deba40344375 21
AzureIoTClient 16:deba40344375 22 DEFINE_ENUM_STRINGS(IOTHUB_CLIENT_RESULT, IOTHUB_CLIENT_RESULT_VALUES);
AzureIoTClient 16:deba40344375 23
AzureIoTClient 16:deba40344375 24 typedef struct IOTHUB_CLIENT_LL_HANDLE_DATA_TAG
AzureIoTClient 16:deba40344375 25 {
AzureIoTClient 16:deba40344375 26 DLIST_ENTRY waitingToSend;
AzureIoTClient 16:deba40344375 27 TRANSPORT_HANDLE transportHandle;
AzureIoTClient 16:deba40344375 28 TRANSPORT_PROVIDER_FIELDS;
AzureIoTClient 16:deba40344375 29 IOTHUB_CLIENT_MESSAGE_CALLBACK_ASYNC messageCallback;
AzureIoTClient 16:deba40344375 30 void* messageUserContextCallback;
AzureIoTClient 16:deba40344375 31 time_t lastMessageReceiveTime;
AzureIoTClient 16:deba40344375 32 }IOTHUB_CLIENT_LL_HANDLE_DATA;
AzureIoTClient 16:deba40344375 33
AzureIoTClient 16:deba40344375 34 static const char HOSTNAME_TOKEN[] = "HostName";
AzureIoTClient 16:deba40344375 35 static const char DEVICEID_TOKEN[] = "DeviceId";
AzureIoTClient 16:deba40344375 36 static const char DEVICEKEY_TOKEN[] = "SharedAccessKey";
AzureIoTClient 16:deba40344375 37 static const char PROTOCOL_GATEWAY_HOST[] = "GatewayHostName";
AzureIoTClient 16:deba40344375 38
AzureIoTClient 16:deba40344375 39 IOTHUB_CLIENT_LL_HANDLE IoTHubClient_LL_CreateFromConnectionString(const char* connectionString, IOTHUB_CLIENT_TRANSPORT_PROVIDER protocol)
AzureIoTClient 16:deba40344375 40 {
AzureIoTClient 32:6e9d81a62085 41 IOTHUB_CLIENT_LL_HANDLE result = NULL;
AzureIoTClient 16:deba40344375 42
AzureIoTClient 16:deba40344375 43 /*Codes_SRS_IOTHUBCLIENT_LL_05_001: [IoTHubClient_LL_CreateFromConnectionString shall obtain the version string by a call to IoTHubClient_GetVersionString.]*/
AzureIoTClient 16:deba40344375 44 /*Codes_SRS_IOTHUBCLIENT_LL_05_002: [IoTHubClient_LL_CreateFromConnectionString shall print the version string to standard output.]*/
AzureIoTClient 16:deba40344375 45 LogInfo("IoT Hub SDK for C, version %s\r\n", IoTHubClient_GetVersionString());
AzureIoTClient 16:deba40344375 46
AzureIoTClient 16:deba40344375 47 /* SRS_IOTHUBCLIENT_LL_12_003: [IoTHubClient_LL_CreateFromConnectionString shall verify the input parameter and if it is NULL then return NULL] */
AzureIoTClient 16:deba40344375 48 if (connectionString == NULL)
AzureIoTClient 16:deba40344375 49 {
AzureIoTClient 16:deba40344375 50 LogError("Input parameter is NULL: connectionString\r\n");
AzureIoTClient 16:deba40344375 51 }
AzureIoTClient 16:deba40344375 52 else if (protocol == NULL)
AzureIoTClient 16:deba40344375 53 {
AzureIoTClient 16:deba40344375 54 LogError("Input parameter is NULL: protocol\r\n");
AzureIoTClient 16:deba40344375 55 }
AzureIoTClient 16:deba40344375 56 else
AzureIoTClient 16:deba40344375 57 {
AzureIoTClient 16:deba40344375 58 /* SRS_IOTHUBCLIENT_LL_12_004: [IoTHubClient_LL_CreateFromConnectionString shall allocate IOTHUB_CLIENT_CONFIG structure] */
AzureIoTClient 16:deba40344375 59 IOTHUB_CLIENT_CONFIG* config = malloc(sizeof(IOTHUB_CLIENT_CONFIG));
AzureIoTClient 16:deba40344375 60 if (config == NULL)
AzureIoTClient 16:deba40344375 61 {
AzureIoTClient 16:deba40344375 62 /* SRS_IOTHUBCLIENT_LL_12_012: [If the allocation failed IoTHubClient_LL_CreateFromConnectionString returns NULL] */
AzureIoTClient 16:deba40344375 63 LogError("Malloc failed\r\n");
AzureIoTClient 16:deba40344375 64 return NULL;
AzureIoTClient 16:deba40344375 65 }
AzureIoTClient 16:deba40344375 66 else
AzureIoTClient 16:deba40344375 67 {
AzureIoTClient 16:deba40344375 68 STRING_TOKENIZER_HANDLE tokenizer1 = NULL;
AzureIoTClient 16:deba40344375 69 STRING_HANDLE connString = NULL;
AzureIoTClient 16:deba40344375 70 STRING_HANDLE tokenString = NULL;
AzureIoTClient 16:deba40344375 71 STRING_HANDLE valueString = NULL;
AzureIoTClient 16:deba40344375 72 STRING_HANDLE hostNameString = NULL;
AzureIoTClient 16:deba40344375 73 STRING_HANDLE hostSuffixString = NULL;
AzureIoTClient 16:deba40344375 74 STRING_HANDLE deviceIdString = NULL;
AzureIoTClient 16:deba40344375 75 STRING_HANDLE deviceKeyString = NULL;
AzureIoTClient 16:deba40344375 76 STRING_HANDLE protocolGateway = NULL;
AzureIoTClient 16:deba40344375 77
AzureIoTClient 16:deba40344375 78 config->protocol = protocol;
AzureIoTClient 16:deba40344375 79
AzureIoTClient 16:deba40344375 80 config->iotHubName = NULL;
AzureIoTClient 16:deba40344375 81 config->iotHubSuffix = NULL;
AzureIoTClient 16:deba40344375 82 config->deviceId = NULL;
AzureIoTClient 16:deba40344375 83 config->deviceKey = NULL;
AzureIoTClient 31:741eacddf296 84 /* Codes_SRS_IOTHUBCLIENT_LL_04_002: [If it does not, it shall pass the protocolGatewayHostName NULL.] */
AzureIoTClient 31:741eacddf296 85 config->protocolGatewayHostName = NULL;
AzureIoTClient 16:deba40344375 86
AzureIoTClient 16:deba40344375 87 if ((connString = STRING_construct(connectionString)) == NULL)
AzureIoTClient 16:deba40344375 88 {
AzureIoTClient 16:deba40344375 89 LogError("Error constructing connectiong String\r\n");
AzureIoTClient 16:deba40344375 90 }
AzureIoTClient 16:deba40344375 91 else if ((tokenizer1 = STRING_TOKENIZER_create(connString)) == NULL)
AzureIoTClient 16:deba40344375 92 {
AzureIoTClient 16:deba40344375 93 LogError("Error creating Tokenizer\r\n");
AzureIoTClient 16:deba40344375 94 }
AzureIoTClient 16:deba40344375 95 else if ((tokenString = STRING_new()) == NULL)
AzureIoTClient 16:deba40344375 96 {
AzureIoTClient 16:deba40344375 97 LogError("Error creating Token String\r\n");
AzureIoTClient 16:deba40344375 98 }
AzureIoTClient 16:deba40344375 99 else if ((valueString = STRING_new()) == NULL)
AzureIoTClient 16:deba40344375 100 {
AzureIoTClient 16:deba40344375 101 LogError("Error creating Value String\r\n");
AzureIoTClient 16:deba40344375 102 }
AzureIoTClient 16:deba40344375 103 else if ((hostNameString = STRING_new()) == NULL)
AzureIoTClient 16:deba40344375 104 {
AzureIoTClient 16:deba40344375 105 LogError("Error creating HostName String\r\n");
AzureIoTClient 16:deba40344375 106 }
AzureIoTClient 16:deba40344375 107 else if ((hostSuffixString = STRING_new()) == NULL)
AzureIoTClient 16:deba40344375 108 {
AzureIoTClient 16:deba40344375 109 LogError("Error creating HostSuffix String\r\n");
AzureIoTClient 16:deba40344375 110 }
AzureIoTClient 16:deba40344375 111 /* SRS_IOTHUBCLIENT_LL_12_005: [IoTHubClient_LL_CreateFromConnectionString shall try to parse the connectionString input parameter for the following structure: "Key1=value1;key2=value2;key3=value3..."] */
AzureIoTClient 16:deba40344375 112 /* SRS_IOTHUBCLIENT_LL_12_006: [IoTHubClient_LL_CreateFromConnectionString shall verify the existence of the following Key/Value pairs in the connection string: HostName, DeviceId, SharedAccessKey.] */
AzureIoTClient 16:deba40344375 113 else
AzureIoTClient 16:deba40344375 114 {
AzureIoTClient 16:deba40344375 115 while ((STRING_TOKENIZER_get_next_token(tokenizer1, tokenString, "=") == 0))
AzureIoTClient 16:deba40344375 116 {
AzureIoTClient 16:deba40344375 117 if (STRING_TOKENIZER_get_next_token(tokenizer1, valueString, ";") != 0)
AzureIoTClient 16:deba40344375 118 {
AzureIoTClient 16:deba40344375 119 LogError("Tokenizer error\r\n");
AzureIoTClient 16:deba40344375 120 break;
AzureIoTClient 16:deba40344375 121 }
AzureIoTClient 16:deba40344375 122 else
AzureIoTClient 16:deba40344375 123 {
AzureIoTClient 16:deba40344375 124 if (tokenString != NULL)
AzureIoTClient 16:deba40344375 125 {
AzureIoTClient 16:deba40344375 126 /* SRS_IOTHUBCLIENT_LL_12_010: [IoTHubClient_LL_CreateFromConnectionString shall fill up the IOTHUB_CLIENT_CONFIG structure using the following mapping: iotHubName = Name, iotHubSuffix = Suffix, deviceId = DeviceId, deviceKey = SharedAccessKey] */
AzureIoTClient 16:deba40344375 127 const char* s_token = STRING_c_str(tokenString);
AzureIoTClient 31:741eacddf296 128 if (strcmp(s_token, HOSTNAME_TOKEN) == 0)
AzureIoTClient 16:deba40344375 129 {
AzureIoTClient 16:deba40344375 130 /* SRS_IOTHUBCLIENT_LL_12_009: [IoTHubClient_LL_CreateFromConnectionString shall split the value of HostName to Name and Suffix using the first "." as a separator] */
AzureIoTClient 16:deba40344375 131 STRING_TOKENIZER_HANDLE tokenizer2 = NULL;
AzureIoTClient 16:deba40344375 132 if ((tokenizer2 = STRING_TOKENIZER_create(valueString)) == NULL)
AzureIoTClient 16:deba40344375 133 {
AzureIoTClient 16:deba40344375 134 LogError("Error creating Tokenizer\r\n");
AzureIoTClient 16:deba40344375 135 break;
AzureIoTClient 16:deba40344375 136 }
AzureIoTClient 16:deba40344375 137 else
AzureIoTClient 16:deba40344375 138 {
AzureIoTClient 16:deba40344375 139 /* SRS_IOTHUBCLIENT_LL_12_015: [If the string split failed, IoTHubClient_LL_CreateFromConnectionString returns NULL ] */
AzureIoTClient 16:deba40344375 140 if (STRING_TOKENIZER_get_next_token(tokenizer2, hostNameString, ".") != 0)
AzureIoTClient 16:deba40344375 141 {
AzureIoTClient 16:deba40344375 142 LogError("Tokenizer error\r\n");
AzureIoTClient 16:deba40344375 143 STRING_TOKENIZER_destroy(tokenizer2);
AzureIoTClient 16:deba40344375 144 break;
AzureIoTClient 16:deba40344375 145 }
AzureIoTClient 16:deba40344375 146 else
AzureIoTClient 16:deba40344375 147 {
AzureIoTClient 16:deba40344375 148 config->iotHubName = STRING_c_str(hostNameString);
AzureIoTClient 16:deba40344375 149 if (STRING_TOKENIZER_get_next_token(tokenizer2, hostSuffixString, ";") != 0)
AzureIoTClient 16:deba40344375 150 {
AzureIoTClient 16:deba40344375 151 LogError("Tokenizer error\r\n");
AzureIoTClient 16:deba40344375 152 STRING_TOKENIZER_destroy(tokenizer2);
AzureIoTClient 16:deba40344375 153 break;
AzureIoTClient 16:deba40344375 154 }
AzureIoTClient 16:deba40344375 155 else
AzureIoTClient 16:deba40344375 156 {
AzureIoTClient 16:deba40344375 157 config->iotHubSuffix = STRING_c_str(hostSuffixString);
AzureIoTClient 16:deba40344375 158 }
AzureIoTClient 16:deba40344375 159 }
AzureIoTClient 16:deba40344375 160 STRING_TOKENIZER_destroy(tokenizer2);
AzureIoTClient 16:deba40344375 161 }
AzureIoTClient 16:deba40344375 162 }
AzureIoTClient 16:deba40344375 163 else if (strcmp(s_token, DEVICEID_TOKEN) == 0)
AzureIoTClient 16:deba40344375 164 {
AzureIoTClient 16:deba40344375 165 deviceIdString = STRING_clone(valueString);
AzureIoTClient 16:deba40344375 166 if (deviceIdString != NULL)
AzureIoTClient 16:deba40344375 167 {
AzureIoTClient 16:deba40344375 168 config->deviceId = STRING_c_str(deviceIdString);
AzureIoTClient 16:deba40344375 169 }
AzureIoTClient 16:deba40344375 170 }
AzureIoTClient 16:deba40344375 171 else if (strcmp(s_token, DEVICEKEY_TOKEN) == 0)
AzureIoTClient 16:deba40344375 172 {
AzureIoTClient 16:deba40344375 173 deviceKeyString = STRING_clone(valueString);
AzureIoTClient 16:deba40344375 174 if (deviceKeyString != NULL)
AzureIoTClient 16:deba40344375 175 {
AzureIoTClient 16:deba40344375 176 config->deviceKey = STRING_c_str(deviceKeyString);
AzureIoTClient 16:deba40344375 177 }
AzureIoTClient 16:deba40344375 178 }
AzureIoTClient 31:741eacddf296 179 /* Codes_SRS_IOTHUBCLIENT_LL_04_001: [IoTHubClient_LL_CreateFromConnectionString shall verify the existence of key/value pair GatewayHostName. If it does exist it shall pass the value to IoTHubClient_LL_Create API.] */
AzureIoTClient 16:deba40344375 180 else if (strcmp(s_token, PROTOCOL_GATEWAY_HOST) == 0)
AzureIoTClient 16:deba40344375 181 {
AzureIoTClient 16:deba40344375 182 protocolGateway = STRING_clone(valueString);
AzureIoTClient 16:deba40344375 183 if (protocolGateway != NULL)
AzureIoTClient 16:deba40344375 184 {
AzureIoTClient 16:deba40344375 185 config->protocolGatewayHostName = STRING_c_str(protocolGateway);
AzureIoTClient 16:deba40344375 186 }
AzureIoTClient 16:deba40344375 187 }
AzureIoTClient 16:deba40344375 188 }
AzureIoTClient 16:deba40344375 189 }
AzureIoTClient 16:deba40344375 190 }
AzureIoTClient 16:deba40344375 191 /* parsing is done - check the result */
AzureIoTClient 16:deba40344375 192 if (config->iotHubName == NULL)
AzureIoTClient 16:deba40344375 193 {
AzureIoTClient 16:deba40344375 194 LogError("iotHubName is not found\r\n");
AzureIoTClient 16:deba40344375 195 }
AzureIoTClient 16:deba40344375 196 else if (config->iotHubSuffix == NULL)
AzureIoTClient 16:deba40344375 197 {
AzureIoTClient 16:deba40344375 198 LogError("iotHubSuffix is not found\r\n");
AzureIoTClient 16:deba40344375 199 }
AzureIoTClient 16:deba40344375 200 else if (config->deviceId == NULL)
AzureIoTClient 16:deba40344375 201 {
AzureIoTClient 16:deba40344375 202 LogError("deviceId is not found\r\n");
AzureIoTClient 16:deba40344375 203 }
AzureIoTClient 16:deba40344375 204 else if (config->deviceKey == NULL)
AzureIoTClient 16:deba40344375 205 {
AzureIoTClient 16:deba40344375 206 LogError("deviceId is not found\r\n");
AzureIoTClient 16:deba40344375 207 }
AzureIoTClient 16:deba40344375 208 else
AzureIoTClient 16:deba40344375 209 {
AzureIoTClient 16:deba40344375 210 /* SRS_IOTHUBCLIENT_LL_12_011: [IoTHubClient_LL_CreateFromConnectionString shall call into the IoTHubClient_LL_Create API with the current structure and returns with the return value of it] */
AzureIoTClient 16:deba40344375 211 result = IoTHubClient_LL_Create(config);
AzureIoTClient 16:deba40344375 212 if (result == NULL)
AzureIoTClient 16:deba40344375 213 {
AzureIoTClient 16:deba40344375 214 LogError("IoTHubClient_LL_Create failed\r\n");
AzureIoTClient 16:deba40344375 215 }
AzureIoTClient 16:deba40344375 216 }
AzureIoTClient 16:deba40344375 217 }
AzureIoTClient 16:deba40344375 218 if (deviceKeyString != NULL)
AzureIoTClient 16:deba40344375 219 STRING_delete(deviceKeyString);
AzureIoTClient 16:deba40344375 220 if (deviceIdString != NULL)
AzureIoTClient 16:deba40344375 221 STRING_delete(deviceIdString);
AzureIoTClient 16:deba40344375 222 if (hostSuffixString != NULL)
AzureIoTClient 16:deba40344375 223 STRING_delete(hostSuffixString);
AzureIoTClient 16:deba40344375 224 if (hostNameString != NULL)
AzureIoTClient 16:deba40344375 225 STRING_delete(hostNameString);
AzureIoTClient 16:deba40344375 226 if (valueString != NULL)
AzureIoTClient 16:deba40344375 227 STRING_delete(valueString);
AzureIoTClient 16:deba40344375 228 if (tokenString != NULL)
AzureIoTClient 16:deba40344375 229 STRING_delete(tokenString);
AzureIoTClient 16:deba40344375 230 if (connString != NULL)
AzureIoTClient 16:deba40344375 231 STRING_delete(connString);
AzureIoTClient 16:deba40344375 232 if (protocolGateway != NULL)
AzureIoTClient 16:deba40344375 233 STRING_delete(protocolGateway);
AzureIoTClient 16:deba40344375 234
AzureIoTClient 16:deba40344375 235 if (tokenizer1 != NULL)
AzureIoTClient 16:deba40344375 236 STRING_TOKENIZER_destroy(tokenizer1);
AzureIoTClient 16:deba40344375 237
AzureIoTClient 16:deba40344375 238 free(config);
AzureIoTClient 16:deba40344375 239 }
AzureIoTClient 16:deba40344375 240 }
AzureIoTClient 16:deba40344375 241 return result;
AzureIoTClient 16:deba40344375 242 }
AzureIoTClient 16:deba40344375 243
AzureIoTClient 16:deba40344375 244
AzureIoTClient 16:deba40344375 245 IOTHUB_CLIENT_LL_HANDLE IoTHubClient_LL_Create(const IOTHUB_CLIENT_CONFIG* config)
AzureIoTClient 16:deba40344375 246 {
AzureIoTClient 16:deba40344375 247 IOTHUB_CLIENT_LL_HANDLE result;
AzureIoTClient 16:deba40344375 248 /*Codes_SRS_IOTHUBCLIENT_LL_02_001: [IoTHubClient_LL_Create shall return NULL if config parameter is NULL or protocol field is NULL.]*/
AzureIoTClient 16:deba40344375 249 if (
AzureIoTClient 16:deba40344375 250 (config == NULL) ||
AzureIoTClient 16:deba40344375 251 (config->protocol == NULL)
AzureIoTClient 16:deba40344375 252 )
AzureIoTClient 16:deba40344375 253 {
AzureIoTClient 16:deba40344375 254 result = NULL;
AzureIoTClient 16:deba40344375 255 LogError("invalid configuration (NULL detected)\r\n");
AzureIoTClient 16:deba40344375 256 }
AzureIoTClient 16:deba40344375 257 else
AzureIoTClient 16:deba40344375 258 {
AzureIoTClient 16:deba40344375 259 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)malloc(sizeof(IOTHUB_CLIENT_LL_HANDLE_DATA));
AzureIoTClient 16:deba40344375 260 if (handleData == NULL)
AzureIoTClient 16:deba40344375 261 {
AzureIoTClient 16:deba40344375 262 LogError("malloc failed\r\n");
AzureIoTClient 16:deba40344375 263 result = NULL;
AzureIoTClient 16:deba40344375 264 }
AzureIoTClient 16:deba40344375 265 else
AzureIoTClient 16:deba40344375 266 {
AzureIoTClient 16:deba40344375 267 /*Codes_SRS_IOTHUBCLIENT_LL_02_004: [Otherwise IoTHubClient_LL_Create shall initialize a new DLIST (further called "waitingToSend") containing records with fields of the following types: IOTHUB_MESSAGE_HANDLE, IOTHUB_CLIENT_EVENT_CONFIRMATION_CALLBACK, void*.]*/
AzureIoTClient 16:deba40344375 268 IOTHUBTRANSPORT_CONFIG lowerLayerConfig;
AzureIoTClient 16:deba40344375 269 DList_InitializeListHead(&(handleData->waitingToSend));
AzureIoTClient 16:deba40344375 270 handleData->IoTHubTransport_SetOption = ((TRANSPORT_PROVIDER*)config->protocol())->IoTHubTransport_SetOption;
AzureIoTClient 16:deba40344375 271 handleData->IoTHubTransport_Create = ((TRANSPORT_PROVIDER*)config->protocol())->IoTHubTransport_Create;
AzureIoTClient 16:deba40344375 272 handleData->IoTHubTransport_Destroy = ((TRANSPORT_PROVIDER*)config->protocol())->IoTHubTransport_Destroy;
AzureIoTClient 16:deba40344375 273 handleData->IoTHubTransport_Subscribe = ((TRANSPORT_PROVIDER*)config->protocol())->IoTHubTransport_Subscribe;
AzureIoTClient 16:deba40344375 274 handleData->IoTHubTransport_Unsubscribe = ((TRANSPORT_PROVIDER*)config->protocol())->IoTHubTransport_Unsubscribe;
AzureIoTClient 16:deba40344375 275 handleData->IoTHubTransport_DoWork = ((TRANSPORT_PROVIDER*)config->protocol())->IoTHubTransport_DoWork;
AzureIoTClient 16:deba40344375 276 handleData->IoTHubTransport_GetSendStatus = ((TRANSPORT_PROVIDER*)config->protocol())->IoTHubTransport_GetSendStatus;
AzureIoTClient 16:deba40344375 277 handleData->messageCallback = NULL;
AzureIoTClient 16:deba40344375 278 handleData->messageUserContextCallback = NULL;
AzureIoTClient 16:deba40344375 279 handleData->lastMessageReceiveTime = INDEFINITE_TIME;
AzureIoTClient 16:deba40344375 280 /*Codes_SRS_IOTHUBCLIENT_LL_02_006: [IoTHubClient_LL_Create shall populate a structure of type IOTHUBTRANSPORT_CONFIG with the information from config parameter and the previous DLIST and shall pass that to the underlying layer _Create function.]*/
AzureIoTClient 16:deba40344375 281 lowerLayerConfig.upperConfig = config;
AzureIoTClient 16:deba40344375 282 lowerLayerConfig.waitingToSend = &(handleData->waitingToSend);
AzureIoTClient 16:deba40344375 283 /*Codes_SRS_IOTHUBCLIENT_LL_02_007: [If the underlaying layer _Create function fails them IoTHubClient_LL_Create shall fail and return NULL.] */
AzureIoTClient 16:deba40344375 284 if ((handleData->transportHandle = handleData->IoTHubTransport_Create(&lowerLayerConfig)) == NULL)
AzureIoTClient 16:deba40344375 285 {
AzureIoTClient 16:deba40344375 286 LogError("underlying transport failed\r\n");
AzureIoTClient 16:deba40344375 287 free(handleData);
AzureIoTClient 16:deba40344375 288 result = NULL;
AzureIoTClient 16:deba40344375 289 }
AzureIoTClient 16:deba40344375 290 else
AzureIoTClient 16:deba40344375 291 {
AzureIoTClient 16:deba40344375 292 /*Codes_SRS_IOTHUBCLIENT_LL_02_008: [Otherwise, IoTHubClient_LL_Create shall succeed and return a non-NULL handle.] */
AzureIoTClient 16:deba40344375 293 result = handleData;
AzureIoTClient 16:deba40344375 294 }
AzureIoTClient 16:deba40344375 295 }
AzureIoTClient 16:deba40344375 296 }
AzureIoTClient 16:deba40344375 297
AzureIoTClient 16:deba40344375 298 return result;
AzureIoTClient 16:deba40344375 299 }
AzureIoTClient 16:deba40344375 300
AzureIoTClient 16:deba40344375 301 void IoTHubClient_LL_Destroy(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle)
AzureIoTClient 16:deba40344375 302 {
AzureIoTClient 16:deba40344375 303 /*Codes_SRS_IOTHUBCLIENT_LL_02_009: [IoTHubClient_LL_Destroy shall do nothing if parameter iotHubClientHandle is NULL.]*/
AzureIoTClient 16:deba40344375 304 if (iotHubClientHandle != NULL)
AzureIoTClient 16:deba40344375 305 {
AzureIoTClient 16:deba40344375 306 PDLIST_ENTRY unsend;
AzureIoTClient 16:deba40344375 307 /*Codes_SRS_IOTHUBCLIENT_LL_02_010: [IoTHubClient_LL_Destroy it shall call the underlaying layer's _Destroy function and shall free the resources allocated by IoTHubClient (if any).] */
AzureIoTClient 16:deba40344375 308 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 16:deba40344375 309 handleData->IoTHubTransport_Destroy(handleData->transportHandle);
AzureIoTClient 16:deba40344375 310 /*if any, remove the items currently not send*/
AzureIoTClient 16:deba40344375 311 while ((unsend = DList_RemoveHeadList(&(handleData->waitingToSend))) != &(handleData->waitingToSend))
AzureIoTClient 16:deba40344375 312 {
AzureIoTClient 16:deba40344375 313 IOTHUB_MESSAGE_LIST* temp = containingRecord(unsend, IOTHUB_MESSAGE_LIST, entry);
AzureIoTClient 16:deba40344375 314 /*Codes_SRS_IOTHUBCLIENT_LL_02_033: [Otherwise, IoTHubClient_LL_Destroy shall complete all the event message callbacks that are in the waitingToSend list with the result IOTHUB_CLIENT_CONFIRMATION_BECAUSE_DESTROY.] */
AzureIoTClient 16:deba40344375 315 if (temp->callback != NULL)
AzureIoTClient 16:deba40344375 316 {
AzureIoTClient 16:deba40344375 317 temp->callback(IOTHUB_CLIENT_CONFIRMATION_BECAUSE_DESTROY, temp->context);
AzureIoTClient 16:deba40344375 318 }
AzureIoTClient 16:deba40344375 319 IoTHubMessage_Destroy(temp->messageHandle);
AzureIoTClient 16:deba40344375 320 free(temp);
AzureIoTClient 16:deba40344375 321 }
AzureIoTClient 16:deba40344375 322 free(handleData);
AzureIoTClient 16:deba40344375 323 }
AzureIoTClient 16:deba40344375 324 }
AzureIoTClient 16:deba40344375 325
AzureIoTClient 16:deba40344375 326 IOTHUB_CLIENT_RESULT IoTHubClient_LL_SendEventAsync(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, IOTHUB_MESSAGE_HANDLE eventMessageHandle, IOTHUB_CLIENT_EVENT_CONFIRMATION_CALLBACK eventConfirmationCallback, void* userContextCallback)
AzureIoTClient 16:deba40344375 327 {
AzureIoTClient 16:deba40344375 328 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 16:deba40344375 329 /*Codes_SRS_IOTHUBCLIENT_LL_02_011: [IoTHubClient_LL_SendEventAsync shall fail and return IOTHUB_CLIENT_INVALID_ARG if parameter iotHubClientHandle or eventMessageHandle is NULL.]*/
AzureIoTClient 16:deba40344375 330 if (
AzureIoTClient 16:deba40344375 331 (iotHubClientHandle == NULL) ||
AzureIoTClient 16:deba40344375 332 (eventMessageHandle == NULL) ||
AzureIoTClient 16:deba40344375 333 /*Codes_SRS_IOTHUBCLIENT_LL_02_012: [IoTHubClient_LL_SendEventAsync shall fail and return IOTHUB_CLIENT_INVALID_ARG if parameter eventConfirmationCallback is NULL and userContextCallback is not NULL.] */
AzureIoTClient 16:deba40344375 334 ((eventConfirmationCallback == NULL) && (userContextCallback != NULL))
AzureIoTClient 16:deba40344375 335 )
AzureIoTClient 16:deba40344375 336 {
AzureIoTClient 16:deba40344375 337 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 16:deba40344375 338 LOG_ERROR;
AzureIoTClient 16:deba40344375 339 }
AzureIoTClient 16:deba40344375 340 else
AzureIoTClient 16:deba40344375 341 {
AzureIoTClient 16:deba40344375 342 IOTHUB_MESSAGE_LIST *newEntry = (IOTHUB_MESSAGE_LIST*)malloc(sizeof(IOTHUB_MESSAGE_LIST));
AzureIoTClient 16:deba40344375 343 if (newEntry == NULL)
AzureIoTClient 16:deba40344375 344 {
AzureIoTClient 16:deba40344375 345 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 16:deba40344375 346 LOG_ERROR;
AzureIoTClient 16:deba40344375 347 }
AzureIoTClient 16:deba40344375 348 else
AzureIoTClient 16:deba40344375 349 {
AzureIoTClient 16:deba40344375 350 /*Codes_SRS_IOTHUBCLIENT_LL_02_013: [IoTHubClient_SendEventAsync shall add the DLIST waitingToSend a new record cloning the information from eventMessageHandle, eventConfirmationCallback, userContextCallback.]*/
AzureIoTClient 16:deba40344375 351 if ((newEntry->messageHandle = IoTHubMessage_Clone(eventMessageHandle)) == NULL)
AzureIoTClient 16:deba40344375 352 {
AzureIoTClient 16:deba40344375 353 /*Codes_SRS_IOTHUBCLIENT_LL_02_014: [If cloning and/or adding the information fails for any reason, IoTHubClient_LL_SendEventAsync shall fail and return IOTHUB_CLIENT_ERROR.] */
AzureIoTClient 16:deba40344375 354 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 16:deba40344375 355 free(newEntry);
AzureIoTClient 16:deba40344375 356 LOG_ERROR;
AzureIoTClient 16:deba40344375 357 }
AzureIoTClient 16:deba40344375 358 else
AzureIoTClient 16:deba40344375 359 {
AzureIoTClient 16:deba40344375 360 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 16:deba40344375 361 /*Codes_SRS_IOTHUBCLIENT_LL_02_013: [IoTHubClient_SendEventAsync shall add the DLIST waitingToSend a new record cloning the information from eventMessageHandle, eventConfirmationCallback, userContextCallback.]*/
AzureIoTClient 16:deba40344375 362 newEntry->callback = eventConfirmationCallback;
AzureIoTClient 16:deba40344375 363 newEntry->context = userContextCallback;
AzureIoTClient 16:deba40344375 364 DList_InsertTailList(&(handleData->waitingToSend), &(newEntry->entry));
AzureIoTClient 16:deba40344375 365 /*Codes_SRS_IOTHUBCLIENT_LL_02_015: [Otherwise IoTHubClient_LL_SendEventAsync shall succeed and return IOTHUB_CLIENT_OK.] */
AzureIoTClient 16:deba40344375 366 result = IOTHUB_CLIENT_OK;
AzureIoTClient 16:deba40344375 367 }
AzureIoTClient 16:deba40344375 368 }
AzureIoTClient 16:deba40344375 369 }
AzureIoTClient 16:deba40344375 370 return result;
AzureIoTClient 16:deba40344375 371 }
AzureIoTClient 16:deba40344375 372
AzureIoTClient 16:deba40344375 373 IOTHUB_CLIENT_RESULT IoTHubClient_LL_SetMessageCallback(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, IOTHUB_CLIENT_MESSAGE_CALLBACK_ASYNC messageCallback, void* userContextCallback)
AzureIoTClient 16:deba40344375 374 {
AzureIoTClient 16:deba40344375 375 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 16:deba40344375 376 /*Codes_SRS_IOTHUBCLIENT_LL_02_016: [IoTHubClient_LL_SetMessageCallback shall fail and return IOTHUB_CLIENT_INVALID_ARG if parameter iotHubClientHandle is NULL.] */
AzureIoTClient 16:deba40344375 377 if (iotHubClientHandle == NULL)
AzureIoTClient 16:deba40344375 378 {
AzureIoTClient 16:deba40344375 379 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 16:deba40344375 380 LOG_ERROR;
AzureIoTClient 16:deba40344375 381 }
AzureIoTClient 16:deba40344375 382 else
AzureIoTClient 16:deba40344375 383 {
AzureIoTClient 16:deba40344375 384 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 16:deba40344375 385 if (messageCallback == NULL)
AzureIoTClient 16:deba40344375 386 {
AzureIoTClient 16:deba40344375 387 /*Codes_SRS_IOTHUBCLIENT_LL_02_019: [If parameter messageCallback is NULL then IoTHubClient_LL_SetMessageCallback shall call the underlying layer's _Unsubscribe function and return IOTHUB_CLIENT_OK.] */
AzureIoTClient 16:deba40344375 388 handleData->IoTHubTransport_Unsubscribe(handleData->transportHandle);
AzureIoTClient 16:deba40344375 389 handleData->messageCallback = NULL;
AzureIoTClient 16:deba40344375 390 handleData->messageUserContextCallback = NULL;
AzureIoTClient 16:deba40344375 391 result = IOTHUB_CLIENT_OK;
AzureIoTClient 16:deba40344375 392 }
AzureIoTClient 16:deba40344375 393 else
AzureIoTClient 16:deba40344375 394 {
AzureIoTClient 16:deba40344375 395 /*Codes_SRS_IOTHUBCLIENT_LL_02_017: [If parameter messageCallback is non-NULL then IoTHubClient_LL_SetMessageCallback shall call the underlying layer's _Subscribe function.]*/
AzureIoTClient 16:deba40344375 396 if (handleData->IoTHubTransport_Subscribe(handleData->transportHandle) == 0)
AzureIoTClient 16:deba40344375 397 {
AzureIoTClient 16:deba40344375 398 handleData->messageCallback = messageCallback;
AzureIoTClient 16:deba40344375 399 handleData->messageUserContextCallback = userContextCallback;
AzureIoTClient 16:deba40344375 400 result = IOTHUB_CLIENT_OK;
AzureIoTClient 16:deba40344375 401 }
AzureIoTClient 16:deba40344375 402 else
AzureIoTClient 16:deba40344375 403 {
AzureIoTClient 16:deba40344375 404 handleData->messageCallback = NULL;
AzureIoTClient 16:deba40344375 405 handleData->messageUserContextCallback = NULL;
AzureIoTClient 16:deba40344375 406 /*Codes_SRS_IOTHUBCLIENT_LL_02_018: [If the underlying layer's _Subscribe function fails, then IoTHubClient_LL_SetMessageCallback shall fail and return IOTHUB_CLIENT_ERROR. Otherwise IoTHubClient_LL_SetMessageCallback shall succeed and return IOTHUB_CLIENT_OK.]*/
AzureIoTClient 16:deba40344375 407 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 16:deba40344375 408 }
AzureIoTClient 16:deba40344375 409 }
AzureIoTClient 16:deba40344375 410 }
AzureIoTClient 16:deba40344375 411
AzureIoTClient 16:deba40344375 412 return result;
AzureIoTClient 16:deba40344375 413 }
AzureIoTClient 16:deba40344375 414
AzureIoTClient 16:deba40344375 415 void IoTHubClient_LL_DoWork(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle)
AzureIoTClient 16:deba40344375 416 {
AzureIoTClient 16:deba40344375 417 /*Codes_SRS_IOTHUBCLIENT_LL_02_020: [If parameter iotHubClientHandle is NULL then IoTHubClient_LL_DoWork shall not perform any action.] */
AzureIoTClient 16:deba40344375 418 if (iotHubClientHandle != NULL)
AzureIoTClient 16:deba40344375 419 {
AzureIoTClient 16:deba40344375 420 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 16:deba40344375 421 handleData->IoTHubTransport_DoWork(handleData->transportHandle, iotHubClientHandle);
AzureIoTClient 16:deba40344375 422 }
AzureIoTClient 16:deba40344375 423 }
AzureIoTClient 16:deba40344375 424
AzureIoTClient 16:deba40344375 425 IOTHUB_CLIENT_RESULT IoTHubClient_LL_GetSendStatus(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, IOTHUB_CLIENT_STATUS *iotHubClientStatus)
AzureIoTClient 16:deba40344375 426 {
AzureIoTClient 16:deba40344375 427 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 16:deba40344375 428
AzureIoTClient 16:deba40344375 429 /* Codes_SRS_IOTHUBCLIENT_09_007: [IoTHubClient_GetSendStatus shall return IOTHUB_CLIENT_INVALID_ARG if called with NULL parameter] */
AzureIoTClient 16:deba40344375 430 if (iotHubClientHandle == NULL || iotHubClientStatus == NULL)
AzureIoTClient 16:deba40344375 431 {
AzureIoTClient 16:deba40344375 432 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 16:deba40344375 433 LOG_ERROR;
AzureIoTClient 16:deba40344375 434 }
AzureIoTClient 16:deba40344375 435 else
AzureIoTClient 16:deba40344375 436 {
AzureIoTClient 16:deba40344375 437 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 16:deba40344375 438
AzureIoTClient 16:deba40344375 439 /* Codes_SRS_IOTHUBCLIENT_09_008: [IoTHubClient_GetSendStatus shall return IOTHUB_CLIENT_OK and status IOTHUB_CLIENT_SEND_STATUS_IDLE if there is currently no items to be sent] */
AzureIoTClient 16:deba40344375 440 /* Codes_SRS_IOTHUBCLIENT_09_009: [IoTHubClient_GetSendStatus shall return IOTHUB_CLIENT_OK and status IOTHUB_CLIENT_SEND_STATUS_BUSY if there are currently items to be sent] */
AzureIoTClient 16:deba40344375 441 result = handleData->IoTHubTransport_GetSendStatus(handleData->transportHandle, iotHubClientStatus);
AzureIoTClient 16:deba40344375 442 }
AzureIoTClient 16:deba40344375 443
AzureIoTClient 16:deba40344375 444 return result;
AzureIoTClient 16:deba40344375 445 }
AzureIoTClient 16:deba40344375 446
AzureIoTClient 16:deba40344375 447 void IoTHubClient_LL_SendComplete(IOTHUB_CLIENT_LL_HANDLE handle, PDLIST_ENTRY completed, IOTHUB_BATCHSTATE_RESULT result)
AzureIoTClient 16:deba40344375 448 {
AzureIoTClient 16:deba40344375 449 /*Codes_SRS_IOTHUBCLIENT_LL_02_022: [If parameter completed is NULL, or parameter handle is NULL then IoTHubClient_LL_SendBatch shall return.]*/
AzureIoTClient 16:deba40344375 450 if (
AzureIoTClient 16:deba40344375 451 (handle == NULL) ||
AzureIoTClient 16:deba40344375 452 (completed == NULL)
AzureIoTClient 16:deba40344375 453 )
AzureIoTClient 16:deba40344375 454 {
AzureIoTClient 16:deba40344375 455 /*"shall return"*/
AzureIoTClient 16:deba40344375 456 LogError("invalid arg\r\n");
AzureIoTClient 16:deba40344375 457 }
AzureIoTClient 16:deba40344375 458 else
AzureIoTClient 16:deba40344375 459 {
AzureIoTClient 16:deba40344375 460 /*Codes_SRS_IOTHUBCLIENT_LL_02_027: [If parameter result is IOTHUB_BACTHSTATE_FAILED then IoTHubClient_LL_SendComplete shall call all the non-NULL callbacks with the result parameter set to IOTHUB_CLIENT_CONFIRMATION_ERROR and the context set to the context passed originally in the SendEventAsync call.] */
AzureIoTClient 16:deba40344375 461 /*Codes_SRS_IOTHUBCLIENT_LL_02_025: [If parameter result is IOTHUB_BATCHSTATE_SUCCESS then IoTHubClient_LL_SendComplete shall call all the non-NULL callbacks with the result parameter set to IOTHUB_CLIENT_CONFIRMATION_OK and the context set to the context passed originally in the SendEventAsync call.]*/
AzureIoTClient 16:deba40344375 462 IOTHUB_CLIENT_CONFIRMATION_RESULT resultToBeCalled = (result == IOTHUB_BATCHSTATE_SUCCESS) ? IOTHUB_CLIENT_CONFIRMATION_OK : IOTHUB_CLIENT_CONFIRMATION_ERROR;
AzureIoTClient 16:deba40344375 463 PDLIST_ENTRY oldest;
AzureIoTClient 16:deba40344375 464 while((oldest= DList_RemoveHeadList(completed))!=completed)
AzureIoTClient 16:deba40344375 465 {
AzureIoTClient 16:deba40344375 466 IOTHUB_MESSAGE_LIST* messageList = (IOTHUB_MESSAGE_LIST*)containingRecord(oldest, IOTHUB_MESSAGE_LIST, entry);
AzureIoTClient 16:deba40344375 467 if (messageList->callback != NULL)
AzureIoTClient 16:deba40344375 468 {
AzureIoTClient 16:deba40344375 469 messageList->callback(resultToBeCalled, messageList->context);
AzureIoTClient 16:deba40344375 470 }
AzureIoTClient 16:deba40344375 471 IoTHubMessage_Destroy(messageList->messageHandle);
AzureIoTClient 16:deba40344375 472 free(messageList);
AzureIoTClient 16:deba40344375 473 }
AzureIoTClient 16:deba40344375 474 }
AzureIoTClient 16:deba40344375 475 }
AzureIoTClient 16:deba40344375 476
AzureIoTClient 16:deba40344375 477 IOTHUBMESSAGE_DISPOSITION_RESULT IoTHubClient_LL_MessageCallback(IOTHUB_CLIENT_LL_HANDLE handle, IOTHUB_MESSAGE_HANDLE message)
AzureIoTClient 16:deba40344375 478 {
AzureIoTClient 16:deba40344375 479 int result;
AzureIoTClient 16:deba40344375 480 /*Codes_SRS_IOTHUBCLIENT_LL_02_029: [If parameter handle is NULL then IoTHubClient_LL_MessageCallback shall return IOTHUBMESSAGE_ABANDONED.] */
AzureIoTClient 16:deba40344375 481 if (handle == NULL)
AzureIoTClient 16:deba40344375 482 {
AzureIoTClient 16:deba40344375 483 LogError("invalid argument\r\n");
AzureIoTClient 16:deba40344375 484 result = IOTHUBMESSAGE_ABANDONED;
AzureIoTClient 16:deba40344375 485 }
AzureIoTClient 16:deba40344375 486 else
AzureIoTClient 16:deba40344375 487 {
AzureIoTClient 16:deba40344375 488 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)handle;
AzureIoTClient 16:deba40344375 489
AzureIoTClient 16:deba40344375 490 /* Codes_SRS_IOTHUBCLIENT_LL_09_004: [IoTHubClient_LL_GetLastMessageReceiveTime shall return lastMessageReceiveTime in localtime] */
AzureIoTClient 16:deba40344375 491 handleData->lastMessageReceiveTime = get_time(NULL);
AzureIoTClient 16:deba40344375 492
AzureIoTClient 16:deba40344375 493 /*Codes_SRS_IOTHUBCLIENT_LL_02_030: [IoTHubClient_LL_MessageCallback shall invoke the last callback function (the parameter messageCallback to IoTHubClient_LL_SetMessageCallback) passing the message and the passed userContextCallback.]*/
AzureIoTClient 16:deba40344375 494 if (handleData->messageCallback != NULL)
AzureIoTClient 16:deba40344375 495 {
AzureIoTClient 16:deba40344375 496 result = handleData->messageCallback(message, handleData->messageUserContextCallback);
AzureIoTClient 16:deba40344375 497 }
AzureIoTClient 16:deba40344375 498 else
AzureIoTClient 16:deba40344375 499 {
AzureIoTClient 16:deba40344375 500 /*Codes_SRS_IOTHUBCLIENT_LL_02_032: [If the last callback function was NULL, then IoTHubClient_LL_MessageCallback shall return IOTHUBMESSAGE_ABANDONED.] */
AzureIoTClient 16:deba40344375 501 LogError("user callback was NULL\r\n");
AzureIoTClient 16:deba40344375 502 result = IOTHUBMESSAGE_ABANDONED;
AzureIoTClient 16:deba40344375 503 }
AzureIoTClient 16:deba40344375 504 }
AzureIoTClient 16:deba40344375 505 /*Codes_SRS_IOTHUBCLIENT_LL_02_031: [Then IoTHubClient_LL_MessageCallback shall return what the user function returns.]*/
AzureIoTClient 16:deba40344375 506 return result;
AzureIoTClient 16:deba40344375 507 }
AzureIoTClient 16:deba40344375 508
AzureIoTClient 16:deba40344375 509 IOTHUB_CLIENT_RESULT IoTHubClient_LL_GetLastMessageReceiveTime(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, time_t* lastMessageReceiveTime)
AzureIoTClient 16:deba40344375 510 {
AzureIoTClient 16:deba40344375 511 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 16:deba40344375 512 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 16:deba40344375 513
AzureIoTClient 16:deba40344375 514 /* Codes_SRS_IOTHUBCLIENT_LL_09_001: [IoTHubClient_LL_GetLastMessageReceiveTime shall return IOTHUB_CLIENT_INVALID_ARG if any of the arguments is NULL] */
AzureIoTClient 16:deba40344375 515 if (handleData == NULL || lastMessageReceiveTime == NULL)
AzureIoTClient 16:deba40344375 516 {
AzureIoTClient 16:deba40344375 517 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 16:deba40344375 518 LOG_ERROR;
AzureIoTClient 16:deba40344375 519 }
AzureIoTClient 16:deba40344375 520 else
AzureIoTClient 16:deba40344375 521 {
AzureIoTClient 16:deba40344375 522 /* Codes_SRS_IOTHUBCLIENT_LL_09_002: [IoTHubClient_LL_GetLastMessageReceiveTime shall return IOTHUB_CLIENT_INDEFINITE_TIME - and not set 'lastMessageReceiveTime' - if it is unable to provide the time for the last commands] */
AzureIoTClient 16:deba40344375 523 if (handleData->lastMessageReceiveTime == INDEFINITE_TIME)
AzureIoTClient 16:deba40344375 524 {
AzureIoTClient 16:deba40344375 525 result = IOTHUB_CLIENT_INDEFINITE_TIME;
AzureIoTClient 16:deba40344375 526 LOG_ERROR;
AzureIoTClient 16:deba40344375 527 }
AzureIoTClient 16:deba40344375 528 else
AzureIoTClient 16:deba40344375 529 {
AzureIoTClient 16:deba40344375 530 /* Codes_SRS_IOTHUBCLIENT_LL_09_003: [IoTHubClient_LL_GetLastMessageReceiveTime shall return IOTHUB_CLIENT_OK if it wrote in the lastMessageReceiveTime the time when the last command was received] */
AzureIoTClient 16:deba40344375 531 /* Codes_SRS_IOTHUBCLIENT_LL_09_004: [IoTHubClient_LL_GetLastMessageReceiveTime shall return lastMessageReceiveTime in localtime] */
AzureIoTClient 16:deba40344375 532 *lastMessageReceiveTime = handleData->lastMessageReceiveTime;
AzureIoTClient 16:deba40344375 533 result = IOTHUB_CLIENT_OK;
AzureIoTClient 16:deba40344375 534 }
AzureIoTClient 16:deba40344375 535 }
AzureIoTClient 16:deba40344375 536
AzureIoTClient 16:deba40344375 537 return result;
AzureIoTClient 16:deba40344375 538 }
AzureIoTClient 16:deba40344375 539
AzureIoTClient 16:deba40344375 540 IOTHUB_CLIENT_RESULT IoTHubClient_LL_SetOption(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, const char* optionName, const void* value)
AzureIoTClient 16:deba40344375 541 {
AzureIoTClient 16:deba40344375 542
AzureIoTClient 16:deba40344375 543 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 16:deba40344375 544 /*Codes_SRS_IOTHUBCLIENT_LL_02_034: [If iotHubClientHandle is NULL then IoTHubClient_LL_SetOption shall return IOTHUB_CLIENT_INVALID_ARG.]*/
AzureIoTClient 16:deba40344375 545 /*Codes_SRS_IOTHUBCLIENT_LL_02_035: [If optionName is NULL then IoTHubClient_LL_SetOption shall return IOTHUB_CLIENT_INVALID_ARG.] */
AzureIoTClient 16:deba40344375 546 /*Codes_SRS_IOTHUBCLIENT_LL_02_036: [If value is NULL then IoTHubClient_LL_SetOption shall return IOTHUB_CLIENT_INVALID_ARG.] */
AzureIoTClient 16:deba40344375 547 if (
AzureIoTClient 16:deba40344375 548 (iotHubClientHandle == NULL) ||
AzureIoTClient 16:deba40344375 549 (optionName == NULL) ||
AzureIoTClient 16:deba40344375 550 (value == NULL)
AzureIoTClient 16:deba40344375 551 )
AzureIoTClient 16:deba40344375 552 {
AzureIoTClient 16:deba40344375 553 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 16:deba40344375 554 LogError("invalid argument (NULL)\r\n");
AzureIoTClient 16:deba40344375 555 }
AzureIoTClient 16:deba40344375 556 else
AzureIoTClient 16:deba40344375 557 {
AzureIoTClient 16:deba40344375 558 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 16:deba40344375 559
AzureIoTClient 16:deba40344375 560 /*Codes_SRS_IOTHUBCLIENT_LL_02_038: [Otherwise, IoTHubClient_LL shall call the function _SetOption of the underlying transport and return what that function is returning.] */
AzureIoTClient 16:deba40344375 561 result = handleData->IoTHubTransport_SetOption(handleData->transportHandle, optionName, value);
AzureIoTClient 16:deba40344375 562
AzureIoTClient 16:deba40344375 563 if (result != IOTHUB_CLIENT_OK)
AzureIoTClient 16:deba40344375 564 {
AzureIoTClient 16:deba40344375 565 LogError("underlying transport failed, returned = %s\r\n", ENUM_TO_STRING(IOTHUB_CLIENT_RESULT, result));
AzureIoTClient 16:deba40344375 566 }
AzureIoTClient 16:deba40344375 567
AzureIoTClient 16:deba40344375 568 }
AzureIoTClient 16:deba40344375 569 return result;
AzureIoTClient 16:deba40344375 570 }