1 /* *****************************************************************
3 * Copyright 2015 Samsung Electronics All Rights Reserved.
7 * Licensed under the Apache License, Version 2.0 (the "License");
8 * you may not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
11 * http://www.apache.org/licenses/LICENSE-2.0
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS,
15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
19 ******************************************************************/
24 * This file contains the APIs for adapters to be implemented.
27 #ifndef CA_ADAPTER_INTERFACE_H_
28 #define CA_ADAPTER_INTERFACE_H_
38 * Starting connectivity adapters and each adapter have transport specific behavior.
39 * Transport Specific Behavior:
40 * WIFI/ETH connectivity Starts unicast server on all available IPs and defined
41 * port number as per specification.
42 * EDR will not start any specific servers.
43 * LE will not start any specific servers.
44 * @return ::CA_STATUS_OK or ::CA_STATUS_FAILED
45 * ERROR CODES (::CAResult_t error codes in cacommon.h).
47 typedef CAResult_t (*CAAdapterStart)();
50 * Starting listening server for receiving multicast search requests
51 * Transport Specific Behavior:
52 * WIFI/ETH Starts multicast server on all available IPs and defined
53 * port number and as per specification.
54 * EDR Starts RFCOMM Server with prefixed UUID as per specification.
55 * LE Start GATT Server with prefixed UUID and Characteristics as per OIC Specification.
56 * @return ::CA_STATUS_OK or ::CA_STATUS_FAILED
57 * ERROR CODES (::CAResult_t error codes in cacommon.h).
59 typedef CAResult_t (*CAAdapterStartListeningServer)();
62 * for starting discovery servers for receiving multicast advertisements
63 * Transport Specific Behavior:
64 * WIFI/ETH Starts multicast server on all available IPs and defined port
65 * number as per OIC Specification.
66 * EDR Starts RFCOMM Server with prefixed UUID as per OIC Specification.
67 * LE Starts GATT Server with prefixed UUID and Characteristics as per OIC Specification.
68 * @return ::CA_STATUS_OK or ::CA_STATUS_FAILED
69 * ERROR CODES (::CAResult_t error codes in cacommon.h).
71 typedef CAResult_t (*CAAdapterStartDiscoveryServer)();
74 * Sends data to the endpoint using the adapter connectivity.
75 * Note: length must be > 0.
76 * @param[in] endpoint Remote Endpoint information (like ipaddress , port,
77 * reference uri and connectivity type) to which the unicast data has to be sent.
78 * @param[in] data Data which required to be sent.
79 * @param[in] dataLen Size of data to be sent.
80 * @return The number of bytes sent on the network. Return value equal to -1 indicates error.
82 typedef int32_t (*CAAdapterSendUnicastData)(const CAEndpoint_t *endpoint,
83 const void *data, uint32_t dataLen);
86 * Sends Multicast data to the endpoint using the adapter connectivity.
87 * Note: length must be > 0.
88 * @param[in] endpoint Remote Endpoint information (like ipaddress , port,
89 * @param[in] data Data which required to be sent.
90 * @param[in] dataLen Size of data to be sent.
91 * @return The number of bytes sent on the network. Return value equal to -1 indicates error.
93 typedef int32_t (*CAAdapterSendMulticastData)(const CAEndpoint_t *endpoint,
94 const void *data, uint32_t dataLen);
97 * Get Network Information.
98 * @param[out] info Local connectivity information structures
99 * @param[out] size Number of local connectivity structures.
100 * @return ::CA_STATUS_OK or ERROR CODES (::CAResult_t error codes in cacommon.h)
102 typedef CAResult_t (*CAAdapterGetNetworkInfo)(CAEndpoint_t **info, uint32_t *size);
105 * Read Synchronous API callback.
106 * @return ::CA_STATUS_OK or ERROR CODES (::CAResult_t error codes in cacommon.h)
108 typedef CAResult_t (*CAAdapterReadData)();
111 * Stopping the adapters and close socket connections.
112 * Transport Specific Behavior:
113 * WIFI/ETH Stops all listening servers and close sockets.
114 * EDR Stops all RFCOMM servers and close sockets.
115 * LE Stops all GATT servers and close sockets.
116 * @return CA_STATUS_OK or ERROR CODES ( CAResult_t error codes in cacommon.h)
118 typedef CAResult_t (*CAAdapterStop)();
121 * Terminate the connectivity adapter.Configuration information will be deleted from
122 * further use. Freeing Memory of threadpool and mutexs and cleanup will be done.
124 typedef void (*CAAdapterTerminate)();
127 * Connectivity handler information for adapter.
131 /** Start Transport specific functions. */
132 CAAdapterStart startAdapter;
134 /** Listening Server function address. */
135 CAAdapterStartListeningServer startListenServer;
137 /** Discovery Server function address. **/
138 CAAdapterStartDiscoveryServer startDiscoveryServer;
140 /** Unicast data function address. **/
141 CAAdapterSendUnicastData sendData;
143 /** Multicast data function address. **/
144 CAAdapterSendMulticastData sendDataToAll;
146 /** Get Networking information. **/
147 CAAdapterGetNetworkInfo GetnetInfo;
149 /** Read Data function address. **/
150 CAAdapterReadData readData;
152 /** Stop Transport specific functions. */
153 CAAdapterStop stopAdapter;
155 /** Terminate function address stored in this pointer. **/
156 CAAdapterTerminate terminate;
158 } CAConnectivityHandler_t;
161 * This will be used during the registration of adapters call backs to the common logic.
162 * @see ::CAConnectivityHandler_t , ::CATransportAdapter_t
164 typedef void (*CARegisterConnectivityCallback)(CAConnectivityHandler_t handler,
165 CATransportAdapter_t cType);
168 * This will be used during the receive of network requests and response.
169 * @see SendUnicastData(), SendMulticastData()
171 typedef void (*CANetworkPacketReceivedCallback)(const CASecureEndpoint_t *sep,
172 const void *data, uint32_t dataLen);
175 * This will be used to notify network changes to the connectivity common logic layer.
176 * @see SendUnicastData(), SendMulticastData()
178 typedef void (*CANetworkChangeCallback)(const CAEndpoint_t *info, CANetworkStatus_t status);
181 * This will be used to notify error result to the connectivity common logic layer.
183 typedef void (*CAErrorHandleCallback)(const CAEndpoint_t *endpoint,
184 const void *data, uint32_t dataLen,
191 #endif /* CA_ADAPTER_INTERFACE_H_ */