Merge pull request #52 from gatecat/site-pips-diagrams

docs: Add a diagram showing legal/illegal site pip usage
chipsalliance · May 11, 2021 · d9c7a0b · d9c7a0b
2 parents d2d7ad1 + 828ec3a
commit d9c7a0b
Show file tree

Hide file tree

Showing 2 changed files with 185 additions and 1 deletion.
diff --git a/docs/device_resources.md b/docs/device_resources.md
@@ -242,6 +242,10 @@ entered via the site port corresponding to the site pin. The first site wire
 in the site will be the site wire attached to the output BEL pin of the site
 port.  From there site routing continues per above.
 
+![Wire and nodes](https://symbiflow.readthedocs.io/projects/arch-defs/en/latest/_images/rrgraph-wire.svg)
+
+### Use of site PIPs
+
 It is important to note that site PIPs can only be used to access placed cells
 inside that site. Site PIPs cannot be used as general route-thrus, to route
 from site input to output. General route-thrus across entire sites should use
@@ -255,7 +259,9 @@ an associated flipflop input inside the site. The tile PIP would be used to
 route across the entire site as part of the general, inter-tile, routing
 problem.
 
-![Wire and nodes](https://symbiflow.readthedocs.io/projects/arch-defs/en/latest/_images/rrgraph-wire.svg)
+A diagram illustrating the legal and illegal uses is shown below.
+
+![Site PIP usage](site_pip_usage.svg)
 
 ### Tile Types and site types
 

diff --git a/docs/site_pip_usage.svg b/docs/site_pip_usage.svg