How to do a full build including ANTLR?

[udif]

Looking at setup.py it seems that the package install stage assumes that the parser has already been generated by the ANTLR code generator.
Is there any script that does a full build from scratch generating all files from the ANLR .g4 parser file ? I would like to write my own custom extension (see #94) by adding a new addrmap property (addrwordsize) that would set the address bus units. This implies regenerating the parser.

[amykyta3]

No need to change the parser at all. The SystemRDL language already allows you to define your own property extensions.
See section 15 of the spec - User Defined Properties.
For plugins, I provide an API to make it easier to work with them once defined in the RDL: https://systemrdl-compiler.readthedocs.io/en/stable/api/udp.html

[udif]

As I wrote in #94, modifying the parser was not because of the property, but because I wanted to transparently convert word addresses of arbitrary size into a byte-address internal representation.
Technically, I could do the address translation in the Python part without touching the ANTLR parts, and tag the addrmap with a UDP (I'm well aware of them), but this would have silently failed with a standard SystemRDL reader which would have interpreted my word addresses as byte addresses.

The other option, which I didn't originally think of, was to do the translation using a `define macro:

`define UINT16_ADDR(x) ((x)*2)
`define UINT32_ADDR(x) ((x)*4)

etc.

Then if I do:

property addr_elem_size { type = int; component = addrmap; };

Once I do that, I don't need to modify the SystemRDL compiler to do the address translation internally for me, and I can use a UDP to mark that addrmap as non-byte and modify the export generators to do the output translation (verilog, html, PDF, etc) based on the UDP value on each addrmap. (I need several addrmaps, each at a different width).

Regardless of that, the original question still remains - are there build scripts for the ANTLR part ? (Not there is any need at the moment).

[amykyta3]

Yep. I have a bash script to rebuild the lexer and parser code here: https://github.com/SystemRDL/systemrdl-compiler/blob/main/systemrdl/parser/generate_parser.sh

As well as some notes about installing antlr: https://systemrdl-compiler.readthedocs.io/en/stable/dev_notes/antlr.html