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?
User | Revision | Line number | New 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 | } |