Source code for spynnaker.pyNN.external_devices_models.push_bot.push_bot_ethernet.push_bot_ethernet_speaker_device
# 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/>.
from spinn_utilities.overrides import overrides
from spinn_front_end_common.abstract_models import (
AbstractSendMeMulticastCommandsVertex)
from spinn_front_end_common.abstract_models.impl import (
ProvidesKeyToAtomMappingImpl)
from spinn_front_end_common.utilities.exceptions import ConfigurationException
from .push_bot_ethernet_device import PushBotEthernetDevice
from spynnaker.pyNN.external_devices_models.push_bot.push_bot_parameters \
import (
PushBotSpeaker)
[docs]class PushBotEthernetSpeakerDevice(
PushBotEthernetDevice, AbstractSendMeMulticastCommandsVertex,
ProvidesKeyToAtomMappingImpl):
""" The Speaker of a PushBot
"""
def __init__(
self, speaker, protocol, start_active_time=0,
start_total_period=0, start_frequency=0, start_melody=None,
timesteps_between_send=None):
"""
:param speaker: The PushBotSpeaker value to control
:type speaker: PushBotSpeaker
:param protocol: The protocol instance to get commands from
:type protocol: MunichIoEthernetProtocol
:param start_active_time: The "active time" to set at the start
:param start_total_period: The "total period" to set at the start
:param start_frequency: The "frequency" to set at the start
:param start_melody: The "melody" to set at the start
:param timesteps_between_send:
The number of timesteps between sending commands to the device,\
or None to use the default
"""
# pylint: disable=too-many-arguments
if not isinstance(speaker, PushBotSpeaker):
raise ConfigurationException(
"speaker parameter must be a PushBotSpeaker value")
super(PushBotEthernetSpeakerDevice, self).__init__(
protocol, speaker, True, timesteps_between_send)
# protocol specific data items
self.__command_protocol = protocol
self.__start_active_time = start_active_time
self.__start_total_period = start_total_period
self.__start_frequency = start_frequency
self.__start_melody = start_melody
[docs] @overrides(PushBotEthernetDevice.set_command_protocol)
def set_command_protocol(self, command_protocol):
self.__command_protocol = command_protocol
@property
@overrides(AbstractSendMeMulticastCommandsVertex.start_resume_commands)
def start_resume_commands(self):
commands = list()
# add mode command if not done already
if not self.protocol.sent_mode_command():
commands.append(self.protocol.set_mode())
# device specific commands
commands.append(
self.__command_protocol.push_bot_speaker_config_total_period(
total_period=self.__start_total_period))
commands.append(
self.__command_protocol.push_bot_speaker_config_active_time(
active_time=self.__start_active_time))
if self.__start_frequency is not None:
commands.append(self.__command_protocol.push_bot_speaker_set_tone(
frequency=self.__start_frequency))
if self.__start_melody is not None:
commands.append(
self.__command_protocol.push_bot_speaker_set_melody(
melody=self.__start_melody))
return commands
@property
@overrides(AbstractSendMeMulticastCommandsVertex.pause_stop_commands)
def pause_stop_commands(self):
return [
self.__command_protocol.push_bot_speaker_config_total_period(0),
self.__command_protocol.push_bot_speaker_config_active_time(0),
self.__command_protocol.push_bot_speaker_set_tone(0)]
@property
@overrides(AbstractSendMeMulticastCommandsVertex.timed_commands)
def timed_commands(self):
return []