Source code for pacman.model.resources.specific_board_reverse_iptag_resource

# Copyright (c) 2017-2019 The University of Manchester
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <http://www.gnu.org/licenses/>.


class ReverseIPtagResource(object):
    """ Represents the ability to talk to a specific board of a SpiNNaker\
        machine by sending UDP packets to it during execution.
    """

    __slots__ = [
        # The target port of the tag or None if this is to be assigned
        # elsewhere
        "_port",

        # The SDP port number to be used when constructing SDP packets from
        # the received UDP packets for this tag
        "_sdp_port",

        # A fixed tag ID to assign, or None if any tag is OK
        "_tag",

        # A board IP address which is where this reverse IP tag is to be \
        # placed
        "_board"
    ]

    def __init__(self, board, port=None, sdp_port=1, tag=None):
        """
        :param board: A board IP address which is where this reverse IP tag is\
            to be placed
        :type board: str
        :param port: The target port of the tag or None to assign elsewhere
        :type port: int or None
        :param port: The UDP port to listen to on the board for this tag
        :type port: int
        :param sdp_port: The SDP port number to be used when constructing \
            SDP packets from the received UDP packets for this tag.
        :type sdp_port: int
        :param tag: A fixed tag ID to assign, or None if any tag is OK
        :type tag: int or None
        """
        self._port = port
        self._sdp_port = sdp_port
        self._tag = tag
        self._board = board

    @property
    def port(self):
        """ The port of the tag

        :return: The port of the tag
        :rtype: int
        """
        return self._port

    @property
    def sdp_port(self):
        """ The SDP port to use when constructing the SDP message from the\
            received UDP message.
        """
        return self._sdp_port

    @property
    def tag(self):
        """ The tag required, or None if any tag is OK

        :return: The tag or None
        :rtype: int
        """
        return self._tag

    @property
    def board(self):
        """ A board IP address which is where this reverse IP tag is to be\
            placed.

        :return: str
        """
        return self._board

    def get_value(self):
        """
        :return: A description of the specific board's reverse IP tag required.
        """
        return [self._board, self._port, self._sdp_port, self._tag]

    def __repr__(self):
        return ("ReverseIPTagResource(board={}, port={}, sdp_port={}, tag={})"
                .format(self._board, self._port, self._sdp_port, self._tag))