Rahol Rajan / NetServices-Traffic

Used in Live Traffic Update Nokia LCD Display Project

Fork of NetServices by Segundo Equipo

if/net/nettcpsocket.h@8:92b57208ab99, 2013-03-06 (annotated)

Committer:
rrajan8
Date:
Wed Mar 06 19:07:23 2013 +0000
Revision:
8:92b57208ab99
Parent:
0:ac1725ba162c 
This project utilizes mbed's networking features to display live traffic updates on the Nokia LCD using the MapQuest API's Traffic Web Service.

Who changed what in which revision?

UserRevisionLine numberNew contents of line
segundo 0:ac1725ba162c 1
segundo 0:ac1725ba162c 2 /*
segundo 0:ac1725ba162c 3 Copyright (c) 2010 Donatien Garnier (donatiengar [at] gmail [dot] com)
segundo 0:ac1725ba162c 4
segundo 0:ac1725ba162c 5 Permission is hereby granted, free of charge, to any person obtaining a copy
segundo 0:ac1725ba162c 6 of this software and associated documentation files (the "Software"), to deal
segundo 0:ac1725ba162c 7 in the Software without restriction, including without limitation the rights
segundo 0:ac1725ba162c 8 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
segundo 0:ac1725ba162c 9 copies of the Software, and to permit persons to whom the Software is
segundo 0:ac1725ba162c 10 furnished to do so, subject to the following conditions:
segundo 0:ac1725ba162c 11
segundo 0:ac1725ba162c 12 The above copyright notice and this permission notice shall be included in
segundo 0:ac1725ba162c 13 all copies or substantial portions of the Software.
segundo 0:ac1725ba162c 14
segundo 0:ac1725ba162c 15 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
segundo 0:ac1725ba162c 16 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
segundo 0:ac1725ba162c 17 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
segundo 0:ac1725ba162c 18 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
segundo 0:ac1725ba162c 19 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
segundo 0:ac1725ba162c 20 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
segundo 0:ac1725ba162c 21 THE SOFTWARE.
segundo 0:ac1725ba162c 22 */
segundo 0:ac1725ba162c 23
segundo 0:ac1725ba162c 24 #ifndef NETTCPSOCKET_H
segundo 0:ac1725ba162c 25 #define NETTCPSOCKET_H
segundo 0:ac1725ba162c 26
segundo 0:ac1725ba162c 27 #include "net.h"
segundo 0:ac1725ba162c 28 #include "host.h"
segundo 0:ac1725ba162c 29
segundo 0:ac1725ba162c 30 #include <queue>
segundo 0:ac1725ba162c 31 using std::queue;
segundo 0:ac1725ba162c 32
segundo 0:ac1725ba162c 33 //Implements a Berkeley-like socket if
segundo 0:ac1725ba162c 34 //Can be interfaced either to lwip or a Telit module
segundo 0:ac1725ba162c 35
segundo 0:ac1725ba162c 36 enum NetTcpSocketErr
segundo 0:ac1725ba162c 37 {
segundo 0:ac1725ba162c 38 __NETTCPSOCKET_MIN = -0xFFFF,
segundo 0:ac1725ba162c 39 NETTCPSOCKET_SETUP, //NetTcpSocket not properly configured
segundo 0:ac1725ba162c 40 NETTCPSOCKET_TIMEOUT,
segundo 0:ac1725ba162c 41 NETTCPSOCKET_IF, //If has problems
segundo 0:ac1725ba162c 42 NETTCPSOCKET_MEM, //Not enough mem
segundo 0:ac1725ba162c 43 NETTCPSOCKET_INUSE, //If/Port is in use
segundo 0:ac1725ba162c 44 NETTCPSOCKET_EMPTY, //Connections queue is empty
segundo 0:ac1725ba162c 45 NETTCPSOCKET_RST, // Connection was reset by remote host
segundo 0:ac1725ba162c 46 //...
segundo 0:ac1725ba162c 47 NETTCPSOCKET_OK = 0
segundo 0:ac1725ba162c 48 };
segundo 0:ac1725ba162c 49
segundo 0:ac1725ba162c 50 enum NetTcpSocketEvent
segundo 0:ac1725ba162c 51 {
segundo 0:ac1725ba162c 52 NETTCPSOCKET_CONNECTED, //Connected to host, must call accept() if we were listening
segundo 0:ac1725ba162c 53 NETTCPSOCKET_ACCEPT, //Connected to client
segundo 0:ac1725ba162c 54 NETTCPSOCKET_READABLE, //Data in buf
segundo 0:ac1725ba162c 55 NETTCPSOCKET_WRITEABLE, //Can write data to buf
segundo 0:ac1725ba162c 56 NETTCPSOCKET_CONTIMEOUT,
segundo 0:ac1725ba162c 57 NETTCPSOCKET_CONRST,
segundo 0:ac1725ba162c 58 NETTCPSOCKET_CONABRT,
segundo 0:ac1725ba162c 59 NETTCPSOCKET_ERROR,
segundo 0:ac1725ba162c 60 NETTCPSOCKET_DISCONNECTED
segundo 0:ac1725ba162c 61 };
segundo 0:ac1725ba162c 62
segundo 0:ac1725ba162c 63
segundo 0:ac1725ba162c 64 class NetTcpSocket
segundo 0:ac1725ba162c 65 {
segundo 0:ac1725ba162c 66 public:
segundo 0:ac1725ba162c 67 NetTcpSocket();
segundo 0:ac1725ba162c 68 virtual ~NetTcpSocket(); //close()
segundo 0:ac1725ba162c 69
segundo 0:ac1725ba162c 70 virtual NetTcpSocketErr bind(const Host& me) = 0;
segundo 0:ac1725ba162c 71 virtual NetTcpSocketErr listen() = 0;
segundo 0:ac1725ba162c 72 virtual NetTcpSocketErr connect(const Host& host) = 0;
segundo 0:ac1725ba162c 73 virtual NetTcpSocketErr accept(Host* pClient, NetTcpSocket** ppNewNetTcpSocket) = 0;
segundo 0:ac1725ba162c 74
segundo 0:ac1725ba162c 75 virtual int /*if < 0 : NetTcpSocketErr*/ send(const char* buf, int len) = 0;
segundo 0:ac1725ba162c 76 virtual int /*if < 0 : NetTcpSocketErr*/ recv(char* buf, int len) = 0;
segundo 0:ac1725ba162c 77
segundo 0:ac1725ba162c 78 virtual NetTcpSocketErr close() = 0;
segundo 0:ac1725ba162c 79
segundo 0:ac1725ba162c 80 virtual NetTcpSocketErr poll() = 0;
segundo 0:ac1725ba162c 81
segundo 0:ac1725ba162c 82 class CDummy;
segundo 0:ac1725ba162c 83 //Callbacks
segundo 0:ac1725ba162c 84 template<class T>
segundo 0:ac1725ba162c 85 //Linker bug : Must be defined here :(
segundo 0:ac1725ba162c 86 void setOnEvent( T* pItem, void (T::*pMethod)(NetTcpSocketEvent) )
segundo 0:ac1725ba162c 87 {
segundo 0:ac1725ba162c 88 m_pCbItem = (CDummy*) pItem;
segundo 0:ac1725ba162c 89 m_pCbMeth = (void (CDummy::*)(NetTcpSocketEvent)) pMethod;
segundo 0:ac1725ba162c 90 }
segundo 0:ac1725ba162c 91
segundo 0:ac1725ba162c 92 void resetOnEvent(); //Disable callback
segundo 0:ac1725ba162c 93
segundo 0:ac1725ba162c 94 protected:
segundo 0:ac1725ba162c 95 void queueEvent(NetTcpSocketEvent e);
segundo 0:ac1725ba162c 96 void discardEvents();
segundo 0:ac1725ba162c 97 void flushEvents(); //to be called during polling
segundo 0:ac1725ba162c 98
segundo 0:ac1725ba162c 99 Host m_host;
segundo 0:ac1725ba162c 100 Host m_client;
segundo 0:ac1725ba162c 101
segundo 0:ac1725ba162c 102 friend class Net;
segundo 0:ac1725ba162c 103 int m_refs;
segundo 0:ac1725ba162c 104
segundo 0:ac1725ba162c 105 bool m_closed;
segundo 0:ac1725ba162c 106 bool m_removed;
segundo 0:ac1725ba162c 107
segundo 0:ac1725ba162c 108 private:
segundo 0:ac1725ba162c 109 //We do not want to execute user code in interrupt routines, so we queue events until the server is polled
segundo 0:ac1725ba162c 110 //If we port this to a multithreaded OS, we could avoid this (however some functions here are not thread-safe, so beware ;) )
segundo 0:ac1725ba162c 111 void onEvent(NetTcpSocketEvent e); //To be called on poll
segundo 0:ac1725ba162c 112 CDummy* m_pCbItem;
segundo 0:ac1725ba162c 113 void (CDummy::*m_pCbMeth)(NetTcpSocketEvent);
segundo 0:ac1725ba162c 114 queue<NetTcpSocketEvent> m_events;
segundo 0:ac1725ba162c 115
segundo 0:ac1725ba162c 116 };
segundo 0:ac1725ba162c 117
segundo 0:ac1725ba162c 118 #endif