Azure IoT / iothub_mqtt_transport

Microsoft Azure IoTHub client MQTT transport

Dependents:   STM32F746_iothub_client_sample_mqtt FXOS8700CQ_To_Azure_IoT f767zi_mqtt FXOS8700CQ_To_Azure_IoT ... more

iothubtransportmqtt.c@19:f87dfe76bc70, 2017-03-10 (annotated)

Committer:
AzureIoTClient
Date:
Fri Mar 10 11:47:21 2017 -0800
Revision:
19:f87dfe76bc70
Parent:
16:14640ee83e99
Child:
20:594780be216d
1.1.9

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Azure.IoT Build 0:5e72a75c31b8 1 // Copyright (c) Microsoft. All rights reserved.
Azure.IoT Build 0:5e72a75c31b8 2 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
Azure.IoT Build 0:5e72a75c31b8 3
Azure.IoT Build 0:5e72a75c31b8 4 #include <stdlib.h>
Azure.IoT Build 0:5e72a75c31b8 5 #include "iothubtransportmqtt.h"
AzureIoTClient 11:31ebaeb51e1e 6 #include "azure_c_shared_utility/xio.h"
Azure.IoT Build 1:f2e563755d91 7 #include "azure_c_shared_utility/tlsio.h"
Azure.IoT Build 1:f2e563755d91 8 #include "azure_c_shared_utility/platform.h"
AzureIoTClient 11:31ebaeb51e1e 9 #include "iothubtransport_mqtt_common.h"
AzureIoTClient 7:7fdd306e6224 10
AzureIoTClient 19:f87dfe76bc70 11
AzureIoTClient 11:31ebaeb51e1e 12 static XIO_HANDLE getIoTransportProvider(const char* fqdn)
AzureIoTClient 6:16875b609849 13 {
AzureIoTClient 11:31ebaeb51e1e 14 XIO_HANDLE result;
AzureIoTClient 11:31ebaeb51e1e 15 const IO_INTERFACE_DESCRIPTION* io_interface_description = platform_get_default_tlsio();
AzureIoTClient 11:31ebaeb51e1e 16 if (io_interface_description == NULL)
AzureIoTClient 4:e472f5ce3473 17 {
AzureIoTClient 11:31ebaeb51e1e 18 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_013: [ If platform_get_default_tlsio returns NULL getIoTransportProvider shall return NULL. ] */
AzureIoTClient 11:31ebaeb51e1e 19 LogError("Failure constructing the provider interface");
AzureIoTClient 4:e472f5ce3473 20 result = NULL;
AzureIoTClient 4:e472f5ce3473 21 }
AzureIoTClient 4:e472f5ce3473 22 else
AzureIoTClient 4:e472f5ce3473 23 {
AzureIoTClient 11:31ebaeb51e1e 24 TLSIO_CONFIG tls_io_config;
AzureIoTClient 11:31ebaeb51e1e 25 tls_io_config.hostname = fqdn;
AzureIoTClient 11:31ebaeb51e1e 26 tls_io_config.port = 8883;
AzureIoTClient 19:f87dfe76bc70 27 tls_io_config.underlying_io_interface = NULL;
AzureIoTClient 19:f87dfe76bc70 28 tls_io_config.underlying_io_parameters = NULL;
AzureIoTClient 11:31ebaeb51e1e 29 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_012: [ getIoTransportProvider shall return the XIO_HANDLE returns by xio_create. ] */
AzureIoTClient 11:31ebaeb51e1e 30 result = xio_create(io_interface_description, &tls_io_config);
AzureIoTClient 2:9db4da50abaa 31 }
AzureIoTClient 4:e472f5ce3473 32 return result;
Azure.IoT Build 0:5e72a75c31b8 33 }
Azure.IoT Build 0:5e72a75c31b8 34
AzureIoTClient 4:e472f5ce3473 35 static TRANSPORT_LL_HANDLE IoTHubTransportMqtt_Create(const IOTHUBTRANSPORT_CONFIG* config)
Azure.IoT Build 0:5e72a75c31b8 36 {
AzureIoTClient 11:31ebaeb51e1e 37 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_001: [IoTHubTransportMqtt_Create shall create a TRANSPORT_LL_HANDLE by calling into the IoTHubMqttAbstract_Create function.] */
AzureIoTClient 11:31ebaeb51e1e 38 return IoTHubTransport_MQTT_Common_Create(config, getIoTransportProvider);
Azure.IoT Build 0:5e72a75c31b8 39 }
Azure.IoT Build 0:5e72a75c31b8 40
AzureIoTClient 4:e472f5ce3473 41 static void IoTHubTransportMqtt_Destroy(TRANSPORT_LL_HANDLE handle)
Azure.IoT Build 0:5e72a75c31b8 42 {
AzureIoTClient 11:31ebaeb51e1e 43 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_002: [ IoTHubTransportMqtt_Destroy shall destroy the TRANSPORT_LL_HANDLE by calling into the IoTHubMqttAbstract_Destroy function. ] */
AzureIoTClient 11:31ebaeb51e1e 44 IoTHubTransport_MQTT_Common_Destroy(handle);
Azure.IoT Build 0:5e72a75c31b8 45 }
Azure.IoT Build 0:5e72a75c31b8 46
AzureIoTClient 4:e472f5ce3473 47 static int IoTHubTransportMqtt_Subscribe(IOTHUB_DEVICE_HANDLE handle)
Azure.IoT Build 0:5e72a75c31b8 48 {
AzureIoTClient 11:31ebaeb51e1e 49 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_005: [ IoTHubTransportMqtt_Subscribe shall subscribe the TRANSPORT_LL_HANDLE by calling into the IoTHubMqttAbstract_Subscribe function. ] */
AzureIoTClient 11:31ebaeb51e1e 50 return IoTHubTransport_MQTT_Common_Subscribe(handle);
Azure.IoT Build 0:5e72a75c31b8 51 }
Azure.IoT Build 0:5e72a75c31b8 52
AzureIoTClient 4:e472f5ce3473 53 static void IoTHubTransportMqtt_Unsubscribe(IOTHUB_DEVICE_HANDLE handle)
Azure.IoT Build 0:5e72a75c31b8 54 {
AzureIoTClient 11:31ebaeb51e1e 55 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_006: [ IoTHubTransportMqtt_Unsubscribe shall unsubscribe the TRANSPORT_LL_HANDLE by calling into the IoTHubMqttAbstract_Unsubscribe function. ] */
AzureIoTClient 11:31ebaeb51e1e 56 IoTHubTransport_MQTT_Common_Unsubscribe(handle);
Azure.IoT Build 0:5e72a75c31b8 57 }
Azure.IoT Build 0:5e72a75c31b8 58
AzureIoTClient 14:4dc2b011be33 59 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_026: [ IoTHubTransportMqtt_Subscribe_DeviceMethod shall subscribe the TRANSPORT_LL_HANDLE by calling into the IoTHubMqttAbstract_Subscribe_DeviceMethod function. ] */
AzureIoTClient 12:658ca6865de2 60 static int IoTHubTransportMqtt_Subscribe_DeviceMethod(IOTHUB_DEVICE_HANDLE handle)
AzureIoTClient 12:658ca6865de2 61 {
AzureIoTClient 12:658ca6865de2 62 return IoTHubTransport_MQTT_Common_Subscribe_DeviceMethod(handle);
AzureIoTClient 12:658ca6865de2 63 }
AzureIoTClient 12:658ca6865de2 64
AzureIoTClient 14:4dc2b011be33 65 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_027: [ IoTHubTransportMqtt_Unsubscribe_DeviceMethod shall call into the IoTHubMqttAbstract_Unsubscribe_DeviceMethod function. ] */
AzureIoTClient 12:658ca6865de2 66 static void IoTHubTransportMqtt_Unsubscribe_DeviceMethod(IOTHUB_DEVICE_HANDLE handle)
AzureIoTClient 12:658ca6865de2 67 {
AzureIoTClient 12:658ca6865de2 68 IoTHubTransport_MQTT_Common_Unsubscribe_DeviceMethod(handle);
AzureIoTClient 12:658ca6865de2 69 }
AzureIoTClient 12:658ca6865de2 70
AzureIoTClient 14:4dc2b011be33 71 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_025: [ IoTHubTransportMqtt_Subscribe_DeviceTwin shall call into the IoTHubMqttAbstract_Subscribe_DeviceTwin function. ] */
AzureIoTClient 12:658ca6865de2 72 static int IoTHubTransportMqtt_Subscribe_DeviceTwin(IOTHUB_DEVICE_HANDLE handle)
AzureIoTClient 12:658ca6865de2 73 {
AzureIoTClient 12:658ca6865de2 74 return IoTHubTransport_MQTT_Common_Subscribe_DeviceTwin(handle);
AzureIoTClient 12:658ca6865de2 75 }
AzureIoTClient 12:658ca6865de2 76
AzureIoTClient 14:4dc2b011be33 77 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_024: [ IoTHubTransportMqtt_Unsubscribe_DeviceTwin shall shall call into the IoTHubMqttAbstract_Unsubscribe_DeviceTwin function. ] */
AzureIoTClient 12:658ca6865de2 78 static void IoTHubTransportMqtt_Unsubscribe_DeviceTwin(IOTHUB_DEVICE_HANDLE handle)
AzureIoTClient 12:658ca6865de2 79 {
AzureIoTClient 12:658ca6865de2 80 IoTHubTransport_MQTT_Common_Unsubscribe_DeviceTwin(handle);
AzureIoTClient 12:658ca6865de2 81 }
AzureIoTClient 12:658ca6865de2 82
AzureIoTClient 14:4dc2b011be33 83 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_023: [ IoTHubTransportMqtt_DeviceMethod_Response shall call into the IoTHubMqttAbstract_DeviceMethod_Response function. ] */
AzureIoTClient 14:4dc2b011be33 84 static int IoTHubTransportMqtt_DeviceMethod_Response(IOTHUB_DEVICE_HANDLE handle, METHOD_HANDLE methodId, const unsigned char* response, size_t response_size, int status_response)
AzureIoTClient 14:4dc2b011be33 85 {
AzureIoTClient 14:4dc2b011be33 86 return IoTHubTransport_MQTT_Common_DeviceMethod_Response(handle, methodId, response, response_size, status_response);
AzureIoTClient 14:4dc2b011be33 87 }
AzureIoTClient 14:4dc2b011be33 88
AzureIoTClient 19:f87dfe76bc70 89 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_10_001: [IoTHubTransportMqtt_SendMessageDisposition shall send the message disposition by calling into the IoTHubMqttAbstract_SendMessageDisposition function.] */
AzureIoTClient 19:f87dfe76bc70 90 static IOTHUB_CLIENT_RESULT IoTHubTransportMqtt_SendMessageDisposition(MESSAGE_CALLBACK_INFO* message_data, IOTHUBMESSAGE_DISPOSITION_RESULT disposition)
AzureIoTClient 19:f87dfe76bc70 91 {
AzureIoTClient 19:f87dfe76bc70 92 return IoTHubTransport_MQTT_Common_SendMessageDisposition(message_data, disposition);
AzureIoTClient 19:f87dfe76bc70 93 }
AzureIoTClient 19:f87dfe76bc70 94
AzureIoTClient 12:658ca6865de2 95 static IOTHUB_PROCESS_ITEM_RESULT IoTHubTransportMqtt_ProcessItem(TRANSPORT_LL_HANDLE handle, IOTHUB_IDENTITY_TYPE item_type, IOTHUB_IDENTITY_INFO* iothub_item)
AzureIoTClient 12:658ca6865de2 96 {
AzureIoTClient 12:658ca6865de2 97 return IoTHubTransport_MQTT_Common_ProcessItem(handle, item_type, iothub_item);
AzureIoTClient 12:658ca6865de2 98 }
AzureIoTClient 12:658ca6865de2 99
AzureIoTClient 12:658ca6865de2 100 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_054: [ IoTHubTransportMqtt_DoWork shall subscribe to the Notification and get_state Topics if they are defined. ] */
AzureIoTClient 4:e472f5ce3473 101 static void IoTHubTransportMqtt_DoWork(TRANSPORT_LL_HANDLE handle, IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle)
Azure.IoT Build 0:5e72a75c31b8 102 {
AzureIoTClient 11:31ebaeb51e1e 103 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_007: [ IoTHubTransportMqtt_DoWork shall call into the IoTHubMqttAbstract_DoWork function. ] */
AzureIoTClient 11:31ebaeb51e1e 104 IoTHubTransport_MQTT_Common_DoWork(handle, iotHubClientHandle);
Azure.IoT Build 0:5e72a75c31b8 105 }
Azure.IoT Build 0:5e72a75c31b8 106
AzureIoTClient 12:658ca6865de2 107 static int IoTHubTransportMqtt_SetRetryPolicy(TRANSPORT_LL_HANDLE handle, IOTHUB_CLIENT_RETRY_POLICY retryPolicy, size_t retryTimeoutLimitInSeconds)
AzureIoTClient 12:658ca6865de2 108 {
AzureIoTClient 12:658ca6865de2 109 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_25_012: [** IoTHubTransportMqtt_SetRetryPolicy shall call into the IoTHubMqttAbstract_SetRetryPolicy function. ] */
AzureIoTClient 12:658ca6865de2 110 return IoTHubTransport_MQTT_Common_SetRetryPolicy(handle, retryPolicy, retryTimeoutLimitInSeconds);
AzureIoTClient 12:658ca6865de2 111 }
AzureIoTClient 12:658ca6865de2 112
AzureIoTClient 4:e472f5ce3473 113 static IOTHUB_CLIENT_RESULT IoTHubTransportMqtt_GetSendStatus(IOTHUB_DEVICE_HANDLE handle, IOTHUB_CLIENT_STATUS *iotHubClientStatus)
Azure.IoT Build 0:5e72a75c31b8 114 {
AzureIoTClient 11:31ebaeb51e1e 115 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_008: [ IoTHubTransportMqtt_GetSendStatus shall get the send status by calling into the IoTHubMqttAbstract_GetSendStatus function. ] */
AzureIoTClient 11:31ebaeb51e1e 116 return IoTHubTransport_MQTT_Common_GetSendStatus(handle, iotHubClientStatus);
Azure.IoT Build 0:5e72a75c31b8 117 }
Azure.IoT Build 0:5e72a75c31b8 118
AzureIoTClient 4:e472f5ce3473 119 static IOTHUB_CLIENT_RESULT IoTHubTransportMqtt_SetOption(TRANSPORT_LL_HANDLE handle, const char* option, const void* value)
Azure.IoT Build 0:5e72a75c31b8 120 {
AzureIoTClient 11:31ebaeb51e1e 121 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_009: [ IoTHubTransportMqtt_SetOption shall set the options by calling into the IoTHubMqttAbstract_SetOption function. ] */
AzureIoTClient 11:31ebaeb51e1e 122 return IoTHubTransport_MQTT_Common_SetOption(handle, option, value);
Azure.IoT Build 0:5e72a75c31b8 123 }
Azure.IoT Build 0:5e72a75c31b8 124
AzureIoTClient 4:e472f5ce3473 125 static IOTHUB_DEVICE_HANDLE IoTHubTransportMqtt_Register(TRANSPORT_LL_HANDLE handle, const IOTHUB_DEVICE_CONFIG* device, IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, PDLIST_ENTRY waitingToSend)
Azure.IoT Build 0:5e72a75c31b8 126 {
AzureIoTClient 11:31ebaeb51e1e 127 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_003: [ IoTHubTransportMqtt_Register shall register the TRANSPORT_LL_HANDLE by calling into the IoTHubMqttAbstract_Register function. ] */
AzureIoTClient 11:31ebaeb51e1e 128 return IoTHubTransport_MQTT_Common_Register(handle, device, iotHubClientHandle, waitingToSend);
Azure.IoT Build 0:5e72a75c31b8 129 }
Azure.IoT Build 0:5e72a75c31b8 130
AzureIoTClient 4:e472f5ce3473 131 static void IoTHubTransportMqtt_Unregister(IOTHUB_DEVICE_HANDLE deviceHandle)
Azure.IoT Build 0:5e72a75c31b8 132 {
AzureIoTClient 11:31ebaeb51e1e 133 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_004: [ IoTHubTransportMqtt_Unregister shall register the TRANSPORT_LL_HANDLE by calling into the IoTHubMqttAbstract_Unregister function. ] */
AzureIoTClient 11:31ebaeb51e1e 134 IoTHubTransport_MQTT_Common_Unregister(deviceHandle);
Azure.IoT Build 0:5e72a75c31b8 135 }
Azure.IoT Build 0:5e72a75c31b8 136
AzureIoTClient 4:e472f5ce3473 137 static STRING_HANDLE IoTHubTransportMqtt_GetHostname(TRANSPORT_LL_HANDLE handle)
AzureIoTClient 4:e472f5ce3473 138 {
AzureIoTClient 11:31ebaeb51e1e 139 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_010: [ IoTHubTransportMqtt_GetHostname shall get the hostname by calling into the IoTHubMqttAbstract_GetHostname function. ] */
AzureIoTClient 11:31ebaeb51e1e 140 return IoTHubTransport_MQTT_Common_GetHostname(handle);
AzureIoTClient 4:e472f5ce3473 141 }
AzureIoTClient 4:e472f5ce3473 142
AzureIoTClient 12:658ca6865de2 143 static TRANSPORT_PROVIDER myfunc =
AzureIoTClient 12:658ca6865de2 144 {
AzureIoTClient 19:f87dfe76bc70 145 IoTHubTransportMqtt_SendMessageDisposition, /*pfIotHubTransport_SendMessageDisposition IoTHubTransport_SendMessageDisposition;*/
AzureIoTClient 12:658ca6865de2 146 IoTHubTransportMqtt_Subscribe_DeviceMethod, /*pfIoTHubTransport_Subscribe_DeviceMethod IoTHubTransport_Subscribe_DeviceMethod;*/
AzureIoTClient 12:658ca6865de2 147 IoTHubTransportMqtt_Unsubscribe_DeviceMethod, /*pfIoTHubTransport_Unsubscribe_DeviceMethod IoTHubTransport_Unsubscribe_DeviceMethod;*/
AzureIoTClient 14:4dc2b011be33 148 IoTHubTransportMqtt_DeviceMethod_Response, /*pfIoTHubTransport_DeviceMethod_Response IoTHubTransport_DeviceMethod_Response;*/
AzureIoTClient 12:658ca6865de2 149 IoTHubTransportMqtt_Subscribe_DeviceTwin, /*pfIoTHubTransport_Subscribe_DeviceTwin IoTHubTransport_Subscribe_DeviceTwin;*/
AzureIoTClient 12:658ca6865de2 150 IoTHubTransportMqtt_Unsubscribe_DeviceTwin, /*pfIoTHubTransport_Unsubscribe_DeviceTwin IoTHubTransport_Unsubscribe_DeviceTwin;*/
AzureIoTClient 12:658ca6865de2 151 IoTHubTransportMqtt_ProcessItem, /*pfIoTHubTransport_ProcessItem IoTHubTransport_ProcessItem;*/
AzureIoTClient 12:658ca6865de2 152 IoTHubTransportMqtt_GetHostname, /*pfIoTHubTransport_GetHostname IoTHubTransport_GetHostname;*/
AzureIoTClient 12:658ca6865de2 153 IoTHubTransportMqtt_SetOption, /*pfIoTHubTransport_SetOption IoTHubTransport_SetOption;*/
AzureIoTClient 12:658ca6865de2 154 IoTHubTransportMqtt_Create, /*pfIoTHubTransport_Create IoTHubTransport_Create;*/
AzureIoTClient 12:658ca6865de2 155 IoTHubTransportMqtt_Destroy, /*pfIoTHubTransport_Destroy IoTHubTransport_Destroy;*/
AzureIoTClient 12:658ca6865de2 156 IoTHubTransportMqtt_Register, /*pfIotHubTransport_Register IoTHubTransport_Register;*/
AzureIoTClient 12:658ca6865de2 157 IoTHubTransportMqtt_Unregister, /*pfIotHubTransport_Unregister IoTHubTransport_Unegister;*/
AzureIoTClient 12:658ca6865de2 158 IoTHubTransportMqtt_Subscribe, /*pfIoTHubTransport_Subscribe IoTHubTransport_Subscribe;*/
AzureIoTClient 12:658ca6865de2 159 IoTHubTransportMqtt_Unsubscribe, /*pfIoTHubTransport_Unsubscribe IoTHubTransport_Unsubscribe;*/
AzureIoTClient 12:658ca6865de2 160 IoTHubTransportMqtt_DoWork, /*pfIoTHubTransport_DoWork IoTHubTransport_DoWork;*/
AzureIoTClient 12:658ca6865de2 161 IoTHubTransportMqtt_SetRetryPolicy, /*pfIoTHubTransport_DoWork IoTHubTransport_SetRetryPolicy;*/
AzureIoTClient 12:658ca6865de2 162 IoTHubTransportMqtt_GetSendStatus /*pfIoTHubTransport_GetSendStatus IoTHubTransport_GetSendStatus;*/
Azure.IoT Build 0:5e72a75c31b8 163 };
Azure.IoT Build 0:5e72a75c31b8 164
AzureIoTClient 12:658ca6865de2 165 /* Codes_SRS_IOTHUB_MQTT_TRANSPORT_07_022: [This function shall return a pointer to a structure of type TRANSPORT_PROVIDER */
AzureIoTClient 12:658ca6865de2 166 extern const TRANSPORT_PROVIDER* MQTT_Protocol(void)
Azure.IoT Build 0:5e72a75c31b8 167 {
AzureIoTClient 4:e472f5ce3473 168 return &myfunc;
Azure.IoT Build 0:5e72a75c31b8 169 }