Azure IoT / iothub_client

Microsoft Azure IoTHub client libraries

Dependents:   sht15_remote_monitoring RobotArmDemo iothub_client_sample_amqp f767zi_mqtt ... more

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

iothub_client.c@61:8b85a4e797cf, 2017-03-10 (annotated)

Committer:
AzureIoTClient
Date:
Fri Mar 10 11:47:36 2017 -0800
Revision:
61:8b85a4e797cf
Parent:
60:41648c4e7036
Child:
62:5a4cdacf5090
1.1.9

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>
Azure.IoT.Build 54:6dcad9019a64 5 #include "azure_c_shared_utility/umock_c_prod.h"
Azure.IoT Build 38:a05929a75111 6 #include "azure_c_shared_utility/gballoc.h"
AzureIoTClient 16:deba40344375 7
AzureIoTClient 16:deba40344375 8 #include <signal.h>
Azure.IoT Build 35:ceed20da4ba6 9 #include <stddef.h>
AzureIoTClient 60:41648c4e7036 10 #include "azure_c_shared_utility/optimize_size.h"
Azure.IoT Build 38:a05929a75111 11 #include "azure_c_shared_utility/crt_abstractions.h"
AzureIoTClient 16:deba40344375 12 #include "iothub_client.h"
AzureIoTClient 16:deba40344375 13 #include "iothub_client_ll.h"
AzureIoTClient 61:8b85a4e797cf 14 #include "iothub_client_private.h"
Azure.IoT Build 37:18310e4d888d 15 #include "iothubtransport.h"
Azure.IoT Build 38:a05929a75111 16 #include "azure_c_shared_utility/threadapi.h"
Azure.IoT Build 38:a05929a75111 17 #include "azure_c_shared_utility/lock.h"
Azure.IoT Build 45:54c11b1b1407 18 #include "azure_c_shared_utility/xlogging.h"
AzureIoTClient 52:1cc3c6d07cad 19 #include "azure_c_shared_utility/singlylinkedlist.h"
Azure.IoT.Build 54:6dcad9019a64 20 #include "azure_c_shared_utility/vector.h"
AzureIoTClient 16:deba40344375 21
AzureIoTClient 55:59b527ab3452 22 struct IOTHUB_QUEUE_CONTEXT_TAG;
AzureIoTClient 55:59b527ab3452 23
AzureIoTClient 16:deba40344375 24 typedef struct IOTHUB_CLIENT_INSTANCE_TAG
AzureIoTClient 16:deba40344375 25 {
AzureIoTClient 16:deba40344375 26 IOTHUB_CLIENT_LL_HANDLE IoTHubClientLLHandle;
AzureIoTClient 42:448eecc3676e 27 TRANSPORT_HANDLE TransportHandle;
AzureIoTClient 16:deba40344375 28 THREAD_HANDLE ThreadHandle;
AzureIoTClient 16:deba40344375 29 LOCK_HANDLE LockHandle;
AzureIoTClient 16:deba40344375 30 sig_atomic_t StopThread;
AzureIoTClient 44:33dd78697616 31 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 52:1cc3c6d07cad 32 SINGLYLINKEDLIST_HANDLE savedDataToBeCleaned; /*list containing UPLOADTOBLOB_SAVED_DATA*/
AzureIoTClient 43:038d8511e817 33 #endif
Azure.IoT.Build 54:6dcad9019a64 34 int created_with_transport_handle;
Azure.IoT.Build 54:6dcad9019a64 35 VECTOR_HANDLE saved_user_callback_list;
Azure.IoT.Build 54:6dcad9019a64 36 IOTHUB_CLIENT_DEVICE_TWIN_CALLBACK desired_state_callback;
Azure.IoT.Build 54:6dcad9019a64 37 IOTHUB_CLIENT_EVENT_CONFIRMATION_CALLBACK event_confirm_callback;
Azure.IoT.Build 54:6dcad9019a64 38 IOTHUB_CLIENT_REPORTED_STATE_CALLBACK reported_state_callback;
Azure.IoT.Build 54:6dcad9019a64 39 IOTHUB_CLIENT_CONNECTION_STATUS_CALLBACK connection_status_callback;
AzureIoTClient 55:59b527ab3452 40 IOTHUB_CLIENT_INBOUND_DEVICE_METHOD_CALLBACK device_method_callback;
AzureIoTClient 61:8b85a4e797cf 41 IOTHUB_CLIENT_MESSAGE_CALLBACK_ASYNC message_callback;
AzureIoTClient 55:59b527ab3452 42 struct IOTHUB_QUEUE_CONTEXT_TAG* devicetwin_user_context;
AzureIoTClient 55:59b527ab3452 43 struct IOTHUB_QUEUE_CONTEXT_TAG* connection_status_user_context;
AzureIoTClient 61:8b85a4e797cf 44 struct IOTHUB_QUEUE_CONTEXT_TAG* message_user_context;
AzureIoTClient 16:deba40344375 45 } IOTHUB_CLIENT_INSTANCE;
AzureIoTClient 16:deba40344375 46
AzureIoTClient 44:33dd78697616 47 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 42:448eecc3676e 48 typedef struct UPLOADTOBLOB_SAVED_DATA_TAG
AzureIoTClient 42:448eecc3676e 49 {
AzureIoTClient 42:448eecc3676e 50 unsigned char* source;
AzureIoTClient 42:448eecc3676e 51 size_t size;
AzureIoTClient 42:448eecc3676e 52 char* destinationFileName;
AzureIoTClient 42:448eecc3676e 53 IOTHUB_CLIENT_FILE_UPLOAD_CALLBACK iotHubClientFileUploadCallback;
AzureIoTClient 42:448eecc3676e 54 void* context;
AzureIoTClient 42:448eecc3676e 55 THREAD_HANDLE uploadingThreadHandle;
AzureIoTClient 42:448eecc3676e 56 IOTHUB_CLIENT_HANDLE iotHubClientHandle;
AzureIoTClient 42:448eecc3676e 57 LOCK_HANDLE lockGarbage;
AzureIoTClient 42:448eecc3676e 58 int canBeGarbageCollected; /*flag indicating that the UPLOADTOBLOB_SAVED_DATA structure can be freed because the thread deadling with it finished*/
AzureIoTClient 42:448eecc3676e 59 }UPLOADTOBLOB_SAVED_DATA;
AzureIoTClient 43:038d8511e817 60 #endif
AzureIoTClient 42:448eecc3676e 61
Azure.IoT.Build 54:6dcad9019a64 62 #define USER_CALLBACK_TYPE_VALUES \
Azure.IoT.Build 54:6dcad9019a64 63 CALLBACK_TYPE_DEVICE_TWIN, \
Azure.IoT.Build 54:6dcad9019a64 64 CALLBACK_TYPE_EVENT_CONFIRM, \
Azure.IoT.Build 54:6dcad9019a64 65 CALLBACK_TYPE_REPORTED_STATE, \
AzureIoTClient 55:59b527ab3452 66 CALLBACK_TYPE_CONNECTION_STATUS, \
AzureIoTClient 61:8b85a4e797cf 67 CALLBACK_TYPE_DEVICE_METHOD, \
AzureIoTClient 61:8b85a4e797cf 68 CALLBACK_TYPE_MESSAGE
Azure.IoT.Build 54:6dcad9019a64 69
Azure.IoT.Build 54:6dcad9019a64 70 DEFINE_ENUM(USER_CALLBACK_TYPE, USER_CALLBACK_TYPE_VALUES)
AzureIoTClient 56:fdda9c1244e4 71 DEFINE_ENUM_STRINGS(USER_CALLBACK_TYPE, USER_CALLBACK_TYPE_VALUES)
Azure.IoT.Build 54:6dcad9019a64 72
Azure.IoT.Build 54:6dcad9019a64 73 typedef struct DEVICE_TWIN_CALLBACK_INFO_TAG
Azure.IoT.Build 54:6dcad9019a64 74 {
Azure.IoT.Build 54:6dcad9019a64 75 DEVICE_TWIN_UPDATE_STATE update_state;
Azure.IoT.Build 54:6dcad9019a64 76 unsigned char* payLoad;
Azure.IoT.Build 54:6dcad9019a64 77 size_t size;
Azure.IoT.Build 54:6dcad9019a64 78 } DEVICE_TWIN_CALLBACK_INFO;
Azure.IoT.Build 54:6dcad9019a64 79
Azure.IoT.Build 54:6dcad9019a64 80 typedef struct EVENT_CONFIRM_CALLBACK_INFO_TAG
Azure.IoT.Build 54:6dcad9019a64 81 {
Azure.IoT.Build 54:6dcad9019a64 82 IOTHUB_CLIENT_CONFIRMATION_RESULT confirm_result;
Azure.IoT.Build 54:6dcad9019a64 83 } EVENT_CONFIRM_CALLBACK_INFO;
Azure.IoT.Build 54:6dcad9019a64 84
Azure.IoT.Build 54:6dcad9019a64 85 typedef struct REPORTED_STATE_CALLBACK_INFO_TAG
Azure.IoT.Build 54:6dcad9019a64 86 {
Azure.IoT.Build 54:6dcad9019a64 87 int status_code;
Azure.IoT.Build 54:6dcad9019a64 88 } REPORTED_STATE_CALLBACK_INFO;
Azure.IoT.Build 54:6dcad9019a64 89
Azure.IoT.Build 54:6dcad9019a64 90 typedef struct CONNECTION_STATUS_CALLBACK_INFO_TAG
Azure.IoT.Build 54:6dcad9019a64 91 {
Azure.IoT.Build 54:6dcad9019a64 92 IOTHUB_CLIENT_CONNECTION_STATUS connection_status;
Azure.IoT.Build 54:6dcad9019a64 93 IOTHUB_CLIENT_CONNECTION_STATUS_REASON status_reason;
Azure.IoT.Build 54:6dcad9019a64 94 } CONNECTION_STATUS_CALLBACK_INFO;
Azure.IoT.Build 54:6dcad9019a64 95
Azure.IoT.Build 54:6dcad9019a64 96 typedef struct METHOD_CALLBACK_INFO_TAG
Azure.IoT.Build 54:6dcad9019a64 97 {
AzureIoTClient 55:59b527ab3452 98 STRING_HANDLE method_name;
AzureIoTClient 55:59b527ab3452 99 BUFFER_HANDLE payload;
AzureIoTClient 55:59b527ab3452 100 METHOD_HANDLE method_id;
Azure.IoT.Build 54:6dcad9019a64 101 } METHOD_CALLBACK_INFO;
Azure.IoT.Build 54:6dcad9019a64 102
Azure.IoT.Build 54:6dcad9019a64 103 typedef struct USER_CALLBACK_INFO_TAG
Azure.IoT.Build 54:6dcad9019a64 104 {
Azure.IoT.Build 54:6dcad9019a64 105 USER_CALLBACK_TYPE type;
Azure.IoT.Build 54:6dcad9019a64 106 void* userContextCallback;
Azure.IoT.Build 54:6dcad9019a64 107 union IOTHUB_CALLBACK
Azure.IoT.Build 54:6dcad9019a64 108 {
Azure.IoT.Build 54:6dcad9019a64 109 DEVICE_TWIN_CALLBACK_INFO dev_twin_cb_info;
Azure.IoT.Build 54:6dcad9019a64 110 EVENT_CONFIRM_CALLBACK_INFO event_confirm_cb_info;
Azure.IoT.Build 54:6dcad9019a64 111 REPORTED_STATE_CALLBACK_INFO reported_state_cb_info;
Azure.IoT.Build 54:6dcad9019a64 112 CONNECTION_STATUS_CALLBACK_INFO connection_status_cb_info;
AzureIoTClient 55:59b527ab3452 113 METHOD_CALLBACK_INFO method_cb_info;
AzureIoTClient 61:8b85a4e797cf 114 MESSAGE_CALLBACK_INFO* message_cb_info;
Azure.IoT.Build 54:6dcad9019a64 115 } iothub_callback;
Azure.IoT.Build 54:6dcad9019a64 116 } USER_CALLBACK_INFO;
Azure.IoT.Build 54:6dcad9019a64 117
Azure.IoT.Build 54:6dcad9019a64 118 typedef struct IOTHUB_QUEUE_CONTEXT_TAG
Azure.IoT.Build 54:6dcad9019a64 119 {
Azure.IoT.Build 54:6dcad9019a64 120 IOTHUB_CLIENT_INSTANCE* iotHubClientHandle;
Azure.IoT.Build 54:6dcad9019a64 121 void* userContextCallback;
Azure.IoT.Build 54:6dcad9019a64 122 } IOTHUB_QUEUE_CONTEXT;
Azure.IoT.Build 54:6dcad9019a64 123
Azure.IoT Build 35:ceed20da4ba6 124 /*used by unittests only*/
Azure.IoT Build 35:ceed20da4ba6 125 const size_t IoTHubClient_ThreadTerminationOffset = offsetof(IOTHUB_CLIENT_INSTANCE, StopThread);
Azure.IoT Build 35:ceed20da4ba6 126
AzureIoTClient 44:33dd78697616 127 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 42:448eecc3676e 128 /*this function is called from _Destroy and from ScheduleWork_Thread to join finished blobUpload threads and free that memory*/
AzureIoTClient 42:448eecc3676e 129 static void garbageCollectorImpl(IOTHUB_CLIENT_INSTANCE* iotHubClientInstance)
AzureIoTClient 42:448eecc3676e 130 {
AzureIoTClient 42:448eecc3676e 131 /*see if any savedData structures can be disposed of*/
AzureIoTClient 42:448eecc3676e 132 /*Codes_SRS_IOTHUBCLIENT_02_072: [ All threads marked as disposable (upon completion of a file upload) shall be joined and the data structures build for them shall be freed. ]*/
AzureIoTClient 52:1cc3c6d07cad 133 LIST_ITEM_HANDLE item = singlylinkedlist_get_head_item(iotHubClientInstance->savedDataToBeCleaned);
AzureIoTClient 42:448eecc3676e 134 while (item != NULL)
AzureIoTClient 42:448eecc3676e 135 {
AzureIoTClient 52:1cc3c6d07cad 136 const UPLOADTOBLOB_SAVED_DATA* savedData = (const UPLOADTOBLOB_SAVED_DATA*)singlylinkedlist_item_get_value(item);
AzureIoTClient 42:448eecc3676e 137 LIST_ITEM_HANDLE old_item = item;
AzureIoTClient 52:1cc3c6d07cad 138 item = singlylinkedlist_get_next_item(item);
AzureIoTClient 42:448eecc3676e 139
AzureIoTClient 42:448eecc3676e 140 if (Lock(savedData->lockGarbage) != LOCK_OK)
AzureIoTClient 42:448eecc3676e 141 {
AzureIoTClient 43:038d8511e817 142 LogError("unable to Lock");
AzureIoTClient 42:448eecc3676e 143 }
AzureIoTClient 42:448eecc3676e 144 else
AzureIoTClient 42:448eecc3676e 145 {
AzureIoTClient 42:448eecc3676e 146 if (savedData->canBeGarbageCollected == 1)
AzureIoTClient 42:448eecc3676e 147 {
AzureIoTClient 42:448eecc3676e 148 int notUsed;
AzureIoTClient 42:448eecc3676e 149 if (ThreadAPI_Join(savedData->uploadingThreadHandle, &notUsed) != THREADAPI_OK)
AzureIoTClient 42:448eecc3676e 150 {
AzureIoTClient 42:448eecc3676e 151 LogError("unable to ThreadAPI_Join");
AzureIoTClient 42:448eecc3676e 152 }
AzureIoTClient 52:1cc3c6d07cad 153 (void)singlylinkedlist_remove(iotHubClientInstance->savedDataToBeCleaned, old_item);
AzureIoTClient 42:448eecc3676e 154 free((void*)savedData->source);
AzureIoTClient 42:448eecc3676e 155 free((void*)savedData->destinationFileName);
AzureIoTClient 42:448eecc3676e 156
AzureIoTClient 42:448eecc3676e 157 if (Unlock(savedData->lockGarbage) != LOCK_OK)
AzureIoTClient 42:448eecc3676e 158 {
AzureIoTClient 42:448eecc3676e 159 LogError("unable to unlock after locking");
AzureIoTClient 42:448eecc3676e 160 }
AzureIoTClient 42:448eecc3676e 161 (void)Lock_Deinit(savedData->lockGarbage);
AzureIoTClient 42:448eecc3676e 162 free((void*)savedData);
AzureIoTClient 42:448eecc3676e 163 }
AzureIoTClient 42:448eecc3676e 164 else
AzureIoTClient 42:448eecc3676e 165 {
AzureIoTClient 42:448eecc3676e 166 if (Unlock(savedData->lockGarbage) != LOCK_OK)
AzureIoTClient 42:448eecc3676e 167 {
AzureIoTClient 42:448eecc3676e 168 LogError("unable to unlock after locking");
AzureIoTClient 42:448eecc3676e 169 }
AzureIoTClient 42:448eecc3676e 170 }
AzureIoTClient 42:448eecc3676e 171 }
AzureIoTClient 42:448eecc3676e 172 }
AzureIoTClient 42:448eecc3676e 173 }
AzureIoTClient 43:038d8511e817 174 #endif
AzureIoTClient 42:448eecc3676e 175
AzureIoTClient 61:8b85a4e797cf 176 static bool iothub_ll_message_callback(MESSAGE_CALLBACK_INFO* messageData, void* userContextCallback)
Azure.IoT.Build 54:6dcad9019a64 177 {
AzureIoTClient 61:8b85a4e797cf 178 bool result;
AzureIoTClient 61:8b85a4e797cf 179 IOTHUB_QUEUE_CONTEXT* queue_context = (IOTHUB_QUEUE_CONTEXT*)userContextCallback;
AzureIoTClient 61:8b85a4e797cf 180 if (queue_context == NULL)
AzureIoTClient 61:8b85a4e797cf 181 {
AzureIoTClient 61:8b85a4e797cf 182 LogError("invalid parameter userContextCallback(NULL)");
AzureIoTClient 61:8b85a4e797cf 183 result = false;
AzureIoTClient 61:8b85a4e797cf 184 }
AzureIoTClient 61:8b85a4e797cf 185 else
AzureIoTClient 61:8b85a4e797cf 186 {
AzureIoTClient 61:8b85a4e797cf 187 USER_CALLBACK_INFO queue_cb_info;
AzureIoTClient 61:8b85a4e797cf 188 queue_cb_info.type = CALLBACK_TYPE_MESSAGE;
AzureIoTClient 61:8b85a4e797cf 189 queue_cb_info.userContextCallback = queue_context->userContextCallback;
AzureIoTClient 61:8b85a4e797cf 190 queue_cb_info.iothub_callback.message_cb_info = messageData;
AzureIoTClient 61:8b85a4e797cf 191 if (VECTOR_push_back(queue_context->iotHubClientHandle->saved_user_callback_list, &queue_cb_info, 1) == 0)
AzureIoTClient 61:8b85a4e797cf 192 {
AzureIoTClient 61:8b85a4e797cf 193 result = true;
AzureIoTClient 61:8b85a4e797cf 194 }
AzureIoTClient 61:8b85a4e797cf 195 else
AzureIoTClient 61:8b85a4e797cf 196 {
AzureIoTClient 61:8b85a4e797cf 197 LogError("message callback vector push failed.");
AzureIoTClient 61:8b85a4e797cf 198 result = false;
AzureIoTClient 61:8b85a4e797cf 199 }
AzureIoTClient 61:8b85a4e797cf 200 }
AzureIoTClient 61:8b85a4e797cf 201 return result;
Azure.IoT.Build 54:6dcad9019a64 202 }
Azure.IoT.Build 54:6dcad9019a64 203
AzureIoTClient 55:59b527ab3452 204 static int iothub_ll_inbound_device_method_callback(const char* method_name, const unsigned char* payload, size_t size, METHOD_HANDLE method_id, void* userContextCallback)
Azure.IoT.Build 54:6dcad9019a64 205 {
AzureIoTClient 55:59b527ab3452 206 int result;
AzureIoTClient 55:59b527ab3452 207 IOTHUB_QUEUE_CONTEXT* queue_context = (IOTHUB_QUEUE_CONTEXT*)userContextCallback;
AzureIoTClient 55:59b527ab3452 208 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_001: [ if userContextCallback is NULL, IOTHUB_CLIENT_INBOUND_DEVICE_METHOD_CALLBACK shall return a nonNULL value. ] */
AzureIoTClient 55:59b527ab3452 209 if (queue_context != NULL)
AzureIoTClient 55:59b527ab3452 210 {
AzureIoTClient 55:59b527ab3452 211 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_002: [ IOTHUB_CLIENT_INBOUND_DEVICE_METHOD_CALLBACK shall copy the method_name and payload. ] */
AzureIoTClient 55:59b527ab3452 212 USER_CALLBACK_INFO queue_cb_info;
AzureIoTClient 55:59b527ab3452 213 queue_cb_info.type = CALLBACK_TYPE_DEVICE_METHOD;
AzureIoTClient 55:59b527ab3452 214 queue_cb_info.userContextCallback = queue_context->userContextCallback;
AzureIoTClient 55:59b527ab3452 215 queue_cb_info.iothub_callback.method_cb_info.method_id = method_id;
AzureIoTClient 55:59b527ab3452 216 if ( (queue_cb_info.iothub_callback.method_cb_info.method_name = STRING_construct(method_name)) == NULL)
AzureIoTClient 55:59b527ab3452 217 {
AzureIoTClient 55:59b527ab3452 218 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_003: [ If a failure is encountered IOTHUB_CLIENT_INBOUND_DEVICE_METHOD_CALLBACK shall return a non-NULL value. ]*/
AzureIoTClient 55:59b527ab3452 219 LogError("Failure: STRING_construct");
AzureIoTClient 60:41648c4e7036 220 result = __FAILURE__;
AzureIoTClient 55:59b527ab3452 221 }
AzureIoTClient 55:59b527ab3452 222 else if ((queue_cb_info.iothub_callback.method_cb_info.payload = BUFFER_create(payload, size)) == NULL)
AzureIoTClient 55:59b527ab3452 223 {
AzureIoTClient 55:59b527ab3452 224 STRING_delete(queue_cb_info.iothub_callback.method_cb_info.method_name);
AzureIoTClient 55:59b527ab3452 225 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_003: [ If a failure is encountered IOTHUB_CLIENT_INBOUND_DEVICE_METHOD_CALLBACK shall return a non-NULL value. ]*/
AzureIoTClient 55:59b527ab3452 226 LogError("Failure: BUFFER_create");
AzureIoTClient 60:41648c4e7036 227 result = __FAILURE__;
AzureIoTClient 55:59b527ab3452 228 }
AzureIoTClient 55:59b527ab3452 229 else if (VECTOR_push_back(queue_context->iotHubClientHandle->saved_user_callback_list, &queue_cb_info, 1) != 0)
AzureIoTClient 55:59b527ab3452 230 {
AzureIoTClient 55:59b527ab3452 231 STRING_delete(queue_cb_info.iothub_callback.method_cb_info.method_name);
AzureIoTClient 55:59b527ab3452 232 BUFFER_delete(queue_cb_info.iothub_callback.method_cb_info.payload);
AzureIoTClient 55:59b527ab3452 233 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_003: [ If a failure is encountered IOTHUB_CLIENT_INBOUND_DEVICE_METHOD_CALLBACK shall return a non-NULL value. ]*/
AzureIoTClient 55:59b527ab3452 234 LogError("connection status callback vector push failed.");
AzureIoTClient 60:41648c4e7036 235 result = __FAILURE__;
AzureIoTClient 55:59b527ab3452 236 }
AzureIoTClient 55:59b527ab3452 237 else
AzureIoTClient 55:59b527ab3452 238 {
AzureIoTClient 55:59b527ab3452 239 /*Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_004: [ On success IOTHUB_CLIENT_INBOUND_DEVICE_METHOD_CALLBACK shall return a 0 value. ]*/
AzureIoTClient 55:59b527ab3452 240 result = 0;
AzureIoTClient 55:59b527ab3452 241 }
AzureIoTClient 55:59b527ab3452 242 free(queue_context);
AzureIoTClient 55:59b527ab3452 243 }
AzureIoTClient 55:59b527ab3452 244 else
AzureIoTClient 55:59b527ab3452 245 {
AzureIoTClient 55:59b527ab3452 246 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_003: [ If a failure is encountered IOTHUB_CLIENT_INBOUND_DEVICE_METHOD_CALLBACK shall return a non-NULL value. ]*/
AzureIoTClient 55:59b527ab3452 247 LogError("Invalid parameter: userContextCallback NULL");
AzureIoTClient 60:41648c4e7036 248 result = __FAILURE__;
AzureIoTClient 55:59b527ab3452 249 }
AzureIoTClient 55:59b527ab3452 250 return result;
Azure.IoT.Build 54:6dcad9019a64 251 }
Azure.IoT.Build 54:6dcad9019a64 252
Azure.IoT.Build 54:6dcad9019a64 253 static void iothub_ll_connection_status_callback(IOTHUB_CLIENT_CONNECTION_STATUS result, IOTHUB_CLIENT_CONNECTION_STATUS_REASON reason, void* userContextCallback)
Azure.IoT.Build 54:6dcad9019a64 254 {
Azure.IoT.Build 54:6dcad9019a64 255 IOTHUB_QUEUE_CONTEXT* queue_context = (IOTHUB_QUEUE_CONTEXT*)userContextCallback;
Azure.IoT.Build 54:6dcad9019a64 256 if (queue_context != NULL)
Azure.IoT.Build 54:6dcad9019a64 257 {
Azure.IoT.Build 54:6dcad9019a64 258 USER_CALLBACK_INFO queue_cb_info;
Azure.IoT.Build 54:6dcad9019a64 259 queue_cb_info.type = CALLBACK_TYPE_CONNECTION_STATUS;
Azure.IoT.Build 54:6dcad9019a64 260 queue_cb_info.userContextCallback = queue_context->userContextCallback;
Azure.IoT.Build 54:6dcad9019a64 261 queue_cb_info.iothub_callback.connection_status_cb_info.status_reason = reason;
Azure.IoT.Build 54:6dcad9019a64 262 queue_cb_info.iothub_callback.connection_status_cb_info.connection_status = result;
Azure.IoT.Build 54:6dcad9019a64 263 if (VECTOR_push_back(queue_context->iotHubClientHandle->saved_user_callback_list, &queue_cb_info, 1) != 0)
Azure.IoT.Build 54:6dcad9019a64 264 {
Azure.IoT.Build 54:6dcad9019a64 265 LogError("connection status callback vector push failed.");
Azure.IoT.Build 54:6dcad9019a64 266 }
Azure.IoT.Build 54:6dcad9019a64 267 }
Azure.IoT.Build 54:6dcad9019a64 268 }
Azure.IoT.Build 54:6dcad9019a64 269
Azure.IoT.Build 54:6dcad9019a64 270 static void iothub_ll_event_confirm_callback(IOTHUB_CLIENT_CONFIRMATION_RESULT result, void* userContextCallback)
Azure.IoT.Build 54:6dcad9019a64 271 {
Azure.IoT.Build 54:6dcad9019a64 272 IOTHUB_QUEUE_CONTEXT* queue_context = (IOTHUB_QUEUE_CONTEXT*)userContextCallback;
Azure.IoT.Build 54:6dcad9019a64 273 if (queue_context != NULL)
Azure.IoT.Build 54:6dcad9019a64 274 {
Azure.IoT.Build 54:6dcad9019a64 275 USER_CALLBACK_INFO queue_cb_info;
Azure.IoT.Build 54:6dcad9019a64 276 queue_cb_info.type = CALLBACK_TYPE_EVENT_CONFIRM;
Azure.IoT.Build 54:6dcad9019a64 277 queue_cb_info.userContextCallback = queue_context->userContextCallback;
Azure.IoT.Build 54:6dcad9019a64 278 queue_cb_info.iothub_callback.event_confirm_cb_info.confirm_result = result;
Azure.IoT.Build 54:6dcad9019a64 279 if (VECTOR_push_back(queue_context->iotHubClientHandle->saved_user_callback_list, &queue_cb_info, 1) != 0)
Azure.IoT.Build 54:6dcad9019a64 280 {
Azure.IoT.Build 54:6dcad9019a64 281 LogError("event confirm callback vector push failed.");
Azure.IoT.Build 54:6dcad9019a64 282 }
Azure.IoT.Build 54:6dcad9019a64 283 free(queue_context);
Azure.IoT.Build 54:6dcad9019a64 284 }
Azure.IoT.Build 54:6dcad9019a64 285 }
Azure.IoT.Build 54:6dcad9019a64 286
Azure.IoT.Build 54:6dcad9019a64 287 static void iothub_ll_reported_state_callback(int status_code, void* userContextCallback)
Azure.IoT.Build 54:6dcad9019a64 288 {
Azure.IoT.Build 54:6dcad9019a64 289 IOTHUB_QUEUE_CONTEXT* queue_context = (IOTHUB_QUEUE_CONTEXT*)userContextCallback;
Azure.IoT.Build 54:6dcad9019a64 290 if (queue_context != NULL)
Azure.IoT.Build 54:6dcad9019a64 291 {
Azure.IoT.Build 54:6dcad9019a64 292 USER_CALLBACK_INFO queue_cb_info;
Azure.IoT.Build 54:6dcad9019a64 293 queue_cb_info.type = CALLBACK_TYPE_REPORTED_STATE;
Azure.IoT.Build 54:6dcad9019a64 294 queue_cb_info.userContextCallback = queue_context->userContextCallback;
Azure.IoT.Build 54:6dcad9019a64 295 queue_cb_info.iothub_callback.reported_state_cb_info.status_code = status_code;
Azure.IoT.Build 54:6dcad9019a64 296 if (VECTOR_push_back(queue_context->iotHubClientHandle->saved_user_callback_list, &queue_cb_info, 1) != 0)
Azure.IoT.Build 54:6dcad9019a64 297 {
Azure.IoT.Build 54:6dcad9019a64 298 LogError("reported state callback vector push failed.");
Azure.IoT.Build 54:6dcad9019a64 299 }
Azure.IoT.Build 54:6dcad9019a64 300 free(queue_context);
Azure.IoT.Build 54:6dcad9019a64 301 }
Azure.IoT.Build 54:6dcad9019a64 302 }
Azure.IoT.Build 54:6dcad9019a64 303
Azure.IoT.Build 54:6dcad9019a64 304 static void iothub_ll_device_twin_callback(DEVICE_TWIN_UPDATE_STATE update_state, const unsigned char* payLoad, size_t size, void* userContextCallback)
Azure.IoT.Build 54:6dcad9019a64 305 {
Azure.IoT.Build 54:6dcad9019a64 306 IOTHUB_QUEUE_CONTEXT* queue_context = (IOTHUB_QUEUE_CONTEXT*)userContextCallback;
Azure.IoT.Build 54:6dcad9019a64 307 if (queue_context != NULL)
Azure.IoT.Build 54:6dcad9019a64 308 {
AzureIoTClient 55:59b527ab3452 309 int push_to_vector;
AzureIoTClient 55:59b527ab3452 310
Azure.IoT.Build 54:6dcad9019a64 311 USER_CALLBACK_INFO queue_cb_info;
Azure.IoT.Build 54:6dcad9019a64 312 queue_cb_info.type = CALLBACK_TYPE_DEVICE_TWIN;
Azure.IoT.Build 54:6dcad9019a64 313 queue_cb_info.userContextCallback = queue_context->userContextCallback;
Azure.IoT.Build 54:6dcad9019a64 314 queue_cb_info.iothub_callback.dev_twin_cb_info.update_state = update_state;
Azure.IoT.Build 54:6dcad9019a64 315 if (payLoad == NULL)
Azure.IoT.Build 54:6dcad9019a64 316 {
Azure.IoT.Build 54:6dcad9019a64 317 queue_cb_info.iothub_callback.dev_twin_cb_info.payLoad = NULL;
Azure.IoT.Build 54:6dcad9019a64 318 queue_cb_info.iothub_callback.dev_twin_cb_info.size = 0;
AzureIoTClient 55:59b527ab3452 319 push_to_vector = 0;
Azure.IoT.Build 54:6dcad9019a64 320 }
Azure.IoT.Build 54:6dcad9019a64 321 else
Azure.IoT.Build 54:6dcad9019a64 322 {
Azure.IoT.Build 54:6dcad9019a64 323 queue_cb_info.iothub_callback.dev_twin_cb_info.payLoad = (unsigned char*)malloc(size);
Azure.IoT.Build 54:6dcad9019a64 324 if (queue_cb_info.iothub_callback.dev_twin_cb_info.payLoad == NULL)
Azure.IoT.Build 54:6dcad9019a64 325 {
Azure.IoT.Build 54:6dcad9019a64 326 LogError("failure allocating payload in device twin callback.");
Azure.IoT.Build 54:6dcad9019a64 327 queue_cb_info.iothub_callback.dev_twin_cb_info.size = 0;
AzureIoTClient 60:41648c4e7036 328 push_to_vector = __FAILURE__;
Azure.IoT.Build 54:6dcad9019a64 329 }
Azure.IoT.Build 54:6dcad9019a64 330 else
Azure.IoT.Build 54:6dcad9019a64 331 {
AzureIoTClient 55:59b527ab3452 332 (void)memcpy(queue_cb_info.iothub_callback.dev_twin_cb_info.payLoad, payLoad, size);
Azure.IoT.Build 54:6dcad9019a64 333 queue_cb_info.iothub_callback.dev_twin_cb_info.size = size;
AzureIoTClient 55:59b527ab3452 334 push_to_vector = 0;
Azure.IoT.Build 54:6dcad9019a64 335 }
Azure.IoT.Build 54:6dcad9019a64 336 }
AzureIoTClient 55:59b527ab3452 337 if (push_to_vector == 0)
Azure.IoT.Build 54:6dcad9019a64 338 {
AzureIoTClient 55:59b527ab3452 339 if (VECTOR_push_back(queue_context->iotHubClientHandle->saved_user_callback_list, &queue_cb_info, 1) != 0)
AzureIoTClient 55:59b527ab3452 340 {
AzureIoTClient 55:59b527ab3452 341 if (queue_cb_info.iothub_callback.dev_twin_cb_info.payLoad != NULL)
AzureIoTClient 55:59b527ab3452 342 {
AzureIoTClient 55:59b527ab3452 343 free(queue_cb_info.iothub_callback.dev_twin_cb_info.payLoad);
AzureIoTClient 55:59b527ab3452 344 }
AzureIoTClient 55:59b527ab3452 345 LogError("device twin callback userContextCallback vector push failed.");
AzureIoTClient 55:59b527ab3452 346 }
Azure.IoT.Build 54:6dcad9019a64 347 }
Azure.IoT.Build 54:6dcad9019a64 348 }
Azure.IoT.Build 54:6dcad9019a64 349 else
Azure.IoT.Build 54:6dcad9019a64 350 {
Azure.IoT.Build 54:6dcad9019a64 351 LogError("device twin callback userContextCallback NULL");
Azure.IoT.Build 54:6dcad9019a64 352 }
Azure.IoT.Build 54:6dcad9019a64 353 }
Azure.IoT.Build 54:6dcad9019a64 354
AzureIoTClient 61:8b85a4e797cf 355 static void dispatch_user_callbacks(IOTHUB_CLIENT_INSTANCE* iotHubClientInstance, VECTOR_HANDLE call_backs)
Azure.IoT.Build 54:6dcad9019a64 356 {
AzureIoTClient 61:8b85a4e797cf 357 size_t callbacks_length = VECTOR_size(call_backs);
AzureIoTClient 61:8b85a4e797cf 358 size_t index;
AzureIoTClient 61:8b85a4e797cf 359 for (index = 0; index < callbacks_length; index++)
Azure.IoT.Build 54:6dcad9019a64 360 {
AzureIoTClient 61:8b85a4e797cf 361 USER_CALLBACK_INFO* queued_cb = (USER_CALLBACK_INFO*)VECTOR_element(call_backs, index);
AzureIoTClient 61:8b85a4e797cf 362 if (queued_cb == NULL)
AzureIoTClient 61:8b85a4e797cf 363 {
AzureIoTClient 61:8b85a4e797cf 364 LogError("VECTOR_element at index %zd is NULL.", index);
AzureIoTClient 61:8b85a4e797cf 365 }
AzureIoTClient 61:8b85a4e797cf 366 else
Azure.IoT.Build 54:6dcad9019a64 367 {
AzureIoTClient 61:8b85a4e797cf 368 switch (queued_cb->type)
Azure.IoT.Build 54:6dcad9019a64 369 {
AzureIoTClient 61:8b85a4e797cf 370 case CALLBACK_TYPE_DEVICE_TWIN:
AzureIoTClient 61:8b85a4e797cf 371 if (iotHubClientInstance->desired_state_callback)
AzureIoTClient 61:8b85a4e797cf 372 {
AzureIoTClient 61:8b85a4e797cf 373 iotHubClientInstance->desired_state_callback(queued_cb->iothub_callback.dev_twin_cb_info.update_state, queued_cb->iothub_callback.dev_twin_cb_info.payLoad, queued_cb->iothub_callback.dev_twin_cb_info.size, queued_cb->userContextCallback);
AzureIoTClient 61:8b85a4e797cf 374 }
AzureIoTClient 61:8b85a4e797cf 375 if (queued_cb->iothub_callback.dev_twin_cb_info.payLoad)
AzureIoTClient 61:8b85a4e797cf 376 {
AzureIoTClient 61:8b85a4e797cf 377 free(queued_cb->iothub_callback.dev_twin_cb_info.payLoad);
AzureIoTClient 61:8b85a4e797cf 378 }
AzureIoTClient 61:8b85a4e797cf 379 break;
AzureIoTClient 61:8b85a4e797cf 380 case CALLBACK_TYPE_EVENT_CONFIRM:
AzureIoTClient 61:8b85a4e797cf 381 if (iotHubClientInstance->event_confirm_callback)
AzureIoTClient 61:8b85a4e797cf 382 {
AzureIoTClient 61:8b85a4e797cf 383 iotHubClientInstance->event_confirm_callback(queued_cb->iothub_callback.event_confirm_cb_info.confirm_result, queued_cb->userContextCallback);
AzureIoTClient 61:8b85a4e797cf 384 }
AzureIoTClient 61:8b85a4e797cf 385 break;
AzureIoTClient 61:8b85a4e797cf 386 case CALLBACK_TYPE_REPORTED_STATE:
AzureIoTClient 61:8b85a4e797cf 387 if (iotHubClientInstance->reported_state_callback)
AzureIoTClient 61:8b85a4e797cf 388 {
AzureIoTClient 61:8b85a4e797cf 389 iotHubClientInstance->reported_state_callback(queued_cb->iothub_callback.reported_state_cb_info.status_code, queued_cb->userContextCallback);
AzureIoTClient 61:8b85a4e797cf 390 }
AzureIoTClient 61:8b85a4e797cf 391 break;
AzureIoTClient 61:8b85a4e797cf 392 case CALLBACK_TYPE_CONNECTION_STATUS:
AzureIoTClient 61:8b85a4e797cf 393 if (iotHubClientInstance->connection_status_callback)
AzureIoTClient 61:8b85a4e797cf 394 {
AzureIoTClient 61:8b85a4e797cf 395 iotHubClientInstance->connection_status_callback(queued_cb->iothub_callback.connection_status_cb_info.connection_status, queued_cb->iothub_callback.connection_status_cb_info.status_reason, queued_cb->userContextCallback);
AzureIoTClient 61:8b85a4e797cf 396 }
AzureIoTClient 61:8b85a4e797cf 397 break;
AzureIoTClient 61:8b85a4e797cf 398 case CALLBACK_TYPE_DEVICE_METHOD:
AzureIoTClient 61:8b85a4e797cf 399 if (iotHubClientInstance->device_method_callback)
AzureIoTClient 61:8b85a4e797cf 400 {
AzureIoTClient 61:8b85a4e797cf 401 const char* method_name = STRING_c_str(queued_cb->iothub_callback.method_cb_info.method_name);
AzureIoTClient 61:8b85a4e797cf 402 const unsigned char* payload = BUFFER_u_char(queued_cb->iothub_callback.method_cb_info.payload);
AzureIoTClient 61:8b85a4e797cf 403 size_t payload_len = BUFFER_length(queued_cb->iothub_callback.method_cb_info.payload);
AzureIoTClient 61:8b85a4e797cf 404 iotHubClientInstance->device_method_callback(method_name, payload, payload_len, queued_cb->iothub_callback.method_cb_info.method_id, queued_cb->userContextCallback);
AzureIoTClient 61:8b85a4e797cf 405
AzureIoTClient 61:8b85a4e797cf 406 BUFFER_delete(queued_cb->iothub_callback.method_cb_info.payload);
AzureIoTClient 61:8b85a4e797cf 407 STRING_delete(queued_cb->iothub_callback.method_cb_info.method_name);
AzureIoTClient 61:8b85a4e797cf 408 }
AzureIoTClient 61:8b85a4e797cf 409 break;
AzureIoTClient 61:8b85a4e797cf 410 case CALLBACK_TYPE_MESSAGE:
AzureIoTClient 61:8b85a4e797cf 411 if (iotHubClientInstance->message_callback)
AzureIoTClient 61:8b85a4e797cf 412 {
AzureIoTClient 61:8b85a4e797cf 413 IOTHUBMESSAGE_DISPOSITION_RESULT disposition = iotHubClientInstance->message_callback(queued_cb->iothub_callback.message_cb_info->messageHandle, queued_cb->userContextCallback);
AzureIoTClient 61:8b85a4e797cf 414 IOTHUB_CLIENT_HANDLE handle = iotHubClientInstance->message_user_context->iotHubClientHandle;
AzureIoTClient 61:8b85a4e797cf 415
AzureIoTClient 61:8b85a4e797cf 416 if (Lock(handle->LockHandle) == LOCK_OK)
Azure.IoT.Build 54:6dcad9019a64 417 {
AzureIoTClient 61:8b85a4e797cf 418 IOTHUB_CLIENT_RESULT result = IoTHubClient_LL_SendMessageDisposition(handle->IoTHubClientLLHandle, queued_cb->iothub_callback.message_cb_info, disposition);
AzureIoTClient 61:8b85a4e797cf 419 if (result != IOTHUB_CLIENT_OK)
Azure.IoT.Build 54:6dcad9019a64 420 {
AzureIoTClient 61:8b85a4e797cf 421 LogError("IoTHubClient_LL_Send_Message_Disposition failed");
Azure.IoT.Build 54:6dcad9019a64 422 }
AzureIoTClient 61:8b85a4e797cf 423 (void)Unlock(handle->LockHandle);
Azure.IoT.Build 54:6dcad9019a64 424 }
AzureIoTClient 61:8b85a4e797cf 425 else
Azure.IoT.Build 54:6dcad9019a64 426 {
AzureIoTClient 61:8b85a4e797cf 427 LogError("Lock failed");
Azure.IoT.Build 54:6dcad9019a64 428 }
AzureIoTClient 61:8b85a4e797cf 429 }
AzureIoTClient 61:8b85a4e797cf 430 break;
AzureIoTClient 61:8b85a4e797cf 431 default:
AzureIoTClient 61:8b85a4e797cf 432 LogError("Invalid callback type '%s'", ENUM_TO_STRING(USER_CALLBACK_TYPE, queued_cb->type));
AzureIoTClient 61:8b85a4e797cf 433 break;
Azure.IoT.Build 54:6dcad9019a64 434 }
Azure.IoT.Build 54:6dcad9019a64 435 }
Azure.IoT.Build 54:6dcad9019a64 436 }
AzureIoTClient 61:8b85a4e797cf 437 VECTOR_destroy(call_backs);
Azure.IoT.Build 54:6dcad9019a64 438 }
Azure.IoT.Build 54:6dcad9019a64 439
AzureIoTClient 16:deba40344375 440 static int ScheduleWork_Thread(void* threadArgument)
AzureIoTClient 16:deba40344375 441 {
AzureIoTClient 16:deba40344375 442 IOTHUB_CLIENT_INSTANCE* iotHubClientInstance = (IOTHUB_CLIENT_INSTANCE*)threadArgument;
AzureIoTClient 42:448eecc3676e 443
Azure.IoT Build 37:18310e4d888d 444 while (1)
AzureIoTClient 16:deba40344375 445 {
AzureIoTClient 16:deba40344375 446 if (Lock(iotHubClientInstance->LockHandle) == LOCK_OK)
AzureIoTClient 16:deba40344375 447 {
Azure.IoT Build 37:18310e4d888d 448 /*Codes_SRS_IOTHUBCLIENT_01_038: [ The thread shall exit when IoTHubClient_Destroy is called. ]*/
Azure.IoT Build 37:18310e4d888d 449 if (iotHubClientInstance->StopThread)
Azure.IoT Build 37:18310e4d888d 450 {
Azure.IoT Build 37:18310e4d888d 451 (void)Unlock(iotHubClientInstance->LockHandle);
Azure.IoT Build 37:18310e4d888d 452 break; /*gets out of the thread*/
Azure.IoT Build 37:18310e4d888d 453 }
Azure.IoT Build 37:18310e4d888d 454 else
Azure.IoT Build 37:18310e4d888d 455 {
Azure.IoT Build 37:18310e4d888d 456 /* Codes_SRS_IOTHUBCLIENT_01_037: [The thread created by IoTHubClient_SendEvent or IoTHubClient_SetMessageCallback shall call IoTHubClient_LL_DoWork every 1 ms.] */
Azure.IoT Build 37:18310e4d888d 457 /* Codes_SRS_IOTHUBCLIENT_01_039: [All calls to IoTHubClient_LL_DoWork shall be protected by the lock created in IotHubClient_Create.] */
Azure.IoT Build 37:18310e4d888d 458 IoTHubClient_LL_DoWork(iotHubClientInstance->IoTHubClientLLHandle);
AzureIoTClient 42:448eecc3676e 459
AzureIoTClient 44:33dd78697616 460 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 42:448eecc3676e 461 garbageCollectorImpl(iotHubClientInstance);
AzureIoTClient 43:038d8511e817 462 #endif
AzureIoTClient 61:8b85a4e797cf 463 VECTOR_HANDLE call_backs = VECTOR_move(iotHubClientInstance->saved_user_callback_list);
Azure.IoT Build 37:18310e4d888d 464 (void)Unlock(iotHubClientInstance->LockHandle);
AzureIoTClient 61:8b85a4e797cf 465 if (call_backs == NULL)
AzureIoTClient 61:8b85a4e797cf 466 {
AzureIoTClient 61:8b85a4e797cf 467 LogError("VECTOR_move failed");
AzureIoTClient 61:8b85a4e797cf 468 }
AzureIoTClient 61:8b85a4e797cf 469 else
AzureIoTClient 61:8b85a4e797cf 470 {
AzureIoTClient 61:8b85a4e797cf 471 dispatch_user_callbacks(iotHubClientInstance, call_backs);
AzureIoTClient 61:8b85a4e797cf 472 }
Azure.IoT Build 37:18310e4d888d 473 }
AzureIoTClient 16:deba40344375 474 }
Azure.IoT Build 37:18310e4d888d 475 else
Azure.IoT Build 37:18310e4d888d 476 {
Azure.IoT Build 37:18310e4d888d 477 /*Codes_SRS_IOTHUBCLIENT_01_040: [If acquiring the lock fails, IoTHubClient_LL_DoWork shall not be called.]*/
Azure.IoT Build 37:18310e4d888d 478 /*no code, shall retry*/
Azure.IoT Build 37:18310e4d888d 479 }
Azure.IoT Build 37:18310e4d888d 480 (void)ThreadAPI_Sleep(1);
AzureIoTClient 16:deba40344375 481 }
AzureIoTClient 42:448eecc3676e 482
AzureIoTClient 16:deba40344375 483 return 0;
AzureIoTClient 16:deba40344375 484 }
AzureIoTClient 16:deba40344375 485
Azure.IoT Build 37:18310e4d888d 486 static IOTHUB_CLIENT_RESULT StartWorkerThreadIfNeeded(IOTHUB_CLIENT_INSTANCE* iotHubClientInstance)
AzureIoTClient 16:deba40344375 487 {
AzureIoTClient 42:448eecc3676e 488 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 42:448eecc3676e 489 if (iotHubClientInstance->TransportHandle == NULL)
AzureIoTClient 42:448eecc3676e 490 {
AzureIoTClient 42:448eecc3676e 491 if (iotHubClientInstance->ThreadHandle == NULL)
AzureIoTClient 42:448eecc3676e 492 {
AzureIoTClient 42:448eecc3676e 493 iotHubClientInstance->StopThread = 0;
AzureIoTClient 42:448eecc3676e 494 if (ThreadAPI_Create(&iotHubClientInstance->ThreadHandle, ScheduleWork_Thread, iotHubClientInstance) != THREADAPI_OK)
AzureIoTClient 42:448eecc3676e 495 {
AzureIoTClient 61:8b85a4e797cf 496 LogError("ThreadAPI_Create failed");
AzureIoTClient 42:448eecc3676e 497 iotHubClientInstance->ThreadHandle = NULL;
AzureIoTClient 42:448eecc3676e 498 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 42:448eecc3676e 499 }
AzureIoTClient 42:448eecc3676e 500 else
AzureIoTClient 42:448eecc3676e 501 {
AzureIoTClient 42:448eecc3676e 502 result = IOTHUB_CLIENT_OK;
AzureIoTClient 42:448eecc3676e 503 }
AzureIoTClient 42:448eecc3676e 504 }
AzureIoTClient 42:448eecc3676e 505 else
AzureIoTClient 42:448eecc3676e 506 {
AzureIoTClient 42:448eecc3676e 507 result = IOTHUB_CLIENT_OK;
AzureIoTClient 42:448eecc3676e 508 }
AzureIoTClient 42:448eecc3676e 509 }
AzureIoTClient 42:448eecc3676e 510 else
AzureIoTClient 42:448eecc3676e 511 {
AzureIoTClient 42:448eecc3676e 512 /*Codes_SRS_IOTHUBCLIENT_17_012: [ If the transport connection is shared, the thread shall be started by calling IoTHubTransport_StartWorkerThread. ]*/
AzureIoTClient 42:448eecc3676e 513 /*Codes_SRS_IOTHUBCLIENT_17_011: [ If the transport connection is shared, the thread shall be started by calling IoTHubTransport_StartWorkerThread*/
AzureIoTClient 42:448eecc3676e 514 result = IoTHubTransport_StartWorkerThread(iotHubClientInstance->TransportHandle, iotHubClientInstance);
AzureIoTClient 42:448eecc3676e 515 }
AzureIoTClient 42:448eecc3676e 516 return result;
AzureIoTClient 16:deba40344375 517 }
AzureIoTClient 16:deba40344375 518
Azure.IoT.Build 54:6dcad9019a64 519 static IOTHUB_CLIENT_INSTANCE* create_iothub_instance(const IOTHUB_CLIENT_CONFIG* config, TRANSPORT_HANDLE transportHandle, const char* connectionString, IOTHUB_CLIENT_TRANSPORT_PROVIDER protocol)
AzureIoTClient 16:deba40344375 520 {
AzureIoTClient 16:deba40344375 521 IOTHUB_CLIENT_INSTANCE* result = (IOTHUB_CLIENT_INSTANCE*)malloc(sizeof(IOTHUB_CLIENT_INSTANCE));
AzureIoTClient 16:deba40344375 522
AzureIoTClient 16:deba40344375 523 /* Codes_SRS_IOTHUBCLIENT_01_004: [If allocating memory for the new IoTHubClient instance fails, then IoTHubClient_Create shall return NULL.] */
AzureIoTClient 16:deba40344375 524 if (result != NULL)
AzureIoTClient 16:deba40344375 525 {
AzureIoTClient 16:deba40344375 526 /* Codes_SRS_IOTHUBCLIENT_01_029: [IoTHubClient_Create shall create a lock object to be used later for serializing IoTHubClient calls.] */
Azure.IoT.Build 54:6dcad9019a64 527 if ( (result->saved_user_callback_list = VECTOR_create(sizeof(USER_CALLBACK_INFO)) ) == NULL)
AzureIoTClient 16:deba40344375 528 {
Azure.IoT.Build 54:6dcad9019a64 529 LogError("Failed creating VECTOR");
AzureIoTClient 16:deba40344375 530 free(result);
AzureIoTClient 16:deba40344375 531 result = NULL;
AzureIoTClient 16:deba40344375 532 }
AzureIoTClient 16:deba40344375 533 else
AzureIoTClient 16:deba40344375 534 {
AzureIoTClient 44:33dd78697616 535 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 52:1cc3c6d07cad 536 /*Codes_SRS_IOTHUBCLIENT_02_060: [ IoTHubClient_Create shall create a SINGLYLINKEDLIST_HANDLE containing THREAD_HANDLE (created by future calls to IoTHubClient_UploadToBlobAsync). ]*/
AzureIoTClient 52:1cc3c6d07cad 537 if ((result->savedDataToBeCleaned = singlylinkedlist_create()) == NULL)
AzureIoTClient 16:deba40344375 538 {
AzureIoTClient 52:1cc3c6d07cad 539 /*Codes_SRS_IOTHUBCLIENT_02_061: [ If creating the SINGLYLINKEDLIST_HANDLE fails then IoTHubClient_Create shall fail and return NULL. ]*/
AzureIoTClient 52:1cc3c6d07cad 540 LogError("unable to singlylinkedlist_create");
Azure.IoT.Build 54:6dcad9019a64 541 VECTOR_destroy(result->saved_user_callback_list);
AzureIoTClient 16:deba40344375 542 free(result);
AzureIoTClient 16:deba40344375 543 result = NULL;
AzureIoTClient 16:deba40344375 544 }
AzureIoTClient 42:448eecc3676e 545 else
AzureIoTClient 43:038d8511e817 546 #endif
AzureIoTClient 42:448eecc3676e 547 {
Azure.IoT.Build 54:6dcad9019a64 548 result->TransportHandle = transportHandle;
Azure.IoT.Build 54:6dcad9019a64 549 result->created_with_transport_handle = 0;
Azure.IoT.Build 54:6dcad9019a64 550 if (config != NULL)
Azure.IoT.Build 54:6dcad9019a64 551 {
Azure.IoT.Build 54:6dcad9019a64 552 if (transportHandle != NULL)
Azure.IoT.Build 54:6dcad9019a64 553 {
Azure.IoT.Build 54:6dcad9019a64 554 /*Codes_SRS_IOTHUBCLIENT_17_005: [ IoTHubClient_CreateWithTransport shall call IoTHubTransport_GetLock to get the transport lock to be used later for serializing IoTHubClient calls. ]*/
Azure.IoT.Build 54:6dcad9019a64 555 result->LockHandle = IoTHubTransport_GetLock(transportHandle);
Azure.IoT.Build 54:6dcad9019a64 556 if (result->LockHandle == NULL)
Azure.IoT.Build 54:6dcad9019a64 557 {
Azure.IoT.Build 54:6dcad9019a64 558 LogError("unable to IoTHubTransport_GetLock");
Azure.IoT.Build 54:6dcad9019a64 559 result->IoTHubClientLLHandle = NULL;
Azure.IoT.Build 54:6dcad9019a64 560 }
Azure.IoT.Build 54:6dcad9019a64 561 else
Azure.IoT.Build 54:6dcad9019a64 562 {
Azure.IoT.Build 54:6dcad9019a64 563 IOTHUB_CLIENT_DEVICE_CONFIG deviceConfig;
Azure.IoT.Build 54:6dcad9019a64 564 deviceConfig.deviceId = config->deviceId;
Azure.IoT.Build 54:6dcad9019a64 565 deviceConfig.deviceKey = config->deviceKey;
Azure.IoT.Build 54:6dcad9019a64 566 deviceConfig.protocol = config->protocol;
Azure.IoT.Build 54:6dcad9019a64 567 deviceConfig.deviceSasToken = config->deviceSasToken;
Azure.IoT.Build 54:6dcad9019a64 568
Azure.IoT.Build 54:6dcad9019a64 569 /*Codes_SRS_IOTHUBCLIENT_17_003: [ IoTHubClient_CreateWithTransport shall call IoTHubTransport_GetLLTransport on transportHandle to get lower layer transport. ]*/
Azure.IoT.Build 54:6dcad9019a64 570 deviceConfig.transportHandle = IoTHubTransport_GetLLTransport(transportHandle);
Azure.IoT.Build 54:6dcad9019a64 571 if (deviceConfig.transportHandle == NULL)
Azure.IoT.Build 54:6dcad9019a64 572 {
Azure.IoT.Build 54:6dcad9019a64 573 LogError("unable to IoTHubTransport_GetLLTransport");
Azure.IoT.Build 54:6dcad9019a64 574 result->IoTHubClientLLHandle = NULL;
Azure.IoT.Build 54:6dcad9019a64 575 }
Azure.IoT.Build 54:6dcad9019a64 576 else
Azure.IoT.Build 54:6dcad9019a64 577 {
Azure.IoT.Build 54:6dcad9019a64 578 if (Lock(result->LockHandle) != LOCK_OK)
Azure.IoT.Build 54:6dcad9019a64 579 {
Azure.IoT.Build 54:6dcad9019a64 580 LogError("unable to Lock");
Azure.IoT.Build 54:6dcad9019a64 581 result->IoTHubClientLLHandle = NULL;
Azure.IoT.Build 54:6dcad9019a64 582 }
Azure.IoT.Build 54:6dcad9019a64 583 else
Azure.IoT.Build 54:6dcad9019a64 584 {
Azure.IoT.Build 54:6dcad9019a64 585 /*Codes_SRS_IOTHUBCLIENT_17_007: [ IoTHubClient_CreateWithTransport shall instantiate a new IoTHubClient_LL instance by calling IoTHubClient_LL_CreateWithTransport and passing the lower layer transport and config argument. ]*/
Azure.IoT.Build 54:6dcad9019a64 586 result->IoTHubClientLLHandle = IoTHubClient_LL_CreateWithTransport(&deviceConfig);
Azure.IoT.Build 54:6dcad9019a64 587 result->created_with_transport_handle = 1;
Azure.IoT.Build 54:6dcad9019a64 588 if (Unlock(result->LockHandle) != LOCK_OK)
Azure.IoT.Build 54:6dcad9019a64 589 {
Azure.IoT.Build 54:6dcad9019a64 590 LogError("unable to Unlock");
Azure.IoT.Build 54:6dcad9019a64 591 result->IoTHubClientLLHandle = NULL;
Azure.IoT.Build 54:6dcad9019a64 592 }
Azure.IoT.Build 54:6dcad9019a64 593 }
Azure.IoT.Build 54:6dcad9019a64 594 }
Azure.IoT.Build 54:6dcad9019a64 595 }
Azure.IoT.Build 54:6dcad9019a64 596 }
Azure.IoT.Build 54:6dcad9019a64 597 else
Azure.IoT.Build 54:6dcad9019a64 598 {
Azure.IoT.Build 54:6dcad9019a64 599 result->LockHandle = Lock_Init();
Azure.IoT.Build 54:6dcad9019a64 600 if (result->LockHandle == NULL)
Azure.IoT.Build 54:6dcad9019a64 601 {
Azure.IoT.Build 54:6dcad9019a64 602 /* Codes_SRS_IOTHUBCLIENT_01_030: [If creating the lock fails, then IoTHubClient_Create shall return NULL.] */
Azure.IoT.Build 54:6dcad9019a64 603 /* Codes_SRS_IOTHUBCLIENT_01_031: [If IoTHubClient_Create fails, all resources allocated by it shall be freed.] */
Azure.IoT.Build 54:6dcad9019a64 604 LogError("Failure creating Lock object");
Azure.IoT.Build 54:6dcad9019a64 605 result->IoTHubClientLLHandle = NULL;
Azure.IoT.Build 54:6dcad9019a64 606 }
Azure.IoT.Build 54:6dcad9019a64 607 else
Azure.IoT.Build 54:6dcad9019a64 608 {
Azure.IoT.Build 54:6dcad9019a64 609 /* Codes_SRS_IOTHUBCLIENT_01_002: [IoTHubClient_Create shall instantiate a new IoTHubClient_LL instance by calling IoTHubClient_LL_Create and passing the config argument.] */
Azure.IoT.Build 54:6dcad9019a64 610 result->IoTHubClientLLHandle = IoTHubClient_LL_Create(config);
Azure.IoT.Build 54:6dcad9019a64 611 }
Azure.IoT.Build 54:6dcad9019a64 612 }
Azure.IoT.Build 54:6dcad9019a64 613 }
Azure.IoT.Build 54:6dcad9019a64 614 else
Azure.IoT.Build 54:6dcad9019a64 615 {
Azure.IoT.Build 54:6dcad9019a64 616 result->LockHandle = Lock_Init();
Azure.IoT.Build 54:6dcad9019a64 617 if (result->LockHandle == NULL)
Azure.IoT.Build 54:6dcad9019a64 618 {
Azure.IoT.Build 54:6dcad9019a64 619 /* Codes_SRS_IOTHUBCLIENT_01_030: [If creating the lock fails, then IoTHubClient_Create shall return NULL.] */
Azure.IoT.Build 54:6dcad9019a64 620 /* Codes_SRS_IOTHUBCLIENT_01_031: [If IoTHubClient_Create fails, all resources allocated by it shall be freed.] */
Azure.IoT.Build 54:6dcad9019a64 621 LogError("Failure creating Lock object");
Azure.IoT.Build 54:6dcad9019a64 622 result->IoTHubClientLLHandle = NULL;
Azure.IoT.Build 54:6dcad9019a64 623 }
Azure.IoT.Build 54:6dcad9019a64 624 else
Azure.IoT.Build 54:6dcad9019a64 625 {
Azure.IoT.Build 54:6dcad9019a64 626 /* Codes_SRS_IOTHUBCLIENT_12_006: [IoTHubClient_CreateFromConnectionString shall instantiate a new IoTHubClient_LL instance by calling IoTHubClient_LL_CreateFromConnectionString and passing the connectionString] */
Azure.IoT.Build 54:6dcad9019a64 627 result->IoTHubClientLLHandle = IoTHubClient_LL_CreateFromConnectionString(connectionString, protocol);
Azure.IoT.Build 54:6dcad9019a64 628 }
Azure.IoT.Build 54:6dcad9019a64 629 }
Azure.IoT.Build 54:6dcad9019a64 630
AzureIoTClient 42:448eecc3676e 631 if (result->IoTHubClientLLHandle == NULL)
AzureIoTClient 42:448eecc3676e 632 {
AzureIoTClient 42:448eecc3676e 633 /* Codes_SRS_IOTHUBCLIENT_01_003: [If IoTHubClient_LL_Create fails, then IoTHubClient_Create shall return NULL.] */
AzureIoTClient 42:448eecc3676e 634 /* Codes_SRS_IOTHUBCLIENT_01_031: [If IoTHubClient_Create fails, all resources allocated by it shall be freed.] */
Azure.IoT.Build 54:6dcad9019a64 635 /* Codes_SRS_IOTHUBCLIENT_17_006: [ If IoTHubTransport_GetLock fails, then IoTHubClient_CreateWithTransport shall return NULL. ]*/
Azure.IoT.Build 54:6dcad9019a64 636 if (transportHandle == NULL)
Azure.IoT.Build 54:6dcad9019a64 637 {
Azure.IoT.Build 54:6dcad9019a64 638 Lock_Deinit(result->LockHandle);
Azure.IoT.Build 54:6dcad9019a64 639 }
AzureIoTClient 44:33dd78697616 640 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 52:1cc3c6d07cad 641 singlylinkedlist_destroy(result->savedDataToBeCleaned);
AzureIoTClient 43:038d8511e817 642 #endif
Azure.IoT.Build 54:6dcad9019a64 643 LogError("Failure creating iothub handle");
Azure.IoT.Build 54:6dcad9019a64 644 VECTOR_destroy(result->saved_user_callback_list);
AzureIoTClient 42:448eecc3676e 645 free(result);
AzureIoTClient 42:448eecc3676e 646 result = NULL;
AzureIoTClient 42:448eecc3676e 647 }
AzureIoTClient 42:448eecc3676e 648 else
AzureIoTClient 42:448eecc3676e 649 {
AzureIoTClient 42:448eecc3676e 650 result->ThreadHandle = NULL;
Azure.IoT.Build 54:6dcad9019a64 651 result->desired_state_callback = NULL;
Azure.IoT.Build 54:6dcad9019a64 652 result->event_confirm_callback = NULL;
Azure.IoT.Build 54:6dcad9019a64 653 result->reported_state_callback = NULL;
Azure.IoT.Build 54:6dcad9019a64 654 result->devicetwin_user_context = NULL;
AzureIoTClient 55:59b527ab3452 655 result->connection_status_callback = NULL;
AzureIoTClient 55:59b527ab3452 656 result->connection_status_user_context = NULL;
AzureIoTClient 61:8b85a4e797cf 657 result->message_callback = NULL;
AzureIoTClient 61:8b85a4e797cf 658 result->message_user_context = NULL;
AzureIoTClient 42:448eecc3676e 659 }
AzureIoTClient 42:448eecc3676e 660 }
AzureIoTClient 16:deba40344375 661 }
AzureIoTClient 16:deba40344375 662 }
Azure.IoT.Build 54:6dcad9019a64 663 return result;
Azure.IoT.Build 54:6dcad9019a64 664 }
AzureIoTClient 16:deba40344375 665
Azure.IoT.Build 54:6dcad9019a64 666 IOTHUB_CLIENT_HANDLE IoTHubClient_CreateFromConnectionString(const char* connectionString, IOTHUB_CLIENT_TRANSPORT_PROVIDER protocol)
Azure.IoT.Build 54:6dcad9019a64 667 {
Azure.IoT.Build 54:6dcad9019a64 668 IOTHUB_CLIENT_INSTANCE* result;
Azure.IoT.Build 54:6dcad9019a64 669
Azure.IoT.Build 54:6dcad9019a64 670 /* Codes_SRS_IOTHUBCLIENT_12_003: [IoTHubClient_CreateFromConnectionString shall verify all input parameters and if any is NULL then return NULL] */
Azure.IoT.Build 54:6dcad9019a64 671 if (connectionString == NULL)
Azure.IoT.Build 54:6dcad9019a64 672 {
Azure.IoT.Build 54:6dcad9019a64 673 LogError("Input parameter is NULL: connectionString");
Azure.IoT.Build 54:6dcad9019a64 674 result = NULL;
Azure.IoT.Build 54:6dcad9019a64 675 }
Azure.IoT.Build 54:6dcad9019a64 676 else if (protocol == NULL)
Azure.IoT.Build 54:6dcad9019a64 677 {
Azure.IoT.Build 54:6dcad9019a64 678 LogError("Input parameter is NULL: protocol");
Azure.IoT.Build 54:6dcad9019a64 679 result = NULL;
Azure.IoT.Build 54:6dcad9019a64 680 }
Azure.IoT.Build 54:6dcad9019a64 681 else
Azure.IoT.Build 54:6dcad9019a64 682 {
Azure.IoT.Build 54:6dcad9019a64 683 result = create_iothub_instance(NULL, NULL, connectionString, protocol);
Azure.IoT.Build 54:6dcad9019a64 684 }
Azure.IoT.Build 54:6dcad9019a64 685 return result;
Azure.IoT.Build 54:6dcad9019a64 686 }
Azure.IoT.Build 54:6dcad9019a64 687
Azure.IoT.Build 54:6dcad9019a64 688 IOTHUB_CLIENT_HANDLE IoTHubClient_Create(const IOTHUB_CLIENT_CONFIG* config)
Azure.IoT.Build 54:6dcad9019a64 689 {
Azure.IoT.Build 54:6dcad9019a64 690 IOTHUB_CLIENT_INSTANCE* result;
Azure.IoT.Build 54:6dcad9019a64 691 if (config == NULL)
Azure.IoT.Build 54:6dcad9019a64 692 {
Azure.IoT.Build 54:6dcad9019a64 693 LogError("Input parameter is NULL: IOTHUB_CLIENT_CONFIG");
Azure.IoT.Build 54:6dcad9019a64 694 result = NULL;
Azure.IoT.Build 54:6dcad9019a64 695 }
Azure.IoT.Build 54:6dcad9019a64 696 else
Azure.IoT.Build 54:6dcad9019a64 697 {
Azure.IoT.Build 54:6dcad9019a64 698 result = create_iothub_instance(config, NULL, NULL, NULL);
Azure.IoT.Build 54:6dcad9019a64 699 }
AzureIoTClient 16:deba40344375 700 return result;
AzureIoTClient 16:deba40344375 701 }
AzureIoTClient 16:deba40344375 702
Azure.IoT Build 37:18310e4d888d 703 IOTHUB_CLIENT_HANDLE IoTHubClient_CreateWithTransport(TRANSPORT_HANDLE transportHandle, const IOTHUB_CLIENT_CONFIG* config)
Azure.IoT Build 37:18310e4d888d 704 {
AzureIoTClient 42:448eecc3676e 705 IOTHUB_CLIENT_INSTANCE* result;
AzureIoTClient 42:448eecc3676e 706 /*Codes_SRS_IOTHUBCLIENT_17_013: [ IoTHubClient_CreateWithTransport shall return NULL if transportHandle is NULL. ]*/
AzureIoTClient 42:448eecc3676e 707 /*Codes_SRS_IOTHUBCLIENT_17_014: [ IoTHubClient_CreateWithTransport shall return NULL if config is NULL. ]*/
AzureIoTClient 42:448eecc3676e 708 if (transportHandle == NULL || config == NULL)
AzureIoTClient 42:448eecc3676e 709 {
AzureIoTClient 43:038d8511e817 710 LogError("invalid parameter TRANSPORT_HANDLE transportHandle=%p, const IOTHUB_CLIENT_CONFIG* config=%p", transportHandle, config);
AzureIoTClient 42:448eecc3676e 711 result = NULL;
AzureIoTClient 42:448eecc3676e 712 }
AzureIoTClient 42:448eecc3676e 713 else
AzureIoTClient 42:448eecc3676e 714 {
Azure.IoT.Build 54:6dcad9019a64 715 result = create_iothub_instance(config, transportHandle, NULL, NULL);
AzureIoTClient 42:448eecc3676e 716 }
AzureIoTClient 42:448eecc3676e 717 return result;
Azure.IoT Build 37:18310e4d888d 718 }
Azure.IoT Build 37:18310e4d888d 719
AzureIoTClient 16:deba40344375 720 /* Codes_SRS_IOTHUBCLIENT_01_005: [IoTHubClient_Destroy shall free all resources associated with the iotHubClientHandle instance.] */
AzureIoTClient 18:1e9adb15c645 721 void IoTHubClient_Destroy(IOTHUB_CLIENT_HANDLE iotHubClientHandle)
AzureIoTClient 16:deba40344375 722 {
AzureIoTClient 16:deba40344375 723 /* Codes_SRS_IOTHUBCLIENT_01_008: [IoTHubClient_Destroy shall do nothing if parameter iotHubClientHandle is NULL.] */
AzureIoTClient 16:deba40344375 724 if (iotHubClientHandle != NULL)
AzureIoTClient 16:deba40344375 725 {
AzureIoTClient 42:448eecc3676e 726 bool okToJoin;
AzureIoTClient 55:59b527ab3452 727 size_t vector_size;
Azure.IoT Build 37:18310e4d888d 728
AzureIoTClient 16:deba40344375 729 IOTHUB_CLIENT_INSTANCE* iotHubClientInstance = (IOTHUB_CLIENT_INSTANCE*)iotHubClientHandle;
AzureIoTClient 16:deba40344375 730
AzureIoTClient 42:448eecc3676e 731 /*Codes_SRS_IOTHUBCLIENT_02_043: [ IoTHubClient_Destroy shall lock the serializing lock and signal the worker thread (if any) to end ]*/
AzureIoTClient 42:448eecc3676e 732 if (Lock(iotHubClientInstance->LockHandle) != LOCK_OK)
AzureIoTClient 42:448eecc3676e 733 {
AzureIoTClient 42:448eecc3676e 734 LogError("unable to Lock - - will still proceed to try to end the thread without locking");
AzureIoTClient 42:448eecc3676e 735 }
AzureIoTClient 42:448eecc3676e 736
AzureIoTClient 44:33dd78697616 737 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 42:448eecc3676e 738 /*Codes_SRS_IOTHUBCLIENT_02_069: [ IoTHubClient_Destroy shall free all data created by IoTHubClient_UploadToBlobAsync ]*/
AzureIoTClient 42:448eecc3676e 739 /*wait for all uploading threads to finish*/
AzureIoTClient 52:1cc3c6d07cad 740 while (singlylinkedlist_get_head_item(iotHubClientInstance->savedDataToBeCleaned) != NULL)
AzureIoTClient 42:448eecc3676e 741 {
AzureIoTClient 42:448eecc3676e 742 garbageCollectorImpl(iotHubClientInstance);
AzureIoTClient 42:448eecc3676e 743 }
AzureIoTClient 43:038d8511e817 744 #endif
AzureIoTClient 16:deba40344375 745 if (iotHubClientInstance->ThreadHandle != NULL)
AzureIoTClient 16:deba40344375 746 {
AzureIoTClient 42:448eecc3676e 747 iotHubClientInstance->StopThread = 1;
AzureIoTClient 42:448eecc3676e 748 okToJoin = true;
AzureIoTClient 42:448eecc3676e 749 }
AzureIoTClient 42:448eecc3676e 750 else
AzureIoTClient 42:448eecc3676e 751 {
AzureIoTClient 42:448eecc3676e 752 okToJoin = false;
AzureIoTClient 16:deba40344375 753 }
Azure.IoT Build 37:18310e4d888d 754
AzureIoTClient 42:448eecc3676e 755 if (iotHubClientInstance->TransportHandle != NULL)
AzureIoTClient 42:448eecc3676e 756 {
AzureIoTClient 42:448eecc3676e 757 /*Codes_SRS_IOTHUBCLIENT_01_007: [ The thread created as part of executing IoTHubClient_SendEventAsync or IoTHubClient_SetNotificationMessageCallback shall be joined. ]*/
AzureIoTClient 42:448eecc3676e 758 okToJoin = IoTHubTransport_SignalEndWorkerThread(iotHubClientInstance->TransportHandle, iotHubClientHandle);
AzureIoTClient 42:448eecc3676e 759 }
AzureIoTClient 16:deba40344375 760
AzureIoTClient 16:deba40344375 761 /* Codes_SRS_IOTHUBCLIENT_01_006: [That includes destroying the IoTHubClient_LL instance by calling IoTHubClient_LL_Destroy.] */
AzureIoTClient 16:deba40344375 762 IoTHubClient_LL_Destroy(iotHubClientInstance->IoTHubClientLLHandle);
AzureIoTClient 16:deba40344375 763
AzureIoTClient 44:33dd78697616 764 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 43:038d8511e817 765 if (iotHubClientInstance->savedDataToBeCleaned != NULL)
AzureIoTClient 43:038d8511e817 766 {
AzureIoTClient 52:1cc3c6d07cad 767 singlylinkedlist_destroy(iotHubClientInstance->savedDataToBeCleaned);
AzureIoTClient 43:038d8511e817 768 }
AzureIoTClient 43:038d8511e817 769 #endif
AzureIoTClient 43:038d8511e817 770
AzureIoTClient 42:448eecc3676e 771 /*Codes_SRS_IOTHUBCLIENT_02_045: [ IoTHubClient_Destroy shall unlock the serializing lock. ]*/
AzureIoTClient 42:448eecc3676e 772 if (Unlock(iotHubClientInstance->LockHandle) != LOCK_OK)
AzureIoTClient 42:448eecc3676e 773 {
AzureIoTClient 42:448eecc3676e 774 LogError("unable to Unlock");
AzureIoTClient 42:448eecc3676e 775 }
Azure.IoT Build 37:18310e4d888d 776
AzureIoTClient 42:448eecc3676e 777 if (okToJoin == true)
AzureIoTClient 42:448eecc3676e 778 {
AzureIoTClient 42:448eecc3676e 779 if (iotHubClientInstance->ThreadHandle != NULL)
AzureIoTClient 42:448eecc3676e 780 {
AzureIoTClient 42:448eecc3676e 781 int res;
AzureIoTClient 42:448eecc3676e 782 /*Codes_SRS_IOTHUBCLIENT_01_007: [ The thread created as part of executing IoTHubClient_SendEventAsync or IoTHubClient_SetNotificationMessageCallback shall be joined. ]*/
AzureIoTClient 42:448eecc3676e 783 if (ThreadAPI_Join(iotHubClientInstance->ThreadHandle, &res) != THREADAPI_OK)
AzureIoTClient 42:448eecc3676e 784 {
AzureIoTClient 42:448eecc3676e 785 LogError("ThreadAPI_Join failed");
AzureIoTClient 42:448eecc3676e 786 }
AzureIoTClient 42:448eecc3676e 787 }
Azure.IoT.Build 54:6dcad9019a64 788
AzureIoTClient 42:448eecc3676e 789 if (iotHubClientInstance->TransportHandle != NULL)
AzureIoTClient 42:448eecc3676e 790 {
AzureIoTClient 42:448eecc3676e 791 /*Codes_SRS_IOTHUBCLIENT_01_007: [ The thread created as part of executing IoTHubClient_SendEventAsync or IoTHubClient_SetNotificationMessageCallback shall be joined. ]*/
AzureIoTClient 42:448eecc3676e 792 IoTHubTransport_JoinWorkerThread(iotHubClientInstance->TransportHandle, iotHubClientHandle);
AzureIoTClient 42:448eecc3676e 793 }
AzureIoTClient 42:448eecc3676e 794 }
AzureIoTClient 42:448eecc3676e 795
AzureIoTClient 55:59b527ab3452 796 vector_size = VECTOR_size(iotHubClientInstance->saved_user_callback_list);
AzureIoTClient 57:4524910c6445 797 size_t index = 0;
AzureIoTClient 57:4524910c6445 798 for (index = 0; index < vector_size; index++)
AzureIoTClient 55:59b527ab3452 799 {
AzureIoTClient 55:59b527ab3452 800 USER_CALLBACK_INFO* queue_cb_info = (USER_CALLBACK_INFO*)VECTOR_element(iotHubClientInstance->saved_user_callback_list, index);
AzureIoTClient 55:59b527ab3452 801 if (queue_cb_info != NULL)
AzureIoTClient 55:59b527ab3452 802 {
AzureIoTClient 55:59b527ab3452 803 if (queue_cb_info->type == CALLBACK_TYPE_DEVICE_METHOD)
AzureIoTClient 55:59b527ab3452 804 {
AzureIoTClient 55:59b527ab3452 805 STRING_delete(queue_cb_info->iothub_callback.method_cb_info.method_name);
AzureIoTClient 55:59b527ab3452 806 BUFFER_delete(queue_cb_info->iothub_callback.method_cb_info.payload);
AzureIoTClient 55:59b527ab3452 807 }
AzureIoTClient 55:59b527ab3452 808 else if (queue_cb_info->type == CALLBACK_TYPE_DEVICE_TWIN)
AzureIoTClient 55:59b527ab3452 809 {
AzureIoTClient 55:59b527ab3452 810 if (queue_cb_info->iothub_callback.dev_twin_cb_info.payLoad != NULL)
AzureIoTClient 55:59b527ab3452 811 {
AzureIoTClient 55:59b527ab3452 812 free(queue_cb_info->iothub_callback.dev_twin_cb_info.payLoad);
AzureIoTClient 55:59b527ab3452 813 }
AzureIoTClient 55:59b527ab3452 814 }
AzureIoTClient 59:7e89be231352 815 else if (queue_cb_info->type == CALLBACK_TYPE_EVENT_CONFIRM)
AzureIoTClient 59:7e89be231352 816 {
AzureIoTClient 59:7e89be231352 817 if (iotHubClientInstance->event_confirm_callback)
AzureIoTClient 59:7e89be231352 818 {
AzureIoTClient 59:7e89be231352 819 iotHubClientInstance->event_confirm_callback(queue_cb_info->iothub_callback.event_confirm_cb_info.confirm_result, queue_cb_info->userContextCallback);
AzureIoTClient 59:7e89be231352 820 }
AzureIoTClient 59:7e89be231352 821 }
AzureIoTClient 55:59b527ab3452 822 }
AzureIoTClient 55:59b527ab3452 823 }
Azure.IoT.Build 54:6dcad9019a64 824 VECTOR_destroy(iotHubClientInstance->saved_user_callback_list);
Azure.IoT.Build 54:6dcad9019a64 825
AzureIoTClient 42:448eecc3676e 826 if (iotHubClientInstance->TransportHandle == NULL)
AzureIoTClient 42:448eecc3676e 827 {
AzureIoTClient 42:448eecc3676e 828 /* Codes_SRS_IOTHUBCLIENT_01_032: [If the lock was allocated in IoTHubClient_Create, it shall be also freed..] */
AzureIoTClient 42:448eecc3676e 829 Lock_Deinit(iotHubClientInstance->LockHandle);
AzureIoTClient 42:448eecc3676e 830 }
Azure.IoT.Build 54:6dcad9019a64 831 if (iotHubClientInstance->devicetwin_user_context != NULL)
Azure.IoT.Build 54:6dcad9019a64 832 {
Azure.IoT.Build 54:6dcad9019a64 833 free(iotHubClientInstance->devicetwin_user_context);
Azure.IoT.Build 54:6dcad9019a64 834 }
AzureIoTClient 55:59b527ab3452 835 if (iotHubClientInstance->connection_status_user_context != NULL)
AzureIoTClient 55:59b527ab3452 836 {
AzureIoTClient 55:59b527ab3452 837 free(iotHubClientInstance->connection_status_user_context);
AzureIoTClient 55:59b527ab3452 838 }
AzureIoTClient 61:8b85a4e797cf 839 if (iotHubClientInstance->message_user_context != NULL)
AzureIoTClient 61:8b85a4e797cf 840 {
AzureIoTClient 61:8b85a4e797cf 841 free(iotHubClientInstance->message_user_context);
AzureIoTClient 61:8b85a4e797cf 842 }
AzureIoTClient 16:deba40344375 843 free(iotHubClientInstance);
AzureIoTClient 16:deba40344375 844 }
AzureIoTClient 16:deba40344375 845 }
AzureIoTClient 16:deba40344375 846
AzureIoTClient 16:deba40344375 847 IOTHUB_CLIENT_RESULT IoTHubClient_SendEventAsync(IOTHUB_CLIENT_HANDLE iotHubClientHandle, IOTHUB_MESSAGE_HANDLE eventMessageHandle, IOTHUB_CLIENT_EVENT_CONFIRMATION_CALLBACK eventConfirmationCallback, void* userContextCallback)
AzureIoTClient 16:deba40344375 848 {
AzureIoTClient 16:deba40344375 849 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 16:deba40344375 850
AzureIoTClient 16:deba40344375 851 if (iotHubClientHandle == NULL)
AzureIoTClient 16:deba40344375 852 {
AzureIoTClient 16:deba40344375 853 /* Codes_SRS_IOTHUBCLIENT_01_011: [If iotHubClientHandle is NULL, IoTHubClient_SendEventAsync shall return IOTHUB_CLIENT_INVALID_ARG.] */
AzureIoTClient 16:deba40344375 854 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 39:2719651a5bee 855 LogError("NULL iothubClientHandle");
AzureIoTClient 16:deba40344375 856 }
AzureIoTClient 16:deba40344375 857 else
AzureIoTClient 16:deba40344375 858 {
AzureIoTClient 16:deba40344375 859 IOTHUB_CLIENT_INSTANCE* iotHubClientInstance = (IOTHUB_CLIENT_INSTANCE*)iotHubClientHandle;
AzureIoTClient 16:deba40344375 860
AzureIoTClient 16:deba40344375 861 /* Codes_SRS_IOTHUBCLIENT_01_025: [IoTHubClient_SendEventAsync shall be made thread-safe by using the lock created in IoTHubClient_Create.] */
AzureIoTClient 16:deba40344375 862 if (Lock(iotHubClientInstance->LockHandle) != LOCK_OK)
AzureIoTClient 16:deba40344375 863 {
AzureIoTClient 16:deba40344375 864 /* Codes_SRS_IOTHUBCLIENT_01_026: [If acquiring the lock fails, IoTHubClient_SendEventAsync shall return IOTHUB_CLIENT_ERROR.] */
AzureIoTClient 16:deba40344375 865 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 39:2719651a5bee 866 LogError("Could not acquire lock");
AzureIoTClient 16:deba40344375 867 }
AzureIoTClient 16:deba40344375 868 else
AzureIoTClient 16:deba40344375 869 {
Azure.IoT.Build 54:6dcad9019a64 870 if (iotHubClientInstance->created_with_transport_handle == 0)
Azure.IoT.Build 54:6dcad9019a64 871 {
Azure.IoT.Build 54:6dcad9019a64 872 iotHubClientInstance->event_confirm_callback = eventConfirmationCallback;
Azure.IoT.Build 54:6dcad9019a64 873 }
AzureIoTClient 16:deba40344375 874 /* Codes_SRS_IOTHUBCLIENT_01_009: [IoTHubClient_SendEventAsync shall start the worker thread if it was not previously started.] */
Azure.IoT Build 37:18310e4d888d 875 if ((result = StartWorkerThreadIfNeeded(iotHubClientInstance)) != IOTHUB_CLIENT_OK)
AzureIoTClient 16:deba40344375 876 {
AzureIoTClient 16:deba40344375 877 /* Codes_SRS_IOTHUBCLIENT_01_010: [If starting the thread fails, IoTHubClient_SendEventAsync shall return IOTHUB_CLIENT_ERROR.] */
AzureIoTClient 16:deba40344375 878 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 39:2719651a5bee 879 LogError("Could not start worker thread");
AzureIoTClient 16:deba40344375 880 }
AzureIoTClient 16:deba40344375 881 else
AzureIoTClient 16:deba40344375 882 {
Azure.IoT.Build 54:6dcad9019a64 883 if (iotHubClientInstance->created_with_transport_handle != 0 || eventConfirmationCallback == NULL)
Azure.IoT.Build 54:6dcad9019a64 884 {
Azure.IoT.Build 54:6dcad9019a64 885 result = IoTHubClient_LL_SendEventAsync(iotHubClientInstance->IoTHubClientLLHandle, eventMessageHandle, eventConfirmationCallback, userContextCallback);
Azure.IoT.Build 54:6dcad9019a64 886 }
Azure.IoT.Build 54:6dcad9019a64 887 else
Azure.IoT.Build 54:6dcad9019a64 888 {
Azure.IoT.Build 54:6dcad9019a64 889 /* Codes_SRS_IOTHUBCLIENT_07_001: [ IoTHubClient_SendEventAsync shall allocate a IOTHUB_QUEUE_CONTEXT object to be sent to the IoTHubClient_LL_SendEventAsync function as a user context. ] */
Azure.IoT.Build 54:6dcad9019a64 890 IOTHUB_QUEUE_CONTEXT* queue_context = (IOTHUB_QUEUE_CONTEXT*)malloc(sizeof(IOTHUB_QUEUE_CONTEXT));
Azure.IoT.Build 54:6dcad9019a64 891 if (queue_context == NULL)
Azure.IoT.Build 54:6dcad9019a64 892 {
Azure.IoT.Build 54:6dcad9019a64 893 result = IOTHUB_CLIENT_ERROR;
Azure.IoT.Build 54:6dcad9019a64 894 LogError("Failed allocating QUEUE_CONTEXT");
Azure.IoT.Build 54:6dcad9019a64 895 }
Azure.IoT.Build 54:6dcad9019a64 896 else
Azure.IoT.Build 54:6dcad9019a64 897 {
Azure.IoT.Build 54:6dcad9019a64 898 queue_context->iotHubClientHandle = iotHubClientInstance;
Azure.IoT.Build 54:6dcad9019a64 899 queue_context->userContextCallback = userContextCallback;
Azure.IoT.Build 54:6dcad9019a64 900 /* Codes_SRS_IOTHUBCLIENT_01_012: [IoTHubClient_SendEventAsync shall call IoTHubClient_LL_SendEventAsync, while passing the IoTHubClient_LL handle created by IoTHubClient_Create and the parameters eventMessageHandle, eventConfirmationCallback and userContextCallback.] */
Azure.IoT.Build 54:6dcad9019a64 901 /* Codes_SRS_IOTHUBCLIENT_01_013: [When IoTHubClient_LL_SendEventAsync is called, IoTHubClient_SendEventAsync shall return the result of IoTHubClient_LL_SendEventAsync.] */
Azure.IoT.Build 54:6dcad9019a64 902 result = IoTHubClient_LL_SendEventAsync(iotHubClientInstance->IoTHubClientLLHandle, eventMessageHandle, iothub_ll_event_confirm_callback, queue_context);
Azure.IoT.Build 54:6dcad9019a64 903 if (result != IOTHUB_CLIENT_OK)
Azure.IoT.Build 54:6dcad9019a64 904 {
Azure.IoT.Build 54:6dcad9019a64 905 LogError("IoTHubClient_LL_SendEventAsync failed");
Azure.IoT.Build 54:6dcad9019a64 906 free(queue_context);
Azure.IoT.Build 54:6dcad9019a64 907 }
Azure.IoT.Build 54:6dcad9019a64 908 }
Azure.IoT.Build 54:6dcad9019a64 909 }
AzureIoTClient 16:deba40344375 910 }
AzureIoTClient 16:deba40344375 911
AzureIoTClient 16:deba40344375 912 /* Codes_SRS_IOTHUBCLIENT_01_025: [IoTHubClient_SendEventAsync shall be made thread-safe by using the lock created in IoTHubClient_Create.] */
AzureIoTClient 16:deba40344375 913 (void)Unlock(iotHubClientInstance->LockHandle);
AzureIoTClient 16:deba40344375 914 }
AzureIoTClient 16:deba40344375 915 }
AzureIoTClient 16:deba40344375 916
AzureIoTClient 16:deba40344375 917 return result;
AzureIoTClient 16:deba40344375 918 }
AzureIoTClient 16:deba40344375 919
AzureIoTClient 16:deba40344375 920 IOTHUB_CLIENT_RESULT IoTHubClient_GetSendStatus(IOTHUB_CLIENT_HANDLE iotHubClientHandle, IOTHUB_CLIENT_STATUS *iotHubClientStatus)
AzureIoTClient 16:deba40344375 921 {
AzureIoTClient 16:deba40344375 922 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 16:deba40344375 923
AzureIoTClient 16:deba40344375 924 if (iotHubClientHandle == NULL)
AzureIoTClient 16:deba40344375 925 {
AzureIoTClient 16:deba40344375 926 /* Codes_SRS_IOTHUBCLIENT_01_023: [If iotHubClientHandle is NULL, IoTHubClient_ GetSendStatus shall return IOTHUB_CLIENT_INVALID_ARG.] */
AzureIoTClient 16:deba40344375 927 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 39:2719651a5bee 928 LogError("NULL iothubClientHandle");
AzureIoTClient 16:deba40344375 929 }
AzureIoTClient 16:deba40344375 930 else
AzureIoTClient 16:deba40344375 931 {
AzureIoTClient 16:deba40344375 932 IOTHUB_CLIENT_INSTANCE* iotHubClientInstance = (IOTHUB_CLIENT_INSTANCE*)iotHubClientHandle;
AzureIoTClient 16:deba40344375 933
AzureIoTClient 16:deba40344375 934 /* Codes_SRS_IOTHUBCLIENT_01_033: [IoTHubClient_GetSendStatus shall be made thread-safe by using the lock created in IoTHubClient_Create.] */
AzureIoTClient 16:deba40344375 935 if (Lock(iotHubClientInstance->LockHandle) != LOCK_OK)
AzureIoTClient 16:deba40344375 936 {
AzureIoTClient 16:deba40344375 937 /* Codes_SRS_IOTHUBCLIENT_01_034: [If acquiring the lock fails, IoTHubClient_GetSendStatus shall return IOTHUB_CLIENT_ERROR.] */
AzureIoTClient 16:deba40344375 938 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 39:2719651a5bee 939 LogError("Could not acquire lock");
AzureIoTClient 16:deba40344375 940 }
AzureIoTClient 16:deba40344375 941 else
AzureIoTClient 16:deba40344375 942 {
AzureIoTClient 16:deba40344375 943 /* Codes_SRS_IOTHUBCLIENT_01_022: [IoTHubClient_GetSendStatus shall call IoTHubClient_LL_GetSendStatus, while passing the IoTHubClient_LL handle created by IoTHubClient_Create and the parameter iotHubClientStatus.] */
AzureIoTClient 16:deba40344375 944 /* Codes_SRS_IOTHUBCLIENT_01_024: [Otherwise, IoTHubClient_GetSendStatus shall return the result of IoTHubClient_LL_GetSendStatus.] */
AzureIoTClient 16:deba40344375 945 result = IoTHubClient_LL_GetSendStatus(iotHubClientInstance->IoTHubClientLLHandle, iotHubClientStatus);
AzureIoTClient 16:deba40344375 946
AzureIoTClient 16:deba40344375 947 /* Codes_SRS_IOTHUBCLIENT_01_033: [IoTHubClient_GetSendStatus shall be made thread-safe by using the lock created in IoTHubClient_Create.] */
AzureIoTClient 16:deba40344375 948 (void)Unlock(iotHubClientInstance->LockHandle);
AzureIoTClient 16:deba40344375 949 }
AzureIoTClient 16:deba40344375 950 }
AzureIoTClient 16:deba40344375 951
AzureIoTClient 16:deba40344375 952 return result;
AzureIoTClient 16:deba40344375 953 }
AzureIoTClient 16:deba40344375 954
AzureIoTClient 16:deba40344375 955 IOTHUB_CLIENT_RESULT IoTHubClient_SetMessageCallback(IOTHUB_CLIENT_HANDLE iotHubClientHandle, IOTHUB_CLIENT_MESSAGE_CALLBACK_ASYNC messageCallback, void* userContextCallback)
AzureIoTClient 16:deba40344375 956 {
AzureIoTClient 16:deba40344375 957 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 16:deba40344375 958
AzureIoTClient 16:deba40344375 959 if (iotHubClientHandle == NULL)
AzureIoTClient 16:deba40344375 960 {
AzureIoTClient 16:deba40344375 961 /* Codes_SRS_IOTHUBCLIENT_01_016: [If iotHubClientHandle is NULL, IoTHubClient_SetMessageCallback shall return IOTHUB_CLIENT_INVALID_ARG.] */
AzureIoTClient 16:deba40344375 962 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 39:2719651a5bee 963 LogError("NULL iothubClientHandle");
AzureIoTClient 16:deba40344375 964 }
AzureIoTClient 16:deba40344375 965 else
AzureIoTClient 16:deba40344375 966 {
AzureIoTClient 16:deba40344375 967 IOTHUB_CLIENT_INSTANCE* iotHubClientInstance = (IOTHUB_CLIENT_INSTANCE*)iotHubClientHandle;
AzureIoTClient 16:deba40344375 968
AzureIoTClient 16:deba40344375 969 /* Codes_SRS_IOTHUBCLIENT_01_027: [IoTHubClient_SetMessageCallback shall be made thread-safe by using the lock created in IoTHubClient_Create.] */
AzureIoTClient 16:deba40344375 970 if (Lock(iotHubClientInstance->LockHandle) != LOCK_OK)
AzureIoTClient 16:deba40344375 971 {
AzureIoTClient 16:deba40344375 972 /* Codes_SRS_IOTHUBCLIENT_01_028: [If acquiring the lock fails, IoTHubClient_SetMessageCallback shall return IOTHUB_CLIENT_ERROR.] */
AzureIoTClient 16:deba40344375 973 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 39:2719651a5bee 974 LogError("Could not acquire lock");
AzureIoTClient 16:deba40344375 975 }
AzureIoTClient 16:deba40344375 976 else
AzureIoTClient 16:deba40344375 977 {
AzureIoTClient 61:8b85a4e797cf 978 if (iotHubClientInstance->created_with_transport_handle == 0)
AzureIoTClient 61:8b85a4e797cf 979 {
AzureIoTClient 61:8b85a4e797cf 980 iotHubClientInstance->message_callback = messageCallback;
AzureIoTClient 61:8b85a4e797cf 981 }
AzureIoTClient 61:8b85a4e797cf 982
AzureIoTClient 16:deba40344375 983 /* Codes_SRS_IOTHUBCLIENT_01_014: [IoTHubClient_SetMessageCallback shall start the worker thread if it was not previously started.] */
Azure.IoT Build 37:18310e4d888d 984 if ((result = StartWorkerThreadIfNeeded(iotHubClientInstance)) != IOTHUB_CLIENT_OK)
AzureIoTClient 16:deba40344375 985 {
AzureIoTClient 16:deba40344375 986 /* Codes_SRS_IOTHUBCLIENT_01_015: [If starting the thread fails, IoTHubClient_SetMessageCallback shall return IOTHUB_CLIENT_ERROR.] */
AzureIoTClient 16:deba40344375 987 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 39:2719651a5bee 988 LogError("Could not start worker thread");
AzureIoTClient 16:deba40344375 989 }
AzureIoTClient 16:deba40344375 990 else
AzureIoTClient 16:deba40344375 991 {
AzureIoTClient 61:8b85a4e797cf 992 if (iotHubClientInstance->message_user_context != NULL)
AzureIoTClient 61:8b85a4e797cf 993 {
AzureIoTClient 61:8b85a4e797cf 994 free(iotHubClientInstance->message_user_context);
AzureIoTClient 61:8b85a4e797cf 995 }
AzureIoTClient 61:8b85a4e797cf 996 if (messageCallback == NULL)
AzureIoTClient 61:8b85a4e797cf 997 {
AzureIoTClient 61:8b85a4e797cf 998 result = IoTHubClient_LL_SetMessageCallbackEx(iotHubClientInstance->IoTHubClientLLHandle, NULL, iotHubClientInstance->message_user_context);
AzureIoTClient 61:8b85a4e797cf 999 }
AzureIoTClient 61:8b85a4e797cf 1000 else if (iotHubClientInstance->created_with_transport_handle != 0)
AzureIoTClient 61:8b85a4e797cf 1001 {
AzureIoTClient 61:8b85a4e797cf 1002 result = IoTHubClient_LL_SetMessageCallback(iotHubClientInstance->IoTHubClientLLHandle, messageCallback, userContextCallback);
AzureIoTClient 61:8b85a4e797cf 1003 }
AzureIoTClient 61:8b85a4e797cf 1004 else
AzureIoTClient 61:8b85a4e797cf 1005 {
AzureIoTClient 61:8b85a4e797cf 1006 iotHubClientInstance->message_user_context = (IOTHUB_QUEUE_CONTEXT*)malloc(sizeof(IOTHUB_QUEUE_CONTEXT));
AzureIoTClient 61:8b85a4e797cf 1007 if (iotHubClientInstance->message_user_context == NULL)
AzureIoTClient 61:8b85a4e797cf 1008 {
AzureIoTClient 61:8b85a4e797cf 1009 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 61:8b85a4e797cf 1010 LogError("Failed allocating QUEUE_CONTEXT");
AzureIoTClient 61:8b85a4e797cf 1011 }
AzureIoTClient 61:8b85a4e797cf 1012 else
AzureIoTClient 61:8b85a4e797cf 1013 {
AzureIoTClient 61:8b85a4e797cf 1014 iotHubClientInstance->message_user_context->iotHubClientHandle = iotHubClientHandle;
AzureIoTClient 61:8b85a4e797cf 1015 iotHubClientInstance->message_user_context->userContextCallback = userContextCallback;
AzureIoTClient 61:8b85a4e797cf 1016
AzureIoTClient 61:8b85a4e797cf 1017 /* Codes_SRS_IOTHUBCLIENT_01_017: [IoTHubClient_SetMessageCallback shall call IoTHubClient_LL_SetMessageCallbackEx, while passing the IoTHubClient_LL handle created by IoTHubClient_Create and the local iothub_ll_message_callback wrapper of messageCallback and userContextCallback.] */
AzureIoTClient 61:8b85a4e797cf 1018 /* Codes_SRS_IOTHUBCLIENT_01_018: [When IoTHubClient_LL_SetMessageCallbackEx is called, IoTHubClient_SetMessageCallback shall return the result of IoTHubClient_LL_SetMessageCallbackEx.] */
AzureIoTClient 61:8b85a4e797cf 1019 result = IoTHubClient_LL_SetMessageCallbackEx(iotHubClientInstance->IoTHubClientLLHandle, iothub_ll_message_callback, iotHubClientInstance->message_user_context);
AzureIoTClient 61:8b85a4e797cf 1020 if (result != IOTHUB_CLIENT_OK)
AzureIoTClient 61:8b85a4e797cf 1021 {
AzureIoTClient 61:8b85a4e797cf 1022 LogError("IoTHubClient_LL_SetMessageCallback failed");
AzureIoTClient 61:8b85a4e797cf 1023 free(iotHubClientInstance->message_user_context);
AzureIoTClient 61:8b85a4e797cf 1024 iotHubClientInstance->message_user_context = NULL;
AzureIoTClient 61:8b85a4e797cf 1025 }
AzureIoTClient 61:8b85a4e797cf 1026 }
AzureIoTClient 61:8b85a4e797cf 1027 }
AzureIoTClient 16:deba40344375 1028 }
AzureIoTClient 16:deba40344375 1029
AzureIoTClient 16:deba40344375 1030 /* Codes_SRS_IOTHUBCLIENT_01_027: [IoTHubClient_SetMessageCallback shall be made thread-safe by using the lock created in IoTHubClient_Create.] */
AzureIoTClient 53:1e5a1ca1f274 1031 (void)Unlock(iotHubClientInstance->LockHandle);
AzureIoTClient 16:deba40344375 1032 }
AzureIoTClient 16:deba40344375 1033 }
AzureIoTClient 16:deba40344375 1034
AzureIoTClient 16:deba40344375 1035 return result;
AzureIoTClient 16:deba40344375 1036 }
AzureIoTClient 16:deba40344375 1037
AzureIoTClient 53:1e5a1ca1f274 1038 IOTHUB_CLIENT_RESULT IoTHubClient_SetConnectionStatusCallback(IOTHUB_CLIENT_HANDLE iotHubClientHandle, IOTHUB_CLIENT_CONNECTION_STATUS_CALLBACK connectionStatusCallback, void * userContextCallback)
AzureIoTClient 52:1cc3c6d07cad 1039 {
AzureIoTClient 53:1e5a1ca1f274 1040 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 53:1e5a1ca1f274 1041
AzureIoTClient 53:1e5a1ca1f274 1042 if (iotHubClientHandle == NULL)
AzureIoTClient 53:1e5a1ca1f274 1043 {
AzureIoTClient 53:1e5a1ca1f274 1044 /* Codes_SRS_IOTHUBCLIENT_25_076: [** If `iotHubClientHandle` is `NULL`, `IoTHubClient_SetRetryPolicy` shall return `IOTHUB_CLIENT_INVALID_ARG`. ] */
AzureIoTClient 53:1e5a1ca1f274 1045 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 53:1e5a1ca1f274 1046 LogError("NULL iothubClientHandle");
AzureIoTClient 53:1e5a1ca1f274 1047 }
AzureIoTClient 53:1e5a1ca1f274 1048 else
AzureIoTClient 53:1e5a1ca1f274 1049 {
AzureIoTClient 53:1e5a1ca1f274 1050 IOTHUB_CLIENT_INSTANCE* iotHubClientInstance = (IOTHUB_CLIENT_INSTANCE*)iotHubClientHandle;
AzureIoTClient 52:1cc3c6d07cad 1051
AzureIoTClient 53:1e5a1ca1f274 1052 /* Codes_SRS_IOTHUBCLIENT_25_087: [ `IoTHubClient_SetConnectionStatusCallback` shall be made thread-safe by using the lock created in `IoTHubClient_Create`. ] */
AzureIoTClient 53:1e5a1ca1f274 1053 if (Lock(iotHubClientInstance->LockHandle) != LOCK_OK)
AzureIoTClient 53:1e5a1ca1f274 1054 {
AzureIoTClient 53:1e5a1ca1f274 1055 /* Codes_SRS_IOTHUBCLIENT_25_088: [ If acquiring the lock fails, `IoTHubClient_SetConnectionStatusCallback` shall return `IOTHUB_CLIENT_ERROR`. ]*/
AzureIoTClient 53:1e5a1ca1f274 1056 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 53:1e5a1ca1f274 1057 LogError("Could not acquire lock");
AzureIoTClient 53:1e5a1ca1f274 1058 }
AzureIoTClient 53:1e5a1ca1f274 1059 else
AzureIoTClient 53:1e5a1ca1f274 1060 {
Azure.IoT.Build 54:6dcad9019a64 1061 if (iotHubClientInstance->created_with_transport_handle == 0)
Azure.IoT.Build 54:6dcad9019a64 1062 {
Azure.IoT.Build 54:6dcad9019a64 1063 iotHubClientInstance->connection_status_callback = connectionStatusCallback;
Azure.IoT.Build 54:6dcad9019a64 1064 }
AzureIoTClient 53:1e5a1ca1f274 1065 /* Codes_SRS_IOTHUBCLIENT_25_081: [ `IoTHubClient_SetConnectionStatusCallback` shall start the worker thread if it was not previously started. ]*/
AzureIoTClient 53:1e5a1ca1f274 1066 if ((result = StartWorkerThreadIfNeeded(iotHubClientInstance)) != IOTHUB_CLIENT_OK)
AzureIoTClient 53:1e5a1ca1f274 1067 {
AzureIoTClient 53:1e5a1ca1f274 1068 /* Codes_SRS_IOTHUBCLIENT_25_083: [ If starting the thread fails, `IoTHubClient_SetConnectionStatusCallback` shall return `IOTHUB_CLIENT_ERROR`. ]*/
AzureIoTClient 53:1e5a1ca1f274 1069 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 53:1e5a1ca1f274 1070 LogError("Could not start worker thread");
AzureIoTClient 53:1e5a1ca1f274 1071 }
AzureIoTClient 53:1e5a1ca1f274 1072 else
AzureIoTClient 53:1e5a1ca1f274 1073 {
Azure.IoT.Build 54:6dcad9019a64 1074 if (iotHubClientInstance->created_with_transport_handle != 0 || connectionStatusCallback == NULL)
Azure.IoT.Build 54:6dcad9019a64 1075 {
Azure.IoT.Build 54:6dcad9019a64 1076 /* Codes_SRS_IOTHUBCLIENT_25_085: [ `IoTHubClient_SetConnectionStatusCallback` shall call `IoTHubClient_LL_SetConnectionStatusCallback`, while passing the `IoTHubClient_LL` handle created by `IoTHubClient_Create` and the parameters `connectionStatusCallback` and `userContextCallback`. ]*/
Azure.IoT.Build 54:6dcad9019a64 1077 result = IoTHubClient_LL_SetConnectionStatusCallback(iotHubClientInstance->IoTHubClientLLHandle, connectionStatusCallback, userContextCallback);
Azure.IoT.Build 54:6dcad9019a64 1078 }
Azure.IoT.Build 54:6dcad9019a64 1079 else
Azure.IoT.Build 54:6dcad9019a64 1080 {
AzureIoTClient 55:59b527ab3452 1081 if (iotHubClientInstance->connection_status_user_context != NULL)
AzureIoTClient 55:59b527ab3452 1082 {
AzureIoTClient 55:59b527ab3452 1083 free(iotHubClientInstance->connection_status_user_context);
AzureIoTClient 55:59b527ab3452 1084 }
AzureIoTClient 55:59b527ab3452 1085 iotHubClientInstance->connection_status_user_context = (IOTHUB_QUEUE_CONTEXT*)malloc(sizeof(IOTHUB_QUEUE_CONTEXT));
AzureIoTClient 55:59b527ab3452 1086 if (iotHubClientInstance->connection_status_user_context == NULL)
Azure.IoT.Build 54:6dcad9019a64 1087 {
Azure.IoT.Build 54:6dcad9019a64 1088 result = IOTHUB_CLIENT_ERROR;
Azure.IoT.Build 54:6dcad9019a64 1089 LogError("Failed allocating QUEUE_CONTEXT");
Azure.IoT.Build 54:6dcad9019a64 1090 }
Azure.IoT.Build 54:6dcad9019a64 1091 else
Azure.IoT.Build 54:6dcad9019a64 1092 {
AzureIoTClient 55:59b527ab3452 1093 iotHubClientInstance->connection_status_user_context->iotHubClientHandle = iotHubClientInstance;
AzureIoTClient 55:59b527ab3452 1094 iotHubClientInstance->connection_status_user_context->userContextCallback = userContextCallback;
Azure.IoT.Build 54:6dcad9019a64 1095
Azure.IoT.Build 54:6dcad9019a64 1096 /* Codes_SRS_IOTHUBCLIENT_25_085: [ `IoTHubClient_SetConnectionStatusCallback` shall call `IoTHubClient_LL_SetConnectionStatusCallback`, while passing the `IoTHubClient_LL` handle created by `IoTHubClient_Create` and the parameters `connectionStatusCallback` and `userContextCallback`. ]*/
AzureIoTClient 55:59b527ab3452 1097 result = IoTHubClient_LL_SetConnectionStatusCallback(iotHubClientInstance->IoTHubClientLLHandle, iothub_ll_connection_status_callback, iotHubClientInstance->connection_status_user_context);
Azure.IoT.Build 54:6dcad9019a64 1098 if (result != IOTHUB_CLIENT_OK)
Azure.IoT.Build 54:6dcad9019a64 1099 {
Azure.IoT.Build 54:6dcad9019a64 1100 LogError("IoTHubClient_LL_SetConnectionStatusCallback failed");
AzureIoTClient 55:59b527ab3452 1101 free(iotHubClientInstance->connection_status_user_context);
AzureIoTClient 61:8b85a4e797cf 1102 iotHubClientInstance->connection_status_user_context = NULL;
Azure.IoT.Build 54:6dcad9019a64 1103 }
Azure.IoT.Build 54:6dcad9019a64 1104 }
Azure.IoT.Build 54:6dcad9019a64 1105 }
AzureIoTClient 53:1e5a1ca1f274 1106 }
AzureIoTClient 53:1e5a1ca1f274 1107 (void)Unlock(iotHubClientInstance->LockHandle);
AzureIoTClient 53:1e5a1ca1f274 1108 }
AzureIoTClient 53:1e5a1ca1f274 1109 }
AzureIoTClient 52:1cc3c6d07cad 1110 return result;
AzureIoTClient 52:1cc3c6d07cad 1111 }
AzureIoTClient 52:1cc3c6d07cad 1112
AzureIoTClient 53:1e5a1ca1f274 1113 IOTHUB_CLIENT_RESULT IoTHubClient_SetRetryPolicy(IOTHUB_CLIENT_HANDLE iotHubClientHandle, IOTHUB_CLIENT_RETRY_POLICY retryPolicy, size_t retryTimeoutLimitInSeconds)
AzureIoTClient 52:1cc3c6d07cad 1114 {
AzureIoTClient 53:1e5a1ca1f274 1115 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 53:1e5a1ca1f274 1116
AzureIoTClient 53:1e5a1ca1f274 1117 if (iotHubClientHandle == NULL)
AzureIoTClient 53:1e5a1ca1f274 1118 {
AzureIoTClient 53:1e5a1ca1f274 1119 /* Codes_SRS_IOTHUBCLIENT_25_076: [** If `iotHubClientHandle` is `NULL`, `IoTHubClient_SetRetryPolicy` shall return `IOTHUB_CLIENT_INVALID_ARG`. ] */
AzureIoTClient 53:1e5a1ca1f274 1120 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 53:1e5a1ca1f274 1121 LogError("NULL iothubClientHandle");
AzureIoTClient 53:1e5a1ca1f274 1122 }
AzureIoTClient 53:1e5a1ca1f274 1123 else
AzureIoTClient 53:1e5a1ca1f274 1124 {
AzureIoTClient 53:1e5a1ca1f274 1125 IOTHUB_CLIENT_INSTANCE* iotHubClientInstance = (IOTHUB_CLIENT_INSTANCE*)iotHubClientHandle;
AzureIoTClient 53:1e5a1ca1f274 1126
AzureIoTClient 53:1e5a1ca1f274 1127 /* Codes_SRS_IOTHUBCLIENT_25_079: [ `IoTHubClient_SetRetryPolicy` shall be made thread-safe by using the lock created in `IoTHubClient_Create`.] */
AzureIoTClient 53:1e5a1ca1f274 1128 if (Lock(iotHubClientInstance->LockHandle) != LOCK_OK)
AzureIoTClient 53:1e5a1ca1f274 1129 {
AzureIoTClient 53:1e5a1ca1f274 1130 /* Codes_SRS_IOTHUBCLIENT_25_080: [ If acquiring the lock fails, `IoTHubClient_SetRetryPolicy` shall return `IOTHUB_CLIENT_ERROR`. ]*/
AzureIoTClient 53:1e5a1ca1f274 1131 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 53:1e5a1ca1f274 1132 LogError("Could not acquire lock");
AzureIoTClient 53:1e5a1ca1f274 1133 }
AzureIoTClient 53:1e5a1ca1f274 1134 else
AzureIoTClient 53:1e5a1ca1f274 1135 {
AzureIoTClient 53:1e5a1ca1f274 1136 /* Codes_SRS_IOTHUBCLIENT_25_073: [ `IoTHubClient_SetRetryPolicy` shall start the worker thread if it was not previously started. ] */
AzureIoTClient 53:1e5a1ca1f274 1137 if ((result = StartWorkerThreadIfNeeded(iotHubClientInstance)) != IOTHUB_CLIENT_OK)
AzureIoTClient 53:1e5a1ca1f274 1138 {
AzureIoTClient 53:1e5a1ca1f274 1139 /* Codes_SRS_IOTHUBCLIENT_25_075: [ If starting the thread fails, `IoTHubClient_SetRetryPolicy` shall return `IOTHUB_CLIENT_ERROR`. ]*/
AzureIoTClient 53:1e5a1ca1f274 1140 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 53:1e5a1ca1f274 1141 LogError("Could not start worker thread");
AzureIoTClient 53:1e5a1ca1f274 1142 }
AzureIoTClient 53:1e5a1ca1f274 1143 else
AzureIoTClient 53:1e5a1ca1f274 1144 {
AzureIoTClient 53:1e5a1ca1f274 1145 /* Codes_SRS_IOTHUBCLIENT_25_077: [ `IoTHubClient_SetRetryPolicy` shall call `IoTHubClient_LL_SetRetryPolicy`, while passing the `IoTHubClient_LL` handle created by `IoTHubClient_Create` and the parameters `retryPolicy` and `retryTimeoutLimitinSeconds`.]*/
AzureIoTClient 53:1e5a1ca1f274 1146 result = IoTHubClient_LL_SetRetryPolicy(iotHubClientInstance->IoTHubClientLLHandle, retryPolicy, retryTimeoutLimitInSeconds);
AzureIoTClient 53:1e5a1ca1f274 1147 }
AzureIoTClient 53:1e5a1ca1f274 1148
AzureIoTClient 53:1e5a1ca1f274 1149 (void)Unlock(iotHubClientInstance->LockHandle);
AzureIoTClient 53:1e5a1ca1f274 1150 }
AzureIoTClient 53:1e5a1ca1f274 1151 }
AzureIoTClient 52:1cc3c6d07cad 1152
AzureIoTClient 52:1cc3c6d07cad 1153 return result;
AzureIoTClient 52:1cc3c6d07cad 1154 }
AzureIoTClient 52:1cc3c6d07cad 1155
Azure.IoT.Build 54:6dcad9019a64 1156 IOTHUB_CLIENT_RESULT IoTHubClient_GetRetryPolicy(IOTHUB_CLIENT_HANDLE iotHubClientHandle, IOTHUB_CLIENT_RETRY_POLICY* retryPolicy, size_t* retryTimeoutLimitInSeconds)
AzureIoTClient 52:1cc3c6d07cad 1157 {
AzureIoTClient 53:1e5a1ca1f274 1158 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 53:1e5a1ca1f274 1159
AzureIoTClient 53:1e5a1ca1f274 1160 if (iotHubClientHandle == NULL)
AzureIoTClient 53:1e5a1ca1f274 1161 {
AzureIoTClient 53:1e5a1ca1f274 1162 /* Codes_SRS_IOTHUBCLIENT_25_092: [ If `iotHubClientHandle` is `NULL`, `IoTHubClient_GetRetryPolicy` shall return `IOTHUB_CLIENT_INVALID_ARG`. ]*/
AzureIoTClient 53:1e5a1ca1f274 1163 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 53:1e5a1ca1f274 1164 LogError("NULL iothubClientHandle");
AzureIoTClient 53:1e5a1ca1f274 1165 }
AzureIoTClient 53:1e5a1ca1f274 1166 else
AzureIoTClient 53:1e5a1ca1f274 1167 {
AzureIoTClient 53:1e5a1ca1f274 1168 IOTHUB_CLIENT_INSTANCE* iotHubClientInstance = (IOTHUB_CLIENT_INSTANCE*)iotHubClientHandle;
AzureIoTClient 53:1e5a1ca1f274 1169
AzureIoTClient 53:1e5a1ca1f274 1170 /* Codes_SRS_IOTHUBCLIENT_25_095: [ `IoTHubClient_GetRetryPolicy` shall be made thread-safe by using the lock created in `IoTHubClient_Create`. ]*/
AzureIoTClient 53:1e5a1ca1f274 1171 if (Lock(iotHubClientInstance->LockHandle) != LOCK_OK)
AzureIoTClient 53:1e5a1ca1f274 1172 {
AzureIoTClient 53:1e5a1ca1f274 1173 /* Codes_SRS_IOTHUBCLIENT_25_096: [ If acquiring the lock fails, `IoTHubClient_GetRetryPolicy` shall return `IOTHUB_CLIENT_ERROR`. ]*/
AzureIoTClient 53:1e5a1ca1f274 1174 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 53:1e5a1ca1f274 1175 LogError("Could not acquire lock");
AzureIoTClient 53:1e5a1ca1f274 1176 }
AzureIoTClient 53:1e5a1ca1f274 1177 else
AzureIoTClient 53:1e5a1ca1f274 1178 {
AzureIoTClient 53:1e5a1ca1f274 1179 /* Codes_SRS_IOTHUBCLIENT_25_089: [ `IoTHubClient_GetRetryPolicy` shall start the worker thread if it was not previously started.]*/
AzureIoTClient 53:1e5a1ca1f274 1180 if ((result = StartWorkerThreadIfNeeded(iotHubClientInstance)) != IOTHUB_CLIENT_OK)
AzureIoTClient 53:1e5a1ca1f274 1181 {
AzureIoTClient 53:1e5a1ca1f274 1182 /* Codes_SRS_IOTHUBCLIENT_25_091: [ If starting the thread fails, `IoTHubClient_GetRetryPolicy` shall return `IOTHUB_CLIENT_ERROR`.]*/
AzureIoTClient 53:1e5a1ca1f274 1183 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 53:1e5a1ca1f274 1184 LogError("Could not start worker thread");
AzureIoTClient 53:1e5a1ca1f274 1185 }
AzureIoTClient 53:1e5a1ca1f274 1186 else
AzureIoTClient 53:1e5a1ca1f274 1187 {
AzureIoTClient 53:1e5a1ca1f274 1188 /* Codes_SRS_IOTHUBCLIENT_25_093: [ `IoTHubClient_GetRetryPolicy` shall call `IoTHubClient_LL_GetRetryPolicy`, while passing the `IoTHubClient_LL` handle created by `IoTHubClient_Create` and the parameters `connectionStatusCallback` and `userContextCallback`.]*/
AzureIoTClient 53:1e5a1ca1f274 1189 result = IoTHubClient_LL_GetRetryPolicy(iotHubClientInstance->IoTHubClientLLHandle, retryPolicy, retryTimeoutLimitInSeconds);
AzureIoTClient 53:1e5a1ca1f274 1190 }
AzureIoTClient 53:1e5a1ca1f274 1191
AzureIoTClient 53:1e5a1ca1f274 1192 (void)Unlock(iotHubClientInstance->LockHandle);
AzureIoTClient 53:1e5a1ca1f274 1193 }
AzureIoTClient 53:1e5a1ca1f274 1194 }
AzureIoTClient 52:1cc3c6d07cad 1195
AzureIoTClient 52:1cc3c6d07cad 1196 return result;
AzureIoTClient 52:1cc3c6d07cad 1197 }
AzureIoTClient 52:1cc3c6d07cad 1198
AzureIoTClient 16:deba40344375 1199 IOTHUB_CLIENT_RESULT IoTHubClient_GetLastMessageReceiveTime(IOTHUB_CLIENT_HANDLE iotHubClientHandle, time_t* lastMessageReceiveTime)
AzureIoTClient 16:deba40344375 1200 {
AzureIoTClient 16:deba40344375 1201 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 16:deba40344375 1202
AzureIoTClient 16:deba40344375 1203 if (iotHubClientHandle == NULL)
AzureIoTClient 16:deba40344375 1204 {
AzureIoTClient 16:deba40344375 1205 /* Codes_SRS_IOTHUBCLIENT_01_020: [If iotHubClientHandle is NULL, IoTHubClient_GetLastMessageReceiveTime shall return IOTHUB_CLIENT_INVALID_ARG.] */
AzureIoTClient 16:deba40344375 1206 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 39:2719651a5bee 1207 LogError("NULL iothubClientHandle");
AzureIoTClient 16:deba40344375 1208 }
AzureIoTClient 16:deba40344375 1209 else
AzureIoTClient 16:deba40344375 1210 {
AzureIoTClient 16:deba40344375 1211 IOTHUB_CLIENT_INSTANCE* iotHubClientInstance = (IOTHUB_CLIENT_INSTANCE*)iotHubClientHandle;
AzureIoTClient 16:deba40344375 1212
AzureIoTClient 16:deba40344375 1213 /* Codes_SRS_IOTHUBCLIENT_01_035: [IoTHubClient_GetLastMessageReceiveTime shall be made thread-safe by using the lock created in IoTHubClient_Create.] */
AzureIoTClient 16:deba40344375 1214 if (Lock(iotHubClientInstance->LockHandle) != LOCK_OK)
AzureIoTClient 16:deba40344375 1215 {
AzureIoTClient 16:deba40344375 1216 /* Codes_SRS_IOTHUBCLIENT_01_036: [If acquiring the lock fails, IoTHubClient_GetLastMessageReceiveTime shall return IOTHUB_CLIENT_ERROR.] */
AzureIoTClient 16:deba40344375 1217 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 39:2719651a5bee 1218 LogError("Could not acquire lock");
AzureIoTClient 16:deba40344375 1219 }
AzureIoTClient 16:deba40344375 1220 else
AzureIoTClient 16:deba40344375 1221 {
AzureIoTClient 16:deba40344375 1222 /* Codes_SRS_IOTHUBCLIENT_01_019: [IoTHubClient_GetLastMessageReceiveTime shall call IoTHubClient_LL_GetLastMessageReceiveTime, while passing the IoTHubClient_LL handle created by IoTHubClient_Create and the parameter lastMessageReceiveTime.] */
AzureIoTClient 16:deba40344375 1223 /* Codes_SRS_IOTHUBCLIENT_01_021: [Otherwise, IoTHubClient_GetLastMessageReceiveTime shall return the result of IoTHubClient_LL_GetLastMessageReceiveTime.] */
AzureIoTClient 16:deba40344375 1224 result = IoTHubClient_LL_GetLastMessageReceiveTime(iotHubClientInstance->IoTHubClientLLHandle, lastMessageReceiveTime);
AzureIoTClient 16:deba40344375 1225
AzureIoTClient 16:deba40344375 1226 /* Codes_SRS_IOTHUBCLIENT_01_035: [IoTHubClient_GetLastMessageReceiveTime shall be made thread-safe by using the lock created in IoTHubClient_Create.] */
AzureIoTClient 53:1e5a1ca1f274 1227 (void)Unlock(iotHubClientInstance->LockHandle);
AzureIoTClient 16:deba40344375 1228 }
AzureIoTClient 16:deba40344375 1229 }
AzureIoTClient 16:deba40344375 1230
AzureIoTClient 16:deba40344375 1231 return result;
AzureIoTClient 16:deba40344375 1232 }
AzureIoTClient 16:deba40344375 1233
AzureIoTClient 16:deba40344375 1234 IOTHUB_CLIENT_RESULT IoTHubClient_SetOption(IOTHUB_CLIENT_HANDLE iotHubClientHandle, const char* optionName, const void* value)
AzureIoTClient 16:deba40344375 1235 {
AzureIoTClient 16:deba40344375 1236 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 16:deba40344375 1237 /*Codes_SRS_IOTHUBCLIENT_02_034: [If parameter iotHubClientHandle is NULL then IoTHubClient_SetOption shall return IOTHUB_CLIENT_INVALID_ARG.] */
AzureIoTClient 42:448eecc3676e 1238 /*Codes_SRS_IOTHUBCLIENT_02_035: [ If parameter optionName is NULL then IoTHubClient_SetOption shall return IOTHUB_CLIENT_INVALID_ARG. ]*/
AzureIoTClient 42:448eecc3676e 1239 /*Codes_SRS_IOTHUBCLIENT_02_036: [ If parameter value is NULL then IoTHubClient_SetOption shall return IOTHUB_CLIENT_INVALID_ARG. ]*/
AzureIoTClient 16:deba40344375 1240 if (
AzureIoTClient 16:deba40344375 1241 (iotHubClientHandle == NULL) ||
AzureIoTClient 16:deba40344375 1242 (optionName == NULL) ||
AzureIoTClient 16:deba40344375 1243 (value == NULL)
AzureIoTClient 16:deba40344375 1244 )
AzureIoTClient 16:deba40344375 1245 {
AzureIoTClient 16:deba40344375 1246 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 53:1e5a1ca1f274 1247 LogError("invalid arg (NULL)");
AzureIoTClient 16:deba40344375 1248 }
AzureIoTClient 16:deba40344375 1249 else
AzureIoTClient 16:deba40344375 1250 {
AzureIoTClient 16:deba40344375 1251 IOTHUB_CLIENT_INSTANCE* iotHubClientInstance = (IOTHUB_CLIENT_INSTANCE*)iotHubClientHandle;
AzureIoTClient 16:deba40344375 1252
AzureIoTClient 40:1a94db9139ea 1253 /* Codes_SRS_IOTHUBCLIENT_01_041: [ IoTHubClient_SetOption shall be made thread-safe by using the lock created in IoTHubClient_Create. ]*/
AzureIoTClient 40:1a94db9139ea 1254 if (Lock(iotHubClientInstance->LockHandle) != LOCK_OK)
AzureIoTClient 40:1a94db9139ea 1255 {
AzureIoTClient 40:1a94db9139ea 1256 /* Codes_SRS_IOTHUBCLIENT_01_042: [ If acquiring the lock fails, IoTHubClient_GetLastMessageReceiveTime shall return IOTHUB_CLIENT_ERROR. ]*/
AzureIoTClient 40:1a94db9139ea 1257 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 40:1a94db9139ea 1258 LogError("Could not acquire lock");
AzureIoTClient 40:1a94db9139ea 1259 }
AzureIoTClient 40:1a94db9139ea 1260 else
AzureIoTClient 16:deba40344375 1261 {
AzureIoTClient 40:1a94db9139ea 1262 /*Codes_SRS_IOTHUBCLIENT_02_038: [If optionName doesn't match one of the options handled by this module then IoTHubClient_SetOption shall call IoTHubClient_LL_SetOption passing the same parameters and return what IoTHubClient_LL_SetOption returns.] */
AzureIoTClient 40:1a94db9139ea 1263 result = IoTHubClient_LL_SetOption(iotHubClientInstance->IoTHubClientLLHandle, optionName, value);
AzureIoTClient 40:1a94db9139ea 1264 if (result != IOTHUB_CLIENT_OK)
AzureIoTClient 40:1a94db9139ea 1265 {
AzureIoTClient 40:1a94db9139ea 1266 LogError("IoTHubClient_LL_SetOption failed");
AzureIoTClient 40:1a94db9139ea 1267 }
AzureIoTClient 40:1a94db9139ea 1268
AzureIoTClient 53:1e5a1ca1f274 1269 (void)Unlock(iotHubClientInstance->LockHandle);
AzureIoTClient 53:1e5a1ca1f274 1270 }
AzureIoTClient 53:1e5a1ca1f274 1271 }
AzureIoTClient 53:1e5a1ca1f274 1272 return result;
AzureIoTClient 53:1e5a1ca1f274 1273 }
AzureIoTClient 53:1e5a1ca1f274 1274
AzureIoTClient 53:1e5a1ca1f274 1275 IOTHUB_CLIENT_RESULT IoTHubClient_SetDeviceTwinCallback(IOTHUB_CLIENT_HANDLE iotHubClientHandle, IOTHUB_CLIENT_DEVICE_TWIN_CALLBACK deviceTwinCallback, void* userContextCallback)
AzureIoTClient 53:1e5a1ca1f274 1276 {
AzureIoTClient 53:1e5a1ca1f274 1277 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 53:1e5a1ca1f274 1278
AzureIoTClient 53:1e5a1ca1f274 1279 /*Codes_SRS_IOTHUBCLIENT_10_001: [** `IoTHubClient_SetDeviceTwinCallback` shall fail and return `IOTHUB_CLIENT_INVALID_ARG` if parameter `iotHubClientHandle` is `NULL`. ]*/
AzureIoTClient 53:1e5a1ca1f274 1280 if (iotHubClientHandle == NULL)
AzureIoTClient 53:1e5a1ca1f274 1281 {
AzureIoTClient 53:1e5a1ca1f274 1282 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 53:1e5a1ca1f274 1283 LogError("invalid arg (NULL)");
AzureIoTClient 53:1e5a1ca1f274 1284 }
AzureIoTClient 53:1e5a1ca1f274 1285 else
AzureIoTClient 53:1e5a1ca1f274 1286 {
AzureIoTClient 53:1e5a1ca1f274 1287 IOTHUB_CLIENT_INSTANCE* iotHubClientInstance = (IOTHUB_CLIENT_INSTANCE*)iotHubClientHandle;
AzureIoTClient 53:1e5a1ca1f274 1288
AzureIoTClient 53:1e5a1ca1f274 1289 /*Codes_SRS_IOTHUBCLIENT_10_020: [** `IoTHubClient_SetDeviceTwinCallback` shall be made thread - safe by using the lock created in IoTHubClient_Create. ]*/
AzureIoTClient 53:1e5a1ca1f274 1290 if (Lock(iotHubClientInstance->LockHandle) != LOCK_OK)
AzureIoTClient 53:1e5a1ca1f274 1291 {
AzureIoTClient 53:1e5a1ca1f274 1292 /*Codes_SRS_IOTHUBCLIENT_10_002: [** If acquiring the lock fails, `IoTHubClient_SetDeviceTwinCallback` shall return `IOTHUB_CLIENT_ERROR`. ]*/
AzureIoTClient 53:1e5a1ca1f274 1293 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 53:1e5a1ca1f274 1294 LogError("Could not acquire lock");
AzureIoTClient 53:1e5a1ca1f274 1295 }
AzureIoTClient 53:1e5a1ca1f274 1296 else
AzureIoTClient 53:1e5a1ca1f274 1297 {
Azure.IoT.Build 54:6dcad9019a64 1298 if (iotHubClientInstance->created_with_transport_handle == 0)
Azure.IoT.Build 54:6dcad9019a64 1299 {
Azure.IoT.Build 54:6dcad9019a64 1300 iotHubClientInstance->desired_state_callback = deviceTwinCallback;
Azure.IoT.Build 54:6dcad9019a64 1301 }
AzureIoTClient 53:1e5a1ca1f274 1302 /*Codes_SRS_IOTHUBCLIENT_10_003: [** If the transport connection is shared, the thread shall be started by calling `IoTHubTransport_StartWorkerThread`. ]*/
AzureIoTClient 53:1e5a1ca1f274 1303 if ((result = StartWorkerThreadIfNeeded(iotHubClientInstance)) != IOTHUB_CLIENT_OK)
AzureIoTClient 53:1e5a1ca1f274 1304 {
AzureIoTClient 53:1e5a1ca1f274 1305 /*Codes_SRS_IOTHUBCLIENT_10_004: [** If starting the thread fails, `IoTHubClient_SetDeviceTwinCallback` shall return `IOTHUB_CLIENT_ERROR`. ]*/
AzureIoTClient 53:1e5a1ca1f274 1306 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 53:1e5a1ca1f274 1307 LogError("Could not start worker thread");
AzureIoTClient 53:1e5a1ca1f274 1308 }
AzureIoTClient 53:1e5a1ca1f274 1309 else
AzureIoTClient 53:1e5a1ca1f274 1310 {
Azure.IoT.Build 54:6dcad9019a64 1311 if (iotHubClientInstance->created_with_transport_handle != 0 || deviceTwinCallback == NULL)
Azure.IoT.Build 54:6dcad9019a64 1312 {
Azure.IoT.Build 54:6dcad9019a64 1313 /*Codes_SRS_IOTHUBCLIENT_10_005: [** `IoTHubClient_LL_SetDeviceTwinCallback` shall call `IoTHubClient_LL_SetDeviceTwinCallback`, while passing the `IoTHubClient_LL handle` created by `IoTHubClient_LL_Create` along with the parameters `reportedStateCallback` and `userContextCallback`. ]*/
Azure.IoT.Build 54:6dcad9019a64 1314 result = IoTHubClient_LL_SetDeviceTwinCallback(iotHubClientInstance->IoTHubClientLLHandle, deviceTwinCallback, userContextCallback);
Azure.IoT.Build 54:6dcad9019a64 1315 }
Azure.IoT.Build 54:6dcad9019a64 1316 else
AzureIoTClient 53:1e5a1ca1f274 1317 {
Azure.IoT.Build 54:6dcad9019a64 1318 if (iotHubClientInstance->devicetwin_user_context != NULL)
Azure.IoT.Build 54:6dcad9019a64 1319 {
Azure.IoT.Build 54:6dcad9019a64 1320 free(iotHubClientInstance->devicetwin_user_context);
Azure.IoT.Build 54:6dcad9019a64 1321 }
Azure.IoT.Build 54:6dcad9019a64 1322
Azure.IoT.Build 54:6dcad9019a64 1323 /*Codes_SRS_IOTHUBCLIENT_07_002: [ IoTHubClient_SetDeviceTwinCallback shall allocate a IOTHUB_QUEUE_CONTEXT object to be sent to the IoTHubClient_LL_SetDeviceTwinCallback function as a user context. ]*/
AzureIoTClient 55:59b527ab3452 1324 iotHubClientInstance->devicetwin_user_context = (IOTHUB_QUEUE_CONTEXT*)malloc(sizeof(IOTHUB_QUEUE_CONTEXT));
Azure.IoT.Build 54:6dcad9019a64 1325 if (iotHubClientInstance->devicetwin_user_context == NULL)
Azure.IoT.Build 54:6dcad9019a64 1326 {
Azure.IoT.Build 54:6dcad9019a64 1327 result = IOTHUB_CLIENT_ERROR;
Azure.IoT.Build 54:6dcad9019a64 1328 LogError("Failed allocating QUEUE_CONTEXT");
Azure.IoT.Build 54:6dcad9019a64 1329 }
Azure.IoT.Build 54:6dcad9019a64 1330 else
Azure.IoT.Build 54:6dcad9019a64 1331 {
Azure.IoT.Build 54:6dcad9019a64 1332 /*Codes_SRS_IOTHUBCLIENT_10_005: [** `IoTHubClient_LL_SetDeviceTwinCallback` shall call `IoTHubClient_LL_SetDeviceTwinCallback`, while passing the `IoTHubClient_LL handle` created by `IoTHubClient_LL_Create` along with the parameters `iothub_ll_device_twin_callback` and IOTHUB_QUEUE_CONTEXT variable. ]*/
AzureIoTClient 55:59b527ab3452 1333 iotHubClientInstance->devicetwin_user_context->iotHubClientHandle = iotHubClientInstance;
AzureIoTClient 55:59b527ab3452 1334 iotHubClientInstance->devicetwin_user_context->userContextCallback = userContextCallback;
Azure.IoT.Build 54:6dcad9019a64 1335 result = IoTHubClient_LL_SetDeviceTwinCallback(iotHubClientInstance->IoTHubClientLLHandle, iothub_ll_device_twin_callback, iotHubClientInstance->devicetwin_user_context);
Azure.IoT.Build 54:6dcad9019a64 1336 if (result != IOTHUB_CLIENT_OK)
Azure.IoT.Build 54:6dcad9019a64 1337 {
Azure.IoT.Build 54:6dcad9019a64 1338 LogError("IoTHubClient_LL_SetDeviceTwinCallback failed");
Azure.IoT.Build 54:6dcad9019a64 1339 free(iotHubClientInstance->devicetwin_user_context);
AzureIoTClient 61:8b85a4e797cf 1340 iotHubClientInstance->devicetwin_user_context = NULL;
Azure.IoT.Build 54:6dcad9019a64 1341 }
Azure.IoT.Build 54:6dcad9019a64 1342 }
AzureIoTClient 53:1e5a1ca1f274 1343 }
AzureIoTClient 53:1e5a1ca1f274 1344 }
AzureIoTClient 53:1e5a1ca1f274 1345 (void)Unlock(iotHubClientInstance->LockHandle);
AzureIoTClient 16:deba40344375 1346 }
AzureIoTClient 16:deba40344375 1347 }
AzureIoTClient 16:deba40344375 1348 return result;
AzureIoTClient 16:deba40344375 1349 }
AzureIoTClient 42:448eecc3676e 1350
AzureIoTClient 53:1e5a1ca1f274 1351 IOTHUB_CLIENT_RESULT IoTHubClient_SendReportedState(IOTHUB_CLIENT_HANDLE iotHubClientHandle, const unsigned char* reportedState, size_t size, IOTHUB_CLIENT_REPORTED_STATE_CALLBACK reportedStateCallback, void* userContextCallback)
AzureIoTClient 53:1e5a1ca1f274 1352 {
AzureIoTClient 53:1e5a1ca1f274 1353 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 53:1e5a1ca1f274 1354
AzureIoTClient 53:1e5a1ca1f274 1355 /*Codes_SRS_IOTHUBCLIENT_10_013: [** If `iotHubClientHandle` is `NULL`, `IoTHubClient_SendReportedState` shall return `IOTHUB_CLIENT_INVALID_ARG`. ]*/
AzureIoTClient 53:1e5a1ca1f274 1356 if (iotHubClientHandle == NULL)
AzureIoTClient 53:1e5a1ca1f274 1357 {
AzureIoTClient 53:1e5a1ca1f274 1358 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 53:1e5a1ca1f274 1359 LogError("invalid arg (NULL)");
AzureIoTClient 53:1e5a1ca1f274 1360 }
AzureIoTClient 53:1e5a1ca1f274 1361 else
AzureIoTClient 53:1e5a1ca1f274 1362 {
AzureIoTClient 53:1e5a1ca1f274 1363 IOTHUB_CLIENT_INSTANCE* iotHubClientInstance = (IOTHUB_CLIENT_INSTANCE*)iotHubClientHandle;
AzureIoTClient 53:1e5a1ca1f274 1364
AzureIoTClient 53:1e5a1ca1f274 1365 /*Codes_SRS_IOTHUBCLIENT_10_021: [** `IoTHubClient_SendReportedState` shall be made thread-safe by using the lock created in IoTHubClient_Create. ]*/
AzureIoTClient 53:1e5a1ca1f274 1366 if (Lock(iotHubClientInstance->LockHandle) != LOCK_OK)
AzureIoTClient 53:1e5a1ca1f274 1367 {
AzureIoTClient 53:1e5a1ca1f274 1368 /*Codes_SRS_IOTHUBCLIENT_10_014: [** If acquiring the lock fails, `IoTHubClient_SendReportedState` shall return `IOTHUB_CLIENT_ERROR`. ]*/
AzureIoTClient 53:1e5a1ca1f274 1369 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 53:1e5a1ca1f274 1370 LogError("Could not acquire lock");
AzureIoTClient 53:1e5a1ca1f274 1371 }
AzureIoTClient 53:1e5a1ca1f274 1372 else
AzureIoTClient 53:1e5a1ca1f274 1373 {
Azure.IoT.Build 54:6dcad9019a64 1374 if (iotHubClientInstance->created_with_transport_handle == 0)
Azure.IoT.Build 54:6dcad9019a64 1375 {
Azure.IoT.Build 54:6dcad9019a64 1376 iotHubClientInstance->reported_state_callback = reportedStateCallback;
Azure.IoT.Build 54:6dcad9019a64 1377 }
AzureIoTClient 53:1e5a1ca1f274 1378 /*Codes_SRS_IOTHUBCLIENT_10_015: [** If the transport connection is shared, the thread shall be started by calling `IoTHubTransport_StartWorkerThread`. ]*/
AzureIoTClient 53:1e5a1ca1f274 1379 if ((result = StartWorkerThreadIfNeeded(iotHubClientInstance)) != IOTHUB_CLIENT_OK)
AzureIoTClient 53:1e5a1ca1f274 1380 {
AzureIoTClient 53:1e5a1ca1f274 1381 /*Codes_SRS_IOTHUBCLIENT_10_016: [** If starting the thread fails, `IoTHubClient_SendReportedState` shall return `IOTHUB_CLIENT_ERROR`. ]*/
AzureIoTClient 53:1e5a1ca1f274 1382 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 53:1e5a1ca1f274 1383 LogError("Could not start worker thread");
AzureIoTClient 53:1e5a1ca1f274 1384 }
AzureIoTClient 53:1e5a1ca1f274 1385 else
AzureIoTClient 53:1e5a1ca1f274 1386 {
Azure.IoT.Build 54:6dcad9019a64 1387 if (iotHubClientInstance->created_with_transport_handle != 0 || reportedStateCallback == NULL)
Azure.IoT.Build 54:6dcad9019a64 1388 {
Azure.IoT.Build 54:6dcad9019a64 1389 /*Codes_SRS_IOTHUBCLIENT_10_017: [** `IoTHubClient_SendReportedState` shall call `IoTHubClient_LL_SendReportedState`, while passing the `IoTHubClient_LL handle` created by `IoTHubClient_LL_Create` along with the parameters `reportedState`, `size`, `reportedStateCallback`, and `userContextCallback`. ]*/
Azure.IoT.Build 54:6dcad9019a64 1390 /*Codes_SRS_IOTHUBCLIENT_10_018: [** When `IoTHubClient_LL_SendReportedState` is called, `IoTHubClient_SendReportedState` shall return the result of `IoTHubClient_LL_SendReportedState`. **]*/
Azure.IoT.Build 54:6dcad9019a64 1391 result = IoTHubClient_LL_SendReportedState(iotHubClientInstance->IoTHubClientLLHandle, reportedState, size, reportedStateCallback, userContextCallback);
Azure.IoT.Build 54:6dcad9019a64 1392 }
Azure.IoT.Build 54:6dcad9019a64 1393 else
AzureIoTClient 53:1e5a1ca1f274 1394 {
Azure.IoT.Build 54:6dcad9019a64 1395 /* Codes_SRS_IOTHUBCLIENT_07_003: [ IoTHubClient_SendReportedState shall allocate a IOTHUB_QUEUE_CONTEXT object to be sent to the IoTHubClient_LL_SendReportedState function as a user context. ] */
Azure.IoT.Build 54:6dcad9019a64 1396 IOTHUB_QUEUE_CONTEXT* queue_context = (IOTHUB_QUEUE_CONTEXT*)malloc(sizeof(IOTHUB_QUEUE_CONTEXT));
Azure.IoT.Build 54:6dcad9019a64 1397 if (queue_context == NULL)
Azure.IoT.Build 54:6dcad9019a64 1398 {
Azure.IoT.Build 54:6dcad9019a64 1399 result = IOTHUB_CLIENT_ERROR;
Azure.IoT.Build 54:6dcad9019a64 1400 LogError("Failed allocating QUEUE_CONTEXT");
Azure.IoT.Build 54:6dcad9019a64 1401 }
Azure.IoT.Build 54:6dcad9019a64 1402 else
Azure.IoT.Build 54:6dcad9019a64 1403 {
Azure.IoT.Build 54:6dcad9019a64 1404 queue_context->iotHubClientHandle = iotHubClientInstance;
Azure.IoT.Build 54:6dcad9019a64 1405 queue_context->userContextCallback = userContextCallback;
Azure.IoT.Build 54:6dcad9019a64 1406 /*Codes_SRS_IOTHUBCLIENT_10_017: [** `IoTHubClient_SendReportedState` shall call `IoTHubClient_LL_SendReportedState`, while passing the `IoTHubClient_LL handle` created by `IoTHubClient_LL_Create` along with the parameters `reportedState`, `size`, `iothub_ll_reported_state_callback` and IOTHUB_QUEUE_CONTEXT variable. ]*/
Azure.IoT.Build 54:6dcad9019a64 1407 /*Codes_SRS_IOTHUBCLIENT_10_018: [** When `IoTHubClient_LL_SendReportedState` is called, `IoTHubClient_SendReportedState` shall return the result of `IoTHubClient_LL_SendReportedState`. **]*/
Azure.IoT.Build 54:6dcad9019a64 1408 result = IoTHubClient_LL_SendReportedState(iotHubClientInstance->IoTHubClientLLHandle, reportedState, size, iothub_ll_reported_state_callback, queue_context);
Azure.IoT.Build 54:6dcad9019a64 1409 if (result != IOTHUB_CLIENT_OK)
Azure.IoT.Build 54:6dcad9019a64 1410 {
Azure.IoT.Build 54:6dcad9019a64 1411 LogError("IoTHubClient_LL_SendReportedState failed");
Azure.IoT.Build 54:6dcad9019a64 1412 free(queue_context);
Azure.IoT.Build 54:6dcad9019a64 1413 }
Azure.IoT.Build 54:6dcad9019a64 1414 }
AzureIoTClient 53:1e5a1ca1f274 1415 }
AzureIoTClient 53:1e5a1ca1f274 1416 }
AzureIoTClient 53:1e5a1ca1f274 1417 (void)Unlock(iotHubClientInstance->LockHandle);
AzureIoTClient 53:1e5a1ca1f274 1418 }
AzureIoTClient 53:1e5a1ca1f274 1419 }
AzureIoTClient 53:1e5a1ca1f274 1420 return result;
AzureIoTClient 53:1e5a1ca1f274 1421 }
AzureIoTClient 53:1e5a1ca1f274 1422
AzureIoTClient 53:1e5a1ca1f274 1423 IOTHUB_CLIENT_RESULT IoTHubClient_SetDeviceMethodCallback(IOTHUB_CLIENT_HANDLE iotHubClientHandle, IOTHUB_CLIENT_DEVICE_METHOD_CALLBACK_ASYNC deviceMethodCallback, void* userContextCallback)
AzureIoTClient 53:1e5a1ca1f274 1424 {
AzureIoTClient 53:1e5a1ca1f274 1425 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 53:1e5a1ca1f274 1426
AzureIoTClient 53:1e5a1ca1f274 1427 /*Codes_SRS_IOTHUBCLIENT_12_012: [ If iotHubClientHandle is NULL, IoTHubClient_SetDeviceMethodCallback shall return IOTHUB_CLIENT_INVALID_ARG. ]*/
AzureIoTClient 53:1e5a1ca1f274 1428 if (iotHubClientHandle == NULL)
AzureIoTClient 53:1e5a1ca1f274 1429 {
AzureIoTClient 53:1e5a1ca1f274 1430 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 53:1e5a1ca1f274 1431 LogError("invalid arg (NULL)");
AzureIoTClient 53:1e5a1ca1f274 1432 }
AzureIoTClient 53:1e5a1ca1f274 1433 else
AzureIoTClient 53:1e5a1ca1f274 1434 {
AzureIoTClient 53:1e5a1ca1f274 1435 IOTHUB_CLIENT_INSTANCE* iotHubClientInstance = (IOTHUB_CLIENT_INSTANCE*)iotHubClientHandle;
AzureIoTClient 53:1e5a1ca1f274 1436
AzureIoTClient 53:1e5a1ca1f274 1437 /*Codes_SRS_IOTHUBCLIENT_12_018: [ IoTHubClient_SetDeviceMethodCallback shall be made thread-safe by using the lock created in IoTHubClient_Create. ]*/
AzureIoTClient 53:1e5a1ca1f274 1438 if (Lock(iotHubClientInstance->LockHandle) != LOCK_OK)
AzureIoTClient 53:1e5a1ca1f274 1439 {
AzureIoTClient 53:1e5a1ca1f274 1440 /*Codes_SRS_IOTHUBCLIENT_12_013: [ If acquiring the lock fails, IoTHubClient_SetDeviceMethodCallback shall return IOTHUB_CLIENT_ERROR. ]*/
AzureIoTClient 53:1e5a1ca1f274 1441 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 53:1e5a1ca1f274 1442 LogError("Could not acquire lock");
AzureIoTClient 53:1e5a1ca1f274 1443 }
AzureIoTClient 53:1e5a1ca1f274 1444 else
AzureIoTClient 53:1e5a1ca1f274 1445 {
AzureIoTClient 53:1e5a1ca1f274 1446 /*Codes_SRS_IOTHUBCLIENT_12_014: [ If the transport handle is null and the worker thread is not initialized, the thread shall be started by calling IoTHubTransport_StartWorkerThread. ]*/
AzureIoTClient 53:1e5a1ca1f274 1447 if ((result = StartWorkerThreadIfNeeded(iotHubClientInstance)) != IOTHUB_CLIENT_OK)
AzureIoTClient 53:1e5a1ca1f274 1448 {
AzureIoTClient 53:1e5a1ca1f274 1449 /*Codes_SRS_IOTHUBCLIENT_12_015: [ If starting the thread fails, IoTHubClient_SetDeviceMethodCallback shall return IOTHUB_CLIENT_ERROR. ]*/
AzureIoTClient 53:1e5a1ca1f274 1450 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 53:1e5a1ca1f274 1451 LogError("Could not start worker thread");
AzureIoTClient 53:1e5a1ca1f274 1452 }
AzureIoTClient 53:1e5a1ca1f274 1453 else
AzureIoTClient 53:1e5a1ca1f274 1454 {
AzureIoTClient 53:1e5a1ca1f274 1455 /*Codes_SRS_IOTHUBCLIENT_12_016: [ IoTHubClient_SetDeviceMethodCallback shall call IoTHubClient_LL_SetDeviceMethodCallback, while passing the IoTHubClient_LL_handle created by IoTHubClient_LL_Create along with the parameters deviceMethodCallback and userContextCallback. ]*/
AzureIoTClient 53:1e5a1ca1f274 1456 /*Codes_SRS_IOTHUBCLIENT_12_017: [ When IoTHubClient_LL_SetDeviceMethodCallback is called, IoTHubClient_SetDeviceMethodCallback shall return the result of IoTHubClient_LL_SetDeviceMethodCallback. ]*/
AzureIoTClient 53:1e5a1ca1f274 1457 result = IoTHubClient_LL_SetDeviceMethodCallback(iotHubClientInstance->IoTHubClientLLHandle, deviceMethodCallback, userContextCallback);
AzureIoTClient 53:1e5a1ca1f274 1458 if (result != IOTHUB_CLIENT_OK)
AzureIoTClient 53:1e5a1ca1f274 1459 {
AzureIoTClient 53:1e5a1ca1f274 1460 LogError("IoTHubClient_LL_SetDeviceMethodCallback failed");
AzureIoTClient 53:1e5a1ca1f274 1461 }
AzureIoTClient 53:1e5a1ca1f274 1462 }
AzureIoTClient 53:1e5a1ca1f274 1463
AzureIoTClient 53:1e5a1ca1f274 1464 (void)Unlock(iotHubClientInstance->LockHandle);
AzureIoTClient 53:1e5a1ca1f274 1465 }
AzureIoTClient 53:1e5a1ca1f274 1466 }
AzureIoTClient 53:1e5a1ca1f274 1467 return result;
AzureIoTClient 53:1e5a1ca1f274 1468 }
AzureIoTClient 53:1e5a1ca1f274 1469
AzureIoTClient 55:59b527ab3452 1470 IOTHUB_CLIENT_RESULT IoTHubClient_SetDeviceMethodCallback_Ex(IOTHUB_CLIENT_HANDLE iotHubClientHandle, IOTHUB_CLIENT_INBOUND_DEVICE_METHOD_CALLBACK inboundDeviceMethodCallback, void* userContextCallback)
AzureIoTClient 55:59b527ab3452 1471 {
AzureIoTClient 55:59b527ab3452 1472 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 55:59b527ab3452 1473
AzureIoTClient 55:59b527ab3452 1474 /*Codes_SRS_IOTHUBCLIENT_07_001: [ If iotHubClientHandle is NULL, IoTHubClient_SetDeviceMethodCallback_Ex shall return IOTHUB_CLIENT_INVALID_ARG. ]*/
AzureIoTClient 55:59b527ab3452 1475 if (iotHubClientHandle == NULL)
AzureIoTClient 55:59b527ab3452 1476 {
AzureIoTClient 55:59b527ab3452 1477 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 55:59b527ab3452 1478 LogError("invalid arg (NULL)");
AzureIoTClient 55:59b527ab3452 1479 }
AzureIoTClient 55:59b527ab3452 1480 else
AzureIoTClient 55:59b527ab3452 1481 {
AzureIoTClient 55:59b527ab3452 1482 IOTHUB_CLIENT_INSTANCE* iotHubClientInstance = (IOTHUB_CLIENT_INSTANCE*)iotHubClientHandle;
AzureIoTClient 55:59b527ab3452 1483
AzureIoTClient 55:59b527ab3452 1484 /*Codes_SRS_IOTHUBCLIENT_07_007: [ IoTHubClient_SetDeviceMethodCallback_Ex shall be made thread-safe by using the lock created in IoTHubClient_Create. ]*/
AzureIoTClient 55:59b527ab3452 1485 if (Lock(iotHubClientInstance->LockHandle) != LOCK_OK)
AzureIoTClient 55:59b527ab3452 1486 {
AzureIoTClient 55:59b527ab3452 1487 /*Codes_SRS_IOTHUBCLIENT_07_002: [ If acquiring the lock fails, IoTHubClient_SetDeviceMethodCallback_Ex shall return IOTHUB_CLIENT_ERROR. ]*/
AzureIoTClient 55:59b527ab3452 1488 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 55:59b527ab3452 1489 LogError("Could not acquire lock");
AzureIoTClient 55:59b527ab3452 1490 }
AzureIoTClient 55:59b527ab3452 1491 else
AzureIoTClient 55:59b527ab3452 1492 {
AzureIoTClient 55:59b527ab3452 1493 if (iotHubClientInstance->created_with_transport_handle == 0)
AzureIoTClient 55:59b527ab3452 1494 {
AzureIoTClient 55:59b527ab3452 1495 iotHubClientInstance->device_method_callback = inboundDeviceMethodCallback;
AzureIoTClient 55:59b527ab3452 1496 }
AzureIoTClient 55:59b527ab3452 1497 /*Codes_SRS_IOTHUBCLIENT_07_003: [ If the transport handle is NULL and the worker thread is not initialized, the thread shall be started by calling IoTHubTransport_StartWorkerThread. ]*/
AzureIoTClient 55:59b527ab3452 1498 if ((result = StartWorkerThreadIfNeeded(iotHubClientInstance)) != IOTHUB_CLIENT_OK)
AzureIoTClient 55:59b527ab3452 1499 {
AzureIoTClient 55:59b527ab3452 1500 /*Codes_SRS_IOTHUBCLIENT_07_004: [ If starting the thread fails, IoTHubClient_SetDeviceMethodCallback_Ex shall return IOTHUB_CLIENT_ERROR. ]*/
AzureIoTClient 55:59b527ab3452 1501 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 55:59b527ab3452 1502 LogError("Could not start worker thread");
AzureIoTClient 55:59b527ab3452 1503 }
AzureIoTClient 55:59b527ab3452 1504 else
AzureIoTClient 55:59b527ab3452 1505 {
AzureIoTClient 55:59b527ab3452 1506 if (iotHubClientInstance->created_with_transport_handle != 0 || inboundDeviceMethodCallback == NULL)
AzureIoTClient 55:59b527ab3452 1507 {
AzureIoTClient 55:59b527ab3452 1508 /* Codes_SRS_IOTHUBCLIENT_07_008: [ If inboundDeviceMethodCallback is NULL, IoTHubClient_SetDeviceMethodCallback_Ex shall call IoTHubClient_LL_SetDeviceMethodCallback_Ex, passing NULL for the iothub_ll_inbound_device_method_callback. ] */
AzureIoTClient 55:59b527ab3452 1509 result = IoTHubClient_LL_SetDeviceMethodCallback_Ex(iotHubClientInstance->IoTHubClientLLHandle, NULL, NULL);
AzureIoTClient 55:59b527ab3452 1510 }
AzureIoTClient 55:59b527ab3452 1511 else
AzureIoTClient 55:59b527ab3452 1512 {
AzureIoTClient 55:59b527ab3452 1513 IOTHUB_QUEUE_CONTEXT* queue_context = (IOTHUB_QUEUE_CONTEXT*)malloc(sizeof(IOTHUB_QUEUE_CONTEXT));
AzureIoTClient 55:59b527ab3452 1514 if (queue_context == NULL)
AzureIoTClient 55:59b527ab3452 1515 {
AzureIoTClient 55:59b527ab3452 1516 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 55:59b527ab3452 1517 LogError("Failed allocating QUEUE_CONTEXT");
AzureIoTClient 55:59b527ab3452 1518 }
AzureIoTClient 55:59b527ab3452 1519 else
AzureIoTClient 55:59b527ab3452 1520 {
AzureIoTClient 55:59b527ab3452 1521 /*Codes_SRS_IOTHUBCLIENT_07_005: [ IoTHubClient_SetDeviceMethodCallback_Ex shall call IoTHubClient_LL_SetDeviceMethodCallback_Ex, while passing the IoTHubClient_LL_handle created by IoTHubClient_LL_Create along with the parameters iothub_ll_inbound_device_method_callback and IOTHUB_QUEUE_CONTEXT. ]*/
AzureIoTClient 55:59b527ab3452 1522 queue_context->iotHubClientHandle = iotHubClientInstance;
AzureIoTClient 55:59b527ab3452 1523 queue_context->userContextCallback = userContextCallback;
AzureIoTClient 55:59b527ab3452 1524 /* Codes_SRS_IOTHUBCLIENT_07_006: [ When IoTHubClient_LL_SetDeviceMethodCallback_Ex is called, IoTHubClient_SetDeviceMethodCallback_Ex shall return the result of IoTHubClient_LL_SetDeviceMethodCallback_Ex. ] */
AzureIoTClient 55:59b527ab3452 1525 result = IoTHubClient_LL_SetDeviceMethodCallback_Ex(iotHubClientInstance->IoTHubClientLLHandle, iothub_ll_inbound_device_method_callback, queue_context);
AzureIoTClient 55:59b527ab3452 1526 if (result != IOTHUB_CLIENT_OK)
AzureIoTClient 55:59b527ab3452 1527 {
AzureIoTClient 55:59b527ab3452 1528 LogError("IoTHubClient_LL_SetDeviceMethodCallback failed");
AzureIoTClient 55:59b527ab3452 1529 free(queue_context);
AzureIoTClient 55:59b527ab3452 1530 }
AzureIoTClient 55:59b527ab3452 1531 }
AzureIoTClient 55:59b527ab3452 1532 }
AzureIoTClient 55:59b527ab3452 1533 }
AzureIoTClient 55:59b527ab3452 1534
AzureIoTClient 55:59b527ab3452 1535 (void)Unlock(iotHubClientInstance->LockHandle);
AzureIoTClient 55:59b527ab3452 1536 }
AzureIoTClient 55:59b527ab3452 1537 }
AzureIoTClient 55:59b527ab3452 1538 return result;
AzureIoTClient 55:59b527ab3452 1539 }
AzureIoTClient 55:59b527ab3452 1540
AzureIoTClient 55:59b527ab3452 1541 IOTHUB_CLIENT_RESULT IoTHubClient_DeviceMethodResponse(IOTHUB_CLIENT_HANDLE iotHubClientHandle, METHOD_HANDLE methodId, const unsigned char* response, size_t respSize, int statusCode)
AzureIoTClient 55:59b527ab3452 1542 {
AzureIoTClient 55:59b527ab3452 1543 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 55:59b527ab3452 1544
AzureIoTClient 55:59b527ab3452 1545 /*Codes_SRS_IOTHUBCLIENT_12_012: [ If iotHubClientHandle is NULL, IoTHubClient_SetDeviceMethodCallback shall return IOTHUB_CLIENT_INVALID_ARG. ]*/
AzureIoTClient 55:59b527ab3452 1546 if (iotHubClientHandle == NULL)
AzureIoTClient 55:59b527ab3452 1547 {
AzureIoTClient 55:59b527ab3452 1548 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 55:59b527ab3452 1549 LogError("invalid arg (NULL)");
AzureIoTClient 55:59b527ab3452 1550 }
AzureIoTClient 55:59b527ab3452 1551 else
AzureIoTClient 55:59b527ab3452 1552 {
AzureIoTClient 55:59b527ab3452 1553 IOTHUB_CLIENT_INSTANCE* iotHubClientInstance = (IOTHUB_CLIENT_INSTANCE*)iotHubClientHandle;
AzureIoTClient 55:59b527ab3452 1554
AzureIoTClient 55:59b527ab3452 1555 /*Codes_SRS_IOTHUBCLIENT_12_018: [ IoTHubClient_SetDeviceMethodCallback shall be made thread-safe by using the lock created in IoTHubClient_Create. ]*/
AzureIoTClient 55:59b527ab3452 1556 if (Lock(iotHubClientInstance->LockHandle) != LOCK_OK)
AzureIoTClient 55:59b527ab3452 1557 {
AzureIoTClient 55:59b527ab3452 1558 /*Codes_SRS_IOTHUBCLIENT_12_013: [ If acquiring the lock fails, IoTHubClient_SetDeviceMethodCallback shall return IOTHUB_CLIENT_ERROR. ]*/
AzureIoTClient 55:59b527ab3452 1559 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 55:59b527ab3452 1560 LogError("Could not acquire lock");
AzureIoTClient 55:59b527ab3452 1561 }
AzureIoTClient 55:59b527ab3452 1562 else
AzureIoTClient 55:59b527ab3452 1563 {
AzureIoTClient 55:59b527ab3452 1564 result = IoTHubClient_LL_DeviceMethodResponse(iotHubClientInstance->IoTHubClientLLHandle, methodId, response, respSize, statusCode);
AzureIoTClient 55:59b527ab3452 1565 if (result != IOTHUB_CLIENT_OK)
AzureIoTClient 55:59b527ab3452 1566 {
AzureIoTClient 55:59b527ab3452 1567 LogError("IoTHubClient_LL_DeviceMethodResponse failed");
AzureIoTClient 55:59b527ab3452 1568 }
AzureIoTClient 55:59b527ab3452 1569 (void)Unlock(iotHubClientInstance->LockHandle);
AzureIoTClient 55:59b527ab3452 1570 }
AzureIoTClient 55:59b527ab3452 1571 }
AzureIoTClient 55:59b527ab3452 1572 return result;
AzureIoTClient 55:59b527ab3452 1573 }
AzureIoTClient 53:1e5a1ca1f274 1574
AzureIoTClient 44:33dd78697616 1575 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 42:448eecc3676e 1576 static int uploadingThread(void *data)
AzureIoTClient 42:448eecc3676e 1577 {
AzureIoTClient 42:448eecc3676e 1578 UPLOADTOBLOB_SAVED_DATA* savedData = (UPLOADTOBLOB_SAVED_DATA*)data;
AzureIoTClient 42:448eecc3676e 1579
AzureIoTClient 42:448eecc3676e 1580 /*it so happens that IoTHubClient_LL_UploadToBlob is thread-safe because there's no saved state in the handle and there are no globals, so no need to protect it*/
AzureIoTClient 42:448eecc3676e 1581 /*not having it protected means multiple simultaneous uploads can happen*/
AzureIoTClient 42:448eecc3676e 1582 /*Codes_SRS_IOTHUBCLIENT_02_054: [ The thread shall call IoTHubClient_LL_UploadToBlob passing the information packed in the structure. ]*/
AzureIoTClient 42:448eecc3676e 1583 if (IoTHubClient_LL_UploadToBlob(savedData->iotHubClientHandle->IoTHubClientLLHandle, savedData->destinationFileName, savedData->source, savedData->size) != IOTHUB_CLIENT_OK)
AzureIoTClient 42:448eecc3676e 1584 {
AzureIoTClient 42:448eecc3676e 1585 LogError("unable to IoTHubClient_LL_UploadToBlob");
AzureIoTClient 42:448eecc3676e 1586 /*call the callback*/
AzureIoTClient 42:448eecc3676e 1587 if (savedData->iotHubClientFileUploadCallback != NULL)
AzureIoTClient 42:448eecc3676e 1588 {
AzureIoTClient 42:448eecc3676e 1589 /*Codes_SRS_IOTHUBCLIENT_02_055: [ If IoTHubClient_LL_UploadToBlob fails then the thread shall call iotHubClientFileUploadCallbackInternal passing as result FILE_UPLOAD_ERROR and as context the structure from SRS IOTHUBCLIENT 02 051. ]*/
AzureIoTClient 42:448eecc3676e 1590 savedData->iotHubClientFileUploadCallback(FILE_UPLOAD_ERROR, savedData->context);
AzureIoTClient 42:448eecc3676e 1591 }
AzureIoTClient 42:448eecc3676e 1592 }
AzureIoTClient 42:448eecc3676e 1593 else
AzureIoTClient 42:448eecc3676e 1594 {
AzureIoTClient 42:448eecc3676e 1595 if (savedData->iotHubClientFileUploadCallback != NULL)
AzureIoTClient 42:448eecc3676e 1596 {
AzureIoTClient 42:448eecc3676e 1597 /*Codes_SRS_IOTHUBCLIENT_02_056: [ Otherwise the thread iotHubClientFileUploadCallbackInternal passing as result FILE_UPLOAD_OK and the structure from SRS IOTHUBCLIENT 02 051. ]*/
AzureIoTClient 42:448eecc3676e 1598 savedData->iotHubClientFileUploadCallback(FILE_UPLOAD_OK, savedData->context);
AzureIoTClient 42:448eecc3676e 1599 }
AzureIoTClient 42:448eecc3676e 1600 }
AzureIoTClient 42:448eecc3676e 1601
AzureIoTClient 42:448eecc3676e 1602 /*Codes_SRS_IOTHUBCLIENT_02_071: [ The thread shall mark itself as disposable. ]*/
AzureIoTClient 42:448eecc3676e 1603 if (Lock(savedData->lockGarbage) != LOCK_OK)
AzureIoTClient 42:448eecc3676e 1604 {
AzureIoTClient 42:448eecc3676e 1605 LogError("unable to Lock - trying anyway");
AzureIoTClient 42:448eecc3676e 1606 savedData->canBeGarbageCollected = 1;
AzureIoTClient 42:448eecc3676e 1607 }
AzureIoTClient 42:448eecc3676e 1608 else
AzureIoTClient 42:448eecc3676e 1609 {
AzureIoTClient 42:448eecc3676e 1610 savedData->canBeGarbageCollected = 1;
AzureIoTClient 42:448eecc3676e 1611
AzureIoTClient 42:448eecc3676e 1612 if (Unlock(savedData->lockGarbage) != LOCK_OK)
AzureIoTClient 42:448eecc3676e 1613 {
AzureIoTClient 42:448eecc3676e 1614 LogError("unable to Unlock after locking");
AzureIoTClient 42:448eecc3676e 1615 }
AzureIoTClient 42:448eecc3676e 1616 }
AzureIoTClient 42:448eecc3676e 1617 return 0;
AzureIoTClient 42:448eecc3676e 1618 }
AzureIoTClient 43:038d8511e817 1619 #endif
AzureIoTClient 42:448eecc3676e 1620
AzureIoTClient 44:33dd78697616 1621 #ifndef DONT_USE_UPLOADTOBLOB
AzureIoTClient 42:448eecc3676e 1622 IOTHUB_CLIENT_RESULT IoTHubClient_UploadToBlobAsync(IOTHUB_CLIENT_HANDLE iotHubClientHandle, const char* destinationFileName, const unsigned char* source, size_t size, IOTHUB_CLIENT_FILE_UPLOAD_CALLBACK iotHubClientFileUploadCallback, void* context)
AzureIoTClient 42:448eecc3676e 1623 {
AzureIoTClient 42:448eecc3676e 1624 IOTHUB_CLIENT_RESULT result;
AzureIoTClient 42:448eecc3676e 1625 /*Codes_SRS_IOTHUBCLIENT_02_047: [ If iotHubClientHandle is NULL then IoTHubClient_UploadToBlobAsync shall fail and return IOTHUB_CLIENT_INVALID_ARG. ]*/
AzureIoTClient 42:448eecc3676e 1626 /*Codes_SRS_IOTHUBCLIENT_02_048: [ If destinationFileName is NULL then IoTHubClient_UploadToBlobAsync shall fail and return IOTHUB_CLIENT_INVALID_ARG. ]*/
AzureIoTClient 42:448eecc3676e 1627 /*Codes_SRS_IOTHUBCLIENT_02_049: [ If source is NULL and size is greated than 0 then IoTHubClient_UploadToBlobAsync shall fail and return IOTHUB_CLIENT_INVALID_ARG. ]*/
AzureIoTClient 42:448eecc3676e 1628 if (
AzureIoTClient 42:448eecc3676e 1629 (iotHubClientHandle == NULL) ||
AzureIoTClient 42:448eecc3676e 1630 (destinationFileName == NULL) ||
AzureIoTClient 42:448eecc3676e 1631 ((source == NULL) && (size > 0))
AzureIoTClient 42:448eecc3676e 1632 )
AzureIoTClient 42:448eecc3676e 1633 {
AzureIoTClient 42:448eecc3676e 1634 LogError("invalid parameters IOTHUB_CLIENT_HANDLE iotHubClientHandle = %p , const char* destinationFileName = %s, const unsigned char* source= %p, size_t size = %zu, IOTHUB_CLIENT_FILE_UPLOAD_CALLBACK iotHubClientFileUploadCallback = %p, void* context = %p",
AzureIoTClient 42:448eecc3676e 1635 iotHubClientHandle,
AzureIoTClient 42:448eecc3676e 1636 destinationFileName,
AzureIoTClient 42:448eecc3676e 1637 source,
AzureIoTClient 42:448eecc3676e 1638 size,
AzureIoTClient 42:448eecc3676e 1639 iotHubClientFileUploadCallback,
AzureIoTClient 42:448eecc3676e 1640 context
AzureIoTClient 42:448eecc3676e 1641 );
AzureIoTClient 42:448eecc3676e 1642 result = IOTHUB_CLIENT_INVALID_ARG;
AzureIoTClient 42:448eecc3676e 1643 }
AzureIoTClient 42:448eecc3676e 1644 else
AzureIoTClient 42:448eecc3676e 1645 {
AzureIoTClient 42:448eecc3676e 1646 /*Codes_SRS_IOTHUBCLIENT_02_051: [IoTHubClient_UploadToBlobAsync shall copy the souce, size, iotHubClientFileUploadCallback, context into a structure.]*/
AzureIoTClient 42:448eecc3676e 1647 UPLOADTOBLOB_SAVED_DATA *savedData = (UPLOADTOBLOB_SAVED_DATA *)malloc(sizeof(UPLOADTOBLOB_SAVED_DATA));
AzureIoTClient 42:448eecc3676e 1648 if (savedData == NULL)
AzureIoTClient 42:448eecc3676e 1649 {
AzureIoTClient 42:448eecc3676e 1650 /*Codes_SRS_IOTHUBCLIENT_02_053: [ If copying to the structure or spawning the thread fails, then IoTHubClient_UploadToBlobAsync shall fail and return IOTHUB_CLIENT_ERROR. ]*/
AzureIoTClient 42:448eecc3676e 1651 LogError("unable to malloc - oom");
AzureIoTClient 42:448eecc3676e 1652 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 42:448eecc3676e 1653 }
AzureIoTClient 42:448eecc3676e 1654 else
AzureIoTClient 42:448eecc3676e 1655 {
AzureIoTClient 42:448eecc3676e 1656 if (mallocAndStrcpy_s((char**)&savedData->destinationFileName, destinationFileName) != 0)
AzureIoTClient 42:448eecc3676e 1657 {
AzureIoTClient 42:448eecc3676e 1658 /*Codes_SRS_IOTHUBCLIENT_02_053: [ If copying to the structure or spawning the thread fails, then IoTHubClient_UploadToBlobAsync shall fail and return IOTHUB_CLIENT_ERROR. ]*/
AzureIoTClient 42:448eecc3676e 1659 LogError("unable to mallocAndStrcpy_s");
AzureIoTClient 42:448eecc3676e 1660 free(savedData);
AzureIoTClient 42:448eecc3676e 1661 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 42:448eecc3676e 1662 }
AzureIoTClient 42:448eecc3676e 1663 else
AzureIoTClient 42:448eecc3676e 1664 {
AzureIoTClient 42:448eecc3676e 1665 savedData->size = size;
AzureIoTClient 42:448eecc3676e 1666 int sourceCloned;
AzureIoTClient 42:448eecc3676e 1667 if (size == 0)
AzureIoTClient 42:448eecc3676e 1668 {
AzureIoTClient 42:448eecc3676e 1669 savedData->source = NULL;
AzureIoTClient 42:448eecc3676e 1670 sourceCloned = 1;
AzureIoTClient 42:448eecc3676e 1671 }
AzureIoTClient 42:448eecc3676e 1672 else
AzureIoTClient 42:448eecc3676e 1673 {
AzureIoTClient 42:448eecc3676e 1674 savedData->source = (unsigned char*)malloc(size);
AzureIoTClient 42:448eecc3676e 1675 if (savedData->source == NULL)
AzureIoTClient 42:448eecc3676e 1676 {
AzureIoTClient 42:448eecc3676e 1677 /*Codes_SRS_IOTHUBCLIENT_02_053: [ If copying to the structure or spawning the thread fails, then IoTHubClient_UploadToBlobAsync shall fail and return IOTHUB_CLIENT_ERROR. ]*/
AzureIoTClient 42:448eecc3676e 1678 LogError("unable to malloc - oom");
AzureIoTClient 42:448eecc3676e 1679 free(savedData->destinationFileName);
AzureIoTClient 42:448eecc3676e 1680 free(savedData);
AzureIoTClient 42:448eecc3676e 1681 sourceCloned = 0;
AzureIoTClient 42:448eecc3676e 1682 }
AzureIoTClient 42:448eecc3676e 1683 else
AzureIoTClient 42:448eecc3676e 1684 {
AzureIoTClient 42:448eecc3676e 1685 sourceCloned = 1;
AzureIoTClient 42:448eecc3676e 1686 }
AzureIoTClient 42:448eecc3676e 1687 }
AzureIoTClient 42:448eecc3676e 1688
AzureIoTClient 42:448eecc3676e 1689 if (sourceCloned == 0)
AzureIoTClient 42:448eecc3676e 1690 {
AzureIoTClient 42:448eecc3676e 1691 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 42:448eecc3676e 1692 }
AzureIoTClient 42:448eecc3676e 1693 else
AzureIoTClient 42:448eecc3676e 1694 {
Azure.IoT.Build 54:6dcad9019a64 1695 IOTHUB_CLIENT_INSTANCE* iotHubClientHandleData = (IOTHUB_CLIENT_INSTANCE*)iotHubClientHandle;
Azure.IoT.Build 54:6dcad9019a64 1696
AzureIoTClient 42:448eecc3676e 1697 savedData->iotHubClientFileUploadCallback = iotHubClientFileUploadCallback;
AzureIoTClient 42:448eecc3676e 1698 savedData->context = context;
AzureIoTClient 58:15b0d29b2667 1699 (void)memcpy(savedData->source, source, size);
Azure.IoT.Build 54:6dcad9019a64 1700
AzureIoTClient 42:448eecc3676e 1701 if (Lock(iotHubClientHandleData->LockHandle) != LOCK_OK) /*locking because the next statement is changing blobThreadsToBeJoined*/
AzureIoTClient 42:448eecc3676e 1702 {
AzureIoTClient 42:448eecc3676e 1703 LogError("unable to lock");
AzureIoTClient 42:448eecc3676e 1704 free(savedData->source);
AzureIoTClient 42:448eecc3676e 1705 free(savedData->destinationFileName);
AzureIoTClient 42:448eecc3676e 1706 free(savedData);
AzureIoTClient 42:448eecc3676e 1707 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 42:448eecc3676e 1708 }
AzureIoTClient 42:448eecc3676e 1709 else
AzureIoTClient 42:448eecc3676e 1710 {
AzureIoTClient 42:448eecc3676e 1711 if ((result = StartWorkerThreadIfNeeded(iotHubClientHandleData)) != IOTHUB_CLIENT_OK)
AzureIoTClient 42:448eecc3676e 1712 {
AzureIoTClient 42:448eecc3676e 1713 free(savedData->source);
AzureIoTClient 42:448eecc3676e 1714 free(savedData->destinationFileName);
AzureIoTClient 42:448eecc3676e 1715 free(savedData);
AzureIoTClient 42:448eecc3676e 1716 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 42:448eecc3676e 1717 LogError("Could not start worker thread");
AzureIoTClient 42:448eecc3676e 1718 }
AzureIoTClient 42:448eecc3676e 1719 else
AzureIoTClient 42:448eecc3676e 1720 {
AzureIoTClient 42:448eecc3676e 1721 /*Codes_SRS_IOTHUBCLIENT_02_058: [ IoTHubClient_UploadToBlobAsync shall add the structure to the list of structures that need to be cleaned once file upload finishes. ]*/
AzureIoTClient 52:1cc3c6d07cad 1722 LIST_ITEM_HANDLE item = singlylinkedlist_add(iotHubClientHandleData->savedDataToBeCleaned, savedData);
AzureIoTClient 42:448eecc3676e 1723 if (item == NULL)
AzureIoTClient 42:448eecc3676e 1724 {
AzureIoTClient 52:1cc3c6d07cad 1725 LogError("unable to singlylinkedlist_add");
AzureIoTClient 42:448eecc3676e 1726 free(savedData->source);
AzureIoTClient 42:448eecc3676e 1727 free(savedData->destinationFileName);
AzureIoTClient 42:448eecc3676e 1728 free(savedData);
AzureIoTClient 42:448eecc3676e 1729 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 42:448eecc3676e 1730 }
AzureIoTClient 42:448eecc3676e 1731 else
AzureIoTClient 42:448eecc3676e 1732 {
AzureIoTClient 42:448eecc3676e 1733 savedData->iotHubClientHandle = iotHubClientHandle;
AzureIoTClient 42:448eecc3676e 1734 savedData->canBeGarbageCollected = 0;
AzureIoTClient 42:448eecc3676e 1735 if ((savedData->lockGarbage = Lock_Init()) == NULL)
AzureIoTClient 42:448eecc3676e 1736 {
AzureIoTClient 52:1cc3c6d07cad 1737 (void)singlylinkedlist_remove(iotHubClientHandleData->savedDataToBeCleaned, item);
AzureIoTClient 42:448eecc3676e 1738 free(savedData->source);
AzureIoTClient 42:448eecc3676e 1739 free(savedData->destinationFileName);
AzureIoTClient 42:448eecc3676e 1740 free(savedData);
AzureIoTClient 42:448eecc3676e 1741 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 42:448eecc3676e 1742 LogError("unable to Lock_Init");
AzureIoTClient 42:448eecc3676e 1743 }
AzureIoTClient 42:448eecc3676e 1744 else
AzureIoTClient 42:448eecc3676e 1745 {
AzureIoTClient 42:448eecc3676e 1746 /*Codes_SRS_IOTHUBCLIENT_02_052: [ IoTHubClient_UploadToBlobAsync shall spawn a thread passing the structure build in SRS IOTHUBCLIENT 02 051 as thread data.]*/
AzureIoTClient 42:448eecc3676e 1747 if (ThreadAPI_Create(&savedData->uploadingThreadHandle, uploadingThread, savedData) != THREADAPI_OK)
AzureIoTClient 42:448eecc3676e 1748 {
AzureIoTClient 42:448eecc3676e 1749 /*Codes_SRS_IOTHUBCLIENT_02_053: [ If copying to the structure or spawning the thread fails, then IoTHubClient_UploadToBlobAsync shall fail and return IOTHUB_CLIENT_ERROR. ]*/
AzureIoTClient 42:448eecc3676e 1750 LogError("unablet to ThreadAPI_Create");
AzureIoTClient 42:448eecc3676e 1751 (void)Lock_Deinit(savedData->lockGarbage);
AzureIoTClient 52:1cc3c6d07cad 1752 (void)singlylinkedlist_remove(iotHubClientHandleData->savedDataToBeCleaned, item);
AzureIoTClient 42:448eecc3676e 1753 free(savedData->source);
AzureIoTClient 42:448eecc3676e 1754 free(savedData->destinationFileName);
AzureIoTClient 42:448eecc3676e 1755 free(savedData);
AzureIoTClient 42:448eecc3676e 1756 result = IOTHUB_CLIENT_ERROR;
AzureIoTClient 42:448eecc3676e 1757 }
AzureIoTClient 42:448eecc3676e 1758 else
AzureIoTClient 42:448eecc3676e 1759 {
AzureIoTClient 42:448eecc3676e 1760 result = IOTHUB_CLIENT_OK;
AzureIoTClient 42:448eecc3676e 1761 }
AzureIoTClient 42:448eecc3676e 1762 }
AzureIoTClient 42:448eecc3676e 1763 }
AzureIoTClient 42:448eecc3676e 1764 }
AzureIoTClient 53:1e5a1ca1f274 1765 (void)Unlock(iotHubClientHandleData->LockHandle);
AzureIoTClient 42:448eecc3676e 1766 }
AzureIoTClient 42:448eecc3676e 1767 }
AzureIoTClient 42:448eecc3676e 1768 }
AzureIoTClient 42:448eecc3676e 1769 }
AzureIoTClient 42:448eecc3676e 1770 }
AzureIoTClient 42:448eecc3676e 1771 return result;
AzureIoTClient 42:448eecc3676e 1772 }
AzureIoTClient 44:33dd78697616 1773 #endif /*DONT_USE_UPLOADTOBLOB*/