87 lines
3.4 KiB
Python
87 lines
3.4 KiB
Python
|
class EthernetServerInterface():
|
|||
|
|
""" This class provides an interface to a server Ethernet socket. After instantiation, the server is started by calling StartListen(). This class allows the user to send data over the Ethernet port in an asynchronous manner using Send() and ReceiveData after a client has connected.
|
|||
|
|
|
|||
|
|
:Warning:: This class is no longer supported. For any new development, EthernetServerInterfaceEx should be used.
|
|||
|
|
|
|||
|
|
Arguments:
|
|||
|
|
IPPort (int) - IP port number of the listening service.
|
|||
|
|
(optional) Protocol (string) - Value for either 'TCP' or 'UDP'
|
|||
|
|
(optional) Interface (string) - Defines the network interface on which to listen ('Any', 'LAN' of 'AVLAN')
|
|||
|
|
(optional) ServicePort (int) - sets the port from which the client will send data. Zero means any service port is valid.
|
|||
|
|
|
|||
|
|
Note: ServicePort is only applicable to 'UDP' protocol type.
|
|||
|
|
|
|||
|
|
Parameters:
|
|||
|
|
Hostname - Returns (string) - Hostname DNS name of the connection. Can be the IP Address
|
|||
|
|
IPAddress - Returns (string) - the IP Address of the connected device
|
|||
|
|
IPPort - Returns (int) - IP Port number of the listening service
|
|||
|
|
Interface - Returns (string) - name of interface on which the server is listening
|
|||
|
|
Protocol - Returns (string) - Value for either ’TCP’, ’UDP’ connection.
|
|||
|
|
ServicePort - Returns (int) - ServicePort port on which the client will listen for data
|
|||
|
|
|
|||
|
|
Events:
|
|||
|
|
Connected - (Event) Triggers when socket connection is established.
|
|||
|
|
Disconnected - (Event) Triggers when the socket connection is broken
|
|||
|
|
ReceiveData - (Event) Receive Data event handler used for asynchronous transactions. The callback takes two arguments. The first one is the EthernetServerInterface instance triggering the event and the second one is a bytes string.
|
|||
|
|
"""
|
|||
|
|
|
|||
|
|
IPPort = 0
|
|||
|
|
Protocol = ''
|
|||
|
|
Interface = ''
|
|||
|
|
ServicePort = 0
|
|||
|
|
Connected = None
|
|||
|
|
Disconnected = None
|
|||
|
|
HostName = ''
|
|||
|
|
IPAddress = ''
|
|||
|
|
ReceiveData = None
|
|||
|
|
|
|||
|
|
def __init__(self, IPPort, Protocol='TCP', Interface='Any', ServicePort=0):
|
|||
|
|
""" EthernetServerInterface class constructor.
|
|||
|
|
|
|||
|
|
Arguments:
|
|||
|
|
- IPPort (int) - IP port number of the listening service.
|
|||
|
|
- (optional) Protocol (string) - Value for either 'TCP' or 'UDP'
|
|||
|
|
- (optional) Interface (string) - Defines the network interface on which to listen ('Any', 'LAN' of 'AVLAN')
|
|||
|
|
- (optional) ServicePort (int) - sets the port from which the client will send data. Zero means any service port is valid.
|
|||
|
|
"""
|
|||
|
|
self.IPPort = IPPort
|
|||
|
|
self.Protocol = Protocol
|
|||
|
|
self.Interface = Interface
|
|||
|
|
self.ServicePort = ServicePort
|
|||
|
|
|
|||
|
|
def Disconnect(self):
|
|||
|
|
""" Closes the connection gracefully.
|
|||
|
|
"""
|
|||
|
|
pass
|
|||
|
|
|
|||
|
|
def Send(self, data):
|
|||
|
|
""" Send string over ethernet port if it’s open
|
|||
|
|
|
|||
|
|
Arguments:
|
|||
|
|
- data (int) - string to send out
|
|||
|
|
|
|||
|
|
Raises:
|
|||
|
|
- TypeError
|
|||
|
|
- IOError
|
|||
|
|
"""
|
|||
|
|
pass
|
|||
|
|
|
|||
|
|
def StartListen(self, timeout=0):
|
|||
|
|
""" Start the listener
|
|||
|
|
|
|||
|
|
Arguments:
|
|||
|
|
- (optional) timeout (float) - how long to listen for connections (0=Forever)
|
|||
|
|
|
|||
|
|
Returns:
|
|||
|
|
- 'Listening' or a reason for failure (e.g. 'PortUnavailable')
|
|||
|
|
|
|||
|
|
Raises:
|
|||
|
|
- IOError
|
|||
|
|
"""
|
|||
|
|
pass
|
|||
|
|
|
|||
|
|
def StopListen(self):
|
|||
|
|
""" Stop the listener
|
|||
|
|
"""
|
|||
|
|
pass
|