Source code for spinnman.connections.abstract_classes.udp_receivers.abstract_udp_eieio_command_receiver
from abc import ABCMeta
from abc import abstractmethod
from six import add_metaclass
import select
import socket
import traceback
from spinnman.data.little_endian_byte_array_byte_reader import \
LittleEndianByteArrayByteReader
from spinnman.exceptions import SpinnmanTimeoutException, SpinnmanIOException
from spinnman.connections.abstract_classes.abstract_connection import \
AbstractConnection
from spinnman.messages.eieio.create_eieio_command\
import read_eieio_command_message
@add_metaclass(ABCMeta)
[docs]class AbstractUDPEIEIOCommandReceiver(AbstractConnection):
""" A receiver of SCP messages
"""
@abstractmethod
[docs] def is_udp_eieio_command_receiver(self):
pass
[docs] def receive_eieio_command_message(self, timeout=None):
""" Receives an eieio message from this connection. Blocks\
until a message has been received, or a timeout occurs.
:param timeout: The time in seconds to wait for the message to arrive;\
if not specified, will wait forever, or until the\
connection is closed
:type timeout: int
:return: Nothing is returned
:rtype: None
:raise spinnman.exceptions.SpinnmanIOException: If there is an error\
receiving the message
:raise spinnman.exceptions.SpinnmanTimeoutException: If there is a\
timeout before a message is received
:raise spinnman.exceptions.SpinnmanInvalidPacketException: If the\
received packet is not a valid SCP message
:raise spinnman.exceptions.SpinnmanInvalidParameterException: If one\
of the fields of the SCP message is invalid
"""
# Receive the data
try:
read_ready, _, _ = select.select([self._socket], [], [], timeout)
if not read_ready:
raise socket.timeout()
raw_data = self._socket.recv(512)
except socket.timeout:
raise SpinnmanTimeoutException("receive_sdp_message", timeout)
except Exception as e:
raise SpinnmanIOException(str(e))
# Set up for reading
packet = bytearray(raw_data)
reader = LittleEndianByteArrayByteReader(packet)
eieio_packet = read_eieio_command_message(reader)
return eieio_packet