Bongjun Hur / W5500Interface

W5500 driver for mbed OS 5

Dependents:   http-webserver-example mbed-os-example-sockets

Fork of W5500Interface by Sergei G

W5500Interface.h@10:925201b1603f, 2018-08-13 (annotated)

Committer:
Bongjun
Date:
Mon Aug 13 02:30:22 2018 +0000
Revision:
10:925201b1603f
Parent:
8:c71c66d43703
Child:
11:5118c2bff025
add functions in W5500Interface.; - virtual const char *get_netmask();; - virtual const char *get_gateway();;

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Bongjun 6:e2ab76b2be07 1 /**
Bongjun 6:e2ab76b2be07 2 ******************************************************************************
Bongjun 6:e2ab76b2be07 3 * @file W5500Interface.h
Bongjun 6:e2ab76b2be07 4 * @author Bongjun Hur (modified version from Sergei G (https://os.mbed.com/users/sgnezdov/))
Bongjun 6:e2ab76b2be07 5 * @brief Header file of the NetworkStack for the W5500 Device
Bongjun 6:e2ab76b2be07 6 ******************************************************************************
Bongjun 6:e2ab76b2be07 7 * @attention
Bongjun 6:e2ab76b2be07 8 *
Bongjun 6:e2ab76b2be07 9 * THE PRESENT FIRMWARE WHICH IS FOR GUIDANCE ONLY AIMS AT PROVIDING CUSTOMERS
Bongjun 6:e2ab76b2be07 10 * WITH CODING INFORMATION REGARDING THEIR PRODUCTS IN ORDER FOR THEM TO SAVE
Bongjun 6:e2ab76b2be07 11 * TIME. AS A RESULT, WIZnet SHALL NOT BE HELD LIABLE FOR ANY
Bongjun 6:e2ab76b2be07 12 * DIRECT, INDIRECT OR CONSEQUENTIAL DAMAGES WITH RESPECT TO ANY CLAIMS ARISING
Bongjun 6:e2ab76b2be07 13 * FROM THE CONTENT OF SUCH FIRMWARE AND/OR THE USE MADE BY CUSTOMERS OF THE
Bongjun 6:e2ab76b2be07 14 * CODING INFORMATION CONTAINED HEREIN IN CONNECTION WITH THEIR PRODUCTS.
Bongjun 6:e2ab76b2be07 15 *
Bongjun 6:e2ab76b2be07 16 * <h2><center>&copy; COPYRIGHT 2017,2018 WIZnet Co.,Ltd.</center></h2>
Bongjun 6:e2ab76b2be07 17 ******************************************************************************
Bongjun 6:e2ab76b2be07 18 */
Bongjun 6:e2ab76b2be07 19
Bongjun 6:e2ab76b2be07 20 #ifndef W5500_INTERFACE_H
Bongjun 6:e2ab76b2be07 21 #define W5500_INTERFACE_H
Bongjun 6:e2ab76b2be07 22
Bongjun 6:e2ab76b2be07 23 #include "mbed.h"
Bongjun 6:e2ab76b2be07 24 #include "W5500.h"
Bongjun 6:e2ab76b2be07 25 //#include "rtos.h"
Bongjun 8:c71c66d43703 26 #include "PinNames.h"
Bongjun 8:c71c66d43703 27
Bongjun 8:c71c66d43703 28 // Arduino pin defaults for convenience
Bongjun 8:c71c66d43703 29 #if !defined(W5500_SPI_MOSI)
Bongjun 8:c71c66d43703 30 #define W5500_SPI_MOSI D11
Bongjun 8:c71c66d43703 31 #endif
Bongjun 8:c71c66d43703 32 #if !defined(W5500_SPI_MISO)
Bongjun 8:c71c66d43703 33 #define W5500_SPI_MISO D12
Bongjun 8:c71c66d43703 34 #endif
Bongjun 8:c71c66d43703 35 #if !defined(W5500_SPI_SCLK)
Bongjun 8:c71c66d43703 36 #define W5500_SPI_SCLK D13
Bongjun 8:c71c66d43703 37 #endif
Bongjun 8:c71c66d43703 38 #if !defined(W5500_SPI_CS)
Bongjun 8:c71c66d43703 39 #define W5500_SPI_CS D10
Bongjun 8:c71c66d43703 40 #endif
Bongjun 8:c71c66d43703 41 #if !defined(W5500_SPI_RST)
Bongjun 8:c71c66d43703 42 #define W5500_SPI_RST NC
Bongjun 8:c71c66d43703 43 #endif
Bongjun 8:c71c66d43703 44
Bongjun 6:e2ab76b2be07 45
Bongjun 6:e2ab76b2be07 46 /** w5500_socket struct
Bongjun 6:e2ab76b2be07 47 * W5500 socket
Bongjun 6:e2ab76b2be07 48 */
Bongjun 6:e2ab76b2be07 49
Bongjun 6:e2ab76b2be07 50 struct w5500_socket {
Bongjun 6:e2ab76b2be07 51 int fd;
Bongjun 6:e2ab76b2be07 52 nsapi_protocol_t proto;
Bongjun 6:e2ab76b2be07 53 bool connected;
Bongjun 6:e2ab76b2be07 54 void (*callback)(void *);
Bongjun 6:e2ab76b2be07 55 void *callback_data;
Bongjun 6:e2ab76b2be07 56 };
Bongjun 6:e2ab76b2be07 57
Bongjun 6:e2ab76b2be07 58 /** W5500Interface class
Bongjun 6:e2ab76b2be07 59 * Implementation of the NetworkStack for the W5500
Bongjun 6:e2ab76b2be07 60 */
Bongjun 6:e2ab76b2be07 61
Bongjun 6:e2ab76b2be07 62 class W5500Interface : public NetworkStack, public EthInterface
Bongjun 6:e2ab76b2be07 63 {
Bongjun 6:e2ab76b2be07 64 public:
Bongjun 8:c71c66d43703 65 //W5500Interface(SPI* spi, PinName cs, PinName reset);
Bongjun 6:e2ab76b2be07 66 W5500Interface(PinName mosi, PinName miso, PinName sclk, PinName cs, PinName reset);
Bongjun 6:e2ab76b2be07 67
Bongjun 6:e2ab76b2be07 68 int init();
Bongjun 6:e2ab76b2be07 69 int init(uint8_t * mac);
Bongjun 6:e2ab76b2be07 70 int init(const char* ip, const char* mask, const char* gateway);
Bongjun 6:e2ab76b2be07 71 int init(uint8_t * mac, const char* ip, const char* mask, const char* gateway);
Bongjun 6:e2ab76b2be07 72
Bongjun 6:e2ab76b2be07 73 /** Start the interface
Bongjun 6:e2ab76b2be07 74 * @return 0 on success, negative on failure
Bongjun 6:e2ab76b2be07 75 */
Bongjun 6:e2ab76b2be07 76 virtual int connect();
Bongjun 6:e2ab76b2be07 77
Bongjun 6:e2ab76b2be07 78 /** Stop the interface
Bongjun 6:e2ab76b2be07 79 * @return 0 on success, negative on failure
Bongjun 6:e2ab76b2be07 80 */
Bongjun 6:e2ab76b2be07 81 virtual int disconnect();
Bongjun 6:e2ab76b2be07 82
Bongjun 6:e2ab76b2be07 83 /** Get the internally stored IP address
Bongjun 6:e2ab76b2be07 84 * @return IP address of the interface or null if not yet connected
Bongjun 6:e2ab76b2be07 85 */
Bongjun 6:e2ab76b2be07 86 virtual const char *get_ip_address();
Bongjun 10:925201b1603f 87 virtual const char *get_netmask();
Bongjun 10:925201b1603f 88 virtual const char *get_gateway();
Bongjun 10:925201b1603f 89
Bongjun 6:e2ab76b2be07 90
Bongjun 6:e2ab76b2be07 91 /** Get MAC address and fill mac with it.
Bongjun 6:e2ab76b2be07 92 */
Bongjun 6:e2ab76b2be07 93 void get_mac(uint8_t mac[6]) ;
Bongjun 6:e2ab76b2be07 94
Bongjun 6:e2ab76b2be07 95 /** Get the internally stored MAC address
Bongjun 6:e2ab76b2be07 96 * @return MAC address of the interface
Bongjun 6:e2ab76b2be07 97 */
Bongjun 6:e2ab76b2be07 98 virtual const char *get_mac_address();
Bongjun 6:e2ab76b2be07 99
Bongjun 6:e2ab76b2be07 100 protected:
Bongjun 6:e2ab76b2be07 101 /** Opens a socket
Bongjun 6:e2ab76b2be07 102 *
Bongjun 6:e2ab76b2be07 103 * Creates a network socket and stores it in the specified handle.
Bongjun 6:e2ab76b2be07 104 * The handle must be passed to following calls on the socket.
Bongjun 6:e2ab76b2be07 105 *
Bongjun 6:e2ab76b2be07 106 * A stack may have a finite number of sockets, in this case
Bongjun 6:e2ab76b2be07 107 * NSAPI_ERROR_NO_SOCKET is returned if no socket is available.
Bongjun 6:e2ab76b2be07 108 *
Bongjun 6:e2ab76b2be07 109 * @param handle Destination for the handle to a newly created socket
Bongjun 6:e2ab76b2be07 110 * @param proto Protocol of socket to open, NSAPI_TCP or NSAPI_UDP
Bongjun 6:e2ab76b2be07 111 * @return 0 on success, negative error code on failure
Bongjun 6:e2ab76b2be07 112 */
Bongjun 6:e2ab76b2be07 113 virtual nsapi_error_t socket_open(nsapi_socket_t *handle, nsapi_protocol_t proto);
Bongjun 6:e2ab76b2be07 114 // virtual int socket_open(void **handle, nsapi_protocol_t proto);
Bongjun 6:e2ab76b2be07 115
Bongjun 6:e2ab76b2be07 116 /** Close the socket
Bongjun 6:e2ab76b2be07 117 *
Bongjun 6:e2ab76b2be07 118 * Closes any open connection and deallocates any memory associated
Bongjun 6:e2ab76b2be07 119 * with the socket.
Bongjun 6:e2ab76b2be07 120 *
Bongjun 6:e2ab76b2be07 121 * @param handle Socket handle
Bongjun 6:e2ab76b2be07 122 * @return 0 on success, negative error code on failure
Bongjun 6:e2ab76b2be07 123 */
Bongjun 6:e2ab76b2be07 124 virtual nsapi_error_t socket_close(nsapi_socket_t handle);
Bongjun 6:e2ab76b2be07 125
Bongjun 6:e2ab76b2be07 126 /** Bind a specific address to a socket
Bongjun 6:e2ab76b2be07 127 *
Bongjun 6:e2ab76b2be07 128 * Binding a socket specifies the address and port on which to recieve
Bongjun 6:e2ab76b2be07 129 * data. If the IP address is zeroed, only the port is bound.
Bongjun 6:e2ab76b2be07 130 *
Bongjun 6:e2ab76b2be07 131 * @param handle Socket handle
Bongjun 6:e2ab76b2be07 132 * @param address Local address to bind
Bongjun 6:e2ab76b2be07 133 * @return 0 on success, negative error code on failure.
Bongjun 6:e2ab76b2be07 134 */
Bongjun 6:e2ab76b2be07 135 virtual nsapi_error_t socket_bind(nsapi_socket_t handle, const SocketAddress &address);
Bongjun 6:e2ab76b2be07 136
Bongjun 6:e2ab76b2be07 137 /** Listen for connections on a TCP socket
Bongjun 6:e2ab76b2be07 138 *
Bongjun 6:e2ab76b2be07 139 * Marks the socket as a passive socket that can be used to accept
Bongjun 6:e2ab76b2be07 140 * incoming connections.
Bongjun 6:e2ab76b2be07 141 *
Bongjun 6:e2ab76b2be07 142 * @param handle Socket handle
Bongjun 6:e2ab76b2be07 143 * @param backlog Number of pending connections that can be queued
Bongjun 6:e2ab76b2be07 144 * simultaneously
Bongjun 6:e2ab76b2be07 145 * @return 0 on success, negative error code on failure
Bongjun 6:e2ab76b2be07 146 */
Bongjun 6:e2ab76b2be07 147 virtual nsapi_error_t socket_listen(nsapi_socket_t handle, int backlog);
Bongjun 6:e2ab76b2be07 148
Bongjun 6:e2ab76b2be07 149 /** Connects TCP socket to a remote host
Bongjun 6:e2ab76b2be07 150 *
Bongjun 6:e2ab76b2be07 151 * Initiates a connection to a remote server specified by the
Bongjun 6:e2ab76b2be07 152 * indicated address.
Bongjun 6:e2ab76b2be07 153 *
Bongjun 6:e2ab76b2be07 154 * @param handle Socket handle
Bongjun 6:e2ab76b2be07 155 * @param address The SocketAddress of the remote host
Bongjun 6:e2ab76b2be07 156 * @return 0 on success, negative error code on failure
Bongjun 6:e2ab76b2be07 157 */
Bongjun 6:e2ab76b2be07 158 virtual nsapi_error_t socket_connect(nsapi_socket_t handle, const SocketAddress &address);
Bongjun 6:e2ab76b2be07 159
Bongjun 6:e2ab76b2be07 160 /** Accepts a connection on a TCP socket
Bongjun 6:e2ab76b2be07 161 *
Bongjun 6:e2ab76b2be07 162 * The server socket must be bound and set to listen for connections.
Bongjun 6:e2ab76b2be07 163 * On a new connection, creates a network socket and stores it in the
Bongjun 6:e2ab76b2be07 164 * specified handle. The handle must be passed to following calls on
Bongjun 6:e2ab76b2be07 165 * the socket.
Bongjun 6:e2ab76b2be07 166 *
Bongjun 6:e2ab76b2be07 167 * A stack may have a finite number of sockets, in this case
Bongjun 6:e2ab76b2be07 168 * NSAPI_ERROR_NO_SOCKET is returned if no socket is available.
Bongjun 6:e2ab76b2be07 169 *
Bongjun 6:e2ab76b2be07 170 * This call is non-blocking. If accept would block,
Bongjun 6:e2ab76b2be07 171 * NSAPI_ERROR_WOULD_BLOCK is returned immediately.
Bongjun 6:e2ab76b2be07 172 *
Bongjun 6:e2ab76b2be07 173 * @param server Socket handle to server to accept from
Bongjun 6:e2ab76b2be07 174 * @param handle Destination for a handle to the newly created socket
Bongjun 6:e2ab76b2be07 175 * @param address Destination for the remote address or NULL
Bongjun 6:e2ab76b2be07 176 * @return 0 on success, negative error code on failure
Bongjun 6:e2ab76b2be07 177 */
Bongjun 6:e2ab76b2be07 178 virtual nsapi_error_t socket_accept(nsapi_socket_t server,
Bongjun 6:e2ab76b2be07 179 nsapi_socket_t *handle, SocketAddress *address=0);
Bongjun 6:e2ab76b2be07 180
Bongjun 6:e2ab76b2be07 181 /** Send data over a TCP socket
Bongjun 6:e2ab76b2be07 182 *
Bongjun 6:e2ab76b2be07 183 * The socket must be connected to a remote host. Returns the number of
Bongjun 6:e2ab76b2be07 184 * bytes sent from the buffer.
Bongjun 6:e2ab76b2be07 185 *
Bongjun 6:e2ab76b2be07 186 * This call is non-blocking. If send would block,
Bongjun 6:e2ab76b2be07 187 * NSAPI_ERROR_WOULD_BLOCK is returned immediately.
Bongjun 6:e2ab76b2be07 188 *
Bongjun 6:e2ab76b2be07 189 * @param handle Socket handle
Bongjun 6:e2ab76b2be07 190 * @param data Buffer of data to send to the host
Bongjun 6:e2ab76b2be07 191 * @param size Size of the buffer in bytes
Bongjun 6:e2ab76b2be07 192 * @return Number of sent bytes on success, negative error
Bongjun 6:e2ab76b2be07 193 * code on failure
Bongjun 6:e2ab76b2be07 194 */
Bongjun 6:e2ab76b2be07 195 virtual nsapi_size_or_error_t socket_send(nsapi_socket_t handle,
Bongjun 6:e2ab76b2be07 196 const void *data, nsapi_size_t size);
Bongjun 6:e2ab76b2be07 197
Bongjun 6:e2ab76b2be07 198 /** Receive data over a TCP socket
Bongjun 6:e2ab76b2be07 199 *
Bongjun 6:e2ab76b2be07 200 * The socket must be connected to a remote host. Returns the number of
Bongjun 6:e2ab76b2be07 201 * bytes received into the buffer.
Bongjun 6:e2ab76b2be07 202 *
Bongjun 6:e2ab76b2be07 203 * This call is non-blocking. If recv would block,
Bongjun 6:e2ab76b2be07 204 * NSAPI_ERROR_WOULD_BLOCK is returned immediately.
Bongjun 6:e2ab76b2be07 205 *
Bongjun 6:e2ab76b2be07 206 * @param handle Socket handle
Bongjun 6:e2ab76b2be07 207 * @param data Destination buffer for data received from the host
Bongjun 6:e2ab76b2be07 208 * @param size Size of the buffer in bytes
Bongjun 6:e2ab76b2be07 209 * @return Number of received bytes on success, negative error
Bongjun 6:e2ab76b2be07 210 * code on failure
Bongjun 6:e2ab76b2be07 211 */
Bongjun 6:e2ab76b2be07 212 virtual nsapi_size_or_error_t socket_recv(nsapi_socket_t handle,
Bongjun 6:e2ab76b2be07 213 void *data, nsapi_size_t size);
Bongjun 6:e2ab76b2be07 214
Bongjun 6:e2ab76b2be07 215 /** Send a packet over a UDP socket
Bongjun 6:e2ab76b2be07 216 *
Bongjun 6:e2ab76b2be07 217 * Sends data to the specified address. Returns the number of bytes
Bongjun 6:e2ab76b2be07 218 * sent from the buffer.
Bongjun 6:e2ab76b2be07 219 *
Bongjun 6:e2ab76b2be07 220 * This call is non-blocking. If sendto would block,
Bongjun 6:e2ab76b2be07 221 * NSAPI_ERROR_WOULD_BLOCK is returned immediately.
Bongjun 6:e2ab76b2be07 222 *
Bongjun 6:e2ab76b2be07 223 * @param handle Socket handle
Bongjun 6:e2ab76b2be07 224 * @param address The SocketAddress of the remote host
Bongjun 6:e2ab76b2be07 225 * @param data Buffer of data to send to the host
Bongjun 6:e2ab76b2be07 226 * @param size Size of the buffer in bytes
Bongjun 6:e2ab76b2be07 227 * @return Number of sent bytes on success, negative error
Bongjun 6:e2ab76b2be07 228 * code on failure
Bongjun 6:e2ab76b2be07 229 */
Bongjun 6:e2ab76b2be07 230 virtual nsapi_size_or_error_t socket_sendto(nsapi_socket_t handle, const SocketAddress &address,
Bongjun 6:e2ab76b2be07 231 const void *data, nsapi_size_t size);
Bongjun 6:e2ab76b2be07 232
Bongjun 6:e2ab76b2be07 233 /** Receive a packet over a UDP socket
Bongjun 6:e2ab76b2be07 234 *
Bongjun 6:e2ab76b2be07 235 * Receives data and stores the source address in address if address
Bongjun 6:e2ab76b2be07 236 * is not NULL. Returns the number of bytes received into the buffer.
Bongjun 6:e2ab76b2be07 237 *
Bongjun 6:e2ab76b2be07 238 * This call is non-blocking. If recvfrom would block,
Bongjun 6:e2ab76b2be07 239 * NSAPI_ERROR_WOULD_BLOCK is returned immediately.
Bongjun 6:e2ab76b2be07 240 *
Bongjun 6:e2ab76b2be07 241 * @param handle Socket handle
Bongjun 6:e2ab76b2be07 242 * @param address Destination for the source address or NULL
Bongjun 6:e2ab76b2be07 243 * @param data Destination buffer for data received from the host
Bongjun 6:e2ab76b2be07 244 * @param size Size of the buffer in bytes
Bongjun 6:e2ab76b2be07 245 * @return Number of received bytes on success, negative error
Bongjun 6:e2ab76b2be07 246 * code on failure
Bongjun 6:e2ab76b2be07 247 */
Bongjun 6:e2ab76b2be07 248 virtual nsapi_size_or_error_t socket_recvfrom(nsapi_socket_t handle, SocketAddress *address,
Bongjun 6:e2ab76b2be07 249 void *buffer, nsapi_size_t size);
Bongjun 6:e2ab76b2be07 250
Bongjun 6:e2ab76b2be07 251 /** Register a callback on state change of the socket
Bongjun 6:e2ab76b2be07 252 *
Bongjun 6:e2ab76b2be07 253 * The specified callback will be called on state changes such as when
Bongjun 6:e2ab76b2be07 254 * the socket can recv/send/accept successfully and on when an error
Bongjun 6:e2ab76b2be07 255 * occurs. The callback may also be called spuriously without reason.
Bongjun 6:e2ab76b2be07 256 *
Bongjun 6:e2ab76b2be07 257 * The callback may be called in an interrupt context and should not
Bongjun 6:e2ab76b2be07 258 * perform expensive operations such as recv/send calls.
Bongjun 6:e2ab76b2be07 259 *
Bongjun 6:e2ab76b2be07 260 * @param handle Socket handle
Bongjun 6:e2ab76b2be07 261 * @param callback Function to call on state change
Bongjun 6:e2ab76b2be07 262 * @param data Argument to pass to callback
Bongjun 6:e2ab76b2be07 263 */
Bongjun 6:e2ab76b2be07 264 virtual void socket_attach(nsapi_socket_t handle, void (*callback)(void *), void *data);
Bongjun 6:e2ab76b2be07 265
Bongjun 6:e2ab76b2be07 266 virtual NetworkStack* get_stack() {return this;}
Bongjun 6:e2ab76b2be07 267
Bongjun 6:e2ab76b2be07 268 private:
Bongjun 6:e2ab76b2be07 269 WIZnet_Chip _w5500;
Bongjun 6:e2ab76b2be07 270
Bongjun 6:e2ab76b2be07 271 char ip_string[20];
Bongjun 10:925201b1603f 272 char netmask_string[20];
Bongjun 10:925201b1603f 273 char gateway_string[20];
Bongjun 6:e2ab76b2be07 274 char mac_string[20];
Bongjun 6:e2ab76b2be07 275 bool ip_set;
Bongjun 6:e2ab76b2be07 276
Bongjun 6:e2ab76b2be07 277 int listen_port;
Bongjun 6:e2ab76b2be07 278
Bongjun 6:e2ab76b2be07 279 //void signal_event(nsapi_socket_t handle);
Bongjun 6:e2ab76b2be07 280 //void event();
Bongjun 6:e2ab76b2be07 281
Bongjun 6:e2ab76b2be07 282 //w5500 socket management
Bongjun 6:e2ab76b2be07 283 struct w5500_socket w5500_sockets[MAX_SOCK_NUM];
Bongjun 6:e2ab76b2be07 284 w5500_socket* get_sock(int fd);
Bongjun 6:e2ab76b2be07 285 void init_socks();
Bongjun 6:e2ab76b2be07 286 /*
Bongjun 6:e2ab76b2be07 287 Thread *_daemon;
Bongjun 6:e2ab76b2be07 288 void daemon();
Bongjun 6:e2ab76b2be07 289 */
Bongjun 6:e2ab76b2be07 290
Bongjun 6:e2ab76b2be07 291 };
Bongjun 6:e2ab76b2be07 292
Bongjun 6:e2ab76b2be07 293 #endif