icestudio: add Blinky variant with 'Board rules'

docs/icestudio.rst

@@ -78,6 +78,28 @@ Modules are browsable, as shown in the screencast above:
 .. image:: _static/icestudio/sb_rgba_drv.png
    :width: 33%
 
+Board rules
+===========
+
+You can use a feature in *icestudio Nightly*.
+Fomu needs to disconnect its USB communication stack,
+so it is always necessary to set pins *usb_dn*, *usb_dp* and *usb_dp_pu*,
+so that it can use the option *"board rules"* for a cleaner desing.
+As an example see the result of applying this feature in the previous example.
+
+.. image:: _static/icestudio/blinky_board_rules.png
+   :width: 600 px
+   :align: center
+
+To use this feature, activate the option in the card properties.
+You can see the rules applied to each pin by using the appropriate option.
+
+.. image:: _static/icestudio/blinky_board_options.gif
+   :width: 600 px
+   :align: center
+
+You can use the file ``Blinky_BoardTop_rules.ice`` as an example.
+
 .. HINT:: Find more info about features of IceStudio (such as collections or
   plugins) in the `documentation <https://juanmard.github.io/icestudio/index.html>`_.
 

icestudio/Blinky_BoardTop.ice

@@ -68,6 +68,26 @@
             "y": 248
           }
         },
+        {
+          "id": "70cad7b1-403f-485d-8a38-f621b3fb5350",
+          "type": "basic.input",
+          "data": {
+            "name": "",
+            "pins": [
+              {
+                "index": "0",
+                "name": "clk",
+                "value": "F4"
+              }
+            ],
+            "virtual": false,
+            "clock": false
+          },
+          "position": {
+            "x": 168,
+            "y": 264
+          }
+        },
         {
           "id": "5a1323c3-4597-429f-a9c7-e8ff5b23d9b3",
           "type": "basic.output",
@@ -214,6 +234,16 @@
             "block": "69ae577b-ac2d-4f56-9596-ffcb4021899a",
             "port": "in"
           }
+        },
+        {
+          "source": {
+            "block": "70cad7b1-403f-485d-8a38-f621b3fb5350",
+            "port": "out"
+          },
+          "target": {
+            "block": "f1fe554e-d771-4fb6-9a5e-fd8ba9aa72b5",
+            "port": "788c569d-cf7f-4dae-aac1-76189ebc5ec8"
+          }
         }
       ]
     }