[topgen/pinmux/doc] Autogen target pinout / pinmux connectivity tables

This adds a top-level doc generation function which currently
generates pinout and pinmux connectivity tables for all targets (ASIC,
CW310 etc) of a specific top-level.

More documentation generation functions can be added in the future, if
needed.

Signed-off-by: Michael Schaffner <[email protected]>

hw/ip/pinmux/doc/_index.md

@@ -382,7 +382,11 @@ A typical programming sequence for the wakeup detectors looks as follows:
 
 ## Pinout and Pinmux Mapping
 
-**TODO: generate tables for top-earlgrey**
+The tables below summarize the pinout and pinmux connectivity for certain top-level designs.
+
+### Top Earlgrey
+
+{{< snippet "./targets.md" >}}
 
 ## Register Table
 

hw/ip/pinmux/doc/targets.md

@@ -0,0 +1,12 @@
+<!--
+DO NOT EDIT THIS FILE DIRECTLY.
+It has been generated with the following command:
+util/topgen.py -t hw/top_earlgrey/data/top_earlgrey.hjson -o hw/top_earlgrey/
+
+-->
+
+|  Target Name  |  #IO Banks  |  #Muxed Pads  |  #Direct Pads  |  #Manual Pads  |  #Total Pads  |                                  Pinout / Pinmux Tables                                  |
+|:-------------:|:-----------:|:-------------:|:--------------:|:--------------:|:-------------:|:----------------------------------------------------------------------------------------:|
+|     ASIC      |      4      |      47       |       14       |       9        |      70       |    [Pinout Table](../../../top_earlgrey/ip/pinmux/doc/autogen/pinout_asic/index.html)    |
+|     CW310     |      4      |      29       |       4        |       16       |      49       |   [Pinout Table](../../../top_earlgrey/ip/pinmux/doc/autogen/pinout_cw310/index.html)    |
+|  NEXYSVIDEO   |      4      |      29       |       4        |       16       |      49       | [Pinout Table](../../../top_earlgrey/ip/pinmux/doc/autogen/pinout_nexysvideo/index.html) |