yosys/tests/bind
Rupert Swarbrick 414154dd27 Add support for parsing the SystemVerilog 'bind' construct
This doesn't do anything useful yet: the patch just adds support for
the syntax to the lexer and parser and adds some tests to check the
syntax parses properly. This generates AST nodes, but doesn't yet
generate RTLIL.

Since our existing hierarchical_identifier parser doesn't allow bit
selects (so you can't do something like foo[1].bar[2].baz), I've also
not added support for a trailing bit select (the "constant_bit_select"
non-terminal in "bind_target_instance" in the spec). If we turn out to
need this in future, we'll want to augment hierarchical_identifier and
its other users too.

Note that you can't easily use the BNF from the spec:

    bind_directive ::=
        "bind" bind_target_scope [ : bind_target_instance_list]
               bind_instantiation ;
      | "bind" bind_target_instance bind_instantiation ;

even if you fix the lookahead problem, because code like this matches
both branches in the BNF:

    bind a b b_i (.*);

The problem is that 'a' could either be a module name or a degenerate
hierarchical reference. This seems to be a genuine syntactic
ambiguity, which the spec resolves (p739) by saying that we have to
wait until resolution time (the hierarchy pass) and take whatever is
defined, treating 'a' as an instance name if it names both an instance
and a module.

To keep the parser simple, it currently accepts this invalid syntax:

    bind a.b : c d e (.*);

This is invalid because we're in the first branch of the BNF above, so
the "a.b" term should match bind_target_scope: a module or interface
identifier, not an arbitrary hierarchical identifier.

This will fail in the hierarchy pass (when it's implemented in a
future patch).
2021-07-16 09:31:39 -04:00
..
.gitignore Add support for parsing the SystemVerilog 'bind' construct 2021-07-16 09:31:39 -04:00
basic.sv Add support for parsing the SystemVerilog 'bind' construct 2021-07-16 09:31:39 -04:00
basic.ys Add support for parsing the SystemVerilog 'bind' construct 2021-07-16 09:31:39 -04:00
cell_list.sv Add support for parsing the SystemVerilog 'bind' construct 2021-07-16 09:31:39 -04:00
cell_list.ys Add support for parsing the SystemVerilog 'bind' construct 2021-07-16 09:31:39 -04:00
hier.sv Add support for parsing the SystemVerilog 'bind' construct 2021-07-16 09:31:39 -04:00
hier.ys Add support for parsing the SystemVerilog 'bind' construct 2021-07-16 09:31:39 -04:00
inst_list.sv Add support for parsing the SystemVerilog 'bind' construct 2021-07-16 09:31:39 -04:00
inst_list.ys Add support for parsing the SystemVerilog 'bind' construct 2021-07-16 09:31:39 -04:00
param.sv Add support for parsing the SystemVerilog 'bind' construct 2021-07-16 09:31:39 -04:00
param.ys Add support for parsing the SystemVerilog 'bind' construct 2021-07-16 09:31:39 -04:00
run-test.sh Add support for parsing the SystemVerilog 'bind' construct 2021-07-16 09:31:39 -04:00
toplevel.sv Add support for parsing the SystemVerilog 'bind' construct 2021-07-16 09:31:39 -04:00
toplevel.ys Add support for parsing the SystemVerilog 'bind' construct 2021-07-16 09:31:39 -04:00