utils: Support expressions for num_ports in block defs

This commit allows the RFNoC image builder utility to support block
definition .yml files where the num_ports values are numerical
expressions using values sourced from the parameters section when the
block is used in an RFNoC image. An example of such an expression for
num_ports is the split stream block, where the number of output ports is
defined as the product of the NUM_PORTS and NUM_BRANCHES parameters:

    data:
      fpga_iface: axis_chdr
      clk_domain: rfnoc_chdr
      inputs:
        in:
          num_ports: NUM_PORTS
      outputs:
        out:
          num_ports: NUM_PORTS*NUM_BRANCHES

In an RFNoC image definition .yml file, these parameters can be
specified when a split stream block is instantiated in an image:

    split0:
      block_desc: 'split_stream.yml'
      parameters:
        NUM_PORTS: 2
        NUM_BRANCHES: 3

Thus, the split0 instance of the split stream block is configured with 2
input ports and 6 output ports (2*3 from NUM_PORTS*NUM_BRANCHES).

When the RFNoC image builder runs and encounters a block instantiation
where that block has a non-integer string in the num_ports key of its
block definition, it performs a textual replacement of the identifiers
in the string with the corresponding values from the parameters section
of the block's instantiation. If no such parameter corresponding to the
identifier exists, the block definition file's parameters section is
consulted for a default value for the parameter. If no such parameter
can be found in either of these locations, the identifier is left
unchanged in place.

After the text substitution step, the expression is evaluated using
Python's expression evaluator. The expression should evaluate to an
integer value, which is then used as the num_ports value. If the
expression does not evaluate to an integer, or fails to evaluate, an
error will be reported.

0 files changed, 0 insertions, 0 deletions