Azure IoT / iothub_amqp_transport

Microsoft Azure IoTHub client AMQP transport

Dependents:   sht15_remote_monitoring RobotArmDemo iothub_client_sample_amqp iothub_client_sample_amqp ... more

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

iothubtransportamqp.c@26:ee14eed604f6, 2017-01-08 (annotated)

Committer:
AzureIoTClient
Date:
Sun Jan 08 11:11:13 2017 -0800
Revision:
26:ee14eed604f6
Parent:
25:63f7d371c030
Child:
30:20a85b733111
1.1.3

Who changed what in which revision?

UserRevisionLine numberNew contents of line
AzureIoTClient 4:57e049bce51e 1 // Copyright (c) Microsoft. All rights reserved.
AzureIoTClient 4:57e049bce51e 2 // Licensed under the MIT license. See LICENSE file in the project root for full license information.
AzureIoTClient 4:57e049bce51e 3
AzureIoTClient 25:63f7d371c030 4 #include "iothubtransportamqp.h"
AzureIoTClient 25:63f7d371c030 5 #include "iothubtransport_amqp_common.h"
Azure.IoT Build 12:841a4c36bd36 6 #include "azure_c_shared_utility/tlsio.h"
AzureIoTClient 25:63f7d371c030 7 #include "azure_c_shared_utility/platform.h"
AzureIoTClient 22:8b70cf813f25 8
Azure.IoT Build 7:07bc440836b3 9 #define RESULT_OK 0
Azure.IoT Build 7:07bc440836b3 10 #define DEFAULT_IOTHUB_AMQP_PORT 5671
AzureIoTClient 4:57e049bce51e 11
AzureIoTClient 25:63f7d371c030 12 static XIO_HANDLE getTLSIOTransport(const char* fqdn)
Azure.IoT Build 7:07bc440836b3 13 {
AzureIoTClient 20:8dec76e7ba34 14 XIO_HANDLE result;
AzureIoTClient 19:ea016664011a 15 TLSIO_CONFIG tls_io_config;
AzureIoTClient 19:ea016664011a 16 tls_io_config.hostname = fqdn;
AzureIoTClient 25:63f7d371c030 17 tls_io_config.port = DEFAULT_IOTHUB_AMQP_PORT;
AzureIoTClient 26:ee14eed604f6 18 // Codes_SRS_IOTHUBTRANSPORTAMQP_09_002: [getTLSIOTransport shall get `io_interface_description` using platform_get_default_tlsio())]
Azure.IoT Build 10:75c5e0d8537d 19 const IO_INTERFACE_DESCRIPTION* io_interface_description = platform_get_default_tlsio();
AzureIoTClient 4:57e049bce51e 20
AzureIoTClient 26:ee14eed604f6 21 // Codes_SRS_IOTHUBTRANSPORTAMQP_09_003: [If `io_interface_description` is NULL getTLSIOTransport shall return NULL.]
AzureIoTClient 26:ee14eed604f6 22 // Codes_SRS_IOTHUBTRANSPORTAMQP_09_004: [getTLSIOTransport shall return the XIO_HANDLE created using xio_create().]
AzureIoTClient 25:63f7d371c030 23 if ((result = xio_create(io_interface_description, &tls_io_config)) == NULL)
AzureIoTClient 19:ea016664011a 24 {
AzureIoTClient 25:63f7d371c030 25 LogError("Failed to get the TLS/IO transport (xio_create failed)");
AzureIoTClient 4:57e049bce51e 26 }
Azure.IoT Build 11:62d7b956e76e 27
Azure.IoT Build 7:07bc440836b3 28 return result;
AzureIoTClient 4:57e049bce51e 29 }
Azure.IoT Build 7:07bc440836b3 30
AzureIoTClient 25:63f7d371c030 31 // API functions
AzureIoTClient 25:63f7d371c030 32 static TRANSPORT_LL_HANDLE IoTHubTransportAMQP_Create(const IOTHUBTRANSPORT_CONFIG* config)
AzureIoTClient 4:57e049bce51e 33 {
AzureIoTClient 26:ee14eed604f6 34 // Codes_SRS_IOTHUBTRANSPORTAMQP_09_001: [IoTHubTransportAMQP_Create shall create a TRANSPORT_LL_HANDLE by calling into the IoTHubTransport_AMQP_Common_Create function, passing `config` and getTLSIOTransport.]
AzureIoTClient 26:ee14eed604f6 35 return IoTHubTransport_AMQP_Common_Create(config, getTLSIOTransport);
AzureIoTClient 20:8dec76e7ba34 36 }
AzureIoTClient 20:8dec76e7ba34 37
AzureIoTClient 25:63f7d371c030 38 static IOTHUB_PROCESS_ITEM_RESULT IoTHubTransportAMQP_ProcessItem(TRANSPORT_LL_HANDLE handle, IOTHUB_IDENTITY_TYPE item_type, IOTHUB_IDENTITY_INFO* iothub_item)
Azure.IoT Build 7:07bc440836b3 39 {
AzureIoTClient 26:ee14eed604f6 40 // Codes_SRS_IOTHUBTRANSPORTAMQP_09_014: [IoTHubTransportAMQP_ProcessItem shall invoke IoTHubTransport_AMQP_Common_ProcessItem() and return its result.]
AzureIoTClient 26:ee14eed604f6 41 return IoTHubTransport_AMQP_Common_ProcessItem(handle, item_type, iothub_item);
AzureIoTClient 4:57e049bce51e 42 }
AzureIoTClient 4:57e049bce51e 43
AzureIoTClient 25:63f7d371c030 44 static void IoTHubTransportAMQP_DoWork(TRANSPORT_LL_HANDLE handle, IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle)
AzureIoTClient 4:57e049bce51e 45 {
AzureIoTClient 26:ee14eed604f6 46 // Codes_SRS_IOTHUBTRANSPORTAMQP_09_015: [IoTHubTransportAMQP_DoWork shall call into the IoTHubTransport_AMQP_Common_DoWork()]
AzureIoTClient 26:ee14eed604f6 47 IoTHubTransport_AMQP_Common_DoWork(handle, iotHubClientHandle);
Azure.IoT Build 7:07bc440836b3 48 }
Azure.IoT Build 7:07bc440836b3 49
AzureIoTClient 25:63f7d371c030 50 static int IoTHubTransportAMQP_Subscribe(IOTHUB_DEVICE_HANDLE handle)
Azure.IoT Build 7:07bc440836b3 51 {
AzureIoTClient 26:ee14eed604f6 52 // Codes_SRS_IOTHUBTRANSPORTAMQP_09_012: [IoTHubTransportAMQP_Subscribe shall subscribe for D2C messages by calling into the IoTHubTransport_AMQP_Common_Subscribe().]
AzureIoTClient 26:ee14eed604f6 53 return IoTHubTransport_AMQP_Common_Subscribe(handle);
AzureIoTClient 4:57e049bce51e 54 }
AzureIoTClient 4:57e049bce51e 55
AzureIoTClient 25:63f7d371c030 56 static void IoTHubTransportAMQP_Unsubscribe(IOTHUB_DEVICE_HANDLE handle)
AzureIoTClient 19:ea016664011a 57 {
AzureIoTClient 26:ee14eed604f6 58 // Codes_SRS_IOTHUBTRANSPORTAMQP_09_013: [IoTHubTransportAMQP_Unsubscribe shall subscribe for D2C messages by calling into the IoTHubTransport_AMQP_Common_Unsubscribe().]
AzureIoTClient 26:ee14eed604f6 59 IoTHubTransport_AMQP_Common_Unsubscribe(handle);
AzureIoTClient 25:63f7d371c030 60 }
AzureIoTClient 25:63f7d371c030 61
AzureIoTClient 25:63f7d371c030 62 static int IoTHubTransportAMQP_Subscribe_DeviceTwin(IOTHUB_DEVICE_HANDLE handle)
AzureIoTClient 25:63f7d371c030 63 {
AzureIoTClient 26:ee14eed604f6 64 // Codes_SRS_IOTHUBTRANSPORTAMQP_09_008: [IoTHubTransportAMQP_Subscribe_DeviceTwin shall invoke IoTHubTransport_AMQP_Common_Subscribe_DeviceTwin() and return its result.]
AzureIoTClient 26:ee14eed604f6 65 return IoTHubTransport_AMQP_Common_Subscribe_DeviceTwin(handle);
AzureIoTClient 19:ea016664011a 66 }
AzureIoTClient 19:ea016664011a 67
AzureIoTClient 25:63f7d371c030 68 static void IoTHubTransportAMQP_Unsubscribe_DeviceTwin(IOTHUB_DEVICE_HANDLE handle)
AzureIoTClient 4:57e049bce51e 69 {
AzureIoTClient 26:ee14eed604f6 70 // Codes_SRS_IOTHUBTRANSPORTAMQP_09_009: [IoTHubTransportAMQP_Unsubscribe_DeviceTwin shall invoke IoTHubTransport_AMQP_Common_Unsubscribe_DeviceTwin()]
AzureIoTClient 26:ee14eed604f6 71 IoTHubTransport_AMQP_Common_Unsubscribe_DeviceTwin(handle);
AzureIoTClient 25:63f7d371c030 72 }
AzureIoTClient 4:57e049bce51e 73
AzureIoTClient 25:63f7d371c030 74 static int IoTHubTransportAMQP_Subscribe_DeviceMethod(IOTHUB_DEVICE_HANDLE handle)
AzureIoTClient 25:63f7d371c030 75 {
AzureIoTClient 26:ee14eed604f6 76 // Codes_SRS_IOTHUBTRANSPORTAMQP_09_010: [IoTHubTransportAMQP_Subscribe_DeviceMethod shall invoke IoTHubTransport_AMQP_Common_Subscribe_DeviceMethod() and return its result.]
AzureIoTClient 26:ee14eed604f6 77 return IoTHubTransport_AMQP_Common_Subscribe_DeviceMethod(handle);
AzureIoTClient 25:63f7d371c030 78 }
AzureIoTClient 4:57e049bce51e 79
AzureIoTClient 25:63f7d371c030 80 static void IoTHubTransportAMQP_Unsubscribe_DeviceMethod(IOTHUB_DEVICE_HANDLE handle)
AzureIoTClient 25:63f7d371c030 81 {
AzureIoTClient 26:ee14eed604f6 82 // Codes_SRS_IOTHUBTRANSPORTAMQP_09_011: [IoTHubTransportAMQP_Unsubscribe_DeviceMethod shall invoke IoTHubTransport_AMQP_Common_Unsubscribe_DeviceMethod()]
AzureIoTClient 26:ee14eed604f6 83 IoTHubTransport_AMQP_Common_Unsubscribe_DeviceMethod(handle);
AzureIoTClient 26:ee14eed604f6 84 }
AzureIoTClient 26:ee14eed604f6 85
AzureIoTClient 26:ee14eed604f6 86 static int IoTHubTransportAMQP_DeviceMethod_Response(IOTHUB_DEVICE_HANDLE handle, METHOD_HANDLE methodId, const unsigned char* response, size_t response_size, int status_response)
AzureIoTClient 26:ee14eed604f6 87 {
AzureIoTClient 26:ee14eed604f6 88 return IoTHubTransport_AMQP_Common_DeviceMethod_Response(handle, methodId, response, response_size, status_response);
AzureIoTClient 25:63f7d371c030 89 }
AzureIoTClient 19:ea016664011a 90
AzureIoTClient 25:63f7d371c030 91 static IOTHUB_CLIENT_RESULT IoTHubTransportAMQP_GetSendStatus(IOTHUB_DEVICE_HANDLE handle, IOTHUB_CLIENT_STATUS *iotHubClientStatus)
AzureIoTClient 25:63f7d371c030 92 {
AzureIoTClient 26:ee14eed604f6 93 // Codes_SRS_IOTHUBTRANSPORTAMQP_09_016: [IoTHubTransportAMQP_GetSendStatus shall get the send status by calling into the IoTHubTransport_AMQP_Common_GetSendStatus()]
AzureIoTClient 26:ee14eed604f6 94 return IoTHubTransport_AMQP_Common_GetSendStatus(handle, iotHubClientStatus);
AzureIoTClient 25:63f7d371c030 95 }
AzureIoTClient 19:ea016664011a 96
AzureIoTClient 25:63f7d371c030 97 static IOTHUB_CLIENT_RESULT IoTHubTransportAMQP_SetOption(TRANSPORT_LL_HANDLE handle, const char* option, const void* value)
AzureIoTClient 25:63f7d371c030 98 {
AzureIoTClient 26:ee14eed604f6 99 // Codes_SRS_IOTHUBTRANSPORTAMQP_09_017: [IoTHubTransportAMQP_SetOption shall set the options by calling into the IoTHubTransport_AMQP_Common_SetOption()]
AzureIoTClient 26:ee14eed604f6 100 return IoTHubTransport_AMQP_Common_SetOption(handle, option, value);
AzureIoTClient 25:63f7d371c030 101 }
AzureIoTClient 19:ea016664011a 102
AzureIoTClient 25:63f7d371c030 103 static IOTHUB_DEVICE_HANDLE IoTHubTransportAMQP_Register(TRANSPORT_LL_HANDLE handle, const IOTHUB_DEVICE_CONFIG* device, IOTHUB_CLIENT_LL_HANDLE iotHubClientHandle, PDLIST_ENTRY waitingToSend)
AzureIoTClient 25:63f7d371c030 104 {
AzureIoTClient 26:ee14eed604f6 105 // Codes_SRS_IOTHUBTRANSPORTAMQP_09_006: [IoTHubTransportAMQP_Register shall register the device by calling into the IoTHubTransport_AMQP_Common_Register().]
AzureIoTClient 26:ee14eed604f6 106 return IoTHubTransport_AMQP_Common_Register(handle, device, iotHubClientHandle, waitingToSend);
AzureIoTClient 25:63f7d371c030 107 }
Azure.IoT Build 7:07bc440836b3 108
AzureIoTClient 25:63f7d371c030 109 static void IoTHubTransportAMQP_Unregister(IOTHUB_DEVICE_HANDLE deviceHandle)
AzureIoTClient 25:63f7d371c030 110 {
AzureIoTClient 26:ee14eed604f6 111 // Codes_SRS_IOTHUBTRANSPORTAMQP_09_007: [IoTHubTransportAMQP_Unregister shall unregister the device by calling into the IoTHubTransport_AMQP_Common_Unregister().]
AzureIoTClient 26:ee14eed604f6 112 IoTHubTransport_AMQP_Common_Unregister(deviceHandle);
AzureIoTClient 4:57e049bce51e 113 }
AzureIoTClient 4:57e049bce51e 114
Azure.IoT Build 11:62d7b956e76e 115 static void IoTHubTransportAMQP_Destroy(TRANSPORT_LL_HANDLE handle)
AzureIoTClient 4:57e049bce51e 116 {
AzureIoTClient 26:ee14eed604f6 117 // Codes_SRS_IOTHUBTRANSPORTAMQP_09_005: [IoTHubTransportAMQP_Destroy shall destroy the TRANSPORT_LL_HANDLE by calling into the IoTHubTransport_AMQP_Common_Destroy().]
AzureIoTClient 26:ee14eed604f6 118 IoTHubTransport_AMQP_Common_Destroy(handle);
AzureIoTClient 4:57e049bce51e 119 }
AzureIoTClient 4:57e049bce51e 120
AzureIoTClient 25:63f7d371c030 121 static int IoTHubTransportAMQP_SetRetryPolicy(TRANSPORT_LL_HANDLE handle, IOTHUB_CLIENT_RETRY_POLICY retryPolicy, size_t retryTimeoutLimitInSeconds)
AzureIoTClient 4:57e049bce51e 122 {
AzureIoTClient 26:ee14eed604f6 123 return IoTHubTransport_AMQP_Common_SetRetryPolicy(handle, retryPolicy, retryTimeoutLimitInSeconds);
Azure.IoT Build 10:75c5e0d8537d 124 }
Azure.IoT Build 10:75c5e0d8537d 125
AzureIoTClient 17:597443dc65a4 126 static STRING_HANDLE IoTHubTransportAMQP_GetHostname(TRANSPORT_LL_HANDLE handle)
AzureIoTClient 17:597443dc65a4 127 {
AzureIoTClient 26:ee14eed604f6 128 // Codes_SRS_IOTHUBTRANSPORTAMQP_09_018: [IoTHubTransportAMQP_GetHostname shall get the hostname by calling into the IoTHubTransport_AMQP_Common_GetHostname()]
AzureIoTClient 26:ee14eed604f6 129 return IoTHubTransport_AMQP_Common_GetHostname(handle);
AzureIoTClient 17:597443dc65a4 130 }
AzureIoTClient 17:597443dc65a4 131
AzureIoTClient 25:63f7d371c030 132 static TRANSPORT_PROVIDER thisTransportProvider =
AzureIoTClient 25:63f7d371c030 133 {
AzureIoTClient 25:63f7d371c030 134 IoTHubTransportAMQP_Subscribe_DeviceMethod, /*pfIoTHubTransport_Subscribe_DeviceMethod IoTHubTransport_Subscribe_DeviceMethod;*/
AzureIoTClient 25:63f7d371c030 135 IoTHubTransportAMQP_Unsubscribe_DeviceMethod, /*pfIoTHubTransport_Unsubscribe_DeviceMethod IoTHubTransport_Unsubscribe_DeviceMethod;*/
AzureIoTClient 26:ee14eed604f6 136 IoTHubTransportAMQP_DeviceMethod_Response,
AzureIoTClient 25:63f7d371c030 137 IoTHubTransportAMQP_Subscribe_DeviceTwin, /*pfIoTHubTransport_Subscribe_DeviceTwin IoTHubTransport_Subscribe_DeviceTwin;*/
AzureIoTClient 25:63f7d371c030 138 IoTHubTransportAMQP_Unsubscribe_DeviceTwin, /*pfIoTHubTransport_Unsubscribe_DeviceTwin IoTHubTransport_Unsubscribe_DeviceTwin;*/
AzureIoTClient 25:63f7d371c030 139 IoTHubTransportAMQP_ProcessItem, /*pfIoTHubTransport_ProcessItem IoTHubTransport_ProcessItem;*/
AzureIoTClient 25:63f7d371c030 140 IoTHubTransportAMQP_GetHostname, /*pfIoTHubTransport_GetHostname IoTHubTransport_GetHostname;*/
AzureIoTClient 25:63f7d371c030 141 IoTHubTransportAMQP_SetOption, /*pfIoTHubTransport_SetOption IoTHubTransport_SetOption;*/
AzureIoTClient 25:63f7d371c030 142 IoTHubTransportAMQP_Create, /*pfIoTHubTransport_Create IoTHubTransport_Create;*/
AzureIoTClient 25:63f7d371c030 143 IoTHubTransportAMQP_Destroy, /*pfIoTHubTransport_Destroy IoTHubTransport_Destroy;*/
AzureIoTClient 25:63f7d371c030 144 IoTHubTransportAMQP_Register, /*pfIotHubTransport_Register IoTHubTransport_Register;*/
AzureIoTClient 25:63f7d371c030 145 IoTHubTransportAMQP_Unregister, /*pfIotHubTransport_Unregister IoTHubTransport_Unegister;*/
AzureIoTClient 25:63f7d371c030 146 IoTHubTransportAMQP_Subscribe, /*pfIoTHubTransport_Subscribe IoTHubTransport_Subscribe;*/
AzureIoTClient 25:63f7d371c030 147 IoTHubTransportAMQP_Unsubscribe, /*pfIoTHubTransport_Unsubscribe IoTHubTransport_Unsubscribe;*/
AzureIoTClient 25:63f7d371c030 148 IoTHubTransportAMQP_DoWork, /*pfIoTHubTransport_DoWork IoTHubTransport_DoWork;*/
AzureIoTClient 25:63f7d371c030 149 IoTHubTransportAMQP_SetRetryPolicy, /*pfIoTHubTransport_DoWork IoTHubTransport_SetRetryPolicy;*/
AzureIoTClient 25:63f7d371c030 150 IoTHubTransportAMQP_GetSendStatus /*pfIoTHubTransport_GetSendStatus IoTHubTransport_GetSendStatus;*/
AzureIoTClient 4:57e049bce51e 151 };
AzureIoTClient 4:57e049bce51e 152
AzureIoTClient 25:63f7d371c030 153 /* Codes_SRS_IOTHUBTRANSPORTAMQP_09_019: [This function shall return a pointer to a structure of type TRANSPORT_PROVIDER having the following values for it's fields:
AzureIoTClient 25:63f7d371c030 154 IoTHubTransport_Subscribe_DeviceMethod = IoTHubTransportAMQP_Subscribe_DeviceMethod
AzureIoTClient 25:63f7d371c030 155 IoTHubTransport_Unsubscribe_DeviceMethod = IoTHubTransportAMQP_Unsubscribe_DeviceMethod
AzureIoTClient 25:63f7d371c030 156 IoTHubTransport_Subscribe_DeviceTwin = IoTHubTransportAMQP_Subscribe_DeviceTwin
AzureIoTClient 25:63f7d371c030 157 IoTHubTransport_Unsubscribe_DeviceTwin = IoTHubTransportAMQP_Unsubscribe_DeviceTwin
AzureIoTClient 25:63f7d371c030 158 IoTHubTransport_ProcessItem - IoTHubTransportAMQP_ProcessItem
AzureIoTClient 25:63f7d371c030 159 IoTHubTransport_GetHostname = IoTHubTransportAMQP_GetHostname
AzureIoTClient 25:63f7d371c030 160 IoTHubTransport_Create = IoTHubTransportAMQP_Create
AzureIoTClient 25:63f7d371c030 161 IoTHubTransport_Destroy = IoTHubTransportAMQP_Destroy
AzureIoTClient 25:63f7d371c030 162 IoTHubTransport_Subscribe = IoTHubTransportAMQP_Subscribe
AzureIoTClient 25:63f7d371c030 163 IoTHubTransport_Unsubscribe = IoTHubTransportAMQP_Unsubscribe
AzureIoTClient 25:63f7d371c030 164 IoTHubTransport_DoWork = IoTHubTransportAMQP_DoWork
AzureIoTClient 25:63f7d371c030 165 IoTHubTransport_SetOption = IoTHubTransportAMQP_SetOption]*/
AzureIoTClient 17:597443dc65a4 166 extern const TRANSPORT_PROVIDER* AMQP_Protocol(void)
AzureIoTClient 4:57e049bce51e 167 {
Azure.IoT Build 7:07bc440836b3 168 return &thisTransportProvider;
AzureIoTClient 4:57e049bce51e 169 }