[top/doc] Autogenerated tables for top-specific IP

[msfschaffner]

We have several top-level specific IPs for which the configuration is not evident from the technical IP specification alone.
Examples are the plic, alert handler, pinmux, pwrmgr, rstmgr, clkmgr.

For some of these, we do already generate top-level specific documentation, such as for example the pinout and pinmux configuration tables here for the block and here for the top-level (both with different scripts, which is another thing that may be unified at some point).

It would probably be good to enhance documentation for the IPs mentioned above to follow this example so that SW developers can find that information more readily.

[andreaskurth]

Triaged for pwrmgr. Assigning Type:Icebox Changes deferred to future milestones as I think this is not needed for M2.5.

[GregAC]

Triaged for rstmgr, added Type:FutureRelease Not relevant to currently planned releases/milestones

[GregAC]

Triaged for pinmux same conclusion as above

[andreaskurth]

Triaged for clkmgr and rv_plic, ditto.

[matutem]

The description of this issue is vague, and the link meant to show an example of the desired tables is broken. Please update so we can determine what really needs to be done.

[msfschaffner]

I fixed the link. The issue has been left open intentionally since it's not fully clear what we want to generate yet, and we can discuss what would be useful. Information that I think could be useful (especially for the top-level documentation):

• table of reset requests and associated indices
• table of wakeup requests and associated indices
• map of alert IDs
• map of IRQ IDs
• pinmux configuration
• pinout (already exists to some degree)
• memory map (already exists to some degree)

etc