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@40:1a94db9139ea, 2016-05-09 (annotated)

Committer:
AzureIoTClient
Date:
Mon May 09 14:37:02 2016 -0700
Revision:
40:1a94db9139ea
Parent:
39:2719651a5bee
Child:
42:448eecc3676e
1.0.6

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
Azure.IoT Build 38:a05929a75111 8 #include <string.h>
Azure.IoT Build 38:a05929a75111 9 #include "azure_c_shared_utility/gballoc.h"
Azure.IoT Build 38:a05929a75111 10 #include "azure_c_shared_utility/string_tokenizer.h"
Azure.IoT Build 38:a05929a75111 11 #include "azure_c_shared_utility/doublylinkedlist.h"
Azure.IoT Build 38:a05929a75111 12 #include "azure_c_shared_utility/iot_logging.h"
Azure.IoT Build 38:a05929a75111 13 #include "azure_c_shared_utility/tickcounter.h"
AzureIoTClient 16:deba40344375 14
AzureIoTClient 16:deba40344375 15 #include "iothub_client_ll.h"
AzureIoTClient 16:deba40344375 16 #include "iothub_client_private.h"
AzureIoTClient 33:b372b0efcd20 17 #include "iothub_client_version.h"
Azure.IoT Build 38:a05929a75111 18 #include "iothub_transport_ll.h"
Azure.IoT Build 36:67300d5a4c1f 19
AzureIoTClient 39:2719651a5bee 20 #define LOG_ERROR LogError("result = %s", ENUM_TO_STRING(IOTHUB_CLIENT_RESULT, result));
AzureIoTClient 16:deba40344375 21 #define INDEFINITE_TIME ((time_t)(-1))
AzureIoTClient 16:deba40344375 22
AzureIoTClient 16:deba40344375 23 DEFINE_ENUM_STRINGS(IOTHUB_CLIENT_RESULT, IOTHUB_CLIENT_RESULT_VALUES);
AzureIoTClient 16:deba40344375 24
AzureIoTClient 16:deba40344375 25 typedef struct IOTHUB_CLIENT_LL_HANDLE_DATA_TAG
AzureIoTClient 16:deba40344375 26 {
AzureIoTClient 40:1a94db9139ea 27 DLIST_ENTRY waitingToSend;
AzureIoTClient 40:1a94db9139ea 28 TRANSPORT_LL_HANDLE transportHandle;
Azure.IoT Build 36:67300d5a4c1f 29 bool isSharedTransport;
Azure.IoT Build 36:67300d5a4c1f 30 IOTHUB_DEVICE_HANDLE deviceHandle;
AzureIoTClient 40:1a94db9139ea 31 TRANSPORT_PROVIDER_FIELDS;
AzureIoTClient 40:1a94db9139ea 32 IOTHUB_CLIENT_MESSAGE_CALLBACK_ASYNC messageCallback;
AzureIoTClient 40:1a94db9139ea 33 void* messageUserContextCallback;
AzureIoTClient 40:1a94db9139ea 34 time_t lastMessageReceiveTime;
AzureIoTClient 40:1a94db9139ea 35 TICK_COUNTER_HANDLE tickCounter; /*shared tickcounter used to track message timeouts in waitingToSend list*/
AzureIoTClient 40:1a94db9139ea 36 uint64_t currentMessageTimeout;
AzureIoTClient 16:deba40344375 37 }IOTHUB_CLIENT_LL_HANDLE_DATA;
AzureIoTClient 16:deba40344375 38
AzureIoTClient 16:deba40344375 39 static const char HOSTNAME_TOKEN[] = "HostName";
AzureIoTClient 16:deba40344375 40 static const char DEVICEID_TOKEN[] = "DeviceId";
AzureIoTClient 16:deba40344375 41 static const char DEVICEKEY_TOKEN[] = "SharedAccessKey";
AzureIoTClient 40:1a94db9139ea 42 static const char DEVICESAS_TOKEN[] = "SharedAccessSignature";
AzureIoTClient 16:deba40344375 43 static const char PROTOCOL_GATEWAY_HOST[] = "GatewayHostName";
AzureIoTClient 16:deba40344375 44
AzureIoTClient 16:deba40344375 45 IOTHUB_CLIENT_LL_HANDLE IoTHubClient_LL_CreateFromConnectionString(const char* connectionString, IOTHUB_CLIENT_TRANSPORT_PROVIDER protocol)
AzureIoTClient 16:deba40344375 46 {
AzureIoTClient 40:1a94db9139ea 47 IOTHUB_CLIENT_LL_HANDLE result = NULL;
AzureIoTClient 16:deba40344375 48
AzureIoTClient 40:1a94db9139ea 49 /*Codes_SRS_IOTHUBCLIENT_LL_05_001: [IoTHubClient_LL_CreateFromConnectionString shall obtain the version string by a call to IoTHubClient_GetVersionString.]*/
AzureIoTClient 40:1a94db9139ea 50 /*Codes_SRS_IOTHUBCLIENT_LL_05_002: [IoTHubClient_LL_CreateFromConnectionString shall print the version string to standard output.]*/
AzureIoTClient 40:1a94db9139ea 51 LogInfo("IoT Hub SDK for C, version %s", IoTHubClient_GetVersionString());
AzureIoTClient 16:deba40344375 52
AzureIoTClient 40:1a94db9139ea 53 /* Codes_SRS_IOTHUBCLIENT_LL_12_003: [IoTHubClient_LL_CreateFromConnectionString shall verify the input parameter and if it is NULL then return NULL] */
AzureIoTClient 40:1a94db9139ea 54 if (connectionString == NULL)
AzureIoTClient 40:1a94db9139ea 55 {
AzureIoTClient 40:1a94db9139ea 56 LogError("Input parameter is NULL: connectionString");
AzureIoTClient 40:1a94db9139ea 57 }
AzureIoTClient 40:1a94db9139ea 58 else if (protocol == NULL)
AzureIoTClient 40:1a94db9139ea 59 {
AzureIoTClient 40:1a94db9139ea 60 LogError("Input parameter is NULL: protocol");
AzureIoTClient 40:1a94db9139ea 61 }
AzureIoTClient 40:1a94db9139ea 62 else
AzureIoTClient 40:1a94db9139ea 63 {
AzureIoTClient 40:1a94db9139ea 64 /* Codes_SRS_IOTHUBCLIENT_LL_12_004: [IoTHubClient_LL_CreateFromConnectionString shall allocate IOTHUB_CLIENT_CONFIG structure] */
AzureIoTClient 40:1a94db9139ea 65 IOTHUB_CLIENT_CONFIG* config = malloc(sizeof(IOTHUB_CLIENT_CONFIG));
AzureIoTClient 40:1a94db9139ea 66 if (config == NULL)
AzureIoTClient 40:1a94db9139ea 67 {
AzureIoTClient 40:1a94db9139ea 68 /* Codes_SRS_IOTHUBCLIENT_LL_12_012: [If the allocation failed IoTHubClient_LL_CreateFromConnectionString returns NULL] */
AzureIoTClient 40:1a94db9139ea 69 LogError("Malloc failed");
AzureIoTClient 40:1a94db9139ea 70 return NULL;
AzureIoTClient 40:1a94db9139ea 71 }
AzureIoTClient 40:1a94db9139ea 72 else
AzureIoTClient 40:1a94db9139ea 73 {
AzureIoTClient 40:1a94db9139ea 74 STRING_TOKENIZER_HANDLE tokenizer1 = NULL;
AzureIoTClient 40:1a94db9139ea 75 STRING_HANDLE connString = NULL;
AzureIoTClient 40:1a94db9139ea 76 STRING_HANDLE tokenString = NULL;
AzureIoTClient 40:1a94db9139ea 77 STRING_HANDLE valueString = NULL;
AzureIoTClient 40:1a94db9139ea 78 STRING_HANDLE hostNameString = NULL;
AzureIoTClient 40:1a94db9139ea 79 STRING_HANDLE hostSuffixString = NULL;
AzureIoTClient 40:1a94db9139ea 80 STRING_HANDLE deviceIdString = NULL;
AzureIoTClient 40:1a94db9139ea 81 STRING_HANDLE deviceKeyString = NULL;
AzureIoTClient 40:1a94db9139ea 82 STRING_HANDLE deviceSasTokenString = NULL;
AzureIoTClient 40:1a94db9139ea 83 STRING_HANDLE protocolGateway = NULL;
AzureIoTClient 16:deba40344375 84
AzureIoTClient 40:1a94db9139ea 85 config->protocol = protocol;
AzureIoTClient 16:deba40344375 86
AzureIoTClient 40:1a94db9139ea 87 config->iotHubName = NULL;
AzureIoTClient 40:1a94db9139ea 88 config->iotHubSuffix = NULL;
AzureIoTClient 40:1a94db9139ea 89 config->deviceId = NULL;
AzureIoTClient 40:1a94db9139ea 90 config->deviceKey = NULL;
AzureIoTClient 40:1a94db9139ea 91 config->deviceSasToken = NULL;
AzureIoTClient 40:1a94db9139ea 92
AzureIoTClient 40:1a94db9139ea 93 /* Codes_SRS_IOTHUBCLIENT_LL_04_002: [If it does not, it shall pass the protocolGatewayHostName NULL.] */
AzureIoTClient 40:1a94db9139ea 94 config->protocolGatewayHostName = NULL;
AzureIoTClient 16:deba40344375 95
AzureIoTClient 40:1a94db9139ea 96 if ((connString = STRING_construct(connectionString)) == NULL)
AzureIoTClient 40:1a94db9139ea 97 {
AzureIoTClient 40:1a94db9139ea 98 LogError("Error constructing connectiong String");
AzureIoTClient 40:1a94db9139ea 99 }
AzureIoTClient 40:1a94db9139ea 100 else if ((tokenizer1 = STRING_TOKENIZER_create(connString)) == NULL)
AzureIoTClient 40:1a94db9139ea 101 {
AzureIoTClient 40:1a94db9139ea 102 LogError("Error creating Tokenizer");
AzureIoTClient 40:1a94db9139ea 103 }
AzureIoTClient 40:1a94db9139ea 104 else if ((tokenString = STRING_new()) == NULL)
AzureIoTClient 40:1a94db9139ea 105 {
AzureIoTClient 40:1a94db9139ea 106 LogError("Error creating Token String");
AzureIoTClient 40:1a94db9139ea 107 }
AzureIoTClient 40:1a94db9139ea 108 else if ((valueString = STRING_new()) == NULL)
AzureIoTClient 40:1a94db9139ea 109 {
AzureIoTClient 40:1a94db9139ea 110 LogError("Error creating Value String");
AzureIoTClient 40:1a94db9139ea 111 }
AzureIoTClient 40:1a94db9139ea 112 else if ((hostNameString = STRING_new()) == NULL)
AzureIoTClient 40:1a94db9139ea 113 {
AzureIoTClient 40:1a94db9139ea 114 LogError("Error creating HostName String");
AzureIoTClient 40:1a94db9139ea 115 }
AzureIoTClient 40:1a94db9139ea 116 else if ((hostSuffixString = STRING_new()) == NULL)
AzureIoTClient 40:1a94db9139ea 117 {
AzureIoTClient 40:1a94db9139ea 118 LogError("Error creating HostSuffix String");
AzureIoTClient 40:1a94db9139ea 119 }
AzureIoTClient 40:1a94db9139ea 120 /* Codes_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 40:1a94db9139ea 121 /* Codes_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 or SharedAccessSignature.] */
AzureIoTClient 40:1a94db9139ea 122 else
AzureIoTClient 40:1a94db9139ea 123 {
AzureIoTClient 40:1a94db9139ea 124 while ((STRING_TOKENIZER_get_next_token(tokenizer1, tokenString, "=") == 0))
AzureIoTClient 40:1a94db9139ea 125 {
AzureIoTClient 40:1a94db9139ea 126 if (STRING_TOKENIZER_get_next_token(tokenizer1, valueString, ";") != 0)
AzureIoTClient 40:1a94db9139ea 127 {
AzureIoTClient 40:1a94db9139ea 128 LogError("Tokenizer error");
AzureIoTClient 40:1a94db9139ea 129 break;
AzureIoTClient 40:1a94db9139ea 130 }
AzureIoTClient 40:1a94db9139ea 131 else
AzureIoTClient 40:1a94db9139ea 132 {
AzureIoTClient 40:1a94db9139ea 133 if (tokenString != NULL)
AzureIoTClient 40:1a94db9139ea 134 {
AzureIoTClient 40:1a94db9139ea 135 /* Codes_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 or deviceSasToken = SharedAccessSignature] */
AzureIoTClient 40:1a94db9139ea 136 const char* s_token = STRING_c_str(tokenString);
AzureIoTClient 40:1a94db9139ea 137 if (strcmp(s_token, HOSTNAME_TOKEN) == 0)
AzureIoTClient 40:1a94db9139ea 138 {
AzureIoTClient 40:1a94db9139ea 139 /* Codes_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 40:1a94db9139ea 140 STRING_TOKENIZER_HANDLE tokenizer2 = NULL;
AzureIoTClient 40:1a94db9139ea 141 if ((tokenizer2 = STRING_TOKENIZER_create(valueString)) == NULL)
AzureIoTClient 40:1a94db9139ea 142 {
AzureIoTClient 40:1a94db9139ea 143 LogError("Error creating Tokenizer");
AzureIoTClient 40:1a94db9139ea 144 break;
AzureIoTClient 40:1a94db9139ea 145 }
AzureIoTClient 40:1a94db9139ea 146 else
AzureIoTClient 40:1a94db9139ea 147 {
AzureIoTClient 40:1a94db9139ea 148 /* Codes_SRS_IOTHUBCLIENT_LL_12_015: [If the string split failed, IoTHubClient_LL_CreateFromConnectionString returns NULL ] */
AzureIoTClient 40:1a94db9139ea 149 if (STRING_TOKENIZER_get_next_token(tokenizer2, hostNameString, ".") != 0)
AzureIoTClient 40:1a94db9139ea 150 {
AzureIoTClient 40:1a94db9139ea 151 LogError("Tokenizer error");
AzureIoTClient 40:1a94db9139ea 152 STRING_TOKENIZER_destroy(tokenizer2);
AzureIoTClient 40:1a94db9139ea 153 break;
AzureIoTClient 40:1a94db9139ea 154 }
AzureIoTClient 40:1a94db9139ea 155 else
AzureIoTClient 40:1a94db9139ea 156 {
AzureIoTClient 40:1a94db9139ea 157 config->iotHubName = STRING_c_str(hostNameString);
AzureIoTClient 40:1a94db9139ea 158 if (STRING_TOKENIZER_get_next_token(tokenizer2, hostSuffixString, ";") != 0)
AzureIoTClient 40:1a94db9139ea 159 {
AzureIoTClient 40:1a94db9139ea 160 LogError("Tokenizer error");
AzureIoTClient 40:1a94db9139ea 161 STRING_TOKENIZER_destroy(tokenizer2);
AzureIoTClient 40:1a94db9139ea 162 break;
AzureIoTClient 40:1a94db9139ea 163 }
AzureIoTClient 40:1a94db9139ea 164 else
AzureIoTClient 40:1a94db9139ea 165 {
AzureIoTClient 40:1a94db9139ea 166 config->iotHubSuffix = STRING_c_str(hostSuffixString);
AzureIoTClient 40:1a94db9139ea 167 }
AzureIoTClient 40:1a94db9139ea 168 }
AzureIoTClient 40:1a94db9139ea 169 STRING_TOKENIZER_destroy(tokenizer2);
AzureIoTClient 40:1a94db9139ea 170 }
AzureIoTClient 40:1a94db9139ea 171 }
AzureIoTClient 40:1a94db9139ea 172 else if (strcmp(s_token, DEVICEID_TOKEN) == 0)
AzureIoTClient 40:1a94db9139ea 173 {
AzureIoTClient 40:1a94db9139ea 174 deviceIdString = STRING_clone(valueString);
AzureIoTClient 40:1a94db9139ea 175 if (deviceIdString != NULL)
AzureIoTClient 40:1a94db9139ea 176 {
AzureIoTClient 40:1a94db9139ea 177 config->deviceId = STRING_c_str(deviceIdString);
AzureIoTClient 40:1a94db9139ea 178 }
AzureIoTClient 40:1a94db9139ea 179 }
AzureIoTClient 40:1a94db9139ea 180 else if (strcmp(s_token, DEVICEKEY_TOKEN) == 0)
AzureIoTClient 40:1a94db9139ea 181 {
AzureIoTClient 40:1a94db9139ea 182 deviceKeyString = STRING_clone(valueString);
AzureIoTClient 40:1a94db9139ea 183 if (deviceKeyString != NULL)
AzureIoTClient 40:1a94db9139ea 184 {
AzureIoTClient 40:1a94db9139ea 185 config->deviceKey = STRING_c_str(deviceKeyString);
AzureIoTClient 40:1a94db9139ea 186 }
AzureIoTClient 40:1a94db9139ea 187 }
AzureIoTClient 40:1a94db9139ea 188 else if (strcmp(s_token, DEVICESAS_TOKEN) == 0)
AzureIoTClient 40:1a94db9139ea 189 {
AzureIoTClient 40:1a94db9139ea 190 deviceSasTokenString = STRING_clone(valueString);
AzureIoTClient 40:1a94db9139ea 191 if (deviceSasTokenString != NULL)
AzureIoTClient 40:1a94db9139ea 192 {
AzureIoTClient 40:1a94db9139ea 193 config->deviceSasToken = STRING_c_str(deviceSasTokenString);
AzureIoTClient 40:1a94db9139ea 194 }
AzureIoTClient 40:1a94db9139ea 195 }
AzureIoTClient 40:1a94db9139ea 196 /* 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 40:1a94db9139ea 197 else if (strcmp(s_token, PROTOCOL_GATEWAY_HOST) == 0)
AzureIoTClient 40:1a94db9139ea 198 {
AzureIoTClient 40:1a94db9139ea 199 protocolGateway = STRING_clone(valueString);
AzureIoTClient 40:1a94db9139ea 200 if (protocolGateway != NULL)
AzureIoTClient 40:1a94db9139ea 201 {
AzureIoTClient 40:1a94db9139ea 202 config->protocolGatewayHostName = STRING_c_str(protocolGateway);
AzureIoTClient 40:1a94db9139ea 203 }
AzureIoTClient 40:1a94db9139ea 204 }
AzureIoTClient 40:1a94db9139ea 205 }
AzureIoTClient 40:1a94db9139ea 206 }
AzureIoTClient 40:1a94db9139ea 207 }
AzureIoTClient 40:1a94db9139ea 208 /* parsing is done - check the result */
AzureIoTClient 40:1a94db9139ea 209 if (config->iotHubName == NULL)
AzureIoTClient 40:1a94db9139ea 210 {
AzureIoTClient 40:1a94db9139ea 211 LogError("iotHubName is not found");
AzureIoTClient 40:1a94db9139ea 212 }
AzureIoTClient 40:1a94db9139ea 213 else if (config->iotHubSuffix == NULL)
AzureIoTClient 40:1a94db9139ea 214 {
AzureIoTClient 40:1a94db9139ea 215 LogError("iotHubSuffix is not found");
AzureIoTClient 40:1a94db9139ea 216 }
AzureIoTClient 40:1a94db9139ea 217 else if (config->deviceId == NULL)
AzureIoTClient 40:1a94db9139ea 218 {
AzureIoTClient 40:1a94db9139ea 219 LogError("deviceId is not found");
AzureIoTClient 40:1a94db9139ea 220 }
AzureIoTClient 40:1a94db9139ea 221 else if (config->deviceKey == NULL && config->deviceSasToken == NULL)
AzureIoTClient 40:1a94db9139ea 222 {
AzureIoTClient 40:1a94db9139ea 223 LogError("deviceKey/deviceSasToken not found");
AzureIoTClient 40:1a94db9139ea 224 }
AzureIoTClient 40:1a94db9139ea 225 else if (config->deviceKey != NULL && config->deviceSasToken != NULL)
AzureIoTClient 40:1a94db9139ea 226 {
AzureIoTClient 40:1a94db9139ea 227 LogError("Both device Key & SAS token are defined. Only one should be provided.");
AzureIoTClient 40:1a94db9139ea 228 }
AzureIoTClient 40:1a94db9139ea 229 else
AzureIoTClient 40:1a94db9139ea 230 {
AzureIoTClient 40:1a94db9139ea 231 /* Codes_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 40:1a94db9139ea 232 result = IoTHubClient_LL_Create(config);
AzureIoTClient 40:1a94db9139ea 233 if (result == NULL)
AzureIoTClient 40:1a94db9139ea 234 {
AzureIoTClient 40:1a94db9139ea 235 LogError("IoTHubClient_LL_Create failed");
AzureIoTClient 40:1a94db9139ea 236 }
AzureIoTClient 40:1a94db9139ea 237 }
AzureIoTClient 40:1a94db9139ea 238 }
AzureIoTClient 40:1a94db9139ea 239 if (deviceSasTokenString != NULL)
AzureIoTClient 40:1a94db9139ea 240 STRING_delete(deviceSasTokenString);
AzureIoTClient 40:1a94db9139ea 241 if (deviceKeyString != NULL)
AzureIoTClient 40:1a94db9139ea 242 STRING_delete(deviceKeyString);
AzureIoTClient 40:1a94db9139ea 243 if (deviceIdString != NULL)
AzureIoTClient 40:1a94db9139ea 244 STRING_delete(deviceIdString);
AzureIoTClient 40:1a94db9139ea 245 if (hostSuffixString != NULL)
AzureIoTClient 40:1a94db9139ea 246 STRING_delete(hostSuffixString);
AzureIoTClient 40:1a94db9139ea 247 if (hostNameString != NULL)
AzureIoTClient 40:1a94db9139ea 248 STRING_delete(hostNameString);
AzureIoTClient 40:1a94db9139ea 249 if (valueString != NULL)
AzureIoTClient 40:1a94db9139ea 250 STRING_delete(valueString);
AzureIoTClient 40:1a94db9139ea 251 if (tokenString != NULL)
AzureIoTClient 40:1a94db9139ea 252 STRING_delete(tokenString);
AzureIoTClient 40:1a94db9139ea 253 if (connString != NULL)
AzureIoTClient 40:1a94db9139ea 254 STRING_delete(connString);
AzureIoTClient 40:1a94db9139ea 255 if (protocolGateway != NULL)
AzureIoTClient 40:1a94db9139ea 256 STRING_delete(protocolGateway);
AzureIoTClient 16:deba40344375 257
AzureIoTClient 40:1a94db9139ea 258 if (tokenizer1 != NULL)
AzureIoTClient 40:1a94db9139ea 259 STRING_TOKENIZER_destroy(tokenizer1);
AzureIoTClient 16:deba40344375 260
AzureIoTClient 40:1a94db9139ea 261 free(config);
AzureIoTClient 40:1a94db9139ea 262 }
AzureIoTClient 40:1a94db9139ea 263 }
AzureIoTClient 40:1a94db9139ea 264 return result;
AzureIoTClient 16:deba40344375 265 }
AzureIoTClient 16:deba40344375 266
Azure.IoT Build 36:67300d5a4c1f 267 static void setTransportProtocol(IOTHUB_CLIENT_LL_HANDLE_DATA* handleData, TRANSPORT_PROVIDER* protocol)
Azure.IoT Build 36:67300d5a4c1f 268 {
Azure.IoT Build 36:67300d5a4c1f 269 handleData->IoTHubTransport_SetOption = protocol->IoTHubTransport_SetOption;
Azure.IoT Build 36:67300d5a4c1f 270 handleData->IoTHubTransport_Create = protocol->IoTHubTransport_Create;
Azure.IoT Build 36:67300d5a4c1f 271 handleData->IoTHubTransport_Destroy = protocol->IoTHubTransport_Destroy;
Azure.IoT Build 36:67300d5a4c1f 272 handleData->IoTHubTransport_Register = protocol->IoTHubTransport_Register;
Azure.IoT Build 36:67300d5a4c1f 273 handleData->IoTHubTransport_Unregister = protocol->IoTHubTransport_Unregister;
Azure.IoT Build 36:67300d5a4c1f 274 handleData->IoTHubTransport_Subscribe = protocol->IoTHubTransport_Subscribe;
Azure.IoT Build 36:67300d5a4c1f 275 handleData->IoTHubTransport_Unsubscribe = protocol->IoTHubTransport_Unsubscribe;
Azure.IoT Build 36:67300d5a4c1f 276 handleData->IoTHubTransport_DoWork = protocol->IoTHubTransport_DoWork;
Azure.IoT Build 36:67300d5a4c1f 277 handleData->IoTHubTransport_GetSendStatus = protocol->IoTHubTransport_GetSendStatus;
Azure.IoT Build 36:67300d5a4c1f 278
Azure.IoT Build 36:67300d5a4c1f 279 }
AzureIoTClient 16:deba40344375 280
AzureIoTClient 16:deba40344375 281 IOTHUB_CLIENT_LL_HANDLE IoTHubClient_LL_Create(const IOTHUB_CLIENT_CONFIG* config)
AzureIoTClient 16:deba40344375 282 {
AzureIoTClient 40:1a94db9139ea 283 IOTHUB_CLIENT_LL_HANDLE result;
AzureIoTClient 40:1a94db9139ea 284 /*Codes_SRS_IOTHUBCLIENT_LL_02_001: [IoTHubClient_LL_Create shall return NULL if config parameter is NULL or protocol field is NULL.]*/
AzureIoTClient 40:1a94db9139ea 285 if (
AzureIoTClient 40:1a94db9139ea 286 (config == NULL) ||
AzureIoTClient 40:1a94db9139ea 287 (config->protocol == NULL)
AzureIoTClient 40:1a94db9139ea 288 )
AzureIoTClient 40:1a94db9139ea 289 {
AzureIoTClient 40:1a94db9139ea 290 result = NULL;
AzureIoTClient 40:1a94db9139ea 291 LogError("invalid configuration (NULL detected)");
AzureIoTClient 40:1a94db9139ea 292 }
AzureIoTClient 40:1a94db9139ea 293 else
AzureIoTClient 40:1a94db9139ea 294 {
AzureIoTClient 40:1a94db9139ea 295 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)malloc(sizeof(IOTHUB_CLIENT_LL_HANDLE_DATA));
AzureIoTClient 40:1a94db9139ea 296 if (handleData == NULL)
AzureIoTClient 40:1a94db9139ea 297 {
AzureIoTClient 40:1a94db9139ea 298 LogError("malloc failed");
AzureIoTClient 40:1a94db9139ea 299 result = NULL;
AzureIoTClient 40:1a94db9139ea 300 }
AzureIoTClient 40:1a94db9139ea 301 else
AzureIoTClient 40:1a94db9139ea 302 {
AzureIoTClient 40:1a94db9139ea 303 if ((handleData->tickCounter = tickcounter_create()) == NULL)
AzureIoTClient 40:1a94db9139ea 304 {
AzureIoTClient 40:1a94db9139ea 305 LogError("unable to get a tickcounter");
AzureIoTClient 40:1a94db9139ea 306 free(handleData);
AzureIoTClient 40:1a94db9139ea 307 result = NULL;
AzureIoTClient 40:1a94db9139ea 308 }
AzureIoTClient 40:1a94db9139ea 309 else
AzureIoTClient 40:1a94db9139ea 310 {
AzureIoTClient 40:1a94db9139ea 311 /*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 40:1a94db9139ea 312 IOTHUBTRANSPORT_CONFIG lowerLayerConfig;
AzureIoTClient 40:1a94db9139ea 313 DList_InitializeListHead(&(handleData->waitingToSend));
AzureIoTClient 40:1a94db9139ea 314 setTransportProtocol(handleData, (TRANSPORT_PROVIDER*)config->protocol());
AzureIoTClient 40:1a94db9139ea 315 handleData->messageCallback = NULL;
AzureIoTClient 40:1a94db9139ea 316 handleData->messageUserContextCallback = NULL;
AzureIoTClient 40:1a94db9139ea 317 handleData->lastMessageReceiveTime = INDEFINITE_TIME;
AzureIoTClient 40:1a94db9139ea 318 /*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 40:1a94db9139ea 319 lowerLayerConfig.upperConfig = config;
AzureIoTClient 40:1a94db9139ea 320 lowerLayerConfig.waitingToSend = &(handleData->waitingToSend);
AzureIoTClient 40:1a94db9139ea 321 /*Codes_SRS_IOTHUBCLIENT_LL_02_007: [If the underlaying layer _Create function fails them IoTHubClient_LL_Create shall fail and return NULL.] */
AzureIoTClient 40:1a94db9139ea 322 if ((handleData->transportHandle = handleData->IoTHubTransport_Create(&lowerLayerConfig)) == NULL)
Azure.IoT Build 36:67300d5a4c1f 323 {
AzureIoTClient 40:1a94db9139ea 324 LogError("underlying transport failed");
AzureIoTClient 40:1a94db9139ea 325 tickcounter_destroy(handleData->tickCounter);
Azure.IoT Build 36:67300d5a4c1f 326 free(handleData);
Azure.IoT Build 36:67300d5a4c1f 327 result = NULL;
Azure.IoT Build 36:67300d5a4c1f 328 }
Azure.IoT Build 36:67300d5a4c1f 329 else
Azure.IoT Build 36:67300d5a4c1f 330 {
AzureIoTClient 40:1a94db9139ea 331 IOTHUB_DEVICE_CONFIG deviceConfig;
AzureIoTClient 40:1a94db9139ea 332
AzureIoTClient 40:1a94db9139ea 333 deviceConfig.deviceId = config->deviceId;
AzureIoTClient 40:1a94db9139ea 334 deviceConfig.deviceKey = config->deviceKey;
AzureIoTClient 40:1a94db9139ea 335 deviceConfig.deviceSasToken = config->deviceSasToken;
AzureIoTClient 40:1a94db9139ea 336
AzureIoTClient 40:1a94db9139ea 337 /*Codes_SRS_IOTHUBCLIENT_LL_17_008: [IoTHubClient_LL_Create shall call the transport _Register function with a populated structure of type IOTHUB_DEVICE_CONFIG and waitingToSend list.] */
AzureIoTClient 40:1a94db9139ea 338 if ((handleData->deviceHandle = handleData->IoTHubTransport_Register(handleData->transportHandle, &deviceConfig, handleData, &(handleData->waitingToSend))) == NULL)
AzureIoTClient 40:1a94db9139ea 339 {
AzureIoTClient 40:1a94db9139ea 340 /*Codes_SRS_IOTHUBCLIENT_LL_17_009: [If the _Register function fails, this function shall fail and return NULL.]*/
AzureIoTClient 40:1a94db9139ea 341 LogError("Registering device in transport failed");
AzureIoTClient 40:1a94db9139ea 342 handleData->IoTHubTransport_Destroy(handleData->transportHandle);
AzureIoTClient 40:1a94db9139ea 343 tickcounter_destroy(handleData->tickCounter);
AzureIoTClient 40:1a94db9139ea 344 free(handleData);
AzureIoTClient 40:1a94db9139ea 345 result = NULL;
AzureIoTClient 40:1a94db9139ea 346 }
AzureIoTClient 40:1a94db9139ea 347 else
AzureIoTClient 40:1a94db9139ea 348 {
AzureIoTClient 40:1a94db9139ea 349 /*Codes_SRS_IOTHUBCLIENT_LL_02_008: [Otherwise, IoTHubClient_LL_Create shall succeed and return a non-NULL handle.] */
AzureIoTClient 40:1a94db9139ea 350 handleData->isSharedTransport = false;
AzureIoTClient 40:1a94db9139ea 351 /*Codes_SRS_IOTHUBCLIENT_LL_02_042: [ By default, messages shall not timeout. ]*/
AzureIoTClient 40:1a94db9139ea 352 handleData->currentMessageTimeout = 0;
AzureIoTClient 40:1a94db9139ea 353 result = handleData;
AzureIoTClient 40:1a94db9139ea 354 }
Azure.IoT Build 36:67300d5a4c1f 355 }
AzureIoTClient 40:1a94db9139ea 356 }
AzureIoTClient 40:1a94db9139ea 357 }
AzureIoTClient 40:1a94db9139ea 358 }
AzureIoTClient 16:deba40344375 359
AzureIoTClient 40:1a94db9139ea 360 return result;
AzureIoTClient 16:deba40344375 361 }
AzureIoTClient 16:deba40344375 362
Azure.IoT Build 36:67300d5a4c1f 363 IOTHUB_CLIENT_LL_HANDLE IoTHubClient_LL_CreateWithTransport(const IOTHUB_CLIENT_DEVICE_CONFIG * config)
Azure.IoT Build 36:67300d5a4c1f 364 {
Azure.IoT Build 36:67300d5a4c1f 365 IOTHUB_CLIENT_LL_HANDLE result;
Azure.IoT Build 36:67300d5a4c1f 366 /*Codes_SRS_IOTHUBCLIENT_LL_17_001: [IoTHubClient_LL_CreateWithTransport shall return NULL if config parameter is NULL, or protocol field is NULL or transportHandle is NULL.]*/
Azure.IoT Build 36:67300d5a4c1f 367 if (
Azure.IoT Build 36:67300d5a4c1f 368 (config == NULL) ||
Azure.IoT Build 36:67300d5a4c1f 369 (config->protocol == NULL) ||
Azure.IoT Build 36:67300d5a4c1f 370 (config->transportHandle == NULL)
Azure.IoT Build 36:67300d5a4c1f 371 )
Azure.IoT Build 36:67300d5a4c1f 372 {
Azure.IoT Build 36:67300d5a4c1f 373 result = NULL;
AzureIoTClient 39:2719651a5bee 374 LogError("invalid configuration (NULL detected)");
Azure.IoT Build 36:67300d5a4c1f 375 }
Azure.IoT Build 36:67300d5a4c1f 376 else
Azure.IoT Build 36:67300d5a4c1f 377 {
Azure.IoT Build 36:67300d5a4c1f 378 /*Codes_SRS_IOTHUBCLIENT_LL_17_002: [IoTHubClient_LL_CreateWithTransport shall allocate data for the IOTHUB_CLIENT_LL_HANDLE.]*/
Azure.IoT Build 36:67300d5a4c1f 379 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)malloc(sizeof(IOTHUB_CLIENT_LL_HANDLE_DATA));
Azure.IoT Build 36:67300d5a4c1f 380 if (handleData == NULL)
Azure.IoT Build 36:67300d5a4c1f 381 {
Azure.IoT Build 36:67300d5a4c1f 382 /*Codes_SRS_IOTHUBCLIENT_LL_17_003: [If allocation fails, the function shall fail and return NULL.] */
AzureIoTClient 39:2719651a5bee 383 LogError("malloc failed");
Azure.IoT Build 36:67300d5a4c1f 384 result = NULL;
Azure.IoT Build 36:67300d5a4c1f 385 }
Azure.IoT Build 36:67300d5a4c1f 386 else
Azure.IoT Build 36:67300d5a4c1f 387 {
AzureIoTClient 40:1a94db9139ea 388 if ((handleData->tickCounter = tickcounter_create()) == NULL)
Azure.IoT Build 36:67300d5a4c1f 389 {
AzureIoTClient 40:1a94db9139ea 390 LogError("unable to get a tickcounter");
Azure.IoT Build 36:67300d5a4c1f 391 free(handleData);
Azure.IoT Build 36:67300d5a4c1f 392 result = NULL;
Azure.IoT Build 36:67300d5a4c1f 393 }
Azure.IoT Build 36:67300d5a4c1f 394 else
Azure.IoT Build 36:67300d5a4c1f 395 {
AzureIoTClient 40:1a94db9139ea 396 /*Codes_SRS_IOTHUBCLIENT_LL_17_004: [IoTHubClient_LL_CreateWithTransport 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 40:1a94db9139ea 397 DList_InitializeListHead(&(handleData->waitingToSend));
AzureIoTClient 40:1a94db9139ea 398 setTransportProtocol(handleData, (TRANSPORT_PROVIDER*)config->protocol());
AzureIoTClient 40:1a94db9139ea 399 handleData->messageCallback = NULL;
AzureIoTClient 40:1a94db9139ea 400 handleData->messageUserContextCallback = NULL;
AzureIoTClient 40:1a94db9139ea 401 handleData->lastMessageReceiveTime = INDEFINITE_TIME;
AzureIoTClient 40:1a94db9139ea 402 handleData->transportHandle = config->transportHandle;
AzureIoTClient 40:1a94db9139ea 403
AzureIoTClient 40:1a94db9139ea 404
AzureIoTClient 40:1a94db9139ea 405 IOTHUB_DEVICE_CONFIG deviceConfig;
AzureIoTClient 40:1a94db9139ea 406
AzureIoTClient 40:1a94db9139ea 407 deviceConfig.deviceId = config->deviceId;
AzureIoTClient 40:1a94db9139ea 408 deviceConfig.deviceKey = config->deviceKey;
AzureIoTClient 40:1a94db9139ea 409 deviceConfig.deviceSasToken = config->deviceSasToken;
AzureIoTClient 40:1a94db9139ea 410
AzureIoTClient 40:1a94db9139ea 411 /*Codes_SRS_IOTHUBCLIENT_LL_17_006: [IoTHubClient_LL_CreateWithTransport shall call the transport _Register function with the IOTHUB_DEVICE_CONFIG populated structure and waitingToSend list.]*/
AzureIoTClient 40:1a94db9139ea 412 if ((handleData->deviceHandle = handleData->IoTHubTransport_Register(config->transportHandle, &deviceConfig, handleData, &(handleData->waitingToSend))) == NULL)
AzureIoTClient 40:1a94db9139ea 413 {
AzureIoTClient 40:1a94db9139ea 414 /*Codes_SRS_IOTHUBCLIENT_LL_17_007: [If the _Register function fails, this function shall fail and return NULL.]*/
AzureIoTClient 40:1a94db9139ea 415 LogError("Registering device in transport failed");
AzureIoTClient 40:1a94db9139ea 416 tickcounter_destroy(handleData->tickCounter);
AzureIoTClient 40:1a94db9139ea 417 free(handleData);
AzureIoTClient 40:1a94db9139ea 418 result = NULL;
AzureIoTClient 40:1a94db9139ea 419 }
AzureIoTClient 40:1a94db9139ea 420 else
AzureIoTClient 40:1a94db9139ea 421 {
AzureIoTClient 40:1a94db9139ea 422 /*Codes_SRS_IOTHUBCLIENT_LL_17_005: [IoTHubClient_LL_CreateWithTransport shall save the transport handle and mark this transport as shared.]*/
AzureIoTClient 40:1a94db9139ea 423 handleData->isSharedTransport = true;
AzureIoTClient 40:1a94db9139ea 424 /*Codes_SRS_IOTHUBCLIENT_LL_02_042: [ By default, messages shall not timeout. ]*/
AzureIoTClient 40:1a94db9139ea 425 handleData->currentMessageTimeout = 0;
AzureIoTClient 40:1a94db9139ea 426 result = handleData;
AzureIoTClient 40:1a94db9139ea 427 }
Azure.IoT Build 36:67300d5a4c1f 428 }
Azure.IoT Build 36:67300d5a4c1f 429 }
Azure.IoT Build 36:67300d5a4c1f 430 }
Azure.IoT Build 36:67300d5a4c1f 431
Azure.IoT Build 36:67300d5a4c1f 432 return result;
Azure.IoT Build 36:67300d5a4c1f 433 }
Azure.IoT Build 36:67300d5a4c1f 434
AzureIoTClient 16:deba40344375 435 void IoTHubClient_LL_Destroy(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle)
AzureIoTClient 16:deba40344375 436 {
AzureIoTClient 40:1a94db9139ea 437 /*Codes_SRS_IOTHUBCLIENT_LL_02_009: [IoTHubClient_LL_Destroy shall do nothing if parameter iotHubClientHandle is NULL.]*/
AzureIoTClient 40:1a94db9139ea 438 if (iotHubClientHandle != NULL)
AzureIoTClient 40:1a94db9139ea 439 {
AzureIoTClient 40:1a94db9139ea 440 PDLIST_ENTRY unsend;
Azure.IoT Build 36:67300d5a4c1f 441 /*Codes_SRS_IOTHUBCLIENT_LL_17_010: [IoTHubClient_LL_Destroy shall call the underlaying layer's _Unregister function] */
AzureIoTClient 40:1a94db9139ea 442 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
Azure.IoT Build 36:67300d5a4c1f 443 handleData->IoTHubTransport_Unregister(handleData->deviceHandle);
Azure.IoT Build 36:67300d5a4c1f 444 if (handleData->isSharedTransport == false)
Azure.IoT Build 36:67300d5a4c1f 445 {
Azure.IoT Build 36:67300d5a4c1f 446 /*Codes_SRS_IOTHUBCLIENT_LL_02_010: [If iotHubClientHandle was not created by IoTHubClient_LL_CreateWithTransport, IoTHubClient_LL_Destroy shall call the underlaying layer's _Destroy function.] */
Azure.IoT Build 36:67300d5a4c1f 447 handleData->IoTHubTransport_Destroy(handleData->transportHandle);
Azure.IoT Build 36:67300d5a4c1f 448 }
AzureIoTClient 40:1a94db9139ea 449 /*if any, remove the items currently not send*/
AzureIoTClient 40:1a94db9139ea 450 while ((unsend = DList_RemoveHeadList(&(handleData->waitingToSend))) != &(handleData->waitingToSend))
AzureIoTClient 40:1a94db9139ea 451 {
AzureIoTClient 40:1a94db9139ea 452 IOTHUB_MESSAGE_LIST* temp = containingRecord(unsend, IOTHUB_MESSAGE_LIST, entry);
AzureIoTClient 40:1a94db9139ea 453 /*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 40:1a94db9139ea 454 if (temp->callback != NULL)
AzureIoTClient 40:1a94db9139ea 455 {
AzureIoTClient 40:1a94db9139ea 456 temp->callback(IOTHUB_CLIENT_CONFIRMATION_BECAUSE_DESTROY, temp->context);
AzureIoTClient 40:1a94db9139ea 457 }
AzureIoTClient 40:1a94db9139ea 458 IoTHubMessage_Destroy(temp->messageHandle);
AzureIoTClient 40:1a94db9139ea 459 free(temp);
AzureIoTClient 40:1a94db9139ea 460 }
Azure.IoT Build 36:67300d5a4c1f 461 /*Codes_SRS_IOTHUBCLIENT_LL_17_011: [IoTHubClient_LL_Destroy shall free the resources allocated by IoTHubClient (if any).] */
AzureIoTClient 40:1a94db9139ea 462 tickcounter_destroy(handleData->tickCounter);
AzureIoTClient 40:1a94db9139ea 463 free(handleData);
AzureIoTClient 40:1a94db9139ea 464 }
AzureIoTClient 16:deba40344375 465 }
AzureIoTClient 16:deba40344375 466
Azure.IoT Build 36:67300d5a4c1f 467 /*Codes_SRS_IOTHUBCLIENT_LL_02_044: [ Messages already delivered to IoTHubClient_LL shall not have their timeouts modified by a new call to IoTHubClient_LL_SetOption. ]*/
Azure.IoT Build 36:67300d5a4c1f 468 /*returns 0 on success, any other value is error*/
Azure.IoT Build 36:67300d5a4c1f 469 static int attach_ms_timesOutAfter(IOTHUB_CLIENT_LL_HANDLE_DATA* handleData, IOTHUB_MESSAGE_LIST *newEntry)
Azure.IoT Build 36:67300d5a4c1f 470 {
AzureIoTClient 40:1a94db9139ea 471 int result;
AzureIoTClient 40:1a94db9139ea 472 /*Codes_SRS_IOTHUBCLIENT_LL_02_043: [ Calling IoTHubClient_LL_SetOption with value set to "0" shall disable the timeout mechanism for all new messages. ]*/
AzureIoTClient 40:1a94db9139ea 473 if (handleData->currentMessageTimeout == 0)
AzureIoTClient 40:1a94db9139ea 474 {
AzureIoTClient 40:1a94db9139ea 475 newEntry->ms_timesOutAfter = 0; /*do not timeout*/
AzureIoTClient 40:1a94db9139ea 476 result = 0;
AzureIoTClient 40:1a94db9139ea 477 }
AzureIoTClient 40:1a94db9139ea 478 else
AzureIoTClient 40:1a94db9139ea 479 {
AzureIoTClient 40:1a94db9139ea 480 /*Codes_SRS_IOTHUBCLIENT_LL_02_039: [ "messageTimeout" - once IoTHubClient_LL_SendEventAsync is called the message shall timeout after value miliseconds. Value is a pointer to a uint64. ]*/
AzureIoTClient 40:1a94db9139ea 481 if (tickcounter_get_current_ms(handleData->tickCounter, &newEntry->ms_timesOutAfter) != 0)
AzureIoTClient 40:1a94db9139ea 482 {
AzureIoTClient 40:1a94db9139ea 483 result = __LINE__;
AzureIoTClient 40:1a94db9139ea 484 LogError("unable to get the current relative tickcount");
AzureIoTClient 40:1a94db9139ea 485 }
AzureIoTClient 40:1a94db9139ea 486 else
AzureIoTClient 40:1a94db9139ea 487 {
AzureIoTClient 40:1a94db9139ea 488 newEntry->ms_timesOutAfter += handleData->currentMessageTimeout;
AzureIoTClient 40:1a94db9139ea 489 result = 0;
AzureIoTClient 40:1a94db9139ea 490 }
AzureIoTClient 40:1a94db9139ea 491 }
AzureIoTClient 40:1a94db9139ea 492 return result;
Azure.IoT Build 36:67300d5a4c1f 493 }
Azure.IoT Build 36:67300d5a4c1f 494
AzureIoTClient 16:deba40344375 495 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 496 {
AzureIoTClient 40:1a94db9139ea 497 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 40:1a94db9139ea 498 /*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 40:1a94db9139ea 499 if (
AzureIoTClient 40:1a94db9139ea 500 (iotHubClientHandle == NULL) ||
AzureIoTClient 40:1a94db9139ea 501 (eventMessageHandle == NULL) ||
AzureIoTClient 40:1a94db9139ea 502 /*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 40:1a94db9139ea 503 ((eventConfirmationCallback == NULL) && (userContextCallback != NULL))
AzureIoTClient 40:1a94db9139ea 504 )
AzureIoTClient 40:1a94db9139ea 505 {
AzureIoTClient 40:1a94db9139ea 506 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 40:1a94db9139ea 507 LOG_ERROR;
AzureIoTClient 40:1a94db9139ea 508 }
AzureIoTClient 40:1a94db9139ea 509 else
AzureIoTClient 40:1a94db9139ea 510 {
AzureIoTClient 40:1a94db9139ea 511 IOTHUB_MESSAGE_LIST *newEntry = (IOTHUB_MESSAGE_LIST*)malloc(sizeof(IOTHUB_MESSAGE_LIST));
AzureIoTClient 40:1a94db9139ea 512 if (newEntry == NULL)
AzureIoTClient 40:1a94db9139ea 513 {
AzureIoTClient 40:1a94db9139ea 514 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 40:1a94db9139ea 515 LOG_ERROR;
AzureIoTClient 40:1a94db9139ea 516 }
AzureIoTClient 40:1a94db9139ea 517 else
AzureIoTClient 40:1a94db9139ea 518 {
AzureIoTClient 40:1a94db9139ea 519 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 40:1a94db9139ea 520
AzureIoTClient 40:1a94db9139ea 521 if (attach_ms_timesOutAfter(handleData, newEntry) != 0)
AzureIoTClient 40:1a94db9139ea 522 {
AzureIoTClient 40:1a94db9139ea 523 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 40:1a94db9139ea 524 LOG_ERROR;
AzureIoTClient 40:1a94db9139ea 525 free(newEntry);
AzureIoTClient 40:1a94db9139ea 526 }
AzureIoTClient 40:1a94db9139ea 527 else
AzureIoTClient 40:1a94db9139ea 528 {
AzureIoTClient 40:1a94db9139ea 529 /*Codes_SRS_IOTHUBCLIENT_LL_02_013: [IoTHubClient_SendEventAsync shall add the DLIST waitingToSend a new record cloning the information from eventMessageHandle, eventConfirmationCallback, userContextCallback.]*/
AzureIoTClient 40:1a94db9139ea 530 if ((newEntry->messageHandle = IoTHubMessage_Clone(eventMessageHandle)) == NULL)
AzureIoTClient 40:1a94db9139ea 531 {
AzureIoTClient 40:1a94db9139ea 532 /*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 40:1a94db9139ea 533 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 40:1a94db9139ea 534 free(newEntry);
AzureIoTClient 40:1a94db9139ea 535 LOG_ERROR;
AzureIoTClient 40:1a94db9139ea 536 }
AzureIoTClient 40:1a94db9139ea 537 else
AzureIoTClient 40:1a94db9139ea 538 {
AzureIoTClient 40:1a94db9139ea 539 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 40:1a94db9139ea 540 /*Codes_SRS_IOTHUBCLIENT_LL_02_013: [IoTHubClient_SendEventAsync shall add the DLIST waitingToSend a new record cloning the information from eventMessageHandle, eventConfirmationCallback, userContextCallback.]*/
AzureIoTClient 40:1a94db9139ea 541 newEntry->callback = eventConfirmationCallback;
AzureIoTClient 40:1a94db9139ea 542 newEntry->context = userContextCallback;
AzureIoTClient 40:1a94db9139ea 543 DList_InsertTailList(&(handleData->waitingToSend), &(newEntry->entry));
AzureIoTClient 40:1a94db9139ea 544 /*Codes_SRS_IOTHUBCLIENT_LL_02_015: [Otherwise IoTHubClient_LL_SendEventAsync shall succeed and return IOTHUB_CLIENT_OK.] */
AzureIoTClient 40:1a94db9139ea 545 result = IOTHUB_CLIENT_OK;
AzureIoTClient 40:1a94db9139ea 546 }
AzureIoTClient 40:1a94db9139ea 547 }
AzureIoTClient 40:1a94db9139ea 548 }
AzureIoTClient 40:1a94db9139ea 549 }
AzureIoTClient 40:1a94db9139ea 550 return result;
AzureIoTClient 16:deba40344375 551 }
AzureIoTClient 16:deba40344375 552
AzureIoTClient 16:deba40344375 553 IOTHUB_CLIENT_RESULT IoTHubClient_LL_SetMessageCallback(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, IOTHUB_CLIENT_MESSAGE_CALLBACK_ASYNC messageCallback, void* userContextCallback)
AzureIoTClient 16:deba40344375 554 {
AzureIoTClient 40:1a94db9139ea 555 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 40:1a94db9139ea 556 /*Codes_SRS_IOTHUBCLIENT_LL_02_016: [IoTHubClient_LL_SetMessageCallback shall fail and return IOTHUB_CLIENT_INVALID_ARG if parameter iotHubClientHandle is NULL.] */
AzureIoTClient 40:1a94db9139ea 557 if (iotHubClientHandle == NULL)
AzureIoTClient 40:1a94db9139ea 558 {
AzureIoTClient 40:1a94db9139ea 559 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 40:1a94db9139ea 560 LOG_ERROR;
AzureIoTClient 40:1a94db9139ea 561 }
AzureIoTClient 40:1a94db9139ea 562 else
AzureIoTClient 40:1a94db9139ea 563 {
AzureIoTClient 40:1a94db9139ea 564 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 40:1a94db9139ea 565 if (messageCallback == NULL)
AzureIoTClient 40:1a94db9139ea 566 {
AzureIoTClient 40:1a94db9139ea 567 /*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 40:1a94db9139ea 568 handleData->IoTHubTransport_Unsubscribe(handleData->deviceHandle);
AzureIoTClient 40:1a94db9139ea 569 handleData->messageCallback = NULL;
AzureIoTClient 40:1a94db9139ea 570 handleData->messageUserContextCallback = NULL;
AzureIoTClient 40:1a94db9139ea 571 result = IOTHUB_CLIENT_OK;
AzureIoTClient 40:1a94db9139ea 572 }
AzureIoTClient 40:1a94db9139ea 573 else
AzureIoTClient 40:1a94db9139ea 574 {
AzureIoTClient 40:1a94db9139ea 575 /*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 40:1a94db9139ea 576 if (handleData->IoTHubTransport_Subscribe(handleData->deviceHandle) == 0)
AzureIoTClient 40:1a94db9139ea 577 {
AzureIoTClient 40:1a94db9139ea 578 handleData->messageCallback = messageCallback;
AzureIoTClient 40:1a94db9139ea 579 handleData->messageUserContextCallback = userContextCallback;
AzureIoTClient 40:1a94db9139ea 580 result = IOTHUB_CLIENT_OK;
AzureIoTClient 40:1a94db9139ea 581 }
AzureIoTClient 40:1a94db9139ea 582 else
AzureIoTClient 40:1a94db9139ea 583 {
AzureIoTClient 40:1a94db9139ea 584 handleData->messageCallback = NULL;
AzureIoTClient 40:1a94db9139ea 585 handleData->messageUserContextCallback = NULL;
AzureIoTClient 40:1a94db9139ea 586 /*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 40:1a94db9139ea 587 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 40:1a94db9139ea 588 }
AzureIoTClient 40:1a94db9139ea 589 }
AzureIoTClient 40:1a94db9139ea 590 }
AzureIoTClient 40:1a94db9139ea 591
AzureIoTClient 40:1a94db9139ea 592 return result;
AzureIoTClient 16:deba40344375 593 }
AzureIoTClient 16:deba40344375 594
Azure.IoT Build 36:67300d5a4c1f 595 static void DoTimeouts(IOTHUB_CLIENT_LL_HANDLE_DATA* handleData)
Azure.IoT Build 36:67300d5a4c1f 596 {
AzureIoTClient 40:1a94db9139ea 597 uint64_t nowTick;
AzureIoTClient 40:1a94db9139ea 598 if (tickcounter_get_current_ms(handleData->tickCounter, &nowTick) != 0)
AzureIoTClient 40:1a94db9139ea 599 {
AzureIoTClient 40:1a94db9139ea 600 LogError("unable to get the current ms, timeouts will not be processed");
AzureIoTClient 40:1a94db9139ea 601 }
AzureIoTClient 40:1a94db9139ea 602 else
AzureIoTClient 40:1a94db9139ea 603 {
AzureIoTClient 40:1a94db9139ea 604 DLIST_ENTRY* currentItemInWaitingToSend = handleData->waitingToSend.Flink;
AzureIoTClient 40:1a94db9139ea 605 while (currentItemInWaitingToSend != &(handleData->waitingToSend)) /*while we are not at the end of the list*/
AzureIoTClient 40:1a94db9139ea 606 {
AzureIoTClient 40:1a94db9139ea 607 IOTHUB_MESSAGE_LIST* fullEntry = containingRecord(currentItemInWaitingToSend, IOTHUB_MESSAGE_LIST, entry);
AzureIoTClient 40:1a94db9139ea 608 /*Codes_SRS_IOTHUBCLIENT_LL_02_041: [ If more than value miliseconds have passed since the call to IoTHubClient_LL_SendEventAsync then the message callback shall be called with a status code of IOTHUB_CLIENT_CONFIRMATION_TIMEOUT. ]*/
AzureIoTClient 40:1a94db9139ea 609 if ((fullEntry->ms_timesOutAfter!=0) && (fullEntry->ms_timesOutAfter < nowTick))
AzureIoTClient 40:1a94db9139ea 610 {
AzureIoTClient 40:1a94db9139ea 611 PDLIST_ENTRY theNext = currentItemInWaitingToSend->Flink; /*need to save the next item, because the below operations are destructive*/
AzureIoTClient 40:1a94db9139ea 612 DList_RemoveEntryList(currentItemInWaitingToSend);
AzureIoTClient 40:1a94db9139ea 613 if (fullEntry->callback != NULL)
AzureIoTClient 40:1a94db9139ea 614 {
AzureIoTClient 40:1a94db9139ea 615 fullEntry->callback(IOTHUB_CLIENT_CONFIRMATION_MESSAGE_TIMEOUT, fullEntry->context);
AzureIoTClient 40:1a94db9139ea 616 }
AzureIoTClient 40:1a94db9139ea 617 IoTHubMessage_Destroy(fullEntry->messageHandle); /*because it has been cloned*/
AzureIoTClient 40:1a94db9139ea 618 free(fullEntry);
AzureIoTClient 40:1a94db9139ea 619 currentItemInWaitingToSend = theNext;
AzureIoTClient 40:1a94db9139ea 620 }
AzureIoTClient 40:1a94db9139ea 621 else
AzureIoTClient 40:1a94db9139ea 622 {
AzureIoTClient 40:1a94db9139ea 623 currentItemInWaitingToSend = currentItemInWaitingToSend->Flink;
AzureIoTClient 40:1a94db9139ea 624 }
AzureIoTClient 40:1a94db9139ea 625 }
AzureIoTClient 40:1a94db9139ea 626 }
Azure.IoT Build 36:67300d5a4c1f 627 }
Azure.IoT Build 36:67300d5a4c1f 628
AzureIoTClient 16:deba40344375 629 void IoTHubClient_LL_DoWork(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle)
AzureIoTClient 16:deba40344375 630 {
AzureIoTClient 40:1a94db9139ea 631 /*Codes_SRS_IOTHUBCLIENT_LL_02_020: [If parameter iotHubClientHandle is NULL then IoTHubClient_LL_DoWork shall not perform any action.] */
AzureIoTClient 40:1a94db9139ea 632 if (iotHubClientHandle != NULL)
AzureIoTClient 40:1a94db9139ea 633 {
AzureIoTClient 40:1a94db9139ea 634 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 40:1a94db9139ea 635 DoTimeouts(handleData);
AzureIoTClient 40:1a94db9139ea 636 handleData->IoTHubTransport_DoWork(handleData->transportHandle, iotHubClientHandle);
AzureIoTClient 40:1a94db9139ea 637 }
AzureIoTClient 16:deba40344375 638 }
AzureIoTClient 16:deba40344375 639
AzureIoTClient 16:deba40344375 640 IOTHUB_CLIENT_RESULT IoTHubClient_LL_GetSendStatus(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, IOTHUB_CLIENT_STATUS *iotHubClientStatus)
AzureIoTClient 16:deba40344375 641 {
AzureIoTClient 40:1a94db9139ea 642 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 16:deba40344375 643
AzureIoTClient 40:1a94db9139ea 644 /* Codes_SRS_IOTHUBCLIENT_09_007: [IoTHubClient_GetSendStatus shall return IOTHUB_CLIENT_INVALID_ARG if called with NULL parameter] */
AzureIoTClient 40:1a94db9139ea 645 if (iotHubClientHandle == NULL || iotHubClientStatus == NULL)
AzureIoTClient 40:1a94db9139ea 646 {
AzureIoTClient 40:1a94db9139ea 647 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 40:1a94db9139ea 648 LOG_ERROR;
AzureIoTClient 40:1a94db9139ea 649 }
AzureIoTClient 40:1a94db9139ea 650 else
AzureIoTClient 40:1a94db9139ea 651 {
AzureIoTClient 40:1a94db9139ea 652 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 16:deba40344375 653
AzureIoTClient 40:1a94db9139ea 654 /* 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 40:1a94db9139ea 655 /* 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 40:1a94db9139ea 656 result = handleData->IoTHubTransport_GetSendStatus(handleData->deviceHandle, iotHubClientStatus);
AzureIoTClient 40:1a94db9139ea 657 }
AzureIoTClient 16:deba40344375 658
AzureIoTClient 40:1a94db9139ea 659 return result;
AzureIoTClient 16:deba40344375 660 }
AzureIoTClient 16:deba40344375 661
AzureIoTClient 16:deba40344375 662 void IoTHubClient_LL_SendComplete(IOTHUB_CLIENT_LL_HANDLE handle, PDLIST_ENTRY completed, IOTHUB_BATCHSTATE_RESULT result)
AzureIoTClient 16:deba40344375 663 {
AzureIoTClient 40:1a94db9139ea 664 /*Codes_SRS_IOTHUBCLIENT_LL_02_022: [If parameter completed is NULL, or parameter handle is NULL then IoTHubClient_LL_SendBatch shall return.]*/
AzureIoTClient 40:1a94db9139ea 665 if (
AzureIoTClient 40:1a94db9139ea 666 (handle == NULL) ||
AzureIoTClient 40:1a94db9139ea 667 (completed == NULL)
AzureIoTClient 40:1a94db9139ea 668 )
AzureIoTClient 40:1a94db9139ea 669 {
AzureIoTClient 40:1a94db9139ea 670 /*"shall return"*/
AzureIoTClient 40:1a94db9139ea 671 LogError("invalid arg");
AzureIoTClient 40:1a94db9139ea 672 }
AzureIoTClient 40:1a94db9139ea 673 else
AzureIoTClient 40:1a94db9139ea 674 {
AzureIoTClient 40:1a94db9139ea 675 /*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 40:1a94db9139ea 676 /*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 40:1a94db9139ea 677 IOTHUB_CLIENT_CONFIRMATION_RESULT resultToBeCalled = (result == IOTHUB_BATCHSTATE_SUCCESS) ? IOTHUB_CLIENT_CONFIRMATION_OK : IOTHUB_CLIENT_CONFIRMATION_ERROR;
AzureIoTClient 40:1a94db9139ea 678 PDLIST_ENTRY oldest;
AzureIoTClient 40:1a94db9139ea 679 while((oldest= DList_RemoveHeadList(completed))!=completed)
AzureIoTClient 40:1a94db9139ea 680 {
AzureIoTClient 40:1a94db9139ea 681 IOTHUB_MESSAGE_LIST* messageList = (IOTHUB_MESSAGE_LIST*)containingRecord(oldest, IOTHUB_MESSAGE_LIST, entry);
AzureIoTClient 40:1a94db9139ea 682 if (messageList->callback != NULL)
AzureIoTClient 40:1a94db9139ea 683 {
AzureIoTClient 40:1a94db9139ea 684 messageList->callback(resultToBeCalled, messageList->context);
AzureIoTClient 40:1a94db9139ea 685 }
AzureIoTClient 40:1a94db9139ea 686 IoTHubMessage_Destroy(messageList->messageHandle);
AzureIoTClient 40:1a94db9139ea 687 free(messageList);
AzureIoTClient 40:1a94db9139ea 688 }
AzureIoTClient 40:1a94db9139ea 689 }
AzureIoTClient 16:deba40344375 690 }
AzureIoTClient 16:deba40344375 691
AzureIoTClient 16:deba40344375 692 IOTHUBMESSAGE_DISPOSITION_RESULT IoTHubClient_LL_MessageCallback(IOTHUB_CLIENT_LL_HANDLE handle, IOTHUB_MESSAGE_HANDLE message)
AzureIoTClient 16:deba40344375 693 {
AzureIoTClient 40:1a94db9139ea 694 int result;
AzureIoTClient 40:1a94db9139ea 695 /*Codes_SRS_IOTHUBCLIENT_LL_02_029: [If parameter handle is NULL then IoTHubClient_LL_MessageCallback shall return IOTHUBMESSAGE_ABANDONED.] */
AzureIoTClient 40:1a94db9139ea 696 if (handle == NULL)
AzureIoTClient 40:1a94db9139ea 697 {
AzureIoTClient 40:1a94db9139ea 698 LogError("invalid argument");
AzureIoTClient 40:1a94db9139ea 699 result = IOTHUBMESSAGE_ABANDONED;
AzureIoTClient 40:1a94db9139ea 700 }
AzureIoTClient 40:1a94db9139ea 701 else
AzureIoTClient 40:1a94db9139ea 702 {
AzureIoTClient 40:1a94db9139ea 703 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)handle;
AzureIoTClient 16:deba40344375 704
AzureIoTClient 40:1a94db9139ea 705 /* Codes_SRS_IOTHUBCLIENT_LL_09_004: [IoTHubClient_LL_GetLastMessageReceiveTime shall return lastMessageReceiveTime in localtime] */
AzureIoTClient 40:1a94db9139ea 706 handleData->lastMessageReceiveTime = get_time(NULL);
AzureIoTClient 16:deba40344375 707
AzureIoTClient 40:1a94db9139ea 708 /*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 40:1a94db9139ea 709 if (handleData->messageCallback != NULL)
AzureIoTClient 40:1a94db9139ea 710 {
AzureIoTClient 40:1a94db9139ea 711 result = handleData->messageCallback(message, handleData->messageUserContextCallback);
AzureIoTClient 40:1a94db9139ea 712 }
AzureIoTClient 40:1a94db9139ea 713 else
AzureIoTClient 40:1a94db9139ea 714 {
AzureIoTClient 40:1a94db9139ea 715 /*Codes_SRS_IOTHUBCLIENT_LL_02_032: [If the last callback function was NULL, then IoTHubClient_LL_MessageCallback shall return IOTHUBMESSAGE_ABANDONED.] */
AzureIoTClient 40:1a94db9139ea 716 LogError("user callback was NULL");
AzureIoTClient 40:1a94db9139ea 717 result = IOTHUBMESSAGE_ABANDONED;
AzureIoTClient 40:1a94db9139ea 718 }
AzureIoTClient 40:1a94db9139ea 719 }
AzureIoTClient 40:1a94db9139ea 720 /*Codes_SRS_IOTHUBCLIENT_LL_02_031: [Then IoTHubClient_LL_MessageCallback shall return what the user function returns.]*/
AzureIoTClient 40:1a94db9139ea 721 return result;
AzureIoTClient 16:deba40344375 722 }
AzureIoTClient 16:deba40344375 723
AzureIoTClient 16:deba40344375 724 IOTHUB_CLIENT_RESULT IoTHubClient_LL_GetLastMessageReceiveTime(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, time_t* lastMessageReceiveTime)
AzureIoTClient 16:deba40344375 725 {
AzureIoTClient 40:1a94db9139ea 726 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 40:1a94db9139ea 727 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 16:deba40344375 728
AzureIoTClient 40:1a94db9139ea 729 /* Codes_SRS_IOTHUBCLIENT_LL_09_001: [IoTHubClient_LL_GetLastMessageReceiveTime shall return IOTHUB_CLIENT_INVALID_ARG if any of the arguments is NULL] */
AzureIoTClient 40:1a94db9139ea 730 if (handleData == NULL || lastMessageReceiveTime == NULL)
AzureIoTClient 40:1a94db9139ea 731 {
AzureIoTClient 40:1a94db9139ea 732 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 40:1a94db9139ea 733 LOG_ERROR;
AzureIoTClient 40:1a94db9139ea 734 }
AzureIoTClient 40:1a94db9139ea 735 else
AzureIoTClient 40:1a94db9139ea 736 {
AzureIoTClient 40:1a94db9139ea 737 /* 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 40:1a94db9139ea 738 if (handleData->lastMessageReceiveTime == INDEFINITE_TIME)
AzureIoTClient 40:1a94db9139ea 739 {
AzureIoTClient 40:1a94db9139ea 740 result = IOTHUB_CLIENT_INDEFINITE_TIME;
AzureIoTClient 40:1a94db9139ea 741 LOG_ERROR;
AzureIoTClient 40:1a94db9139ea 742 }
AzureIoTClient 40:1a94db9139ea 743 else
AzureIoTClient 40:1a94db9139ea 744 {
AzureIoTClient 40:1a94db9139ea 745 /* 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 40:1a94db9139ea 746 /* Codes_SRS_IOTHUBCLIENT_LL_09_004: [IoTHubClient_LL_GetLastMessageReceiveTime shall return lastMessageReceiveTime in localtime] */
AzureIoTClient 40:1a94db9139ea 747 *lastMessageReceiveTime = handleData->lastMessageReceiveTime;
AzureIoTClient 40:1a94db9139ea 748 result = IOTHUB_CLIENT_OK;
AzureIoTClient 40:1a94db9139ea 749 }
AzureIoTClient 40:1a94db9139ea 750 }
AzureIoTClient 16:deba40344375 751
AzureIoTClient 40:1a94db9139ea 752 return result;
AzureIoTClient 16:deba40344375 753 }
AzureIoTClient 16:deba40344375 754
AzureIoTClient 16:deba40344375 755 IOTHUB_CLIENT_RESULT IoTHubClient_LL_SetOption(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, const char* optionName, const void* value)
AzureIoTClient 16:deba40344375 756 {
AzureIoTClient 40:1a94db9139ea 757
AzureIoTClient 40:1a94db9139ea 758 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 40:1a94db9139ea 759 /*Codes_SRS_IOTHUBCLIENT_LL_02_034: [If iotHubClientHandle is NULL then IoTHubClient_LL_SetOption shall return IOTHUB_CLIENT_INVALID_ARG.]*/
AzureIoTClient 40:1a94db9139ea 760 /*Codes_SRS_IOTHUBCLIENT_LL_02_035: [If optionName is NULL then IoTHubClient_LL_SetOption shall return IOTHUB_CLIENT_INVALID_ARG.] */
AzureIoTClient 40:1a94db9139ea 761 /*Codes_SRS_IOTHUBCLIENT_LL_02_036: [If value is NULL then IoTHubClient_LL_SetOption shall return IOTHUB_CLIENT_INVALID_ARG.] */
AzureIoTClient 40:1a94db9139ea 762 if (
AzureIoTClient 40:1a94db9139ea 763 (iotHubClientHandle == NULL) ||
AzureIoTClient 40:1a94db9139ea 764 (optionName == NULL) ||
AzureIoTClient 40:1a94db9139ea 765 (value == NULL)
AzureIoTClient 40:1a94db9139ea 766 )
AzureIoTClient 40:1a94db9139ea 767 {
AzureIoTClient 40:1a94db9139ea 768 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 40:1a94db9139ea 769 LogError("invalid argument (NULL)");
AzureIoTClient 40:1a94db9139ea 770 }
AzureIoTClient 40:1a94db9139ea 771 else
AzureIoTClient 40:1a94db9139ea 772 {
AzureIoTClient 40:1a94db9139ea 773 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 16:deba40344375 774
AzureIoTClient 40:1a94db9139ea 775 /*Codes_SRS_IOTHUBCLIENT_LL_02_039: [ "messageTimeout" - once IoTHubClient_LL_SendEventAsync is called the message shall timeout after value miliseconds. Value is a pointer to a uint64. ]*/
AzureIoTClient 40:1a94db9139ea 776 if (strcmp(optionName, "messageTimeout") == 0)
AzureIoTClient 40:1a94db9139ea 777 {
AzureIoTClient 40:1a94db9139ea 778 /*this is an option handled by IoTHubClient_LL*/
AzureIoTClient 40:1a94db9139ea 779 /*Codes_SRS_IOTHUBCLIENT_LL_02_043: [ Calling IoTHubClient_LL_SetOption with value set to "0" shall disable the timeout mechanism for all new messages. ]*/
AzureIoTClient 40:1a94db9139ea 780 handleData->currentMessageTimeout = *(const uint64_t*)value;
AzureIoTClient 40:1a94db9139ea 781 result = IOTHUB_CLIENT_OK;
AzureIoTClient 40:1a94db9139ea 782 }
AzureIoTClient 40:1a94db9139ea 783 else
AzureIoTClient 40:1a94db9139ea 784 {
AzureIoTClient 40:1a94db9139ea 785 /*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 40:1a94db9139ea 786 result = handleData->IoTHubTransport_SetOption(handleData->transportHandle, optionName, value);
AzureIoTClient 16:deba40344375 787
AzureIoTClient 40:1a94db9139ea 788 if (result != IOTHUB_CLIENT_OK)
AzureIoTClient 40:1a94db9139ea 789 {
AzureIoTClient 40:1a94db9139ea 790 LogError("underlying transport failed, returned = %s", ENUM_TO_STRING(IOTHUB_CLIENT_RESULT, result));
AzureIoTClient 40:1a94db9139ea 791 }
AzureIoTClient 40:1a94db9139ea 792 }
AzureIoTClient 40:1a94db9139ea 793 }
AzureIoTClient 40:1a94db9139ea 794 return result;
AzureIoTClient 16:deba40344375 795 }