DongEun Koak / NetworkSocketAPI

NetworkSocketAPI

Dependencies:   DnsQuery

Dependents:   HelloWizFi250Interface

Fork of NetworkSocketAPI by NetworkSocketAPI

SocketInterface.h@48:b3bbe28a7963, 2016-02-25 (annotated)

Committer:
Christopher Haster
Date:
Thu Feb 25 03:13:26 2016 -0600
Branch:
api-changes
Revision:
48:b3bbe28a7963
Parent:
43:09ea32f2eb54
Child:
53:26b5f1c69822
Added non-blocking recv

Who changed what in which revision?

UserRevisionLine numberNew contents of line
sam_grove 0:d35446f60233 1 /* SocketInterface Base Class
sam_grove 0:d35446f60233 2 * Copyright (c) 2015 ARM Limited
sam_grove 0:d35446f60233 3 *
sam_grove 0:d35446f60233 4 * Licensed under the Apache License, Version 2.0 (the "License");
sam_grove 0:d35446f60233 5 * you may not use this file except in compliance with the License.
sam_grove 0:d35446f60233 6 * You may obtain a copy of the License at
sam_grove 0:d35446f60233 7 *
sam_grove 0:d35446f60233 8 * http://www.apache.org/licenses/LICENSE-2.0
sam_grove 0:d35446f60233 9 *
sam_grove 0:d35446f60233 10 * Unless required by applicable law or agreed to in writing, software
sam_grove 0:d35446f60233 11 * distributed under the License is distributed on an "AS IS" BASIS,
sam_grove 0:d35446f60233 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
sam_grove 0:d35446f60233 13 * See the License for the specific language governing permissions and
sam_grove 0:d35446f60233 14 * limitations under the License.
sam_grove 0:d35446f60233 15 */
sam_grove 8:4b7f97a5597b 16
Christopher Haster 21:35ed15069189 17 #ifndef SOCKET_INTERFACE_H
Christopher Haster 21:35ed15069189 18 #define SOCKET_INTERFACE_H
bridadan 2:ce08986b18b5 19
sam_grove 8:4b7f97a5597b 20 #include "stdint.h"
sam_grove 8:4b7f97a5597b 21
sam_grove 8:4b7f97a5597b 22
Christopher Haster 21:35ed15069189 23 /** Enum of socket protocols
sam_grove 8:4b7f97a5597b 24 */
Christopher Haster 42:49893d13c432 25 enum socket_protocol_t {
sam_grove 8:4b7f97a5597b 26 SOCK_TCP, /*!< Socket connection over TCP */
sam_grove 8:4b7f97a5597b 27 SOCK_UDP, /*!< Socket connection over UDP */
Christopher Haster 42:49893d13c432 28 };
sam_grove 8:4b7f97a5597b 29
Christopher Haster 21:35ed15069189 30
Christopher Haster 21:35ed15069189 31 /** SocketInterface class
Christopher Haster 21:35ed15069189 32 * Common interface for implementation specific sockets created through
Christopher Haster 21:35ed15069189 33 * network interfaces. This class is used internally by the
Christopher Haster 21:35ed15069189 34 * TCPSocket and UDPSocket classes
sam_grove 8:4b7f97a5597b 35 */
Christopher Haster 21:35ed15069189 36 class SocketInterface
sam_grove 8:4b7f97a5597b 37 {
sam_grove 8:4b7f97a5597b 38 public:
Christopher Haster 21:35ed15069189 39 /** Set the IP address of the socket
Christopher Haster 41:3ec1c97e9bbf 40 * @param ip IP address to connect to
sam_grove 8:4b7f97a5597b 41 */
Christopher Haster 43:09ea32f2eb54 42 virtual void setIPAddress(const char *ip) { (void)ip; }
sam_grove 16:658d4943c753 43
Christopher Haster 21:35ed15069189 44 /** Set the port of the socket
Christopher Haster 21:35ed15069189 45 * @param port Port to connect to
sam_grove 8:4b7f97a5597b 46 */
Christopher Haster 43:09ea32f2eb54 47 virtual void setPort(uint16_t port) { (void)port; }
sam_grove 8:4b7f97a5597b 48
Christopher Haster 38:157fb2ab965f 49 /** Status of the socket
Christopher Haster 38:157fb2ab965f 50 * @return True if connected
Christopher Haster 38:157fb2ab965f 51 */
Christopher Haster 43:09ea32f2eb54 52 virtual bool isConnected()
Christopher Haster 43:09ea32f2eb54 53 {
Christopher Haster 43:09ea32f2eb54 54 // By default return true if socket was created successfully
Christopher Haster 43:09ea32f2eb54 55 return true;
Christopher Haster 43:09ea32f2eb54 56 }
Christopher Haster 38:157fb2ab965f 57
Christopher Haster 21:35ed15069189 58 /** Open a connection to the underlying address
Christopher Haster 36:eab792dfb0d8 59 * @param ip IP address to connect to
Christopher Haster 36:eab792dfb0d8 60 * @param port Port to connect to
Christopher Haster 21:35ed15069189 61 * @return 0 on success
sam_grove 8:4b7f97a5597b 62 */
Christopher Haster 36:eab792dfb0d8 63 virtual int32_t open(const char *ip, uint16_t port) = 0;
Christopher Haster 21:35ed15069189 64
Christopher Haster 21:35ed15069189 65 /** Close an open connection
Christopher Haster 21:35ed15069189 66 * @return 0 on success
Christopher Haster 21:35ed15069189 67 */
Christopher Haster 21:35ed15069189 68 virtual int32_t close() = 0;
sam_grove 8:4b7f97a5597b 69
Christopher Haster 21:35ed15069189 70 /** Send data
Christopher Haster 21:35ed15069189 71 * @param data Buffer of data to send
Christopher Haster 48:b3bbe28a7963 72 * @param size Size of data to send
Christopher Haster 21:35ed15069189 73 * @return 0 on success
sam_grove 8:4b7f97a5597b 74 */
Christopher Haster 48:b3bbe28a7963 75 virtual int32_t send(const void *data, uint32_t size) = 0;
sam_grove 8:4b7f97a5597b 76
Christopher Haster 48:b3bbe28a7963 77 /** Receive data
Christopher Haster 48:b3bbe28a7963 78 * @note
Christopher Haster 48:b3bbe28a7963 79 * This call should return immediately with a value of 0
Christopher Haster 48:b3bbe28a7963 80 * if no data is available.
Christopher Haster 48:b3bbe28a7963 81 *
Christopher Haster 48:b3bbe28a7963 82 * @param data A buffer to store the data in
Christopher Haster 48:b3bbe28a7963 83 * @param size Size of buffer
Christopher Haster 48:b3bbe28a7963 84 * @return Number of bytes received or a negative value on failure
sam_grove 8:4b7f97a5597b 85 */
Christopher Haster 48:b3bbe28a7963 86 virtual int32_t recv(void *data, uint32_t size) = 0;
sam_grove 8:4b7f97a5597b 87 };
sam_grove 8:4b7f97a5597b 88
bridadan 1:291a9d61e58a 89 #endif