Microsoft Azure IoTHub client libraries

Dependents:   sht15_remote_monitoring RobotArmDemo iothub_client_sample_amqp f767zi_mqtt ... more

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

Committer:
AzureIoTClient
Date:
Thu Oct 20 17:07:32 2016 -0700
Revision:
52:1cc3c6d07cad
Parent:
47:aaa262b5f898
Child:
53:1e5a1ca1f274
1.0.10

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 45:54c11b1b1407 12 #include "azure_c_shared_utility/xlogging.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"
AzureIoTClient 43:038d8511e817 19
AzureIoTClient 44:33dd78697616 20 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 42:448eecc3676e 21 #include "iothub_client_ll_uploadtoblob.h"
AzureIoTClient 43:038d8511e817 22 #endif
Azure.IoT Build 36:67300d5a4c1f 23
Azure.IoT Build 45:54c11b1b1407 24 #define LOG_ERROR_RESULT LogError("result = %s", ENUM_TO_STRING(IOTHUB_CLIENT_RESULT, result));
AzureIoTClient 16:deba40344375 25 #define INDEFINITE_TIME ((time_t)(-1))
AzureIoTClient 16:deba40344375 26
AzureIoTClient 16:deba40344375 27 DEFINE_ENUM_STRINGS(IOTHUB_CLIENT_RESULT, IOTHUB_CLIENT_RESULT_VALUES);
Azure.IoT Build 45:54c11b1b1407 28 DEFINE_ENUM_STRINGS(IOTHUB_CLIENT_CONFIRMATION_RESULT, IOTHUB_CLIENT_CONFIRMATION_RESULT_VALUES);
AzureIoTClient 16:deba40344375 29
AzureIoTClient 16:deba40344375 30 typedef struct IOTHUB_CLIENT_LL_HANDLE_DATA_TAG
AzureIoTClient 16:deba40344375 31 {
AzureIoTClient 42:448eecc3676e 32 DLIST_ENTRY waitingToSend;
AzureIoTClient 42:448eecc3676e 33 TRANSPORT_LL_HANDLE transportHandle;
AzureIoTClient 42:448eecc3676e 34 bool isSharedTransport;
AzureIoTClient 42:448eecc3676e 35 IOTHUB_DEVICE_HANDLE deviceHandle;
AzureIoTClient 42:448eecc3676e 36 TRANSPORT_PROVIDER_FIELDS;
AzureIoTClient 42:448eecc3676e 37 IOTHUB_CLIENT_MESSAGE_CALLBACK_ASYNC messageCallback;
AzureIoTClient 42:448eecc3676e 38 void* messageUserContextCallback;
AzureIoTClient 42:448eecc3676e 39 time_t lastMessageReceiveTime;
AzureIoTClient 42:448eecc3676e 40 TICK_COUNTER_HANDLE tickCounter; /*shared tickcounter used to track message timeouts in waitingToSend list*/
AzureIoTClient 42:448eecc3676e 41 uint64_t currentMessageTimeout;
AzureIoTClient 52:1cc3c6d07cad 42 IOTHUB_CLIENT_RETRY_POLICY retryPolicy;
AzureIoTClient 52:1cc3c6d07cad 43 size_t retryTimeoutinSeconds;
AzureIoTClient 44:33dd78697616 44 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 42:448eecc3676e 45 IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE uploadToBlobHandle;
AzureIoTClient 43:038d8511e817 46 #endif
AzureIoTClient 42:448eecc3676e 47
AzureIoTClient 16:deba40344375 48 }IOTHUB_CLIENT_LL_HANDLE_DATA;
AzureIoTClient 16:deba40344375 49
AzureIoTClient 16:deba40344375 50 static const char HOSTNAME_TOKEN[] = "HostName";
AzureIoTClient 16:deba40344375 51 static const char DEVICEID_TOKEN[] = "DeviceId";
Azure.IoT Build 45:54c11b1b1407 52 static const char X509_TOKEN[] = "x509";
Azure.IoT Build 45:54c11b1b1407 53 static const char X509_TOKEN_ONLY_ACCEPTABLE_VALUE[] = "true";
AzureIoTClient 16:deba40344375 54 static const char DEVICEKEY_TOKEN[] = "SharedAccessKey";
AzureIoTClient 40:1a94db9139ea 55 static const char DEVICESAS_TOKEN[] = "SharedAccessSignature";
AzureIoTClient 16:deba40344375 56 static const char PROTOCOL_GATEWAY_HOST[] = "GatewayHostName";
AzureIoTClient 16:deba40344375 57
AzureIoTClient 16:deba40344375 58 IOTHUB_CLIENT_LL_HANDLE IoTHubClient_LL_CreateFromConnectionString(const char* connectionString, IOTHUB_CLIENT_TRANSPORT_PROVIDER protocol)
AzureIoTClient 16:deba40344375 59 {
AzureIoTClient 42:448eecc3676e 60 IOTHUB_CLIENT_LL_HANDLE result = NULL;
AzureIoTClient 16:deba40344375 61
AzureIoTClient 42:448eecc3676e 62 /*Codes_SRS_IOTHUBCLIENT_LL_05_001: [IoTHubClient_LL_CreateFromConnectionString shall obtain the version string by a call to IoTHubClient_GetVersionString.]*/
AzureIoTClient 42:448eecc3676e 63 /*Codes_SRS_IOTHUBCLIENT_LL_05_002: [IoTHubClient_LL_CreateFromConnectionString shall print the version string to standard output.]*/
AzureIoTClient 42:448eecc3676e 64 LogInfo("IoT Hub SDK for C, version %s", IoTHubClient_GetVersionString());
AzureIoTClient 16:deba40344375 65
AzureIoTClient 42:448eecc3676e 66 /* Codes_SRS_IOTHUBCLIENT_LL_12_003: [IoTHubClient_LL_CreateFromConnectionString shall verify the input parameter and if it is NULL then return NULL] */
AzureIoTClient 42:448eecc3676e 67 if (connectionString == NULL)
AzureIoTClient 42:448eecc3676e 68 {
AzureIoTClient 42:448eecc3676e 69 LogError("Input parameter is NULL: connectionString");
AzureIoTClient 42:448eecc3676e 70 }
AzureIoTClient 42:448eecc3676e 71 else if (protocol == NULL)
AzureIoTClient 42:448eecc3676e 72 {
AzureIoTClient 42:448eecc3676e 73 LogError("Input parameter is NULL: protocol");
AzureIoTClient 42:448eecc3676e 74 }
AzureIoTClient 42:448eecc3676e 75 else
AzureIoTClient 42:448eecc3676e 76 {
AzureIoTClient 42:448eecc3676e 77 /* Codes_SRS_IOTHUBCLIENT_LL_12_004: [IoTHubClient_LL_CreateFromConnectionString shall allocate IOTHUB_CLIENT_CONFIG structure] */
AzureIoTClient 47:aaa262b5f898 78 IOTHUB_CLIENT_CONFIG* config = (IOTHUB_CLIENT_CONFIG*) malloc(sizeof(IOTHUB_CLIENT_CONFIG));
AzureIoTClient 42:448eecc3676e 79 if (config == NULL)
AzureIoTClient 42:448eecc3676e 80 {
AzureIoTClient 42:448eecc3676e 81 /* Codes_SRS_IOTHUBCLIENT_LL_12_012: [If the allocation failed IoTHubClient_LL_CreateFromConnectionString returns NULL] */
AzureIoTClient 42:448eecc3676e 82 LogError("Malloc failed");
AzureIoTClient 42:448eecc3676e 83 return NULL;
AzureIoTClient 42:448eecc3676e 84 }
AzureIoTClient 42:448eecc3676e 85 else
AzureIoTClient 42:448eecc3676e 86 {
AzureIoTClient 42:448eecc3676e 87 STRING_TOKENIZER_HANDLE tokenizer1 = NULL;
AzureIoTClient 42:448eecc3676e 88 STRING_HANDLE connString = NULL;
AzureIoTClient 42:448eecc3676e 89 STRING_HANDLE tokenString = NULL;
AzureIoTClient 42:448eecc3676e 90 STRING_HANDLE valueString = NULL;
AzureIoTClient 42:448eecc3676e 91 STRING_HANDLE hostNameString = NULL;
AzureIoTClient 42:448eecc3676e 92 STRING_HANDLE hostSuffixString = NULL;
AzureIoTClient 42:448eecc3676e 93 STRING_HANDLE deviceIdString = NULL;
AzureIoTClient 42:448eecc3676e 94 STRING_HANDLE deviceKeyString = NULL;
AzureIoTClient 42:448eecc3676e 95 STRING_HANDLE deviceSasTokenString = NULL;
AzureIoTClient 42:448eecc3676e 96 STRING_HANDLE protocolGateway = NULL;
AzureIoTClient 16:deba40344375 97
AzureIoTClient 42:448eecc3676e 98 config->protocol = protocol;
AzureIoTClient 16:deba40344375 99
AzureIoTClient 42:448eecc3676e 100 config->iotHubName = NULL;
AzureIoTClient 42:448eecc3676e 101 config->iotHubSuffix = NULL;
AzureIoTClient 42:448eecc3676e 102 config->deviceId = NULL;
AzureIoTClient 42:448eecc3676e 103 config->deviceKey = NULL;
AzureIoTClient 42:448eecc3676e 104 config->deviceSasToken = NULL;
AzureIoTClient 40:1a94db9139ea 105
AzureIoTClient 42:448eecc3676e 106 /* Codes_SRS_IOTHUBCLIENT_LL_04_002: [If it does not, it shall pass the protocolGatewayHostName NULL.] */
AzureIoTClient 42:448eecc3676e 107 config->protocolGatewayHostName = NULL;
AzureIoTClient 16:deba40344375 108
AzureIoTClient 42:448eecc3676e 109 if ((connString = STRING_construct(connectionString)) == NULL)
AzureIoTClient 42:448eecc3676e 110 {
AzureIoTClient 42:448eecc3676e 111 LogError("Error constructing connectiong String");
AzureIoTClient 42:448eecc3676e 112 }
AzureIoTClient 42:448eecc3676e 113 else if ((tokenizer1 = STRING_TOKENIZER_create(connString)) == NULL)
AzureIoTClient 42:448eecc3676e 114 {
AzureIoTClient 42:448eecc3676e 115 LogError("Error creating Tokenizer");
AzureIoTClient 42:448eecc3676e 116 }
AzureIoTClient 42:448eecc3676e 117 else if ((tokenString = STRING_new()) == NULL)
AzureIoTClient 42:448eecc3676e 118 {
AzureIoTClient 42:448eecc3676e 119 LogError("Error creating Token String");
AzureIoTClient 42:448eecc3676e 120 }
AzureIoTClient 42:448eecc3676e 121 else if ((valueString = STRING_new()) == NULL)
AzureIoTClient 42:448eecc3676e 122 {
AzureIoTClient 42:448eecc3676e 123 LogError("Error creating Value String");
AzureIoTClient 42:448eecc3676e 124 }
AzureIoTClient 42:448eecc3676e 125 else if ((hostNameString = STRING_new()) == NULL)
AzureIoTClient 42:448eecc3676e 126 {
AzureIoTClient 42:448eecc3676e 127 LogError("Error creating HostName String");
AzureIoTClient 42:448eecc3676e 128 }
AzureIoTClient 42:448eecc3676e 129 else if ((hostSuffixString = STRING_new()) == NULL)
AzureIoTClient 42:448eecc3676e 130 {
AzureIoTClient 42:448eecc3676e 131 LogError("Error creating HostSuffix String");
AzureIoTClient 42:448eecc3676e 132 }
AzureIoTClient 42:448eecc3676e 133 /* 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..."] */
Azure.IoT Build 45:54c11b1b1407 134 /* 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, SharedAccessSignature or x509] */
AzureIoTClient 42:448eecc3676e 135 else
AzureIoTClient 42:448eecc3676e 136 {
Azure.IoT Build 45:54c11b1b1407 137 int isx509found = 0;
AzureIoTClient 42:448eecc3676e 138 while ((STRING_TOKENIZER_get_next_token(tokenizer1, tokenString, "=") == 0))
AzureIoTClient 42:448eecc3676e 139 {
AzureIoTClient 42:448eecc3676e 140 if (STRING_TOKENIZER_get_next_token(tokenizer1, valueString, ";") != 0)
AzureIoTClient 42:448eecc3676e 141 {
AzureIoTClient 42:448eecc3676e 142 LogError("Tokenizer error");
AzureIoTClient 42:448eecc3676e 143 break;
AzureIoTClient 42:448eecc3676e 144 }
AzureIoTClient 42:448eecc3676e 145 else
AzureIoTClient 42:448eecc3676e 146 {
AzureIoTClient 42:448eecc3676e 147 if (tokenString != NULL)
AzureIoTClient 42:448eecc3676e 148 {
AzureIoTClient 42:448eecc3676e 149 /* 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 42:448eecc3676e 150 const char* s_token = STRING_c_str(tokenString);
AzureIoTClient 42:448eecc3676e 151 if (strcmp(s_token, HOSTNAME_TOKEN) == 0)
AzureIoTClient 42:448eecc3676e 152 {
AzureIoTClient 42:448eecc3676e 153 /* 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 42:448eecc3676e 154 STRING_TOKENIZER_HANDLE tokenizer2 = NULL;
AzureIoTClient 42:448eecc3676e 155 if ((tokenizer2 = STRING_TOKENIZER_create(valueString)) == NULL)
AzureIoTClient 42:448eecc3676e 156 {
AzureIoTClient 42:448eecc3676e 157 LogError("Error creating Tokenizer");
AzureIoTClient 42:448eecc3676e 158 break;
AzureIoTClient 42:448eecc3676e 159 }
AzureIoTClient 42:448eecc3676e 160 else
AzureIoTClient 42:448eecc3676e 161 {
AzureIoTClient 42:448eecc3676e 162 /* Codes_SRS_IOTHUBCLIENT_LL_12_015: [If the string split failed, IoTHubClient_LL_CreateFromConnectionString returns NULL ] */
AzureIoTClient 42:448eecc3676e 163 if (STRING_TOKENIZER_get_next_token(tokenizer2, hostNameString, ".") != 0)
AzureIoTClient 42:448eecc3676e 164 {
AzureIoTClient 42:448eecc3676e 165 LogError("Tokenizer error");
AzureIoTClient 42:448eecc3676e 166 STRING_TOKENIZER_destroy(tokenizer2);
AzureIoTClient 42:448eecc3676e 167 break;
AzureIoTClient 42:448eecc3676e 168 }
AzureIoTClient 42:448eecc3676e 169 else
AzureIoTClient 42:448eecc3676e 170 {
AzureIoTClient 42:448eecc3676e 171 config->iotHubName = STRING_c_str(hostNameString);
AzureIoTClient 42:448eecc3676e 172 if (STRING_TOKENIZER_get_next_token(tokenizer2, hostSuffixString, ";") != 0)
AzureIoTClient 42:448eecc3676e 173 {
AzureIoTClient 42:448eecc3676e 174 LogError("Tokenizer error");
AzureIoTClient 42:448eecc3676e 175 STRING_TOKENIZER_destroy(tokenizer2);
AzureIoTClient 42:448eecc3676e 176 break;
AzureIoTClient 42:448eecc3676e 177 }
AzureIoTClient 42:448eecc3676e 178 else
AzureIoTClient 42:448eecc3676e 179 {
AzureIoTClient 42:448eecc3676e 180 config->iotHubSuffix = STRING_c_str(hostSuffixString);
AzureIoTClient 42:448eecc3676e 181 }
AzureIoTClient 42:448eecc3676e 182 }
AzureIoTClient 42:448eecc3676e 183 STRING_TOKENIZER_destroy(tokenizer2);
AzureIoTClient 42:448eecc3676e 184 }
AzureIoTClient 42:448eecc3676e 185 }
AzureIoTClient 42:448eecc3676e 186 else if (strcmp(s_token, DEVICEID_TOKEN) == 0)
AzureIoTClient 42:448eecc3676e 187 {
AzureIoTClient 42:448eecc3676e 188 deviceIdString = STRING_clone(valueString);
AzureIoTClient 42:448eecc3676e 189 if (deviceIdString != NULL)
AzureIoTClient 42:448eecc3676e 190 {
AzureIoTClient 42:448eecc3676e 191 config->deviceId = STRING_c_str(deviceIdString);
AzureIoTClient 42:448eecc3676e 192 }
AzureIoTClient 42:448eecc3676e 193 }
AzureIoTClient 42:448eecc3676e 194 else if (strcmp(s_token, DEVICEKEY_TOKEN) == 0)
AzureIoTClient 42:448eecc3676e 195 {
AzureIoTClient 42:448eecc3676e 196 deviceKeyString = STRING_clone(valueString);
AzureIoTClient 42:448eecc3676e 197 if (deviceKeyString != NULL)
AzureIoTClient 42:448eecc3676e 198 {
AzureIoTClient 42:448eecc3676e 199 config->deviceKey = STRING_c_str(deviceKeyString);
AzureIoTClient 42:448eecc3676e 200 }
AzureIoTClient 42:448eecc3676e 201 }
AzureIoTClient 42:448eecc3676e 202 else if (strcmp(s_token, DEVICESAS_TOKEN) == 0)
AzureIoTClient 42:448eecc3676e 203 {
AzureIoTClient 42:448eecc3676e 204 deviceSasTokenString = STRING_clone(valueString);
AzureIoTClient 42:448eecc3676e 205 if (deviceSasTokenString != NULL)
AzureIoTClient 42:448eecc3676e 206 {
AzureIoTClient 42:448eecc3676e 207 config->deviceSasToken = STRING_c_str(deviceSasTokenString);
AzureIoTClient 42:448eecc3676e 208 }
AzureIoTClient 42:448eecc3676e 209 }
Azure.IoT Build 45:54c11b1b1407 210 else if (strcmp(s_token, X509_TOKEN) == 0)
Azure.IoT Build 45:54c11b1b1407 211 {
Azure.IoT Build 45:54c11b1b1407 212 if (strcmp(STRING_c_str(valueString), X509_TOKEN_ONLY_ACCEPTABLE_VALUE) != 0)
Azure.IoT Build 45:54c11b1b1407 213 {
Azure.IoT Build 45:54c11b1b1407 214 LogError("x509 option has wrong value, the only acceptable one is \"true\"");
Azure.IoT Build 45:54c11b1b1407 215 }
Azure.IoT Build 45:54c11b1b1407 216 else
Azure.IoT Build 45:54c11b1b1407 217 {
Azure.IoT Build 45:54c11b1b1407 218 isx509found = 1;
Azure.IoT Build 45:54c11b1b1407 219 }
Azure.IoT Build 45:54c11b1b1407 220 }
AzureIoTClient 42:448eecc3676e 221 /* 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 42:448eecc3676e 222 else if (strcmp(s_token, PROTOCOL_GATEWAY_HOST) == 0)
AzureIoTClient 42:448eecc3676e 223 {
AzureIoTClient 42:448eecc3676e 224 protocolGateway = STRING_clone(valueString);
AzureIoTClient 42:448eecc3676e 225 if (protocolGateway != NULL)
AzureIoTClient 42:448eecc3676e 226 {
AzureIoTClient 42:448eecc3676e 227 config->protocolGatewayHostName = STRING_c_str(protocolGateway);
AzureIoTClient 42:448eecc3676e 228 }
AzureIoTClient 42:448eecc3676e 229 }
AzureIoTClient 42:448eecc3676e 230 }
AzureIoTClient 42:448eecc3676e 231 }
AzureIoTClient 42:448eecc3676e 232 }
AzureIoTClient 42:448eecc3676e 233 /* parsing is done - check the result */
AzureIoTClient 42:448eecc3676e 234 if (config->iotHubName == NULL)
AzureIoTClient 42:448eecc3676e 235 {
AzureIoTClient 42:448eecc3676e 236 LogError("iotHubName is not found");
AzureIoTClient 42:448eecc3676e 237 }
AzureIoTClient 42:448eecc3676e 238 else if (config->iotHubSuffix == NULL)
AzureIoTClient 42:448eecc3676e 239 {
AzureIoTClient 42:448eecc3676e 240 LogError("iotHubSuffix is not found");
AzureIoTClient 42:448eecc3676e 241 }
AzureIoTClient 42:448eecc3676e 242 else if (config->deviceId == NULL)
AzureIoTClient 42:448eecc3676e 243 {
AzureIoTClient 42:448eecc3676e 244 LogError("deviceId is not found");
AzureIoTClient 42:448eecc3676e 245 }
Azure.IoT Build 45:54c11b1b1407 246 else if (!(
Azure.IoT Build 45:54c11b1b1407 247 ((!isx509found) && (config->deviceSasToken == NULL) ^ (config->deviceKey == NULL)) ||
Azure.IoT Build 45:54c11b1b1407 248 ((isx509found) && (config->deviceSasToken == NULL) && (config->deviceKey == NULL))
Azure.IoT Build 45:54c11b1b1407 249 ))
AzureIoTClient 42:448eecc3676e 250 {
Azure.IoT Build 45:54c11b1b1407 251 LogError("invalid combination of x509, deviceSasToken and deviceKey");
AzureIoTClient 42:448eecc3676e 252 }
AzureIoTClient 42:448eecc3676e 253 else
AzureIoTClient 42:448eecc3676e 254 {
AzureIoTClient 42:448eecc3676e 255 /* 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 42:448eecc3676e 256
AzureIoTClient 42:448eecc3676e 257 result = IoTHubClient_LL_Create(config);
AzureIoTClient 42:448eecc3676e 258 if (result == NULL)
AzureIoTClient 42:448eecc3676e 259 {
AzureIoTClient 42:448eecc3676e 260 LogError("IoTHubClient_LL_Create failed");
AzureIoTClient 42:448eecc3676e 261 }
AzureIoTClient 42:448eecc3676e 262 else
AzureIoTClient 42:448eecc3676e 263 {
AzureIoTClient 42:448eecc3676e 264 /*return as is*/
AzureIoTClient 42:448eecc3676e 265 }
AzureIoTClient 42:448eecc3676e 266 }
AzureIoTClient 42:448eecc3676e 267 }
AzureIoTClient 42:448eecc3676e 268 if (deviceSasTokenString != NULL)
AzureIoTClient 42:448eecc3676e 269 STRING_delete(deviceSasTokenString);
AzureIoTClient 42:448eecc3676e 270 if (deviceKeyString != NULL)
AzureIoTClient 42:448eecc3676e 271 STRING_delete(deviceKeyString);
AzureIoTClient 42:448eecc3676e 272 if (deviceIdString != NULL)
AzureIoTClient 42:448eecc3676e 273 STRING_delete(deviceIdString);
AzureIoTClient 42:448eecc3676e 274 if (hostSuffixString != NULL)
AzureIoTClient 42:448eecc3676e 275 STRING_delete(hostSuffixString);
AzureIoTClient 42:448eecc3676e 276 if (hostNameString != NULL)
AzureIoTClient 42:448eecc3676e 277 STRING_delete(hostNameString);
AzureIoTClient 42:448eecc3676e 278 if (valueString != NULL)
AzureIoTClient 42:448eecc3676e 279 STRING_delete(valueString);
AzureIoTClient 42:448eecc3676e 280 if (tokenString != NULL)
AzureIoTClient 42:448eecc3676e 281 STRING_delete(tokenString);
AzureIoTClient 42:448eecc3676e 282 if (connString != NULL)
AzureIoTClient 42:448eecc3676e 283 STRING_delete(connString);
AzureIoTClient 42:448eecc3676e 284 if (protocolGateway != NULL)
AzureIoTClient 42:448eecc3676e 285 STRING_delete(protocolGateway);
AzureIoTClient 16:deba40344375 286
AzureIoTClient 42:448eecc3676e 287 if (tokenizer1 != NULL)
AzureIoTClient 42:448eecc3676e 288 STRING_TOKENIZER_destroy(tokenizer1);
AzureIoTClient 16:deba40344375 289
AzureIoTClient 42:448eecc3676e 290 free(config);
AzureIoTClient 42:448eecc3676e 291 }
AzureIoTClient 42:448eecc3676e 292 }
AzureIoTClient 42:448eecc3676e 293 return result;
AzureIoTClient 16:deba40344375 294 }
AzureIoTClient 16:deba40344375 295
Azure.IoT Build 36:67300d5a4c1f 296 static void setTransportProtocol(IOTHUB_CLIENT_LL_HANDLE_DATA* handleData, TRANSPORT_PROVIDER* protocol)
Azure.IoT Build 36:67300d5a4c1f 297 {
AzureIoTClient 43:038d8511e817 298 handleData->IoTHubTransport_GetHostname = protocol->IoTHubTransport_GetHostname;
AzureIoTClient 42:448eecc3676e 299 handleData->IoTHubTransport_SetOption = protocol->IoTHubTransport_SetOption;
AzureIoTClient 42:448eecc3676e 300 handleData->IoTHubTransport_Create = protocol->IoTHubTransport_Create;
AzureIoTClient 42:448eecc3676e 301 handleData->IoTHubTransport_Destroy = protocol->IoTHubTransport_Destroy;
AzureIoTClient 42:448eecc3676e 302 handleData->IoTHubTransport_Register = protocol->IoTHubTransport_Register;
AzureIoTClient 42:448eecc3676e 303 handleData->IoTHubTransport_Unregister = protocol->IoTHubTransport_Unregister;
AzureIoTClient 42:448eecc3676e 304 handleData->IoTHubTransport_Subscribe = protocol->IoTHubTransport_Subscribe;
AzureIoTClient 42:448eecc3676e 305 handleData->IoTHubTransport_Unsubscribe = protocol->IoTHubTransport_Unsubscribe;
AzureIoTClient 42:448eecc3676e 306 handleData->IoTHubTransport_DoWork = protocol->IoTHubTransport_DoWork;
AzureIoTClient 42:448eecc3676e 307 handleData->IoTHubTransport_GetSendStatus = protocol->IoTHubTransport_GetSendStatus;
Azure.IoT Build 36:67300d5a4c1f 308
Azure.IoT Build 36:67300d5a4c1f 309 }
AzureIoTClient 16:deba40344375 310
AzureIoTClient 16:deba40344375 311 IOTHUB_CLIENT_LL_HANDLE IoTHubClient_LL_Create(const IOTHUB_CLIENT_CONFIG* config)
AzureIoTClient 16:deba40344375 312 {
AzureIoTClient 42:448eecc3676e 313 IOTHUB_CLIENT_LL_HANDLE result;
AzureIoTClient 42:448eecc3676e 314 /*Codes_SRS_IOTHUBCLIENT_LL_02_001: [IoTHubClient_LL_Create shall return NULL if config parameter is NULL or protocol field is NULL.]*/
AzureIoTClient 42:448eecc3676e 315 if(
AzureIoTClient 42:448eecc3676e 316 (config == NULL) ||
AzureIoTClient 42:448eecc3676e 317 (config->protocol == NULL)
AzureIoTClient 42:448eecc3676e 318 )
AzureIoTClient 42:448eecc3676e 319 {
AzureIoTClient 42:448eecc3676e 320 result = NULL;
AzureIoTClient 42:448eecc3676e 321 LogError("invalid configuration (NULL detected)");
AzureIoTClient 42:448eecc3676e 322 }
AzureIoTClient 42:448eecc3676e 323 else
AzureIoTClient 42:448eecc3676e 324 {
AzureIoTClient 42:448eecc3676e 325 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)malloc(sizeof(IOTHUB_CLIENT_LL_HANDLE_DATA));
AzureIoTClient 42:448eecc3676e 326 if (handleData == NULL)
AzureIoTClient 42:448eecc3676e 327 {
AzureIoTClient 42:448eecc3676e 328 LogError("malloc failed");
AzureIoTClient 42:448eecc3676e 329 result = NULL;
AzureIoTClient 42:448eecc3676e 330 }
AzureIoTClient 42:448eecc3676e 331 else
AzureIoTClient 42:448eecc3676e 332 {
AzureIoTClient 44:33dd78697616 333 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 42:448eecc3676e 334 /*Codes_SRS_IOTHUBCLIENT_LL_02_094: [ IoTHubClient_LL_Create shall create a IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE from IOTHUB_CLIENT_CONFIG. ]*/
AzureIoTClient 42:448eecc3676e 335 /*Codes_SRS_IOTHUBCLIENT_LL_02_092: [ IoTHubClient_LL_CreateFromConnectionString shall create a IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE from IOTHUB_CLIENT_CONFIG. ]*/
AzureIoTClient 42:448eecc3676e 336 handleData->uploadToBlobHandle = IoTHubClient_LL_UploadToBlob_Create(config);
AzureIoTClient 42:448eecc3676e 337 if (handleData->uploadToBlobHandle == NULL)
AzureIoTClient 42:448eecc3676e 338 {
AzureIoTClient 42:448eecc3676e 339 /*Codes_SRS_IOTHUBCLIENT_LL_02_093: [ If creating the IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE fails then IoTHubClient_LL_CreateFromConnectionString shall fail and return NULL. ]*/
AzureIoTClient 42:448eecc3676e 340 /*Codes_SRS_IOTHUBCLIENT_LL_02_095: [ If creating the IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE fails then IoTHubClient_LL_Create shall fail and return NULL. ]*/
AzureIoTClient 42:448eecc3676e 341 LogError("unable to IoTHubClient_LL_UploadToBlob_Create");
AzureIoTClient 42:448eecc3676e 342 free(handleData);
AzureIoTClient 42:448eecc3676e 343 result = NULL;
AzureIoTClient 42:448eecc3676e 344 }
AzureIoTClient 42:448eecc3676e 345 else
AzureIoTClient 43:038d8511e817 346 #endif
AzureIoTClient 42:448eecc3676e 347 {
AzureIoTClient 42:448eecc3676e 348 /*Codes_SRS_IOTHUBCLIENT_LL_02_045: [ Otherwise IoTHubClient_LL_Create shall create a new TICK_COUNTER_HANDLE ]*/
AzureIoTClient 42:448eecc3676e 349 if ((handleData->tickCounter = tickcounter_create()) == NULL)
AzureIoTClient 42:448eecc3676e 350 {
AzureIoTClient 44:33dd78697616 351 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 42:448eecc3676e 352 /*Codes_SRS_IOTHUBCLIENT_LL_02_046: [ If creating the TICK_COUNTER_HANDLE fails then IoTHubClient_LL_Create shall fail and return NULL. ]*/
AzureIoTClient 42:448eecc3676e 353 IoTHubClient_LL_UploadToBlob_Destroy(handleData->uploadToBlobHandle);
AzureIoTClient 43:038d8511e817 354 #endif
AzureIoTClient 42:448eecc3676e 355 LogError("unable to get a tickcounter");
AzureIoTClient 42:448eecc3676e 356 free(handleData);
AzureIoTClient 42:448eecc3676e 357 result = NULL;
AzureIoTClient 42:448eecc3676e 358 }
AzureIoTClient 42:448eecc3676e 359 else
AzureIoTClient 42:448eecc3676e 360 {
AzureIoTClient 42:448eecc3676e 361 /*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 42:448eecc3676e 362 IOTHUBTRANSPORT_CONFIG lowerLayerConfig;
AzureIoTClient 42:448eecc3676e 363 DList_InitializeListHead(&(handleData->waitingToSend));
AzureIoTClient 42:448eecc3676e 364 setTransportProtocol(handleData, (TRANSPORT_PROVIDER*)config->protocol());
AzureIoTClient 42:448eecc3676e 365 handleData->messageCallback = NULL;
AzureIoTClient 42:448eecc3676e 366 handleData->messageUserContextCallback = NULL;
AzureIoTClient 42:448eecc3676e 367 handleData->lastMessageReceiveTime = INDEFINITE_TIME;
AzureIoTClient 42:448eecc3676e 368 /*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 42:448eecc3676e 369 lowerLayerConfig.upperConfig = config;
AzureIoTClient 42:448eecc3676e 370 lowerLayerConfig.waitingToSend = &(handleData->waitingToSend);
AzureIoTClient 42:448eecc3676e 371 /*Codes_SRS_IOTHUBCLIENT_LL_02_007: [If the underlaying layer _Create function fails them IoTHubClient_LL_Create shall fail and return NULL.] */
AzureIoTClient 42:448eecc3676e 372 if ((handleData->transportHandle = handleData->IoTHubTransport_Create(&lowerLayerConfig)) == NULL)
AzureIoTClient 42:448eecc3676e 373 {
AzureIoTClient 42:448eecc3676e 374 LogError("underlying transport failed");
AzureIoTClient 44:33dd78697616 375 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 42:448eecc3676e 376 IoTHubClient_LL_UploadToBlob_Destroy(handleData->uploadToBlobHandle);
AzureIoTClient 43:038d8511e817 377 #endif
AzureIoTClient 42:448eecc3676e 378 tickcounter_destroy(handleData->tickCounter);
AzureIoTClient 42:448eecc3676e 379 free(handleData);
AzureIoTClient 42:448eecc3676e 380 result = NULL;
AzureIoTClient 42:448eecc3676e 381 }
AzureIoTClient 42:448eecc3676e 382 else
AzureIoTClient 42:448eecc3676e 383 {
AzureIoTClient 42:448eecc3676e 384 IOTHUB_DEVICE_CONFIG deviceConfig;
AzureIoTClient 40:1a94db9139ea 385
AzureIoTClient 42:448eecc3676e 386 deviceConfig.deviceId = config->deviceId;
AzureIoTClient 42:448eecc3676e 387 deviceConfig.deviceKey = config->deviceKey;
AzureIoTClient 42:448eecc3676e 388 deviceConfig.deviceSasToken = config->deviceSasToken;
AzureIoTClient 40:1a94db9139ea 389
AzureIoTClient 42:448eecc3676e 390 /*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 42:448eecc3676e 391 if ((handleData->deviceHandle = handleData->IoTHubTransport_Register(handleData->transportHandle, &deviceConfig, handleData, &(handleData->waitingToSend))) == NULL)
AzureIoTClient 42:448eecc3676e 392 {
AzureIoTClient 42:448eecc3676e 393 /*Codes_SRS_IOTHUBCLIENT_LL_17_009: [If the _Register function fails, this function shall fail and return NULL.]*/
AzureIoTClient 42:448eecc3676e 394 LogError("Registering device in transport failed");
AzureIoTClient 42:448eecc3676e 395 handleData->IoTHubTransport_Destroy(handleData->transportHandle);
AzureIoTClient 44:33dd78697616 396 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 42:448eecc3676e 397 IoTHubClient_LL_UploadToBlob_Destroy(handleData->uploadToBlobHandle);
AzureIoTClient 43:038d8511e817 398 #endif
AzureIoTClient 42:448eecc3676e 399 tickcounter_destroy(handleData->tickCounter);
AzureIoTClient 42:448eecc3676e 400 free(handleData);
AzureIoTClient 42:448eecc3676e 401 result = NULL;
AzureIoTClient 42:448eecc3676e 402 }
AzureIoTClient 42:448eecc3676e 403 else
AzureIoTClient 42:448eecc3676e 404 {
AzureIoTClient 42:448eecc3676e 405 /*Codes_SRS_IOTHUBCLIENT_LL_02_008: [Otherwise, IoTHubClient_LL_Create shall succeed and return a non-NULL handle.] */
AzureIoTClient 42:448eecc3676e 406 handleData->isSharedTransport = false;
AzureIoTClient 42:448eecc3676e 407 /*Codes_SRS_IOTHUBCLIENT_LL_02_042: [ By default, messages shall not timeout. ]*/
AzureIoTClient 42:448eecc3676e 408 handleData->currentMessageTimeout = 0;
AzureIoTClient 42:448eecc3676e 409 result = handleData;
AzureIoTClient 42:448eecc3676e 410 }
AzureIoTClient 42:448eecc3676e 411 }
AzureIoTClient 42:448eecc3676e 412 }
AzureIoTClient 42:448eecc3676e 413 }
AzureIoTClient 42:448eecc3676e 414 }
AzureIoTClient 42:448eecc3676e 415 }
AzureIoTClient 16:deba40344375 416
AzureIoTClient 42:448eecc3676e 417 return result;
AzureIoTClient 16:deba40344375 418 }
AzureIoTClient 16:deba40344375 419
Azure.IoT Build 36:67300d5a4c1f 420 IOTHUB_CLIENT_LL_HANDLE IoTHubClient_LL_CreateWithTransport(const IOTHUB_CLIENT_DEVICE_CONFIG * config)
Azure.IoT Build 36:67300d5a4c1f 421 {
AzureIoTClient 42:448eecc3676e 422 IOTHUB_CLIENT_LL_HANDLE result;
AzureIoTClient 42:448eecc3676e 423 /*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.]*/
AzureIoTClient 42:448eecc3676e 424 if (
AzureIoTClient 42:448eecc3676e 425 (config == NULL) ||
AzureIoTClient 42:448eecc3676e 426 (config->protocol == NULL) ||
Azure.IoT Build 45:54c11b1b1407 427 (config->transportHandle == NULL) ||
Azure.IoT Build 45:54c11b1b1407 428 /*Codes_SRS_IOTHUBCLIENT_LL_02_098: [ IoTHubClient_LL_CreateWithTransport shall fail and return NULL if both config->deviceKey AND config->deviceSasToken are NULL. ]*/
Azure.IoT Build 45:54c11b1b1407 429 ((config->deviceKey == NULL) && (config->deviceSasToken == NULL))
AzureIoTClient 42:448eecc3676e 430 )
AzureIoTClient 42:448eecc3676e 431 {
AzureIoTClient 42:448eecc3676e 432 result = NULL;
AzureIoTClient 42:448eecc3676e 433 LogError("invalid configuration (NULL detected)");
AzureIoTClient 42:448eecc3676e 434 }
AzureIoTClient 42:448eecc3676e 435 else
AzureIoTClient 42:448eecc3676e 436 {
AzureIoTClient 42:448eecc3676e 437 /*Codes_SRS_IOTHUBCLIENT_LL_17_002: [IoTHubClient_LL_CreateWithTransport shall allocate data for the IOTHUB_CLIENT_LL_HANDLE.]*/
AzureIoTClient 42:448eecc3676e 438 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)malloc(sizeof(IOTHUB_CLIENT_LL_HANDLE_DATA));
AzureIoTClient 42:448eecc3676e 439 if (handleData == NULL)
AzureIoTClient 42:448eecc3676e 440 {
AzureIoTClient 42:448eecc3676e 441 /*Codes_SRS_IOTHUBCLIENT_LL_17_003: [If allocation fails, the function shall fail and return NULL.] */
AzureIoTClient 42:448eecc3676e 442 LogError("malloc failed");
AzureIoTClient 42:448eecc3676e 443 result = NULL;
AzureIoTClient 42:448eecc3676e 444 }
AzureIoTClient 42:448eecc3676e 445 else
AzureIoTClient 42:448eecc3676e 446 {
AzureIoTClient 43:038d8511e817 447 handleData->transportHandle = config->transportHandle;
AzureIoTClient 43:038d8511e817 448 setTransportProtocol(handleData, (TRANSPORT_PROVIDER*)config->protocol());
AzureIoTClient 43:038d8511e817 449
AzureIoTClient 44:33dd78697616 450 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 43:038d8511e817 451 const char* hostname = STRING_c_str(handleData->IoTHubTransport_GetHostname(handleData->transportHandle));
AzureIoTClient 43:038d8511e817 452 /*Codes_SRS_IOTHUBCLIENT_LL_02_096: [ IoTHubClient_LL_CreateWithTransport shall create the data structures needed to instantiate a IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE. ]*/
AzureIoTClient 43:038d8511e817 453 /*the first '.' says where the iothubname finishes*/
AzureIoTClient 43:038d8511e817 454 const char* whereIsDot = strchr(hostname, '.');
AzureIoTClient 43:038d8511e817 455 if (whereIsDot == NULL)
AzureIoTClient 42:448eecc3676e 456 {
AzureIoTClient 43:038d8511e817 457 /*Codes_SRS_IOTHUBCLIENT_LL_02_097: [ If creating the data structures fails or instantiating the IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE fails then IoTHubClient_LL_CreateWithTransport shall fail and return NULL. ]*/
AzureIoTClient 43:038d8511e817 458 LogError("unable to determine the IoTHub name");
AzureIoTClient 42:448eecc3676e 459 free(handleData);
AzureIoTClient 42:448eecc3676e 460 result = NULL;
AzureIoTClient 42:448eecc3676e 461 }
AzureIoTClient 42:448eecc3676e 462 else
AzureIoTClient 42:448eecc3676e 463 {
AzureIoTClient 43:038d8511e817 464 /*Codes_SRS_IOTHUBCLIENT_LL_02_096: [ IoTHubClient_LL_CreateWithTransport shall create the data structures needed to instantiate a IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE. ]*/
AzureIoTClient 47:aaa262b5f898 465 char* IoTHubName = (char*) malloc(whereIsDot - hostname + 1);
AzureIoTClient 43:038d8511e817 466 if (IoTHubName == NULL)
AzureIoTClient 42:448eecc3676e 467 {
AzureIoTClient 43:038d8511e817 468 /*Codes_SRS_IOTHUBCLIENT_LL_02_097: [ If creating the data structures fails or instantiating the IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE fails then IoTHubClient_LL_CreateWithTransport shall fail and return NULL. ]*/
AzureIoTClient 43:038d8511e817 469 LogError("unable to malloc");
AzureIoTClient 42:448eecc3676e 470 free(handleData);
AzureIoTClient 42:448eecc3676e 471 result = NULL;
AzureIoTClient 42:448eecc3676e 472 }
AzureIoTClient 42:448eecc3676e 473 else
AzureIoTClient 42:448eecc3676e 474 {
AzureIoTClient 43:038d8511e817 475 const char* IotHubSuffix = whereIsDot + 1;
AzureIoTClient 43:038d8511e817 476 memcpy(IoTHubName, hostname, whereIsDot - hostname);
AzureIoTClient 43:038d8511e817 477 IoTHubName[whereIsDot - hostname ] = '\0';
AzureIoTClient 43:038d8511e817 478
AzureIoTClient 43:038d8511e817 479 IOTHUB_CLIENT_CONFIG temp;
AzureIoTClient 43:038d8511e817 480 temp.deviceId = config->deviceId;
AzureIoTClient 43:038d8511e817 481 temp.deviceKey = config->deviceKey;
AzureIoTClient 43:038d8511e817 482 temp.deviceSasToken = config->deviceSasToken;
AzureIoTClient 43:038d8511e817 483 temp.iotHubName = IoTHubName;
AzureIoTClient 43:038d8511e817 484 temp.iotHubSuffix = IotHubSuffix;
AzureIoTClient 43:038d8511e817 485 temp.protocol = NULL; /*irrelevant to IoTHubClient_LL_UploadToBlob*/
AzureIoTClient 43:038d8511e817 486 temp.protocolGatewayHostName = NULL; /*irrelevant to IoTHubClient_LL_UploadToBlob*/
AzureIoTClient 43:038d8511e817 487
AzureIoTClient 43:038d8511e817 488 /*Codes_SRS_IOTHUBCLIENT_LL_02_097: [ If creating the data structures fails or instantiating the IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE fails then IoTHubClient_LL_CreateWithTransport shall fail and return NULL. ]*/
AzureIoTClient 43:038d8511e817 489 handleData->uploadToBlobHandle = IoTHubClient_LL_UploadToBlob_Create(&temp);
AzureIoTClient 43:038d8511e817 490 if (handleData->uploadToBlobHandle == NULL)
AzureIoTClient 43:038d8511e817 491 {
AzureIoTClient 43:038d8511e817 492 /*Codes_SRS_IOTHUBCLIENT_LL_02_096: [ IoTHubClient_LL_CreateWithTransport shall create the data structures needed to instantiate a IOTHUB_CLIENT_LL_UPLOADTOBLOB_HANDLE. ]*/
AzureIoTClient 43:038d8511e817 493 LogError("unable to IoTHubClient_LL_UploadToBlob_Create");
AzureIoTClient 43:038d8511e817 494 free(handleData);
AzureIoTClient 43:038d8511e817 495 result = NULL;
AzureIoTClient 43:038d8511e817 496 }
AzureIoTClient 43:038d8511e817 497 else
AzureIoTClient 43:038d8511e817 498 #endif
AzureIoTClient 43:038d8511e817 499 {
AzureIoTClient 43:038d8511e817 500 /*Codes_SRS_IOTHUBCLIENT_LL_02_047: [ IoTHubClient_LL_CreateWithTransport shall create a TICK_COUNTER_HANDLE. ]*/
AzureIoTClient 43:038d8511e817 501 if ((handleData->tickCounter = tickcounter_create()) == NULL)
AzureIoTClient 43:038d8511e817 502 {
AzureIoTClient 43:038d8511e817 503 /*Codes_SRS_IOTHUBCLIENT_LL_02_048: [ If creating the handle fails, then IoTHubClient_LL_CreateWithTransport shall fail and return NULL ]*/
AzureIoTClient 43:038d8511e817 504 LogError("unable to get a tickcounter");
AzureIoTClient 44:33dd78697616 505 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 43:038d8511e817 506 IoTHubClient_LL_UploadToBlob_Destroy(handleData->uploadToBlobHandle);
AzureIoTClient 43:038d8511e817 507 #endif
AzureIoTClient 43:038d8511e817 508 free(handleData);
AzureIoTClient 43:038d8511e817 509 result = NULL;
AzureIoTClient 43:038d8511e817 510 }
AzureIoTClient 43:038d8511e817 511 else
AzureIoTClient 43:038d8511e817 512 {
AzureIoTClient 43:038d8511e817 513 /*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 43:038d8511e817 514 DList_InitializeListHead(&(handleData->waitingToSend));
AzureIoTClient 43:038d8511e817 515
AzureIoTClient 43:038d8511e817 516 handleData->messageCallback = NULL;
AzureIoTClient 43:038d8511e817 517 handleData->messageUserContextCallback = NULL;
AzureIoTClient 43:038d8511e817 518 handleData->lastMessageReceiveTime = INDEFINITE_TIME;
AzureIoTClient 43:038d8511e817 519
AzureIoTClient 43:038d8511e817 520
AzureIoTClient 43:038d8511e817 521 IOTHUB_DEVICE_CONFIG deviceConfig;
AzureIoTClient 43:038d8511e817 522
AzureIoTClient 43:038d8511e817 523 deviceConfig.deviceId = config->deviceId;
AzureIoTClient 43:038d8511e817 524 deviceConfig.deviceKey = config->deviceKey;
AzureIoTClient 43:038d8511e817 525 deviceConfig.deviceSasToken = config->deviceSasToken;
AzureIoTClient 43:038d8511e817 526
AzureIoTClient 43:038d8511e817 527 /*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 43:038d8511e817 528 if ((handleData->deviceHandle = handleData->IoTHubTransport_Register(config->transportHandle, &deviceConfig, handleData, &(handleData->waitingToSend))) == NULL)
AzureIoTClient 43:038d8511e817 529 {
AzureIoTClient 43:038d8511e817 530 /*Codes_SRS_IOTHUBCLIENT_LL_17_007: [If the _Register function fails, this function shall fail and return NULL.]*/
AzureIoTClient 43:038d8511e817 531 LogError("Registering device in transport failed");
AzureIoTClient 44:33dd78697616 532 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 43:038d8511e817 533 IoTHubClient_LL_UploadToBlob_Destroy(handleData->uploadToBlobHandle);
AzureIoTClient 43:038d8511e817 534 #endif
AzureIoTClient 43:038d8511e817 535 tickcounter_destroy(handleData->tickCounter);
AzureIoTClient 43:038d8511e817 536 free(handleData);
AzureIoTClient 43:038d8511e817 537 result = NULL;
AzureIoTClient 43:038d8511e817 538 }
AzureIoTClient 43:038d8511e817 539 else
AzureIoTClient 43:038d8511e817 540 {
AzureIoTClient 43:038d8511e817 541 /*Codes_SRS_IOTHUBCLIENT_LL_17_005: [IoTHubClient_LL_CreateWithTransport shall save the transport handle and mark this transport as shared.]*/
AzureIoTClient 43:038d8511e817 542 handleData->isSharedTransport = true;
AzureIoTClient 43:038d8511e817 543 /*Codes_SRS_IOTHUBCLIENT_LL_02_042: [ By default, messages shall not timeout. ]*/
AzureIoTClient 43:038d8511e817 544 handleData->currentMessageTimeout = 0;
AzureIoTClient 43:038d8511e817 545 result = handleData;
AzureIoTClient 43:038d8511e817 546 }
AzureIoTClient 43:038d8511e817 547 }
AzureIoTClient 43:038d8511e817 548 }
AzureIoTClient 44:33dd78697616 549 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 43:038d8511e817 550 free(IoTHubName);
AzureIoTClient 42:448eecc3676e 551 }
AzureIoTClient 42:448eecc3676e 552 }
AzureIoTClient 43:038d8511e817 553 #endif
AzureIoTClient 42:448eecc3676e 554 }
AzureIoTClient 42:448eecc3676e 555 }
Azure.IoT Build 36:67300d5a4c1f 556
AzureIoTClient 42:448eecc3676e 557 return result;
Azure.IoT Build 36:67300d5a4c1f 558 }
Azure.IoT Build 36:67300d5a4c1f 559
AzureIoTClient 16:deba40344375 560 void IoTHubClient_LL_Destroy(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle)
AzureIoTClient 16:deba40344375 561 {
AzureIoTClient 42:448eecc3676e 562 /*Codes_SRS_IOTHUBCLIENT_LL_02_009: [IoTHubClient_LL_Destroy shall do nothing if parameter iotHubClientHandle is NULL.]*/
AzureIoTClient 42:448eecc3676e 563 if (iotHubClientHandle != NULL)
AzureIoTClient 42:448eecc3676e 564 {
AzureIoTClient 42:448eecc3676e 565 PDLIST_ENTRY unsend;
AzureIoTClient 42:448eecc3676e 566 /*Codes_SRS_IOTHUBCLIENT_LL_17_010: [IoTHubClient_LL_Destroy shall call the underlaying layer's _Unregister function] */
AzureIoTClient 42:448eecc3676e 567 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 42:448eecc3676e 568 handleData->IoTHubTransport_Unregister(handleData->deviceHandle);
AzureIoTClient 42:448eecc3676e 569 if (handleData->isSharedTransport == false)
AzureIoTClient 42:448eecc3676e 570 {
AzureIoTClient 42:448eecc3676e 571 /*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.] */
AzureIoTClient 42:448eecc3676e 572 handleData->IoTHubTransport_Destroy(handleData->transportHandle);
AzureIoTClient 42:448eecc3676e 573 }
AzureIoTClient 42:448eecc3676e 574 /*if any, remove the items currently not send*/
AzureIoTClient 42:448eecc3676e 575 while ((unsend = DList_RemoveHeadList(&(handleData->waitingToSend))) != &(handleData->waitingToSend))
AzureIoTClient 42:448eecc3676e 576 {
AzureIoTClient 42:448eecc3676e 577 IOTHUB_MESSAGE_LIST* temp = containingRecord(unsend, IOTHUB_MESSAGE_LIST, entry);
AzureIoTClient 42:448eecc3676e 578 /*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 42:448eecc3676e 579 if (temp->callback != NULL)
AzureIoTClient 42:448eecc3676e 580 {
AzureIoTClient 42:448eecc3676e 581 temp->callback(IOTHUB_CLIENT_CONFIRMATION_BECAUSE_DESTROY, temp->context);
AzureIoTClient 42:448eecc3676e 582 }
AzureIoTClient 42:448eecc3676e 583 IoTHubMessage_Destroy(temp->messageHandle);
AzureIoTClient 42:448eecc3676e 584 free(temp);
AzureIoTClient 42:448eecc3676e 585 }
AzureIoTClient 42:448eecc3676e 586 /*Codes_SRS_IOTHUBCLIENT_LL_17_011: [IoTHubClient_LL_Destroy shall free the resources allocated by IoTHubClient (if any).] */
AzureIoTClient 42:448eecc3676e 587 tickcounter_destroy(handleData->tickCounter);
AzureIoTClient 44:33dd78697616 588 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 42:448eecc3676e 589 IoTHubClient_LL_UploadToBlob_Destroy(handleData->uploadToBlobHandle);
AzureIoTClient 43:038d8511e817 590 #endif
AzureIoTClient 42:448eecc3676e 591 free(handleData);
AzureIoTClient 42:448eecc3676e 592 }
AzureIoTClient 16:deba40344375 593 }
AzureIoTClient 16:deba40344375 594
Azure.IoT Build 36:67300d5a4c1f 595 /*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 596 /*returns 0 on success, any other value is error*/
Azure.IoT Build 36:67300d5a4c1f 597 static int attach_ms_timesOutAfter(IOTHUB_CLIENT_LL_HANDLE_DATA* handleData, IOTHUB_MESSAGE_LIST *newEntry)
Azure.IoT Build 36:67300d5a4c1f 598 {
AzureIoTClient 42:448eecc3676e 599 int result;
AzureIoTClient 42:448eecc3676e 600 /*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 42:448eecc3676e 601 if (handleData->currentMessageTimeout == 0)
AzureIoTClient 42:448eecc3676e 602 {
AzureIoTClient 42:448eecc3676e 603 newEntry->ms_timesOutAfter = 0; /*do not timeout*/
AzureIoTClient 42:448eecc3676e 604 result = 0;
AzureIoTClient 42:448eecc3676e 605 }
AzureIoTClient 42:448eecc3676e 606 else
AzureIoTClient 42:448eecc3676e 607 {
AzureIoTClient 42:448eecc3676e 608 /*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 42:448eecc3676e 609 if (tickcounter_get_current_ms(handleData->tickCounter, &newEntry->ms_timesOutAfter) != 0)
AzureIoTClient 42:448eecc3676e 610 {
AzureIoTClient 42:448eecc3676e 611 result = __LINE__;
AzureIoTClient 42:448eecc3676e 612 LogError("unable to get the current relative tickcount");
AzureIoTClient 42:448eecc3676e 613 }
AzureIoTClient 42:448eecc3676e 614 else
AzureIoTClient 42:448eecc3676e 615 {
AzureIoTClient 42:448eecc3676e 616 newEntry->ms_timesOutAfter += handleData->currentMessageTimeout;
AzureIoTClient 42:448eecc3676e 617 result = 0;
AzureIoTClient 42:448eecc3676e 618 }
AzureIoTClient 42:448eecc3676e 619 }
AzureIoTClient 42:448eecc3676e 620 return result;
Azure.IoT Build 36:67300d5a4c1f 621 }
Azure.IoT Build 36:67300d5a4c1f 622
AzureIoTClient 16:deba40344375 623 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 624 {
AzureIoTClient 42:448eecc3676e 625 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 42:448eecc3676e 626 /*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 42:448eecc3676e 627 if (
AzureIoTClient 42:448eecc3676e 628 (iotHubClientHandle == NULL) ||
AzureIoTClient 42:448eecc3676e 629 (eventMessageHandle == NULL) ||
AzureIoTClient 42:448eecc3676e 630 /*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 42:448eecc3676e 631 ((eventConfirmationCallback == NULL) && (userContextCallback != NULL))
AzureIoTClient 42:448eecc3676e 632 )
AzureIoTClient 42:448eecc3676e 633 {
AzureIoTClient 42:448eecc3676e 634 result = IOTHUB_CLIENT_INVALID_ARG;
Azure.IoT Build 45:54c11b1b1407 635 LOG_ERROR_RESULT;
AzureIoTClient 42:448eecc3676e 636 }
AzureIoTClient 42:448eecc3676e 637 else
AzureIoTClient 42:448eecc3676e 638 {
AzureIoTClient 42:448eecc3676e 639 IOTHUB_MESSAGE_LIST *newEntry = (IOTHUB_MESSAGE_LIST*)malloc(sizeof(IOTHUB_MESSAGE_LIST));
AzureIoTClient 42:448eecc3676e 640 if (newEntry == NULL)
AzureIoTClient 42:448eecc3676e 641 {
AzureIoTClient 42:448eecc3676e 642 result = IOTHUB_CLIENT_ERROR;
Azure.IoT Build 45:54c11b1b1407 643 LOG_ERROR_RESULT;
AzureIoTClient 42:448eecc3676e 644 }
AzureIoTClient 42:448eecc3676e 645 else
AzureIoTClient 42:448eecc3676e 646 {
AzureIoTClient 42:448eecc3676e 647 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 40:1a94db9139ea 648
AzureIoTClient 42:448eecc3676e 649 if (attach_ms_timesOutAfter(handleData, newEntry) != 0)
AzureIoTClient 42:448eecc3676e 650 {
AzureIoTClient 42:448eecc3676e 651 result = IOTHUB_CLIENT_ERROR;
Azure.IoT Build 45:54c11b1b1407 652 LOG_ERROR_RESULT;
AzureIoTClient 42:448eecc3676e 653 free(newEntry);
AzureIoTClient 42:448eecc3676e 654 }
AzureIoTClient 42:448eecc3676e 655 else
AzureIoTClient 42:448eecc3676e 656 {
AzureIoTClient 42:448eecc3676e 657 /*Codes_SRS_IOTHUBCLIENT_LL_02_013: [IoTHubClient_SendEventAsync shall add the DLIST waitingToSend a new record cloning the information from eventMessageHandle, eventConfirmationCallback, userContextCallback.]*/
AzureIoTClient 42:448eecc3676e 658 if ((newEntry->messageHandle = IoTHubMessage_Clone(eventMessageHandle)) == NULL)
AzureIoTClient 42:448eecc3676e 659 {
AzureIoTClient 42:448eecc3676e 660 /*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 42:448eecc3676e 661 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 42:448eecc3676e 662 free(newEntry);
Azure.IoT Build 45:54c11b1b1407 663 LOG_ERROR_RESULT;
AzureIoTClient 42:448eecc3676e 664 }
AzureIoTClient 42:448eecc3676e 665 else
AzureIoTClient 42:448eecc3676e 666 {
AzureIoTClient 42:448eecc3676e 667 /*Codes_SRS_IOTHUBCLIENT_LL_02_013: [IoTHubClient_SendEventAsync shall add the DLIST waitingToSend a new record cloning the information from eventMessageHandle, eventConfirmationCallback, userContextCallback.]*/
AzureIoTClient 42:448eecc3676e 668 newEntry->callback = eventConfirmationCallback;
AzureIoTClient 42:448eecc3676e 669 newEntry->context = userContextCallback;
AzureIoTClient 46:6a69294b6119 670 DList_InsertTailList(&(iotHubClientHandle->waitingToSend), &(newEntry->entry));
AzureIoTClient 42:448eecc3676e 671 /*Codes_SRS_IOTHUBCLIENT_LL_02_015: [Otherwise IoTHubClient_LL_SendEventAsync shall succeed and return IOTHUB_CLIENT_OK.] */
AzureIoTClient 42:448eecc3676e 672 result = IOTHUB_CLIENT_OK;
AzureIoTClient 42:448eecc3676e 673 }
AzureIoTClient 42:448eecc3676e 674 }
AzureIoTClient 42:448eecc3676e 675 }
AzureIoTClient 42:448eecc3676e 676 }
AzureIoTClient 42:448eecc3676e 677 return result;
AzureIoTClient 16:deba40344375 678 }
AzureIoTClient 16:deba40344375 679
AzureIoTClient 16:deba40344375 680 IOTHUB_CLIENT_RESULT IoTHubClient_LL_SetMessageCallback(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, IOTHUB_CLIENT_MESSAGE_CALLBACK_ASYNC messageCallback, void* userContextCallback)
AzureIoTClient 16:deba40344375 681 {
AzureIoTClient 42:448eecc3676e 682 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 42:448eecc3676e 683 /*Codes_SRS_IOTHUBCLIENT_LL_02_016: [IoTHubClient_LL_SetMessageCallback shall fail and return IOTHUB_CLIENT_INVALID_ARG if parameter iotHubClientHandle is NULL.] */
AzureIoTClient 42:448eecc3676e 684 if (iotHubClientHandle == NULL)
AzureIoTClient 42:448eecc3676e 685 {
AzureIoTClient 42:448eecc3676e 686 result = IOTHUB_CLIENT_INVALID_ARG;
Azure.IoT Build 45:54c11b1b1407 687 LOG_ERROR_RESULT;
AzureIoTClient 42:448eecc3676e 688 }
AzureIoTClient 42:448eecc3676e 689 else
AzureIoTClient 42:448eecc3676e 690 {
AzureIoTClient 42:448eecc3676e 691 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 42:448eecc3676e 692 if (messageCallback == NULL)
AzureIoTClient 42:448eecc3676e 693 {
AzureIoTClient 42:448eecc3676e 694 /*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 42:448eecc3676e 695 handleData->IoTHubTransport_Unsubscribe(handleData->deviceHandle);
AzureIoTClient 42:448eecc3676e 696 handleData->messageCallback = NULL;
AzureIoTClient 42:448eecc3676e 697 handleData->messageUserContextCallback = NULL;
AzureIoTClient 42:448eecc3676e 698 result = IOTHUB_CLIENT_OK;
AzureIoTClient 42:448eecc3676e 699 }
AzureIoTClient 42:448eecc3676e 700 else
AzureIoTClient 42:448eecc3676e 701 {
AzureIoTClient 42:448eecc3676e 702 /*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 42:448eecc3676e 703 if (handleData->IoTHubTransport_Subscribe(handleData->deviceHandle) == 0)
AzureIoTClient 42:448eecc3676e 704 {
AzureIoTClient 42:448eecc3676e 705 handleData->messageCallback = messageCallback;
AzureIoTClient 42:448eecc3676e 706 handleData->messageUserContextCallback = userContextCallback;
AzureIoTClient 42:448eecc3676e 707 result = IOTHUB_CLIENT_OK;
AzureIoTClient 42:448eecc3676e 708 }
AzureIoTClient 42:448eecc3676e 709 else
AzureIoTClient 42:448eecc3676e 710 {
AzureIoTClient 42:448eecc3676e 711 handleData->messageCallback = NULL;
AzureIoTClient 42:448eecc3676e 712 handleData->messageUserContextCallback = NULL;
AzureIoTClient 42:448eecc3676e 713 /*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 42:448eecc3676e 714 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 42:448eecc3676e 715 }
AzureIoTClient 42:448eecc3676e 716 }
AzureIoTClient 42:448eecc3676e 717 }
AzureIoTClient 40:1a94db9139ea 718
AzureIoTClient 42:448eecc3676e 719 return result;
AzureIoTClient 16:deba40344375 720 }
AzureIoTClient 16:deba40344375 721
Azure.IoT Build 36:67300d5a4c1f 722 static void DoTimeouts(IOTHUB_CLIENT_LL_HANDLE_DATA* handleData)
Azure.IoT Build 36:67300d5a4c1f 723 {
AzureIoTClient 42:448eecc3676e 724 uint64_t nowTick;
AzureIoTClient 42:448eecc3676e 725 if (tickcounter_get_current_ms(handleData->tickCounter, &nowTick) != 0)
AzureIoTClient 42:448eecc3676e 726 {
AzureIoTClient 42:448eecc3676e 727 LogError("unable to get the current ms, timeouts will not be processed");
AzureIoTClient 42:448eecc3676e 728 }
AzureIoTClient 42:448eecc3676e 729 else
AzureIoTClient 42:448eecc3676e 730 {
AzureIoTClient 42:448eecc3676e 731 DLIST_ENTRY* currentItemInWaitingToSend = handleData->waitingToSend.Flink;
AzureIoTClient 42:448eecc3676e 732 while (currentItemInWaitingToSend != &(handleData->waitingToSend)) /*while we are not at the end of the list*/
AzureIoTClient 42:448eecc3676e 733 {
AzureIoTClient 42:448eecc3676e 734 IOTHUB_MESSAGE_LIST* fullEntry = containingRecord(currentItemInWaitingToSend, IOTHUB_MESSAGE_LIST, entry);
AzureIoTClient 42:448eecc3676e 735 /*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 42:448eecc3676e 736 if ((fullEntry->ms_timesOutAfter != 0) && (fullEntry->ms_timesOutAfter < nowTick))
AzureIoTClient 42:448eecc3676e 737 {
AzureIoTClient 42:448eecc3676e 738 PDLIST_ENTRY theNext = currentItemInWaitingToSend->Flink; /*need to save the next item, because the below operations are destructive*/
AzureIoTClient 42:448eecc3676e 739 DList_RemoveEntryList(currentItemInWaitingToSend);
AzureIoTClient 42:448eecc3676e 740 if (fullEntry->callback != NULL)
AzureIoTClient 42:448eecc3676e 741 {
AzureIoTClient 42:448eecc3676e 742 fullEntry->callback(IOTHUB_CLIENT_CONFIRMATION_MESSAGE_TIMEOUT, fullEntry->context);
AzureIoTClient 42:448eecc3676e 743 }
AzureIoTClient 42:448eecc3676e 744 IoTHubMessage_Destroy(fullEntry->messageHandle); /*because it has been cloned*/
AzureIoTClient 42:448eecc3676e 745 free(fullEntry);
AzureIoTClient 42:448eecc3676e 746 currentItemInWaitingToSend = theNext;
AzureIoTClient 42:448eecc3676e 747 }
AzureIoTClient 42:448eecc3676e 748 else
AzureIoTClient 42:448eecc3676e 749 {
AzureIoTClient 42:448eecc3676e 750 currentItemInWaitingToSend = currentItemInWaitingToSend->Flink;
AzureIoTClient 42:448eecc3676e 751 }
AzureIoTClient 42:448eecc3676e 752 }
AzureIoTClient 42:448eecc3676e 753 }
Azure.IoT Build 36:67300d5a4c1f 754 }
Azure.IoT Build 36:67300d5a4c1f 755
AzureIoTClient 16:deba40344375 756 void IoTHubClient_LL_DoWork(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle)
AzureIoTClient 16:deba40344375 757 {
AzureIoTClient 42:448eecc3676e 758 /*Codes_SRS_IOTHUBCLIENT_LL_02_020: [If parameter iotHubClientHandle is NULL then IoTHubClient_LL_DoWork shall not perform any action.] */
AzureIoTClient 42:448eecc3676e 759 if (iotHubClientHandle != NULL)
AzureIoTClient 42:448eecc3676e 760 {
AzureIoTClient 42:448eecc3676e 761 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 42:448eecc3676e 762 DoTimeouts(handleData);
AzureIoTClient 42:448eecc3676e 763
AzureIoTClient 42:448eecc3676e 764 /*Codes_SRS_IOTHUBCLIENT_LL_02_021: [Otherwise, IoTHubClient_LL_DoWork shall invoke the underlaying layer's _DoWork function.]*/
AzureIoTClient 42:448eecc3676e 765 handleData->IoTHubTransport_DoWork(handleData->transportHandle, iotHubClientHandle);
AzureIoTClient 42:448eecc3676e 766 }
AzureIoTClient 16:deba40344375 767 }
AzureIoTClient 16:deba40344375 768
AzureIoTClient 16:deba40344375 769 IOTHUB_CLIENT_RESULT IoTHubClient_LL_GetSendStatus(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, IOTHUB_CLIENT_STATUS *iotHubClientStatus)
AzureIoTClient 16:deba40344375 770 {
AzureIoTClient 42:448eecc3676e 771 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 16:deba40344375 772
AzureIoTClient 42:448eecc3676e 773 /* Codes_SRS_IOTHUBCLIENT_09_007: [IoTHubClient_GetSendStatus shall return IOTHUB_CLIENT_INVALID_ARG if called with NULL parameter] */
AzureIoTClient 42:448eecc3676e 774 if (iotHubClientHandle == NULL || iotHubClientStatus == NULL)
AzureIoTClient 42:448eecc3676e 775 {
AzureIoTClient 42:448eecc3676e 776 result = IOTHUB_CLIENT_INVALID_ARG;
Azure.IoT Build 45:54c11b1b1407 777 LOG_ERROR_RESULT;
AzureIoTClient 42:448eecc3676e 778 }
AzureIoTClient 42:448eecc3676e 779 else
AzureIoTClient 42:448eecc3676e 780 {
AzureIoTClient 42:448eecc3676e 781 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 16:deba40344375 782
AzureIoTClient 42:448eecc3676e 783 /* 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 42:448eecc3676e 784 /* 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 42:448eecc3676e 785 result = handleData->IoTHubTransport_GetSendStatus(handleData->deviceHandle, iotHubClientStatus);
AzureIoTClient 42:448eecc3676e 786 }
AzureIoTClient 16:deba40344375 787
AzureIoTClient 42:448eecc3676e 788 return result;
AzureIoTClient 16:deba40344375 789 }
AzureIoTClient 16:deba40344375 790
Azure.IoT Build 45:54c11b1b1407 791 void IoTHubClient_LL_SendComplete(IOTHUB_CLIENT_LL_HANDLE handle, PDLIST_ENTRY completed, IOTHUB_CLIENT_CONFIRMATION_RESULT result)
AzureIoTClient 16:deba40344375 792 {
AzureIoTClient 42:448eecc3676e 793 /*Codes_SRS_IOTHUBCLIENT_LL_02_022: [If parameter completed is NULL, or parameter handle is NULL then IoTHubClient_LL_SendBatch shall return.]*/
AzureIoTClient 42:448eecc3676e 794 if (
AzureIoTClient 42:448eecc3676e 795 (handle == NULL) ||
AzureIoTClient 42:448eecc3676e 796 (completed == NULL)
AzureIoTClient 42:448eecc3676e 797 )
AzureIoTClient 42:448eecc3676e 798 {
AzureIoTClient 42:448eecc3676e 799 /*"shall return"*/
AzureIoTClient 42:448eecc3676e 800 LogError("invalid arg");
AzureIoTClient 42:448eecc3676e 801 }
AzureIoTClient 42:448eecc3676e 802 else
AzureIoTClient 42:448eecc3676e 803 {
Azure.IoT Build 45:54c11b1b1407 804 /*Codes_SRS_IOTHUBCLIENT_LL_02_027: [If parameter result is IOTHUB_CLIENT_CONFIRMATION_ERROR 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.] */
Azure.IoT Build 45:54c11b1b1407 805 /*Codes_SRS_IOTHUBCLIENT_LL_02_025: [If parameter result is IOTHUB_CLIENT_CONFIRMATION_OK 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 42:448eecc3676e 806 PDLIST_ENTRY oldest;
AzureIoTClient 42:448eecc3676e 807 while ((oldest = DList_RemoveHeadList(completed)) != completed)
AzureIoTClient 42:448eecc3676e 808 {
AzureIoTClient 42:448eecc3676e 809 IOTHUB_MESSAGE_LIST* messageList = (IOTHUB_MESSAGE_LIST*)containingRecord(oldest, IOTHUB_MESSAGE_LIST, entry);
AzureIoTClient 42:448eecc3676e 810 /*Codes_SRS_IOTHUBCLIENT_LL_02_026: [If any callback is NULL then there shall not be a callback call.]*/
AzureIoTClient 42:448eecc3676e 811 if (messageList->callback != NULL)
AzureIoTClient 42:448eecc3676e 812 {
Azure.IoT Build 45:54c11b1b1407 813 messageList->callback(result, messageList->context);
AzureIoTClient 42:448eecc3676e 814 }
AzureIoTClient 42:448eecc3676e 815 IoTHubMessage_Destroy(messageList->messageHandle);
AzureIoTClient 42:448eecc3676e 816 free(messageList);
AzureIoTClient 42:448eecc3676e 817 }
AzureIoTClient 42:448eecc3676e 818 }
AzureIoTClient 16:deba40344375 819 }
AzureIoTClient 16:deba40344375 820
AzureIoTClient 16:deba40344375 821 IOTHUBMESSAGE_DISPOSITION_RESULT IoTHubClient_LL_MessageCallback(IOTHUB_CLIENT_LL_HANDLE handle, IOTHUB_MESSAGE_HANDLE message)
AzureIoTClient 16:deba40344375 822 {
AzureIoTClient 42:448eecc3676e 823 int result;
AzureIoTClient 42:448eecc3676e 824 /*Codes_SRS_IOTHUBCLIENT_LL_02_029: [If parameter handle is NULL then IoTHubClient_LL_MessageCallback shall return IOTHUBMESSAGE_ABANDONED.] */
AzureIoTClient 42:448eecc3676e 825 if (handle == NULL)
AzureIoTClient 42:448eecc3676e 826 {
AzureIoTClient 42:448eecc3676e 827 LogError("invalid argument");
AzureIoTClient 42:448eecc3676e 828 result = IOTHUBMESSAGE_ABANDONED;
AzureIoTClient 42:448eecc3676e 829 }
AzureIoTClient 42:448eecc3676e 830 else
AzureIoTClient 42:448eecc3676e 831 {
AzureIoTClient 42:448eecc3676e 832 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)handle;
AzureIoTClient 16:deba40344375 833
AzureIoTClient 42:448eecc3676e 834 /* Codes_SRS_IOTHUBCLIENT_LL_09_004: [IoTHubClient_LL_GetLastMessageReceiveTime shall return lastMessageReceiveTime in localtime] */
AzureIoTClient 42:448eecc3676e 835 handleData->lastMessageReceiveTime = get_time(NULL);
AzureIoTClient 16:deba40344375 836
AzureIoTClient 42:448eecc3676e 837 /*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 42:448eecc3676e 838 if (handleData->messageCallback != NULL)
AzureIoTClient 42:448eecc3676e 839 {
AzureIoTClient 42:448eecc3676e 840 result = handleData->messageCallback(message, handleData->messageUserContextCallback);
AzureIoTClient 42:448eecc3676e 841 }
AzureIoTClient 42:448eecc3676e 842 else
AzureIoTClient 42:448eecc3676e 843 {
AzureIoTClient 42:448eecc3676e 844 /*Codes_SRS_IOTHUBCLIENT_LL_02_032: [If the last callback function was NULL, then IoTHubClient_LL_MessageCallback shall return IOTHUBMESSAGE_ABANDONED.] */
AzureIoTClient 42:448eecc3676e 845 LogError("user callback was NULL");
AzureIoTClient 42:448eecc3676e 846 result = IOTHUBMESSAGE_ABANDONED;
AzureIoTClient 42:448eecc3676e 847 }
AzureIoTClient 42:448eecc3676e 848 }
AzureIoTClient 42:448eecc3676e 849 /*Codes_SRS_IOTHUBCLIENT_LL_02_031: [Then IoTHubClient_LL_MessageCallback shall return what the user function returns.]*/
AzureIoTClient 47:aaa262b5f898 850 return (IOTHUBMESSAGE_DISPOSITION_RESULT) result;
AzureIoTClient 16:deba40344375 851 }
AzureIoTClient 16:deba40344375 852
AzureIoTClient 52:1cc3c6d07cad 853 void IotHubClient_LL_ConnectionStatusCallBack(IOTHUB_CLIENT_LL_HANDLE handle, PDLIST_ENTRY connectionStatus)
AzureIoTClient 52:1cc3c6d07cad 854 {
AzureIoTClient 52:1cc3c6d07cad 855 (void)handle;
AzureIoTClient 52:1cc3c6d07cad 856 (void)connectionStatus;
AzureIoTClient 52:1cc3c6d07cad 857 }
AzureIoTClient 52:1cc3c6d07cad 858
AzureIoTClient 52:1cc3c6d07cad 859 IOTHUB_CLIENT_RESULT IoTHubClient_LL_SetConnectionStatusCallback(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, IOTHUB_CLIENT_CONNECTION_STATUS_CALLBACK connectionStatusCallback, void * userContextCallback)
AzureIoTClient 52:1cc3c6d07cad 860 {
AzureIoTClient 52:1cc3c6d07cad 861
AzureIoTClient 52:1cc3c6d07cad 862 IOTHUB_CLIENT_RESULT result = IOTHUB_CLIENT_OK;
AzureIoTClient 52:1cc3c6d07cad 863 (void)iotHubClientHandle;
AzureIoTClient 52:1cc3c6d07cad 864 (void)connectionStatusCallback;
AzureIoTClient 52:1cc3c6d07cad 865 (void)userContextCallback;
AzureIoTClient 52:1cc3c6d07cad 866
AzureIoTClient 52:1cc3c6d07cad 867
AzureIoTClient 52:1cc3c6d07cad 868 return result;
AzureIoTClient 52:1cc3c6d07cad 869 }
AzureIoTClient 52:1cc3c6d07cad 870
AzureIoTClient 52:1cc3c6d07cad 871 IOTHUB_CLIENT_RESULT IoTHubClient_LL_SetRetryPolicy(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, IOTHUB_CLIENT_RETRY_POLICY retryPolicy, size_t retryTimeoutLimitinSeconds)
AzureIoTClient 52:1cc3c6d07cad 872 {
AzureIoTClient 52:1cc3c6d07cad 873 IOTHUB_CLIENT_RESULT result = IOTHUB_CLIENT_OK;
AzureIoTClient 52:1cc3c6d07cad 874 (void)iotHubClientHandle;
AzureIoTClient 52:1cc3c6d07cad 875 (void)retryPolicy;
AzureIoTClient 52:1cc3c6d07cad 876 (void)retryTimeoutLimitinSeconds;
AzureIoTClient 52:1cc3c6d07cad 877
AzureIoTClient 52:1cc3c6d07cad 878 return result;
AzureIoTClient 52:1cc3c6d07cad 879 }
AzureIoTClient 52:1cc3c6d07cad 880
AzureIoTClient 52:1cc3c6d07cad 881 IOTHUB_CLIENT_RESULT IoTHubClient_LL_GetRetryPolicy(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, IOTHUB_CLIENT_RETRY_POLICY* retryPolicy, size_t* retryTimeoutLimitinSeconds)
AzureIoTClient 52:1cc3c6d07cad 882 {
AzureIoTClient 52:1cc3c6d07cad 883 IOTHUB_CLIENT_RESULT result = IOTHUB_CLIENT_OK;
AzureIoTClient 52:1cc3c6d07cad 884 (void)iotHubClientHandle;
AzureIoTClient 52:1cc3c6d07cad 885 (void)retryPolicy;
AzureIoTClient 52:1cc3c6d07cad 886 (void)retryTimeoutLimitinSeconds;
AzureIoTClient 52:1cc3c6d07cad 887
AzureIoTClient 52:1cc3c6d07cad 888 return result;
AzureIoTClient 52:1cc3c6d07cad 889 }
AzureIoTClient 52:1cc3c6d07cad 890
AzureIoTClient 16:deba40344375 891 IOTHUB_CLIENT_RESULT IoTHubClient_LL_GetLastMessageReceiveTime(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, time_t* lastMessageReceiveTime)
AzureIoTClient 16:deba40344375 892 {
AzureIoTClient 42:448eecc3676e 893 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 42:448eecc3676e 894 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 16:deba40344375 895
AzureIoTClient 42:448eecc3676e 896 /* Codes_SRS_IOTHUBCLIENT_LL_09_001: [IoTHubClient_LL_GetLastMessageReceiveTime shall return IOTHUB_CLIENT_INVALID_ARG if any of the arguments is NULL] */
AzureIoTClient 42:448eecc3676e 897 if (handleData == NULL || lastMessageReceiveTime == NULL)
AzureIoTClient 42:448eecc3676e 898 {
AzureIoTClient 42:448eecc3676e 899 result = IOTHUB_CLIENT_INVALID_ARG;
Azure.IoT Build 45:54c11b1b1407 900 LOG_ERROR_RESULT;
AzureIoTClient 42:448eecc3676e 901 }
AzureIoTClient 42:448eecc3676e 902 else
AzureIoTClient 42:448eecc3676e 903 {
AzureIoTClient 42:448eecc3676e 904 /* 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 42:448eecc3676e 905 if (handleData->lastMessageReceiveTime == INDEFINITE_TIME)
AzureIoTClient 42:448eecc3676e 906 {
AzureIoTClient 42:448eecc3676e 907 result = IOTHUB_CLIENT_INDEFINITE_TIME;
Azure.IoT Build 45:54c11b1b1407 908 LOG_ERROR_RESULT;
AzureIoTClient 42:448eecc3676e 909 }
AzureIoTClient 42:448eecc3676e 910 else
AzureIoTClient 42:448eecc3676e 911 {
AzureIoTClient 42:448eecc3676e 912 /* 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 42:448eecc3676e 913 /* Codes_SRS_IOTHUBCLIENT_LL_09_004: [IoTHubClient_LL_GetLastMessageReceiveTime shall return lastMessageReceiveTime in localtime] */
AzureIoTClient 42:448eecc3676e 914 *lastMessageReceiveTime = handleData->lastMessageReceiveTime;
AzureIoTClient 42:448eecc3676e 915 result = IOTHUB_CLIENT_OK;
AzureIoTClient 42:448eecc3676e 916 }
AzureIoTClient 42:448eecc3676e 917 }
AzureIoTClient 16:deba40344375 918
AzureIoTClient 42:448eecc3676e 919 return result;
AzureIoTClient 16:deba40344375 920 }
AzureIoTClient 16:deba40344375 921
AzureIoTClient 16:deba40344375 922 IOTHUB_CLIENT_RESULT IoTHubClient_LL_SetOption(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, const char* optionName, const void* value)
AzureIoTClient 16:deba40344375 923 {
AzureIoTClient 40:1a94db9139ea 924
AzureIoTClient 42:448eecc3676e 925 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 42:448eecc3676e 926 /*Codes_SRS_IOTHUBCLIENT_LL_02_034: [If iotHubClientHandle is NULL then IoTHubClient_LL_SetOption shall return IOTHUB_CLIENT_INVALID_ARG.]*/
AzureIoTClient 42:448eecc3676e 927 /*Codes_SRS_IOTHUBCLIENT_LL_02_035: [If optionName is NULL then IoTHubClient_LL_SetOption shall return IOTHUB_CLIENT_INVALID_ARG.] */
AzureIoTClient 42:448eecc3676e 928 /*Codes_SRS_IOTHUBCLIENT_LL_02_036: [If value is NULL then IoTHubClient_LL_SetOption shall return IOTHUB_CLIENT_INVALID_ARG.] */
AzureIoTClient 42:448eecc3676e 929 if (
AzureIoTClient 42:448eecc3676e 930 (iotHubClientHandle == NULL) ||
AzureIoTClient 42:448eecc3676e 931 (optionName == NULL) ||
AzureIoTClient 42:448eecc3676e 932 (value == NULL)
AzureIoTClient 42:448eecc3676e 933 )
AzureIoTClient 42:448eecc3676e 934 {
AzureIoTClient 42:448eecc3676e 935 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 42:448eecc3676e 936 LogError("invalid argument (NULL)");
AzureIoTClient 42:448eecc3676e 937 }
AzureIoTClient 42:448eecc3676e 938 else
AzureIoTClient 42:448eecc3676e 939 {
AzureIoTClient 42:448eecc3676e 940 IOTHUB_CLIENT_LL_HANDLE_DATA* handleData = (IOTHUB_CLIENT_LL_HANDLE_DATA*)iotHubClientHandle;
AzureIoTClient 42:448eecc3676e 941
AzureIoTClient 42:448eecc3676e 942 /*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 42:448eecc3676e 943 if (strcmp(optionName, "messageTimeout") == 0)
AzureIoTClient 42:448eecc3676e 944 {
AzureIoTClient 42:448eecc3676e 945 /*this is an option handled by IoTHubClient_LL*/
AzureIoTClient 42:448eecc3676e 946 /*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 42:448eecc3676e 947 handleData->currentMessageTimeout = *(const uint64_t*)value;
AzureIoTClient 42:448eecc3676e 948 result = IOTHUB_CLIENT_OK;
AzureIoTClient 42:448eecc3676e 949 }
AzureIoTClient 42:448eecc3676e 950 else
AzureIoTClient 42:448eecc3676e 951 {
AzureIoTClient 46:6a69294b6119 952
AzureIoTClient 46:6a69294b6119 953 /*Codes_SRS_IOTHUBCLIENT_LL_02_099: [ IoTHubClient_LL_SetOption shall return according to the table below ]*/
AzureIoTClient 46:6a69294b6119 954 IOTHUB_CLIENT_RESULT uploadToBlob_result;
AzureIoTClient 46:6a69294b6119 955 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 46:6a69294b6119 956 uploadToBlob_result = IoTHubClient_LL_UploadToBlob_SetOption(handleData->uploadToBlobHandle, optionName, value);
AzureIoTClient 46:6a69294b6119 957 if(uploadToBlob_result == IOTHUB_CLIENT_ERROR)
AzureIoTClient 46:6a69294b6119 958 {
AzureIoTClient 46:6a69294b6119 959 LogError("unable to IoTHubClient_LL_UploadToBlob_SetOption");
AzureIoTClient 46:6a69294b6119 960 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 46:6a69294b6119 961 }
AzureIoTClient 46:6a69294b6119 962 #else
AzureIoTClient 46:6a69294b6119 963 uploadToBlob_result = IOTHUB_CLIENT_INVALID_ARG; /*harmless value (IOTHUB_CLIENT_INVALID_ARG)in the case when uploadtoblob is not compiled in, otherwise whatever IoTHubClient_LL_UploadToBlob_SetOption returned*/
AzureIoTClient 46:6a69294b6119 964 #endif /*DONT_USE_UPLOADTOBLOB*/
AzureIoTClient 16:deba40344375 965
AzureIoTClient 46:6a69294b6119 966
AzureIoTClient 46:6a69294b6119 967 result =
AzureIoTClient 46:6a69294b6119 968 /*based on uploadToBlob_result value this is what happens:*/
AzureIoTClient 46:6a69294b6119 969 /*IOTHUB_CLIENT_INVALID_ARG always returns what IoTHubTransport_SetOption returns*/
AzureIoTClient 46:6a69294b6119 970 /*IOTHUB_CLIENT_ERROR always returns IOTHUB_CLIENT_ERROR */
AzureIoTClient 46:6a69294b6119 971 /*IOTHUB_CLIENT_OK returns OK
AzureIoTClient 46:6a69294b6119 972 IOTHUB_CLIENT_OK if IoTHubTransport_SetOption returns OK or INVALID_ARG
AzureIoTClient 46:6a69294b6119 973 IOTHUB_CLIENT_ERROR if IoTHubTransport_SetOption returns ERROR*/
AzureIoTClient 46:6a69294b6119 974
AzureIoTClient 46:6a69294b6119 975 (uploadToBlob_result == IOTHUB_CLIENT_INVALID_ARG) ? handleData->IoTHubTransport_SetOption(handleData->transportHandle, optionName, value) :
AzureIoTClient 46:6a69294b6119 976 (uploadToBlob_result == IOTHUB_CLIENT_ERROR) ? IOTHUB_CLIENT_ERROR :
AzureIoTClient 46:6a69294b6119 977 (handleData->IoTHubTransport_SetOption(handleData->transportHandle, optionName, value) == IOTHUB_CLIENT_ERROR) ? IOTHUB_CLIENT_ERROR : IOTHUB_CLIENT_OK;
AzureIoTClient 46:6a69294b6119 978
AzureIoTClient 47:aaa262b5f898 979 if (result != IOTHUB_CLIENT_OK)
AzureIoTClient 47:aaa262b5f898 980 {
AzureIoTClient 47:aaa262b5f898 981 LogError("underlying transport failed, returned = %s", ENUM_TO_STRING(IOTHUB_CLIENT_RESULT, result));
AzureIoTClient 42:448eecc3676e 982 }
AzureIoTClient 47:aaa262b5f898 983 }
AzureIoTClient 42:448eecc3676e 984 }
AzureIoTClient 42:448eecc3676e 985 return result;
AzureIoTClient 42:448eecc3676e 986 }
AzureIoTClient 16:deba40344375 987
AzureIoTClient 44:33dd78697616 988 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 42:448eecc3676e 989 IOTHUB_CLIENT_RESULT IoTHubClient_LL_UploadToBlob(IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, const char* destinationFileName, const unsigned char* source, size_t size)
AzureIoTClient 42:448eecc3676e 990 {
AzureIoTClient 42:448eecc3676e 991 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 42:448eecc3676e 992 /*Codes_SRS_IOTHUBCLIENT_LL_02_061: [ If iotHubClientHandle is NULL then IoTHubClient_LL_UploadToBlob shall fail and return IOTHUB_CLIENT_INVALID_ARG. ]*/
AzureIoTClient 42:448eecc3676e 993 /*Codes_SRS_IOTHUBCLIENT_LL_02_062: [ If destinationFileName is NULL then IoTHubClient_LL_UploadToBlob shall fail and return IOTHUB_CLIENT_INVALID_ARG. ]*/
AzureIoTClient 42:448eecc3676e 994 if (
AzureIoTClient 42:448eecc3676e 995 (iotHubClientHandle == NULL) ||
AzureIoTClient 42:448eecc3676e 996 (destinationFileName == NULL) ||
AzureIoTClient 42:448eecc3676e 997 ((source == NULL) && (size >0))
AzureIoTClient 42:448eecc3676e 998 )
AzureIoTClient 42:448eecc3676e 999 {
AzureIoTClient 42:448eecc3676e 1000 LogError("invalid parameters IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle=%p, const char* destinationFileName=%s, const unsigned char* source=%p, size_t size=%zu", iotHubClientHandle, destinationFileName, source, size);
AzureIoTClient 42:448eecc3676e 1001 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 42:448eecc3676e 1002 }
AzureIoTClient 42:448eecc3676e 1003 else
AzureIoTClient 42:448eecc3676e 1004 {
AzureIoTClient 42:448eecc3676e 1005 result = IoTHubClient_LL_UploadToBlob_Impl(iotHubClientHandle->uploadToBlobHandle, destinationFileName, source, size);
AzureIoTClient 42:448eecc3676e 1006 }
AzureIoTClient 42:448eecc3676e 1007 return result;
AzureIoTClient 16:deba40344375 1008 }
AzureIoTClient 43:038d8511e817 1009 #endif