1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
|
"""
Copyright 2008-2015 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 __future__ import absolute_import
import ast
import collections
import itertools
import six
from six.moves import range
from ._templates import MakoTemplates
from ._flags import Flags
from ..Constants import ADVANCED_PARAM_TAB
from ..base import Element
from ..utils.descriptors import lazy_property
def _get_elem(iterable, key):
items = list(iterable)
for item in items:
if item.key == key:
return item
return ValueError('Key "{}" not found in {}.'.format(key, items))
class Block(Element):
is_block = True
STATE_LABELS = ['disabled', 'enabled', 'bypassed']
key = ''
label = ''
category = ''
flags = Flags('')
documentation = {'': ''}
value = None
checks = []
templates = MakoTemplates()
parameters_data = []
inputs_data = []
outputs_data = []
extra_data = {}
# region Init
def __init__(self, parent):
"""Make a new block from nested data."""
super(Block, self).__init__(parent)
self.params = self._init_params()
self.sinks = self._init_ports(self.inputs_data, direction='sink')
self.sources = self._init_ports(self.outputs_data, direction='source')
self.active_sources = [] # on rewrite
self.active_sinks = [] # on rewrite
self.states = {'state': True}
def _init_params(self):
is_dsp_block = not self.flags.not_dsp
has_inputs = bool(self.inputs_data)
has_outputs = bool(self.outputs_data)
params = collections.OrderedDict()
param_factory = self.parent_platform.make_param
def add_param(id, **kwargs):
params[id] = param_factory(self, id=id, **kwargs)
add_param(id='id', name='ID', dtype='id',
hide='none' if (self.key == 'options' or self.is_variable) else 'part')
if is_dsp_block:
add_param(id='alias', name='Block Alias', dtype='string',
hide='part', category=ADVANCED_PARAM_TAB)
if has_outputs or has_inputs:
add_param(id='affinity', name='Core Affinity', dtype='int_vector',
hide='part', category=ADVANCED_PARAM_TAB)
if has_outputs:
add_param(id='minoutbuf', name='Min Output Buffer', dtype='int',
hide='part', value='0', category=ADVANCED_PARAM_TAB)
add_param(id='maxoutbuf', name='Max Output Buffer', dtype='int',
hide='part', value='0', category=ADVANCED_PARAM_TAB)
base_params_n = {}
for param_data in self.parameters_data:
param_id = param_data['id']
if param_id in params:
raise Exception('Param id "{}" is not unique'.format(param_id))
base_key = param_data.get('base_key', None)
param_data_ext = base_params_n.get(base_key, {}).copy()
param_data_ext.update(param_data)
add_param(**param_data_ext)
base_params_n[param_id] = param_data_ext
add_param(id='comment', name='Comment', dtype='_multiline', hide='part',
value='', category=ADVANCED_PARAM_TAB)
return params
def _init_ports(self, ports_n, direction):
ports = []
port_factory = self.parent_platform.make_port
port_ids = set()
def make_stream_port_id(_pool=itertools.count()):
return {'sink': 'in', 'source': 'out'}[direction] + str(next(_pool))
for i, port_data in enumerate(ports_n):
port_id = port_data.setdefault('id', make_stream_port_id())
if port_id in port_ids:
raise Exception('Port id "{}" already exists in {}s'.format(port_id, direction))
port_ids.add(port_id)
port = port_factory(parent=self, direction=direction, **port_data)
ports.append(port)
return ports
# endregion
# region Rewrite_and_Validation
def rewrite(self):
"""
Add and remove ports to adjust for the nports.
"""
Element.rewrite(self)
def rekey(ports):
"""Renumber non-message/message ports"""
domain_specific_port_index = collections.defaultdict(int)
for port in ports:
if not port.key.isdigit():
continue
domain = port.domain
port.key = str(domain_specific_port_index[domain])
domain_specific_port_index[domain] += 1
# Adjust nports
for ports in (self.sources, self.sinks):
self._rewrite_nports(ports)
rekey(ports)
# disconnect hidden ports
self.parent_flowgraph.disconnect(*[p for p in self.ports() if p.hidden])
self.active_sources = [p for p in self.sources if not p.hidden]
self.active_sinks = [p for p in self.sinks if not p.hidden]
def _rewrite_nports(self, ports):
for port in ports:
if hasattr(port, 'master_port'): # Not a master port and no left-over clones
continue
nports = port.multiplicity
for clone in port.clones[nports-1:]:
# Remove excess connections
self.parent_flowgraph.disconnect(clone)
port.remove_clone(clone)
ports.remove(clone)
# Add more cloned ports
for j in range(1 + len(port.clones), nports):
clone = port.add_clone()
ports.insert(ports.index(port) + j, clone)
def validate(self):
"""
Validate this block.
Call the base class validate.
Evaluate the checks: each check must evaluate to True.
"""
Element.validate(self)
self._run_checks()
self._validate_generate_mode_compat()
self._validate_var_value()
def _run_checks(self):
"""Evaluate the checks"""
for check in self.checks:
try:
if not self.evaluate(check):
self.add_error_message('Check "{}" failed.'.format(check))
except:
self.add_error_message('Check "{}" did not evaluate.'.format(check))
def _validate_generate_mode_compat(self):
"""check if this is a GUI block and matches the selected generate option"""
current_generate_option = self.parent.get_option('generate_options')
def check_generate_mode(label, flag, valid_options):
block_requires_mode = (
flag in self.flags or self.label.upper().startswith(label)
)
if block_requires_mode and current_generate_option not in valid_options:
self.add_error_message("Can't generate this block in mode: {} ".format(
repr(current_generate_option)))
check_generate_mode('QT GUI', Flags.NEED_QT_GUI, ('qt_gui', 'hb_qt_gui'))
def _validate_var_value(self):
"""or variables check the value (only if var_value is used)"""
if self.is_variable and self.value != 'value':
try:
self.parent_flowgraph.evaluate(self.value, local_namespace=self.namespace)
except Exception as err:
self.add_error_message('Value "{}" cannot be evaluated:\n{}'.format(self.value, err))
# endregion
# region Properties
def __str__(self):
return 'Block - {} - {}({})'.format(self.name, self.label, self.key)
def __repr__(self):
try:
name = self.name
except Exception:
name = self.key
return 'block[' + name + ']'
@property
def name(self):
return self.params['id'].value
@lazy_property
def is_virtual_or_pad(self):
return self.key in ("virtual_source", "virtual_sink", "pad_source", "pad_sink")
@lazy_property
def is_variable(self):
return bool(self.value)
@lazy_property
def is_import(self):
return self.key == 'import'
@property
def comment(self):
return self.params['comment'].value
@property
def state(self):
"""Gets the block's current state."""
state = self.states['state']
return state if state in self.STATE_LABELS else 'enabled'
@state.setter
def state(self, value):
"""Sets the state for the block."""
self.states['state'] = value
# Enable/Disable Aliases
@property
def enabled(self):
"""Get the enabled state of the block"""
return self.state != 'disabled'
# endregion
##############################################
# Getters (old)
##############################################
def get_var_make(self):
return self.templates.render('var_make')
def get_var_value(self):
return self.templates.render('var_value')
def get_callbacks(self):
"""
Get a list of function callbacks for this block.
Returns:
a list of strings
"""
def make_callback(callback):
if 'self.' in callback:
return callback
return 'self.{}.{}'.format(self.name, callback)
return [make_callback(c) for c in self.templates.render('callbacks')]
def is_virtual_sink(self):
return self.key == 'virtual_sink'
def is_virtual_source(self):
return self.key == 'virtual_source'
# Block bypassing
def get_bypassed(self):
"""
Check if the block is bypassed
"""
return self.state == 'bypassed'
def set_bypassed(self):
"""
Bypass the block
Returns:
True if block chagnes state
"""
if self.state != 'bypassed' and self.can_bypass():
self.state = 'bypassed'
return True
return False
def can_bypass(self):
""" Check the number of sinks and sources and see if this block can be bypassed """
# Check to make sure this is a single path block
# Could possibly support 1 to many blocks
if len(self.sources) != 1 or len(self.sinks) != 1:
return False
if not (self.sources[0].dtype == self.sinks[0].dtype):
return False
if self.flags.disable_bypass:
return False
return True
def ports(self):
return itertools.chain(self.sources, self.sinks)
def active_ports(self):
return itertools.chain(self.active_sources, self.active_sinks)
def children(self):
return itertools.chain(six.itervalues(self.params), self.ports())
##############################################
# Access
##############################################
def get_sink(self, key):
return _get_elem(self.sinks, key)
def get_source(self, key):
return _get_elem(self.sources, key)
##############################################
# Resolve
##############################################
@property
def namespace(self):
return {key: param.get_evaluated() for key, param in six.iteritems(self.params)}
@property
def namespace_templates(self):
return {key: param.template_arg for key, param in six.iteritems(self.params)}
def evaluate(self, expr):
return self.parent_flowgraph.evaluate(expr, self.namespace)
##############################################
# Import/Export Methods
##############################################
def export_data(self):
"""
Export this block's params to nested data.
Returns:
a nested data odict
"""
data = collections.OrderedDict()
if self.key != 'options':
data['name'] = self.name
data['id'] = self.key
data['parameters'] = collections.OrderedDict(sorted(
(param_id, param.value) for param_id, param in self.params.items()
if param_id != 'id'
))
data['states'] = collections.OrderedDict(sorted(self.states.items()))
return data
def import_data(self, name, states, parameters, **_):
"""
Import this block's params from nested data.
Any param keys that do not exist will be ignored.
Since params can be dynamically created based another param,
call rewrite, and repeat the load until the params stick.
"""
self.params['id'].value = name
self.states.update(states)
def get_hash():
return hash(tuple(hash(v) for v in self.params.values()))
pre_rewrite_hash = -1
while pre_rewrite_hash != get_hash():
for key, value in six.iteritems(parameters):
try:
self.params[key].set_value(value)
except KeyError:
continue
# Store hash and call rewrite
pre_rewrite_hash = get_hash()
self.rewrite()
|