""" Copyright 2008-2011 Free Software Foundation, Inc. This file is part of GNU Radio GNU Radio Companion 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 2 of the License, or (at your option) any later version. GNU Radio Companion 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, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA """ from Element import Element from . Constants import GR_STREAM_DOMAIN, GR_MESSAGE_DOMAIN class Port(Element): def __init__(self, block, n, dir): """ Make a new port from nested data. Args: block: the parent element n: the nested odict dir: the direction source or sink """ #build the port Element.__init__(self, block) #grab the data self._name = n['name'] self._key = n['key'] self._type = n['type'] self._domain = n['domain'] self._hide = n.find('hide') or '' self._dir = dir self._hide_evaluated = False # updated on rewrite() def validate(self): """ Validate the port. The port must be non-empty and type must a possible type. """ Element.validate(self) if self.get_type() not in self.get_types(): self.add_error_message('Type "%s" is not a possible type.' % self.get_type()) platform = self.get_parent().get_parent().get_parent() if self.get_domain() not in platform.get_domains(): self.add_error_message('Domain key "%s" is not registered.' % self.get_domain()) def rewrite(self): """resolve dependencies in for type and hide""" Element.rewrite(self) hide = self.get_parent().resolve_dependencies(self._hide).strip().lower() self._hide_evaluated = False if hide in ('false', 'off', '0') else bool(hide) # update domain if was deduced from (dynamic) port type type_ = self.get_type() if self._domain == GR_STREAM_DOMAIN and type_ == "message": self._domain = GR_MESSAGE_DOMAIN self._key = self._name if self._domain == GR_MESSAGE_DOMAIN and type_ != "message": self._domain = GR_STREAM_DOMAIN self._key = '0' # is rectified in rewrite() def __str__(self): if self.is_source(): return 'Source - %s(%s)'%(self.get_name(), self.get_key()) if self.is_sink(): return 'Sink - %s(%s)'%(self.get_name(), self.get_key()) def get_types(self): """ Get a list of all possible port types. @throw NotImplementedError """ raise NotImplementedError def is_port(self): return True def get_color(self): return '#FFFFFF' def get_name(self): number = '' if self.get_type() == 'bus': busses = filter(lambda a: a._dir == self._dir, self.get_parent().get_ports_gui()) number = str(busses.index(self)) + '#' + str(len(self.get_associated_ports())) return self._name + number def get_key(self): return self._key def is_sink(self): return self._dir == 'sink' def is_source(self): return self._dir == 'source' def get_type(self): return self.get_parent().resolve_dependencies(self._type) def get_domain(self): return self._domain def get_hide(self): return self._hide_evaluated def get_connections(self): """ Get all connections that use this port. Returns: a list of connection objects """ connections = self.get_parent().get_parent().get_connections() connections = filter(lambda c: c.get_source() is self or c.get_sink() is self, connections) return connections def get_enabled_connections(self): """ Get all enabled connections that use this port. Returns: a list of connection objects """ return filter(lambda c: c.get_enabled(), self.get_connections()) def get_associated_ports(self): if not self.get_type() == 'bus': return [self] else: if self.is_source(): get_ports = self.get_parent().get_sources bus_structure = self.get_parent().current_bus_structure['source'] else: get_ports = self.get_parent().get_sinks bus_structure = self.get_parent().current_bus_structure['sink'] ports = [i for i in get_ports() if not i.get_type() == 'bus'] if bus_structure: busses = [i for i in get_ports() if i.get_type() == 'bus'] bus_index = busses.index(self) ports = filter(lambda a: ports.index(a) in bus_structure[bus_index], ports) return ports