Azure IoT / iothub_client

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

iothub_client_ll.c@1:bec6dd049b54, 2015-09-15 (annotated)

Committer:
AzureIoTClient
Date:
Tue Sep 15 22:25:50 2015 -0700
Revision:
1:bec6dd049b54
Parent:
0:e393db310d89
Child:
9:3ec7e2695f98
New release

Who changed what in which revision?

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