Committer:
mbed714
Date:
Sat Sep 18 23:05:49 2010 +0000
Revision:
0:d616ece2d859

        

Who changed what in which revision?

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