From 18f29fc1d3e12bb751a26f52e3e3a3b2549f000d Mon Sep 17 00:00:00 2001
From: seldridge <seldridge@users.noreply.github.com>
Date: Fri, 16 Aug 2024 04:14:03 +0000
Subject: [PATCH] deploy: f347914dee389cebbe48ac4ef2e350e5ac1d267a

---
 404.html                                      |  2 +-
 api.html                                      |  4 +-
 api/chisel3/latest.html                       |  2 +-
 assets/js/17dd133b.a4d03fda.js                |  1 +
 assets/js/17dd133b.eb35e550.js                |  1 -
 assets/js/1ce89024.8397b873.js                |  1 +
 assets/js/1ce89024.8ad3720b.js                |  1 -
 assets/js/67ffb541.aafe16f9.js                |  1 +
 assets/js/67ffb541.b79017b5.js                |  1 -
 ...bfa87.18f8af79.js => 7b5bfa87.eff9fa5b.js} |  2 +-
 assets/js/7cc2f0dc.0f402a60.js                |  1 -
 assets/js/7cc2f0dc.d5e2a205.js                |  1 +
 assets/js/7e1e4a75.82d2355a.js                |  1 -
 assets/js/7e1e4a75.f1b5b02e.js                |  1 +
 assets/js/7fa9ea57.5aff8b69.js                |  1 +
 assets/js/7fa9ea57.a0b7aa39.js                |  1 -
 assets/js/868241d3.8f24b23c.js                |  1 -
 assets/js/868241d3.cd7cbf8a.js                |  1 +
 assets/js/916cecd1.117f3b9d.js                |  1 -
 assets/js/916cecd1.465d4dc0.js                |  1 +
 ...a0ee0.9a00ad74.js => 98ca0ee0.1b04f0c5.js} |  2 +-
 assets/js/a8f82c73.74167bd1.js                |  1 +
 assets/js/a8f82c73.e2fd7a36.js                |  1 -
 assets/js/c48de377.64bb7063.js                |  1 -
 assets/js/c48de377.e33bb9b9.js                |  1 +
 assets/js/c7666d49.11a4da61.js                |  1 +
 assets/js/c7666d49.3ed48610.js                |  1 -
 assets/js/cdcdfbab.733b373f.js                |  1 +
 assets/js/cdcdfbab.eaeb3d96.js                |  1 -
 assets/js/d1e6e3d8.bae292e0.js                |  1 +
 assets/js/d1e6e3d8.de556a7e.js                |  1 -
 assets/js/d4b6d0e6.3905c761.js                |  1 +
 assets/js/d4b6d0e6.dcf1e388.js                |  1 -
 assets/js/d50fb5c7.37482279.js                |  1 -
 assets/js/d50fb5c7.5a3db385.js                |  1 +
 assets/js/f10ce86b.10f5bd03.js                |  1 -
 assets/js/f10ce86b.1a8da0d2.js                |  1 +
 ...n.8290adcf.js => runtime~main.4c8ffac5.js} |  2 +-
 community.html                                |  2 +-
 docs.html                                     |  2 +-
 docs/appendix.html                            |  2 +-
 docs/appendix/experimental-features.html      | 18 +++---
 docs/appendix/migrating-from-chiseltest.html  |  2 +-
 docs/appendix/upgrading-from-chisel-3-4.html  |  2 +-
 docs/appendix/upgrading-from-scala-2-11.html  |  2 +-
 docs/appendix/versioning.html                 |  2 +-
 docs/category/getting-started.html            |  2 +-
 docs/cookbooks.html                           |  2 +-
 docs/cookbooks/cookbook.html                  | 16 +++---
 docs/cookbooks/dataview.html                  |  6 +-
 docs/cookbooks/hierarchy.html                 | 12 ++--
 docs/cookbooks/naming.html                    | 18 +++---
 docs/cookbooks/serialization.html             |  2 +-
 docs/cookbooks/troubleshooting.html           |  2 +-
 docs/developers.html                          |  2 +-
 docs/developers/scaladoc.html                 |  2 +-
 docs/developers/style.html                    |  2 +-
 docs/developers/test-coverage.html            |  2 +-
 docs/explanations.html                        |  2 +-
 docs/explanations/annotations.html            |  2 +-
 docs/explanations/blackboxes.html             |  2 +-
 docs/explanations/bundles-and-vecs.html       |  4 +-
 docs/explanations/chisel-enum.html            |  4 +-
 .../chisel-type-vs-scala-type.html            |  6 +-
 docs/explanations/combinational-circuits.html |  2 +-
 docs/explanations/connectable.html            | 34 +++++------
 docs/explanations/connection-operators.html   | 14 ++---
 docs/explanations/data-types.html             |  2 +-
 docs/explanations/dataview.html               | 16 +++---
 docs/explanations/decoder.html                |  2 +-
 docs/explanations/functional-abstraction.html |  2 +-
 .../functional-module-creation.html           |  2 +-
 docs/explanations/instchoice.html             |  2 +-
 .../interfaces-and-connections.html           |  2 +-
 docs/explanations/intrinsics.html             |  2 +-
 docs/explanations/layers.html                 | 56 +++++++++++++------
 docs/explanations/memories.html               |  2 +-
 docs/explanations/modules.html                |  2 +-
 docs/explanations/motivation.html             |  2 +-
 docs/explanations/multi-clock.html            |  2 +-
 .../muxes-and-input-selection.html            |  2 +-
 docs/explanations/naming.html                 | 26 ++++-----
 docs/explanations/operators.html              |  2 +-
 .../polymorphism-and-parameterization.html    |  4 +-
 docs/explanations/ports.html                  |  4 +-
 docs/explanations/printing.html               |  2 +-
 docs/explanations/properties.html             |  2 +-
 docs/explanations/reset.html                  |  2 +-
 docs/explanations/sequential-circuits.html    |  2 +-
 docs/explanations/source-locators.html        |  2 +-
 docs/explanations/supported-hardware.html     |  2 +-
 docs/explanations/unconnected-wires.html      |  2 +-
 docs/explanations/warnings.html               |  2 +-
 docs/explanations/width-inference.html        |  2 +-
 docs/installation.html                        |  2 +-
 docs/resources.html                           |  2 +-
 docs/resources/faqs.html                      |  6 +-
 generated/contributors.html                   |  2 +-
 generated/scaladoc_links.html                 |  4 +-
 index.html                                    |  2 +-
 search.html                                   |  2 +-
 101 files changed, 204 insertions(+), 182 deletions(-)
 create mode 100644 assets/js/17dd133b.a4d03fda.js
 delete mode 100644 assets/js/17dd133b.eb35e550.js
 create mode 100644 assets/js/1ce89024.8397b873.js
 delete mode 100644 assets/js/1ce89024.8ad3720b.js
 create mode 100644 assets/js/67ffb541.aafe16f9.js
 delete mode 100644 assets/js/67ffb541.b79017b5.js
 rename assets/js/{7b5bfa87.18f8af79.js => 7b5bfa87.eff9fa5b.js} (73%)
 delete mode 100644 assets/js/7cc2f0dc.0f402a60.js
 create mode 100644 assets/js/7cc2f0dc.d5e2a205.js
 delete mode 100644 assets/js/7e1e4a75.82d2355a.js
 create mode 100644 assets/js/7e1e4a75.f1b5b02e.js
 create mode 100644 assets/js/7fa9ea57.5aff8b69.js
 delete mode 100644 assets/js/7fa9ea57.a0b7aa39.js
 delete mode 100644 assets/js/868241d3.8f24b23c.js
 create mode 100644 assets/js/868241d3.cd7cbf8a.js
 delete mode 100644 assets/js/916cecd1.117f3b9d.js
 create mode 100644 assets/js/916cecd1.465d4dc0.js
 rename assets/js/{98ca0ee0.9a00ad74.js => 98ca0ee0.1b04f0c5.js} (95%)
 create mode 100644 assets/js/a8f82c73.74167bd1.js
 delete mode 100644 assets/js/a8f82c73.e2fd7a36.js
 delete mode 100644 assets/js/c48de377.64bb7063.js
 create mode 100644 assets/js/c48de377.e33bb9b9.js
 create mode 100644 assets/js/c7666d49.11a4da61.js
 delete mode 100644 assets/js/c7666d49.3ed48610.js
 create mode 100644 assets/js/cdcdfbab.733b373f.js
 delete mode 100644 assets/js/cdcdfbab.eaeb3d96.js
 create mode 100644 assets/js/d1e6e3d8.bae292e0.js
 delete mode 100644 assets/js/d1e6e3d8.de556a7e.js
 create mode 100644 assets/js/d4b6d0e6.3905c761.js
 delete mode 100644 assets/js/d4b6d0e6.dcf1e388.js
 delete mode 100644 assets/js/d50fb5c7.37482279.js
 create mode 100644 assets/js/d50fb5c7.5a3db385.js
 delete mode 100644 assets/js/f10ce86b.10f5bd03.js
 create mode 100644 assets/js/f10ce86b.1a8da0d2.js
 rename assets/js/{runtime~main.8290adcf.js => runtime~main.4c8ffac5.js} (86%)

diff --git a/404.html b/404.html
index 31bc8a4ce9..4c5a436d4a 100644
--- a/404.html
+++ b/404.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Page Not Found | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/404.html"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docusaurus_tag" content="default"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docsearch:docusaurus_tag" content="default"><meta data-rh="true" property="og:title" content="Page Not Found | Chisel"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/404.html"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/404.html" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/404.html" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/api.html b/api.html
index 20beb1d54a..25e0dfe992 100644
--- a/api.html
+++ b/api.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">API Docs | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/api"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docusaurus_tag" content="default"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docsearch:docusaurus_tag" content="default"><meta data-rh="true" property="og:title" content="API Docs | Chisel"><meta data-rh="true" name="description" content="Chisel API Documentation"><meta data-rh="true" property="og:description" content="Chisel API Documentation"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/api"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/api" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/api" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
@@ -12,7 +12,7 @@
 <p>Please see the page about <a href="/docs/appendix/versioning">Versioning</a> for more information about major and minor versioning and binary compatibility.</p>
 <ul>
 <li><a href="/api/latest/index.html" target="_blank" rel="noopener noreferrer">Latest (6.5.0)</a></li>
-<li><a href="https://s01.oss.sonatype.org/service/local/repositories/snapshots/archive/org/chipsalliance/chisel_2.13/7.0.0-M2+49-ab82fc22-SNAPSHOT/chisel_2.13-7.0.0-M2+49-ab82fc22-SNAPSHOT-javadoc.jar/!/index.html" target="_blank" rel="noopener noreferrer">Snapshot</a></li>
+<li><a href="https://s01.oss.sonatype.org/service/local/repositories/snapshots/archive/org/chipsalliance/chisel_2.13/7.0.0-M2+50-f347914d-SNAPSHOT/chisel_2.13-7.0.0-M2+50-f347914d-SNAPSHOT-javadoc.jar/!/index.html" target="_blank" rel="noopener noreferrer">Snapshot</a></li>
 <li><a href="https://javadoc.io/doc/org.chipsalliance/chisel_2.13/7.0.0-M2" target="_blank" rel="noopener noreferrer">7.0.0-M2</a></li>
 <li><a href="https://javadoc.io/doc/org.chipsalliance/chisel_2.13/6.5.0" target="_blank" rel="noopener noreferrer">6.5.0</a></li>
 <li><a href="https://javadoc.io/doc/org.chipsalliance/chisel_2.13/5.3.0" target="_blank" rel="noopener noreferrer">5.3.0</a></li>
diff --git a/api/chisel3/latest.html b/api/chisel3/latest.html
index 3f27c5dd97..5739be262c 100644
--- a/api/chisel3/latest.html
+++ b/api/chisel3/latest.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Chisel</title><meta data-rh="true" property="og:title" content="Chisel"><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/api/chisel3/latest"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docusaurus_tag" content="default"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docsearch:docusaurus_tag" content="default"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/api/chisel3/latest"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/api/chisel3/latest" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/api/chisel3/latest" hreflang="x-default"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/assets/js/17dd133b.a4d03fda.js b/assets/js/17dd133b.a4d03fda.js
new file mode 100644
index 0000000000..4b5de6ab98
--- /dev/null
+++ b/assets/js/17dd133b.a4d03fda.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[8316],{8203:(e,i,n)=>{n.r(i),n.d(i,{assets:()=>a,contentTitle:()=>r,default:()=>h,frontMatter:()=>s,metadata:()=>t,toc:()=>d});var l=n(4848),o=n(8453);const s={layout:"docs",title:"Frequently Asked Questions",section:"chisel3"},r="Frequently Asked Questions",t={id:"resources/faqs",title:"Frequently Asked Questions",description:"* Where should I start if I want to learn Chisel?",source:"@site/docs/resources/faqs.md",sourceDirName:"resources",slug:"/resources/faqs",permalink:"/docs/resources/faqs",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/resources/faqs.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Frequently Asked Questions",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Chisel Resources",permalink:"/docs/resources"}},a={},d=[{value:"Where should I start if I want to learn Chisel?",id:"where-should-i-start-if-i-want-to-learn-chisel",level:3},{value:"How do I do ... (e.g. like that in Verilog) in Chisel?",id:"how-do-i-do--eg-like-that-in-verilog-in-chisel",level:3},{value:"What versions of the various projects work together?",id:"what-versions-of-the-various-projects-work-together",level:3},{value:"How can I contribute to Chisel?",id:"how-can-i-contribute-to-chisel",level:3},{value:"Why DecoupledIO instead of ReadyValidIO?",id:"why-decoupledio-instead-of-readyvalidio",level:3},{value:"Why do I have to wrap module instantiations in <code>Module(...)</code>?",id:"why-do-i-have-to-wrap-module-instantiations-in-module",level:3},{value:"Why Chisel?",id:"why-chisel",level:3},{value:"Does Chisel support X and Z logic values",id:"does-chisel-support-x-and-z-logic-values",level:3},{value:"Get me Verilog",id:"get-me-verilog",level:3},{value:"Get me FIRRTL",id:"get-me-firrtl",level:3},{value:"Why doesn&#39;t Chisel tell me which wires aren&#39;t connected?",id:"why-doesnt-chisel-tell-me-which-wires-arent-connected",level:3},{value:"What does <code>Reference ... is not fully initialized.</code> mean?",id:"what-does-reference--is-not-fully-initialized-mean",level:3},{value:"Can I specify behavior before and after generated initial blocks?",id:"can-i-specify-behavior-before-and-after-generated-initial-blocks",level:3}];function c(e){const i={a:"a",code:"code",em:"em",h1:"h1",h3:"h3",li:"li",p:"p",pre:"pre",ul:"ul",...(0,o.R)(),...e.components};return(0,l.jsxs)(l.Fragment,{children:[(0,l.jsx)(i.h1,{id:"frequently-asked-questions",children:"Frequently Asked Questions"}),"\n",(0,l.jsxs)(i.ul,{children:["\n",(0,l.jsx)(i.li,{children:(0,l.jsx)(i.a,{href:"#where-should-i-start-if-i-want-to-learn-chisel",children:"Where should I start if I want to learn Chisel?"})}),"\n",(0,l.jsx)(i.li,{children:(0,l.jsx)(i.a,{href:"#how-do-i-do--eg-like-that-in-verilog-in-chisel",children:"How do I ... in Chisel?"})}),"\n",(0,l.jsx)(i.li,{children:(0,l.jsx)(i.a,{href:"#what-versions-of-the-various-projects-work-together",children:"What versions of the various projects work together?"})}),"\n",(0,l.jsx)(i.li,{children:(0,l.jsx)(i.a,{href:"#how-can-i-contribute-to-chisel",children:"How can I contribute to Chisel?"})}),"\n",(0,l.jsx)(i.li,{children:(0,l.jsx)(i.a,{href:"#why-decoupledio-instead-of-readyvalidio",children:"Why DecoupledIO instead of ReadyValidIO?"})}),"\n",(0,l.jsx)(i.li,{children:(0,l.jsxs)(i.a,{href:"#why-do-i-have-to-wrap-module-instantiations-in-module",children:["Why do I have to wrap module instantiations in ",(0,l.jsx)(i.code,{children:"Module(...)"}),"?"]})}),"\n",(0,l.jsx)(i.li,{children:(0,l.jsx)(i.a,{href:"#why-chisel",children:"Why Chisel?"})}),"\n",(0,l.jsx)(i.li,{children:(0,l.jsx)(i.a,{href:"#does-chisel-support-x-and-z-logic-values",children:"Does Chisel support X and Z logic values?"})}),"\n",(0,l.jsx)(i.li,{children:(0,l.jsx)(i.a,{href:"#get-me-verilog",children:"I just want some Verilog; what do I do?"})}),"\n",(0,l.jsx)(i.li,{children:(0,l.jsx)(i.a,{href:"#get-me-firrtl",children:"I just want some FIRRTL; what do I do?"})}),"\n",(0,l.jsx)(i.li,{children:(0,l.jsx)(i.a,{href:"#why-doesnt-chisel-tell-me-which-wires-arent-connected",children:"Why doesn't Chisel tell me which wires aren't connected?"})}),"\n",(0,l.jsx)(i.li,{children:(0,l.jsxs)(i.a,{href:"#what-does-reference--is-not-fully-initialized-mean",children:["What does ",(0,l.jsx)(i.code,{children:"Reference ... is not fully initialized."})," mean?"]})}),"\n",(0,l.jsx)(i.li,{children:(0,l.jsx)(i.a,{href:"#can-i-specify-behavior-before-and-after-generated-initial-blocks",children:"Can I specify behavior before and after generated initial blocks?"})}),"\n"]}),"\n",(0,l.jsx)(i.h3,{id:"where-should-i-start-if-i-want-to-learn-chisel",children:"Where should I start if I want to learn Chisel?"}),"\n",(0,l.jsxs)(i.p,{children:["We recommend the ",(0,l.jsx)(i.a,{href:"https://github.com/freechipsproject/chisel-bootcamp",children:"Chisel Bootcamp"})," for getting started with Chisel."]}),"\n",(0,l.jsx)(i.h3,{id:"how-do-i-do--eg-like-that-in-verilog-in-chisel",children:"How do I do ... (e.g. like that in Verilog) in Chisel?"}),"\n",(0,l.jsxs)(i.p,{children:["See the ",(0,l.jsx)(i.a,{href:"../cookbooks/cookbook",children:"cookbooks"}),"."]}),"\n",(0,l.jsx)(i.h3,{id:"what-versions-of-the-various-projects-work-together",children:"What versions of the various projects work together?"}),"\n",(0,l.jsxs)(i.p,{children:["See ",(0,l.jsx)(i.a,{href:"../appendix/versioning",children:"Chisel Project Versioning"}),"."]}),"\n",(0,l.jsx)(i.h3,{id:"how-can-i-contribute-to-chisel",children:"How can I contribute to Chisel?"}),"\n",(0,l.jsxs)(i.p,{children:["Check out the ",(0,l.jsx)(i.a,{href:"https://github.com/chipsalliance/chisel3#contributor-documentation",children:"Contributor Documentation"})," in the chisel3 repository."]}),"\n",(0,l.jsx)(i.h3,{id:"why-decoupledio-instead-of-readyvalidio",children:"Why DecoupledIO instead of ReadyValidIO?"}),"\n",(0,l.jsx)(i.p,{children:"There are multiple kinds of Ready/Valid interfaces that impose varying restrictions on the producers and consumers. Chisel currently provides the following:"}),"\n",(0,l.jsxs)(i.ul,{children:["\n",(0,l.jsxs)(i.li,{children:[(0,l.jsx)(i.a,{href:"https://chisel.eecs.berkeley.edu/api/index.html#chisel3.util.DecoupledIO",children:"DecoupledIO"})," - No guarantees"]}),"\n",(0,l.jsxs)(i.li,{children:[(0,l.jsx)(i.a,{href:"https://chisel.eecs.berkeley.edu/api/index.html#chisel3.util.IrrevocableIO",children:"IrrevocableIO"})," - Producer promises to not change the value of 'bits' after a cycle where 'valid' is high and 'ready' is low. Additionally, once 'valid' is raised it will never be lowered until after 'ready' has also been raised."]}),"\n"]}),"\n",(0,l.jsxs)(i.h3,{id:"why-do-i-have-to-wrap-module-instantiations-in-module",children:["Why do I have to wrap module instantiations in ",(0,l.jsx)(i.code,{children:"Module(...)"}),"?"]}),"\n",(0,l.jsx)(i.p,{children:"In short: Limitations of Scala"}),"\n",(0,l.jsxs)(i.p,{children:["Chisel Modules are written by defining a ",(0,l.jsx)(i.a,{href:"http://docs.scala-lang.org/tutorials/tour/classes.html",children:"Scala class"})," and implementing its constructor. As elaboration runs, Chisel constructs a hardware AST from these Modules. The compiler needs hooks to run before and after the actual construction of the Module object. In Scala, superclasses are fully initialized before subclasses, so by extending Module, Chisel has the ability to run some initialization code before the user's Module is constructed. However, there is no such hook to run after the Module object is initialized. By wrapping Module instantiations in the Module object's apply method (ie. ",(0,l.jsx)(i.code,{children:"Module(...)"}),"), Chisel is able to perform post-initialization actions. There is a ",(0,l.jsx)(i.a,{href:"https://issues.scala-lang.org/browse/SI-4330",children:"proposed solution"}),", so eventually this requirement will be lifted, but for now, wrap those Modules!"]}),"\n",(0,l.jsx)(i.h3,{id:"why-chisel",children:"Why Chisel?"}),"\n",(0,l.jsxs)(i.p,{children:["Please see ",(0,l.jsx)(i.a,{href:"../explanations/motivation",children:"Chisel Motivation"})]}),"\n",(0,l.jsx)(i.h3,{id:"does-chisel-support-x-and-z-logic-values",children:"Does Chisel support X and Z logic values"}),"\n",(0,l.jsxs)(i.p,{children:["Chisel does not directly support Verilog logic values ",(0,l.jsx)(i.code,{children:"x"})," ",(0,l.jsx)(i.em,{children:"unknown"})," and ",(0,l.jsx)(i.code,{children:"z"})," ",(0,l.jsx)(i.em,{children:"high-impedance"}),".  There are a number of reasons to want to avoid these values.  See:",(0,l.jsx)(i.a,{href:"http://infocenter.arm.com/help/topic/com.arm.doc.arp0009a/Verilog_X_Bugs.pdf",children:"The Dangers of Living With An X"})," and ",(0,l.jsx)(i.a,{href:"http://ieeexplore.ieee.org/document/7827620/",children:"Malicious LUT: A stealthy FPGA Trojan injected and triggered by the design flow"}),".  Chisel has its own eco-system of unit and functional testers that limit the need for ",(0,l.jsx)(i.code,{children:"x"})," and ",(0,l.jsx)(i.code,{children:"z"})," and their omission simplify language implementation, design, and testing.  The circuits created by chisel do not preclude developers from using ",(0,l.jsx)(i.code,{children:"x"})," and ",(0,l.jsx)(i.code,{children:"z"})," in downstream toolchains as they see fit."]}),"\n",(0,l.jsx)(i.h3,{id:"get-me-verilog",children:"Get me Verilog"}),"\n",(0,l.jsx)(i.p,{children:"I wrote a module and I want to see the Verilog; what do I do?"}),"\n",(0,l.jsx)(i.p,{children:"Here's a simple hello world module in a file HelloWorld.scala."}),"\n",(0,l.jsx)(i.pre,{children:(0,l.jsx)(i.code,{className:"language-scala",children:"package intro\n"})}),"\n",(0,l.jsx)(i.pre,{children:(0,l.jsx)(i.code,{className:"language-scala",children:'import chisel3._\nclass HelloWorld extends Module {\n  val io = IO(new Bundle{})\n  printf("hello world\\n")\n}\n'})}),"\n",(0,l.jsx)(i.p,{children:"Add the following"}),"\n",(0,l.jsx)(i.pre,{children:(0,l.jsx)(i.code,{className:"language-scala",children:"import circt.stage.ChiselStage\nobject VerilogMain extends App {\n  ChiselStage.emitSystemVerilog(new HelloWorld)\n}\n"})}),"\n",(0,l.jsx)(i.p,{children:"Now you can get some Verilog. Start sbt:"}),"\n",(0,l.jsx)(i.pre,{children:(0,l.jsx)(i.code,{children:"bash> sbt\n> run-main intro.VerilogMain\n[info] Running intro.VerilogMain\n[info] [0.004] Elaborating design...\n[info] [0.100] Done elaborating.\n[success] Total time: 1 s, completed Jan 12, 2017 6:24:03 PM\n"})}),"\n",(0,l.jsx)(i.p,{children:"or as a one-liner:"}),"\n",(0,l.jsx)(i.pre,{children:(0,l.jsx)(i.code,{children:"bash> sbt 'runMain intro.VerilogMain'\n"})}),"\n",(0,l.jsx)(i.p,{children:"After either of the above there will be a HelloWorld.v file in the current directory:"}),"\n",(0,l.jsx)(i.pre,{children:(0,l.jsx)(i.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\n\n// Users can define \'PRINTF_COND\' to add an extra gate to prints.\n`ifndef PRINTF_COND_\n  `ifdef PRINTF_COND\n    `define PRINTF_COND_ (`PRINTF_COND)\n  `else  // PRINTF_COND\n    `define PRINTF_COND_ 1\n  `endif // PRINTF_COND\n`endif // not def PRINTF_COND_\nmodule HelloWorld(\t// faqs.md:11:7\n  input clock,\t// faqs.md:11:7\n        reset\t// faqs.md:11:7\n);\n\n  `ifndef SYNTHESIS\t// faqs.md:13:9\n    always @(posedge clock) begin\t// faqs.md:13:9\n      if ((`PRINTF_COND_) & ~reset)\t// faqs.md:13:9\n        $fwrite(32\'h80000002, "hello world\\n");\t// faqs.md:13:9\n    end // always @(posedge)\n  `endif // not def SYNTHESIS\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_HelloWorld_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_HelloWorld_Verification.sv"\n`ifndef layers_HelloWorld_Verification_Cover\n`define layers_HelloWorld_Verification_Cover\t// <stdin>:6:5\n`endif // layers_HelloWorld_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_HelloWorld_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_HelloWorld_Verification.sv"\n`ifndef layers_HelloWorld_Verification_Assume\n`define layers_HelloWorld_Verification_Assume\t// <stdin>:5:5\n`endif // layers_HelloWorld_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_HelloWorld_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_HelloWorld_Verification.sv"\n`ifndef layers_HelloWorld_Verification_Assert\n`define layers_HelloWorld_Verification_Assert\t// <stdin>:4:5\n`endif // layers_HelloWorld_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_HelloWorld_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_HelloWorld_Verification\n`define layers_HelloWorld_Verification\t// <stdin>:3:3\n`endif // layers_HelloWorld_Verification\t// <stdin>:3:3\n\n'})}),"\n",(0,l.jsx)(i.p,{children:"You can see additional options with"}),"\n",(0,l.jsx)(i.pre,{children:(0,l.jsx)(i.code,{children:"bash> sbt 'runMain intro.HelloWorld --help'\n"})}),"\n",(0,l.jsx)(i.p,{children:"This will return a comprehensive usage line with available options."}),"\n",(0,l.jsx)(i.p,{children:"For example to place the output in a directory name buildstuff use"}),"\n",(0,l.jsx)(i.pre,{children:(0,l.jsx)(i.code,{children:"bash> sbt 'runMain intro.HelloWorld --target-dir buildstuff --top-name HelloWorld'\n"})}),"\n",(0,l.jsx)(i.p,{children:"Alternatively, you can also use the sbt console to invoke the Verilog driver:"}),"\n",(0,l.jsx)(i.pre,{children:(0,l.jsx)(i.code,{children:'$ sbt\n> console\n[info] Starting scala interpreter...\nWelcome to Scala 2.12.13 (OpenJDK 64-Bit Server VM, Java 1.8.0_275).\nType in expressions for evaluation. Or try :help.\n\nscala> (new circt.stage.ChiselStage).emitSystemVerilog(new HelloWorld())\nchisel3.Driver.execute(Array[String](), () => new HelloWorld)\nElaborating design...\nDone elaborating.\nres1: String =\n"module HelloWorld(\n  input   clock,\n  input   reset\n);\n...\n'})}),"\n",(0,l.jsx)(i.p,{children:"As before, there should be a HelloWorld.v file in the current directory."}),"\n",(0,l.jsxs)(i.p,{children:["Note: Using the following, without the ",(0,l.jsx)(i.code,{children:"new"}),",\nwill ONLY return the string representation, and will not emit a ",(0,l.jsx)(i.code,{children:".v"})," file:"]}),"\n",(0,l.jsx)(i.pre,{children:(0,l.jsx)(i.code,{className:"language-scala",children:"ChiselStage.emitSystemVerilog(new HelloWorld())\n"})}),"\n",(0,l.jsx)(i.h3,{id:"get-me-firrtl",children:"Get me FIRRTL"}),"\n",(0,l.jsx)(i.p,{children:"If for some reason you don't want the Verilog (e.g. maybe you want to run some custom transformations before exporting to Verilog), then use something along these lines:"}),"\n",(0,l.jsx)(i.pre,{children:(0,l.jsx)(i.code,{className:"language-scala",children:"package intro\n"})}),"\n",(0,l.jsx)(i.pre,{children:(0,l.jsx)(i.code,{className:"language-scala",children:"\nimport chisel3._\nimport circt.stage.ChiselStage\n\nclass MyFirrtlModule extends Module {\n  val io = IO(new Bundle{})\n}\n\nobject FirrtlMain extends App {\n  ChiselStage.emitCHIRRTL(new MyFirrtlModule)\n}\n"})}),"\n",(0,l.jsx)(i.p,{children:"Run it with:"}),"\n",(0,l.jsx)(i.pre,{children:(0,l.jsx)(i.code,{children:"sbt 'runMain intro.FirrtlMain'\n"})}),"\n",(0,l.jsx)(i.pre,{children:(0,l.jsx)(i.code,{children:'FIRRTL version 4.0.0\ncircuit MyFirrtlModule :\n  layer Verification, bind, "Verification" :\n    layer Assert, bind, "Verification/Assert" :\n    layer Assume, bind, "Verification/Assume" :\n    layer Cover, bind, "Verification/Cover" :\n  public module MyFirrtlModule : @[faqs.md 64:7]\n    input clock : Clock @[faqs.md 64:7]\n    input reset : UInt<1> @[faqs.md 64:7]\n    output io : { } @[faqs.md 65:14]\n\n    skip\n\n\n'})}),"\n",(0,l.jsx)(i.p,{children:"Alternatively, you can also use the sbt console to invoke the FIRRTL driver directly (replace MyFirrtlModule with your module name):"}),"\n",(0,l.jsx)(i.pre,{children:(0,l.jsx)(i.code,{children:"$ sbt\n> console\n[info] Starting scala interpreter...\nWelcome to Scala 2.12.13 (OpenJDK 64-Bit Server VM, Java 1.8.0_275).\nType in expressions for evaluation. Or try :help.\n\nscala> circt.stage.ChiselStage.emitCHIRRTL(new MyFirrtlModule)\nElaborating design...\nDone elaborating.\nres3: String = ...\n"})}),"\n",(0,l.jsx)(i.h3,{id:"why-doesnt-chisel-tell-me-which-wires-arent-connected",children:"Why doesn't Chisel tell me which wires aren't connected?"}),"\n",(0,l.jsxs)(i.p,{children:["As long as your code uses ",(0,l.jsx)(i.code,{children:"import chisel3._"})," (and not ",(0,l.jsx)(i.code,{children:"import Chisel._"}),"), it does!\nSee ",(0,l.jsx)(i.a,{href:"../explanations/unconnected-wires",children:"Unconnected Wires"})," for details."]}),"\n",(0,l.jsxs)(i.h3,{id:"what-does-reference--is-not-fully-initialized-mean",children:["What does ",(0,l.jsx)(i.code,{children:"Reference ... is not fully initialized."})," mean?"]}),"\n",(0,l.jsx)(i.p,{children:"It means that you have unconnected wires in your design which could be an indication of a design bug."}),"\n",(0,l.jsxs)(i.p,{children:["In Chisel2 compatibility mode (",(0,l.jsx)(i.code,{children:"NotStrict"})," compile options), chisel generates firrtl code that disables firrtl's initialized wire checks.\nIn pure chisel3 (",(0,l.jsx)(i.code,{children:"Strict"})," compile options), the generated firrtl code does not contain these disablers (",(0,l.jsx)(i.code,{children:"is invalid"}),").\nOutput wires that are not driven (not connected) are reported by firrtl as ",(0,l.jsx)(i.code,{children:"not fully initialized"}),".\nRead more at ",(0,l.jsx)(i.a,{href:"../explanations/unconnected-wires",children:"Unconnected Wires"})," for details on solving the problem."]}),"\n",(0,l.jsx)(i.h3,{id:"can-i-specify-behavior-before-and-after-generated-initial-blocks",children:"Can I specify behavior before and after generated initial blocks?"}),"\n",(0,l.jsx)(i.p,{children:"Users may define the following macros if they wish to specify behavior before or after emitted initial blocks."}),"\n",(0,l.jsxs)(i.ul,{children:["\n",(0,l.jsxs)(i.li,{children:[(0,l.jsx)(i.code,{children:"BEFORE_INITIAL"}),", which is called before the emitted (non-empty) initial block if it is defined"]}),"\n",(0,l.jsxs)(i.li,{children:[(0,l.jsx)(i.code,{children:"AFTER_INITIAL"}),", which is called after the emitted (non-empty) initial block if it is defined"]}),"\n"]}),"\n",(0,l.jsx)(i.p,{children:"These macros may be useful for turning coverage on and off."})]})}function h(e={}){const{wrapper:i}={...(0,o.R)(),...e.components};return i?(0,l.jsx)(i,{...e,children:(0,l.jsx)(c,{...e})}):c(e)}},8453:(e,i,n)=>{n.d(i,{R:()=>r,x:()=>t});var l=n(6540);const o={},s=l.createContext(o);function r(e){const i=l.useContext(s);return l.useMemo((function(){return"function"==typeof e?e(i):{...i,...e}}),[i,e])}function t(e){let i;return i=e.disableParentContext?"function"==typeof e.components?e.components(o):e.components||o:r(e.components),l.createElement(s.Provider,{value:i},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/17dd133b.eb35e550.js b/assets/js/17dd133b.eb35e550.js
deleted file mode 100644
index ebb602b8cc..0000000000
--- a/assets/js/17dd133b.eb35e550.js
+++ /dev/null
@@ -1 +0,0 @@
-"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[8316],{8203:(e,n,i)=>{i.r(n),i.d(n,{assets:()=>a,contentTitle:()=>t,default:()=>h,frontMatter:()=>o,metadata:()=>r,toc:()=>d});var s=i(4848),l=i(8453);const o={layout:"docs",title:"Frequently Asked Questions",section:"chisel3"},t="Frequently Asked Questions",r={id:"resources/faqs",title:"Frequently Asked Questions",description:"* Where should I start if I want to learn Chisel?",source:"@site/docs/resources/faqs.md",sourceDirName:"resources",slug:"/resources/faqs",permalink:"/docs/resources/faqs",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/resources/faqs.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Frequently Asked Questions",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Chisel Resources",permalink:"/docs/resources"}},a={},d=[{value:"Where should I start if I want to learn Chisel?",id:"where-should-i-start-if-i-want-to-learn-chisel",level:3},{value:"How do I do ... (e.g. like that in Verilog) in Chisel?",id:"how-do-i-do--eg-like-that-in-verilog-in-chisel",level:3},{value:"What versions of the various projects work together?",id:"what-versions-of-the-various-projects-work-together",level:3},{value:"How can I contribute to Chisel?",id:"how-can-i-contribute-to-chisel",level:3},{value:"Why DecoupledIO instead of ReadyValidIO?",id:"why-decoupledio-instead-of-readyvalidio",level:3},{value:"Why do I have to wrap module instantiations in <code>Module(...)</code>?",id:"why-do-i-have-to-wrap-module-instantiations-in-module",level:3},{value:"Why Chisel?",id:"why-chisel",level:3},{value:"Does Chisel support X and Z logic values",id:"does-chisel-support-x-and-z-logic-values",level:3},{value:"Get me Verilog",id:"get-me-verilog",level:3},{value:"Get me FIRRTL",id:"get-me-firrtl",level:3},{value:"Why doesn&#39;t Chisel tell me which wires aren&#39;t connected?",id:"why-doesnt-chisel-tell-me-which-wires-arent-connected",level:3},{value:"What does <code>Reference ... is not fully initialized.</code> mean?",id:"what-does-reference--is-not-fully-initialized-mean",level:3},{value:"Can I specify behavior before and after generated initial blocks?",id:"can-i-specify-behavior-before-and-after-generated-initial-blocks",level:3}];function c(e){const n={a:"a",code:"code",em:"em",h1:"h1",h3:"h3",li:"li",p:"p",pre:"pre",ul:"ul",...(0,l.R)(),...e.components};return(0,s.jsxs)(s.Fragment,{children:[(0,s.jsx)(n.h1,{id:"frequently-asked-questions",children:"Frequently Asked Questions"}),"\n",(0,s.jsxs)(n.ul,{children:["\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"#where-should-i-start-if-i-want-to-learn-chisel",children:"Where should I start if I want to learn Chisel?"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"#how-do-i-do--eg-like-that-in-verilog-in-chisel",children:"How do I ... in Chisel?"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"#what-versions-of-the-various-projects-work-together",children:"What versions of the various projects work together?"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"#how-can-i-contribute-to-chisel",children:"How can I contribute to Chisel?"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"#why-decoupledio-instead-of-readyvalidio",children:"Why DecoupledIO instead of ReadyValidIO?"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsxs)(n.a,{href:"#why-do-i-have-to-wrap-module-instantiations-in-module",children:["Why do I have to wrap module instantiations in ",(0,s.jsx)(n.code,{children:"Module(...)"}),"?"]})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"#why-chisel",children:"Why Chisel?"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"#does-chisel-support-x-and-z-logic-values",children:"Does Chisel support X and Z logic values?"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"#get-me-verilog",children:"I just want some Verilog; what do I do?"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"#get-me-firrtl",children:"I just want some FIRRTL; what do I do?"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"#why-doesnt-chisel-tell-me-which-wires-arent-connected",children:"Why doesn't Chisel tell me which wires aren't connected?"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsxs)(n.a,{href:"#what-does-reference--is-not-fully-initialized-mean",children:["What does ",(0,s.jsx)(n.code,{children:"Reference ... is not fully initialized."})," mean?"]})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"#can-i-specify-behavior-before-and-after-generated-initial-blocks",children:"Can I specify behavior before and after generated initial blocks?"})}),"\n"]}),"\n",(0,s.jsx)(n.h3,{id:"where-should-i-start-if-i-want-to-learn-chisel",children:"Where should I start if I want to learn Chisel?"}),"\n",(0,s.jsxs)(n.p,{children:["We recommend the ",(0,s.jsx)(n.a,{href:"https://github.com/freechipsproject/chisel-bootcamp",children:"Chisel Bootcamp"})," for getting started with Chisel."]}),"\n",(0,s.jsx)(n.h3,{id:"how-do-i-do--eg-like-that-in-verilog-in-chisel",children:"How do I do ... (e.g. like that in Verilog) in Chisel?"}),"\n",(0,s.jsxs)(n.p,{children:["See the ",(0,s.jsx)(n.a,{href:"../cookbooks/cookbook",children:"cookbooks"}),"."]}),"\n",(0,s.jsx)(n.h3,{id:"what-versions-of-the-various-projects-work-together",children:"What versions of the various projects work together?"}),"\n",(0,s.jsxs)(n.p,{children:["See ",(0,s.jsx)(n.a,{href:"../appendix/versioning",children:"Chisel Project Versioning"}),"."]}),"\n",(0,s.jsx)(n.h3,{id:"how-can-i-contribute-to-chisel",children:"How can I contribute to Chisel?"}),"\n",(0,s.jsxs)(n.p,{children:["Check out the ",(0,s.jsx)(n.a,{href:"https://github.com/chipsalliance/chisel3#contributor-documentation",children:"Contributor Documentation"})," in the chisel3 repository."]}),"\n",(0,s.jsx)(n.h3,{id:"why-decoupledio-instead-of-readyvalidio",children:"Why DecoupledIO instead of ReadyValidIO?"}),"\n",(0,s.jsx)(n.p,{children:"There are multiple kinds of Ready/Valid interfaces that impose varying restrictions on the producers and consumers. Chisel currently provides the following:"}),"\n",(0,s.jsxs)(n.ul,{children:["\n",(0,s.jsxs)(n.li,{children:[(0,s.jsx)(n.a,{href:"https://chisel.eecs.berkeley.edu/api/index.html#chisel3.util.DecoupledIO",children:"DecoupledIO"})," - No guarantees"]}),"\n",(0,s.jsxs)(n.li,{children:[(0,s.jsx)(n.a,{href:"https://chisel.eecs.berkeley.edu/api/index.html#chisel3.util.IrrevocableIO",children:"IrrevocableIO"})," - Producer promises to not change the value of 'bits' after a cycle where 'valid' is high and 'ready' is low. Additionally, once 'valid' is raised it will never be lowered until after 'ready' has also been raised."]}),"\n"]}),"\n",(0,s.jsxs)(n.h3,{id:"why-do-i-have-to-wrap-module-instantiations-in-module",children:["Why do I have to wrap module instantiations in ",(0,s.jsx)(n.code,{children:"Module(...)"}),"?"]}),"\n",(0,s.jsx)(n.p,{children:"In short: Limitations of Scala"}),"\n",(0,s.jsxs)(n.p,{children:["Chisel Modules are written by defining a ",(0,s.jsx)(n.a,{href:"http://docs.scala-lang.org/tutorials/tour/classes.html",children:"Scala class"})," and implementing its constructor. As elaboration runs, Chisel constructs a hardware AST from these Modules. The compiler needs hooks to run before and after the actual construction of the Module object. In Scala, superclasses are fully initialized before subclasses, so by extending Module, Chisel has the ability to run some initialization code before the user's Module is constructed. However, there is no such hook to run after the Module object is initialized. By wrapping Module instantiations in the Module object's apply method (ie. ",(0,s.jsx)(n.code,{children:"Module(...)"}),"), Chisel is able to perform post-initialization actions. There is a ",(0,s.jsx)(n.a,{href:"https://issues.scala-lang.org/browse/SI-4330",children:"proposed solution"}),", so eventually this requirement will be lifted, but for now, wrap those Modules!"]}),"\n",(0,s.jsx)(n.h3,{id:"why-chisel",children:"Why Chisel?"}),"\n",(0,s.jsxs)(n.p,{children:["Please see ",(0,s.jsx)(n.a,{href:"../explanations/motivation",children:"Chisel Motivation"})]}),"\n",(0,s.jsx)(n.h3,{id:"does-chisel-support-x-and-z-logic-values",children:"Does Chisel support X and Z logic values"}),"\n",(0,s.jsxs)(n.p,{children:["Chisel does not directly support Verilog logic values ",(0,s.jsx)(n.code,{children:"x"})," ",(0,s.jsx)(n.em,{children:"unknown"})," and ",(0,s.jsx)(n.code,{children:"z"})," ",(0,s.jsx)(n.em,{children:"high-impedance"}),".  There are a number of reasons to want to avoid these values.  See:",(0,s.jsx)(n.a,{href:"http://infocenter.arm.com/help/topic/com.arm.doc.arp0009a/Verilog_X_Bugs.pdf",children:"The Dangers of Living With An X"})," and ",(0,s.jsx)(n.a,{href:"http://ieeexplore.ieee.org/document/7827620/",children:"Malicious LUT: A stealthy FPGA Trojan injected and triggered by the design flow"}),".  Chisel has its own eco-system of unit and functional testers that limit the need for ",(0,s.jsx)(n.code,{children:"x"})," and ",(0,s.jsx)(n.code,{children:"z"})," and their omission simplify language implementation, design, and testing.  The circuits created by chisel do not preclude developers from using ",(0,s.jsx)(n.code,{children:"x"})," and ",(0,s.jsx)(n.code,{children:"z"})," in downstream toolchains as they see fit."]}),"\n",(0,s.jsx)(n.h3,{id:"get-me-verilog",children:"Get me Verilog"}),"\n",(0,s.jsx)(n.p,{children:"I wrote a module and I want to see the Verilog; what do I do?"}),"\n",(0,s.jsx)(n.p,{children:"Here's a simple hello world module in a file HelloWorld.scala."}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"package intro\n"})}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:'import chisel3._\nclass HelloWorld extends Module {\n  val io = IO(new Bundle{})\n  printf("hello world\\n")\n}\n'})}),"\n",(0,s.jsx)(n.p,{children:"Add the following"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"import circt.stage.ChiselStage\nobject VerilogMain extends App {\n  ChiselStage.emitSystemVerilog(new HelloWorld)\n}\n"})}),"\n",(0,s.jsx)(n.p,{children:"Now you can get some Verilog. Start sbt:"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{children:"bash> sbt\n> run-main intro.VerilogMain\n[info] Running intro.VerilogMain\n[info] [0.004] Elaborating design...\n[info] [0.100] Done elaborating.\n[success] Total time: 1 s, completed Jan 12, 2017 6:24:03 PM\n"})}),"\n",(0,s.jsx)(n.p,{children:"or as a one-liner:"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{children:"bash> sbt 'runMain intro.VerilogMain'\n"})}),"\n",(0,s.jsx)(n.p,{children:"After either of the above there will be a HelloWorld.v file in the current directory:"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\n\n// Users can define 'PRINTF_COND' to add an extra gate to prints.\n`ifndef PRINTF_COND_\n  `ifdef PRINTF_COND\n    `define PRINTF_COND_ (`PRINTF_COND)\n  `else  // PRINTF_COND\n    `define PRINTF_COND_ 1\n  `endif // PRINTF_COND\n`endif // not def PRINTF_COND_\nmodule HelloWorld(\t// faqs.md:11:7\n  input clock,\t// faqs.md:11:7\n        reset\t// faqs.md:11:7\n);\n\n  `ifndef SYNTHESIS\t// faqs.md:13:9\n    always @(posedge clock) begin\t// faqs.md:13:9\n      if ((`PRINTF_COND_) & ~reset)\t// faqs.md:13:9\n        $fwrite(32'h80000002, \"hello world\\n\");\t// faqs.md:13:9\n    end // always @(posedge)\n  `endif // not def SYNTHESIS\nendmodule\n\n\n"})}),"\n",(0,s.jsx)(n.p,{children:"You can see additional options with"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{children:"bash> sbt 'runMain intro.HelloWorld --help'\n"})}),"\n",(0,s.jsx)(n.p,{children:"This will return a comprehensive usage line with available options."}),"\n",(0,s.jsx)(n.p,{children:"For example to place the output in a directory name buildstuff use"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{children:"bash> sbt 'runMain intro.HelloWorld --target-dir buildstuff --top-name HelloWorld'\n"})}),"\n",(0,s.jsx)(n.p,{children:"Alternatively, you can also use the sbt console to invoke the Verilog driver:"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{children:'$ sbt\n> console\n[info] Starting scala interpreter...\nWelcome to Scala 2.12.13 (OpenJDK 64-Bit Server VM, Java 1.8.0_275).\nType in expressions for evaluation. Or try :help.\n\nscala> (new circt.stage.ChiselStage).emitSystemVerilog(new HelloWorld())\nchisel3.Driver.execute(Array[String](), () => new HelloWorld)\nElaborating design...\nDone elaborating.\nres1: String =\n"module HelloWorld(\n  input   clock,\n  input   reset\n);\n...\n'})}),"\n",(0,s.jsx)(n.p,{children:"As before, there should be a HelloWorld.v file in the current directory."}),"\n",(0,s.jsxs)(n.p,{children:["Note: Using the following, without the ",(0,s.jsx)(n.code,{children:"new"}),",\nwill ONLY return the string representation, and will not emit a ",(0,s.jsx)(n.code,{children:".v"})," file:"]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"ChiselStage.emitSystemVerilog(new HelloWorld())\n"})}),"\n",(0,s.jsx)(n.h3,{id:"get-me-firrtl",children:"Get me FIRRTL"}),"\n",(0,s.jsx)(n.p,{children:"If for some reason you don't want the Verilog (e.g. maybe you want to run some custom transformations before exporting to Verilog), then use something along these lines:"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"package intro\n"})}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"\nimport chisel3._\nimport circt.stage.ChiselStage\n\nclass MyFirrtlModule extends Module {\n  val io = IO(new Bundle{})\n}\n\nobject FirrtlMain extends App {\n  ChiselStage.emitCHIRRTL(new MyFirrtlModule)\n}\n"})}),"\n",(0,s.jsx)(n.p,{children:"Run it with:"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{children:"sbt 'runMain intro.FirrtlMain'\n"})}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{children:"FIRRTL version 4.0.0\ncircuit MyFirrtlModule :\n  public module MyFirrtlModule : @[faqs.md 64:7]\n    input clock : Clock @[faqs.md 64:7]\n    input reset : UInt<1> @[faqs.md 64:7]\n    output io : { } @[faqs.md 65:14]\n\n    skip\n\n\n"})}),"\n",(0,s.jsx)(n.p,{children:"Alternatively, you can also use the sbt console to invoke the FIRRTL driver directly (replace MyFirrtlModule with your module name):"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{children:"$ sbt\n> console\n[info] Starting scala interpreter...\nWelcome to Scala 2.12.13 (OpenJDK 64-Bit Server VM, Java 1.8.0_275).\nType in expressions for evaluation. Or try :help.\n\nscala> circt.stage.ChiselStage.emitCHIRRTL(new MyFirrtlModule)\nElaborating design...\nDone elaborating.\nres3: String = ...\n"})}),"\n",(0,s.jsx)(n.h3,{id:"why-doesnt-chisel-tell-me-which-wires-arent-connected",children:"Why doesn't Chisel tell me which wires aren't connected?"}),"\n",(0,s.jsxs)(n.p,{children:["As long as your code uses ",(0,s.jsx)(n.code,{children:"import chisel3._"})," (and not ",(0,s.jsx)(n.code,{children:"import Chisel._"}),"), it does!\nSee ",(0,s.jsx)(n.a,{href:"../explanations/unconnected-wires",children:"Unconnected Wires"})," for details."]}),"\n",(0,s.jsxs)(n.h3,{id:"what-does-reference--is-not-fully-initialized-mean",children:["What does ",(0,s.jsx)(n.code,{children:"Reference ... is not fully initialized."})," mean?"]}),"\n",(0,s.jsx)(n.p,{children:"It means that you have unconnected wires in your design which could be an indication of a design bug."}),"\n",(0,s.jsxs)(n.p,{children:["In Chisel2 compatibility mode (",(0,s.jsx)(n.code,{children:"NotStrict"})," compile options), chisel generates firrtl code that disables firrtl's initialized wire checks.\nIn pure chisel3 (",(0,s.jsx)(n.code,{children:"Strict"})," compile options), the generated firrtl code does not contain these disablers (",(0,s.jsx)(n.code,{children:"is invalid"}),").\nOutput wires that are not driven (not connected) are reported by firrtl as ",(0,s.jsx)(n.code,{children:"not fully initialized"}),".\nRead more at ",(0,s.jsx)(n.a,{href:"../explanations/unconnected-wires",children:"Unconnected Wires"})," for details on solving the problem."]}),"\n",(0,s.jsx)(n.h3,{id:"can-i-specify-behavior-before-and-after-generated-initial-blocks",children:"Can I specify behavior before and after generated initial blocks?"}),"\n",(0,s.jsx)(n.p,{children:"Users may define the following macros if they wish to specify behavior before or after emitted initial blocks."}),"\n",(0,s.jsxs)(n.ul,{children:["\n",(0,s.jsxs)(n.li,{children:[(0,s.jsx)(n.code,{children:"BEFORE_INITIAL"}),", which is called before the emitted (non-empty) initial block if it is defined"]}),"\n",(0,s.jsxs)(n.li,{children:[(0,s.jsx)(n.code,{children:"AFTER_INITIAL"}),", which is called after the emitted (non-empty) initial block if it is defined"]}),"\n"]}),"\n",(0,s.jsx)(n.p,{children:"These macros may be useful for turning coverage on and off."})]})}function h(e={}){const{wrapper:n}={...(0,l.R)(),...e.components};return n?(0,s.jsx)(n,{...e,children:(0,s.jsx)(c,{...e})}):c(e)}},8453:(e,n,i)=>{i.d(n,{R:()=>t,x:()=>r});var s=i(6540);const l={},o=s.createContext(l);function t(e){const n=s.useContext(o);return s.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function r(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(l):e.components||l:t(e.components),s.createElement(o.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/1ce89024.8397b873.js b/assets/js/1ce89024.8397b873.js
new file mode 100644
index 0000000000..339d7bb77d
--- /dev/null
+++ b/assets/js/1ce89024.8397b873.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[741],{4008:(e,n,i)=>{i.r(n),i.d(n,{assets:()=>l,contentTitle:()=>r,default:()=>u,frontMatter:()=>s,metadata:()=>d,toc:()=>c});var t=i(4848),o=i(8453),a=i(1871);const s={sidebar_position:2},r="Hierarchy Cookbook",d={id:"cookbooks/hierarchy",title:"Hierarchy Cookbook",description:"How do I instantiate multiple instances with the same module parameterization?",source:"@site/docs/cookbooks/hierarchy.md",sourceDirName:"cookbooks",slug:"/cookbooks/hierarchy",permalink:"/docs/cookbooks/hierarchy",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/cookbooks/hierarchy.md",tags:[],version:"current",sidebarPosition:2,frontMatter:{sidebar_position:2},sidebar:"chiselSidebar",previous:{title:"Naming Cookbook",permalink:"/docs/cookbooks/naming"},next:{title:"DataView Cookbook",permalink:"/docs/cookbooks/dataview"}},l={},c=[{value:"How do I instantiate multiple instances with the same module parameterization?",id:"how-do-i-instantiate-multiple-instances-with-the-same-module-parameterization",level:2},{value:"Using Definition and Instance",id:"using-definition-and-instance",level:3},{value:"Using Instantiate",id:"using-instantiate",level:3},{value:"How do I access internal fields of an instance?",id:"how-do-i-access-internal-fields-of-an-instance",level:2},{value:"How do I make my parameters accessible from an instance?",id:"how-do-i-make-my-parameters-accessible-from-an-instance",level:2},{value:"How do I look up parameters from a Definition, if I don&#39;t want to instantiate it?",id:"how-do-i-look-up-parameters-from-a-definition-if-i-dont-want-to-instantiate-it",level:2},{value:"How do I parameterize a module by its children instances?",id:"how-do-i-parameterize-a-module-by-its-children-instances",level:2},{value:"How do I use the new hierarchy-specific Select functions?",id:"how-do-i-use-the-new-hierarchy-specific-select-functions",level:2}];function h(e){const n={code:"code",h1:"h1",h2:"h2",h3:"h3",li:"li",ol:"ol",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,o.R)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.h1,{id:"hierarchy-cookbook",children:"Hierarchy Cookbook"}),"\n","\n","\n",(0,t.jsx)(a.A,{toc:c}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-instantiate-multiple-instances-with-the-same-module-parameterization",children:"How do I instantiate multiple instances with the same module parameterization?"}),"\n",(0,t.jsx)(n.p,{children:'Prior to this package, Chisel users relied on deduplication in a FIRRTL compiler to combine\nstructurally equivalent modules into one module (aka "deduplication").\nThis package introduces the following new APIs to enable multiply-instantiated modules directly in Chisel.'}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.code,{children:"Definition(...)"})," enables elaborating a module, but does not actually instantiate that module.\nInstead, it returns a ",(0,t.jsx)(n.code,{children:"Definition"})," class which represents that module's definition."]}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.code,{children:"Instance(...)"})," takes a ",(0,t.jsx)(n.code,{children:"Definition"})," and instantiates it, returning an ",(0,t.jsx)(n.code,{children:"Instance"})," object."]}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.code,{children:"Instantiate(...)"})," provides an API similar to ",(0,t.jsx)(n.code,{children:"Module(...)"}),", except it uses\n",(0,t.jsx)(n.code,{children:"Definition"})," and ",(0,t.jsx)(n.code,{children:"Instance"})," to only elaborate modules once for a given set of\nparameters. It returns an ",(0,t.jsx)(n.code,{children:"Instance"})," object."]}),"\n",(0,t.jsxs)(n.p,{children:["Modules (classes or traits) which will be used with the ",(0,t.jsx)(n.code,{children:"Definition"}),"/",(0,t.jsx)(n.code,{children:"Instance"})," api should be marked\nwith the ",(0,t.jsx)(n.code,{children:"@instantiable"})," annotation at the class/trait definition."]}),"\n",(0,t.jsxs)(n.p,{children:["To make a Module's members variables accessible from an ",(0,t.jsx)(n.code,{children:"Instance"})," object, they must be annotated\nwith the ",(0,t.jsx)(n.code,{children:"@public"})," annotation. Note that this is only accessible from a Scala sense\u2014this is not\nin and of itself a mechanism for cross-module references."]}),"\n",(0,t.jsx)(n.h3,{id:"using-definition-and-instance",children:"Using Definition and Instance"}),"\n",(0,t.jsxs)(n.p,{children:["In the following example, use ",(0,t.jsx)(n.code,{children:"Definition"}),", ",(0,t.jsx)(n.code,{children:"Instance"}),", ",(0,t.jsx)(n.code,{children:"@instantiable"})," and ",(0,t.jsx)(n.code,{children:"@public"})," to create\nmultiple instances of one specific parameterization of a module, ",(0,t.jsx)(n.code,{children:"AddOne"}),"."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.hierarchy.{Definition, Instance, instantiable, public}\n\n@instantiable\nclass AddOne(width: Int) extends Module {\n  @public val in  = IO(Input(UInt(width.W)))\n  @public val out = IO(Output(UInt(width.W)))\n  out := in + 1.U\n}\n\nclass AddTwo(width: Int) extends Module {\n  val in  = IO(Input(UInt(width.W)))\n  val out = IO(Output(UInt(width.W)))\n  val addOneDef = Definition(new AddOne(width))\n  val i0 = Instance(addOneDef)\n  val i1 = Instance(addOneDef)\n  i0.in := in\n  i1.in := i0.out\n  out   := i1.out\n}\n"})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule AddOne(\t// hierarchy.md:14:2\n  input  [9:0] in,\t// hierarchy.md:16:23\n  output [9:0] out\t// hierarchy.md:17:23\n);\n\n  assign out = in + 10\'h1;\t// hierarchy.md:14:2, :18:13\nendmodule\n\nmodule AddTwo(\t// hierarchy.md:22:7\n  input        clock,\t// hierarchy.md:22:7\n               reset,\t// hierarchy.md:22:7\n  input  [9:0] in,\t// hierarchy.md:23:15\n  output [9:0] out\t// hierarchy.md:24:15\n);\n\n  wire [9:0] _i0_out;\t// hierarchy.md:26:20\n  AddOne i0 (\t// hierarchy.md:26:20\n    .in  (in),\n    .out (_i0_out)\n  );\t// hierarchy.md:26:20\n  AddOne i1 (\t// hierarchy.md:27:20\n    .in  (_i0_out),\t// hierarchy.md:26:20\n    .out (out)\n  );\t// hierarchy.md:27:20\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_AddTwo_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_AddTwo_Verification.sv"\n`ifndef layers_AddTwo_Verification_Cover\n`define layers_AddTwo_Verification_Cover\t// <stdin>:6:5\n`endif // layers_AddTwo_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_AddTwo_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_AddTwo_Verification.sv"\n`ifndef layers_AddTwo_Verification_Assume\n`define layers_AddTwo_Verification_Assume\t// <stdin>:5:5\n`endif // layers_AddTwo_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_AddTwo_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_AddTwo_Verification.sv"\n`ifndef layers_AddTwo_Verification_Assert\n`define layers_AddTwo_Verification_Assert\t// <stdin>:4:5\n`endif // layers_AddTwo_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_AddTwo_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_AddTwo_Verification\n`define layers_AddTwo_Verification\t// <stdin>:3:3\n`endif // layers_AddTwo_Verification\t// <stdin>:3:3\n'})}),"\n",(0,t.jsx)(n.h3,{id:"using-instantiate",children:"Using Instantiate"}),"\n",(0,t.jsxs)(n.p,{children:["Similar to the above, the following example uses ",(0,t.jsx)(n.code,{children:"Instantiate"})," to create\nmultiple instances of ",(0,t.jsx)(n.code,{children:"AddOne"}),"."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3.experimental.hierarchy.Instantiate\n\nclass AddTwoInstantiate(width: Int) extends Module {\n  val in  = IO(Input(UInt(width.W)))\n  val out = IO(Output(UInt(width.W)))\n  val i0 = Instantiate(new AddOne(width))\n  val i1 = Instantiate(new AddOne(width))\n  i0.in := in\n  i1.in := i0.out\n  out   := i1.out\n}\n"})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule AddOne(\t// hierarchy.md:14:2\n  input  [15:0] in,\t// hierarchy.md:16:23\n  output [15:0] out\t// hierarchy.md:17:23\n);\n\n  assign out = in + 16\'h1;\t// hierarchy.md:14:2, :18:13\nendmodule\n\nmodule AddTwoInstantiate(\t// hierarchy.md:46:7\n  input         clock,\t// hierarchy.md:46:7\n                reset,\t// hierarchy.md:46:7\n  input  [15:0] in,\t// hierarchy.md:47:15\n  output [15:0] out\t// hierarchy.md:48:15\n);\n\n  wire [15:0] _i0_out;\t// hierarchy.md:49:23\n  AddOne i0 (\t// hierarchy.md:49:23\n    .in  (in),\n    .out (_i0_out)\n  );\t// hierarchy.md:49:23\n  AddOne i1 (\t// hierarchy.md:50:23\n    .in  (_i0_out),\t// hierarchy.md:49:23\n    .out (out)\n  );\t// hierarchy.md:50:23\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_AddTwoInstantiate_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_AddTwoInstantiate_Verification.sv"\n`ifndef layers_AddTwoInstantiate_Verification_Cover\n`define layers_AddTwoInstantiate_Verification_Cover\t// <stdin>:6:5\n`endif // layers_AddTwoInstantiate_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_AddTwoInstantiate_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_AddTwoInstantiate_Verification.sv"\n`ifndef layers_AddTwoInstantiate_Verification_Assume\n`define layers_AddTwoInstantiate_Verification_Assume\t// <stdin>:5:5\n`endif // layers_AddTwoInstantiate_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_AddTwoInstantiate_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_AddTwoInstantiate_Verification.sv"\n`ifndef layers_AddTwoInstantiate_Verification_Assert\n`define layers_AddTwoInstantiate_Verification_Assert\t// <stdin>:4:5\n`endif // layers_AddTwoInstantiate_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_AddTwoInstantiate_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_AddTwoInstantiate_Verification\n`define layers_AddTwoInstantiate_Verification\t// <stdin>:3:3\n`endif // layers_AddTwoInstantiate_Verification\t// <stdin>:3:3\n'})}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-access-internal-fields-of-an-instance",children:"How do I access internal fields of an instance?"}),"\n",(0,t.jsxs)(n.p,{children:["You can mark internal members of a class or trait marked with ",(0,t.jsx)(n.code,{children:"@instantiable"})," with the ",(0,t.jsx)(n.code,{children:"@public"})," annotation.\nThe requirements are that the field is publicly accessible, is a ",(0,t.jsx)(n.code,{children:"val"})," or ",(0,t.jsx)(n.code,{children:"lazy val"}),", and is a valid type.\nThe list of valid types are:"]}),"\n",(0,t.jsxs)(n.ol,{children:["\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.code,{children:"IsInstantiable"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.code,{children:"IsLookupable"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.code,{children:"Data"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.code,{children:"BaseModule"})}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"Iterable"}),"/",(0,t.jsx)(n.code,{children:"Option "}),"containing a type that meets these requirements"]}),"\n",(0,t.jsxs)(n.li,{children:["Basic type like ",(0,t.jsx)(n.code,{children:"String"}),", ",(0,t.jsx)(n.code,{children:"Int"}),", ",(0,t.jsx)(n.code,{children:"BigInt"})," etc."]}),"\n"]}),"\n",(0,t.jsxs)(n.p,{children:["To mark a superclass's member as ",(0,t.jsx)(n.code,{children:"@public"}),", use the following pattern (shown with ",(0,t.jsx)(n.code,{children:"val clock"}),")."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.hierarchy.{instantiable, public}\n\n@instantiable\nclass MyModule extends Module {\n  @public val clock = clock\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["You'll get the following error message for improperly marking something as ",(0,t.jsx)(n.code,{children:"@public"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.hierarchy.{instantiable, public}\n\nobject NotValidType\n\n@instantiable\nclass MyModule extends Module {\n  @public val x = NotValidType\n}\n// error: @public is only legal within a class or trait marked @instantiable, and only on vals of type Data, BaseModule, MemBase, IsInstantiable, IsLookupable, or Instance[_], or in an Iterable, Option, Either, or Tuple2\n// val x = circt.stage.ChiselStage.emitCHIRRTL(new Top)\n//     ^\n"})}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-make-my-parameters-accessible-from-an-instance",children:"How do I make my parameters accessible from an instance?"}),"\n",(0,t.jsxs)(n.p,{children:["If an instance's parameters are simple (e.g. ",(0,t.jsx)(n.code,{children:"Int"}),", ",(0,t.jsx)(n.code,{children:"String"})," etc.) they can be marked directly with ",(0,t.jsx)(n.code,{children:"@public"}),"."]}),"\n",(0,t.jsxs)(n.p,{children:["Often, parameters are more complicated and are contained in case classes.\nIn such cases, mark the case class with the ",(0,t.jsx)(n.code,{children:"IsLookupable"})," trait.\nThis indicates to Chisel that instances of the ",(0,t.jsx)(n.code,{children:"IsLookupable"})," class may be accessed from within instances."]}),"\n",(0,t.jsxs)(n.p,{children:["However, ensure that these parameters are true for ",(0,t.jsx)(n.strong,{children:"all"})," instances of a definition.\nFor example, if our parameters contained an id field which was instance-specific but defaulted to zero,\nthen the definition's id would be returned for all instances.\nThis change in behavior could lead to bugs if other code presumed the id field was correct."]}),"\n",(0,t.jsxs)(n.p,{children:["Thus, it is important that when converting normal modules to use this package,\nyou are careful about what you mark as ",(0,t.jsx)(n.code,{children:"IsLookupable"}),"."]}),"\n",(0,t.jsxs)(n.p,{children:["In the following example, we added the trait ",(0,t.jsx)(n.code,{children:"IsLookupable"})," to allow the member to be marked ",(0,t.jsx)(n.code,{children:"@public"}),"."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'import chisel3._\nimport chisel3.experimental.hierarchy.{Definition, Instance, instantiable, IsLookupable, public}\n\ncase class MyCaseClass(width: Int) extends IsLookupable\n\n@instantiable\nclass MyModule extends Module {\n  @public val x = MyCaseClass(10)\n}\n\nclass Top extends Module {\n  val inst = Instance(Definition(new MyModule))\n  println(s"Width is ${inst.x.width}")\n}\n'})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{children:"Width is 10\nCircuit(Top,List(DefModule(repl.MdocSession$MdocApp5$MyModule@5b6d1953,MyModule,false,List(),List(Port(MyModule.clock: IO[Clock],Input,SourceLine(hierarchy.md,105,2)), Port(MyModule.reset: IO[Reset],Input,SourceLine(hierarchy.md,105,2))),Vector()), DefModule(repl.MdocSession$MdocApp5$Top@7590e65b,Top,true,List(),List(Port(Top.clock: IO[Clock],Input,SourceLine(hierarchy.md,111,7)), Port(Top.reset: IO[Bool],Input,SourceLine(hierarchy.md,111,7))),Vector(DefInstance(SourceLine(hierarchy.md,112,22),ModuleClone(repl.MdocSession$MdocApp5$MyModule@5b6d1953),List(Port(MyModule.clock: IO[Clock],Input,SourceLine(hierarchy.md,105,2)), Port(MyModule.reset: IO[Reset],Input,SourceLine(hierarchy.md,105,2)))), Connect(SourceLine(hierarchy.md,112,22),Node(MyModule.inst.clock: IO[Clock]),Node(Top.clock: IO[Clock])), Connect(SourceLine(hierarchy.md,112,22),Node(MyModule.inst.reset: IO[Reset]),Node(Top.reset: IO[Bool]))))),List(),firrtl.renamemap.package$MutableRenameMap@207b07c1,List(),List(),List(Layer(UnlocatableSourceInfo,Verification,Extract(Some(Verification)),List(Layer(UnlocatableSourceInfo,Assert,Extract(Some(Verification/Assert)),List()), Layer(UnlocatableSourceInfo,Assume,Extract(Some(Verification/Assume)),List()), Layer(UnlocatableSourceInfo,Cover,Extract(Some(Verification/Cover)),List())))),List())\n"})}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-look-up-parameters-from-a-definition-if-i-dont-want-to-instantiate-it",children:"How do I look up parameters from a Definition, if I don't want to instantiate it?"}),"\n",(0,t.jsxs)(n.p,{children:["Just like ",(0,t.jsx)(n.code,{children:"Instance"}),"s, ",(0,t.jsx)(n.code,{children:"Definition"}),"'s also contain accessors for ",(0,t.jsx)(n.code,{children:"@public"})," members.\nAs such, you can directly access them:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'import chisel3._\nimport chisel3.experimental.hierarchy.{Definition, instantiable, public}\n\n@instantiable\nclass AddOne(val width: Int) extends RawModule {\n  @public val width = width\n  @public val in  = IO(Input(UInt(width.W)))\n  @public val out = IO(Output(UInt(width.W)))\n  out := in + 1.U\n}\n\nclass Top extends Module {\n  val definition = Definition(new AddOne(10))\n  println(s"Width is: ${definition.width}")\n}\n'})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Top(\t// hierarchy.md:157:7\n  input clock,\t// hierarchy.md:157:7\n        reset\t// hierarchy.md:157:7\n);\n\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Top_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Top_Verification.sv"\n`ifndef layers_Top_Verification_Cover\n`define layers_Top_Verification_Cover\t// <stdin>:6:5\n`endif // layers_Top_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Top_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Top_Verification.sv"\n`ifndef layers_Top_Verification_Assume\n`define layers_Top_Verification_Assume\t// <stdin>:5:5\n`endif // layers_Top_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Top_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Top_Verification.sv"\n`ifndef layers_Top_Verification_Assert\n`define layers_Top_Verification_Assert\t// <stdin>:4:5\n`endif // layers_Top_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_Top_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Top_Verification\n`define layers_Top_Verification\t// <stdin>:3:3\n`endif // layers_Top_Verification\t// <stdin>:3:3\n'})}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-parameterize-a-module-by-its-children-instances",children:"How do I parameterize a module by its children instances?"}),"\n",(0,t.jsx)(n.p,{children:"Prior to the introduction of this package, a parent module would have to pass all necessary parameters\nwhen instantiating a child module.\nThis had the unfortunate consequence of requiring a parent's parameters to always contain the child's\nparameters, which was an unnecessary coupling which lead to some anti-patterns."}),"\n",(0,t.jsxs)(n.p,{children:["Now, a parent can take a child ",(0,t.jsx)(n.code,{children:"Definition"})," as an argument, and instantiate it directly.\nIn addition, it can analyze the parameters used in the definition to parameterize itself.\nIn a sense, now the child can actually parameterize the parent."]}),"\n",(0,t.jsxs)(n.p,{children:["In the following example, we create a definition of ",(0,t.jsx)(n.code,{children:"AddOne"}),", and pass the definition to ",(0,t.jsx)(n.code,{children:"AddTwo"}),".\nThe width of the ",(0,t.jsx)(n.code,{children:"AddTwo"})," ports are now derived from the parameterization of the ",(0,t.jsx)(n.code,{children:"AddOne"})," instance."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.hierarchy.{Definition, Instance, instantiable, public}\n\n@instantiable\nclass AddOne(val width: Int) extends Module {\n  @public val width = width\n  @public val in  = IO(Input(UInt(width.W)))\n  @public val out = IO(Output(UInt(width.W)))\n  out := in + 1.U\n}\n\nclass AddTwo(addOneDef: Definition[AddOne]) extends Module {\n  val i0 = Instance(addOneDef)\n  val i1 = Instance(addOneDef)\n  val in  = IO(Input(UInt(addOneDef.width.W)))\n  val out = IO(Output(UInt(addOneDef.width.W)))\n  i0.in := in\n  i1.in := i0.out\n  out   := i1.out\n}\n"})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule AddOne(\t// hierarchy.md:181:2\n  input  [9:0] in,\t// hierarchy.md:184:23\n  output [9:0] out\t// hierarchy.md:185:23\n);\n\n  assign out = in + 10\'h1;\t// hierarchy.md:181:2, :186:13\nendmodule\n\nmodule AddTwo(\t// hierarchy.md:190:7\n  input        clock,\t// hierarchy.md:190:7\n               reset,\t// hierarchy.md:190:7\n  input  [9:0] in,\t// hierarchy.md:193:15\n  output [9:0] out\t// hierarchy.md:194:15\n);\n\n  wire [9:0] _i0_out;\t// hierarchy.md:191:20\n  AddOne i0 (\t// hierarchy.md:191:20\n    .in  (in),\n    .out (_i0_out)\n  );\t// hierarchy.md:191:20\n  AddOne i1 (\t// hierarchy.md:192:20\n    .in  (_i0_out),\t// hierarchy.md:191:20\n    .out (out)\n  );\t// hierarchy.md:192:20\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_AddTwo_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_AddTwo_Verification.sv"\n`ifndef layers_AddTwo_Verification_Cover\n`define layers_AddTwo_Verification_Cover\t// <stdin>:6:5\n`endif // layers_AddTwo_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_AddTwo_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_AddTwo_Verification.sv"\n`ifndef layers_AddTwo_Verification_Assume\n`define layers_AddTwo_Verification_Assume\t// <stdin>:5:5\n`endif // layers_AddTwo_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_AddTwo_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_AddTwo_Verification.sv"\n`ifndef layers_AddTwo_Verification_Assert\n`define layers_AddTwo_Verification_Assert\t// <stdin>:4:5\n`endif // layers_AddTwo_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_AddTwo_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_AddTwo_Verification\n`define layers_AddTwo_Verification\t// <stdin>:3:3\n`endif // layers_AddTwo_Verification\t// <stdin>:3:3\n'})}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-use-the-new-hierarchy-specific-select-functions",children:"How do I use the new hierarchy-specific Select functions?"}),"\n",(0,t.jsx)(n.p,{children:"Select functions can be applied after a module has been elaborated, either in a Chisel Aspect or in a parent module applied to a child module."}),"\n",(0,t.jsxs)(n.p,{children:["There are seven hierarchy-specific functions, which (with the exception of ",(0,t.jsx)(n.code,{children:"ios"}),") either return ",(0,t.jsx)(n.code,{children:"Instance"}),"'s or ",(0,t.jsx)(n.code,{children:"Definition"}),"'s:"]}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"instancesIn(parent)"}),": Return all instances directly instantiated locally within ",(0,t.jsx)(n.code,{children:"parent"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"instancesOf[type](parent)"}),": Return all instances of provided ",(0,t.jsx)(n.code,{children:"type"})," directly instantiated locally within ",(0,t.jsx)(n.code,{children:"parent"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"allInstancesOf[type](root)"}),": Return all instances of provided ",(0,t.jsx)(n.code,{children:"type"})," directly and indirectly instantiated, locally and deeply, starting from ",(0,t.jsx)(n.code,{children:"root"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"definitionsIn"}),": Return definitions of all instances directly instantiated locally within ",(0,t.jsx)(n.code,{children:"parent"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"definitionsOf[type]"}),": Return definitions of all instances of provided ",(0,t.jsx)(n.code,{children:"type"})," directly instantiated locally within ",(0,t.jsx)(n.code,{children:"parent"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"allDefinitionsOf[type]"}),": Return all definitions of instances of provided ",(0,t.jsx)(n.code,{children:"type"})," directly and indirectly instantiated, locally and deeply, starting from ",(0,t.jsx)(n.code,{children:"root"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"ios"}),": Returns all the I/Os of the provided definition or instance."]}),"\n"]}),"\n",(0,t.jsxs)(n.p,{children:["To demonstrate this, consider the following. We mock up an example where we are using the ",(0,t.jsx)(n.code,{children:"Select.allInstancesOf"})," and ",(0,t.jsx)(n.code,{children:"Select.allDefinitionsOf"})," to annotate instances and the definition of ",(0,t.jsx)(n.code,{children:"EmptyModule"}),". When converting the ",(0,t.jsx)(n.code,{children:"ChiselAnnotation"})," to firrtl's ",(0,t.jsx)(n.code,{children:"Annotation"}),", we print out the resulting ",(0,t.jsx)(n.code,{children:"Target"}),". As shown, despite ",(0,t.jsx)(n.code,{children:"EmptyModule"})," actually only being elaborated once, we still provide different targets depending on how the instance or definition is selected."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'import chisel3._\nimport chisel3.experimental.hierarchy.{Definition, Instance, Hierarchy, instantiable, public}\nimport firrtl.annotations.{IsModule, NoTargetAnnotation}\ncase object EmptyAnnotation extends NoTargetAnnotation\ncase class MyChiselAnnotation(m: Hierarchy[RawModule], tag: String) extends experimental.ChiselAnnotation {\n  def toFirrtl = {\n    println(tag + ": " + m.toTarget)\n    EmptyAnnotation\n  }\n}\n\n@instantiable\nclass EmptyModule extends Module {\n  println("Elaborating EmptyModule!")\n}\n\n@instantiable\nclass TwoEmptyModules extends Module {\n  val definition = Definition(new EmptyModule)\n  val i0         = Instance(definition)\n  val i1         = Instance(definition)\n}\n\nclass Top extends Module {\n  val definition = Definition(new TwoEmptyModules)\n  val instance   = Instance(definition)\n  aop.Select.allInstancesOf[EmptyModule](instance).foreach { i =>\n    experimental.annotate(MyChiselAnnotation(i, "instance"))\n  }\n  aop.Select.allDefinitionsOf[EmptyModule](instance).foreach { d =>\n    experimental.annotate(MyChiselAnnotation(d, "definition"))\n  }\n}\n'})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{children:"Elaborating EmptyModule!\ninstance: ~Top|Top/instance:TwoEmptyModules/i0:EmptyModule\ninstance: ~Top|Top/instance:TwoEmptyModules/i1:EmptyModule\ndefinition: ~Top|EmptyModule\n"})}),"\n",(0,t.jsxs)(n.p,{children:["You can also use ",(0,t.jsx)(n.code,{children:"Select.ios"})," on either a ",(0,t.jsx)(n.code,{children:"Definition"})," or an ",(0,t.jsx)(n.code,{children:"Instance"})," to annotate the I/Os appropriately:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'case class MyIOAnnotation(m: Data, tag: String) extends experimental.ChiselAnnotation {\n  def toFirrtl = {\n    println(tag + ": " + m.toTarget)\n    EmptyAnnotation\n  }\n}\n\n@instantiable\nclass InOutModule extends Module {\n  @public val in = IO(Input(Bool()))\n  @public val out = IO(Output(Bool()))\n  out := in\n}\n\n@instantiable\nclass TwoInOutModules extends Module {\n  val in = IO(Input(Bool()))\n  val out = IO(Output(Bool()))\n  val definition = Definition(new InOutModule)\n  val i0         = Instance(definition)\n  val i1         = Instance(definition)\n  i0.in := in\n  i1.in := i0.out\n  out := i1.out\n}\n\nclass InOutTop extends Module {\n  val definition = Definition(new TwoInOutModules)\n  val instance   = Instance(definition)\n  aop.Select.allInstancesOf[InOutModule](instance).foreach { i =>\n    aop.Select.ios(i).foreach { io =>\n      experimental.annotate(MyIOAnnotation(io, "instance io"))\n  }}\n  aop.Select.allDefinitionsOf[InOutModule](instance).foreach { d =>\n    aop.Select.ios(d).foreach {io =>\n      experimental.annotate(MyIOAnnotation(io, "definition io"))\n  }}\n}\n'})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{children:"instance io: ~InOutTop|InOutTop/instance:TwoInOutModules/i0:InOutModule>clock\ninstance io: ~InOutTop|InOutTop/instance:TwoInOutModules/i0:InOutModule>reset\ninstance io: ~InOutTop|InOutTop/instance:TwoInOutModules/i0:InOutModule>in\ninstance io: ~InOutTop|InOutTop/instance:TwoInOutModules/i0:InOutModule>out\ninstance io: ~InOutTop|InOutTop/instance:TwoInOutModules/i1:InOutModule>clock\ninstance io: ~InOutTop|InOutTop/instance:TwoInOutModules/i1:InOutModule>reset\ninstance io: ~InOutTop|InOutTop/instance:TwoInOutModules/i1:InOutModule>in\ninstance io: ~InOutTop|InOutTop/instance:TwoInOutModules/i1:InOutModule>out\ndefinition io: ~InOutTop|InOutModule>clock\ndefinition io: ~InOutTop|InOutModule>reset\ndefinition io: ~InOutTop|InOutModule>in\ndefinition io: ~InOutTop|InOutModule>out\n"})})]})}function u(e={}){const{wrapper:n}={...(0,o.R)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(h,{...e})}):h(e)}},1871:(e,n,i)=>{i.d(n,{A:()=>s});i(6540);var t=i(5195);const o={tableOfContentsInline:"tableOfContentsInline_prmo"};var a=i(4848);function s(e){let{toc:n,minHeadingLevel:i,maxHeadingLevel:s}=e;return(0,a.jsx)("div",{className:o.tableOfContentsInline,children:(0,a.jsx)(t.A,{toc:n,minHeadingLevel:i,maxHeadingLevel:s,className:"table-of-contents",linkClassName:null})})}},5195:(e,n,i)=>{i.d(n,{A:()=>m});var t=i(6540),o=i(6342);function a(e){const n=e.map((e=>({...e,parentIndex:-1,children:[]}))),i=Array(7).fill(-1);n.forEach(((e,n)=>{const t=i.slice(2,e.level);e.parentIndex=Math.max(...t),i[e.level]=n}));const t=[];return n.forEach((e=>{const{parentIndex:i,...o}=e;i>=0?n[i].children.push(o):t.push(o)})),t}function s(e){let{toc:n,minHeadingLevel:i,maxHeadingLevel:t}=e;return n.flatMap((e=>{const n=s({toc:e.children,minHeadingLevel:i,maxHeadingLevel:t});return function(e){return e.level>=i&&e.level<=t}(e)?[{...e,children:n}]:n}))}function r(e){const n=e.getBoundingClientRect();return n.top===n.bottom?r(e.parentNode):n}function d(e,n){let{anchorTopOffset:i}=n;const t=e.find((e=>r(e).top>=i));if(t){return function(e){return e.top>0&&e.bottom<window.innerHeight/2}(r(t))?t:e[e.indexOf(t)-1]??null}return e[e.length-1]??null}function l(){const e=(0,t.useRef)(0),{navbar:{hideOnScroll:n}}=(0,o.p)();return(0,t.useEffect)((()=>{e.current=n?0:document.querySelector(".navbar").clientHeight}),[n]),e}function c(e){const n=(0,t.useRef)(void 0),i=l();(0,t.useEffect)((()=>{if(!e)return()=>{};const{linkClassName:t,linkActiveClassName:o,minHeadingLevel:a,maxHeadingLevel:s}=e;function r(){const e=function(e){return Array.from(document.getElementsByClassName(e))}(t),r=function(e){let{minHeadingLevel:n,maxHeadingLevel:i}=e;const t=[];for(let o=n;o<=i;o+=1)t.push(`h${o}.anchor`);return Array.from(document.querySelectorAll(t.join()))}({minHeadingLevel:a,maxHeadingLevel:s}),l=d(r,{anchorTopOffset:i.current}),c=e.find((e=>l&&l.id===function(e){return decodeURIComponent(e.href.substring(e.href.indexOf("#")+1))}(e)));e.forEach((e=>{!function(e,i){i?(n.current&&n.current!==e&&n.current.classList.remove(o),e.classList.add(o),n.current=e):e.classList.remove(o)}(e,e===c)}))}return document.addEventListener("scroll",r),document.addEventListener("resize",r),r(),()=>{document.removeEventListener("scroll",r),document.removeEventListener("resize",r)}}),[e,i])}var h=i(8774),u=i(4848);function f(e){let{toc:n,className:i,linkClassName:t,isChild:o}=e;return n.length?(0,u.jsx)("ul",{className:o?void 0:i,children:n.map((e=>(0,u.jsxs)("li",{children:[(0,u.jsx)(h.A,{to:`#${e.id}`,className:t??void 0,dangerouslySetInnerHTML:{__html:e.value}}),(0,u.jsx)(f,{isChild:!0,toc:e.children,className:i,linkClassName:t})]},e.id)))}):null}const p=t.memo(f);function m(e){let{toc:n,className:i="table-of-contents table-of-contents__left-border",linkClassName:r="table-of-contents__link",linkActiveClassName:d,minHeadingLevel:l,maxHeadingLevel:h,...f}=e;const m=(0,o.p)(),y=l??m.tableOfContents.minHeadingLevel,I=h??m.tableOfContents.maxHeadingLevel,x=function(e){let{toc:n,minHeadingLevel:i,maxHeadingLevel:o}=e;return(0,t.useMemo)((()=>s({toc:a(n),minHeadingLevel:i,maxHeadingLevel:o})),[n,i,o])}({toc:n,minHeadingLevel:y,maxHeadingLevel:I});return c((0,t.useMemo)((()=>{if(r&&d)return{linkClassName:r,linkActiveClassName:d,minHeadingLevel:y,maxHeadingLevel:I}}),[r,d,y,I])),(0,u.jsx)(p,{toc:x,className:i,linkClassName:r,...f})}},8453:(e,n,i)=>{i.d(n,{R:()=>s,x:()=>r});var t=i(6540);const o={},a=t.createContext(o);function s(e){const n=t.useContext(a);return t.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function r(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(o):e.components||o:s(e.components),t.createElement(a.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/1ce89024.8ad3720b.js b/assets/js/1ce89024.8ad3720b.js
deleted file mode 100644
index 85ab299c2c..0000000000
--- a/assets/js/1ce89024.8ad3720b.js
+++ /dev/null
@@ -1 +0,0 @@
-"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[741],{4008:(e,n,i)=>{i.r(n),i.d(n,{assets:()=>d,contentTitle:()=>l,default:()=>u,frontMatter:()=>s,metadata:()=>c,toc:()=>r});var t=i(4848),o=i(8453),a=i(1871);const s={sidebar_position:2},l="Hierarchy Cookbook",c={id:"cookbooks/hierarchy",title:"Hierarchy Cookbook",description:"How do I instantiate multiple instances with the same module parameterization?",source:"@site/docs/cookbooks/hierarchy.md",sourceDirName:"cookbooks",slug:"/cookbooks/hierarchy",permalink:"/docs/cookbooks/hierarchy",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/cookbooks/hierarchy.md",tags:[],version:"current",sidebarPosition:2,frontMatter:{sidebar_position:2},sidebar:"chiselSidebar",previous:{title:"Naming Cookbook",permalink:"/docs/cookbooks/naming"},next:{title:"DataView Cookbook",permalink:"/docs/cookbooks/dataview"}},d={},r=[{value:"How do I instantiate multiple instances with the same module parameterization?",id:"how-do-i-instantiate-multiple-instances-with-the-same-module-parameterization",level:2},{value:"Using Definition and Instance",id:"using-definition-and-instance",level:3},{value:"Using Instantiate",id:"using-instantiate",level:3},{value:"How do I access internal fields of an instance?",id:"how-do-i-access-internal-fields-of-an-instance",level:2},{value:"How do I make my parameters accessible from an instance?",id:"how-do-i-make-my-parameters-accessible-from-an-instance",level:2},{value:"How do I look up parameters from a Definition, if I don&#39;t want to instantiate it?",id:"how-do-i-look-up-parameters-from-a-definition-if-i-dont-want-to-instantiate-it",level:2},{value:"How do I parameterize a module by its children instances?",id:"how-do-i-parameterize-a-module-by-its-children-instances",level:2},{value:"How do I use the new hierarchy-specific Select functions?",id:"how-do-i-use-the-new-hierarchy-specific-select-functions",level:2}];function h(e){const n={code:"code",h1:"h1",h2:"h2",h3:"h3",li:"li",ol:"ol",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,o.R)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.h1,{id:"hierarchy-cookbook",children:"Hierarchy Cookbook"}),"\n","\n","\n",(0,t.jsx)(a.A,{toc:r}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-instantiate-multiple-instances-with-the-same-module-parameterization",children:"How do I instantiate multiple instances with the same module parameterization?"}),"\n",(0,t.jsx)(n.p,{children:'Prior to this package, Chisel users relied on deduplication in a FIRRTL compiler to combine\nstructurally equivalent modules into one module (aka "deduplication").\nThis package introduces the following new APIs to enable multiply-instantiated modules directly in Chisel.'}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.code,{children:"Definition(...)"})," enables elaborating a module, but does not actually instantiate that module.\nInstead, it returns a ",(0,t.jsx)(n.code,{children:"Definition"})," class which represents that module's definition."]}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.code,{children:"Instance(...)"})," takes a ",(0,t.jsx)(n.code,{children:"Definition"})," and instantiates it, returning an ",(0,t.jsx)(n.code,{children:"Instance"})," object."]}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.code,{children:"Instantiate(...)"})," provides an API similar to ",(0,t.jsx)(n.code,{children:"Module(...)"}),", except it uses\n",(0,t.jsx)(n.code,{children:"Definition"})," and ",(0,t.jsx)(n.code,{children:"Instance"})," to only elaborate modules once for a given set of\nparameters. It returns an ",(0,t.jsx)(n.code,{children:"Instance"})," object."]}),"\n",(0,t.jsxs)(n.p,{children:["Modules (classes or traits) which will be used with the ",(0,t.jsx)(n.code,{children:"Definition"}),"/",(0,t.jsx)(n.code,{children:"Instance"})," api should be marked\nwith the ",(0,t.jsx)(n.code,{children:"@instantiable"})," annotation at the class/trait definition."]}),"\n",(0,t.jsxs)(n.p,{children:["To make a Module's members variables accessible from an ",(0,t.jsx)(n.code,{children:"Instance"})," object, they must be annotated\nwith the ",(0,t.jsx)(n.code,{children:"@public"})," annotation. Note that this is only accessible from a Scala sense\u2014this is not\nin and of itself a mechanism for cross-module references."]}),"\n",(0,t.jsx)(n.h3,{id:"using-definition-and-instance",children:"Using Definition and Instance"}),"\n",(0,t.jsxs)(n.p,{children:["In the following example, use ",(0,t.jsx)(n.code,{children:"Definition"}),", ",(0,t.jsx)(n.code,{children:"Instance"}),", ",(0,t.jsx)(n.code,{children:"@instantiable"})," and ",(0,t.jsx)(n.code,{children:"@public"})," to create\nmultiple instances of one specific parameterization of a module, ",(0,t.jsx)(n.code,{children:"AddOne"}),"."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.hierarchy.{Definition, Instance, instantiable, public}\n\n@instantiable\nclass AddOne(width: Int) extends Module {\n  @public val in  = IO(Input(UInt(width.W)))\n  @public val out = IO(Output(UInt(width.W)))\n  out := in + 1.U\n}\n\nclass AddTwo(width: Int) extends Module {\n  val in  = IO(Input(UInt(width.W)))\n  val out = IO(Output(UInt(width.W)))\n  val addOneDef = Definition(new AddOne(width))\n  val i0 = Instance(addOneDef)\n  val i1 = Instance(addOneDef)\n  i0.in := in\n  i1.in := i0.out\n  out   := i1.out\n}\n"})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule AddOne(\t// hierarchy.md:14:2\n  input  [9:0] in,\t// hierarchy.md:16:23\n  output [9:0] out\t// hierarchy.md:17:23\n);\n\n  assign out = in + 10'h1;\t// hierarchy.md:14:2, :18:13\nendmodule\n\nmodule AddTwo(\t// hierarchy.md:22:7\n  input        clock,\t// hierarchy.md:22:7\n               reset,\t// hierarchy.md:22:7\n  input  [9:0] in,\t// hierarchy.md:23:15\n  output [9:0] out\t// hierarchy.md:24:15\n);\n\n  wire [9:0] _i0_out;\t// hierarchy.md:26:20\n  AddOne i0 (\t// hierarchy.md:26:20\n    .in  (in),\n    .out (_i0_out)\n  );\t// hierarchy.md:26:20\n  AddOne i1 (\t// hierarchy.md:27:20\n    .in  (_i0_out),\t// hierarchy.md:26:20\n    .out (out)\n  );\t// hierarchy.md:27:20\nendmodule\n\n"})}),"\n",(0,t.jsx)(n.h3,{id:"using-instantiate",children:"Using Instantiate"}),"\n",(0,t.jsxs)(n.p,{children:["Similar to the above, the following example uses ",(0,t.jsx)(n.code,{children:"Instantiate"})," to create\nmultiple instances of ",(0,t.jsx)(n.code,{children:"AddOne"}),"."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3.experimental.hierarchy.Instantiate\n\nclass AddTwoInstantiate(width: Int) extends Module {\n  val in  = IO(Input(UInt(width.W)))\n  val out = IO(Output(UInt(width.W)))\n  val i0 = Instantiate(new AddOne(width))\n  val i1 = Instantiate(new AddOne(width))\n  i0.in := in\n  i1.in := i0.out\n  out   := i1.out\n}\n"})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule AddOne(\t// hierarchy.md:14:2\n  input  [15:0] in,\t// hierarchy.md:16:23\n  output [15:0] out\t// hierarchy.md:17:23\n);\n\n  assign out = in + 16'h1;\t// hierarchy.md:14:2, :18:13\nendmodule\n\nmodule AddTwoInstantiate(\t// hierarchy.md:46:7\n  input         clock,\t// hierarchy.md:46:7\n                reset,\t// hierarchy.md:46:7\n  input  [15:0] in,\t// hierarchy.md:47:15\n  output [15:0] out\t// hierarchy.md:48:15\n);\n\n  wire [15:0] _i0_out;\t// hierarchy.md:49:23\n  AddOne i0 (\t// hierarchy.md:49:23\n    .in  (in),\n    .out (_i0_out)\n  );\t// hierarchy.md:49:23\n  AddOne i1 (\t// hierarchy.md:50:23\n    .in  (_i0_out),\t// hierarchy.md:49:23\n    .out (out)\n  );\t// hierarchy.md:50:23\nendmodule\n\n"})}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-access-internal-fields-of-an-instance",children:"How do I access internal fields of an instance?"}),"\n",(0,t.jsxs)(n.p,{children:["You can mark internal members of a class or trait marked with ",(0,t.jsx)(n.code,{children:"@instantiable"})," with the ",(0,t.jsx)(n.code,{children:"@public"})," annotation.\nThe requirements are that the field is publicly accessible, is a ",(0,t.jsx)(n.code,{children:"val"})," or ",(0,t.jsx)(n.code,{children:"lazy val"}),", and is a valid type.\nThe list of valid types are:"]}),"\n",(0,t.jsxs)(n.ol,{children:["\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.code,{children:"IsInstantiable"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.code,{children:"IsLookupable"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.code,{children:"Data"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.code,{children:"BaseModule"})}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"Iterable"}),"/",(0,t.jsx)(n.code,{children:"Option "}),"containing a type that meets these requirements"]}),"\n",(0,t.jsxs)(n.li,{children:["Basic type like ",(0,t.jsx)(n.code,{children:"String"}),", ",(0,t.jsx)(n.code,{children:"Int"}),", ",(0,t.jsx)(n.code,{children:"BigInt"})," etc."]}),"\n"]}),"\n",(0,t.jsxs)(n.p,{children:["To mark a superclass's member as ",(0,t.jsx)(n.code,{children:"@public"}),", use the following pattern (shown with ",(0,t.jsx)(n.code,{children:"val clock"}),")."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.hierarchy.{instantiable, public}\n\n@instantiable\nclass MyModule extends Module {\n  @public val clock = clock\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["You'll get the following error message for improperly marking something as ",(0,t.jsx)(n.code,{children:"@public"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.hierarchy.{instantiable, public}\n\nobject NotValidType\n\n@instantiable\nclass MyModule extends Module {\n  @public val x = NotValidType\n}\n// error: @public is only legal within a class or trait marked @instantiable, and only on vals of type Data, BaseModule, MemBase, IsInstantiable, IsLookupable, or Instance[_], or in an Iterable, Option, Either, or Tuple2\n// val x = circt.stage.ChiselStage.emitCHIRRTL(new Top)\n//     ^\n"})}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-make-my-parameters-accessible-from-an-instance",children:"How do I make my parameters accessible from an instance?"}),"\n",(0,t.jsxs)(n.p,{children:["If an instance's parameters are simple (e.g. ",(0,t.jsx)(n.code,{children:"Int"}),", ",(0,t.jsx)(n.code,{children:"String"})," etc.) they can be marked directly with ",(0,t.jsx)(n.code,{children:"@public"}),"."]}),"\n",(0,t.jsxs)(n.p,{children:["Often, parameters are more complicated and are contained in case classes.\nIn such cases, mark the case class with the ",(0,t.jsx)(n.code,{children:"IsLookupable"})," trait.\nThis indicates to Chisel that instances of the ",(0,t.jsx)(n.code,{children:"IsLookupable"})," class may be accessed from within instances."]}),"\n",(0,t.jsxs)(n.p,{children:["However, ensure that these parameters are true for ",(0,t.jsx)(n.strong,{children:"all"})," instances of a definition.\nFor example, if our parameters contained an id field which was instance-specific but defaulted to zero,\nthen the definition's id would be returned for all instances.\nThis change in behavior could lead to bugs if other code presumed the id field was correct."]}),"\n",(0,t.jsxs)(n.p,{children:["Thus, it is important that when converting normal modules to use this package,\nyou are careful about what you mark as ",(0,t.jsx)(n.code,{children:"IsLookupable"}),"."]}),"\n",(0,t.jsxs)(n.p,{children:["In the following example, we added the trait ",(0,t.jsx)(n.code,{children:"IsLookupable"})," to allow the member to be marked ",(0,t.jsx)(n.code,{children:"@public"}),"."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'import chisel3._\nimport chisel3.experimental.hierarchy.{Definition, Instance, instantiable, IsLookupable, public}\n\ncase class MyCaseClass(width: Int) extends IsLookupable\n\n@instantiable\nclass MyModule extends Module {\n  @public val x = MyCaseClass(10)\n}\n\nclass Top extends Module {\n  val inst = Instance(Definition(new MyModule))\n  println(s"Width is ${inst.x.width}")\n}\n'})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{children:"Width is 10\nCircuit(Top,List(DefModule(repl.MdocSession$MdocApp5$MyModule@47eac141,MyModule,false,List(),List(Port(MyModule.clock: IO[Clock],Input,SourceLine(hierarchy.md,105,2)), Port(MyModule.reset: IO[Reset],Input,SourceLine(hierarchy.md,105,2))),Vector()), DefModule(repl.MdocSession$MdocApp5$Top@1fddaa2a,Top,true,List(),List(Port(Top.clock: IO[Clock],Input,SourceLine(hierarchy.md,111,7)), Port(Top.reset: IO[Bool],Input,SourceLine(hierarchy.md,111,7))),Vector(DefInstance(SourceLine(hierarchy.md,112,22),ModuleClone(repl.MdocSession$MdocApp5$MyModule@47eac141),List(Port(MyModule.clock: IO[Clock],Input,SourceLine(hierarchy.md,105,2)), Port(MyModule.reset: IO[Reset],Input,SourceLine(hierarchy.md,105,2)))), Connect(SourceLine(hierarchy.md,112,22),Node(MyModule.inst.clock: IO[Clock]),Node(Top.clock: IO[Clock])), Connect(SourceLine(hierarchy.md,112,22),Node(MyModule.inst.reset: IO[Reset]),Node(Top.reset: IO[Bool]))))),List(),firrtl.renamemap.package$MutableRenameMap@79862851,List(),List(),List(),List())\n"})}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-look-up-parameters-from-a-definition-if-i-dont-want-to-instantiate-it",children:"How do I look up parameters from a Definition, if I don't want to instantiate it?"}),"\n",(0,t.jsxs)(n.p,{children:["Just like ",(0,t.jsx)(n.code,{children:"Instance"}),"s, ",(0,t.jsx)(n.code,{children:"Definition"}),"'s also contain accessors for ",(0,t.jsx)(n.code,{children:"@public"})," members.\nAs such, you can directly access them:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'import chisel3._\nimport chisel3.experimental.hierarchy.{Definition, instantiable, public}\n\n@instantiable\nclass AddOne(val width: Int) extends RawModule {\n  @public val width = width\n  @public val in  = IO(Input(UInt(width.W)))\n  @public val out = IO(Output(UInt(width.W)))\n  out := in + 1.U\n}\n\nclass Top extends Module {\n  val definition = Definition(new AddOne(10))\n  println(s"Width is: ${definition.width}")\n}\n'})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Top(\t// hierarchy.md:157:7\n  input clock,\t// hierarchy.md:157:7\n        reset\t// hierarchy.md:157:7\n);\n\nendmodule\n\n"})}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-parameterize-a-module-by-its-children-instances",children:"How do I parameterize a module by its children instances?"}),"\n",(0,t.jsx)(n.p,{children:"Prior to the introduction of this package, a parent module would have to pass all necessary parameters\nwhen instantiating a child module.\nThis had the unfortunate consequence of requiring a parent's parameters to always contain the child's\nparameters, which was an unnecessary coupling which lead to some anti-patterns."}),"\n",(0,t.jsxs)(n.p,{children:["Now, a parent can take a child ",(0,t.jsx)(n.code,{children:"Definition"})," as an argument, and instantiate it directly.\nIn addition, it can analyze the parameters used in the definition to parameterize itself.\nIn a sense, now the child can actually parameterize the parent."]}),"\n",(0,t.jsxs)(n.p,{children:["In the following example, we create a definition of ",(0,t.jsx)(n.code,{children:"AddOne"}),", and pass the definition to ",(0,t.jsx)(n.code,{children:"AddTwo"}),".\nThe width of the ",(0,t.jsx)(n.code,{children:"AddTwo"})," ports are now derived from the parameterization of the ",(0,t.jsx)(n.code,{children:"AddOne"})," instance."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.hierarchy.{Definition, Instance, instantiable, public}\n\n@instantiable\nclass AddOne(val width: Int) extends Module {\n  @public val width = width\n  @public val in  = IO(Input(UInt(width.W)))\n  @public val out = IO(Output(UInt(width.W)))\n  out := in + 1.U\n}\n\nclass AddTwo(addOneDef: Definition[AddOne]) extends Module {\n  val i0 = Instance(addOneDef)\n  val i1 = Instance(addOneDef)\n  val in  = IO(Input(UInt(addOneDef.width.W)))\n  val out = IO(Output(UInt(addOneDef.width.W)))\n  i0.in := in\n  i1.in := i0.out\n  out   := i1.out\n}\n"})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule AddOne(\t// hierarchy.md:181:2\n  input  [9:0] in,\t// hierarchy.md:184:23\n  output [9:0] out\t// hierarchy.md:185:23\n);\n\n  assign out = in + 10'h1;\t// hierarchy.md:181:2, :186:13\nendmodule\n\nmodule AddTwo(\t// hierarchy.md:190:7\n  input        clock,\t// hierarchy.md:190:7\n               reset,\t// hierarchy.md:190:7\n  input  [9:0] in,\t// hierarchy.md:193:15\n  output [9:0] out\t// hierarchy.md:194:15\n);\n\n  wire [9:0] _i0_out;\t// hierarchy.md:191:20\n  AddOne i0 (\t// hierarchy.md:191:20\n    .in  (in),\n    .out (_i0_out)\n  );\t// hierarchy.md:191:20\n  AddOne i1 (\t// hierarchy.md:192:20\n    .in  (_i0_out),\t// hierarchy.md:191:20\n    .out (out)\n  );\t// hierarchy.md:192:20\nendmodule\n\n"})}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-use-the-new-hierarchy-specific-select-functions",children:"How do I use the new hierarchy-specific Select functions?"}),"\n",(0,t.jsx)(n.p,{children:"Select functions can be applied after a module has been elaborated, either in a Chisel Aspect or in a parent module applied to a child module."}),"\n",(0,t.jsxs)(n.p,{children:["There are seven hierarchy-specific functions, which (with the exception of ",(0,t.jsx)(n.code,{children:"ios"}),") either return ",(0,t.jsx)(n.code,{children:"Instance"}),"'s or ",(0,t.jsx)(n.code,{children:"Definition"}),"'s:"]}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"instancesIn(parent)"}),": Return all instances directly instantiated locally within ",(0,t.jsx)(n.code,{children:"parent"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"instancesOf[type](parent)"}),": Return all instances of provided ",(0,t.jsx)(n.code,{children:"type"})," directly instantiated locally within ",(0,t.jsx)(n.code,{children:"parent"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"allInstancesOf[type](root)"}),": Return all instances of provided ",(0,t.jsx)(n.code,{children:"type"})," directly and indirectly instantiated, locally and deeply, starting from ",(0,t.jsx)(n.code,{children:"root"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"definitionsIn"}),": Return definitions of all instances directly instantiated locally within ",(0,t.jsx)(n.code,{children:"parent"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"definitionsOf[type]"}),": Return definitions of all instances of provided ",(0,t.jsx)(n.code,{children:"type"})," directly instantiated locally within ",(0,t.jsx)(n.code,{children:"parent"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"allDefinitionsOf[type]"}),": Return all definitions of instances of provided ",(0,t.jsx)(n.code,{children:"type"})," directly and indirectly instantiated, locally and deeply, starting from ",(0,t.jsx)(n.code,{children:"root"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"ios"}),": Returns all the I/Os of the provided definition or instance."]}),"\n"]}),"\n",(0,t.jsxs)(n.p,{children:["To demonstrate this, consider the following. We mock up an example where we are using the ",(0,t.jsx)(n.code,{children:"Select.allInstancesOf"})," and ",(0,t.jsx)(n.code,{children:"Select.allDefinitionsOf"})," to annotate instances and the definition of ",(0,t.jsx)(n.code,{children:"EmptyModule"}),". When converting the ",(0,t.jsx)(n.code,{children:"ChiselAnnotation"})," to firrtl's ",(0,t.jsx)(n.code,{children:"Annotation"}),", we print out the resulting ",(0,t.jsx)(n.code,{children:"Target"}),". As shown, despite ",(0,t.jsx)(n.code,{children:"EmptyModule"})," actually only being elaborated once, we still provide different targets depending on how the instance or definition is selected."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'import chisel3._\nimport chisel3.experimental.hierarchy.{Definition, Instance, Hierarchy, instantiable, public}\nimport firrtl.annotations.{IsModule, NoTargetAnnotation}\ncase object EmptyAnnotation extends NoTargetAnnotation\ncase class MyChiselAnnotation(m: Hierarchy[RawModule], tag: String) extends experimental.ChiselAnnotation {\n  def toFirrtl = {\n    println(tag + ": " + m.toTarget)\n    EmptyAnnotation\n  }\n}\n\n@instantiable\nclass EmptyModule extends Module {\n  println("Elaborating EmptyModule!")\n}\n\n@instantiable\nclass TwoEmptyModules extends Module {\n  val definition = Definition(new EmptyModule)\n  val i0         = Instance(definition)\n  val i1         = Instance(definition)\n}\n\nclass Top extends Module {\n  val definition = Definition(new TwoEmptyModules)\n  val instance   = Instance(definition)\n  aop.Select.allInstancesOf[EmptyModule](instance).foreach { i =>\n    experimental.annotate(MyChiselAnnotation(i, "instance"))\n  }\n  aop.Select.allDefinitionsOf[EmptyModule](instance).foreach { d =>\n    experimental.annotate(MyChiselAnnotation(d, "definition"))\n  }\n}\n'})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{children:"Elaborating EmptyModule!\ninstance: ~Top|Top/instance:TwoEmptyModules/i0:EmptyModule\ninstance: ~Top|Top/instance:TwoEmptyModules/i1:EmptyModule\ndefinition: ~Top|EmptyModule\n"})}),"\n",(0,t.jsxs)(n.p,{children:["You can also use ",(0,t.jsx)(n.code,{children:"Select.ios"})," on either a ",(0,t.jsx)(n.code,{children:"Definition"})," or an ",(0,t.jsx)(n.code,{children:"Instance"})," to annotate the I/Os appropriately:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'case class MyIOAnnotation(m: Data, tag: String) extends experimental.ChiselAnnotation {\n  def toFirrtl = {\n    println(tag + ": " + m.toTarget)\n    EmptyAnnotation\n  }\n}\n\n@instantiable\nclass InOutModule extends Module {\n  @public val in = IO(Input(Bool()))\n  @public val out = IO(Output(Bool()))\n  out := in\n}\n\n@instantiable\nclass TwoInOutModules extends Module {\n  val in = IO(Input(Bool()))\n  val out = IO(Output(Bool()))\n  val definition = Definition(new InOutModule)\n  val i0         = Instance(definition)\n  val i1         = Instance(definition)\n  i0.in := in\n  i1.in := i0.out\n  out := i1.out\n}\n\nclass InOutTop extends Module {\n  val definition = Definition(new TwoInOutModules)\n  val instance   = Instance(definition)\n  aop.Select.allInstancesOf[InOutModule](instance).foreach { i =>\n    aop.Select.ios(i).foreach { io =>\n      experimental.annotate(MyIOAnnotation(io, "instance io"))\n  }}\n  aop.Select.allDefinitionsOf[InOutModule](instance).foreach { d =>\n    aop.Select.ios(d).foreach {io =>\n      experimental.annotate(MyIOAnnotation(io, "definition io"))\n  }}\n}\n'})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{children:"instance io: ~InOutTop|InOutTop/instance:TwoInOutModules/i0:InOutModule>clock\ninstance io: ~InOutTop|InOutTop/instance:TwoInOutModules/i0:InOutModule>reset\ninstance io: ~InOutTop|InOutTop/instance:TwoInOutModules/i0:InOutModule>in\ninstance io: ~InOutTop|InOutTop/instance:TwoInOutModules/i0:InOutModule>out\ninstance io: ~InOutTop|InOutTop/instance:TwoInOutModules/i1:InOutModule>clock\ninstance io: ~InOutTop|InOutTop/instance:TwoInOutModules/i1:InOutModule>reset\ninstance io: ~InOutTop|InOutTop/instance:TwoInOutModules/i1:InOutModule>in\ninstance io: ~InOutTop|InOutTop/instance:TwoInOutModules/i1:InOutModule>out\ndefinition io: ~InOutTop|InOutModule>clock\ndefinition io: ~InOutTop|InOutModule>reset\ndefinition io: ~InOutTop|InOutModule>in\ndefinition io: ~InOutTop|InOutModule>out\n"})})]})}function u(e={}){const{wrapper:n}={...(0,o.R)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(h,{...e})}):h(e)}},1871:(e,n,i)=>{i.d(n,{A:()=>s});i(6540);var t=i(5195);const o={tableOfContentsInline:"tableOfContentsInline_prmo"};var a=i(4848);function s(e){let{toc:n,minHeadingLevel:i,maxHeadingLevel:s}=e;return(0,a.jsx)("div",{className:o.tableOfContentsInline,children:(0,a.jsx)(t.A,{toc:n,minHeadingLevel:i,maxHeadingLevel:s,className:"table-of-contents",linkClassName:null})})}},5195:(e,n,i)=>{i.d(n,{A:()=>f});var t=i(6540),o=i(6342);function a(e){const n=e.map((e=>({...e,parentIndex:-1,children:[]}))),i=Array(7).fill(-1);n.forEach(((e,n)=>{const t=i.slice(2,e.level);e.parentIndex=Math.max(...t),i[e.level]=n}));const t=[];return n.forEach((e=>{const{parentIndex:i,...o}=e;i>=0?n[i].children.push(o):t.push(o)})),t}function s(e){let{toc:n,minHeadingLevel:i,maxHeadingLevel:t}=e;return n.flatMap((e=>{const n=s({toc:e.children,minHeadingLevel:i,maxHeadingLevel:t});return function(e){return e.level>=i&&e.level<=t}(e)?[{...e,children:n}]:n}))}function l(e){const n=e.getBoundingClientRect();return n.top===n.bottom?l(e.parentNode):n}function c(e,n){let{anchorTopOffset:i}=n;const t=e.find((e=>l(e).top>=i));if(t){return function(e){return e.top>0&&e.bottom<window.innerHeight/2}(l(t))?t:e[e.indexOf(t)-1]??null}return e[e.length-1]??null}function d(){const e=(0,t.useRef)(0),{navbar:{hideOnScroll:n}}=(0,o.p)();return(0,t.useEffect)((()=>{e.current=n?0:document.querySelector(".navbar").clientHeight}),[n]),e}function r(e){const n=(0,t.useRef)(void 0),i=d();(0,t.useEffect)((()=>{if(!e)return()=>{};const{linkClassName:t,linkActiveClassName:o,minHeadingLevel:a,maxHeadingLevel:s}=e;function l(){const e=function(e){return Array.from(document.getElementsByClassName(e))}(t),l=function(e){let{minHeadingLevel:n,maxHeadingLevel:i}=e;const t=[];for(let o=n;o<=i;o+=1)t.push(`h${o}.anchor`);return Array.from(document.querySelectorAll(t.join()))}({minHeadingLevel:a,maxHeadingLevel:s}),d=c(l,{anchorTopOffset:i.current}),r=e.find((e=>d&&d.id===function(e){return decodeURIComponent(e.href.substring(e.href.indexOf("#")+1))}(e)));e.forEach((e=>{!function(e,i){i?(n.current&&n.current!==e&&n.current.classList.remove(o),e.classList.add(o),n.current=e):e.classList.remove(o)}(e,e===r)}))}return document.addEventListener("scroll",l),document.addEventListener("resize",l),l(),()=>{document.removeEventListener("scroll",l),document.removeEventListener("resize",l)}}),[e,i])}var h=i(8774),u=i(4848);function p(e){let{toc:n,className:i,linkClassName:t,isChild:o}=e;return n.length?(0,u.jsx)("ul",{className:o?void 0:i,children:n.map((e=>(0,u.jsxs)("li",{children:[(0,u.jsx)(h.A,{to:`#${e.id}`,className:t??void 0,dangerouslySetInnerHTML:{__html:e.value}}),(0,u.jsx)(p,{isChild:!0,toc:e.children,className:i,linkClassName:t})]},e.id)))}):null}const m=t.memo(p);function f(e){let{toc:n,className:i="table-of-contents table-of-contents__left-border",linkClassName:l="table-of-contents__link",linkActiveClassName:c,minHeadingLevel:d,maxHeadingLevel:h,...p}=e;const f=(0,o.p)(),x=d??f.tableOfContents.minHeadingLevel,I=h??f.tableOfContents.maxHeadingLevel,y=function(e){let{toc:n,minHeadingLevel:i,maxHeadingLevel:o}=e;return(0,t.useMemo)((()=>s({toc:a(n),minHeadingLevel:i,maxHeadingLevel:o})),[n,i,o])}({toc:n,minHeadingLevel:x,maxHeadingLevel:I});return r((0,t.useMemo)((()=>{if(l&&c)return{linkClassName:l,linkActiveClassName:c,minHeadingLevel:x,maxHeadingLevel:I}}),[l,c,x,I])),(0,u.jsx)(m,{toc:y,className:i,linkClassName:l,...p})}},8453:(e,n,i)=>{i.d(n,{R:()=>s,x:()=>l});var t=i(6540);const o={},a=t.createContext(o);function s(e){const n=t.useContext(a);return t.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function l(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(o):e.components||o:s(e.components),t.createElement(a.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/67ffb541.aafe16f9.js b/assets/js/67ffb541.aafe16f9.js
new file mode 100644
index 0000000000..9c8e80c266
--- /dev/null
+++ b/assets/js/67ffb541.aafe16f9.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[7132],{6350:(e,n,i)=>{i.r(n),i.d(n,{assets:()=>r,contentTitle:()=>l,default:()=>u,frontMatter:()=>s,metadata:()=>o,toc:()=>d});var a=i(4848),t=i(8453);const s={layout:"docs",title:"DataView",section:"chisel3"},l="DataView",o={id:"explanations/dataview",title:"DataView",description:"New in Chisel 3.5",source:"@site/docs/explanations/dataview.md",sourceDirName:"explanations",slug:"/explanations/dataview",permalink:"/docs/explanations/dataview",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/dataview.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"DataView",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Chisel Data Types",permalink:"/docs/explanations/data-types"},next:{title:"Decoders",permalink:"/docs/explanations/decoder"}},r={},d=[{value:"Introduction",id:"introduction",level:2},{value:"A Motivating Example (AXI4)",id:"a-motivating-example-axi4",level:2},{value:"Other Use Cases",id:"other-use-cases",level:2},{value:"Tuples",id:"tuples",level:3},{value:"Totality and PartialDataView",id:"totality-and-partialdataview",level:2},{value:"Advanced Details",id:"advanced-details",level:2},{value:"Type Classes",id:"type-classes",level:3},{value:"Implicit Resolution",id:"implicit-resolution",level:3},{value:"Implicit Resolution Example",id:"implicit-resolution-example",level:4},{value:"DataProduct",id:"dataproduct",level:3}];function c(e){const n={a:"a",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",h4:"h4",li:"li",ol:"ol",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,t.R)(),...e.components};return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(n.h1,{id:"dataview",children:"DataView"}),"\n",(0,a.jsx)(n.p,{children:(0,a.jsx)(n.em,{children:"New in Chisel 3.5"})}),"\n",(0,a.jsx)(n.h2,{id:"introduction",children:"Introduction"}),"\n",(0,a.jsxs)(n.p,{children:['DataView is a mechanism for "viewing" Scala objects as a subtype of ',(0,a.jsx)(n.code,{children:"chisel3.Data"}),".\nOften, this is useful for viewing one subtype of ",(0,a.jsx)(n.code,{children:"chisel3.Data"}),", as another.\nOne can think about a ",(0,a.jsx)(n.code,{children:"DataView"})," as a mapping from a ",(0,a.jsx)(n.em,{children:"Target"})," type ",(0,a.jsx)(n.code,{children:"T"})," to a ",(0,a.jsx)(n.em,{children:"View"})," type ",(0,a.jsx)(n.code,{children:"V"}),".\nThis is similar to a cast (eg. ",(0,a.jsx)(n.code,{children:".asTypeOf"}),") with a few differences:"]}),"\n",(0,a.jsxs)(n.ol,{children:["\n",(0,a.jsxs)(n.li,{children:["Views are ",(0,a.jsx)(n.em,{children:"connectable"}),"\u2014connections to the view will occur on the target"]}),"\n",(0,a.jsxs)(n.li,{children:["Whereas casts are ",(0,a.jsx)(n.em,{children:"structural"})," (a reinterpretation of the underlying bits), a DataView is a customizable mapping"]}),"\n",(0,a.jsxs)(n.li,{children:["Views can be ",(0,a.jsx)(n.em,{children:"partial"}),"\u2014not every field in the target must be included in the mapping"]}),"\n"]}),"\n",(0,a.jsx)(n.h2,{id:"a-motivating-example-axi4",children:"A Motivating Example (AXI4)"}),"\n",(0,a.jsxs)(n.p,{children:[(0,a.jsx)(n.a,{href:"https://en.wikipedia.org/wiki/Advanced_eXtensible_Interface",children:"AXI4"})," is a common interface in digital\ndesign.\nA typical Verilog peripheral using AXI4 will define a write channel as something like:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:"module my_module(\n  // Write Channel\n  input        AXI_AWVALID,\n  output       AXI_AWREADY,\n  input [3:0]  AXI_AWID,\n  input [19:0] AXI_AWADDR,\n  input [1:0]  AXI_AWLEN,\n  input [1:0]  AXI_AWSIZE,\n  // ...\n);\n"})}),"\n",(0,a.jsx)(n.p,{children:"This would correspond to the following Chisel Bundle:"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"class VerilogAXIBundle(val addrWidth: Int) extends Bundle {\n  val AWVALID = Output(Bool())\n  val AWREADY = Input(Bool())\n  val AWID = Output(UInt(4.W))\n  val AWADDR = Output(UInt(addrWidth.W))\n  val AWLEN = Output(UInt(2.W))\n  val AWSIZE = Output(UInt(2.W))\n  // The rest of AW and other AXI channels here\n}\n\n// Instantiated as\nclass my_module extends RawModule {\n  val AXI = IO(new VerilogAXIBundle(20))\n}\n"})}),"\n",(0,a.jsxs)(n.p,{children:["Expressing something that matches a standard Verilog interface is important when instantiating Verilog\nmodules in a Chisel design as ",(0,a.jsx)(n.code,{children:"BlackBoxes"}),".\nGenerally though, Chisel developers prefer to use composition via utilities like ",(0,a.jsx)(n.code,{children:"Decoupled"})," rather\nthan a flat handling of ",(0,a.jsx)(n.code,{children:"ready"})," and ",(0,a.jsx)(n.code,{children:"valid"}),' as in the above.\nA more "Chisel-y" implementation of this interface might look like:']}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"// Note that both the AW and AR channels look similar and could use the same Bundle definition\nclass AXIAddressChannel(val addrWidth: Int) extends Bundle {\n  val id = UInt(4.W)\n  val addr = UInt(addrWidth.W)\n  val len = UInt(2.W)\n  val size = UInt(2.W)\n  // ...\n}\nimport chisel3.util.Decoupled\n// We can compose the various AXI channels together\nclass AXIBundle(val addrWidth: Int) extends Bundle {\n  val aw = Decoupled(new AXIAddressChannel(addrWidth))\n  // val ar = new AXIAddressChannel\n  // ... Other channels here ...\n}\n// Instantiated as\nclass MyModule extends RawModule {\n  val axi = IO(new AXIBundle(20))\n}\n"})}),"\n",(0,a.jsx)(n.p,{children:"Of course, this would result in very different looking Verilog:"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule MyModule(\t// dataview.md:60:33\n  input         axi_aw_ready,\t// dataview.md:53:15\n  output        axi_aw_valid,\t// dataview.md:53:15\n  output [3:0]  axi_aw_bits_id,\t// dataview.md:53:15\n  output [19:0] axi_aw_bits_addr,\t// dataview.md:53:15\n  output [1:0]  axi_aw_bits_len,\t// dataview.md:53:15\n                axi_aw_bits_size\t// dataview.md:53:15\n);\n\n  assign axi_aw_valid = 1\'h0;\t// dataview.md:60:33\n  assign axi_aw_bits_id = 4\'h0;\t// dataview.md:60:33\n  assign axi_aw_bits_addr = 20\'h0;\t// dataview.md:60:33\n  assign axi_aw_bits_len = 2\'h0;\t// dataview.md:60:33\n  assign axi_aw_bits_size = 2\'h0;\t// dataview.md:60:33\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_MyModule_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyModule_Verification.sv"\n`ifndef layers_MyModule_Verification_Cover\n`define layers_MyModule_Verification_Cover\t// <stdin>:6:5\n`endif // layers_MyModule_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_MyModule_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyModule_Verification.sv"\n`ifndef layers_MyModule_Verification_Assume\n`define layers_MyModule_Verification_Assume\t// <stdin>:5:5\n`endif // layers_MyModule_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_MyModule_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyModule_Verification.sv"\n`ifndef layers_MyModule_Verification_Assert\n`define layers_MyModule_Verification_Assert\t// <stdin>:4:5\n`endif // layers_MyModule_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_MyModule_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_MyModule_Verification\n`define layers_MyModule_Verification\t// <stdin>:3:3\n`endif // layers_MyModule_Verification\t// <stdin>:3:3\n'})}),"\n",(0,a.jsx)(n.p,{children:"So how can we use our more structured types while maintaining expected Verilog interfaces?\nMeet DataView:"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"import chisel3.experimental.dataview._\n\n// We recommend putting DataViews in a companion object of one of the involved types\nobject AXIBundle {\n  // Don't be afraid of the use of implicits, we will discuss this pattern in more detail later\n  implicit val axiView = DataView[VerilogAXIBundle, AXIBundle](\n    // The first argument is a function constructing an object of View type (AXIBundle)\n    // from an object of the Target type (VerilogAXIBundle)\n    vab => new AXIBundle(vab.addrWidth),\n    // The remaining arguments are a mapping of the corresponding fields of the two types\n    _.AWVALID -> _.aw.valid,\n    _.AWREADY -> _.aw.ready,\n    _.AWID -> _.aw.bits.id,\n    _.AWADDR -> _.aw.bits.addr,\n    _.AWLEN -> _.aw.bits.len,\n    _.AWSIZE -> _.aw.bits.size,\n    // ...\n  )\n}\n"})}),"\n",(0,a.jsxs)(n.p,{children:["This ",(0,a.jsx)(n.code,{children:"DataView"})," is a mapping between our flat, Verilog-style AXI Bundle to our more compositional,\nChisel-style AXI Bundle.\nIt allows us to define our ports to match the expected Verilog interface, while manipulating it as if\nit were the more structured type:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"class AXIStub extends RawModule {\n  val AXI = IO(new VerilogAXIBundle(20))\n  val view = AXI.viewAs[AXIBundle]\n\n  // We can now manipulate `AXI` via `view`\n  view.aw.bits := 0.U.asTypeOf(new AXIAddressChannel(20)) // zero everything out by default\n  view.aw.valid := true.B\n  when (view.aw.ready) {\n    view.aw.bits.id := 5.U\n    view.aw.bits.addr := 1234.U\n    // We can still manipulate AXI as well\n    AXI.AWLEN := 1.U\n  }\n}\n"})}),"\n",(0,a.jsx)(n.p,{children:"This will generate Verilog that matches the standard naming convention:"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule AXIStub(\t// dataview.md:93:7\n  output        AXI_AWVALID,\t// dataview.md:94:15\n  input         AXI_AWREADY,\t// dataview.md:94:15\n  output [3:0]  AXI_AWID,\t// dataview.md:94:15\n  output [19:0] AXI_AWADDR,\t// dataview.md:94:15\n  output [1:0]  AXI_AWLEN,\t// dataview.md:94:15\n                AXI_AWSIZE\t// dataview.md:94:15\n);\n\n  assign AXI_AWVALID = 1\'h1;\t// dataview.md:93:7\n  assign AXI_AWID = AXI_AWREADY ? 4\'h5 : 4\'h0;\t// dataview.md:93:7, :98:16, :100:24, :101:21\n  assign AXI_AWADDR = AXI_AWREADY ? 20\'h4D2 : 20\'h0;\t// dataview.md:93:7, :98:16, :100:24, :102:23\n  assign AXI_AWLEN = {1\'h0, AXI_AWREADY};\t// dataview.md:93:7, :98:16, :100:24, :104:15\n  assign AXI_AWSIZE = 2\'h0;\t// dataview.md:93:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_AXIStub_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_AXIStub_Verification.sv"\n`ifndef layers_AXIStub_Verification_Cover\n`define layers_AXIStub_Verification_Cover\t// <stdin>:6:5\n`endif // layers_AXIStub_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_AXIStub_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_AXIStub_Verification.sv"\n`ifndef layers_AXIStub_Verification_Assume\n`define layers_AXIStub_Verification_Assume\t// <stdin>:5:5\n`endif // layers_AXIStub_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_AXIStub_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_AXIStub_Verification.sv"\n`ifndef layers_AXIStub_Verification_Assert\n`define layers_AXIStub_Verification_Assert\t// <stdin>:4:5\n`endif // layers_AXIStub_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_AXIStub_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_AXIStub_Verification\n`define layers_AXIStub_Verification\t// <stdin>:3:3\n`endif // layers_AXIStub_Verification\t// <stdin>:3:3\n'})}),"\n",(0,a.jsxs)(n.p,{children:["Note that if both the ",(0,a.jsx)(n.em,{children:"Target"})," and the ",(0,a.jsx)(n.em,{children:"View"})," types are subtypes of ",(0,a.jsx)(n.code,{children:"Data"})," (as they are in this example),\nthe ",(0,a.jsx)(n.code,{children:"DataView"})," is ",(0,a.jsx)(n.em,{children:"invertible"}),".\nThis means that we can easily create a ",(0,a.jsx)(n.code,{children:"DataView[AXIBundle, VerilogAXIBundle]"})," from our existing\n",(0,a.jsx)(n.code,{children:"DataView[VerilogAXIBundle, AXIBundle]"}),", all we need to do is provide a function to construct\na ",(0,a.jsx)(n.code,{children:"VerilogAXIBundle"})," from an instance of an ",(0,a.jsx)(n.code,{children:"AXIBundle"}),":"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"// Note that typically you should define these together (eg. inside object AXIBundle)\nimplicit val axiView2 = AXIBundle.axiView.invert(ab => new VerilogAXIBundle(ab.addrWidth))\n"})}),"\n",(0,a.jsxs)(n.p,{children:["The following example shows this and illustrates another use case of ",(0,a.jsx)(n.code,{children:"DataView"}),"\u2014connecting unrelated\ntypes:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"class ConnectionExample extends RawModule {\n  val in = IO(new AXIBundle(20))\n  val out = IO(Flipped(new VerilogAXIBundle(20)))\n  out.viewAs[AXIBundle] <> in\n}\n"})}),"\n",(0,a.jsx)(n.p,{children:"This results in the corresponding fields being connected in the emitted Verilog:"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule ConnectionExample(\t// dataview.md:124:7\n  input         in_aw_ready,\t// dataview.md:125:14\n  output        in_aw_valid,\t// dataview.md:125:14\n  output [3:0]  in_aw_bits_id,\t// dataview.md:125:14\n  output [19:0] in_aw_bits_addr,\t// dataview.md:125:14\n  output [1:0]  in_aw_bits_len,\t// dataview.md:125:14\n                in_aw_bits_size,\t// dataview.md:125:14\n  input         out_AWVALID,\t// dataview.md:126:15\n  output        out_AWREADY,\t// dataview.md:126:15\n  input  [3:0]  out_AWID,\t// dataview.md:126:15\n  input  [19:0] out_AWADDR,\t// dataview.md:126:15\n  input  [1:0]  out_AWLEN,\t// dataview.md:126:15\n                out_AWSIZE\t// dataview.md:126:15\n);\n\n  assign in_aw_valid = out_AWVALID;\t// dataview.md:124:7\n  assign in_aw_bits_id = out_AWID;\t// dataview.md:124:7\n  assign in_aw_bits_addr = out_AWADDR;\t// dataview.md:124:7\n  assign in_aw_bits_len = out_AWLEN;\t// dataview.md:124:7\n  assign in_aw_bits_size = out_AWSIZE;\t// dataview.md:124:7\n  assign out_AWREADY = in_aw_ready;\t// dataview.md:124:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_ConnectionExample_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_ConnectionExample_Verification.sv"\n`ifndef layers_ConnectionExample_Verification_Cover\n`define layers_ConnectionExample_Verification_Cover\t// <stdin>:6:5\n`endif // layers_ConnectionExample_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_ConnectionExample_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_ConnectionExample_Verification.sv"\n`ifndef layers_ConnectionExample_Verification_Assume\n`define layers_ConnectionExample_Verification_Assume\t// <stdin>:5:5\n`endif // layers_ConnectionExample_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_ConnectionExample_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_ConnectionExample_Verification.sv"\n`ifndef layers_ConnectionExample_Verification_Assert\n`define layers_ConnectionExample_Verification_Assert\t// <stdin>:4:5\n`endif // layers_ConnectionExample_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_ConnectionExample_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_ConnectionExample_Verification\n`define layers_ConnectionExample_Verification\t// <stdin>:3:3\n`endif // layers_ConnectionExample_Verification\t// <stdin>:3:3\n'})}),"\n",(0,a.jsx)(n.h2,{id:"other-use-cases",children:"Other Use Cases"}),"\n",(0,a.jsxs)(n.p,{children:["While the ability to map between ",(0,a.jsx)(n.code,{children:"Bundle"})," types as in the AXI4 example is pretty compelling,\nDataView has many other applications.\nImportantly, because the ",(0,a.jsx)(n.em,{children:"Target"})," of the ",(0,a.jsx)(n.code,{children:"DataView"})," need not be a ",(0,a.jsx)(n.code,{children:"Data"}),", it provides a way to use\n",(0,a.jsx)(n.code,{children:"non-Data"})," objects with APIs that require ",(0,a.jsx)(n.code,{children:"Data"}),"."]}),"\n",(0,a.jsx)(n.h3,{id:"tuples",children:"Tuples"}),"\n",(0,a.jsxs)(n.p,{children:["Perhaps the most helpful use of ",(0,a.jsx)(n.code,{children:"DataView"})," for a non-",(0,a.jsx)(n.code,{children:"Data"})," type is viewing Scala tuples as ",(0,a.jsx)(n.code,{children:"Bundles"}),".\nFor example, in Chisel prior to the introduction of ",(0,a.jsx)(n.code,{children:"DataView"}),", one might try to ",(0,a.jsx)(n.code,{children:"Mux"})," tuples and\nsee an error like the following:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"class TupleExample extends RawModule {\n  val a, b, c, d = IO(Input(UInt(8.W)))\n  val cond = IO(Input(Bool()))\n  val x, y = IO(Output(UInt(8.W)))\n  (x, y) := Mux(cond, (a, b), (c, d))\n}\n// error: value := is not a member of (chisel3.UInt, chisel3.UInt)\n//   Expression does not convert to assignment because receiver is not assignable.\n//   (x, y) := Mux(cond, (a, b), (c, d))\n//   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n// error: inferred type arguments [(chisel3.UInt, chisel3.UInt)] do not conform to macro method apply's type parameter bounds [T <: chisel3.Data]\n//   (x, y) := Mux(cond, (a, b), (c, d))\n//             ^^^\n// error: type mismatch;\n//  found   : (chisel3.UInt, chisel3.UInt)\n//  required: T\n//   (x, y) := Mux(cond, (a, b), (c, d))\n//                       ^^^^^^\n// error: type mismatch;\n//  found   : (chisel3.UInt, chisel3.UInt)\n//  required: T\n//   (x, y) := Mux(cond, (a, b), (c, d))\n//                               ^^^^^^\n"})}),"\n",(0,a.jsxs)(n.p,{children:["The issue, is that Chisel primitives like ",(0,a.jsx)(n.code,{children:"Mux"})," and ",(0,a.jsx)(n.code,{children:":="})," only operate on subtypes of ",(0,a.jsx)(n.code,{children:"Data"})," and\nTuples (as members of the Scala standard library), are not subclasses of ",(0,a.jsx)(n.code,{children:"Data"}),".\n",(0,a.jsx)(n.code,{children:"DataView"})," provides a mechanism to ",(0,a.jsx)(n.em,{children:"view"})," a ",(0,a.jsx)(n.code,{children:"Tuple"})," as if it were a ",(0,a.jsx)(n.code,{children:"Data"}),":"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"// We need a type to represent the Tuple\nclass HWTuple2[A <: Data, B <: Data](val _1: A, val _2: B) extends Bundle\n\n// Provide DataView between Tuple and HWTuple\nimplicit def view[A <: Data, B <: Data]: DataView[(A, B), HWTuple2[A, B]] =\n  DataView(tup => new HWTuple2(tup._1.cloneType, tup._2.cloneType),\n           _._1 -> _._1, _._2 -> _._2)\n"})}),"\n",(0,a.jsxs)(n.p,{children:["Now, we can use ",(0,a.jsx)(n.code,{children:".viewAs"})," to view Tuples as if they were subtypes of ",(0,a.jsx)(n.code,{children:"Data"}),":"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"class TupleVerboseExample extends RawModule {\n  val a, b, c, d = IO(Input(UInt(8.W)))\n  val cond = IO(Input(Bool()))\n  val x, y = IO(Output(UInt(8.W)))\n  (x, y).viewAs[HWTuple2[UInt, UInt]] := Mux(cond, (a, b).viewAs[HWTuple2[UInt, UInt]], (c, d).viewAs[HWTuple2[UInt, UInt]])\n}\n"})}),"\n",(0,a.jsxs)(n.p,{children:["This is much more verbose than the original idea of just using the Tuples directly as if they were ",(0,a.jsx)(n.code,{children:"Data"}),".\nWe can make this better by providing an implicit conversion that views a ",(0,a.jsx)(n.code,{children:"Tuple"})," as a ",(0,a.jsx)(n.code,{children:"HWTuple2"}),":"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"implicit def tuple2hwtuple[A <: Data, B <: Data](tup: (A, B)): HWTuple2[A, B] =\n  tup.viewAs[HWTuple2[A, B]]\n"})}),"\n",(0,a.jsx)(n.p,{children:"Now, the original code just works!"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"class TupleExample extends RawModule {\n  val a, b, c, d = IO(Input(UInt(8.W)))\n  val cond = IO(Input(Bool()))\n  val x, y = IO(Output(UInt(8.W)))\n  (x, y) := Mux(cond, (a, b), (c, d))\n}\n"})}),"\n",(0,a.jsxs)(n.p,{children:["Note that this example ignored ",(0,a.jsx)(n.code,{children:"DataProduct"})," which is another required piece (see ",(0,a.jsx)(n.a,{href:"#dataproduct",children:"the documentation\nabout it below"}),")."]}),"\n",(0,a.jsx)(n.p,{children:"All of this is available to users via a single import:"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"import chisel3.experimental.conversions._\n"})}),"\n",(0,a.jsx)(n.h2,{id:"totality-and-partialdataview",children:"Totality and PartialDataView"}),"\n",(0,a.jsxs)(n.p,{children:["A ",(0,a.jsx)(n.code,{children:"DataView"})," is ",(0,a.jsx)(n.em,{children:"total"})," if all fields of the ",(0,a.jsx)(n.em,{children:"Target"})," type and all fields of the ",(0,a.jsx)(n.em,{children:"View"})," type are\nincluded in the mapping.\nChisel will error if a field is accidentally left out from a ",(0,a.jsx)(n.code,{children:"DataView"}),".\nFor example:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"class BundleA extends Bundle {\n  val foo = UInt(8.W)\n  val bar = UInt(8.W)\n}\nclass BundleB extends Bundle {\n  val fizz = UInt(8.W)\n}\n"})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"// We forgot BundleA.foo in the mapping!\nimplicit val myView = DataView[BundleA, BundleB](_ => new BundleB, _.bar -> _.fizz)\nclass BadMapping extends Module {\n   val in = IO(Input(new BundleA))\n   val out = IO(Output(new BundleB))\n   out := in.viewAs[BundleB]\n}\n// We must run Chisel to see the error\ngetVerilogString(new BadMapping)\n// chisel3.experimental.dataview.package$InvalidViewException: Viewing BadMapping.in: IO[BundleA] as BundleB is non-Total!\n//   Target field '_.foo' is missing.\n//   DataView used is DataView(defined @[dataview.md:228:49]).\n//   If the view *should* be non-total, try a 'PartialDataView'.\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp6$$anonfun$55$BadMapping$1$$anonfun$60.apply(dataview.md:232)\n// \tat repl.MdocSession$MdocApp6$$anonfun$55$BadMapping$1$$anonfun$60.apply(dataview.md:232)\n// \tat chisel3.Data.$anonfun$$colon$eq$1(Data.scala:806)\n// \tat scala.runtime.java8.JFunction0$mcV$sp.apply(JFunction0$mcV$sp.scala:18)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:33)\n// \tat chisel3.Data.$colon$eq(Data.scala:806)\n// \tat repl.MdocSession$MdocApp6$$anonfun$55$BadMapping$1.<init>(dataview.md:232)\n// \tat repl.MdocSession$MdocApp6$$anonfun$55$$anonfun$apply$67.apply(dataview.md:234)\n// \tat repl.MdocSession$MdocApp6$$anonfun$55$$anonfun$apply$67.apply(dataview.md:234)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,a.jsxs)(n.p,{children:["As that error suggests, if we ",(0,a.jsx)(n.em,{children:"want"})," the view to be non-total, we can use a ",(0,a.jsx)(n.code,{children:"PartialDataView"}),":"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"// A PartialDataView does not have to be total for the Target\nimplicit val myView = PartialDataView[BundleA, BundleB](_ => new BundleB, _.bar -> _.fizz)\n// myView: DataView[BundleA, BundleB] = PartialDataView(defined @[dataview.md:243:56])\nclass PartialDataViewModule extends Module {\n   val in = IO(Input(new BundleA))\n   val out = IO(Output(new BundleB))\n   out := in.viewAs[BundleB]\n}\n"})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule PartialDataViewModule(\t// dataview.md:246:7\n  input        clock,\t// dataview.md:246:7\n               reset,\t// dataview.md:246:7\n  input  [7:0] in_foo,\t// dataview.md:247:15\n               in_bar,\t// dataview.md:247:15\n  output [7:0] out_fizz\t// dataview.md:248:16\n);\n\n  assign out_fizz = in_bar;\t// dataview.md:246:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_PartialDataViewModule_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_PartialDataViewModule_Verification.sv"\n`ifndef layers_PartialDataViewModule_Verification_Cover\n`define layers_PartialDataViewModule_Verification_Cover\t// <stdin>:6:5\n`endif // layers_PartialDataViewModule_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_PartialDataViewModule_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_PartialDataViewModule_Verification.sv"\n`ifndef layers_PartialDataViewModule_Verification_Assume\n`define layers_PartialDataViewModule_Verification_Assume\t// <stdin>:5:5\n`endif // layers_PartialDataViewModule_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_PartialDataViewModule_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_PartialDataViewModule_Verification.sv"\n`ifndef layers_PartialDataViewModule_Verification_Assert\n`define layers_PartialDataViewModule_Verification_Assert\t// <stdin>:4:5\n`endif // layers_PartialDataViewModule_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_PartialDataViewModule_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_PartialDataViewModule_Verification\n`define layers_PartialDataViewModule_Verification\t// <stdin>:3:3\n`endif // layers_PartialDataViewModule_Verification\t// <stdin>:3:3\n'})}),"\n",(0,a.jsxs)(n.p,{children:["While ",(0,a.jsx)(n.code,{children:"PartialDataViews"})," need not be total for the ",(0,a.jsx)(n.em,{children:"Target"}),", both ",(0,a.jsx)(n.code,{children:"PartialDataViews"})," and ",(0,a.jsx)(n.code,{children:"DataViews"}),"\nmust always be total for the ",(0,a.jsx)(n.em,{children:"View"}),".\nThis has the consequence that ",(0,a.jsx)(n.code,{children:"PartialDataViews"})," are ",(0,a.jsx)(n.strong,{children:"not"})," invertible in the same way as ",(0,a.jsx)(n.code,{children:"DataViews"}),"."]}),"\n",(0,a.jsx)(n.p,{children:"For example:"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"implicit val myView2 = myView.invert(_ => new BundleA)\nclass PartialDataViewModule2 extends Module {\n   val in = IO(Input(new BundleA))\n   val out = IO(Output(new BundleB))\n   // Using the inverted version of the mapping\n   out.viewAs[BundleA] := in\n}\n// We must run Chisel to see the error\ngetVerilogString(new PartialDataViewModule2)\n// chisel3.experimental.dataview.package$InvalidViewException: Cannot invert 'PartialDataView(defined @[dataview.md:243:56])' as it is non-total.\n//   Try providing a DataView[MdocApp6.this.BundleB, MdocApp6.this.BundleA].\n//   Please see https://www.chisel-lang.org/chisel3/docs/explanations/dataview.\n// \tat chisel3.experimental.dataview.DataView$InvertibleDataView.invert(DataView.scala:136)\n// \tat repl.MdocSession$MdocApp6$$anonfun$67.apply(dataview.md:263)\n// \tat repl.MdocSession$MdocApp6$$anonfun$67.apply(dataview.md:262)\n"})}),"\n",(0,a.jsxs)(n.p,{children:["As noted, the mapping must ",(0,a.jsx)(n.strong,{children:"always"})," be total for the ",(0,a.jsx)(n.code,{children:"View"}),"."]}),"\n",(0,a.jsx)(n.h2,{id:"advanced-details",children:"Advanced Details"}),"\n",(0,a.jsxs)(n.p,{children:[(0,a.jsx)(n.code,{children:"DataView"})," takes advantage of features of Scala that may be new to many users of Chisel\u2014in particular\n",(0,a.jsx)(n.a,{href:"#type-classes",children:"Type Classes"}),"."]}),"\n",(0,a.jsx)(n.h3,{id:"type-classes",children:"Type Classes"}),"\n",(0,a.jsxs)(n.p,{children:[(0,a.jsx)(n.a,{href:"https://en.wikipedia.org/wiki/Type_class",children:"Type classes"}),' are powerful language feature for writing\npolymorphic code.\nThey are a common feature in "modern programming languages" like\nScala,\nSwift (see ',(0,a.jsx)(n.a,{href:"https://docs.swift.org/swift-book/LanguageGuide/Protocols.html",children:"protocols"}),"),\nand Rust (see ",(0,a.jsx)(n.a,{href:"https://doc.rust-lang.org/book/ch10-02-traits.html",children:"traits"}),").\nType classes may appear similar to inheritance in object-oriented programming but there are some\nimportant  differences:"]}),"\n",(0,a.jsxs)(n.ol,{children:["\n",(0,a.jsx)(n.li,{children:"You can provide a type class for a type you don't own (eg. one defined in a 3rd party library,\nthe Scala standard library, or Chisel itself)"}),"\n",(0,a.jsx)(n.li,{children:"You can write a single type class for many types that do not have a sub-typing relationship"}),"\n",(0,a.jsx)(n.li,{children:"You can provide multiple different type classes for the same type"}),"\n"]}),"\n",(0,a.jsxs)(n.p,{children:["For ",(0,a.jsx)(n.code,{children:"DataView"}),", (1) is crucial because we want to be able to implement ",(0,a.jsx)(n.code,{children:"DataViews"})," of built-in Scala\ntypes like tuples and ",(0,a.jsx)(n.code,{children:"Seqs"}),". Furthermore, ",(0,a.jsx)(n.code,{children:"DataView"})," has two type parameters (the ",(0,a.jsx)(n.em,{children:"Target"})," and the\n",(0,a.jsx)(n.em,{children:"View"})," types) so inheritance does not really make sense\u2014which type would ",(0,a.jsx)(n.code,{children:"extend"})," ",(0,a.jsx)(n.code,{children:"DataView"}),"?"]}),"\n",(0,a.jsx)(n.p,{children:"In Scala 2, type classes are not a built-in language feature, but rather are implemented using implicits.\nThere are great resources out there for interested readers:"}),"\n",(0,a.jsxs)(n.ul,{children:["\n",(0,a.jsx)(n.li,{children:(0,a.jsx)(n.a,{href:"https://scalac.io/blog/typeclasses-in-scala/",children:"Basic Tutorial"})}),"\n",(0,a.jsx)(n.li,{children:(0,a.jsx)(n.a,{href:"https://stackoverflow.com/a/5598107/2483329",children:"Fantastic Explanation on StackOverflow"})}),"\n"]}),"\n",(0,a.jsx)(n.p,{children:"Note that Scala 3 has added built-in syntax for type classes that does not apply to Chisel 3 which\ncurrently only supports Scala 2."}),"\n",(0,a.jsx)(n.h3,{id:"implicit-resolution",children:"Implicit Resolution"}),"\n",(0,a.jsxs)(n.p,{children:["Given that ",(0,a.jsx)(n.code,{children:"DataView"})," is implemented using implicits, it is important to understand implicit\nresolution.\nWhenever the compiler sees an implicit argument is required, it first looks in ",(0,a.jsx)(n.em,{children:"current scope"}),"\nbefore looking in the ",(0,a.jsx)(n.em,{children:"implicit scope"}),"."]}),"\n",(0,a.jsxs)(n.ol,{children:["\n",(0,a.jsxs)(n.li,{children:["Current scope","\n",(0,a.jsxs)(n.ul,{children:["\n",(0,a.jsx)(n.li,{children:"Values defined in the current scope"}),"\n",(0,a.jsx)(n.li,{children:"Explicit imports"}),"\n",(0,a.jsx)(n.li,{children:"Wildcard imports"}),"\n"]}),"\n"]}),"\n",(0,a.jsxs)(n.li,{children:["Implicit scope","\n",(0,a.jsxs)(n.ul,{children:["\n",(0,a.jsx)(n.li,{children:"Companion object of a type"}),"\n",(0,a.jsx)(n.li,{children:"Implicit scope of an argument's type"}),"\n",(0,a.jsx)(n.li,{children:"Implicit scope of type parameters"}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,a.jsx)(n.p,{children:"If at either stage, multiple implicits are found, then the static overloading rule is used to resolve\nit.\nPut simply, if one implicit applies to a more-specific type than the other, the more-specific one\nwill be selected.\nIf multiple implicits apply within a given stage, then the compiler throws an ambiguous implicit\nresolution error."}),"\n",(0,a.jsxs)(n.p,{children:["This section draws heavily from ",(0,a.jsx)(n.a,{href:"https://stackoverflow.com/a/5598107/2483329",children:"[1]"})," and\n",(0,a.jsx)(n.a,{href:"https://stackoverflow.com/a/8694558/2483329",children:"[2]"}),".\nIn particular, see [1] for examples."]}),"\n",(0,a.jsx)(n.h4,{id:"implicit-resolution-example",children:"Implicit Resolution Example"}),"\n",(0,a.jsxs)(n.p,{children:["To help clarify a bit, let us consider how implicit resolution works for ",(0,a.jsx)(n.code,{children:"DataView"}),".\nConsider the definition of ",(0,a.jsx)(n.code,{children:"viewAs"}),":"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"def viewAs[V <: Data](implicit dataView: DataView[T, V]): V\n"})}),"\n",(0,a.jsxs)(n.p,{children:["Armed with the knowledge from the previous section, we know that whenever we call ",(0,a.jsx)(n.code,{children:".viewAs"}),", the\nScala compiler will first look for a ",(0,a.jsx)(n.code,{children:"DataView[T, V]"})," in the current scope (defined in, or imported),\nthen it will look in the companion objects of ",(0,a.jsx)(n.code,{children:"DataView"}),", ",(0,a.jsx)(n.code,{children:"T"}),", and ",(0,a.jsx)(n.code,{children:"V"}),".\nThis enables a fairly powerful pattern, namely that default or typical implementations of a ",(0,a.jsx)(n.code,{children:"DataView"}),"\nshould be defined in the companion object for one of the two types.\nWe can think about ",(0,a.jsx)(n.code,{children:"DataViews"}),' defined in this way as "low priority defaults".\nThey can then be overruled by a specific import if a given user ever wants different behavior.\nFor example:']}),"\n",(0,a.jsx)(n.p,{children:"Given the following types:"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"class Foo extends Bundle {\n  val a = UInt(8.W)\n  val b = UInt(8.W)\n}\nclass Bar extends Bundle {\n  val c = UInt(8.W)\n  val d = UInt(8.W)\n}\nobject Foo {\n  implicit val f2b = DataView[Foo, Bar](_ => new Bar, _.a -> _.c, _.b -> _.d)\n  implicit val b2f = f2b.invert(_ => new Foo)\n}\n"})}),"\n",(0,a.jsxs)(n.p,{children:["This provides an implementation of ",(0,a.jsx)(n.code,{children:"DataView"})," in the ",(0,a.jsx)(n.em,{children:"implicit scope"}),' as a "default" mapping between\n',(0,a.jsx)(n.code,{children:"Foo"})," and ",(0,a.jsx)(n.code,{children:"Bar"})," (and it doesn't even require an import!):"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"class FooToBar extends Module {\n  val foo = IO(Input(new Foo))\n  val bar = IO(Output(new Bar))\n  bar := foo.viewAs[Bar]\n}\n"})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule FooToBar(\t// dataview.md:300:7\n  input        clock,\t// dataview.md:300:7\n               reset,\t// dataview.md:300:7\n  input  [7:0] foo_a,\t// dataview.md:301:15\n               foo_b,\t// dataview.md:301:15\n  output [7:0] bar_c,\t// dataview.md:302:15\n               bar_d\t// dataview.md:302:15\n);\n\n  assign bar_c = foo_a;\t// dataview.md:300:7\n  assign bar_d = foo_b;\t// dataview.md:300:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_FooToBar_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_FooToBar_Verification.sv"\n`ifndef layers_FooToBar_Verification_Cover\n`define layers_FooToBar_Verification_Cover\t// <stdin>:6:5\n`endif // layers_FooToBar_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_FooToBar_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_FooToBar_Verification.sv"\n`ifndef layers_FooToBar_Verification_Assume\n`define layers_FooToBar_Verification_Assume\t// <stdin>:5:5\n`endif // layers_FooToBar_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_FooToBar_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_FooToBar_Verification.sv"\n`ifndef layers_FooToBar_Verification_Assert\n`define layers_FooToBar_Verification_Assert\t// <stdin>:4:5\n`endif // layers_FooToBar_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_FooToBar_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_FooToBar_Verification\n`define layers_FooToBar_Verification\t// <stdin>:3:3\n`endif // layers_FooToBar_Verification\t// <stdin>:3:3\n'})}),"\n",(0,a.jsxs)(n.p,{children:["However, it's possible that some user of ",(0,a.jsx)(n.code,{children:"Foo"})," and ",(0,a.jsx)(n.code,{children:"Bar"}),' wants different behavior,\nperhaps they would prefer more of "swizzling" behavior rather than a direct mapping:']}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"object Swizzle {\n  implicit val swizzle = DataView[Foo, Bar](_ => new Bar, _.a -> _.d, _.b -> _.c)\n}\n// Current scope always wins over implicit scope\nimport Swizzle._\nclass FooToBarSwizzled extends Module {\n  val foo = IO(Input(new Foo))\n  val bar = IO(Output(new Bar))\n  bar := foo.viewAs[Bar]\n}\n"})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule FooToBarSwizzled(\t// dataview.md:324:7\n  input        clock,\t// dataview.md:324:7\n               reset,\t// dataview.md:324:7\n  input  [7:0] foo_a,\t// dataview.md:325:15\n               foo_b,\t// dataview.md:325:15\n  output [7:0] bar_c,\t// dataview.md:326:15\n               bar_d\t// dataview.md:326:15\n);\n\n  assign bar_c = foo_b;\t// dataview.md:324:7\n  assign bar_d = foo_a;\t// dataview.md:324:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_FooToBarSwizzled_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_FooToBarSwizzled_Verification.sv"\n`ifndef layers_FooToBarSwizzled_Verification_Cover\n`define layers_FooToBarSwizzled_Verification_Cover\t// <stdin>:6:5\n`endif // layers_FooToBarSwizzled_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_FooToBarSwizzled_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_FooToBarSwizzled_Verification.sv"\n`ifndef layers_FooToBarSwizzled_Verification_Assume\n`define layers_FooToBarSwizzled_Verification_Assume\t// <stdin>:5:5\n`endif // layers_FooToBarSwizzled_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_FooToBarSwizzled_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_FooToBarSwizzled_Verification.sv"\n`ifndef layers_FooToBarSwizzled_Verification_Assert\n`define layers_FooToBarSwizzled_Verification_Assert\t// <stdin>:4:5\n`endif // layers_FooToBarSwizzled_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_FooToBarSwizzled_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_FooToBarSwizzled_Verification\n`define layers_FooToBarSwizzled_Verification\t// <stdin>:3:3\n`endif // layers_FooToBarSwizzled_Verification\t// <stdin>:3:3\n'})}),"\n",(0,a.jsx)(n.h3,{id:"dataproduct",children:"DataProduct"}),"\n",(0,a.jsxs)(n.p,{children:[(0,a.jsx)(n.code,{children:"DataProduct"})," is a type class used by ",(0,a.jsx)(n.code,{children:"DataView"}),' to validate the correctness of a user-provided mapping.\nIn order for a type to be "viewable" (ie. the ',(0,a.jsx)(n.code,{children:"Target"})," type of a ",(0,a.jsx)(n.code,{children:"DataView"}),"), it must have an\nimplementation of ",(0,a.jsx)(n.code,{children:"DataProduct"}),"."]}),"\n",(0,a.jsx)(n.p,{children:"For example, say we have some non-Bundle type:"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"// Loosely based on chisel3.util.Counter\nclass MyCounter(val width: Int) {\n  /** Indicates if the Counter is incrementing this cycle */\n  val active = WireDefault(false.B)\n  val value = RegInit(0.U(width.W))\n  def inc(): Unit = {\n    active := true.B\n    value := value + 1.U\n  }\n  def reset(): Unit = {\n    value := 0.U\n  }\n}\n"})}),"\n",(0,a.jsxs)(n.p,{children:["Say we want to view ",(0,a.jsx)(n.code,{children:"MyCounter"})," as a ",(0,a.jsx)(n.code,{children:"Valid[UInt]"}),":"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"import chisel3.util.Valid\nimplicit val counterView = DataView[MyCounter, Valid[UInt]](c => Valid(UInt(c.width.W)), _.value -> _.bits, _.active -> _.valid)\n// error: myView is already defined as value myView\n// implicit val myView = PartialDataView[BundleA, BundleB](_ => new BundleB, _.bar -> _.fizz)\n//              ^^^^^^\n// error: Could not find implicit value for DataView[MdocApp1.this.BundleA, MdocApp1.this.BundleB].\n// Please see https://www.chisel-lang.org/chisel3/docs/explanations/dataview\n//    out := in.viewAs[BundleB]\n//           ^^^^^^^^^^^^^^^^^^\n// error: Could not find implicit value for DataView[MdocApp1.this.BundleA, MdocApp1.this.BundleB].\n// Please see https://www.chisel-lang.org/chisel3/docs/explanations/dataview\n//    out := in.viewAs[BundleB]\n//           ^^^^^^^^^^^^^^^^^^\n// error: Could not find implicit value for DataView[MdocApp1.this.BundleB, MdocApp1.this.BundleA].\n// Please see https://www.chisel-lang.org/chisel3/docs/explanations/dataview\n//    out.viewAs[BundleA] := in\n//    ^^^^^^^^^^^^^^^^^^^\n// error: Could not find implicit value for DataProduct[MdocApp1.this.MyCounter].\n// Please see https://www.chisel-lang.org/chisel3/docs/explanations/dataview#dataproduct\n// implicit val counterView = DataView[MyCounter, Valid[UInt]](c => Valid(UInt(c.width.W)), _.value -> _.bits, _.active -> _.valid)\n//                            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n"})}),"\n",(0,a.jsxs)(n.p,{children:["As you can see, this fails Scala compliation.\nWe need to provide an implementation of ",(0,a.jsx)(n.code,{children:"DataProduct[MyCounter]"})," which provides Chisel a way to access\nthe objects of type ",(0,a.jsx)(n.code,{children:"Data"})," within ",(0,a.jsx)(n.code,{children:"MyCounter"}),":"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'import chisel3.util.Valid\nimplicit val counterProduct = new DataProduct[MyCounter] {\n  // The String part of the tuple is a String path to the object to help in debugging\n  def dataIterator(a: MyCounter, path: String): Iterator[(Data, String)] =\n    List(a.value -> s"$path.value", a.active -> s"$path.active").iterator\n}\n// Now this works\nimplicit val counterView = DataView[MyCounter, Valid[UInt]](c => Valid(UInt(c.width.W)), _.value -> _.bits, _.active -> _.valid)\n'})}),"\n",(0,a.jsxs)(n.p,{children:["Why is this useful?\nThis is how Chisel is able to check for totality as ",(0,a.jsx)(n.a,{href:"#totality-and-partialdataview",children:"described above"}),".\nIn addition to checking if a user has left a field out of the mapping, it also allows Chisel to check\nif the user has included a ",(0,a.jsx)(n.code,{children:"Data"})," in the mapping that isn't actually a part of the ",(0,a.jsx)(n.em,{children:"target"})," nor the\n",(0,a.jsx)(n.em,{children:"view"}),"."]})]})}function u(e={}){const{wrapper:n}={...(0,t.R)(),...e.components};return n?(0,a.jsx)(n,{...e,children:(0,a.jsx)(c,{...e})}):c(e)}},8453:(e,n,i)=>{i.d(n,{R:()=>l,x:()=>o});var a=i(6540);const t={},s=a.createContext(t);function l(e){const n=a.useContext(s);return a.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function o(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(t):e.components||t:l(e.components),a.createElement(s.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/67ffb541.b79017b5.js b/assets/js/67ffb541.b79017b5.js
deleted file mode 100644
index 9e64c11faf..0000000000
--- a/assets/js/67ffb541.b79017b5.js
+++ /dev/null
@@ -1 +0,0 @@
-"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[7132],{6350:(e,n,a)=>{a.r(n),a.d(n,{assets:()=>o,contentTitle:()=>s,default:()=>h,frontMatter:()=>l,metadata:()=>d,toc:()=>r});var i=a(4848),t=a(8453);const l={layout:"docs",title:"DataView",section:"chisel3"},s="DataView",d={id:"explanations/dataview",title:"DataView",description:"New in Chisel 3.5",source:"@site/docs/explanations/dataview.md",sourceDirName:"explanations",slug:"/explanations/dataview",permalink:"/docs/explanations/dataview",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/dataview.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"DataView",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Chisel Data Types",permalink:"/docs/explanations/data-types"},next:{title:"Decoders",permalink:"/docs/explanations/decoder"}},o={},r=[{value:"Introduction",id:"introduction",level:2},{value:"A Motivating Example (AXI4)",id:"a-motivating-example-axi4",level:2},{value:"Other Use Cases",id:"other-use-cases",level:2},{value:"Tuples",id:"tuples",level:3},{value:"Totality and PartialDataView",id:"totality-and-partialdataview",level:2},{value:"Advanced Details",id:"advanced-details",level:2},{value:"Type Classes",id:"type-classes",level:3},{value:"Implicit Resolution",id:"implicit-resolution",level:3},{value:"Implicit Resolution Example",id:"implicit-resolution-example",level:4},{value:"DataProduct",id:"dataproduct",level:3}];function c(e){const n={a:"a",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",h4:"h4",li:"li",ol:"ol",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,t.R)(),...e.components};return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsx)(n.h1,{id:"dataview",children:"DataView"}),"\n",(0,i.jsx)(n.p,{children:(0,i.jsx)(n.em,{children:"New in Chisel 3.5"})}),"\n",(0,i.jsx)(n.h2,{id:"introduction",children:"Introduction"}),"\n",(0,i.jsxs)(n.p,{children:['DataView is a mechanism for "viewing" Scala objects as a subtype of ',(0,i.jsx)(n.code,{children:"chisel3.Data"}),".\nOften, this is useful for viewing one subtype of ",(0,i.jsx)(n.code,{children:"chisel3.Data"}),", as another.\nOne can think about a ",(0,i.jsx)(n.code,{children:"DataView"})," as a mapping from a ",(0,i.jsx)(n.em,{children:"Target"})," type ",(0,i.jsx)(n.code,{children:"T"})," to a ",(0,i.jsx)(n.em,{children:"View"})," type ",(0,i.jsx)(n.code,{children:"V"}),".\nThis is similar to a cast (eg. ",(0,i.jsx)(n.code,{children:".asTypeOf"}),") with a few differences:"]}),"\n",(0,i.jsxs)(n.ol,{children:["\n",(0,i.jsxs)(n.li,{children:["Views are ",(0,i.jsx)(n.em,{children:"connectable"}),"\u2014connections to the view will occur on the target"]}),"\n",(0,i.jsxs)(n.li,{children:["Whereas casts are ",(0,i.jsx)(n.em,{children:"structural"})," (a reinterpretation of the underlying bits), a DataView is a customizable mapping"]}),"\n",(0,i.jsxs)(n.li,{children:["Views can be ",(0,i.jsx)(n.em,{children:"partial"}),"\u2014not every field in the target must be included in the mapping"]}),"\n"]}),"\n",(0,i.jsx)(n.h2,{id:"a-motivating-example-axi4",children:"A Motivating Example (AXI4)"}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.a,{href:"https://en.wikipedia.org/wiki/Advanced_eXtensible_Interface",children:"AXI4"})," is a common interface in digital\ndesign.\nA typical Verilog peripheral using AXI4 will define a write channel as something like:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"module my_module(\n  // Write Channel\n  input        AXI_AWVALID,\n  output       AXI_AWREADY,\n  input [3:0]  AXI_AWID,\n  input [19:0] AXI_AWADDR,\n  input [1:0]  AXI_AWLEN,\n  input [1:0]  AXI_AWSIZE,\n  // ...\n);\n"})}),"\n",(0,i.jsx)(n.p,{children:"This would correspond to the following Chisel Bundle:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class VerilogAXIBundle(val addrWidth: Int) extends Bundle {\n  val AWVALID = Output(Bool())\n  val AWREADY = Input(Bool())\n  val AWID = Output(UInt(4.W))\n  val AWADDR = Output(UInt(addrWidth.W))\n  val AWLEN = Output(UInt(2.W))\n  val AWSIZE = Output(UInt(2.W))\n  // The rest of AW and other AXI channels here\n}\n\n// Instantiated as\nclass my_module extends RawModule {\n  val AXI = IO(new VerilogAXIBundle(20))\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["Expressing something that matches a standard Verilog interface is important when instantiating Verilog\nmodules in a Chisel design as ",(0,i.jsx)(n.code,{children:"BlackBoxes"}),".\nGenerally though, Chisel developers prefer to use composition via utilities like ",(0,i.jsx)(n.code,{children:"Decoupled"})," rather\nthan a flat handling of ",(0,i.jsx)(n.code,{children:"ready"})," and ",(0,i.jsx)(n.code,{children:"valid"}),' as in the above.\nA more "Chisel-y" implementation of this interface might look like:']}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"// Note that both the AW and AR channels look similar and could use the same Bundle definition\nclass AXIAddressChannel(val addrWidth: Int) extends Bundle {\n  val id = UInt(4.W)\n  val addr = UInt(addrWidth.W)\n  val len = UInt(2.W)\n  val size = UInt(2.W)\n  // ...\n}\nimport chisel3.util.Decoupled\n// We can compose the various AXI channels together\nclass AXIBundle(val addrWidth: Int) extends Bundle {\n  val aw = Decoupled(new AXIAddressChannel(addrWidth))\n  // val ar = new AXIAddressChannel\n  // ... Other channels here ...\n}\n// Instantiated as\nclass MyModule extends RawModule {\n  val axi = IO(new AXIBundle(20))\n}\n"})}),"\n",(0,i.jsx)(n.p,{children:"Of course, this would result in very different looking Verilog:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule MyModule(\t// dataview.md:60:33\n  input         axi_aw_ready,\t// dataview.md:53:15\n  output        axi_aw_valid,\t// dataview.md:53:15\n  output [3:0]  axi_aw_bits_id,\t// dataview.md:53:15\n  output [19:0] axi_aw_bits_addr,\t// dataview.md:53:15\n  output [1:0]  axi_aw_bits_len,\t// dataview.md:53:15\n                axi_aw_bits_size\t// dataview.md:53:15\n);\n\n  assign axi_aw_valid = 1'h0;\t// dataview.md:60:33\n  assign axi_aw_bits_id = 4'h0;\t// dataview.md:60:33\n  assign axi_aw_bits_addr = 20'h0;\t// dataview.md:60:33\n  assign axi_aw_bits_len = 2'h0;\t// dataview.md:60:33\n  assign axi_aw_bits_size = 2'h0;\t// dataview.md:60:33\nendmodule\n\n"})}),"\n",(0,i.jsx)(n.p,{children:"So how can we use our more structured types while maintaining expected Verilog interfaces?\nMeet DataView:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3.experimental.dataview._\n\n// We recommend putting DataViews in a companion object of one of the involved types\nobject AXIBundle {\n  // Don't be afraid of the use of implicits, we will discuss this pattern in more detail later\n  implicit val axiView = DataView[VerilogAXIBundle, AXIBundle](\n    // The first argument is a function constructing an object of View type (AXIBundle)\n    // from an object of the Target type (VerilogAXIBundle)\n    vab => new AXIBundle(vab.addrWidth),\n    // The remaining arguments are a mapping of the corresponding fields of the two types\n    _.AWVALID -> _.aw.valid,\n    _.AWREADY -> _.aw.ready,\n    _.AWID -> _.aw.bits.id,\n    _.AWADDR -> _.aw.bits.addr,\n    _.AWLEN -> _.aw.bits.len,\n    _.AWSIZE -> _.aw.bits.size,\n    // ...\n  )\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["This ",(0,i.jsx)(n.code,{children:"DataView"})," is a mapping between our flat, Verilog-style AXI Bundle to our more compositional,\nChisel-style AXI Bundle.\nIt allows us to define our ports to match the expected Verilog interface, while manipulating it as if\nit were the more structured type:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class AXIStub extends RawModule {\n  val AXI = IO(new VerilogAXIBundle(20))\n  val view = AXI.viewAs[AXIBundle]\n\n  // We can now manipulate `AXI` via `view`\n  view.aw.bits := 0.U.asTypeOf(new AXIAddressChannel(20)) // zero everything out by default\n  view.aw.valid := true.B\n  when (view.aw.ready) {\n    view.aw.bits.id := 5.U\n    view.aw.bits.addr := 1234.U\n    // We can still manipulate AXI as well\n    AXI.AWLEN := 1.U\n  }\n}\n"})}),"\n",(0,i.jsx)(n.p,{children:"This will generate Verilog that matches the standard naming convention:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule AXIStub(\t// dataview.md:93:7\n  output        AXI_AWVALID,\t// dataview.md:94:15\n  input         AXI_AWREADY,\t// dataview.md:94:15\n  output [3:0]  AXI_AWID,\t// dataview.md:94:15\n  output [19:0] AXI_AWADDR,\t// dataview.md:94:15\n  output [1:0]  AXI_AWLEN,\t// dataview.md:94:15\n                AXI_AWSIZE\t// dataview.md:94:15\n);\n\n  assign AXI_AWVALID = 1'h1;\t// dataview.md:93:7\n  assign AXI_AWID = AXI_AWREADY ? 4'h5 : 4'h0;\t// dataview.md:93:7, :98:16, :100:24, :101:21\n  assign AXI_AWADDR = AXI_AWREADY ? 20'h4D2 : 20'h0;\t// dataview.md:93:7, :98:16, :100:24, :102:23\n  assign AXI_AWLEN = {1'h0, AXI_AWREADY};\t// dataview.md:93:7, :98:16, :100:24, :104:15\n  assign AXI_AWSIZE = 2'h0;\t// dataview.md:93:7\nendmodule\n\n"})}),"\n",(0,i.jsxs)(n.p,{children:["Note that if both the ",(0,i.jsx)(n.em,{children:"Target"})," and the ",(0,i.jsx)(n.em,{children:"View"})," types are subtypes of ",(0,i.jsx)(n.code,{children:"Data"})," (as they are in this example),\nthe ",(0,i.jsx)(n.code,{children:"DataView"})," is ",(0,i.jsx)(n.em,{children:"invertible"}),".\nThis means that we can easily create a ",(0,i.jsx)(n.code,{children:"DataView[AXIBundle, VerilogAXIBundle]"})," from our existing\n",(0,i.jsx)(n.code,{children:"DataView[VerilogAXIBundle, AXIBundle]"}),", all we need to do is provide a function to construct\na ",(0,i.jsx)(n.code,{children:"VerilogAXIBundle"})," from an instance of an ",(0,i.jsx)(n.code,{children:"AXIBundle"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"// Note that typically you should define these together (eg. inside object AXIBundle)\nimplicit val axiView2 = AXIBundle.axiView.invert(ab => new VerilogAXIBundle(ab.addrWidth))\n"})}),"\n",(0,i.jsxs)(n.p,{children:["The following example shows this and illustrates another use case of ",(0,i.jsx)(n.code,{children:"DataView"}),"\u2014connecting unrelated\ntypes:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class ConnectionExample extends RawModule {\n  val in = IO(new AXIBundle(20))\n  val out = IO(Flipped(new VerilogAXIBundle(20)))\n  out.viewAs[AXIBundle] <> in\n}\n"})}),"\n",(0,i.jsx)(n.p,{children:"This results in the corresponding fields being connected in the emitted Verilog:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule ConnectionExample(\t// dataview.md:124:7\n  input         in_aw_ready,\t// dataview.md:125:14\n  output        in_aw_valid,\t// dataview.md:125:14\n  output [3:0]  in_aw_bits_id,\t// dataview.md:125:14\n  output [19:0] in_aw_bits_addr,\t// dataview.md:125:14\n  output [1:0]  in_aw_bits_len,\t// dataview.md:125:14\n                in_aw_bits_size,\t// dataview.md:125:14\n  input         out_AWVALID,\t// dataview.md:126:15\n  output        out_AWREADY,\t// dataview.md:126:15\n  input  [3:0]  out_AWID,\t// dataview.md:126:15\n  input  [19:0] out_AWADDR,\t// dataview.md:126:15\n  input  [1:0]  out_AWLEN,\t// dataview.md:126:15\n                out_AWSIZE\t// dataview.md:126:15\n);\n\n  assign in_aw_valid = out_AWVALID;\t// dataview.md:124:7\n  assign in_aw_bits_id = out_AWID;\t// dataview.md:124:7\n  assign in_aw_bits_addr = out_AWADDR;\t// dataview.md:124:7\n  assign in_aw_bits_len = out_AWLEN;\t// dataview.md:124:7\n  assign in_aw_bits_size = out_AWSIZE;\t// dataview.md:124:7\n  assign out_AWREADY = in_aw_ready;\t// dataview.md:124:7\nendmodule\n\n"})}),"\n",(0,i.jsx)(n.h2,{id:"other-use-cases",children:"Other Use Cases"}),"\n",(0,i.jsxs)(n.p,{children:["While the ability to map between ",(0,i.jsx)(n.code,{children:"Bundle"})," types as in the AXI4 example is pretty compelling,\nDataView has many other applications.\nImportantly, because the ",(0,i.jsx)(n.em,{children:"Target"})," of the ",(0,i.jsx)(n.code,{children:"DataView"})," need not be a ",(0,i.jsx)(n.code,{children:"Data"}),", it provides a way to use\n",(0,i.jsx)(n.code,{children:"non-Data"})," objects with APIs that require ",(0,i.jsx)(n.code,{children:"Data"}),"."]}),"\n",(0,i.jsx)(n.h3,{id:"tuples",children:"Tuples"}),"\n",(0,i.jsxs)(n.p,{children:["Perhaps the most helpful use of ",(0,i.jsx)(n.code,{children:"DataView"})," for a non-",(0,i.jsx)(n.code,{children:"Data"})," type is viewing Scala tuples as ",(0,i.jsx)(n.code,{children:"Bundles"}),".\nFor example, in Chisel prior to the introduction of ",(0,i.jsx)(n.code,{children:"DataView"}),", one might try to ",(0,i.jsx)(n.code,{children:"Mux"})," tuples and\nsee an error like the following:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class TupleExample extends RawModule {\n  val a, b, c, d = IO(Input(UInt(8.W)))\n  val cond = IO(Input(Bool()))\n  val x, y = IO(Output(UInt(8.W)))\n  (x, y) := Mux(cond, (a, b), (c, d))\n}\n// error: value := is not a member of (chisel3.UInt, chisel3.UInt)\n//   Expression does not convert to assignment because receiver is not assignable.\n//   (x, y) := Mux(cond, (a, b), (c, d))\n//   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n// error: inferred type arguments [(chisel3.UInt, chisel3.UInt)] do not conform to macro method apply's type parameter bounds [T <: chisel3.Data]\n//   (x, y) := Mux(cond, (a, b), (c, d))\n//             ^^^\n// error: type mismatch;\n//  found   : (chisel3.UInt, chisel3.UInt)\n//  required: T\n//   (x, y) := Mux(cond, (a, b), (c, d))\n//                       ^^^^^^\n// error: type mismatch;\n//  found   : (chisel3.UInt, chisel3.UInt)\n//  required: T\n//   (x, y) := Mux(cond, (a, b), (c, d))\n//                               ^^^^^^\n"})}),"\n",(0,i.jsxs)(n.p,{children:["The issue, is that Chisel primitives like ",(0,i.jsx)(n.code,{children:"Mux"})," and ",(0,i.jsx)(n.code,{children:":="})," only operate on subtypes of ",(0,i.jsx)(n.code,{children:"Data"})," and\nTuples (as members of the Scala standard library), are not subclasses of ",(0,i.jsx)(n.code,{children:"Data"}),".\n",(0,i.jsx)(n.code,{children:"DataView"})," provides a mechanism to ",(0,i.jsx)(n.em,{children:"view"})," a ",(0,i.jsx)(n.code,{children:"Tuple"})," as if it were a ",(0,i.jsx)(n.code,{children:"Data"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"// We need a type to represent the Tuple\nclass HWTuple2[A <: Data, B <: Data](val _1: A, val _2: B) extends Bundle\n\n// Provide DataView between Tuple and HWTuple\nimplicit def view[A <: Data, B <: Data]: DataView[(A, B), HWTuple2[A, B]] =\n  DataView(tup => new HWTuple2(tup._1.cloneType, tup._2.cloneType),\n           _._1 -> _._1, _._2 -> _._2)\n"})}),"\n",(0,i.jsxs)(n.p,{children:["Now, we can use ",(0,i.jsx)(n.code,{children:".viewAs"})," to view Tuples as if they were subtypes of ",(0,i.jsx)(n.code,{children:"Data"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class TupleVerboseExample extends RawModule {\n  val a, b, c, d = IO(Input(UInt(8.W)))\n  val cond = IO(Input(Bool()))\n  val x, y = IO(Output(UInt(8.W)))\n  (x, y).viewAs[HWTuple2[UInt, UInt]] := Mux(cond, (a, b).viewAs[HWTuple2[UInt, UInt]], (c, d).viewAs[HWTuple2[UInt, UInt]])\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["This is much more verbose than the original idea of just using the Tuples directly as if they were ",(0,i.jsx)(n.code,{children:"Data"}),".\nWe can make this better by providing an implicit conversion that views a ",(0,i.jsx)(n.code,{children:"Tuple"})," as a ",(0,i.jsx)(n.code,{children:"HWTuple2"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"implicit def tuple2hwtuple[A <: Data, B <: Data](tup: (A, B)): HWTuple2[A, B] =\n  tup.viewAs[HWTuple2[A, B]]\n"})}),"\n",(0,i.jsx)(n.p,{children:"Now, the original code just works!"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class TupleExample extends RawModule {\n  val a, b, c, d = IO(Input(UInt(8.W)))\n  val cond = IO(Input(Bool()))\n  val x, y = IO(Output(UInt(8.W)))\n  (x, y) := Mux(cond, (a, b), (c, d))\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["Note that this example ignored ",(0,i.jsx)(n.code,{children:"DataProduct"})," which is another required piece (see ",(0,i.jsx)(n.a,{href:"#dataproduct",children:"the documentation\nabout it below"}),")."]}),"\n",(0,i.jsx)(n.p,{children:"All of this is available to users via a single import:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3.experimental.conversions._\n"})}),"\n",(0,i.jsx)(n.h2,{id:"totality-and-partialdataview",children:"Totality and PartialDataView"}),"\n",(0,i.jsxs)(n.p,{children:["A ",(0,i.jsx)(n.code,{children:"DataView"})," is ",(0,i.jsx)(n.em,{children:"total"})," if all fields of the ",(0,i.jsx)(n.em,{children:"Target"})," type and all fields of the ",(0,i.jsx)(n.em,{children:"View"})," type are\nincluded in the mapping.\nChisel will error if a field is accidentally left out from a ",(0,i.jsx)(n.code,{children:"DataView"}),".\nFor example:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class BundleA extends Bundle {\n  val foo = UInt(8.W)\n  val bar = UInt(8.W)\n}\nclass BundleB extends Bundle {\n  val fizz = UInt(8.W)\n}\n"})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"// We forgot BundleA.foo in the mapping!\nimplicit val myView = DataView[BundleA, BundleB](_ => new BundleB, _.bar -> _.fizz)\nclass BadMapping extends Module {\n   val in = IO(Input(new BundleA))\n   val out = IO(Output(new BundleB))\n   out := in.viewAs[BundleB]\n}\n// We must run Chisel to see the error\ngetVerilogString(new BadMapping)\n// chisel3.experimental.dataview.package$InvalidViewException: Viewing BadMapping.in: IO[BundleA] as BundleB is non-Total!\n//   Target field '_.foo' is missing.\n//   DataView used is DataView(defined @[dataview.md:228:49]).\n//   If the view *should* be non-total, try a 'PartialDataView'.\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp6$$anonfun$55$BadMapping$1$$anonfun$60.apply(dataview.md:232)\n// \tat repl.MdocSession$MdocApp6$$anonfun$55$BadMapping$1$$anonfun$60.apply(dataview.md:232)\n// \tat chisel3.Data.$anonfun$$colon$eq$1(Data.scala:806)\n// \tat scala.runtime.java8.JFunction0$mcV$sp.apply(JFunction0$mcV$sp.scala:18)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:33)\n// \tat chisel3.Data.$colon$eq(Data.scala:806)\n// \tat repl.MdocSession$MdocApp6$$anonfun$55$BadMapping$1.<init>(dataview.md:232)\n// \tat repl.MdocSession$MdocApp6$$anonfun$55$$anonfun$apply$67.apply(dataview.md:234)\n// \tat repl.MdocSession$MdocApp6$$anonfun$55$$anonfun$apply$67.apply(dataview.md:234)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,i.jsxs)(n.p,{children:["As that error suggests, if we ",(0,i.jsx)(n.em,{children:"want"})," the view to be non-total, we can use a ",(0,i.jsx)(n.code,{children:"PartialDataView"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"// A PartialDataView does not have to be total for the Target\nimplicit val myView = PartialDataView[BundleA, BundleB](_ => new BundleB, _.bar -> _.fizz)\n// myView: DataView[BundleA, BundleB] = PartialDataView(defined @[dataview.md:243:56])\nclass PartialDataViewModule extends Module {\n   val in = IO(Input(new BundleA))\n   val out = IO(Output(new BundleB))\n   out := in.viewAs[BundleB]\n}\n"})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule PartialDataViewModule(\t// dataview.md:246:7\n  input        clock,\t// dataview.md:246:7\n               reset,\t// dataview.md:246:7\n  input  [7:0] in_foo,\t// dataview.md:247:15\n               in_bar,\t// dataview.md:247:15\n  output [7:0] out_fizz\t// dataview.md:248:16\n);\n\n  assign out_fizz = in_bar;\t// dataview.md:246:7\nendmodule\n\n"})}),"\n",(0,i.jsxs)(n.p,{children:["While ",(0,i.jsx)(n.code,{children:"PartialDataViews"})," need not be total for the ",(0,i.jsx)(n.em,{children:"Target"}),", both ",(0,i.jsx)(n.code,{children:"PartialDataViews"})," and ",(0,i.jsx)(n.code,{children:"DataViews"}),"\nmust always be total for the ",(0,i.jsx)(n.em,{children:"View"}),".\nThis has the consequence that ",(0,i.jsx)(n.code,{children:"PartialDataViews"})," are ",(0,i.jsx)(n.strong,{children:"not"})," invertible in the same way as ",(0,i.jsx)(n.code,{children:"DataViews"}),"."]}),"\n",(0,i.jsx)(n.p,{children:"For example:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"implicit val myView2 = myView.invert(_ => new BundleA)\nclass PartialDataViewModule2 extends Module {\n   val in = IO(Input(new BundleA))\n   val out = IO(Output(new BundleB))\n   // Using the inverted version of the mapping\n   out.viewAs[BundleA] := in\n}\n// We must run Chisel to see the error\ngetVerilogString(new PartialDataViewModule2)\n// chisel3.experimental.dataview.package$InvalidViewException: Cannot invert 'PartialDataView(defined @[dataview.md:243:56])' as it is non-total.\n//   Try providing a DataView[MdocApp6.this.BundleB, MdocApp6.this.BundleA].\n//   Please see https://www.chisel-lang.org/chisel3/docs/explanations/dataview.\n// \tat chisel3.experimental.dataview.DataView$InvertibleDataView.invert(DataView.scala:136)\n// \tat repl.MdocSession$MdocApp6$$anonfun$67.apply(dataview.md:263)\n// \tat repl.MdocSession$MdocApp6$$anonfun$67.apply(dataview.md:262)\n"})}),"\n",(0,i.jsxs)(n.p,{children:["As noted, the mapping must ",(0,i.jsx)(n.strong,{children:"always"})," be total for the ",(0,i.jsx)(n.code,{children:"View"}),"."]}),"\n",(0,i.jsx)(n.h2,{id:"advanced-details",children:"Advanced Details"}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.code,{children:"DataView"})," takes advantage of features of Scala that may be new to many users of Chisel\u2014in particular\n",(0,i.jsx)(n.a,{href:"#type-classes",children:"Type Classes"}),"."]}),"\n",(0,i.jsx)(n.h3,{id:"type-classes",children:"Type Classes"}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.a,{href:"https://en.wikipedia.org/wiki/Type_class",children:"Type classes"}),' are powerful language feature for writing\npolymorphic code.\nThey are a common feature in "modern programming languages" like\nScala,\nSwift (see ',(0,i.jsx)(n.a,{href:"https://docs.swift.org/swift-book/LanguageGuide/Protocols.html",children:"protocols"}),"),\nand Rust (see ",(0,i.jsx)(n.a,{href:"https://doc.rust-lang.org/book/ch10-02-traits.html",children:"traits"}),").\nType classes may appear similar to inheritance in object-oriented programming but there are some\nimportant  differences:"]}),"\n",(0,i.jsxs)(n.ol,{children:["\n",(0,i.jsx)(n.li,{children:"You can provide a type class for a type you don't own (eg. one defined in a 3rd party library,\nthe Scala standard library, or Chisel itself)"}),"\n",(0,i.jsx)(n.li,{children:"You can write a single type class for many types that do not have a sub-typing relationship"}),"\n",(0,i.jsx)(n.li,{children:"You can provide multiple different type classes for the same type"}),"\n"]}),"\n",(0,i.jsxs)(n.p,{children:["For ",(0,i.jsx)(n.code,{children:"DataView"}),", (1) is crucial because we want to be able to implement ",(0,i.jsx)(n.code,{children:"DataViews"})," of built-in Scala\ntypes like tuples and ",(0,i.jsx)(n.code,{children:"Seqs"}),". Furthermore, ",(0,i.jsx)(n.code,{children:"DataView"})," has two type parameters (the ",(0,i.jsx)(n.em,{children:"Target"})," and the\n",(0,i.jsx)(n.em,{children:"View"})," types) so inheritance does not really make sense\u2014which type would ",(0,i.jsx)(n.code,{children:"extend"})," ",(0,i.jsx)(n.code,{children:"DataView"}),"?"]}),"\n",(0,i.jsx)(n.p,{children:"In Scala 2, type classes are not a built-in language feature, but rather are implemented using implicits.\nThere are great resources out there for interested readers:"}),"\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsx)(n.li,{children:(0,i.jsx)(n.a,{href:"https://scalac.io/blog/typeclasses-in-scala/",children:"Basic Tutorial"})}),"\n",(0,i.jsx)(n.li,{children:(0,i.jsx)(n.a,{href:"https://stackoverflow.com/a/5598107/2483329",children:"Fantastic Explanation on StackOverflow"})}),"\n"]}),"\n",(0,i.jsx)(n.p,{children:"Note that Scala 3 has added built-in syntax for type classes that does not apply to Chisel 3 which\ncurrently only supports Scala 2."}),"\n",(0,i.jsx)(n.h3,{id:"implicit-resolution",children:"Implicit Resolution"}),"\n",(0,i.jsxs)(n.p,{children:["Given that ",(0,i.jsx)(n.code,{children:"DataView"})," is implemented using implicits, it is important to understand implicit\nresolution.\nWhenever the compiler sees an implicit argument is required, it first looks in ",(0,i.jsx)(n.em,{children:"current scope"}),"\nbefore looking in the ",(0,i.jsx)(n.em,{children:"implicit scope"}),"."]}),"\n",(0,i.jsxs)(n.ol,{children:["\n",(0,i.jsxs)(n.li,{children:["Current scope","\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsx)(n.li,{children:"Values defined in the current scope"}),"\n",(0,i.jsx)(n.li,{children:"Explicit imports"}),"\n",(0,i.jsx)(n.li,{children:"Wildcard imports"}),"\n"]}),"\n"]}),"\n",(0,i.jsxs)(n.li,{children:["Implicit scope","\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsx)(n.li,{children:"Companion object of a type"}),"\n",(0,i.jsx)(n.li,{children:"Implicit scope of an argument's type"}),"\n",(0,i.jsx)(n.li,{children:"Implicit scope of type parameters"}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,i.jsx)(n.p,{children:"If at either stage, multiple implicits are found, then the static overloading rule is used to resolve\nit.\nPut simply, if one implicit applies to a more-specific type than the other, the more-specific one\nwill be selected.\nIf multiple implicits apply within a given stage, then the compiler throws an ambiguous implicit\nresolution error."}),"\n",(0,i.jsxs)(n.p,{children:["This section draws heavily from ",(0,i.jsx)(n.a,{href:"https://stackoverflow.com/a/5598107/2483329",children:"[1]"})," and\n",(0,i.jsx)(n.a,{href:"https://stackoverflow.com/a/8694558/2483329",children:"[2]"}),".\nIn particular, see [1] for examples."]}),"\n",(0,i.jsx)(n.h4,{id:"implicit-resolution-example",children:"Implicit Resolution Example"}),"\n",(0,i.jsxs)(n.p,{children:["To help clarify a bit, let us consider how implicit resolution works for ",(0,i.jsx)(n.code,{children:"DataView"}),".\nConsider the definition of ",(0,i.jsx)(n.code,{children:"viewAs"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"def viewAs[V <: Data](implicit dataView: DataView[T, V]): V\n"})}),"\n",(0,i.jsxs)(n.p,{children:["Armed with the knowledge from the previous section, we know that whenever we call ",(0,i.jsx)(n.code,{children:".viewAs"}),", the\nScala compiler will first look for a ",(0,i.jsx)(n.code,{children:"DataView[T, V]"})," in the current scope (defined in, or imported),\nthen it will look in the companion objects of ",(0,i.jsx)(n.code,{children:"DataView"}),", ",(0,i.jsx)(n.code,{children:"T"}),", and ",(0,i.jsx)(n.code,{children:"V"}),".\nThis enables a fairly powerful pattern, namely that default or typical implementations of a ",(0,i.jsx)(n.code,{children:"DataView"}),"\nshould be defined in the companion object for one of the two types.\nWe can think about ",(0,i.jsx)(n.code,{children:"DataViews"}),' defined in this way as "low priority defaults".\nThey can then be overruled by a specific import if a given user ever wants different behavior.\nFor example:']}),"\n",(0,i.jsx)(n.p,{children:"Given the following types:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class Foo extends Bundle {\n  val a = UInt(8.W)\n  val b = UInt(8.W)\n}\nclass Bar extends Bundle {\n  val c = UInt(8.W)\n  val d = UInt(8.W)\n}\nobject Foo {\n  implicit val f2b = DataView[Foo, Bar](_ => new Bar, _.a -> _.c, _.b -> _.d)\n  implicit val b2f = f2b.invert(_ => new Foo)\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["This provides an implementation of ",(0,i.jsx)(n.code,{children:"DataView"})," in the ",(0,i.jsx)(n.em,{children:"implicit scope"}),' as a "default" mapping between\n',(0,i.jsx)(n.code,{children:"Foo"})," and ",(0,i.jsx)(n.code,{children:"Bar"})," (and it doesn't even require an import!):"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class FooToBar extends Module {\n  val foo = IO(Input(new Foo))\n  val bar = IO(Output(new Bar))\n  bar := foo.viewAs[Bar]\n}\n"})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule FooToBar(\t// dataview.md:300:7\n  input        clock,\t// dataview.md:300:7\n               reset,\t// dataview.md:300:7\n  input  [7:0] foo_a,\t// dataview.md:301:15\n               foo_b,\t// dataview.md:301:15\n  output [7:0] bar_c,\t// dataview.md:302:15\n               bar_d\t// dataview.md:302:15\n);\n\n  assign bar_c = foo_a;\t// dataview.md:300:7\n  assign bar_d = foo_b;\t// dataview.md:300:7\nendmodule\n\n"})}),"\n",(0,i.jsxs)(n.p,{children:["However, it's possible that some user of ",(0,i.jsx)(n.code,{children:"Foo"})," and ",(0,i.jsx)(n.code,{children:"Bar"}),' wants different behavior,\nperhaps they would prefer more of "swizzling" behavior rather than a direct mapping:']}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"object Swizzle {\n  implicit val swizzle = DataView[Foo, Bar](_ => new Bar, _.a -> _.d, _.b -> _.c)\n}\n// Current scope always wins over implicit scope\nimport Swizzle._\nclass FooToBarSwizzled extends Module {\n  val foo = IO(Input(new Foo))\n  val bar = IO(Output(new Bar))\n  bar := foo.viewAs[Bar]\n}\n"})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule FooToBarSwizzled(\t// dataview.md:324:7\n  input        clock,\t// dataview.md:324:7\n               reset,\t// dataview.md:324:7\n  input  [7:0] foo_a,\t// dataview.md:325:15\n               foo_b,\t// dataview.md:325:15\n  output [7:0] bar_c,\t// dataview.md:326:15\n               bar_d\t// dataview.md:326:15\n);\n\n  assign bar_c = foo_b;\t// dataview.md:324:7\n  assign bar_d = foo_a;\t// dataview.md:324:7\nendmodule\n\n"})}),"\n",(0,i.jsx)(n.h3,{id:"dataproduct",children:"DataProduct"}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.code,{children:"DataProduct"})," is a type class used by ",(0,i.jsx)(n.code,{children:"DataView"}),' to validate the correctness of a user-provided mapping.\nIn order for a type to be "viewable" (ie. the ',(0,i.jsx)(n.code,{children:"Target"})," type of a ",(0,i.jsx)(n.code,{children:"DataView"}),"), it must have an\nimplementation of ",(0,i.jsx)(n.code,{children:"DataProduct"}),"."]}),"\n",(0,i.jsx)(n.p,{children:"For example, say we have some non-Bundle type:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"// Loosely based on chisel3.util.Counter\nclass MyCounter(val width: Int) {\n  /** Indicates if the Counter is incrementing this cycle */\n  val active = WireDefault(false.B)\n  val value = RegInit(0.U(width.W))\n  def inc(): Unit = {\n    active := true.B\n    value := value + 1.U\n  }\n  def reset(): Unit = {\n    value := 0.U\n  }\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["Say we want to view ",(0,i.jsx)(n.code,{children:"MyCounter"})," as a ",(0,i.jsx)(n.code,{children:"Valid[UInt]"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3.util.Valid\nimplicit val counterView = DataView[MyCounter, Valid[UInt]](c => Valid(UInt(c.width.W)), _.value -> _.bits, _.active -> _.valid)\n// error: myView is already defined as value myView\n// implicit val myView = PartialDataView[BundleA, BundleB](_ => new BundleB, _.bar -> _.fizz)\n//              ^^^^^^\n// error: Could not find implicit value for DataView[MdocApp1.this.BundleA, MdocApp1.this.BundleB].\n// Please see https://www.chisel-lang.org/chisel3/docs/explanations/dataview\n//    out := in.viewAs[BundleB]\n//           ^^^^^^^^^^^^^^^^^^\n// error: Could not find implicit value for DataView[MdocApp1.this.BundleA, MdocApp1.this.BundleB].\n// Please see https://www.chisel-lang.org/chisel3/docs/explanations/dataview\n//    out := in.viewAs[BundleB]\n//           ^^^^^^^^^^^^^^^^^^\n// error: Could not find implicit value for DataView[MdocApp1.this.BundleB, MdocApp1.this.BundleA].\n// Please see https://www.chisel-lang.org/chisel3/docs/explanations/dataview\n//    out.viewAs[BundleA] := in\n//    ^^^^^^^^^^^^^^^^^^^\n// error: Could not find implicit value for DataProduct[MdocApp1.this.MyCounter].\n// Please see https://www.chisel-lang.org/chisel3/docs/explanations/dataview#dataproduct\n// implicit val counterView = DataView[MyCounter, Valid[UInt]](c => Valid(UInt(c.width.W)), _.value -> _.bits, _.active -> _.valid)\n//                            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n"})}),"\n",(0,i.jsxs)(n.p,{children:["As you can see, this fails Scala compliation.\nWe need to provide an implementation of ",(0,i.jsx)(n.code,{children:"DataProduct[MyCounter]"})," which provides Chisel a way to access\nthe objects of type ",(0,i.jsx)(n.code,{children:"Data"})," within ",(0,i.jsx)(n.code,{children:"MyCounter"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'import chisel3.util.Valid\nimplicit val counterProduct = new DataProduct[MyCounter] {\n  // The String part of the tuple is a String path to the object to help in debugging\n  def dataIterator(a: MyCounter, path: String): Iterator[(Data, String)] =\n    List(a.value -> s"$path.value", a.active -> s"$path.active").iterator\n}\n// Now this works\nimplicit val counterView = DataView[MyCounter, Valid[UInt]](c => Valid(UInt(c.width.W)), _.value -> _.bits, _.active -> _.valid)\n'})}),"\n",(0,i.jsxs)(n.p,{children:["Why is this useful?\nThis is how Chisel is able to check for totality as ",(0,i.jsx)(n.a,{href:"#totality-and-partialdataview",children:"described above"}),".\nIn addition to checking if a user has left a field out of the mapping, it also allows Chisel to check\nif the user has included a ",(0,i.jsx)(n.code,{children:"Data"})," in the mapping that isn't actually a part of the ",(0,i.jsx)(n.em,{children:"target"})," nor the\n",(0,i.jsx)(n.em,{children:"view"}),"."]})]})}function h(e={}){const{wrapper:n}={...(0,t.R)(),...e.components};return n?(0,i.jsx)(n,{...e,children:(0,i.jsx)(c,{...e})}):c(e)}},8453:(e,n,a)=>{a.d(n,{R:()=>s,x:()=>d});var i=a(6540);const t={},l=i.createContext(t);function s(e){const n=i.useContext(l);return i.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function d(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(t):e.components||t:s(e.components),i.createElement(l.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/7b5bfa87.18f8af79.js b/assets/js/7b5bfa87.eff9fa5b.js
similarity index 73%
rename from assets/js/7b5bfa87.18f8af79.js
rename to assets/js/7b5bfa87.eff9fa5b.js
index 229d815f8f..6d9edda911 100644
--- a/assets/js/7b5bfa87.18f8af79.js
+++ b/assets/js/7b5bfa87.eff9fa5b.js
@@ -1 +1 @@
-"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[2785],{924:(a,e,n)=>{n.r(e),n.d(e,{assets:()=>i,contentTitle:()=>c,default:()=>$,frontMatter:()=>s,metadata:()=>o,toc:()=>r});var l=n(4848),t=n(8453);const s={layout:"docs",title:"Chisel Type vs Scala Type",section:"chisel3"},c="Chisel Type vs Scala Type",o={id:"explanations/chisel-type-vs-scala-type",title:"Chisel Type vs Scala Type",description:"The Scala compiler cannot distinguish between Chisel's representation of hardware such as false.B, Reg(Bool())",source:"@site/docs/explanations/chisel-type-vs-scala-type.md",sourceDirName:"explanations",slug:"/explanations/chisel-type-vs-scala-type",permalink:"/docs/explanations/chisel-type-vs-scala-type",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/chisel-type-vs-scala-type.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Chisel Type vs Scala Type",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Enumerations",permalink:"/docs/explanations/chisel-enum"},next:{title:"Combinational Circuits",permalink:"/docs/explanations/combinational-circuits"}},i={},r=[{value:"Scala Type vs Chisel Type vs Hardware",id:"scala-type-vs-chisel-type-vs-hardware",level:2},{value:"Chisel Type vs Hardware vs Literals",id:"chisel-type-vs-hardware-vs-literals",level:2},{value:"Chisel Type vs Hardware -- Specific Functions and Errors",id:"chisel-type-vs-hardware----specific-functions-and-errors",level:2},{value:"<code>.asInstanceOf</code> vs <code>.asTypeOf</code> vs <code>chiselTypeOf</code>",id:"asinstanceof-vs-astypeof-vs-chiseltypeof",level:2}];function p(a){const e={a:"a",code:"code",em:"em",h1:"h1",h2:"h2",p:"p",pre:"pre",...(0,t.R)(),...a.components};return(0,l.jsxs)(l.Fragment,{children:[(0,l.jsx)(e.h1,{id:"chisel-type-vs-scala-type",children:"Chisel Type vs Scala Type"}),"\n",(0,l.jsxs)(e.p,{children:["The Scala compiler cannot distinguish between Chisel's representation of hardware such as ",(0,l.jsx)(e.code,{children:"false.B"}),", ",(0,l.jsx)(e.code,{children:"Reg(Bool())"}),"\nand pure Chisel types (e.g. ",(0,l.jsx)(e.code,{children:"Bool()"}),"). You can get runtime errors passing a Chisel type when hardware is expected, and vice versa."]}),"\n",(0,l.jsx)(e.h2,{id:"scala-type-vs-chisel-type-vs-hardware",children:"Scala Type vs Chisel Type vs Hardware"}),"\n",(0,l.jsxs)(e.p,{children:["The ",(0,l.jsx)(e.em,{children:"Scala"})," type of the Data is recognized by the Scala compiler, such as ",(0,l.jsx)(e.code,{children:"Bool"}),", ",(0,l.jsx)(e.code,{children:"Decoupled[UInt]"})," or ",(0,l.jsx)(e.code,{children:"MyBundle"})," in"]}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"class MyBundle(w: Int) extends Bundle {\n  val foo = UInt(w.W)\n  val bar = UInt(w.W)\n}\n"})}),"\n",(0,l.jsxs)(e.p,{children:["The ",(0,l.jsx)(e.em,{children:"Chisel"})," type of a ",(0,l.jsx)(e.code,{children:"Data"})," is a Scala object. It captures all the fields actually present,\nby names, and their types including widths.\nFor example, ",(0,l.jsx)(e.code,{children:"MyBundle(3)"})," creates a Chisel Type with fields ",(0,l.jsx)(e.code,{children:"foo: UInt(3.W),  bar: UInt(3.W))"}),"."]}),"\n",(0,l.jsxs)(e.p,{children:["Hardware is ",(0,l.jsx)(e.code,{children:"Data"}),' that is "bound" to synthesizable hardware. For example ',(0,l.jsx)(e.code,{children:"false.B"})," or ",(0,l.jsx)(e.code,{children:"Reg(Bool())"}),".\nThe binding is what determines the actual directionality of each field, it is not a property of the Chisel type."]}),"\n",(0,l.jsxs)(e.p,{children:["A literal is a ",(0,l.jsx)(e.code,{children:"Data"})," that is respresentable as a literal value without being wrapped in Wire, Reg, or IO."]}),"\n",(0,l.jsx)(e.h2,{id:"chisel-type-vs-hardware-vs-literals",children:"Chisel Type vs Hardware vs Literals"}),"\n",(0,l.jsxs)(e.p,{children:["The below code demonstrates how objects with the same Scala type (",(0,l.jsx)(e.code,{children:"MyBundle"}),") can have different properties."]}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"import chisel3.experimental.BundleLiterals._\n\nclass MyModule(gen: () => MyBundle) extends Module {\n                                                            //   Hardware   Literal\n    val xType:    MyBundle     = new MyBundle(3)            //      -          -\n    val dirXType: MyBundle     = Input(new MyBundle(3))     //      -          -\n    val xReg:     MyBundle     = Reg(new MyBundle(3))       //      x          -\n    val xIO:      MyBundle     = IO(Input(new MyBundle(3))) //      x          -\n    val xRegInit: MyBundle     = RegInit(xIO)               //      x          -\n    val xLit:     MyBundle     = xType.Lit(                 //      x          x\n      _.foo -> 0.U(3.W),\n      _.bar -> 0.U(3.W)\n    )\n    val y:        MyBundle = gen()                          //      ?          ?\n\n    // Need to initialize all hardware values\n    xReg := DontCare\n}\n"})}),"\n",(0,l.jsx)(e.h2,{id:"chisel-type-vs-hardware----specific-functions-and-errors",children:"Chisel Type vs Hardware -- Specific Functions and Errors"}),"\n",(0,l.jsxs)(e.p,{children:[(0,l.jsx)(e.code,{children:".asTypeOf"})," works for both hardware and Chisel type:"]}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"elaborate(new Module {\n  val chiselType = new MyBundle(3)\n  val hardware = Wire(new MyBundle(3))\n  hardware := DontCare\n  val a = 0.U.asTypeOf(chiselType)\n  val b = 0.U.asTypeOf(hardware)\n})\n"})}),"\n",(0,l.jsxs)(e.p,{children:["Can only ",(0,l.jsx)(e.code,{children:":="})," to hardware:"]}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"// Do this...\nelaborate(new Module {\n  val hardware = Wire(new MyBundle(3))\n  hardware := DontCare\n})\n"})}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"// Not this...\nelaborate(new Module {\n  val chiselType = new MyBundle(3)\n  chiselType := DontCare\n})\n// chisel3.package$ExpectedHardwareException: data to be connected 'MyBundle' must be hardware, not a bare Chisel type. Perhaps you forgot to wrap it in Wire(_) or IO(_)?\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp$$anonfun$21$$anonfun$apply$21$$anon$3.<init>(chisel-type-vs-scala-type.md:90)\n// \tat repl.MdocSession$MdocApp$$anonfun$21$$anonfun$apply$21.apply(chisel-type-vs-scala-type.md:88)\n// \tat repl.MdocSession$MdocApp$$anonfun$21$$anonfun$apply$21.apply(chisel-type-vs-scala-type.md:88)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,l.jsxs)(e.p,{children:["Can only ",(0,l.jsx)(e.code,{children:":="})," from hardware:"]}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"// Do this...\nelaborate(new Module {\n  val hardware = IO(new MyBundle(3))\n  val moarHardware = Wire(new MyBundle(3))\n  moarHardware := DontCare\n  hardware := moarHardware\n})\n"})}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"// Not this...\nelaborate(new Module {\n  val hardware = IO(new MyBundle(3))\n  val chiselType = new MyBundle(3)\n  hardware := chiselType\n})\n// chisel3.package$ExpectedHardwareException: data to be connected 'MyBundle' must be hardware, not a bare Chisel type. Perhaps you forgot to wrap it in Wire(_) or IO(_)?\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp$$anonfun$29$$anonfun$apply$27$$anon$5.<init>(chisel-type-vs-scala-type.md:115)\n// \tat repl.MdocSession$MdocApp$$anonfun$29$$anonfun$apply$27.apply(chisel-type-vs-scala-type.md:112)\n// \tat repl.MdocSession$MdocApp$$anonfun$29$$anonfun$apply$27.apply(chisel-type-vs-scala-type.md:112)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,l.jsxs)(e.p,{children:["Have to pass hardware to ",(0,l.jsx)(e.code,{children:"chiselTypeOf"}),":"]}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"// Do this...\nelaborate(new Module {\n  val hardware = Wire(new MyBundle(3))\n  hardware := DontCare\n  val chiselType = chiselTypeOf(hardware)\n})\n"})}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"// Not this...\nelaborate(new Module {\n  val chiselType = new MyBundle(3)\n  val crash = chiselTypeOf(chiselType)\n})\n// chisel3.package$ExpectedHardwareException: 'MyBundle' must be hardware, not a bare Chisel type. Perhaps you forgot to wrap it in Wire(_) or IO(_)?\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp$$anonfun$37$$anonfun$apply$34$$anon$7$$anonfun$39$$anonfun$apply$36.apply(chisel-type-vs-scala-type.md:138)\n// \tat repl.MdocSession$MdocApp$$anonfun$37$$anonfun$apply$34$$anon$7$$anonfun$39$$anonfun$apply$36.apply(chisel-type-vs-scala-type.md:138)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp$$anonfun$37$$anonfun$apply$34$$anon$7$$anonfun$39.apply(chisel-type-vs-scala-type.md:138)\n// \tat repl.MdocSession$MdocApp$$anonfun$37$$anonfun$apply$34$$anon$7$$anonfun$39.apply(chisel-type-vs-scala-type.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp$$anonfun$37$$anonfun$apply$34$$anon$7.<init>(chisel-type-vs-scala-type.md:138)\n// \tat repl.MdocSession$MdocApp$$anonfun$37$$anonfun$apply$34.apply(chisel-type-vs-scala-type.md:136)\n// \tat repl.MdocSession$MdocApp$$anonfun$37$$anonfun$apply$34.apply(chisel-type-vs-scala-type.md:136)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,l.jsxs)(e.p,{children:["Have to pass hardware to ",(0,l.jsx)(e.code,{children:"*Init"}),":"]}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"// Do this...\nelaborate(new Module {\n  val hardware = Wire(new MyBundle(3))\n  hardware := DontCare\n  val moarHardware = WireInit(hardware)\n})\n"})}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"// Not this...\nelaborate(new Module {\n  val crash = WireInit(new MyBundle(3))\n})\n// chisel3.package$ExpectedHardwareException: wire initializer 'MyBundle' must be hardware, not a bare Chisel type. Perhaps you forgot to wrap it in Wire(_) or IO(_)?\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp$$anonfun$44$$anonfun$apply$40$$anon$9$$anonfun$45$$anonfun$apply$41.apply(chisel-type-vs-scala-type.md:160)\n// \tat repl.MdocSession$MdocApp$$anonfun$44$$anonfun$apply$40$$anon$9$$anonfun$45$$anonfun$apply$41.apply(chisel-type-vs-scala-type.md:160)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp$$anonfun$44$$anonfun$apply$40$$anon$9$$anonfun$45.apply(chisel-type-vs-scala-type.md:160)\n// \tat repl.MdocSession$MdocApp$$anonfun$44$$anonfun$apply$40$$anon$9$$anonfun$45.apply(chisel-type-vs-scala-type.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp$$anonfun$44$$anonfun$apply$40$$anon$9.<init>(chisel-type-vs-scala-type.md:160)\n// \tat repl.MdocSession$MdocApp$$anonfun$44$$anonfun$apply$40.apply(chisel-type-vs-scala-type.md:159)\n// \tat repl.MdocSession$MdocApp$$anonfun$44$$anonfun$apply$40.apply(chisel-type-vs-scala-type.md:159)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,l.jsxs)(e.p,{children:["Can't pass hardware to a ",(0,l.jsx)(e.code,{children:"Wire"}),", ",(0,l.jsx)(e.code,{children:"Reg"}),", ",(0,l.jsx)(e.code,{children:"IO"}),":"]}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"// Do this...\nelaborate(new Module {\n  val hardware = Wire(new MyBundle(3))\n  hardware := DontCare\n})\n"})}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"// Not this...\nelaborate(new Module {\n  val hardware = Wire(new MyBundle(3))\n  val crash = Wire(hardware)\n})\n// chisel3.package$ExpectedChiselTypeException: wire type '_44_Anon.hardware: Wire[MyBundle]' must be a Chisel type, not hardware\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp$$anonfun$49$$anonfun$apply$44$$anon$11$$anonfun$51$$anonfun$apply$47.apply(chisel-type-vs-scala-type.md:182)\n// \tat repl.MdocSession$MdocApp$$anonfun$49$$anonfun$apply$44$$anon$11$$anonfun$51$$anonfun$apply$47.apply(chisel-type-vs-scala-type.md:182)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp$$anonfun$49$$anonfun$apply$44$$anon$11$$anonfun$51.apply(chisel-type-vs-scala-type.md:182)\n// \tat repl.MdocSession$MdocApp$$anonfun$49$$anonfun$apply$44$$anon$11$$anonfun$51.apply(chisel-type-vs-scala-type.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp$$anonfun$49$$anonfun$apply$44$$anon$11.<init>(chisel-type-vs-scala-type.md:182)\n// \tat repl.MdocSession$MdocApp$$anonfun$49$$anonfun$apply$44.apply(chisel-type-vs-scala-type.md:180)\n// \tat repl.MdocSession$MdocApp$$anonfun$49$$anonfun$apply$44.apply(chisel-type-vs-scala-type.md:180)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,l.jsxs)(e.p,{children:[(0,l.jsx)(e.code,{children:".Lit"})," can only be called on Chisel type:"]}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"// Do this...\nelaborate(new Module {\n  val hardwareLit = (new MyBundle(3)).Lit(\n    _.foo -> 0.U,\n    _.bar -> 0.U\n  )\n})\n"})}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"//Not this...\nelaborate(new Module {\n  val hardware = Wire(new MyBundle(3))\n  val crash = hardware.Lit(\n    _.foo -> 0.U,\n    _.bar -> 0.U\n  )\n})\n// chisel3.package$ExpectedChiselTypeException: bundle literal constructor model '_52_Anon.hardware: Wire[MyBundle]' must be a Chisel type, not hardware\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp$$anonfun$54$$anonfun$apply$52$$anon$13$$anonfun$56$$anonfun$apply$55.apply(chisel-type-vs-scala-type.md:206)\n// \tat repl.MdocSession$MdocApp$$anonfun$54$$anonfun$apply$52$$anon$13$$anonfun$56$$anonfun$apply$55.apply(chisel-type-vs-scala-type.md:206)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp$$anonfun$54$$anonfun$apply$52$$anon$13$$anonfun$56.apply(chisel-type-vs-scala-type.md:206)\n// \tat repl.MdocSession$MdocApp$$anonfun$54$$anonfun$apply$52$$anon$13$$anonfun$56.apply(chisel-type-vs-scala-type.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp$$anonfun$54$$anonfun$apply$52$$anon$13.<init>(chisel-type-vs-scala-type.md:206)\n// \tat repl.MdocSession$MdocApp$$anonfun$54$$anonfun$apply$52.apply(chisel-type-vs-scala-type.md:204)\n// \tat repl.MdocSession$MdocApp$$anonfun$54$$anonfun$apply$52.apply(chisel-type-vs-scala-type.md:204)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,l.jsxs)(e.p,{children:["Can only use a Chisel type within a ",(0,l.jsx)(e.code,{children:"Bundle"})," definition:"]}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"// Do this...\nelaborate(new Module {\n  val hardware = Wire(new Bundle {\n    val nested = new MyBundle(3)\n  })\n  hardware := DontCare\n})\n"})}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"// Not this...\nelaborate(new Module {\n  val crash = Wire(new Bundle {\n    val nested = Wire(new MyBundle(3))\n  })\n})\n// chisel3.package$ExpectedChiselTypeException: Bundle: AnonymousBundle contains hardware fields: nested: _60_Anon.crash_nested: Wire[MyBundle]\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp$$anonfun$61$$anonfun$apply$60$$anon$16$$anonfun$62$$anonfun$apply$61.apply(chisel-type-vs-scala-type.md:232)\n// \tat repl.MdocSession$MdocApp$$anonfun$61$$anonfun$apply$60$$anon$16$$anonfun$62$$anonfun$apply$61.apply(chisel-type-vs-scala-type.md:232)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp$$anonfun$61$$anonfun$apply$60$$anon$16$$anonfun$62.apply(chisel-type-vs-scala-type.md:232)\n// \tat repl.MdocSession$MdocApp$$anonfun$61$$anonfun$apply$60$$anon$16$$anonfun$62.apply(chisel-type-vs-scala-type.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp$$anonfun$61$$anonfun$apply$60$$anon$16.<init>(chisel-type-vs-scala-type.md:232)\n// \tat repl.MdocSession$MdocApp$$anonfun$61$$anonfun$apply$60.apply(chisel-type-vs-scala-type.md:231)\n// \tat repl.MdocSession$MdocApp$$anonfun$61$$anonfun$apply$60.apply(chisel-type-vs-scala-type.md:231)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,l.jsxs)(e.p,{children:["Can only call ",(0,l.jsx)(e.code,{children:"directionOf"})," on Hardware:"]}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"import chisel3.reflect.DataMirror\n\nclass Child extends Module{\n  val hardware = IO(new MyBundle(3))\n  hardware := DontCare\n  val chiselType = new MyBundle(3)\n}\n"})}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"// Do this...\nelaborate(new Module {\n  val child = Module(new Child())\n  child.hardware := DontCare\n  val direction = DataMirror.directionOf(child.hardware)\n})\n"})}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"// Not this...\nelaborate(new Module {\nval child = Module(new Child())\n  child.hardware := DontCare\n  val direction = DataMirror.directionOf(child.chiselType)\n})\n// chisel3.package$ExpectedHardwareException: node requested directionality on 'MyBundle' must be hardware, not a bare Chisel type. Perhaps you forgot to wrap it in Wire(_) or IO(_)?\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp$$anonfun$70$$anonfun$apply$68$$anon$19.<init>(chisel-type-vs-scala-type.md:271)\n// \tat repl.MdocSession$MdocApp$$anonfun$70$$anonfun$apply$68.apply(chisel-type-vs-scala-type.md:268)\n// \tat repl.MdocSession$MdocApp$$anonfun$70$$anonfun$apply$68.apply(chisel-type-vs-scala-type.md:268)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,l.jsxs)(e.p,{children:["Can call ",(0,l.jsx)(e.code,{children:"specifiedDirectionOf"})," on hardware or Chisel type:"]}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"elaborate(new Module {\n  val child = Module(new Child())\n  child.hardware := DontCare\n  val direction0 = DataMirror.specifiedDirectionOf(child.hardware)\n  val direction1 = DataMirror.specifiedDirectionOf(child.chiselType)\n})\n"})}),"\n",(0,l.jsxs)(e.h2,{id:"asinstanceof-vs-astypeof-vs-chiseltypeof",children:[(0,l.jsx)(e.code,{children:".asInstanceOf"})," vs ",(0,l.jsx)(e.code,{children:".asTypeOf"})," vs ",(0,l.jsx)(e.code,{children:"chiselTypeOf"})]}),"\n",(0,l.jsxs)(e.p,{children:[(0,l.jsx)(e.code,{children:".asInstanceOf"})," is a Scala runtime cast, usually used for telling the compiler\nthat you have more information than it can infer to convert Scala types:"]}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"class ScalaCastingModule(gen: () => Bundle) extends Module {\n  val io = IO(Output(gen().asInstanceOf[MyBundle]))\n  io.foo := 0.U\n}\n"})}),"\n",(0,l.jsx)(e.p,{children:"This works if we do indeed have more information than the compiler:"}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"elaborate(new ScalaCastingModule( () => new MyBundle(3)))\n"})}),"\n",(0,l.jsx)(e.p,{children:"But if we are wrong, we can get a Scala runtime exception:"}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:"class NotMyBundle extends Bundle {val baz = Bool()}\nelaborate(new ScalaCastingModule(() => new NotMyBundle()))\n// java.lang.ClassCastException: class repl.MdocSession$MdocApp$$anonfun$79$NotMyBundle$1 cannot be cast to class repl.MdocSession$MdocApp$MyBundle (repl.MdocSession$MdocApp$$anonfun$79$NotMyBundle$1 and repl.MdocSession$MdocApp$MyBundle are in unnamed module of loader scala.reflect.internal.util.AbstractFileClassLoader @25c61518)\n// \tat repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71$$anonfun$apply$72$$anonfun$apply$73.apply(chisel-type-vs-scala-type.md:293)\n// \tat repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71$$anonfun$apply$72$$anonfun$apply$73.apply(chisel-type-vs-scala-type.md:293)\n// \tat chisel3.SpecifiedDirection$.specifiedDirection(Data.scala:75)\n// \tat chisel3.Output$.apply(Data.scala:316)\n// \tat repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71$$anonfun$apply$72.apply(chisel-type-vs-scala-type.md:293)\n// \tat repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71$$anonfun$apply$72.apply(chisel-type-vs-scala-type.md:293)\n// \tat chisel3.IO$.apply(IO.scala:34)\n// \tat chisel3.experimental.BaseModule.IO(Module.scala:878)\n// \tat repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71.apply(chisel-type-vs-scala-type.md:293)\n// \tat repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71.apply(chisel-type-vs-scala-type.md:293)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76.apply(chisel-type-vs-scala-type.md:293)\n// \tat repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76.apply(chisel-type-vs-scala-type.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp$ScalaCastingModule.<init>(chisel-type-vs-scala-type.md:293)\n// \tat repl.MdocSession$MdocApp$$anonfun$79$$anonfun$apply$75.apply(chisel-type-vs-scala-type.md:309)\n// \tat repl.MdocSession$MdocApp$$anonfun$79$$anonfun$apply$75.apply(chisel-type-vs-scala-type.md:309)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,l.jsxs)(e.p,{children:[(0,l.jsx)(e.code,{children:".asTypeOf"})," is a conversion from one ",(0,l.jsx)(e.code,{children:"Data"})," subclass to another.\nIt is commonly used to assign data to all-zeros, as described in ",(0,l.jsx)(e.a,{href:"https://www.chisel-lang.org/chisel3/docs/cookbooks/cookbook.html#how-can-i-tieoff-a-bundlevec-to-0",children:"this cookbook recipe"}),", but it can\nalso be used (though not really recommended, as there is no checking on\nwidth matches) to convert one Chisel type to another:"]}),"\n",(0,l.jsx)(e.pre,{children:(0,l.jsx)(e.code,{className:"language-scala",children:'class SimilarToMyBundle(w: Int) extends Bundle{\n  val foobar = UInt((2*w).W)\n}\n\nChiselStage.emitSystemVerilog(new Module {\n  val in = IO(Input(new MyBundle(3)))\n  val out = IO(Output(new SimilarToMyBundle(3)))\n\n  out := in.asTypeOf(out)\n})\n// res12: String = """// Generated by CIRCT firtool-1.81.1\n// module _82_Anon(\t// chisel-type-vs-scala-type.md:323:47\n//   input        clock,\t// chisel-type-vs-scala-type.md:323:47\n//                reset,\t// chisel-type-vs-scala-type.md:323:47\n//   input  [2:0] in_foo,\t// chisel-type-vs-scala-type.md:324:14\n//                in_bar,\t// chisel-type-vs-scala-type.md:324:14\n//   output [5:0] out_foobar\t// chisel-type-vs-scala-type.md:325:15\n// );\n// \n//   assign out_foobar = {in_foo, in_bar};\t// chisel-type-vs-scala-type.md:323:47, :327:21\n// endmodule\n// \n// """\n'})}),"\n",(0,l.jsxs)(e.p,{children:["In contrast to ",(0,l.jsx)(e.code,{children:"asInstanceOf"})," and ",(0,l.jsx)(e.code,{children:"asTypeOf"}),",\n",(0,l.jsx)(e.code,{children:"chiselTypeOf"})," is not a casting operation. It returns a Scala object which\ncan be used as shown in the examples above to create more Chisel types and\nhardware with the same Chisel type as existing hardware."]})]})}function $(a={}){const{wrapper:e}={...(0,t.R)(),...a.components};return e?(0,l.jsx)(e,{...a,children:(0,l.jsx)(p,{...a})}):p(a)}},8453:(a,e,n)=>{n.d(e,{R:()=>c,x:()=>o});var l=n(6540);const t={},s=l.createContext(t);function c(a){const e=l.useContext(s);return l.useMemo((function(){return"function"==typeof a?a(e):{...e,...a}}),[e,a])}function o(a){let e;return e=a.disableParentContext?"function"==typeof a.components?a.components(t):a.components||t:c(a.components),l.createElement(s.Provider,{value:e},a.children)}}}]);
\ No newline at end of file
+"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[2785],{924:(e,a,n)=>{n.r(a),n.d(a,{assets:()=>i,contentTitle:()=>o,default:()=>d,frontMatter:()=>s,metadata:()=>c,toc:()=>r});var l=n(4848),t=n(8453);const s={layout:"docs",title:"Chisel Type vs Scala Type",section:"chisel3"},o="Chisel Type vs Scala Type",c={id:"explanations/chisel-type-vs-scala-type",title:"Chisel Type vs Scala Type",description:"The Scala compiler cannot distinguish between Chisel's representation of hardware such as false.B, Reg(Bool())",source:"@site/docs/explanations/chisel-type-vs-scala-type.md",sourceDirName:"explanations",slug:"/explanations/chisel-type-vs-scala-type",permalink:"/docs/explanations/chisel-type-vs-scala-type",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/chisel-type-vs-scala-type.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Chisel Type vs Scala Type",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Enumerations",permalink:"/docs/explanations/chisel-enum"},next:{title:"Combinational Circuits",permalink:"/docs/explanations/combinational-circuits"}},i={},r=[{value:"Scala Type vs Chisel Type vs Hardware",id:"scala-type-vs-chisel-type-vs-hardware",level:2},{value:"Chisel Type vs Hardware vs Literals",id:"chisel-type-vs-hardware-vs-literals",level:2},{value:"Chisel Type vs Hardware -- Specific Functions and Errors",id:"chisel-type-vs-hardware----specific-functions-and-errors",level:2},{value:"<code>.asInstanceOf</code> vs <code>.asTypeOf</code> vs <code>chiselTypeOf</code>",id:"asinstanceof-vs-astypeof-vs-chiseltypeof",level:2}];function p(e){const a={a:"a",code:"code",em:"em",h1:"h1",h2:"h2",p:"p",pre:"pre",...(0,t.R)(),...e.components};return(0,l.jsxs)(l.Fragment,{children:[(0,l.jsx)(a.h1,{id:"chisel-type-vs-scala-type",children:"Chisel Type vs Scala Type"}),"\n",(0,l.jsxs)(a.p,{children:["The Scala compiler cannot distinguish between Chisel's representation of hardware such as ",(0,l.jsx)(a.code,{children:"false.B"}),", ",(0,l.jsx)(a.code,{children:"Reg(Bool())"}),"\nand pure Chisel types (e.g. ",(0,l.jsx)(a.code,{children:"Bool()"}),"). You can get runtime errors passing a Chisel type when hardware is expected, and vice versa."]}),"\n",(0,l.jsx)(a.h2,{id:"scala-type-vs-chisel-type-vs-hardware",children:"Scala Type vs Chisel Type vs Hardware"}),"\n",(0,l.jsxs)(a.p,{children:["The ",(0,l.jsx)(a.em,{children:"Scala"})," type of the Data is recognized by the Scala compiler, such as ",(0,l.jsx)(a.code,{children:"Bool"}),", ",(0,l.jsx)(a.code,{children:"Decoupled[UInt]"})," or ",(0,l.jsx)(a.code,{children:"MyBundle"})," in"]}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"class MyBundle(w: Int) extends Bundle {\n  val foo = UInt(w.W)\n  val bar = UInt(w.W)\n}\n"})}),"\n",(0,l.jsxs)(a.p,{children:["The ",(0,l.jsx)(a.em,{children:"Chisel"})," type of a ",(0,l.jsx)(a.code,{children:"Data"})," is a Scala object. It captures all the fields actually present,\nby names, and their types including widths.\nFor example, ",(0,l.jsx)(a.code,{children:"MyBundle(3)"})," creates a Chisel Type with fields ",(0,l.jsx)(a.code,{children:"foo: UInt(3.W),  bar: UInt(3.W))"}),"."]}),"\n",(0,l.jsxs)(a.p,{children:["Hardware is ",(0,l.jsx)(a.code,{children:"Data"}),' that is "bound" to synthesizable hardware. For example ',(0,l.jsx)(a.code,{children:"false.B"})," or ",(0,l.jsx)(a.code,{children:"Reg(Bool())"}),".\nThe binding is what determines the actual directionality of each field, it is not a property of the Chisel type."]}),"\n",(0,l.jsxs)(a.p,{children:["A literal is a ",(0,l.jsx)(a.code,{children:"Data"})," that is respresentable as a literal value without being wrapped in Wire, Reg, or IO."]}),"\n",(0,l.jsx)(a.h2,{id:"chisel-type-vs-hardware-vs-literals",children:"Chisel Type vs Hardware vs Literals"}),"\n",(0,l.jsxs)(a.p,{children:["The below code demonstrates how objects with the same Scala type (",(0,l.jsx)(a.code,{children:"MyBundle"}),") can have different properties."]}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"import chisel3.experimental.BundleLiterals._\n\nclass MyModule(gen: () => MyBundle) extends Module {\n                                                            //   Hardware   Literal\n    val xType:    MyBundle     = new MyBundle(3)            //      -          -\n    val dirXType: MyBundle     = Input(new MyBundle(3))     //      -          -\n    val xReg:     MyBundle     = Reg(new MyBundle(3))       //      x          -\n    val xIO:      MyBundle     = IO(Input(new MyBundle(3))) //      x          -\n    val xRegInit: MyBundle     = RegInit(xIO)               //      x          -\n    val xLit:     MyBundle     = xType.Lit(                 //      x          x\n      _.foo -> 0.U(3.W),\n      _.bar -> 0.U(3.W)\n    )\n    val y:        MyBundle = gen()                          //      ?          ?\n\n    // Need to initialize all hardware values\n    xReg := DontCare\n}\n"})}),"\n",(0,l.jsx)(a.h2,{id:"chisel-type-vs-hardware----specific-functions-and-errors",children:"Chisel Type vs Hardware -- Specific Functions and Errors"}),"\n",(0,l.jsxs)(a.p,{children:[(0,l.jsx)(a.code,{children:".asTypeOf"})," works for both hardware and Chisel type:"]}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"elaborate(new Module {\n  val chiselType = new MyBundle(3)\n  val hardware = Wire(new MyBundle(3))\n  hardware := DontCare\n  val a = 0.U.asTypeOf(chiselType)\n  val b = 0.U.asTypeOf(hardware)\n})\n"})}),"\n",(0,l.jsxs)(a.p,{children:["Can only ",(0,l.jsx)(a.code,{children:":="})," to hardware:"]}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"// Do this...\nelaborate(new Module {\n  val hardware = Wire(new MyBundle(3))\n  hardware := DontCare\n})\n"})}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"// Not this...\nelaborate(new Module {\n  val chiselType = new MyBundle(3)\n  chiselType := DontCare\n})\n// chisel3.package$ExpectedHardwareException: data to be connected 'MyBundle' must be hardware, not a bare Chisel type. Perhaps you forgot to wrap it in Wire(_) or IO(_)?\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp$$anonfun$21$$anonfun$apply$21$$anon$3.<init>(chisel-type-vs-scala-type.md:90)\n// \tat repl.MdocSession$MdocApp$$anonfun$21$$anonfun$apply$21.apply(chisel-type-vs-scala-type.md:88)\n// \tat repl.MdocSession$MdocApp$$anonfun$21$$anonfun$apply$21.apply(chisel-type-vs-scala-type.md:88)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,l.jsxs)(a.p,{children:["Can only ",(0,l.jsx)(a.code,{children:":="})," from hardware:"]}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"// Do this...\nelaborate(new Module {\n  val hardware = IO(new MyBundle(3))\n  val moarHardware = Wire(new MyBundle(3))\n  moarHardware := DontCare\n  hardware := moarHardware\n})\n"})}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"// Not this...\nelaborate(new Module {\n  val hardware = IO(new MyBundle(3))\n  val chiselType = new MyBundle(3)\n  hardware := chiselType\n})\n// chisel3.package$ExpectedHardwareException: data to be connected 'MyBundle' must be hardware, not a bare Chisel type. Perhaps you forgot to wrap it in Wire(_) or IO(_)?\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp$$anonfun$29$$anonfun$apply$27$$anon$5.<init>(chisel-type-vs-scala-type.md:115)\n// \tat repl.MdocSession$MdocApp$$anonfun$29$$anonfun$apply$27.apply(chisel-type-vs-scala-type.md:112)\n// \tat repl.MdocSession$MdocApp$$anonfun$29$$anonfun$apply$27.apply(chisel-type-vs-scala-type.md:112)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,l.jsxs)(a.p,{children:["Have to pass hardware to ",(0,l.jsx)(a.code,{children:"chiselTypeOf"}),":"]}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"// Do this...\nelaborate(new Module {\n  val hardware = Wire(new MyBundle(3))\n  hardware := DontCare\n  val chiselType = chiselTypeOf(hardware)\n})\n"})}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"// Not this...\nelaborate(new Module {\n  val chiselType = new MyBundle(3)\n  val crash = chiselTypeOf(chiselType)\n})\n// chisel3.package$ExpectedHardwareException: 'MyBundle' must be hardware, not a bare Chisel type. Perhaps you forgot to wrap it in Wire(_) or IO(_)?\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp$$anonfun$37$$anonfun$apply$34$$anon$7$$anonfun$39$$anonfun$apply$36.apply(chisel-type-vs-scala-type.md:138)\n// \tat repl.MdocSession$MdocApp$$anonfun$37$$anonfun$apply$34$$anon$7$$anonfun$39$$anonfun$apply$36.apply(chisel-type-vs-scala-type.md:138)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp$$anonfun$37$$anonfun$apply$34$$anon$7$$anonfun$39.apply(chisel-type-vs-scala-type.md:138)\n// \tat repl.MdocSession$MdocApp$$anonfun$37$$anonfun$apply$34$$anon$7$$anonfun$39.apply(chisel-type-vs-scala-type.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp$$anonfun$37$$anonfun$apply$34$$anon$7.<init>(chisel-type-vs-scala-type.md:138)\n// \tat repl.MdocSession$MdocApp$$anonfun$37$$anonfun$apply$34.apply(chisel-type-vs-scala-type.md:136)\n// \tat repl.MdocSession$MdocApp$$anonfun$37$$anonfun$apply$34.apply(chisel-type-vs-scala-type.md:136)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,l.jsxs)(a.p,{children:["Have to pass hardware to ",(0,l.jsx)(a.code,{children:"*Init"}),":"]}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"// Do this...\nelaborate(new Module {\n  val hardware = Wire(new MyBundle(3))\n  hardware := DontCare\n  val moarHardware = WireInit(hardware)\n})\n"})}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"// Not this...\nelaborate(new Module {\n  val crash = WireInit(new MyBundle(3))\n})\n// chisel3.package$ExpectedHardwareException: wire initializer 'MyBundle' must be hardware, not a bare Chisel type. Perhaps you forgot to wrap it in Wire(_) or IO(_)?\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp$$anonfun$44$$anonfun$apply$40$$anon$9$$anonfun$45$$anonfun$apply$41.apply(chisel-type-vs-scala-type.md:160)\n// \tat repl.MdocSession$MdocApp$$anonfun$44$$anonfun$apply$40$$anon$9$$anonfun$45$$anonfun$apply$41.apply(chisel-type-vs-scala-type.md:160)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp$$anonfun$44$$anonfun$apply$40$$anon$9$$anonfun$45.apply(chisel-type-vs-scala-type.md:160)\n// \tat repl.MdocSession$MdocApp$$anonfun$44$$anonfun$apply$40$$anon$9$$anonfun$45.apply(chisel-type-vs-scala-type.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp$$anonfun$44$$anonfun$apply$40$$anon$9.<init>(chisel-type-vs-scala-type.md:160)\n// \tat repl.MdocSession$MdocApp$$anonfun$44$$anonfun$apply$40.apply(chisel-type-vs-scala-type.md:159)\n// \tat repl.MdocSession$MdocApp$$anonfun$44$$anonfun$apply$40.apply(chisel-type-vs-scala-type.md:159)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,l.jsxs)(a.p,{children:["Can't pass hardware to a ",(0,l.jsx)(a.code,{children:"Wire"}),", ",(0,l.jsx)(a.code,{children:"Reg"}),", ",(0,l.jsx)(a.code,{children:"IO"}),":"]}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"// Do this...\nelaborate(new Module {\n  val hardware = Wire(new MyBundle(3))\n  hardware := DontCare\n})\n"})}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"// Not this...\nelaborate(new Module {\n  val hardware = Wire(new MyBundle(3))\n  val crash = Wire(hardware)\n})\n// chisel3.package$ExpectedChiselTypeException: wire type '_44_Anon.hardware: Wire[MyBundle]' must be a Chisel type, not hardware\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp$$anonfun$49$$anonfun$apply$44$$anon$11$$anonfun$51$$anonfun$apply$47.apply(chisel-type-vs-scala-type.md:182)\n// \tat repl.MdocSession$MdocApp$$anonfun$49$$anonfun$apply$44$$anon$11$$anonfun$51$$anonfun$apply$47.apply(chisel-type-vs-scala-type.md:182)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp$$anonfun$49$$anonfun$apply$44$$anon$11$$anonfun$51.apply(chisel-type-vs-scala-type.md:182)\n// \tat repl.MdocSession$MdocApp$$anonfun$49$$anonfun$apply$44$$anon$11$$anonfun$51.apply(chisel-type-vs-scala-type.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp$$anonfun$49$$anonfun$apply$44$$anon$11.<init>(chisel-type-vs-scala-type.md:182)\n// \tat repl.MdocSession$MdocApp$$anonfun$49$$anonfun$apply$44.apply(chisel-type-vs-scala-type.md:180)\n// \tat repl.MdocSession$MdocApp$$anonfun$49$$anonfun$apply$44.apply(chisel-type-vs-scala-type.md:180)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,l.jsxs)(a.p,{children:[(0,l.jsx)(a.code,{children:".Lit"})," can only be called on Chisel type:"]}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"// Do this...\nelaborate(new Module {\n  val hardwareLit = (new MyBundle(3)).Lit(\n    _.foo -> 0.U,\n    _.bar -> 0.U\n  )\n})\n"})}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"//Not this...\nelaborate(new Module {\n  val hardware = Wire(new MyBundle(3))\n  val crash = hardware.Lit(\n    _.foo -> 0.U,\n    _.bar -> 0.U\n  )\n})\n// chisel3.package$ExpectedChiselTypeException: bundle literal constructor model '_52_Anon.hardware: Wire[MyBundle]' must be a Chisel type, not hardware\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp$$anonfun$54$$anonfun$apply$52$$anon$13$$anonfun$56$$anonfun$apply$55.apply(chisel-type-vs-scala-type.md:206)\n// \tat repl.MdocSession$MdocApp$$anonfun$54$$anonfun$apply$52$$anon$13$$anonfun$56$$anonfun$apply$55.apply(chisel-type-vs-scala-type.md:206)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp$$anonfun$54$$anonfun$apply$52$$anon$13$$anonfun$56.apply(chisel-type-vs-scala-type.md:206)\n// \tat repl.MdocSession$MdocApp$$anonfun$54$$anonfun$apply$52$$anon$13$$anonfun$56.apply(chisel-type-vs-scala-type.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp$$anonfun$54$$anonfun$apply$52$$anon$13.<init>(chisel-type-vs-scala-type.md:206)\n// \tat repl.MdocSession$MdocApp$$anonfun$54$$anonfun$apply$52.apply(chisel-type-vs-scala-type.md:204)\n// \tat repl.MdocSession$MdocApp$$anonfun$54$$anonfun$apply$52.apply(chisel-type-vs-scala-type.md:204)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,l.jsxs)(a.p,{children:["Can only use a Chisel type within a ",(0,l.jsx)(a.code,{children:"Bundle"})," definition:"]}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"// Do this...\nelaborate(new Module {\n  val hardware = Wire(new Bundle {\n    val nested = new MyBundle(3)\n  })\n  hardware := DontCare\n})\n"})}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"// Not this...\nelaborate(new Module {\n  val crash = Wire(new Bundle {\n    val nested = Wire(new MyBundle(3))\n  })\n})\n// chisel3.package$ExpectedChiselTypeException: Bundle: AnonymousBundle contains hardware fields: nested: _60_Anon.crash_nested: Wire[MyBundle]\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp$$anonfun$61$$anonfun$apply$60$$anon$16$$anonfun$62$$anonfun$apply$61.apply(chisel-type-vs-scala-type.md:232)\n// \tat repl.MdocSession$MdocApp$$anonfun$61$$anonfun$apply$60$$anon$16$$anonfun$62$$anonfun$apply$61.apply(chisel-type-vs-scala-type.md:232)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp$$anonfun$61$$anonfun$apply$60$$anon$16$$anonfun$62.apply(chisel-type-vs-scala-type.md:232)\n// \tat repl.MdocSession$MdocApp$$anonfun$61$$anonfun$apply$60$$anon$16$$anonfun$62.apply(chisel-type-vs-scala-type.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp$$anonfun$61$$anonfun$apply$60$$anon$16.<init>(chisel-type-vs-scala-type.md:232)\n// \tat repl.MdocSession$MdocApp$$anonfun$61$$anonfun$apply$60.apply(chisel-type-vs-scala-type.md:231)\n// \tat repl.MdocSession$MdocApp$$anonfun$61$$anonfun$apply$60.apply(chisel-type-vs-scala-type.md:231)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,l.jsxs)(a.p,{children:["Can only call ",(0,l.jsx)(a.code,{children:"directionOf"})," on Hardware:"]}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"import chisel3.reflect.DataMirror\n\nclass Child extends Module{\n  val hardware = IO(new MyBundle(3))\n  hardware := DontCare\n  val chiselType = new MyBundle(3)\n}\n"})}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"// Do this...\nelaborate(new Module {\n  val child = Module(new Child())\n  child.hardware := DontCare\n  val direction = DataMirror.directionOf(child.hardware)\n})\n"})}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"// Not this...\nelaborate(new Module {\nval child = Module(new Child())\n  child.hardware := DontCare\n  val direction = DataMirror.directionOf(child.chiselType)\n})\n// chisel3.package$ExpectedHardwareException: node requested directionality on 'MyBundle' must be hardware, not a bare Chisel type. Perhaps you forgot to wrap it in Wire(_) or IO(_)?\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp$$anonfun$70$$anonfun$apply$68$$anon$19.<init>(chisel-type-vs-scala-type.md:271)\n// \tat repl.MdocSession$MdocApp$$anonfun$70$$anonfun$apply$68.apply(chisel-type-vs-scala-type.md:268)\n// \tat repl.MdocSession$MdocApp$$anonfun$70$$anonfun$apply$68.apply(chisel-type-vs-scala-type.md:268)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,l.jsxs)(a.p,{children:["Can call ",(0,l.jsx)(a.code,{children:"specifiedDirectionOf"})," on hardware or Chisel type:"]}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"elaborate(new Module {\n  val child = Module(new Child())\n  child.hardware := DontCare\n  val direction0 = DataMirror.specifiedDirectionOf(child.hardware)\n  val direction1 = DataMirror.specifiedDirectionOf(child.chiselType)\n})\n"})}),"\n",(0,l.jsxs)(a.h2,{id:"asinstanceof-vs-astypeof-vs-chiseltypeof",children:[(0,l.jsx)(a.code,{children:".asInstanceOf"})," vs ",(0,l.jsx)(a.code,{children:".asTypeOf"})," vs ",(0,l.jsx)(a.code,{children:"chiselTypeOf"})]}),"\n",(0,l.jsxs)(a.p,{children:[(0,l.jsx)(a.code,{children:".asInstanceOf"})," is a Scala runtime cast, usually used for telling the compiler\nthat you have more information than it can infer to convert Scala types:"]}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"class ScalaCastingModule(gen: () => Bundle) extends Module {\n  val io = IO(Output(gen().asInstanceOf[MyBundle]))\n  io.foo := 0.U\n}\n"})}),"\n",(0,l.jsx)(a.p,{children:"This works if we do indeed have more information than the compiler:"}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"elaborate(new ScalaCastingModule( () => new MyBundle(3)))\n"})}),"\n",(0,l.jsx)(a.p,{children:"But if we are wrong, we can get a Scala runtime exception:"}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:"class NotMyBundle extends Bundle {val baz = Bool()}\nelaborate(new ScalaCastingModule(() => new NotMyBundle()))\n// java.lang.ClassCastException: class repl.MdocSession$MdocApp$$anonfun$79$NotMyBundle$1 cannot be cast to class repl.MdocSession$MdocApp$MyBundle (repl.MdocSession$MdocApp$$anonfun$79$NotMyBundle$1 and repl.MdocSession$MdocApp$MyBundle are in unnamed module of loader scala.reflect.internal.util.AbstractFileClassLoader @3a39a49f)\n// \tat repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71$$anonfun$apply$72$$anonfun$apply$73.apply(chisel-type-vs-scala-type.md:293)\n// \tat repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71$$anonfun$apply$72$$anonfun$apply$73.apply(chisel-type-vs-scala-type.md:293)\n// \tat chisel3.SpecifiedDirection$.specifiedDirection(Data.scala:75)\n// \tat chisel3.Output$.apply(Data.scala:316)\n// \tat repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71$$anonfun$apply$72.apply(chisel-type-vs-scala-type.md:293)\n// \tat repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71$$anonfun$apply$72.apply(chisel-type-vs-scala-type.md:293)\n// \tat chisel3.IO$.apply(IO.scala:34)\n// \tat chisel3.experimental.BaseModule.IO(Module.scala:878)\n// \tat repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71.apply(chisel-type-vs-scala-type.md:293)\n// \tat repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71.apply(chisel-type-vs-scala-type.md:293)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76.apply(chisel-type-vs-scala-type.md:293)\n// \tat repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76.apply(chisel-type-vs-scala-type.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp$ScalaCastingModule.<init>(chisel-type-vs-scala-type.md:293)\n// \tat repl.MdocSession$MdocApp$$anonfun$79$$anonfun$apply$75.apply(chisel-type-vs-scala-type.md:309)\n// \tat repl.MdocSession$MdocApp$$anonfun$79$$anonfun$apply$75.apply(chisel-type-vs-scala-type.md:309)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,l.jsxs)(a.p,{children:[(0,l.jsx)(a.code,{children:".asTypeOf"})," is a conversion from one ",(0,l.jsx)(a.code,{children:"Data"})," subclass to another.\nIt is commonly used to assign data to all-zeros, as described in ",(0,l.jsx)(a.a,{href:"https://www.chisel-lang.org/chisel3/docs/cookbooks/cookbook.html#how-can-i-tieoff-a-bundlevec-to-0",children:"this cookbook recipe"}),", but it can\nalso be used (though not really recommended, as there is no checking on\nwidth matches) to convert one Chisel type to another:"]}),"\n",(0,l.jsx)(a.pre,{children:(0,l.jsx)(a.code,{className:"language-scala",children:'class SimilarToMyBundle(w: Int) extends Bundle{\n  val foobar = UInt((2*w).W)\n}\n\nChiselStage.emitSystemVerilog(new Module {\n  val in = IO(Input(new MyBundle(3)))\n  val out = IO(Output(new SimilarToMyBundle(3)))\n\n  out := in.asTypeOf(out)\n})\n// res12: String = """// Generated by CIRCT firtool-1.81.1\n// module _82_Anon(\t// chisel-type-vs-scala-type.md:323:47\n//   input        clock,\t// chisel-type-vs-scala-type.md:323:47\n//                reset,\t// chisel-type-vs-scala-type.md:323:47\n//   input  [2:0] in_foo,\t// chisel-type-vs-scala-type.md:324:14\n//                in_bar,\t// chisel-type-vs-scala-type.md:324:14\n//   output [5:0] out_foobar\t// chisel-type-vs-scala-type.md:325:15\n// );\n// \n//   assign out_foobar = {in_foo, in_bar};\t// chisel-type-vs-scala-type.md:323:47, :327:21\n// endmodule\n// \n// \n// // ----- 8< ----- FILE "Verification/Cover/layers__82_Anon_Verification_Cover.sv" ----- 8< -----\n// \n// // Generated by CIRCT firtool-1.81.1\n// `include "Verification/layers__82_Anon_Verification.sv"\n// `ifndef layers__82_Anon_Verification_Cover\n// `define layers__82_Anon_Verification_Cover\t// <stdin>:6:5\n// `endif // layers__82_Anon_Verification_Cover\t// <stdin>:6:5\n// \n// // ----- 8< ----- FILE "Verification/Assume/layers__82_Anon_Verification_Assume.sv" ----- 8< -----\n// \n// // Generated by CIRCT firtool-1.81.1\n// `include "Verification/layers__82_Anon_Verification.sv"\n// `ifndef layers__82_Anon_Verification_Assume\n// `define layers__82_Anon_Verification_Assume\t// <stdin>:5:5\n// `endif // layers__82_Anon_Verification_Assume\t// <stdin>:5:5\n// \n// // ----- 8< ----- FILE "Verification/Assert/layers__82_Anon_Verification_Assert.sv" ----- 8< -----\n// \n// // Generated by CIRCT firtool-1.81.1\n// `include "Verification/layers__82_Anon_Verification.sv"\n// `ifndef layers__82_Anon_Verification_Assert\n// `define layers__82_Anon_Verification_Assert\t// <stdin>:4:5\n// `endif // layers__82_Anon_Verification_Assert\t// <stdin>:4:5\n// \n// // ----- 8< ----- FILE "Verification/layers__82_Anon_Verification.sv" ----- 8< -----\n// \n// // Generated by CIRCT firtool-1.81.1\n// `ifndef layers__82_Anon_Verification\n// `define layers__82_Anon_Verification\t// <stdin>:3:3\n// `endif // layers__82_Anon_Verification\t// <stdin>:3:3\n// """\n'})}),"\n",(0,l.jsxs)(a.p,{children:["In contrast to ",(0,l.jsx)(a.code,{children:"asInstanceOf"})," and ",(0,l.jsx)(a.code,{children:"asTypeOf"}),",\n",(0,l.jsx)(a.code,{children:"chiselTypeOf"})," is not a casting operation. It returns a Scala object which\ncan be used as shown in the examples above to create more Chisel types and\nhardware with the same Chisel type as existing hardware."]})]})}function d(e={}){const{wrapper:a}={...(0,t.R)(),...e.components};return a?(0,l.jsx)(a,{...e,children:(0,l.jsx)(p,{...e})}):p(e)}},8453:(e,a,n)=>{n.d(a,{R:()=>o,x:()=>c});var l=n(6540);const t={},s=l.createContext(t);function o(e){const a=l.useContext(s);return l.useMemo((function(){return"function"==typeof e?e(a):{...a,...e}}),[a,e])}function c(e){let a;return a=e.disableParentContext?"function"==typeof e.components?e.components(t):e.components||t:o(e.components),l.createElement(s.Provider,{value:a},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/7cc2f0dc.0f402a60.js b/assets/js/7cc2f0dc.0f402a60.js
deleted file mode 100644
index 8a71e2b8fb..0000000000
--- a/assets/js/7cc2f0dc.0f402a60.js
+++ /dev/null
@@ -1 +0,0 @@
-"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[3291],{9044:(e,n,a)=>{a.r(n),a.d(n,{assets:()=>r,contentTitle:()=>s,default:()=>p,frontMatter:()=>o,metadata:()=>l,toc:()=>d});var t=a(4848),i=a(8453);const o={layout:"docs",title:"Polymorphism and Parameterization",section:"chisel3"},s="Polymorphism and Parameterization",l={id:"explanations/polymorphism-and-parameterization",title:"Polymorphism and Parameterization",description:"This section is advanced and can be skipped at first reading.",source:"@site/docs/explanations/polymorphism-and-parameterization.md",sourceDirName:"explanations",slug:"/explanations/polymorphism-and-parameterization",permalink:"/docs/explanations/polymorphism-and-parameterization",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/polymorphism-and-parameterization.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Polymorphism and Parameterization",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Operators",permalink:"/docs/explanations/operators"},next:{title:"Ports",permalink:"/docs/explanations/ports"}},r={},d=[{value:"Parameterized Functions",id:"parameterized-functions",level:2},{value:"Parameterized Classes",id:"parameterized-classes",level:2},{value:"Parametrization based on Modules",id:"parametrization-based-on-modules",level:2}];function c(e){const n={code:"code",em:"em",h1:"h1",h2:"h2",p:"p",pre:"pre",...(0,i.R)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.h1,{id:"polymorphism-and-parameterization",children:"Polymorphism and Parameterization"}),"\n",(0,t.jsx)(n.p,{children:(0,t.jsx)(n.em,{children:"This section is advanced and can be skipped at first reading."})}),"\n",(0,t.jsx)(n.p,{children:"Scala is a strongly typed language and uses parameterized types to specify generic functions and classes.\nIn this section, we show how Chisel users can define their own reusable functions and classes using parameterized classes."}),"\n",(0,t.jsx)(n.h2,{id:"parameterized-functions",children:"Parameterized Functions"}),"\n",(0,t.jsxs)(n.p,{children:["Earlier we defined ",(0,t.jsx)(n.code,{children:"Mux2"})," on ",(0,t.jsx)(n.code,{children:"Bool"}),", but now we show how we can define a generic multiplexer function.\nWe define this function as taking a boolean condition and con and alt arguments (corresponding to then and else expressions) of type ",(0,t.jsx)(n.code,{children:"T"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"def Mux[T <: Bits](c: Bool, con: T, alt: T): T = { ... }\n"})}),"\n",(0,t.jsxs)(n.p,{children:["where ",(0,t.jsx)(n.code,{children:"T"})," is required to be a subclass of ",(0,t.jsx)(n.code,{children:"Bits"}),".\nScala ensures that in each usage of ",(0,t.jsx)(n.code,{children:"Mux"}),", it can find a common superclass of the actual con and alt argument types,\notherwise it causes a Scala compilation type error.\nFor example,"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"Mux(c, UInt(10), UInt(11))\n"})}),"\n",(0,t.jsxs)(n.p,{children:["yields a ",(0,t.jsx)(n.code,{children:"UInt"})," wire because the ",(0,t.jsx)(n.code,{children:"con"})," and ",(0,t.jsx)(n.code,{children:"alt"})," arguments are each of type ",(0,t.jsx)(n.code,{children:"UInt"}),"."]}),"\n",(0,t.jsx)(n.h2,{id:"parameterized-classes",children:"Parameterized Classes"}),"\n",(0,t.jsxs)(n.p,{children:["Like parameterized functions, we can also parameterize classes to make them more reusable.\nFor instance, we can generalize the Filter class to use any kind of link.\nWe do so by parameterizing the ",(0,t.jsx)(n.code,{children:"FilterIO"})," class and defining the constructor to take a single argument ",(0,t.jsx)(n.code,{children:"gen"})," of type ",(0,t.jsx)(n.code,{children:"T"})," as below."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class FilterIO[T <: Data](gen: T) extends Bundle {\n  val x = Input(gen)\n  val y = Output(gen)\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["We can now define ",(0,t.jsx)(n.code,{children:"Filter"})," by defining a module class that also takes a link type constructor argument and passes it through to the ",(0,t.jsx)(n.code,{children:"FilterIO"})," interface constructor:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class Filter[T <: Data](gen: T) extends Module {\n  val io = IO(new FilterIO(gen))\n  // ...\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["We can now define a ",(0,t.jsx)(n.code,{children:"PLink"}),"-based ",(0,t.jsx)(n.code,{children:"Filter"})," as follows:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"val f = Module(new Filter(new PLink))\n"})}),"\n",(0,t.jsx)(n.p,{children:"A generic FIFO could be defined as follows:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3.util.log2Up\n\nclass DataBundle extends Bundle {\n  val a = UInt(32.W)\n  val b = UInt(32.W)\n}\n\nclass Fifo[T <: Data](gen: T, n: Int) extends Module {\n  val io = IO(new Bundle {\n    val enqVal = Input(Bool())\n    val enqRdy = Output(Bool())\n    val deqVal = Output(Bool())\n    val deqRdy = Input(Bool())\n    val enqDat = Input(gen)\n    val deqDat = Output(gen)\n  })\n  val enqPtr     = RegInit(0.U((log2Up(n)).W))\n  val deqPtr     = RegInit(0.U((log2Up(n)).W))\n  val isFull     = RegInit(false.B)\n  val doEnq      = io.enqRdy && io.enqVal\n  val doDeq      = io.deqRdy && io.deqVal\n  val isEmpty    = !isFull && (enqPtr === deqPtr)\n  val deqPtrInc  = deqPtr + 1.U\n  val enqPtrInc  = enqPtr + 1.U\n  val isFullNext = Mux(doEnq && ~doDeq && (enqPtrInc === deqPtr),\n                         true.B, Mux(doDeq && isFull, false.B,\n                         isFull))\n  enqPtr := Mux(doEnq, enqPtrInc, enqPtr)\n  deqPtr := Mux(doDeq, deqPtrInc, deqPtr)\n  isFull := isFullNext\n  val ram = Mem(n, gen)\n  when (doEnq) {\n    ram(enqPtr) := io.enqDat\n  }\n  io.enqRdy := !isFull\n  io.deqVal := !isEmpty\n  ram(deqPtr) <> io.deqDat\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"An Fifo with 8 elements of type DataBundle could then be instantiated as:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"val fifo = Module(new Fifo(new DataBundle, 8))\n"})}),"\n",(0,t.jsx)(n.p,{children:"It is also possible to define a generic decoupled (ready/valid) interface:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class DecoupledIO[T <: Data](data: T) extends Bundle {\n  val ready = Input(Bool())\n  val valid = Output(Bool())\n  val bits  = Output(data)\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"This template can then be used to add a handshaking protocol to any\nset of signals:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class DecoupledDemo extends DecoupledIO(new DataBundle)\n"})}),"\n",(0,t.jsx)(n.p,{children:"The FIFO interface can be now be simplified as follows:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class Fifo[T <: Data](data: T, n: Int) extends Module {\n  val io = IO(new Bundle {\n    val enq = Flipped(new DecoupledIO(data))\n    val deq = new DecoupledIO(data)\n  })\n  // ...\n}\n"})}),"\n",(0,t.jsx)(n.h2,{id:"parametrization-based-on-modules",children:"Parametrization based on Modules"}),"\n",(0,t.jsx)(n.p,{children:"You can also parametrize modules based on other modules rather than just types. The following is an example of a module parametrized by other modules as opposed to e.g. types."}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3.RawModule\nimport chisel3.experimental.BaseModule\nimport circt.stage.ChiselStage\n\n// Provides a more specific interface since generic Module\n// provides no compile-time information on generic module's IOs.\ntrait MyAdder {\n    def in1: UInt\n    def in2: UInt\n    def out: UInt\n}\n\nclass Mod1 extends RawModule with MyAdder {\n    val in1 = IO(Input(UInt(8.W)))\n    val in2 = IO(Input(UInt(8.W)))\n    val out = IO(Output(UInt(8.W)))\n    out := in1 + in2\n}\n\nclass Mod2 extends RawModule with MyAdder {\n    val in1 = IO(Input(UInt(8.W)))\n    val in2 = IO(Input(UInt(8.W)))\n    val out = IO(Output(UInt(8.W)))\n    out := in1 - in2\n}\n\nclass X[T <: BaseModule with MyAdder](genT: => T) extends Module {\n    val io = IO(new Bundle {\n        val in1 = Input(UInt(8.W))\n        val in2 = Input(UInt(8.W))\n        val out = Output(UInt(8.W))\n    })\n    val subMod = Module(genT)\n    io.out := subMod.out\n    subMod.in1 := io.in1\n    subMod.in2 := io.in2\n}\n\nprintln(ChiselStage.emitSystemVerilog(new X(new Mod1)))\nprintln(ChiselStage.emitSystemVerilog(new X(new Mod2)))\n"})}),"\n",(0,t.jsx)(n.p,{children:"Output:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Mod1(\t// polymorphism-and-parameterization.md:170:7\n  input  [7:0] in1,\t// polymorphism-and-parameterization.md:171:17\n               in2,\t// polymorphism-and-parameterization.md:172:17\n  output [7:0] out\t// polymorphism-and-parameterization.md:173:17\n);\n\n  assign out = in1 + in2;\t// polymorphism-and-parameterization.md:170:7, :174:16\nendmodule\n\nmodule X(\t// polymorphism-and-parameterization.md:186:7\n  input        clock,\t// polymorphism-and-parameterization.md:186:7\n               reset,\t// polymorphism-and-parameterization.md:186:7\n  input  [7:0] io_in1,\t// polymorphism-and-parameterization.md:187:16\n               io_in2,\t// polymorphism-and-parameterization.md:187:16\n  output [7:0] io_out\t// polymorphism-and-parameterization.md:187:16\n);\n\n  Mod1 subMod (\t// polymorphism-and-parameterization.md:192:24\n    .in1 (io_in1),\n    .in2 (io_in2),\n    .out (io_out)\n  );\t// polymorphism-and-parameterization.md:192:24\nendmodule\n\n// Generated by CIRCT firtool-1.81.1\nmodule Mod2(\t// polymorphism-and-parameterization.md:178:7\n  input  [7:0] in1,\t// polymorphism-and-parameterization.md:179:17\n               in2,\t// polymorphism-and-parameterization.md:180:17\n  output [7:0] out\t// polymorphism-and-parameterization.md:181:17\n);\n\n  assign out = in1 - in2;\t// polymorphism-and-parameterization.md:178:7, :182:16\nendmodule\n\nmodule X(\t// polymorphism-and-parameterization.md:186:7\n  input        clock,\t// polymorphism-and-parameterization.md:186:7\n               reset,\t// polymorphism-and-parameterization.md:186:7\n  input  [7:0] io_in1,\t// polymorphism-and-parameterization.md:187:16\n               io_in2,\t// polymorphism-and-parameterization.md:187:16\n  output [7:0] io_out\t// polymorphism-and-parameterization.md:187:16\n);\n\n  Mod2 subMod (\t// polymorphism-and-parameterization.md:192:24\n    .in1 (io_in1),\n    .in2 (io_in2),\n    .out (io_out)\n  );\t// polymorphism-and-parameterization.md:192:24\nendmodule\n\n"})})]})}function p(e={}){const{wrapper:n}={...(0,i.R)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(c,{...e})}):c(e)}},8453:(e,n,a)=>{a.d(n,{R:()=>s,x:()=>l});var t=a(6540);const i={},o=t.createContext(i);function s(e){const n=t.useContext(o);return t.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function l(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(i):e.components||i:s(e.components),t.createElement(o.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/7cc2f0dc.d5e2a205.js b/assets/js/7cc2f0dc.d5e2a205.js
new file mode 100644
index 0000000000..87edeaf9d9
--- /dev/null
+++ b/assets/js/7cc2f0dc.d5e2a205.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[3291],{9044:(e,n,i)=>{i.r(n),i.d(n,{assets:()=>l,contentTitle:()=>s,default:()=>p,frontMatter:()=>o,metadata:()=>r,toc:()=>d});var a=i(4848),t=i(8453);const o={layout:"docs",title:"Polymorphism and Parameterization",section:"chisel3"},s="Polymorphism and Parameterization",r={id:"explanations/polymorphism-and-parameterization",title:"Polymorphism and Parameterization",description:"This section is advanced and can be skipped at first reading.",source:"@site/docs/explanations/polymorphism-and-parameterization.md",sourceDirName:"explanations",slug:"/explanations/polymorphism-and-parameterization",permalink:"/docs/explanations/polymorphism-and-parameterization",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/polymorphism-and-parameterization.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Polymorphism and Parameterization",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Operators",permalink:"/docs/explanations/operators"},next:{title:"Ports",permalink:"/docs/explanations/ports"}},l={},d=[{value:"Parameterized Functions",id:"parameterized-functions",level:2},{value:"Parameterized Classes",id:"parameterized-classes",level:2},{value:"Parametrization based on Modules",id:"parametrization-based-on-modules",level:2}];function c(e){const n={code:"code",em:"em",h1:"h1",h2:"h2",p:"p",pre:"pre",...(0,t.R)(),...e.components};return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(n.h1,{id:"polymorphism-and-parameterization",children:"Polymorphism and Parameterization"}),"\n",(0,a.jsx)(n.p,{children:(0,a.jsx)(n.em,{children:"This section is advanced and can be skipped at first reading."})}),"\n",(0,a.jsx)(n.p,{children:"Scala is a strongly typed language and uses parameterized types to specify generic functions and classes.\nIn this section, we show how Chisel users can define their own reusable functions and classes using parameterized classes."}),"\n",(0,a.jsx)(n.h2,{id:"parameterized-functions",children:"Parameterized Functions"}),"\n",(0,a.jsxs)(n.p,{children:["Earlier we defined ",(0,a.jsx)(n.code,{children:"Mux2"})," on ",(0,a.jsx)(n.code,{children:"Bool"}),", but now we show how we can define a generic multiplexer function.\nWe define this function as taking a boolean condition and con and alt arguments (corresponding to then and else expressions) of type ",(0,a.jsx)(n.code,{children:"T"}),":"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"def Mux[T <: Bits](c: Bool, con: T, alt: T): T = { ... }\n"})}),"\n",(0,a.jsxs)(n.p,{children:["where ",(0,a.jsx)(n.code,{children:"T"})," is required to be a subclass of ",(0,a.jsx)(n.code,{children:"Bits"}),".\nScala ensures that in each usage of ",(0,a.jsx)(n.code,{children:"Mux"}),", it can find a common superclass of the actual con and alt argument types,\notherwise it causes a Scala compilation type error.\nFor example,"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"Mux(c, UInt(10), UInt(11))\n"})}),"\n",(0,a.jsxs)(n.p,{children:["yields a ",(0,a.jsx)(n.code,{children:"UInt"})," wire because the ",(0,a.jsx)(n.code,{children:"con"})," and ",(0,a.jsx)(n.code,{children:"alt"})," arguments are each of type ",(0,a.jsx)(n.code,{children:"UInt"}),"."]}),"\n",(0,a.jsx)(n.h2,{id:"parameterized-classes",children:"Parameterized Classes"}),"\n",(0,a.jsxs)(n.p,{children:["Like parameterized functions, we can also parameterize classes to make them more reusable.\nFor instance, we can generalize the Filter class to use any kind of link.\nWe do so by parameterizing the ",(0,a.jsx)(n.code,{children:"FilterIO"})," class and defining the constructor to take a single argument ",(0,a.jsx)(n.code,{children:"gen"})," of type ",(0,a.jsx)(n.code,{children:"T"})," as below."]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"class FilterIO[T <: Data](gen: T) extends Bundle {\n  val x = Input(gen)\n  val y = Output(gen)\n}\n"})}),"\n",(0,a.jsxs)(n.p,{children:["We can now define ",(0,a.jsx)(n.code,{children:"Filter"})," by defining a module class that also takes a link type constructor argument and passes it through to the ",(0,a.jsx)(n.code,{children:"FilterIO"})," interface constructor:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"class Filter[T <: Data](gen: T) extends Module {\n  val io = IO(new FilterIO(gen))\n  // ...\n}\n"})}),"\n",(0,a.jsxs)(n.p,{children:["We can now define a ",(0,a.jsx)(n.code,{children:"PLink"}),"-based ",(0,a.jsx)(n.code,{children:"Filter"})," as follows:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"val f = Module(new Filter(new PLink))\n"})}),"\n",(0,a.jsx)(n.p,{children:"A generic FIFO could be defined as follows:"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"import chisel3.util.log2Up\n\nclass DataBundle extends Bundle {\n  val a = UInt(32.W)\n  val b = UInt(32.W)\n}\n\nclass Fifo[T <: Data](gen: T, n: Int) extends Module {\n  val io = IO(new Bundle {\n    val enqVal = Input(Bool())\n    val enqRdy = Output(Bool())\n    val deqVal = Output(Bool())\n    val deqRdy = Input(Bool())\n    val enqDat = Input(gen)\n    val deqDat = Output(gen)\n  })\n  val enqPtr     = RegInit(0.U((log2Up(n)).W))\n  val deqPtr     = RegInit(0.U((log2Up(n)).W))\n  val isFull     = RegInit(false.B)\n  val doEnq      = io.enqRdy && io.enqVal\n  val doDeq      = io.deqRdy && io.deqVal\n  val isEmpty    = !isFull && (enqPtr === deqPtr)\n  val deqPtrInc  = deqPtr + 1.U\n  val enqPtrInc  = enqPtr + 1.U\n  val isFullNext = Mux(doEnq && ~doDeq && (enqPtrInc === deqPtr),\n                         true.B, Mux(doDeq && isFull, false.B,\n                         isFull))\n  enqPtr := Mux(doEnq, enqPtrInc, enqPtr)\n  deqPtr := Mux(doDeq, deqPtrInc, deqPtr)\n  isFull := isFullNext\n  val ram = Mem(n, gen)\n  when (doEnq) {\n    ram(enqPtr) := io.enqDat\n  }\n  io.enqRdy := !isFull\n  io.deqVal := !isEmpty\n  ram(deqPtr) <> io.deqDat\n}\n"})}),"\n",(0,a.jsx)(n.p,{children:"An Fifo with 8 elements of type DataBundle could then be instantiated as:"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"val fifo = Module(new Fifo(new DataBundle, 8))\n"})}),"\n",(0,a.jsx)(n.p,{children:"It is also possible to define a generic decoupled (ready/valid) interface:"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"class DecoupledIO[T <: Data](data: T) extends Bundle {\n  val ready = Input(Bool())\n  val valid = Output(Bool())\n  val bits  = Output(data)\n}\n"})}),"\n",(0,a.jsx)(n.p,{children:"This template can then be used to add a handshaking protocol to any\nset of signals:"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"class DecoupledDemo extends DecoupledIO(new DataBundle)\n"})}),"\n",(0,a.jsx)(n.p,{children:"The FIFO interface can be now be simplified as follows:"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"class Fifo[T <: Data](data: T, n: Int) extends Module {\n  val io = IO(new Bundle {\n    val enq = Flipped(new DecoupledIO(data))\n    val deq = new DecoupledIO(data)\n  })\n  // ...\n}\n"})}),"\n",(0,a.jsx)(n.h2,{id:"parametrization-based-on-modules",children:"Parametrization based on Modules"}),"\n",(0,a.jsx)(n.p,{children:"You can also parametrize modules based on other modules rather than just types. The following is an example of a module parametrized by other modules as opposed to e.g. types."}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"import chisel3.RawModule\nimport chisel3.experimental.BaseModule\nimport circt.stage.ChiselStage\n\n// Provides a more specific interface since generic Module\n// provides no compile-time information on generic module's IOs.\ntrait MyAdder {\n    def in1: UInt\n    def in2: UInt\n    def out: UInt\n}\n\nclass Mod1 extends RawModule with MyAdder {\n    val in1 = IO(Input(UInt(8.W)))\n    val in2 = IO(Input(UInt(8.W)))\n    val out = IO(Output(UInt(8.W)))\n    out := in1 + in2\n}\n\nclass Mod2 extends RawModule with MyAdder {\n    val in1 = IO(Input(UInt(8.W)))\n    val in2 = IO(Input(UInt(8.W)))\n    val out = IO(Output(UInt(8.W)))\n    out := in1 - in2\n}\n\nclass X[T <: BaseModule with MyAdder](genT: => T) extends Module {\n    val io = IO(new Bundle {\n        val in1 = Input(UInt(8.W))\n        val in2 = Input(UInt(8.W))\n        val out = Output(UInt(8.W))\n    })\n    val subMod = Module(genT)\n    io.out := subMod.out\n    subMod.in1 := io.in1\n    subMod.in2 := io.in2\n}\n\nprintln(ChiselStage.emitSystemVerilog(new X(new Mod1)))\nprintln(ChiselStage.emitSystemVerilog(new X(new Mod2)))\n"})}),"\n",(0,a.jsx)(n.p,{children:"Output:"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Mod1(\t// polymorphism-and-parameterization.md:170:7\n  input  [7:0] in1,\t// polymorphism-and-parameterization.md:171:17\n               in2,\t// polymorphism-and-parameterization.md:172:17\n  output [7:0] out\t// polymorphism-and-parameterization.md:173:17\n);\n\n  assign out = in1 + in2;\t// polymorphism-and-parameterization.md:170:7, :174:16\nendmodule\n\nmodule X(\t// polymorphism-and-parameterization.md:186:7\n  input        clock,\t// polymorphism-and-parameterization.md:186:7\n               reset,\t// polymorphism-and-parameterization.md:186:7\n  input  [7:0] io_in1,\t// polymorphism-and-parameterization.md:187:16\n               io_in2,\t// polymorphism-and-parameterization.md:187:16\n  output [7:0] io_out\t// polymorphism-and-parameterization.md:187:16\n);\n\n  Mod1 subMod (\t// polymorphism-and-parameterization.md:192:24\n    .in1 (io_in1),\n    .in2 (io_in2),\n    .out (io_out)\n  );\t// polymorphism-and-parameterization.md:192:24\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_X_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_X_Verification.sv"\n`ifndef layers_X_Verification_Cover\n`define layers_X_Verification_Cover\t// <stdin>:6:5\n`endif // layers_X_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_X_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_X_Verification.sv"\n`ifndef layers_X_Verification_Assume\n`define layers_X_Verification_Assume\t// <stdin>:5:5\n`endif // layers_X_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_X_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_X_Verification.sv"\n`ifndef layers_X_Verification_Assert\n`define layers_X_Verification_Assert\t// <stdin>:4:5\n`endif // layers_X_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_X_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_X_Verification\n`define layers_X_Verification\t// <stdin>:3:3\n`endif // layers_X_Verification\t// <stdin>:3:3\n// Generated by CIRCT firtool-1.81.1\nmodule Mod2(\t// polymorphism-and-parameterization.md:178:7\n  input  [7:0] in1,\t// polymorphism-and-parameterization.md:179:17\n               in2,\t// polymorphism-and-parameterization.md:180:17\n  output [7:0] out\t// polymorphism-and-parameterization.md:181:17\n);\n\n  assign out = in1 - in2;\t// polymorphism-and-parameterization.md:178:7, :182:16\nendmodule\n\nmodule X(\t// polymorphism-and-parameterization.md:186:7\n  input        clock,\t// polymorphism-and-parameterization.md:186:7\n               reset,\t// polymorphism-and-parameterization.md:186:7\n  input  [7:0] io_in1,\t// polymorphism-and-parameterization.md:187:16\n               io_in2,\t// polymorphism-and-parameterization.md:187:16\n  output [7:0] io_out\t// polymorphism-and-parameterization.md:187:16\n);\n\n  Mod2 subMod (\t// polymorphism-and-parameterization.md:192:24\n    .in1 (io_in1),\n    .in2 (io_in2),\n    .out (io_out)\n  );\t// polymorphism-and-parameterization.md:192:24\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_X_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_X_Verification.sv"\n`ifndef layers_X_Verification_Cover\n`define layers_X_Verification_Cover\t// <stdin>:6:5\n`endif // layers_X_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_X_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_X_Verification.sv"\n`ifndef layers_X_Verification_Assume\n`define layers_X_Verification_Assume\t// <stdin>:5:5\n`endif // layers_X_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_X_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_X_Verification.sv"\n`ifndef layers_X_Verification_Assert\n`define layers_X_Verification_Assert\t// <stdin>:4:5\n`endif // layers_X_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_X_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_X_Verification\n`define layers_X_Verification\t// <stdin>:3:3\n`endif // layers_X_Verification\t// <stdin>:3:3\n'})})]})}function p(e={}){const{wrapper:n}={...(0,t.R)(),...e.components};return n?(0,a.jsx)(n,{...e,children:(0,a.jsx)(c,{...e})}):c(e)}},8453:(e,n,i)=>{i.d(n,{R:()=>s,x:()=>r});var a=i(6540);const t={},o=a.createContext(t);function s(e){const n=a.useContext(o);return a.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function r(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(t):e.components||t:s(e.components),a.createElement(o.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/7e1e4a75.82d2355a.js b/assets/js/7e1e4a75.82d2355a.js
deleted file mode 100644
index 667296afd9..0000000000
--- a/assets/js/7e1e4a75.82d2355a.js
+++ /dev/null
@@ -1 +0,0 @@
-"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[5432],{9730:(e,n,o)=>{o.r(n),o.d(n,{assets:()=>r,contentTitle:()=>s,default:()=>h,frontMatter:()=>l,metadata:()=>c,toc:()=>d});var t=o(4848),a=o(8453),i=o(1871);const l={sidebar_position:0},s="General Cookbook",c={id:"cookbooks/cookbook",title:"General Cookbook",description:"Please note that these examples make use of Chisel's scala-style printing.",source:"@site/docs/cookbooks/cookbook.md",sourceDirName:"cookbooks",slug:"/cookbooks/cookbook",permalink:"/docs/cookbooks/cookbook",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/cookbooks/cookbook.md",tags:[],version:"current",sidebarPosition:0,frontMatter:{sidebar_position:0},sidebar:"chiselSidebar",previous:{title:"Cookbooks",permalink:"/docs/cookbooks"},next:{title:"Naming Cookbook",permalink:"/docs/cookbooks/naming"}},r={},d=[{value:"Type Conversions",id:"type-conversions",level:2},{value:"How do I create a UInt from an instance of a Bundle?",id:"how-do-i-create-a-uint-from-an-instance-of-a-bundle",level:3},{value:"How do I create a Bundle from a UInt?",id:"how-do-i-create-a-bundle-from-a-uint",level:3},{value:"How can I tieoff a Bundle/Vec to 0?",id:"how-can-i-tieoff-a-bundlevec-to-0",level:3},{value:"How do I create a Vec of Bools from a UInt?",id:"how-do-i-create-a-vec-of-bools-from-a-uint",level:3},{value:"How do I create a UInt from a Vec of Bool?",id:"how-do-i-create-a-uint-from-a-vec-of-bool",level:3},{value:"How do I connect a subset of Bundle fields?",id:"how-do-i-connect-a-subset-of-bundle-fields",level:3},{value:"Vectors and Registers",id:"vectors-and-registers",level:2},{value:"Can I make a 2D or 3D Vector?",id:"can-i-make-a-2d-or-3d-vector",level:3},{value:"How do I create a Vector of Registers?",id:"how-do-i-create-a-vector-of-registers",level:3},{value:"How do I create a Reg of type Vec?",id:"how-do-i-create-a-reg-of-type-vec",level:3},{value:"How do I partially reset an Aggregate Reg?",id:"how-do-i-partially-reset-an-aggregate-reg",level:3},{value:"Bundles",id:"bundles",level:2},{value:"How do I deal with aliased Bundle fields?",id:"how-do-i-deal-with-aliased-bundle-fields",level:3},{value:"1. 0-arity function parameters",id:"1-0-arity-function-parameters",level:4},{value:"Aliased Warning",id:"aliased-warning",level:5},{value:"2. By-name function parameters",id:"2-by-name-function-parameters",level:4},{value:"3. Directioned Bundle fields",id:"3-directioned-bundle-fields",level:4},{value:"4. Call <code>.cloneType</code> directly",id:"4-call-clonetype-directly",level:4},{value:"<a></a> How do I deal with the &quot;unable to clone&quot; error?",id:"-how-do-i-deal-with-the-unable-to-clone-error",level:3},{value:"How do I create a finite state machine (FSM)?",id:"how-do-i-create-a-finite-state-machine-fsm",level:2},{value:"How do I unpack a value (&quot;reverse concatenation&quot;) like in Verilog?",id:"how-do-i-unpack-a-value-reverse-concatenation-like-in-verilog",level:2},{value:"How do I do subword assignment (assign to some bits in a UInt)?",id:"how-do-i-do-subword-assignment-assign-to-some-bits-in-a-uint",level:2},{value:"How do I create an optional I/O?",id:"how-do-i-create-an-optional-io",level:2},{value:"How do I create I/O without a prefix?",id:"how-do-i-create-io-without-a-prefix",level:2},{value:"How do I override the implicit clock or reset within a Module?",id:"how-do-i-override-the-implicit-clock-or-reset-within-a-module",level:2},{value:"How do I minimize the number of bits used in an output vector?",id:"how-do-i-minimize-the-number-of-bits-used-in-an-output-vector",level:2},{value:"How do I resolve &quot;Dynamic index ... is too wide/narrow for extractee ...&quot;?",id:"how-do-i-resolve-dynamic-index--is-too-widenarrow-for-extractee-",level:2},{value:"Use bit extraction when the index is too wide",id:"use-bit-extraction-when-the-index-is-too-wide",level:4},{value:"Predictable Naming",id:"predictable-naming",level:2},{value:"How do I get Chisel to name signals properly in blocks like when/withClockAndReset?",id:"how-do-i-get-chisel-to-name-signals-properly-in-blocks-like-whenwithclockandreset",level:3},{value:"How do I get Chisel to name the results of vector reads properly?",id:"how-do-i-get-chisel-to-name-the-results-of-vector-reads-properly",level:3},{value:"How can I dynamically set/parametrize the name of a module?",id:"how-can-i-dynamically-setparametrize-the-name-of-a-module",level:3},{value:"Directionality",id:"directionality",level:2},{value:"How do I strip directions from a bidirectional Bundle (or other Data)?",id:"how-do-i-strip-directions-from-a-bidirectional-bundle-or-other-data",level:3}];function u(e){const n={a:"a",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",h4:"h4",h5:"h5",p:"p",pre:"pre",strong:"strong",...(0,a.R)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.h1,{id:"general-cookbook",children:"General Cookbook"}),"\n",(0,t.jsxs)(n.p,{children:["Please note that these examples make use of ",(0,t.jsx)(n.a,{href:"../explanations/printing#scala-style",children:"Chisel's scala-style printing"}),"."]}),"\n","\n","\n",(0,t.jsx)(i.A,{toc:d}),"\n",(0,t.jsx)(n.h2,{id:"type-conversions",children:"Type Conversions"}),"\n",(0,t.jsx)(n.h3,{id:"how-do-i-create-a-uint-from-an-instance-of-a-bundle",children:"How do I create a UInt from an instance of a Bundle?"}),"\n",(0,t.jsxs)(n.p,{children:["Call ",(0,t.jsx)(n.a,{href:"https://www.chisel-lang.org/api/latest/chisel3/Bundle.html#asUInt:chisel3.UInt",children:(0,t.jsx)(n.code,{children:"asUInt"})})," on the ",(0,t.jsx)(n.a,{href:"https://www.chisel-lang.org/api/latest/chisel3/Bundle.html",children:(0,t.jsx)(n.code,{children:"Bundle"})})," instance."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'import chisel3._\n\nclass MyBundle extends Bundle {\n  val foo = UInt(4.W)\n  val bar = UInt(4.W)\n}\n\nclass Foo extends Module {\n  val bundle = Wire(new MyBundle)\n  bundle.foo := 0xc.U\n  bundle.bar := 0x3.U\n  val uint = bundle.asUInt\n  printf(cf"$uint") // 195\n\n  // Test\n  assert(uint === 0xc3.U)\n}\n'})}),"\n",(0,t.jsx)(n.h3,{id:"how-do-i-create-a-bundle-from-a-uint",children:"How do I create a Bundle from a UInt?"}),"\n",(0,t.jsxs)(n.p,{children:["Use the ",(0,t.jsx)(n.a,{href:"https://www.chisel-lang.org/api/latest/chisel3/UInt.html#asTypeOf%5BT%3C:chisel3.Data%5D(that:T):T",children:(0,t.jsx)(n.code,{children:"asTypeOf"})})," method to reinterpret the ",(0,t.jsx)(n.a,{href:"https://www.chisel-lang.org/api/latest/chisel3/UInt.html",children:(0,t.jsx)(n.code,{children:"UInt"})})," as the type of the ",(0,t.jsx)(n.a,{href:"https://www.chisel-lang.org/api/latest/chisel3/Bundle.html",children:(0,t.jsx)(n.code,{children:"Bundle"})}),"."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'import chisel3._\n\nclass MyBundle extends Bundle {\n  val foo = UInt(4.W)\n  val bar = UInt(4.W)\n}\n\nclass Foo extends Module {\n  val uint = 0xb4.U\n  val bundle = uint.asTypeOf(new MyBundle)\n\n  printf(cf"$bundle") // Bundle(foo -> 11, bar -> 4)\n\n  // Test\n  assert(bundle.foo === 0xb.U)\n  assert(bundle.bar === 0x4.U)\n}\n'})}),"\n",(0,t.jsx)(n.h3,{id:"how-can-i-tieoff-a-bundlevec-to-0",children:"How can I tieoff a Bundle/Vec to 0?"}),"\n",(0,t.jsxs)(n.p,{children:["You can use ",(0,t.jsx)(n.code,{children:"asTypeOf"})," as above. If you don't want to worry about the type of the thing\nyou are tying off, you can use ",(0,t.jsx)(n.code,{children:"chiselTypeOf"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport circt.stage.ChiselStage\n\nclass MyBundle extends Bundle {\n  val foo = UInt(4.W)\n  val bar = Vec(4, UInt(1.W))\n}\n\nclass Foo(typ: MyBundle) extends Module {\n  val bundleA = IO(Output(typ))\n  val bundleB = IO(Output(typ))\n\n  // typ is already a Chisel Data Type, so can use it directly here, but you\n  // need to know that bundleA is of type typ\n  bundleA := 0.U.asTypeOf(typ)\n\n  // bundleB is a Hardware data IO(Output(...)) so need to call chiselTypeOf,\n  // but this will work no matter the type of bundleB:\n  bundleB := 0.U.asTypeOf(chiselTypeOf(bundleB))\n}\n\nChiselStage.emitSystemVerilog(new Foo(new MyBundle))\n"})}),"\n",(0,t.jsx)(n.h3,{id:"how-do-i-create-a-vec-of-bools-from-a-uint",children:"How do I create a Vec of Bools from a UInt?"}),"\n",(0,t.jsxs)(n.p,{children:["Use ",(0,t.jsx)(n.a,{href:"https://www.chisel-lang.org/api/latest/chisel3/VecInit$.html",children:(0,t.jsx)(n.code,{children:"VecInit"})})," given a ",(0,t.jsx)(n.code,{children:"Seq[Bool]"})," generated using the ",(0,t.jsx)(n.a,{href:"https://www.chisel-lang.org/api/latest/chisel3/UInt.html#asBools:Seq%5Bchisel3.Bool%5D",children:(0,t.jsx)(n.code,{children:"asBools"})})," method."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'import chisel3._\n\nclass Foo extends Module {\n  val uint = 0xc.U\n  val vec = VecInit(uint.asBools)\n\n  printf(cf"$vec") // Vec(0, 0, 1, 1)\n\n  // Test\n  assert(vec(0) === false.B)\n  assert(vec(1) === false.B)\n  assert(vec(2) === true.B)\n  assert(vec(3) === true.B)\n}\n'})}),"\n",(0,t.jsx)(n.h3,{id:"how-do-i-create-a-uint-from-a-vec-of-bool",children:"How do I create a UInt from a Vec of Bool?"}),"\n",(0,t.jsxs)(n.p,{children:["Use the builtin function ",(0,t.jsx)(n.a,{href:"https://www.chisel-lang.org/api/latest/chisel3/Vec.html#asUInt:chisel3.UInt",children:(0,t.jsx)(n.code,{children:"asUInt"})})]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'import chisel3._\n\nclass Foo extends Module {\n  val vec = VecInit(true.B, false.B, true.B, true.B)\n  val uint = vec.asUInt\n\n  printf(cf"$uint") // 13\n\n  // Test\n  // (remember leftmost Bool in Vec is low order bit)\n  assert(0xd.U === uint)\n\n}\n'})}),"\n",(0,t.jsx)(n.h3,{id:"how-do-i-connect-a-subset-of-bundle-fields",children:"How do I connect a subset of Bundle fields?"}),"\n",(0,t.jsxs)(n.p,{children:["See the ",(0,t.jsx)(n.a,{href:"dataview#how-do-i-connect-a-subset-of-bundle-fields",children:"DataView cookbook"}),"."]}),"\n",(0,t.jsx)(n.h2,{id:"vectors-and-registers",children:"Vectors and Registers"}),"\n",(0,t.jsx)(n.h3,{id:"can-i-make-a-2d-or-3d-vector",children:"Can I make a 2D or 3D Vector?"}),"\n",(0,t.jsxs)(n.p,{children:["Yes. Using ",(0,t.jsx)(n.code,{children:"VecInit"})," you can make Vectors that hold Vectors of Chisel types. Methods ",(0,t.jsx)(n.code,{children:"fill"})," and ",(0,t.jsx)(n.code,{children:"tabulate"})," make these multi-dimensional Vectors."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\nclass MyBundle extends Bundle {\n  val foo = UInt(4.W)\n  val bar = UInt(4.W)\n}\n\nclass Foo extends Module {\n  //2D Fill\n  val twoDVec = VecInit.fill(2, 3)(5.U)\n  //3D Fill\n  val myBundle = Wire(new MyBundle)\n  myBundle.foo := 0xc.U\n  myBundle.bar := 0x3.U\n  val threeDVec = VecInit.fill(1, 2, 3)(myBundle)\n  assert(threeDVec(0)(0)(0).foo === 0xc.U && threeDVec(0)(0)(0).bar === 0x3.U)\n\n  //2D Tabulate\n  val indexTiedVec = VecInit.tabulate(2, 2){ (x, y) => (x + y).U }\n  assert(indexTiedVec(0)(0) === 0.U)\n  assert(indexTiedVec(0)(1) === 1.U)\n  assert(indexTiedVec(1)(0) === 1.U)\n  assert(indexTiedVec(1)(1) === 2.U)\n  //3D Tabulate\n  val indexTiedVec3D = VecInit.tabulate(2, 3, 4){ (x, y, z) => (x + y * z).U }\n  assert(indexTiedVec3D(0)(0)(0) === 0.U)\n  assert(indexTiedVec3D(1)(1)(1) === 2.U)\n  assert(indexTiedVec3D(1)(1)(2) === 3.U)\n  assert(indexTiedVec3D(1)(1)(3) === 4.U)\n  assert(indexTiedVec3D(1)(2)(3) === 7.U)\n}\n"})}),"\n",(0,t.jsx)(n.h3,{id:"how-do-i-create-a-vector-of-registers",children:"How do I create a Vector of Registers?"}),"\n",(0,t.jsx)(n.p,{children:(0,t.jsx)(n.strong,{children:"Rule!  Use Reg of Vec not Vec of Reg!"})}),"\n",(0,t.jsxs)(n.p,{children:["You create a ",(0,t.jsx)(n.a,{href:"#how-do-i-create-a-reg-of-type-vec",children:"Reg of type Vec"}),". Because Vecs are a ",(0,t.jsx)(n.em,{children:"type"})," (like ",(0,t.jsx)(n.code,{children:"UInt"}),", ",(0,t.jsx)(n.code,{children:"Bool"}),") rather than a ",(0,t.jsx)(n.em,{children:"value"}),", we must bind the Vec to some concrete ",(0,t.jsx)(n.em,{children:"value"}),"."]}),"\n",(0,t.jsx)(n.h3,{id:"how-do-i-create-a-reg-of-type-vec",children:"How do I create a Reg of type Vec?"}),"\n",(0,t.jsxs)(n.p,{children:["For more information, the API Documentation for ",(0,t.jsx)(n.a,{href:"https://www.chisel-lang.org/api/latest/chisel3/Vec.html",children:(0,t.jsx)(n.code,{children:"Vec"})})," provides more information."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\nclass Foo extends Module {\n  val regOfVec = Reg(Vec(4, UInt(32.W))) // Register of 32-bit UInts\n  regOfVec(0) := 123.U                   // Assignments to elements of the Vec\n  regOfVec(1) := 456.U\n  regOfVec(2) := 789.U\n  regOfVec(3) := regOfVec(0)\n\n  // Reg of Vec of 32-bit UInts initialized to zero\n  //   Note that Seq.fill constructs 4 32-bit UInt literals with the value 0\n  //   VecInit(...) then constructs a Wire of these literals\n  //   The Reg is then initialized to the value of the Wire (which gives it the same type)\n  val initRegOfVec = RegInit(VecInit(Seq.fill(4)(0.U(32.W))))\n}\n"})}),"\n",(0,t.jsx)(n.h3,{id:"how-do-i-partially-reset-an-aggregate-reg",children:"How do I partially reset an Aggregate Reg?"}),"\n",(0,t.jsxs)(n.p,{children:["The easiest way is to use a partially-specified ",(0,t.jsx)(n.a,{href:"../appendix/experimental-features#bundle-literals",children:"Bundle Literal"}),"\nor ",(0,t.jsx)(n.a,{href:"../appendix/experimental-features#vec-literals",children:"Vec Literal"})," to match the type of the Reg."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.BundleLiterals._\n\nclass MyBundle extends Bundle {\n  val foo = UInt(8.W)\n  val bar = UInt(8.W)\n}\n\nclass MyModule extends Module {\n  // Only .foo will be reset, .bar will have no reset value\n  val reg = RegInit((new MyBundle).Lit(_.foo -> 123.U))\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["If your initial value is not a literal, or if you just prefer, you can use a\nWire as the initial value for the Reg. Simply connect fields to ",(0,t.jsx)(n.code,{children:"DontCare"})," that\nyou do not wish to be reset."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class MyModule2 extends Module {\n  val reg = RegInit({\n    // The wire could be constructed before the reg rather than in the RegInit scope,\n    // but this style has nice lexical scoping behavior, keeping the Wire private\n    val init = Wire(new MyBundle)\n    init := DontCare // No fields will be reset\n    init.foo := 123.U // Last connect override, .foo is reset\n    init\n  })\n}\n"})}),"\n",(0,t.jsx)(n.h2,{id:"bundles",children:"Bundles"}),"\n",(0,t.jsx)(n.h3,{id:"how-do-i-deal-with-aliased-bundle-fields",children:"How do I deal with aliased Bundle fields?"}),"\n",(0,t.jsxs)(n.p,{children:["Following the ",(0,t.jsx)(n.code,{children:"gen"})," pattern when creating Bundles can result in some opaque error messages:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class AliasedBundle[T <: Data](gen: T) extends Bundle {\n  val foo = gen\n  val bar = gen\n}\n"})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"getVerilogString(new Top(new AliasedBundle(UInt(8.W))))\n// chisel3.AliasedAggregateFieldException: AliasedBundle contains aliased fields named (foo,bar)\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp17$Top$$anonfun$50$$anonfun$apply$37.apply(cookbook.md:301)\n// \tat repl.MdocSession$MdocApp17$Top$$anonfun$50$$anonfun$apply$37.apply(cookbook.md:301)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp17$Top$$anonfun$50.apply(cookbook.md:301)\n// \tat repl.MdocSession$MdocApp17$Top$$anonfun$50.apply(cookbook.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp17$Top.<init>(cookbook.md:301)\n// \tat repl.MdocSession$MdocApp17$$anonfun$55$$anonfun$apply$43.apply(cookbook.md:320)\n// \tat repl.MdocSession$MdocApp17$$anonfun$55$$anonfun$apply$43.apply(cookbook.md:320)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,t.jsxs)(n.p,{children:["This error is saying that fields ",(0,t.jsx)(n.code,{children:"foo"})," and ",(0,t.jsx)(n.code,{children:"bar"})," of ",(0,t.jsx)(n.code,{children:"AliasedBundle"})," are the\nexact same object in memory.\nThis is a problem for Chisel because we need to be able to distinguish uses of\n",(0,t.jsx)(n.code,{children:"foo"})," and ",(0,t.jsx)(n.code,{children:"bar"})," but cannot when they are referentially the same."]}),"\n",(0,t.jsx)(n.p,{children:"Note that the following example looks different but will give you exactly the same issue:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class AlsoAliasedBundle[T <: Data](val gen: T) extends Bundle {\n                                // ^ This val makes `gen` a field, just like `foo`\n  val foo = gen\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["By making ",(0,t.jsx)(n.code,{children:"gen"})," a ",(0,t.jsx)(n.code,{children:"val"}),", it becomes a public field of the ",(0,t.jsx)(n.code,{children:"class"}),", just like ",(0,t.jsx)(n.code,{children:"foo"}),"."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"getVerilogString(new Top(new AlsoAliasedBundle(UInt(8.W))))\n// chisel3.AliasedAggregateFieldException: AlsoAliasedBundle contains aliased fields named (gen,foo)\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp17$Top$$anonfun$50$$anonfun$apply$37.apply(cookbook.md:301)\n// \tat repl.MdocSession$MdocApp17$Top$$anonfun$50$$anonfun$apply$37.apply(cookbook.md:301)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp17$Top$$anonfun$50.apply(cookbook.md:301)\n// \tat repl.MdocSession$MdocApp17$Top$$anonfun$50.apply(cookbook.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp17$Top.<init>(cookbook.md:301)\n// \tat repl.MdocSession$MdocApp17$$anonfun$57$$anonfun$apply$44.apply(cookbook.md:339)\n// \tat repl.MdocSession$MdocApp17$$anonfun$57$$anonfun$apply$44.apply(cookbook.md:339)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,t.jsx)(n.p,{children:"There are several ways to solve this issue with their own advantages and disadvantages."}),"\n",(0,t.jsx)(n.h4,{id:"1-0-arity-function-parameters",children:"1. 0-arity function parameters"}),"\n",(0,t.jsx)(n.p,{children:"Instead of passing an object as a parameter, you can pass a 0-arity function (a function with no arguments):"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class UsingAFunctionBundle[T <: Data](gen: () => T) extends Bundle {\n  val foo = gen()\n  val bar = gen()\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["Note that the type of ",(0,t.jsx)(n.code,{children:"gen"})," is now ",(0,t.jsx)(n.code,{children:"() => T"}),".\nBecause it is now a function and not a subtype of ",(0,t.jsx)(n.code,{children:"Data"}),", you can safely make ",(0,t.jsx)(n.code,{children:"gen"})," a ",(0,t.jsx)(n.code,{children:"val"})," without\nit becoming a hardware field of the ",(0,t.jsx)(n.code,{children:"Bundle"}),"."]}),"\n",(0,t.jsxs)(n.p,{children:["Note that this also means you must pass ",(0,t.jsx)(n.code,{children:"gen"})," as a function, for example:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"getVerilogString(new Top(new UsingAFunctionBundle(() => UInt(8.W))))\n"})}),"\n",(0,t.jsx)(n.h5,{id:"aliased-warning",children:"Aliased Warning"}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.strong,{children:"Warning"}),": you must ensure that ",(0,t.jsx)(n.code,{children:"gen"})," creates fresh objects rather than capturing an already constructed value:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class MisusedFunctionArguments extends Module {\n  // This usage is correct\n  val in = IO(Input(new UsingAFunctionBundle(() => UInt(8.W))))\n\n  // This usage is incorrect\n  val fizz = UInt(8.W)\n  val out = IO(Output(new UsingAFunctionBundle(() => fizz)))\n}\ngetVerilogString(new MisusedFunctionArguments)\n// chisel3.AutoClonetypeException: The bundle plugin was unable to clone UsingAFunctionBundle that has field 'bar' aliased with base UsingAFunctionBundle.This likely happened because you tried nesting Data arguments inside of other data structures. Try wrapping the field(s) in Input(...), Output(...), or Flipped(...) if appropriate. As a last resort, you can call chisel3.reflect.DataMirror.internal.chiselTypeClone on any nested Data arguments. See the cookbook entry 'How do I deal with the \"unable to clone\" error?' for more details.\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp17$$anonfun$59$MisusedFunctionArguments$1$$anonfun$62$$anonfun$apply$51$$anonfun$apply$52.apply(cookbook.md:370)\n// \tat repl.MdocSession$MdocApp17$$anonfun$59$MisusedFunctionArguments$1$$anonfun$62$$anonfun$apply$51$$anonfun$apply$52.apply(cookbook.md:370)\n// \tat chisel3.IO$.apply(IO.scala:34)\n// \tat chisel3.experimental.BaseModule.IO(Module.scala:878)\n// \tat repl.MdocSession$MdocApp17$$anonfun$59$MisusedFunctionArguments$1$$anonfun$62$$anonfun$apply$51.apply(cookbook.md:370)\n// \tat repl.MdocSession$MdocApp17$$anonfun$59$MisusedFunctionArguments$1$$anonfun$62$$anonfun$apply$51.apply(cookbook.md:370)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp17$$anonfun$59$MisusedFunctionArguments$1$$anonfun$62.apply(cookbook.md:370)\n// \tat repl.MdocSession$MdocApp17$$anonfun$59$MisusedFunctionArguments$1$$anonfun$62.apply(cookbook.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp17$$anonfun$59$MisusedFunctionArguments$1.<init>(cookbook.md:370)\n// \tat repl.MdocSession$MdocApp17$$anonfun$59$$anonfun$apply$55.apply(cookbook.md:372)\n// \tat repl.MdocSession$MdocApp17$$anonfun$59$$anonfun$apply$55.apply(cookbook.md:372)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,t.jsxs)(n.p,{children:["In the above example, value ",(0,t.jsx)(n.code,{children:"fizz"})," and fields ",(0,t.jsx)(n.code,{children:"foo"})," and ",(0,t.jsx)(n.code,{children:"bar"})," of ",(0,t.jsx)(n.code,{children:"out"})," are all the same object in memory."]}),"\n",(0,t.jsx)(n.h4,{id:"2-by-name-function-parameters",children:"2. By-name function parameters"}),"\n",(0,t.jsxs)(n.p,{children:["Functionally the same as (1) but with more subtle syntax, you can use ",(0,t.jsx)(n.a,{href:"https://docs.scala-lang.org/tour/by-name-parameters.html",children:"Scala by-name function parameters"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class UsingByNameParameters[T <: Data](gen: => T) extends Bundle {\n  val foo = gen\n  val bar = gen\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["With this usage, you do not include ",(0,t.jsx)(n.code,{children:"() =>"})," when passing the argument:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"getVerilogString(new Top(new UsingByNameParameters(UInt(8.W))))\n"})}),"\n",(0,t.jsxs)(n.p,{children:["Note that as this is just syntactic sugar over (1), the ",(0,t.jsx)(n.a,{href:"#aliased-warning",children:"same warning applies"}),"."]}),"\n",(0,t.jsx)(n.h4,{id:"3-directioned-bundle-fields",children:"3. Directioned Bundle fields"}),"\n",(0,t.jsxs)(n.p,{children:["You can alternatively wrap the fields with ",(0,t.jsx)(n.code,{children:"Output(...)"}),", which creates fresh instances of the passed argument.\nChisel treats ",(0,t.jsx)(n.code,{children:"Output"}),' as the "default direction" so if all fields are outputs, the ',(0,t.jsx)(n.code,{children:"Bundle"})," is functionally equivalent to a ",(0,t.jsx)(n.code,{children:"Bundle"})," with no directioned fields."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class DirectionedBundle[T <: Data](gen: T) extends Bundle {\n  val foo = Output(gen)\n  val bar = Output(gen)\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["This approach is admittedly a little ugly and may mislead others reading the code because it implies that this Bundle is intended to be used as an ",(0,t.jsx)(n.code,{children:"Output"}),"."]}),"\n",(0,t.jsxs)(n.h4,{id:"4-call-clonetype-directly",children:["4. Call ",(0,t.jsx)(n.code,{children:".cloneType"})," directly"]}),"\n",(0,t.jsxs)(n.p,{children:["You can also just call ",(0,t.jsx)(n.code,{children:".cloneType"})," on your ",(0,t.jsx)(n.code,{children:"gen"})," argument directly.\nWhile we try to hide this implementation detail from the user, ",(0,t.jsx)(n.code,{children:".cloneType"})," is the mechanism by which Chisel creates fresh instances of ",(0,t.jsx)(n.code,{children:"Data"})," objects:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class UsingCloneTypeBundle[T <: Data](gen: T) extends Bundle {\n  val foo = gen.cloneType\n  val bar = gen.cloneType\n}\n"})}),"\n",(0,t.jsxs)(n.h3,{id:"-how-do-i-deal-with-the-unable-to-clone-error",children:[(0,t.jsx)("a",{name:"bundle-unable-to-clone"}),' How do I deal with the "unable to clone" error?']}),"\n",(0,t.jsx)(n.p,{children:'Most Chisel objects need to be cloned in order to differentiate between the\nsoftware representation of the bundle field from its "bound" hardware\nrepresentation, where "binding" is the process of generating a hardware\ncomponent. For Bundle fields, this cloning is supposed to happen automatically\nwith a compiler plugin.'}),"\n",(0,t.jsxs)(n.p,{children:["In some cases though, the plugin may not be able to clone the Bundle fields. The\nmost common case for when this happens is when the ",(0,t.jsx)(n.code,{children:"chisel3.Data"})," part of the\nBundle field is nested inside some other data structure and the compiler plugin\nis unable to figure out how to clone the entire structure. It is best to avoid\nsuch nested structures."]}),"\n",(0,t.jsxs)(n.p,{children:["There are a few ways around this issue - you can try wrapping the problematic\nfields in Input(...), Output(...), or Flipped(...) if appropriate. You can also\ntry manually cloning each field in the Bundle using the ",(0,t.jsx)(n.code,{children:"chiselTypeClone"})," method\nin ",(0,t.jsx)(n.code,{children:"chisel3.reflect.DataMirror"}),". Here's an example with the Bundle whose fields\nwon't get cloned:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'class CustomBundleBroken(elts: (String, Data)*) extends Record {\n  val elements = ListMap(elts: _*)\n\n  def apply(elt: String): Data = elements(elt)\n}\n\nclass NewModule extends Module {\n  val out = Output(UInt(8.W))\n  val recordType = new CustomBundleBroken("fizz" -> UInt(16.W), "buzz" -> UInt(16.W))\n  val record = Wire(recordType)\n  val uint = record.asUInt\n  val record2 = uint.asTypeOf(recordType)\n  out := record\n}\ngetVerilogString(new NewModule)\n// chisel3.AutoClonetypeException: The bundle plugin was unable to clone CustomBundleBroken$1 that has field \'fizz\' aliased with base CustomBundleBroken$1.This likely happened because you tried nesting Data arguments inside of other data structures. Try wrapping the field(s) in Input(...), Output(...), or Flipped(...) if appropriate. As a last resort, you can call chisel3.reflect.DataMirror.internal.chiselTypeClone on any nested Data arguments. See the cookbook entry \'How do I deal with the "unable to clone" error?\' for more details.\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp17$$anonfun$70$NewModule$1$$anonfun$74$$anonfun$apply$63.apply(cookbook.md:444)\n// \tat repl.MdocSession$MdocApp17$$anonfun$70$NewModule$1$$anonfun$74$$anonfun$apply$63.apply(cookbook.md:444)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp17$$anonfun$70$NewModule$1$$anonfun$74.apply(cookbook.md:444)\n// \tat repl.MdocSession$MdocApp17$$anonfun$70$NewModule$1$$anonfun$74.apply(cookbook.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp17$$anonfun$70$NewModule$1.<init>(cookbook.md:444)\n// \tat repl.MdocSession$MdocApp17$$anonfun$70$$anonfun$apply$67.apply(cookbook.md:449)\n// \tat repl.MdocSession$MdocApp17$$anonfun$70$$anonfun$apply$67.apply(cookbook.md:449)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n'})}),"\n",(0,t.jsxs)(n.p,{children:["You can use ",(0,t.jsx)(n.code,{children:"chiselTypeClone"})," to clone the elements as:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3.reflect.DataMirror\nimport chisel3.experimental.requireIsChiselType\n\nclass CustomBundleFixed(elts: (String, Data)*) extends Record {\n  val elements = ListMap(elts.map {\n    case (field, elt) =>\n      requireIsChiselType(elt)\n      field -> DataMirror.internal.chiselTypeClone(elt)\n  }: _*)\n\n  def apply(elt: String): Data = elements(elt)\n}\n"})}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-create-a-finite-state-machine-fsm",children:"How do I create a finite state machine (FSM)?"}),"\n",(0,t.jsxs)(n.p,{children:["The advised way is to use ",(0,t.jsx)(n.code,{children:"ChiselEnum"})," to construct enumerated types representing the state of the FSM.\nState transitions are then handled with ",(0,t.jsx)(n.code,{children:"switch"}),"/",(0,t.jsx)(n.code,{children:"is"})," and ",(0,t.jsx)(n.code,{children:"when"}),"/",(0,t.jsx)(n.code,{children:".elsewhen"}),"/",(0,t.jsx)(n.code,{children:".otherwise"}),"."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.util.{switch, is}\n\nobject DetectTwoOnes {\n  object State extends ChiselEnum {\n    val sNone, sOne1, sTwo1s = Value\n  }\n}\n\n/* This FSM detects two 1's one after the other */\nclass DetectTwoOnes extends Module {\n  import DetectTwoOnes.State\n  import DetectTwoOnes.State._\n\n  val io = IO(new Bundle {\n    val in = Input(Bool())\n    val out = Output(Bool())\n    val state = Output(State())\n  })\n\n  val state = RegInit(sNone)\n\n  io.out := (state === sTwo1s)\n  io.state := state\n\n  switch (state) {\n    is (sNone) {\n      when (io.in) {\n        state := sOne1\n      }\n    }\n    is (sOne1) {\n      when (io.in) {\n        state := sTwo1s\n      } .otherwise {\n        state := sNone\n      }\n    }\n    is (sTwo1s) {\n      when (!io.in) {\n        state := sNone\n      }\n    }\n  }\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["Note: the ",(0,t.jsx)(n.code,{children:"is"})," statement can take multiple conditions e.g. ",(0,t.jsx)(n.code,{children:"is (sTwo1s, sOne1) { ... }"}),"."]}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-unpack-a-value-reverse-concatenation-like-in-verilog",children:'How do I unpack a value ("reverse concatenation") like in Verilog?'}),"\n",(0,t.jsxs)(n.p,{children:["In Verilog, you can do something like the following which will unpack a the value ",(0,t.jsx)(n.code,{children:"z"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"wire [1:0] a;\nwire [3:0] b;\nwire [2:0] c;\nwire [8:0] z = [...];\nassign {a,b,c} = z;\n"})}),"\n",(0,t.jsx)(n.p,{children:"Unpacking often corresponds to reinterpreting an unstructured data type as a structured data type.\nFrequently, this structured type is used prolifically in the design, and has been declared as in the following example:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\nclass MyBundle extends Bundle {\n  val a = UInt(2.W)\n  val b = UInt(4.W)\n  val c = UInt(3.W)\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"The easiest way to accomplish this in Chisel would be:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'class Foo extends Module {\n  val z = Wire(UInt(9.W))\n  z := DontCare // This is a dummy connection\n  val unpacked = z.asTypeOf(new MyBundle)\n  printf("%d", unpacked.a)\n  printf("%d", unpacked.b)\n  printf("%d", unpacked.c)\n}\n'})}),"\n",(0,t.jsxs)(n.p,{children:["If you ",(0,t.jsx)(n.strong,{children:"really"})," need to do this for a one-off case (Think thrice! It is likely you can better structure the code using bundles), then rocket-chip has a ",(0,t.jsx)(n.a,{href:"https://github.com/freechipsproject/rocket-chip/blob/723af5e6b69e07b5f94c46269a208a8d65e9d73b/src/main/scala/util/Misc.scala#L140",children:"Split utility"})," which can accomplish this."]}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-do-subword-assignment-assign-to-some-bits-in-a-uint",children:"How do I do subword assignment (assign to some bits in a UInt)?"}),"\n",(0,t.jsxs)(n.p,{children:["You may try to do something like the following where you want to assign only some bits of a Chisel type.\nBelow, the left-hand side connection to ",(0,t.jsx)(n.code,{children:"io.out(0)"})," is not allowed."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport circt.stage.ChiselStage\n\nclass Foo extends Module {\n  val io = IO(new Bundle {\n    val bit = Input(Bool())\n    val out = Output(UInt(10.W))\n  })\n  io.out(0) := io.bit\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"If you try to compile this, you will get an error."}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"getVerilogString(new Foo)\n// chisel3.package$ChiselException: Cannot reassign to read-only Foo.?: OpResult[Bool]\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp26$Foo.<init>(cookbook.md:589)\n// \tat repl.MdocSession$MdocApp26$$anonfun$104$$anonfun$apply$90.apply(cookbook.md:597)\n// \tat repl.MdocSession$MdocApp26$$anonfun$104$$anonfun$apply$90.apply(cookbook.md:597)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,t.jsxs)(n.p,{children:["Chisel3 ",(0,t.jsx)(n.em,{children:"does not support subword assignment"}),".\nThe reason for this is that subword assignment generally hints at a better abstraction with an aggregate/structured types, i.e., a ",(0,t.jsx)(n.code,{children:"Bundle"})," or a ",(0,t.jsx)(n.code,{children:"Vec"}),"."]}),"\n",(0,t.jsxs)(n.p,{children:["If you must express it this way, one approach is to blast your ",(0,t.jsx)(n.code,{children:"UInt"})," to a ",(0,t.jsx)(n.code,{children:"Vec"})," of ",(0,t.jsx)(n.code,{children:"Bool"})," and back:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\nclass Foo extends Module {\n  val io = IO(new Bundle {\n    val in = Input(UInt(10.W))\n    val bit = Input(Bool())\n    val out = Output(UInt(10.W))\n  })\n  val bools = VecInit(io.in.asBools)\n  bools(0) := io.bit\n  io.out := bools.asUInt\n}\n"})}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-create-an-optional-io",children:"How do I create an optional I/O?"}),"\n",(0,t.jsxs)(n.p,{children:["The following example is a module which includes the optional port ",(0,t.jsx)(n.code,{children:"out2"})," only if the given parameter is ",(0,t.jsx)(n.code,{children:"true"}),"."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\nclass ModuleWithOptionalIOs(flag: Boolean) extends Module {\n  val io = IO(new Bundle {\n    val in = Input(UInt(12.W))\n    val out = Output(UInt(12.W))\n    val out2 = if (flag) Some(Output(UInt(12.W))) else None\n  })\n\n  io.out := io.in\n  if (flag) {\n    io.out2.get := io.in\n  }\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["The following is an example where an entire ",(0,t.jsx)(n.code,{children:"IO"})," is optional:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\nclass ModuleWithOptionalIO(flag: Boolean) extends Module {\n  val in = if (flag) Some(IO(Input(Bool()))) else None\n  val out = IO(Output(Bool()))\n\n  out := in.getOrElse(false.B)\n}\n"})}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-create-io-without-a-prefix",children:"How do I create I/O without a prefix?"}),"\n",(0,t.jsxs)(n.p,{children:["In most cases, you can simply call ",(0,t.jsx)(n.code,{children:"IO"})," multiple times:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\nclass MyModule extends Module {\n  val in = IO(Input(UInt(8.W)))\n  val out = IO(Output(UInt(8.W)))\n\n  out := in +% 1.U\n}\n"})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule MyModule(\t// cookbook.md:691:7\n  input        clock,\t// cookbook.md:691:7\n               reset,\t// cookbook.md:691:7\n  input  [7:0] in,\t// cookbook.md:692:14\n  output [7:0] out\t// cookbook.md:693:15\n);\n\n  assign out = in + 8'h1;\t// cookbook.md:691:7, :695:13\nendmodule\n\n"})}),"\n",(0,t.jsxs)(n.p,{children:["If you have a ",(0,t.jsx)(n.code,{children:"Bundle"})," from which you would like to create ports without the\nnormal ",(0,t.jsx)(n.code,{children:"val"})," prefix, you can use ",(0,t.jsx)(n.code,{children:"FlatIO"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\nclass MyBundle extends Bundle {\n  val foo = Input(UInt(8.W))\n  val bar = Output(UInt(8.W))\n}\n\nclass MyModule extends Module {\n  val io = FlatIO(new MyBundle)\n\n  io.bar := io.foo +% 1.U\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["Note that ",(0,t.jsx)(n.code,{children:"io_"})," is nowhere to be seen!"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule MyModule(\t// cookbook.md:720:7\n  input        clock,\t// cookbook.md:720:7\n               reset,\t// cookbook.md:720:7\n  input  [7:0] foo,\t// cookbook.md:721:18\n  output [7:0] bar\t// cookbook.md:721:18\n);\n\n  assign bar = foo + 8'h1;\t// cookbook.md:720:7, :723:20\nendmodule\n\n"})}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-override-the-implicit-clock-or-reset-within-a-module",children:"How do I override the implicit clock or reset within a Module?"}),"\n",(0,t.jsxs)(n.p,{children:["To change the clock or reset for a region of code, use ",(0,t.jsx)(n.code,{children:"withClock"}),", ",(0,t.jsx)(n.code,{children:"withReset"}),", or ",(0,t.jsx)(n.code,{children:"withClockAndReset"}),".\nSee ",(0,t.jsx)(n.a,{href:"../explanations/multi-clock",children:"Multiple Clock Domains"})," for examples and details."]}),"\n",(0,t.jsxs)(n.p,{children:["To override the clock or reset for the entire scope of the ",(0,t.jsx)(n.code,{children:"Module"}),", you can mixin the ",(0,t.jsx)(n.code,{children:"ImplicitClock"})," and ",(0,t.jsx)(n.code,{children:"ImplicitReset"})," traits."]}),"\n",(0,t.jsx)(n.p,{children:'For example, you could "gate" the default implicit clock as follows:'}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nclass MyModule extends Module with ImplicitClock {\n  val gate = IO(Input(Bool()))\n  val in = IO(Input(UInt(8.W)))\n  val out = IO(Output(UInt(8.W)))\n  // We could just assign this to val implicitClock, but this allows us to give it a custom name\n  val gatedClock = (clock.asBool || gate).asClock\n  // The trait requires us to implement this method referring to the clock\n  // Note that this is a def, but the actual clock value must be assigned to a val\n  override protected def implicitClock = gatedClock\n\n  val r = Reg(UInt(8.W))\n  out := r\n  r := in\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"This gives the following Verilog:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule MyModule(\n  input        clock,\n               reset,\n               gate,\n  input  [7:0] in,\n  output [7:0] out\n);\n\n  wire       gatedClock = clock | gate;\n  reg  [7:0] r;\n  always @(posedge gatedClock)\n    r <= in;\n  assign out = r;\nendmodule\n\n"})}),"\n",(0,t.jsxs)(n.p,{children:["If you do not care about the name of the overriden clock, you can just assign it to ",(0,t.jsx)(n.code,{children:"val implicitClock"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"override protected val implicitClock = (clock.asBool || gate).asClock\n"})}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.code,{children:"ImplicitReset"})," works analogously to ",(0,t.jsx)(n.code,{children:"ImplicitClock"}),"."]}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-minimize-the-number-of-bits-used-in-an-output-vector",children:"How do I minimize the number of bits used in an output vector?"}),"\n",(0,t.jsxs)(n.p,{children:["Use inferred width and a ",(0,t.jsx)(n.code,{children:"Seq"})," instead of a ",(0,t.jsx)(n.code,{children:"Vec"}),":"]}),"\n",(0,t.jsx)(n.p,{children:"Consider:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\n// Count the number of set bits up to and including each bit position\nclass CountBits(width: Int) extends Module {\n  val bits = IO(Input(UInt(width.W)))\n  val countVector = IO(Output(Vec(width, UInt())))\n\n  private val countSequence = Seq.tabulate(width)(i => Wire(UInt()))\n  countSequence.zipWithIndex.foreach { case (port, i) =>\n    port := util.PopCount(bits(i, 0))\n  }\n  countVector := countSequence\n}\n\nclass Top(width: Int) extends Module {\n  val countBits = Module(new CountBits(width))\n  countBits.bits :<>= DontCare\n  dontTouch(countBits.bits)\n  dontTouch(countBits.countVector)\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"Note that top modules or public modules cannot have unknown widths."}),"\n",(0,t.jsxs)(n.p,{children:["Unlike ",(0,t.jsx)(n.code,{children:"Vecs"})," which represent a singular Chisel type and must have the same width for every element,\n",(0,t.jsx)(n.code,{children:"Seq"})," is a purely Scala construct, so their elements are independent from the perspective of Chisel and can have different widths."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule CountBits(\t// cookbook.md:780:7\n  input  [3:0] bits,\t// cookbook.md:781:16\n  output [2:0] countVector_0,\t// cookbook.md:782:23\n               countVector_1,\t// cookbook.md:782:23\n               countVector_2,\t// cookbook.md:782:23\n               countVector_3\t// cookbook.md:782:23\n);\n"})}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-resolve-dynamic-index--is-too-widenarrow-for-extractee-",children:'How do I resolve "Dynamic index ... is too wide/narrow for extractee ..."?'}),"\n",(0,t.jsx)(n.p,{children:'Chisel will warn if a dynamic index is not the correctly-sized width for indexing a Vec or UInt.\n"Correctly-sized" means that the width of the index should be the log2 of the size of the indexee.\nIf the indexee is a non-power-of-2 size, use the ceiling of the log2 result.'}),"\n",(0,t.jsxs)(n.p,{children:["When the index does not have enough bits to address all entries or bits in the extractee, you can ",(0,t.jsx)(n.code,{children:".pad"})," the index to increase the width."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class TooNarrow extends RawModule {\n  val extractee = Wire(UInt(7.W))\n  val index = Wire(UInt(2.W))\n  extractee(index)\n}\ncompile(new TooNarrow)\n// [warn] cookbook.md 829:12: [W003] Dynamic index with width 2 is too small for extractee of width 7\n// [warn] There were 1 warning(s) during hardware elaboration.\n"})}),"\n",(0,t.jsxs)(n.p,{children:["This can be fixed with ",(0,t.jsx)(n.code,{children:"pad"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class TooNarrowFixed extends RawModule {\n  val extractee = Wire(UInt(7.W))\n  val index = Wire(UInt(2.W))\n  extractee(index.pad(3))\n}\ncompile(new TooNarrowFixed)\n"})}),"\n",(0,t.jsx)(n.h4,{id:"use-bit-extraction-when-the-index-is-too-wide",children:"Use bit extraction when the index is too wide"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class TooWide extends RawModule {\n  val extractee = Wire(Vec(8, UInt(32.W)))\n  val index = Wire(UInt(4.W))\n  extractee(index)\n}\ncompile(new TooWide)\n// [warn] cookbook.md 855:12: [W004] Dynamic index with width 4 is too wide for Vec of size 8 (expected index width 3).\n// [warn] There were 1 warning(s) during hardware elaboration.\n"})}),"\n",(0,t.jsx)(n.p,{children:"This can be fixed with bit extraction:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class TooWideFixed extends RawModule {\n  val extractee = Wire(Vec(8, UInt(32.W)))\n  val index = Wire(UInt(4.W))\n  extractee(index(2, 0))\n}\ncompile(new TooWideFixed)\n"})}),"\n",(0,t.jsxs)(n.p,{children:["Note that size 1 ",(0,t.jsx)(n.code,{children:"Vecs"})," and ",(0,t.jsx)(n.code,{children:"UInts"})," should be indexed by a zero-width ",(0,t.jsx)(n.code,{children:"UInt"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class SizeOneVec extends RawModule {\n  val extractee = Wire(Vec(1, UInt(32.W)))\n  val index = Wire(UInt(0.W))\n  extractee(index)\n}\ncompile(new SizeOneVec)\n"})}),"\n",(0,t.jsxs)(n.p,{children:["Because ",(0,t.jsx)(n.code,{children:"pad"})," only pads if the desired width is less than the current width of the argument,\nyou can use ",(0,t.jsx)(n.code,{children:"pad"})," in conjunction with bit extraction when the widths may be too wide or too\nnarrow under different circumstances"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3.util.log2Ceil\nclass TooWideOrNarrow(extracteeSize: Int, indexWidth: Int) extends Module {\n  val extractee = Wire(Vec(extracteeSize, UInt(8.W)))\n  val index = Wire(UInt(indexWidth.W))\n  val correctWidth = log2Ceil(extracteeSize)\n  extractee(index.pad(correctWidth)(correctWidth - 1, 0))\n}\ncompile(new TooWideOrNarrow(8, 2))\ncompile(new TooWideOrNarrow(8, 4))\n"})}),"\n",(0,t.jsxs)(n.p,{children:["Another option for dynamic bit selection of ",(0,t.jsx)(n.code,{children:"UInts"})," (but not ",(0,t.jsx)(n.code,{children:"Vec"})," dynamic indexing) is to do a dynamic\nright shift of the extractee by the index and then just bit select a single bit:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class TooWideOrNarrowUInt(extracteeSize: Int, indexWidth: Int) extends Module {\n  val extractee = Wire(UInt(extracteeSize.W))\n  val index = Wire(UInt(indexWidth.W))\n  (extractee >> index)(0)\n}\ncompile(new TooWideOrNarrowUInt(8, 2))\ncompile(new TooWideOrNarrowUInt(8, 4))\n"})}),"\n",(0,t.jsx)(n.h2,{id:"predictable-naming",children:"Predictable Naming"}),"\n",(0,t.jsx)(n.h3,{id:"how-do-i-get-chisel-to-name-signals-properly-in-blocks-like-whenwithclockandreset",children:"How do I get Chisel to name signals properly in blocks like when/withClockAndReset?"}),"\n",(0,t.jsxs)(n.p,{children:["Use the compiler plugin, and check out the ",(0,t.jsx)(n.a,{href:"naming",children:"Naming Cookbook"})," if that still does not do what you want."]}),"\n",(0,t.jsx)(n.h3,{id:"how-do-i-get-chisel-to-name-the-results-of-vector-reads-properly",children:"How do I get Chisel to name the results of vector reads properly?"}),"\n",(0,t.jsx)(n.p,{children:"Currently, name information is lost when using dynamic indexing. For example:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\nclass Foo extends Module {\n  val io = IO(new Bundle {\n    val in = Input(Vec(4, Bool()))\n    val idx = Input(UInt(2.W))\n    val en = Input(Bool())\n    val out = Output(Bool())\n  })\n\n  val x = io.in(io.idx)\n  val y = x && io.en\n  io.out := y\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["The above code loses the ",(0,t.jsx)(n.code,{children:"x"})," name, instead using ",(0,t.jsx)(n.code,{children:"_GEN_3"})," (the other ",(0,t.jsx)(n.code,{children:"_GEN_*"})," signals are expected)."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Foo(\t// cookbook.md:933:7\n  input        clock,\t// cookbook.md:933:7\n               reset,\t// cookbook.md:933:7\n               io_in_0,\t// cookbook.md:934:14\n               io_in_1,\t// cookbook.md:934:14\n               io_in_2,\t// cookbook.md:934:14\n               io_in_3,\t// cookbook.md:934:14\n  input  [1:0] io_idx,\t// cookbook.md:934:14\n  input        io_en,\t// cookbook.md:934:14\n  output       io_out\t// cookbook.md:934:14\n);\n\n  wire [3:0] _GEN = {{io_in_3}, {io_in_2}, {io_in_1}, {io_in_0}};\t// cookbook.md:942:13\n  assign io_out = _GEN[io_idx] & io_en;\t// cookbook.md:933:7, :942:13\nendmodule\n\n"})}),"\n",(0,t.jsx)(n.p,{children:"This can be worked around by creating a wire and connecting the dynamic index to the wire:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"val x = WireInit(io.in(io.idx))\n"})}),"\n",(0,t.jsx)(n.p,{children:"Which produces:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Foo2(\t// cookbook.md:956:7\n  input        clock,\t// cookbook.md:956:7\n               reset,\t// cookbook.md:956:7\n               io_in_0,\t// cookbook.md:957:14\n               io_in_1,\t// cookbook.md:957:14\n               io_in_2,\t// cookbook.md:957:14\n               io_in_3,\t// cookbook.md:957:14\n  input  [1:0] io_idx,\t// cookbook.md:957:14\n  input        io_en,\t// cookbook.md:957:14\n  output       io_out\t// cookbook.md:957:14\n);\n\n  wire [3:0] _GEN = {{io_in_3}, {io_in_2}, {io_in_1}, {io_in_0}};\t// cookbook.md:964:19\n  assign io_out = _GEN[io_idx] & io_en;\t// cookbook.md:956:7, :964:19, :965:13\nendmodule\n\n"})}),"\n",(0,t.jsx)(n.h3,{id:"how-can-i-dynamically-setparametrize-the-name-of-a-module",children:"How can I dynamically set/parametrize the name of a module?"}),"\n",(0,t.jsxs)(n.p,{children:["You can override the ",(0,t.jsx)(n.code,{children:"desiredName"})," function. This works with normal Chisel modules and ",(0,t.jsx)(n.code,{children:"BlackBox"}),"es. Example:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'import chisel3._\n\nclass Coffee extends BlackBox {\n    val io = IO(new Bundle {\n        val I = Input(UInt(32.W))\n        val O = Output(UInt(32.W))\n    })\n    override def desiredName = "Tea"\n}\n\nclass Salt extends Module {\n    val io = IO(new Bundle {})\n    val drink = Module(new Coffee)\n    override def desiredName = "SodiumMonochloride"\n\n    drink.io.I := 42.U\n}\n'})}),"\n",(0,t.jsxs)(n.p,{children:["Elaborating the Chisel module ",(0,t.jsx)(n.code,{children:"Salt"}),' yields our "desired names" for ',(0,t.jsx)(n.code,{children:"Salt"})," and ",(0,t.jsx)(n.code,{children:"Coffee"})," in the output Verilog:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\n// external module Tea\n\nmodule SodiumMonochloride(\t// cookbook.md:994:7\n  input clock,\t// cookbook.md:994:7\n        reset\t// cookbook.md:994:7\n);\n\n  Tea drink (\t// cookbook.md:996:23\n    .I (32'h2A),\n    .O (/* unused */)\n  );\t// cookbook.md:996:23\nendmodule\n\n"})}),"\n",(0,t.jsx)(n.h2,{id:"directionality",children:"Directionality"}),"\n",(0,t.jsx)(n.h3,{id:"how-do-i-strip-directions-from-a-bidirectional-bundle-or-other-data",children:"How do I strip directions from a bidirectional Bundle (or other Data)?"}),"\n",(0,t.jsxs)(n.p,{children:["Given a bidirectional port like a ",(0,t.jsx)(n.code,{children:"Decoupled"}),", you will get an error if you try to connect it directly\nto a register:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport circt.stage.ChiselStage\nimport chisel3.util.Decoupled\nclass BadRegConnect extends Module {\n  val io = IO(new Bundle {\n    val enq = Decoupled(UInt(8.W))\n  })\n\n  val monitor = Reg(chiselTypeOf(io.enq))\n  monitor := io.enq\n}\n"})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"ChiselStage.emitSystemVerilog(new BadRegConnect)\n// circt.stage.phases.Exceptions$FirtoolNonZeroExitCode: /home/runner/.cache/llvm-firtool/1.81.1/bin/firtool returned a non-zero exit code. Note that this version of Chisel (7.0.0-M2+49-ab82fc22-SNAPSHOT) was published against firtool version 1.81.1.\n// ------------------------------------------------------------------------------\n// ExitCode:\n// 1\n// STDOUT:\n// \n// STDERR:\n// cookbook.md:1029:20: error: 'firrtl.reg' op result #0 must be a passive non-'const' base type that does not contain analog, but got '!firrtl.bundle<ready flip: uint<1>, valid: uint<1>, bits: uint<8>>'\n// cookbook.md:1029:20: note: see current operation: %4 = \"firrtl.reg\"(%arg0) {annotations = [], name = \"monitor\", nameKind = #firrtl<name_kind interesting_name>} : (!firrtl.clock) -> !firrtl.bundle<ready flip: uint<1>, valid: uint<1>, bits: uint<8>>\n// \n// ------------------------------------------------------------------------------\n"})}),"\n",(0,t.jsxs)(n.p,{children:['While there is no construct to "strip direction" in Chisel3, wrapping a type in ',(0,t.jsx)(n.code,{children:"Output(...)"}),"\n(the default direction in Chisel3) will\nset all of the individual elements to output direction.\nThis will have the desired result when used to construct a Register:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport circt.stage.ChiselStage\nimport chisel3.util.Decoupled\nclass CoercedRegConnect extends Module {\n  val io = IO(new Bundle {\n    val enq = Flipped(Decoupled(UInt(8.W)))\n  })\n\n  // Make a Reg which contains all of the bundle's signals, regardless of their directionality\n  val monitor = Reg(Output(chiselTypeOf(io.enq)))\n  // Even though io.enq is bidirectional, := will drive all fields of monitor with the fields of io.enq\n  monitor := io.enq\n}\n"})})]})}function h(e={}){const{wrapper:n}={...(0,a.R)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(u,{...e})}):u(e)}},1871:(e,n,o)=>{o.d(n,{A:()=>l});o(6540);var t=o(5195);const a={tableOfContentsInline:"tableOfContentsInline_prmo"};var i=o(4848);function l(e){let{toc:n,minHeadingLevel:o,maxHeadingLevel:l}=e;return(0,i.jsx)("div",{className:a.tableOfContentsInline,children:(0,i.jsx)(t.A,{toc:n,minHeadingLevel:o,maxHeadingLevel:l,className:"table-of-contents",linkClassName:null})})}},5195:(e,n,o)=>{o.d(n,{A:()=>g});var t=o(6540),a=o(6342);function i(e){const n=e.map((e=>({...e,parentIndex:-1,children:[]}))),o=Array(7).fill(-1);n.forEach(((e,n)=>{const t=o.slice(2,e.level);e.parentIndex=Math.max(...t),o[e.level]=n}));const t=[];return n.forEach((e=>{const{parentIndex:o,...a}=e;o>=0?n[o].children.push(a):t.push(a)})),t}function l(e){let{toc:n,minHeadingLevel:o,maxHeadingLevel:t}=e;return n.flatMap((e=>{const n=l({toc:e.children,minHeadingLevel:o,maxHeadingLevel:t});return function(e){return e.level>=o&&e.level<=t}(e)?[{...e,children:n}]:n}))}function s(e){const n=e.getBoundingClientRect();return n.top===n.bottom?s(e.parentNode):n}function c(e,n){let{anchorTopOffset:o}=n;const t=e.find((e=>s(e).top>=o));if(t){return function(e){return e.top>0&&e.bottom<window.innerHeight/2}(s(t))?t:e[e.indexOf(t)-1]??null}return e[e.length-1]??null}function r(){const e=(0,t.useRef)(0),{navbar:{hideOnScroll:n}}=(0,a.p)();return(0,t.useEffect)((()=>{e.current=n?0:document.querySelector(".navbar").clientHeight}),[n]),e}function d(e){const n=(0,t.useRef)(void 0),o=r();(0,t.useEffect)((()=>{if(!e)return()=>{};const{linkClassName:t,linkActiveClassName:a,minHeadingLevel:i,maxHeadingLevel:l}=e;function s(){const e=function(e){return Array.from(document.getElementsByClassName(e))}(t),s=function(e){let{minHeadingLevel:n,maxHeadingLevel:o}=e;const t=[];for(let a=n;a<=o;a+=1)t.push(`h${a}.anchor`);return Array.from(document.querySelectorAll(t.join()))}({minHeadingLevel:i,maxHeadingLevel:l}),r=c(s,{anchorTopOffset:o.current}),d=e.find((e=>r&&r.id===function(e){return decodeURIComponent(e.href.substring(e.href.indexOf("#")+1))}(e)));e.forEach((e=>{!function(e,o){o?(n.current&&n.current!==e&&n.current.classList.remove(a),e.classList.add(a),n.current=e):e.classList.remove(a)}(e,e===d)}))}return document.addEventListener("scroll",s),document.addEventListener("resize",s),s(),()=>{document.removeEventListener("scroll",s),document.removeEventListener("resize",s)}}),[e,o])}var u=o(8774),h=o(4848);function p(e){let{toc:n,className:o,linkClassName:t,isChild:a}=e;return n.length?(0,h.jsx)("ul",{className:a?void 0:o,children:n.map((e=>(0,h.jsxs)("li",{children:[(0,h.jsx)(u.A,{to:`#${e.id}`,className:t??void 0,dangerouslySetInnerHTML:{__html:e.value}}),(0,h.jsx)(p,{isChild:!0,toc:e.children,className:o,linkClassName:t})]},e.id)))}):null}const m=t.memo(p);function g(e){let{toc:n,className:o="table-of-contents table-of-contents__left-border",linkClassName:s="table-of-contents__link",linkActiveClassName:c,minHeadingLevel:r,maxHeadingLevel:u,...p}=e;const g=(0,a.p)(),x=r??g.tableOfContents.minHeadingLevel,f=u??g.tableOfContents.maxHeadingLevel,w=function(e){let{toc:n,minHeadingLevel:o,maxHeadingLevel:a}=e;return(0,t.useMemo)((()=>l({toc:i(n),minHeadingLevel:o,maxHeadingLevel:a})),[n,o,a])}({toc:n,minHeadingLevel:x,maxHeadingLevel:f});return d((0,t.useMemo)((()=>{if(s&&c)return{linkClassName:s,linkActiveClassName:c,minHeadingLevel:x,maxHeadingLevel:f}}),[s,c,x,f])),(0,h.jsx)(m,{toc:w,className:o,linkClassName:s,...p})}},8453:(e,n,o)=>{o.d(n,{R:()=>l,x:()=>s});var t=o(6540);const a={},i=t.createContext(a);function l(e){const n=t.useContext(i);return t.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function s(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(a):e.components||a:l(e.components),t.createElement(i.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/7e1e4a75.f1b5b02e.js b/assets/js/7e1e4a75.f1b5b02e.js
new file mode 100644
index 0000000000..2665e79e03
--- /dev/null
+++ b/assets/js/7e1e4a75.f1b5b02e.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[5432],{9730:(e,n,o)=>{o.r(n),o.d(n,{assets:()=>c,contentTitle:()=>s,default:()=>h,frontMatter:()=>l,metadata:()=>r,toc:()=>d});var i=o(4848),t=o(8453),a=o(1871);const l={sidebar_position:0},s="General Cookbook",r={id:"cookbooks/cookbook",title:"General Cookbook",description:"Please note that these examples make use of Chisel's scala-style printing.",source:"@site/docs/cookbooks/cookbook.md",sourceDirName:"cookbooks",slug:"/cookbooks/cookbook",permalink:"/docs/cookbooks/cookbook",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/cookbooks/cookbook.md",tags:[],version:"current",sidebarPosition:0,frontMatter:{sidebar_position:0},sidebar:"chiselSidebar",previous:{title:"Cookbooks",permalink:"/docs/cookbooks"},next:{title:"Naming Cookbook",permalink:"/docs/cookbooks/naming"}},c={},d=[{value:"Type Conversions",id:"type-conversions",level:2},{value:"How do I create a UInt from an instance of a Bundle?",id:"how-do-i-create-a-uint-from-an-instance-of-a-bundle",level:3},{value:"How do I create a Bundle from a UInt?",id:"how-do-i-create-a-bundle-from-a-uint",level:3},{value:"How can I tieoff a Bundle/Vec to 0?",id:"how-can-i-tieoff-a-bundlevec-to-0",level:3},{value:"How do I create a Vec of Bools from a UInt?",id:"how-do-i-create-a-vec-of-bools-from-a-uint",level:3},{value:"How do I create a UInt from a Vec of Bool?",id:"how-do-i-create-a-uint-from-a-vec-of-bool",level:3},{value:"How do I connect a subset of Bundle fields?",id:"how-do-i-connect-a-subset-of-bundle-fields",level:3},{value:"Vectors and Registers",id:"vectors-and-registers",level:2},{value:"Can I make a 2D or 3D Vector?",id:"can-i-make-a-2d-or-3d-vector",level:3},{value:"How do I create a Vector of Registers?",id:"how-do-i-create-a-vector-of-registers",level:3},{value:"How do I create a Reg of type Vec?",id:"how-do-i-create-a-reg-of-type-vec",level:3},{value:"How do I partially reset an Aggregate Reg?",id:"how-do-i-partially-reset-an-aggregate-reg",level:3},{value:"Bundles",id:"bundles",level:2},{value:"How do I deal with aliased Bundle fields?",id:"how-do-i-deal-with-aliased-bundle-fields",level:3},{value:"1. 0-arity function parameters",id:"1-0-arity-function-parameters",level:4},{value:"Aliased Warning",id:"aliased-warning",level:5},{value:"2. By-name function parameters",id:"2-by-name-function-parameters",level:4},{value:"3. Directioned Bundle fields",id:"3-directioned-bundle-fields",level:4},{value:"4. Call <code>.cloneType</code> directly",id:"4-call-clonetype-directly",level:4},{value:"<a></a> How do I deal with the &quot;unable to clone&quot; error?",id:"-how-do-i-deal-with-the-unable-to-clone-error",level:3},{value:"How do I create a finite state machine (FSM)?",id:"how-do-i-create-a-finite-state-machine-fsm",level:2},{value:"How do I unpack a value (&quot;reverse concatenation&quot;) like in Verilog?",id:"how-do-i-unpack-a-value-reverse-concatenation-like-in-verilog",level:2},{value:"How do I do subword assignment (assign to some bits in a UInt)?",id:"how-do-i-do-subword-assignment-assign-to-some-bits-in-a-uint",level:2},{value:"How do I create an optional I/O?",id:"how-do-i-create-an-optional-io",level:2},{value:"How do I create I/O without a prefix?",id:"how-do-i-create-io-without-a-prefix",level:2},{value:"How do I override the implicit clock or reset within a Module?",id:"how-do-i-override-the-implicit-clock-or-reset-within-a-module",level:2},{value:"How do I minimize the number of bits used in an output vector?",id:"how-do-i-minimize-the-number-of-bits-used-in-an-output-vector",level:2},{value:"How do I resolve &quot;Dynamic index ... is too wide/narrow for extractee ...&quot;?",id:"how-do-i-resolve-dynamic-index--is-too-widenarrow-for-extractee-",level:2},{value:"Use bit extraction when the index is too wide",id:"use-bit-extraction-when-the-index-is-too-wide",level:4},{value:"Predictable Naming",id:"predictable-naming",level:2},{value:"How do I get Chisel to name signals properly in blocks like when/withClockAndReset?",id:"how-do-i-get-chisel-to-name-signals-properly-in-blocks-like-whenwithclockandreset",level:3},{value:"How do I get Chisel to name the results of vector reads properly?",id:"how-do-i-get-chisel-to-name-the-results-of-vector-reads-properly",level:3},{value:"How can I dynamically set/parametrize the name of a module?",id:"how-can-i-dynamically-setparametrize-the-name-of-a-module",level:3},{value:"Directionality",id:"directionality",level:2},{value:"How do I strip directions from a bidirectional Bundle (or other Data)?",id:"how-do-i-strip-directions-from-a-bidirectional-bundle-or-other-data",level:3}];function u(e){const n={a:"a",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",h4:"h4",h5:"h5",p:"p",pre:"pre",strong:"strong",...(0,t.R)(),...e.components};return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsx)(n.h1,{id:"general-cookbook",children:"General Cookbook"}),"\n",(0,i.jsxs)(n.p,{children:["Please note that these examples make use of ",(0,i.jsx)(n.a,{href:"../explanations/printing#scala-style",children:"Chisel's scala-style printing"}),"."]}),"\n","\n","\n",(0,i.jsx)(a.A,{toc:d}),"\n",(0,i.jsx)(n.h2,{id:"type-conversions",children:"Type Conversions"}),"\n",(0,i.jsx)(n.h3,{id:"how-do-i-create-a-uint-from-an-instance-of-a-bundle",children:"How do I create a UInt from an instance of a Bundle?"}),"\n",(0,i.jsxs)(n.p,{children:["Call ",(0,i.jsx)(n.a,{href:"https://www.chisel-lang.org/api/latest/chisel3/Bundle.html#asUInt:chisel3.UInt",children:(0,i.jsx)(n.code,{children:"asUInt"})})," on the ",(0,i.jsx)(n.a,{href:"https://www.chisel-lang.org/api/latest/chisel3/Bundle.html",children:(0,i.jsx)(n.code,{children:"Bundle"})})," instance."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'import chisel3._\n\nclass MyBundle extends Bundle {\n  val foo = UInt(4.W)\n  val bar = UInt(4.W)\n}\n\nclass Foo extends Module {\n  val bundle = Wire(new MyBundle)\n  bundle.foo := 0xc.U\n  bundle.bar := 0x3.U\n  val uint = bundle.asUInt\n  printf(cf"$uint") // 195\n\n  // Test\n  assert(uint === 0xc3.U)\n}\n'})}),"\n",(0,i.jsx)(n.h3,{id:"how-do-i-create-a-bundle-from-a-uint",children:"How do I create a Bundle from a UInt?"}),"\n",(0,i.jsxs)(n.p,{children:["Use the ",(0,i.jsx)(n.a,{href:"https://www.chisel-lang.org/api/latest/chisel3/UInt.html#asTypeOf%5BT%3C:chisel3.Data%5D(that:T):T",children:(0,i.jsx)(n.code,{children:"asTypeOf"})})," method to reinterpret the ",(0,i.jsx)(n.a,{href:"https://www.chisel-lang.org/api/latest/chisel3/UInt.html",children:(0,i.jsx)(n.code,{children:"UInt"})})," as the type of the ",(0,i.jsx)(n.a,{href:"https://www.chisel-lang.org/api/latest/chisel3/Bundle.html",children:(0,i.jsx)(n.code,{children:"Bundle"})}),"."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'import chisel3._\n\nclass MyBundle extends Bundle {\n  val foo = UInt(4.W)\n  val bar = UInt(4.W)\n}\n\nclass Foo extends Module {\n  val uint = 0xb4.U\n  val bundle = uint.asTypeOf(new MyBundle)\n\n  printf(cf"$bundle") // Bundle(foo -> 11, bar -> 4)\n\n  // Test\n  assert(bundle.foo === 0xb.U)\n  assert(bundle.bar === 0x4.U)\n}\n'})}),"\n",(0,i.jsx)(n.h3,{id:"how-can-i-tieoff-a-bundlevec-to-0",children:"How can I tieoff a Bundle/Vec to 0?"}),"\n",(0,i.jsxs)(n.p,{children:["You can use ",(0,i.jsx)(n.code,{children:"asTypeOf"})," as above. If you don't want to worry about the type of the thing\nyou are tying off, you can use ",(0,i.jsx)(n.code,{children:"chiselTypeOf"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport circt.stage.ChiselStage\n\nclass MyBundle extends Bundle {\n  val foo = UInt(4.W)\n  val bar = Vec(4, UInt(1.W))\n}\n\nclass Foo(typ: MyBundle) extends Module {\n  val bundleA = IO(Output(typ))\n  val bundleB = IO(Output(typ))\n\n  // typ is already a Chisel Data Type, so can use it directly here, but you\n  // need to know that bundleA is of type typ\n  bundleA := 0.U.asTypeOf(typ)\n\n  // bundleB is a Hardware data IO(Output(...)) so need to call chiselTypeOf,\n  // but this will work no matter the type of bundleB:\n  bundleB := 0.U.asTypeOf(chiselTypeOf(bundleB))\n}\n\nChiselStage.emitSystemVerilog(new Foo(new MyBundle))\n"})}),"\n",(0,i.jsx)(n.h3,{id:"how-do-i-create-a-vec-of-bools-from-a-uint",children:"How do I create a Vec of Bools from a UInt?"}),"\n",(0,i.jsxs)(n.p,{children:["Use ",(0,i.jsx)(n.a,{href:"https://www.chisel-lang.org/api/latest/chisel3/VecInit$.html",children:(0,i.jsx)(n.code,{children:"VecInit"})})," given a ",(0,i.jsx)(n.code,{children:"Seq[Bool]"})," generated using the ",(0,i.jsx)(n.a,{href:"https://www.chisel-lang.org/api/latest/chisel3/UInt.html#asBools:Seq%5Bchisel3.Bool%5D",children:(0,i.jsx)(n.code,{children:"asBools"})})," method."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'import chisel3._\n\nclass Foo extends Module {\n  val uint = 0xc.U\n  val vec = VecInit(uint.asBools)\n\n  printf(cf"$vec") // Vec(0, 0, 1, 1)\n\n  // Test\n  assert(vec(0) === false.B)\n  assert(vec(1) === false.B)\n  assert(vec(2) === true.B)\n  assert(vec(3) === true.B)\n}\n'})}),"\n",(0,i.jsx)(n.h3,{id:"how-do-i-create-a-uint-from-a-vec-of-bool",children:"How do I create a UInt from a Vec of Bool?"}),"\n",(0,i.jsxs)(n.p,{children:["Use the builtin function ",(0,i.jsx)(n.a,{href:"https://www.chisel-lang.org/api/latest/chisel3/Vec.html#asUInt:chisel3.UInt",children:(0,i.jsx)(n.code,{children:"asUInt"})})]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'import chisel3._\n\nclass Foo extends Module {\n  val vec = VecInit(true.B, false.B, true.B, true.B)\n  val uint = vec.asUInt\n\n  printf(cf"$uint") // 13\n\n  // Test\n  // (remember leftmost Bool in Vec is low order bit)\n  assert(0xd.U === uint)\n\n}\n'})}),"\n",(0,i.jsx)(n.h3,{id:"how-do-i-connect-a-subset-of-bundle-fields",children:"How do I connect a subset of Bundle fields?"}),"\n",(0,i.jsxs)(n.p,{children:["See the ",(0,i.jsx)(n.a,{href:"dataview#how-do-i-connect-a-subset-of-bundle-fields",children:"DataView cookbook"}),"."]}),"\n",(0,i.jsx)(n.h2,{id:"vectors-and-registers",children:"Vectors and Registers"}),"\n",(0,i.jsx)(n.h3,{id:"can-i-make-a-2d-or-3d-vector",children:"Can I make a 2D or 3D Vector?"}),"\n",(0,i.jsxs)(n.p,{children:["Yes. Using ",(0,i.jsx)(n.code,{children:"VecInit"})," you can make Vectors that hold Vectors of Chisel types. Methods ",(0,i.jsx)(n.code,{children:"fill"})," and ",(0,i.jsx)(n.code,{children:"tabulate"})," make these multi-dimensional Vectors."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\nclass MyBundle extends Bundle {\n  val foo = UInt(4.W)\n  val bar = UInt(4.W)\n}\n\nclass Foo extends Module {\n  //2D Fill\n  val twoDVec = VecInit.fill(2, 3)(5.U)\n  //3D Fill\n  val myBundle = Wire(new MyBundle)\n  myBundle.foo := 0xc.U\n  myBundle.bar := 0x3.U\n  val threeDVec = VecInit.fill(1, 2, 3)(myBundle)\n  assert(threeDVec(0)(0)(0).foo === 0xc.U && threeDVec(0)(0)(0).bar === 0x3.U)\n\n  //2D Tabulate\n  val indexTiedVec = VecInit.tabulate(2, 2){ (x, y) => (x + y).U }\n  assert(indexTiedVec(0)(0) === 0.U)\n  assert(indexTiedVec(0)(1) === 1.U)\n  assert(indexTiedVec(1)(0) === 1.U)\n  assert(indexTiedVec(1)(1) === 2.U)\n  //3D Tabulate\n  val indexTiedVec3D = VecInit.tabulate(2, 3, 4){ (x, y, z) => (x + y * z).U }\n  assert(indexTiedVec3D(0)(0)(0) === 0.U)\n  assert(indexTiedVec3D(1)(1)(1) === 2.U)\n  assert(indexTiedVec3D(1)(1)(2) === 3.U)\n  assert(indexTiedVec3D(1)(1)(3) === 4.U)\n  assert(indexTiedVec3D(1)(2)(3) === 7.U)\n}\n"})}),"\n",(0,i.jsx)(n.h3,{id:"how-do-i-create-a-vector-of-registers",children:"How do I create a Vector of Registers?"}),"\n",(0,i.jsx)(n.p,{children:(0,i.jsx)(n.strong,{children:"Rule!  Use Reg of Vec not Vec of Reg!"})}),"\n",(0,i.jsxs)(n.p,{children:["You create a ",(0,i.jsx)(n.a,{href:"#how-do-i-create-a-reg-of-type-vec",children:"Reg of type Vec"}),". Because Vecs are a ",(0,i.jsx)(n.em,{children:"type"})," (like ",(0,i.jsx)(n.code,{children:"UInt"}),", ",(0,i.jsx)(n.code,{children:"Bool"}),") rather than a ",(0,i.jsx)(n.em,{children:"value"}),", we must bind the Vec to some concrete ",(0,i.jsx)(n.em,{children:"value"}),"."]}),"\n",(0,i.jsx)(n.h3,{id:"how-do-i-create-a-reg-of-type-vec",children:"How do I create a Reg of type Vec?"}),"\n",(0,i.jsxs)(n.p,{children:["For more information, the API Documentation for ",(0,i.jsx)(n.a,{href:"https://www.chisel-lang.org/api/latest/chisel3/Vec.html",children:(0,i.jsx)(n.code,{children:"Vec"})})," provides more information."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\nclass Foo extends Module {\n  val regOfVec = Reg(Vec(4, UInt(32.W))) // Register of 32-bit UInts\n  regOfVec(0) := 123.U                   // Assignments to elements of the Vec\n  regOfVec(1) := 456.U\n  regOfVec(2) := 789.U\n  regOfVec(3) := regOfVec(0)\n\n  // Reg of Vec of 32-bit UInts initialized to zero\n  //   Note that Seq.fill constructs 4 32-bit UInt literals with the value 0\n  //   VecInit(...) then constructs a Wire of these literals\n  //   The Reg is then initialized to the value of the Wire (which gives it the same type)\n  val initRegOfVec = RegInit(VecInit(Seq.fill(4)(0.U(32.W))))\n}\n"})}),"\n",(0,i.jsx)(n.h3,{id:"how-do-i-partially-reset-an-aggregate-reg",children:"How do I partially reset an Aggregate Reg?"}),"\n",(0,i.jsxs)(n.p,{children:["The easiest way is to use a partially-specified ",(0,i.jsx)(n.a,{href:"../appendix/experimental-features#bundle-literals",children:"Bundle Literal"}),"\nor ",(0,i.jsx)(n.a,{href:"../appendix/experimental-features#vec-literals",children:"Vec Literal"})," to match the type of the Reg."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.BundleLiterals._\n\nclass MyBundle extends Bundle {\n  val foo = UInt(8.W)\n  val bar = UInt(8.W)\n}\n\nclass MyModule extends Module {\n  // Only .foo will be reset, .bar will have no reset value\n  val reg = RegInit((new MyBundle).Lit(_.foo -> 123.U))\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["If your initial value is not a literal, or if you just prefer, you can use a\nWire as the initial value for the Reg. Simply connect fields to ",(0,i.jsx)(n.code,{children:"DontCare"})," that\nyou do not wish to be reset."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class MyModule2 extends Module {\n  val reg = RegInit({\n    // The wire could be constructed before the reg rather than in the RegInit scope,\n    // but this style has nice lexical scoping behavior, keeping the Wire private\n    val init = Wire(new MyBundle)\n    init := DontCare // No fields will be reset\n    init.foo := 123.U // Last connect override, .foo is reset\n    init\n  })\n}\n"})}),"\n",(0,i.jsx)(n.h2,{id:"bundles",children:"Bundles"}),"\n",(0,i.jsx)(n.h3,{id:"how-do-i-deal-with-aliased-bundle-fields",children:"How do I deal with aliased Bundle fields?"}),"\n",(0,i.jsxs)(n.p,{children:["Following the ",(0,i.jsx)(n.code,{children:"gen"})," pattern when creating Bundles can result in some opaque error messages:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class AliasedBundle[T <: Data](gen: T) extends Bundle {\n  val foo = gen\n  val bar = gen\n}\n"})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"getVerilogString(new Top(new AliasedBundle(UInt(8.W))))\n// chisel3.AliasedAggregateFieldException: AliasedBundle contains aliased fields named (foo,bar)\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp17$Top$$anonfun$50$$anonfun$apply$37.apply(cookbook.md:301)\n// \tat repl.MdocSession$MdocApp17$Top$$anonfun$50$$anonfun$apply$37.apply(cookbook.md:301)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp17$Top$$anonfun$50.apply(cookbook.md:301)\n// \tat repl.MdocSession$MdocApp17$Top$$anonfun$50.apply(cookbook.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp17$Top.<init>(cookbook.md:301)\n// \tat repl.MdocSession$MdocApp17$$anonfun$55$$anonfun$apply$43.apply(cookbook.md:320)\n// \tat repl.MdocSession$MdocApp17$$anonfun$55$$anonfun$apply$43.apply(cookbook.md:320)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,i.jsxs)(n.p,{children:["This error is saying that fields ",(0,i.jsx)(n.code,{children:"foo"})," and ",(0,i.jsx)(n.code,{children:"bar"})," of ",(0,i.jsx)(n.code,{children:"AliasedBundle"})," are the\nexact same object in memory.\nThis is a problem for Chisel because we need to be able to distinguish uses of\n",(0,i.jsx)(n.code,{children:"foo"})," and ",(0,i.jsx)(n.code,{children:"bar"})," but cannot when they are referentially the same."]}),"\n",(0,i.jsx)(n.p,{children:"Note that the following example looks different but will give you exactly the same issue:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class AlsoAliasedBundle[T <: Data](val gen: T) extends Bundle {\n                                // ^ This val makes `gen` a field, just like `foo`\n  val foo = gen\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["By making ",(0,i.jsx)(n.code,{children:"gen"})," a ",(0,i.jsx)(n.code,{children:"val"}),", it becomes a public field of the ",(0,i.jsx)(n.code,{children:"class"}),", just like ",(0,i.jsx)(n.code,{children:"foo"}),"."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"getVerilogString(new Top(new AlsoAliasedBundle(UInt(8.W))))\n// chisel3.AliasedAggregateFieldException: AlsoAliasedBundle contains aliased fields named (gen,foo)\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp17$Top$$anonfun$50$$anonfun$apply$37.apply(cookbook.md:301)\n// \tat repl.MdocSession$MdocApp17$Top$$anonfun$50$$anonfun$apply$37.apply(cookbook.md:301)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp17$Top$$anonfun$50.apply(cookbook.md:301)\n// \tat repl.MdocSession$MdocApp17$Top$$anonfun$50.apply(cookbook.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp17$Top.<init>(cookbook.md:301)\n// \tat repl.MdocSession$MdocApp17$$anonfun$57$$anonfun$apply$44.apply(cookbook.md:339)\n// \tat repl.MdocSession$MdocApp17$$anonfun$57$$anonfun$apply$44.apply(cookbook.md:339)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,i.jsx)(n.p,{children:"There are several ways to solve this issue with their own advantages and disadvantages."}),"\n",(0,i.jsx)(n.h4,{id:"1-0-arity-function-parameters",children:"1. 0-arity function parameters"}),"\n",(0,i.jsx)(n.p,{children:"Instead of passing an object as a parameter, you can pass a 0-arity function (a function with no arguments):"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class UsingAFunctionBundle[T <: Data](gen: () => T) extends Bundle {\n  val foo = gen()\n  val bar = gen()\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["Note that the type of ",(0,i.jsx)(n.code,{children:"gen"})," is now ",(0,i.jsx)(n.code,{children:"() => T"}),".\nBecause it is now a function and not a subtype of ",(0,i.jsx)(n.code,{children:"Data"}),", you can safely make ",(0,i.jsx)(n.code,{children:"gen"})," a ",(0,i.jsx)(n.code,{children:"val"})," without\nit becoming a hardware field of the ",(0,i.jsx)(n.code,{children:"Bundle"}),"."]}),"\n",(0,i.jsxs)(n.p,{children:["Note that this also means you must pass ",(0,i.jsx)(n.code,{children:"gen"})," as a function, for example:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"getVerilogString(new Top(new UsingAFunctionBundle(() => UInt(8.W))))\n"})}),"\n",(0,i.jsx)(n.h5,{id:"aliased-warning",children:"Aliased Warning"}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.strong,{children:"Warning"}),": you must ensure that ",(0,i.jsx)(n.code,{children:"gen"})," creates fresh objects rather than capturing an already constructed value:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class MisusedFunctionArguments extends Module {\n  // This usage is correct\n  val in = IO(Input(new UsingAFunctionBundle(() => UInt(8.W))))\n\n  // This usage is incorrect\n  val fizz = UInt(8.W)\n  val out = IO(Output(new UsingAFunctionBundle(() => fizz)))\n}\ngetVerilogString(new MisusedFunctionArguments)\n// chisel3.AutoClonetypeException: The bundle plugin was unable to clone UsingAFunctionBundle that has field 'bar' aliased with base UsingAFunctionBundle.This likely happened because you tried nesting Data arguments inside of other data structures. Try wrapping the field(s) in Input(...), Output(...), or Flipped(...) if appropriate. As a last resort, you can call chisel3.reflect.DataMirror.internal.chiselTypeClone on any nested Data arguments. See the cookbook entry 'How do I deal with the \"unable to clone\" error?' for more details.\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp17$$anonfun$59$MisusedFunctionArguments$1$$anonfun$62$$anonfun$apply$51$$anonfun$apply$52.apply(cookbook.md:370)\n// \tat repl.MdocSession$MdocApp17$$anonfun$59$MisusedFunctionArguments$1$$anonfun$62$$anonfun$apply$51$$anonfun$apply$52.apply(cookbook.md:370)\n// \tat chisel3.IO$.apply(IO.scala:34)\n// \tat chisel3.experimental.BaseModule.IO(Module.scala:878)\n// \tat repl.MdocSession$MdocApp17$$anonfun$59$MisusedFunctionArguments$1$$anonfun$62$$anonfun$apply$51.apply(cookbook.md:370)\n// \tat repl.MdocSession$MdocApp17$$anonfun$59$MisusedFunctionArguments$1$$anonfun$62$$anonfun$apply$51.apply(cookbook.md:370)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp17$$anonfun$59$MisusedFunctionArguments$1$$anonfun$62.apply(cookbook.md:370)\n// \tat repl.MdocSession$MdocApp17$$anonfun$59$MisusedFunctionArguments$1$$anonfun$62.apply(cookbook.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp17$$anonfun$59$MisusedFunctionArguments$1.<init>(cookbook.md:370)\n// \tat repl.MdocSession$MdocApp17$$anonfun$59$$anonfun$apply$55.apply(cookbook.md:372)\n// \tat repl.MdocSession$MdocApp17$$anonfun$59$$anonfun$apply$55.apply(cookbook.md:372)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,i.jsxs)(n.p,{children:["In the above example, value ",(0,i.jsx)(n.code,{children:"fizz"})," and fields ",(0,i.jsx)(n.code,{children:"foo"})," and ",(0,i.jsx)(n.code,{children:"bar"})," of ",(0,i.jsx)(n.code,{children:"out"})," are all the same object in memory."]}),"\n",(0,i.jsx)(n.h4,{id:"2-by-name-function-parameters",children:"2. By-name function parameters"}),"\n",(0,i.jsxs)(n.p,{children:["Functionally the same as (1) but with more subtle syntax, you can use ",(0,i.jsx)(n.a,{href:"https://docs.scala-lang.org/tour/by-name-parameters.html",children:"Scala by-name function parameters"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class UsingByNameParameters[T <: Data](gen: => T) extends Bundle {\n  val foo = gen\n  val bar = gen\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["With this usage, you do not include ",(0,i.jsx)(n.code,{children:"() =>"})," when passing the argument:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"getVerilogString(new Top(new UsingByNameParameters(UInt(8.W))))\n"})}),"\n",(0,i.jsxs)(n.p,{children:["Note that as this is just syntactic sugar over (1), the ",(0,i.jsx)(n.a,{href:"#aliased-warning",children:"same warning applies"}),"."]}),"\n",(0,i.jsx)(n.h4,{id:"3-directioned-bundle-fields",children:"3. Directioned Bundle fields"}),"\n",(0,i.jsxs)(n.p,{children:["You can alternatively wrap the fields with ",(0,i.jsx)(n.code,{children:"Output(...)"}),", which creates fresh instances of the passed argument.\nChisel treats ",(0,i.jsx)(n.code,{children:"Output"}),' as the "default direction" so if all fields are outputs, the ',(0,i.jsx)(n.code,{children:"Bundle"})," is functionally equivalent to a ",(0,i.jsx)(n.code,{children:"Bundle"})," with no directioned fields."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class DirectionedBundle[T <: Data](gen: T) extends Bundle {\n  val foo = Output(gen)\n  val bar = Output(gen)\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["This approach is admittedly a little ugly and may mislead others reading the code because it implies that this Bundle is intended to be used as an ",(0,i.jsx)(n.code,{children:"Output"}),"."]}),"\n",(0,i.jsxs)(n.h4,{id:"4-call-clonetype-directly",children:["4. Call ",(0,i.jsx)(n.code,{children:".cloneType"})," directly"]}),"\n",(0,i.jsxs)(n.p,{children:["You can also just call ",(0,i.jsx)(n.code,{children:".cloneType"})," on your ",(0,i.jsx)(n.code,{children:"gen"})," argument directly.\nWhile we try to hide this implementation detail from the user, ",(0,i.jsx)(n.code,{children:".cloneType"})," is the mechanism by which Chisel creates fresh instances of ",(0,i.jsx)(n.code,{children:"Data"})," objects:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class UsingCloneTypeBundle[T <: Data](gen: T) extends Bundle {\n  val foo = gen.cloneType\n  val bar = gen.cloneType\n}\n"})}),"\n",(0,i.jsxs)(n.h3,{id:"-how-do-i-deal-with-the-unable-to-clone-error",children:[(0,i.jsx)("a",{name:"bundle-unable-to-clone"}),' How do I deal with the "unable to clone" error?']}),"\n",(0,i.jsx)(n.p,{children:'Most Chisel objects need to be cloned in order to differentiate between the\nsoftware representation of the bundle field from its "bound" hardware\nrepresentation, where "binding" is the process of generating a hardware\ncomponent. For Bundle fields, this cloning is supposed to happen automatically\nwith a compiler plugin.'}),"\n",(0,i.jsxs)(n.p,{children:["In some cases though, the plugin may not be able to clone the Bundle fields. The\nmost common case for when this happens is when the ",(0,i.jsx)(n.code,{children:"chisel3.Data"})," part of the\nBundle field is nested inside some other data structure and the compiler plugin\nis unable to figure out how to clone the entire structure. It is best to avoid\nsuch nested structures."]}),"\n",(0,i.jsxs)(n.p,{children:["There are a few ways around this issue - you can try wrapping the problematic\nfields in Input(...), Output(...), or Flipped(...) if appropriate. You can also\ntry manually cloning each field in the Bundle using the ",(0,i.jsx)(n.code,{children:"chiselTypeClone"})," method\nin ",(0,i.jsx)(n.code,{children:"chisel3.reflect.DataMirror"}),". Here's an example with the Bundle whose fields\nwon't get cloned:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'class CustomBundleBroken(elts: (String, Data)*) extends Record {\n  val elements = ListMap(elts: _*)\n\n  def apply(elt: String): Data = elements(elt)\n}\n\nclass NewModule extends Module {\n  val out = Output(UInt(8.W))\n  val recordType = new CustomBundleBroken("fizz" -> UInt(16.W), "buzz" -> UInt(16.W))\n  val record = Wire(recordType)\n  val uint = record.asUInt\n  val record2 = uint.asTypeOf(recordType)\n  out := record\n}\ngetVerilogString(new NewModule)\n// chisel3.AutoClonetypeException: The bundle plugin was unable to clone CustomBundleBroken$1 that has field \'fizz\' aliased with base CustomBundleBroken$1.This likely happened because you tried nesting Data arguments inside of other data structures. Try wrapping the field(s) in Input(...), Output(...), or Flipped(...) if appropriate. As a last resort, you can call chisel3.reflect.DataMirror.internal.chiselTypeClone on any nested Data arguments. See the cookbook entry \'How do I deal with the "unable to clone" error?\' for more details.\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp17$$anonfun$70$NewModule$1$$anonfun$74$$anonfun$apply$63.apply(cookbook.md:444)\n// \tat repl.MdocSession$MdocApp17$$anonfun$70$NewModule$1$$anonfun$74$$anonfun$apply$63.apply(cookbook.md:444)\n// \tat chisel3.experimental.prefix$.apply(prefix.scala:50)\n// \tat repl.MdocSession$MdocApp17$$anonfun$70$NewModule$1$$anonfun$74.apply(cookbook.md:444)\n// \tat repl.MdocSession$MdocApp17$$anonfun$70$NewModule$1$$anonfun$74.apply(cookbook.md)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp17$$anonfun$70$NewModule$1.<init>(cookbook.md:444)\n// \tat repl.MdocSession$MdocApp17$$anonfun$70$$anonfun$apply$67.apply(cookbook.md:449)\n// \tat repl.MdocSession$MdocApp17$$anonfun$70$$anonfun$apply$67.apply(cookbook.md:449)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n'})}),"\n",(0,i.jsxs)(n.p,{children:["You can use ",(0,i.jsx)(n.code,{children:"chiselTypeClone"})," to clone the elements as:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3.reflect.DataMirror\nimport chisel3.experimental.requireIsChiselType\n\nclass CustomBundleFixed(elts: (String, Data)*) extends Record {\n  val elements = ListMap(elts.map {\n    case (field, elt) =>\n      requireIsChiselType(elt)\n      field -> DataMirror.internal.chiselTypeClone(elt)\n  }: _*)\n\n  def apply(elt: String): Data = elements(elt)\n}\n"})}),"\n",(0,i.jsx)(n.h2,{id:"how-do-i-create-a-finite-state-machine-fsm",children:"How do I create a finite state machine (FSM)?"}),"\n",(0,i.jsxs)(n.p,{children:["The advised way is to use ",(0,i.jsx)(n.code,{children:"ChiselEnum"})," to construct enumerated types representing the state of the FSM.\nState transitions are then handled with ",(0,i.jsx)(n.code,{children:"switch"}),"/",(0,i.jsx)(n.code,{children:"is"})," and ",(0,i.jsx)(n.code,{children:"when"}),"/",(0,i.jsx)(n.code,{children:".elsewhen"}),"/",(0,i.jsx)(n.code,{children:".otherwise"}),"."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.util.{switch, is}\n\nobject DetectTwoOnes {\n  object State extends ChiselEnum {\n    val sNone, sOne1, sTwo1s = Value\n  }\n}\n\n/* This FSM detects two 1's one after the other */\nclass DetectTwoOnes extends Module {\n  import DetectTwoOnes.State\n  import DetectTwoOnes.State._\n\n  val io = IO(new Bundle {\n    val in = Input(Bool())\n    val out = Output(Bool())\n    val state = Output(State())\n  })\n\n  val state = RegInit(sNone)\n\n  io.out := (state === sTwo1s)\n  io.state := state\n\n  switch (state) {\n    is (sNone) {\n      when (io.in) {\n        state := sOne1\n      }\n    }\n    is (sOne1) {\n      when (io.in) {\n        state := sTwo1s\n      } .otherwise {\n        state := sNone\n      }\n    }\n    is (sTwo1s) {\n      when (!io.in) {\n        state := sNone\n      }\n    }\n  }\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["Note: the ",(0,i.jsx)(n.code,{children:"is"})," statement can take multiple conditions e.g. ",(0,i.jsx)(n.code,{children:"is (sTwo1s, sOne1) { ... }"}),"."]}),"\n",(0,i.jsx)(n.h2,{id:"how-do-i-unpack-a-value-reverse-concatenation-like-in-verilog",children:'How do I unpack a value ("reverse concatenation") like in Verilog?'}),"\n",(0,i.jsxs)(n.p,{children:["In Verilog, you can do something like the following which will unpack a the value ",(0,i.jsx)(n.code,{children:"z"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"wire [1:0] a;\nwire [3:0] b;\nwire [2:0] c;\nwire [8:0] z = [...];\nassign {a,b,c} = z;\n"})}),"\n",(0,i.jsx)(n.p,{children:"Unpacking often corresponds to reinterpreting an unstructured data type as a structured data type.\nFrequently, this structured type is used prolifically in the design, and has been declared as in the following example:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\nclass MyBundle extends Bundle {\n  val a = UInt(2.W)\n  val b = UInt(4.W)\n  val c = UInt(3.W)\n}\n"})}),"\n",(0,i.jsx)(n.p,{children:"The easiest way to accomplish this in Chisel would be:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'class Foo extends Module {\n  val z = Wire(UInt(9.W))\n  z := DontCare // This is a dummy connection\n  val unpacked = z.asTypeOf(new MyBundle)\n  printf("%d", unpacked.a)\n  printf("%d", unpacked.b)\n  printf("%d", unpacked.c)\n}\n'})}),"\n",(0,i.jsxs)(n.p,{children:["If you ",(0,i.jsx)(n.strong,{children:"really"})," need to do this for a one-off case (Think thrice! It is likely you can better structure the code using bundles), then rocket-chip has a ",(0,i.jsx)(n.a,{href:"https://github.com/freechipsproject/rocket-chip/blob/723af5e6b69e07b5f94c46269a208a8d65e9d73b/src/main/scala/util/Misc.scala#L140",children:"Split utility"})," which can accomplish this."]}),"\n",(0,i.jsx)(n.h2,{id:"how-do-i-do-subword-assignment-assign-to-some-bits-in-a-uint",children:"How do I do subword assignment (assign to some bits in a UInt)?"}),"\n",(0,i.jsxs)(n.p,{children:["You may try to do something like the following where you want to assign only some bits of a Chisel type.\nBelow, the left-hand side connection to ",(0,i.jsx)(n.code,{children:"io.out(0)"})," is not allowed."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport circt.stage.ChiselStage\n\nclass Foo extends Module {\n  val io = IO(new Bundle {\n    val bit = Input(Bool())\n    val out = Output(UInt(10.W))\n  })\n  io.out(0) := io.bit\n}\n"})}),"\n",(0,i.jsx)(n.p,{children:"If you try to compile this, you will get an error."}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"getVerilogString(new Foo)\n// chisel3.package$ChiselException: Cannot reassign to read-only Foo.?: OpResult[Bool]\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp26$Foo.<init>(cookbook.md:589)\n// \tat repl.MdocSession$MdocApp26$$anonfun$104$$anonfun$apply$90.apply(cookbook.md:597)\n// \tat repl.MdocSession$MdocApp26$$anonfun$104$$anonfun$apply$90.apply(cookbook.md:597)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,i.jsxs)(n.p,{children:["Chisel3 ",(0,i.jsx)(n.em,{children:"does not support subword assignment"}),".\nThe reason for this is that subword assignment generally hints at a better abstraction with an aggregate/structured types, i.e., a ",(0,i.jsx)(n.code,{children:"Bundle"})," or a ",(0,i.jsx)(n.code,{children:"Vec"}),"."]}),"\n",(0,i.jsxs)(n.p,{children:["If you must express it this way, one approach is to blast your ",(0,i.jsx)(n.code,{children:"UInt"})," to a ",(0,i.jsx)(n.code,{children:"Vec"})," of ",(0,i.jsx)(n.code,{children:"Bool"})," and back:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\nclass Foo extends Module {\n  val io = IO(new Bundle {\n    val in = Input(UInt(10.W))\n    val bit = Input(Bool())\n    val out = Output(UInt(10.W))\n  })\n  val bools = VecInit(io.in.asBools)\n  bools(0) := io.bit\n  io.out := bools.asUInt\n}\n"})}),"\n",(0,i.jsx)(n.h2,{id:"how-do-i-create-an-optional-io",children:"How do I create an optional I/O?"}),"\n",(0,i.jsxs)(n.p,{children:["The following example is a module which includes the optional port ",(0,i.jsx)(n.code,{children:"out2"})," only if the given parameter is ",(0,i.jsx)(n.code,{children:"true"}),"."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\nclass ModuleWithOptionalIOs(flag: Boolean) extends Module {\n  val io = IO(new Bundle {\n    val in = Input(UInt(12.W))\n    val out = Output(UInt(12.W))\n    val out2 = if (flag) Some(Output(UInt(12.W))) else None\n  })\n\n  io.out := io.in\n  if (flag) {\n    io.out2.get := io.in\n  }\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["The following is an example where an entire ",(0,i.jsx)(n.code,{children:"IO"})," is optional:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\nclass ModuleWithOptionalIO(flag: Boolean) extends Module {\n  val in = if (flag) Some(IO(Input(Bool()))) else None\n  val out = IO(Output(Bool()))\n\n  out := in.getOrElse(false.B)\n}\n"})}),"\n",(0,i.jsx)(n.h2,{id:"how-do-i-create-io-without-a-prefix",children:"How do I create I/O without a prefix?"}),"\n",(0,i.jsxs)(n.p,{children:["In most cases, you can simply call ",(0,i.jsx)(n.code,{children:"IO"})," multiple times:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\nclass MyModule extends Module {\n  val in = IO(Input(UInt(8.W)))\n  val out = IO(Output(UInt(8.W)))\n\n  out := in +% 1.U\n}\n"})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule MyModule(\t// cookbook.md:691:7\n  input        clock,\t// cookbook.md:691:7\n               reset,\t// cookbook.md:691:7\n  input  [7:0] in,\t// cookbook.md:692:14\n  output [7:0] out\t// cookbook.md:693:15\n);\n\n  assign out = in + 8\'h1;\t// cookbook.md:691:7, :695:13\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_MyModule_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyModule_Verification.sv"\n`ifndef layers_MyModule_Verification_Cover\n`define layers_MyModule_Verification_Cover\t// <stdin>:6:5\n`endif // layers_MyModule_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_MyModule_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyModule_Verification.sv"\n`ifndef layers_MyModule_Verification_Assume\n`define layers_MyModule_Verification_Assume\t// <stdin>:5:5\n`endif // layers_MyModule_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_MyModule_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyModule_Verification.sv"\n`ifndef layers_MyModule_Verification_Assert\n`define layers_MyModule_Verification_Assert\t// <stdin>:4:5\n`endif // layers_MyModule_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_MyModule_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_MyModule_Verification\n`define layers_MyModule_Verification\t// <stdin>:3:3\n`endif // layers_MyModule_Verification\t// <stdin>:3:3\n'})}),"\n",(0,i.jsxs)(n.p,{children:["If you have a ",(0,i.jsx)(n.code,{children:"Bundle"})," from which you would like to create ports without the\nnormal ",(0,i.jsx)(n.code,{children:"val"})," prefix, you can use ",(0,i.jsx)(n.code,{children:"FlatIO"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\nclass MyBundle extends Bundle {\n  val foo = Input(UInt(8.W))\n  val bar = Output(UInt(8.W))\n}\n\nclass MyModule extends Module {\n  val io = FlatIO(new MyBundle)\n\n  io.bar := io.foo +% 1.U\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["Note that ",(0,i.jsx)(n.code,{children:"io_"})," is nowhere to be seen!"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule MyModule(\t// cookbook.md:720:7\n  input        clock,\t// cookbook.md:720:7\n               reset,\t// cookbook.md:720:7\n  input  [7:0] foo,\t// cookbook.md:721:18\n  output [7:0] bar\t// cookbook.md:721:18\n);\n\n  assign bar = foo + 8\'h1;\t// cookbook.md:720:7, :723:20\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_MyModule_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyModule_Verification.sv"\n`ifndef layers_MyModule_Verification_Cover\n`define layers_MyModule_Verification_Cover\t// <stdin>:6:5\n`endif // layers_MyModule_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_MyModule_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyModule_Verification.sv"\n`ifndef layers_MyModule_Verification_Assume\n`define layers_MyModule_Verification_Assume\t// <stdin>:5:5\n`endif // layers_MyModule_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_MyModule_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyModule_Verification.sv"\n`ifndef layers_MyModule_Verification_Assert\n`define layers_MyModule_Verification_Assert\t// <stdin>:4:5\n`endif // layers_MyModule_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_MyModule_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_MyModule_Verification\n`define layers_MyModule_Verification\t// <stdin>:3:3\n`endif // layers_MyModule_Verification\t// <stdin>:3:3\n'})}),"\n",(0,i.jsx)(n.h2,{id:"how-do-i-override-the-implicit-clock-or-reset-within-a-module",children:"How do I override the implicit clock or reset within a Module?"}),"\n",(0,i.jsxs)(n.p,{children:["To change the clock or reset for a region of code, use ",(0,i.jsx)(n.code,{children:"withClock"}),", ",(0,i.jsx)(n.code,{children:"withReset"}),", or ",(0,i.jsx)(n.code,{children:"withClockAndReset"}),".\nSee ",(0,i.jsx)(n.a,{href:"../explanations/multi-clock",children:"Multiple Clock Domains"})," for examples and details."]}),"\n",(0,i.jsxs)(n.p,{children:["To override the clock or reset for the entire scope of the ",(0,i.jsx)(n.code,{children:"Module"}),", you can mixin the ",(0,i.jsx)(n.code,{children:"ImplicitClock"})," and ",(0,i.jsx)(n.code,{children:"ImplicitReset"})," traits."]}),"\n",(0,i.jsx)(n.p,{children:'For example, you could "gate" the default implicit clock as follows:'}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nclass MyModule extends Module with ImplicitClock {\n  val gate = IO(Input(Bool()))\n  val in = IO(Input(UInt(8.W)))\n  val out = IO(Output(UInt(8.W)))\n  // We could just assign this to val implicitClock, but this allows us to give it a custom name\n  val gatedClock = (clock.asBool || gate).asClock\n  // The trait requires us to implement this method referring to the clock\n  // Note that this is a def, but the actual clock value must be assigned to a val\n  override protected def implicitClock = gatedClock\n\n  val r = Reg(UInt(8.W))\n  out := r\n  r := in\n}\n"})}),"\n",(0,i.jsx)(n.p,{children:"This gives the following Verilog:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule MyModule(\n  input        clock,\n               reset,\n               gate,\n  input  [7:0] in,\n  output [7:0] out\n);\n\n  wire       gatedClock = clock | gate;\n  reg  [7:0] r;\n  always @(posedge gatedClock)\n    r <= in;\n  assign out = r;\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_MyModule_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyModule_Verification.sv"\n`ifndef layers_MyModule_Verification_Cover\n`define layers_MyModule_Verification_Cover\n`endif // layers_MyModule_Verification_Cover\n\n// ----- 8< ----- FILE "Verification/Assume/layers_MyModule_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyModule_Verification.sv"\n`ifndef layers_MyModule_Verification_Assume\n`define layers_MyModule_Verification_Assume\n`endif // layers_MyModule_Verification_Assume\n\n// ----- 8< ----- FILE "Verification/Assert/layers_MyModule_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyModule_Verification.sv"\n`ifndef layers_MyModule_Verification_Assert\n`define layers_MyModule_Verification_Assert\n`endif // layers_MyModule_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_MyModule_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_MyModule_Verification\n`define layers_MyModule_Verification\n`endif // layers_MyModule_Verification\n'})}),"\n",(0,i.jsxs)(n.p,{children:["If you do not care about the name of the overriden clock, you can just assign it to ",(0,i.jsx)(n.code,{children:"val implicitClock"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"override protected val implicitClock = (clock.asBool || gate).asClock\n"})}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.code,{children:"ImplicitReset"})," works analogously to ",(0,i.jsx)(n.code,{children:"ImplicitClock"}),"."]}),"\n",(0,i.jsx)(n.h2,{id:"how-do-i-minimize-the-number-of-bits-used-in-an-output-vector",children:"How do I minimize the number of bits used in an output vector?"}),"\n",(0,i.jsxs)(n.p,{children:["Use inferred width and a ",(0,i.jsx)(n.code,{children:"Seq"})," instead of a ",(0,i.jsx)(n.code,{children:"Vec"}),":"]}),"\n",(0,i.jsx)(n.p,{children:"Consider:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\n// Count the number of set bits up to and including each bit position\nclass CountBits(width: Int) extends Module {\n  val bits = IO(Input(UInt(width.W)))\n  val countVector = IO(Output(Vec(width, UInt())))\n\n  private val countSequence = Seq.tabulate(width)(i => Wire(UInt()))\n  countSequence.zipWithIndex.foreach { case (port, i) =>\n    port := util.PopCount(bits(i, 0))\n  }\n  countVector := countSequence\n}\n\nclass Top(width: Int) extends Module {\n  val countBits = Module(new CountBits(width))\n  countBits.bits :<>= DontCare\n  dontTouch(countBits.bits)\n  dontTouch(countBits.countVector)\n}\n"})}),"\n",(0,i.jsx)(n.p,{children:"Note that top modules or public modules cannot have unknown widths."}),"\n",(0,i.jsxs)(n.p,{children:["Unlike ",(0,i.jsx)(n.code,{children:"Vecs"})," which represent a singular Chisel type and must have the same width for every element,\n",(0,i.jsx)(n.code,{children:"Seq"})," is a purely Scala construct, so their elements are independent from the perspective of Chisel and can have different widths."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule CountBits(\t// cookbook.md:780:7\n  input  [3:0] bits,\t// cookbook.md:781:16\n  output [2:0] countVector_0,\t// cookbook.md:782:23\n               countVector_1,\t// cookbook.md:782:23\n               countVector_2,\t// cookbook.md:782:23\n               countVector_3\t// cookbook.md:782:23\n);\n"})}),"\n",(0,i.jsx)(n.h2,{id:"how-do-i-resolve-dynamic-index--is-too-widenarrow-for-extractee-",children:'How do I resolve "Dynamic index ... is too wide/narrow for extractee ..."?'}),"\n",(0,i.jsx)(n.p,{children:'Chisel will warn if a dynamic index is not the correctly-sized width for indexing a Vec or UInt.\n"Correctly-sized" means that the width of the index should be the log2 of the size of the indexee.\nIf the indexee is a non-power-of-2 size, use the ceiling of the log2 result.'}),"\n",(0,i.jsxs)(n.p,{children:["When the index does not have enough bits to address all entries or bits in the extractee, you can ",(0,i.jsx)(n.code,{children:".pad"})," the index to increase the width."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class TooNarrow extends RawModule {\n  val extractee = Wire(UInt(7.W))\n  val index = Wire(UInt(2.W))\n  extractee(index)\n}\ncompile(new TooNarrow)\n// [warn] cookbook.md 829:12: [W003] Dynamic index with width 2 is too small for extractee of width 7\n// [warn] There were 1 warning(s) during hardware elaboration.\n"})}),"\n",(0,i.jsxs)(n.p,{children:["This can be fixed with ",(0,i.jsx)(n.code,{children:"pad"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class TooNarrowFixed extends RawModule {\n  val extractee = Wire(UInt(7.W))\n  val index = Wire(UInt(2.W))\n  extractee(index.pad(3))\n}\ncompile(new TooNarrowFixed)\n"})}),"\n",(0,i.jsx)(n.h4,{id:"use-bit-extraction-when-the-index-is-too-wide",children:"Use bit extraction when the index is too wide"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class TooWide extends RawModule {\n  val extractee = Wire(Vec(8, UInt(32.W)))\n  val index = Wire(UInt(4.W))\n  extractee(index)\n}\ncompile(new TooWide)\n// [warn] cookbook.md 855:12: [W004] Dynamic index with width 4 is too wide for Vec of size 8 (expected index width 3).\n// [warn] There were 1 warning(s) during hardware elaboration.\n"})}),"\n",(0,i.jsx)(n.p,{children:"This can be fixed with bit extraction:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class TooWideFixed extends RawModule {\n  val extractee = Wire(Vec(8, UInt(32.W)))\n  val index = Wire(UInt(4.W))\n  extractee(index(2, 0))\n}\ncompile(new TooWideFixed)\n"})}),"\n",(0,i.jsxs)(n.p,{children:["Note that size 1 ",(0,i.jsx)(n.code,{children:"Vecs"})," and ",(0,i.jsx)(n.code,{children:"UInts"})," should be indexed by a zero-width ",(0,i.jsx)(n.code,{children:"UInt"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class SizeOneVec extends RawModule {\n  val extractee = Wire(Vec(1, UInt(32.W)))\n  val index = Wire(UInt(0.W))\n  extractee(index)\n}\ncompile(new SizeOneVec)\n"})}),"\n",(0,i.jsxs)(n.p,{children:["Because ",(0,i.jsx)(n.code,{children:"pad"})," only pads if the desired width is less than the current width of the argument,\nyou can use ",(0,i.jsx)(n.code,{children:"pad"})," in conjunction with bit extraction when the widths may be too wide or too\nnarrow under different circumstances"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3.util.log2Ceil\nclass TooWideOrNarrow(extracteeSize: Int, indexWidth: Int) extends Module {\n  val extractee = Wire(Vec(extracteeSize, UInt(8.W)))\n  val index = Wire(UInt(indexWidth.W))\n  val correctWidth = log2Ceil(extracteeSize)\n  extractee(index.pad(correctWidth)(correctWidth - 1, 0))\n}\ncompile(new TooWideOrNarrow(8, 2))\ncompile(new TooWideOrNarrow(8, 4))\n"})}),"\n",(0,i.jsxs)(n.p,{children:["Another option for dynamic bit selection of ",(0,i.jsx)(n.code,{children:"UInts"})," (but not ",(0,i.jsx)(n.code,{children:"Vec"})," dynamic indexing) is to do a dynamic\nright shift of the extractee by the index and then just bit select a single bit:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class TooWideOrNarrowUInt(extracteeSize: Int, indexWidth: Int) extends Module {\n  val extractee = Wire(UInt(extracteeSize.W))\n  val index = Wire(UInt(indexWidth.W))\n  (extractee >> index)(0)\n}\ncompile(new TooWideOrNarrowUInt(8, 2))\ncompile(new TooWideOrNarrowUInt(8, 4))\n"})}),"\n",(0,i.jsx)(n.h2,{id:"predictable-naming",children:"Predictable Naming"}),"\n",(0,i.jsx)(n.h3,{id:"how-do-i-get-chisel-to-name-signals-properly-in-blocks-like-whenwithclockandreset",children:"How do I get Chisel to name signals properly in blocks like when/withClockAndReset?"}),"\n",(0,i.jsxs)(n.p,{children:["Use the compiler plugin, and check out the ",(0,i.jsx)(n.a,{href:"naming",children:"Naming Cookbook"})," if that still does not do what you want."]}),"\n",(0,i.jsx)(n.h3,{id:"how-do-i-get-chisel-to-name-the-results-of-vector-reads-properly",children:"How do I get Chisel to name the results of vector reads properly?"}),"\n",(0,i.jsx)(n.p,{children:"Currently, name information is lost when using dynamic indexing. For example:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\n\nclass Foo extends Module {\n  val io = IO(new Bundle {\n    val in = Input(Vec(4, Bool()))\n    val idx = Input(UInt(2.W))\n    val en = Input(Bool())\n    val out = Output(Bool())\n  })\n\n  val x = io.in(io.idx)\n  val y = x && io.en\n  io.out := y\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["The above code loses the ",(0,i.jsx)(n.code,{children:"x"})," name, instead using ",(0,i.jsx)(n.code,{children:"_GEN_3"})," (the other ",(0,i.jsx)(n.code,{children:"_GEN_*"})," signals are expected)."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Foo(\t// cookbook.md:933:7\n  input        clock,\t// cookbook.md:933:7\n               reset,\t// cookbook.md:933:7\n               io_in_0,\t// cookbook.md:934:14\n               io_in_1,\t// cookbook.md:934:14\n               io_in_2,\t// cookbook.md:934:14\n               io_in_3,\t// cookbook.md:934:14\n  input  [1:0] io_idx,\t// cookbook.md:934:14\n  input        io_en,\t// cookbook.md:934:14\n  output       io_out\t// cookbook.md:934:14\n);\n\n  wire [3:0] _GEN = {{io_in_3}, {io_in_2}, {io_in_1}, {io_in_0}};\t// cookbook.md:942:13\n  assign io_out = _GEN[io_idx] & io_en;\t// cookbook.md:933:7, :942:13\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Foo_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Foo_Verification.sv"\n`ifndef layers_Foo_Verification_Cover\n`define layers_Foo_Verification_Cover\t// <stdin>:6:5\n`endif // layers_Foo_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Foo_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Foo_Verification.sv"\n`ifndef layers_Foo_Verification_Assume\n`define layers_Foo_Verification_Assume\t// <stdin>:5:5\n`endif // layers_Foo_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Foo_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Foo_Verification.sv"\n`ifndef layers_Foo_Verification_Assert\n`define layers_Foo_Verification_Assert\t// <stdin>:4:5\n`endif // layers_Foo_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_Foo_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Foo_Verification\n`define layers_Foo_Verification\t// <stdin>:3:3\n`endif // layers_Foo_Verification\t// <stdin>:3:3\n'})}),"\n",(0,i.jsx)(n.p,{children:"This can be worked around by creating a wire and connecting the dynamic index to the wire:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"val x = WireInit(io.in(io.idx))\n"})}),"\n",(0,i.jsx)(n.p,{children:"Which produces:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Foo2(\t// cookbook.md:956:7\n  input        clock,\t// cookbook.md:956:7\n               reset,\t// cookbook.md:956:7\n               io_in_0,\t// cookbook.md:957:14\n               io_in_1,\t// cookbook.md:957:14\n               io_in_2,\t// cookbook.md:957:14\n               io_in_3,\t// cookbook.md:957:14\n  input  [1:0] io_idx,\t// cookbook.md:957:14\n  input        io_en,\t// cookbook.md:957:14\n  output       io_out\t// cookbook.md:957:14\n);\n\n  wire [3:0] _GEN = {{io_in_3}, {io_in_2}, {io_in_1}, {io_in_0}};\t// cookbook.md:964:19\n  assign io_out = _GEN[io_idx] & io_en;\t// cookbook.md:956:7, :964:19, :965:13\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Foo2_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Foo2_Verification.sv"\n`ifndef layers_Foo2_Verification_Cover\n`define layers_Foo2_Verification_Cover\t// <stdin>:6:5\n`endif // layers_Foo2_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Foo2_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Foo2_Verification.sv"\n`ifndef layers_Foo2_Verification_Assume\n`define layers_Foo2_Verification_Assume\t// <stdin>:5:5\n`endif // layers_Foo2_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Foo2_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Foo2_Verification.sv"\n`ifndef layers_Foo2_Verification_Assert\n`define layers_Foo2_Verification_Assert\t// <stdin>:4:5\n`endif // layers_Foo2_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_Foo2_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Foo2_Verification\n`define layers_Foo2_Verification\t// <stdin>:3:3\n`endif // layers_Foo2_Verification\t// <stdin>:3:3\n'})}),"\n",(0,i.jsx)(n.h3,{id:"how-can-i-dynamically-setparametrize-the-name-of-a-module",children:"How can I dynamically set/parametrize the name of a module?"}),"\n",(0,i.jsxs)(n.p,{children:["You can override the ",(0,i.jsx)(n.code,{children:"desiredName"})," function. This works with normal Chisel modules and ",(0,i.jsx)(n.code,{children:"BlackBox"}),"es. Example:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'import chisel3._\n\nclass Coffee extends BlackBox {\n    val io = IO(new Bundle {\n        val I = Input(UInt(32.W))\n        val O = Output(UInt(32.W))\n    })\n    override def desiredName = "Tea"\n}\n\nclass Salt extends Module {\n    val io = IO(new Bundle {})\n    val drink = Module(new Coffee)\n    override def desiredName = "SodiumMonochloride"\n\n    drink.io.I := 42.U\n}\n'})}),"\n",(0,i.jsxs)(n.p,{children:["Elaborating the Chisel module ",(0,i.jsx)(n.code,{children:"Salt"}),' yields our "desired names" for ',(0,i.jsx)(n.code,{children:"Salt"})," and ",(0,i.jsx)(n.code,{children:"Coffee"})," in the output Verilog:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\n// external module Tea\n\nmodule SodiumMonochloride(\t// cookbook.md:994:7\n  input clock,\t// cookbook.md:994:7\n        reset\t// cookbook.md:994:7\n);\n\n  Tea drink (\t// cookbook.md:996:23\n    .I (32\'h2A),\n    .O (/* unused */)\n  );\t// cookbook.md:996:23\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_SodiumMonochloride_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_SodiumMonochloride_Verification.sv"\n`ifndef layers_SodiumMonochloride_Verification_Cover\n`define layers_SodiumMonochloride_Verification_Cover\t// <stdin>:6:5\n`endif // layers_SodiumMonochloride_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_SodiumMonochloride_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_SodiumMonochloride_Verification.sv"\n`ifndef layers_SodiumMonochloride_Verification_Assume\n`define layers_SodiumMonochloride_Verification_Assume\t// <stdin>:5:5\n`endif // layers_SodiumMonochloride_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_SodiumMonochloride_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_SodiumMonochloride_Verification.sv"\n`ifndef layers_SodiumMonochloride_Verification_Assert\n`define layers_SodiumMonochloride_Verification_Assert\t// <stdin>:4:5\n`endif // layers_SodiumMonochloride_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_SodiumMonochloride_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_SodiumMonochloride_Verification\n`define layers_SodiumMonochloride_Verification\t// <stdin>:3:3\n`endif // layers_SodiumMonochloride_Verification\t// <stdin>:3:3\n'})}),"\n",(0,i.jsx)(n.h2,{id:"directionality",children:"Directionality"}),"\n",(0,i.jsx)(n.h3,{id:"how-do-i-strip-directions-from-a-bidirectional-bundle-or-other-data",children:"How do I strip directions from a bidirectional Bundle (or other Data)?"}),"\n",(0,i.jsxs)(n.p,{children:["Given a bidirectional port like a ",(0,i.jsx)(n.code,{children:"Decoupled"}),", you will get an error if you try to connect it directly\nto a register:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport circt.stage.ChiselStage\nimport chisel3.util.Decoupled\nclass BadRegConnect extends Module {\n  val io = IO(new Bundle {\n    val enq = Decoupled(UInt(8.W))\n  })\n\n  val monitor = Reg(chiselTypeOf(io.enq))\n  monitor := io.enq\n}\n"})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"ChiselStage.emitSystemVerilog(new BadRegConnect)\n// circt.stage.phases.Exceptions$FirtoolNonZeroExitCode: /home/runner/.cache/llvm-firtool/1.81.1/bin/firtool returned a non-zero exit code. Note that this version of Chisel (7.0.0-M2+50-f347914d-SNAPSHOT) was published against firtool version 1.81.1.\n// ------------------------------------------------------------------------------\n// ExitCode:\n// 1\n// STDOUT:\n// \n// STDERR:\n// cookbook.md:1029:20: error: 'firrtl.reg' op result #0 must be a passive non-'const' base type that does not contain analog, but got '!firrtl.bundle<ready flip: uint<1>, valid: uint<1>, bits: uint<8>>'\n// cookbook.md:1029:20: note: see current operation: %4 = \"firrtl.reg\"(%arg0) {annotations = [], name = \"monitor\", nameKind = #firrtl<name_kind interesting_name>} : (!firrtl.clock) -> !firrtl.bundle<ready flip: uint<1>, valid: uint<1>, bits: uint<8>>\n// \n// ------------------------------------------------------------------------------\n"})}),"\n",(0,i.jsxs)(n.p,{children:['While there is no construct to "strip direction" in Chisel3, wrapping a type in ',(0,i.jsx)(n.code,{children:"Output(...)"}),"\n(the default direction in Chisel3) will\nset all of the individual elements to output direction.\nThis will have the desired result when used to construct a Register:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport circt.stage.ChiselStage\nimport chisel3.util.Decoupled\nclass CoercedRegConnect extends Module {\n  val io = IO(new Bundle {\n    val enq = Flipped(Decoupled(UInt(8.W)))\n  })\n\n  // Make a Reg which contains all of the bundle's signals, regardless of their directionality\n  val monitor = Reg(Output(chiselTypeOf(io.enq)))\n  // Even though io.enq is bidirectional, := will drive all fields of monitor with the fields of io.enq\n  monitor := io.enq\n}\n"})})]})}function h(e={}){const{wrapper:n}={...(0,t.R)(),...e.components};return n?(0,i.jsx)(n,{...e,children:(0,i.jsx)(u,{...e})}):u(e)}},1871:(e,n,o)=>{o.d(n,{A:()=>l});o(6540);var i=o(5195);const t={tableOfContentsInline:"tableOfContentsInline_prmo"};var a=o(4848);function l(e){let{toc:n,minHeadingLevel:o,maxHeadingLevel:l}=e;return(0,a.jsx)("div",{className:t.tableOfContentsInline,children:(0,a.jsx)(i.A,{toc:n,minHeadingLevel:o,maxHeadingLevel:l,className:"table-of-contents",linkClassName:null})})}},5195:(e,n,o)=>{o.d(n,{A:()=>m});var i=o(6540),t=o(6342);function a(e){const n=e.map((e=>({...e,parentIndex:-1,children:[]}))),o=Array(7).fill(-1);n.forEach(((e,n)=>{const i=o.slice(2,e.level);e.parentIndex=Math.max(...i),o[e.level]=n}));const i=[];return n.forEach((e=>{const{parentIndex:o,...t}=e;o>=0?n[o].children.push(t):i.push(t)})),i}function l(e){let{toc:n,minHeadingLevel:o,maxHeadingLevel:i}=e;return n.flatMap((e=>{const n=l({toc:e.children,minHeadingLevel:o,maxHeadingLevel:i});return function(e){return e.level>=o&&e.level<=i}(e)?[{...e,children:n}]:n}))}function s(e){const n=e.getBoundingClientRect();return n.top===n.bottom?s(e.parentNode):n}function r(e,n){let{anchorTopOffset:o}=n;const i=e.find((e=>s(e).top>=o));if(i){return function(e){return e.top>0&&e.bottom<window.innerHeight/2}(s(i))?i:e[e.indexOf(i)-1]??null}return e[e.length-1]??null}function c(){const e=(0,i.useRef)(0),{navbar:{hideOnScroll:n}}=(0,t.p)();return(0,i.useEffect)((()=>{e.current=n?0:document.querySelector(".navbar").clientHeight}),[n]),e}function d(e){const n=(0,i.useRef)(void 0),o=c();(0,i.useEffect)((()=>{if(!e)return()=>{};const{linkClassName:i,linkActiveClassName:t,minHeadingLevel:a,maxHeadingLevel:l}=e;function s(){const e=function(e){return Array.from(document.getElementsByClassName(e))}(i),s=function(e){let{minHeadingLevel:n,maxHeadingLevel:o}=e;const i=[];for(let t=n;t<=o;t+=1)i.push(`h${t}.anchor`);return Array.from(document.querySelectorAll(i.join()))}({minHeadingLevel:a,maxHeadingLevel:l}),c=r(s,{anchorTopOffset:o.current}),d=e.find((e=>c&&c.id===function(e){return decodeURIComponent(e.href.substring(e.href.indexOf("#")+1))}(e)));e.forEach((e=>{!function(e,o){o?(n.current&&n.current!==e&&n.current.classList.remove(t),e.classList.add(t),n.current=e):e.classList.remove(t)}(e,e===d)}))}return document.addEventListener("scroll",s),document.addEventListener("resize",s),s(),()=>{document.removeEventListener("scroll",s),document.removeEventListener("resize",s)}}),[e,o])}var u=o(8774),h=o(4848);function p(e){let{toc:n,className:o,linkClassName:i,isChild:t}=e;return n.length?(0,h.jsx)("ul",{className:t?void 0:o,children:n.map((e=>(0,h.jsxs)("li",{children:[(0,h.jsx)(u.A,{to:`#${e.id}`,className:i??void 0,dangerouslySetInnerHTML:{__html:e.value}}),(0,h.jsx)(p,{isChild:!0,toc:e.children,className:o,linkClassName:i})]},e.id)))}):null}const f=i.memo(p);function m(e){let{toc:n,className:o="table-of-contents table-of-contents__left-border",linkClassName:s="table-of-contents__link",linkActiveClassName:r,minHeadingLevel:c,maxHeadingLevel:u,...p}=e;const m=(0,t.p)(),g=c??m.tableOfContents.minHeadingLevel,x=u??m.tableOfContents.maxHeadingLevel,y=function(e){let{toc:n,minHeadingLevel:o,maxHeadingLevel:t}=e;return(0,i.useMemo)((()=>l({toc:a(n),minHeadingLevel:o,maxHeadingLevel:t})),[n,o,t])}({toc:n,minHeadingLevel:g,maxHeadingLevel:x});return d((0,i.useMemo)((()=>{if(s&&r)return{linkClassName:s,linkActiveClassName:r,minHeadingLevel:g,maxHeadingLevel:x}}),[s,r,g,x])),(0,h.jsx)(f,{toc:y,className:o,linkClassName:s,...p})}},8453:(e,n,o)=>{o.d(n,{R:()=>l,x:()=>s});var i=o(6540);const t={},a=i.createContext(t);function l(e){const n=i.useContext(a);return i.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function s(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(t):e.components||t:l(e.components),i.createElement(a.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/7fa9ea57.5aff8b69.js b/assets/js/7fa9ea57.5aff8b69.js
new file mode 100644
index 0000000000..b8627b01a3
--- /dev/null
+++ b/assets/js/7fa9ea57.5aff8b69.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[9128],{6715:(e,n,t)=>{t.r(n),t.d(n,{assets:()=>c,contentTitle:()=>o,default:()=>p,frontMatter:()=>r,metadata:()=>a,toc:()=>d});var s=t(4848),i=t(8453);const r={layout:"docs",title:"Ports",section:"chisel3"},o="Ports",a={id:"explanations/ports",title:"Ports",description:"Ports are used as interfaces to hardware components.  A port is simply",source:"@site/docs/explanations/ports.md",sourceDirName:"explanations",slug:"/explanations/ports",permalink:"/docs/explanations/ports",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/ports.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Ports",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Polymorphism and Parameterization",permalink:"/docs/explanations/polymorphism-and-parameterization"},next:{title:"Printing",permalink:"/docs/explanations/printing"}},c={},d=[{value:"Inspecting Module ports",id:"inspecting-module-ports",level:2}];function l(e){const n={code:"code",h1:"h1",h2:"h2",p:"p",pre:"pre",...(0,i.R)(),...e.components};return(0,s.jsxs)(s.Fragment,{children:[(0,s.jsx)(n.h1,{id:"ports",children:"Ports"}),"\n",(0,s.jsxs)(n.p,{children:["Ports are used as interfaces to hardware components.  A port is simply\nany ",(0,s.jsx)(n.code,{children:"Data"})," object that has directions assigned to its members."]}),"\n",(0,s.jsxs)(n.p,{children:["Chisel provides port constructors to allow a direction to be added\n(input or output) to an object at construction time. Primitive port\nconstructors wrap the type of the port in ",(0,s.jsx)(n.code,{children:"Input"})," or ",(0,s.jsx)(n.code,{children:"Output"}),"."]}),"\n",(0,s.jsx)(n.p,{children:"An example port declaration is as follows:"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"class Decoupled extends Bundle {\n  val ready = Output(Bool())\n  val data  = Input(UInt(32.W))\n  val valid = Input(Bool())\n}\n"})}),"\n",(0,s.jsxs)(n.p,{children:["After defining ",(0,s.jsx)(n.code,{children:"Decoupled"}),", it becomes a new type that can be\nused as needed for module interfaces or for named collections of\nwires."]}),"\n",(0,s.jsx)(n.p,{children:"By folding directions into the object declarations, Chisel is able to\nprovide powerful wiring constructs described later."}),"\n",(0,s.jsx)(n.h2,{id:"inspecting-module-ports",children:"Inspecting Module ports"}),"\n",(0,s.jsx)(n.p,{children:"(Chisel 3.2+)"}),"\n",(0,s.jsxs)(n.p,{children:["Chisel 3.2 introduced ",(0,s.jsx)(n.code,{children:"DataMirror.modulePorts"})," which can be used to inspect the IOs of any Chisel module (this includes modules in both ",(0,s.jsx)(n.code,{children:"import chisel3._"})," and ",(0,s.jsx)(n.code,{children:"import Chisel._"}),", as well as BlackBoxes from each package).\nHere is an example of how to use this API:"]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:'import chisel3.reflect.DataMirror\nimport chisel3.stage.ChiselGeneratorAnnotation\nimport circt.stage.ChiselStage\n\nclass Adder extends Module {\n  val a = IO(Input(UInt(8.W)))\n  val b = IO(Input(UInt(8.W)))\n  val c = IO(Output(UInt(8.W)))\n  c := a +& b\n}\n\nclass Test extends Module {\n  val adder = Module(new Adder)\n  // for debug only\n  adder.a := DontCare\n  adder.b := DontCare\n\n  // Inspect ports of adder\n  // See the result below.\n   DataMirror.modulePorts(adder).foreach { case (name, port) => {\n    println(s"Found port $name: $port")\n  }}\n}\n\nChiselStage.emitSystemVerilog(new Test)\n// Found port clock: Adder.clock: IO[Clock]\n// Found port reset: Adder.reset: IO[Reset]\n// Found port a: Adder.a: IO[UInt<8>]\n// Found port b: Adder.b: IO[UInt<8>]\n// Found port c: Adder.c: IO[UInt<8>]\n// res0: String = """// Generated by CIRCT firtool-1.81.1\n// module Test(\t// ports.md:41:7\n//   input clock,\t// ports.md:41:7\n//         reset\t// ports.md:41:7\n// );\n// \n// endmodule\n// \n// \n// // ----- 8< ----- FILE "Verification/Cover/layers_Test_Verification_Cover.sv" ----- 8< -----\n// \n// // Generated by CIRCT firtool-1.81.1\n// `include "Verification/layers_Test_Verification.sv"\n// `ifndef layers_Test_Verification_Cover\n// `define layers_Test_Verification_Cover\t// <stdin>:6:5\n// `endif // layers_Test_Verification_Cover\t// <stdin>:6:5\n// \n// // ----- 8< ----- FILE "Verification/Assume/layers_Test_Verification_Assume.sv" ----- 8< -----\n// \n// // Generated by CIRCT firtool-1.81.1\n// `include "Verification/layers_Test_Verification.sv"\n// `ifndef layers_Test_Verification_Assume\n// `define layers_Test_Verification_Assume\t// <stdin>:5:5\n// `endif // layers_Test_Verification_Assume\t// <stdin>:5:5\n// \n// // ----- 8< ----- FILE "Verification/Assert/layers_Test_Verification_Assert.sv" ----- 8< -----\n// \n// // Generated by CIRCT firtool-1.81.1\n// `include "Verification/layers_Test_Verification.sv"\n// `ifndef layers_Test_Verification_Assert\n// `define layers_Test_Verification_Assert\t// <stdin>:4:5\n// `endif // layers_Test_Verification_Assert\t// <stdin>:4:5\n// \n// // ----- 8< ----- FILE "Verification/layers_Test_Verification.sv" ----- 8< -----\n// \n// // Generated by CIRCT firtool-1.81.1\n// `ifndef layers_Test_Verification\n// `define layers_Test_Verification\t// <stdin>:3:3\n// `endif // layers_Test_Verification\t// <stdin>:3:3\n// """\n'})})]})}function p(e={}){const{wrapper:n}={...(0,i.R)(),...e.components};return n?(0,s.jsx)(n,{...e,children:(0,s.jsx)(l,{...e})}):l(e)}},8453:(e,n,t)=>{t.d(n,{R:()=>o,x:()=>a});var s=t(6540);const i={},r=s.createContext(i);function o(e){const n=s.useContext(r);return s.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function a(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(i):e.components||i:o(e.components),s.createElement(r.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/7fa9ea57.a0b7aa39.js b/assets/js/7fa9ea57.a0b7aa39.js
deleted file mode 100644
index 75d121af40..0000000000
--- a/assets/js/7fa9ea57.a0b7aa39.js
+++ /dev/null
@@ -1 +0,0 @@
-"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[9128],{6715:(e,n,t)=>{t.r(n),t.d(n,{assets:()=>c,contentTitle:()=>i,default:()=>p,frontMatter:()=>r,metadata:()=>a,toc:()=>d});var o=t(4848),s=t(8453);const r={layout:"docs",title:"Ports",section:"chisel3"},i="Ports",a={id:"explanations/ports",title:"Ports",description:"Ports are used as interfaces to hardware components.  A port is simply",source:"@site/docs/explanations/ports.md",sourceDirName:"explanations",slug:"/explanations/ports",permalink:"/docs/explanations/ports",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/ports.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Ports",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Polymorphism and Parameterization",permalink:"/docs/explanations/polymorphism-and-parameterization"},next:{title:"Printing",permalink:"/docs/explanations/printing"}},c={},d=[{value:"Inspecting Module ports",id:"inspecting-module-ports",level:2}];function l(e){const n={code:"code",h1:"h1",h2:"h2",p:"p",pre:"pre",...(0,s.R)(),...e.components};return(0,o.jsxs)(o.Fragment,{children:[(0,o.jsx)(n.h1,{id:"ports",children:"Ports"}),"\n",(0,o.jsxs)(n.p,{children:["Ports are used as interfaces to hardware components.  A port is simply\nany ",(0,o.jsx)(n.code,{children:"Data"})," object that has directions assigned to its members."]}),"\n",(0,o.jsxs)(n.p,{children:["Chisel provides port constructors to allow a direction to be added\n(input or output) to an object at construction time. Primitive port\nconstructors wrap the type of the port in ",(0,o.jsx)(n.code,{children:"Input"})," or ",(0,o.jsx)(n.code,{children:"Output"}),"."]}),"\n",(0,o.jsx)(n.p,{children:"An example port declaration is as follows:"}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"class Decoupled extends Bundle {\n  val ready = Output(Bool())\n  val data  = Input(UInt(32.W))\n  val valid = Input(Bool())\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["After defining ",(0,o.jsx)(n.code,{children:"Decoupled"}),", it becomes a new type that can be\nused as needed for module interfaces or for named collections of\nwires."]}),"\n",(0,o.jsx)(n.p,{children:"By folding directions into the object declarations, Chisel is able to\nprovide powerful wiring constructs described later."}),"\n",(0,o.jsx)(n.h2,{id:"inspecting-module-ports",children:"Inspecting Module ports"}),"\n",(0,o.jsx)(n.p,{children:"(Chisel 3.2+)"}),"\n",(0,o.jsxs)(n.p,{children:["Chisel 3.2 introduced ",(0,o.jsx)(n.code,{children:"DataMirror.modulePorts"})," which can be used to inspect the IOs of any Chisel module (this includes modules in both ",(0,o.jsx)(n.code,{children:"import chisel3._"})," and ",(0,o.jsx)(n.code,{children:"import Chisel._"}),", as well as BlackBoxes from each package).\nHere is an example of how to use this API:"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:'import chisel3.reflect.DataMirror\nimport chisel3.stage.ChiselGeneratorAnnotation\nimport circt.stage.ChiselStage\n\nclass Adder extends Module {\n  val a = IO(Input(UInt(8.W)))\n  val b = IO(Input(UInt(8.W)))\n  val c = IO(Output(UInt(8.W)))\n  c := a +& b\n}\n\nclass Test extends Module {\n  val adder = Module(new Adder)\n  // for debug only\n  adder.a := DontCare\n  adder.b := DontCare\n\n  // Inspect ports of adder\n  // See the result below.\n   DataMirror.modulePorts(adder).foreach { case (name, port) => {\n    println(s"Found port $name: $port")\n  }}\n}\n\nChiselStage.emitSystemVerilog(new Test)\n// Found port clock: Adder.clock: IO[Clock]\n// Found port reset: Adder.reset: IO[Reset]\n// Found port a: Adder.a: IO[UInt<8>]\n// Found port b: Adder.b: IO[UInt<8>]\n// Found port c: Adder.c: IO[UInt<8>]\n// res0: String = """// Generated by CIRCT firtool-1.81.1\n// module Test(\t// ports.md:41:7\n//   input clock,\t// ports.md:41:7\n//         reset\t// ports.md:41:7\n// );\n// \n// endmodule\n// \n// """\n'})})]})}function p(e={}){const{wrapper:n}={...(0,s.R)(),...e.components};return n?(0,o.jsx)(n,{...e,children:(0,o.jsx)(l,{...e})}):l(e)}},8453:(e,n,t)=>{t.d(n,{R:()=>i,x:()=>a});var o=t(6540);const s={},r=o.createContext(s);function i(e){const n=o.useContext(r);return o.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function a(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(s):e.components||s:i(e.components),o.createElement(r.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/868241d3.8f24b23c.js b/assets/js/868241d3.8f24b23c.js
deleted file mode 100644
index 27fd4ed127..0000000000
--- a/assets/js/868241d3.8f24b23c.js
+++ /dev/null
@@ -1 +0,0 @@
-"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[9017],{7333:(e,n,s)=>{s.r(n),s.d(n,{assets:()=>o,contentTitle:()=>a,default:()=>d,frontMatter:()=>i,metadata:()=>l,toc:()=>r});var c=s(4848),t=s(8453);const i={},a=void 0,l={type:"mdx",permalink:"/generated/scaladoc_links",source:"@site/src/pages/generated/scaladoc_links.md",description:"- Latest (6.5.0)",frontMatter:{},unlisted:!1},o={},r=[];function h(e){const n={a:"a",li:"li",ul:"ul",...(0,t.R)(),...e.components};return(0,c.jsxs)(n.ul,{children:["\n",(0,c.jsx)(n.li,{children:(0,c.jsx)(n.a,{href:"pathname:///api/latest/index.html",children:"Latest (6.5.0)"})}),"\n",(0,c.jsx)(n.li,{children:(0,c.jsx)(n.a,{href:"https://s01.oss.sonatype.org/service/local/repositories/snapshots/archive/org/chipsalliance/chisel_2.13/7.0.0-M2+49-ab82fc22-SNAPSHOT/chisel_2.13-7.0.0-M2+49-ab82fc22-SNAPSHOT-javadoc.jar/!/index.html",children:"Snapshot"})}),"\n",(0,c.jsx)(n.li,{children:(0,c.jsx)(n.a,{href:"https://javadoc.io/doc/org.chipsalliance/chisel_2.13/7.0.0-M2",children:"7.0.0-M2"})}),"\n",(0,c.jsx)(n.li,{children:(0,c.jsx)(n.a,{href:"https://javadoc.io/doc/org.chipsalliance/chisel_2.13/6.5.0",children:"6.5.0"})}),"\n",(0,c.jsx)(n.li,{children:(0,c.jsx)(n.a,{href:"https://javadoc.io/doc/org.chipsalliance/chisel_2.13/5.3.0",children:"5.3.0"})}),"\n",(0,c.jsx)(n.li,{children:(0,c.jsx)(n.a,{href:"https://javadoc.io/doc/edu.berkeley.cs/chisel3_2.13/3.6.1",children:"3.6.1"})}),"\n",(0,c.jsx)(n.li,{children:(0,c.jsx)(n.a,{href:"https://javadoc.io/doc/edu.berkeley.cs/chisel3_2.13/3.5.6",children:"3.5.6"})}),"\n"]})}function d(e={}){const{wrapper:n}={...(0,t.R)(),...e.components};return n?(0,c.jsx)(n,{...e,children:(0,c.jsx)(h,{...e})}):h(e)}},8453:(e,n,s)=>{s.d(n,{R:()=>a,x:()=>l});var c=s(6540);const t={},i=c.createContext(t);function a(e){const n=c.useContext(i);return c.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function l(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(t):e.components||t:a(e.components),c.createElement(i.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/868241d3.cd7cbf8a.js b/assets/js/868241d3.cd7cbf8a.js
new file mode 100644
index 0000000000..2b402372a7
--- /dev/null
+++ b/assets/js/868241d3.cd7cbf8a.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[9017],{7333:(e,n,s)=>{s.r(n),s.d(n,{assets:()=>o,contentTitle:()=>l,default:()=>d,frontMatter:()=>i,metadata:()=>a,toc:()=>r});var t=s(4848),c=s(8453);const i={},l=void 0,a={type:"mdx",permalink:"/generated/scaladoc_links",source:"@site/src/pages/generated/scaladoc_links.md",description:"- Latest (6.5.0)",frontMatter:{},unlisted:!1},o={},r=[];function h(e){const n={a:"a",li:"li",ul:"ul",...(0,c.R)(),...e.components};return(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"pathname:///api/latest/index.html",children:"Latest (6.5.0)"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"https://s01.oss.sonatype.org/service/local/repositories/snapshots/archive/org/chipsalliance/chisel_2.13/7.0.0-M2+50-f347914d-SNAPSHOT/chisel_2.13-7.0.0-M2+50-f347914d-SNAPSHOT-javadoc.jar/!/index.html",children:"Snapshot"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"https://javadoc.io/doc/org.chipsalliance/chisel_2.13/7.0.0-M2",children:"7.0.0-M2"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"https://javadoc.io/doc/org.chipsalliance/chisel_2.13/6.5.0",children:"6.5.0"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"https://javadoc.io/doc/org.chipsalliance/chisel_2.13/5.3.0",children:"5.3.0"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"https://javadoc.io/doc/edu.berkeley.cs/chisel3_2.13/3.6.1",children:"3.6.1"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"https://javadoc.io/doc/edu.berkeley.cs/chisel3_2.13/3.5.6",children:"3.5.6"})}),"\n"]})}function d(e={}){const{wrapper:n}={...(0,c.R)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(h,{...e})}):h(e)}},8453:(e,n,s)=>{s.d(n,{R:()=>l,x:()=>a});var t=s(6540);const c={},i=t.createContext(c);function l(e){const n=t.useContext(i);return t.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function a(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(c):e.components||c:l(e.components),t.createElement(i.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/916cecd1.117f3b9d.js b/assets/js/916cecd1.117f3b9d.js
deleted file mode 100644
index 8f807aa300..0000000000
--- a/assets/js/916cecd1.117f3b9d.js
+++ /dev/null
@@ -1 +0,0 @@
-"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[2289],{759:(e,n,a)=>{a.r(n),a.d(n,{assets:()=>r,contentTitle:()=>o,default:()=>h,frontMatter:()=>l,metadata:()=>d,toc:()=>c});var i=a(4848),s=a(8453),t=a(1871);const l={sidebar_position:1},o="Naming Cookbook",d={id:"cookbooks/naming",title:"Naming Cookbook",description:"I still have _T signals, can this be fixed?",source:"@site/docs/cookbooks/naming.md",sourceDirName:"cookbooks",slug:"/cookbooks/naming",permalink:"/docs/cookbooks/naming",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/cookbooks/naming.md",tags:[],version:"current",sidebarPosition:1,frontMatter:{sidebar_position:1},sidebar:"chiselSidebar",previous:{title:"General Cookbook",permalink:"/docs/cookbooks/cookbook"},next:{title:"Hierarchy Cookbook",permalink:"/docs/cookbooks/hierarchy"}},r={},c=[{value:"I still have _T signals, can this be fixed?",id:"i-still-have-_t-signals-can-this-be-fixed",level:3},{value:"I have so many wires with the same name, like <code>x</code>, <code>x_1</code> and <code>x_2</code>. How can I make them easier to understand?",id:"i-have-so-many-wires-with-the-same-name-like-x-x_1-and-x_2-how-can-i-make-them-easier-to-understand",level:3},{value:"How can I get better names for code generated by <code>when</code> clauses?",id:"how-can-i-get-better-names-for-code-generated-by-when-clauses",level:3},{value:"I still see _GEN signals, can this be fixed?",id:"i-still-see-_gen-signals-can-this-be-fixed",level:3},{value:"How do I make my modules have more stable names instead of &#39;Module_1&#39; and &#39;Module_42&#39;?",id:"how-do-i-make-my-modules-have-more-stable-names-instead-of-module_1-and-module_42",level:3},{value:"How would I write my own <code>typeName</code> for my data types?",id:"how-would-i-write-my-own-typename-for-my-data-types",level:3},{value:"I don&#39;t want to override <code>typeName</code> over and over! Is there any easy way to generate a <code>typeName</code>?",id:"i-dont-want-to-override-typename-over-and-over-is-there-any-easy-way-to-generate-a-typename",level:3},{value:"Can I name my bundles in FIRRTL, so I don&#39;t generate extremely long bundle types?",id:"can-i-name-my-bundles-in-firrtl-so-i-dont-generate-extremely-long-bundle-types",level:3},{value:"Why do I keep seeing _stripped suffixing everywhere in my FIRRTL? I didn&#39;t specify that in my <code>aliasName</code>.",id:"why-do-i-keep-seeing-_stripped-suffixing-everywhere-in-my-firrtl-i-didnt-specify-that-in-my-aliasname",level:3},{value:"I want to add some hardware or assertions, but each time I do all the signal names get bumped!",id:"i-want-to-add-some-hardware-or-assertions-but-each-time-i-do-all-the-signal-names-get-bumped",level:3},{value:"I want to force a signal (or instance) name to something, how do I do that?",id:"i-want-to-force-a-signal-or-instance-name-to-something-how-do-i-do-that",level:3},{value:"How can I omit the prefix in certain parts of the code?",id:"how-can-i-omit-the-prefix-in-certain-parts-of-the-code",level:3},{value:"I am still not getting the name I want. For example, inlining an instance changes my name!",id:"i-am-still-not-getting-the-name-i-want-for-example-inlining-an-instance-changes-my-name",level:3}];function u(e){const n={a:"a",code:"code",em:"em",h1:"h1",h3:"h3",p:"p",pre:"pre",...(0,s.R)(),...e.components};return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsx)(n.h1,{id:"naming-cookbook",children:"Naming Cookbook"}),"\n","\n","\n",(0,i.jsx)(t.A,{toc:c}),"\n",(0,i.jsx)(n.h3,{id:"i-still-have-_t-signals-can-this-be-fixed",children:"I still have _T signals, can this be fixed?"}),"\n",(0,i.jsx)(n.p,{children:"See the next answer!"}),"\n",(0,i.jsxs)(n.h3,{id:"i-have-so-many-wires-with-the-same-name-like-x-x_1-and-x_2-how-can-i-make-them-easier-to-understand",children:["I have so many wires with the same name, like ",(0,i.jsx)(n.code,{children:"x"}),", ",(0,i.jsx)(n.code,{children:"x_1"})," and ",(0,i.jsx)(n.code,{children:"x_2"}),". How can I make them easier to understand?"]}),"\n",(0,i.jsxs)(n.p,{children:["Signals with ",(0,i.jsx)(n.code,{children:"_T"})," names or names that Chisel has to uniquify\noften are intermediate values generated within loops, function calls, or ",(0,i.jsx)(n.code,{children:"when"})," predicates.\nThey can also be consumed by verification statements like ",(0,i.jsx)(n.code,{children:"assert"})," or ",(0,i.jsx)(n.code,{children:"prints"}),".\nIn these cases, the compiler plugin often can't find a good prefix for the generated\nintermediate signals and can't name them at all or has to make up a unique name for them."]}),"\n",(0,i.jsxs)(n.p,{children:["We recommend you manually insert calls to ",(0,i.jsx)(n.code,{children:"prefix"})," to clarify these cases:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'import chisel3.experimental.prefix\nclass ExamplePrefix extends Module {\n\n  Seq.tabulate(2) { i =>\n    Seq.tabulate(2) { j =>\n      prefix(s"loop_${i}_${j}"){\n        val x = WireInit((i*0x10+j).U(8.W))\n        dontTouch(x)\n      }\n    }\n  }\n}\n'})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule ExamplePrefix(\n  input clock,\n        reset\n);\n\n  wire [7:0] loop_0_0_x = 8'h0;\n  wire [7:0] loop_0_1_x = 8'h1;\n  wire [7:0] loop_1_0_x = 8'h10;\n  wire [7:0] loop_1_1_x = 8'h11;\nendmodule\n\n"})}),"\n",(0,i.jsxs)(n.h3,{id:"how-can-i-get-better-names-for-code-generated-by-when-clauses",children:["How can I get better names for code generated by ",(0,i.jsx)(n.code,{children:"when"})," clauses?"]}),"\n",(0,i.jsxs)(n.p,{children:["The ",(0,i.jsx)(n.code,{children:"prefix"})," API can help with code inside ",(0,i.jsx)(n.code,{children:"when"})," clauses:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'class ExampleWhenPrefix extends Module {\n\n  val in = IO(Input(UInt(4.W)))\n  val out = IO(Output(UInt(4.W)))\n\n  out := DontCare\n\n  Seq.tabulate(2) { i =>\n    val j = i + 1\n    prefix(s"clause_${j}") {\n      when (in === j.U) {\n        val foo = Reg(UInt(4.W))\n        foo := in + j.U(4.W)\n        out := foo\n      }\n    }\n  }\n}\n'})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule ExampleWhenPrefix(\n  input        clock,\n               reset,\n  input  [3:0] in,\n  output [3:0] out\n);\n\n  reg [3:0] clause_1_foo;\n  reg [3:0] clause_2_foo;\n  always @(posedge clock) begin\n    clause_1_foo <= in + 4'h1;\n    clause_2_foo <= in + 4'h2;\n  end // always @(posedge)\n  assign out = in == 4'h2 ? clause_2_foo : clause_1_foo;\nendmodule\n\n"})}),"\n",(0,i.jsx)(n.h3,{id:"i-still-see-_gen-signals-can-this-be-fixed",children:"I still see _GEN signals, can this be fixed?"}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.code,{children:"_GEN"})," signals are usually generated from the FIRRTL compiler, rather than the Chisel library. We are working on\nrenaming these signals with more context-dependent names, but it is a work in progress. Thanks for caring!"]}),"\n",(0,i.jsx)(n.h3,{id:"how-do-i-make-my-modules-have-more-stable-names-instead-of-module_1-and-module_42",children:"How do I make my modules have more stable names instead of 'Module_1' and 'Module_42'?"}),"\n",(0,i.jsxs)(n.p,{children:["This is an example of the module instability problem, which results from several modules all sharing the exact same name. To fix this, you must add more specificity to your ",(0,i.jsx)(n.code,{children:"Module"}),"'s name to avoid these name collisions."]}),"\n",(0,i.jsxs)(n.p,{children:["This can be done by leveraging the ",(0,i.jsx)(n.code,{children:"desiredName"})," and ",(0,i.jsx)(n.code,{children:"typeName"})," APIs.\n",(0,i.jsx)(n.code,{children:"desiredName"})," is for indicating the names of ",(0,i.jsx)(n.code,{children:"Modules"})," (e.g. influenced by the parameters passed in), and ",(0,i.jsx)(n.code,{children:"typeName"})," is useful for modules which are type-parameterized by subclasses of ",(0,i.jsx)(n.code,{children:"Data"}),". Overriding ",(0,i.jsx)(n.code,{children:"desiredName"})," can reduce or even eliminate name collisions. For instance, suppose your module looks like the following:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class MyModule[T <: Data](gen: T) extends Module {\n  // ...\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["We can override ",(0,i.jsx)(n.code,{children:"desiredName"})," of the module to include the type name of the ",(0,i.jsx)(n.code,{children:"gen"})," parameter like so:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'class MyModule[T <: Data](gen: T) extends Module {\n  override def desiredName = s"MyModule_${gen.typeName}"\n}\n'})}),"\n",(0,i.jsxs)(n.p,{children:["Any instances of your ",(0,i.jsx)(n.code,{children:"MyModule"})," will now have Verilog module names containing the type parameter."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"val foo = Module(new MyModule(UInt(4.W))) // MyModule_UInt4 // MyModule_UInt4\nval bar = Module(new MyModule(Vec(3, UInt(4.W)))) // MyModule_Vec3_UInt4\n"})}),"\n",(0,i.jsxs)(n.p,{children:["Note that all base Chisel util modules, like ",(0,i.jsx)(n.code,{children:"Queue"}),", already implement ",(0,i.jsx)(n.code,{children:"desiredName"})," like this:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"val fooQueue = Module(new Queue(UInt(8.W), 4)) // Verilog module would be named 'Queue4_UInt8' // Verilog module would be named 'Queue4_UInt8'\nval barQueue = Module(new Queue(SInt(12.W), 3)) // ... and 'Queue3_SInt12' // ... and 'Queue3_SInt12'\nval bazQueue = Module(new Queue(Bool(), 16)) // ... and 'Queue16_Bool'\n"})}),"\n",(0,i.jsxs)(n.h3,{id:"how-would-i-write-my-own-typename-for-my-data-types",children:["How would I write my own ",(0,i.jsx)(n.code,{children:"typeName"})," for my data types?"]}),"\n",(0,i.jsxs)(n.p,{children:["If you're using your own user-defined ",(0,i.jsx)(n.code,{children:"Bundle"}),", you can increase the specificity of its own ",(0,i.jsx)(n.code,{children:"typeName"})," by overriding it. All ",(0,i.jsx)(n.code,{children:"Data"})," types have a simple default implementation of ",(0,i.jsx)(n.code,{children:"typeName"})," (which is simply its class name), but you can override this yourself:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class MyBundle[T <: Data](gen: T, intParam: Int) extends Bundle {\n  // Generate a stable typeName for this Bundle. Two 'words' are present\n  // in this implementation: the bundle's name plus its integer parameter\n  // (something like 'MyBundle9')\n  // and the generator's typeName, which itself can be composed of 'words'\n  // (something like 'Vec3_UInt4')\n  override def typeName = s\"MyBundle${intParam}_${gen.typeName}\"\n\n  // ...\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["Now if you use your ",(0,i.jsx)(n.code,{children:"MyBundle"})," in a module like a ",(0,i.jsx)(n.code,{children:"Queue"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"val fooQueue = Module(new Queue(new MyBundle(UInt(4.W), 3), 16)) // Queue16_MyBundle3_UInt4\n"})}),"\n",(0,i.jsxs)(n.p,{children:["The suggested pattern for ",(0,i.jsx)(n.code,{children:"typeName"}),", and subsequently ",(0,i.jsx)(n.code,{children:"desiredName"}),", is to fold single integer-like parameters with the name itself (for example, ",(0,i.jsx)(n.code,{children:"Queue4"}),", ",(0,i.jsx)(n.code,{children:"UInt3"}),", ",(0,i.jsx)(n.code,{children:"MyBundle9"}),") to form 'words' and separate these 'words' with underscores (",(0,i.jsx)(n.code,{children:"Queue4_UInt3"}),", ",(0,i.jsx)(n.code,{children:"FooBundle_BarType4"}),")."]}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.code,{children:"Bundles"})," that have multiple integer arguments aren't presently addressed by any of the built-in modules, and so implementing a descriptive and sufficiently differentiable ",(0,i.jsx)(n.code,{children:"typeName"})," for such ",(0,i.jsx)(n.code,{children:"Bundles"})," is left as an exercise to the reader. However, integers should not occur with an underscore before them at the very end of the ",(0,i.jsx)(n.code,{children:"typeName"})," (e.g. ",(0,i.jsx)(n.code,{children:"MyBundle_1"}),") because this is the ",(0,i.jsx)(n.em,{children:"same"})," syntax used for duplicates, and so would cause confusion. Having to disambiguate modules all named ",(0,i.jsx)(n.code,{children:"Queue32_MyBundle_4_1"}),", ",(0,i.jsx)(n.code,{children:"Queue32_MyBundle_4_2"}),", ",(0,i.jsx)(n.code,{children:"Queue32_MyBundle_4_3"}),", and so on would be undesirable, indeed!"]}),"\n",(0,i.jsxs)(n.h3,{id:"i-dont-want-to-override-typename-over-and-over-is-there-any-easy-way-to-generate-a-typename",children:["I don't want to override ",(0,i.jsx)(n.code,{children:"typeName"})," over and over! Is there any easy way to generate a ",(0,i.jsx)(n.code,{children:"typeName"}),"?"]}),"\n",(0,i.jsxs)(n.p,{children:["Yes, with the experimental ",(0,i.jsx)(n.code,{children:"HasAutoTypename"})," trait. This trait can be mixed into your ",(0,i.jsx)(n.code,{children:"Bundle"}),"s to automatically generate a tuple-like ",(0,i.jsx)(n.code,{children:"typeName"})," for them, based on the constructor parameters of that ",(0,i.jsx)(n.code,{children:"Bundle"}),". Let's look at the previous examples:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'class MyBundle[T <: Data](gen: T, intParam: Int) extends Bundle {\n  override def typeName = s"MyBundle_${gen.typeName}_${intParam}"\n  // ...\n}\n'})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'new MyBundle(UInt(8.W), 3).typeName\n// res7: String = "MyBundle_UInt<8>_3"\n'})}),"\n",(0,i.jsxs)(n.p,{children:["Auto-generated ",(0,i.jsx)(n.code,{children:"typeName"}),"s take the form of ",(0,i.jsx)(n.code,{children:"{Bundle Name}_{Parameter Value 1}_{Parameter Value 2}_{...}"}),", and so our ",(0,i.jsx)(n.code,{children:"MyBundle"})," can be equivalently expressed with:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3.experimental.HasAutoTypename\nclass MyBundle[T <: Data](gen: T, intParam: Int) extends Bundle with HasAutoTypename {\n  // ...\n  // Note: No `override def typeName` statement here\n}\n"})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'new MyBundle(UInt(8.W), 3).typeName\n// res9: String = "MyBundle_UInt<8>_3"\n'})}),"\n",(0,i.jsx)(n.h3,{id:"can-i-name-my-bundles-in-firrtl-so-i-dont-generate-extremely-long-bundle-types",children:"Can I name my bundles in FIRRTL, so I don't generate extremely long bundle types?"}),"\n",(0,i.jsxs)(n.p,{children:["Yes, using the ",(0,i.jsx)(n.code,{children:"HasTypeAlias"})," trait. FIRRTL has a construct to alias a bundle type with a type alias like so:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{children:"circuit Top :\n  type MyBundle = { foo : UInt<8>, bar : UInt<1>}\n\n  module Top :\n    //...\n"})}),"\n",(0,i.jsxs)(n.p,{children:["These can be automatically emitted from Chisel by mixing ",(0,i.jsx)(n.code,{children:"HasTypeAlias"})," into a user-defined ",(0,i.jsx)(n.code,{children:"Record"}),", and implementing a field named ",(0,i.jsx)(n.code,{children:"aliasName"})," with a ",(0,i.jsx)(n.code,{children:"RecordAlias(...)"})," instance."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'import chisel3.experimental.{HasTypeAlias, RecordAlias}\n\nclass AliasedBundle extends Bundle with HasTypeAlias {\n  override def aliasName = RecordAlias("MyAliasedBundle")\n  val foo = UInt(8.W)\n  val bar = Bool()\n}\n'})}),"\n",(0,i.jsxs)(n.p,{children:["Let's see what happens when we generate FIRRTL using this ",(0,i.jsx)(n.code,{children:"Bundle"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'emitFIRRTL(new Module {\n  val wire = Wire(new AliasedBundle)\n})\n// res10: String = """FIRRTL version 4.0.0\n// circuit _18_Anon :\n//   type MyAliasedBundle = { foo : UInt<8>, bar : UInt<1>}\n// \n//   public module _18_Anon : @[naming.md 252:28]\n//     input clock : Clock @[naming.md 252:28]\n//     input reset : UInt<1> @[naming.md 252:28]\n// \n//     wire wire : MyAliasedBundle @[naming.md 253:18]\n// \n// """\n'})}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.code,{children:"HasTypeAlias"})," also supports nested bundles, too:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'class Child extends Bundle with HasTypeAlias {\n  override def aliasName = RecordAlias("ChildBundle")\n  val x = UInt(8.W)\n}\n\nclass Parent extends Bundle with HasTypeAlias {\n  override def aliasName = RecordAlias("ParentBundle")\n  val child = new Child\n}\n'})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'emitFIRRTL(new Module {\n  val wire = Wire(new Parent)\n})\n// res11: String = """FIRRTL version 4.0.0\n// circuit _22_Anon :\n//   type ChildBundle = { x : UInt<8>}\n//   type ParentBundle = { child : ChildBundle}\n// \n//   public module _22_Anon : @[naming.md 275:28]\n//     input clock : Clock @[naming.md 275:28]\n//     input reset : UInt<1> @[naming.md 275:28]\n// \n//     wire wire : ParentBundle @[naming.md 276:18]\n// \n// """\n'})}),"\n",(0,i.jsxs)(n.h3,{id:"why-do-i-keep-seeing-_stripped-suffixing-everywhere-in-my-firrtl-i-didnt-specify-that-in-my-aliasname",children:["Why do I keep seeing _stripped suffixing everywhere in my FIRRTL? I didn't specify that in my ",(0,i.jsx)(n.code,{children:"aliasName"}),"."]}),"\n",(0,i.jsxs)(n.p,{children:["You're using an ",(0,i.jsx)(n.code,{children:"Input(...)"})," or ",(0,i.jsx)(n.code,{children:"Output(...)"})," in conjunction with an aliased ",(0,i.jsx)(n.code,{children:"Record"})," that contains a ",(0,i.jsx)(n.code,{children:"Flipped(...)"}),". These flipped values are stripped by ",(0,i.jsx)(n.code,{children:"Input"})," and ",(0,i.jsx)(n.code,{children:"Output"})," which fundamentally changes the type of the parent ",(0,i.jsx)(n.code,{children:"Record"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'class StrippedBundle extends Bundle with HasTypeAlias {\n  override def aliasName = RecordAlias("StrippedBundle")\n  val flipped = Flipped(UInt(8.W))\n  val normal = UInt(8.W)\n}\n'})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'emitFIRRTL(new Module {\n  val in = IO(Input(new StrippedBundle))\n})\n// res12: String = """FIRRTL version 4.0.0\n// circuit _26_Anon :\n//   type StrippedBundle_stripped = { flipped : UInt<8>, normal : UInt<8>}\n// \n//   public module _26_Anon : @[naming.md 293:28]\n//     input clock : Clock @[naming.md 293:28]\n//     input reset : UInt<1> @[naming.md 293:28]\n//     input in : StrippedBundle_stripped @[naming.md 294:14]\n// \n//     skip\n// \n// """\n'})}),"\n",(0,i.jsxs)(n.p,{children:["Note how the bundle type doesn't contain a ",(0,i.jsx)(n.code,{children:"flip flipped : UInt<8>"})," field, and the alias gains a ",(0,i.jsx)(n.code,{children:'"_stripped"'})," suffix! This ",(0,i.jsx)(n.code,{children:"Bundle"})," type is no longer the same as the one we wrote in Chisel, so we have to distinguish it as such."]}),"\n",(0,i.jsxs)(n.p,{children:["By default, the suffix appended to ",(0,i.jsx)(n.code,{children:"Record"})," names is ",(0,i.jsx)(n.code,{children:'"_stripped"'}),". This can be defined by users with an additional string argument passed to ",(0,i.jsx)(n.code,{children:"RecordAlias(alias, strippedSuffix)"}),":"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'class CustomStrippedBundle extends Bundle with HasTypeAlias {\n  override def aliasName = RecordAlias("StrippedBundle", "Foo")\n  val flipped = Flipped(UInt(8.W))\n  val normal = UInt(8.W)\n}\n'})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'emitFIRRTL(new Module {\n  val in = IO(Input(new CustomStrippedBundle))\n})\n// res13: String = """FIRRTL version 4.0.0\n// circuit _30_Anon :\n//   type StrippedBundleFoo = { flipped : UInt<8>, normal : UInt<8>}\n// \n//   public module _30_Anon : @[naming.md 311:28]\n//     input clock : Clock @[naming.md 311:28]\n//     input reset : UInt<1> @[naming.md 311:28]\n//     input in : StrippedBundleFoo @[naming.md 312:14]\n// \n//     skip\n// \n// """\n'})}),"\n",(0,i.jsx)(n.h3,{id:"i-want-to-add-some-hardware-or-assertions-but-each-time-i-do-all-the-signal-names-get-bumped",children:"I want to add some hardware or assertions, but each time I do all the signal names get bumped!"}),"\n",(0,i.jsxs)(n.p,{children:['This is the classic "ECO" problem, and we provide descriptions in ',(0,i.jsx)(n.a,{href:"../explanations/naming",children:"explanation"}),". In short,\nwe recommend wrapping all additional logic in a prefix scope, which enables a unique namespace. This should prevent\nname collisions, which are what triggers all those annoying signal name bumps!"]}),"\n",(0,i.jsx)(n.h3,{id:"i-want-to-force-a-signal-or-instance-name-to-something-how-do-i-do-that",children:"I want to force a signal (or instance) name to something, how do I do that?"}),"\n",(0,i.jsxs)(n.p,{children:["Use the ",(0,i.jsx)(n.code,{children:".suggestName"})," method, which is on all classes which subtype ",(0,i.jsx)(n.code,{children:"Data"}),"."]}),"\n",(0,i.jsx)(n.h3,{id:"how-can-i-omit-the-prefix-in-certain-parts-of-the-code",children:"How can I omit the prefix in certain parts of the code?"}),"\n",(0,i.jsxs)(n.p,{children:["You can use the ",(0,i.jsx)(n.code,{children:"noPrefix { ... }"})," to strip the prefix from all signals generated in that scope."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3.experimental.noPrefix\n\nclass ExampleNoPrefix extends Module {\n  val in = IO(Input(UInt(2.W)))\n  val out = IO(Output(UInt(5.W)))\n\n  val add = noPrefix {\n    // foo will not get a prefix\n    val foo = RegNext(in + 1.U)\n    foo + in\n  }\n\n  out := add\n}\n"})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule ExampleNoPrefix(\n  input        clock,\n               reset,\n  input  [1:0] in,\n  output [4:0] out\n);\n\n  reg [1:0] foo;\n  always @(posedge clock)\n    foo <= in + 2'h1;\n  assign out = {3'h0, foo + in};\nendmodule\n\n"})}),"\n",(0,i.jsx)(n.h3,{id:"i-am-still-not-getting-the-name-i-want-for-example-inlining-an-instance-changes-my-name",children:"I am still not getting the name I want. For example, inlining an instance changes my name!"}),"\n",(0,i.jsxs)(n.p,{children:["In cases where a FIRRTL transform renames a signal/instance, you can use the ",(0,i.jsx)(n.code,{children:"forcename"})," API:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'import chisel3.util.experimental.{forceName, InlineInstance}\n\nclass WrapperExample extends Module {\n  val in = IO(Input(UInt(3.W)))\n  val out = IO(Output(UInt(3.W)))\n  val inst = Module(new Wrapper)\n  inst.in := in\n  out := inst.out\n}\nclass Wrapper extends Module with InlineInstance {\n  val in = IO(Input(UInt(3.W)))\n  val out = IO(Output(UInt(3.W)))\n  val inst = Module(new MyLeaf)\n  forceName(inst, "inst")\n  inst.in := in\n  out := inst.out\n}\nclass MyLeaf extends Module {\n  val in = IO(Input(UInt(3.W)))\n  val out = IO(Output(UInt(3.W)))\n  out := in\n}\n'})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule MyLeaf(\n  input  [2:0] in,\n  output [2:0] out\n);\n\n  assign out = in;\nendmodule\n\nmodule WrapperExample(\n  input        clock,\n               reset,\n  input  [2:0] in,\n  output [2:0] out\n);\n\n  MyLeaf inst (\n    .in  (in),\n    .out (out)\n  );\nendmodule\n\n"})}),"\n",(0,i.jsx)(n.p,{children:"This can be used to rename instances and non-aggregate typed signals."})]})}function h(e={}){const{wrapper:n}={...(0,s.R)(),...e.components};return n?(0,i.jsx)(n,{...e,children:(0,i.jsx)(u,{...e})}):u(e)}},1871:(e,n,a)=>{a.d(n,{A:()=>l});a(6540);var i=a(5195);const s={tableOfContentsInline:"tableOfContentsInline_prmo"};var t=a(4848);function l(e){let{toc:n,minHeadingLevel:a,maxHeadingLevel:l}=e;return(0,t.jsx)("div",{className:s.tableOfContentsInline,children:(0,t.jsx)(i.A,{toc:n,minHeadingLevel:a,maxHeadingLevel:l,className:"table-of-contents",linkClassName:null})})}},5195:(e,n,a)=>{a.d(n,{A:()=>x});var i=a(6540),s=a(6342);function t(e){const n=e.map((e=>({...e,parentIndex:-1,children:[]}))),a=Array(7).fill(-1);n.forEach(((e,n)=>{const i=a.slice(2,e.level);e.parentIndex=Math.max(...i),a[e.level]=n}));const i=[];return n.forEach((e=>{const{parentIndex:a,...s}=e;a>=0?n[a].children.push(s):i.push(s)})),i}function l(e){let{toc:n,minHeadingLevel:a,maxHeadingLevel:i}=e;return n.flatMap((e=>{const n=l({toc:e.children,minHeadingLevel:a,maxHeadingLevel:i});return function(e){return e.level>=a&&e.level<=i}(e)?[{...e,children:n}]:n}))}function o(e){const n=e.getBoundingClientRect();return n.top===n.bottom?o(e.parentNode):n}function d(e,n){let{anchorTopOffset:a}=n;const i=e.find((e=>o(e).top>=a));if(i){return function(e){return e.top>0&&e.bottom<window.innerHeight/2}(o(i))?i:e[e.indexOf(i)-1]??null}return e[e.length-1]??null}function r(){const e=(0,i.useRef)(0),{navbar:{hideOnScroll:n}}=(0,s.p)();return(0,i.useEffect)((()=>{e.current=n?0:document.querySelector(".navbar").clientHeight}),[n]),e}function c(e){const n=(0,i.useRef)(void 0),a=r();(0,i.useEffect)((()=>{if(!e)return()=>{};const{linkClassName:i,linkActiveClassName:s,minHeadingLevel:t,maxHeadingLevel:l}=e;function o(){const e=function(e){return Array.from(document.getElementsByClassName(e))}(i),o=function(e){let{minHeadingLevel:n,maxHeadingLevel:a}=e;const i=[];for(let s=n;s<=a;s+=1)i.push(`h${s}.anchor`);return Array.from(document.querySelectorAll(i.join()))}({minHeadingLevel:t,maxHeadingLevel:l}),r=d(o,{anchorTopOffset:a.current}),c=e.find((e=>r&&r.id===function(e){return decodeURIComponent(e.href.substring(e.href.indexOf("#")+1))}(e)));e.forEach((e=>{!function(e,a){a?(n.current&&n.current!==e&&n.current.classList.remove(s),e.classList.add(s),n.current=e):e.classList.remove(s)}(e,e===c)}))}return document.addEventListener("scroll",o),document.addEventListener("resize",o),o(),()=>{document.removeEventListener("scroll",o),document.removeEventListener("resize",o)}}),[e,a])}var u=a(8774),h=a(4848);function m(e){let{toc:n,className:a,linkClassName:i,isChild:s}=e;return n.length?(0,h.jsx)("ul",{className:s?void 0:a,children:n.map((e=>(0,h.jsxs)("li",{children:[(0,h.jsx)(u.A,{to:`#${e.id}`,className:i??void 0,dangerouslySetInnerHTML:{__html:e.value}}),(0,h.jsx)(m,{isChild:!0,toc:e.children,className:a,linkClassName:i})]},e.id)))}):null}const p=i.memo(m);function x(e){let{toc:n,className:a="table-of-contents table-of-contents__left-border",linkClassName:o="table-of-contents__link",linkActiveClassName:d,minHeadingLevel:r,maxHeadingLevel:u,...m}=e;const x=(0,s.p)(),g=r??x.tableOfContents.minHeadingLevel,f=u??x.tableOfContents.maxHeadingLevel,y=function(e){let{toc:n,minHeadingLevel:a,maxHeadingLevel:s}=e;return(0,i.useMemo)((()=>l({toc:t(n),minHeadingLevel:a,maxHeadingLevel:s})),[n,a,s])}({toc:n,minHeadingLevel:g,maxHeadingLevel:f});return c((0,i.useMemo)((()=>{if(o&&d)return{linkClassName:o,linkActiveClassName:d,minHeadingLevel:g,maxHeadingLevel:f}}),[o,d,g,f])),(0,h.jsx)(p,{toc:y,className:a,linkClassName:o,...m})}},8453:(e,n,a)=>{a.d(n,{R:()=>l,x:()=>o});var i=a(6540);const s={},t=i.createContext(s);function l(e){const n=i.useContext(t);return i.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function o(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(s):e.components||s:l(e.components),i.createElement(t.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/916cecd1.465d4dc0.js b/assets/js/916cecd1.465d4dc0.js
new file mode 100644
index 0000000000..4d3a80257f
--- /dev/null
+++ b/assets/js/916cecd1.465d4dc0.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[2289],{759:(e,n,i)=>{i.r(n),i.d(n,{assets:()=>d,contentTitle:()=>l,default:()=>u,frontMatter:()=>t,metadata:()=>o,toc:()=>c});var a=i(4848),s=i(8453),r=i(1871);const t={sidebar_position:1},l="Naming Cookbook",o={id:"cookbooks/naming",title:"Naming Cookbook",description:"I still have _T signals, can this be fixed?",source:"@site/docs/cookbooks/naming.md",sourceDirName:"cookbooks",slug:"/cookbooks/naming",permalink:"/docs/cookbooks/naming",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/cookbooks/naming.md",tags:[],version:"current",sidebarPosition:1,frontMatter:{sidebar_position:1},sidebar:"chiselSidebar",previous:{title:"General Cookbook",permalink:"/docs/cookbooks/cookbook"},next:{title:"Hierarchy Cookbook",permalink:"/docs/cookbooks/hierarchy"}},d={},c=[{value:"I still have _T signals, can this be fixed?",id:"i-still-have-_t-signals-can-this-be-fixed",level:3},{value:"I have so many wires with the same name, like <code>x</code>, <code>x_1</code> and <code>x_2</code>. How can I make them easier to understand?",id:"i-have-so-many-wires-with-the-same-name-like-x-x_1-and-x_2-how-can-i-make-them-easier-to-understand",level:3},{value:"How can I get better names for code generated by <code>when</code> clauses?",id:"how-can-i-get-better-names-for-code-generated-by-when-clauses",level:3},{value:"I still see _GEN signals, can this be fixed?",id:"i-still-see-_gen-signals-can-this-be-fixed",level:3},{value:"How do I make my modules have more stable names instead of &#39;Module_1&#39; and &#39;Module_42&#39;?",id:"how-do-i-make-my-modules-have-more-stable-names-instead-of-module_1-and-module_42",level:3},{value:"How would I write my own <code>typeName</code> for my data types?",id:"how-would-i-write-my-own-typename-for-my-data-types",level:3},{value:"I don&#39;t want to override <code>typeName</code> over and over! Is there any easy way to generate a <code>typeName</code>?",id:"i-dont-want-to-override-typename-over-and-over-is-there-any-easy-way-to-generate-a-typename",level:3},{value:"Can I name my bundles in FIRRTL, so I don&#39;t generate extremely long bundle types?",id:"can-i-name-my-bundles-in-firrtl-so-i-dont-generate-extremely-long-bundle-types",level:3},{value:"Why do I keep seeing _stripped suffixing everywhere in my FIRRTL? I didn&#39;t specify that in my <code>aliasName</code>.",id:"why-do-i-keep-seeing-_stripped-suffixing-everywhere-in-my-firrtl-i-didnt-specify-that-in-my-aliasname",level:3},{value:"I want to add some hardware or assertions, but each time I do all the signal names get bumped!",id:"i-want-to-add-some-hardware-or-assertions-but-each-time-i-do-all-the-signal-names-get-bumped",level:3},{value:"I want to force a signal (or instance) name to something, how do I do that?",id:"i-want-to-force-a-signal-or-instance-name-to-something-how-do-i-do-that",level:3},{value:"How can I omit the prefix in certain parts of the code?",id:"how-can-i-omit-the-prefix-in-certain-parts-of-the-code",level:3},{value:"I am still not getting the name I want. For example, inlining an instance changes my name!",id:"i-am-still-not-getting-the-name-i-want-for-example-inlining-an-instance-changes-my-name",level:3}];function m(e){const n={a:"a",code:"code",em:"em",h1:"h1",h3:"h3",p:"p",pre:"pre",...(0,s.R)(),...e.components};return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(n.h1,{id:"naming-cookbook",children:"Naming Cookbook"}),"\n","\n","\n",(0,a.jsx)(r.A,{toc:c}),"\n",(0,a.jsx)(n.h3,{id:"i-still-have-_t-signals-can-this-be-fixed",children:"I still have _T signals, can this be fixed?"}),"\n",(0,a.jsx)(n.p,{children:"See the next answer!"}),"\n",(0,a.jsxs)(n.h3,{id:"i-have-so-many-wires-with-the-same-name-like-x-x_1-and-x_2-how-can-i-make-them-easier-to-understand",children:["I have so many wires with the same name, like ",(0,a.jsx)(n.code,{children:"x"}),", ",(0,a.jsx)(n.code,{children:"x_1"})," and ",(0,a.jsx)(n.code,{children:"x_2"}),". How can I make them easier to understand?"]}),"\n",(0,a.jsxs)(n.p,{children:["Signals with ",(0,a.jsx)(n.code,{children:"_T"})," names or names that Chisel has to uniquify\noften are intermediate values generated within loops, function calls, or ",(0,a.jsx)(n.code,{children:"when"})," predicates.\nThey can also be consumed by verification statements like ",(0,a.jsx)(n.code,{children:"assert"})," or ",(0,a.jsx)(n.code,{children:"prints"}),".\nIn these cases, the compiler plugin often can't find a good prefix for the generated\nintermediate signals and can't name them at all or has to make up a unique name for them."]}),"\n",(0,a.jsxs)(n.p,{children:["We recommend you manually insert calls to ",(0,a.jsx)(n.code,{children:"prefix"})," to clarify these cases:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'import chisel3.experimental.prefix\nclass ExamplePrefix extends Module {\n\n  Seq.tabulate(2) { i =>\n    Seq.tabulate(2) { j =>\n      prefix(s"loop_${i}_${j}"){\n        val x = WireInit((i*0x10+j).U(8.W))\n        dontTouch(x)\n      }\n    }\n  }\n}\n'})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule ExamplePrefix(\n  input clock,\n        reset\n);\n\n  wire [7:0] loop_0_0_x = 8\'h0;\n  wire [7:0] loop_0_1_x = 8\'h1;\n  wire [7:0] loop_1_0_x = 8\'h10;\n  wire [7:0] loop_1_1_x = 8\'h11;\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_ExamplePrefix_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_ExamplePrefix_Verification.sv"\n`ifndef layers_ExamplePrefix_Verification_Cover\n`define layers_ExamplePrefix_Verification_Cover\n`endif // layers_ExamplePrefix_Verification_Cover\n\n// ----- 8< ----- FILE "Verification/Assume/layers_ExamplePrefix_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_ExamplePrefix_Verification.sv"\n`ifndef layers_ExamplePrefix_Verification_Assume\n`define layers_ExamplePrefix_Verification_Assume\n`endif // layers_ExamplePrefix_Verification_Assume\n\n// ----- 8< ----- FILE "Verification/Assert/layers_ExamplePrefix_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_ExamplePrefix_Verification.sv"\n`ifndef layers_ExamplePrefix_Verification_Assert\n`define layers_ExamplePrefix_Verification_Assert\n`endif // layers_ExamplePrefix_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_ExamplePrefix_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_ExamplePrefix_Verification\n`define layers_ExamplePrefix_Verification\n`endif // layers_ExamplePrefix_Verification\n'})}),"\n",(0,a.jsxs)(n.h3,{id:"how-can-i-get-better-names-for-code-generated-by-when-clauses",children:["How can I get better names for code generated by ",(0,a.jsx)(n.code,{children:"when"})," clauses?"]}),"\n",(0,a.jsxs)(n.p,{children:["The ",(0,a.jsx)(n.code,{children:"prefix"})," API can help with code inside ",(0,a.jsx)(n.code,{children:"when"})," clauses:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'class ExampleWhenPrefix extends Module {\n\n  val in = IO(Input(UInt(4.W)))\n  val out = IO(Output(UInt(4.W)))\n\n  out := DontCare\n\n  Seq.tabulate(2) { i =>\n    val j = i + 1\n    prefix(s"clause_${j}") {\n      when (in === j.U) {\n        val foo = Reg(UInt(4.W))\n        foo := in + j.U(4.W)\n        out := foo\n      }\n    }\n  }\n}\n'})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule ExampleWhenPrefix(\n  input        clock,\n               reset,\n  input  [3:0] in,\n  output [3:0] out\n);\n\n  reg [3:0] clause_1_foo;\n  reg [3:0] clause_2_foo;\n  always @(posedge clock) begin\n    clause_1_foo <= in + 4\'h1;\n    clause_2_foo <= in + 4\'h2;\n  end // always @(posedge)\n  assign out = in == 4\'h2 ? clause_2_foo : clause_1_foo;\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_ExampleWhenPrefix_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_ExampleWhenPrefix_Verification.sv"\n`ifndef layers_ExampleWhenPrefix_Verification_Cover\n`define layers_ExampleWhenPrefix_Verification_Cover\n`endif // layers_ExampleWhenPrefix_Verification_Cover\n\n// ----- 8< ----- FILE "Verification/Assume/layers_ExampleWhenPrefix_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_ExampleWhenPrefix_Verification.sv"\n`ifndef layers_ExampleWhenPrefix_Verification_Assume\n`define layers_ExampleWhenPrefix_Verification_Assume\n`endif // layers_ExampleWhenPrefix_Verification_Assume\n\n// ----- 8< ----- FILE "Verification/Assert/layers_ExampleWhenPrefix_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_ExampleWhenPrefix_Verification.sv"\n`ifndef layers_ExampleWhenPrefix_Verification_Assert\n`define layers_ExampleWhenPrefix_Verification_Assert\n`endif // layers_ExampleWhenPrefix_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_ExampleWhenPrefix_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_ExampleWhenPrefix_Verification\n`define layers_ExampleWhenPrefix_Verification\n`endif // layers_ExampleWhenPrefix_Verification\n'})}),"\n",(0,a.jsx)(n.h3,{id:"i-still-see-_gen-signals-can-this-be-fixed",children:"I still see _GEN signals, can this be fixed?"}),"\n",(0,a.jsxs)(n.p,{children:[(0,a.jsx)(n.code,{children:"_GEN"})," signals are usually generated from the FIRRTL compiler, rather than the Chisel library. We are working on\nrenaming these signals with more context-dependent names, but it is a work in progress. Thanks for caring!"]}),"\n",(0,a.jsx)(n.h3,{id:"how-do-i-make-my-modules-have-more-stable-names-instead-of-module_1-and-module_42",children:"How do I make my modules have more stable names instead of 'Module_1' and 'Module_42'?"}),"\n",(0,a.jsxs)(n.p,{children:["This is an example of the module instability problem, which results from several modules all sharing the exact same name. To fix this, you must add more specificity to your ",(0,a.jsx)(n.code,{children:"Module"}),"'s name to avoid these name collisions."]}),"\n",(0,a.jsxs)(n.p,{children:["This can be done by leveraging the ",(0,a.jsx)(n.code,{children:"desiredName"})," and ",(0,a.jsx)(n.code,{children:"typeName"})," APIs.\n",(0,a.jsx)(n.code,{children:"desiredName"})," is for indicating the names of ",(0,a.jsx)(n.code,{children:"Modules"})," (e.g. influenced by the parameters passed in), and ",(0,a.jsx)(n.code,{children:"typeName"})," is useful for modules which are type-parameterized by subclasses of ",(0,a.jsx)(n.code,{children:"Data"}),". Overriding ",(0,a.jsx)(n.code,{children:"desiredName"})," can reduce or even eliminate name collisions. For instance, suppose your module looks like the following:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"class MyModule[T <: Data](gen: T) extends Module {\n  // ...\n}\n"})}),"\n",(0,a.jsxs)(n.p,{children:["We can override ",(0,a.jsx)(n.code,{children:"desiredName"})," of the module to include the type name of the ",(0,a.jsx)(n.code,{children:"gen"})," parameter like so:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'class MyModule[T <: Data](gen: T) extends Module {\n  override def desiredName = s"MyModule_${gen.typeName}"\n}\n'})}),"\n",(0,a.jsxs)(n.p,{children:["Any instances of your ",(0,a.jsx)(n.code,{children:"MyModule"})," will now have Verilog module names containing the type parameter."]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"val foo = Module(new MyModule(UInt(4.W))) // MyModule_UInt4 // MyModule_UInt4\nval bar = Module(new MyModule(Vec(3, UInt(4.W)))) // MyModule_Vec3_UInt4\n"})}),"\n",(0,a.jsxs)(n.p,{children:["Note that all base Chisel util modules, like ",(0,a.jsx)(n.code,{children:"Queue"}),", already implement ",(0,a.jsx)(n.code,{children:"desiredName"})," like this:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"val fooQueue = Module(new Queue(UInt(8.W), 4)) // Verilog module would be named 'Queue4_UInt8' // Verilog module would be named 'Queue4_UInt8'\nval barQueue = Module(new Queue(SInt(12.W), 3)) // ... and 'Queue3_SInt12' // ... and 'Queue3_SInt12'\nval bazQueue = Module(new Queue(Bool(), 16)) // ... and 'Queue16_Bool'\n"})}),"\n",(0,a.jsxs)(n.h3,{id:"how-would-i-write-my-own-typename-for-my-data-types",children:["How would I write my own ",(0,a.jsx)(n.code,{children:"typeName"})," for my data types?"]}),"\n",(0,a.jsxs)(n.p,{children:["If you're using your own user-defined ",(0,a.jsx)(n.code,{children:"Bundle"}),", you can increase the specificity of its own ",(0,a.jsx)(n.code,{children:"typeName"})," by overriding it. All ",(0,a.jsx)(n.code,{children:"Data"})," types have a simple default implementation of ",(0,a.jsx)(n.code,{children:"typeName"})," (which is simply its class name), but you can override this yourself:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"class MyBundle[T <: Data](gen: T, intParam: Int) extends Bundle {\n  // Generate a stable typeName for this Bundle. Two 'words' are present\n  // in this implementation: the bundle's name plus its integer parameter\n  // (something like 'MyBundle9')\n  // and the generator's typeName, which itself can be composed of 'words'\n  // (something like 'Vec3_UInt4')\n  override def typeName = s\"MyBundle${intParam}_${gen.typeName}\"\n\n  // ...\n}\n"})}),"\n",(0,a.jsxs)(n.p,{children:["Now if you use your ",(0,a.jsx)(n.code,{children:"MyBundle"})," in a module like a ",(0,a.jsx)(n.code,{children:"Queue"}),":"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"val fooQueue = Module(new Queue(new MyBundle(UInt(4.W), 3), 16)) // Queue16_MyBundle3_UInt4\n"})}),"\n",(0,a.jsxs)(n.p,{children:["The suggested pattern for ",(0,a.jsx)(n.code,{children:"typeName"}),", and subsequently ",(0,a.jsx)(n.code,{children:"desiredName"}),", is to fold single integer-like parameters with the name itself (for example, ",(0,a.jsx)(n.code,{children:"Queue4"}),", ",(0,a.jsx)(n.code,{children:"UInt3"}),", ",(0,a.jsx)(n.code,{children:"MyBundle9"}),") to form 'words' and separate these 'words' with underscores (",(0,a.jsx)(n.code,{children:"Queue4_UInt3"}),", ",(0,a.jsx)(n.code,{children:"FooBundle_BarType4"}),")."]}),"\n",(0,a.jsxs)(n.p,{children:[(0,a.jsx)(n.code,{children:"Bundles"})," that have multiple integer arguments aren't presently addressed by any of the built-in modules, and so implementing a descriptive and sufficiently differentiable ",(0,a.jsx)(n.code,{children:"typeName"})," for such ",(0,a.jsx)(n.code,{children:"Bundles"})," is left as an exercise to the reader. However, integers should not occur with an underscore before them at the very end of the ",(0,a.jsx)(n.code,{children:"typeName"})," (e.g. ",(0,a.jsx)(n.code,{children:"MyBundle_1"}),") because this is the ",(0,a.jsx)(n.em,{children:"same"})," syntax used for duplicates, and so would cause confusion. Having to disambiguate modules all named ",(0,a.jsx)(n.code,{children:"Queue32_MyBundle_4_1"}),", ",(0,a.jsx)(n.code,{children:"Queue32_MyBundle_4_2"}),", ",(0,a.jsx)(n.code,{children:"Queue32_MyBundle_4_3"}),", and so on would be undesirable, indeed!"]}),"\n",(0,a.jsxs)(n.h3,{id:"i-dont-want-to-override-typename-over-and-over-is-there-any-easy-way-to-generate-a-typename",children:["I don't want to override ",(0,a.jsx)(n.code,{children:"typeName"})," over and over! Is there any easy way to generate a ",(0,a.jsx)(n.code,{children:"typeName"}),"?"]}),"\n",(0,a.jsxs)(n.p,{children:["Yes, with the experimental ",(0,a.jsx)(n.code,{children:"HasAutoTypename"})," trait. This trait can be mixed into your ",(0,a.jsx)(n.code,{children:"Bundle"}),"s to automatically generate a tuple-like ",(0,a.jsx)(n.code,{children:"typeName"})," for them, based on the constructor parameters of that ",(0,a.jsx)(n.code,{children:"Bundle"}),". Let's look at the previous examples:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'class MyBundle[T <: Data](gen: T, intParam: Int) extends Bundle {\n  override def typeName = s"MyBundle_${gen.typeName}_${intParam}"\n  // ...\n}\n'})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'new MyBundle(UInt(8.W), 3).typeName\n// res7: String = "MyBundle_UInt<8>_3"\n'})}),"\n",(0,a.jsxs)(n.p,{children:["Auto-generated ",(0,a.jsx)(n.code,{children:"typeName"}),"s take the form of ",(0,a.jsx)(n.code,{children:"{Bundle Name}_{Parameter Value 1}_{Parameter Value 2}_{...}"}),", and so our ",(0,a.jsx)(n.code,{children:"MyBundle"})," can be equivalently expressed with:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"import chisel3.experimental.HasAutoTypename\nclass MyBundle[T <: Data](gen: T, intParam: Int) extends Bundle with HasAutoTypename {\n  // ...\n  // Note: No `override def typeName` statement here\n}\n"})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'new MyBundle(UInt(8.W), 3).typeName\n// res9: String = "MyBundle_UInt<8>_3"\n'})}),"\n",(0,a.jsx)(n.h3,{id:"can-i-name-my-bundles-in-firrtl-so-i-dont-generate-extremely-long-bundle-types",children:"Can I name my bundles in FIRRTL, so I don't generate extremely long bundle types?"}),"\n",(0,a.jsxs)(n.p,{children:["Yes, using the ",(0,a.jsx)(n.code,{children:"HasTypeAlias"})," trait. FIRRTL has a construct to alias a bundle type with a type alias like so:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{children:"circuit Top :\n  type MyBundle = { foo : UInt<8>, bar : UInt<1>}\n\n  module Top :\n    //...\n"})}),"\n",(0,a.jsxs)(n.p,{children:["These can be automatically emitted from Chisel by mixing ",(0,a.jsx)(n.code,{children:"HasTypeAlias"})," into a user-defined ",(0,a.jsx)(n.code,{children:"Record"}),", and implementing a field named ",(0,a.jsx)(n.code,{children:"aliasName"})," with a ",(0,a.jsx)(n.code,{children:"RecordAlias(...)"})," instance."]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'import chisel3.experimental.{HasTypeAlias, RecordAlias}\n\nclass AliasedBundle extends Bundle with HasTypeAlias {\n  override def aliasName = RecordAlias("MyAliasedBundle")\n  val foo = UInt(8.W)\n  val bar = Bool()\n}\n'})}),"\n",(0,a.jsxs)(n.p,{children:["Let's see what happens when we generate FIRRTL using this ",(0,a.jsx)(n.code,{children:"Bundle"}),":"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'emitFIRRTL(new Module {\n  val wire = Wire(new AliasedBundle)\n})\n// res10: String = """FIRRTL version 4.0.0\n// circuit _18_Anon :\n//   type MyAliasedBundle = { foo : UInt<8>, bar : UInt<1>}\n// \n//   layer Verification, bind, "Verification" :\n//     layer Assert, bind, "Verification/Assert" :\n//     layer Assume, bind, "Verification/Assume" :\n//     layer Cover, bind, "Verification/Cover" :\n//   public module _18_Anon : @[naming.md 252:28]\n//     input clock : Clock @[naming.md 252:28]\n//     input reset : UInt<1> @[naming.md 252:28]\n// \n//     wire wire : MyAliasedBundle @[naming.md 253:18]\n// \n// """\n'})}),"\n",(0,a.jsxs)(n.p,{children:[(0,a.jsx)(n.code,{children:"HasTypeAlias"})," also supports nested bundles, too:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'class Child extends Bundle with HasTypeAlias {\n  override def aliasName = RecordAlias("ChildBundle")\n  val x = UInt(8.W)\n}\n\nclass Parent extends Bundle with HasTypeAlias {\n  override def aliasName = RecordAlias("ParentBundle")\n  val child = new Child\n}\n'})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'emitFIRRTL(new Module {\n  val wire = Wire(new Parent)\n})\n// res11: String = """FIRRTL version 4.0.0\n// circuit _22_Anon :\n//   type ChildBundle = { x : UInt<8>}\n//   type ParentBundle = { child : ChildBundle}\n// \n//   layer Verification, bind, "Verification" :\n//     layer Assert, bind, "Verification/Assert" :\n//     layer Assume, bind, "Verification/Assume" :\n//     layer Cover, bind, "Verification/Cover" :\n//   public module _22_Anon : @[naming.md 275:28]\n//     input clock : Clock @[naming.md 275:28]\n//     input reset : UInt<1> @[naming.md 275:28]\n// \n//     wire wire : ParentBundle @[naming.md 276:18]\n// \n// """\n'})}),"\n",(0,a.jsxs)(n.h3,{id:"why-do-i-keep-seeing-_stripped-suffixing-everywhere-in-my-firrtl-i-didnt-specify-that-in-my-aliasname",children:["Why do I keep seeing _stripped suffixing everywhere in my FIRRTL? I didn't specify that in my ",(0,a.jsx)(n.code,{children:"aliasName"}),"."]}),"\n",(0,a.jsxs)(n.p,{children:["You're using an ",(0,a.jsx)(n.code,{children:"Input(...)"})," or ",(0,a.jsx)(n.code,{children:"Output(...)"})," in conjunction with an aliased ",(0,a.jsx)(n.code,{children:"Record"})," that contains a ",(0,a.jsx)(n.code,{children:"Flipped(...)"}),". These flipped values are stripped by ",(0,a.jsx)(n.code,{children:"Input"})," and ",(0,a.jsx)(n.code,{children:"Output"})," which fundamentally changes the type of the parent ",(0,a.jsx)(n.code,{children:"Record"}),":"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'class StrippedBundle extends Bundle with HasTypeAlias {\n  override def aliasName = RecordAlias("StrippedBundle")\n  val flipped = Flipped(UInt(8.W))\n  val normal = UInt(8.W)\n}\n'})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'emitFIRRTL(new Module {\n  val in = IO(Input(new StrippedBundle))\n})\n// res12: String = """FIRRTL version 4.0.0\n// circuit _26_Anon :\n//   type StrippedBundle_stripped = { flipped : UInt<8>, normal : UInt<8>}\n// \n//   layer Verification, bind, "Verification" :\n//     layer Assert, bind, "Verification/Assert" :\n//     layer Assume, bind, "Verification/Assume" :\n//     layer Cover, bind, "Verification/Cover" :\n//   public module _26_Anon : @[naming.md 293:28]\n//     input clock : Clock @[naming.md 293:28]\n//     input reset : UInt<1> @[naming.md 293:28]\n//     input in : StrippedBundle_stripped @[naming.md 294:14]\n// \n//     skip\n// \n// """\n'})}),"\n",(0,a.jsxs)(n.p,{children:["Note how the bundle type doesn't contain a ",(0,a.jsx)(n.code,{children:"flip flipped : UInt<8>"})," field, and the alias gains a ",(0,a.jsx)(n.code,{children:'"_stripped"'})," suffix! This ",(0,a.jsx)(n.code,{children:"Bundle"})," type is no longer the same as the one we wrote in Chisel, so we have to distinguish it as such."]}),"\n",(0,a.jsxs)(n.p,{children:["By default, the suffix appended to ",(0,a.jsx)(n.code,{children:"Record"})," names is ",(0,a.jsx)(n.code,{children:'"_stripped"'}),". This can be defined by users with an additional string argument passed to ",(0,a.jsx)(n.code,{children:"RecordAlias(alias, strippedSuffix)"}),":"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'class CustomStrippedBundle extends Bundle with HasTypeAlias {\n  override def aliasName = RecordAlias("StrippedBundle", "Foo")\n  val flipped = Flipped(UInt(8.W))\n  val normal = UInt(8.W)\n}\n'})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'emitFIRRTL(new Module {\n  val in = IO(Input(new CustomStrippedBundle))\n})\n// res13: String = """FIRRTL version 4.0.0\n// circuit _30_Anon :\n//   type StrippedBundleFoo = { flipped : UInt<8>, normal : UInt<8>}\n// \n//   layer Verification, bind, "Verification" :\n//     layer Assert, bind, "Verification/Assert" :\n//     layer Assume, bind, "Verification/Assume" :\n//     layer Cover, bind, "Verification/Cover" :\n//   public module _30_Anon : @[naming.md 311:28]\n//     input clock : Clock @[naming.md 311:28]\n//     input reset : UInt<1> @[naming.md 311:28]\n//     input in : StrippedBundleFoo @[naming.md 312:14]\n// \n//     skip\n// \n// """\n'})}),"\n",(0,a.jsx)(n.h3,{id:"i-want-to-add-some-hardware-or-assertions-but-each-time-i-do-all-the-signal-names-get-bumped",children:"I want to add some hardware or assertions, but each time I do all the signal names get bumped!"}),"\n",(0,a.jsxs)(n.p,{children:['This is the classic "ECO" problem, and we provide descriptions in ',(0,a.jsx)(n.a,{href:"../explanations/naming",children:"explanation"}),". In short,\nwe recommend wrapping all additional logic in a prefix scope, which enables a unique namespace. This should prevent\nname collisions, which are what triggers all those annoying signal name bumps!"]}),"\n",(0,a.jsx)(n.h3,{id:"i-want-to-force-a-signal-or-instance-name-to-something-how-do-i-do-that",children:"I want to force a signal (or instance) name to something, how do I do that?"}),"\n",(0,a.jsxs)(n.p,{children:["Use the ",(0,a.jsx)(n.code,{children:".suggestName"})," method, which is on all classes which subtype ",(0,a.jsx)(n.code,{children:"Data"}),"."]}),"\n",(0,a.jsx)(n.h3,{id:"how-can-i-omit-the-prefix-in-certain-parts-of-the-code",children:"How can I omit the prefix in certain parts of the code?"}),"\n",(0,a.jsxs)(n.p,{children:["You can use the ",(0,a.jsx)(n.code,{children:"noPrefix { ... }"})," to strip the prefix from all signals generated in that scope."]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"import chisel3.experimental.noPrefix\n\nclass ExampleNoPrefix extends Module {\n  val in = IO(Input(UInt(2.W)))\n  val out = IO(Output(UInt(5.W)))\n\n  val add = noPrefix {\n    // foo will not get a prefix\n    val foo = RegNext(in + 1.U)\n    foo + in\n  }\n\n  out := add\n}\n"})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule ExampleNoPrefix(\n  input        clock,\n               reset,\n  input  [1:0] in,\n  output [4:0] out\n);\n\n  reg [1:0] foo;\n  always @(posedge clock)\n    foo <= in + 2\'h1;\n  assign out = {3\'h0, foo + in};\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_ExampleNoPrefix_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_ExampleNoPrefix_Verification.sv"\n`ifndef layers_ExampleNoPrefix_Verification_Cover\n`define layers_ExampleNoPrefix_Verification_Cover\n`endif // layers_ExampleNoPrefix_Verification_Cover\n\n// ----- 8< ----- FILE "Verification/Assume/layers_ExampleNoPrefix_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_ExampleNoPrefix_Verification.sv"\n`ifndef layers_ExampleNoPrefix_Verification_Assume\n`define layers_ExampleNoPrefix_Verification_Assume\n`endif // layers_ExampleNoPrefix_Verification_Assume\n\n// ----- 8< ----- FILE "Verification/Assert/layers_ExampleNoPrefix_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_ExampleNoPrefix_Verification.sv"\n`ifndef layers_ExampleNoPrefix_Verification_Assert\n`define layers_ExampleNoPrefix_Verification_Assert\n`endif // layers_ExampleNoPrefix_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_ExampleNoPrefix_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_ExampleNoPrefix_Verification\n`define layers_ExampleNoPrefix_Verification\n`endif // layers_ExampleNoPrefix_Verification\n'})}),"\n",(0,a.jsx)(n.h3,{id:"i-am-still-not-getting-the-name-i-want-for-example-inlining-an-instance-changes-my-name",children:"I am still not getting the name I want. For example, inlining an instance changes my name!"}),"\n",(0,a.jsxs)(n.p,{children:["In cases where a FIRRTL transform renames a signal/instance, you can use the ",(0,a.jsx)(n.code,{children:"forcename"})," API:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'import chisel3.util.experimental.{forceName, InlineInstance}\n\nclass WrapperExample extends Module {\n  val in = IO(Input(UInt(3.W)))\n  val out = IO(Output(UInt(3.W)))\n  val inst = Module(new Wrapper)\n  inst.in := in\n  out := inst.out\n}\nclass Wrapper extends Module with InlineInstance {\n  val in = IO(Input(UInt(3.W)))\n  val out = IO(Output(UInt(3.W)))\n  val inst = Module(new MyLeaf)\n  forceName(inst, "inst")\n  inst.in := in\n  out := inst.out\n}\nclass MyLeaf extends Module {\n  val in = IO(Input(UInt(3.W)))\n  val out = IO(Output(UInt(3.W)))\n  out := in\n}\n'})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule MyLeaf(\n  input  [2:0] in,\n  output [2:0] out\n);\n\n  assign out = in;\nendmodule\n\nmodule WrapperExample(\n  input        clock,\n               reset,\n  input  [2:0] in,\n  output [2:0] out\n);\n\n  MyLeaf inst (\n    .in  (in),\n    .out (out)\n  );\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_WrapperExample_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_WrapperExample_Verification.sv"\n`ifndef layers_WrapperExample_Verification_Cover\n`define layers_WrapperExample_Verification_Cover\n`endif // layers_WrapperExample_Verification_Cover\n\n// ----- 8< ----- FILE "Verification/Assume/layers_WrapperExample_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_WrapperExample_Verification.sv"\n`ifndef layers_WrapperExample_Verification_Assume\n`define layers_WrapperExample_Verification_Assume\n`endif // layers_WrapperExample_Verification_Assume\n\n// ----- 8< ----- FILE "Verification/Assert/layers_WrapperExample_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_WrapperExample_Verification.sv"\n`ifndef layers_WrapperExample_Verification_Assert\n`define layers_WrapperExample_Verification_Assert\n`endif // layers_WrapperExample_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_WrapperExample_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_WrapperExample_Verification\n`define layers_WrapperExample_Verification\n`endif // layers_WrapperExample_Verification\n'})}),"\n",(0,a.jsx)(n.p,{children:"This can be used to rename instances and non-aggregate typed signals."})]})}function u(e={}){const{wrapper:n}={...(0,s.R)(),...e.components};return n?(0,a.jsx)(n,{...e,children:(0,a.jsx)(m,{...e})}):m(e)}},1871:(e,n,i)=>{i.d(n,{A:()=>t});i(6540);var a=i(5195);const s={tableOfContentsInline:"tableOfContentsInline_prmo"};var r=i(4848);function t(e){let{toc:n,minHeadingLevel:i,maxHeadingLevel:t}=e;return(0,r.jsx)("div",{className:s.tableOfContentsInline,children:(0,r.jsx)(a.A,{toc:n,minHeadingLevel:i,maxHeadingLevel:t,className:"table-of-contents",linkClassName:null})})}},5195:(e,n,i)=>{i.d(n,{A:()=>f});var a=i(6540),s=i(6342);function r(e){const n=e.map((e=>({...e,parentIndex:-1,children:[]}))),i=Array(7).fill(-1);n.forEach(((e,n)=>{const a=i.slice(2,e.level);e.parentIndex=Math.max(...a),i[e.level]=n}));const a=[];return n.forEach((e=>{const{parentIndex:i,...s}=e;i>=0?n[i].children.push(s):a.push(s)})),a}function t(e){let{toc:n,minHeadingLevel:i,maxHeadingLevel:a}=e;return n.flatMap((e=>{const n=t({toc:e.children,minHeadingLevel:i,maxHeadingLevel:a});return function(e){return e.level>=i&&e.level<=a}(e)?[{...e,children:n}]:n}))}function l(e){const n=e.getBoundingClientRect();return n.top===n.bottom?l(e.parentNode):n}function o(e,n){let{anchorTopOffset:i}=n;const a=e.find((e=>l(e).top>=i));if(a){return function(e){return e.top>0&&e.bottom<window.innerHeight/2}(l(a))?a:e[e.indexOf(a)-1]??null}return e[e.length-1]??null}function d(){const e=(0,a.useRef)(0),{navbar:{hideOnScroll:n}}=(0,s.p)();return(0,a.useEffect)((()=>{e.current=n?0:document.querySelector(".navbar").clientHeight}),[n]),e}function c(e){const n=(0,a.useRef)(void 0),i=d();(0,a.useEffect)((()=>{if(!e)return()=>{};const{linkClassName:a,linkActiveClassName:s,minHeadingLevel:r,maxHeadingLevel:t}=e;function l(){const e=function(e){return Array.from(document.getElementsByClassName(e))}(a),l=function(e){let{minHeadingLevel:n,maxHeadingLevel:i}=e;const a=[];for(let s=n;s<=i;s+=1)a.push(`h${s}.anchor`);return Array.from(document.querySelectorAll(a.join()))}({minHeadingLevel:r,maxHeadingLevel:t}),d=o(l,{anchorTopOffset:i.current}),c=e.find((e=>d&&d.id===function(e){return decodeURIComponent(e.href.substring(e.href.indexOf("#")+1))}(e)));e.forEach((e=>{!function(e,i){i?(n.current&&n.current!==e&&n.current.classList.remove(s),e.classList.add(s),n.current=e):e.classList.remove(s)}(e,e===c)}))}return document.addEventListener("scroll",l),document.addEventListener("resize",l),l(),()=>{document.removeEventListener("scroll",l),document.removeEventListener("resize",l)}}),[e,i])}var m=i(8774),u=i(4848);function h(e){let{toc:n,className:i,linkClassName:a,isChild:s}=e;return n.length?(0,u.jsx)("ul",{className:s?void 0:i,children:n.map((e=>(0,u.jsxs)("li",{children:[(0,u.jsx)(m.A,{to:`#${e.id}`,className:a??void 0,dangerouslySetInnerHTML:{__html:e.value}}),(0,u.jsx)(h,{isChild:!0,toc:e.children,className:i,linkClassName:a})]},e.id)))}):null}const p=a.memo(h);function f(e){let{toc:n,className:i="table-of-contents table-of-contents__left-border",linkClassName:l="table-of-contents__link",linkActiveClassName:o,minHeadingLevel:d,maxHeadingLevel:m,...h}=e;const f=(0,s.p)(),x=d??f.tableOfContents.minHeadingLevel,y=m??f.tableOfContents.maxHeadingLevel,_=function(e){let{toc:n,minHeadingLevel:i,maxHeadingLevel:s}=e;return(0,a.useMemo)((()=>t({toc:r(n),minHeadingLevel:i,maxHeadingLevel:s})),[n,i,s])}({toc:n,minHeadingLevel:x,maxHeadingLevel:y});return c((0,a.useMemo)((()=>{if(l&&o)return{linkClassName:l,linkActiveClassName:o,minHeadingLevel:x,maxHeadingLevel:y}}),[l,o,x,y])),(0,u.jsx)(p,{toc:_,className:i,linkClassName:l,...h})}},8453:(e,n,i)=>{i.d(n,{R:()=>t,x:()=>l});var a=i(6540);const s={},r=a.createContext(s);function t(e){const n=a.useContext(r);return a.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function l(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(s):e.components||s:t(e.components),a.createElement(r.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/98ca0ee0.9a00ad74.js b/assets/js/98ca0ee0.1b04f0c5.js
similarity index 95%
rename from assets/js/98ca0ee0.9a00ad74.js
rename to assets/js/98ca0ee0.1b04f0c5.js
index 9564fdcdd1..f4ab9065a8 100644
--- a/assets/js/98ca0ee0.9a00ad74.js
+++ b/assets/js/98ca0ee0.1b04f0c5.js
@@ -1 +1 @@
-"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[8946,9017],{5893:(e,n,t)=>{t.r(n),t.d(n,{assets:()=>l,contentTitle:()=>a,default:()=>p,frontMatter:()=>o,metadata:()=>r,toc:()=>d});var s=t(4848),i=t(8453),c=t(7333);const o={title:"API Docs"},a=void 0,r={type:"mdx",permalink:"/api",source:"@site/src/pages/api.md",title:"API Docs",description:"Chisel API Documentation",frontMatter:{title:"API Docs"},unlisted:!1},l={},d=[{value:"Chisel API Documentation",id:"chisel-api-documentation",level:2}];function h(e){const n={a:"a",h2:"h2",p:"p",...(0,i.R)(),...e.components};return(0,s.jsxs)(s.Fragment,{children:[(0,s.jsx)(n.h2,{id:"chisel-api-documentation",children:"Chisel API Documentation"}),"\n",(0,s.jsxs)(n.p,{children:["Please see the page about ",(0,s.jsx)(n.a,{href:"docs/appendix/versioning",children:"Versioning"})," for more information about major and minor versioning and binary compatibility."]}),"\n",(0,s.jsx)(c.default,{})]})}function p(e={}){const{wrapper:n}={...(0,i.R)(),...e.components};return n?(0,s.jsx)(n,{...e,children:(0,s.jsx)(h,{...e})}):h(e)}},7333:(e,n,t)=>{t.r(n),t.d(n,{assets:()=>r,contentTitle:()=>o,default:()=>h,frontMatter:()=>c,metadata:()=>a,toc:()=>l});var s=t(4848),i=t(8453);const c={},o=void 0,a={type:"mdx",permalink:"/generated/scaladoc_links",source:"@site/src/pages/generated/scaladoc_links.md",description:"- Latest (6.5.0)",frontMatter:{},unlisted:!1},r={},l=[];function d(e){const n={a:"a",li:"li",ul:"ul",...(0,i.R)(),...e.components};return(0,s.jsxs)(n.ul,{children:["\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"pathname:///api/latest/index.html",children:"Latest (6.5.0)"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"https://s01.oss.sonatype.org/service/local/repositories/snapshots/archive/org/chipsalliance/chisel_2.13/7.0.0-M2+49-ab82fc22-SNAPSHOT/chisel_2.13-7.0.0-M2+49-ab82fc22-SNAPSHOT-javadoc.jar/!/index.html",children:"Snapshot"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"https://javadoc.io/doc/org.chipsalliance/chisel_2.13/7.0.0-M2",children:"7.0.0-M2"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"https://javadoc.io/doc/org.chipsalliance/chisel_2.13/6.5.0",children:"6.5.0"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"https://javadoc.io/doc/org.chipsalliance/chisel_2.13/5.3.0",children:"5.3.0"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"https://javadoc.io/doc/edu.berkeley.cs/chisel3_2.13/3.6.1",children:"3.6.1"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"https://javadoc.io/doc/edu.berkeley.cs/chisel3_2.13/3.5.6",children:"3.5.6"})}),"\n"]})}function h(e={}){const{wrapper:n}={...(0,i.R)(),...e.components};return n?(0,s.jsx)(n,{...e,children:(0,s.jsx)(d,{...e})}):d(e)}},8453:(e,n,t)=>{t.d(n,{R:()=>o,x:()=>a});var s=t(6540);const i={},c=s.createContext(i);function o(e){const n=s.useContext(c);return s.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function a(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(i):e.components||i:o(e.components),s.createElement(c.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
+"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[8946,9017],{5893:(e,n,t)=>{t.r(n),t.d(n,{assets:()=>l,contentTitle:()=>a,default:()=>p,frontMatter:()=>o,metadata:()=>r,toc:()=>d});var s=t(4848),i=t(8453),c=t(7333);const o={title:"API Docs"},a=void 0,r={type:"mdx",permalink:"/api",source:"@site/src/pages/api.md",title:"API Docs",description:"Chisel API Documentation",frontMatter:{title:"API Docs"},unlisted:!1},l={},d=[{value:"Chisel API Documentation",id:"chisel-api-documentation",level:2}];function h(e){const n={a:"a",h2:"h2",p:"p",...(0,i.R)(),...e.components};return(0,s.jsxs)(s.Fragment,{children:[(0,s.jsx)(n.h2,{id:"chisel-api-documentation",children:"Chisel API Documentation"}),"\n",(0,s.jsxs)(n.p,{children:["Please see the page about ",(0,s.jsx)(n.a,{href:"docs/appendix/versioning",children:"Versioning"})," for more information about major and minor versioning and binary compatibility."]}),"\n",(0,s.jsx)(c.default,{})]})}function p(e={}){const{wrapper:n}={...(0,i.R)(),...e.components};return n?(0,s.jsx)(n,{...e,children:(0,s.jsx)(h,{...e})}):h(e)}},7333:(e,n,t)=>{t.r(n),t.d(n,{assets:()=>r,contentTitle:()=>o,default:()=>h,frontMatter:()=>c,metadata:()=>a,toc:()=>l});var s=t(4848),i=t(8453);const c={},o=void 0,a={type:"mdx",permalink:"/generated/scaladoc_links",source:"@site/src/pages/generated/scaladoc_links.md",description:"- Latest (6.5.0)",frontMatter:{},unlisted:!1},r={},l=[];function d(e){const n={a:"a",li:"li",ul:"ul",...(0,i.R)(),...e.components};return(0,s.jsxs)(n.ul,{children:["\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"pathname:///api/latest/index.html",children:"Latest (6.5.0)"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"https://s01.oss.sonatype.org/service/local/repositories/snapshots/archive/org/chipsalliance/chisel_2.13/7.0.0-M2+50-f347914d-SNAPSHOT/chisel_2.13-7.0.0-M2+50-f347914d-SNAPSHOT-javadoc.jar/!/index.html",children:"Snapshot"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"https://javadoc.io/doc/org.chipsalliance/chisel_2.13/7.0.0-M2",children:"7.0.0-M2"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"https://javadoc.io/doc/org.chipsalliance/chisel_2.13/6.5.0",children:"6.5.0"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"https://javadoc.io/doc/org.chipsalliance/chisel_2.13/5.3.0",children:"5.3.0"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"https://javadoc.io/doc/edu.berkeley.cs/chisel3_2.13/3.6.1",children:"3.6.1"})}),"\n",(0,s.jsx)(n.li,{children:(0,s.jsx)(n.a,{href:"https://javadoc.io/doc/edu.berkeley.cs/chisel3_2.13/3.5.6",children:"3.5.6"})}),"\n"]})}function h(e={}){const{wrapper:n}={...(0,i.R)(),...e.components};return n?(0,s.jsx)(n,{...e,children:(0,s.jsx)(d,{...e})}):d(e)}},8453:(e,n,t)=>{t.d(n,{R:()=>o,x:()=>a});var s=t(6540);const i={},c=s.createContext(i);function o(e){const n=s.useContext(c);return s.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function a(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(i):e.components||i:o(e.components),s.createElement(c.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/a8f82c73.74167bd1.js b/assets/js/a8f82c73.74167bd1.js
new file mode 100644
index 0000000000..fb73ac379f
--- /dev/null
+++ b/assets/js/a8f82c73.74167bd1.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[3313],{5e3:(e,n,l)=>{l.r(n),l.d(n,{assets:()=>o,contentTitle:()=>t,default:()=>u,frontMatter:()=>a,metadata:()=>d,toc:()=>c});var i=l(4848),s=l(8453);const a={layout:"docs",title:"Bundles and Vecs",section:"chisel3"},t="Bundles and Vecs",d={id:"explanations/bundles-and-vecs",title:"Bundles and Vecs",description:"Bundle and Vec are classes that allow the user to expand the set of Chisel datatypes with aggregates of other types.",source:"@site/docs/explanations/bundles-and-vecs.md",sourceDirName:"explanations",slug:"/explanations/bundles-and-vecs",permalink:"/docs/explanations/bundles-and-vecs",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/bundles-and-vecs.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Bundles and Vecs",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Blackboxes",permalink:"/docs/explanations/blackboxes"},next:{title:"Enumerations",permalink:"/docs/explanations/chisel-enum"}},o={},c=[{value:"Flipping Bundles",id:"flipping-bundles",level:3},{value:"MixedVec",id:"mixedvec",level:3},{value:"A note on <code>cloneType</code> (For Chisel &lt; 3.5)",id:"a-note-on-clonetype-for-chisel--35",level:3}];function r(e){const n={a:"a",code:"code",h1:"h1",h3:"h3",p:"p",pre:"pre",strong:"strong",...(0,s.R)(),...e.components};return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsx)(n.h1,{id:"bundles-and-vecs",children:"Bundles and Vecs"}),"\n",(0,i.jsxs)(n.p,{children:[(0,i.jsx)(n.code,{children:"Bundle"})," and ",(0,i.jsx)(n.code,{children:"Vec"})," are classes that allow the user to expand the set of Chisel datatypes with aggregates of other types."]}),"\n",(0,i.jsxs)(n.p,{children:["Bundles group together several named fields of potentially different types into a coherent unit, much like a ",(0,i.jsx)(n.code,{children:"struct"})," in\nC. Users define their own bundles by defining a class as a subclass of ",(0,i.jsx)(n.code,{children:"Bundle"}),"."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nclass MyFloat extends Bundle {\n  val sign        = Bool()\n  val exponent    = UInt(8.W)\n  val significand = UInt(23.W)\n}\n\nclass ModuleWithFloatWire extends RawModule {\n  val x  = Wire(new MyFloat)\n  val xs = x.sign\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["You can create literal Bundles using the experimental ",(0,i.jsx)(n.a,{href:"../appendix/experimental-features#bundle-literals",children:"Bundle Literals"})," feature."]}),"\n",(0,i.jsx)(n.p,{children:"Scala convention is to name classes using UpperCamelCase, and we suggest you follow that convention in your Chisel code."}),"\n",(0,i.jsx)(n.p,{children:"Vecs create an indexable vector of elements, and are constructed as follows:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class ModuleWithVec extends RawModule {\n  // Vector of 5 23-bit signed integers.\n  val myVec = Wire(Vec(5, SInt(23.W)))\n\n  // Connect to one element of vector.\n  val reg3 = myVec(3)\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["(Note that we specify the number followed by the type of the ",(0,i.jsx)(n.code,{children:"Vec"})," elements. We also specifiy the width of the ",(0,i.jsx)(n.code,{children:"SInt"}),")"]}),"\n",(0,i.jsxs)(n.p,{children:["The set of primitive classes\n(",(0,i.jsx)(n.code,{children:"SInt"}),", ",(0,i.jsx)(n.code,{children:"UInt"}),", and ",(0,i.jsx)(n.code,{children:"Bool"}),") plus the aggregate\nclasses (",(0,i.jsx)(n.code,{children:"Bundles"})," and ",(0,i.jsx)(n.code,{children:"Vec"}),"s) all inherit from a common\nsuperclass, ",(0,i.jsx)(n.code,{children:"Data"}),".  Every object that ultimately inherits from\n",(0,i.jsx)(n.code,{children:"Data"})," can be represented as a bit vector in a hardware design."]}),"\n",(0,i.jsx)(n.p,{children:"Bundles and Vecs can be arbitrarily nested to build complex data\nstructures:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class BigBundle extends Bundle {\n // Vector of 5 23-bit signed integers.\n val myVec = Vec(5, SInt(23.W))\n val flag  = Bool()\n // Previously defined bundle.\n val f     = new MyFloat\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["Note that the builtin Chisel primitive and aggregate classes do not\nrequire the ",(0,i.jsx)(n.code,{children:"new"})," when creating an instance, whereas new user\ndatatypes will.  A Scala ",(0,i.jsx)(n.code,{children:"apply"})," constructor can be defined so\nthat a user datatype also does not require ",(0,i.jsx)(n.code,{children:"new"}),", as described in\n",(0,i.jsx)(n.a,{href:"../explanations/functional-module-creation",children:"Function Constructor"}),"."]}),"\n",(0,i.jsx)(n.h3,{id:"flipping-bundles",children:"Flipping Bundles"}),"\n",(0,i.jsxs)(n.p,{children:["The ",(0,i.jsx)(n.code,{children:"Flipped()"})," function recursively flips all elements in a Bundle/Record. This is very useful for building bidirectional interfaces that connect to each other (e.g. ",(0,i.jsx)(n.code,{children:"Decoupled"}),"). See below for an example."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class ABBundle extends Bundle {\n  val a = Input(Bool())\n  val b = Output(Bool())\n}\nclass MyFlippedModule extends RawModule {\n  // Normal instantiation of the bundle\n  // 'a' is an Input and 'b' is an Output\n  val normalBundle = IO(new ABBundle)\n  normalBundle.b := normalBundle.a\n\n  // Flipped recursively flips the direction of all Bundle fields\n  // Now 'a' is an Output and 'b' is an Input\n  val flippedBundle = IO(Flipped(new ABBundle))\n  flippedBundle.a := flippedBundle.b\n}\n"})}),"\n",(0,i.jsx)(n.p,{children:"This generates the following Verilog:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule MyFlippedModule(\t// bundles-and-vecs.md:57:7\n  input  normalBundle_a,\t// bundles-and-vecs.md:60:24\n  output normalBundle_b,\t// bundles-and-vecs.md:60:24\n         flippedBundle_a,\t// bundles-and-vecs.md:65:25\n  input  flippedBundle_b\t// bundles-and-vecs.md:65:25\n);\n\n  assign normalBundle_b = normalBundle_a;\t// bundles-and-vecs.md:57:7\n  assign flippedBundle_a = flippedBundle_b;\t// bundles-and-vecs.md:57:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_MyFlippedModule_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyFlippedModule_Verification.sv"\n`ifndef layers_MyFlippedModule_Verification_Cover\n`define layers_MyFlippedModule_Verification_Cover\t// <stdin>:6:5\n`endif // layers_MyFlippedModule_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_MyFlippedModule_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyFlippedModule_Verification.sv"\n`ifndef layers_MyFlippedModule_Verification_Assume\n`define layers_MyFlippedModule_Verification_Assume\t// <stdin>:5:5\n`endif // layers_MyFlippedModule_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_MyFlippedModule_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyFlippedModule_Verification.sv"\n`ifndef layers_MyFlippedModule_Verification_Assert\n`define layers_MyFlippedModule_Verification_Assert\t// <stdin>:4:5\n`endif // layers_MyFlippedModule_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_MyFlippedModule_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_MyFlippedModule_Verification\n`define layers_MyFlippedModule_Verification\t// <stdin>:3:3\n`endif // layers_MyFlippedModule_Verification\t// <stdin>:3:3\n'})}),"\n",(0,i.jsx)(n.h3,{id:"mixedvec",children:"MixedVec"}),"\n",(0,i.jsx)(n.p,{children:"(Chisel 3.2+)"}),"\n",(0,i.jsxs)(n.p,{children:["All elements of a ",(0,i.jsx)(n.code,{children:"Vec"})," must have the same parameterization. If we want to create a Vec where the elements have the same type but different parameterizations, we can use a MixedVec:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3.util.MixedVec\nclass ModuleMixedVec extends Module {\n  val io = IO(new Bundle {\n    val x = Input(UInt(3.W))\n    val y = Input(UInt(10.W))\n    val vec = Output(MixedVec(UInt(3.W), UInt(10.W)))\n  })\n  io.vec(0) := io.x\n  io.vec(1) := io.y\n}\n"})}),"\n",(0,i.jsx)(n.p,{children:"We can also programmatically create the types in a MixedVec:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class ModuleProgrammaticMixedVec(x: Int, y: Int) extends Module {\n  val io = IO(new Bundle {\n    val vec = Input(MixedVec((x to y) map { i => UInt(i.W) }))\n    // ...\n  })\n  // ...rest of the module goes here...\n}\n"})}),"\n",(0,i.jsxs)(n.h3,{id:"a-note-on-clonetype-for-chisel--35",children:["A note on ",(0,i.jsx)(n.code,{children:"cloneType"})," (For Chisel < 3.5)"]}),"\n",(0,i.jsxs)(n.p,{children:["NOTE: This section ",(0,i.jsx)(n.strong,{children:"only applies to Chisel before Chisel 3.5"}),".\nAs of Chisel 3.5, ",(0,i.jsx)(n.code,{children:"Bundle"}),"s should ",(0,i.jsx)(n.strong,{children:"not"})," ",(0,i.jsx)(n.code,{children:"override def cloneType"}),",\nas this is a compiler error when using the chisel3 compiler plugin for inferring ",(0,i.jsx)(n.code,{children:"cloneType"}),"."]}),"\n",(0,i.jsxs)(n.p,{children:["Since Chisel is built on top of Scala and the JVM,\nit needs to know how to construct copies of ",(0,i.jsx)(n.code,{children:"Bundle"}),"s for various\npurposes (creating wires, IOs, etc).\nIf you have a parametrized ",(0,i.jsx)(n.code,{children:"Bundle"})," and Chisel can't automatically figure out how to\nclone it, you will need to create a custom ",(0,i.jsx)(n.code,{children:"cloneType"})," method in your bundle.\nIn the vast majority of cases, ",(0,i.jsx)(n.strong,{children:"this is not required"}),"\nas Chisel can figure out how to clone most ",(0,i.jsx)(n.code,{children:"Bundle"}),"s automatically:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class MyCloneTypeBundle(val bitwidth: Int) extends Bundle {\n   val field = UInt(bitwidth.W)\n   // ...\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["The only caveat is if you are passing something of type ",(0,i.jsx)(n.code,{children:"Data"}),' as a "generator" parameter,\nin which case you should make it a ',(0,i.jsx)(n.code,{children:"private val"}),", and define a ",(0,i.jsx)(n.code,{children:"cloneType"})," method with\n",(0,i.jsx)(n.code,{children:"override def cloneType = (new YourBundleHere(...)).asInstanceOf[this.type]"}),"."]}),"\n",(0,i.jsxs)(n.p,{children:["For example, consider the following ",(0,i.jsx)(n.code,{children:"Bundle"}),". Because its ",(0,i.jsx)(n.code,{children:"gen"})," variable is not a ",(0,i.jsx)(n.code,{children:"private val"}),", the user has to\nexplicitly define the ",(0,i.jsx)(n.code,{children:"cloneType"})," method:"]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3.util.{Decoupled, Irrevocable}\nclass RegisterWriteIOExplicitCloneType[T <: Data](gen: T) extends Bundle {\n  val request  = Flipped(Decoupled(gen))\n  val response = Irrevocable(Bool())\n  override def cloneType = new RegisterWriteIOExplicitCloneType(gen).asInstanceOf[this.type]\n}\n"})}),"\n",(0,i.jsxs)(n.p,{children:["We can make this this infer cloneType by making ",(0,i.jsx)(n.code,{children:"gen"}),' private since it is a "type parameter":']}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3.util.{Decoupled, Irrevocable}\nclass RegisterWriteIO[T <: Data](private val gen: T) extends Bundle {\n  val request  = Flipped(Decoupled(gen))\n  val response = Irrevocable(Bool())\n}\n"})})]})}function u(e={}){const{wrapper:n}={...(0,s.R)(),...e.components};return n?(0,i.jsx)(n,{...e,children:(0,i.jsx)(r,{...e})}):r(e)}},8453:(e,n,l)=>{l.d(n,{R:()=>t,x:()=>d});var i=l(6540);const s={},a=i.createContext(s);function t(e){const n=i.useContext(a);return i.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function d(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(s):e.components||s:t(e.components),i.createElement(a.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/a8f82c73.e2fd7a36.js b/assets/js/a8f82c73.e2fd7a36.js
deleted file mode 100644
index 7ac1e611b4..0000000000
--- a/assets/js/a8f82c73.e2fd7a36.js
+++ /dev/null
@@ -1 +0,0 @@
-"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[3313],{5e3:(e,n,l)=>{l.r(n),l.d(n,{assets:()=>c,contentTitle:()=>i,default:()=>u,frontMatter:()=>t,metadata:()=>d,toc:()=>o});var s=l(4848),a=l(8453);const t={layout:"docs",title:"Bundles and Vecs",section:"chisel3"},i="Bundles and Vecs",d={id:"explanations/bundles-and-vecs",title:"Bundles and Vecs",description:"Bundle and Vec are classes that allow the user to expand the set of Chisel datatypes with aggregates of other types.",source:"@site/docs/explanations/bundles-and-vecs.md",sourceDirName:"explanations",slug:"/explanations/bundles-and-vecs",permalink:"/docs/explanations/bundles-and-vecs",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/bundles-and-vecs.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Bundles and Vecs",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Blackboxes",permalink:"/docs/explanations/blackboxes"},next:{title:"Enumerations",permalink:"/docs/explanations/chisel-enum"}},c={},o=[{value:"Flipping Bundles",id:"flipping-bundles",level:3},{value:"MixedVec",id:"mixedvec",level:3},{value:"A note on <code>cloneType</code> (For Chisel &lt; 3.5)",id:"a-note-on-clonetype-for-chisel--35",level:3}];function r(e){const n={a:"a",code:"code",h1:"h1",h3:"h3",p:"p",pre:"pre",strong:"strong",...(0,a.R)(),...e.components};return(0,s.jsxs)(s.Fragment,{children:[(0,s.jsx)(n.h1,{id:"bundles-and-vecs",children:"Bundles and Vecs"}),"\n",(0,s.jsxs)(n.p,{children:[(0,s.jsx)(n.code,{children:"Bundle"})," and ",(0,s.jsx)(n.code,{children:"Vec"})," are classes that allow the user to expand the set of Chisel datatypes with aggregates of other types."]}),"\n",(0,s.jsxs)(n.p,{children:["Bundles group together several named fields of potentially different types into a coherent unit, much like a ",(0,s.jsx)(n.code,{children:"struct"})," in\nC. Users define their own bundles by defining a class as a subclass of ",(0,s.jsx)(n.code,{children:"Bundle"}),"."]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nclass MyFloat extends Bundle {\n  val sign        = Bool()\n  val exponent    = UInt(8.W)\n  val significand = UInt(23.W)\n}\n\nclass ModuleWithFloatWire extends RawModule {\n  val x  = Wire(new MyFloat)\n  val xs = x.sign\n}\n"})}),"\n",(0,s.jsxs)(n.p,{children:["You can create literal Bundles using the experimental ",(0,s.jsx)(n.a,{href:"../appendix/experimental-features#bundle-literals",children:"Bundle Literals"})," feature."]}),"\n",(0,s.jsx)(n.p,{children:"Scala convention is to name classes using UpperCamelCase, and we suggest you follow that convention in your Chisel code."}),"\n",(0,s.jsx)(n.p,{children:"Vecs create an indexable vector of elements, and are constructed as follows:"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"class ModuleWithVec extends RawModule {\n  // Vector of 5 23-bit signed integers.\n  val myVec = Wire(Vec(5, SInt(23.W)))\n\n  // Connect to one element of vector.\n  val reg3 = myVec(3)\n}\n"})}),"\n",(0,s.jsxs)(n.p,{children:["(Note that we specify the number followed by the type of the ",(0,s.jsx)(n.code,{children:"Vec"})," elements. We also specifiy the width of the ",(0,s.jsx)(n.code,{children:"SInt"}),")"]}),"\n",(0,s.jsxs)(n.p,{children:["The set of primitive classes\n(",(0,s.jsx)(n.code,{children:"SInt"}),", ",(0,s.jsx)(n.code,{children:"UInt"}),", and ",(0,s.jsx)(n.code,{children:"Bool"}),") plus the aggregate\nclasses (",(0,s.jsx)(n.code,{children:"Bundles"})," and ",(0,s.jsx)(n.code,{children:"Vec"}),"s) all inherit from a common\nsuperclass, ",(0,s.jsx)(n.code,{children:"Data"}),".  Every object that ultimately inherits from\n",(0,s.jsx)(n.code,{children:"Data"})," can be represented as a bit vector in a hardware design."]}),"\n",(0,s.jsx)(n.p,{children:"Bundles and Vecs can be arbitrarily nested to build complex data\nstructures:"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"class BigBundle extends Bundle {\n // Vector of 5 23-bit signed integers.\n val myVec = Vec(5, SInt(23.W))\n val flag  = Bool()\n // Previously defined bundle.\n val f     = new MyFloat\n}\n"})}),"\n",(0,s.jsxs)(n.p,{children:["Note that the builtin Chisel primitive and aggregate classes do not\nrequire the ",(0,s.jsx)(n.code,{children:"new"})," when creating an instance, whereas new user\ndatatypes will.  A Scala ",(0,s.jsx)(n.code,{children:"apply"})," constructor can be defined so\nthat a user datatype also does not require ",(0,s.jsx)(n.code,{children:"new"}),", as described in\n",(0,s.jsx)(n.a,{href:"../explanations/functional-module-creation",children:"Function Constructor"}),"."]}),"\n",(0,s.jsx)(n.h3,{id:"flipping-bundles",children:"Flipping Bundles"}),"\n",(0,s.jsxs)(n.p,{children:["The ",(0,s.jsx)(n.code,{children:"Flipped()"})," function recursively flips all elements in a Bundle/Record. This is very useful for building bidirectional interfaces that connect to each other (e.g. ",(0,s.jsx)(n.code,{children:"Decoupled"}),"). See below for an example."]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"class ABBundle extends Bundle {\n  val a = Input(Bool())\n  val b = Output(Bool())\n}\nclass MyFlippedModule extends RawModule {\n  // Normal instantiation of the bundle\n  // 'a' is an Input and 'b' is an Output\n  val normalBundle = IO(new ABBundle)\n  normalBundle.b := normalBundle.a\n\n  // Flipped recursively flips the direction of all Bundle fields\n  // Now 'a' is an Output and 'b' is an Input\n  val flippedBundle = IO(Flipped(new ABBundle))\n  flippedBundle.a := flippedBundle.b\n}\n"})}),"\n",(0,s.jsx)(n.p,{children:"This generates the following Verilog:"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule MyFlippedModule(\t// bundles-and-vecs.md:57:7\n  input  normalBundle_a,\t// bundles-and-vecs.md:60:24\n  output normalBundle_b,\t// bundles-and-vecs.md:60:24\n         flippedBundle_a,\t// bundles-and-vecs.md:65:25\n  input  flippedBundle_b\t// bundles-and-vecs.md:65:25\n);\n\n  assign normalBundle_b = normalBundle_a;\t// bundles-and-vecs.md:57:7\n  assign flippedBundle_a = flippedBundle_b;\t// bundles-and-vecs.md:57:7\nendmodule\n\n"})}),"\n",(0,s.jsx)(n.h3,{id:"mixedvec",children:"MixedVec"}),"\n",(0,s.jsx)(n.p,{children:"(Chisel 3.2+)"}),"\n",(0,s.jsxs)(n.p,{children:["All elements of a ",(0,s.jsx)(n.code,{children:"Vec"})," must have the same parameterization. If we want to create a Vec where the elements have the same type but different parameterizations, we can use a MixedVec:"]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"import chisel3.util.MixedVec\nclass ModuleMixedVec extends Module {\n  val io = IO(new Bundle {\n    val x = Input(UInt(3.W))\n    val y = Input(UInt(10.W))\n    val vec = Output(MixedVec(UInt(3.W), UInt(10.W)))\n  })\n  io.vec(0) := io.x\n  io.vec(1) := io.y\n}\n"})}),"\n",(0,s.jsx)(n.p,{children:"We can also programmatically create the types in a MixedVec:"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"class ModuleProgrammaticMixedVec(x: Int, y: Int) extends Module {\n  val io = IO(new Bundle {\n    val vec = Input(MixedVec((x to y) map { i => UInt(i.W) }))\n    // ...\n  })\n  // ...rest of the module goes here...\n}\n"})}),"\n",(0,s.jsxs)(n.h3,{id:"a-note-on-clonetype-for-chisel--35",children:["A note on ",(0,s.jsx)(n.code,{children:"cloneType"})," (For Chisel < 3.5)"]}),"\n",(0,s.jsxs)(n.p,{children:["NOTE: This section ",(0,s.jsx)(n.strong,{children:"only applies to Chisel before Chisel 3.5"}),".\nAs of Chisel 3.5, ",(0,s.jsx)(n.code,{children:"Bundle"}),"s should ",(0,s.jsx)(n.strong,{children:"not"})," ",(0,s.jsx)(n.code,{children:"override def cloneType"}),",\nas this is a compiler error when using the chisel3 compiler plugin for inferring ",(0,s.jsx)(n.code,{children:"cloneType"}),"."]}),"\n",(0,s.jsxs)(n.p,{children:["Since Chisel is built on top of Scala and the JVM,\nit needs to know how to construct copies of ",(0,s.jsx)(n.code,{children:"Bundle"}),"s for various\npurposes (creating wires, IOs, etc).\nIf you have a parametrized ",(0,s.jsx)(n.code,{children:"Bundle"})," and Chisel can't automatically figure out how to\nclone it, you will need to create a custom ",(0,s.jsx)(n.code,{children:"cloneType"})," method in your bundle.\nIn the vast majority of cases, ",(0,s.jsx)(n.strong,{children:"this is not required"}),"\nas Chisel can figure out how to clone most ",(0,s.jsx)(n.code,{children:"Bundle"}),"s automatically:"]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"class MyCloneTypeBundle(val bitwidth: Int) extends Bundle {\n   val field = UInt(bitwidth.W)\n   // ...\n}\n"})}),"\n",(0,s.jsxs)(n.p,{children:["The only caveat is if you are passing something of type ",(0,s.jsx)(n.code,{children:"Data"}),' as a "generator" parameter,\nin which case you should make it a ',(0,s.jsx)(n.code,{children:"private val"}),", and define a ",(0,s.jsx)(n.code,{children:"cloneType"})," method with\n",(0,s.jsx)(n.code,{children:"override def cloneType = (new YourBundleHere(...)).asInstanceOf[this.type]"}),"."]}),"\n",(0,s.jsxs)(n.p,{children:["For example, consider the following ",(0,s.jsx)(n.code,{children:"Bundle"}),". Because its ",(0,s.jsx)(n.code,{children:"gen"})," variable is not a ",(0,s.jsx)(n.code,{children:"private val"}),", the user has to\nexplicitly define the ",(0,s.jsx)(n.code,{children:"cloneType"})," method:"]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"import chisel3.util.{Decoupled, Irrevocable}\nclass RegisterWriteIOExplicitCloneType[T <: Data](gen: T) extends Bundle {\n  val request  = Flipped(Decoupled(gen))\n  val response = Irrevocable(Bool())\n  override def cloneType = new RegisterWriteIOExplicitCloneType(gen).asInstanceOf[this.type]\n}\n"})}),"\n",(0,s.jsxs)(n.p,{children:["We can make this this infer cloneType by making ",(0,s.jsx)(n.code,{children:"gen"}),' private since it is a "type parameter":']}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"import chisel3.util.{Decoupled, Irrevocable}\nclass RegisterWriteIO[T <: Data](private val gen: T) extends Bundle {\n  val request  = Flipped(Decoupled(gen))\n  val response = Irrevocable(Bool())\n}\n"})})]})}function u(e={}){const{wrapper:n}={...(0,a.R)(),...e.components};return n?(0,s.jsx)(n,{...e,children:(0,s.jsx)(r,{...e})}):r(e)}},8453:(e,n,l)=>{l.d(n,{R:()=>i,x:()=>d});var s=l(6540);const a={},t=s.createContext(a);function i(e){const n=s.useContext(t);return s.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function d(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(a):e.components||a:i(e.components),s.createElement(t.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/c48de377.64bb7063.js b/assets/js/c48de377.64bb7063.js
deleted file mode 100644
index 48ebcc23c3..0000000000
--- a/assets/js/c48de377.64bb7063.js
+++ /dev/null
@@ -1 +0,0 @@
-"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[3316],{648:(e,n,t)=>{t.r(n),t.d(n,{assets:()=>o,contentTitle:()=>s,default:()=>u,frontMatter:()=>a,metadata:()=>r,toc:()=>d});var i=t(4848),l=t(8453);const a={layout:"docs",title:"Experimental Features",section:"chisel3"},s="Experimental Features",r={id:"appendix/experimental-features",title:"Experimental Features",description:"Chisel has a number of new features that are worth checking out.  This page is an informal list of these features and projects.",source:"@site/docs/appendix/experimental-features.md",sourceDirName:"appendix",slug:"/appendix/experimental-features",permalink:"/docs/appendix/experimental-features",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/appendix/experimental-features.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Experimental Features",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Migrating from ChiselTest",permalink:"/docs/appendix/migrating-from-chiseltest"},next:{title:"Upgrading From Chisel 3.4 to 3.5",permalink:"/docs/appendix/upgrading-from-chisel-3-4"}},o={},d=[{value:"Module Variants",id:"module-variants",level:2},{value:"Bundle Literals",id:"bundle-literals",level:2},{value:"Vec Literals",id:"vec-literals",level:2},{value:"Loading Memories for simulation or FPGA initialization",id:"loading-memories-for-simulation-or-fpga-initialization",level:2},{value:"Inline initialization with external file",id:"inline-initialization-with-external-file",level:3},{value:"SystemVerilog Bind Initialization",id:"systemverilog-bind-initialization",level:3},{value:"Notes on files",id:"notes-on-files",level:3},{value:"Aggregate memories",id:"aggregate-memories",level:3}];function c(e){const n={a:"a",blockquote:"blockquote",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",li:"li",p:"p",pre:"pre",ul:"ul",...(0,l.R)(),...e.components};return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsx)(n.h1,{id:"experimental-features",children:"Experimental Features"}),"\n",(0,i.jsx)(n.p,{children:"Chisel has a number of new features that are worth checking out.  This page is an informal list of these features and projects."}),"\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsx)(n.li,{children:(0,i.jsx)(n.a,{href:"#module-variants",children:"Module Variants"})}),"\n",(0,i.jsx)(n.li,{children:(0,i.jsx)(n.a,{href:"#bundle-literals",children:"Bundle Literals"})}),"\n",(0,i.jsx)(n.li,{children:(0,i.jsx)(n.a,{href:"#vec-literals",children:"Vec Literals"})}),"\n",(0,i.jsx)(n.li,{children:(0,i.jsx)(n.a,{href:"#loading-memories-for-simulation-or-fpga-initialization",children:"Loading-Memories-for-simulation-or-FPGA-initialization"})}),"\n"]}),"\n",(0,i.jsx)(n.h2,{id:"module-variants",children:"Module Variants"}),"\n",(0,i.jsxs)(n.p,{children:["The standard Chisel ",(0,i.jsx)(n.em,{children:"Module"})," requires a ",(0,i.jsx)(n.code,{children:"val io = IO(...)"}),", the experimental package introduces several\nnew ways of defining Modules"]}),"\n",(0,i.jsxs)(n.ul,{children:["\n",(0,i.jsx)(n.li,{children:"BaseModule: no contents, instantiable"}),"\n",(0,i.jsx)(n.li,{children:"BlackBox extends BaseModule"}),"\n",(0,i.jsx)(n.li,{children:"UserDefinedModule extends BaseModule: this module can contain Chisel RTL. No default clock or reset lines. No default IO. - User should be able to specify non-io ports, ideally multiple of them."}),"\n",(0,i.jsx)(n.li,{children:"ImplicitModule extends UserModule: has clock, reset, and io, essentially current Chisel Module."}),"\n",(0,i.jsx)(n.li,{children:"RawModule: will be the user-facing version of UserDefinedModule"}),"\n",(0,i.jsx)(n.li,{children:"Module: type-aliases to ImplicitModule, the user-facing version of ImplicitModule."}),"\n"]}),"\n",(0,i.jsx)(n.h2,{id:"bundle-literals",children:"Bundle Literals"}),"\n",(0,i.jsx)(n.p,{children:"Bundle literals can be constructed via an experimental import:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.BundleLiterals._\n\nclass MyBundle extends Bundle {\n  val a = UInt(8.W)\n  val b = Bool()\n}\n\nclass Example extends RawModule {\n  val out = IO(Output(new MyBundle))\n  out := (new MyBundle).Lit(_.a -> 8.U, _.b -> true.B)\n}\n"})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example(\t// experimental-features.md:20:7\n  output [7:0] out_a,\t// experimental-features.md:21:15\n  output       out_b\t// experimental-features.md:21:15\n);\n\n  assign out_a = 8'h8;\t// experimental-features.md:20:7\n  assign out_b = 1'h1;\t// experimental-features.md:20:7\nendmodule\n\n"})}),"\n",(0,i.jsxs)(n.p,{children:['Partial specification is allowed, which results in "invalidated fields" as\ndescribed in ',(0,i.jsx)(n.a,{href:"../explanations/unconnected-wires",children:"Unconnected Wires"}),".\nNote that this can be used with ",(0,i.jsx)(n.code,{children:"RegInit"})," to construct partially reset registers as\ndescribed in the ",(0,i.jsx)(n.a,{href:"../cookbooks/cookbook#how-do-i-partially-reset-an-aggregate-reg",children:"Cookbook"}),"."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class Example2 extends RawModule {\n  val out = IO(Output(new MyBundle))\n  out := (new MyBundle).Lit(_.b -> true.B)\n}\n"})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example2(\t// experimental-features.md:35:7\n  output [7:0] out_a,\t// experimental-features.md:36:15\n  output       out_b\t// experimental-features.md:36:15\n);\n\n  assign out_a = 8'h0;\t// experimental-features.md:35:7\n  assign out_b = 1'h1;\t// experimental-features.md:35:7\nendmodule\n\n"})}),"\n",(0,i.jsx)(n.p,{children:"Bundle literals can also be nested arbitrarily."}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class ChildBundle extends Bundle {\n  val foo = UInt(8.W)\n}\n\nclass ParentBundle extends Bundle {\n  val a = UInt(8.W)\n  val b = new ChildBundle\n}\n\nclass Example3 extends RawModule {\n  val out = IO(Output(new ParentBundle))\n  out := (new ParentBundle).Lit(_.a -> 123.U, _.b -> (new ChildBundle).Lit(_.foo -> 42.U))\n}\n"})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example3(\t// experimental-features.md:61:7\n  output [7:0] out_a,\t// experimental-features.md:62:15\n               out_b_foo\t// experimental-features.md:62:15\n);\n\n  assign out_a = 8'h7B;\t// experimental-features.md:61:7\n  assign out_b_foo = 8'h2A;\t// experimental-features.md:61:7\nendmodule\n\n"})}),"\n",(0,i.jsx)(n.h2,{id:"vec-literals",children:"Vec Literals"}),"\n",(0,i.jsx)(n.p,{children:"Vec literals are very similar to Bundle literals and can be constructed via an experimental import.\nThey can be constructed in two forms, with type and length inferred as in:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.VecLiterals._\n\nclass VecExample1 extends Module {\n  val out = IO(Output(Vec(2, UInt(4.W))))\n  out := Vec.Lit(0xa.U, 0xbb.U)\n}\n"})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule VecExample1(\t// experimental-features.md:82:7\n  input        clock,\t// experimental-features.md:82:7\n               reset,\t// experimental-features.md:82:7\n  output [3:0] out_0,\t// experimental-features.md:83:15\n               out_1\t// experimental-features.md:83:15\n);\n\n  assign out_0 = 4'hA;\t// experimental-features.md:82:7, :84:7\n  assign out_1 = 4'hB;\t// experimental-features.md:82:7, :84:7\nendmodule\n\n"})}),"\n",(0,i.jsx)(n.p,{children:"or explicitly as in:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.VecLiterals._\n\nclass VecExample1a extends Module {\n  val out = IO(Output(Vec(2, UInt(4.W))))\n  out := Vec(2, UInt(4.W)).Lit(0 -> 1.U, 1 -> 2.U)\n}\n"})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule VecExample1a(\t// experimental-features.md:103:7\n  input        clock,\t// experimental-features.md:103:7\n               reset,\t// experimental-features.md:103:7\n  output [3:0] out_0,\t// experimental-features.md:104:15\n               out_1\t// experimental-features.md:104:15\n);\n\n  assign out_0 = 4'h1;\t// experimental-features.md:103:7\n  assign out_1 = 4'h2;\t// experimental-features.md:103:7\nendmodule\n\n"})}),"\n",(0,i.jsxs)(n.p,{children:['The following examples all use the explicit form.\nWith the explicit form partial specification is allowed, which results in\n"invalidated fields" as described in ',(0,i.jsx)(n.a,{href:"../explanations/unconnected-wires",children:"Unconnected Wires"}),".\nNote that this can be used with ",(0,i.jsx)(n.code,{children:"RegInit"})," to construct partially reset registers as\ndescribed in the ",(0,i.jsx)(n.a,{href:"../cookbooks/cookbook#how-do-i-partially-reset-an-aggregate-reg",children:"Cookbook"}),"."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class VecExample2 extends RawModule {\n  val out = IO(Output(Vec(4, UInt(4.W))))\n  out := Vec(4, UInt(4.W)).Lit(0 -> 1.U, 3 -> 7.U)\n}\n"})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule VecExample2(\t// experimental-features.md:118:7\n  output [3:0] out_0,\t// experimental-features.md:119:15\n               out_1,\t// experimental-features.md:119:15\n               out_2,\t// experimental-features.md:119:15\n               out_3\t// experimental-features.md:119:15\n);\n\n  assign out_0 = 4'h1;\t// experimental-features.md:118:7\n  assign out_1 = 4'h0;\t// experimental-features.md:118:7\n  assign out_2 = 4'h0;\t// experimental-features.md:118:7\n  assign out_3 = 4'h7;\t// experimental-features.md:118:7\nendmodule\n\n"})}),"\n",(0,i.jsx)(n.p,{children:"Registers can be initialized from Vec literals"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class VecExample3 extends Module {\n  val out = IO(Output(Vec(4, UInt(8.W))))\n  val y = RegInit(\n    Vec(4, UInt(8.W)).Lit(0 -> 0xAB.U(8.W), 1 -> 0xCD.U(8.W), 2 -> 0xEF.U(8.W), 3 -> 0xFF.U(8.W))\n  )\n  out := y\n}\n"})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule VecExample3(\t// experimental-features.md:133:7\n  input        clock,\t// experimental-features.md:133:7\n               reset,\t// experimental-features.md:133:7\n  output [7:0] out_0,\t// experimental-features.md:134:15\n               out_1,\t// experimental-features.md:134:15\n               out_2,\t// experimental-features.md:134:15\n               out_3\t// experimental-features.md:134:15\n);\n\n  assign out_0 = 8'hAB;\t// experimental-features.md:133:7\n  assign out_1 = 8'hCD;\t// experimental-features.md:133:7\n  assign out_2 = 8'hEF;\t// experimental-features.md:133:7\n  assign out_3 = 8'hFF;\t// experimental-features.md:133:7\nendmodule\n\n"})}),"\n",(0,i.jsx)(n.p,{children:"Vec literals can also be nested arbitrarily."}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"class VecExample5 extends RawModule {\n  val out = IO(Output(Vec(2, new ChildBundle)))\n  out := Vec(2, new ChildBundle).Lit(\n    0 -> (new ChildBundle).Lit(_.foo -> 42.U),\n    1 -> (new ChildBundle).Lit(_.foo -> 7.U)\n  )\n}\n"})}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule VecExample5(\t// experimental-features.md:151:7\n  output [7:0] out_0_foo,\t// experimental-features.md:152:15\n               out_1_foo\t// experimental-features.md:152:15\n);\n\n  assign out_0_foo = 8'h2A;\t// experimental-features.md:151:7\n  assign out_1_foo = 8'h7;\t// experimental-features.md:151:7\nendmodule\n\n"})}),"\n",(0,i.jsx)(n.h2,{id:"loading-memories-for-simulation-or-fpga-initialization",children:"Loading Memories for simulation or FPGA initialization"}),"\n",(0,i.jsx)(n.h3,{id:"inline-initialization-with-external-file",children:"Inline initialization with external file"}),"\n",(0,i.jsxs)(n.p,{children:["Memories can be initialized by generating inline ",(0,i.jsx)(n.code,{children:"readmemh"})," or ",(0,i.jsx)(n.code,{children:"readmemb"})," statements in the output Verilog."]}),"\n",(0,i.jsxs)(n.p,{children:["The function ",(0,i.jsx)(n.code,{children:"loadMemoryFromFileInline"})," from ",(0,i.jsx)(n.code,{children:"chisel3.util.experimental"})," allows the memory to be initialized by the synthesis software from the specified file. Chisel does not validate the file contents nor its location. Both the memory initialization file and the Verilog source should be accessible for the toolchain."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:'import chisel3._\nimport chisel3.util.experimental.loadMemoryFromFileInline\n\nclass InitMemInline(memoryFile: String = "") extends Module {\n  val width: Int = 32\n  val io = IO(new Bundle {\n    val enable = Input(Bool())\n    val write = Input(Bool())\n    val addr = Input(UInt(10.W))\n    val dataIn = Input(UInt(width.W))\n    val dataOut = Output(UInt(width.W))\n  })\n\n  val mem = SyncReadMem(1024, UInt(width.W))\n  // Initialize memory\n  if (memoryFile.trim().nonEmpty) {\n    loadMemoryFromFileInline(mem, memoryFile)\n  }\n  io.dataOut := DontCare\n  when(io.enable) {\n    val rdwrPort = mem(io.addr)\n    when (io.write) { rdwrPort := io.dataIn }\n      .otherwise    { io.dataOut := rdwrPort }\n  }\n}\n'})}),"\n",(0,i.jsxs)(n.p,{children:["The default is to use ",(0,i.jsx)(n.code,{children:"$readmemh"})," (which assumes all numbers in the file are in ascii hex),\nbut to use ascii binary there is an optional ",(0,i.jsx)(n.code,{children:"hexOrBinary"})," argument which can be set to ",(0,i.jsx)(n.code,{children:"MemoryLoadFileType.Hex"})," or ",(0,i.jsx)(n.code,{children:"MemoryLoadFileType.Binary"}),". You will need to add an additional import."]}),"\n",(0,i.jsx)(n.h3,{id:"systemverilog-bind-initialization",children:"SystemVerilog Bind Initialization"}),"\n",(0,i.jsxs)(n.p,{children:["Chisel can also initialize memories by generating a SV bind module with ",(0,i.jsx)(n.code,{children:"readmemh"})," or ",(0,i.jsx)(n.code,{children:"readmemb"})," statements by using the function ",(0,i.jsx)(n.code,{children:"loadMemoryFromFile"})," from ",(0,i.jsx)(n.code,{children:"chisel3.util.experimental"}),"."]}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.util.experimental.loadMemoryFromFile\n\nclass InitMemBind(val bits: Int, val size: Int, filename: String) extends Module {\n  val io = IO(new Bundle {\n    val nia = Input(UInt(bits.W))\n    val insn = Output(UInt(32.W))\n  })\n\n  val memory = Mem(size, UInt(32.W))\n  io.insn := memory(io.nia >> 2);\n  loadMemoryFromFile(memory, filename)\n}\n"})}),"\n",(0,i.jsx)(n.p,{children:"Which generates the bind module:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{className:"language-verilog",children:'module BindsTo_0_Foo(\n  input         clock,\n  input         reset,\n  input  [31:0] io_nia,\n  output [31:0] io_insn\n);\n\ninitial begin\n  $readmemh("test.hex", Foo.memory);\nend\nendmodule\n\nbind Foo BindsTo_0_Foo BindsTo_0_Foo_Inst(.*);\n'})}),"\n",(0,i.jsx)(n.h3,{id:"notes-on-files",children:"Notes on files"}),"\n",(0,i.jsxs)(n.p,{children:["There is no simple answer to where to put the ",(0,i.jsx)(n.code,{children:"hex"})," or ",(0,i.jsx)(n.code,{children:"bin"})," file with the initial contents. It's probably best to create a resource directory somewhere and reference that through a full path or place the file beside the generated Verilog. Another option is adding the path to the memory file in the synthesis tool path. Because these files may be large, Chisel does not copy them."]}),"\n",(0,i.jsxs)(n.blockquote,{children:["\n",(0,i.jsx)(n.p,{children:"Don't forget there is no decimal option, so a 10 in an input file will be 16 decimal"}),"\n"]}),"\n",(0,i.jsxs)(n.p,{children:["See: ",(0,i.jsx)(n.a,{href:"https://github.com/freechipsproject/chisel-testers/blob/master/src/test/scala/examples/ComplexMemoryLoadingSpec.scala",children:"ComplexMemoryLoadingSpec.scala"})," and\n",(0,i.jsx)(n.a,{href:"https://github.com/freechipsproject/chisel-testers/blob/master/src/test/scala/examples/LoadMemoryFromFileSpec.scala",children:"LoadMemoryFromFileSpec.scala"}),"\nfor working examples."]}),"\n",(0,i.jsx)(n.h3,{id:"aggregate-memories",children:"Aggregate memories"}),"\n",(0,i.jsxs)(n.p,{children:["Aggregate memories are supported and will be lowered to a single wide ",(0,i.jsx)(n.code,{children:"UInt"}),".  The memory loading file should be constructed to align with the final structure of the memory."]})]})}function u(e={}){const{wrapper:n}={...(0,l.R)(),...e.components};return n?(0,i.jsx)(n,{...e,children:(0,i.jsx)(c,{...e})}):c(e)}},8453:(e,n,t)=>{t.d(n,{R:()=>s,x:()=>r});var i=t(6540);const l={},a=i.createContext(l);function s(e){const n=i.useContext(a);return i.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function r(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(l):e.components||l:s(e.components),i.createElement(a.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/c48de377.e33bb9b9.js b/assets/js/c48de377.e33bb9b9.js
new file mode 100644
index 0000000000..5c7d68b359
--- /dev/null
+++ b/assets/js/c48de377.e33bb9b9.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[3316],{648:(e,i,n)=>{n.r(i),n.d(i,{assets:()=>o,contentTitle:()=>l,default:()=>m,frontMatter:()=>r,metadata:()=>s,toc:()=>c});var a=n(4848),t=n(8453);const r={layout:"docs",title:"Experimental Features",section:"chisel3"},l="Experimental Features",s={id:"appendix/experimental-features",title:"Experimental Features",description:"Chisel has a number of new features that are worth checking out.  This page is an informal list of these features and projects.",source:"@site/docs/appendix/experimental-features.md",sourceDirName:"appendix",slug:"/appendix/experimental-features",permalink:"/docs/appendix/experimental-features",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/appendix/experimental-features.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Experimental Features",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Migrating from ChiselTest",permalink:"/docs/appendix/migrating-from-chiseltest"},next:{title:"Upgrading From Chisel 3.4 to 3.5",permalink:"/docs/appendix/upgrading-from-chisel-3-4"}},o={},c=[{value:"Module Variants",id:"module-variants",level:2},{value:"Bundle Literals",id:"bundle-literals",level:2},{value:"Vec Literals",id:"vec-literals",level:2},{value:"Loading Memories for simulation or FPGA initialization",id:"loading-memories-for-simulation-or-fpga-initialization",level:2},{value:"Inline initialization with external file",id:"inline-initialization-with-external-file",level:3},{value:"SystemVerilog Bind Initialization",id:"systemverilog-bind-initialization",level:3},{value:"Notes on files",id:"notes-on-files",level:3},{value:"Aggregate memories",id:"aggregate-memories",level:3}];function d(e){const i={a:"a",blockquote:"blockquote",code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",li:"li",p:"p",pre:"pre",ul:"ul",...(0,t.R)(),...e.components};return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(i.h1,{id:"experimental-features",children:"Experimental Features"}),"\n",(0,a.jsx)(i.p,{children:"Chisel has a number of new features that are worth checking out.  This page is an informal list of these features and projects."}),"\n",(0,a.jsxs)(i.ul,{children:["\n",(0,a.jsx)(i.li,{children:(0,a.jsx)(i.a,{href:"#module-variants",children:"Module Variants"})}),"\n",(0,a.jsx)(i.li,{children:(0,a.jsx)(i.a,{href:"#bundle-literals",children:"Bundle Literals"})}),"\n",(0,a.jsx)(i.li,{children:(0,a.jsx)(i.a,{href:"#vec-literals",children:"Vec Literals"})}),"\n",(0,a.jsx)(i.li,{children:(0,a.jsx)(i.a,{href:"#loading-memories-for-simulation-or-fpga-initialization",children:"Loading-Memories-for-simulation-or-FPGA-initialization"})}),"\n"]}),"\n",(0,a.jsx)(i.h2,{id:"module-variants",children:"Module Variants"}),"\n",(0,a.jsxs)(i.p,{children:["The standard Chisel ",(0,a.jsx)(i.em,{children:"Module"})," requires a ",(0,a.jsx)(i.code,{children:"val io = IO(...)"}),", the experimental package introduces several\nnew ways of defining Modules"]}),"\n",(0,a.jsxs)(i.ul,{children:["\n",(0,a.jsx)(i.li,{children:"BaseModule: no contents, instantiable"}),"\n",(0,a.jsx)(i.li,{children:"BlackBox extends BaseModule"}),"\n",(0,a.jsx)(i.li,{children:"UserDefinedModule extends BaseModule: this module can contain Chisel RTL. No default clock or reset lines. No default IO. - User should be able to specify non-io ports, ideally multiple of them."}),"\n",(0,a.jsx)(i.li,{children:"ImplicitModule extends UserModule: has clock, reset, and io, essentially current Chisel Module."}),"\n",(0,a.jsx)(i.li,{children:"RawModule: will be the user-facing version of UserDefinedModule"}),"\n",(0,a.jsx)(i.li,{children:"Module: type-aliases to ImplicitModule, the user-facing version of ImplicitModule."}),"\n"]}),"\n",(0,a.jsx)(i.h2,{id:"bundle-literals",children:"Bundle Literals"}),"\n",(0,a.jsx)(i.p,{children:"Bundle literals can be constructed via an experimental import:"}),"\n",(0,a.jsx)(i.pre,{children:(0,a.jsx)(i.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.BundleLiterals._\n\nclass MyBundle extends Bundle {\n  val a = UInt(8.W)\n  val b = Bool()\n}\n\nclass Example extends RawModule {\n  val out = IO(Output(new MyBundle))\n  out := (new MyBundle).Lit(_.a -> 8.U, _.b -> true.B)\n}\n"})}),"\n",(0,a.jsx)(i.pre,{children:(0,a.jsx)(i.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example(\t// experimental-features.md:20:7\n  output [7:0] out_a,\t// experimental-features.md:21:15\n  output       out_b\t// experimental-features.md:21:15\n);\n\n  assign out_a = 8\'h8;\t// experimental-features.md:20:7\n  assign out_b = 1\'h1;\t// experimental-features.md:20:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example_Verification.sv"\n`ifndef layers_Example_Verification_Cover\n`define layers_Example_Verification_Cover\t// <stdin>:6:5\n`endif // layers_Example_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example_Verification.sv"\n`ifndef layers_Example_Verification_Assume\n`define layers_Example_Verification_Assume\t// <stdin>:5:5\n`endif // layers_Example_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example_Verification.sv"\n`ifndef layers_Example_Verification_Assert\n`define layers_Example_Verification_Assert\t// <stdin>:4:5\n`endif // layers_Example_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_Example_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example_Verification\n`define layers_Example_Verification\t// <stdin>:3:3\n`endif // layers_Example_Verification\t// <stdin>:3:3\n'})}),"\n",(0,a.jsxs)(i.p,{children:['Partial specification is allowed, which results in "invalidated fields" as\ndescribed in ',(0,a.jsx)(i.a,{href:"../explanations/unconnected-wires",children:"Unconnected Wires"}),".\nNote that this can be used with ",(0,a.jsx)(i.code,{children:"RegInit"})," to construct partially reset registers as\ndescribed in the ",(0,a.jsx)(i.a,{href:"../cookbooks/cookbook#how-do-i-partially-reset-an-aggregate-reg",children:"Cookbook"}),"."]}),"\n",(0,a.jsx)(i.pre,{children:(0,a.jsx)(i.code,{className:"language-scala",children:"class Example2 extends RawModule {\n  val out = IO(Output(new MyBundle))\n  out := (new MyBundle).Lit(_.b -> true.B)\n}\n"})}),"\n",(0,a.jsx)(i.pre,{children:(0,a.jsx)(i.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example2(\t// experimental-features.md:35:7\n  output [7:0] out_a,\t// experimental-features.md:36:15\n  output       out_b\t// experimental-features.md:36:15\n);\n\n  assign out_a = 8\'h0;\t// experimental-features.md:35:7\n  assign out_b = 1\'h1;\t// experimental-features.md:35:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example2_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example2_Verification.sv"\n`ifndef layers_Example2_Verification_Cover\n`define layers_Example2_Verification_Cover\t// <stdin>:6:5\n`endif // layers_Example2_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example2_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example2_Verification.sv"\n`ifndef layers_Example2_Verification_Assume\n`define layers_Example2_Verification_Assume\t// <stdin>:5:5\n`endif // layers_Example2_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example2_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example2_Verification.sv"\n`ifndef layers_Example2_Verification_Assert\n`define layers_Example2_Verification_Assert\t// <stdin>:4:5\n`endif // layers_Example2_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_Example2_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example2_Verification\n`define layers_Example2_Verification\t// <stdin>:3:3\n`endif // layers_Example2_Verification\t// <stdin>:3:3\n'})}),"\n",(0,a.jsx)(i.p,{children:"Bundle literals can also be nested arbitrarily."}),"\n",(0,a.jsx)(i.pre,{children:(0,a.jsx)(i.code,{className:"language-scala",children:"class ChildBundle extends Bundle {\n  val foo = UInt(8.W)\n}\n\nclass ParentBundle extends Bundle {\n  val a = UInt(8.W)\n  val b = new ChildBundle\n}\n\nclass Example3 extends RawModule {\n  val out = IO(Output(new ParentBundle))\n  out := (new ParentBundle).Lit(_.a -> 123.U, _.b -> (new ChildBundle).Lit(_.foo -> 42.U))\n}\n"})}),"\n",(0,a.jsx)(i.pre,{children:(0,a.jsx)(i.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example3(\t// experimental-features.md:61:7\n  output [7:0] out_a,\t// experimental-features.md:62:15\n               out_b_foo\t// experimental-features.md:62:15\n);\n\n  assign out_a = 8\'h7B;\t// experimental-features.md:61:7\n  assign out_b_foo = 8\'h2A;\t// experimental-features.md:61:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example3_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example3_Verification.sv"\n`ifndef layers_Example3_Verification_Cover\n`define layers_Example3_Verification_Cover\t// <stdin>:6:5\n`endif // layers_Example3_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example3_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example3_Verification.sv"\n`ifndef layers_Example3_Verification_Assume\n`define layers_Example3_Verification_Assume\t// <stdin>:5:5\n`endif // layers_Example3_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example3_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example3_Verification.sv"\n`ifndef layers_Example3_Verification_Assert\n`define layers_Example3_Verification_Assert\t// <stdin>:4:5\n`endif // layers_Example3_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_Example3_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example3_Verification\n`define layers_Example3_Verification\t// <stdin>:3:3\n`endif // layers_Example3_Verification\t// <stdin>:3:3\n'})}),"\n",(0,a.jsx)(i.h2,{id:"vec-literals",children:"Vec Literals"}),"\n",(0,a.jsx)(i.p,{children:"Vec literals are very similar to Bundle literals and can be constructed via an experimental import.\nThey can be constructed in two forms, with type and length inferred as in:"}),"\n",(0,a.jsx)(i.pre,{children:(0,a.jsx)(i.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.VecLiterals._\n\nclass VecExample1 extends Module {\n  val out = IO(Output(Vec(2, UInt(4.W))))\n  out := Vec.Lit(0xa.U, 0xbb.U)\n}\n"})}),"\n",(0,a.jsx)(i.pre,{children:(0,a.jsx)(i.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule VecExample1(\t// experimental-features.md:82:7\n  input        clock,\t// experimental-features.md:82:7\n               reset,\t// experimental-features.md:82:7\n  output [3:0] out_0,\t// experimental-features.md:83:15\n               out_1\t// experimental-features.md:83:15\n);\n\n  assign out_0 = 4\'hA;\t// experimental-features.md:82:7, :84:7\n  assign out_1 = 4\'hB;\t// experimental-features.md:82:7, :84:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_VecExample1_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_VecExample1_Verification.sv"\n`ifndef layers_VecExample1_Verification_Cover\n`define layers_VecExample1_Verification_Cover\t// <stdin>:6:5\n`endif // layers_VecExample1_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_VecExample1_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_VecExample1_Verification.sv"\n`ifndef layers_VecExample1_Verification_Assume\n`define layers_VecExample1_Verification_Assume\t// <stdin>:5:5\n`endif // layers_VecExample1_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_VecExample1_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_VecExample1_Verification.sv"\n`ifndef layers_VecExample1_Verification_Assert\n`define layers_VecExample1_Verification_Assert\t// <stdin>:4:5\n`endif // layers_VecExample1_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_VecExample1_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_VecExample1_Verification\n`define layers_VecExample1_Verification\t// <stdin>:3:3\n`endif // layers_VecExample1_Verification\t// <stdin>:3:3\n'})}),"\n",(0,a.jsx)(i.p,{children:"or explicitly as in:"}),"\n",(0,a.jsx)(i.pre,{children:(0,a.jsx)(i.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.VecLiterals._\n\nclass VecExample1a extends Module {\n  val out = IO(Output(Vec(2, UInt(4.W))))\n  out := Vec(2, UInt(4.W)).Lit(0 -> 1.U, 1 -> 2.U)\n}\n"})}),"\n",(0,a.jsx)(i.pre,{children:(0,a.jsx)(i.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule VecExample1a(\t// experimental-features.md:103:7\n  input        clock,\t// experimental-features.md:103:7\n               reset,\t// experimental-features.md:103:7\n  output [3:0] out_0,\t// experimental-features.md:104:15\n               out_1\t// experimental-features.md:104:15\n);\n\n  assign out_0 = 4\'h1;\t// experimental-features.md:103:7\n  assign out_1 = 4\'h2;\t// experimental-features.md:103:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_VecExample1a_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_VecExample1a_Verification.sv"\n`ifndef layers_VecExample1a_Verification_Cover\n`define layers_VecExample1a_Verification_Cover\t// <stdin>:6:5\n`endif // layers_VecExample1a_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_VecExample1a_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_VecExample1a_Verification.sv"\n`ifndef layers_VecExample1a_Verification_Assume\n`define layers_VecExample1a_Verification_Assume\t// <stdin>:5:5\n`endif // layers_VecExample1a_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_VecExample1a_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_VecExample1a_Verification.sv"\n`ifndef layers_VecExample1a_Verification_Assert\n`define layers_VecExample1a_Verification_Assert\t// <stdin>:4:5\n`endif // layers_VecExample1a_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_VecExample1a_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_VecExample1a_Verification\n`define layers_VecExample1a_Verification\t// <stdin>:3:3\n`endif // layers_VecExample1a_Verification\t// <stdin>:3:3\n'})}),"\n",(0,a.jsxs)(i.p,{children:['The following examples all use the explicit form.\nWith the explicit form partial specification is allowed, which results in\n"invalidated fields" as described in ',(0,a.jsx)(i.a,{href:"../explanations/unconnected-wires",children:"Unconnected Wires"}),".\nNote that this can be used with ",(0,a.jsx)(i.code,{children:"RegInit"})," to construct partially reset registers as\ndescribed in the ",(0,a.jsx)(i.a,{href:"../cookbooks/cookbook#how-do-i-partially-reset-an-aggregate-reg",children:"Cookbook"}),"."]}),"\n",(0,a.jsx)(i.pre,{children:(0,a.jsx)(i.code,{className:"language-scala",children:"class VecExample2 extends RawModule {\n  val out = IO(Output(Vec(4, UInt(4.W))))\n  out := Vec(4, UInt(4.W)).Lit(0 -> 1.U, 3 -> 7.U)\n}\n"})}),"\n",(0,a.jsx)(i.pre,{children:(0,a.jsx)(i.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule VecExample2(\t// experimental-features.md:118:7\n  output [3:0] out_0,\t// experimental-features.md:119:15\n               out_1,\t// experimental-features.md:119:15\n               out_2,\t// experimental-features.md:119:15\n               out_3\t// experimental-features.md:119:15\n);\n\n  assign out_0 = 4\'h1;\t// experimental-features.md:118:7\n  assign out_1 = 4\'h0;\t// experimental-features.md:118:7\n  assign out_2 = 4\'h0;\t// experimental-features.md:118:7\n  assign out_3 = 4\'h7;\t// experimental-features.md:118:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_VecExample2_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_VecExample2_Verification.sv"\n`ifndef layers_VecExample2_Verification_Cover\n`define layers_VecExample2_Verification_Cover\t// <stdin>:6:5\n`endif // layers_VecExample2_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_VecExample2_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_VecExample2_Verification.sv"\n`ifndef layers_VecExample2_Verification_Assume\n`define layers_VecExample2_Verification_Assume\t// <stdin>:5:5\n`endif // layers_VecExample2_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_VecExample2_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_VecExample2_Verification.sv"\n`ifndef layers_VecExample2_Verification_Assert\n`define layers_VecExample2_Verification_Assert\t// <stdin>:4:5\n`endif // layers_VecExample2_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_VecExample2_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_VecExample2_Verification\n`define layers_VecExample2_Verification\t// <stdin>:3:3\n`endif // layers_VecExample2_Verification\t// <stdin>:3:3\n'})}),"\n",(0,a.jsx)(i.p,{children:"Registers can be initialized from Vec literals"}),"\n",(0,a.jsx)(i.pre,{children:(0,a.jsx)(i.code,{className:"language-scala",children:"class VecExample3 extends Module {\n  val out = IO(Output(Vec(4, UInt(8.W))))\n  val y = RegInit(\n    Vec(4, UInt(8.W)).Lit(0 -> 0xAB.U(8.W), 1 -> 0xCD.U(8.W), 2 -> 0xEF.U(8.W), 3 -> 0xFF.U(8.W))\n  )\n  out := y\n}\n"})}),"\n",(0,a.jsx)(i.pre,{children:(0,a.jsx)(i.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule VecExample3(\t// experimental-features.md:133:7\n  input        clock,\t// experimental-features.md:133:7\n               reset,\t// experimental-features.md:133:7\n  output [7:0] out_0,\t// experimental-features.md:134:15\n               out_1,\t// experimental-features.md:134:15\n               out_2,\t// experimental-features.md:134:15\n               out_3\t// experimental-features.md:134:15\n);\n\n  assign out_0 = 8\'hAB;\t// experimental-features.md:133:7\n  assign out_1 = 8\'hCD;\t// experimental-features.md:133:7\n  assign out_2 = 8\'hEF;\t// experimental-features.md:133:7\n  assign out_3 = 8\'hFF;\t// experimental-features.md:133:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_VecExample3_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_VecExample3_Verification.sv"\n`ifndef layers_VecExample3_Verification_Cover\n`define layers_VecExample3_Verification_Cover\t// <stdin>:6:5\n`endif // layers_VecExample3_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_VecExample3_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_VecExample3_Verification.sv"\n`ifndef layers_VecExample3_Verification_Assume\n`define layers_VecExample3_Verification_Assume\t// <stdin>:5:5\n`endif // layers_VecExample3_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_VecExample3_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_VecExample3_Verification.sv"\n`ifndef layers_VecExample3_Verification_Assert\n`define layers_VecExample3_Verification_Assert\t// <stdin>:4:5\n`endif // layers_VecExample3_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_VecExample3_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_VecExample3_Verification\n`define layers_VecExample3_Verification\t// <stdin>:3:3\n`endif // layers_VecExample3_Verification\t// <stdin>:3:3\n'})}),"\n",(0,a.jsx)(i.p,{children:"Vec literals can also be nested arbitrarily."}),"\n",(0,a.jsx)(i.pre,{children:(0,a.jsx)(i.code,{className:"language-scala",children:"class VecExample5 extends RawModule {\n  val out = IO(Output(Vec(2, new ChildBundle)))\n  out := Vec(2, new ChildBundle).Lit(\n    0 -> (new ChildBundle).Lit(_.foo -> 42.U),\n    1 -> (new ChildBundle).Lit(_.foo -> 7.U)\n  )\n}\n"})}),"\n",(0,a.jsx)(i.pre,{children:(0,a.jsx)(i.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule VecExample5(\t// experimental-features.md:151:7\n  output [7:0] out_0_foo,\t// experimental-features.md:152:15\n               out_1_foo\t// experimental-features.md:152:15\n);\n\n  assign out_0_foo = 8\'h2A;\t// experimental-features.md:151:7\n  assign out_1_foo = 8\'h7;\t// experimental-features.md:151:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_VecExample5_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_VecExample5_Verification.sv"\n`ifndef layers_VecExample5_Verification_Cover\n`define layers_VecExample5_Verification_Cover\t// <stdin>:6:5\n`endif // layers_VecExample5_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_VecExample5_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_VecExample5_Verification.sv"\n`ifndef layers_VecExample5_Verification_Assume\n`define layers_VecExample5_Verification_Assume\t// <stdin>:5:5\n`endif // layers_VecExample5_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_VecExample5_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_VecExample5_Verification.sv"\n`ifndef layers_VecExample5_Verification_Assert\n`define layers_VecExample5_Verification_Assert\t// <stdin>:4:5\n`endif // layers_VecExample5_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_VecExample5_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_VecExample5_Verification\n`define layers_VecExample5_Verification\t// <stdin>:3:3\n`endif // layers_VecExample5_Verification\t// <stdin>:3:3\n'})}),"\n",(0,a.jsx)(i.h2,{id:"loading-memories-for-simulation-or-fpga-initialization",children:"Loading Memories for simulation or FPGA initialization"}),"\n",(0,a.jsx)(i.h3,{id:"inline-initialization-with-external-file",children:"Inline initialization with external file"}),"\n",(0,a.jsxs)(i.p,{children:["Memories can be initialized by generating inline ",(0,a.jsx)(i.code,{children:"readmemh"})," or ",(0,a.jsx)(i.code,{children:"readmemb"})," statements in the output Verilog."]}),"\n",(0,a.jsxs)(i.p,{children:["The function ",(0,a.jsx)(i.code,{children:"loadMemoryFromFileInline"})," from ",(0,a.jsx)(i.code,{children:"chisel3.util.experimental"})," allows the memory to be initialized by the synthesis software from the specified file. Chisel does not validate the file contents nor its location. Both the memory initialization file and the Verilog source should be accessible for the toolchain."]}),"\n",(0,a.jsx)(i.pre,{children:(0,a.jsx)(i.code,{className:"language-scala",children:'import chisel3._\nimport chisel3.util.experimental.loadMemoryFromFileInline\n\nclass InitMemInline(memoryFile: String = "") extends Module {\n  val width: Int = 32\n  val io = IO(new Bundle {\n    val enable = Input(Bool())\n    val write = Input(Bool())\n    val addr = Input(UInt(10.W))\n    val dataIn = Input(UInt(width.W))\n    val dataOut = Output(UInt(width.W))\n  })\n\n  val mem = SyncReadMem(1024, UInt(width.W))\n  // Initialize memory\n  if (memoryFile.trim().nonEmpty) {\n    loadMemoryFromFileInline(mem, memoryFile)\n  }\n  io.dataOut := DontCare\n  when(io.enable) {\n    val rdwrPort = mem(io.addr)\n    when (io.write) { rdwrPort := io.dataIn }\n      .otherwise    { io.dataOut := rdwrPort }\n  }\n}\n'})}),"\n",(0,a.jsxs)(i.p,{children:["The default is to use ",(0,a.jsx)(i.code,{children:"$readmemh"})," (which assumes all numbers in the file are in ascii hex),\nbut to use ascii binary there is an optional ",(0,a.jsx)(i.code,{children:"hexOrBinary"})," argument which can be set to ",(0,a.jsx)(i.code,{children:"MemoryLoadFileType.Hex"})," or ",(0,a.jsx)(i.code,{children:"MemoryLoadFileType.Binary"}),". You will need to add an additional import."]}),"\n",(0,a.jsx)(i.h3,{id:"systemverilog-bind-initialization",children:"SystemVerilog Bind Initialization"}),"\n",(0,a.jsxs)(i.p,{children:["Chisel can also initialize memories by generating a SV bind module with ",(0,a.jsx)(i.code,{children:"readmemh"})," or ",(0,a.jsx)(i.code,{children:"readmemb"})," statements by using the function ",(0,a.jsx)(i.code,{children:"loadMemoryFromFile"})," from ",(0,a.jsx)(i.code,{children:"chisel3.util.experimental"}),"."]}),"\n",(0,a.jsx)(i.pre,{children:(0,a.jsx)(i.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.util.experimental.loadMemoryFromFile\n\nclass InitMemBind(val bits: Int, val size: Int, filename: String) extends Module {\n  val io = IO(new Bundle {\n    val nia = Input(UInt(bits.W))\n    val insn = Output(UInt(32.W))\n  })\n\n  val memory = Mem(size, UInt(32.W))\n  io.insn := memory(io.nia >> 2);\n  loadMemoryFromFile(memory, filename)\n}\n"})}),"\n",(0,a.jsx)(i.p,{children:"Which generates the bind module:"}),"\n",(0,a.jsx)(i.pre,{children:(0,a.jsx)(i.code,{className:"language-verilog",children:'module BindsTo_0_Foo(\n  input         clock,\n  input         reset,\n  input  [31:0] io_nia,\n  output [31:0] io_insn\n);\n\ninitial begin\n  $readmemh("test.hex", Foo.memory);\nend\nendmodule\n\nbind Foo BindsTo_0_Foo BindsTo_0_Foo_Inst(.*);\n'})}),"\n",(0,a.jsx)(i.h3,{id:"notes-on-files",children:"Notes on files"}),"\n",(0,a.jsxs)(i.p,{children:["There is no simple answer to where to put the ",(0,a.jsx)(i.code,{children:"hex"})," or ",(0,a.jsx)(i.code,{children:"bin"})," file with the initial contents. It's probably best to create a resource directory somewhere and reference that through a full path or place the file beside the generated Verilog. Another option is adding the path to the memory file in the synthesis tool path. Because these files may be large, Chisel does not copy them."]}),"\n",(0,a.jsxs)(i.blockquote,{children:["\n",(0,a.jsx)(i.p,{children:"Don't forget there is no decimal option, so a 10 in an input file will be 16 decimal"}),"\n"]}),"\n",(0,a.jsxs)(i.p,{children:["See: ",(0,a.jsx)(i.a,{href:"https://github.com/freechipsproject/chisel-testers/blob/master/src/test/scala/examples/ComplexMemoryLoadingSpec.scala",children:"ComplexMemoryLoadingSpec.scala"})," and\n",(0,a.jsx)(i.a,{href:"https://github.com/freechipsproject/chisel-testers/blob/master/src/test/scala/examples/LoadMemoryFromFileSpec.scala",children:"LoadMemoryFromFileSpec.scala"}),"\nfor working examples."]}),"\n",(0,a.jsx)(i.h3,{id:"aggregate-memories",children:"Aggregate memories"}),"\n",(0,a.jsxs)(i.p,{children:["Aggregate memories are supported and will be lowered to a single wide ",(0,a.jsx)(i.code,{children:"UInt"}),".  The memory loading file should be constructed to align with the final structure of the memory."]})]})}function m(e={}){const{wrapper:i}={...(0,t.R)(),...e.components};return i?(0,a.jsx)(i,{...e,children:(0,a.jsx)(d,{...e})}):d(e)}},8453:(e,i,n)=>{n.d(i,{R:()=>l,x:()=>s});var a=n(6540);const t={},r=a.createContext(t);function l(e){const i=a.useContext(r);return a.useMemo((function(){return"function"==typeof e?e(i):{...i,...e}}),[i,e])}function s(e){let i;return i=e.disableParentContext?"function"==typeof e.components?e.components(t):e.components||t:l(e.components),a.createElement(r.Provider,{value:i},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/c7666d49.11a4da61.js b/assets/js/c7666d49.11a4da61.js
new file mode 100644
index 0000000000..f4c37b1bf3
--- /dev/null
+++ b/assets/js/c7666d49.11a4da61.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[6474],{361:(e,n,i)=>{i.r(n),i.d(n,{assets:()=>t,contentTitle:()=>a,default:()=>h,frontMatter:()=>s,metadata:()=>l,toc:()=>c});var o=i(4848),r=i(8453);const s={layout:"docs",title:"Layers",section:"chisel3"},a="Layers",l={id:"explanations/layers",title:"Layers",description:"Layers are used to describe functionality of a Chisel circuit or module that a",source:"@site/docs/explanations/layers.md",sourceDirName:"explanations",slug:"/explanations/layers",permalink:"/docs/explanations/layers",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/layers.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Layers",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Intrinsics",permalink:"/docs/explanations/intrinsics"},next:{title:"Memories",permalink:"/docs/explanations/memories"}},t={},c=[{value:"Conventions",id:"conventions",level:2},{value:"Built-in Layers and User-defined Layers",id:"built-in-layers-and-user-defined-layers",level:2},{value:"Examples",id:"examples",level:2},{value:"Design Verification Example",id:"design-verification-example",level:3},{value:"Implementation Notes",id:"implementation-notes",level:4},{value:"Verilog Output",id:"verilog-output",level:4}];function d(e){const n={code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",h4:"h4",li:"li",ol:"ol",p:"p",pre:"pre",...(0,r.R)(),...e.components};return(0,o.jsxs)(o.Fragment,{children:[(0,o.jsx)(n.h1,{id:"layers",children:"Layers"}),"\n",(0,o.jsxs)(n.p,{children:["Layers are used to describe functionality of a Chisel circuit or module that a\nuser would like to ",(0,o.jsx)(n.em,{children:"optionally"})," include at Verilog elaboration time.  This\nfeature is intended to be used to optionally include verification or debug logic\nthat a user does not want to always have present."]}),"\n",(0,o.jsx)(n.p,{children:"Each layer is broken into two pieces:"}),"\n",(0,o.jsxs)(n.ol,{children:["\n",(0,o.jsxs)(n.li,{children:["A layer ",(0,o.jsx)(n.em,{children:"declaration"})]}),"\n",(0,o.jsxs)(n.li,{children:["One or more ",(0,o.jsx)(n.em,{children:"layer blocks"})," inside modules in the circuit"]}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["There are two kinds of layers, each kind is lowered to verilog under a different\n",(0,o.jsx)(n.em,{children:"convention"}),". The kinds of layers are:"]}),"\n",(0,o.jsxs)(n.ol,{children:["\n",(0,o.jsx)(n.li,{children:'"Extract" Layers: layers whose blocks are lowered to bound-in modules, and'}),"\n",(0,o.jsx)(n.li,{children:'"Inline" Layers: layers whose blocks are lowered to ifdefs macros.'}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["To declare a layer, create a singleton ",(0,o.jsx)(n.code,{children:"object"})," in scala that extends the"]}),"\n",(0,o.jsxs)(n.p,{children:["extend the abstract class ",(0,o.jsx)(n.code,{children:"chisel3.layer.Layer"}),", passing into the layer\nconstructor either ",(0,o.jsx)(n.code,{children:"chisel3.layer.LayerConfig.Extract()"}),' for an "extract" layer,\nor ',(0,o.jsx)(n.code,{children:"chisel3.layer.LayerConfig.Inline"}),' for "inline" layers.']}),"\n",(0,o.jsxs)(n.p,{children:["Layers may be nested. To declare a nested layer, extend the\n",(0,o.jsx)(n.code,{children:"chisel3.layer.Layer"})," abstract class inside another declaration."]}),"\n",(0,o.jsx)(n.p,{children:"The following example declares four layers:"}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"import chisel3.layer.{Layer, LayerConfig}\n\nobject A extends Layer(LayerConfig.Extract()) {\n  object B extends Layer(LayerConfig.Extract()) {\n    object C extends Layer(LayerConfig.Extract())\n  }\n  object D extends Layer(LayerConfig.Extract())\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["A ",(0,o.jsx)(n.em,{children:"layer block"}),", associated with a layer, adds optional functionality to a\nmodule that is enabled if that layer is enabled.  Each layer block must refer to\na pre-declared layer.  Layer block nesting must match the nesting of declared\nlayers."]}),"\n",(0,o.jsxs)(n.p,{children:["To define a layer block, use the ",(0,o.jsx)(n.code,{children:"chisel3.layer.block"})," inside a Chisel module.\nAn layer block may use any Chisel or Scala value visible to its Scala lexical\nscope."]}),"\n",(0,o.jsxs)(n.p,{children:["The following example defines layer blocks inside module ",(0,o.jsx)(n.code,{children:"Foo"})," and declares\nwires which are connected to values captured from visible lexical scope:"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.layer.block\n\nclass Foo extends RawModule {\n  val port = IO(Input(Bool()))\n\n  block(A) {\n    val a = WireInit(port)\n    block(A.B) {\n      val b = WireInit(a)\n      block(A.B.C) {\n        val c = WireInit(b)\n      }\n    }\n    block(A.D) {\n      val d = WireInit(port ^ a)\n    }\n  }\n}\n"})}),"\n",(0,o.jsx)(n.h2,{id:"conventions",children:"Conventions"}),"\n",(0,o.jsxs)(n.p,{children:["Currently, there is only one supported convention, ",(0,o.jsx)(n.code,{children:"Bind"}),".  This will cause layer\nblocks to be lowered to Verilog modules that are instantiated via the\nSystemVerilog ",(0,o.jsx)(n.code,{children:"bind"})," mechanism.  The lowering to Verilog of layer blocks avoids\nillegal nested usage of ",(0,o.jsx)(n.code,{children:"bind"}),"."]}),"\n",(0,o.jsx)(n.p,{children:"More conventions may be supported in the future."}),"\n",(0,o.jsx)(n.h2,{id:"built-in-layers-and-user-defined-layers",children:"Built-in Layers and User-defined Layers"}),"\n",(0,o.jsx)(n.p,{children:"Chisel provides several built-in layers.  These are shown below with their full\nScala paths:"}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{children:"`chisel3.layers.Verification`\n\u251c\u2500\u2500 `chisel3.layers.Verification.Assert`\n\u251c\u2500\u2500 `chisel3.layers.Verification.Assume`\n\u2514\u2500\u2500 `chisel3.layers.Verification.Cover`\n"})}),"\n",(0,o.jsxs)(n.p,{children:["These built-in layers are dual purpose.  First, they are layers that match\ncommon use cases for sequestering verification code.  The ",(0,o.jsx)(n.code,{children:"Verification"})," layer\nis for common verification collateral.  The ",(0,o.jsx)(n.code,{children:"Assert"}),", ",(0,o.jsx)(n.code,{children:"Assume"}),", and ",(0,o.jsx)(n.code,{children:"Cover"}),"\nlayers are for, respectively, assertions, assumptions, and cover statements.\nSecond, the Chisel standard library uses them for some of its APIs."]}),"\n",(0,o.jsx)(n.p,{children:"For predictability of output, these layers will always be show up in the FIRRTL\nthat Chisel emits."}),"\n",(0,o.jsxs)(n.p,{children:["A user is free to define their own layers, as shown previously with layer ",(0,o.jsx)(n.code,{children:"A"}),",\n",(0,o.jsx)(n.code,{children:"A.B"}),", etc.  User-defined layers are only emitted into FIRRTL if they have layer\nblock users.  Layers can be unconditionally emitted using the\n",(0,o.jsx)(n.code,{children:"chisel3.layer.addLayer"})," API."]}),"\n",(0,o.jsx)(n.h2,{id:"examples",children:"Examples"}),"\n",(0,o.jsx)(n.h3,{id:"design-verification-example",children:"Design Verification Example"}),"\n",(0,o.jsx)(n.p,{children:"Consider a use case where a design or design verification engineer would like to\nadd some asserts and debug prints to a module.  The logic necessary for the\nasserts and debug prints requires additional computation.  All of this code\nshould not be included in the final Verilog.  The engineer can use three layers\nto do this."}),"\n",(0,o.jsx)(n.p,{children:"There are four layers that emerge from this example."}),"\n",(0,o.jsxs)(n.ol,{children:["\n",(0,o.jsxs)(n.li,{children:["The built-in ",(0,o.jsx)(n.code,{children:"Verification"})," layer"]}),"\n",(0,o.jsxs)(n.li,{children:["The built-in ",(0,o.jsx)(n.code,{children:"Assert"})," layer which is nested under the built-in ",(0,o.jsx)(n.code,{children:"Verification"}),"\nlayer"]}),"\n",(0,o.jsxs)(n.li,{children:["The built-in ",(0,o.jsx)(n.code,{children:"Cover"})," layer which is also nested under the built-in\n",(0,o.jsx)(n.code,{children:"Verification"})," layer"]}),"\n",(0,o.jsxs)(n.li,{children:["A user-defined ",(0,o.jsx)(n.code,{children:"Debug"})," layer"]}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["The ",(0,o.jsx)(n.code,{children:"Verification"})," layer can be used to store common logic used by both the\n",(0,o.jsx)(n.code,{children:"Assert"})," and ",(0,o.jsx)(n.code,{children:"Cover"})," layers.  The ",(0,o.jsx)(n.code,{children:"Assert"})," and ",(0,o.jsx)(n.code,{children:"Cover"})," layers contain,\nrespectively, assertions and cover statements.  The ",(0,o.jsx)(n.code,{children:"Debug"})," layer contains\ndebugging prints."]}),"\n",(0,o.jsx)(n.p,{children:"One way to write this in Scala is the following:"}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:'import chisel3._\nimport chisel3.layer.{Layer, LayerConfig, block}\nimport chisel3.layers.Verification\n\n// User-defined layers are declared here.  Built-in layers do not need to be declared.\nobject Debug extends Layer(LayerConfig.Extract())\n\nclass Foo extends Module {\n  val a = IO(Input(UInt(32.W)))\n  val b = IO(Output(UInt(32.W)))\n\n  b := a +% 1.U\n\n  // This adds a `Verification` layer block inside Foo.\n  block(Verification) {\n\n    // Some common logic added here.  The input port `a` is "captured" and\n    // used here.\n    val a_d0 = RegNext(a)\n\n    // This adds an `Assert` layer block.\n    block(Verification.Assert) {\n      chisel3.assert(a >= a_d0, "a must always increment")\n    }\n\n    // This adds a `Cover` layer block.\n    block(Verification.Cover) {\n      chisel3.cover(a === 8.U, "a_ took a value of 8")\n      chisel3.cover(a_d0 === 8.U, "a_d0 took a value of 8")\n    }\n\n  }\n\n  // This adds a `Debug` layer block.\n  block(Debug) {\n    printf("a: %x", a)\n  }\n\n}\n\n'})}),"\n",(0,o.jsx)(n.p,{children:"After compilation, this will produce three layer include files with the\nfollowing filenames.  One file is created for each layer:"}),"\n",(0,o.jsxs)(n.ol,{children:["\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.code,{children:"layers_Foo_Verification.sv"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.code,{children:"layers_Foo_Verification_Assert.sv"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.code,{children:"layers_Foo_Verification_Cover.sv"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.code,{children:"layers_Foo_Debug.sv"})}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["A user can then include any combination of these files in their design to\ninclude the optional functionality describe by the ",(0,o.jsx)(n.code,{children:"Verification"}),", ",(0,o.jsx)(n.code,{children:"Assert"}),",\n",(0,o.jsx)(n.code,{children:"Cover"}),", or ",(0,o.jsx)(n.code,{children:"Debug"})," layers.  The ",(0,o.jsx)(n.code,{children:"Assert"})," and ",(0,o.jsx)(n.code,{children:"Cover"})," bind files automatically\ninclude the ",(0,o.jsx)(n.code,{children:"Verification"})," bind file for the user."]}),"\n",(0,o.jsx)(n.h4,{id:"implementation-notes",children:"Implementation Notes"}),"\n",(0,o.jsx)(n.p,{children:(0,o.jsx)(n.em,{children:"Note: the names of the modules and the names of any files that contain these\nmodules are FIRRTL compiler implementation defined!  The only guarantee is the\nexistence of the three layer include files.  The information in this subsection\nis for informational purposes to aid understanding."})}),"\n",(0,o.jsxs)(n.p,{children:["In implementation, a FIRRTL compiler creates four Verilog modules for the\ncircuit above (one for ",(0,o.jsx)(n.code,{children:"Foo"})," and one for each layer block in module ",(0,o.jsx)(n.code,{children:"Foo"}),"):"]}),"\n",(0,o.jsxs)(n.ol,{children:["\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.code,{children:"Foo"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.code,{children:"Foo_Verification"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.code,{children:"Foo_Verification_Assert"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.code,{children:"Foo_Verification_Cover"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.code,{children:"Foo_Debug"})}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["These will typically be created in separate files with names that match the\nmodules, i.e., ",(0,o.jsx)(n.code,{children:"Foo.sv"}),", ",(0,o.jsx)(n.code,{children:"Foo_Verification.sv"}),", ",(0,o.jsx)(n.code,{children:"Foo_Verification_Assert.sv"}),",\n",(0,o.jsx)(n.code,{children:"Foo_Verification_Cover.sv"}),", and ",(0,o.jsx)(n.code,{children:"Foo_Debug.sv"}),"."]}),"\n",(0,o.jsxs)(n.p,{children:["The ports of each module created from a layer block will be automatically\ndetermined based on what that layer block captured from outside the layer block.\nIn the example above, the ",(0,o.jsx)(n.code,{children:"Verification"})," layer block captured port ",(0,o.jsx)(n.code,{children:"a"}),".  Both\nthe ",(0,o.jsx)(n.code,{children:"Assert"})," and ",(0,o.jsx)(n.code,{children:"Cover"})," layer blocks captured ",(0,o.jsx)(n.code,{children:"a"})," and ",(0,o.jsx)(n.code,{children:"a_d0"}),".  The ",(0,o.jsx)(n.code,{children:"Debug"}),"\nlayer only captured ",(0,o.jsx)(n.code,{children:"a"}),".  Layer blocks may be optimized to remove/add ports or\nto move logic into a layer block."]}),"\n",(0,o.jsx)(n.h4,{id:"verilog-output",children:"Verilog Output"}),"\n",(0,o.jsx)(n.p,{children:"The complete Verilog output for this example is reproduced below:"}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Foo(\n  input         clock,\n                reset,\n  input  [31:0] a,\n  output [31:0] b\n);\n\n  assign b = a + 32\'h1;\nendmodule\n\n\n// ----- 8< ----- FILE "Debug/layers_Foo_Verification_Debug.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Foo_Verification.sv"\n`ifndef layers_Foo_Verification_Debug\n`define layers_Foo_Verification_Debug\n`endif // layers_Foo_Verification_Debug\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Foo_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Foo_Verification.sv"\n`ifndef layers_Foo_Verification_Assume\n`define layers_Foo_Verification_Assume\n`endif // layers_Foo_Verification_Assume\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Foo_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Foo_Verification.sv"\n`ifndef layers_Foo_Verification_Cover\n`define layers_Foo_Verification_Cover\nbind Foo Foo_Verification_Cover verification_cover (\n  .a     (Foo.verification.a_probe_0),\n  .reset (reset),\n  .clock (Foo.verification.clock_probe_0),\n  .a_d0  (Foo.verification.a_d0_probe_0)\n);\n`endif // layers_Foo_Verification_Cover\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Foo_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Foo_Verification.sv"\n`ifndef layers_Foo_Verification_Assert\n`define layers_Foo_Verification_Assert\nbind Foo Foo_Verification_Assert verification_assert (\n  .a     (Foo.verification.a_probe),\n  .a_d0  (Foo.verification.a_d0_probe),\n  .reset (reset),\n  .clock (Foo.verification.clock_probe)\n);\n`endif // layers_Foo_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_Foo_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Foo_Verification\n`define layers_Foo_Verification\nbind Foo Foo_Verification verification (\n  .clock (clock),\n  .a     (a)\n);\n`endif // layers_Foo_Verification\n\n// ----- 8< ----- FILE "Verification/Assert/Foo_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n\n// Users can define \'STOP_COND\' to add an extra gate to stop conditions.\n`ifndef STOP_COND_\n  `ifdef STOP_COND\n    `define STOP_COND_ (`STOP_COND)\n  `else  // STOP_COND\n    `define STOP_COND_ 1\n  `endif // STOP_COND\n`endif // not def STOP_COND_\n\n// Users can define \'ASSERT_VERBOSE_COND\' to add an extra gate to assert error printing.\n`ifndef ASSERT_VERBOSE_COND_\n  `ifdef ASSERT_VERBOSE_COND\n    `define ASSERT_VERBOSE_COND_ (`ASSERT_VERBOSE_COND)\n  `else  // ASSERT_VERBOSE_COND\n    `define ASSERT_VERBOSE_COND_ 1\n  `endif // ASSERT_VERBOSE_COND\n`endif // not def ASSERT_VERBOSE_COND_\nmodule Foo_Verification_Assert(\n  input [31:0] a,\n               a_d0,\n  input        reset,\n               clock\n);\n\n  `ifndef SYNTHESIS\n    always @(posedge clock) begin\n      if (~reset & a < a_d0) begin\n        if (`ASSERT_VERBOSE_COND_)\n          $error("Assertion failed: a must always increment\\n");\n        if (`STOP_COND_)\n          $fatal;\n      end\n    end // always @(posedge)\n  `endif // not def SYNTHESIS\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/Foo_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\nmodule Foo_Verification_Cover(\n  input [31:0] a,\n  input        reset,\n               clock,\n  input [31:0] a_d0\n);\n\n  always @(posedge clock) begin\n    if (~reset) begin\n      cover__cover: cover(a == 32\'h8);\n      cover__cover_1: cover(a_d0 == 32\'h8);\n    end\n  end // always @(posedge)\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Foo_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\nmodule Foo_Verification(\n  input        clock,\n  input [31:0] a\n);\n\n  wire        clock_probe = clock;\n  wire [31:0] a_probe = a;\n  wire        clock_probe_0 = clock;\n  wire [31:0] a_probe_0 = a;\n  reg  [31:0] a_d0;\n  wire [31:0] a_d0_probe = a_d0;\n  wire [31:0] a_d0_probe_0 = a_d0;\n  always @(posedge clock)\n    a_d0 <= a;\nendmodule\n\n\n// ----- 8< ----- FILE "Debug/Foo_Debug.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n\n// Users can define \'PRINTF_COND\' to add an extra gate to prints.\n`ifndef PRINTF_COND_\n  `ifdef PRINTF_COND\n    `define PRINTF_COND_ (`PRINTF_COND)\n  `else  // PRINTF_COND\n    `define PRINTF_COND_ 1\n  `endif // PRINTF_COND\n`endif // not def PRINTF_COND_\nmodule Foo_Debug(\n  input        reset,\n               clock,\n  input [31:0] a\n);\n\n  `ifndef SYNTHESIS\n    always @(posedge clock) begin\n      if ((`PRINTF_COND_) & ~reset)\n        $fwrite(32\'h80000002, "a: %x", a);\n    end // always @(posedge)\n  `endif // not def SYNTHESIS\nendmodule\n\n\n// ----- 8< ----- FILE "Debug/layers_Foo_Debug.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\nbind Foo Foo_Debug debug (\n  .reset (reset),\n  .clock (clock),\n  .a     (a)\n);\n'})})]})}function h(e={}){const{wrapper:n}={...(0,r.R)(),...e.components};return n?(0,o.jsx)(n,{...e,children:(0,o.jsx)(d,{...e})}):d(e)}},8453:(e,n,i)=>{i.d(n,{R:()=>a,x:()=>l});var o=i(6540);const r={},s=o.createContext(r);function a(e){const n=o.useContext(s);return o.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function l(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(r):e.components||r:a(e.components),o.createElement(s.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/c7666d49.3ed48610.js b/assets/js/c7666d49.3ed48610.js
deleted file mode 100644
index 4fed5c7e3e..0000000000
--- a/assets/js/c7666d49.3ed48610.js
+++ /dev/null
@@ -1 +0,0 @@
-"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[6474],{361:(e,n,i)=>{i.r(n),i.d(n,{assets:()=>l,contentTitle:()=>s,default:()=>h,frontMatter:()=>a,metadata:()=>t,toc:()=>c});var o=i(4848),r=i(8453);const a={layout:"docs",title:"Layers",section:"chisel3"},s="Layers",t={id:"explanations/layers",title:"Layers",description:"Layers are used to describe functionality of a Chisel circuit or module that a",source:"@site/docs/explanations/layers.md",sourceDirName:"explanations",slug:"/explanations/layers",permalink:"/docs/explanations/layers",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/layers.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Layers",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Intrinsics",permalink:"/docs/explanations/intrinsics"},next:{title:"Memories",permalink:"/docs/explanations/memories"}},l={},c=[{value:"Conventions",id:"conventions",level:2},{value:"Examples",id:"examples",level:2},{value:"Design Verification Example",id:"design-verification-example",level:3},{value:"Implementation Notes",id:"implementation-notes",level:4},{value:"Verilog Output",id:"verilog-output",level:4}];function d(e){const n={code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",h4:"h4",li:"li",ol:"ol",p:"p",pre:"pre",...(0,r.R)(),...e.components};return(0,o.jsxs)(o.Fragment,{children:[(0,o.jsx)(n.h1,{id:"layers",children:"Layers"}),"\n",(0,o.jsxs)(n.p,{children:["Layers are used to describe functionality of a Chisel circuit or module that a\nuser would like to ",(0,o.jsx)(n.em,{children:"optionally"})," include at Verilog elaboration time.  This\nfeature is intended to be used to optionally include verification or debug logic\nthat a user does not want to always have present."]}),"\n",(0,o.jsx)(n.p,{children:"Each layer is broken into two pieces:"}),"\n",(0,o.jsxs)(n.ol,{children:["\n",(0,o.jsxs)(n.li,{children:["A layer ",(0,o.jsx)(n.em,{children:"declaration"})]}),"\n",(0,o.jsxs)(n.li,{children:["One or more ",(0,o.jsx)(n.em,{children:"layer blocks"})," inside modules in the circuit"]}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["There are two kinds of layers, each kind is lowered to verilog under a different\n",(0,o.jsx)(n.em,{children:"convention"}),". The kinds of layers are:"]}),"\n",(0,o.jsxs)(n.ol,{children:["\n",(0,o.jsx)(n.li,{children:'"Extract" Layers: layers whose blocks are lowered to bound-in modules, and'}),"\n",(0,o.jsx)(n.li,{children:'"Inline" Layers: layers whose blocks are lowered to ifdefs macros.'}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["To declare a layer, create a singleton ",(0,o.jsx)(n.code,{children:"object"})," in scala that extends the"]}),"\n",(0,o.jsxs)(n.p,{children:["extend the abstract class ",(0,o.jsx)(n.code,{children:"chisel3.layer.Layer"}),", passing into the layer\nconstructor either ",(0,o.jsx)(n.code,{children:"chisel3.layer.LayerConfig.Extract()"}),' for an "extract" layer,\nor ',(0,o.jsx)(n.code,{children:"chisel3.layer.LayerConfig.Inline"}),' for "inline" layers.']}),"\n",(0,o.jsxs)(n.p,{children:["Layers may be nested. To declare a nested layer, extend the\n",(0,o.jsx)(n.code,{children:"chisel3.layer.Layer"})," abstract class inside another declaration."]}),"\n",(0,o.jsx)(n.p,{children:"The following example declares four layers:"}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"import chisel3.layer.{Layer, LayerConfig}\n\nobject A extends Layer(LayerConfig.Extract()) {\n  object B extends Layer(LayerConfig.Extract()) {\n    object C extends Layer(LayerConfig.Extract())\n  }\n  object D extends Layer(LayerConfig.Extract())\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["A ",(0,o.jsx)(n.em,{children:"layer block"}),", associated with a layer, adds optional functionality to a\nmodule that is enabled if that layer is enabled.  Each layer block must refer to\na pre-declared layer.  Layer block nesting must match the nesting of declared\nlayers."]}),"\n",(0,o.jsxs)(n.p,{children:["To define a layer block, use the ",(0,o.jsx)(n.code,{children:"chisel3.layer.block"})," inside a Chisel module.\nAn layer block may use any Chisel or Scala value visible to its Scala lexical\nscope."]}),"\n",(0,o.jsxs)(n.p,{children:["The following example defines layer blocks inside module ",(0,o.jsx)(n.code,{children:"Foo"})," and declares\nwires which are connected to values captured from visible lexical scope:"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.layer.block\n\nclass Foo extends RawModule {\n  val port = IO(Input(Bool()))\n\n  block(A) {\n    val a = WireInit(port)\n    block(A.B) {\n      val b = WireInit(a)\n      block(A.B.C) {\n        val c = WireInit(b)\n      }\n    }\n    block(A.D) {\n      val d = WireInit(port ^ a)\n    }\n  }\n}\n"})}),"\n",(0,o.jsx)(n.h2,{id:"conventions",children:"Conventions"}),"\n",(0,o.jsxs)(n.p,{children:["Currently, there is only one supported convention, ",(0,o.jsx)(n.code,{children:"Bind"}),".  This will cause layer\nblocks to be lowered to Verilog modules that are instantiated via the\nSystemVerilog ",(0,o.jsx)(n.code,{children:"bind"})," mechanism.  The lowering to Verilog of layer blocks avoids\nillegal nested usage of ",(0,o.jsx)(n.code,{children:"bind"}),"."]}),"\n",(0,o.jsx)(n.p,{children:"More conventions may be supported in the future."}),"\n",(0,o.jsx)(n.h2,{id:"examples",children:"Examples"}),"\n",(0,o.jsx)(n.h3,{id:"design-verification-example",children:"Design Verification Example"}),"\n",(0,o.jsx)(n.p,{children:"Consider a use case where a design or design verification engineer would like to\nadd some asserts and debug prints to a module.  The logic necessary for the\nasserts and debug prints requires additional computation.  All of this code\nshould not be included in the final Verilog.  The engineer can use three layers\nto do this."}),"\n",(0,o.jsx)(n.p,{children:"There are three layers that emerge from this example:"}),"\n",(0,o.jsxs)(n.ol,{children:["\n",(0,o.jsxs)(n.li,{children:["A common ",(0,o.jsx)(n.code,{children:"Verification"})," layer"]}),"\n",(0,o.jsxs)(n.li,{children:["An ",(0,o.jsx)(n.code,{children:"Assert"})," layer nested under the ",(0,o.jsx)(n.code,{children:"Verification"})," layer"]}),"\n",(0,o.jsxs)(n.li,{children:["A ",(0,o.jsx)(n.code,{children:"Debug"})," layer also nested under the ",(0,o.jsx)(n.code,{children:"Verification"})," layer"]}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["The ",(0,o.jsx)(n.code,{children:"Verification"})," layer can be used to store common logic used by both the\n",(0,o.jsx)(n.code,{children:"Assert"})," and ",(0,o.jsx)(n.code,{children:"Debug"})," layers.  The latter two layers allow for separation of,\nrespectively, assertions from prints."]}),"\n",(0,o.jsx)(n.p,{children:"One way to write this in Scala is the following:"}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:'import chisel3._\nimport chisel3.layer.{Layer, LayerConfig, block}\n\n// All layers are declared here.  The Assert and Debug layers are nested under\n// the Verification layer.\nobject Verification extends Layer(LayerConfig.Extract()) {\n  object Assert extends Layer(LayerConfig.Extract())\n  object Debug extends Layer(LayerConfig.Extract())\n}\n\nclass Foo extends Module {\n  val a = IO(Input(UInt(32.W)))\n  val b = IO(Output(UInt(32.W)))\n\n  b := a +% 1.U\n\n  // This adds a `Verification` layer block inside Foo.\n  block(Verification) {\n\n    // Some common logic added here.  The input port `a` is "captured" and\n    // used here.\n    val a_d0 = RegNext(a)\n\n    // This adds an `Assert` layer block.\n    block(Verification.Assert) {\n      chisel3.assert(a >= a_d0, "a must always increment")\n    }\n\n    // This adds a `Debug` layer block.\n    block(Verification.Debug) {\n      printf("a: %x, a_d0: %x", a, a_d0)\n    }\n  }\n\n}\n\n'})}),"\n",(0,o.jsx)(n.p,{children:"After compilation, this will produce three layer include files with the\nfollowing filenames.  One file is created for each layer:"}),"\n",(0,o.jsxs)(n.ol,{children:["\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.code,{children:"layers_Foo_Verification.sv"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.code,{children:"layers_Foo_Verification_Assert.sv"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.code,{children:"layers_Foo_Verification_Debug.sv"})}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["A user can then include any combination of these files in their design to\ninclude the optional functionality describe by the ",(0,o.jsx)(n.code,{children:"Verification"}),", ",(0,o.jsx)(n.code,{children:"Assert"}),", or\n",(0,o.jsx)(n.code,{children:"Debug"})," layers.  The ",(0,o.jsx)(n.code,{children:"Assert"})," and ",(0,o.jsx)(n.code,{children:"Debug"})," bind files automatically include the\n",(0,o.jsx)(n.code,{children:"Verification"})," bind file for the user."]}),"\n",(0,o.jsx)(n.h4,{id:"implementation-notes",children:"Implementation Notes"}),"\n",(0,o.jsx)(n.p,{children:(0,o.jsx)(n.em,{children:"Note: the names of the modules and the names of any files that contain these\nmodules are FIRRTL compiler implementation defined!  The only guarantee is the\nexistence of the three layer include files.  The information in this subsection\nis for informational purposes to aid understanding."})}),"\n",(0,o.jsxs)(n.p,{children:["In implementation, a FIRRTL compiler creates four Verilog modules for the\ncircuit above (one for ",(0,o.jsx)(n.code,{children:"Foo"})," and one for each layer block in module ",(0,o.jsx)(n.code,{children:"Foo"}),"):"]}),"\n",(0,o.jsxs)(n.ol,{children:["\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.code,{children:"Foo"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.code,{children:"Foo_Verification"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.code,{children:"Foo_Verification_Assert"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.code,{children:"Foo_Verification_Debug"})}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["These will typically be created in separate files with names that match the\nmodules, i.e., ",(0,o.jsx)(n.code,{children:"Foo.sv"}),", ",(0,o.jsx)(n.code,{children:"Foo_Verification.sv"}),", ",(0,o.jsx)(n.code,{children:"Foo_Verification_Assert.sv"}),",\nand ",(0,o.jsx)(n.code,{children:"Foo_Verification_Debug.sv"}),"."]}),"\n",(0,o.jsxs)(n.p,{children:["The ports of each module created from a layer block will be automatically\ndetermined based on what that layer block captured from outside the layer block.\nIn the example above, the ",(0,o.jsx)(n.code,{children:"Verification"})," layer block captured port ",(0,o.jsx)(n.code,{children:"a"}),".  Both\nthe ",(0,o.jsx)(n.code,{children:"Assert"})," and ",(0,o.jsx)(n.code,{children:"Debug"})," layer blocks captured ",(0,o.jsx)(n.code,{children:"a"})," and ",(0,o.jsx)(n.code,{children:"a_d0"}),".  Layer blocks may\nbe optimized to remove/add ports or to move logic into a layer block."]}),"\n",(0,o.jsx)(n.h4,{id:"verilog-output",children:"Verilog Output"}),"\n",(0,o.jsx)(n.p,{children:"The complete Verilog output for this example is reproduced below:"}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Foo(\n  input         clock,\n                reset,\n  input  [31:0] a,\n  output [31:0] b\n);\n\n  assign b = a + 32\'h1;\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Debug/layers_Foo_Verification_Debug.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Foo_Verification.sv"\n`ifndef layers_Foo_Verification_Debug\n`define layers_Foo_Verification_Debug\nbind Foo Foo_Verification_Debug verification_debug (\n  .reset (reset),\n  .clock (Foo.verification.clock_probe_0),\n  .a     (Foo.verification.a_probe_0),\n  .a_d0  (Foo.verification.a_d0_probe_0)\n);\n`endif // layers_Foo_Verification_Debug\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Foo_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Foo_Verification.sv"\n`ifndef layers_Foo_Verification_Assert\n`define layers_Foo_Verification_Assert\nbind Foo Foo_Verification_Assert verification_assert (\n  .a     (Foo.verification.a_probe),\n  .a_d0  (Foo.verification.a_d0_probe),\n  .reset (reset),\n  .clock (Foo.verification.clock_probe)\n);\n`endif // layers_Foo_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_Foo_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Foo_Verification\n`define layers_Foo_Verification\nbind Foo Foo_Verification verification (\n  .clock (clock),\n  .a     (a)\n);\n`endif // layers_Foo_Verification\n\n// ----- 8< ----- FILE "Verification/Assert/Foo_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n\n// Users can define \'STOP_COND\' to add an extra gate to stop conditions.\n`ifndef STOP_COND_\n  `ifdef STOP_COND\n    `define STOP_COND_ (`STOP_COND)\n  `else  // STOP_COND\n    `define STOP_COND_ 1\n  `endif // STOP_COND\n`endif // not def STOP_COND_\n\n// Users can define \'ASSERT_VERBOSE_COND\' to add an extra gate to assert error printing.\n`ifndef ASSERT_VERBOSE_COND_\n  `ifdef ASSERT_VERBOSE_COND\n    `define ASSERT_VERBOSE_COND_ (`ASSERT_VERBOSE_COND)\n  `else  // ASSERT_VERBOSE_COND\n    `define ASSERT_VERBOSE_COND_ 1\n  `endif // ASSERT_VERBOSE_COND\n`endif // not def ASSERT_VERBOSE_COND_\nmodule Foo_Verification_Assert(\n  input [31:0] a,\n               a_d0,\n  input        reset,\n               clock\n);\n\n  `ifndef SYNTHESIS\n    always @(posedge clock) begin\n      if (~reset & a < a_d0) begin\n        if (`ASSERT_VERBOSE_COND_)\n          $error("Assertion failed: a must always increment\\n");\n        if (`STOP_COND_)\n          $fatal;\n      end\n    end // always @(posedge)\n  `endif // not def SYNTHESIS\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Debug/Foo_Verification_Debug.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n\n// Users can define \'PRINTF_COND\' to add an extra gate to prints.\n`ifndef PRINTF_COND_\n  `ifdef PRINTF_COND\n    `define PRINTF_COND_ (`PRINTF_COND)\n  `else  // PRINTF_COND\n    `define PRINTF_COND_ 1\n  `endif // PRINTF_COND\n`endif // not def PRINTF_COND_\nmodule Foo_Verification_Debug(\n  input        reset,\n               clock,\n  input [31:0] a,\n               a_d0\n);\n\n  `ifndef SYNTHESIS\n    always @(posedge clock) begin\n      if ((`PRINTF_COND_) & ~reset)\n        $fwrite(32\'h80000002, "a: %x, a_d0: %x", a, a_d0);\n    end // always @(posedge)\n  `endif // not def SYNTHESIS\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Foo_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\nmodule Foo_Verification(\n  input        clock,\n  input [31:0] a\n);\n\n  wire        clock_probe = clock;\n  wire [31:0] a_probe = a;\n  wire [31:0] a_probe_0 = a;\n  wire        clock_probe_0 = clock;\n  reg  [31:0] a_d0;\n  wire [31:0] a_d0_probe = a_d0;\n  wire [31:0] a_d0_probe_0 = a_d0;\n  always @(posedge clock)\n    a_d0 <= a;\nendmodule\n\n'})})]})}function h(e={}){const{wrapper:n}={...(0,r.R)(),...e.components};return n?(0,o.jsx)(n,{...e,children:(0,o.jsx)(d,{...e})}):d(e)}},8453:(e,n,i)=>{i.d(n,{R:()=>s,x:()=>t});var o=i(6540);const r={},a=o.createContext(r);function s(e){const n=o.useContext(a);return o.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function t(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(r):e.components||r:s(e.components),o.createElement(a.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/cdcdfbab.733b373f.js b/assets/js/cdcdfbab.733b373f.js
new file mode 100644
index 0000000000..433442dd91
--- /dev/null
+++ b/assets/js/cdcdfbab.733b373f.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[5522],{2175:(e,n,l)=>{l.r(n),l.d(n,{assets:()=>o,contentTitle:()=>t,default:()=>d,frontMatter:()=>a,metadata:()=>c,toc:()=>u});var s=l(4848),i=l(8453);const a={layout:"docs",title:"Enumerations",section:"chisel3"},t="ChiselEnum",c={id:"explanations/chisel-enum",title:"Enumerations",description:"The ChiselEnum type can be used to reduce the chance of error when encoding mux selectors, opcodes, and functional unit operations.",source:"@site/docs/explanations/chisel-enum.md",sourceDirName:"explanations",slug:"/explanations/chisel-enum",permalink:"/docs/explanations/chisel-enum",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/chisel-enum.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Enumerations",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Bundles and Vecs",permalink:"/docs/explanations/bundles-and-vecs"},next:{title:"Chisel Type vs Scala Type",permalink:"/docs/explanations/chisel-type-vs-scala-type"}},o={},u=[{value:"Functionality and Examples",id:"functionality-and-examples",level:2},{value:"Casting",id:"casting",level:2},{value:"Testing",id:"testing",level:2},{value:"Workarounds",id:"workarounds",level:2},{value:"Additional Resources",id:"additional-resources",level:2}];function r(e){const n={a:"a",code:"code",em:"em",h1:"h1",h2:"h2",li:"li",p:"p",pre:"pre",ul:"ul",...(0,i.R)(),...e.components};return(0,s.jsxs)(s.Fragment,{children:[(0,s.jsx)(n.h1,{id:"chiselenum",children:"ChiselEnum"}),"\n",(0,s.jsxs)(n.p,{children:["The ChiselEnum type can be used to reduce the chance of error when encoding mux selectors, opcodes, and functional unit operations.\nIn contrast with ",(0,s.jsx)(n.code,{children:"Chisel.util.Enum"}),", ",(0,s.jsx)(n.code,{children:"ChiselEnum"})," are subclasses of ",(0,s.jsx)(n.code,{children:"Data"}),", which means that they can be used to define fields in ",(0,s.jsx)(n.code,{children:"Bundle"}),"s, including in ",(0,s.jsx)(n.code,{children:"IO"}),"s."]}),"\n",(0,s.jsx)(n.h2,{id:"functionality-and-examples",children:"Functionality and Examples"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"// Imports used in the following examples\nimport circt.stage.ChiselStage\nimport chisel3._\nimport chisel3.util._\n"})}),"\n",(0,s.jsx)(n.p,{children:"Below we see ChiselEnum being used as mux select for a RISC-V core. While wrapping the object in a package is not required, it is highly recommended as it allows for the type to be used in multiple files more easily."}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"// package CPUTypes {\nobject AluMux1Sel extends ChiselEnum {\n  val selectRS1, selectPC = Value\n}\n// We can see the mapping by printing each Value\nAluMux1Sel.all.foreach(println)\n// AluMux1Sel(0=selectRS1)\n// AluMux1Sel(1=selectPC)\n"})}),"\n",(0,s.jsx)(n.p,{children:"Here we see a mux using the AluMux1Sel to select between different inputs."}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"import AluMux1Sel._\n\nclass AluMux1Bundle extends Bundle {\n  val aluMux1Sel = Input(AluMux1Sel())\n  val rs1Out     = Input(Bits(32.W))\n  val pcOut      = Input(Bits(32.W))\n  val aluMux1Out = Output(Bits(32.W))\n}\n\nclass AluMux1File extends Module {\n  val io = IO(new AluMux1Bundle)\n\n  // Default value for aluMux1Out\n  io.aluMux1Out := 0.U\n\n  switch (io.aluMux1Sel) {\n    is (selectRS1) {\n      io.aluMux1Out := io.rs1Out\n    }\n    is (selectPC) {\n      io.aluMux1Out := io.pcOut\n    }\n  }\n}\n"})}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule AluMux1File(\t// chisel-enum.md:62:7\n  input         clock,\t// chisel-enum.md:62:7\n                reset,\t// chisel-enum.md:62:7\n                io_aluMux1Sel,\t// chisel-enum.md:63:14\n  input  [31:0] io_rs1Out,\t// chisel-enum.md:63:14\n                io_pcOut,\t// chisel-enum.md:63:14\n  output [31:0] io_aluMux1Out\t// chisel-enum.md:63:14\n);\n\n  assign io_aluMux1Out = io_aluMux1Sel ? io_pcOut : io_rs1Out;\t// chisel-enum.md:62:7, :68:26, :70:21\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_AluMux1File_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_AluMux1File_Verification.sv"\n`ifndef layers_AluMux1File_Verification_Cover\n`define layers_AluMux1File_Verification_Cover\t// <stdin>:20:5\n`endif // layers_AluMux1File_Verification_Cover\t// <stdin>:20:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_AluMux1File_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_AluMux1File_Verification.sv"\n`ifndef layers_AluMux1File_Verification_Assume\n`define layers_AluMux1File_Verification_Assume\t// <stdin>:19:5\n`endif // layers_AluMux1File_Verification_Assume\t// <stdin>:19:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_AluMux1File_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_AluMux1File_Verification.sv"\n`ifndef layers_AluMux1File_Verification_Assert\n`define layers_AluMux1File_Verification_Assert\t// <stdin>:18:5\n`endif // layers_AluMux1File_Verification_Assert\t// <stdin>:18:5\n\n// ----- 8< ----- FILE "Verification/layers_AluMux1File_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_AluMux1File_Verification\n`define layers_AluMux1File_Verification\t// <stdin>:17:3\n`endif // layers_AluMux1File_Verification\t// <stdin>:17:3\n'})}),"\n",(0,s.jsxs)(n.p,{children:["ChiselEnum also allows for the user to directly set the Values by passing an ",(0,s.jsx)(n.code,{children:"UInt"})," to ",(0,s.jsx)(n.code,{children:"Value(...)"}),"\nas shown below. Note that the magnitude of each ",(0,s.jsx)(n.code,{children:"Value"})," must be strictly greater than the one before\nit."]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:'object Opcode extends ChiselEnum {\n    val load  = Value(0x03.U) // i "load"  -> 000_0011\n    val imm   = Value(0x13.U) // i "imm"   -> 001_0011\n    val auipc = Value(0x17.U) // u "auipc" -> 001_0111\n    val store = Value(0x23.U) // s "store" -> 010_0011\n    val reg   = Value(0x33.U) // r "reg"   -> 011_0011\n    val lui   = Value(0x37.U) // u "lui"   -> 011_0111\n    val br    = Value(0x63.U) // b "br"    -> 110_0011\n    val jalr  = Value(0x67.U) // i "jalr"  -> 110_0111\n    val jal   = Value(0x6F.U) // j "jal"   -> 110_1111\n}\n'})}),"\n",(0,s.jsx)(n.p,{children:"The user can 'jump' to a value and continue incrementing by passing a start point then using a regular Value definition."}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"object BranchFunct3 extends ChiselEnum {\n    val beq, bne = Value\n    val blt = Value(4.U)\n    val bge, bltu, bgeu = Value\n}\n// We can see the mapping by printing each Value\nBranchFunct3.all.foreach(println)\n// BranchFunct3(0=beq)\n// BranchFunct3(1=bne)\n// BranchFunct3(4=blt)\n// BranchFunct3(5=bge)\n// BranchFunct3(6=bltu)\n// BranchFunct3(7=bgeu)\n"})}),"\n",(0,s.jsx)(n.h2,{id:"casting",children:"Casting"}),"\n",(0,s.jsxs)(n.p,{children:["You can cast an enum to a ",(0,s.jsx)(n.code,{children:"UInt"})," using ",(0,s.jsx)(n.code,{children:".asUInt"}),":"]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"class ToUInt extends RawModule {\n  val in = IO(Input(Opcode()))\n  val out = IO(Output(UInt(in.getWidth.W)))\n  out := in.asUInt\n}\n"})}),"\n",(0,s.jsxs)(n.p,{children:["You can cast from a ",(0,s.jsx)(n.code,{children:"UInt"})," to an enum by passing the ",(0,s.jsx)(n.code,{children:"UInt"})," to the apply method of the ",(0,s.jsx)(n.code,{children:"ChiselEnum"})," object:"]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"class FromUInt extends Module {\n  val in = IO(Input(UInt(7.W)))\n  val out = IO(Output(Opcode()))\n  out := Opcode(in)\n}\n"})}),"\n",(0,s.jsxs)(n.p,{children:["However, if you cast from a ",(0,s.jsx)(n.code,{children:"UInt"})," to an Enum type when there are undefined states in the Enum values\nthat the ",(0,s.jsx)(n.code,{children:"UInt"})," could hit, you will see a warning like the following:"]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{children:"[warn] chisel-enum.md 136:16: [W001] Casting non-literal UInt to repl.MdocSession$MdocApp$Opcode. You can use repl.MdocSession$MdocApp$Opcode.safe to cast without this warning.\n[warn] There were 1 warning(s) during hardware elaboration.\n"})}),"\n",(0,s.jsx)(n.p,{children:"(Note that the name of the Enum is ugly as an artifact of our documentation generation flow, it will\nbe cleaner in normal use)."}),"\n",(0,s.jsxs)(n.p,{children:["You can avoid this warning by using the ",(0,s.jsx)(n.code,{children:".safe"})," factory method which returns the cast Enum in addition\nto a ",(0,s.jsx)(n.code,{children:"Bool"})," indicating if the Enum is in a valid state:"]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:'class SafeFromUInt extends Module {\n  val in = IO(Input(UInt(7.W)))\n  val out = IO(Output(Opcode()))\n  val (value, valid) = Opcode.safe(in)\n  assert(valid, "Enum state must be valid, got %d!", in)\n  out := value\n}\n'})}),"\n",(0,s.jsx)(n.p,{children:"Now there will be no warning:"}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{})}),"\n",(0,s.jsxs)(n.p,{children:["You can also suppress the warning by using ",(0,s.jsx)(n.code,{children:"suppressEnumCastWarning"}),". This is\nprimarily used for casting from [[UInt]] to a Bundle type that contains an\nEnum, where the [[UInt]] is known to be valid for the Bundle type."]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"class MyBundle extends Bundle {\n  val addr = UInt(8.W)\n  val op = Opcode()\n}\n\nclass SuppressedFromUInt extends Module {\n  val in = IO(Input(UInt(15.W)))\n  val out = IO(Output(new MyBundle()))\n  suppressEnumCastWarning {\n    out := in.asTypeOf(new MyBundle)\n  }\n}\n"})}),"\n",(0,s.jsx)(n.h2,{id:"testing",children:"Testing"}),"\n",(0,s.jsxs)(n.p,{children:["The ",(0,s.jsx)(n.em,{children:"Type"})," of the enums values is ",(0,s.jsx)(n.code,{children:"<ChiselEnum Object>.Type"})," which can be useful for passing the values\nas parameters to a function (or any other time a type annotation is needed).\nCalling ",(0,s.jsx)(n.code,{children:".litValue"})," on an enum value will return the integer value of that object as a\n",(0,s.jsx)(n.a,{href:"https://www.scala-lang.org/api/2.12.13/scala/math/BigInt.html",children:(0,s.jsx)(n.code,{children:"BigInt"})}),"."]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"def expectedSel(sel: AluMux1Sel.Type): Boolean = sel match {\n  case AluMux1Sel.selectRS1 => (sel.litValue == 0)\n  case AluMux1Sel.selectPC  => (sel.litValue == 1)\n  case _                    => false\n}\n"})}),"\n",(0,s.jsxs)(n.p,{children:["The enum value type also defines some convenience methods for working with ",(0,s.jsx)(n.code,{children:"ChiselEnum"})," values. For example, continuing with the RISC-V opcode\nexample, one could easily create hardware signal that is only asserted on LOAD/STORE operations (when the enum value is equal to ",(0,s.jsx)(n.code,{children:"Opcode.load"}),"\nor ",(0,s.jsx)(n.code,{children:"Opcode.store"}),") using the ",(0,s.jsx)(n.code,{children:".isOneOf"})," method:"]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"class LoadStoreExample extends Module {\n  val io = IO(new Bundle {\n    val opcode = Input(Opcode())\n    val load_or_store = Output(Bool())\n  })\n  io.load_or_store := io.opcode.isOneOf(Opcode.load, Opcode.store)\n}\n"})}),"\n",(0,s.jsxs)(n.p,{children:["Some additional useful methods defined on the ",(0,s.jsx)(n.code,{children:"ChiselEnum"})," object are:"]}),"\n",(0,s.jsxs)(n.ul,{children:["\n",(0,s.jsxs)(n.li,{children:[(0,s.jsx)(n.code,{children:".all"}),": returns the enum values within the enumeration"]}),"\n",(0,s.jsxs)(n.li,{children:[(0,s.jsx)(n.code,{children:".getWidth"}),": returns the width of the hardware type"]}),"\n"]}),"\n",(0,s.jsx)(n.h2,{id:"workarounds",children:"Workarounds"}),"\n",(0,s.jsxs)(n.p,{children:["As of Chisel v3.4.3 (1 July 2020), the width of the values is always inferred.\nTo work around this, you can add an extra ",(0,s.jsx)(n.code,{children:"Value"})," that forces the width that is desired.\nThis is shown in the example below, where we add a field ",(0,s.jsx)(n.code,{children:"ukn"})," to force the width to be 3 bits wide:"]}),"\n",(0,s.jsx)(n.pre,{children:(0,s.jsx)(n.code,{className:"language-scala",children:"object StoreFunct3 extends ChiselEnum {\n    val sb, sh, sw = Value\n    val ukn = Value(7.U)\n}\n// We can see the mapping by printing each Value\nStoreFunct3.all.foreach(println)\n// StoreFunct3(0=sb)\n// StoreFunct3(1=sh)\n// StoreFunct3(2=sw)\n// StoreFunct3(7=ukn)\n"})}),"\n",(0,s.jsxs)(n.p,{children:["Signed values are not supported so if you want the value signed, you must cast the UInt with ",(0,s.jsx)(n.code,{children:".asSInt"}),"."]}),"\n",(0,s.jsx)(n.h2,{id:"additional-resources",children:"Additional Resources"}),"\n",(0,s.jsxs)(n.p,{children:["The ChiselEnum type is much more powerful than stated above. It allows for Sequence, Vec, and Bundle assignments, as well as a ",(0,s.jsx)(n.code,{children:".next"})," operation to allow for stepping through sequential states and an ",(0,s.jsx)(n.code,{children:".isValid"})," for checking that a hardware value is a valid ",(0,s.jsx)(n.code,{children:"Value"}),". The source code for the ChiselEnum can be found ",(0,s.jsx)(n.a,{href:"https://github.com/chipsalliance/chisel3/blob/2a96767097264eade18ff26e1d8bce192383a190/core/src/main/scala/chisel3/StrongEnum.scala",children:"here"})," in the class ",(0,s.jsx)(n.code,{children:"EnumFactory"}),". Examples of the ChiselEnum operations can be found ",(0,s.jsx)(n.a,{href:"https://github.com/chipsalliance/chisel3/blob/dd6871b8b3f2619178c2a333d9d6083805d99e16/src/test/scala/chiselTests/StrongEnum.scala",children:"here"}),"."]})]})}function d(e={}){const{wrapper:n}={...(0,i.R)(),...e.components};return n?(0,s.jsx)(n,{...e,children:(0,s.jsx)(r,{...e})}):r(e)}},8453:(e,n,l)=>{l.d(n,{R:()=>t,x:()=>c});var s=l(6540);const i={},a=s.createContext(i);function t(e){const n=s.useContext(a);return s.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function c(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(i):e.components||i:t(e.components),s.createElement(a.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/cdcdfbab.eaeb3d96.js b/assets/js/cdcdfbab.eaeb3d96.js
deleted file mode 100644
index dae9199593..0000000000
--- a/assets/js/cdcdfbab.eaeb3d96.js
+++ /dev/null
@@ -1 +0,0 @@
-"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[5522],{2175:(e,n,s)=>{s.r(n),s.d(n,{assets:()=>o,contentTitle:()=>i,default:()=>d,frontMatter:()=>t,metadata:()=>c,toc:()=>u});var l=s(4848),a=s(8453);const t={layout:"docs",title:"Enumerations",section:"chisel3"},i="ChiselEnum",c={id:"explanations/chisel-enum",title:"Enumerations",description:"The ChiselEnum type can be used to reduce the chance of error when encoding mux selectors, opcodes, and functional unit operations.",source:"@site/docs/explanations/chisel-enum.md",sourceDirName:"explanations",slug:"/explanations/chisel-enum",permalink:"/docs/explanations/chisel-enum",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/chisel-enum.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Enumerations",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Bundles and Vecs",permalink:"/docs/explanations/bundles-and-vecs"},next:{title:"Chisel Type vs Scala Type",permalink:"/docs/explanations/chisel-type-vs-scala-type"}},o={},u=[{value:"Functionality and Examples",id:"functionality-and-examples",level:2},{value:"Casting",id:"casting",level:2},{value:"Testing",id:"testing",level:2},{value:"Workarounds",id:"workarounds",level:2},{value:"Additional Resources",id:"additional-resources",level:2}];function r(e){const n={a:"a",code:"code",em:"em",h1:"h1",h2:"h2",li:"li",p:"p",pre:"pre",ul:"ul",...(0,a.R)(),...e.components};return(0,l.jsxs)(l.Fragment,{children:[(0,l.jsx)(n.h1,{id:"chiselenum",children:"ChiselEnum"}),"\n",(0,l.jsxs)(n.p,{children:["The ChiselEnum type can be used to reduce the chance of error when encoding mux selectors, opcodes, and functional unit operations.\nIn contrast with ",(0,l.jsx)(n.code,{children:"Chisel.util.Enum"}),", ",(0,l.jsx)(n.code,{children:"ChiselEnum"})," are subclasses of ",(0,l.jsx)(n.code,{children:"Data"}),", which means that they can be used to define fields in ",(0,l.jsx)(n.code,{children:"Bundle"}),"s, including in ",(0,l.jsx)(n.code,{children:"IO"}),"s."]}),"\n",(0,l.jsx)(n.h2,{id:"functionality-and-examples",children:"Functionality and Examples"}),"\n",(0,l.jsx)(n.pre,{children:(0,l.jsx)(n.code,{className:"language-scala",children:"// Imports used in the following examples\nimport circt.stage.ChiselStage\nimport chisel3._\nimport chisel3.util._\n"})}),"\n",(0,l.jsx)(n.p,{children:"Below we see ChiselEnum being used as mux select for a RISC-V core. While wrapping the object in a package is not required, it is highly recommended as it allows for the type to be used in multiple files more easily."}),"\n",(0,l.jsx)(n.pre,{children:(0,l.jsx)(n.code,{className:"language-scala",children:"// package CPUTypes {\nobject AluMux1Sel extends ChiselEnum {\n  val selectRS1, selectPC = Value\n}\n// We can see the mapping by printing each Value\nAluMux1Sel.all.foreach(println)\n// AluMux1Sel(0=selectRS1)\n// AluMux1Sel(1=selectPC)\n"})}),"\n",(0,l.jsx)(n.p,{children:"Here we see a mux using the AluMux1Sel to select between different inputs."}),"\n",(0,l.jsx)(n.pre,{children:(0,l.jsx)(n.code,{className:"language-scala",children:"import AluMux1Sel._\n\nclass AluMux1Bundle extends Bundle {\n  val aluMux1Sel = Input(AluMux1Sel())\n  val rs1Out     = Input(Bits(32.W))\n  val pcOut      = Input(Bits(32.W))\n  val aluMux1Out = Output(Bits(32.W))\n}\n\nclass AluMux1File extends Module {\n  val io = IO(new AluMux1Bundle)\n\n  // Default value for aluMux1Out\n  io.aluMux1Out := 0.U\n\n  switch (io.aluMux1Sel) {\n    is (selectRS1) {\n      io.aluMux1Out := io.rs1Out\n    }\n    is (selectPC) {\n      io.aluMux1Out := io.pcOut\n    }\n  }\n}\n"})}),"\n",(0,l.jsx)(n.pre,{children:(0,l.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule AluMux1File(\t// chisel-enum.md:62:7\n  input         clock,\t// chisel-enum.md:62:7\n                reset,\t// chisel-enum.md:62:7\n                io_aluMux1Sel,\t// chisel-enum.md:63:14\n  input  [31:0] io_rs1Out,\t// chisel-enum.md:63:14\n                io_pcOut,\t// chisel-enum.md:63:14\n  output [31:0] io_aluMux1Out\t// chisel-enum.md:63:14\n);\n\n  assign io_aluMux1Out = io_aluMux1Sel ? io_pcOut : io_rs1Out;\t// chisel-enum.md:62:7, :68:26, :70:21\nendmodule\n\n"})}),"\n",(0,l.jsxs)(n.p,{children:["ChiselEnum also allows for the user to directly set the Values by passing an ",(0,l.jsx)(n.code,{children:"UInt"})," to ",(0,l.jsx)(n.code,{children:"Value(...)"}),"\nas shown below. Note that the magnitude of each ",(0,l.jsx)(n.code,{children:"Value"})," must be strictly greater than the one before\nit."]}),"\n",(0,l.jsx)(n.pre,{children:(0,l.jsx)(n.code,{className:"language-scala",children:'object Opcode extends ChiselEnum {\n    val load  = Value(0x03.U) // i "load"  -> 000_0011\n    val imm   = Value(0x13.U) // i "imm"   -> 001_0011\n    val auipc = Value(0x17.U) // u "auipc" -> 001_0111\n    val store = Value(0x23.U) // s "store" -> 010_0011\n    val reg   = Value(0x33.U) // r "reg"   -> 011_0011\n    val lui   = Value(0x37.U) // u "lui"   -> 011_0111\n    val br    = Value(0x63.U) // b "br"    -> 110_0011\n    val jalr  = Value(0x67.U) // i "jalr"  -> 110_0111\n    val jal   = Value(0x6F.U) // j "jal"   -> 110_1111\n}\n'})}),"\n",(0,l.jsx)(n.p,{children:"The user can 'jump' to a value and continue incrementing by passing a start point then using a regular Value definition."}),"\n",(0,l.jsx)(n.pre,{children:(0,l.jsx)(n.code,{className:"language-scala",children:"object BranchFunct3 extends ChiselEnum {\n    val beq, bne = Value\n    val blt = Value(4.U)\n    val bge, bltu, bgeu = Value\n}\n// We can see the mapping by printing each Value\nBranchFunct3.all.foreach(println)\n// BranchFunct3(0=beq)\n// BranchFunct3(1=bne)\n// BranchFunct3(4=blt)\n// BranchFunct3(5=bge)\n// BranchFunct3(6=bltu)\n// BranchFunct3(7=bgeu)\n"})}),"\n",(0,l.jsx)(n.h2,{id:"casting",children:"Casting"}),"\n",(0,l.jsxs)(n.p,{children:["You can cast an enum to a ",(0,l.jsx)(n.code,{children:"UInt"})," using ",(0,l.jsx)(n.code,{children:".asUInt"}),":"]}),"\n",(0,l.jsx)(n.pre,{children:(0,l.jsx)(n.code,{className:"language-scala",children:"class ToUInt extends RawModule {\n  val in = IO(Input(Opcode()))\n  val out = IO(Output(UInt(in.getWidth.W)))\n  out := in.asUInt\n}\n"})}),"\n",(0,l.jsxs)(n.p,{children:["You can cast from a ",(0,l.jsx)(n.code,{children:"UInt"})," to an enum by passing the ",(0,l.jsx)(n.code,{children:"UInt"})," to the apply method of the ",(0,l.jsx)(n.code,{children:"ChiselEnum"})," object:"]}),"\n",(0,l.jsx)(n.pre,{children:(0,l.jsx)(n.code,{className:"language-scala",children:"class FromUInt extends Module {\n  val in = IO(Input(UInt(7.W)))\n  val out = IO(Output(Opcode()))\n  out := Opcode(in)\n}\n"})}),"\n",(0,l.jsxs)(n.p,{children:["However, if you cast from a ",(0,l.jsx)(n.code,{children:"UInt"})," to an Enum type when there are undefined states in the Enum values\nthat the ",(0,l.jsx)(n.code,{children:"UInt"})," could hit, you will see a warning like the following:"]}),"\n",(0,l.jsx)(n.pre,{children:(0,l.jsx)(n.code,{children:"[warn] chisel-enum.md 136:16: [W001] Casting non-literal UInt to repl.MdocSession$MdocApp$Opcode. You can use repl.MdocSession$MdocApp$Opcode.safe to cast without this warning.\n[warn] There were 1 warning(s) during hardware elaboration.\n"})}),"\n",(0,l.jsx)(n.p,{children:"(Note that the name of the Enum is ugly as an artifact of our documentation generation flow, it will\nbe cleaner in normal use)."}),"\n",(0,l.jsxs)(n.p,{children:["You can avoid this warning by using the ",(0,l.jsx)(n.code,{children:".safe"})," factory method which returns the cast Enum in addition\nto a ",(0,l.jsx)(n.code,{children:"Bool"})," indicating if the Enum is in a valid state:"]}),"\n",(0,l.jsx)(n.pre,{children:(0,l.jsx)(n.code,{className:"language-scala",children:'class SafeFromUInt extends Module {\n  val in = IO(Input(UInt(7.W)))\n  val out = IO(Output(Opcode()))\n  val (value, valid) = Opcode.safe(in)\n  assert(valid, "Enum state must be valid, got %d!", in)\n  out := value\n}\n'})}),"\n",(0,l.jsx)(n.p,{children:"Now there will be no warning:"}),"\n",(0,l.jsx)(n.pre,{children:(0,l.jsx)(n.code,{})}),"\n",(0,l.jsxs)(n.p,{children:["You can also suppress the warning by using ",(0,l.jsx)(n.code,{children:"suppressEnumCastWarning"}),". This is\nprimarily used for casting from [[UInt]] to a Bundle type that contains an\nEnum, where the [[UInt]] is known to be valid for the Bundle type."]}),"\n",(0,l.jsx)(n.pre,{children:(0,l.jsx)(n.code,{className:"language-scala",children:"class MyBundle extends Bundle {\n  val addr = UInt(8.W)\n  val op = Opcode()\n}\n\nclass SuppressedFromUInt extends Module {\n  val in = IO(Input(UInt(15.W)))\n  val out = IO(Output(new MyBundle()))\n  suppressEnumCastWarning {\n    out := in.asTypeOf(new MyBundle)\n  }\n}\n"})}),"\n",(0,l.jsx)(n.h2,{id:"testing",children:"Testing"}),"\n",(0,l.jsxs)(n.p,{children:["The ",(0,l.jsx)(n.em,{children:"Type"})," of the enums values is ",(0,l.jsx)(n.code,{children:"<ChiselEnum Object>.Type"})," which can be useful for passing the values\nas parameters to a function (or any other time a type annotation is needed).\nCalling ",(0,l.jsx)(n.code,{children:".litValue"})," on an enum value will return the integer value of that object as a\n",(0,l.jsx)(n.a,{href:"https://www.scala-lang.org/api/2.12.13/scala/math/BigInt.html",children:(0,l.jsx)(n.code,{children:"BigInt"})}),"."]}),"\n",(0,l.jsx)(n.pre,{children:(0,l.jsx)(n.code,{className:"language-scala",children:"def expectedSel(sel: AluMux1Sel.Type): Boolean = sel match {\n  case AluMux1Sel.selectRS1 => (sel.litValue == 0)\n  case AluMux1Sel.selectPC  => (sel.litValue == 1)\n  case _                    => false\n}\n"})}),"\n",(0,l.jsxs)(n.p,{children:["The enum value type also defines some convenience methods for working with ",(0,l.jsx)(n.code,{children:"ChiselEnum"})," values. For example, continuing with the RISC-V opcode\nexample, one could easily create hardware signal that is only asserted on LOAD/STORE operations (when the enum value is equal to ",(0,l.jsx)(n.code,{children:"Opcode.load"}),"\nor ",(0,l.jsx)(n.code,{children:"Opcode.store"}),") using the ",(0,l.jsx)(n.code,{children:".isOneOf"})," method:"]}),"\n",(0,l.jsx)(n.pre,{children:(0,l.jsx)(n.code,{className:"language-scala",children:"class LoadStoreExample extends Module {\n  val io = IO(new Bundle {\n    val opcode = Input(Opcode())\n    val load_or_store = Output(Bool())\n  })\n  io.load_or_store := io.opcode.isOneOf(Opcode.load, Opcode.store)\n}\n"})}),"\n",(0,l.jsxs)(n.p,{children:["Some additional useful methods defined on the ",(0,l.jsx)(n.code,{children:"ChiselEnum"})," object are:"]}),"\n",(0,l.jsxs)(n.ul,{children:["\n",(0,l.jsxs)(n.li,{children:[(0,l.jsx)(n.code,{children:".all"}),": returns the enum values within the enumeration"]}),"\n",(0,l.jsxs)(n.li,{children:[(0,l.jsx)(n.code,{children:".getWidth"}),": returns the width of the hardware type"]}),"\n"]}),"\n",(0,l.jsx)(n.h2,{id:"workarounds",children:"Workarounds"}),"\n",(0,l.jsxs)(n.p,{children:["As of Chisel v3.4.3 (1 July 2020), the width of the values is always inferred.\nTo work around this, you can add an extra ",(0,l.jsx)(n.code,{children:"Value"})," that forces the width that is desired.\nThis is shown in the example below, where we add a field ",(0,l.jsx)(n.code,{children:"ukn"})," to force the width to be 3 bits wide:"]}),"\n",(0,l.jsx)(n.pre,{children:(0,l.jsx)(n.code,{className:"language-scala",children:"object StoreFunct3 extends ChiselEnum {\n    val sb, sh, sw = Value\n    val ukn = Value(7.U)\n}\n// We can see the mapping by printing each Value\nStoreFunct3.all.foreach(println)\n// StoreFunct3(0=sb)\n// StoreFunct3(1=sh)\n// StoreFunct3(2=sw)\n// StoreFunct3(7=ukn)\n"})}),"\n",(0,l.jsxs)(n.p,{children:["Signed values are not supported so if you want the value signed, you must cast the UInt with ",(0,l.jsx)(n.code,{children:".asSInt"}),"."]}),"\n",(0,l.jsx)(n.h2,{id:"additional-resources",children:"Additional Resources"}),"\n",(0,l.jsxs)(n.p,{children:["The ChiselEnum type is much more powerful than stated above. It allows for Sequence, Vec, and Bundle assignments, as well as a ",(0,l.jsx)(n.code,{children:".next"})," operation to allow for stepping through sequential states and an ",(0,l.jsx)(n.code,{children:".isValid"})," for checking that a hardware value is a valid ",(0,l.jsx)(n.code,{children:"Value"}),". The source code for the ChiselEnum can be found ",(0,l.jsx)(n.a,{href:"https://github.com/chipsalliance/chisel3/blob/2a96767097264eade18ff26e1d8bce192383a190/core/src/main/scala/chisel3/StrongEnum.scala",children:"here"})," in the class ",(0,l.jsx)(n.code,{children:"EnumFactory"}),". Examples of the ChiselEnum operations can be found ",(0,l.jsx)(n.a,{href:"https://github.com/chipsalliance/chisel3/blob/dd6871b8b3f2619178c2a333d9d6083805d99e16/src/test/scala/chiselTests/StrongEnum.scala",children:"here"}),"."]})]})}function d(e={}){const{wrapper:n}={...(0,a.R)(),...e.components};return n?(0,l.jsx)(n,{...e,children:(0,l.jsx)(r,{...e})}):r(e)}},8453:(e,n,s)=>{s.d(n,{R:()=>i,x:()=>c});var l=s(6540);const a={},t=l.createContext(a);function i(e){const n=l.useContext(t);return l.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function c(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(a):e.components||a:i(e.components),l.createElement(t.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/d1e6e3d8.bae292e0.js b/assets/js/d1e6e3d8.bae292e0.js
new file mode 100644
index 0000000000..de19b478a1
--- /dev/null
+++ b/assets/js/d1e6e3d8.bae292e0.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[4863],{6671:(e,n,o)=>{o.r(n),o.d(n,{assets:()=>s,contentTitle:()=>c,default:()=>p,frontMatter:()=>a,metadata:()=>r,toc:()=>l});var t=o(4848),i=o(8453);const a={layout:"docs",title:"Deep Dive into <> and := Connection Operators",section:"chisel3"},c="Deep Dive into Connection Operators",r={id:"explanations/connection-operators",title:"Deep Dive into <> and := Connection Operators",description:"Chisel contains two connection operators, := and `. This document provides a deeper explanation of the differences of the two and when to use one or the other. The differences are demonstrated with experiments using Scastie examples which use DecoupledIO`.",source:"@site/docs/explanations/connection-operators.md",sourceDirName:"explanations",slug:"/explanations/connection-operators",permalink:"/docs/explanations/connection-operators",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/connection-operators.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Deep Dive into <> and := Connection Operators",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Connectable Operators",permalink:"/docs/explanations/connectable"},next:{title:"Chisel Data Types",permalink:"/docs/explanations/data-types"}},s={},l=[{value:"Experiment Setup",id:"experiment-setup",level:3},{value:"Concept 1: <code>&lt;&gt;</code> is Commutative",id:"concept-1--is-commutative",level:2},{value:"Conclusion:",id:"conclusion",level:3},{value:"Concept 2: <code>:=</code> means assign ALL LHS signals from the RHS, regardless of the direction on the LHS.",id:"concept-2--means-assign-all-lhs-signals-from-the-rhs-regardless-of-the-direction-on-the-lhs",level:2},{value:"Conclusion:",id:"conclusion-1",level:3},{value:"Concept 3: Always Use <code>:=</code> to assign DontCare to Wires",id:"concept-3-always-use--to-assign-dontcare-to-wires",level:2},{value:"Conclusion:",id:"conclusion-2",level:3},{value:"Concept 4: You can use <code>&lt;&gt;</code> or <code>:=</code> to assign <code>DontCare</code> to directioned things (IOs)",id:"concept-4-you-can-use--or--to-assign-dontcare-to-directioned-things-ios",level:2},{value:"Conclusion:",id:"conclusion-3",level:3},{value:"Concept 5: <code>&lt;&gt;</code>  works between things with at least one known flow (An IO or child&#39;s IO).",id:"concept-5---works-between-things-with-at-least-one-known-flow-an-io-or-childs-io",level:2},{value:"Conclusion:",id:"conclusion-4",level:3},{value:"Concept 6: <code>&lt;&gt;</code> and <code>:=</code> connect signals by field name.",id:"concept-6--and--connect-signals-by-field-name",level:2},{value:"Conclusion:",id:"conclusion-5",level:3}];function d(e){const n={a:"a",code:"code",h1:"h1",h2:"h2",h3:"h3",img:"img",p:"p",pre:"pre",...(0,i.R)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.h1,{id:"deep-dive-into-connection-operators",children:"Deep Dive into Connection Operators"}),"\n",(0,t.jsxs)(n.p,{children:["Chisel contains two connection operators, ",(0,t.jsx)(n.code,{children:":="})," and ",(0,t.jsx)(n.code,{children:"<>"}),". This document provides a deeper explanation of the differences of the two and when to use one or the other. The differences are demonstrated with experiments using Scastie examples which use ",(0,t.jsx)(n.code,{children:"DecoupledIO"}),"."]}),"\n",(0,t.jsx)(n.h3,{id:"experiment-setup",children:"Experiment Setup"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"// Imports used by the following examples\nimport chisel3._\nimport chisel3.util.DecoupledIO\nimport circt.stage.ChiselStage\n"})}),"\n",(0,t.jsxs)(n.p,{children:["The diagram for the experiment can be viewed ",(0,t.jsx)(n.a,{href:"https://docs.google.com/document/d/14C918Hdahk2xOGSJJBT-ZVqAx99_hg3JQIq-vaaifQU/edit?usp=sharing",children:"here"}),".\n",(0,t.jsx)(n.img,{src:"https://raw.githubusercontent.com/chipsalliance/chisel3/master/docs/src/images/connection-operators-experiment.svg?sanitize=true",alt:"Experiment Image"})]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"\nclass Wrapper extends Module{\n  val io = IO(new Bundle {\n  val in = Flipped(DecoupledIO(UInt(8.W)))\n  val out = DecoupledIO(UInt(8.W))\n  })\n  val p = Module(new PipelineStage)\n  val c = Module(new PipelineStage)\n  // connect Producer to IO\n  p.io.a <> io.in\n  // connect producer to consumer\n  c.io.a <> p.io.b\n  // connect consumer to IO\n  io.out <> c.io.b\n}\nclass PipelineStage extends Module{\n  val io = IO(new Bundle{\n    val a = Flipped(DecoupledIO(UInt(8.W)))\n    val b = DecoupledIO(UInt(8.W))\n  })\n  io.b <> io.a\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"Below we can see the resulting Verilog for this example:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'ChiselStage.emitSystemVerilog(new Wrapper)\n// res0: String = """// Generated by CIRCT firtool-1.81.1\n// module PipelineStage(\t// connection-operators.md:36:7\n//   output       io_a_ready,\t// connection-operators.md:37:14\n//   input        io_a_valid,\t// connection-operators.md:37:14\n//   input  [7:0] io_a_bits,\t// connection-operators.md:37:14\n//   input        io_b_ready,\t// connection-operators.md:37:14\n//   output       io_b_valid,\t// connection-operators.md:37:14\n//   output [7:0] io_b_bits\t// connection-operators.md:37:14\n// );\n// \n//   assign io_a_ready = io_b_ready;\t// connection-operators.md:36:7\n//   assign io_b_valid = io_a_valid;\t// connection-operators.md:36:7\n//   assign io_b_bits = io_a_bits;\t// connection-operators.md:36:7\n// endmodule\n// \n// module Wrapper(\t// connection-operators.md:20:7\n//   input        clock,\t// connection-operators.md:20:7\n//                reset,\t// connection-operators.md:20:7\n//   output       io_in_ready,\t// connection-operators.md:21:14\n//   input        io_in_valid,\t// connection-operators.md:21:14\n//   input  [7:0] io_in_bits,\t// connection-operators.md:21:14\n//   input        io_out_ready,\t// connection-operators.md:21:14\n//   output       io_out_valid,\t// connection-operators.md:21:14\n//   output [7:0] io_out_bits\t// connection-operators.md:21:14\n// );\n// \n//   wire       _c_io_a_ready;\t// connection-operators.md:26:17\n//   wire       _p_io_b_valid;\t// connection-operators.md:25:17\n//   wire [7:0] _p_io_b_bits;\t// connection-operators.md:25:17\n//   PipelineStage p (\t// connection-operators.md:25:17\n//     .io_a_ready (io_in_ready),\n//     .io_a_valid (io_in_valid),\n//     .io_a_bits  (io_in_bits),\n//     .io_b_ready (_c_io_a_ready),\t// connection-operators.md:26:17\n//     .io_b_valid (_p_io_b_valid),\n//     .io_b_bits  (_p_io_b_bits)\n//   );\t// connection-operators.md:25:17\n//   PipelineStage c (\t// connection-operators.md:26:17\n//     .io_a_ready (_c_io_a_ready),\n//     .io_a_valid (_p_io_b_valid),\t// connection-operators.md:25:17\n//     .io_a_bits  (_p_io_b_bits),\t// connection-operators.md:25:17\n//     .io_b_ready (io_out_ready),\n//     .io_b_valid (io_out_valid),\n//     .io_b_bits  (io_out_bits)\n//   );\t// connection-operators.md:26:17\n// endmodule\n// \n// \n// // ----- 8< ----- FILE "Verification/Cover/layers_Wrapper_Verification_Cover.sv"...\n'})}),"\n",(0,t.jsxs)(n.h2,{id:"concept-1--is-commutative",children:["Concept 1: ",(0,t.jsx)(n.code,{children:"<>"})," is Commutative"]}),"\n",(0,t.jsxs)(n.p,{children:["This experiment is set up to test for the function of ",(0,t.jsx)(n.code,{children:"<>"})," using the experiment above."]}),"\n",(0,t.jsxs)(n.p,{children:["Achieving this involves flipping the RHS and LHS of the ",(0,t.jsx)(n.code,{children:"<>"})," operator and seeing how ",(0,t.jsx)(n.code,{children:"<>"}),"  will react.\n( Scastie link for the experiment:",(0,t.jsx)(n.a,{href:"https://scastie.scala-lang.org/Shorla/LVhlbkFQQnq7X3trHfgZZQ",children:"https://scastie.scala-lang.org/Shorla/LVhlbkFQQnq7X3trHfgZZQ"})," )"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.util.DecoupledIO\nimport circt.stage.ChiselStage\n\nclass Wrapper extends Module{\n  val io = IO(new Bundle {\n  val in = Flipped(DecoupledIO(UInt(8.W)))\n  val out = DecoupledIO(UInt(8.W))\n  })\n  val p = Module(new PipelineStage)\n  val c = Module(new PipelineStage)\n  // connect producer to I/O\n  io.in <> p.io.a\n  // connect producer  to consumer\n  p.io.b <> c.io.a\n  // connect consumer to I/O\n  c.io.b <> io.out\n}\nclass PipelineStage extends Module{\n  val io = IO(new Bundle{\n    val a = Flipped(DecoupledIO(UInt(8.W)))\n    val b = DecoupledIO(UInt(8.W))\n  })\n  io.a <> io.b\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"Below we can see the resulting Verilog for this example:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'ChiselStage.emitSystemVerilog(new Wrapper)\n// res2: String = """// Generated by CIRCT firtool-1.81.1\n// module PipelineStage(\t// connection-operators.md:82:7\n//   output       io_a_ready,\t// connection-operators.md:83:14\n//   input        io_a_valid,\t// connection-operators.md:83:14\n//   input  [7:0] io_a_bits,\t// connection-operators.md:83:14\n//   input        io_b_ready,\t// connection-operators.md:83:14\n//   output       io_b_valid,\t// connection-operators.md:83:14\n//   output [7:0] io_b_bits\t// connection-operators.md:83:14\n// );\n// \n//   assign io_a_ready = io_b_ready;\t// connection-operators.md:82:7\n//   assign io_b_valid = io_a_valid;\t// connection-operators.md:82:7\n//   assign io_b_bits = io_a_bits;\t// connection-operators.md:82:7\n// endmodule\n// \n// module Wrapper(\t// connection-operators.md:66:7\n//   input        clock,\t// connection-operators.md:66:7\n//                reset,\t// connection-operators.md:66:7\n//   output       io_in_ready,\t// connection-operators.md:67:14\n//   input        io_in_valid,\t// connection-operators.md:67:14\n//   input  [7:0] io_in_bits,\t// connection-operators.md:67:14\n//   input        io_out_ready,\t// connection-operators.md:67:14\n//   output       io_out_valid,\t// connection-operators.md:67:14\n//   output [7:0] io_out_bits\t// connection-operators.md:67:14\n// );\n// \n//   wire       _c_io_a_ready;\t// connection-operators.md:72:17\n//   wire       _p_io_b_valid;\t// connection-operators.md:71:17\n//   wire [7:0] _p_io_b_bits;\t// connection-operators.md:71:17\n//   PipelineStage p (\t// connection-operators.md:71:17\n//     .io_a_ready (io_in_ready),\n//     .io_a_valid (io_in_valid),\n//     .io_a_bits  (io_in_bits),\n//     .io_b_ready (_c_io_a_ready),\t// connection-operators.md:72:17\n//     .io_b_valid (_p_io_b_valid),\n//     .io_b_bits  (_p_io_b_bits)\n//   );\t// connection-operators.md:71:17\n//   PipelineStage c (\t// connection-operators.md:72:17\n//     .io_a_ready (_c_io_a_ready),\n//     .io_a_valid (_p_io_b_valid),\t// connection-operators.md:71:17\n//     .io_a_bits  (_p_io_b_bits),\t// connection-operators.md:71:17\n//     .io_b_ready (io_out_ready),\n//     .io_b_valid (io_out_valid),\n//     .io_b_bits  (io_out_bits)\n//   );\t// connection-operators.md:72:17\n// endmodule\n// \n// \n// // ----- 8< ----- FILE "Verification/Cover/layers_Wrapper_Verification_Cover.sv"...\n'})}),"\n",(0,t.jsx)(n.h3,{id:"conclusion",children:"Conclusion:"}),"\n",(0,t.jsxs)(n.p,{children:["The Verilog remained the same without incurring errors, showing that the ",(0,t.jsx)(n.code,{children:"<>"})," operator is commutative."]}),"\n",(0,t.jsxs)(n.h2,{id:"concept-2--means-assign-all-lhs-signals-from-the-rhs-regardless-of-the-direction-on-the-lhs",children:["Concept 2: ",(0,t.jsx)(n.code,{children:":="})," means assign ALL LHS signals from the RHS, regardless of the direction on the LHS."]}),"\n",(0,t.jsxs)(n.p,{children:["Using the same experiment code as above, we set to test for the function of ",(0,t.jsx)(n.code,{children:":="}),"\nWe replace all instances of ",(0,t.jsx)(n.code,{children:"<>"})," with ",(0,t.jsx)(n.code,{children:":="})," in the sample code above.\n(Scastie link to the experiment: ",(0,t.jsx)(n.a,{href:"https://scastie.scala-lang.org/Shorla/o1ShdaY3RWKf0IIFwwQ1UQ/1",children:"https://scastie.scala-lang.org/Shorla/o1ShdaY3RWKf0IIFwwQ1UQ/1"}),")"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.util.DecoupledIO\nimport circt.stage.ChiselStage\n\nclass Wrapper extends Module{\n  val io = IO(new Bundle {\n  val in = Flipped(DecoupledIO(UInt(8.W)))\n  val out = DecoupledIO(UInt(8.W))\n  })\n  val p = Module(new PipelineStage)\n  val c = Module(new PipelineStage)\n  // connect producer to I/O\n  p.io.a := io.in\n  // connect producer  to consumer\n  c.io.a := p.io.b\n  // connect consumer to I/O\n  io.out := c.io.b\n}\nclass PipelineStage extends Module{\n  val io = IO(new Bundle{\n    val a = Flipped(DecoupledIO(UInt(8.W)))\n    val b = DecoupledIO(UInt(8.W))\n  })\n  io.a := io.b\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"Below we can see the resulting error message for this example:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"ChiselStage.emitSystemVerilog(new Wrapper)\n// chisel3.package$ChiselException: Connection between sink (PipelineStage.io.a: IO[DecoupledIO]) and source (PipelineStage.io.b: IO[DecoupledIO]) failed @: .bitsio.a.bits in PipelineStage cannot be written from module PipelineStage.\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp3$PipelineStage.<init>(connection-operators.md:133)\n// \tat repl.MdocSession$MdocApp3$Wrapper$$anonfun$30$$anonfun$apply$20.apply(connection-operators.md:117)\n// \tat repl.MdocSession$MdocApp3$Wrapper$$anonfun$30$$anonfun$apply$20.apply(connection-operators.md:117)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat repl.MdocSession$MdocApp3$Wrapper$$anonfun$30.apply(connection-operators.md:117)\n// \tat repl.MdocSession$MdocApp3$Wrapper$$anonfun$30.apply(connection-operators.md:117)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp3$Wrapper.<init>(connection-operators.md:117)\n// \tat repl.MdocSession$MdocApp3$$anonfun$39$$anonfun$apply$25.apply(connection-operators.md:141)\n// \tat repl.MdocSession$MdocApp3$$anonfun$39$$anonfun$apply$25.apply(connection-operators.md:141)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,t.jsx)(n.h3,{id:"conclusion-1",children:"Conclusion:"}),"\n",(0,t.jsx)(n.p,{children:"The := operator goes field-by-field on the LHS and attempts to connect it to the same-named signal from the RHS. If something on the LHS is actually an Input, or the corresponding signal on the RHS is an Output, you will get an error as shown above."}),"\n",(0,t.jsxs)(n.h2,{id:"concept-3-always-use--to-assign-dontcare-to-wires",children:["Concept 3: Always Use ",(0,t.jsx)(n.code,{children:":="})," to assign DontCare to Wires"]}),"\n",(0,t.jsxs)(n.p,{children:["When assigning ",(0,t.jsx)(n.code,{children:"DontCare"})," to something that is not directioned, should you use ",(0,t.jsx)(n.code,{children:":="})," or ",(0,t.jsx)(n.code,{children:"<>"}),"?\nWe will find out using the sample codes below:\n( Scastie link for the experiment:",(0,t.jsx)(n.a,{href:"https://scastie.scala-lang.org/Shorla/ZIGsWcylRqKJhZCkKWlSIA/1",children:"https://scastie.scala-lang.org/Shorla/ZIGsWcylRqKJhZCkKWlSIA/1"}),")"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.util.DecoupledIO\nimport circt.stage.ChiselStage\n\nclass Wrapper extends Module{\n  val io = IO(new Bundle {\n  val in = Flipped(DecoupledIO(UInt(8.W)))\n  val out = DecoupledIO(UInt(8.W))\n  })\n  val p = Module(new PipelineStage)\n  val c = Module(new PipelineStage)\n  //connect Producer to IO\n  io.in := DontCare\n  p.io.a <> DontCare\n  val tmp = Wire(Flipped(DecoupledIO(UInt(8.W))))\n  tmp := DontCare\n  p.io.a <> io.in\n  // connect producer to consumer\n  c.io.a <> p.io.b\n  //connect consumer to IO\n  io.out <> c.io.b\n}\nclass PipelineStage extends Module{\n  val io = IO(new Bundle{\n    val a = Flipped(DecoupledIO(UInt(8.W)))\n    val b = DecoupledIO(UInt(8.W))\n  })\n  io.b <> io.a\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"Below we can see the resulting Verilog for this example:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'ChiselStage.emitSystemVerilog(new Wrapper)\n// res5: String = """// Generated by CIRCT firtool-1.81.1\n// module PipelineStage(\t// connection-operators.md:182:7\n//   output       io_a_ready,\t// connection-operators.md:183:14\n//   input        io_a_valid,\t// connection-operators.md:183:14\n//   input  [7:0] io_a_bits,\t// connection-operators.md:183:14\n//   input        io_b_ready,\t// connection-operators.md:183:14\n//   output       io_b_valid,\t// connection-operators.md:183:14\n//   output [7:0] io_b_bits\t// connection-operators.md:183:14\n// );\n// \n//   assign io_a_ready = io_b_ready;\t// connection-operators.md:182:7\n//   assign io_b_valid = io_a_valid;\t// connection-operators.md:182:7\n//   assign io_b_bits = io_a_bits;\t// connection-operators.md:182:7\n// endmodule\n// \n// module Wrapper(\t// connection-operators.md:162:7\n//   input        clock,\t// connection-operators.md:162:7\n//                reset,\t// connection-operators.md:162:7\n//   output       io_in_ready,\t// connection-operators.md:163:14\n//   input        io_in_valid,\t// connection-operators.md:163:14\n//   input  [7:0] io_in_bits,\t// connection-operators.md:163:14\n//   input        io_out_ready,\t// connection-operators.md:163:14\n//   output       io_out_valid,\t// connection-operators.md:163:14\n//   output [7:0] io_out_bits\t// connection-operators.md:163:14\n// );\n// \n//   wire       _c_io_a_ready;\t// connection-operators.md:168:17\n//   wire       _p_io_b_valid;\t// connection-operators.md:167:17\n//   wire [7:0] _p_io_b_bits;\t// connection-operators.md:167:17\n//   PipelineStage p (\t// connection-operators.md:167:17\n//     .io_a_ready (io_in_ready),\n//     .io_a_valid (io_in_valid),\n//     .io_a_bits  (io_in_bits),\n//     .io_b_ready (_c_io_a_ready),\t// connection-operators.md:168:17\n//     .io_b_valid (_p_io_b_valid),\n//     .io_b_bits  (_p_io_b_bits)\n//   );\t// connection-operators.md:167:17\n//   PipelineStage c (\t// connection-operators.md:168:17\n//     .io_a_ready (_c_io_a_ready),\n//     .io_a_valid (_p_io_b_valid),\t// connection-operators.md:167:17\n//     .io_a_bits  (_p_io_b_bits),\t// connection-operators.md:167:17\n//     .io_b_ready (io_out_ready),\n//     .io_b_valid (io_out_valid),\n//     .io_b_bits  (io_out_bits)\n//   );\t// connection-operators.md:168:17\n// endmodule\n// \n// \n// // ----- 8< ----- FILE "Verification/Cover/layers_Wrapper_Verification_Cover.sv"...\n'})}),"\n",(0,t.jsx)(n.h3,{id:"conclusion-2",children:"Conclusion:"}),"\n",(0,t.jsxs)(n.p,{children:["If ",(0,t.jsx)(n.code,{children:"<>"})," were used to assign the unidrectioned wire ",(0,t.jsx)(n.code,{children:"tmp"})," to DontCare, we would get an error. But in the example above, we used ",(0,t.jsx)(n.code,{children:":="})," and no errors occurred.\nBut when ",(0,t.jsx)(n.code,{children:":="})," was used to assign the wire to DontCare, no errors will occur."]}),"\n",(0,t.jsxs)(n.p,{children:["Thus, when assigning ",(0,t.jsx)(n.code,{children:"DontCare"})," to a ",(0,t.jsx)(n.code,{children:"Wire"}),", always use ",(0,t.jsx)(n.code,{children:":="}),"."]}),"\n",(0,t.jsxs)(n.h2,{id:"concept-4-you-can-use--or--to-assign-dontcare-to-directioned-things-ios",children:["Concept 4: You can use ",(0,t.jsx)(n.code,{children:"<>"})," or ",(0,t.jsx)(n.code,{children:":="})," to assign ",(0,t.jsx)(n.code,{children:"DontCare"})," to directioned things (IOs)"]}),"\n",(0,t.jsxs)(n.p,{children:["When assigning ",(0,t.jsx)(n.code,{children:"DontCare"})," to something that is directioned, should you use ",(0,t.jsx)(n.code,{children:":="})," or ",(0,t.jsx)(n.code,{children:"<>"}),"?\nWe will find out using the sample codes below:\n( Scastie link for the experiment:",(0,t.jsx)(n.a,{href:"https://scastie.scala-lang.org/Shorla/ZIGsWcylRqKJhZCkKWlSIA/1",children:"https://scastie.scala-lang.org/Shorla/ZIGsWcylRqKJhZCkKWlSIA/1"}),")"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.util.DecoupledIO\nimport circt.stage.ChiselStage\n\nclass Wrapper extends Module{\n  val io = IO(new Bundle {\n  val in = Flipped(DecoupledIO(UInt(8.W)))\n  val out = DecoupledIO(UInt(8.W))\n  })\n  val p = Module(new PipelineStage)\n  val c = Module(new PipelineStage)\n  //connect Producer to IO\n  io.in := DontCare\n  p.io.a <> DontCare\n  val tmp = Wire(Flipped(DecoupledIO(UInt(8.W))))\n  tmp := DontCare\n  p.io.a <> io.in\n  // connect producer to consumer\n  c.io.a <> p.io.b\n  //connect consumer to IO\n  io.out <> c.io.b\n}\nclass PipelineStage extends Module{\n  val io = IO(new Bundle{\n    val a = Flipped(DecoupledIO(UInt(8.W)))\n    val b = DecoupledIO(UInt(8.W))\n  })\n  io.b <> io.a\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"Below we can see the resulting Verilog for this example:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'ChiselStage.emitSystemVerilog(new Wrapper)\n// res7: String = """// Generated by CIRCT firtool-1.81.1\n// module PipelineStage(\t// connection-operators.md:232:7\n//   output       io_a_ready,\t// connection-operators.md:233:14\n//   input        io_a_valid,\t// connection-operators.md:233:14\n//   input  [7:0] io_a_bits,\t// connection-operators.md:233:14\n//   input        io_b_ready,\t// connection-operators.md:233:14\n//   output       io_b_valid,\t// connection-operators.md:233:14\n//   output [7:0] io_b_bits\t// connection-operators.md:233:14\n// );\n// \n//   assign io_a_ready = io_b_ready;\t// connection-operators.md:232:7\n//   assign io_b_valid = io_a_valid;\t// connection-operators.md:232:7\n//   assign io_b_bits = io_a_bits;\t// connection-operators.md:232:7\n// endmodule\n// \n// module Wrapper(\t// connection-operators.md:212:7\n//   input        clock,\t// connection-operators.md:212:7\n//                reset,\t// connection-operators.md:212:7\n//   output       io_in_ready,\t// connection-operators.md:213:14\n//   input        io_in_valid,\t// connection-operators.md:213:14\n//   input  [7:0] io_in_bits,\t// connection-operators.md:213:14\n//   input        io_out_ready,\t// connection-operators.md:213:14\n//   output       io_out_valid,\t// connection-operators.md:213:14\n//   output [7:0] io_out_bits\t// connection-operators.md:213:14\n// );\n// \n//   wire       _c_io_a_ready;\t// connection-operators.md:218:17\n//   wire       _p_io_b_valid;\t// connection-operators.md:217:17\n//   wire [7:0] _p_io_b_bits;\t// connection-operators.md:217:17\n//   PipelineStage p (\t// connection-operators.md:217:17\n//     .io_a_ready (io_in_ready),\n//     .io_a_valid (io_in_valid),\n//     .io_a_bits  (io_in_bits),\n//     .io_b_ready (_c_io_a_ready),\t// connection-operators.md:218:17\n//     .io_b_valid (_p_io_b_valid),\n//     .io_b_bits  (_p_io_b_bits)\n//   );\t// connection-operators.md:217:17\n//   PipelineStage c (\t// connection-operators.md:218:17\n//     .io_a_ready (_c_io_a_ready),\n//     .io_a_valid (_p_io_b_valid),\t// connection-operators.md:217:17\n//     .io_a_bits  (_p_io_b_bits),\t// connection-operators.md:217:17\n//     .io_b_ready (io_out_ready),\n//     .io_b_valid (io_out_valid),\n//     .io_b_bits  (io_out_bits)\n//   );\t// connection-operators.md:218:17\n// endmodule\n// \n// \n// // ----- 8< ----- FILE "Verification/Cover/layers_Wrapper_Verification_Cover.sv"...\n'})}),"\n",(0,t.jsx)(n.h3,{id:"conclusion-3",children:"Conclusion:"}),"\n",(0,t.jsxs)(n.p,{children:["Both ",(0,t.jsx)(n.code,{children:"<>"})," and ",(0,t.jsx)(n.code,{children:":="})," can be used to assign directioned things (IOs) to DontCare as shown in ",(0,t.jsx)(n.code,{children:"io.in"})," and ",(0,t.jsx)(n.code,{children:"p.io.a"})," respectively. This is basically equivalent because in this case both ",(0,t.jsx)(n.code,{children:"<>"})," and ",(0,t.jsx)(n.code,{children:":="})," will determine the direction from the LHS."]}),"\n",(0,t.jsxs)(n.h2,{id:"concept-5---works-between-things-with-at-least-one-known-flow-an-io-or-childs-io",children:["Concept 5: ",(0,t.jsx)(n.code,{children:"<>"}),"  works between things with at least one known flow (An IO or child's IO)."]}),"\n",(0,t.jsxs)(n.p,{children:["If there is at least one known flow what will ",(0,t.jsx)(n.code,{children:"<>"})," do? This will be shown using the experiment code below:\n( Scastie link for the experiment:",(0,t.jsx)(n.a,{href:"https://scastie.scala-lang.org/Shorla/gKx9ReLVTTqDTk9vmw5ozg",children:"https://scastie.scala-lang.org/Shorla/gKx9ReLVTTqDTk9vmw5ozg"}),")"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.util.DecoupledIO\nimport circt.stage.ChiselStage\n\nclass Wrapper extends Module{\n  val io = IO(new Bundle {\n  val in = Flipped(DecoupledIO(UInt(8.W)))\n  val out = DecoupledIO(UInt(8.W))\n  })\n  val p = Module(new PipelineStage)\n  val c = Module(new PipelineStage)\n  //connect Producer to IO\n    // For this experiment, we add a temporary wire and see if it works...\n  //p.io.a <> io.in\n  val tmp = Wire(DecoupledIO(UInt(8.W)))\n  // connect intermediate wire\n  tmp <> io.in\n  p.io.a <> tmp\n  // connect producer to consumer\n  c.io.a <> p.io.b\n  //connect consumer to IO\n  io.out <> c.io.b\n}\nclass PipelineStage extends Module{\n  val io = IO(new Bundle{\n    val a = Flipped(DecoupledIO(UInt(8.W)))\n    val b = DecoupledIO(UInt(8.W))\n  })\n  io.b <> io.a\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"Below we can see the resulting Verilog for this example:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'ChiselStage.emitSystemVerilog(new Wrapper)\n// res9: String = """// Generated by CIRCT firtool-1.81.1\n// module PipelineStage(\t// connection-operators.md:283:7\n//   output       io_a_ready,\t// connection-operators.md:284:14\n//   input        io_a_valid,\t// connection-operators.md:284:14\n//   input  [7:0] io_a_bits,\t// connection-operators.md:284:14\n//   input        io_b_ready,\t// connection-operators.md:284:14\n//   output       io_b_valid,\t// connection-operators.md:284:14\n//   output [7:0] io_b_bits\t// connection-operators.md:284:14\n// );\n// \n//   assign io_a_ready = io_b_ready;\t// connection-operators.md:283:7\n//   assign io_b_valid = io_a_valid;\t// connection-operators.md:283:7\n//   assign io_b_bits = io_a_bits;\t// connection-operators.md:283:7\n// endmodule\n// \n// module Wrapper(\t// connection-operators.md:262:7\n//   input        clock,\t// connection-operators.md:262:7\n//                reset,\t// connection-operators.md:262:7\n//   output       io_in_ready,\t// connection-operators.md:263:14\n//   input        io_in_valid,\t// connection-operators.md:263:14\n//   input  [7:0] io_in_bits,\t// connection-operators.md:263:14\n//   input        io_out_ready,\t// connection-operators.md:263:14\n//   output       io_out_valid,\t// connection-operators.md:263:14\n//   output [7:0] io_out_bits\t// connection-operators.md:263:14\n// );\n// \n//   wire       _c_io_a_ready;\t// connection-operators.md:268:17\n//   wire       _p_io_b_valid;\t// connection-operators.md:267:17\n//   wire [7:0] _p_io_b_bits;\t// connection-operators.md:267:17\n//   PipelineStage p (\t// connection-operators.md:267:17\n//     .io_a_ready (io_in_ready),\n//     .io_a_valid (io_in_valid),\n//     .io_a_bits  (io_in_bits),\n//     .io_b_ready (_c_io_a_ready),\t// connection-operators.md:268:17\n//     .io_b_valid (_p_io_b_valid),\n//     .io_b_bits  (_p_io_b_bits)\n//   );\t// connection-operators.md:267:17\n//   PipelineStage c (\t// connection-operators.md:268:17\n//     .io_a_ready (_c_io_a_ready),\n//     .io_a_valid (_p_io_b_valid),\t// connection-operators.md:267:17\n//     .io_a_bits  (_p_io_b_bits),\t// connection-operators.md:267:17\n//     .io_b_ready (io_out_ready),\n//     .io_b_valid (io_out_valid),\n//     .io_b_bits  (io_out_bits)\n//   );\t// connection-operators.md:268:17\n// endmodule\n// \n// \n// // ----- 8< ----- FILE "Verification/Cover/layers_Wrapper_Verification_Cover.sv"...\n'})}),"\n",(0,t.jsx)(n.h3,{id:"conclusion-4",children:"Conclusion:"}),"\n",(0,t.jsxs)(n.p,{children:["The connection above went smoothly with no errors, this goes to show ",(0,t.jsx)(n.code,{children:"<>"}),' will work as long as there is at least one directioned thing (IO or submodule\'s IO) to "fix" the direction.']}),"\n",(0,t.jsxs)(n.h2,{id:"concept-6--and--connect-signals-by-field-name",children:["Concept 6: ",(0,t.jsx)(n.code,{children:"<>"})," and ",(0,t.jsx)(n.code,{children:":="})," connect signals by field name."]}),"\n",(0,t.jsxs)(n.p,{children:["This experiment creates a MockDecoupledIO which has the same fields by name as a DecoupledIO. Chisel lets us connect it and produces the same verilog, even though MockDecoupledIO and DecoupledIO are different types.\n( Scastie link for the experiment:",(0,t.jsx)(n.a,{href:"https://scastie.scala-lang.org/Uf4tQquvQYigZAW705NFIQ",children:"https://scastie.scala-lang.org/Uf4tQquvQYigZAW705NFIQ"}),")"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.util.DecoupledIO\nimport circt.stage.ChiselStage\n\nclass MockDecoupledIO extends Bundle {\n  val valid = Output(Bool())\n  val ready = Input(Bool())\n  val bits = Output(UInt(8.W))\n}\nclass Wrapper extends Module{\n  val io = IO(new Bundle {\n  val in = Flipped(new MockDecoupledIO())\n  val out = new MockDecoupledIO()\n  })\n  val p = Module(new PipelineStage)\n  val c = Module(new PipelineStage)\n  // connect producer to I/O\n  p.io.a <> io.in\n  // connect producer  to consumer\n  c.io.a <> p.io.b\n  // connect consumer to I/O\n  io.out <> c.io.b\n}\nclass PipelineStage extends Module{\n  val io = IO(new Bundle{\n    val a = Flipped(DecoupledIO(UInt(8.W)))\n    val b = DecoupledIO(UInt(8.W))\n  })\n  io.a <> io.b\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"Below we can see the resulting Verilog for this example:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'ChiselStage.emitSystemVerilog(new Wrapper)\n// res11: String = """// Generated by CIRCT firtool-1.81.1\n// module PipelineStage(\t// connection-operators.md:336:7\n//   output       io_a_ready,\t// connection-operators.md:337:14\n//   input        io_a_valid,\t// connection-operators.md:337:14\n//   input  [7:0] io_a_bits,\t// connection-operators.md:337:14\n//   input        io_b_ready,\t// connection-operators.md:337:14\n//   output       io_b_valid,\t// connection-operators.md:337:14\n//   output [7:0] io_b_bits\t// connection-operators.md:337:14\n// );\n// \n//   assign io_a_ready = io_b_ready;\t// connection-operators.md:336:7\n//   assign io_b_valid = io_a_valid;\t// connection-operators.md:336:7\n//   assign io_b_bits = io_a_bits;\t// connection-operators.md:336:7\n// endmodule\n// \n// module Wrapper(\t// connection-operators.md:320:7\n//   input        clock,\t// connection-operators.md:320:7\n//                reset,\t// connection-operators.md:320:7\n//                io_in_valid,\t// connection-operators.md:321:14\n//   output       io_in_ready,\t// connection-operators.md:321:14\n//   input  [7:0] io_in_bits,\t// connection-operators.md:321:14\n//   output       io_out_valid,\t// connection-operators.md:321:14\n//   input        io_out_ready,\t// connection-operators.md:321:14\n//   output [7:0] io_out_bits\t// connection-operators.md:321:14\n// );\n// \n//   wire       _c_io_a_ready;\t// connection-operators.md:326:17\n//   wire       _p_io_b_valid;\t// connection-operators.md:325:17\n//   wire [7:0] _p_io_b_bits;\t// connection-operators.md:325:17\n//   PipelineStage p (\t// connection-operators.md:325:17\n//     .io_a_ready (io_in_ready),\n//     .io_a_valid (io_in_valid),\n//     .io_a_bits  (io_in_bits),\n//     .io_b_ready (_c_io_a_ready),\t// connection-operators.md:326:17\n//     .io_b_valid (_p_io_b_valid),\n//     .io_b_bits  (_p_io_b_bits)\n//   );\t// connection-operators.md:325:17\n//   PipelineStage c (\t// connection-operators.md:326:17\n//     .io_a_ready (_c_io_a_ready),\n//     .io_a_valid (_p_io_b_valid),\t// connection-operators.md:325:17\n//     .io_a_bits  (_p_io_b_bits),\t// connection-operators.md:325:17\n//     .io_b_ready (io_out_ready),\n//     .io_b_valid (io_out_valid),\n//     .io_b_bits  (io_out_bits)\n//   );\t// connection-operators.md:326:17\n// endmodule\n// \n// \n// // ----- 8< ----- FILE "Verification/Cover/layers_Wrapper_Verification_Cover.sv"...\n'})}),"\n",(0,t.jsxs)(n.p,{children:["And here is another experiment, where we remove one of the fields of MockDecoupledIO:\n( Scastie link for the experiment:",(0,t.jsx)(n.a,{href:"https://scastie.scala-lang.org/ChtkhKCpS9CvJkjjqpdeIA",children:"https://scastie.scala-lang.org/ChtkhKCpS9CvJkjjqpdeIA"}),")"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.util.DecoupledIO\nimport circt.stage.ChiselStage\n\nclass MockDecoupledIO extends Bundle {\n  val valid = Output(Bool())\n  val ready = Input(Bool())\n  //val bits = Output(UInt(8.W))\n}\nclass Wrapper extends Module{\n  val io = IO(new Bundle {\n  val in = Flipped(new MockDecoupledIO())\n  val out = new MockDecoupledIO()\n  })\n  val p = Module(new PipelineStage)\n  val c = Module(new PipelineStage)\n  // connect producer to I/O\n  p.io.a <> io.in\n  // connect producer  to consumer\n  c.io.a <> p.io.b\n  // connect consumer to I/O\n  io.out <> c.io.b\n}\nclass PipelineStage extends Module{\n  val io = IO(new Bundle{\n    val a = Flipped(DecoupledIO(UInt(8.W)))\n    val b = DecoupledIO(UInt(8.W))\n  })\n  io.a <> io.b\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"Below we can see the resulting error for this example:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"ChiselStage.emitSystemVerilog(new Wrapper)\n// chisel3.package$ChiselException: Connection between left (PipelineStage.io.a: IO[DecoupledIO]) and source (Wrapper.io.in: IO[MockDecoupledIO]) failed @.bits: Right Record missing field (bits).\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp12$Wrapper.<init>(connection-operators.md:381)\n// \tat repl.MdocSession$MdocApp12$$anonfun$119$$anonfun$apply$79.apply(connection-operators.md:402)\n// \tat repl.MdocSession$MdocApp12$$anonfun$119$$anonfun$apply$79.apply(connection-operators.md:402)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,t.jsxs)(n.p,{children:["This one fails because there is a field ",(0,t.jsx)(n.code,{children:"bits"})," missing."]}),"\n",(0,t.jsx)(n.h3,{id:"conclusion-5",children:"Conclusion:"}),"\n",(0,t.jsxs)(n.p,{children:["For ",(0,t.jsx)(n.code,{children:":="}),", the Scala types do not need to match but all the signals on the LHS must be provided by the RHS or you will get a Chisel elaboration error. There may be additional signals on the RHS, these will be ignored. For ",(0,t.jsx)(n.code,{children:"<>"}),", the Scala types do not need to match, but all signals must match exactly between LHS and RHS. In both cases, the order of the fields does not matter."]})]})}function p(e={}){const{wrapper:n}={...(0,i.R)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(d,{...e})}):d(e)}},8453:(e,n,o)=>{o.d(n,{R:()=>c,x:()=>r});var t=o(6540);const i={},a=t.createContext(i);function c(e){const n=t.useContext(a);return t.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function r(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(i):e.components||i:c(e.components),t.createElement(a.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/d1e6e3d8.de556a7e.js b/assets/js/d1e6e3d8.de556a7e.js
deleted file mode 100644
index 8bc286fa1e..0000000000
--- a/assets/js/d1e6e3d8.de556a7e.js
+++ /dev/null
@@ -1 +0,0 @@
-"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[4863],{6671:(e,n,o)=>{o.r(n),o.d(n,{assets:()=>s,contentTitle:()=>c,default:()=>p,frontMatter:()=>a,metadata:()=>r,toc:()=>l});var t=o(4848),i=o(8453);const a={layout:"docs",title:"Deep Dive into <> and := Connection Operators",section:"chisel3"},c="Deep Dive into Connection Operators",r={id:"explanations/connection-operators",title:"Deep Dive into <> and := Connection Operators",description:"Chisel contains two connection operators, := and `. This document provides a deeper explanation of the differences of the two and when to use one or the other. The differences are demonstrated with experiments using Scastie examples which use DecoupledIO`.",source:"@site/docs/explanations/connection-operators.md",sourceDirName:"explanations",slug:"/explanations/connection-operators",permalink:"/docs/explanations/connection-operators",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/connection-operators.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Deep Dive into <> and := Connection Operators",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Connectable Operators",permalink:"/docs/explanations/connectable"},next:{title:"Chisel Data Types",permalink:"/docs/explanations/data-types"}},s={},l=[{value:"Experiment Setup",id:"experiment-setup",level:3},{value:"Concept 1: <code>&lt;&gt;</code> is Commutative",id:"concept-1--is-commutative",level:2},{value:"Conclusion:",id:"conclusion",level:3},{value:"Concept 2: <code>:=</code> means assign ALL LHS signals from the RHS, regardless of the direction on the LHS.",id:"concept-2--means-assign-all-lhs-signals-from-the-rhs-regardless-of-the-direction-on-the-lhs",level:2},{value:"Conclusion:",id:"conclusion-1",level:3},{value:"Concept 3: Always Use <code>:=</code> to assign DontCare to Wires",id:"concept-3-always-use--to-assign-dontcare-to-wires",level:2},{value:"Conclusion:",id:"conclusion-2",level:3},{value:"Concept 4: You can use <code>&lt;&gt;</code> or <code>:=</code> to assign <code>DontCare</code> to directioned things (IOs)",id:"concept-4-you-can-use--or--to-assign-dontcare-to-directioned-things-ios",level:2},{value:"Conclusion:",id:"conclusion-3",level:3},{value:"Concept 5: <code>&lt;&gt;</code>  works between things with at least one known flow (An IO or child&#39;s IO).",id:"concept-5---works-between-things-with-at-least-one-known-flow-an-io-or-childs-io",level:2},{value:"Conclusion:",id:"conclusion-4",level:3},{value:"Concept 6: <code>&lt;&gt;</code> and <code>:=</code> connect signals by field name.",id:"concept-6--and--connect-signals-by-field-name",level:2},{value:"Conclusion:",id:"conclusion-5",level:3}];function d(e){const n={a:"a",code:"code",h1:"h1",h2:"h2",h3:"h3",img:"img",p:"p",pre:"pre",...(0,i.R)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.h1,{id:"deep-dive-into-connection-operators",children:"Deep Dive into Connection Operators"}),"\n",(0,t.jsxs)(n.p,{children:["Chisel contains two connection operators, ",(0,t.jsx)(n.code,{children:":="})," and ",(0,t.jsx)(n.code,{children:"<>"}),". This document provides a deeper explanation of the differences of the two and when to use one or the other. The differences are demonstrated with experiments using Scastie examples which use ",(0,t.jsx)(n.code,{children:"DecoupledIO"}),"."]}),"\n",(0,t.jsx)(n.h3,{id:"experiment-setup",children:"Experiment Setup"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"// Imports used by the following examples\nimport chisel3._\nimport chisel3.util.DecoupledIO\nimport circt.stage.ChiselStage\n"})}),"\n",(0,t.jsxs)(n.p,{children:["The diagram for the experiment can be viewed ",(0,t.jsx)(n.a,{href:"https://docs.google.com/document/d/14C918Hdahk2xOGSJJBT-ZVqAx99_hg3JQIq-vaaifQU/edit?usp=sharing",children:"here"}),".\n",(0,t.jsx)(n.img,{src:"https://raw.githubusercontent.com/chipsalliance/chisel3/master/docs/src/images/connection-operators-experiment.svg?sanitize=true",alt:"Experiment Image"})]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"\nclass Wrapper extends Module{\n  val io = IO(new Bundle {\n  val in = Flipped(DecoupledIO(UInt(8.W)))\n  val out = DecoupledIO(UInt(8.W))\n  })\n  val p = Module(new PipelineStage)\n  val c = Module(new PipelineStage)\n  // connect Producer to IO\n  p.io.a <> io.in\n  // connect producer to consumer\n  c.io.a <> p.io.b\n  // connect consumer to IO\n  io.out <> c.io.b\n}\nclass PipelineStage extends Module{\n  val io = IO(new Bundle{\n    val a = Flipped(DecoupledIO(UInt(8.W)))\n    val b = DecoupledIO(UInt(8.W))\n  })\n  io.b <> io.a\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"Below we can see the resulting Verilog for this example:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'ChiselStage.emitSystemVerilog(new Wrapper)\n// res0: String = """// Generated by CIRCT firtool-1.81.1\n// module PipelineStage(\t// connection-operators.md:36:7\n//   output       io_a_ready,\t// connection-operators.md:37:14\n//   input        io_a_valid,\t// connection-operators.md:37:14\n//   input  [7:0] io_a_bits,\t// connection-operators.md:37:14\n//   input        io_b_ready,\t// connection-operators.md:37:14\n//   output       io_b_valid,\t// connection-operators.md:37:14\n//   output [7:0] io_b_bits\t// connection-operators.md:37:14\n// );\n// \n//   assign io_a_ready = io_b_ready;\t// connection-operators.md:36:7\n//   assign io_b_valid = io_a_valid;\t// connection-operators.md:36:7\n//   assign io_b_bits = io_a_bits;\t// connection-operators.md:36:7\n// endmodule\n// \n// module Wrapper(\t// connection-operators.md:20:7\n//   input        clock,\t// connection-operators.md:20:7\n//                reset,\t// connection-operators.md:20:7\n//   output       io_in_ready,\t// connection-operators.md:21:14\n//   input        io_in_valid,\t// connection-operators.md:21:14\n//   input  [7:0] io_in_bits,\t// connection-operators.md:21:14\n//   input        io_out_ready,\t// connection-operators.md:21:14\n//   output       io_out_valid,\t// connection-operators.md:21:14\n//   output [7:0] io_out_bits\t// connection-operators.md:21:14\n// );\n// \n//   wire       _c_io_a_ready;\t// connection-operators.md:26:17\n//   wire       _p_io_b_valid;\t// connection-operators.md:25:17\n//   wire [7:0] _p_io_b_bits;\t// connection-operators.md:25:17\n//   PipelineStage p (\t// connection-operators.md:25:17\n//     .io_a_ready (io_in_ready),\n//     .io_a_valid (io_in_valid),\n//     .io_a_bits  (io_in_bits),\n//     .io_b_ready (_c_io_a_ready),\t// connection-operators.md:26:17\n//     .io_b_valid (_p_io_b_valid),\n//     .io_b_bits  (_p_io_b_bits)\n//   );\t// connection-operators.md:25:17\n//   PipelineStage c (\t// connection-operators.md:26:17\n//     .io_a_ready (_c_io_a_ready),\n//     .io_a_valid (_p_io_b_valid),\t// connection-operators.md:25:17\n//     .io_a_bits  (_p_io_b_bits),\t// connection-operators.md:25:17\n//     .io_b_ready (io_out_ready),\n//     .io_b_valid (io_out_valid),\n//     .io_b_bits  (io_out_bits)\n//   );\t// connection-operators.md:26:17\n// endmodule\n// \n// """\n'})}),"\n",(0,t.jsxs)(n.h2,{id:"concept-1--is-commutative",children:["Concept 1: ",(0,t.jsx)(n.code,{children:"<>"})," is Commutative"]}),"\n",(0,t.jsxs)(n.p,{children:["This experiment is set up to test for the function of ",(0,t.jsx)(n.code,{children:"<>"})," using the experiment above."]}),"\n",(0,t.jsxs)(n.p,{children:["Achieving this involves flipping the RHS and LHS of the ",(0,t.jsx)(n.code,{children:"<>"})," operator and seeing how ",(0,t.jsx)(n.code,{children:"<>"}),"  will react.\n( Scastie link for the experiment:",(0,t.jsx)(n.a,{href:"https://scastie.scala-lang.org/Shorla/LVhlbkFQQnq7X3trHfgZZQ",children:"https://scastie.scala-lang.org/Shorla/LVhlbkFQQnq7X3trHfgZZQ"})," )"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.util.DecoupledIO\nimport circt.stage.ChiselStage\n\nclass Wrapper extends Module{\n  val io = IO(new Bundle {\n  val in = Flipped(DecoupledIO(UInt(8.W)))\n  val out = DecoupledIO(UInt(8.W))\n  })\n  val p = Module(new PipelineStage)\n  val c = Module(new PipelineStage)\n  // connect producer to I/O\n  io.in <> p.io.a\n  // connect producer  to consumer\n  p.io.b <> c.io.a\n  // connect consumer to I/O\n  c.io.b <> io.out\n}\nclass PipelineStage extends Module{\n  val io = IO(new Bundle{\n    val a = Flipped(DecoupledIO(UInt(8.W)))\n    val b = DecoupledIO(UInt(8.W))\n  })\n  io.a <> io.b\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"Below we can see the resulting Verilog for this example:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'ChiselStage.emitSystemVerilog(new Wrapper)\n// res2: String = """// Generated by CIRCT firtool-1.81.1\n// module PipelineStage(\t// connection-operators.md:82:7\n//   output       io_a_ready,\t// connection-operators.md:83:14\n//   input        io_a_valid,\t// connection-operators.md:83:14\n//   input  [7:0] io_a_bits,\t// connection-operators.md:83:14\n//   input        io_b_ready,\t// connection-operators.md:83:14\n//   output       io_b_valid,\t// connection-operators.md:83:14\n//   output [7:0] io_b_bits\t// connection-operators.md:83:14\n// );\n// \n//   assign io_a_ready = io_b_ready;\t// connection-operators.md:82:7\n//   assign io_b_valid = io_a_valid;\t// connection-operators.md:82:7\n//   assign io_b_bits = io_a_bits;\t// connection-operators.md:82:7\n// endmodule\n// \n// module Wrapper(\t// connection-operators.md:66:7\n//   input        clock,\t// connection-operators.md:66:7\n//                reset,\t// connection-operators.md:66:7\n//   output       io_in_ready,\t// connection-operators.md:67:14\n//   input        io_in_valid,\t// connection-operators.md:67:14\n//   input  [7:0] io_in_bits,\t// connection-operators.md:67:14\n//   input        io_out_ready,\t// connection-operators.md:67:14\n//   output       io_out_valid,\t// connection-operators.md:67:14\n//   output [7:0] io_out_bits\t// connection-operators.md:67:14\n// );\n// \n//   wire       _c_io_a_ready;\t// connection-operators.md:72:17\n//   wire       _p_io_b_valid;\t// connection-operators.md:71:17\n//   wire [7:0] _p_io_b_bits;\t// connection-operators.md:71:17\n//   PipelineStage p (\t// connection-operators.md:71:17\n//     .io_a_ready (io_in_ready),\n//     .io_a_valid (io_in_valid),\n//     .io_a_bits  (io_in_bits),\n//     .io_b_ready (_c_io_a_ready),\t// connection-operators.md:72:17\n//     .io_b_valid (_p_io_b_valid),\n//     .io_b_bits  (_p_io_b_bits)\n//   );\t// connection-operators.md:71:17\n//   PipelineStage c (\t// connection-operators.md:72:17\n//     .io_a_ready (_c_io_a_ready),\n//     .io_a_valid (_p_io_b_valid),\t// connection-operators.md:71:17\n//     .io_a_bits  (_p_io_b_bits),\t// connection-operators.md:71:17\n//     .io_b_ready (io_out_ready),\n//     .io_b_valid (io_out_valid),\n//     .io_b_bits  (io_out_bits)\n//   );\t// connection-operators.md:72:17\n// endmodule\n// \n// """\n'})}),"\n",(0,t.jsx)(n.h3,{id:"conclusion",children:"Conclusion:"}),"\n",(0,t.jsxs)(n.p,{children:["The Verilog remained the same without incurring errors, showing that the ",(0,t.jsx)(n.code,{children:"<>"})," operator is commutative."]}),"\n",(0,t.jsxs)(n.h2,{id:"concept-2--means-assign-all-lhs-signals-from-the-rhs-regardless-of-the-direction-on-the-lhs",children:["Concept 2: ",(0,t.jsx)(n.code,{children:":="})," means assign ALL LHS signals from the RHS, regardless of the direction on the LHS."]}),"\n",(0,t.jsxs)(n.p,{children:["Using the same experiment code as above, we set to test for the function of ",(0,t.jsx)(n.code,{children:":="}),"\nWe replace all instances of ",(0,t.jsx)(n.code,{children:"<>"})," with ",(0,t.jsx)(n.code,{children:":="})," in the sample code above.\n(Scastie link to the experiment: ",(0,t.jsx)(n.a,{href:"https://scastie.scala-lang.org/Shorla/o1ShdaY3RWKf0IIFwwQ1UQ/1",children:"https://scastie.scala-lang.org/Shorla/o1ShdaY3RWKf0IIFwwQ1UQ/1"}),")"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.util.DecoupledIO\nimport circt.stage.ChiselStage\n\nclass Wrapper extends Module{\n  val io = IO(new Bundle {\n  val in = Flipped(DecoupledIO(UInt(8.W)))\n  val out = DecoupledIO(UInt(8.W))\n  })\n  val p = Module(new PipelineStage)\n  val c = Module(new PipelineStage)\n  // connect producer to I/O\n  p.io.a := io.in\n  // connect producer  to consumer\n  c.io.a := p.io.b\n  // connect consumer to I/O\n  io.out := c.io.b\n}\nclass PipelineStage extends Module{\n  val io = IO(new Bundle{\n    val a = Flipped(DecoupledIO(UInt(8.W)))\n    val b = DecoupledIO(UInt(8.W))\n  })\n  io.a := io.b\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"Below we can see the resulting error message for this example:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"ChiselStage.emitSystemVerilog(new Wrapper)\n// chisel3.package$ChiselException: Connection between sink (PipelineStage.io.a: IO[DecoupledIO]) and source (PipelineStage.io.b: IO[DecoupledIO]) failed @: .bitsio.a.bits in PipelineStage cannot be written from module PipelineStage.\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp3$PipelineStage.<init>(connection-operators.md:133)\n// \tat repl.MdocSession$MdocApp3$Wrapper$$anonfun$30$$anonfun$apply$20.apply(connection-operators.md:117)\n// \tat repl.MdocSession$MdocApp3$Wrapper$$anonfun$30$$anonfun$apply$20.apply(connection-operators.md:117)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat repl.MdocSession$MdocApp3$Wrapper$$anonfun$30.apply(connection-operators.md:117)\n// \tat repl.MdocSession$MdocApp3$Wrapper$$anonfun$30.apply(connection-operators.md:117)\n// \tat chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)\n// \tat repl.MdocSession$MdocApp3$Wrapper.<init>(connection-operators.md:117)\n// \tat repl.MdocSession$MdocApp3$$anonfun$39$$anonfun$apply$25.apply(connection-operators.md:141)\n// \tat repl.MdocSession$MdocApp3$$anonfun$39$$anonfun$apply$25.apply(connection-operators.md:141)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,t.jsx)(n.h3,{id:"conclusion-1",children:"Conclusion:"}),"\n",(0,t.jsx)(n.p,{children:"The := operator goes field-by-field on the LHS and attempts to connect it to the same-named signal from the RHS. If something on the LHS is actually an Input, or the corresponding signal on the RHS is an Output, you will get an error as shown above."}),"\n",(0,t.jsxs)(n.h2,{id:"concept-3-always-use--to-assign-dontcare-to-wires",children:["Concept 3: Always Use ",(0,t.jsx)(n.code,{children:":="})," to assign DontCare to Wires"]}),"\n",(0,t.jsxs)(n.p,{children:["When assigning ",(0,t.jsx)(n.code,{children:"DontCare"})," to something that is not directioned, should you use ",(0,t.jsx)(n.code,{children:":="})," or ",(0,t.jsx)(n.code,{children:"<>"}),"?\nWe will find out using the sample codes below:\n( Scastie link for the experiment:",(0,t.jsx)(n.a,{href:"https://scastie.scala-lang.org/Shorla/ZIGsWcylRqKJhZCkKWlSIA/1",children:"https://scastie.scala-lang.org/Shorla/ZIGsWcylRqKJhZCkKWlSIA/1"}),")"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.util.DecoupledIO\nimport circt.stage.ChiselStage\n\nclass Wrapper extends Module{\n  val io = IO(new Bundle {\n  val in = Flipped(DecoupledIO(UInt(8.W)))\n  val out = DecoupledIO(UInt(8.W))\n  })\n  val p = Module(new PipelineStage)\n  val c = Module(new PipelineStage)\n  //connect Producer to IO\n  io.in := DontCare\n  p.io.a <> DontCare\n  val tmp = Wire(Flipped(DecoupledIO(UInt(8.W))))\n  tmp := DontCare\n  p.io.a <> io.in\n  // connect producer to consumer\n  c.io.a <> p.io.b\n  //connect consumer to IO\n  io.out <> c.io.b\n}\nclass PipelineStage extends Module{\n  val io = IO(new Bundle{\n    val a = Flipped(DecoupledIO(UInt(8.W)))\n    val b = DecoupledIO(UInt(8.W))\n  })\n  io.b <> io.a\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"Below we can see the resulting Verilog for this example:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'ChiselStage.emitSystemVerilog(new Wrapper)\n// res5: String = """// Generated by CIRCT firtool-1.81.1\n// module PipelineStage(\t// connection-operators.md:182:7\n//   output       io_a_ready,\t// connection-operators.md:183:14\n//   input        io_a_valid,\t// connection-operators.md:183:14\n//   input  [7:0] io_a_bits,\t// connection-operators.md:183:14\n//   input        io_b_ready,\t// connection-operators.md:183:14\n//   output       io_b_valid,\t// connection-operators.md:183:14\n//   output [7:0] io_b_bits\t// connection-operators.md:183:14\n// );\n// \n//   assign io_a_ready = io_b_ready;\t// connection-operators.md:182:7\n//   assign io_b_valid = io_a_valid;\t// connection-operators.md:182:7\n//   assign io_b_bits = io_a_bits;\t// connection-operators.md:182:7\n// endmodule\n// \n// module Wrapper(\t// connection-operators.md:162:7\n//   input        clock,\t// connection-operators.md:162:7\n//                reset,\t// connection-operators.md:162:7\n//   output       io_in_ready,\t// connection-operators.md:163:14\n//   input        io_in_valid,\t// connection-operators.md:163:14\n//   input  [7:0] io_in_bits,\t// connection-operators.md:163:14\n//   input        io_out_ready,\t// connection-operators.md:163:14\n//   output       io_out_valid,\t// connection-operators.md:163:14\n//   output [7:0] io_out_bits\t// connection-operators.md:163:14\n// );\n// \n//   wire       _c_io_a_ready;\t// connection-operators.md:168:17\n//   wire       _p_io_b_valid;\t// connection-operators.md:167:17\n//   wire [7:0] _p_io_b_bits;\t// connection-operators.md:167:17\n//   PipelineStage p (\t// connection-operators.md:167:17\n//     .io_a_ready (io_in_ready),\n//     .io_a_valid (io_in_valid),\n//     .io_a_bits  (io_in_bits),\n//     .io_b_ready (_c_io_a_ready),\t// connection-operators.md:168:17\n//     .io_b_valid (_p_io_b_valid),\n//     .io_b_bits  (_p_io_b_bits)\n//   );\t// connection-operators.md:167:17\n//   PipelineStage c (\t// connection-operators.md:168:17\n//     .io_a_ready (_c_io_a_ready),\n//     .io_a_valid (_p_io_b_valid),\t// connection-operators.md:167:17\n//     .io_a_bits  (_p_io_b_bits),\t// connection-operators.md:167:17\n//     .io_b_ready (io_out_ready),\n//     .io_b_valid (io_out_valid),\n//     .io_b_bits  (io_out_bits)\n//   );\t// connection-operators.md:168:17\n// endmodule\n// \n// """\n'})}),"\n",(0,t.jsx)(n.h3,{id:"conclusion-2",children:"Conclusion:"}),"\n",(0,t.jsxs)(n.p,{children:["If ",(0,t.jsx)(n.code,{children:"<>"})," were used to assign the unidrectioned wire ",(0,t.jsx)(n.code,{children:"tmp"})," to DontCare, we would get an error. But in the example above, we used ",(0,t.jsx)(n.code,{children:":="})," and no errors occurred.\nBut when ",(0,t.jsx)(n.code,{children:":="})," was used to assign the wire to DontCare, no errors will occur."]}),"\n",(0,t.jsxs)(n.p,{children:["Thus, when assigning ",(0,t.jsx)(n.code,{children:"DontCare"})," to a ",(0,t.jsx)(n.code,{children:"Wire"}),", always use ",(0,t.jsx)(n.code,{children:":="}),"."]}),"\n",(0,t.jsxs)(n.h2,{id:"concept-4-you-can-use--or--to-assign-dontcare-to-directioned-things-ios",children:["Concept 4: You can use ",(0,t.jsx)(n.code,{children:"<>"})," or ",(0,t.jsx)(n.code,{children:":="})," to assign ",(0,t.jsx)(n.code,{children:"DontCare"})," to directioned things (IOs)"]}),"\n",(0,t.jsxs)(n.p,{children:["When assigning ",(0,t.jsx)(n.code,{children:"DontCare"})," to something that is directioned, should you use ",(0,t.jsx)(n.code,{children:":="})," or ",(0,t.jsx)(n.code,{children:"<>"}),"?\nWe will find out using the sample codes below:\n( Scastie link for the experiment:",(0,t.jsx)(n.a,{href:"https://scastie.scala-lang.org/Shorla/ZIGsWcylRqKJhZCkKWlSIA/1",children:"https://scastie.scala-lang.org/Shorla/ZIGsWcylRqKJhZCkKWlSIA/1"}),")"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.util.DecoupledIO\nimport circt.stage.ChiselStage\n\nclass Wrapper extends Module{\n  val io = IO(new Bundle {\n  val in = Flipped(DecoupledIO(UInt(8.W)))\n  val out = DecoupledIO(UInt(8.W))\n  })\n  val p = Module(new PipelineStage)\n  val c = Module(new PipelineStage)\n  //connect Producer to IO\n  io.in := DontCare\n  p.io.a <> DontCare\n  val tmp = Wire(Flipped(DecoupledIO(UInt(8.W))))\n  tmp := DontCare\n  p.io.a <> io.in\n  // connect producer to consumer\n  c.io.a <> p.io.b\n  //connect consumer to IO\n  io.out <> c.io.b\n}\nclass PipelineStage extends Module{\n  val io = IO(new Bundle{\n    val a = Flipped(DecoupledIO(UInt(8.W)))\n    val b = DecoupledIO(UInt(8.W))\n  })\n  io.b <> io.a\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"Below we can see the resulting Verilog for this example:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'ChiselStage.emitSystemVerilog(new Wrapper)\n// res7: String = """// Generated by CIRCT firtool-1.81.1\n// module PipelineStage(\t// connection-operators.md:232:7\n//   output       io_a_ready,\t// connection-operators.md:233:14\n//   input        io_a_valid,\t// connection-operators.md:233:14\n//   input  [7:0] io_a_bits,\t// connection-operators.md:233:14\n//   input        io_b_ready,\t// connection-operators.md:233:14\n//   output       io_b_valid,\t// connection-operators.md:233:14\n//   output [7:0] io_b_bits\t// connection-operators.md:233:14\n// );\n// \n//   assign io_a_ready = io_b_ready;\t// connection-operators.md:232:7\n//   assign io_b_valid = io_a_valid;\t// connection-operators.md:232:7\n//   assign io_b_bits = io_a_bits;\t// connection-operators.md:232:7\n// endmodule\n// \n// module Wrapper(\t// connection-operators.md:212:7\n//   input        clock,\t// connection-operators.md:212:7\n//                reset,\t// connection-operators.md:212:7\n//   output       io_in_ready,\t// connection-operators.md:213:14\n//   input        io_in_valid,\t// connection-operators.md:213:14\n//   input  [7:0] io_in_bits,\t// connection-operators.md:213:14\n//   input        io_out_ready,\t// connection-operators.md:213:14\n//   output       io_out_valid,\t// connection-operators.md:213:14\n//   output [7:0] io_out_bits\t// connection-operators.md:213:14\n// );\n// \n//   wire       _c_io_a_ready;\t// connection-operators.md:218:17\n//   wire       _p_io_b_valid;\t// connection-operators.md:217:17\n//   wire [7:0] _p_io_b_bits;\t// connection-operators.md:217:17\n//   PipelineStage p (\t// connection-operators.md:217:17\n//     .io_a_ready (io_in_ready),\n//     .io_a_valid (io_in_valid),\n//     .io_a_bits  (io_in_bits),\n//     .io_b_ready (_c_io_a_ready),\t// connection-operators.md:218:17\n//     .io_b_valid (_p_io_b_valid),\n//     .io_b_bits  (_p_io_b_bits)\n//   );\t// connection-operators.md:217:17\n//   PipelineStage c (\t// connection-operators.md:218:17\n//     .io_a_ready (_c_io_a_ready),\n//     .io_a_valid (_p_io_b_valid),\t// connection-operators.md:217:17\n//     .io_a_bits  (_p_io_b_bits),\t// connection-operators.md:217:17\n//     .io_b_ready (io_out_ready),\n//     .io_b_valid (io_out_valid),\n//     .io_b_bits  (io_out_bits)\n//   );\t// connection-operators.md:218:17\n// endmodule\n// \n// """\n'})}),"\n",(0,t.jsx)(n.h3,{id:"conclusion-3",children:"Conclusion:"}),"\n",(0,t.jsxs)(n.p,{children:["Both ",(0,t.jsx)(n.code,{children:"<>"})," and ",(0,t.jsx)(n.code,{children:":="})," can be used to assign directioned things (IOs) to DontCare as shown in ",(0,t.jsx)(n.code,{children:"io.in"})," and ",(0,t.jsx)(n.code,{children:"p.io.a"})," respectively. This is basically equivalent because in this case both ",(0,t.jsx)(n.code,{children:"<>"})," and ",(0,t.jsx)(n.code,{children:":="})," will determine the direction from the LHS."]}),"\n",(0,t.jsxs)(n.h2,{id:"concept-5---works-between-things-with-at-least-one-known-flow-an-io-or-childs-io",children:["Concept 5: ",(0,t.jsx)(n.code,{children:"<>"}),"  works between things with at least one known flow (An IO or child's IO)."]}),"\n",(0,t.jsxs)(n.p,{children:["If there is at least one known flow what will ",(0,t.jsx)(n.code,{children:"<>"})," do? This will be shown using the experiment code below:\n( Scastie link for the experiment:",(0,t.jsx)(n.a,{href:"https://scastie.scala-lang.org/Shorla/gKx9ReLVTTqDTk9vmw5ozg",children:"https://scastie.scala-lang.org/Shorla/gKx9ReLVTTqDTk9vmw5ozg"}),")"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.util.DecoupledIO\nimport circt.stage.ChiselStage\n\nclass Wrapper extends Module{\n  val io = IO(new Bundle {\n  val in = Flipped(DecoupledIO(UInt(8.W)))\n  val out = DecoupledIO(UInt(8.W))\n  })\n  val p = Module(new PipelineStage)\n  val c = Module(new PipelineStage)\n  //connect Producer to IO\n    // For this experiment, we add a temporary wire and see if it works...\n  //p.io.a <> io.in\n  val tmp = Wire(DecoupledIO(UInt(8.W)))\n  // connect intermediate wire\n  tmp <> io.in\n  p.io.a <> tmp\n  // connect producer to consumer\n  c.io.a <> p.io.b\n  //connect consumer to IO\n  io.out <> c.io.b\n}\nclass PipelineStage extends Module{\n  val io = IO(new Bundle{\n    val a = Flipped(DecoupledIO(UInt(8.W)))\n    val b = DecoupledIO(UInt(8.W))\n  })\n  io.b <> io.a\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"Below we can see the resulting Verilog for this example:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'ChiselStage.emitSystemVerilog(new Wrapper)\n// res9: String = """// Generated by CIRCT firtool-1.81.1\n// module PipelineStage(\t// connection-operators.md:283:7\n//   output       io_a_ready,\t// connection-operators.md:284:14\n//   input        io_a_valid,\t// connection-operators.md:284:14\n//   input  [7:0] io_a_bits,\t// connection-operators.md:284:14\n//   input        io_b_ready,\t// connection-operators.md:284:14\n//   output       io_b_valid,\t// connection-operators.md:284:14\n//   output [7:0] io_b_bits\t// connection-operators.md:284:14\n// );\n// \n//   assign io_a_ready = io_b_ready;\t// connection-operators.md:283:7\n//   assign io_b_valid = io_a_valid;\t// connection-operators.md:283:7\n//   assign io_b_bits = io_a_bits;\t// connection-operators.md:283:7\n// endmodule\n// \n// module Wrapper(\t// connection-operators.md:262:7\n//   input        clock,\t// connection-operators.md:262:7\n//                reset,\t// connection-operators.md:262:7\n//   output       io_in_ready,\t// connection-operators.md:263:14\n//   input        io_in_valid,\t// connection-operators.md:263:14\n//   input  [7:0] io_in_bits,\t// connection-operators.md:263:14\n//   input        io_out_ready,\t// connection-operators.md:263:14\n//   output       io_out_valid,\t// connection-operators.md:263:14\n//   output [7:0] io_out_bits\t// connection-operators.md:263:14\n// );\n// \n//   wire       _c_io_a_ready;\t// connection-operators.md:268:17\n//   wire       _p_io_b_valid;\t// connection-operators.md:267:17\n//   wire [7:0] _p_io_b_bits;\t// connection-operators.md:267:17\n//   PipelineStage p (\t// connection-operators.md:267:17\n//     .io_a_ready (io_in_ready),\n//     .io_a_valid (io_in_valid),\n//     .io_a_bits  (io_in_bits),\n//     .io_b_ready (_c_io_a_ready),\t// connection-operators.md:268:17\n//     .io_b_valid (_p_io_b_valid),\n//     .io_b_bits  (_p_io_b_bits)\n//   );\t// connection-operators.md:267:17\n//   PipelineStage c (\t// connection-operators.md:268:17\n//     .io_a_ready (_c_io_a_ready),\n//     .io_a_valid (_p_io_b_valid),\t// connection-operators.md:267:17\n//     .io_a_bits  (_p_io_b_bits),\t// connection-operators.md:267:17\n//     .io_b_ready (io_out_ready),\n//     .io_b_valid (io_out_valid),\n//     .io_b_bits  (io_out_bits)\n//   );\t// connection-operators.md:268:17\n// endmodule\n// \n// """\n'})}),"\n",(0,t.jsx)(n.h3,{id:"conclusion-4",children:"Conclusion:"}),"\n",(0,t.jsxs)(n.p,{children:["The connection above went smoothly with no errors, this goes to show ",(0,t.jsx)(n.code,{children:"<>"}),' will work as long as there is at least one directioned thing (IO or submodule\'s IO) to "fix" the direction.']}),"\n",(0,t.jsxs)(n.h2,{id:"concept-6--and--connect-signals-by-field-name",children:["Concept 6: ",(0,t.jsx)(n.code,{children:"<>"})," and ",(0,t.jsx)(n.code,{children:":="})," connect signals by field name."]}),"\n",(0,t.jsxs)(n.p,{children:["This experiment creates a MockDecoupledIO which has the same fields by name as a DecoupledIO. Chisel lets us connect it and produces the same verilog, even though MockDecoupledIO and DecoupledIO are different types.\n( Scastie link for the experiment:",(0,t.jsx)(n.a,{href:"https://scastie.scala-lang.org/Uf4tQquvQYigZAW705NFIQ",children:"https://scastie.scala-lang.org/Uf4tQquvQYigZAW705NFIQ"}),")"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.util.DecoupledIO\nimport circt.stage.ChiselStage\n\nclass MockDecoupledIO extends Bundle {\n  val valid = Output(Bool())\n  val ready = Input(Bool())\n  val bits = Output(UInt(8.W))\n}\nclass Wrapper extends Module{\n  val io = IO(new Bundle {\n  val in = Flipped(new MockDecoupledIO())\n  val out = new MockDecoupledIO()\n  })\n  val p = Module(new PipelineStage)\n  val c = Module(new PipelineStage)\n  // connect producer to I/O\n  p.io.a <> io.in\n  // connect producer  to consumer\n  c.io.a <> p.io.b\n  // connect consumer to I/O\n  io.out <> c.io.b\n}\nclass PipelineStage extends Module{\n  val io = IO(new Bundle{\n    val a = Flipped(DecoupledIO(UInt(8.W)))\n    val b = DecoupledIO(UInt(8.W))\n  })\n  io.a <> io.b\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"Below we can see the resulting Verilog for this example:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'ChiselStage.emitSystemVerilog(new Wrapper)\n// res11: String = """// Generated by CIRCT firtool-1.81.1\n// module PipelineStage(\t// connection-operators.md:336:7\n//   output       io_a_ready,\t// connection-operators.md:337:14\n//   input        io_a_valid,\t// connection-operators.md:337:14\n//   input  [7:0] io_a_bits,\t// connection-operators.md:337:14\n//   input        io_b_ready,\t// connection-operators.md:337:14\n//   output       io_b_valid,\t// connection-operators.md:337:14\n//   output [7:0] io_b_bits\t// connection-operators.md:337:14\n// );\n// \n//   assign io_a_ready = io_b_ready;\t// connection-operators.md:336:7\n//   assign io_b_valid = io_a_valid;\t// connection-operators.md:336:7\n//   assign io_b_bits = io_a_bits;\t// connection-operators.md:336:7\n// endmodule\n// \n// module Wrapper(\t// connection-operators.md:320:7\n//   input        clock,\t// connection-operators.md:320:7\n//                reset,\t// connection-operators.md:320:7\n//                io_in_valid,\t// connection-operators.md:321:14\n//   output       io_in_ready,\t// connection-operators.md:321:14\n//   input  [7:0] io_in_bits,\t// connection-operators.md:321:14\n//   output       io_out_valid,\t// connection-operators.md:321:14\n//   input        io_out_ready,\t// connection-operators.md:321:14\n//   output [7:0] io_out_bits\t// connection-operators.md:321:14\n// );\n// \n//   wire       _c_io_a_ready;\t// connection-operators.md:326:17\n//   wire       _p_io_b_valid;\t// connection-operators.md:325:17\n//   wire [7:0] _p_io_b_bits;\t// connection-operators.md:325:17\n//   PipelineStage p (\t// connection-operators.md:325:17\n//     .io_a_ready (io_in_ready),\n//     .io_a_valid (io_in_valid),\n//     .io_a_bits  (io_in_bits),\n//     .io_b_ready (_c_io_a_ready),\t// connection-operators.md:326:17\n//     .io_b_valid (_p_io_b_valid),\n//     .io_b_bits  (_p_io_b_bits)\n//   );\t// connection-operators.md:325:17\n//   PipelineStage c (\t// connection-operators.md:326:17\n//     .io_a_ready (_c_io_a_ready),\n//     .io_a_valid (_p_io_b_valid),\t// connection-operators.md:325:17\n//     .io_a_bits  (_p_io_b_bits),\t// connection-operators.md:325:17\n//     .io_b_ready (io_out_ready),\n//     .io_b_valid (io_out_valid),\n//     .io_b_bits  (io_out_bits)\n//   );\t// connection-operators.md:326:17\n// endmodule\n// \n// """\n'})}),"\n",(0,t.jsxs)(n.p,{children:["And here is another experiment, where we remove one of the fields of MockDecoupledIO:\n( Scastie link for the experiment:",(0,t.jsx)(n.a,{href:"https://scastie.scala-lang.org/ChtkhKCpS9CvJkjjqpdeIA",children:"https://scastie.scala-lang.org/ChtkhKCpS9CvJkjjqpdeIA"}),")"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.util.DecoupledIO\nimport circt.stage.ChiselStage\n\nclass MockDecoupledIO extends Bundle {\n  val valid = Output(Bool())\n  val ready = Input(Bool())\n  //val bits = Output(UInt(8.W))\n}\nclass Wrapper extends Module{\n  val io = IO(new Bundle {\n  val in = Flipped(new MockDecoupledIO())\n  val out = new MockDecoupledIO()\n  })\n  val p = Module(new PipelineStage)\n  val c = Module(new PipelineStage)\n  // connect producer to I/O\n  p.io.a <> io.in\n  // connect producer  to consumer\n  c.io.a <> p.io.b\n  // connect consumer to I/O\n  io.out <> c.io.b\n}\nclass PipelineStage extends Module{\n  val io = IO(new Bundle{\n    val a = Flipped(DecoupledIO(UInt(8.W)))\n    val b = DecoupledIO(UInt(8.W))\n  })\n  io.a <> io.b\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"Below we can see the resulting error for this example:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"ChiselStage.emitSystemVerilog(new Wrapper)\n// chisel3.package$ChiselException: Connection between left (PipelineStage.io.a: IO[DecoupledIO]) and source (Wrapper.io.in: IO[MockDecoupledIO]) failed @.bits: Right Record missing field (bits).\n// \tat ... ()\n// \tat repl.MdocSession$MdocApp12$Wrapper.<init>(connection-operators.md:381)\n// \tat repl.MdocSession$MdocApp12$$anonfun$119$$anonfun$apply$79.apply(connection-operators.md:402)\n// \tat repl.MdocSession$MdocApp12$$anonfun$119$$anonfun$apply$79.apply(connection-operators.md:402)\n// \tat chisel3.Module$.evaluate(Module.scala:94)\n// \tat chisel3.Module$.do_apply(Module.scala:37)\n// \tat chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)\n// \tat chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat chisel3.internal.Builder$.buildImpl(Builder.scala:1071)\n// \tat chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)\n// \tat logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)\n// \tat scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)\n// \tat logger.Logger$.makeScope(Logger.scala:146)\n// \tat logger.Logger$.makeScope(Logger.scala:133)\n// \tat ... ()\n// \tat ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)\n"})}),"\n",(0,t.jsxs)(n.p,{children:["This one fails because there is a field ",(0,t.jsx)(n.code,{children:"bits"})," missing."]}),"\n",(0,t.jsx)(n.h3,{id:"conclusion-5",children:"Conclusion:"}),"\n",(0,t.jsxs)(n.p,{children:["For ",(0,t.jsx)(n.code,{children:":="}),", the Scala types do not need to match but all the signals on the LHS must be provided by the RHS or you will get a Chisel elaboration error. There may be additional signals on the RHS, these will be ignored. For ",(0,t.jsx)(n.code,{children:"<>"}),", the Scala types do not need to match, but all signals must match exactly between LHS and RHS. In both cases, the order of the fields does not matter."]})]})}function p(e={}){const{wrapper:n}={...(0,i.R)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(d,{...e})}):d(e)}},8453:(e,n,o)=>{o.d(n,{R:()=>c,x:()=>r});var t=o(6540);const i={},a=t.createContext(i);function c(e){const n=t.useContext(a);return t.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function r(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(i):e.components||i:c(e.components),t.createElement(a.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/d4b6d0e6.3905c761.js b/assets/js/d4b6d0e6.3905c761.js
new file mode 100644
index 0000000000..ea74ae52ff
--- /dev/null
+++ b/assets/js/d4b6d0e6.3905c761.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[4166],{3205:(e,n,i)=>{i.r(n),i.d(n,{assets:()=>a,contentTitle:()=>s,default:()=>h,frontMatter:()=>o,metadata:()=>r,toc:()=>c});var t=i(4848),l=i(8453);const o={layout:"docs",title:"Connectable Operators",section:"chisel3"},s=void 0,r={id:"explanations/connectable",title:"Connectable Operators",description:"Table of Contents",source:"@site/docs/explanations/connectable.md",sourceDirName:"explanations",slug:"/explanations/connectable",permalink:"/docs/explanations/connectable",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/connectable.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Connectable Operators",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Combinational Circuits",permalink:"/docs/explanations/combinational-circuits"},next:{title:"Deep Dive into <> and := Connection Operators",permalink:"/docs/explanations/connection-operators"}},a={},c=[{value:"Table of Contents",id:"table-of-contents",level:2},{value:"Terminology",id:"terminology",level:2},{value:"Overview",id:"overview",level:2},{value:"Alignment: Flipped vs Aligned",id:"alignment-flipped-vs-aligned",level:2},{value:"Input/Output",id:"inputoutput",level:2},{value:"Connecting components with fully aligned members",id:"connecting-components-with-fully-aligned-members",level:2},{value:"Mono-direction connection operator (:=)",id:"mono-direction-connection-operator-",level:3},{value:"Connecting components with mixed alignment members",id:"connecting-components-with-mixed-alignment-members",level:2},{value:"Bi-direction connection operator (<code>:&lt;&gt;=</code>)",id:"bi-direction-connection-operator-",level:3},{value:"Port-Direction Computation versus Connection-Direction Computation",id:"port-direction-computation-versus-connection-direction-computation",level:3},{value:"Aligned connection operator (<code>:&lt;=</code>)",id:"aligned-connection-operator-",level:3},{value:"Flipped connection operator (<code>:&gt;=</code>)",id:"flipped-connection-operator-",level:3},{value:"Coercing mono-direction connection operator (<code>:#=</code>)",id:"coercing-mono-direction-connection-operator-",level:3},{value:"Connectable",id:"connectable",level:2},{value:"Connecting Records",id:"connecting-records",level:3},{value:"Defaults with waived connections",id:"defaults-with-waived-connections",level:3},{value:"Connecting types with optional members",id:"connecting-types-with-optional-members",level:3},{value:"Always ignore errors caused by extra members (partial connection operator)",id:"always-ignore-errors-caused-by-extra-members-partial-connection-operator",level:3},{value:"Connecting components with different widths",id:"connecting-components-with-different-widths",level:3},{value:"Excluding members from any operator on a Connectable",id:"excluding-members-from-any-operator-on-a-connectable",level:3},{value:"Techniques for connecting structurally inequivalent Chisel types",id:"techniques-for-connecting-structurally-inequivalent-chisel-types",level:2},{value:"Connecting different sub-types of the same super-type, with colliding names",id:"connecting-different-sub-types-of-the-same-super-type-with-colliding-names",level:3},{value:"Connecting sub-types to super-types by waiving extra members",id:"connecting-sub-types-to-super-types-by-waiving-extra-members",level:3},{value:"Connecting different sub-types",id:"connecting-different-sub-types",level:3},{value:"FAQ",id:"faq",level:2},{value:"How do I connect two items as flexibly as possible (try your best but never error)",id:"how-do-i-connect-two-items-as-flexibly-as-possible-try-your-best-but-never-error",level:3},{value:"How do I connect two items but don&#39;t care about the Scala types being equivalent?",id:"how-do-i-connect-two-items-but-dont-care-about-the-scala-types-being-equivalent",level:3}];function d(e){const n={a:"a",blockquote:"blockquote",code:"code",em:"em",h2:"h2",h3:"h3",li:"li",p:"p",pre:"pre",ul:"ul",...(0,l.R)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.h2,{id:"table-of-contents",children:"Table of Contents"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"#terminology",children:"Terminology"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"#overview",children:"Overview"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"#alignment-flipped-vs-aligned",children:"Alignment: Flipped vs Aligned"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"#inputoutput",children:"Input/Output"})}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.a,{href:"#connecting-components-with-fully-aligned-members",children:"Connecting components with fully aligned members"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsx)(n.li,{children:(0,t.jsxs)(n.a,{href:"#mono-direction-connection-operator-",children:["Mono-direction connection operator (",(0,t.jsx)(n.code,{children:":="}),")"]})}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.a,{href:"#connecting-components-with-mixed-alignment-members",children:"Connecting components with mixed alignment members"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsx)(n.li,{children:(0,t.jsxs)(n.a,{href:"#bi-direction-connection-operator-",children:["Bi-direction connection operator (",(0,t.jsx)(n.code,{children:":<>="}),")"]})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"#port-direction-computation-versus-connection-direction-computation",children:"Port-Direction Computation versus Connection-Direction Computation"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsxs)(n.a,{href:"#aligned-connection-operator-",children:["Aligned connection operator (",(0,t.jsx)(n.code,{children:":<="}),")"]})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsxs)(n.a,{href:"#flipped-connection-operator-",children:["Flipped connection operator (",(0,t.jsx)(n.code,{children:":>="}),")"]})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsxs)(n.a,{href:"#coercing-mono-direction-connection-operator-",children:["Coercing mono-direction connection operator (",(0,t.jsx)(n.code,{children:":#="}),")"]})}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.a,{href:"#connectable",children:"Connectable"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"#connecting-records",children:"Connecting Records"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"#defaults-with-waived-connections",children:"Defaults with waived connections"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"#connecting-types-with-optional-members",children:"Connecting types with optional members"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"#always-ignore-errors-caused-by-extra-members-partial-connection-operator",children:"Always ignore extra members (partial connection operator)"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"#connecting-components-with-different-widths",children:"Connecting components with different widths"})}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.a,{href:"#techniques-for-connecting-structurally-inequivalent-chisel-types",children:"Techniques for connecting structurally inequivalent Chisel types"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"#connecting-different-sub-types-of-the-same-super-type-with-colliding-names",children:"Connecting different sub-types of the same super-type, with colliding names"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"#connecting-sub-types-to-super-types-by-waiving-extra-members",children:"Connecting sub-types to super-types by waiving extra members"})}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"#connecting-different-sub-types",children:"Connecting different sub-types"})}),"\n"]}),"\n"]}),"\n",(0,t.jsx)(n.li,{children:(0,t.jsx)(n.a,{href:"#faq",children:"FAQ"})}),"\n"]}),"\n",(0,t.jsx)(n.h2,{id:"terminology",children:"Terminology"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:['"Chisel type" - a ',(0,t.jsx)(n.code,{children:"Data"})," that is not bound to hardware, i.e. not a component. (more details ",(0,t.jsx)(n.a,{href:"chisel-type-vs-scala-type",children:"here"}),").","\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:["E.g. ",(0,t.jsx)(n.code,{children:"UInt(3.W)"}),", ",(0,t.jsx)(n.code,{children:"new Bundle {..}"}),", ",(0,t.jsx)(n.code,{children:"Vec(3, SInt(2.W))"})," are all Chisel types"]}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:['"component" - a ',(0,t.jsx)(n.code,{children:"Data"})," that is bound to hardware (",(0,t.jsx)(n.code,{children:"IO"}),", ",(0,t.jsx)(n.code,{children:"Reg"}),", ",(0,t.jsx)(n.code,{children:"Wire"}),", etc.)","\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:["E.g. ",(0,t.jsx)(n.code,{children:"Wire(UInt(3.W))"})," is a component, whose Chisel type is ",(0,t.jsx)(n.code,{children:"UInt(3.W)"})]}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"Aggregate"})," - a Chisel type or component that contains other Chisel types or components (i.e. ",(0,t.jsx)(n.code,{children:"Vec"}),", ",(0,t.jsx)(n.code,{children:"Record"}),", or ",(0,t.jsx)(n.code,{children:"Bundle"}),")"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"Element"})," - a Chisel type or component that does not contain other Chisel types or components (e.g. ",(0,t.jsx)(n.code,{children:"UInt"}),", ",(0,t.jsx)(n.code,{children:"SInt"}),", ",(0,t.jsx)(n.code,{children:"Clock"}),", ",(0,t.jsx)(n.code,{children:"Bool"})," etc.)"]}),"\n",(0,t.jsxs)(n.li,{children:['"member" - a Chisel type or component, or any of its children (could be an ',(0,t.jsx)(n.code,{children:"Aggregate"})," or an ",(0,t.jsx)(n.code,{children:"Element"}),")","\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:["E.g. ",(0,t.jsx)(n.code,{children:"Vec(3, UInt(2.W))(0)"})," is a member of the parent ",(0,t.jsx)(n.code,{children:"Vec"})," Chisel type"]}),"\n",(0,t.jsxs)(n.li,{children:["E.g. ",(0,t.jsx)(n.code,{children:"Wire(Vec(3, UInt(2.W)))(0)"})," is a member of the parent ",(0,t.jsx)(n.code,{children:"Wire"})," component"]}),"\n",(0,t.jsxs)(n.li,{children:["E.g. ",(0,t.jsx)(n.code,{children:"IO(Decoupled(Bool)).ready"})," is a member of the parent ",(0,t.jsx)(n.code,{children:"IO"})," component"]}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:['"relative alignment" - whether two members of the same component or Chisel type are aligned/flipped, relative to one another',"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:["see section ",(0,t.jsx)(n.a,{href:"#alignment-flipped-vs-aligned",children:"below"})," for a detailed definition"]}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:['"structural type check" - Chisel type ',(0,t.jsx)(n.code,{children:"A"})," is structurally equivalent to Chisel type ",(0,t.jsx)(n.code,{children:"B"})," if ",(0,t.jsx)(n.code,{children:"A"})," and ",(0,t.jsx)(n.code,{children:"B"})," have matching bundle field names and types (",(0,t.jsx)(n.code,{children:"Record"})," vs ",(0,t.jsx)(n.code,{children:"Vector"})," vs ",(0,t.jsx)(n.code,{children:"Element"}),"), probe modifiers (probe vs nonprobe), vector sizes, ",(0,t.jsx)(n.code,{children:"Element"})," types (UInt/SInt/Bool/Clock)","\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsx)(n.li,{children:"ignores relative alignment (flippedness)"}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:['"alignment type check" - a Chisel type ',(0,t.jsx)(n.code,{children:"A"})," matches alignment with another Chisel type ",(0,t.jsx)(n.code,{children:"B"})," if every member of ",(0,t.jsx)(n.code,{children:"A"}),"'s relative alignment to ",(0,t.jsx)(n.code,{children:"A"})," is the same as the structurally corresponding member of ",(0,t.jsx)(n.code,{children:"B"}),"'s relative alignment to ",(0,t.jsx)(n.code,{children:"B"}),"."]}),"\n"]}),"\n",(0,t.jsx)(n.h2,{id:"overview",children:"Overview"}),"\n",(0,t.jsxs)(n.p,{children:["The ",(0,t.jsx)(n.code,{children:"Connectable"})," operators are the standard way to connect Chisel hardware components to one another."]}),"\n",(0,t.jsxs)(n.blockquote,{children:["\n",(0,t.jsxs)(n.p,{children:["Note: For descriptions of the semantics for the previous operators, see ",(0,t.jsx)(n.a,{href:"connection-operators",children:(0,t.jsx)(n.code,{children:"Connection Operators"})}),"."]}),"\n"]}),"\n",(0,t.jsx)(n.p,{children:"All connection operators require the two hardware components (consumer and producer) to be structurally type equivalent."}),"\n",(0,t.jsxs)(n.p,{children:["The one exception to the structural type-equivalence rule is using the ",(0,t.jsx)(n.code,{children:"Connectable"})," mechanism, detailed at this ",(0,t.jsx)(n.a,{href:"#techniques-for-connecting-structurally-inequivalent-chisel-types",children:"section"})," towards the end of this document."]}),"\n",(0,t.jsxs)(n.p,{children:["Aggregate (",(0,t.jsx)(n.code,{children:"Record"}),", ",(0,t.jsx)(n.code,{children:"Vec"}),", ",(0,t.jsx)(n.code,{children:"Bundle"}),") Chisel types can include data members which are flipped relative to one another.\nDue to this, there are many desired connection behaviors between two Chisel components.\nThe following are the Chisel connection operators between a consumer ",(0,t.jsx)(n.code,{children:"c"})," and producer ",(0,t.jsx)(n.code,{children:"p"}),":"]}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"c := p"})," (mono-direction): connects all ",(0,t.jsx)(n.code,{children:"p"})," members to ",(0,t.jsx)(n.code,{children:"c"}),"; requires ",(0,t.jsx)(n.code,{children:"c"})," and ",(0,t.jsx)(n.code,{children:"p"})," to not have any flipped members"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"c :#= p"})," (coercing mono-direction): connects all ",(0,t.jsx)(n.code,{children:"p"})," members to ",(0,t.jsx)(n.code,{children:"c"}),"; regardless of alignment"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"c :<= p"})," (aligned-direction): connects all aligned (non-flipped) ",(0,t.jsx)(n.code,{children:"c"})," members from ",(0,t.jsx)(n.code,{children:"p"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"c :>= p"})," (flipped-direction): connects all flipped ",(0,t.jsx)(n.code,{children:"p"})," members from ",(0,t.jsx)(n.code,{children:"c"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"c :<>= p"})," (bi-direction operator): connects all aligned ",(0,t.jsx)(n.code,{children:"c"})," members from ",(0,t.jsx)(n.code,{children:"p"}),"; all flipped ",(0,t.jsx)(n.code,{children:"p"})," members from ",(0,t.jsx)(n.code,{children:"c"})]}),"\n"]}),"\n",(0,t.jsx)(n.p,{children:"These operators may appear to be a random collection of symbols; however, the characters are consistent between operators and self-describe the semantics of each operator:"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:":"})," always indicates the consumer, or left-hand-side, of the operator."]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"="})," always indicates the producer, or right-hand-side, of the operator.","\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:["Hence, ",(0,t.jsx)(n.code,{children:"c := p"})," connects a consumer (",(0,t.jsx)(n.code,{children:"c"}),") and a producer (",(0,t.jsx)(n.code,{children:"p"}),")."]}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"<"})," always indicates that some members will be driven producer-to-consumer, or right-to-left.","\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:["Hence, ",(0,t.jsx)(n.code,{children:"c :<= p"})," drives members in producer (",(0,t.jsx)(n.code,{children:"p"}),") to members in consumer (",(0,t.jsx)(n.code,{children:"c"}),")."]}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:">"})," always indicates that some signals will be driven consumer-to-producer, or left-to-right.","\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:["Hence, ",(0,t.jsx)(n.code,{children:"c :>= p"})," drives members in consumer (",(0,t.jsx)(n.code,{children:"c"}),") to members producer (",(0,t.jsx)(n.code,{children:"p"}),")."]}),"\n",(0,t.jsxs)(n.li,{children:["Hence, ",(0,t.jsx)(n.code,{children:"c :<>= p"})," both drives members from ",(0,t.jsx)(n.code,{children:"p"})," to ",(0,t.jsx)(n.code,{children:"c"})," and from ",(0,t.jsx)(n.code,{children:"c"})," to ",(0,t.jsx)(n.code,{children:"p"}),"."]}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"#"})," always indicates to ignore member alignment and to drive producer-to-consumer, or right-to-left.","\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:["Hence, ",(0,t.jsx)(n.code,{children:"c :#= p"})," always drives members from ",(0,t.jsx)(n.code,{children:"p"})," to ",(0,t.jsx)(n.code,{children:"c"})," ignoring direction."]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,t.jsxs)(n.blockquote,{children:["\n",(0,t.jsxs)(n.p,{children:["Note: in addition, an operator that ends in ",(0,t.jsx)(n.code,{children:"="})," has assignment-precedence, which means that ",(0,t.jsx)(n.code,{children:"x :<>= y + z"})," will translate to ",(0,t.jsx)(n.code,{children:"x :<>= (y + z)"}),", rather than ",(0,t.jsx)(n.code,{children:"(x :<>= y) + z"}),".\nThis was not true of the ",(0,t.jsx)(n.code,{children:"<>"})," operator and was a minor painpoint for users."]}),"\n"]}),"\n",(0,t.jsx)(n.h2,{id:"alignment-flipped-vs-aligned",children:"Alignment: Flipped vs Aligned"}),"\n",(0,t.jsxs)(n.p,{children:["A member's alignment is a relative property: a member is aligned/flipped relative to another member of the same component or Chisel type.\nHence, one must always say whether a member is flipped/aligned ",(0,t.jsx)(n.em,{children:"with respect to (w.r.t)"})," another member of that type (parent, sibling, child etc.)."]}),"\n",(0,t.jsxs)(n.p,{children:["We use the following example of a non-nested bundle ",(0,t.jsx)(n.code,{children:"Parent"})," to let us state all of the alignment relationships between members of ",(0,t.jsx)(n.code,{children:"p"}),"."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nclass Parent extends Bundle {\n  val alignedChild = UInt(32.W)\n  val flippedChild = Flipped(UInt(32.W))\n}\nclass MyModule0 extends Module {\n  val p = Wire(new Parent)\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"First, every member is always aligned with themselves:"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"p"})," is aligned w.r.t ",(0,t.jsx)(n.code,{children:"p"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"p.alignedChild"})," is aligned w.r.t ",(0,t.jsx)(n.code,{children:"p.alignedChild"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"p.flippedChild"})," is aligned w.r.t ",(0,t.jsx)(n.code,{children:"p.flippedChild"})]}),"\n"]}),"\n",(0,t.jsxs)(n.p,{children:["Next, we list all parent/child relationships.\nBecause the ",(0,t.jsx)(n.code,{children:"flippedChild"})," field is ",(0,t.jsx)(n.code,{children:"Flipped"}),", it changes its alignment relative to its parent."]}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"p"})," is aligned w.r.t ",(0,t.jsx)(n.code,{children:"p.alignedChild"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"p"})," is flipped w.r.t ",(0,t.jsx)(n.code,{children:"p.flippedChild"})]}),"\n"]}),"\n",(0,t.jsx)(n.p,{children:"Finally, we can list all sibling relationships:"}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"p.alignedChild"})," is flipped w.r.t ",(0,t.jsx)(n.code,{children:"p.flippedChild"})]}),"\n"]}),"\n",(0,t.jsxs)(n.p,{children:["The next example has a nested bundle ",(0,t.jsx)(n.code,{children:"GrandParent"})," who instantiates an aligned ",(0,t.jsx)(n.code,{children:"Parent"})," field and flipped ",(0,t.jsx)(n.code,{children:"Parent"})," field."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nclass GrandParent extends Bundle {\n  val alignedParent = new Parent\n  val flippedParent = Flipped(new Parent)\n}\nclass MyModule1 extends Module {\n  val g = Wire(new GrandParent)\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"Consider the following alignments between grandparent and grandchildren.\nAn odd number of flips indicate a flipped relationship; even numbers of flips indicate an aligned relationship."}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"g"})," is aligned w.r.t ",(0,t.jsx)(n.code,{children:"g.flippedParent.flippedChild"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"g"})," is aligned w.r.t ",(0,t.jsx)(n.code,{children:"g.alignedParent.alignedChild"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"g"})," is flipped w.r.t ",(0,t.jsx)(n.code,{children:"g.flippedParent.alignedChild"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"g"})," is flipped w.r.t ",(0,t.jsx)(n.code,{children:"g.alignedParent.flippedChild"})]}),"\n"]}),"\n",(0,t.jsxs)(n.p,{children:["Consider the following alignment relationships starting from ",(0,t.jsx)(n.code,{children:"g.alignedParent"})," and ",(0,t.jsx)(n.code,{children:"g.flippedParent"}),".\n",(0,t.jsxs)(n.em,{children:["Note that whether ",(0,t.jsx)(n.code,{children:"g.alignedParent"})," is aligned/flipped relative to ",(0,t.jsx)(n.code,{children:"g"})," has no effect on the aligned/flipped relationship between ",(0,t.jsx)(n.code,{children:"g.alignedParent"})," and ",(0,t.jsx)(n.code,{children:"g.alignedParent.alignedChild"})," because alignment is only relative to the two members in question!"]}),":"]}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"g.alignedParent"})," is aligned w.r.t. ",(0,t.jsx)(n.code,{children:"g.alignedParent.alignedChild"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"g.flippedParent"})," is aligned w.r.t. ",(0,t.jsx)(n.code,{children:"g.flippedParent.alignedChild"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"g.alignedParent"})," is flipped w.r.t. ",(0,t.jsx)(n.code,{children:"g.alignedParent.flippedChild"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"g.flippedParent"})," is flipped w.r.t. ",(0,t.jsx)(n.code,{children:"g.flippedParent.flippedChild"})]}),"\n"]}),"\n",(0,t.jsxs)(n.p,{children:["In summary, a member is aligned or flipped w.r.t. another member of the hardware component.\nThis means that the type of the consumer/producer is the only information needed to determine the behavior of any operator.\n",(0,t.jsx)(n.em,{children:"Whether the consumer/producer is a member of a larger bundle is irrelevant; you ONLY need to know the type of the consumer/producer"}),"."]}),"\n",(0,t.jsx)(n.h2,{id:"inputoutput",children:"Input/Output"}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.code,{children:"Input(gen)"}),"/",(0,t.jsx)(n.code,{children:"Output(gen)"})," are coercing operators.\nThey perform two functions: (1) create a new Chisel type that has all flips removed from all recursive children members (still structurally equivalent to ",(0,t.jsx)(n.code,{children:"gen"})," but no longer alignment type equivalent), and (2) apply ",(0,t.jsx)(n.code,{children:"Flipped"})," if ",(0,t.jsx)(n.code,{children:"Input"}),", keep aligned (do nothing) if ",(0,t.jsx)(n.code,{children:"Output"}),".\nE.g. if we imagine a function called ",(0,t.jsx)(n.code,{children:"cloneChiselTypeButStripAllFlips"}),", then ",(0,t.jsx)(n.code,{children:"Input(gen)"})," is structurally and alignment type equivalent to ",(0,t.jsx)(n.code,{children:"Flipped(cloneChiselTypeButStripAllFlips(gen))"}),"."]}),"\n",(0,t.jsxs)(n.p,{children:["Note that if ",(0,t.jsx)(n.code,{children:"gen"})," is a non-aggregate, then ",(0,t.jsx)(n.code,{children:"Input(nonAggregateGen)"})," is equivalent to ",(0,t.jsx)(n.code,{children:"Flipped(nonAggregateGen)"}),"."]}),"\n",(0,t.jsxs)(n.blockquote,{children:["\n",(0,t.jsxs)(n.p,{children:["Future work will refactor how these primitives are exposed to the user to make Chisel's type system more intuitive.\nSee [",(0,t.jsx)(n.a,{href:"https://github.com/chipsalliance/chisel3/issues/2643",children:"https://github.com/chipsalliance/chisel3/issues/2643"}),"]."]}),"\n"]}),"\n",(0,t.jsx)(n.p,{children:"With this in mind, we can consider the following examples and detail relative alignments of members."}),"\n",(0,t.jsxs)(n.p,{children:["First, we can use a similar example to ",(0,t.jsx)(n.code,{children:"Parent"})," but use ",(0,t.jsx)(n.code,{children:"Input/Output"})," instead of ",(0,t.jsx)(n.code,{children:"Flipped"}),".\nBecause ",(0,t.jsx)(n.code,{children:"alignedChild"})," and ",(0,t.jsx)(n.code,{children:"flippedChild"})," are non-aggregates, ",(0,t.jsx)(n.code,{children:"Input"})," is basically just a ",(0,t.jsx)(n.code,{children:"Flipped"})," and thus the alignments are unchanged compared to the previous ",(0,t.jsx)(n.code,{children:"Parent"})," example."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nclass ParentWithOutputInput extends Bundle {\n  val alignedCoerced = Output(UInt(32.W)) // Equivalent to just UInt(32.W)\n  val flippedCoerced = Input(UInt(32.W))  // Equivalent to Flipped(UInt(32.W))\n}\nclass MyModule2 extends Module {\n  val p = Wire(new ParentWithOutputInput)\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["The alignments are the same as the previous ",(0,t.jsx)(n.code,{children:"Parent"})," example:"]}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"p"})," is aligned w.r.t ",(0,t.jsx)(n.code,{children:"p"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"p.alignedCoerced"})," is aligned w.r.t ",(0,t.jsx)(n.code,{children:"p.alignedCoerced"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"p.flippedCoerced"})," is aligned w.r.t ",(0,t.jsx)(n.code,{children:"p.flippedCoerced"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"p"})," is aligned w.r.t ",(0,t.jsx)(n.code,{children:"p.alignedCoerced"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"p"})," is flipped w.r.t ",(0,t.jsx)(n.code,{children:"p.flippedCoerced"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"p.alignedCoerced"})," is flipped w.r.t ",(0,t.jsx)(n.code,{children:"p.flippedCoerced"})]}),"\n"]}),"\n",(0,t.jsxs)(n.p,{children:["The next example has a nested bundle ",(0,t.jsx)(n.code,{children:"GrandParent"})," who instantiates an ",(0,t.jsx)(n.code,{children:"Output"})," ",(0,t.jsx)(n.code,{children:"ParentWithOutputInput"})," field and an ",(0,t.jsx)(n.code,{children:"Input"})," ",(0,t.jsx)(n.code,{children:"ParentWithOutputInput"})," field."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nclass GrandParentWithOutputInput extends Bundle {\n  val alignedCoerced = Output(new ParentWithOutputInput)\n  val flippedCoerced = Input(new ParentWithOutputInput)\n}\nclass MyModule3 extends Module {\n  val g = Wire(new GrandParentWithOutputInput)\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["Remember that ",(0,t.jsx)(n.code,{children:"Output(gen)/Input(gen)"})," recursively strips the ",(0,t.jsx)(n.code,{children:"Flipped"})," of any recursive children.\nThis makes every member of ",(0,t.jsx)(n.code,{children:"gen"})," aligned with every other member of ",(0,t.jsx)(n.code,{children:"gen"}),"."]}),"\n",(0,t.jsxs)(n.p,{children:["Consider the following alignments between grandparent and grandchildren.\nBecause ",(0,t.jsx)(n.code,{children:"alignedCoerced"})," and ",(0,t.jsx)(n.code,{children:"flippedCoerced"})," are aligned with all their recursive members, they are fully aligned.\nThus, only their alignment to ",(0,t.jsx)(n.code,{children:"g"})," influences grandchildren alignment:"]}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"g"})," is aligned w.r.t ",(0,t.jsx)(n.code,{children:"g.alignedCoerced.alignedCoerced"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"g"})," is aligned w.r.t ",(0,t.jsx)(n.code,{children:"g.alignedCoerced.flippedCoerced"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"g"})," is flipped w.r.t ",(0,t.jsx)(n.code,{children:"g.flippedCoerced.alignedCoerced"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"g"})," is flipped w.r.t ",(0,t.jsx)(n.code,{children:"g.flippedCoerced.flippedCoerced"})]}),"\n"]}),"\n",(0,t.jsxs)(n.p,{children:["Consider the following alignment relationships starting from ",(0,t.jsx)(n.code,{children:"g.alignedCoerced"})," and ",(0,t.jsx)(n.code,{children:"g.flippedCoerced"}),".\n",(0,t.jsxs)(n.em,{children:["Note that whether ",(0,t.jsx)(n.code,{children:"g.alignedCoerced"})," is aligned/flipped relative to ",(0,t.jsx)(n.code,{children:"g"})," has no effect on the aligned/flipped relationship between ",(0,t.jsx)(n.code,{children:"g.alignedCoerced"})," and ",(0,t.jsx)(n.code,{children:"g.alignedCoerced.alignedCoerced"})," or ",(0,t.jsx)(n.code,{children:"g.alignedCoerced.flippedCoerced"})," because alignment is only relative to the two members in question! However, because alignment is coerced, everything is aligned between ",(0,t.jsx)(n.code,{children:"g.alignedCoerced"}),"/",(0,t.jsx)(n.code,{children:"g.flippedAligned"})," and their children"]}),":"]}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"g.alignedCoerced"})," is aligned w.r.t. ",(0,t.jsx)(n.code,{children:"g.alignedCoerced.alignedCoerced"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"g.alignedCoerced"})," is aligned w.r.t. ",(0,t.jsx)(n.code,{children:"g.alignedCoerced.flippedCoerced"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"g.flippedCoerced"})," is aligned w.r.t. ",(0,t.jsx)(n.code,{children:"g.flippedCoerced.alignedCoerced"})]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"g.flippedCoerced"})," is aligned w.r.t. ",(0,t.jsx)(n.code,{children:"g.flippedCoerced.flippedCoerced"})]}),"\n"]}),"\n",(0,t.jsxs)(n.p,{children:["In summary, ",(0,t.jsx)(n.code,{children:"Input(gen)"})," and ",(0,t.jsx)(n.code,{children:"Output(gen)"})," recursively coerce children alignment, as well as dictate ",(0,t.jsx)(n.code,{children:"gen"}),"'s alignment to its parent bundle (if it exists)."]}),"\n",(0,t.jsx)(n.h2,{id:"connecting-components-with-fully-aligned-members",children:"Connecting components with fully aligned members"}),"\n",(0,t.jsx)(n.h3,{id:"mono-direction-connection-operator-",children:"Mono-direction connection operator (:=)"}),"\n",(0,t.jsxs)(n.p,{children:["For simple connections where all members are aligned (non-flipped) w.r.t. one another, use ",(0,t.jsx)(n.code,{children:":="}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nclass FullyAlignedBundle extends Bundle {\n  val a = Bool()\n  val b = Bool()\n}\nclass Example0 extends RawModule {\n  val incoming = IO(Flipped(new FullyAlignedBundle))\n  val outgoing = IO(new FullyAlignedBundle)\n  outgoing := incoming\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["This generates the following Verilog, where each member of ",(0,t.jsx)(n.code,{children:"incoming"})," drives every member of ",(0,t.jsx)(n.code,{children:"outgoing"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example0(\t// connectable.md:85:7\n  input  incoming_a,\t// connectable.md:86:20\n         incoming_b,\t// connectable.md:86:20\n  output outgoing_a,\t// connectable.md:87:20\n         outgoing_b\t// connectable.md:87:20\n);\n\n  assign outgoing_a = incoming_a;\t// connectable.md:85:7\n  assign outgoing_b = incoming_b;\t// connectable.md:85:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example0_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example0_Verification.sv"\n`ifndef layers_Example0_Verification_Cover\n`define layers_Example0_Verification_Cover\t// <stdin>:6:5\n`endif // layers_Example0_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example0_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example0_Verification.sv"\n`ifndef layers_Example0_Verification_Assume\n`define layers_Example0_Verification_Assume\t// <stdin>:5:5\n`endif // layers_Example0_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example0_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example0_Verification.sv"\n`ifndef layers_Example0_Verification_Assert\n`define layers_Example0_Verification_Assert\t// <stdin>:4:5\n`endif // layers_Example0_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_Example0_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example0_Verification\n`define layers_Example0_Verification\t// <stdin>:3:3\n`endif // layers_Example0_Verification\t// <stdin>:3:3\n'})}),"\n",(0,t.jsxs)(n.blockquote,{children:["\n",(0,t.jsxs)(n.p,{children:["You may be thinking \"Wait, I'm confused! Isn't ",(0,t.jsx)(n.code,{children:"incoming"})," flipped and ",(0,t.jsx)(n.code,{children:"outgoing"}),' aligned?" -- Noo! Whether ',(0,t.jsx)(n.code,{children:"incoming"})," is aligned with ",(0,t.jsx)(n.code,{children:"outgoing"})," makes no sense; remember, you only evaluate alignment between members of the same component or Chisel type.\nBecause components are always aligned to themselves, ",(0,t.jsx)(n.code,{children:"outgoing"})," is aligned to ",(0,t.jsx)(n.code,{children:"outgoing"}),", and ",(0,t.jsx)(n.code,{children:"incoming"})," is aligned to ",(0,t.jsx)(n.code,{children:"incoming"}),", there is no problem.\nTheir relative flippedness to anything else is irrelevant."]}),"\n"]}),"\n",(0,t.jsx)(n.h2,{id:"connecting-components-with-mixed-alignment-members",children:"Connecting components with mixed alignment members"}),"\n",(0,t.jsxs)(n.p,{children:["Aggregate Chisel types can include data members which are flipped relative to one another; in the example below, ",(0,t.jsx)(n.code,{children:"alignedChild"})," and ",(0,t.jsx)(n.code,{children:"flippedChild"})," are aligned/flipped relative to ",(0,t.jsx)(n.code,{children:"MixedAlignmentBundle"}),"."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nclass MixedAlignmentBundle extends Bundle {\n  val alignedChild = Bool()\n  val flippedChild = Flipped(Bool())\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["Due to this, there are many desired connection behaviors between two Chisel components.\nFirst we will introduce the most common Chisel connection operator, ",(0,t.jsx)(n.code,{children:":<>="}),", useful for connecting components with members of mixed-alignments, then take a moment to investigate a common source of confusion between port-direction and connection-direction.\nThen, we will explore the remainder of the Chisel connection operators."]}),"\n",(0,t.jsxs)(n.h3,{id:"bi-direction-connection-operator-",children:["Bi-direction connection operator (",(0,t.jsx)(n.code,{children:":<>="}),")"]}),"\n",(0,t.jsxs)(n.p,{children:["For connections where you want 'bulk-connect-like-semantics' where the aligned members are driven producer-to-consumer and flipped members are driven consumer-to-producer, use ",(0,t.jsx)(n.code,{children:":<>="}),"."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class Example1 extends RawModule {\n  val incoming = IO(Flipped(new MixedAlignmentBundle))\n  val outgoing = IO(new MixedAlignmentBundle)\n  outgoing :<>= incoming\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["This generates the following Verilog, where the aligned members are driven ",(0,t.jsx)(n.code,{children:"incoming"})," to ",(0,t.jsx)(n.code,{children:"outgoing"})," and flipped members are driven ",(0,t.jsx)(n.code,{children:"outgoing"})," to ",(0,t.jsx)(n.code,{children:"incoming"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example1(\t// connectable.md:113:7\n  input  incoming_alignedChild,\t// connectable.md:114:20\n  output incoming_flippedChild,\t// connectable.md:114:20\n         outgoing_alignedChild,\t// connectable.md:115:20\n  input  outgoing_flippedChild\t// connectable.md:115:20\n);\n\n  assign incoming_flippedChild = outgoing_flippedChild;\t// connectable.md:113:7\n  assign outgoing_alignedChild = incoming_alignedChild;\t// connectable.md:113:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example1_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example1_Verification.sv"\n`ifndef layers_Example1_Verification_Cover\n`define layers_Example1_Verification_Cover\t// <stdin>:6:5\n`endif // layers_Example1_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example1_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example1_Verification.sv"\n`ifndef layers_Example1_Verification_Assume\n`define layers_Example1_Verification_Assume\t// <stdin>:5:5\n`endif // layers_Example1_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example1_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example1_Verification.sv"\n`ifndef layers_Example1_Verification_Assert\n`define layers_Example1_Verification_Assert\t// <stdin>:4:5\n`endif // layers_Example1_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_Example1_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example1_Verification\n`define layers_Example1_Verification\t// <stdin>:3:3\n`endif // layers_Example1_Verification\t// <stdin>:3:3\n'})}),"\n",(0,t.jsx)(n.h3,{id:"port-direction-computation-versus-connection-direction-computation",children:"Port-Direction Computation versus Connection-Direction Computation"}),"\n",(0,t.jsxs)(n.p,{children:["A common question is if you use a mixed-alignment connection (such as ",(0,t.jsx)(n.code,{children:":<>="}),") to connect submembers of parent components, does the alignment of the submember to their parent affect anything? The answer is no, because ",(0,t.jsx)(n.em,{children:"alignment is always computed relative to what is being connected to, and members are always aligned with themselves."})]}),"\n",(0,t.jsxs)(n.p,{children:["In the following example connecting from ",(0,t.jsx)(n.code,{children:"incoming.alignedChild"})," to ",(0,t.jsx)(n.code,{children:"outgoing.alignedChild"}),", whether ",(0,t.jsx)(n.code,{children:"incoming.alignedChild"})," is aligned with ",(0,t.jsx)(n.code,{children:"incoming"})," is irrelevant because the ",(0,t.jsx)(n.code,{children:":<>="})," only computes alignment relative to the thing being connected to, and ",(0,t.jsx)(n.code,{children:"incoming.alignedChild"})," is aligned with ",(0,t.jsx)(n.code,{children:"incoming.alignedChild"}),"."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class Example1a extends RawModule {\n  val incoming = IO(Flipped(new MixedAlignmentBundle))\n  val outgoing = IO(new MixedAlignmentBundle)\n  outgoing.alignedChild :<>= incoming.alignedChild // whether incoming.alignedChild is aligned/flipped to incoming is IRRELEVANT to what gets connected with :<>=\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["While ",(0,t.jsx)(n.code,{children:"incoming.flippedChild"}),"'s alignment with ",(0,t.jsx)(n.code,{children:"incoming"})," does not affect our operators, it does influence whether ",(0,t.jsx)(n.code,{children:"incoming.flippedChild"})," is an output or input port of my module.\nA common source of confusion is to mistake the process for determining whether ",(0,t.jsx)(n.code,{children:"incoming.flippedChild"})," will resolve to a Verilog ",(0,t.jsx)(n.code,{children:"output"}),"/",(0,t.jsx)(n.code,{children:"input"})," (the port-direction computation) with the process for determining how ",(0,t.jsx)(n.code,{children:":<>="})," drives what with what (the connection-direction computation).\nWhile both processes consider relative alignment, they are distinct."]}),"\n",(0,t.jsxs)(n.p,{children:["The port-direction computation always computes alignment relative to the component marked with ",(0,t.jsx)(n.code,{children:"IO"}),".\nAn ",(0,t.jsx)(n.code,{children:"IO(Flipped(gen))"})," is an incoming port, and any member of ",(0,t.jsx)(n.code,{children:"gen"})," that is aligned/flipped with ",(0,t.jsx)(n.code,{children:"gen"})," is an incoming/outgoing port.\nAn ",(0,t.jsx)(n.code,{children:"IO(gen)"})," is an outgoing port, and any member of ",(0,t.jsx)(n.code,{children:"gen"})," that is aligned/flipped with ",(0,t.jsx)(n.code,{children:"gen"})," is an outgoing/incoming port."]}),"\n",(0,t.jsxs)(n.p,{children:["The connection-direction computation always computes alignment based on the explicit consumer/producer referenced for the connection.\nIf one connects ",(0,t.jsx)(n.code,{children:"incoming :<>= outgoing"}),", alignments are computed based on ",(0,t.jsx)(n.code,{children:"incoming"})," and ",(0,t.jsx)(n.code,{children:"outgoing"}),".\nIf one connects ",(0,t.jsx)(n.code,{children:"incoming.alignedChild :<>= outgoing.alignedChild"}),", then alignments are computed based on ",(0,t.jsx)(n.code,{children:"incoming.alignedChild"})," and ",(0,t.jsx)(n.code,{children:"outgoing.alignedChild"})," (and the alignment of ",(0,t.jsx)(n.code,{children:"incoming"})," to ",(0,t.jsx)(n.code,{children:"incoming.alignedChild"})," is irrelevant)."]}),"\n",(0,t.jsxs)(n.p,{children:["This means that users can try to connect to input ports of their module! If I write ",(0,t.jsx)(n.code,{children:"x :<>= y"}),", and ",(0,t.jsx)(n.code,{children:"x"})," is an input to the current module, then that is what the connection is trying to do.\nHowever, because input ports are not drivable from within the current module, Chisel will throw an error.\nThis is the same error a user would get using a mono-directioned operator: ",(0,t.jsx)(n.code,{children:"x := y"})," will throw the same error if ",(0,t.jsx)(n.code,{children:"x"})," is an input to the current module.\n",(0,t.jsx)(n.em,{children:"Whether a component is drivable is irrelevant to the semantics of any connection operator attempting to drive to it."})]}),"\n",(0,t.jsxs)(n.p,{children:["In summary, the port-direction computation is relative to the root marked ",(0,t.jsx)(n.code,{children:"IO"}),", but connection-direction computation is relative to the consumer/producer that the connection is doing.\nThis has the positive property that connection semantics are solely based on the Chisel structural type and its relative alignments of the consumer/producer (nothing more, nothing less)."]}),"\n",(0,t.jsxs)(n.h3,{id:"aligned-connection-operator-",children:["Aligned connection operator (",(0,t.jsx)(n.code,{children:":<="}),")"]}),"\n",(0,t.jsxs)(n.p,{children:["For connections where you want the aligned-half of 'bulk-connect-like-semantics' where the aligned members are driven producer-to-consumer and flipped members are ignored, use ",(0,t.jsx)(n.code,{children:":<="}),' (the "aligned connection").']}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class Example2 extends RawModule {\n  val incoming = IO(Flipped(new MixedAlignmentBundle))\n  val outgoing = IO(new MixedAlignmentBundle)\n  incoming.flippedChild := DontCare // Otherwise FIRRTL throws an uninitialization error\n  outgoing :<= incoming\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["This generates the following Verilog, where the aligned members are driven ",(0,t.jsx)(n.code,{children:"incoming"})," to ",(0,t.jsx)(n.code,{children:"outgoing"})," and flipped members are ignored:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example2(\t// connectable.md:139:7\n  input  incoming_alignedChild,\t// connectable.md:140:20\n  output incoming_flippedChild,\t// connectable.md:140:20\n         outgoing_alignedChild,\t// connectable.md:141:20\n  input  outgoing_flippedChild\t// connectable.md:141:20\n);\n\n  assign incoming_flippedChild = 1\'h0;\t// connectable.md:139:7\n  assign outgoing_alignedChild = incoming_alignedChild;\t// connectable.md:139:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example2_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example2_Verification.sv"\n`ifndef layers_Example2_Verification_Cover\n`define layers_Example2_Verification_Cover\t// <stdin>:6:5\n`endif // layers_Example2_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example2_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example2_Verification.sv"\n`ifndef layers_Example2_Verification_Assume\n`define layers_Example2_Verification_Assume\t// <stdin>:5:5\n`endif // layers_Example2_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example2_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example2_Verification.sv"\n`ifndef layers_Example2_Verification_Assert\n`define layers_Example2_Verification_Assert\t// <stdin>:4:5\n`endif // layers_Example2_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_Example2_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example2_Verification\n`define layers_Example2_Verification\t// <stdin>:3:3\n`endif // layers_Example2_Verification\t// <stdin>:3:3\n'})}),"\n",(0,t.jsxs)(n.h3,{id:"flipped-connection-operator-",children:["Flipped connection operator (",(0,t.jsx)(n.code,{children:":>="}),")"]}),"\n",(0,t.jsxs)(n.p,{children:["For connections where you want the flipped-half of 'bulk-connect-like-semantics' where the aligned members are ignored and flipped members are connected consumer-to-producer, use ",(0,t.jsx)(n.code,{children:":>="}),' (the "flipped connection", or "backpressure connection").']}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class Example3 extends RawModule {\n  val incoming = IO(Flipped(new MixedAlignmentBundle))\n  val outgoing = IO(new MixedAlignmentBundle)\n  outgoing.alignedChild := DontCare // Otherwise FIRRTL throws an uninitialization error\n  outgoing :>= incoming\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["This generates the following Verilog, where the aligned members are ignored and the flipped members are driven ",(0,t.jsx)(n.code,{children:"outgoing"})," to ",(0,t.jsx)(n.code,{children:"incoming"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example3(\t// connectable.md:156:7\n  input  incoming_alignedChild,\t// connectable.md:157:20\n  output incoming_flippedChild,\t// connectable.md:157:20\n         outgoing_alignedChild,\t// connectable.md:158:20\n  input  outgoing_flippedChild\t// connectable.md:158:20\n);\n\n  assign incoming_flippedChild = outgoing_flippedChild;\t// connectable.md:156:7\n  assign outgoing_alignedChild = 1\'h0;\t// connectable.md:156:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example3_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example3_Verification.sv"\n`ifndef layers_Example3_Verification_Cover\n`define layers_Example3_Verification_Cover\t// <stdin>:6:5\n`endif // layers_Example3_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example3_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example3_Verification.sv"\n`ifndef layers_Example3_Verification_Assume\n`define layers_Example3_Verification_Assume\t// <stdin>:5:5\n`endif // layers_Example3_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example3_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example3_Verification.sv"\n`ifndef layers_Example3_Verification_Assert\n`define layers_Example3_Verification_Assert\t// <stdin>:4:5\n`endif // layers_Example3_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_Example3_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example3_Verification\n`define layers_Example3_Verification\t// <stdin>:3:3\n`endif // layers_Example3_Verification\t// <stdin>:3:3\n'})}),"\n",(0,t.jsxs)(n.blockquote,{children:["\n",(0,t.jsxs)(n.p,{children:["Note: Astute observers will realize that ",(0,t.jsx)(n.code,{children:"c :<>= p"})," is semantically equivalent to ",(0,t.jsx)(n.code,{children:"c :<= p"})," followed by ",(0,t.jsx)(n.code,{children:"c :>= p"}),"."]}),"\n"]}),"\n",(0,t.jsxs)(n.h3,{id:"coercing-mono-direction-connection-operator-",children:["Coercing mono-direction connection operator (",(0,t.jsx)(n.code,{children:":#="}),")"]}),"\n",(0,t.jsxs)(n.p,{children:["For connections where you want to every producer member to always drive every consumer member, regardless of alignment, use ",(0,t.jsx)(n.code,{children:":#="}),' (the "coercion connection").\nThis operator is useful for initializing wires whose types contain members of mixed alignment.']}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3.experimental.BundleLiterals._\nclass Example4 extends RawModule {\n  val w = Wire(new MixedAlignmentBundle)\n  dontTouch(w) // So we see it in the output Verilog\n  w :#= (new MixedAlignmentBundle).Lit(_.alignedChild -> true.B, _.flippedChild -> true.B)\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["This generates the following Verilog, where all members are driven from the literal to ",(0,t.jsx)(n.code,{children:"w"}),", regardless of alignment:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example4();\t// connectable.md:176:7\n  wire w_alignedChild = 1\'h1;\t// connectable.md:177:15\n  wire w_flippedChild = 1\'h1;\t// connectable.md:177:15\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example4_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example4_Verification.sv"\n`ifndef layers_Example4_Verification_Cover\n`define layers_Example4_Verification_Cover\t// <stdin>:15:5\n`endif // layers_Example4_Verification_Cover\t// <stdin>:15:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example4_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example4_Verification.sv"\n`ifndef layers_Example4_Verification_Assume\n`define layers_Example4_Verification_Assume\t// <stdin>:14:5\n`endif // layers_Example4_Verification_Assume\t// <stdin>:14:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example4_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example4_Verification.sv"\n`ifndef layers_Example4_Verification_Assert\n`define layers_Example4_Verification_Assert\t// <stdin>:13:5\n`endif // layers_Example4_Verification_Assert\t// <stdin>:13:5\n\n// ----- 8< ----- FILE "Verification/layers_Example4_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example4_Verification\n`define layers_Example4_Verification\t// <stdin>:12:3\n`endif // layers_Example4_Verification\t// <stdin>:12:3\n'})}),"\n",(0,t.jsxs)(n.blockquote,{children:["\n",(0,t.jsxs)(n.p,{children:["Note: Astute observers will realize that ",(0,t.jsx)(n.code,{children:"c :#= p"})," is semantically equivalent to ",(0,t.jsx)(n.code,{children:"c :<= p"})," followed by ",(0,t.jsx)(n.code,{children:"p :>= c"})," (note ",(0,t.jsx)(n.code,{children:"p"})," and ",(0,t.jsx)(n.code,{children:"c"})," switched places in the second connection)."]}),"\n"]}),"\n",(0,t.jsxs)(n.p,{children:["Another use case for ",(0,t.jsx)(n.code,{children:":#="})," is for connecting a mixed-directional bundle to a fully-aligned monitor."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3.experimental.BundleLiterals._\nclass Example4b extends RawModule {\n  val monitor = IO(Output(new MixedAlignmentBundle))\n  val w = Wire(new MixedAlignmentBundle)\n  dontTouch(w) // So we see it in the output Verilog\n  w :#= DontCare\n  monitor :#= w\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["This generates the following Verilog, where all members are driven from the literal to ",(0,t.jsx)(n.code,{children:"w"}),", regardless of alignment:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example4b(\t// connectable.md:195:7\n  output monitor_alignedChild,\t// connectable.md:196:19\n         monitor_flippedChild\t// connectable.md:196:19\n);\n\n  wire w_alignedChild = 1\'h0;\t// connectable.md:197:15\n  wire w_flippedChild = 1\'h0;\t// connectable.md:197:15\n  assign monitor_alignedChild = w_alignedChild;\t// connectable.md:195:7, :197:15\n  assign monitor_flippedChild = w_flippedChild;\t// connectable.md:195:7, :197:15\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example4b_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example4b_Verification.sv"\n`ifndef layers_Example4b_Verification_Cover\n`define layers_Example4b_Verification_Cover\t// <stdin>:15:5\n`endif // layers_Example4b_Verification_Cover\t// <stdin>:15:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example4b_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example4b_Verification.sv"\n`ifndef layers_Example4b_Verification_Assume\n`define layers_Example4b_Verification_Assume\t// <stdin>:14:5\n`endif // layers_Example4b_Verification_Assume\t// <stdin>:14:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example4b_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example4b_Verification.sv"\n`ifndef layers_Example4b_Verification_Assert\n`define layers_Example4b_Verification_Assert\t// <stdin>:13:5\n`endif // layers_Example4b_Verification_Assert\t// <stdin>:13:5\n\n// ----- 8< ----- FILE "Verification/layers_Example4b_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example4b_Verification\n`define layers_Example4b_Verification\t// <stdin>:12:3\n`endif // layers_Example4b_Verification\t// <stdin>:12:3\n'})}),"\n",(0,t.jsx)(n.h2,{id:"connectable",children:"Connectable"}),"\n",(0,t.jsxs)(n.p,{children:["Sometimes a user wants to connect Chisel components which are not type equivalent.\nFor example, a user may want to hook up anonymous ",(0,t.jsx)(n.code,{children:"Record"})," components who may have an intersection of their fields being equivalent, but cannot because they are not structurally equivalent.\nAlternatively, one may want to connect two types that have different widths."]}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.code,{children:"Connectable"})," is the mechanism to specialize connection operator behavior in these scenarios.\nFor additional members which are not present in the other component being connected to, or for mismatched widths, or for always excluding a member from being connected to, they can be explicitly called out from the ",(0,t.jsx)(n.code,{children:"Connectable"})," object, rather than trigger an error."]}),"\n",(0,t.jsxs)(n.p,{children:["In addition, there are other techniques that can be used to address similar use cases including ",(0,t.jsx)(n.code,{children:".viewAsSuperType"}),", a static cast to a supertype (e.g. ",(0,t.jsx)(n.code,{children:"(x: T)"}),"), or creating a custom ",(0,t.jsx)(n.code,{children:"DataView"}),".\nFor a discussion about when to use each technique, please continue ",(0,t.jsx)(n.a,{href:"#techniques-for-connecting-structurally-inequivalent-chisel-types",children:"here"}),"."]}),"\n",(0,t.jsxs)(n.p,{children:["This section demonstrates how ",(0,t.jsx)(n.code,{children:"Connectable"})," specifically can be used in a multitude of scenarios."]}),"\n",(0,t.jsx)(n.h3,{id:"connecting-records",children:"Connecting Records"}),"\n",(0,t.jsxs)(n.p,{children:["One use case is to try to connect two ",(0,t.jsx)(n.code,{children:"Record"}),"s; for matching members, they should be connected, but for unmatched members, the errors caused due to them being unmatched should be ignored.\nTo accomplish this, use the other operators to initialize all ",(0,t.jsx)(n.code,{children:"Record"})," members, then use ",(0,t.jsx)(n.code,{children:":<>="})," with ",(0,t.jsx)(n.code,{children:".waive"})," to connect only the matching members."]}),"\n",(0,t.jsxs)(n.blockquote,{children:["\n",(0,t.jsxs)(n.p,{children:["Note that none of ",(0,t.jsx)(n.code,{children:".viewAsSuperType"}),", static casts, nor a custom ",(0,t.jsx)(n.code,{children:"DataView"})," helps this case because the Scala types are still ",(0,t.jsx)(n.code,{children:"Record"}),"."]}),"\n"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'import scala.collection.immutable.SeqMap\n\nclass Example9 extends RawModule {\n  val abType = new Record { val elements = SeqMap("a" -> Bool(), "b" -> Flipped(Bool())) }\n  val bcType = new Record { val elements = SeqMap("b" -> Flipped(Bool()), "c" -> Bool()) }\n\n  val p = IO(Flipped(abType))\n  val c = IO(bcType)\n\n  DontCare :>= p\n  c :<= DontCare\n\n  c.waive(_.elements("c")):<>= p.waive(_.elements("a"))\n}\n'})}),"\n",(0,t.jsxs)(n.p,{children:["This generates the following Verilog, where ",(0,t.jsx)(n.code,{children:"p.b"})," is driven from ",(0,t.jsx)(n.code,{children:"c.b"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example9(\t// connectable.md:216:7\n  output p_b,\t// connectable.md:220:13\n  input  p_a,\t// connectable.md:220:13\n  output c_c,\t// connectable.md:221:13\n  input  c_b\t// connectable.md:221:13\n);\n\n  assign p_b = c_b;\t// connectable.md:216:7\n  assign c_c = 1\'h0;\t// connectable.md:216:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example9_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example9_Verification.sv"\n`ifndef layers_Example9_Verification_Cover\n`define layers_Example9_Verification_Cover\t// <stdin>:6:5\n`endif // layers_Example9_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example9_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example9_Verification.sv"\n`ifndef layers_Example9_Verification_Assume\n`define layers_Example9_Verification_Assume\t// <stdin>:5:5\n`endif // layers_Example9_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example9_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example9_Verification.sv"\n`ifndef layers_Example9_Verification_Assert\n`define layers_Example9_Verification_Assert\t// <stdin>:4:5\n`endif // layers_Example9_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_Example9_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example9_Verification\n`define layers_Example9_Verification\t// <stdin>:3:3\n`endif // layers_Example9_Verification\t// <stdin>:3:3\n'})}),"\n",(0,t.jsx)(n.h3,{id:"defaults-with-waived-connections",children:"Defaults with waived connections"}),"\n",(0,t.jsxs)(n.p,{children:["Another use case is to try to connect two ",(0,t.jsx)(n.code,{children:"Record"}),"s; for matching members, they should be connected, but for unmatched members, ",(0,t.jsx)(n.em,{children:"they should be connected to a default value"}),".\nTo accomplish this, use the other operators to initialize all ",(0,t.jsx)(n.code,{children:"Record"})," members, then use ",(0,t.jsx)(n.code,{children:":<>="})," with ",(0,t.jsx)(n.code,{children:".waive"})," to connect only the matching members."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'import scala.collection.immutable.SeqMap\n\nclass Example10 extends RawModule {\n  val abType = new Record { val elements = SeqMap("a" -> Bool(), "b" -> Flipped(Bool())) }\n  val bcType = new Record { val elements = SeqMap("b" -> Flipped(Bool()), "c" -> Bool()) }\n\n  val p = Wire(abType)\n  val c = Wire(bcType)\n\n  dontTouch(p) // So it doesn\'t get constant-propped away for the example\n  dontTouch(c) // So it doesn\'t get constant-propped away for the example\n\n  p :#= abType.Lit(_.elements("a") -> true.B, _.elements("b") -> true.B)\n  c :#= bcType.Lit(_.elements("b") -> true.B, _.elements("c") -> true.B)\n\n  c.waive(_.elements("c")) :<>= p.waive(_.elements("a"))\n}\n'})}),"\n",(0,t.jsxs)(n.p,{children:["This generates the following Verilog, where ",(0,t.jsx)(n.code,{children:"p.b"})," is driven from ",(0,t.jsx)(n.code,{children:"c.b"}),", and ",(0,t.jsx)(n.code,{children:"p.a"}),", ",(0,t.jsx)(n.code,{children:"c.b"}),", and ",(0,t.jsx)(n.code,{children:"c.c"})," are initialized to default values:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example10();\t// connectable.md:242:7\n  wire p_a = 1\'h1;\t// connectable.md:246:15\n  wire c_c = 1\'h1;\t// connectable.md:247:15\n  wire c_b = 1\'h1;\t// connectable.md:247:15\n  wire p_b = c_b;\t// connectable.md:246:15, :247:15\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example10_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example10_Verification.sv"\n`ifndef layers_Example10_Verification_Cover\n`define layers_Example10_Verification_Cover\t// <stdin>:23:5\n`endif // layers_Example10_Verification_Cover\t// <stdin>:23:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example10_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example10_Verification.sv"\n`ifndef layers_Example10_Verification_Assume\n`define layers_Example10_Verification_Assume\t// <stdin>:22:5\n`endif // layers_Example10_Verification_Assume\t// <stdin>:22:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example10_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example10_Verification.sv"\n`ifndef layers_Example10_Verification_Assert\n`define layers_Example10_Verification_Assert\t// <stdin>:21:5\n`endif // layers_Example10_Verification_Assert\t// <stdin>:21:5\n\n// ----- 8< ----- FILE "Verification/layers_Example10_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example10_Verification\n`define layers_Example10_Verification\t// <stdin>:20:3\n`endif // layers_Example10_Verification\t// <stdin>:20:3\n'})}),"\n",(0,t.jsx)(n.h3,{id:"connecting-types-with-optional-members",children:"Connecting types with optional members"}),"\n",(0,t.jsxs)(n.p,{children:["In the following example, we can use ",(0,t.jsx)(n.code,{children:":<>="})," and ",(0,t.jsx)(n.code,{children:".waive"})," to connect two ",(0,t.jsx)(n.code,{children:"MyDecoupledOpts"}),"'s, where only one has a ",(0,t.jsx)(n.code,{children:"bits"})," member."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class MyDecoupledOpt(hasBits: Boolean) extends Bundle {\n  val valid = Bool()\n  val ready = Flipped(Bool())\n  val bits = if (hasBits) Some(UInt(32.W)) else None\n}\nclass Example6 extends RawModule {\n  val in  = IO(Flipped(new MyDecoupledOpt(true)))\n  val out = IO(new MyDecoupledOpt(false))\n  out :<>= in.waive(_.bits.get) // We can know to call .get because we can inspect in.bits.isEmpty\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["This generates the following Verilog, where ",(0,t.jsx)(n.code,{children:"ready"})," and ",(0,t.jsx)(n.code,{children:"valid"})," are connected, and ",(0,t.jsx)(n.code,{children:"bits"})," is ignored:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example6(\t// connectable.md:275:7\n  input         in_valid,\t// connectable.md:276:15\n  output        in_ready,\t// connectable.md:276:15\n  input  [31:0] in_bits,\t// connectable.md:276:15\n  output        out_valid,\t// connectable.md:277:15\n  input         out_ready\t// connectable.md:277:15\n);\n\n  assign in_ready = out_ready;\t// connectable.md:275:7\n  assign out_valid = in_valid;\t// connectable.md:275:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example6_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example6_Verification.sv"\n`ifndef layers_Example6_Verification_Cover\n`define layers_Example6_Verification_Cover\t// <stdin>:6:5\n`endif // layers_Example6_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example6_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example6_Verification.sv"\n`ifndef layers_Example6_Verification_Assume\n`define layers_Example6_Verification_Assume\t// <stdin>:5:5\n`endif // layers_Example6_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example6_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example6_Verification.sv"\n`ifndef layers_Example6_Verification_Assert\n`define layers_Example6_Verification_Assert\t// <stdin>:4:5\n`endif // layers_Example6_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_Example6_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example6_Verification\n`define layers_Example6_Verification\t// <stdin>:3:3\n`endif // layers_Example6_Verification\t// <stdin>:3:3\n'})}),"\n",(0,t.jsx)(n.h3,{id:"always-ignore-errors-caused-by-extra-members-partial-connection-operator",children:"Always ignore errors caused by extra members (partial connection operator)"}),"\n",(0,t.jsx)(n.p,{children:"The most unsafe connection is to connect only members that are present in both consumer and producer, and ignore all other members.\nThis is unsafe because this connection will never error on any Chisel types."}),"\n",(0,t.jsxs)(n.p,{children:["To do this, you can use ",(0,t.jsx)(n.code,{children:".waiveAll"})," and static cast to ",(0,t.jsx)(n.code,{children:"Data"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class OnlyA extends Bundle {\n  val a = UInt(32.W)\n}\nclass OnlyB extends Bundle {\n  val b = UInt(32.W)\n}\nclass Example11 extends RawModule {\n  val in  = IO(Flipped(new OnlyA))\n  val out = IO(new OnlyB)\n\n  out := DontCare\n\n  (out: Data).waiveAll :<>= (in: Data).waiveAll\n}\n"})}),"\n",(0,t.jsx)(n.p,{children:"This generates the following Verilog, where nothing is connected:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example11(\t// connectable.md:301:7\n  input  [31:0] in_a,\t// connectable.md:302:15\n  output [31:0] out_b\t// connectable.md:303:15\n);\n\n  assign out_b = 32\'h0;\t// connectable.md:301:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example11_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example11_Verification.sv"\n`ifndef layers_Example11_Verification_Cover\n`define layers_Example11_Verification_Cover\t// <stdin>:6:5\n`endif // layers_Example11_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example11_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example11_Verification.sv"\n`ifndef layers_Example11_Verification_Assume\n`define layers_Example11_Verification_Assume\t// <stdin>:5:5\n`endif // layers_Example11_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example11_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example11_Verification.sv"\n`ifndef layers_Example11_Verification_Assert\n`define layers_Example11_Verification_Assert\t// <stdin>:4:5\n`endif // layers_Example11_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_Example11_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example11_Verification\n`define layers_Example11_Verification\t// <stdin>:3:3\n`endif // layers_Example11_Verification\t// <stdin>:3:3\n'})}),"\n",(0,t.jsx)(n.h3,{id:"connecting-components-with-different-widths",children:"Connecting components with different widths"}),"\n",(0,t.jsxs)(n.p,{children:["Non-",(0,t.jsx)(n.code,{children:"Connectable"})," operators implicitly truncate if a component with a larger width is connected to a component with a smaller width.\n",(0,t.jsx)(n.code,{children:"Connectable"})," operators disallow this implicit truncation behavior and require the driven component to be equal or larger in width that the sourcing component."]}),"\n",(0,t.jsxs)(n.p,{children:["If implicit truncation behavior is desired, then ",(0,t.jsx)(n.code,{children:"Connectable"})," provides a ",(0,t.jsx)(n.code,{children:"squeeze"})," mechanism which will allow the connection to continue with implicit truncation."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import scala.collection.immutable.SeqMap\n\nclass Example14 extends RawModule {\n  val p = IO(Flipped(UInt(4.W)))\n  val c = IO(UInt(3.W))\n\n  c :<>= p.squeeze\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["This generates the following Verilog, where ",(0,t.jsx)(n.code,{children:"p"})," is truncated prior to driving ",(0,t.jsx)(n.code,{children:"c"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example14(\t// connectable.md:323:7\n  input  [3:0] p,\t// connectable.md:324:13\n  output [2:0] c\t// connectable.md:325:13\n);\n\n  assign c = p[2:0];\t// connectable.md:323:7, :327:5\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example14_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example14_Verification.sv"\n`ifndef layers_Example14_Verification_Cover\n`define layers_Example14_Verification_Cover\t// <stdin>:6:5\n`endif // layers_Example14_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example14_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example14_Verification.sv"\n`ifndef layers_Example14_Verification_Assume\n`define layers_Example14_Verification_Assume\t// <stdin>:5:5\n`endif // layers_Example14_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example14_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example14_Verification.sv"\n`ifndef layers_Example14_Verification_Assert\n`define layers_Example14_Verification_Assert\t// <stdin>:4:5\n`endif // layers_Example14_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_Example14_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example14_Verification\n`define layers_Example14_Verification\t// <stdin>:3:3\n`endif // layers_Example14_Verification\t// <stdin>:3:3\n'})}),"\n",(0,t.jsx)(n.h3,{id:"excluding-members-from-any-operator-on-a-connectable",children:"Excluding members from any operator on a Connectable"}),"\n",(0,t.jsxs)(n.p,{children:["If a user wants to always exclude a field from a connect, use the ",(0,t.jsx)(n.code,{children:".exclude"})," mechanism which will never connect the field (as if it didn't exist to the connection)."]}),"\n",(0,t.jsxs)(n.p,{children:["Note that if a field matches in both producer and consumer, but only one is excluded, the other non-excluded field will still trigger an error; to fix this, use either ",(0,t.jsx)(n.code,{children:".waive"})," or ",(0,t.jsx)(n.code,{children:".exclude"}),"."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import scala.collection.immutable.SeqMap\n\nclass BundleWithSpecialField extends Bundle {\n  val foo = UInt(3.W)\n  val special = Bool()\n}\nclass Example15 extends RawModule {\n  val p = IO(Flipped(new BundleWithSpecialField()))\n  val c = IO(new BundleWithSpecialField())\n\n  c.special := true.B // must initialize it\n\n  c.exclude(_.special) :<>= p.exclude(_.special)\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["This generates the following Verilog, where the ",(0,t.jsx)(n.code,{children:"special"})," field is not connected:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example15(\t// connectable.md:349:7\n  input  [2:0] p_foo,\t// connectable.md:350:13\n  input        p_special,\t// connectable.md:350:13\n  output [2:0] c_foo,\t// connectable.md:351:13\n  output       c_special\t// connectable.md:351:13\n);\n\n  assign c_foo = p_foo;\t// connectable.md:349:7\n  assign c_special = 1\'h1;\t// connectable.md:349:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example15_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example15_Verification.sv"\n`ifndef layers_Example15_Verification_Cover\n`define layers_Example15_Verification_Cover\t// <stdin>:6:5\n`endif // layers_Example15_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example15_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example15_Verification.sv"\n`ifndef layers_Example15_Verification_Assume\n`define layers_Example15_Verification_Assume\t// <stdin>:5:5\n`endif // layers_Example15_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example15_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example15_Verification.sv"\n`ifndef layers_Example15_Verification_Assert\n`define layers_Example15_Verification_Assert\t// <stdin>:4:5\n`endif // layers_Example15_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_Example15_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example15_Verification\n`define layers_Example15_Verification\t// <stdin>:3:3\n`endif // layers_Example15_Verification\t// <stdin>:3:3\n'})}),"\n",(0,t.jsx)(n.h2,{id:"techniques-for-connecting-structurally-inequivalent-chisel-types",children:"Techniques for connecting structurally inequivalent Chisel types"}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.code,{children:"DataView"})," and ",(0,t.jsx)(n.code,{children:".viewAsSupertype"})," create a view of the component that has a different Chisel type.\nThis means that a user can first create a ",(0,t.jsx)(n.code,{children:"DataView"})," of the consumer or producer (or both) so that the Chisel types are structurally equivalent.\nThis is useful when the difference between the consumer and producer aren't super nested, and also if they have rich Scala types which encode their structure.\nIn general, ",(0,t.jsx)(n.code,{children:"DataView"})," is the preferred mechanism to use (if you can) because it maintains the most amount of Chisel information in the Scala type, but there are many instances where it doesn't work and thus one must fall back on ",(0,t.jsx)(n.code,{children:"Connectable"}),"."]}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.code,{children:"Connectable"})," does not change the Chisel type, but instead changes the semantics of the operator to not error on the waived members if they are dangling or unconnected.\nThis is useful for when differences between the consumer and producer do not show up in the Scala type system (e.g. present/missing fields of type ",(0,t.jsx)(n.code,{children:"Option[Data]"}),", or anonymous ",(0,t.jsx)(n.code,{children:"Record"}),"s) or are deeply nested in a bundle that is especially onerous to create a ",(0,t.jsx)(n.code,{children:"DataView"}),"."]}),"\n",(0,t.jsxs)(n.p,{children:["Static casts (e.g. ",(0,t.jsx)(n.code,{children:"(x: T)"}),") allows connecting components that have different Scala types, but leaves the Chisel type unchanged.\nUse this to force a connection to occur, even if the Scala types are different."]}),"\n",(0,t.jsxs)(n.blockquote,{children:["\n",(0,t.jsx)(n.p,{children:'One may wonder why the operators require identical Scala types in the first place, if they can easily be bypassed.\nThe reason is to encourage users to use the Scala type system to encode Chisel information as it can make their code more robust; however, we don\'t want to be draconian about it because there are times when we want to enable the user to "just connect the darn thing".'}),"\n"]}),"\n",(0,t.jsx)(n.p,{children:"When all else fails one can always manually expand the connection to do what they want to happen, member by member.\nThe down-side to this approach is its verbosity and that adding new members to a component will require updating the manual connections."}),"\n",(0,t.jsxs)(n.p,{children:["Things to remember about ",(0,t.jsx)(n.code,{children:"Connectable"})," vs ",(0,t.jsx)(n.code,{children:".viewAsSupertype"}),"/",(0,t.jsx)(n.code,{children:"DataView"})," vs static cast (e.g. ",(0,t.jsx)(n.code,{children:"(x: T)"}),"):"]}),"\n",(0,t.jsxs)(n.ul,{children:["\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"DataView"})," and ",(0,t.jsx)(n.code,{children:".viewAsSupertype"})," will preemptively remove members that are not present in the new view which has a different Chisel type, thus ",(0,t.jsx)(n.code,{children:"DataView"})," ",(0,t.jsx)(n.em,{children:"does"})," affect what is connected"]}),"\n",(0,t.jsxs)(n.li,{children:[(0,t.jsx)(n.code,{children:"Connectable"})," can be used to waive the error on members who end up being dangling or unconnected.\nImportantly, ",(0,t.jsx)(n.code,{children:"Connectable"})," waives ",(0,t.jsx)(n.em,{children:"do not"})," affect what is connected"]}),"\n",(0,t.jsxs)(n.li,{children:["Static cast does not remove extra members, thus a static cast ",(0,t.jsx)(n.em,{children:"does not"})," affect what is connected"]}),"\n"]}),"\n",(0,t.jsx)(n.h3,{id:"connecting-different-sub-types-of-the-same-super-type-with-colliding-names",children:"Connecting different sub-types of the same super-type, with colliding names"}),"\n",(0,t.jsxs)(n.p,{children:["In these examples, we are connecting ",(0,t.jsx)(n.code,{children:"MyDecoupled"})," with ",(0,t.jsx)(n.code,{children:"MyDecoupledOtherBits"}),".\nBoth are subtypes of ",(0,t.jsx)(n.code,{children:"MyReadyValid"}),", and both have a ",(0,t.jsx)(n.code,{children:"bits"})," field of type ",(0,t.jsx)(n.code,{children:"UInt(32.W)"}),"."]}),"\n",(0,t.jsxs)(n.p,{children:["The first example will use ",(0,t.jsx)(n.code,{children:".viewAsSupertype"})," to connect them as ",(0,t.jsx)(n.code,{children:"MyReadyValid"}),".\nBecause it changes the Chisel type to omit both ",(0,t.jsx)(n.code,{children:"bits"})," fields, the ",(0,t.jsx)(n.code,{children:"bits"})," fields are unconnected."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import experimental.dataview._\nclass MyDecoupledOtherBits extends MyReadyValid {\n  val bits = UInt(32.W)\n}\nclass Example12 extends RawModule {\n  val in  = IO(Flipped(new MyDecoupled))\n  val out = IO(new MyDecoupledOtherBits)\n\n  out := DontCare\n\n  out.viewAsSupertype(new MyReadyValid) :<>= in.viewAsSupertype(new MyReadyValid)\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["Note that the ",(0,t.jsx)(n.code,{children:"bits"})," fields are unconnected."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example12(\t// connectable.md:376:7\n  input         in_valid,\t// connectable.md:377:15\n  output        in_ready,\t// connectable.md:377:15\n  input  [31:0] in_bits,\t// connectable.md:377:15\n  output        out_valid,\t// connectable.md:378:15\n  input         out_ready,\t// connectable.md:378:15\n  output [31:0] out_bits\t// connectable.md:378:15\n);\n\n  assign in_ready = out_ready;\t// connectable.md:376:7\n  assign out_valid = in_valid;\t// connectable.md:376:7\n  assign out_bits = 32\'h0;\t// connectable.md:376:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example12_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example12_Verification.sv"\n`ifndef layers_Example12_Verification_Cover\n`define layers_Example12_Verification_Cover\t// <stdin>:6:5\n`endif // layers_Example12_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example12_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example12_Verification.sv"\n`ifndef layers_Example12_Verification_Assume\n`define layers_Example12_Verification_Assume\t// <stdin>:5:5\n`endif // layers_Example12_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example12_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example12_Verification.sv"\n`ifndef layers_Example12_Verification_Assert\n`define layers_Example12_Verification_Assert\t// <stdin>:4:5\n`endif // layers_Example12_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_Example12_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example12_Verification\n`define layers_Example12_Verification\t// <stdin>:3:3\n`endif // layers_Example12_Verification\t// <stdin>:3:3\n'})}),"\n",(0,t.jsxs)(n.p,{children:["The second example will use a static cast and ",(0,t.jsx)(n.code,{children:".waive(_.bits)"})," to connect them as ",(0,t.jsx)(n.code,{children:"MyReadyValid"}),".\nNote that because the static cast does not change the Chisel type, the connection finds that both consumer and producer have a ",(0,t.jsx)(n.code,{children:"bits"})," field.\nThis means that since they are structurally equivalent, they match and are connected.\nThe ",(0,t.jsx)(n.code,{children:"waive(_.bits)"})," does nothing, because the ",(0,t.jsx)(n.code,{children:"bits"})," are neither dangling nor unconnected."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import experimental.dataview._\nclass Example13 extends RawModule {\n  val in  = IO(Flipped(new MyDecoupled))\n  val out = IO(new MyDecoupledOtherBits)\n\n  out := DontCare\n\n  out.waiveAs[MyReadyValid](_.bits) :<>= in.waiveAs[MyReadyValid](_.bits)\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["Note that the ",(0,t.jsx)(n.code,{children:"bits"})," fields ARE connected, even though they are waived, as ",(0,t.jsx)(n.code,{children:".waive"})," just changes whether an error should be thrown if they are missing, NOT to not connect them if they are structurally equivalent.\nTo always omit the connection, use ",(0,t.jsx)(n.code,{children:".exclude"})," on one side and either ",(0,t.jsx)(n.code,{children:".exclude"})," or ",(0,t.jsx)(n.code,{children:".waive"})," on the other side."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example13(\t// connectable.md:398:7\n  input         in_valid,\t// connectable.md:399:15\n  output        in_ready,\t// connectable.md:399:15\n  input  [31:0] in_bits,\t// connectable.md:399:15\n  output        out_valid,\t// connectable.md:400:15\n  input         out_ready,\t// connectable.md:400:15\n  output [31:0] out_bits\t// connectable.md:400:15\n);\n\n  assign in_ready = out_ready;\t// connectable.md:398:7\n  assign out_valid = in_valid;\t// connectable.md:398:7\n  assign out_bits = in_bits;\t// connectable.md:398:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example13_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example13_Verification.sv"\n`ifndef layers_Example13_Verification_Cover\n`define layers_Example13_Verification_Cover\t// <stdin>:6:5\n`endif // layers_Example13_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example13_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example13_Verification.sv"\n`ifndef layers_Example13_Verification_Assume\n`define layers_Example13_Verification_Assume\t// <stdin>:5:5\n`endif // layers_Example13_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example13_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example13_Verification.sv"\n`ifndef layers_Example13_Verification_Assert\n`define layers_Example13_Verification_Assert\t// <stdin>:4:5\n`endif // layers_Example13_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_Example13_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example13_Verification\n`define layers_Example13_Verification\t// <stdin>:3:3\n`endif // layers_Example13_Verification\t// <stdin>:3:3\n'})}),"\n",(0,t.jsx)(n.h3,{id:"connecting-sub-types-to-super-types-by-waiving-extra-members",children:"Connecting sub-types to super-types by waiving extra members"}),"\n",(0,t.jsxs)(n.blockquote,{children:["\n",(0,t.jsxs)(n.p,{children:["Note that in this example, it would be better to use ",(0,t.jsx)(n.code,{children:".viewAsSupertype"}),"."]}),"\n"]}),"\n",(0,t.jsxs)(n.p,{children:["In the following example, we can use ",(0,t.jsx)(n.code,{children:":<>="})," to connect a ",(0,t.jsx)(n.code,{children:"MyReadyValid"})," to a ",(0,t.jsx)(n.code,{children:"MyDecoupled"})," by waiving the ",(0,t.jsx)(n.code,{children:"bits"})," member."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class MyReadyValid extends Bundle {\n  val valid = Bool()\n  val ready = Flipped(Bool())\n}\nclass MyDecoupled extends MyReadyValid {\n  val bits = UInt(32.W)\n}\nclass Example5 extends RawModule {\n  val in  = IO(Flipped(new MyDecoupled))\n  val out = IO(new MyReadyValid)\n  out :<>= in.waiveAs[MyReadyValid](_.bits)\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["This generates the following Verilog, where ",(0,t.jsx)(n.code,{children:"ready"})," and ",(0,t.jsx)(n.code,{children:"valid"})," are connected, and ",(0,t.jsx)(n.code,{children:"bits"})," is ignored:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example5(\t// connectable.md:428:7\n  input         in_valid,\t// connectable.md:429:15\n  output        in_ready,\t// connectable.md:429:15\n  input  [31:0] in_bits,\t// connectable.md:429:15\n  output        out_valid,\t// connectable.md:430:15\n  input         out_ready\t// connectable.md:430:15\n);\n\n  assign in_ready = out_ready;\t// connectable.md:428:7\n  assign out_valid = in_valid;\t// connectable.md:428:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example5_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example5_Verification.sv"\n`ifndef layers_Example5_Verification_Cover\n`define layers_Example5_Verification_Cover\t// <stdin>:6:5\n`endif // layers_Example5_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example5_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example5_Verification.sv"\n`ifndef layers_Example5_Verification_Assume\n`define layers_Example5_Verification_Assume\t// <stdin>:5:5\n`endif // layers_Example5_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example5_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example5_Verification.sv"\n`ifndef layers_Example5_Verification_Assert\n`define layers_Example5_Verification_Assert\t// <stdin>:4:5\n`endif // layers_Example5_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_Example5_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example5_Verification\n`define layers_Example5_Verification\t// <stdin>:3:3\n`endif // layers_Example5_Verification\t// <stdin>:3:3\n'})}),"\n",(0,t.jsx)(n.h3,{id:"connecting-different-sub-types",children:"Connecting different sub-types"}),"\n",(0,t.jsxs)(n.blockquote,{children:["\n",(0,t.jsxs)(n.p,{children:["Note that in this example, it would be better to use ",(0,t.jsx)(n.code,{children:".viewAsSupertype"}),"."]}),"\n"]}),"\n",(0,t.jsxs)(n.p,{children:["Note that the connection operator requires the ",(0,t.jsx)(n.code,{children:"consumer"})," and ",(0,t.jsx)(n.code,{children:"producer"})," to be the same Scala type to encourage capturing more information statically, but they can always be cast to ",(0,t.jsx)(n.code,{children:"Data"})," or another common supertype prior to connecting."]}),"\n",(0,t.jsxs)(n.p,{children:["In the following example, we can use ",(0,t.jsx)(n.code,{children:":<>="})," and ",(0,t.jsx)(n.code,{children:".waiveAs"})," to connect two different sub-types of ",(0,t.jsx)(n.code,{children:"MyReadyValid"}),"."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class HasBits extends MyReadyValid {\n  val bits = UInt(32.W)\n}\nclass HasEcho extends MyReadyValid {\n  val echo = Flipped(UInt(32.W))\n}\nclass Example7 extends RawModule {\n  val in  = IO(Flipped(new HasBits))\n  val out = IO(new HasEcho)\n  out.waiveAs[MyReadyValid](_.echo) :<>= in.waiveAs[MyReadyValid](_.bits)\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["This generates the following Verilog, where ",(0,t.jsx)(n.code,{children:"ready"})," and ",(0,t.jsx)(n.code,{children:"valid"})," are connected, and ",(0,t.jsx)(n.code,{children:"bits"})," and ",(0,t.jsx)(n.code,{children:"echo"})," are ignored:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example7(\t// connectable.md:454:7\n  input         in_valid,\t// connectable.md:455:15\n  output        in_ready,\t// connectable.md:455:15\n  input  [31:0] in_bits,\t// connectable.md:455:15\n  output        out_valid,\t// connectable.md:456:15\n  input         out_ready,\t// connectable.md:456:15\n  input  [31:0] out_echo\t// connectable.md:456:15\n);\n\n  assign in_ready = out_ready;\t// connectable.md:454:7\n  assign out_valid = in_valid;\t// connectable.md:454:7\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example7_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example7_Verification.sv"\n`ifndef layers_Example7_Verification_Cover\n`define layers_Example7_Verification_Cover\t// <stdin>:6:5\n`endif // layers_Example7_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example7_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example7_Verification.sv"\n`ifndef layers_Example7_Verification_Assume\n`define layers_Example7_Verification_Assume\t// <stdin>:5:5\n`endif // layers_Example7_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example7_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example7_Verification.sv"\n`ifndef layers_Example7_Verification_Assert\n`define layers_Example7_Verification_Assert\t// <stdin>:4:5\n`endif // layers_Example7_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_Example7_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example7_Verification\n`define layers_Example7_Verification\t// <stdin>:3:3\n`endif // layers_Example7_Verification\t// <stdin>:3:3\n'})}),"\n",(0,t.jsx)(n.h2,{id:"faq",children:"FAQ"}),"\n",(0,t.jsx)(n.h3,{id:"how-do-i-connect-two-items-as-flexibly-as-possible-try-your-best-but-never-error",children:"How do I connect two items as flexibly as possible (try your best but never error)"}),"\n",(0,t.jsxs)(n.p,{children:["Use ",(0,t.jsx)(n.code,{children:".unsafe"})," (both waives and allows squeezing of all fields)."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class ExampleUnsafe extends RawModule {\n  val in  = IO(Flipped(new Bundle { val foo = Bool(); val bar = Bool() }))\n  val out = IO(new Bundle { val baz = Bool(); val bar = Bool() })\n  out.unsafe :<>= in.unsafe // bar is connected, and nothing errors\n}\n"})}),"\n",(0,t.jsx)(n.h3,{id:"how-do-i-connect-two-items-but-dont-care-about-the-scala-types-being-equivalent",children:"How do I connect two items but don't care about the Scala types being equivalent?"}),"\n",(0,t.jsxs)(n.p,{children:["Use ",(0,t.jsx)(n.code,{children:".as"})," (upcasts the Scala type)."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class ExampleAs extends RawModule {\n  val in  = IO(Flipped(new Bundle { val foo = Bool(); val bar = Bool() }))\n  val out = IO(new Bundle { val foo = Bool(); val bar = Bool() })\n  // foo and bar are connected, although Scala types aren't the same\n  out.as[Data] :<>= in.as[Data]\n}\n"})})]})}function h(e={}){const{wrapper:n}={...(0,l.R)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(d,{...e})}):d(e)}},8453:(e,n,i)=>{i.d(n,{R:()=>s,x:()=>r});var t=i(6540);const l={},o=t.createContext(l);function s(e){const n=t.useContext(o);return t.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function r(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(l):e.components||l:s(e.components),t.createElement(o.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/d4b6d0e6.dcf1e388.js b/assets/js/d4b6d0e6.dcf1e388.js
deleted file mode 100644
index 1180d9a2c8..0000000000
--- a/assets/js/d4b6d0e6.dcf1e388.js
+++ /dev/null
@@ -1 +0,0 @@
-"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[4166],{3205:(e,n,i)=>{i.r(n),i.d(n,{assets:()=>s,contentTitle:()=>c,default:()=>h,frontMatter:()=>l,metadata:()=>d,toc:()=>r});var o=i(4848),t=i(8453);const l={layout:"docs",title:"Connectable Operators",section:"chisel3"},c=void 0,d={id:"explanations/connectable",title:"Connectable Operators",description:"Table of Contents",source:"@site/docs/explanations/connectable.md",sourceDirName:"explanations",slug:"/explanations/connectable",permalink:"/docs/explanations/connectable",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/connectable.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Connectable Operators",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Combinational Circuits",permalink:"/docs/explanations/combinational-circuits"},next:{title:"Deep Dive into <> and := Connection Operators",permalink:"/docs/explanations/connection-operators"}},s={},r=[{value:"Table of Contents",id:"table-of-contents",level:2},{value:"Terminology",id:"terminology",level:2},{value:"Overview",id:"overview",level:2},{value:"Alignment: Flipped vs Aligned",id:"alignment-flipped-vs-aligned",level:2},{value:"Input/Output",id:"inputoutput",level:2},{value:"Connecting components with fully aligned members",id:"connecting-components-with-fully-aligned-members",level:2},{value:"Mono-direction connection operator (:=)",id:"mono-direction-connection-operator-",level:3},{value:"Connecting components with mixed alignment members",id:"connecting-components-with-mixed-alignment-members",level:2},{value:"Bi-direction connection operator (<code>:&lt;&gt;=</code>)",id:"bi-direction-connection-operator-",level:3},{value:"Port-Direction Computation versus Connection-Direction Computation",id:"port-direction-computation-versus-connection-direction-computation",level:3},{value:"Aligned connection operator (<code>:&lt;=</code>)",id:"aligned-connection-operator-",level:3},{value:"Flipped connection operator (<code>:&gt;=</code>)",id:"flipped-connection-operator-",level:3},{value:"Coercing mono-direction connection operator (<code>:#=</code>)",id:"coercing-mono-direction-connection-operator-",level:3},{value:"Connectable",id:"connectable",level:2},{value:"Connecting Records",id:"connecting-records",level:3},{value:"Defaults with waived connections",id:"defaults-with-waived-connections",level:3},{value:"Connecting types with optional members",id:"connecting-types-with-optional-members",level:3},{value:"Always ignore errors caused by extra members (partial connection operator)",id:"always-ignore-errors-caused-by-extra-members-partial-connection-operator",level:3},{value:"Connecting components with different widths",id:"connecting-components-with-different-widths",level:3},{value:"Excluding members from any operator on a Connectable",id:"excluding-members-from-any-operator-on-a-connectable",level:3},{value:"Techniques for connecting structurally inequivalent Chisel types",id:"techniques-for-connecting-structurally-inequivalent-chisel-types",level:2},{value:"Connecting different sub-types of the same super-type, with colliding names",id:"connecting-different-sub-types-of-the-same-super-type-with-colliding-names",level:3},{value:"Connecting sub-types to super-types by waiving extra members",id:"connecting-sub-types-to-super-types-by-waiving-extra-members",level:3},{value:"Connecting different sub-types",id:"connecting-different-sub-types",level:3},{value:"FAQ",id:"faq",level:2},{value:"How do I connect two items as flexibly as possible (try your best but never error)",id:"how-do-i-connect-two-items-as-flexibly-as-possible-try-your-best-but-never-error",level:3},{value:"How do I connect two items but don&#39;t care about the Scala types being equivalent?",id:"how-do-i-connect-two-items-but-dont-care-about-the-scala-types-being-equivalent",level:3}];function a(e){const n={a:"a",blockquote:"blockquote",code:"code",em:"em",h2:"h2",h3:"h3",li:"li",p:"p",pre:"pre",ul:"ul",...(0,t.R)(),...e.components};return(0,o.jsxs)(o.Fragment,{children:[(0,o.jsx)(n.h2,{id:"table-of-contents",children:"Table of Contents"}),"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.a,{href:"#terminology",children:"Terminology"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.a,{href:"#overview",children:"Overview"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.a,{href:"#alignment-flipped-vs-aligned",children:"Alignment: Flipped vs Aligned"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.a,{href:"#inputoutput",children:"Input/Output"})}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.a,{href:"#connecting-components-with-fully-aligned-members",children:"Connecting components with fully aligned members"}),"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsx)(n.li,{children:(0,o.jsxs)(n.a,{href:"#mono-direction-connection-operator-",children:["Mono-direction connection operator (",(0,o.jsx)(n.code,{children:":="}),")"]})}),"\n"]}),"\n"]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.a,{href:"#connecting-components-with-mixed-alignment-members",children:"Connecting components with mixed alignment members"}),"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsx)(n.li,{children:(0,o.jsxs)(n.a,{href:"#bi-direction-connection-operator-",children:["Bi-direction connection operator (",(0,o.jsx)(n.code,{children:":<>="}),")"]})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.a,{href:"#port-direction-computation-versus-connection-direction-computation",children:"Port-Direction Computation versus Connection-Direction Computation"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsxs)(n.a,{href:"#aligned-connection-operator-",children:["Aligned connection operator (",(0,o.jsx)(n.code,{children:":<="}),")"]})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsxs)(n.a,{href:"#flipped-connection-operator-",children:["Flipped connection operator (",(0,o.jsx)(n.code,{children:":>="}),")"]})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsxs)(n.a,{href:"#coercing-mono-direction-connection-operator-",children:["Coercing mono-direction connection operator (",(0,o.jsx)(n.code,{children:":#="}),")"]})}),"\n"]}),"\n"]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.a,{href:"#connectable",children:"Connectable"}),"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.a,{href:"#connecting-records",children:"Connecting Records"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.a,{href:"#defaults-with-waived-connections",children:"Defaults with waived connections"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.a,{href:"#connecting-types-with-optional-members",children:"Connecting types with optional members"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.a,{href:"#always-ignore-errors-caused-by-extra-members-partial-connection-operator",children:"Always ignore extra members (partial connection operator)"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.a,{href:"#connecting-components-with-different-widths",children:"Connecting components with different widths"})}),"\n"]}),"\n"]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.a,{href:"#techniques-for-connecting-structurally-inequivalent-chisel-types",children:"Techniques for connecting structurally inequivalent Chisel types"}),"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.a,{href:"#connecting-different-sub-types-of-the-same-super-type-with-colliding-names",children:"Connecting different sub-types of the same super-type, with colliding names"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.a,{href:"#connecting-sub-types-to-super-types-by-waiving-extra-members",children:"Connecting sub-types to super-types by waiving extra members"})}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.a,{href:"#connecting-different-sub-types",children:"Connecting different sub-types"})}),"\n"]}),"\n"]}),"\n",(0,o.jsx)(n.li,{children:(0,o.jsx)(n.a,{href:"#faq",children:"FAQ"})}),"\n"]}),"\n",(0,o.jsx)(n.h2,{id:"terminology",children:"Terminology"}),"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:['"Chisel type" - a ',(0,o.jsx)(n.code,{children:"Data"})," that is not bound to hardware, i.e. not a component. (more details ",(0,o.jsx)(n.a,{href:"chisel-type-vs-scala-type",children:"here"}),").","\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:["E.g. ",(0,o.jsx)(n.code,{children:"UInt(3.W)"}),", ",(0,o.jsx)(n.code,{children:"new Bundle {..}"}),", ",(0,o.jsx)(n.code,{children:"Vec(3, SInt(2.W))"})," are all Chisel types"]}),"\n"]}),"\n"]}),"\n",(0,o.jsxs)(n.li,{children:['"component" - a ',(0,o.jsx)(n.code,{children:"Data"})," that is bound to hardware (",(0,o.jsx)(n.code,{children:"IO"}),", ",(0,o.jsx)(n.code,{children:"Reg"}),", ",(0,o.jsx)(n.code,{children:"Wire"}),", etc.)","\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:["E.g. ",(0,o.jsx)(n.code,{children:"Wire(UInt(3.W))"})," is a component, whose Chisel type is ",(0,o.jsx)(n.code,{children:"UInt(3.W)"})]}),"\n"]}),"\n"]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"Aggregate"})," - a Chisel type or component that contains other Chisel types or components (i.e. ",(0,o.jsx)(n.code,{children:"Vec"}),", ",(0,o.jsx)(n.code,{children:"Record"}),", or ",(0,o.jsx)(n.code,{children:"Bundle"}),")"]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"Element"})," - a Chisel type or component that does not contain other Chisel types or components (e.g. ",(0,o.jsx)(n.code,{children:"UInt"}),", ",(0,o.jsx)(n.code,{children:"SInt"}),", ",(0,o.jsx)(n.code,{children:"Clock"}),", ",(0,o.jsx)(n.code,{children:"Bool"})," etc.)"]}),"\n",(0,o.jsxs)(n.li,{children:['"member" - a Chisel type or component, or any of its children (could be an ',(0,o.jsx)(n.code,{children:"Aggregate"})," or an ",(0,o.jsx)(n.code,{children:"Element"}),")","\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:["E.g. ",(0,o.jsx)(n.code,{children:"Vec(3, UInt(2.W))(0)"})," is a member of the parent ",(0,o.jsx)(n.code,{children:"Vec"})," Chisel type"]}),"\n",(0,o.jsxs)(n.li,{children:["E.g. ",(0,o.jsx)(n.code,{children:"Wire(Vec(3, UInt(2.W)))(0)"})," is a member of the parent ",(0,o.jsx)(n.code,{children:"Wire"})," component"]}),"\n",(0,o.jsxs)(n.li,{children:["E.g. ",(0,o.jsx)(n.code,{children:"IO(Decoupled(Bool)).ready"})," is a member of the parent ",(0,o.jsx)(n.code,{children:"IO"})," component"]}),"\n"]}),"\n"]}),"\n",(0,o.jsxs)(n.li,{children:['"relative alignment" - whether two members of the same component or Chisel type are aligned/flipped, relative to one another',"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:["see section ",(0,o.jsx)(n.a,{href:"#alignment-flipped-vs-aligned",children:"below"})," for a detailed definition"]}),"\n"]}),"\n"]}),"\n",(0,o.jsxs)(n.li,{children:['"structural type check" - Chisel type ',(0,o.jsx)(n.code,{children:"A"})," is structurally equivalent to Chisel type ",(0,o.jsx)(n.code,{children:"B"})," if ",(0,o.jsx)(n.code,{children:"A"})," and ",(0,o.jsx)(n.code,{children:"B"})," have matching bundle field names and types (",(0,o.jsx)(n.code,{children:"Record"})," vs ",(0,o.jsx)(n.code,{children:"Vector"})," vs ",(0,o.jsx)(n.code,{children:"Element"}),"), probe modifiers (probe vs nonprobe), vector sizes, ",(0,o.jsx)(n.code,{children:"Element"})," types (UInt/SInt/Bool/Clock)","\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsx)(n.li,{children:"ignores relative alignment (flippedness)"}),"\n"]}),"\n"]}),"\n",(0,o.jsxs)(n.li,{children:['"alignment type check" - a Chisel type ',(0,o.jsx)(n.code,{children:"A"})," matches alignment with another Chisel type ",(0,o.jsx)(n.code,{children:"B"})," if every member of ",(0,o.jsx)(n.code,{children:"A"}),"'s relative alignment to ",(0,o.jsx)(n.code,{children:"A"})," is the same as the structurally corresponding member of ",(0,o.jsx)(n.code,{children:"B"}),"'s relative alignment to ",(0,o.jsx)(n.code,{children:"B"}),"."]}),"\n"]}),"\n",(0,o.jsx)(n.h2,{id:"overview",children:"Overview"}),"\n",(0,o.jsxs)(n.p,{children:["The ",(0,o.jsx)(n.code,{children:"Connectable"})," operators are the standard way to connect Chisel hardware components to one another."]}),"\n",(0,o.jsxs)(n.blockquote,{children:["\n",(0,o.jsxs)(n.p,{children:["Note: For descriptions of the semantics for the previous operators, see ",(0,o.jsx)(n.a,{href:"connection-operators",children:(0,o.jsx)(n.code,{children:"Connection Operators"})}),"."]}),"\n"]}),"\n",(0,o.jsx)(n.p,{children:"All connection operators require the two hardware components (consumer and producer) to be structurally type equivalent."}),"\n",(0,o.jsxs)(n.p,{children:["The one exception to the structural type-equivalence rule is using the ",(0,o.jsx)(n.code,{children:"Connectable"})," mechanism, detailed at this ",(0,o.jsx)(n.a,{href:"#techniques-for-connecting-structurally-inequivalent-chisel-types",children:"section"})," towards the end of this document."]}),"\n",(0,o.jsxs)(n.p,{children:["Aggregate (",(0,o.jsx)(n.code,{children:"Record"}),", ",(0,o.jsx)(n.code,{children:"Vec"}),", ",(0,o.jsx)(n.code,{children:"Bundle"}),") Chisel types can include data members which are flipped relative to one another.\nDue to this, there are many desired connection behaviors between two Chisel components.\nThe following are the Chisel connection operators between a consumer ",(0,o.jsx)(n.code,{children:"c"})," and producer ",(0,o.jsx)(n.code,{children:"p"}),":"]}),"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"c := p"})," (mono-direction): connects all ",(0,o.jsx)(n.code,{children:"p"})," members to ",(0,o.jsx)(n.code,{children:"c"}),"; requires ",(0,o.jsx)(n.code,{children:"c"})," and ",(0,o.jsx)(n.code,{children:"p"})," to not have any flipped members"]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"c :#= p"})," (coercing mono-direction): connects all ",(0,o.jsx)(n.code,{children:"p"})," members to ",(0,o.jsx)(n.code,{children:"c"}),"; regardless of alignment"]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"c :<= p"})," (aligned-direction): connects all aligned (non-flipped) ",(0,o.jsx)(n.code,{children:"c"})," members from ",(0,o.jsx)(n.code,{children:"p"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"c :>= p"})," (flipped-direction): connects all flipped ",(0,o.jsx)(n.code,{children:"p"})," members from ",(0,o.jsx)(n.code,{children:"c"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"c :<>= p"})," (bi-direction operator): connects all aligned ",(0,o.jsx)(n.code,{children:"c"})," members from ",(0,o.jsx)(n.code,{children:"p"}),"; all flipped ",(0,o.jsx)(n.code,{children:"p"})," members from ",(0,o.jsx)(n.code,{children:"c"})]}),"\n"]}),"\n",(0,o.jsx)(n.p,{children:"These operators may appear to be a random collection of symbols; however, the characters are consistent between operators and self-describe the semantics of each operator:"}),"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:":"})," always indicates the consumer, or left-hand-side, of the operator."]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"="})," always indicates the producer, or right-hand-side, of the operator.","\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:["Hence, ",(0,o.jsx)(n.code,{children:"c := p"})," connects a consumer (",(0,o.jsx)(n.code,{children:"c"}),") and a producer (",(0,o.jsx)(n.code,{children:"p"}),")."]}),"\n"]}),"\n"]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"<"})," always indicates that some members will be driven producer-to-consumer, or right-to-left.","\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:["Hence, ",(0,o.jsx)(n.code,{children:"c :<= p"})," drives members in producer (",(0,o.jsx)(n.code,{children:"p"}),") to members in consumer (",(0,o.jsx)(n.code,{children:"c"}),")."]}),"\n"]}),"\n"]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:">"})," always indicates that some signals will be driven consumer-to-producer, or left-to-right.","\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:["Hence, ",(0,o.jsx)(n.code,{children:"c :>= p"})," drives members in consumer (",(0,o.jsx)(n.code,{children:"c"}),") to members producer (",(0,o.jsx)(n.code,{children:"p"}),")."]}),"\n",(0,o.jsxs)(n.li,{children:["Hence, ",(0,o.jsx)(n.code,{children:"c :<>= p"})," both drives members from ",(0,o.jsx)(n.code,{children:"p"})," to ",(0,o.jsx)(n.code,{children:"c"})," and from ",(0,o.jsx)(n.code,{children:"c"})," to ",(0,o.jsx)(n.code,{children:"p"}),"."]}),"\n"]}),"\n"]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"#"})," always indicates to ignore member alignment and to drive producer-to-consumer, or right-to-left.","\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:["Hence, ",(0,o.jsx)(n.code,{children:"c :#= p"})," always drives members from ",(0,o.jsx)(n.code,{children:"p"})," to ",(0,o.jsx)(n.code,{children:"c"})," ignoring direction."]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,o.jsxs)(n.blockquote,{children:["\n",(0,o.jsxs)(n.p,{children:["Note: in addition, an operator that ends in ",(0,o.jsx)(n.code,{children:"="})," has assignment-precedence, which means that ",(0,o.jsx)(n.code,{children:"x :<>= y + z"})," will translate to ",(0,o.jsx)(n.code,{children:"x :<>= (y + z)"}),", rather than ",(0,o.jsx)(n.code,{children:"(x :<>= y) + z"}),".\nThis was not true of the ",(0,o.jsx)(n.code,{children:"<>"})," operator and was a minor painpoint for users."]}),"\n"]}),"\n",(0,o.jsx)(n.h2,{id:"alignment-flipped-vs-aligned",children:"Alignment: Flipped vs Aligned"}),"\n",(0,o.jsxs)(n.p,{children:["A member's alignment is a relative property: a member is aligned/flipped relative to another member of the same component or Chisel type.\nHence, one must always say whether a member is flipped/aligned ",(0,o.jsx)(n.em,{children:"with respect to (w.r.t)"})," another member of that type (parent, sibling, child etc.)."]}),"\n",(0,o.jsxs)(n.p,{children:["We use the following example of a non-nested bundle ",(0,o.jsx)(n.code,{children:"Parent"})," to let us state all of the alignment relationships between members of ",(0,o.jsx)(n.code,{children:"p"}),"."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nclass Parent extends Bundle {\n  val alignedChild = UInt(32.W)\n  val flippedChild = Flipped(UInt(32.W))\n}\nclass MyModule0 extends Module {\n  val p = Wire(new Parent)\n}\n"})}),"\n",(0,o.jsx)(n.p,{children:"First, every member is always aligned with themselves:"}),"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"p"})," is aligned w.r.t ",(0,o.jsx)(n.code,{children:"p"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"p.alignedChild"})," is aligned w.r.t ",(0,o.jsx)(n.code,{children:"p.alignedChild"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"p.flippedChild"})," is aligned w.r.t ",(0,o.jsx)(n.code,{children:"p.flippedChild"})]}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["Next, we list all parent/child relationships.\nBecause the ",(0,o.jsx)(n.code,{children:"flippedChild"})," field is ",(0,o.jsx)(n.code,{children:"Flipped"}),", it changes its alignment relative to its parent."]}),"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"p"})," is aligned w.r.t ",(0,o.jsx)(n.code,{children:"p.alignedChild"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"p"})," is flipped w.r.t ",(0,o.jsx)(n.code,{children:"p.flippedChild"})]}),"\n"]}),"\n",(0,o.jsx)(n.p,{children:"Finally, we can list all sibling relationships:"}),"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"p.alignedChild"})," is flipped w.r.t ",(0,o.jsx)(n.code,{children:"p.flippedChild"})]}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["The next example has a nested bundle ",(0,o.jsx)(n.code,{children:"GrandParent"})," who instantiates an aligned ",(0,o.jsx)(n.code,{children:"Parent"})," field and flipped ",(0,o.jsx)(n.code,{children:"Parent"})," field."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nclass GrandParent extends Bundle {\n  val alignedParent = new Parent\n  val flippedParent = Flipped(new Parent)\n}\nclass MyModule1 extends Module {\n  val g = Wire(new GrandParent)\n}\n"})}),"\n",(0,o.jsx)(n.p,{children:"Consider the following alignments between grandparent and grandchildren.\nAn odd number of flips indicate a flipped relationship; even numbers of flips indicate an aligned relationship."}),"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"g"})," is aligned w.r.t ",(0,o.jsx)(n.code,{children:"g.flippedParent.flippedChild"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"g"})," is aligned w.r.t ",(0,o.jsx)(n.code,{children:"g.alignedParent.alignedChild"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"g"})," is flipped w.r.t ",(0,o.jsx)(n.code,{children:"g.flippedParent.alignedChild"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"g"})," is flipped w.r.t ",(0,o.jsx)(n.code,{children:"g.alignedParent.flippedChild"})]}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["Consider the following alignment relationships starting from ",(0,o.jsx)(n.code,{children:"g.alignedParent"})," and ",(0,o.jsx)(n.code,{children:"g.flippedParent"}),".\n",(0,o.jsxs)(n.em,{children:["Note that whether ",(0,o.jsx)(n.code,{children:"g.alignedParent"})," is aligned/flipped relative to ",(0,o.jsx)(n.code,{children:"g"})," has no effect on the aligned/flipped relationship between ",(0,o.jsx)(n.code,{children:"g.alignedParent"})," and ",(0,o.jsx)(n.code,{children:"g.alignedParent.alignedChild"})," because alignment is only relative to the two members in question!"]}),":"]}),"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"g.alignedParent"})," is aligned w.r.t. ",(0,o.jsx)(n.code,{children:"g.alignedParent.alignedChild"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"g.flippedParent"})," is aligned w.r.t. ",(0,o.jsx)(n.code,{children:"g.flippedParent.alignedChild"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"g.alignedParent"})," is flipped w.r.t. ",(0,o.jsx)(n.code,{children:"g.alignedParent.flippedChild"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"g.flippedParent"})," is flipped w.r.t. ",(0,o.jsx)(n.code,{children:"g.flippedParent.flippedChild"})]}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["In summary, a member is aligned or flipped w.r.t. another member of the hardware component.\nThis means that the type of the consumer/producer is the only information needed to determine the behavior of any operator.\n",(0,o.jsx)(n.em,{children:"Whether the consumer/producer is a member of a larger bundle is irrelevant; you ONLY need to know the type of the consumer/producer"}),"."]}),"\n",(0,o.jsx)(n.h2,{id:"inputoutput",children:"Input/Output"}),"\n",(0,o.jsxs)(n.p,{children:[(0,o.jsx)(n.code,{children:"Input(gen)"}),"/",(0,o.jsx)(n.code,{children:"Output(gen)"})," are coercing operators.\nThey perform two functions: (1) create a new Chisel type that has all flips removed from all recursive children members (still structurally equivalent to ",(0,o.jsx)(n.code,{children:"gen"})," but no longer alignment type equivalent), and (2) apply ",(0,o.jsx)(n.code,{children:"Flipped"})," if ",(0,o.jsx)(n.code,{children:"Input"}),", keep aligned (do nothing) if ",(0,o.jsx)(n.code,{children:"Output"}),".\nE.g. if we imagine a function called ",(0,o.jsx)(n.code,{children:"cloneChiselTypeButStripAllFlips"}),", then ",(0,o.jsx)(n.code,{children:"Input(gen)"})," is structurally and alignment type equivalent to ",(0,o.jsx)(n.code,{children:"Flipped(cloneChiselTypeButStripAllFlips(gen))"}),"."]}),"\n",(0,o.jsxs)(n.p,{children:["Note that if ",(0,o.jsx)(n.code,{children:"gen"})," is a non-aggregate, then ",(0,o.jsx)(n.code,{children:"Input(nonAggregateGen)"})," is equivalent to ",(0,o.jsx)(n.code,{children:"Flipped(nonAggregateGen)"}),"."]}),"\n",(0,o.jsxs)(n.blockquote,{children:["\n",(0,o.jsxs)(n.p,{children:["Future work will refactor how these primitives are exposed to the user to make Chisel's type system more intuitive.\nSee [",(0,o.jsx)(n.a,{href:"https://github.com/chipsalliance/chisel3/issues/2643",children:"https://github.com/chipsalliance/chisel3/issues/2643"}),"]."]}),"\n"]}),"\n",(0,o.jsx)(n.p,{children:"With this in mind, we can consider the following examples and detail relative alignments of members."}),"\n",(0,o.jsxs)(n.p,{children:["First, we can use a similar example to ",(0,o.jsx)(n.code,{children:"Parent"})," but use ",(0,o.jsx)(n.code,{children:"Input/Output"})," instead of ",(0,o.jsx)(n.code,{children:"Flipped"}),".\nBecause ",(0,o.jsx)(n.code,{children:"alignedChild"})," and ",(0,o.jsx)(n.code,{children:"flippedChild"})," are non-aggregates, ",(0,o.jsx)(n.code,{children:"Input"})," is basically just a ",(0,o.jsx)(n.code,{children:"Flipped"})," and thus the alignments are unchanged compared to the previous ",(0,o.jsx)(n.code,{children:"Parent"})," example."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nclass ParentWithOutputInput extends Bundle {\n  val alignedCoerced = Output(UInt(32.W)) // Equivalent to just UInt(32.W)\n  val flippedCoerced = Input(UInt(32.W))  // Equivalent to Flipped(UInt(32.W))\n}\nclass MyModule2 extends Module {\n  val p = Wire(new ParentWithOutputInput)\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["The alignments are the same as the previous ",(0,o.jsx)(n.code,{children:"Parent"})," example:"]}),"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"p"})," is aligned w.r.t ",(0,o.jsx)(n.code,{children:"p"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"p.alignedCoerced"})," is aligned w.r.t ",(0,o.jsx)(n.code,{children:"p.alignedCoerced"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"p.flippedCoerced"})," is aligned w.r.t ",(0,o.jsx)(n.code,{children:"p.flippedCoerced"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"p"})," is aligned w.r.t ",(0,o.jsx)(n.code,{children:"p.alignedCoerced"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"p"})," is flipped w.r.t ",(0,o.jsx)(n.code,{children:"p.flippedCoerced"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"p.alignedCoerced"})," is flipped w.r.t ",(0,o.jsx)(n.code,{children:"p.flippedCoerced"})]}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["The next example has a nested bundle ",(0,o.jsx)(n.code,{children:"GrandParent"})," who instantiates an ",(0,o.jsx)(n.code,{children:"Output"})," ",(0,o.jsx)(n.code,{children:"ParentWithOutputInput"})," field and an ",(0,o.jsx)(n.code,{children:"Input"})," ",(0,o.jsx)(n.code,{children:"ParentWithOutputInput"})," field."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nclass GrandParentWithOutputInput extends Bundle {\n  val alignedCoerced = Output(new ParentWithOutputInput)\n  val flippedCoerced = Input(new ParentWithOutputInput)\n}\nclass MyModule3 extends Module {\n  val g = Wire(new GrandParentWithOutputInput)\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["Remember that ",(0,o.jsx)(n.code,{children:"Output(gen)/Input(gen)"})," recursively strips the ",(0,o.jsx)(n.code,{children:"Flipped"})," of any recursive children.\nThis makes every member of ",(0,o.jsx)(n.code,{children:"gen"})," aligned with every other member of ",(0,o.jsx)(n.code,{children:"gen"}),"."]}),"\n",(0,o.jsxs)(n.p,{children:["Consider the following alignments between grandparent and grandchildren.\nBecause ",(0,o.jsx)(n.code,{children:"alignedCoerced"})," and ",(0,o.jsx)(n.code,{children:"flippedCoerced"})," are aligned with all their recursive members, they are fully aligned.\nThus, only their alignment to ",(0,o.jsx)(n.code,{children:"g"})," influences grandchildren alignment:"]}),"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"g"})," is aligned w.r.t ",(0,o.jsx)(n.code,{children:"g.alignedCoerced.alignedCoerced"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"g"})," is aligned w.r.t ",(0,o.jsx)(n.code,{children:"g.alignedCoerced.flippedCoerced"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"g"})," is flipped w.r.t ",(0,o.jsx)(n.code,{children:"g.flippedCoerced.alignedCoerced"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"g"})," is flipped w.r.t ",(0,o.jsx)(n.code,{children:"g.flippedCoerced.flippedCoerced"})]}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["Consider the following alignment relationships starting from ",(0,o.jsx)(n.code,{children:"g.alignedCoerced"})," and ",(0,o.jsx)(n.code,{children:"g.flippedCoerced"}),".\n",(0,o.jsxs)(n.em,{children:["Note that whether ",(0,o.jsx)(n.code,{children:"g.alignedCoerced"})," is aligned/flipped relative to ",(0,o.jsx)(n.code,{children:"g"})," has no effect on the aligned/flipped relationship between ",(0,o.jsx)(n.code,{children:"g.alignedCoerced"})," and ",(0,o.jsx)(n.code,{children:"g.alignedCoerced.alignedCoerced"})," or ",(0,o.jsx)(n.code,{children:"g.alignedCoerced.flippedCoerced"})," because alignment is only relative to the two members in question! However, because alignment is coerced, everything is aligned between ",(0,o.jsx)(n.code,{children:"g.alignedCoerced"}),"/",(0,o.jsx)(n.code,{children:"g.flippedAligned"})," and their children"]}),":"]}),"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"g.alignedCoerced"})," is aligned w.r.t. ",(0,o.jsx)(n.code,{children:"g.alignedCoerced.alignedCoerced"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"g.alignedCoerced"})," is aligned w.r.t. ",(0,o.jsx)(n.code,{children:"g.alignedCoerced.flippedCoerced"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"g.flippedCoerced"})," is aligned w.r.t. ",(0,o.jsx)(n.code,{children:"g.flippedCoerced.alignedCoerced"})]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"g.flippedCoerced"})," is aligned w.r.t. ",(0,o.jsx)(n.code,{children:"g.flippedCoerced.flippedCoerced"})]}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["In summary, ",(0,o.jsx)(n.code,{children:"Input(gen)"})," and ",(0,o.jsx)(n.code,{children:"Output(gen)"})," recursively coerce children alignment, as well as dictate ",(0,o.jsx)(n.code,{children:"gen"}),"'s alignment to its parent bundle (if it exists)."]}),"\n",(0,o.jsx)(n.h2,{id:"connecting-components-with-fully-aligned-members",children:"Connecting components with fully aligned members"}),"\n",(0,o.jsx)(n.h3,{id:"mono-direction-connection-operator-",children:"Mono-direction connection operator (:=)"}),"\n",(0,o.jsxs)(n.p,{children:["For simple connections where all members are aligned (non-flipped) w.r.t. one another, use ",(0,o.jsx)(n.code,{children:":="}),":"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nclass FullyAlignedBundle extends Bundle {\n  val a = Bool()\n  val b = Bool()\n}\nclass Example0 extends RawModule {\n  val incoming = IO(Flipped(new FullyAlignedBundle))\n  val outgoing = IO(new FullyAlignedBundle)\n  outgoing := incoming\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["This generates the following Verilog, where each member of ",(0,o.jsx)(n.code,{children:"incoming"})," drives every member of ",(0,o.jsx)(n.code,{children:"outgoing"}),":"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example0(\t// connectable.md:85:7\n  input  incoming_a,\t// connectable.md:86:20\n         incoming_b,\t// connectable.md:86:20\n  output outgoing_a,\t// connectable.md:87:20\n         outgoing_b\t// connectable.md:87:20\n);\n\n  assign outgoing_a = incoming_a;\t// connectable.md:85:7\n  assign outgoing_b = incoming_b;\t// connectable.md:85:7\nendmodule\n\n"})}),"\n",(0,o.jsxs)(n.blockquote,{children:["\n",(0,o.jsxs)(n.p,{children:["You may be thinking \"Wait, I'm confused! Isn't ",(0,o.jsx)(n.code,{children:"incoming"})," flipped and ",(0,o.jsx)(n.code,{children:"outgoing"}),' aligned?" -- Noo! Whether ',(0,o.jsx)(n.code,{children:"incoming"})," is aligned with ",(0,o.jsx)(n.code,{children:"outgoing"})," makes no sense; remember, you only evaluate alignment between members of the same component or Chisel type.\nBecause components are always aligned to themselves, ",(0,o.jsx)(n.code,{children:"outgoing"})," is aligned to ",(0,o.jsx)(n.code,{children:"outgoing"}),", and ",(0,o.jsx)(n.code,{children:"incoming"})," is aligned to ",(0,o.jsx)(n.code,{children:"incoming"}),", there is no problem.\nTheir relative flippedness to anything else is irrelevant."]}),"\n"]}),"\n",(0,o.jsx)(n.h2,{id:"connecting-components-with-mixed-alignment-members",children:"Connecting components with mixed alignment members"}),"\n",(0,o.jsxs)(n.p,{children:["Aggregate Chisel types can include data members which are flipped relative to one another; in the example below, ",(0,o.jsx)(n.code,{children:"alignedChild"})," and ",(0,o.jsx)(n.code,{children:"flippedChild"})," are aligned/flipped relative to ",(0,o.jsx)(n.code,{children:"MixedAlignmentBundle"}),"."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nclass MixedAlignmentBundle extends Bundle {\n  val alignedChild = Bool()\n  val flippedChild = Flipped(Bool())\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["Due to this, there are many desired connection behaviors between two Chisel components.\nFirst we will introduce the most common Chisel connection operator, ",(0,o.jsx)(n.code,{children:":<>="}),", useful for connecting components with members of mixed-alignments, then take a moment to investigate a common source of confusion between port-direction and connection-direction.\nThen, we will explore the remainder of the Chisel connection operators."]}),"\n",(0,o.jsxs)(n.h3,{id:"bi-direction-connection-operator-",children:["Bi-direction connection operator (",(0,o.jsx)(n.code,{children:":<>="}),")"]}),"\n",(0,o.jsxs)(n.p,{children:["For connections where you want 'bulk-connect-like-semantics' where the aligned members are driven producer-to-consumer and flipped members are driven consumer-to-producer, use ",(0,o.jsx)(n.code,{children:":<>="}),"."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"class Example1 extends RawModule {\n  val incoming = IO(Flipped(new MixedAlignmentBundle))\n  val outgoing = IO(new MixedAlignmentBundle)\n  outgoing :<>= incoming\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["This generates the following Verilog, where the aligned members are driven ",(0,o.jsx)(n.code,{children:"incoming"})," to ",(0,o.jsx)(n.code,{children:"outgoing"})," and flipped members are driven ",(0,o.jsx)(n.code,{children:"outgoing"})," to ",(0,o.jsx)(n.code,{children:"incoming"}),":"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example1(\t// connectable.md:113:7\n  input  incoming_alignedChild,\t// connectable.md:114:20\n  output incoming_flippedChild,\t// connectable.md:114:20\n         outgoing_alignedChild,\t// connectable.md:115:20\n  input  outgoing_flippedChild\t// connectable.md:115:20\n);\n\n  assign incoming_flippedChild = outgoing_flippedChild;\t// connectable.md:113:7\n  assign outgoing_alignedChild = incoming_alignedChild;\t// connectable.md:113:7\nendmodule\n\n"})}),"\n",(0,o.jsx)(n.h3,{id:"port-direction-computation-versus-connection-direction-computation",children:"Port-Direction Computation versus Connection-Direction Computation"}),"\n",(0,o.jsxs)(n.p,{children:["A common question is if you use a mixed-alignment connection (such as ",(0,o.jsx)(n.code,{children:":<>="}),") to connect submembers of parent components, does the alignment of the submember to their parent affect anything? The answer is no, because ",(0,o.jsx)(n.em,{children:"alignment is always computed relative to what is being connected to, and members are always aligned with themselves."})]}),"\n",(0,o.jsxs)(n.p,{children:["In the following example connecting from ",(0,o.jsx)(n.code,{children:"incoming.alignedChild"})," to ",(0,o.jsx)(n.code,{children:"outgoing.alignedChild"}),", whether ",(0,o.jsx)(n.code,{children:"incoming.alignedChild"})," is aligned with ",(0,o.jsx)(n.code,{children:"incoming"})," is irrelevant because the ",(0,o.jsx)(n.code,{children:":<>="})," only computes alignment relative to the thing being connected to, and ",(0,o.jsx)(n.code,{children:"incoming.alignedChild"})," is aligned with ",(0,o.jsx)(n.code,{children:"incoming.alignedChild"}),"."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"class Example1a extends RawModule {\n  val incoming = IO(Flipped(new MixedAlignmentBundle))\n  val outgoing = IO(new MixedAlignmentBundle)\n  outgoing.alignedChild :<>= incoming.alignedChild // whether incoming.alignedChild is aligned/flipped to incoming is IRRELEVANT to what gets connected with :<>=\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["While ",(0,o.jsx)(n.code,{children:"incoming.flippedChild"}),"'s alignment with ",(0,o.jsx)(n.code,{children:"incoming"})," does not affect our operators, it does influence whether ",(0,o.jsx)(n.code,{children:"incoming.flippedChild"})," is an output or input port of my module.\nA common source of confusion is to mistake the process for determining whether ",(0,o.jsx)(n.code,{children:"incoming.flippedChild"})," will resolve to a Verilog ",(0,o.jsx)(n.code,{children:"output"}),"/",(0,o.jsx)(n.code,{children:"input"})," (the port-direction computation) with the process for determining how ",(0,o.jsx)(n.code,{children:":<>="})," drives what with what (the connection-direction computation).\nWhile both processes consider relative alignment, they are distinct."]}),"\n",(0,o.jsxs)(n.p,{children:["The port-direction computation always computes alignment relative to the component marked with ",(0,o.jsx)(n.code,{children:"IO"}),".\nAn ",(0,o.jsx)(n.code,{children:"IO(Flipped(gen))"})," is an incoming port, and any member of ",(0,o.jsx)(n.code,{children:"gen"})," that is aligned/flipped with ",(0,o.jsx)(n.code,{children:"gen"})," is an incoming/outgoing port.\nAn ",(0,o.jsx)(n.code,{children:"IO(gen)"})," is an outgoing port, and any member of ",(0,o.jsx)(n.code,{children:"gen"})," that is aligned/flipped with ",(0,o.jsx)(n.code,{children:"gen"})," is an outgoing/incoming port."]}),"\n",(0,o.jsxs)(n.p,{children:["The connection-direction computation always computes alignment based on the explicit consumer/producer referenced for the connection.\nIf one connects ",(0,o.jsx)(n.code,{children:"incoming :<>= outgoing"}),", alignments are computed based on ",(0,o.jsx)(n.code,{children:"incoming"})," and ",(0,o.jsx)(n.code,{children:"outgoing"}),".\nIf one connects ",(0,o.jsx)(n.code,{children:"incoming.alignedChild :<>= outgoing.alignedChild"}),", then alignments are computed based on ",(0,o.jsx)(n.code,{children:"incoming.alignedChild"})," and ",(0,o.jsx)(n.code,{children:"outgoing.alignedChild"})," (and the alignment of ",(0,o.jsx)(n.code,{children:"incoming"})," to ",(0,o.jsx)(n.code,{children:"incoming.alignedChild"})," is irrelevant)."]}),"\n",(0,o.jsxs)(n.p,{children:["This means that users can try to connect to input ports of their module! If I write ",(0,o.jsx)(n.code,{children:"x :<>= y"}),", and ",(0,o.jsx)(n.code,{children:"x"})," is an input to the current module, then that is what the connection is trying to do.\nHowever, because input ports are not drivable from within the current module, Chisel will throw an error.\nThis is the same error a user would get using a mono-directioned operator: ",(0,o.jsx)(n.code,{children:"x := y"})," will throw the same error if ",(0,o.jsx)(n.code,{children:"x"})," is an input to the current module.\n",(0,o.jsx)(n.em,{children:"Whether a component is drivable is irrelevant to the semantics of any connection operator attempting to drive to it."})]}),"\n",(0,o.jsxs)(n.p,{children:["In summary, the port-direction computation is relative to the root marked ",(0,o.jsx)(n.code,{children:"IO"}),", but connection-direction computation is relative to the consumer/producer that the connection is doing.\nThis has the positive property that connection semantics are solely based on the Chisel structural type and its relative alignments of the consumer/producer (nothing more, nothing less)."]}),"\n",(0,o.jsxs)(n.h3,{id:"aligned-connection-operator-",children:["Aligned connection operator (",(0,o.jsx)(n.code,{children:":<="}),")"]}),"\n",(0,o.jsxs)(n.p,{children:["For connections where you want the aligned-half of 'bulk-connect-like-semantics' where the aligned members are driven producer-to-consumer and flipped members are ignored, use ",(0,o.jsx)(n.code,{children:":<="}),' (the "aligned connection").']}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"class Example2 extends RawModule {\n  val incoming = IO(Flipped(new MixedAlignmentBundle))\n  val outgoing = IO(new MixedAlignmentBundle)\n  incoming.flippedChild := DontCare // Otherwise FIRRTL throws an uninitialization error\n  outgoing :<= incoming\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["This generates the following Verilog, where the aligned members are driven ",(0,o.jsx)(n.code,{children:"incoming"})," to ",(0,o.jsx)(n.code,{children:"outgoing"})," and flipped members are ignored:"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example2(\t// connectable.md:139:7\n  input  incoming_alignedChild,\t// connectable.md:140:20\n  output incoming_flippedChild,\t// connectable.md:140:20\n         outgoing_alignedChild,\t// connectable.md:141:20\n  input  outgoing_flippedChild\t// connectable.md:141:20\n);\n\n  assign incoming_flippedChild = 1'h0;\t// connectable.md:139:7\n  assign outgoing_alignedChild = incoming_alignedChild;\t// connectable.md:139:7\nendmodule\n\n"})}),"\n",(0,o.jsxs)(n.h3,{id:"flipped-connection-operator-",children:["Flipped connection operator (",(0,o.jsx)(n.code,{children:":>="}),")"]}),"\n",(0,o.jsxs)(n.p,{children:["For connections where you want the flipped-half of 'bulk-connect-like-semantics' where the aligned members are ignored and flipped members are connected consumer-to-producer, use ",(0,o.jsx)(n.code,{children:":>="}),' (the "flipped connection", or "backpressure connection").']}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"class Example3 extends RawModule {\n  val incoming = IO(Flipped(new MixedAlignmentBundle))\n  val outgoing = IO(new MixedAlignmentBundle)\n  outgoing.alignedChild := DontCare // Otherwise FIRRTL throws an uninitialization error\n  outgoing :>= incoming\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["This generates the following Verilog, where the aligned members are ignored and the flipped members are driven ",(0,o.jsx)(n.code,{children:"outgoing"})," to ",(0,o.jsx)(n.code,{children:"incoming"}),":"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example3(\t// connectable.md:156:7\n  input  incoming_alignedChild,\t// connectable.md:157:20\n  output incoming_flippedChild,\t// connectable.md:157:20\n         outgoing_alignedChild,\t// connectable.md:158:20\n  input  outgoing_flippedChild\t// connectable.md:158:20\n);\n\n  assign incoming_flippedChild = outgoing_flippedChild;\t// connectable.md:156:7\n  assign outgoing_alignedChild = 1'h0;\t// connectable.md:156:7\nendmodule\n\n"})}),"\n",(0,o.jsxs)(n.blockquote,{children:["\n",(0,o.jsxs)(n.p,{children:["Note: Astute observers will realize that ",(0,o.jsx)(n.code,{children:"c :<>= p"})," is semantically equivalent to ",(0,o.jsx)(n.code,{children:"c :<= p"})," followed by ",(0,o.jsx)(n.code,{children:"c :>= p"}),"."]}),"\n"]}),"\n",(0,o.jsxs)(n.h3,{id:"coercing-mono-direction-connection-operator-",children:["Coercing mono-direction connection operator (",(0,o.jsx)(n.code,{children:":#="}),")"]}),"\n",(0,o.jsxs)(n.p,{children:["For connections where you want to every producer member to always drive every consumer member, regardless of alignment, use ",(0,o.jsx)(n.code,{children:":#="}),' (the "coercion connection").\nThis operator is useful for initializing wires whose types contain members of mixed alignment.']}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"import chisel3.experimental.BundleLiterals._\nclass Example4 extends RawModule {\n  val w = Wire(new MixedAlignmentBundle)\n  dontTouch(w) // So we see it in the output Verilog\n  w :#= (new MixedAlignmentBundle).Lit(_.alignedChild -> true.B, _.flippedChild -> true.B)\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["This generates the following Verilog, where all members are driven from the literal to ",(0,o.jsx)(n.code,{children:"w"}),", regardless of alignment:"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example4();\t// connectable.md:176:7\n  wire w_alignedChild = 1'h1;\t// connectable.md:177:15\n  wire w_flippedChild = 1'h1;\t// connectable.md:177:15\nendmodule\n\n"})}),"\n",(0,o.jsxs)(n.blockquote,{children:["\n",(0,o.jsxs)(n.p,{children:["Note: Astute observers will realize that ",(0,o.jsx)(n.code,{children:"c :#= p"})," is semantically equivalent to ",(0,o.jsx)(n.code,{children:"c :<= p"})," followed by ",(0,o.jsx)(n.code,{children:"p :>= c"})," (note ",(0,o.jsx)(n.code,{children:"p"})," and ",(0,o.jsx)(n.code,{children:"c"})," switched places in the second connection)."]}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["Another use case for ",(0,o.jsx)(n.code,{children:":#="})," is for connecting a mixed-directional bundle to a fully-aligned monitor."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"import chisel3.experimental.BundleLiterals._\nclass Example4b extends RawModule {\n  val monitor = IO(Output(new MixedAlignmentBundle))\n  val w = Wire(new MixedAlignmentBundle)\n  dontTouch(w) // So we see it in the output Verilog\n  w :#= DontCare\n  monitor :#= w\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["This generates the following Verilog, where all members are driven from the literal to ",(0,o.jsx)(n.code,{children:"w"}),", regardless of alignment:"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example4b(\t// connectable.md:195:7\n  output monitor_alignedChild,\t// connectable.md:196:19\n         monitor_flippedChild\t// connectable.md:196:19\n);\n\n  wire w_alignedChild = 1'h0;\t// connectable.md:197:15\n  wire w_flippedChild = 1'h0;\t// connectable.md:197:15\n  assign monitor_alignedChild = w_alignedChild;\t// connectable.md:195:7, :197:15\n  assign monitor_flippedChild = w_flippedChild;\t// connectable.md:195:7, :197:15\nendmodule\n\n"})}),"\n",(0,o.jsx)(n.h2,{id:"connectable",children:"Connectable"}),"\n",(0,o.jsxs)(n.p,{children:["Sometimes a user wants to connect Chisel components which are not type equivalent.\nFor example, a user may want to hook up anonymous ",(0,o.jsx)(n.code,{children:"Record"})," components who may have an intersection of their fields being equivalent, but cannot because they are not structurally equivalent.\nAlternatively, one may want to connect two types that have different widths."]}),"\n",(0,o.jsxs)(n.p,{children:[(0,o.jsx)(n.code,{children:"Connectable"})," is the mechanism to specialize connection operator behavior in these scenarios.\nFor additional members which are not present in the other component being connected to, or for mismatched widths, or for always excluding a member from being connected to, they can be explicitly called out from the ",(0,o.jsx)(n.code,{children:"Connectable"})," object, rather than trigger an error."]}),"\n",(0,o.jsxs)(n.p,{children:["In addition, there are other techniques that can be used to address similar use cases including ",(0,o.jsx)(n.code,{children:".viewAsSuperType"}),", a static cast to a supertype (e.g. ",(0,o.jsx)(n.code,{children:"(x: T)"}),"), or creating a custom ",(0,o.jsx)(n.code,{children:"DataView"}),".\nFor a discussion about when to use each technique, please continue ",(0,o.jsx)(n.a,{href:"#techniques-for-connecting-structurally-inequivalent-chisel-types",children:"here"}),"."]}),"\n",(0,o.jsxs)(n.p,{children:["This section demonstrates how ",(0,o.jsx)(n.code,{children:"Connectable"})," specifically can be used in a multitude of scenarios."]}),"\n",(0,o.jsx)(n.h3,{id:"connecting-records",children:"Connecting Records"}),"\n",(0,o.jsxs)(n.p,{children:["One use case is to try to connect two ",(0,o.jsx)(n.code,{children:"Record"}),"s; for matching members, they should be connected, but for unmatched members, the errors caused due to them being unmatched should be ignored.\nTo accomplish this, use the other operators to initialize all ",(0,o.jsx)(n.code,{children:"Record"})," members, then use ",(0,o.jsx)(n.code,{children:":<>="})," with ",(0,o.jsx)(n.code,{children:".waive"})," to connect only the matching members."]}),"\n",(0,o.jsxs)(n.blockquote,{children:["\n",(0,o.jsxs)(n.p,{children:["Note that none of ",(0,o.jsx)(n.code,{children:".viewAsSuperType"}),", static casts, nor a custom ",(0,o.jsx)(n.code,{children:"DataView"})," helps this case because the Scala types are still ",(0,o.jsx)(n.code,{children:"Record"}),"."]}),"\n"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:'import scala.collection.immutable.SeqMap\n\nclass Example9 extends RawModule {\n  val abType = new Record { val elements = SeqMap("a" -> Bool(), "b" -> Flipped(Bool())) }\n  val bcType = new Record { val elements = SeqMap("b" -> Flipped(Bool()), "c" -> Bool()) }\n\n  val p = IO(Flipped(abType))\n  val c = IO(bcType)\n\n  DontCare :>= p\n  c :<= DontCare\n\n  c.waive(_.elements("c")):<>= p.waive(_.elements("a"))\n}\n'})}),"\n",(0,o.jsxs)(n.p,{children:["This generates the following Verilog, where ",(0,o.jsx)(n.code,{children:"p.b"})," is driven from ",(0,o.jsx)(n.code,{children:"c.b"}),":"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example9(\t// connectable.md:216:7\n  output p_b,\t// connectable.md:220:13\n  input  p_a,\t// connectable.md:220:13\n  output c_c,\t// connectable.md:221:13\n  input  c_b\t// connectable.md:221:13\n);\n\n  assign p_b = c_b;\t// connectable.md:216:7\n  assign c_c = 1'h0;\t// connectable.md:216:7\nendmodule\n\n"})}),"\n",(0,o.jsx)(n.h3,{id:"defaults-with-waived-connections",children:"Defaults with waived connections"}),"\n",(0,o.jsxs)(n.p,{children:["Another use case is to try to connect two ",(0,o.jsx)(n.code,{children:"Record"}),"s; for matching members, they should be connected, but for unmatched members, ",(0,o.jsx)(n.em,{children:"they should be connected to a default value"}),".\nTo accomplish this, use the other operators to initialize all ",(0,o.jsx)(n.code,{children:"Record"})," members, then use ",(0,o.jsx)(n.code,{children:":<>="})," with ",(0,o.jsx)(n.code,{children:".waive"})," to connect only the matching members."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:'import scala.collection.immutable.SeqMap\n\nclass Example10 extends RawModule {\n  val abType = new Record { val elements = SeqMap("a" -> Bool(), "b" -> Flipped(Bool())) }\n  val bcType = new Record { val elements = SeqMap("b" -> Flipped(Bool()), "c" -> Bool()) }\n\n  val p = Wire(abType)\n  val c = Wire(bcType)\n\n  dontTouch(p) // So it doesn\'t get constant-propped away for the example\n  dontTouch(c) // So it doesn\'t get constant-propped away for the example\n\n  p :#= abType.Lit(_.elements("a") -> true.B, _.elements("b") -> true.B)\n  c :#= bcType.Lit(_.elements("b") -> true.B, _.elements("c") -> true.B)\n\n  c.waive(_.elements("c")) :<>= p.waive(_.elements("a"))\n}\n'})}),"\n",(0,o.jsxs)(n.p,{children:["This generates the following Verilog, where ",(0,o.jsx)(n.code,{children:"p.b"})," is driven from ",(0,o.jsx)(n.code,{children:"c.b"}),", and ",(0,o.jsx)(n.code,{children:"p.a"}),", ",(0,o.jsx)(n.code,{children:"c.b"}),", and ",(0,o.jsx)(n.code,{children:"c.c"})," are initialized to default values:"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example10();\t// connectable.md:242:7\n  wire p_a = 1'h1;\t// connectable.md:246:15\n  wire c_c = 1'h1;\t// connectable.md:247:15\n  wire c_b = 1'h1;\t// connectable.md:247:15\n  wire p_b = c_b;\t// connectable.md:246:15, :247:15\nendmodule\n\n"})}),"\n",(0,o.jsx)(n.h3,{id:"connecting-types-with-optional-members",children:"Connecting types with optional members"}),"\n",(0,o.jsxs)(n.p,{children:["In the following example, we can use ",(0,o.jsx)(n.code,{children:":<>="})," and ",(0,o.jsx)(n.code,{children:".waive"})," to connect two ",(0,o.jsx)(n.code,{children:"MyDecoupledOpts"}),"'s, where only one has a ",(0,o.jsx)(n.code,{children:"bits"})," member."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"class MyDecoupledOpt(hasBits: Boolean) extends Bundle {\n  val valid = Bool()\n  val ready = Flipped(Bool())\n  val bits = if (hasBits) Some(UInt(32.W)) else None\n}\nclass Example6 extends RawModule {\n  val in  = IO(Flipped(new MyDecoupledOpt(true)))\n  val out = IO(new MyDecoupledOpt(false))\n  out :<>= in.waive(_.bits.get) // We can know to call .get because we can inspect in.bits.isEmpty\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["This generates the following Verilog, where ",(0,o.jsx)(n.code,{children:"ready"})," and ",(0,o.jsx)(n.code,{children:"valid"})," are connected, and ",(0,o.jsx)(n.code,{children:"bits"})," is ignored:"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example6(\t// connectable.md:275:7\n  input         in_valid,\t// connectable.md:276:15\n  output        in_ready,\t// connectable.md:276:15\n  input  [31:0] in_bits,\t// connectable.md:276:15\n  output        out_valid,\t// connectable.md:277:15\n  input         out_ready\t// connectable.md:277:15\n);\n\n  assign in_ready = out_ready;\t// connectable.md:275:7\n  assign out_valid = in_valid;\t// connectable.md:275:7\nendmodule\n\n"})}),"\n",(0,o.jsx)(n.h3,{id:"always-ignore-errors-caused-by-extra-members-partial-connection-operator",children:"Always ignore errors caused by extra members (partial connection operator)"}),"\n",(0,o.jsx)(n.p,{children:"The most unsafe connection is to connect only members that are present in both consumer and producer, and ignore all other members.\nThis is unsafe because this connection will never error on any Chisel types."}),"\n",(0,o.jsxs)(n.p,{children:["To do this, you can use ",(0,o.jsx)(n.code,{children:".waiveAll"})," and static cast to ",(0,o.jsx)(n.code,{children:"Data"}),":"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"class OnlyA extends Bundle {\n  val a = UInt(32.W)\n}\nclass OnlyB extends Bundle {\n  val b = UInt(32.W)\n}\nclass Example11 extends RawModule {\n  val in  = IO(Flipped(new OnlyA))\n  val out = IO(new OnlyB)\n\n  out := DontCare\n\n  (out: Data).waiveAll :<>= (in: Data).waiveAll\n}\n"})}),"\n",(0,o.jsx)(n.p,{children:"This generates the following Verilog, where nothing is connected:"}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example11(\t// connectable.md:301:7\n  input  [31:0] in_a,\t// connectable.md:302:15\n  output [31:0] out_b\t// connectable.md:303:15\n);\n\n  assign out_b = 32'h0;\t// connectable.md:301:7\nendmodule\n\n"})}),"\n",(0,o.jsx)(n.h3,{id:"connecting-components-with-different-widths",children:"Connecting components with different widths"}),"\n",(0,o.jsxs)(n.p,{children:["Non-",(0,o.jsx)(n.code,{children:"Connectable"})," operators implicitly truncate if a component with a larger width is connected to a component with a smaller width.\n",(0,o.jsx)(n.code,{children:"Connectable"})," operators disallow this implicit truncation behavior and require the driven component to be equal or larger in width that the sourcing component."]}),"\n",(0,o.jsxs)(n.p,{children:["If implicit truncation behavior is desired, then ",(0,o.jsx)(n.code,{children:"Connectable"})," provides a ",(0,o.jsx)(n.code,{children:"squeeze"})," mechanism which will allow the connection to continue with implicit truncation."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"import scala.collection.immutable.SeqMap\n\nclass Example14 extends RawModule {\n  val p = IO(Flipped(UInt(4.W)))\n  val c = IO(UInt(3.W))\n\n  c :<>= p.squeeze\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["This generates the following Verilog, where ",(0,o.jsx)(n.code,{children:"p"})," is truncated prior to driving ",(0,o.jsx)(n.code,{children:"c"}),":"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example14(\t// connectable.md:323:7\n  input  [3:0] p,\t// connectable.md:324:13\n  output [2:0] c\t// connectable.md:325:13\n);\n\n  assign c = p[2:0];\t// connectable.md:323:7, :327:5\nendmodule\n\n"})}),"\n",(0,o.jsx)(n.h3,{id:"excluding-members-from-any-operator-on-a-connectable",children:"Excluding members from any operator on a Connectable"}),"\n",(0,o.jsxs)(n.p,{children:["If a user wants to always exclude a field from a connect, use the ",(0,o.jsx)(n.code,{children:".exclude"})," mechanism which will never connect the field (as if it didn't exist to the connection)."]}),"\n",(0,o.jsxs)(n.p,{children:["Note that if a field matches in both producer and consumer, but only one is excluded, the other non-excluded field will still trigger an error; to fix this, use either ",(0,o.jsx)(n.code,{children:".waive"})," or ",(0,o.jsx)(n.code,{children:".exclude"}),"."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"import scala.collection.immutable.SeqMap\n\nclass BundleWithSpecialField extends Bundle {\n  val foo = UInt(3.W)\n  val special = Bool()\n}\nclass Example15 extends RawModule {\n  val p = IO(Flipped(new BundleWithSpecialField()))\n  val c = IO(new BundleWithSpecialField())\n\n  c.special := true.B // must initialize it\n\n  c.exclude(_.special) :<>= p.exclude(_.special)\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["This generates the following Verilog, where the ",(0,o.jsx)(n.code,{children:"special"})," field is not connected:"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example15(\t// connectable.md:349:7\n  input  [2:0] p_foo,\t// connectable.md:350:13\n  input        p_special,\t// connectable.md:350:13\n  output [2:0] c_foo,\t// connectable.md:351:13\n  output       c_special\t// connectable.md:351:13\n);\n\n  assign c_foo = p_foo;\t// connectable.md:349:7\n  assign c_special = 1'h1;\t// connectable.md:349:7\nendmodule\n\n"})}),"\n",(0,o.jsx)(n.h2,{id:"techniques-for-connecting-structurally-inequivalent-chisel-types",children:"Techniques for connecting structurally inequivalent Chisel types"}),"\n",(0,o.jsxs)(n.p,{children:[(0,o.jsx)(n.code,{children:"DataView"})," and ",(0,o.jsx)(n.code,{children:".viewAsSupertype"})," create a view of the component that has a different Chisel type.\nThis means that a user can first create a ",(0,o.jsx)(n.code,{children:"DataView"})," of the consumer or producer (or both) so that the Chisel types are structurally equivalent.\nThis is useful when the difference between the consumer and producer aren't super nested, and also if they have rich Scala types which encode their structure.\nIn general, ",(0,o.jsx)(n.code,{children:"DataView"})," is the preferred mechanism to use (if you can) because it maintains the most amount of Chisel information in the Scala type, but there are many instances where it doesn't work and thus one must fall back on ",(0,o.jsx)(n.code,{children:"Connectable"}),"."]}),"\n",(0,o.jsxs)(n.p,{children:[(0,o.jsx)(n.code,{children:"Connectable"})," does not change the Chisel type, but instead changes the semantics of the operator to not error on the waived members if they are dangling or unconnected.\nThis is useful for when differences between the consumer and producer do not show up in the Scala type system (e.g. present/missing fields of type ",(0,o.jsx)(n.code,{children:"Option[Data]"}),", or anonymous ",(0,o.jsx)(n.code,{children:"Record"}),"s) or are deeply nested in a bundle that is especially onerous to create a ",(0,o.jsx)(n.code,{children:"DataView"}),"."]}),"\n",(0,o.jsxs)(n.p,{children:["Static casts (e.g. ",(0,o.jsx)(n.code,{children:"(x: T)"}),") allows connecting components that have different Scala types, but leaves the Chisel type unchanged.\nUse this to force a connection to occur, even if the Scala types are different."]}),"\n",(0,o.jsxs)(n.blockquote,{children:["\n",(0,o.jsx)(n.p,{children:'One may wonder why the operators require identical Scala types in the first place, if they can easily be bypassed.\nThe reason is to encourage users to use the Scala type system to encode Chisel information as it can make their code more robust; however, we don\'t want to be draconian about it because there are times when we want to enable the user to "just connect the darn thing".'}),"\n"]}),"\n",(0,o.jsx)(n.p,{children:"When all else fails one can always manually expand the connection to do what they want to happen, member by member.\nThe down-side to this approach is its verbosity and that adding new members to a component will require updating the manual connections."}),"\n",(0,o.jsxs)(n.p,{children:["Things to remember about ",(0,o.jsx)(n.code,{children:"Connectable"})," vs ",(0,o.jsx)(n.code,{children:".viewAsSupertype"}),"/",(0,o.jsx)(n.code,{children:"DataView"})," vs static cast (e.g. ",(0,o.jsx)(n.code,{children:"(x: T)"}),"):"]}),"\n",(0,o.jsxs)(n.ul,{children:["\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"DataView"})," and ",(0,o.jsx)(n.code,{children:".viewAsSupertype"})," will preemptively remove members that are not present in the new view which has a different Chisel type, thus ",(0,o.jsx)(n.code,{children:"DataView"})," ",(0,o.jsx)(n.em,{children:"does"})," affect what is connected"]}),"\n",(0,o.jsxs)(n.li,{children:[(0,o.jsx)(n.code,{children:"Connectable"})," can be used to waive the error on members who end up being dangling or unconnected.\nImportantly, ",(0,o.jsx)(n.code,{children:"Connectable"})," waives ",(0,o.jsx)(n.em,{children:"do not"})," affect what is connected"]}),"\n",(0,o.jsxs)(n.li,{children:["Static cast does not remove extra members, thus a static cast ",(0,o.jsx)(n.em,{children:"does not"})," affect what is connected"]}),"\n"]}),"\n",(0,o.jsx)(n.h3,{id:"connecting-different-sub-types-of-the-same-super-type-with-colliding-names",children:"Connecting different sub-types of the same super-type, with colliding names"}),"\n",(0,o.jsxs)(n.p,{children:["In these examples, we are connecting ",(0,o.jsx)(n.code,{children:"MyDecoupled"})," with ",(0,o.jsx)(n.code,{children:"MyDecoupledOtherBits"}),".\nBoth are subtypes of ",(0,o.jsx)(n.code,{children:"MyReadyValid"}),", and both have a ",(0,o.jsx)(n.code,{children:"bits"})," field of type ",(0,o.jsx)(n.code,{children:"UInt(32.W)"}),"."]}),"\n",(0,o.jsxs)(n.p,{children:["The first example will use ",(0,o.jsx)(n.code,{children:".viewAsSupertype"})," to connect them as ",(0,o.jsx)(n.code,{children:"MyReadyValid"}),".\nBecause it changes the Chisel type to omit both ",(0,o.jsx)(n.code,{children:"bits"})," fields, the ",(0,o.jsx)(n.code,{children:"bits"})," fields are unconnected."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"import experimental.dataview._\nclass MyDecoupledOtherBits extends MyReadyValid {\n  val bits = UInt(32.W)\n}\nclass Example12 extends RawModule {\n  val in  = IO(Flipped(new MyDecoupled))\n  val out = IO(new MyDecoupledOtherBits)\n\n  out := DontCare\n\n  out.viewAsSupertype(new MyReadyValid) :<>= in.viewAsSupertype(new MyReadyValid)\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["Note that the ",(0,o.jsx)(n.code,{children:"bits"})," fields are unconnected."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example12(\t// connectable.md:376:7\n  input         in_valid,\t// connectable.md:377:15\n  output        in_ready,\t// connectable.md:377:15\n  input  [31:0] in_bits,\t// connectable.md:377:15\n  output        out_valid,\t// connectable.md:378:15\n  input         out_ready,\t// connectable.md:378:15\n  output [31:0] out_bits\t// connectable.md:378:15\n);\n\n  assign in_ready = out_ready;\t// connectable.md:376:7\n  assign out_valid = in_valid;\t// connectable.md:376:7\n  assign out_bits = 32'h0;\t// connectable.md:376:7\nendmodule\n\n"})}),"\n",(0,o.jsxs)(n.p,{children:["The second example will use a static cast and ",(0,o.jsx)(n.code,{children:".waive(_.bits)"})," to connect them as ",(0,o.jsx)(n.code,{children:"MyReadyValid"}),".\nNote that because the static cast does not change the Chisel type, the connection finds that both consumer and producer have a ",(0,o.jsx)(n.code,{children:"bits"})," field.\nThis means that since they are structurally equivalent, they match and are connected.\nThe ",(0,o.jsx)(n.code,{children:"waive(_.bits)"})," does nothing, because the ",(0,o.jsx)(n.code,{children:"bits"})," are neither dangling nor unconnected."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"import experimental.dataview._\nclass Example13 extends RawModule {\n  val in  = IO(Flipped(new MyDecoupled))\n  val out = IO(new MyDecoupledOtherBits)\n\n  out := DontCare\n\n  out.waiveAs[MyReadyValid](_.bits) :<>= in.waiveAs[MyReadyValid](_.bits)\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["Note that the ",(0,o.jsx)(n.code,{children:"bits"})," fields ARE connected, even though they are waived, as ",(0,o.jsx)(n.code,{children:".waive"})," just changes whether an error should be thrown if they are missing, NOT to not connect them if they are structurally equivalent.\nTo always omit the connection, use ",(0,o.jsx)(n.code,{children:".exclude"})," on one side and either ",(0,o.jsx)(n.code,{children:".exclude"})," or ",(0,o.jsx)(n.code,{children:".waive"})," on the other side."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example13(\t// connectable.md:398:7\n  input         in_valid,\t// connectable.md:399:15\n  output        in_ready,\t// connectable.md:399:15\n  input  [31:0] in_bits,\t// connectable.md:399:15\n  output        out_valid,\t// connectable.md:400:15\n  input         out_ready,\t// connectable.md:400:15\n  output [31:0] out_bits\t// connectable.md:400:15\n);\n\n  assign in_ready = out_ready;\t// connectable.md:398:7\n  assign out_valid = in_valid;\t// connectable.md:398:7\n  assign out_bits = in_bits;\t// connectable.md:398:7\nendmodule\n\n"})}),"\n",(0,o.jsx)(n.h3,{id:"connecting-sub-types-to-super-types-by-waiving-extra-members",children:"Connecting sub-types to super-types by waiving extra members"}),"\n",(0,o.jsxs)(n.blockquote,{children:["\n",(0,o.jsxs)(n.p,{children:["Note that in this example, it would be better to use ",(0,o.jsx)(n.code,{children:".viewAsSupertype"}),"."]}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["In the following example, we can use ",(0,o.jsx)(n.code,{children:":<>="})," to connect a ",(0,o.jsx)(n.code,{children:"MyReadyValid"})," to a ",(0,o.jsx)(n.code,{children:"MyDecoupled"})," by waiving the ",(0,o.jsx)(n.code,{children:"bits"})," member."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"class MyReadyValid extends Bundle {\n  val valid = Bool()\n  val ready = Flipped(Bool())\n}\nclass MyDecoupled extends MyReadyValid {\n  val bits = UInt(32.W)\n}\nclass Example5 extends RawModule {\n  val in  = IO(Flipped(new MyDecoupled))\n  val out = IO(new MyReadyValid)\n  out :<>= in.waiveAs[MyReadyValid](_.bits)\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["This generates the following Verilog, where ",(0,o.jsx)(n.code,{children:"ready"})," and ",(0,o.jsx)(n.code,{children:"valid"})," are connected, and ",(0,o.jsx)(n.code,{children:"bits"})," is ignored:"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example5(\t// connectable.md:428:7\n  input         in_valid,\t// connectable.md:429:15\n  output        in_ready,\t// connectable.md:429:15\n  input  [31:0] in_bits,\t// connectable.md:429:15\n  output        out_valid,\t// connectable.md:430:15\n  input         out_ready\t// connectable.md:430:15\n);\n\n  assign in_ready = out_ready;\t// connectable.md:428:7\n  assign out_valid = in_valid;\t// connectable.md:428:7\nendmodule\n\n"})}),"\n",(0,o.jsx)(n.h3,{id:"connecting-different-sub-types",children:"Connecting different sub-types"}),"\n",(0,o.jsxs)(n.blockquote,{children:["\n",(0,o.jsxs)(n.p,{children:["Note that in this example, it would be better to use ",(0,o.jsx)(n.code,{children:".viewAsSupertype"}),"."]}),"\n"]}),"\n",(0,o.jsxs)(n.p,{children:["Note that the connection operator requires the ",(0,o.jsx)(n.code,{children:"consumer"})," and ",(0,o.jsx)(n.code,{children:"producer"})," to be the same Scala type to encourage capturing more information statically, but they can always be cast to ",(0,o.jsx)(n.code,{children:"Data"})," or another common supertype prior to connecting."]}),"\n",(0,o.jsxs)(n.p,{children:["In the following example, we can use ",(0,o.jsx)(n.code,{children:":<>="})," and ",(0,o.jsx)(n.code,{children:".waiveAs"})," to connect two different sub-types of ",(0,o.jsx)(n.code,{children:"MyReadyValid"}),"."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"class HasBits extends MyReadyValid {\n  val bits = UInt(32.W)\n}\nclass HasEcho extends MyReadyValid {\n  val echo = Flipped(UInt(32.W))\n}\nclass Example7 extends RawModule {\n  val in  = IO(Flipped(new HasBits))\n  val out = IO(new HasEcho)\n  out.waiveAs[MyReadyValid](_.echo) :<>= in.waiveAs[MyReadyValid](_.bits)\n}\n"})}),"\n",(0,o.jsxs)(n.p,{children:["This generates the following Verilog, where ",(0,o.jsx)(n.code,{children:"ready"})," and ",(0,o.jsx)(n.code,{children:"valid"})," are connected, and ",(0,o.jsx)(n.code,{children:"bits"})," and ",(0,o.jsx)(n.code,{children:"echo"})," are ignored:"]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example7(\t// connectable.md:454:7\n  input         in_valid,\t// connectable.md:455:15\n  output        in_ready,\t// connectable.md:455:15\n  input  [31:0] in_bits,\t// connectable.md:455:15\n  output        out_valid,\t// connectable.md:456:15\n  input         out_ready,\t// connectable.md:456:15\n  input  [31:0] out_echo\t// connectable.md:456:15\n);\n\n  assign in_ready = out_ready;\t// connectable.md:454:7\n  assign out_valid = in_valid;\t// connectable.md:454:7\nendmodule\n\n"})}),"\n",(0,o.jsx)(n.h2,{id:"faq",children:"FAQ"}),"\n",(0,o.jsx)(n.h3,{id:"how-do-i-connect-two-items-as-flexibly-as-possible-try-your-best-but-never-error",children:"How do I connect two items as flexibly as possible (try your best but never error)"}),"\n",(0,o.jsxs)(n.p,{children:["Use ",(0,o.jsx)(n.code,{children:".unsafe"})," (both waives and allows squeezing of all fields)."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"class ExampleUnsafe extends RawModule {\n  val in  = IO(Flipped(new Bundle { val foo = Bool(); val bar = Bool() }))\n  val out = IO(new Bundle { val baz = Bool(); val bar = Bool() })\n  out.unsafe :<>= in.unsafe // bar is connected, and nothing errors\n}\n"})}),"\n",(0,o.jsx)(n.h3,{id:"how-do-i-connect-two-items-but-dont-care-about-the-scala-types-being-equivalent",children:"How do I connect two items but don't care about the Scala types being equivalent?"}),"\n",(0,o.jsxs)(n.p,{children:["Use ",(0,o.jsx)(n.code,{children:".as"})," (upcasts the Scala type)."]}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{className:"language-scala",children:"class ExampleAs extends RawModule {\n  val in  = IO(Flipped(new Bundle { val foo = Bool(); val bar = Bool() }))\n  val out = IO(new Bundle { val foo = Bool(); val bar = Bool() })\n  // foo and bar are connected, although Scala types aren't the same\n  out.as[Data] :<>= in.as[Data]\n}\n"})})]})}function h(e={}){const{wrapper:n}={...(0,t.R)(),...e.components};return n?(0,o.jsx)(n,{...e,children:(0,o.jsx)(a,{...e})}):a(e)}},8453:(e,n,i)=>{i.d(n,{R:()=>c,x:()=>d});var o=i(6540);const t={},l=o.createContext(t);function c(e){const n=o.useContext(l);return o.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function d(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(t):e.components||t:c(e.components),o.createElement(l.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/d50fb5c7.37482279.js b/assets/js/d50fb5c7.37482279.js
deleted file mode 100644
index bbd408c21a..0000000000
--- a/assets/js/d50fb5c7.37482279.js
+++ /dev/null
@@ -1 +0,0 @@
-"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[1281],{3747:(e,n,a)=>{a.r(n),a.d(n,{assets:()=>r,contentTitle:()=>o,default:()=>c,frontMatter:()=>s,metadata:()=>l,toc:()=>u});var t=a(4848),i=a(8453);const s={layout:"docs",title:"Naming",section:"chisel3"},o="Naming",l={id:"explanations/naming",title:"Naming",description:"Historically, Chisel has had trouble reliably capturing the names of signals. The reasons for this are due to (1)",source:"@site/docs/explanations/naming.md",sourceDirName:"explanations",slug:"/explanations/naming",permalink:"/docs/explanations/naming",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/naming.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Naming",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Muxes and Input Selection",permalink:"/docs/explanations/muxes-and-input-selection"},next:{title:"Operators",permalink:"/docs/explanations/operators"}},r={},u=[{value:"Compiler Plugin",id:"compiler-plugin",level:3},{value:"Prefixing",id:"prefixing",level:3},{value:"Suggest a Signal&#39;s Name (or the instance name of a Module)",id:"suggest-a-signals-name-or-the-instance-name-of-a-module",level:3},{value:"Behavior for &quot;Unnamed signals&quot; (aka &quot;Temporaries&quot;)",id:"behavior-for-unnamed-signals-aka-temporaries",level:3},{value:"Set a Module Name",id:"set-a-module-name",level:3}];function d(e){const n={a:"a",code:"code",em:"em",h1:"h1",h3:"h3",p:"p",pre:"pre",strong:"strong",...(0,i.R)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.h1,{id:"naming",children:"Naming"}),"\n",(0,t.jsxs)(n.p,{children:["Historically, Chisel has had trouble reliably capturing the names of signals. The reasons for this are due to (1)\nprimarily relying on reflection to find names, (2) using ",(0,t.jsx)(n.code,{children:"@chiselName"})," macro which had unreliable behavior."]}),"\n",(0,t.jsx)(n.p,{children:"Chisel 3.4 introduced a custom Scala compiler plugin which enables reliabe and automatic capturing of signal names, when\nthey are declared. In addition, this release includes prolific use of a new prefixing API which enables more stable\nnaming of signals programmatically generated from function calls."}),"\n",(0,t.jsxs)(n.p,{children:["This document explains how naming now works in Chisel for signal and module names. For cookbook examples on how to fix\nsystemic name-stability issues, please refer to the naming ",(0,t.jsx)(n.a,{href:"../cookbooks/naming",children:"cookbook"}),"."]}),"\n",(0,t.jsx)(n.h3,{id:"compiler-plugin",children:"Compiler Plugin"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"// Imports used by the following examples\nimport chisel3._\nimport chisel3.experimental.{prefix, noPrefix}\n"})}),"\n",(0,t.jsx)(n.p,{children:"Chisel users must also include the compiler plugin in their build settings.\nIn SBT this is something like:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'// For chisel versions 5.0.0+\naddCompilerPlugin("org.chipsalliance" % "chisel-plugin" % "5.0.0" cross CrossVersion.full)\n// For older chisel3 versions, eg. 3.6.0\naddCompilerPlugin("edu.berkeley.cs" % "chisel3-plugin" % "3.6.0" cross CrossVersion.full)\n'})}),"\n",(0,t.jsxs)(n.p,{children:["This plugin will run after the 'typer' phase of the Scala compiler. It looks for any user code which is of the form\n",(0,t.jsx)(n.code,{children:"val x = y"}),", where ",(0,t.jsx)(n.code,{children:"x"})," is of type ",(0,t.jsx)(n.code,{children:"chisel3.Data"}),", ",(0,t.jsx)(n.code,{children:"chisel3.MemBase"}),", or ",(0,t.jsx)(n.code,{children:"chisel3.experimental.BaseModule"}),". For each\nline which fits this criteria, it rewrites that line. In the following examples, the commented line is the what the\nline above is rewritten to."]}),"\n",(0,t.jsxs)(n.p,{children:["If the line is within a bundle declaration or is a module instantiation, it is rewritten to replace the right hand\nside with a call to ",(0,t.jsx)(n.code,{children:"autoNameRecursively"}),", which names the signal/module."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'class MyBundle extends Bundle {\n  val foo = Input(UInt(3.W))\n  // val foo = autoNameRecursively("foo")(Input(UInt(3.W)))\n}\nclass Example1 extends Module {\n  val io = IO(new MyBundle())\n  // val io = autoNameRecursively("io")(IO(new MyBundle()))\n}\n'})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example1(\n  input       clock,\n              reset,\n  input [2:0] io_foo\n);\n\nendmodule\n\n"})}),"\n",(0,t.jsx)(n.p,{children:"Otherwise, it is rewritten to also include the name as a prefix to any signals generated while executing the right-hand-\nside of the val declaration:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'class Example2 extends Module {\n  val in = IO(Input(UInt(2.W)))\n  // val in = autoNameRecursively("in")(prefix("in")(IO(Input(UInt(2.W)))))\n\n  val out1 = IO(Output(UInt(4.W)))\n  // val out1 = autoNameRecursively("out1")(prefix("out1")(IO(Output(UInt(4.W)))))\n  val out2 = IO(Output(UInt(4.W)))\n  // val out2 = autoNameRecursively("out2")(prefix("out2")(IO(Output(UInt(4.W)))))\n  val out3 = IO(Output(UInt(4.W)))\n  // val out3 = autoNameRecursively("out3")(prefix("out3")(IO(Output(UInt(4.W)))))\n\n  def func() = {\n    val squared = in * in\n    // val squared = autoNameRecursively("squared")(prefix("squared")(in * in))\n    out1 := squared\n    val delay = RegNext(squared)\n    // val delay = autoNameRecursively("delay")(prefix("delay")(RegNext(squared)))\n    delay\n  }\n\n  val masked = 0xa.U & func()\n  // val masked = autoNameRecursively("masked")(prefix("masked")(0xa.U & func()))\n  // Note that values created inside of `func()`` are prefixed with `masked`\n\n  out2 := masked + 1.U\n  out3 := masked - 1.U\n}\n'})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example2(\n  input        clock,\n               reset,\n  input  [1:0] in,\n  output [3:0] out1,\n               out2,\n               out3\n);\n\n  wire [3:0] _GEN = {2'h0, in};\n  wire [3:0] masked_squared = _GEN * _GEN;\n  reg  [3:0] masked_delay;\n  wire [3:0] masked = masked_delay & 4'hA;\n  always @(posedge clock)\n    masked_delay <= masked_squared;\n  assign out1 = masked_squared;\n  assign out2 = masked + 4'h1;\n  assign out3 = masked - 4'h1;\nendmodule\n\n"})}),"\n",(0,t.jsx)(n.p,{children:"Prefixing can also be derived from the name of signals on the left-hand side of a connection.\nWhile this is not implemented via the compiler plugin, the behavior should feel similar:"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'class ConnectPrefixing extends Module {\n  val in = IO(Input(UInt(2.W)))\n  // val in = autoNameRecursively("in")(prefix("in")(IO(Input(UInt(2.W)))))\n\n  val out1 = IO(Output(UInt(4.W)))\n  // val out1 = autoNameRecursively("out1")(prefix("out1")(IO(Output(UInt(4.W)))))\n  val out2 = IO(Output(UInt(4.W)))\n  // val out2 = autoNameRecursively("out2")(prefix("out2")(IO(Output(UInt(4.W)))))\n\n  out1 := { // technically this is not wrapped in autoNameRecursively nor prefix\n    // But the Chisel runtime will still use the name of `out1` as a prefix\n    val squared = in * in\n    out2 := squared\n    val delayed = RegNext(squared)\n    // val delayed = autoNameRecursively("delayed")(prefix("delayed")(RegNext(squared)))\n    delayed + 1.U\n  }\n}\n'})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule ConnectPrefixing(\n  input        clock,\n               reset,\n  input  [1:0] in,\n  output [3:0] out1,\n               out2\n);\n\n  wire [3:0] _GEN = {2'h0, in};\n  wire [3:0] out1_squared = _GEN * _GEN;\n  reg  [3:0] out1_delayed;\n  always @(posedge clock)\n    out1_delayed <= out1_squared;\n  assign out1 = out1_delayed + 4'h1;\n  assign out2 = out1_squared;\nendmodule\n\n"})}),"\n",(0,t.jsxs)(n.p,{children:["Note that the naming also works if the hardware type is nested in an ",(0,t.jsx)(n.code,{children:"Option"})," or a subtype of ",(0,t.jsx)(n.code,{children:"Iterable"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'class Example3 extends Module {\n  val in = IO(Input(UInt(2.W)))\n  // val in = autoNameRecursively("in")(prefix("in")(IO(Input(UInt(2.W)))))\n\n  val out = IO(Output(UInt(4.W)))\n  // val out = autoNameRecursively("out")(prefix("out")(IO(Output(UInt(4.W)))))\n\n  def func() = {\n    val delay = RegNext(in)\n    delay + 1.U\n  }\n\n  val opt = Some(func())\n  // Note that the register in func() is prefixed with `opt`:\n  // val opt = autoNameRecursively("opt")(prefix("opt")(Some(func()))\n\n  out := opt.get + 1.U\n}\n'})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example3(\n  input        clock,\n               reset,\n  input  [1:0] in,\n  output [3:0] out\n);\n\n  reg [1:0] opt_delay;\n  always @(posedge clock)\n    opt_delay <= in;\n  assign out = {2'h0, opt_delay - 2'h2};\nendmodule\n\n"})}),"\n",(0,t.jsxs)(n.p,{children:["There is also a slight variant (",(0,t.jsx)(n.code,{children:"autoNameRecursivelyProduct"}),") for naming hardware with names provided by an unapply:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'class UnapplyExample extends Module {\n  def mkIO() = (IO(Input(UInt(2.W))), IO(Output(UInt(2.W))))\n  val (in, out) = mkIO()\n  // val (in, out) = autoNameRecursivelyProduct(List(Some("in"), Some("out")))(mkIO())\n\n  out := in\n}\n'})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule UnapplyExample(\n  input        clock,\n               reset,\n  input  [1:0] in,\n  output [1:0] out\n);\n\n  assign out = in;\nendmodule\n\n"})}),"\n",(0,t.jsxs)(n.p,{children:["Note that the compiler plugin will not insert a prefix in these cases because it is ambiguous what the prefix should be.\nUsers who desire a prefix are encouraged to provide one as ",(0,t.jsx)(n.a,{href:"#prefixing",children:"described below"}),"."]}),"\n",(0,t.jsx)(n.h3,{id:"prefixing",children:"Prefixing"}),"\n",(0,t.jsxs)(n.p,{children:["As shown above, the compiler plugin automatically attempts to prefix some of your signals for you.\nHowever, you as a user can also add your own prefixes by calling ",(0,t.jsx)(n.code,{children:"prefix(...)"}),":"]}),"\n",(0,t.jsx)(n.p,{children:"Also note that the prefixes append to each other (including the prefix generated by the compiler plugin):"}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'class Example6 extends Module {\n  val in = IO(Input(UInt(2.W)))\n  val out = IO(Output(UInt(4.W)))\n\n  val add = prefix("foo") {\n    val sum = RegNext(in + 1.U)\n    sum + 1.U\n  }\n\n  out := add\n}\n'})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example6(\n  input        clock,\n               reset,\n  input  [1:0] in,\n  output [3:0] out\n);\n\n  reg [1:0] add_foo_sum;\n  always @(posedge clock)\n    add_foo_sum <= in + 2'h1;\n  assign out = {2'h0, add_foo_sum + 2'h1};\nendmodule\n\n"})}),"\n",(0,t.jsxs)(n.p,{children:["Sometimes you may want to disable the prefixing. This might occur if you are writing a library function and\ndon't want the prefixing behavior. In this case, you can call ",(0,t.jsx)(n.code,{children:"noPrefix"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class Example7 extends Module {\n  val in = IO(Input(UInt(2.W)))\n  val out = IO(Output(UInt(4.W)))\n\n  val add = noPrefix {\n    val sum = RegNext(in + 1.U)\n    sum + 1.U\n  }\n\n  out := add\n}\n"})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example7(\n  input        clock,\n               reset,\n  input  [1:0] in,\n  output [3:0] out\n);\n\n  reg [1:0] sum;\n  always @(posedge clock)\n    sum <= in + 2'h1;\n  assign out = {2'h0, sum + 2'h1};\nendmodule\n\n"})}),"\n",(0,t.jsx)(n.h3,{id:"suggest-a-signals-name-or-the-instance-name-of-a-module",children:"Suggest a Signal's Name (or the instance name of a Module)"}),"\n",(0,t.jsxs)(n.p,{children:["If you want to specify the name of a signal, you can always use the ",(0,t.jsx)(n.code,{children:".suggestName"})," API. Please note that the suggested\nname will still be prefixed (including by the plugin). You can always use the ",(0,t.jsx)(n.code,{children:"noPrefix"})," object to strip this."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'class Example8 extends Module {\n  val in = IO(Input(UInt(2.W)))\n  val out = IO(Output(UInt(4.W)))\n\n  val add = {\n    val sum = RegNext(in + 1.U).suggestName("foo")\n    sum + 1.U\n  }\n\n  out := add\n}\n'})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule Example8(\n  input        clock,\n               reset,\n  input  [1:0] in,\n  output [3:0] out\n);\n\n  reg [1:0] add_foo;\n  always @(posedge clock)\n    add_foo <= in + 2'h1;\n  assign out = {2'h0, add_foo + 2'h1};\nendmodule\n\n"})}),"\n",(0,t.jsxs)(n.p,{children:["Note that using ",(0,t.jsx)(n.code,{children:".suggestName"})," does ",(0,t.jsx)(n.strong,{children:"not"})," affect prefixes derived from val names;\nhowever, it ",(0,t.jsx)(n.em,{children:"can"})," affect prefixes derived from connections (eg. ",(0,t.jsx)(n.code,{children:":="}),"):"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'class ConnectionPrefixExample extends Module {\n  val in0 = IO(Input(UInt(2.W)))\n  val in1 = IO(Input(UInt(2.W)))\n\n  val out0 = {\n    val port = IO(Output(UInt(5.W)))\n    // Even though this suggestName is before mul, the prefix used in this scope\n    // is derived from `val out0`, so this does not affect the name of mul\n    port.suggestName("foo")\n    // out0_mul\n    val mul = RegNext(in0 * in1)\n    port := mul + 1.U\n    port\n  }\n\n  val out1 = IO(Output(UInt(4.W)))\n  val out2 = IO(Output(UInt(4.W)))\n\n  out1 := {\n    // out1_sum\n    val sum = RegNext(in0 + in1)\n    sum + 1.U\n  }\n  // Comes after so does *not* affect prefix above\n  out1.suggestName("bar")\n\n  // Comes before so *does* affect prefix below\n  out2.suggestName("fizz")\n  out2 := {\n    // fizz_diff\n    val diff = RegNext(in0 - in1)\n    diff + 1.U\n  }\n}\n'})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule ConnectionPrefixExample(\n  input        clock,\n               reset,\n  input  [1:0] in0,\n               in1,\n  output [4:0] foo,\n  output [3:0] bar,\n               fizz\n);\n\n  reg [3:0] out0_mul;\n  reg [1:0] out1_sum;\n  reg [1:0] fizz_diff;\n  always @(posedge clock) begin\n    out0_mul <= {2'h0, in0} * {2'h0, in1};\n    out1_sum <= in0 + in1;\n    fizz_diff <= in0 - in1;\n  end // always @(posedge)\n  assign foo = {1'h0, out0_mul + 4'h1};\n  assign bar = {2'h0, out1_sum + 2'h1};\n  assign fizz = {2'h0, fizz_diff + 2'h1};\nendmodule\n\n"})}),"\n",(0,t.jsx)(n.p,{children:"As this example illustrates, this behavior is slightly inconsistent so is subject to change in a future version of Chisel."}),"\n",(0,t.jsx)(n.h3,{id:"behavior-for-unnamed-signals-aka-temporaries",children:'Behavior for "Unnamed signals" (aka "Temporaries")'}),"\n",(0,t.jsxs)(n.p,{children:["If you want to signify that the name of a signal does not matter, you can prefix the name of your val with ",(0,t.jsx)(n.code,{children:"_"}),".\nChisel will preserve the convention of leading ",(0,t.jsx)(n.code,{children:"_"})," signifying an unnamed signal across prefixes.\nFor example:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'class TemporaryExample extends Module {\n  val in0 = IO(Input(UInt(2.W)))\n  val in1 = IO(Input(UInt(2.W)))\n\n  val out = {\n    // We need 2 ports so firtool will maintain the common subexpression\n    val port0 = IO(Output(UInt(4.W)))\n    // out_port1\n    val port1 = IO(Output(UInt(4.W)))\n    val _sum = in0 + in1\n    port0 := _sum + 1.U\n    port1 := _sum - 1.U\n    // port0 is returned so will get the name "out"\n    port0\n  }\n}\n'})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule TemporaryExample(\n  input        clock,\n               reset,\n  input  [1:0] in0,\n               in1,\n  output [3:0] out,\n               out_port1\n);\n\n  wire [1:0] _out_sum_T = in0 + in1;\n  assign out = {2'h0, _out_sum_T + 2'h1};\n  assign out_port1 = {2'h0, _out_sum_T - 2'h1};\nendmodule\n\n"})}),"\n",(0,t.jsxs)(n.p,{children:["If an unnamed signal is itself used to generate a prefix, the leading ",(0,t.jsx)(n.code,{children:"_"})," will be ignored to avoid double ",(0,t.jsx)(n.code,{children:"__"})," in the names of further nested signals."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class TemporaryPrefixExample extends Module {\n  val in0 = IO(Input(UInt(2.W)))\n  val in1 = IO(Input(UInt(2.W)))\n  val out0 = IO(Output(UInt(3.W)))\n  val out1 = IO(Output(UInt(4.W)))\n\n  val _sum = {\n    val x = in0 + in1\n    out0 := x\n    x + 1.U\n  }\n  out1 := _sum & 0x2.U\n}\n"})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule TemporaryPrefixExample(\n  input        clock,\n               reset,\n  input  [1:0] in0,\n               in1,\n  output [2:0] out0,\n  output [3:0] out1\n);\n\n  wire [1:0] _sum_x_T = in0 + in1;\n  assign out0 = {1'h0, _sum_x_T};\n  assign out1 = {2'h0, _sum_x_T + 2'h1 & 2'h2};\nendmodule\n\n"})}),"\n",(0,t.jsx)(n.h3,{id:"set-a-module-name",children:"Set a Module Name"}),"\n",(0,t.jsxs)(n.p,{children:["If you want to specify the module's name (not the instance name of a module), you can always override the ",(0,t.jsx)(n.code,{children:"desiredName"}),"\nvalue. Note that you can parameterize the name by the module's parameters. This is an excellent way to make your module\nnames more stable and is highly recommended to do."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:'class Example9(width: Int) extends Module {\n  override val desiredName = s"EXAMPLE9WITHWIDTH$width"\n  val in = IO(Input(UInt(width.W)))\n  val out = IO(Output(UInt((width + 2).W)))\n\n  val add = (in + (in + in).suggestName("foo"))\n\n  out := add\n}\n'})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule EXAMPLE9WITHWIDTH8(\n  input        clock,\n               reset,\n  input  [7:0] in,\n  output [9:0] out\n);\n\n  assign out = {2'h0, in + {in[6:0], 1'h0}};\nendmodule\n\n// Generated by CIRCT firtool-1.81.1\nmodule EXAMPLE9WITHWIDTH1(\n  input        clock,\n               reset,\n               in,\n  output [2:0] out\n);\n\n  assign out = {2'h0, in};\nendmodule\n\n"})})]})}function c(e={}){const{wrapper:n}={...(0,i.R)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(d,{...e})}):d(e)}},8453:(e,n,a)=>{a.d(n,{R:()=>o,x:()=>l});var t=a(6540);const i={},s=t.createContext(i);function o(e){const n=t.useContext(s);return t.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function l(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(i):e.components||i:o(e.components),t.createElement(s.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/d50fb5c7.5a3db385.js b/assets/js/d50fb5c7.5a3db385.js
new file mode 100644
index 0000000000..d1fefa3b1b
--- /dev/null
+++ b/assets/js/d50fb5c7.5a3db385.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[1281],{3747:(e,n,i)=>{i.r(n),i.d(n,{assets:()=>l,contentTitle:()=>o,default:()=>d,frontMatter:()=>s,metadata:()=>t,toc:()=>f});var a=i(4848),r=i(8453);const s={layout:"docs",title:"Naming",section:"chisel3"},o="Naming",t={id:"explanations/naming",title:"Naming",description:"Historically, Chisel has had trouble reliably capturing the names of signals. The reasons for this are due to (1)",source:"@site/docs/explanations/naming.md",sourceDirName:"explanations",slug:"/explanations/naming",permalink:"/docs/explanations/naming",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/naming.md",tags:[],version:"current",frontMatter:{layout:"docs",title:"Naming",section:"chisel3"},sidebar:"chiselSidebar",previous:{title:"Muxes and Input Selection",permalink:"/docs/explanations/muxes-and-input-selection"},next:{title:"Operators",permalink:"/docs/explanations/operators"}},l={},f=[{value:"Compiler Plugin",id:"compiler-plugin",level:3},{value:"Prefixing",id:"prefixing",level:3},{value:"Suggest a Signal&#39;s Name (or the instance name of a Module)",id:"suggest-a-signals-name-or-the-instance-name-of-a-module",level:3},{value:"Behavior for &quot;Unnamed signals&quot; (aka &quot;Temporaries&quot;)",id:"behavior-for-unnamed-signals-aka-temporaries",level:3},{value:"Set a Module Name",id:"set-a-module-name",level:3}];function c(e){const n={a:"a",code:"code",em:"em",h1:"h1",h3:"h3",p:"p",pre:"pre",strong:"strong",...(0,r.R)(),...e.components};return(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(n.h1,{id:"naming",children:"Naming"}),"\n",(0,a.jsxs)(n.p,{children:["Historically, Chisel has had trouble reliably capturing the names of signals. The reasons for this are due to (1)\nprimarily relying on reflection to find names, (2) using ",(0,a.jsx)(n.code,{children:"@chiselName"})," macro which had unreliable behavior."]}),"\n",(0,a.jsx)(n.p,{children:"Chisel 3.4 introduced a custom Scala compiler plugin which enables reliabe and automatic capturing of signal names, when\nthey are declared. In addition, this release includes prolific use of a new prefixing API which enables more stable\nnaming of signals programmatically generated from function calls."}),"\n",(0,a.jsxs)(n.p,{children:["This document explains how naming now works in Chisel for signal and module names. For cookbook examples on how to fix\nsystemic name-stability issues, please refer to the naming ",(0,a.jsx)(n.a,{href:"../cookbooks/naming",children:"cookbook"}),"."]}),"\n",(0,a.jsx)(n.h3,{id:"compiler-plugin",children:"Compiler Plugin"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"// Imports used by the following examples\nimport chisel3._\nimport chisel3.experimental.{prefix, noPrefix}\n"})}),"\n",(0,a.jsx)(n.p,{children:"Chisel users must also include the compiler plugin in their build settings.\nIn SBT this is something like:"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'// For chisel versions 5.0.0+\naddCompilerPlugin("org.chipsalliance" % "chisel-plugin" % "5.0.0" cross CrossVersion.full)\n// For older chisel3 versions, eg. 3.6.0\naddCompilerPlugin("edu.berkeley.cs" % "chisel3-plugin" % "3.6.0" cross CrossVersion.full)\n'})}),"\n",(0,a.jsxs)(n.p,{children:["This plugin will run after the 'typer' phase of the Scala compiler. It looks for any user code which is of the form\n",(0,a.jsx)(n.code,{children:"val x = y"}),", where ",(0,a.jsx)(n.code,{children:"x"})," is of type ",(0,a.jsx)(n.code,{children:"chisel3.Data"}),", ",(0,a.jsx)(n.code,{children:"chisel3.MemBase"}),", or ",(0,a.jsx)(n.code,{children:"chisel3.experimental.BaseModule"}),". For each\nline which fits this criteria, it rewrites that line. In the following examples, the commented line is the what the\nline above is rewritten to."]}),"\n",(0,a.jsxs)(n.p,{children:["If the line is within a bundle declaration or is a module instantiation, it is rewritten to replace the right hand\nside with a call to ",(0,a.jsx)(n.code,{children:"autoNameRecursively"}),", which names the signal/module."]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'class MyBundle extends Bundle {\n  val foo = Input(UInt(3.W))\n  // val foo = autoNameRecursively("foo")(Input(UInt(3.W)))\n}\nclass Example1 extends Module {\n  val io = IO(new MyBundle())\n  // val io = autoNameRecursively("io")(IO(new MyBundle()))\n}\n'})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example1(\n  input       clock,\n              reset,\n  input [2:0] io_foo\n);\n\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example1_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example1_Verification.sv"\n`ifndef layers_Example1_Verification_Cover\n`define layers_Example1_Verification_Cover\n`endif // layers_Example1_Verification_Cover\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example1_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example1_Verification.sv"\n`ifndef layers_Example1_Verification_Assume\n`define layers_Example1_Verification_Assume\n`endif // layers_Example1_Verification_Assume\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example1_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example1_Verification.sv"\n`ifndef layers_Example1_Verification_Assert\n`define layers_Example1_Verification_Assert\n`endif // layers_Example1_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_Example1_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example1_Verification\n`define layers_Example1_Verification\n`endif // layers_Example1_Verification\n'})}),"\n",(0,a.jsx)(n.p,{children:"Otherwise, it is rewritten to also include the name as a prefix to any signals generated while executing the right-hand-\nside of the val declaration:"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'class Example2 extends Module {\n  val in = IO(Input(UInt(2.W)))\n  // val in = autoNameRecursively("in")(prefix("in")(IO(Input(UInt(2.W)))))\n\n  val out1 = IO(Output(UInt(4.W)))\n  // val out1 = autoNameRecursively("out1")(prefix("out1")(IO(Output(UInt(4.W)))))\n  val out2 = IO(Output(UInt(4.W)))\n  // val out2 = autoNameRecursively("out2")(prefix("out2")(IO(Output(UInt(4.W)))))\n  val out3 = IO(Output(UInt(4.W)))\n  // val out3 = autoNameRecursively("out3")(prefix("out3")(IO(Output(UInt(4.W)))))\n\n  def func() = {\n    val squared = in * in\n    // val squared = autoNameRecursively("squared")(prefix("squared")(in * in))\n    out1 := squared\n    val delay = RegNext(squared)\n    // val delay = autoNameRecursively("delay")(prefix("delay")(RegNext(squared)))\n    delay\n  }\n\n  val masked = 0xa.U & func()\n  // val masked = autoNameRecursively("masked")(prefix("masked")(0xa.U & func()))\n  // Note that values created inside of `func()`` are prefixed with `masked`\n\n  out2 := masked + 1.U\n  out3 := masked - 1.U\n}\n'})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example2(\n  input        clock,\n               reset,\n  input  [1:0] in,\n  output [3:0] out1,\n               out2,\n               out3\n);\n\n  wire [3:0] _GEN = {2\'h0, in};\n  wire [3:0] masked_squared = _GEN * _GEN;\n  reg  [3:0] masked_delay;\n  wire [3:0] masked = masked_delay & 4\'hA;\n  always @(posedge clock)\n    masked_delay <= masked_squared;\n  assign out1 = masked_squared;\n  assign out2 = masked + 4\'h1;\n  assign out3 = masked - 4\'h1;\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example2_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example2_Verification.sv"\n`ifndef layers_Example2_Verification_Cover\n`define layers_Example2_Verification_Cover\n`endif // layers_Example2_Verification_Cover\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example2_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example2_Verification.sv"\n`ifndef layers_Example2_Verification_Assume\n`define layers_Example2_Verification_Assume\n`endif // layers_Example2_Verification_Assume\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example2_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example2_Verification.sv"\n`ifndef layers_Example2_Verification_Assert\n`define layers_Example2_Verification_Assert\n`endif // layers_Example2_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_Example2_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example2_Verification\n`define layers_Example2_Verification\n`endif // layers_Example2_Verification\n'})}),"\n",(0,a.jsx)(n.p,{children:"Prefixing can also be derived from the name of signals on the left-hand side of a connection.\nWhile this is not implemented via the compiler plugin, the behavior should feel similar:"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'class ConnectPrefixing extends Module {\n  val in = IO(Input(UInt(2.W)))\n  // val in = autoNameRecursively("in")(prefix("in")(IO(Input(UInt(2.W)))))\n\n  val out1 = IO(Output(UInt(4.W)))\n  // val out1 = autoNameRecursively("out1")(prefix("out1")(IO(Output(UInt(4.W)))))\n  val out2 = IO(Output(UInt(4.W)))\n  // val out2 = autoNameRecursively("out2")(prefix("out2")(IO(Output(UInt(4.W)))))\n\n  out1 := { // technically this is not wrapped in autoNameRecursively nor prefix\n    // But the Chisel runtime will still use the name of `out1` as a prefix\n    val squared = in * in\n    out2 := squared\n    val delayed = RegNext(squared)\n    // val delayed = autoNameRecursively("delayed")(prefix("delayed")(RegNext(squared)))\n    delayed + 1.U\n  }\n}\n'})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule ConnectPrefixing(\n  input        clock,\n               reset,\n  input  [1:0] in,\n  output [3:0] out1,\n               out2\n);\n\n  wire [3:0] _GEN = {2\'h0, in};\n  wire [3:0] out1_squared = _GEN * _GEN;\n  reg  [3:0] out1_delayed;\n  always @(posedge clock)\n    out1_delayed <= out1_squared;\n  assign out1 = out1_delayed + 4\'h1;\n  assign out2 = out1_squared;\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_ConnectPrefixing_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_ConnectPrefixing_Verification.sv"\n`ifndef layers_ConnectPrefixing_Verification_Cover\n`define layers_ConnectPrefixing_Verification_Cover\n`endif // layers_ConnectPrefixing_Verification_Cover\n\n// ----- 8< ----- FILE "Verification/Assume/layers_ConnectPrefixing_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_ConnectPrefixing_Verification.sv"\n`ifndef layers_ConnectPrefixing_Verification_Assume\n`define layers_ConnectPrefixing_Verification_Assume\n`endif // layers_ConnectPrefixing_Verification_Assume\n\n// ----- 8< ----- FILE "Verification/Assert/layers_ConnectPrefixing_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_ConnectPrefixing_Verification.sv"\n`ifndef layers_ConnectPrefixing_Verification_Assert\n`define layers_ConnectPrefixing_Verification_Assert\n`endif // layers_ConnectPrefixing_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_ConnectPrefixing_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_ConnectPrefixing_Verification\n`define layers_ConnectPrefixing_Verification\n`endif // layers_ConnectPrefixing_Verification\n'})}),"\n",(0,a.jsxs)(n.p,{children:["Note that the naming also works if the hardware type is nested in an ",(0,a.jsx)(n.code,{children:"Option"})," or a subtype of ",(0,a.jsx)(n.code,{children:"Iterable"}),":"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'class Example3 extends Module {\n  val in = IO(Input(UInt(2.W)))\n  // val in = autoNameRecursively("in")(prefix("in")(IO(Input(UInt(2.W)))))\n\n  val out = IO(Output(UInt(4.W)))\n  // val out = autoNameRecursively("out")(prefix("out")(IO(Output(UInt(4.W)))))\n\n  def func() = {\n    val delay = RegNext(in)\n    delay + 1.U\n  }\n\n  val opt = Some(func())\n  // Note that the register in func() is prefixed with `opt`:\n  // val opt = autoNameRecursively("opt")(prefix("opt")(Some(func()))\n\n  out := opt.get + 1.U\n}\n'})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example3(\n  input        clock,\n               reset,\n  input  [1:0] in,\n  output [3:0] out\n);\n\n  reg [1:0] opt_delay;\n  always @(posedge clock)\n    opt_delay <= in;\n  assign out = {2\'h0, opt_delay - 2\'h2};\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example3_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example3_Verification.sv"\n`ifndef layers_Example3_Verification_Cover\n`define layers_Example3_Verification_Cover\n`endif // layers_Example3_Verification_Cover\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example3_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example3_Verification.sv"\n`ifndef layers_Example3_Verification_Assume\n`define layers_Example3_Verification_Assume\n`endif // layers_Example3_Verification_Assume\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example3_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example3_Verification.sv"\n`ifndef layers_Example3_Verification_Assert\n`define layers_Example3_Verification_Assert\n`endif // layers_Example3_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_Example3_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example3_Verification\n`define layers_Example3_Verification\n`endif // layers_Example3_Verification\n'})}),"\n",(0,a.jsxs)(n.p,{children:["There is also a slight variant (",(0,a.jsx)(n.code,{children:"autoNameRecursivelyProduct"}),") for naming hardware with names provided by an unapply:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'class UnapplyExample extends Module {\n  def mkIO() = (IO(Input(UInt(2.W))), IO(Output(UInt(2.W))))\n  val (in, out) = mkIO()\n  // val (in, out) = autoNameRecursivelyProduct(List(Some("in"), Some("out")))(mkIO())\n\n  out := in\n}\n'})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule UnapplyExample(\n  input        clock,\n               reset,\n  input  [1:0] in,\n  output [1:0] out\n);\n\n  assign out = in;\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_UnapplyExample_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_UnapplyExample_Verification.sv"\n`ifndef layers_UnapplyExample_Verification_Cover\n`define layers_UnapplyExample_Verification_Cover\n`endif // layers_UnapplyExample_Verification_Cover\n\n// ----- 8< ----- FILE "Verification/Assume/layers_UnapplyExample_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_UnapplyExample_Verification.sv"\n`ifndef layers_UnapplyExample_Verification_Assume\n`define layers_UnapplyExample_Verification_Assume\n`endif // layers_UnapplyExample_Verification_Assume\n\n// ----- 8< ----- FILE "Verification/Assert/layers_UnapplyExample_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_UnapplyExample_Verification.sv"\n`ifndef layers_UnapplyExample_Verification_Assert\n`define layers_UnapplyExample_Verification_Assert\n`endif // layers_UnapplyExample_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_UnapplyExample_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_UnapplyExample_Verification\n`define layers_UnapplyExample_Verification\n`endif // layers_UnapplyExample_Verification\n'})}),"\n",(0,a.jsxs)(n.p,{children:["Note that the compiler plugin will not insert a prefix in these cases because it is ambiguous what the prefix should be.\nUsers who desire a prefix are encouraged to provide one as ",(0,a.jsx)(n.a,{href:"#prefixing",children:"described below"}),"."]}),"\n",(0,a.jsx)(n.h3,{id:"prefixing",children:"Prefixing"}),"\n",(0,a.jsxs)(n.p,{children:["As shown above, the compiler plugin automatically attempts to prefix some of your signals for you.\nHowever, you as a user can also add your own prefixes by calling ",(0,a.jsx)(n.code,{children:"prefix(...)"}),":"]}),"\n",(0,a.jsx)(n.p,{children:"Also note that the prefixes append to each other (including the prefix generated by the compiler plugin):"}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'class Example6 extends Module {\n  val in = IO(Input(UInt(2.W)))\n  val out = IO(Output(UInt(4.W)))\n\n  val add = prefix("foo") {\n    val sum = RegNext(in + 1.U)\n    sum + 1.U\n  }\n\n  out := add\n}\n'})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example6(\n  input        clock,\n               reset,\n  input  [1:0] in,\n  output [3:0] out\n);\n\n  reg [1:0] add_foo_sum;\n  always @(posedge clock)\n    add_foo_sum <= in + 2\'h1;\n  assign out = {2\'h0, add_foo_sum + 2\'h1};\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example6_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example6_Verification.sv"\n`ifndef layers_Example6_Verification_Cover\n`define layers_Example6_Verification_Cover\n`endif // layers_Example6_Verification_Cover\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example6_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example6_Verification.sv"\n`ifndef layers_Example6_Verification_Assume\n`define layers_Example6_Verification_Assume\n`endif // layers_Example6_Verification_Assume\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example6_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example6_Verification.sv"\n`ifndef layers_Example6_Verification_Assert\n`define layers_Example6_Verification_Assert\n`endif // layers_Example6_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_Example6_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example6_Verification\n`define layers_Example6_Verification\n`endif // layers_Example6_Verification\n'})}),"\n",(0,a.jsxs)(n.p,{children:["Sometimes you may want to disable the prefixing. This might occur if you are writing a library function and\ndon't want the prefixing behavior. In this case, you can call ",(0,a.jsx)(n.code,{children:"noPrefix"}),":"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"class Example7 extends Module {\n  val in = IO(Input(UInt(2.W)))\n  val out = IO(Output(UInt(4.W)))\n\n  val add = noPrefix {\n    val sum = RegNext(in + 1.U)\n    sum + 1.U\n  }\n\n  out := add\n}\n"})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example7(\n  input        clock,\n               reset,\n  input  [1:0] in,\n  output [3:0] out\n);\n\n  reg [1:0] sum;\n  always @(posedge clock)\n    sum <= in + 2\'h1;\n  assign out = {2\'h0, sum + 2\'h1};\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example7_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example7_Verification.sv"\n`ifndef layers_Example7_Verification_Cover\n`define layers_Example7_Verification_Cover\n`endif // layers_Example7_Verification_Cover\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example7_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example7_Verification.sv"\n`ifndef layers_Example7_Verification_Assume\n`define layers_Example7_Verification_Assume\n`endif // layers_Example7_Verification_Assume\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example7_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example7_Verification.sv"\n`ifndef layers_Example7_Verification_Assert\n`define layers_Example7_Verification_Assert\n`endif // layers_Example7_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_Example7_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example7_Verification\n`define layers_Example7_Verification\n`endif // layers_Example7_Verification\n'})}),"\n",(0,a.jsx)(n.h3,{id:"suggest-a-signals-name-or-the-instance-name-of-a-module",children:"Suggest a Signal's Name (or the instance name of a Module)"}),"\n",(0,a.jsxs)(n.p,{children:["If you want to specify the name of a signal, you can always use the ",(0,a.jsx)(n.code,{children:".suggestName"})," API. Please note that the suggested\nname will still be prefixed (including by the plugin). You can always use the ",(0,a.jsx)(n.code,{children:"noPrefix"})," object to strip this."]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'class Example8 extends Module {\n  val in = IO(Input(UInt(2.W)))\n  val out = IO(Output(UInt(4.W)))\n\n  val add = {\n    val sum = RegNext(in + 1.U).suggestName("foo")\n    sum + 1.U\n  }\n\n  out := add\n}\n'})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule Example8(\n  input        clock,\n               reset,\n  input  [1:0] in,\n  output [3:0] out\n);\n\n  reg [1:0] add_foo;\n  always @(posedge clock)\n    add_foo <= in + 2\'h1;\n  assign out = {2\'h0, add_foo + 2\'h1};\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_Example8_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example8_Verification.sv"\n`ifndef layers_Example8_Verification_Cover\n`define layers_Example8_Verification_Cover\n`endif // layers_Example8_Verification_Cover\n\n// ----- 8< ----- FILE "Verification/Assume/layers_Example8_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example8_Verification.sv"\n`ifndef layers_Example8_Verification_Assume\n`define layers_Example8_Verification_Assume\n`endif // layers_Example8_Verification_Assume\n\n// ----- 8< ----- FILE "Verification/Assert/layers_Example8_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_Example8_Verification.sv"\n`ifndef layers_Example8_Verification_Assert\n`define layers_Example8_Verification_Assert\n`endif // layers_Example8_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_Example8_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_Example8_Verification\n`define layers_Example8_Verification\n`endif // layers_Example8_Verification\n'})}),"\n",(0,a.jsxs)(n.p,{children:["Note that using ",(0,a.jsx)(n.code,{children:".suggestName"})," does ",(0,a.jsx)(n.strong,{children:"not"})," affect prefixes derived from val names;\nhowever, it ",(0,a.jsx)(n.em,{children:"can"})," affect prefixes derived from connections (eg. ",(0,a.jsx)(n.code,{children:":="}),"):"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'class ConnectionPrefixExample extends Module {\n  val in0 = IO(Input(UInt(2.W)))\n  val in1 = IO(Input(UInt(2.W)))\n\n  val out0 = {\n    val port = IO(Output(UInt(5.W)))\n    // Even though this suggestName is before mul, the prefix used in this scope\n    // is derived from `val out0`, so this does not affect the name of mul\n    port.suggestName("foo")\n    // out0_mul\n    val mul = RegNext(in0 * in1)\n    port := mul + 1.U\n    port\n  }\n\n  val out1 = IO(Output(UInt(4.W)))\n  val out2 = IO(Output(UInt(4.W)))\n\n  out1 := {\n    // out1_sum\n    val sum = RegNext(in0 + in1)\n    sum + 1.U\n  }\n  // Comes after so does *not* affect prefix above\n  out1.suggestName("bar")\n\n  // Comes before so *does* affect prefix below\n  out2.suggestName("fizz")\n  out2 := {\n    // fizz_diff\n    val diff = RegNext(in0 - in1)\n    diff + 1.U\n  }\n}\n'})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule ConnectionPrefixExample(\n  input        clock,\n               reset,\n  input  [1:0] in0,\n               in1,\n  output [4:0] foo,\n  output [3:0] bar,\n               fizz\n);\n\n  reg [3:0] out0_mul;\n  reg [1:0] out1_sum;\n  reg [1:0] fizz_diff;\n  always @(posedge clock) begin\n    out0_mul <= {2\'h0, in0} * {2\'h0, in1};\n    out1_sum <= in0 + in1;\n    fizz_diff <= in0 - in1;\n  end // always @(posedge)\n  assign foo = {1\'h0, out0_mul + 4\'h1};\n  assign bar = {2\'h0, out1_sum + 2\'h1};\n  assign fizz = {2\'h0, fizz_diff + 2\'h1};\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_ConnectionPrefixExample_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_ConnectionPrefixExample_Verification.sv"\n`ifndef layers_ConnectionPrefixExample_Verification_Cover\n`define layers_ConnectionPrefixExample_Verification_Cover\n`endif // layers_ConnectionPrefixExample_Verification_Cover\n\n// ----- 8< ----- FILE "Verification/Assume/layers_ConnectionPrefixExample_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_ConnectionPrefixExample_Verification.sv"\n`ifndef layers_ConnectionPrefixExample_Verification_Assume\n`define layers_ConnectionPrefixExample_Verification_Assume\n`endif // layers_ConnectionPrefixExample_Verification_Assume\n\n// ----- 8< ----- FILE "Verification/Assert/layers_ConnectionPrefixExample_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_ConnectionPrefixExample_Verification.sv"\n`ifndef layers_ConnectionPrefixExample_Verification_Assert\n`define layers_ConnectionPrefixExample_Verification_Assert\n`endif // layers_ConnectionPrefixExample_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_ConnectionPrefixExample_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_ConnectionPrefixExample_Verification\n`define layers_ConnectionPrefixExample_Verification\n`endif // layers_ConnectionPrefixExample_Verification\n'})}),"\n",(0,a.jsx)(n.p,{children:"As this example illustrates, this behavior is slightly inconsistent so is subject to change in a future version of Chisel."}),"\n",(0,a.jsx)(n.h3,{id:"behavior-for-unnamed-signals-aka-temporaries",children:'Behavior for "Unnamed signals" (aka "Temporaries")'}),"\n",(0,a.jsxs)(n.p,{children:["If you want to signify that the name of a signal does not matter, you can prefix the name of your val with ",(0,a.jsx)(n.code,{children:"_"}),".\nChisel will preserve the convention of leading ",(0,a.jsx)(n.code,{children:"_"})," signifying an unnamed signal across prefixes.\nFor example:"]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'class TemporaryExample extends Module {\n  val in0 = IO(Input(UInt(2.W)))\n  val in1 = IO(Input(UInt(2.W)))\n\n  val out = {\n    // We need 2 ports so firtool will maintain the common subexpression\n    val port0 = IO(Output(UInt(4.W)))\n    // out_port1\n    val port1 = IO(Output(UInt(4.W)))\n    val _sum = in0 + in1\n    port0 := _sum + 1.U\n    port1 := _sum - 1.U\n    // port0 is returned so will get the name "out"\n    port0\n  }\n}\n'})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule TemporaryExample(\n  input        clock,\n               reset,\n  input  [1:0] in0,\n               in1,\n  output [3:0] out,\n               out_port1\n);\n\n  wire [1:0] _out_sum_T = in0 + in1;\n  assign out = {2\'h0, _out_sum_T + 2\'h1};\n  assign out_port1 = {2\'h0, _out_sum_T - 2\'h1};\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_TemporaryExample_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_TemporaryExample_Verification.sv"\n`ifndef layers_TemporaryExample_Verification_Cover\n`define layers_TemporaryExample_Verification_Cover\n`endif // layers_TemporaryExample_Verification_Cover\n\n// ----- 8< ----- FILE "Verification/Assume/layers_TemporaryExample_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_TemporaryExample_Verification.sv"\n`ifndef layers_TemporaryExample_Verification_Assume\n`define layers_TemporaryExample_Verification_Assume\n`endif // layers_TemporaryExample_Verification_Assume\n\n// ----- 8< ----- FILE "Verification/Assert/layers_TemporaryExample_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_TemporaryExample_Verification.sv"\n`ifndef layers_TemporaryExample_Verification_Assert\n`define layers_TemporaryExample_Verification_Assert\n`endif // layers_TemporaryExample_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_TemporaryExample_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_TemporaryExample_Verification\n`define layers_TemporaryExample_Verification\n`endif // layers_TemporaryExample_Verification\n'})}),"\n",(0,a.jsxs)(n.p,{children:["If an unnamed signal is itself used to generate a prefix, the leading ",(0,a.jsx)(n.code,{children:"_"})," will be ignored to avoid double ",(0,a.jsx)(n.code,{children:"__"})," in the names of further nested signals."]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:"class TemporaryPrefixExample extends Module {\n  val in0 = IO(Input(UInt(2.W)))\n  val in1 = IO(Input(UInt(2.W)))\n  val out0 = IO(Output(UInt(3.W)))\n  val out1 = IO(Output(UInt(4.W)))\n\n  val _sum = {\n    val x = in0 + in1\n    out0 := x\n    x + 1.U\n  }\n  out1 := _sum & 0x2.U\n}\n"})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule TemporaryPrefixExample(\n  input        clock,\n               reset,\n  input  [1:0] in0,\n               in1,\n  output [2:0] out0,\n  output [3:0] out1\n);\n\n  wire [1:0] _sum_x_T = in0 + in1;\n  assign out0 = {1\'h0, _sum_x_T};\n  assign out1 = {2\'h0, _sum_x_T + 2\'h1 & 2\'h2};\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_TemporaryPrefixExample_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_TemporaryPrefixExample_Verification.sv"\n`ifndef layers_TemporaryPrefixExample_Verification_Cover\n`define layers_TemporaryPrefixExample_Verification_Cover\n`endif // layers_TemporaryPrefixExample_Verification_Cover\n\n// ----- 8< ----- FILE "Verification/Assume/layers_TemporaryPrefixExample_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_TemporaryPrefixExample_Verification.sv"\n`ifndef layers_TemporaryPrefixExample_Verification_Assume\n`define layers_TemporaryPrefixExample_Verification_Assume\n`endif // layers_TemporaryPrefixExample_Verification_Assume\n\n// ----- 8< ----- FILE "Verification/Assert/layers_TemporaryPrefixExample_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_TemporaryPrefixExample_Verification.sv"\n`ifndef layers_TemporaryPrefixExample_Verification_Assert\n`define layers_TemporaryPrefixExample_Verification_Assert\n`endif // layers_TemporaryPrefixExample_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_TemporaryPrefixExample_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_TemporaryPrefixExample_Verification\n`define layers_TemporaryPrefixExample_Verification\n`endif // layers_TemporaryPrefixExample_Verification\n'})}),"\n",(0,a.jsx)(n.h3,{id:"set-a-module-name",children:"Set a Module Name"}),"\n",(0,a.jsxs)(n.p,{children:["If you want to specify the module's name (not the instance name of a module), you can always override the ",(0,a.jsx)(n.code,{children:"desiredName"}),"\nvalue. Note that you can parameterize the name by the module's parameters. This is an excellent way to make your module\nnames more stable and is highly recommended to do."]}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-scala",children:'class Example9(width: Int) extends Module {\n  override val desiredName = s"EXAMPLE9WITHWIDTH$width"\n  val in = IO(Input(UInt(width.W)))\n  val out = IO(Output(UInt((width + 2).W)))\n\n  val add = (in + (in + in).suggestName("foo"))\n\n  out := add\n}\n'})}),"\n",(0,a.jsx)(n.pre,{children:(0,a.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule EXAMPLE9WITHWIDTH8(\n  input        clock,\n               reset,\n  input  [7:0] in,\n  output [9:0] out\n);\n\n  assign out = {2\'h0, in + {in[6:0], 1\'h0}};\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_EXAMPLE9WITHWIDTH8_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_EXAMPLE9WITHWIDTH8_Verification.sv"\n`ifndef layers_EXAMPLE9WITHWIDTH8_Verification_Cover\n`define layers_EXAMPLE9WITHWIDTH8_Verification_Cover\n`endif // layers_EXAMPLE9WITHWIDTH8_Verification_Cover\n\n// ----- 8< ----- FILE "Verification/Assume/layers_EXAMPLE9WITHWIDTH8_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_EXAMPLE9WITHWIDTH8_Verification.sv"\n`ifndef layers_EXAMPLE9WITHWIDTH8_Verification_Assume\n`define layers_EXAMPLE9WITHWIDTH8_Verification_Assume\n`endif // layers_EXAMPLE9WITHWIDTH8_Verification_Assume\n\n// ----- 8< ----- FILE "Verification/Assert/layers_EXAMPLE9WITHWIDTH8_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_EXAMPLE9WITHWIDTH8_Verification.sv"\n`ifndef layers_EXAMPLE9WITHWIDTH8_Verification_Assert\n`define layers_EXAMPLE9WITHWIDTH8_Verification_Assert\n`endif // layers_EXAMPLE9WITHWIDTH8_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_EXAMPLE9WITHWIDTH8_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_EXAMPLE9WITHWIDTH8_Verification\n`define layers_EXAMPLE9WITHWIDTH8_Verification\n`endif // layers_EXAMPLE9WITHWIDTH8_Verification\n// Generated by CIRCT firtool-1.81.1\nmodule EXAMPLE9WITHWIDTH1(\n  input        clock,\n               reset,\n               in,\n  output [2:0] out\n);\n\n  assign out = {2\'h0, in};\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_EXAMPLE9WITHWIDTH1_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_EXAMPLE9WITHWIDTH1_Verification.sv"\n`ifndef layers_EXAMPLE9WITHWIDTH1_Verification_Cover\n`define layers_EXAMPLE9WITHWIDTH1_Verification_Cover\n`endif // layers_EXAMPLE9WITHWIDTH1_Verification_Cover\n\n// ----- 8< ----- FILE "Verification/Assume/layers_EXAMPLE9WITHWIDTH1_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_EXAMPLE9WITHWIDTH1_Verification.sv"\n`ifndef layers_EXAMPLE9WITHWIDTH1_Verification_Assume\n`define layers_EXAMPLE9WITHWIDTH1_Verification_Assume\n`endif // layers_EXAMPLE9WITHWIDTH1_Verification_Assume\n\n// ----- 8< ----- FILE "Verification/Assert/layers_EXAMPLE9WITHWIDTH1_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_EXAMPLE9WITHWIDTH1_Verification.sv"\n`ifndef layers_EXAMPLE9WITHWIDTH1_Verification_Assert\n`define layers_EXAMPLE9WITHWIDTH1_Verification_Assert\n`endif // layers_EXAMPLE9WITHWIDTH1_Verification_Assert\n\n// ----- 8< ----- FILE "Verification/layers_EXAMPLE9WITHWIDTH1_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_EXAMPLE9WITHWIDTH1_Verification\n`define layers_EXAMPLE9WITHWIDTH1_Verification\n`endif // layers_EXAMPLE9WITHWIDTH1_Verification\n'})})]})}function d(e={}){const{wrapper:n}={...(0,r.R)(),...e.components};return n?(0,a.jsx)(n,{...e,children:(0,a.jsx)(c,{...e})}):c(e)}},8453:(e,n,i)=>{i.d(n,{R:()=>o,x:()=>t});var a=i(6540);const r={},s=a.createContext(r);function o(e){const n=a.useContext(s);return a.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function t(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(r):e.components||r:o(e.components),a.createElement(s.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/f10ce86b.10f5bd03.js b/assets/js/f10ce86b.10f5bd03.js
deleted file mode 100644
index b0a176bfd5..0000000000
--- a/assets/js/f10ce86b.10f5bd03.js
+++ /dev/null
@@ -1 +0,0 @@
-"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[2012],{8714:(e,n,a)=>{a.r(n),a.d(n,{assets:()=>c,contentTitle:()=>r,default:()=>p,frontMatter:()=>s,metadata:()=>l,toc:()=>d});var t=a(4848),o=a(8453),i=a(1871);const s={sidebar_position:3},r="DataView Cookbook",l={id:"cookbooks/dataview",title:"DataView Cookbook",description:"How do I view a Data as a UInt or vice versa?",source:"@site/docs/cookbooks/dataview.md",sourceDirName:"cookbooks",slug:"/cookbooks/dataview",permalink:"/docs/cookbooks/dataview",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/cookbooks/dataview.md",tags:[],version:"current",sidebarPosition:3,frontMatter:{sidebar_position:3},sidebar:"chiselSidebar",previous:{title:"Hierarchy Cookbook",permalink:"/docs/cookbooks/hierarchy"},next:{title:"Serialization Cookbook",permalink:"/docs/cookbooks/serialization"}},c={},d=[{value:"How do I view a Data as a UInt or vice versa?",id:"how-do-i-view-a-data-as-a-uint-or-vice-versa",level:2},{value:"How do I create a DataView for a Bundle has a type parameter?",id:"how-do-i-create-a-dataview-for-a-bundle-has-a-type-parameter",level:2},{value:"How do I create a DataView for a Bundle with optional fields?",id:"how-do-i-create-a-dataview-for-a-bundle-with-optional-fields",level:2},{value:"How do I connect a subset of Bundle fields?",id:"how-do-i-connect-a-subset-of-bundle-fields",level:2},{value:"How do I view a Bundle as a parent type (superclass)?",id:"how-do-i-view-a-bundle-as-a-parent-type-superclass",level:3},{value:"How do I view a Bundle as a parent type when the parent type is abstract (like a trait)?",id:"how-do-i-view-a-bundle-as-a-parent-type-when-the-parent-type-is-abstract-like-a-trait",level:3},{value:"How can I use <code>.viewAs</code> instead of <code>.viewAsSupertype(type)</code>?",id:"how-can-i-use-viewas-instead-of-viewassupertypetype",level:3}];function u(e){const n={code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",p:"p",pre:"pre",...(0,o.R)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.h1,{id:"dataview-cookbook",children:"DataView Cookbook"}),"\n","\n","\n",(0,t.jsx)(i.A,{toc:d}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-view-a-data-as-a-uint-or-vice-versa",children:"How do I view a Data as a UInt or vice versa?"}),"\n",(0,t.jsxs)(n.p,{children:["Subword viewing (using concatenations or bit extractions in ",(0,t.jsx)(n.code,{children:"DataViews"}),") is not yet supported.\nWe intend to implement this in the future, but for the time being, use regular casts\n(",(0,t.jsx)(n.code,{children:".asUInt"})," and ",(0,t.jsx)(n.code,{children:".asTypeOf"}),")."]}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-create-a-dataview-for-a-bundle-has-a-type-parameter",children:"How do I create a DataView for a Bundle has a type parameter?"}),"\n",(0,t.jsxs)(n.p,{children:["Instead of using a ",(0,t.jsx)(n.code,{children:"val"}),", use a ",(0,t.jsx)(n.code,{children:"def"})," which can have type parameters:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.dataview._\n\nclass Foo[T <: Data](val foo: T) extends Bundle\nclass Bar[T <: Data](val bar: T) extends Bundle\n\nobject Foo {\n  implicit def view[T <: Data]: DataView[Foo[T], Bar[T]] = {\n    DataView(f => new Bar(f.foo.cloneType), _.foo -> _.bar)\n    // .cloneType is necessary because the f passed to this function will be bound hardware\n  }\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["If you think about type parameterized classes as really being a family of different classes\n(one for each type parameter), you can think about the ",(0,t.jsx)(n.code,{children:"implicit def"})," as a generator of ",(0,t.jsx)(n.code,{children:"DataViews"}),"\nfor each type parameter."]}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-create-a-dataview-for-a-bundle-with-optional-fields",children:"How do I create a DataView for a Bundle with optional fields?"}),"\n",(0,t.jsxs)(n.p,{children:["Instead of using the default ",(0,t.jsx)(n.code,{children:"DataView"})," apply method, use ",(0,t.jsx)(n.code,{children:"DataView.mapping"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.dataview._\n\nclass Foo(val w: Option[Int]) extends Bundle {\n  val foo = UInt(8.W)\n  val opt = w.map(x => UInt(x.W))\n}\nclass Bar(val w: Option[Int]) extends Bundle {\n  val bar = UInt(8.W)\n  val opt = w.map(x => UInt(x.W))\n}\n\nobject Foo {\n  implicit val view: DataView[Foo, Bar] =\n    DataView.mapping(\n      // First argument is always the function to make the view from the target\n      f => new Bar(f.w),\n      // Now instead of a varargs of tuples of individual mappings, we have a single function that\n      // takes a target and a view and returns an Iterable of tuple\n      (f, b) =>  List(f.foo -> b.bar) ++ f.opt.map(_ -> b.opt.get)\n                                   // ^ Note that we can append options since they are Iterable!\n\n    )\n}\n"})}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-connect-a-subset-of-bundle-fields",children:"How do I connect a subset of Bundle fields?"}),"\n",(0,t.jsxs)(n.p,{children:['Chisel 3 requires types to match exactly for connections.\nDataView provides a mechanism for "viewing" one ',(0,t.jsx)(n.code,{children:"Bundle"})," object as if it were the type of another,\nwhich allows them to be connected."]}),"\n",(0,t.jsx)(n.h3,{id:"how-do-i-view-a-bundle-as-a-parent-type-superclass",children:"How do I view a Bundle as a parent type (superclass)?"}),"\n",(0,t.jsxs)(n.p,{children:["For viewing ",(0,t.jsx)(n.code,{children:"Bundles"})," as the type of the parent, it is as simple as using ",(0,t.jsx)(n.code,{children:"viewAsSupertype"})," and providing a\ntemplate object of the parent type:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.dataview._\n\nclass Foo extends Bundle {\n  val foo = UInt(8.W)\n}\nclass Bar extends Foo {\n  val bar = UInt(8.W)\n}\nclass MyModule extends Module {\n  val foo = IO(Input(new Foo))\n  val bar = IO(Output(new Bar))\n  bar.viewAsSupertype(new Foo) := foo // bar.foo := foo.foo\n  bar.bar := 123.U           // all fields need to be connected\n}\n"})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule MyModule(\t// dataview.md:117:7\n  input        clock,\t// dataview.md:117:7\n               reset,\t// dataview.md:117:7\n  input  [7:0] foo_foo,\t// dataview.md:118:15\n  output [7:0] bar_foo,\t// dataview.md:119:15\n               bar_bar\t// dataview.md:119:15\n);\n\n  assign bar_foo = foo_foo;\t// dataview.md:117:7\n  assign bar_bar = 8'h7B;\t// dataview.md:117:7, :121:11\nendmodule\n\n"})}),"\n",(0,t.jsx)(n.h3,{id:"how-do-i-view-a-bundle-as-a-parent-type-when-the-parent-type-is-abstract-like-a-trait",children:"How do I view a Bundle as a parent type when the parent type is abstract (like a trait)?"}),"\n",(0,t.jsxs)(n.p,{children:["Given the following ",(0,t.jsx)(n.code,{children:"Bundles"})," that share a common ",(0,t.jsx)(n.code,{children:"trait"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.dataview._\n\ntrait Super extends Bundle {\n  def bitwidth: Int\n  val a = UInt(bitwidth.W)\n}\nclass Foo(val bitwidth: Int) extends Super {\n  val foo = UInt(8.W)\n}\nclass Bar(val bitwidth: Int) extends Super {\n  val bar = UInt(8.W)\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.code,{children:"Foo"})," and ",(0,t.jsx)(n.code,{children:"Bar"})," cannot be connected directly, but they could be connected by viewing them both as if\nthey were instances of their common supertype, ",(0,t.jsx)(n.code,{children:"Super"}),".\nA straightforward approach might run into an issue like the following:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class MyModule extends Module {\n  val foo = IO(Input(new Foo(8)))\n  val bar = IO(Output(new Bar(8)))\n  bar.viewAsSupertype(new Super) := foo.viewAsSupertype(new Super)\n}\n// error: trait Super is abstract; cannot be instantiated\n//   bar.viewAsSupertype(new Super) := foo.viewAsSupertype(new Super)\n//                       ^^^^^^^^^\n// error: trait Super is abstract; cannot be instantiated\n//   bar.viewAsSupertype(new Super) := foo.viewAsSupertype(new Super)\n//                                                         ^^^^^^^^^\n"})}),"\n",(0,t.jsxs)(n.p,{children:["The problem is that ",(0,t.jsx)(n.code,{children:"viewAs"})," requires an object to use as a type template (so that it can be cloned),\nbut ",(0,t.jsx)(n.code,{children:"traits"})," are abstract and cannot be instantiated.\nThe solution is to create an instance of an ",(0,t.jsx)(n.em,{children:"anonymous class"})," and use that object as the argument to ",(0,t.jsx)(n.code,{children:"viewAs"}),".\nWe can do this like so:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class MyModule extends Module {\n  val foo = IO(Input(new Foo(8)))\n  val bar = IO(Output(new Bar(8)))\n  val tpe = new Super { // Adding curly braces creates an anonymous class\n    def bitwidth = 8 // We must implement any abstract methods\n  }\n  bar.viewAsSupertype(tpe) := foo.viewAsSupertype(tpe)\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["By adding curly braces after the name of the trait, we're telling Scala to create a new concrete\nsubclass of the trait, and create an instance of it.\nAs indicated in the comment, abstract methods must still be implemented.\nThis is the same that happens when one writes ",(0,t.jsx)(n.code,{children:"new Bundle {}"}),",\nthe curly braces create a new concrete subclass; however, because ",(0,t.jsx)(n.code,{children:"Bundle"})," has no abstract methods,\nthe contents of the body can be empty."]}),"\n",(0,t.jsxs)(n.h3,{id:"how-can-i-use-viewas-instead-of-viewassupertypetype",children:["How can I use ",(0,t.jsx)(n.code,{children:".viewAs"})," instead of ",(0,t.jsx)(n.code,{children:".viewAsSupertype(type)"}),"?"]}),"\n",(0,t.jsxs)(n.p,{children:["While ",(0,t.jsx)(n.code,{children:"viewAsSupertype"})," is helpful for one-off casts, the need to provide a type template object\neach time can be onerous.\nBecause of the subtyping relationship, you can use ",(0,t.jsx)(n.code,{children:"PartialDataView.supertype"})," to create a\n",(0,t.jsx)(n.code,{children:"DataView"})," from a Bundle type to a parent type by just providing the function to construct an\ninstance of the parent type from an instance of the child type.\nThe mapping of corresponding fields is automatically determined by Chisel to be the fields defined\nin the supertype."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.dataview._\n\nclass Foo(x: Int) extends Bundle {\n  val foo = UInt(x.W)\n}\nclass Bar(val x: Int) extends Foo(x) {\n  val bar = UInt(x.W)\n}\n// Define a DataView without having to specify the mapping!\nimplicit val view = PartialDataView.supertype[Bar, Foo](b => new Foo(b.x))\n\nclass MyModule extends Module {\n  val foo = IO(Input(new Foo(8)))\n  val bar = IO(Output(new Bar(8)))\n  bar.viewAs[Foo] := foo // bar.foo := foo.foo\n  bar.bar := 123.U       // all fields need to be connected\n}\n"})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:"// Generated by CIRCT firtool-1.81.1\nmodule MyModule(\t// dataview.md:203:7\n  input        clock,\t// dataview.md:203:7\n               reset,\t// dataview.md:203:7\n  input  [7:0] foo_foo,\t// dataview.md:204:15\n  output [7:0] bar_foo,\t// dataview.md:205:15\n               bar_bar\t// dataview.md:205:15\n);\n\n  assign bar_foo = foo_foo;\t// dataview.md:203:7\n  assign bar_bar = 8'h7B;\t// dataview.md:203:7, :207:11\nendmodule\n\n"})})]})}function p(e={}){const{wrapper:n}={...(0,o.R)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(u,{...e})}):u(e)}},1871:(e,n,a)=>{a.d(n,{A:()=>s});a(6540);var t=a(5195);const o={tableOfContentsInline:"tableOfContentsInline_prmo"};var i=a(4848);function s(e){let{toc:n,minHeadingLevel:a,maxHeadingLevel:s}=e;return(0,i.jsx)("div",{className:o.tableOfContentsInline,children:(0,i.jsx)(t.A,{toc:n,minHeadingLevel:a,maxHeadingLevel:s,className:"table-of-contents",linkClassName:null})})}},5195:(e,n,a)=>{a.d(n,{A:()=>m});var t=a(6540),o=a(6342);function i(e){const n=e.map((e=>({...e,parentIndex:-1,children:[]}))),a=Array(7).fill(-1);n.forEach(((e,n)=>{const t=a.slice(2,e.level);e.parentIndex=Math.max(...t),a[e.level]=n}));const t=[];return n.forEach((e=>{const{parentIndex:a,...o}=e;a>=0?n[a].children.push(o):t.push(o)})),t}function s(e){let{toc:n,minHeadingLevel:a,maxHeadingLevel:t}=e;return n.flatMap((e=>{const n=s({toc:e.children,minHeadingLevel:a,maxHeadingLevel:t});return function(e){return e.level>=a&&e.level<=t}(e)?[{...e,children:n}]:n}))}function r(e){const n=e.getBoundingClientRect();return n.top===n.bottom?r(e.parentNode):n}function l(e,n){let{anchorTopOffset:a}=n;const t=e.find((e=>r(e).top>=a));if(t){return function(e){return e.top>0&&e.bottom<window.innerHeight/2}(r(t))?t:e[e.indexOf(t)-1]??null}return e[e.length-1]??null}function c(){const e=(0,t.useRef)(0),{navbar:{hideOnScroll:n}}=(0,o.p)();return(0,t.useEffect)((()=>{e.current=n?0:document.querySelector(".navbar").clientHeight}),[n]),e}function d(e){const n=(0,t.useRef)(void 0),a=c();(0,t.useEffect)((()=>{if(!e)return()=>{};const{linkClassName:t,linkActiveClassName:o,minHeadingLevel:i,maxHeadingLevel:s}=e;function r(){const e=function(e){return Array.from(document.getElementsByClassName(e))}(t),r=function(e){let{minHeadingLevel:n,maxHeadingLevel:a}=e;const t=[];for(let o=n;o<=a;o+=1)t.push(`h${o}.anchor`);return Array.from(document.querySelectorAll(t.join()))}({minHeadingLevel:i,maxHeadingLevel:s}),c=l(r,{anchorTopOffset:a.current}),d=e.find((e=>c&&c.id===function(e){return decodeURIComponent(e.href.substring(e.href.indexOf("#")+1))}(e)));e.forEach((e=>{!function(e,a){a?(n.current&&n.current!==e&&n.current.classList.remove(o),e.classList.add(o),n.current=e):e.classList.remove(o)}(e,e===d)}))}return document.addEventListener("scroll",r),document.addEventListener("resize",r),r(),()=>{document.removeEventListener("scroll",r),document.removeEventListener("resize",r)}}),[e,a])}var u=a(8774),p=a(4848);function h(e){let{toc:n,className:a,linkClassName:t,isChild:o}=e;return n.length?(0,p.jsx)("ul",{className:o?void 0:a,children:n.map((e=>(0,p.jsxs)("li",{children:[(0,p.jsx)(u.A,{to:`#${e.id}`,className:t??void 0,dangerouslySetInnerHTML:{__html:e.value}}),(0,p.jsx)(h,{isChild:!0,toc:e.children,className:a,linkClassName:t})]},e.id)))}):null}const f=t.memo(h);function m(e){let{toc:n,className:a="table-of-contents table-of-contents__left-border",linkClassName:r="table-of-contents__link",linkActiveClassName:l,minHeadingLevel:c,maxHeadingLevel:u,...h}=e;const m=(0,o.p)(),v=c??m.tableOfContents.minHeadingLevel,w=u??m.tableOfContents.maxHeadingLevel,b=function(e){let{toc:n,minHeadingLevel:a,maxHeadingLevel:o}=e;return(0,t.useMemo)((()=>s({toc:i(n),minHeadingLevel:a,maxHeadingLevel:o})),[n,a,o])}({toc:n,minHeadingLevel:v,maxHeadingLevel:w});return d((0,t.useMemo)((()=>{if(r&&l)return{linkClassName:r,linkActiveClassName:l,minHeadingLevel:v,maxHeadingLevel:w}}),[r,l,v,w])),(0,p.jsx)(f,{toc:b,className:a,linkClassName:r,...h})}},8453:(e,n,a)=>{a.d(n,{R:()=>s,x:()=>r});var t=a(6540);const o={},i=t.createContext(o);function s(e){const n=t.useContext(i);return t.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function r(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(o):e.components||o:s(e.components),t.createElement(i.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/f10ce86b.1a8da0d2.js b/assets/js/f10ce86b.1a8da0d2.js
new file mode 100644
index 0000000000..c5a50c0af4
--- /dev/null
+++ b/assets/js/f10ce86b.1a8da0d2.js
@@ -0,0 +1 @@
+"use strict";(self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[]).push([[2012],{8714:(e,n,a)=>{a.r(n),a.d(n,{assets:()=>d,contentTitle:()=>r,default:()=>f,frontMatter:()=>s,metadata:()=>l,toc:()=>c});var t=a(4848),i=a(8453),o=a(1871);const s={sidebar_position:3},r="DataView Cookbook",l={id:"cookbooks/dataview",title:"DataView Cookbook",description:"How do I view a Data as a UInt or vice versa?",source:"@site/docs/cookbooks/dataview.md",sourceDirName:"cookbooks",slug:"/cookbooks/dataview",permalink:"/docs/cookbooks/dataview",draft:!1,unlisted:!1,editUrl:"https://github.com/chipsalliance/chisel/tree/main/docs/src/cookbooks/dataview.md",tags:[],version:"current",sidebarPosition:3,frontMatter:{sidebar_position:3},sidebar:"chiselSidebar",previous:{title:"Hierarchy Cookbook",permalink:"/docs/cookbooks/hierarchy"},next:{title:"Serialization Cookbook",permalink:"/docs/cookbooks/serialization"}},d={},c=[{value:"How do I view a Data as a UInt or vice versa?",id:"how-do-i-view-a-data-as-a-uint-or-vice-versa",level:2},{value:"How do I create a DataView for a Bundle has a type parameter?",id:"how-do-i-create-a-dataview-for-a-bundle-has-a-type-parameter",level:2},{value:"How do I create a DataView for a Bundle with optional fields?",id:"how-do-i-create-a-dataview-for-a-bundle-with-optional-fields",level:2},{value:"How do I connect a subset of Bundle fields?",id:"how-do-i-connect-a-subset-of-bundle-fields",level:2},{value:"How do I view a Bundle as a parent type (superclass)?",id:"how-do-i-view-a-bundle-as-a-parent-type-superclass",level:3},{value:"How do I view a Bundle as a parent type when the parent type is abstract (like a trait)?",id:"how-do-i-view-a-bundle-as-a-parent-type-when-the-parent-type-is-abstract-like-a-trait",level:3},{value:"How can I use <code>.viewAs</code> instead of <code>.viewAsSupertype(type)</code>?",id:"how-can-i-use-viewas-instead-of-viewassupertypetype",level:3}];function u(e){const n={code:"code",em:"em",h1:"h1",h2:"h2",h3:"h3",p:"p",pre:"pre",...(0,i.R)(),...e.components};return(0,t.jsxs)(t.Fragment,{children:[(0,t.jsx)(n.h1,{id:"dataview-cookbook",children:"DataView Cookbook"}),"\n","\n","\n",(0,t.jsx)(o.A,{toc:c}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-view-a-data-as-a-uint-or-vice-versa",children:"How do I view a Data as a UInt or vice versa?"}),"\n",(0,t.jsxs)(n.p,{children:["Subword viewing (using concatenations or bit extractions in ",(0,t.jsx)(n.code,{children:"DataViews"}),") is not yet supported.\nWe intend to implement this in the future, but for the time being, use regular casts\n(",(0,t.jsx)(n.code,{children:".asUInt"})," and ",(0,t.jsx)(n.code,{children:".asTypeOf"}),")."]}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-create-a-dataview-for-a-bundle-has-a-type-parameter",children:"How do I create a DataView for a Bundle has a type parameter?"}),"\n",(0,t.jsxs)(n.p,{children:["Instead of using a ",(0,t.jsx)(n.code,{children:"val"}),", use a ",(0,t.jsx)(n.code,{children:"def"})," which can have type parameters:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.dataview._\n\nclass Foo[T <: Data](val foo: T) extends Bundle\nclass Bar[T <: Data](val bar: T) extends Bundle\n\nobject Foo {\n  implicit def view[T <: Data]: DataView[Foo[T], Bar[T]] = {\n    DataView(f => new Bar(f.foo.cloneType), _.foo -> _.bar)\n    // .cloneType is necessary because the f passed to this function will be bound hardware\n  }\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["If you think about type parameterized classes as really being a family of different classes\n(one for each type parameter), you can think about the ",(0,t.jsx)(n.code,{children:"implicit def"})," as a generator of ",(0,t.jsx)(n.code,{children:"DataViews"}),"\nfor each type parameter."]}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-create-a-dataview-for-a-bundle-with-optional-fields",children:"How do I create a DataView for a Bundle with optional fields?"}),"\n",(0,t.jsxs)(n.p,{children:["Instead of using the default ",(0,t.jsx)(n.code,{children:"DataView"})," apply method, use ",(0,t.jsx)(n.code,{children:"DataView.mapping"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.dataview._\n\nclass Foo(val w: Option[Int]) extends Bundle {\n  val foo = UInt(8.W)\n  val opt = w.map(x => UInt(x.W))\n}\nclass Bar(val w: Option[Int]) extends Bundle {\n  val bar = UInt(8.W)\n  val opt = w.map(x => UInt(x.W))\n}\n\nobject Foo {\n  implicit val view: DataView[Foo, Bar] =\n    DataView.mapping(\n      // First argument is always the function to make the view from the target\n      f => new Bar(f.w),\n      // Now instead of a varargs of tuples of individual mappings, we have a single function that\n      // takes a target and a view and returns an Iterable of tuple\n      (f, b) =>  List(f.foo -> b.bar) ++ f.opt.map(_ -> b.opt.get)\n                                   // ^ Note that we can append options since they are Iterable!\n\n    )\n}\n"})}),"\n",(0,t.jsx)(n.h2,{id:"how-do-i-connect-a-subset-of-bundle-fields",children:"How do I connect a subset of Bundle fields?"}),"\n",(0,t.jsxs)(n.p,{children:['Chisel 3 requires types to match exactly for connections.\nDataView provides a mechanism for "viewing" one ',(0,t.jsx)(n.code,{children:"Bundle"})," object as if it were the type of another,\nwhich allows them to be connected."]}),"\n",(0,t.jsx)(n.h3,{id:"how-do-i-view-a-bundle-as-a-parent-type-superclass",children:"How do I view a Bundle as a parent type (superclass)?"}),"\n",(0,t.jsxs)(n.p,{children:["For viewing ",(0,t.jsx)(n.code,{children:"Bundles"})," as the type of the parent, it is as simple as using ",(0,t.jsx)(n.code,{children:"viewAsSupertype"})," and providing a\ntemplate object of the parent type:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.dataview._\n\nclass Foo extends Bundle {\n  val foo = UInt(8.W)\n}\nclass Bar extends Foo {\n  val bar = UInt(8.W)\n}\nclass MyModule extends Module {\n  val foo = IO(Input(new Foo))\n  val bar = IO(Output(new Bar))\n  bar.viewAsSupertype(new Foo) := foo // bar.foo := foo.foo\n  bar.bar := 123.U           // all fields need to be connected\n}\n"})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule MyModule(\t// dataview.md:117:7\n  input        clock,\t// dataview.md:117:7\n               reset,\t// dataview.md:117:7\n  input  [7:0] foo_foo,\t// dataview.md:118:15\n  output [7:0] bar_foo,\t// dataview.md:119:15\n               bar_bar\t// dataview.md:119:15\n);\n\n  assign bar_foo = foo_foo;\t// dataview.md:117:7\n  assign bar_bar = 8\'h7B;\t// dataview.md:117:7, :121:11\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_MyModule_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyModule_Verification.sv"\n`ifndef layers_MyModule_Verification_Cover\n`define layers_MyModule_Verification_Cover\t// <stdin>:6:5\n`endif // layers_MyModule_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_MyModule_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyModule_Verification.sv"\n`ifndef layers_MyModule_Verification_Assume\n`define layers_MyModule_Verification_Assume\t// <stdin>:5:5\n`endif // layers_MyModule_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_MyModule_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyModule_Verification.sv"\n`ifndef layers_MyModule_Verification_Assert\n`define layers_MyModule_Verification_Assert\t// <stdin>:4:5\n`endif // layers_MyModule_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_MyModule_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_MyModule_Verification\n`define layers_MyModule_Verification\t// <stdin>:3:3\n`endif // layers_MyModule_Verification\t// <stdin>:3:3\n'})}),"\n",(0,t.jsx)(n.h3,{id:"how-do-i-view-a-bundle-as-a-parent-type-when-the-parent-type-is-abstract-like-a-trait",children:"How do I view a Bundle as a parent type when the parent type is abstract (like a trait)?"}),"\n",(0,t.jsxs)(n.p,{children:["Given the following ",(0,t.jsx)(n.code,{children:"Bundles"})," that share a common ",(0,t.jsx)(n.code,{children:"trait"}),":"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.dataview._\n\ntrait Super extends Bundle {\n  def bitwidth: Int\n  val a = UInt(bitwidth.W)\n}\nclass Foo(val bitwidth: Int) extends Super {\n  val foo = UInt(8.W)\n}\nclass Bar(val bitwidth: Int) extends Super {\n  val bar = UInt(8.W)\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:[(0,t.jsx)(n.code,{children:"Foo"})," and ",(0,t.jsx)(n.code,{children:"Bar"})," cannot be connected directly, but they could be connected by viewing them both as if\nthey were instances of their common supertype, ",(0,t.jsx)(n.code,{children:"Super"}),".\nA straightforward approach might run into an issue like the following:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class MyModule extends Module {\n  val foo = IO(Input(new Foo(8)))\n  val bar = IO(Output(new Bar(8)))\n  bar.viewAsSupertype(new Super) := foo.viewAsSupertype(new Super)\n}\n// error: trait Super is abstract; cannot be instantiated\n//   bar.viewAsSupertype(new Super) := foo.viewAsSupertype(new Super)\n//                       ^^^^^^^^^\n// error: trait Super is abstract; cannot be instantiated\n//   bar.viewAsSupertype(new Super) := foo.viewAsSupertype(new Super)\n//                                                         ^^^^^^^^^\n"})}),"\n",(0,t.jsxs)(n.p,{children:["The problem is that ",(0,t.jsx)(n.code,{children:"viewAs"})," requires an object to use as a type template (so that it can be cloned),\nbut ",(0,t.jsx)(n.code,{children:"traits"})," are abstract and cannot be instantiated.\nThe solution is to create an instance of an ",(0,t.jsx)(n.em,{children:"anonymous class"})," and use that object as the argument to ",(0,t.jsx)(n.code,{children:"viewAs"}),".\nWe can do this like so:"]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"class MyModule extends Module {\n  val foo = IO(Input(new Foo(8)))\n  val bar = IO(Output(new Bar(8)))\n  val tpe = new Super { // Adding curly braces creates an anonymous class\n    def bitwidth = 8 // We must implement any abstract methods\n  }\n  bar.viewAsSupertype(tpe) := foo.viewAsSupertype(tpe)\n}\n"})}),"\n",(0,t.jsxs)(n.p,{children:["By adding curly braces after the name of the trait, we're telling Scala to create a new concrete\nsubclass of the trait, and create an instance of it.\nAs indicated in the comment, abstract methods must still be implemented.\nThis is the same that happens when one writes ",(0,t.jsx)(n.code,{children:"new Bundle {}"}),",\nthe curly braces create a new concrete subclass; however, because ",(0,t.jsx)(n.code,{children:"Bundle"})," has no abstract methods,\nthe contents of the body can be empty."]}),"\n",(0,t.jsxs)(n.h3,{id:"how-can-i-use-viewas-instead-of-viewassupertypetype",children:["How can I use ",(0,t.jsx)(n.code,{children:".viewAs"})," instead of ",(0,t.jsx)(n.code,{children:".viewAsSupertype(type)"}),"?"]}),"\n",(0,t.jsxs)(n.p,{children:["While ",(0,t.jsx)(n.code,{children:"viewAsSupertype"})," is helpful for one-off casts, the need to provide a type template object\neach time can be onerous.\nBecause of the subtyping relationship, you can use ",(0,t.jsx)(n.code,{children:"PartialDataView.supertype"})," to create a\n",(0,t.jsx)(n.code,{children:"DataView"})," from a Bundle type to a parent type by just providing the function to construct an\ninstance of the parent type from an instance of the child type.\nThe mapping of corresponding fields is automatically determined by Chisel to be the fields defined\nin the supertype."]}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-scala",children:"import chisel3._\nimport chisel3.experimental.dataview._\n\nclass Foo(x: Int) extends Bundle {\n  val foo = UInt(x.W)\n}\nclass Bar(val x: Int) extends Foo(x) {\n  val bar = UInt(x.W)\n}\n// Define a DataView without having to specify the mapping!\nimplicit val view = PartialDataView.supertype[Bar, Foo](b => new Foo(b.x))\n\nclass MyModule extends Module {\n  val foo = IO(Input(new Foo(8)))\n  val bar = IO(Output(new Bar(8)))\n  bar.viewAs[Foo] := foo // bar.foo := foo.foo\n  bar.bar := 123.U       // all fields need to be connected\n}\n"})}),"\n",(0,t.jsx)(n.pre,{children:(0,t.jsx)(n.code,{className:"language-verilog",children:'// Generated by CIRCT firtool-1.81.1\nmodule MyModule(\t// dataview.md:203:7\n  input        clock,\t// dataview.md:203:7\n               reset,\t// dataview.md:203:7\n  input  [7:0] foo_foo,\t// dataview.md:204:15\n  output [7:0] bar_foo,\t// dataview.md:205:15\n               bar_bar\t// dataview.md:205:15\n);\n\n  assign bar_foo = foo_foo;\t// dataview.md:203:7\n  assign bar_bar = 8\'h7B;\t// dataview.md:203:7, :207:11\nendmodule\n\n\n// ----- 8< ----- FILE "Verification/Cover/layers_MyModule_Verification_Cover.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyModule_Verification.sv"\n`ifndef layers_MyModule_Verification_Cover\n`define layers_MyModule_Verification_Cover\t// <stdin>:6:5\n`endif // layers_MyModule_Verification_Cover\t// <stdin>:6:5\n\n// ----- 8< ----- FILE "Verification/Assume/layers_MyModule_Verification_Assume.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyModule_Verification.sv"\n`ifndef layers_MyModule_Verification_Assume\n`define layers_MyModule_Verification_Assume\t// <stdin>:5:5\n`endif // layers_MyModule_Verification_Assume\t// <stdin>:5:5\n\n// ----- 8< ----- FILE "Verification/Assert/layers_MyModule_Verification_Assert.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`include "Verification/layers_MyModule_Verification.sv"\n`ifndef layers_MyModule_Verification_Assert\n`define layers_MyModule_Verification_Assert\t// <stdin>:4:5\n`endif // layers_MyModule_Verification_Assert\t// <stdin>:4:5\n\n// ----- 8< ----- FILE "Verification/layers_MyModule_Verification.sv" ----- 8< -----\n\n// Generated by CIRCT firtool-1.81.1\n`ifndef layers_MyModule_Verification\n`define layers_MyModule_Verification\t// <stdin>:3:3\n`endif // layers_MyModule_Verification\t// <stdin>:3:3\n'})})]})}function f(e={}){const{wrapper:n}={...(0,i.R)(),...e.components};return n?(0,t.jsx)(n,{...e,children:(0,t.jsx)(u,{...e})}):u(e)}},1871:(e,n,a)=>{a.d(n,{A:()=>s});a(6540);var t=a(5195);const i={tableOfContentsInline:"tableOfContentsInline_prmo"};var o=a(4848);function s(e){let{toc:n,minHeadingLevel:a,maxHeadingLevel:s}=e;return(0,o.jsx)("div",{className:i.tableOfContentsInline,children:(0,o.jsx)(t.A,{toc:n,minHeadingLevel:a,maxHeadingLevel:s,className:"table-of-contents",linkClassName:null})})}},5195:(e,n,a)=>{a.d(n,{A:()=>v});var t=a(6540),i=a(6342);function o(e){const n=e.map((e=>({...e,parentIndex:-1,children:[]}))),a=Array(7).fill(-1);n.forEach(((e,n)=>{const t=a.slice(2,e.level);e.parentIndex=Math.max(...t),a[e.level]=n}));const t=[];return n.forEach((e=>{const{parentIndex:a,...i}=e;a>=0?n[a].children.push(i):t.push(i)})),t}function s(e){let{toc:n,minHeadingLevel:a,maxHeadingLevel:t}=e;return n.flatMap((e=>{const n=s({toc:e.children,minHeadingLevel:a,maxHeadingLevel:t});return function(e){return e.level>=a&&e.level<=t}(e)?[{...e,children:n}]:n}))}function r(e){const n=e.getBoundingClientRect();return n.top===n.bottom?r(e.parentNode):n}function l(e,n){let{anchorTopOffset:a}=n;const t=e.find((e=>r(e).top>=a));if(t){return function(e){return e.top>0&&e.bottom<window.innerHeight/2}(r(t))?t:e[e.indexOf(t)-1]??null}return e[e.length-1]??null}function d(){const e=(0,t.useRef)(0),{navbar:{hideOnScroll:n}}=(0,i.p)();return(0,t.useEffect)((()=>{e.current=n?0:document.querySelector(".navbar").clientHeight}),[n]),e}function c(e){const n=(0,t.useRef)(void 0),a=d();(0,t.useEffect)((()=>{if(!e)return()=>{};const{linkClassName:t,linkActiveClassName:i,minHeadingLevel:o,maxHeadingLevel:s}=e;function r(){const e=function(e){return Array.from(document.getElementsByClassName(e))}(t),r=function(e){let{minHeadingLevel:n,maxHeadingLevel:a}=e;const t=[];for(let i=n;i<=a;i+=1)t.push(`h${i}.anchor`);return Array.from(document.querySelectorAll(t.join()))}({minHeadingLevel:o,maxHeadingLevel:s}),d=l(r,{anchorTopOffset:a.current}),c=e.find((e=>d&&d.id===function(e){return decodeURIComponent(e.href.substring(e.href.indexOf("#")+1))}(e)));e.forEach((e=>{!function(e,a){a?(n.current&&n.current!==e&&n.current.classList.remove(i),e.classList.add(i),n.current=e):e.classList.remove(i)}(e,e===c)}))}return document.addEventListener("scroll",r),document.addEventListener("resize",r),r(),()=>{document.removeEventListener("scroll",r),document.removeEventListener("resize",r)}}),[e,a])}var u=a(8774),f=a(4848);function p(e){let{toc:n,className:a,linkClassName:t,isChild:i}=e;return n.length?(0,f.jsx)("ul",{className:i?void 0:a,children:n.map((e=>(0,f.jsxs)("li",{children:[(0,f.jsx)(u.A,{to:`#${e.id}`,className:t??void 0,dangerouslySetInnerHTML:{__html:e.value}}),(0,f.jsx)(p,{isChild:!0,toc:e.children,className:a,linkClassName:t})]},e.id)))}):null}const h=t.memo(p);function v(e){let{toc:n,className:a="table-of-contents table-of-contents__left-border",linkClassName:r="table-of-contents__link",linkActiveClassName:l,minHeadingLevel:d,maxHeadingLevel:u,...p}=e;const v=(0,i.p)(),m=d??v.tableOfContents.minHeadingLevel,w=u??v.tableOfContents.maxHeadingLevel,y=function(e){let{toc:n,minHeadingLevel:a,maxHeadingLevel:i}=e;return(0,t.useMemo)((()=>s({toc:o(n),minHeadingLevel:a,maxHeadingLevel:i})),[n,a,i])}({toc:n,minHeadingLevel:m,maxHeadingLevel:w});return c((0,t.useMemo)((()=>{if(r&&l)return{linkClassName:r,linkActiveClassName:l,minHeadingLevel:m,maxHeadingLevel:w}}),[r,l,m,w])),(0,f.jsx)(h,{toc:y,className:a,linkClassName:r,...p})}},8453:(e,n,a)=>{a.d(n,{R:()=>s,x:()=>r});var t=a(6540);const i={},o=t.createContext(i);function s(e){const n=t.useContext(o);return t.useMemo((function(){return"function"==typeof e?e(n):{...n,...e}}),[n,e])}function r(e){let n;return n=e.disableParentContext?"function"==typeof e.components?e.components(i):e.components||i:s(e.components),t.createElement(o.Provider,{value:n},e.children)}}}]);
\ No newline at end of file
diff --git a/assets/js/runtime~main.8290adcf.js b/assets/js/runtime~main.4c8ffac5.js
similarity index 86%
rename from assets/js/runtime~main.8290adcf.js
rename to assets/js/runtime~main.4c8ffac5.js
index 08a9a92ac8..072ec5c397 100644
--- a/assets/js/runtime~main.8290adcf.js
+++ b/assets/js/runtime~main.4c8ffac5.js
@@ -1 +1 @@
-(()=>{"use strict";var e,a,d,c,f,b={},t={};function r(e){var a=t[e];if(void 0!==a)return a.exports;var d=t[e]={exports:{}};return b[e].call(d.exports,d,d.exports,r),d.exports}r.m=b,e=[],r.O=(a,d,c,f)=>{if(!d){var b=1/0;for(i=0;i<e.length;i++){d=e[i][0],c=e[i][1],f=e[i][2];for(var t=!0,o=0;o<d.length;o++)(!1&f||b>=f)&&Object.keys(r.O).every((e=>r.O[e](d[o])))?d.splice(o--,1):(t=!1,f<b&&(b=f));if(t){e.splice(i--,1);var n=c();void 0!==n&&(a=n)}}return a}f=f||0;for(var i=e.length;i>0&&e[i-1][2]>f;i--)e[i]=e[i-1];e[i]=[d,c,f]},r.n=e=>{var a=e&&e.__esModule?()=>e.default:()=>e;return r.d(a,{a:a}),a},d=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,r.t=function(e,c){if(1&c&&(e=this(e)),8&c)return e;if("object"==typeof e&&e){if(4&c&&e.__esModule)return e;if(16&c&&"function"==typeof e.then)return e}var f=Object.create(null);r.r(f);var b={};a=a||[null,d({}),d([]),d(d)];for(var t=2&c&&e;"object"==typeof t&&!~a.indexOf(t);t=d(t))Object.getOwnPropertyNames(t).forEach((a=>b[a]=()=>e[a]));return b.default=()=>e,r.d(f,b),f},r.d=(e,a)=>{for(var d in a)r.o(a,d)&&!r.o(e,d)&&Object.defineProperty(e,d,{enumerable:!0,get:a[d]})},r.f={},r.e=e=>Promise.all(Object.keys(r.f).reduce(((a,d)=>(r.f[d](e,a),a)),[])),r.u=e=>"assets/js/"+({340:"c5561474",741:"1ce89024",1108:"bc33eb1f",1188:"e7b22fe0",1281:"d50fb5c7",1357:"87b43d15",1384:"8fdf13ba",1596:"f416550b",1921:"2024159c",1979:"9cfbec6b",2012:"f10ce86b",2138:"1a4e3797",2289:"916cecd1",2504:"54ab625b",2579:"9cc76f42",2634:"c4f5d8e4",2785:"7b5bfa87",3117:"a26328e3",3126:"cddf45a4",3130:"3afb3224",3291:"7cc2f0dc",3313:"a8f82c73",3316:"c48de377",3460:"a98e3d7d",3543:"96d1adfe",3599:"30c88dbf",4020:"44ff0b81",4166:"d4b6d0e6",4286:"11a69d4a",4315:"651e9e03",4825:"44147ff4",4863:"d1e6e3d8",5056:"ae8e96e2",5432:"7e1e4a75",5497:"46a40f56",5522:"cdcdfbab",5540:"d1a7dbc9",5583:"f901c241",5666:"0bba5ab0",5742:"c377a04b",6061:"1f391b9e",6067:"1f7682ec",6259:"556f9cb0",6304:"21d75435",6403:"d1a683e4",6474:"c7666d49",6709:"c3800170",6760:"11d458a9",6803:"3b8c55ea",6969:"14eb3368",6991:"37a5b604",7087:"1883c3a9",7098:"a7bd4aaa",7132:"67ffb541",7315:"407ce553",7425:"a47e47c7",7437:"adf02ec5",8118:"6559d260",8227:"19ad7e9f",8316:"17dd133b",8401:"17896441",8485:"806d4637",8507:"b13aa1a2",8581:"935f2afb",8864:"d92a3c43",8946:"98ca0ee0",9017:"868241d3",9048:"a94703ab",9128:"7fa9ea57",9387:"c71a47e4",9647:"5e95c892",9670:"87ed036d",9710:"bc089483",9920:"6a9619ba",9942:"12b2b068"}[e]||e)+"."+{340:"2a86726f",416:"d5c32938",741:"8ad3720b",1108:"73a85b4c",1188:"b37becdb",1281:"37482279",1357:"17470d5c",1384:"79f03779",1596:"1ceba669",1921:"ea204555",1979:"e4e33567",2012:"10f5bd03",2138:"09d5ffe5",2237:"c1ab8b5a",2289:"117f3b9d",2504:"c8a6834c",2579:"d67bb198",2634:"c5377180",2785:"18f8af79",3117:"c64240dc",3126:"0e9d453a",3130:"46c05042",3291:"0f402a60",3313:"e2fd7a36",3316:"64bb7063",3460:"1c5a22d0",3543:"d8496b98",3599:"d8d7e9aa",3794:"35034f12",4020:"5cf60c66",4166:"dcf1e388",4286:"5282e6c7",4315:"4851e79f",4825:"994c2df0",4863:"de556a7e",5056:"ed5a202a",5432:"82d2355a",5497:"f792daf2",5522:"eaeb3d96",5540:"58654cac",5583:"b056d9a6",5666:"1e7c9e57",5742:"ee2a24ca",6061:"9d3ff995",6067:"0fceaace",6259:"3363753d",6304:"5e682e30",6403:"1f47dcec",6474:"3ed48610",6709:"9ba42d11",6760:"670d958e",6803:"1f5fc799",6969:"0bcc7e8d",6991:"a9655923",7087:"96db2d80",7098:"fb8f4b1d",7132:"b79017b5",7315:"573ffbec",7425:"46016d7a",7437:"4a2fd9ba",8118:"c7ffc560",8158:"887a29fb",8227:"e5504390",8316:"eb35e550",8401:"19366d16",8485:"e8db32ed",8507:"b458ceda",8581:"d7b40125",8864:"f3c5be57",8913:"eae5cfc0",8946:"9a00ad74",9017:"8f24b23c",9048:"ca12ef2b",9128:"a0b7aa39",9387:"dff32f23",9647:"539b71e6",9670:"550cd114",9710:"071ce7a7",9920:"74a4701a",9942:"027aa455"}[e]+".js",r.miniCssF=e=>{},r.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),r.o=(e,a)=>Object.prototype.hasOwnProperty.call(e,a),c={},f="chisel-lang:",r.l=(e,a,d,b)=>{if(c[e])c[e].push(a);else{var t,o;if(void 0!==d)for(var n=document.getElementsByTagName("script"),i=0;i<n.length;i++){var l=n[i];if(l.getAttribute("src")==e||l.getAttribute("data-webpack")==f+d){t=l;break}}t||(o=!0,(t=document.createElement("script")).charset="utf-8",t.timeout=120,r.nc&&t.setAttribute("nonce",r.nc),t.setAttribute("data-webpack",f+d),t.src=e),c[e]=[a];var u=(a,d)=>{t.onerror=t.onload=null,clearTimeout(s);var f=c[e];if(delete c[e],t.parentNode&&t.parentNode.removeChild(t),f&&f.forEach((e=>e(d))),a)return a(d)},s=setTimeout(u.bind(null,void 0,{type:"timeout",target:t}),12e4);t.onerror=u.bind(null,t.onerror),t.onload=u.bind(null,t.onload),o&&document.head.appendChild(t)}},r.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},r.p="/",r.gca=function(e){return e={17896441:"8401",c5561474:"340","1ce89024":"741",bc33eb1f:"1108",e7b22fe0:"1188",d50fb5c7:"1281","87b43d15":"1357","8fdf13ba":"1384",f416550b:"1596","2024159c":"1921","9cfbec6b":"1979",f10ce86b:"2012","1a4e3797":"2138","916cecd1":"2289","54ab625b":"2504","9cc76f42":"2579",c4f5d8e4:"2634","7b5bfa87":"2785",a26328e3:"3117",cddf45a4:"3126","3afb3224":"3130","7cc2f0dc":"3291",a8f82c73:"3313",c48de377:"3316",a98e3d7d:"3460","96d1adfe":"3543","30c88dbf":"3599","44ff0b81":"4020",d4b6d0e6:"4166","11a69d4a":"4286","651e9e03":"4315","44147ff4":"4825",d1e6e3d8:"4863",ae8e96e2:"5056","7e1e4a75":"5432","46a40f56":"5497",cdcdfbab:"5522",d1a7dbc9:"5540",f901c241:"5583","0bba5ab0":"5666",c377a04b:"5742","1f391b9e":"6061","1f7682ec":"6067","556f9cb0":"6259","21d75435":"6304",d1a683e4:"6403",c7666d49:"6474",c3800170:"6709","11d458a9":"6760","3b8c55ea":"6803","14eb3368":"6969","37a5b604":"6991","1883c3a9":"7087",a7bd4aaa:"7098","67ffb541":"7132","407ce553":"7315",a47e47c7:"7425",adf02ec5:"7437","6559d260":"8118","19ad7e9f":"8227","17dd133b":"8316","806d4637":"8485",b13aa1a2:"8507","935f2afb":"8581",d92a3c43:"8864","98ca0ee0":"8946","868241d3":"9017",a94703ab:"9048","7fa9ea57":"9128",c71a47e4:"9387","5e95c892":"9647","87ed036d":"9670",bc089483:"9710","6a9619ba":"9920","12b2b068":"9942"}[e]||e,r.p+r.u(e)},(()=>{var e={5354:0,1869:0};r.f.j=(a,d)=>{var c=r.o(e,a)?e[a]:void 0;if(0!==c)if(c)d.push(c[2]);else if(/^(1869|5354)$/.test(a))e[a]=0;else{var f=new Promise(((d,f)=>c=e[a]=[d,f]));d.push(c[2]=f);var b=r.p+r.u(a),t=new Error;r.l(b,(d=>{if(r.o(e,a)&&(0!==(c=e[a])&&(e[a]=void 0),c)){var f=d&&("load"===d.type?"missing":d.type),b=d&&d.target&&d.target.src;t.message="Loading chunk "+a+" failed.\n("+f+": "+b+")",t.name="ChunkLoadError",t.type=f,t.request=b,c[1](t)}}),"chunk-"+a,a)}},r.O.j=a=>0===e[a];var a=(a,d)=>{var c,f,b=d[0],t=d[1],o=d[2],n=0;if(b.some((a=>0!==e[a]))){for(c in t)r.o(t,c)&&(r.m[c]=t[c]);if(o)var i=o(r)}for(a&&a(d);n<b.length;n++)f=b[n],r.o(e,f)&&e[f]&&e[f][0](),e[f]=0;return r.O(i)},d=self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[];d.forEach(a.bind(null,0)),d.push=a.bind(null,d.push.bind(d))})()})();
\ No newline at end of file
+(()=>{"use strict";var e,a,d,c,f,b={},t={};function r(e){var a=t[e];if(void 0!==a)return a.exports;var d=t[e]={exports:{}};return b[e].call(d.exports,d,d.exports,r),d.exports}r.m=b,e=[],r.O=(a,d,c,f)=>{if(!d){var b=1/0;for(i=0;i<e.length;i++){d=e[i][0],c=e[i][1],f=e[i][2];for(var t=!0,o=0;o<d.length;o++)(!1&f||b>=f)&&Object.keys(r.O).every((e=>r.O[e](d[o])))?d.splice(o--,1):(t=!1,f<b&&(b=f));if(t){e.splice(i--,1);var n=c();void 0!==n&&(a=n)}}return a}f=f||0;for(var i=e.length;i>0&&e[i-1][2]>f;i--)e[i]=e[i-1];e[i]=[d,c,f]},r.n=e=>{var a=e&&e.__esModule?()=>e.default:()=>e;return r.d(a,{a:a}),a},d=Object.getPrototypeOf?e=>Object.getPrototypeOf(e):e=>e.__proto__,r.t=function(e,c){if(1&c&&(e=this(e)),8&c)return e;if("object"==typeof e&&e){if(4&c&&e.__esModule)return e;if(16&c&&"function"==typeof e.then)return e}var f=Object.create(null);r.r(f);var b={};a=a||[null,d({}),d([]),d(d)];for(var t=2&c&&e;"object"==typeof t&&!~a.indexOf(t);t=d(t))Object.getOwnPropertyNames(t).forEach((a=>b[a]=()=>e[a]));return b.default=()=>e,r.d(f,b),f},r.d=(e,a)=>{for(var d in a)r.o(a,d)&&!r.o(e,d)&&Object.defineProperty(e,d,{enumerable:!0,get:a[d]})},r.f={},r.e=e=>Promise.all(Object.keys(r.f).reduce(((a,d)=>(r.f[d](e,a),a)),[])),r.u=e=>"assets/js/"+({340:"c5561474",741:"1ce89024",1108:"bc33eb1f",1188:"e7b22fe0",1281:"d50fb5c7",1357:"87b43d15",1384:"8fdf13ba",1596:"f416550b",1921:"2024159c",1979:"9cfbec6b",2012:"f10ce86b",2138:"1a4e3797",2289:"916cecd1",2504:"54ab625b",2579:"9cc76f42",2634:"c4f5d8e4",2785:"7b5bfa87",3117:"a26328e3",3126:"cddf45a4",3130:"3afb3224",3291:"7cc2f0dc",3313:"a8f82c73",3316:"c48de377",3460:"a98e3d7d",3543:"96d1adfe",3599:"30c88dbf",4020:"44ff0b81",4166:"d4b6d0e6",4286:"11a69d4a",4315:"651e9e03",4825:"44147ff4",4863:"d1e6e3d8",5056:"ae8e96e2",5432:"7e1e4a75",5497:"46a40f56",5522:"cdcdfbab",5540:"d1a7dbc9",5583:"f901c241",5666:"0bba5ab0",5742:"c377a04b",6061:"1f391b9e",6067:"1f7682ec",6259:"556f9cb0",6304:"21d75435",6403:"d1a683e4",6474:"c7666d49",6709:"c3800170",6760:"11d458a9",6803:"3b8c55ea",6969:"14eb3368",6991:"37a5b604",7087:"1883c3a9",7098:"a7bd4aaa",7132:"67ffb541",7315:"407ce553",7425:"a47e47c7",7437:"adf02ec5",8118:"6559d260",8227:"19ad7e9f",8316:"17dd133b",8401:"17896441",8485:"806d4637",8507:"b13aa1a2",8581:"935f2afb",8864:"d92a3c43",8946:"98ca0ee0",9017:"868241d3",9048:"a94703ab",9128:"7fa9ea57",9387:"c71a47e4",9647:"5e95c892",9670:"87ed036d",9710:"bc089483",9920:"6a9619ba",9942:"12b2b068"}[e]||e)+"."+{340:"2a86726f",416:"d5c32938",741:"8397b873",1108:"73a85b4c",1188:"b37becdb",1281:"5a3db385",1357:"17470d5c",1384:"79f03779",1596:"1ceba669",1921:"ea204555",1979:"e4e33567",2012:"1a8da0d2",2138:"09d5ffe5",2237:"c1ab8b5a",2289:"465d4dc0",2504:"c8a6834c",2579:"d67bb198",2634:"c5377180",2785:"eff9fa5b",3117:"c64240dc",3126:"0e9d453a",3130:"46c05042",3291:"d5e2a205",3313:"74167bd1",3316:"e33bb9b9",3460:"1c5a22d0",3543:"d8496b98",3599:"d8d7e9aa",3794:"35034f12",4020:"5cf60c66",4166:"3905c761",4286:"5282e6c7",4315:"4851e79f",4825:"994c2df0",4863:"bae292e0",5056:"ed5a202a",5432:"f1b5b02e",5497:"f792daf2",5522:"733b373f",5540:"58654cac",5583:"b056d9a6",5666:"1e7c9e57",5742:"ee2a24ca",6061:"9d3ff995",6067:"0fceaace",6259:"3363753d",6304:"5e682e30",6403:"1f47dcec",6474:"11a4da61",6709:"9ba42d11",6760:"670d958e",6803:"1f5fc799",6969:"0bcc7e8d",6991:"a9655923",7087:"96db2d80",7098:"fb8f4b1d",7132:"aafe16f9",7315:"573ffbec",7425:"46016d7a",7437:"4a2fd9ba",8118:"c7ffc560",8158:"887a29fb",8227:"e5504390",8316:"a4d03fda",8401:"19366d16",8485:"e8db32ed",8507:"b458ceda",8581:"d7b40125",8864:"f3c5be57",8913:"eae5cfc0",8946:"1b04f0c5",9017:"cd7cbf8a",9048:"ca12ef2b",9128:"5aff8b69",9387:"dff32f23",9647:"539b71e6",9670:"550cd114",9710:"071ce7a7",9920:"74a4701a",9942:"027aa455"}[e]+".js",r.miniCssF=e=>{},r.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||new Function("return this")()}catch(e){if("object"==typeof window)return window}}(),r.o=(e,a)=>Object.prototype.hasOwnProperty.call(e,a),c={},f="chisel-lang:",r.l=(e,a,d,b)=>{if(c[e])c[e].push(a);else{var t,o;if(void 0!==d)for(var n=document.getElementsByTagName("script"),i=0;i<n.length;i++){var l=n[i];if(l.getAttribute("src")==e||l.getAttribute("data-webpack")==f+d){t=l;break}}t||(o=!0,(t=document.createElement("script")).charset="utf-8",t.timeout=120,r.nc&&t.setAttribute("nonce",r.nc),t.setAttribute("data-webpack",f+d),t.src=e),c[e]=[a];var u=(a,d)=>{t.onerror=t.onload=null,clearTimeout(s);var f=c[e];if(delete c[e],t.parentNode&&t.parentNode.removeChild(t),f&&f.forEach((e=>e(d))),a)return a(d)},s=setTimeout(u.bind(null,void 0,{type:"timeout",target:t}),12e4);t.onerror=u.bind(null,t.onerror),t.onload=u.bind(null,t.onload),o&&document.head.appendChild(t)}},r.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},r.p="/",r.gca=function(e){return e={17896441:"8401",c5561474:"340","1ce89024":"741",bc33eb1f:"1108",e7b22fe0:"1188",d50fb5c7:"1281","87b43d15":"1357","8fdf13ba":"1384",f416550b:"1596","2024159c":"1921","9cfbec6b":"1979",f10ce86b:"2012","1a4e3797":"2138","916cecd1":"2289","54ab625b":"2504","9cc76f42":"2579",c4f5d8e4:"2634","7b5bfa87":"2785",a26328e3:"3117",cddf45a4:"3126","3afb3224":"3130","7cc2f0dc":"3291",a8f82c73:"3313",c48de377:"3316",a98e3d7d:"3460","96d1adfe":"3543","30c88dbf":"3599","44ff0b81":"4020",d4b6d0e6:"4166","11a69d4a":"4286","651e9e03":"4315","44147ff4":"4825",d1e6e3d8:"4863",ae8e96e2:"5056","7e1e4a75":"5432","46a40f56":"5497",cdcdfbab:"5522",d1a7dbc9:"5540",f901c241:"5583","0bba5ab0":"5666",c377a04b:"5742","1f391b9e":"6061","1f7682ec":"6067","556f9cb0":"6259","21d75435":"6304",d1a683e4:"6403",c7666d49:"6474",c3800170:"6709","11d458a9":"6760","3b8c55ea":"6803","14eb3368":"6969","37a5b604":"6991","1883c3a9":"7087",a7bd4aaa:"7098","67ffb541":"7132","407ce553":"7315",a47e47c7:"7425",adf02ec5:"7437","6559d260":"8118","19ad7e9f":"8227","17dd133b":"8316","806d4637":"8485",b13aa1a2:"8507","935f2afb":"8581",d92a3c43:"8864","98ca0ee0":"8946","868241d3":"9017",a94703ab:"9048","7fa9ea57":"9128",c71a47e4:"9387","5e95c892":"9647","87ed036d":"9670",bc089483:"9710","6a9619ba":"9920","12b2b068":"9942"}[e]||e,r.p+r.u(e)},(()=>{var e={5354:0,1869:0};r.f.j=(a,d)=>{var c=r.o(e,a)?e[a]:void 0;if(0!==c)if(c)d.push(c[2]);else if(/^(1869|5354)$/.test(a))e[a]=0;else{var f=new Promise(((d,f)=>c=e[a]=[d,f]));d.push(c[2]=f);var b=r.p+r.u(a),t=new Error;r.l(b,(d=>{if(r.o(e,a)&&(0!==(c=e[a])&&(e[a]=void 0),c)){var f=d&&("load"===d.type?"missing":d.type),b=d&&d.target&&d.target.src;t.message="Loading chunk "+a+" failed.\n("+f+": "+b+")",t.name="ChunkLoadError",t.type=f,t.request=b,c[1](t)}}),"chunk-"+a,a)}},r.O.j=a=>0===e[a];var a=(a,d)=>{var c,f,b=d[0],t=d[1],o=d[2],n=0;if(b.some((a=>0!==e[a]))){for(c in t)r.o(t,c)&&(r.m[c]=t[c]);if(o)var i=o(r)}for(a&&a(d);n<b.length;n++)f=b[n],r.o(e,f)&&e[f]&&e[f][0](),e[f]=0;return r.O(i)},d=self.webpackChunkchisel_lang=self.webpackChunkchisel_lang||[];d.forEach(a.bind(null,0)),d.push=a.bind(null,d.push.bind(d))})()})();
\ No newline at end of file
diff --git a/community.html b/community.html
index 71b210ac42..d306a65269 100644
--- a/community.html
+++ b/community.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Community | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/community"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docusaurus_tag" content="default"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docsearch:docusaurus_tag" content="default"><meta data-rh="true" property="og:title" content="Community | Chisel"><meta data-rh="true" name="description" content="Chisel Users Community"><meta data-rh="true" property="og:description" content="Chisel Users Community"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/community"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/community" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/community" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs.html b/docs.html
index e778d0b9a9..97e958bead 100644
--- a/docs.html
+++ b/docs.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Introduction | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Introduction | Chisel"><meta data-rh="true" name="description" content="Chisel (Constructing"><meta data-rh="true" property="og:description" content="Chisel (Constructing"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/appendix.html b/docs/appendix.html
index 623d1f45c4..c6387122e8 100644
--- a/docs/appendix.html
+++ b/docs/appendix.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Appendix | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/appendix"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Appendix | Chisel"><meta data-rh="true" name="description" content="This section covers some less-common Chisel topics."><meta data-rh="true" property="og:description" content="This section covers some less-common Chisel topics."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/appendix"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/appendix" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/appendix" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/appendix/experimental-features.html b/docs/appendix/experimental-features.html
index 315540f0f4..bec6f26d02 100644
--- a/docs/appendix/experimental-features.html
+++ b/docs/appendix/experimental-features.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Experimental Features | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/appendix/experimental-features"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Experimental Features | Chisel"><meta data-rh="true" name="description" content="Chisel has a number of new features that are worth checking out.  This page is an informal list of these features and projects."><meta data-rh="true" property="og:description" content="Chisel has a number of new features that are worth checking out.  This page is an informal list of these features and projects."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/appendix/experimental-features"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/appendix/experimental-features" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/appendix/experimental-features" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
@@ -30,37 +30,37 @@ <h2 class="anchor anchorWithStickyNavbar_LWe7" id="module-variants">Module Varia
 <h2 class="anchor anchorWithStickyNavbar_LWe7" id="bundle-literals">Bundle Literals<a href="#bundle-literals" class="hash-link" aria-label="Direct link to Bundle Literals" title="Direct link to Bundle Literals">​</a></h2>
 <p>Bundle literals can be constructed via an experimental import:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">BundleLiterals</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MyBundle </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Lit</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token boolean" style="color:#36acaa">true</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">B</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:20:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:21:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">       out_b	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:21:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h8</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:20:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:20:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:20:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:21:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">       out_b	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:21:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h8</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:20:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:20:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Partial specification is allowed, which results in &quot;invalidated fields&quot; as
 described in <a href="/docs/explanations/unconnected-wires">Unconnected Wires</a>.
 Note that this can be used with <code>RegInit</code> to construct partially reset registers as
 described in the <a href="/docs/cookbooks/cookbook#how-do-i-partially-reset-an-aggregate-reg">Cookbook</a>.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example2 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Lit</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token boolean" style="color:#36acaa">true</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">B</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example2</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:35:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:36:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">       out_b	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:36:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:35:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:35:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example2</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:35:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:36:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">       out_b	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:36:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:35:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:35:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example2_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example2_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example2_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example2_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example2_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example2_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example2_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example2_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example2_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example2_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example2_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example2_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example2_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example2_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example2_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example2_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example2_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example2_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example2_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Bundle literals can also be nested arbitrarily.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> ChildBundle </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> ParentBundle </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> ChildBundle</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example3 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> ParentBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> ParentBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Lit</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">123.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> ChildBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Lit</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">foo </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">42.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example3</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:61:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:62:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_b_foo	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:62:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h7B</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:61:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_b_foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h2A</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:61:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example3</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:61:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:62:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_b_foo	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:62:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h7B</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:61:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_b_foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h2A</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:61:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example3_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example3_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example3_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example3_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example3_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example3_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example3_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example3_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example3_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example3_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example3_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example3_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example3_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example3_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example3_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example3_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example3_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example3_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example3_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h2 class="anchor anchorWithStickyNavbar_LWe7" id="vec-literals">Vec Literals<a href="#vec-literals" class="hash-link" aria-label="Direct link to Vec Literals" title="Direct link to Vec Literals">​</a></h2>
 <p>Vec literals are very similar to Bundle literals and can be constructed via an experimental import.
 They can be constructed in two forms, with type and length inferred as in:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">VecLiterals</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> VecExample1 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Vec</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Vec</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Lit</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">0xa</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">0xbb</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">VecExample1</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:82:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:82:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:82:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:83:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_1	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:83:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;hA</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:82:7, :84:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;hB</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:82:7, :84:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">VecExample1</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:82:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:82:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:82:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:83:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_1	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:83:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;hA</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:82:7, :84:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;hB</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:82:7, :84:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_VecExample1_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_VecExample1_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample1_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample1_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample1_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_VecExample1_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_VecExample1_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample1_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample1_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample1_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_VecExample1_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_VecExample1_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample1_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample1_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample1_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_VecExample1_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample1_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample1_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample1_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>or explicitly as in:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">VecLiterals</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> VecExample1a </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Vec</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Vec</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Lit</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">0</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">VecExample1a</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:103:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:103:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:103:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:104:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_1	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:104:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:103:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h2</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:103:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">VecExample1a</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:103:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:103:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:103:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:104:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_1	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:104:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:103:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h2</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:103:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_VecExample1a_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_VecExample1a_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample1a_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample1a_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample1a_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_VecExample1a_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_VecExample1a_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample1a_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample1a_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample1a_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_VecExample1a_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_VecExample1a_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample1a_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample1a_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample1a_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_VecExample1a_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample1a_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample1a_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample1a_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>The following examples all use the explicit form.
 With the explicit form partial specification is allowed, which results in
 &quot;invalidated fields&quot; as described in <a href="/docs/explanations/unconnected-wires">Unconnected Wires</a>.
 Note that this can be used with <code>RegInit</code> to construct partially reset registers as
 described in the <a href="/docs/cookbooks/cookbook#how-do-i-partially-reset-an-aggregate-reg">Cookbook</a>.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> VecExample2 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Vec</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Vec</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Lit</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">0</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">3</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">7.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">VecExample2</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:118:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:119:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:119:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:119:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_3	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:119:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:118:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:118:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_2 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:118:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_3 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h7</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:118:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">VecExample2</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:118:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:119:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:119:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:119:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_3	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:119:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:118:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:118:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_2 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:118:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_3 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h7</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:118:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_VecExample2_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_VecExample2_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample2_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample2_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample2_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_VecExample2_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_VecExample2_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample2_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample2_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample2_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_VecExample2_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_VecExample2_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample2_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample2_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample2_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_VecExample2_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample2_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample2_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample2_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Registers can be initialized from Vec literals</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> VecExample3 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Vec</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> y </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> RegInit</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    Vec</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Lit</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">0</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">0xAB</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">0xCD</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">0xEF</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">3</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">0xFF</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> y</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">VecExample3</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:133:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:133:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:133:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:134:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:134:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:134:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_3	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:134:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;hAB</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:133:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;hCD</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:133:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_2 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;hEF</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:133:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_3 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;hFF</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:133:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">VecExample3</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:133:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:133:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:133:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:134:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:134:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:134:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_3	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:134:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;hAB</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:133:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;hCD</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:133:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_2 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;hEF</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:133:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_3 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;hFF</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:133:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_VecExample3_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_VecExample3_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample3_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample3_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample3_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_VecExample3_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_VecExample3_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample3_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample3_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample3_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_VecExample3_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_VecExample3_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample3_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample3_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample3_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_VecExample3_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample3_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample3_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample3_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Vec literals can also be nested arbitrarily.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> VecExample5 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Vec</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> ChildBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Vec</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> ChildBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Lit</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token number" style="color:#36acaa">0</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> ChildBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Lit</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">foo </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">42.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token number" style="color:#36acaa">1</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> ChildBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Lit</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">foo </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">7.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">VecExample5</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:151:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_0_foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:152:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_1_foo	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:152:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_0_foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h2A</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:151:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_1_foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h7</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:151:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">VecExample5</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:151:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_0_foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:152:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_1_foo	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:152:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_0_foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h2A</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:151:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_1_foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h7</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// experimental-features.md:151:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_VecExample5_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_VecExample5_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample5_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample5_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample5_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_VecExample5_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_VecExample5_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample5_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample5_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample5_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_VecExample5_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_VecExample5_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample5_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample5_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample5_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_VecExample5_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_VecExample5_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_VecExample5_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_VecExample5_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h2 class="anchor anchorWithStickyNavbar_LWe7" id="loading-memories-for-simulation-or-fpga-initialization">Loading Memories for simulation or FPGA initialization<a href="#loading-memories-for-simulation-or-fpga-initialization" class="hash-link" aria-label="Direct link to Loading Memories for simulation or FPGA initialization" title="Direct link to Loading Memories for simulation or FPGA initialization">​</a></h2>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="inline-initialization-with-external-file">Inline initialization with external file<a href="#inline-initialization-with-external-file" class="hash-link" aria-label="Direct link to Inline initialization with external file" title="Direct link to Inline initialization with external file">​</a></h3>
 <p>Memories can be initialized by generating inline <code>readmemh</code> or <code>readmemb</code> statements in the output Verilog.</p>
diff --git a/docs/appendix/migrating-from-chiseltest.html b/docs/appendix/migrating-from-chiseltest.html
index 9d5b4b6e2e..590aa5bcf2 100644
--- a/docs/appendix/migrating-from-chiseltest.html
+++ b/docs/appendix/migrating-from-chiseltest.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Migrating from ChiselTest | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/appendix/migrating-from-chiseltest"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Migrating from ChiselTest | Chisel"><meta data-rh="true" name="description" content="Background"><meta data-rh="true" property="og:description" content="Background"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/appendix/migrating-from-chiseltest"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/appendix/migrating-from-chiseltest" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/appendix/migrating-from-chiseltest" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/appendix/upgrading-from-chisel-3-4.html b/docs/appendix/upgrading-from-chisel-3-4.html
index 839daa71ef..1a7222d5c6 100644
--- a/docs/appendix/upgrading-from-chisel-3-4.html
+++ b/docs/appendix/upgrading-from-chisel-3-4.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Upgrading From Chisel 3.4 to 3.5 | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/appendix/upgrading-from-chisel-3-4"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Upgrading From Chisel 3.4 to 3.5 | Chisel"><meta data-rh="true" name="description" content="Upgrading From Chisel 3.4 to 3.5"><meta data-rh="true" property="og:description" content="Upgrading From Chisel 3.4 to 3.5"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/appendix/upgrading-from-chisel-3-4"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/appendix/upgrading-from-chisel-3-4" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/appendix/upgrading-from-chisel-3-4" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/appendix/upgrading-from-scala-2-11.html b/docs/appendix/upgrading-from-scala-2-11.html
index af0e69ea66..578120a842 100644
--- a/docs/appendix/upgrading-from-scala-2-11.html
+++ b/docs/appendix/upgrading-from-scala-2-11.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Upgrading From Scala 2.11 | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/appendix/upgrading-from-scala-2-11"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Upgrading From Scala 2.11 | Chisel"><meta data-rh="true" name="description" content="Upgrading From Scala 2.11 to 2.12"><meta data-rh="true" property="og:description" content="Upgrading From Scala 2.11 to 2.12"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/appendix/upgrading-from-scala-2-11"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/appendix/upgrading-from-scala-2-11" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/appendix/upgrading-from-scala-2-11" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/appendix/versioning.html b/docs/appendix/versioning.html
index aa221266cc..ba065278d9 100644
--- a/docs/appendix/versioning.html
+++ b/docs/appendix/versioning.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Versioning | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/appendix/versioning"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Versioning | Chisel"><meta data-rh="true" name="description" content="Chisel follows Semantic Versioning 2.0.0."><meta data-rh="true" property="og:description" content="Chisel follows Semantic Versioning 2.0.0."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/appendix/versioning"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/appendix/versioning" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/appendix/versioning" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/category/getting-started.html b/docs/category/getting-started.html
index 48aede2911..634362485d 100644
--- a/docs/category/getting-started.html
+++ b/docs/category/getting-started.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Getting Started | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/category/getting-started"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Getting Started | Chisel"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/category/getting-started"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/category/getting-started" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/category/getting-started" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/cookbooks.html b/docs/cookbooks.html
index bb0d9e1664..a7593d6f33 100644
--- a/docs/cookbooks.html
+++ b/docs/cookbooks.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Cookbooks | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/cookbooks"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Cookbooks | Chisel"><meta data-rh="true" name="description" content="Welcome to the Chisel Cookbooks, where we capture frequently-used design patterns or troubleshooting questions."><meta data-rh="true" property="og:description" content="Welcome to the Chisel Cookbooks, where we capture frequently-used design patterns or troubleshooting questions."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/cookbooks"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/cookbooks" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/cookbooks" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/cookbooks/cookbook.html b/docs/cookbooks/cookbook.html
index de3ad3df82..2de759f38b 100644
--- a/docs/cookbooks/cookbook.html
+++ b/docs/cookbooks/cookbook.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">General Cookbook | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/cookbooks/cookbook"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="General Cookbook | Chisel"><meta data-rh="true" name="description" content="Please note that these examples make use of Chisel&#x27;s scala-style printing."><meta data-rh="true" property="og:description" content="Please note that these examples make use of Chisel&#x27;s scala-style printing."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/cookbooks/cookbook"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/cookbooks/cookbook" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/cookbooks/cookbook" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
@@ -142,12 +142,12 @@ <h2 class="anchor anchorWithStickyNavbar_LWe7" id="how-do-i-create-an-optional-i
 <h2 class="anchor anchorWithStickyNavbar_LWe7" id="how-do-i-create-io-without-a-prefix">How do I create I/O without a prefix?<a href="#how-do-i-create-io-without-a-prefix" class="hash-link" aria-label="Direct link to How do I create I/O without a prefix?" title="Direct link to How do I create I/O without a prefix?">​</a></h2>
 <p>In most cases, you can simply call <code>IO</code> multiple times:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MyModule </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token operator" style="color:#393A34">%</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">MyModule</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:691:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:691:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:691:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:692:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:693:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:691:7, :695:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">MyModule</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:691:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:691:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:691:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:692:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:693:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:691:7, :695:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_MyModule_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_MyModule_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_MyModule_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_MyModule_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>If you have a <code>Bundle</code> from which you would like to create ports without the
 normal <code>val</code> prefix, you can use <code>FlatIO</code>:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MyBundle </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> bar </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MyModule </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> FlatIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">bar </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">foo </span><span class="token operator" style="color:#393A34">+</span><span class="token operator" style="color:#393A34">%</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Note that <code>io_</code> is nowhere to be seen!</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">MyModule</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:720:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:720:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:720:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:721:18</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> bar	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:721:18</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:720:7, :723:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">MyModule</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:720:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:720:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:720:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:721:18</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> bar	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:721:18</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:720:7, :723:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_MyModule_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_MyModule_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_MyModule_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_MyModule_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h2 class="anchor anchorWithStickyNavbar_LWe7" id="how-do-i-override-the-implicit-clock-or-reset-within-a-module">How do I override the implicit clock or reset within a Module?<a href="#how-do-i-override-the-implicit-clock-or-reset-within-a-module" class="hash-link" aria-label="Direct link to How do I override the implicit clock or reset within a Module?" title="Direct link to How do I override the implicit clock or reset within a Module?">​</a></h2>
 <p>To change the clock or reset for a region of code, use <code>withClock</code>, <code>withReset</code>, or <code>withClockAndReset</code>.
 See <a href="/docs/explanations/multi-clock">Multiple Clock Domains</a> for examples and details.</p>
@@ -155,7 +155,7 @@ <h2 class="anchor anchorWithStickyNavbar_LWe7" id="how-do-i-override-the-implici
 <p>For example, you could &quot;gate&quot; the default implicit clock as follows:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MyModule </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token keyword" style="color:#00009f">with</span><span class="token plain"> ImplicitClock </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> gate </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// We could just assign this to val implicitClock, but this allows us to give it a custom name</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> gatedClock </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">clock</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">asBool </span><span class="token operator" style="color:#393A34">||</span><span class="token plain"> gate</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">asClock</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// The trait requires us to implement this method referring to the clock</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// Note that this is a def, but the actual clock value must be assigned to a val</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">override</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">protected</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">def</span><span class="token plain"> implicitClock </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> gatedClock</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> r </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Reg</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> r</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  r </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This gives the following Verilog:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">MyModule</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               gate</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain">       gatedClock </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> clock </span><span class="token operator" style="color:#393A34">|</span><span class="token plain"> gate</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> r</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> gatedClock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    r </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> r</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">MyModule</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               gate</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain">       gatedClock </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> clock </span><span class="token operator" style="color:#393A34">|</span><span class="token plain"> gate</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> r</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> gatedClock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    r </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> r</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_MyModule_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_MyModule_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_MyModule_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_MyModule_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>If you do not care about the name of the overriden clock, you can just assign it to <code>val implicitClock</code>:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">override</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">protected</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> implicitClock </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">clock</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">asBool </span><span class="token operator" style="color:#393A34">||</span><span class="token plain"> gate</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">asClock</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p><code>ImplicitReset</code> works analogously to <code>ImplicitClock</code>.</p>
@@ -195,22 +195,22 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="how-do-i-get-chisel-to-name-t
 <p>Currently, name information is lost when using dynamic indexing. For example:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Foo </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Vec</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> idx </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> en </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> x </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">idx</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> y </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> x </span><span class="token operator" style="color:#393A34">&amp;&amp;</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">en</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> y</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>The above code loses the <code>x</code> name, instead using <code>_GEN_3</code> (the other <code>_GEN_*</code> signals are expected).</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Foo</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:933:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:933:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:933:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in_0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:934:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in_1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:934:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in_2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:934:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in_3</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:934:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> io_idx</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:934:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        io_en</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:934:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">       io_out	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:934:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> _GEN </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{{</span><span class="token plain">io_in_3</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token plain">io_in_2</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token plain">io_in_1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token plain">io_in_0</span><span class="token operator" style="color:#393A34">}}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:942:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> io_out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> _GEN</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">io_idx</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">&amp;</span><span class="token plain"> io_en</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:933:7, :942:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Foo</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:933:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:933:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:933:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in_0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:934:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in_1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:934:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in_2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:934:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in_3</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:934:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> io_idx</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:934:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        io_en</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:934:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">       io_out	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:934:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> _GEN </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{{</span><span class="token plain">io_in_3</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token plain">io_in_2</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token plain">io_in_1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token plain">io_in_0</span><span class="token operator" style="color:#393A34">}}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:942:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> io_out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> _GEN</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">io_idx</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">&amp;</span><span class="token plain"> io_en</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:933:7, :942:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Foo_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Foo_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Foo_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Foo_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Foo_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Foo_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Foo_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Foo_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Foo_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Foo_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Foo_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Foo_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Foo_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Foo_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Foo_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Foo_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Foo_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Foo_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Foo_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This can be worked around by creating a wire and connecting the dynamic index to the wire:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> x </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> WireInit</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">idx</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Which produces:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Foo2</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:956:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:956:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:956:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in_0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:957:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in_1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:957:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in_2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:957:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in_3</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:957:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> io_idx</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:957:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        io_en</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:957:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">       io_out	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:957:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> _GEN </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{{</span><span class="token plain">io_in_3</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token plain">io_in_2</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token plain">io_in_1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token plain">io_in_0</span><span class="token operator" style="color:#393A34">}}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:964:19</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> io_out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> _GEN</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">io_idx</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">&amp;</span><span class="token plain"> io_en</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:956:7, :964:19, :965:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Foo2</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:956:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:956:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:956:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in_0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:957:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in_1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:957:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in_2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:957:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in_3</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:957:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> io_idx</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:957:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        io_en</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:957:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">       io_out	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:957:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> _GEN </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{{</span><span class="token plain">io_in_3</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token plain">io_in_2</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token plain">io_in_1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token plain">io_in_0</span><span class="token operator" style="color:#393A34">}}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:964:19</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> io_out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> _GEN</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">io_idx</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">&amp;</span><span class="token plain"> io_en</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:956:7, :964:19, :965:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Foo2_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Foo2_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Foo2_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Foo2_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Foo2_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Foo2_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Foo2_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Foo2_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Foo2_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Foo2_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Foo2_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Foo2_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Foo2_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Foo2_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Foo2_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Foo2_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Foo2_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Foo2_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Foo2_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="how-can-i-dynamically-setparametrize-the-name-of-a-module">How can I dynamically set/parametrize the name of a module?<a href="#how-can-i-dynamically-setparametrize-the-name-of-a-module" class="hash-link" aria-label="Direct link to How can I dynamically set/parametrize the name of a module?" title="Direct link to How can I dynamically set/parametrize the name of a module?">​</a></h3>
 <p>You can override the <code>desiredName</code> function. This works with normal Chisel modules and <code>BlackBox</code>es. Example:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Coffee </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> BlackBox </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> I </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> O </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">override</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">def</span><span class="token plain"> desiredName </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Tea&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Salt </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> drink </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Coffee</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">override</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">def</span><span class="token plain"> desiredName </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;SodiumMonochloride&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    drink</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">I </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">42.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Elaborating the Chisel module <code>Salt</code> yields our &quot;desired names&quot; for <code>Salt</code> and <code>Coffee</code> in the output Verilog:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// external module Tea</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">SodiumMonochloride</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:994:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:994:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        reset	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:994:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  Tea drink </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:996:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">I </span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32&#x27;h2A</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">O </span><span class="token punctuation" style="color:#393A34">(</span><span class="token comment" style="color:#999988;font-style:italic">/* unused */</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:996:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// external module Tea</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">SodiumMonochloride</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:994:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:994:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        reset	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:994:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  Tea drink </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:996:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">I </span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32&#x27;h2A</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">O </span><span class="token punctuation" style="color:#393A34">(</span><span class="token comment" style="color:#999988;font-style:italic">/* unused */</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:996:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_SodiumMonochloride_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_SodiumMonochloride_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_SodiumMonochloride_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_SodiumMonochloride_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_SodiumMonochloride_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_SodiumMonochloride_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_SodiumMonochloride_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_SodiumMonochloride_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_SodiumMonochloride_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_SodiumMonochloride_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_SodiumMonochloride_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_SodiumMonochloride_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_SodiumMonochloride_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_SodiumMonochloride_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_SodiumMonochloride_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_SodiumMonochloride_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_SodiumMonochloride_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_SodiumMonochloride_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_SodiumMonochloride_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h2 class="anchor anchorWithStickyNavbar_LWe7" id="directionality">Directionality<a href="#directionality" class="hash-link" aria-label="Direct link to Directionality" title="Direct link to Directionality">​</a></h2>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="how-do-i-strip-directions-from-a-bidirectional-bundle-or-other-data">How do I strip directions from a bidirectional Bundle (or other Data)?<a href="#how-do-i-strip-directions-from-a-bidirectional-bundle-or-other-data" class="hash-link" aria-label="Direct link to How do I strip directions from a bidirectional Bundle (or other Data)?" title="Direct link to How do I strip directions from a bidirectional Bundle (or other Data)?">​</a></h3>
 <p>Given a bidirectional port like a <code>Decoupled</code>, you will get an error if you try to connect it directly
 to a register:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">circt</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">stage</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">ChiselStage</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">util</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">Decoupled</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> BadRegConnect </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> enq </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Decoupled</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> monitor </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Reg</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">chiselTypeOf</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">enq</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  monitor </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">enq</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> BadRegConnect</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// circt.stage.phases.Exceptions$FirtoolNonZeroExitCode: /home/runner/.cache/llvm-firtool/1.81.1/bin/firtool returned a non-zero exit code. Note that this version of Chisel (7.0.0-M2+49-ab82fc22-SNAPSHOT) was published against firtool version 1.81.1.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ------------------------------------------------------------------------------</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ExitCode:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// STDOUT:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// STDERR:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:1029:20: error: &#x27;firrtl.reg&#x27; op result #0 must be a passive non-&#x27;const&#x27; base type that does not contain analog, but got &#x27;!firrtl.bundle&lt;ready flip: uint&lt;1&gt;, valid: uint&lt;1&gt;, bits: uint&lt;8&gt;&gt;&#x27;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:1029:20: note: see current operation: %4 = &quot;firrtl.reg&quot;(%arg0) {annotations = [], name = &quot;monitor&quot;, nameKind = #firrtl&lt;name_kind interesting_name&gt;} : (!firrtl.clock) -&gt; !firrtl.bundle&lt;ready flip: uint&lt;1&gt;, valid: uint&lt;1&gt;, bits: uint&lt;8&gt;&gt;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ------------------------------------------------------------------------------</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> BadRegConnect</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// circt.stage.phases.Exceptions$FirtoolNonZeroExitCode: /home/runner/.cache/llvm-firtool/1.81.1/bin/firtool returned a non-zero exit code. Note that this version of Chisel (7.0.0-M2+50-f347914d-SNAPSHOT) was published against firtool version 1.81.1.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ------------------------------------------------------------------------------</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ExitCode:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// STDOUT:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// STDERR:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:1029:20: error: &#x27;firrtl.reg&#x27; op result #0 must be a passive non-&#x27;const&#x27; base type that does not contain analog, but got &#x27;!firrtl.bundle&lt;ready flip: uint&lt;1&gt;, valid: uint&lt;1&gt;, bits: uint&lt;8&gt;&gt;&#x27;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// cookbook.md:1029:20: note: see current operation: %4 = &quot;firrtl.reg&quot;(%arg0) {annotations = [], name = &quot;monitor&quot;, nameKind = #firrtl&lt;name_kind interesting_name&gt;} : (!firrtl.clock) -&gt; !firrtl.bundle&lt;ready flip: uint&lt;1&gt;, valid: uint&lt;1&gt;, bits: uint&lt;8&gt;&gt;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ------------------------------------------------------------------------------</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>While there is no construct to &quot;strip direction&quot; in Chisel3, wrapping a type in <code>Output(...)</code>
 (the default direction in Chisel3) will
 set all of the individual elements to output direction.
diff --git a/docs/cookbooks/dataview.html b/docs/cookbooks/dataview.html
index 61a095cb37..2e7dbb13b0 100644
--- a/docs/cookbooks/dataview.html
+++ b/docs/cookbooks/dataview.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">DataView Cookbook | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/cookbooks/dataview"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="DataView Cookbook | Chisel"><meta data-rh="true" name="description" content="How do I view a Data as a UInt or vice versa?"><meta data-rh="true" property="og:description" content="How do I view a Data as a UInt or vice versa?"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/cookbooks/dataview"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/cookbooks/dataview" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/cookbooks/dataview" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
@@ -33,7 +33,7 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="how-do-i-view-a-bundle-as-a-p
 <p>For viewing <code>Bundles</code> as the type of the parent, it is as simple as using <code>viewAsSupertype</code> and providing a
 template object of the parent type:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">dataview</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Foo </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Bar </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Foo </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> bar </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MyModule </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Foo</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> bar </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bar</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  bar</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">viewAsSupertype</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Foo</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> foo </span><span class="token comment" style="color:#999988;font-style:italic">// bar.foo := foo.foo</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  bar</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">bar </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">123.</span><span class="token plain">U           </span><span class="token comment" style="color:#999988;font-style:italic">// all fields need to be connected</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">MyModule</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:117:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:117:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:117:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> foo_foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:118:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> bar_foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:119:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               bar_bar	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:119:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar_foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> foo_foo</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:117:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar_bar </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h7B</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:117:7, :121:11</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">MyModule</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:117:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:117:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:117:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> foo_foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:118:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> bar_foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:119:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               bar_bar	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:119:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar_foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> foo_foo</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:117:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar_bar </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h7B</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:117:7, :121:11</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_MyModule_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_MyModule_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_MyModule_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_MyModule_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="how-do-i-view-a-bundle-as-a-parent-type-when-the-parent-type-is-abstract-like-a-trait">How do I view a Bundle as a parent type when the parent type is abstract (like a trait)?<a href="#how-do-i-view-a-bundle-as-a-parent-type-when-the-parent-type-is-abstract-like-a-trait" class="hash-link" aria-label="Direct link to How do I view a Bundle as a parent type when the parent type is abstract (like a trait)?" title="Direct link to How do I view a Bundle as a parent type when the parent type is abstract (like a trait)?">​</a></h3>
 <p>Given the following <code>Bundles</code> that share a common <code>trait</code>:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">dataview</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">trait</span><span class="token plain"> Super </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">def</span><span class="token plain"> bitwidth</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">Int</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">bitwidth</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Foo</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> bitwidth</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">Int</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Super </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Bar</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> bitwidth</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">Int</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Super </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> bar </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
@@ -61,6 +61,6 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="how-can-i-use-viewas-instead-
 The mapping of corresponding fields is automatically determined by Chisel to be the fields defined
 in the supertype.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">dataview</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Foo</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">x</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">Int</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">x</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Bar</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> x</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">Int</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Foo</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">x</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> bar </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">x</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Define a DataView without having to specify the mapping!</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">implicit</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> view </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> PartialDataView</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">supertype</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">Bar</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> Foo</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">b </span><span class="token keyword" style="color:#00009f">=&gt;</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Foo</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">b</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">x</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MyModule </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Foo</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> bar </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bar</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  bar</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">viewAs</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">Foo</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> foo </span><span class="token comment" style="color:#999988;font-style:italic">// bar.foo := foo.foo</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  bar</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">bar </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">123.</span><span class="token plain">U       </span><span class="token comment" style="color:#999988;font-style:italic">// all fields need to be connected</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">MyModule</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:203:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:203:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:203:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> foo_foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:204:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> bar_foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:205:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               bar_bar	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:205:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar_foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> foo_foo</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:203:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar_bar </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h7B</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:203:7, :207:11</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/chipsalliance/chisel/tree/main/docs/src/cookbooks/dataview.md" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_vwxv"></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/docs/cookbooks/hierarchy"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Hierarchy Cookbook</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/docs/cookbooks/serialization"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Serialization Cookbook</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#how-do-i-view-a-data-as-a-uint-or-vice-versa" class="table-of-contents__link toc-highlight">How do I view a Data as a UInt or vice versa?</a></li><li><a href="#how-do-i-create-a-dataview-for-a-bundle-has-a-type-parameter" class="table-of-contents__link toc-highlight">How do I create a DataView for a Bundle has a type parameter?</a></li><li><a href="#how-do-i-create-a-dataview-for-a-bundle-with-optional-fields" class="table-of-contents__link toc-highlight">How do I create a DataView for a Bundle with optional fields?</a></li><li><a href="#how-do-i-connect-a-subset-of-bundle-fields" class="table-of-contents__link toc-highlight">How do I connect a subset of Bundle fields?</a><ul><li><a href="#how-do-i-view-a-bundle-as-a-parent-type-superclass" class="table-of-contents__link toc-highlight">How do I view a Bundle as a parent type (superclass)?</a></li><li><a href="#how-do-i-view-a-bundle-as-a-parent-type-when-the-parent-type-is-abstract-like-a-trait" class="table-of-contents__link toc-highlight">How do I view a Bundle as a parent type when the parent type is abstract (like a trait)?</a></li><li><a href="#how-can-i-use-viewas-instead-of-viewassupertypetype" class="table-of-contents__link toc-highlight">How can I use <code>.viewAs</code> instead of <code>.viewAsSupertype(type)</code>?</a></li></ul></li></ul></div></div></div></div></main></div></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">Docs</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/docs">Docs</a></li><li class="footer__item"><a href="/api/latest" target="_blank" rel="noopener noreferrer" class="footer__link-item">ScalaDoc</a></li></ul></div><div class="col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://stackoverflow.com/questions/tagged/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">Stack Overflow<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://gitter.im/freechipsproject/chisel3" target="_blank" rel="noopener noreferrer" class="footer__link-item">Gitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://twitter.com/chisel_lang" target="_blank" rel="noopener noreferrer" class="footer__link-item">Twitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">More</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://github.com/chipsalliance/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2024 ChipsAlliance. Built with Docusaurus.</div></div></div></footer></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">MyModule</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:203:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:203:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:203:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> foo_foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:204:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> bar_foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:205:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               bar_bar	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:205:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar_foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> foo_foo</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:203:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar_bar </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h7B</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:203:7, :207:11</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_MyModule_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_MyModule_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_MyModule_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_MyModule_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/chipsalliance/chisel/tree/main/docs/src/cookbooks/dataview.md" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_vwxv"></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/docs/cookbooks/hierarchy"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Hierarchy Cookbook</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/docs/cookbooks/serialization"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Serialization Cookbook</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#how-do-i-view-a-data-as-a-uint-or-vice-versa" class="table-of-contents__link toc-highlight">How do I view a Data as a UInt or vice versa?</a></li><li><a href="#how-do-i-create-a-dataview-for-a-bundle-has-a-type-parameter" class="table-of-contents__link toc-highlight">How do I create a DataView for a Bundle has a type parameter?</a></li><li><a href="#how-do-i-create-a-dataview-for-a-bundle-with-optional-fields" class="table-of-contents__link toc-highlight">How do I create a DataView for a Bundle with optional fields?</a></li><li><a href="#how-do-i-connect-a-subset-of-bundle-fields" class="table-of-contents__link toc-highlight">How do I connect a subset of Bundle fields?</a><ul><li><a href="#how-do-i-view-a-bundle-as-a-parent-type-superclass" class="table-of-contents__link toc-highlight">How do I view a Bundle as a parent type (superclass)?</a></li><li><a href="#how-do-i-view-a-bundle-as-a-parent-type-when-the-parent-type-is-abstract-like-a-trait" class="table-of-contents__link toc-highlight">How do I view a Bundle as a parent type when the parent type is abstract (like a trait)?</a></li><li><a href="#how-can-i-use-viewas-instead-of-viewassupertypetype" class="table-of-contents__link toc-highlight">How can I use <code>.viewAs</code> instead of <code>.viewAsSupertype(type)</code>?</a></li></ul></li></ul></div></div></div></div></main></div></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">Docs</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/docs">Docs</a></li><li class="footer__item"><a href="/api/latest" target="_blank" rel="noopener noreferrer" class="footer__link-item">ScalaDoc</a></li></ul></div><div class="col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://stackoverflow.com/questions/tagged/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">Stack Overflow<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://gitter.im/freechipsproject/chisel3" target="_blank" rel="noopener noreferrer" class="footer__link-item">Gitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://twitter.com/chisel_lang" target="_blank" rel="noopener noreferrer" class="footer__link-item">Twitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">More</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://github.com/chipsalliance/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2024 ChipsAlliance. Built with Docusaurus.</div></div></div></footer></div>
 </body>
 </html>
\ No newline at end of file
diff --git a/docs/cookbooks/hierarchy.html b/docs/cookbooks/hierarchy.html
index 86e2bd2b89..4bb2b73069 100644
--- a/docs/cookbooks/hierarchy.html
+++ b/docs/cookbooks/hierarchy.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Hierarchy Cookbook | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/cookbooks/hierarchy"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Hierarchy Cookbook | Chisel"><meta data-rh="true" name="description" content="How do I instantiate multiple instances with the same module parameterization?"><meta data-rh="true" property="og:description" content="How do I instantiate multiple instances with the same module parameterization?"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/cookbooks/hierarchy"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/cookbooks/hierarchy" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/cookbooks/hierarchy" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
@@ -31,12 +31,12 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="using-definition-and-instance
 <p>In the following example, use <code>Definition</code>, <code>Instance</code>, <code>@instantiable</code> and <code>@public</code> to create
 multiple instances of one specific parameterization of a module, <code>AddOne</code>.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">hierarchy</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">Definition</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> Instance</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> instantiable</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> public</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token annotation punctuation" style="color:#393A34">@instantiable</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> AddOne</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">Int</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token annotation punctuation" style="color:#393A34">@public</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in  </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token annotation punctuation" style="color:#393A34">@public</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> AddTwo</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">Int</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in  </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> addOneDef </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Definition</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> AddOne</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> i0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Instance</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">addOneDef</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> i1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Instance</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">addOneDef</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  i0</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  i1</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> i0</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out   </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> i1</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">AddOne</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:14:2</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:16:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:17:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">10&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:14:2, :18:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">AddTwo</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:22:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:22:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:22:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:23:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:24:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> _i0_out</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:26:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  AddOne i0 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:26:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in  </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_i0_out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:26:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  AddOne i1 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:27:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in  </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_i0_out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:26:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:27:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">AddOne</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:14:2</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:16:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:17:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">10&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:14:2, :18:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">AddTwo</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:22:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:22:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:22:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:23:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:24:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> _i0_out</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:26:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  AddOne i0 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:26:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in  </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_i0_out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:26:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  AddOne i1 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:27:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in  </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_i0_out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:26:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:27:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_AddTwo_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_AddTwo_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AddTwo_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AddTwo_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AddTwo_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_AddTwo_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_AddTwo_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AddTwo_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AddTwo_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AddTwo_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_AddTwo_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_AddTwo_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AddTwo_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AddTwo_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AddTwo_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_AddTwo_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AddTwo_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AddTwo_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AddTwo_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="using-instantiate">Using Instantiate<a href="#using-instantiate" class="hash-link" aria-label="Direct link to Using Instantiate" title="Direct link to Using Instantiate">​</a></h3>
 <p>Similar to the above, the following example uses <code>Instantiate</code> to create
 multiple instances of <code>AddOne</code>.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">hierarchy</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">Instantiate</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> AddTwoInstantiate</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">Int</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in  </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> i0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Instantiate</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> AddOne</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> i1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Instantiate</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> AddOne</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  i0</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  i1</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> i0</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out   </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> i1</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">AddOne</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:14:2</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">15</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:16:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">15</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:17:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">16&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:14:2, :18:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">AddTwoInstantiate</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:46:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:46:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">                reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:46:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">15</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:47:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">15</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:48:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">15</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> _i0_out</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:49:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  AddOne i0 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:49:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in  </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_i0_out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:49:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  AddOne i1 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:50:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in  </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_i0_out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:49:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:50:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">AddOne</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:14:2</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">15</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:16:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">15</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:17:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">16&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:14:2, :18:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">AddTwoInstantiate</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:46:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:46:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">                reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:46:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">15</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:47:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">15</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:48:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">15</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> _i0_out</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:49:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  AddOne i0 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:49:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in  </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_i0_out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:49:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  AddOne i1 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:50:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in  </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_i0_out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:49:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:50:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_AddTwoInstantiate_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_AddTwoInstantiate_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AddTwoInstantiate_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AddTwoInstantiate_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AddTwoInstantiate_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_AddTwoInstantiate_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_AddTwoInstantiate_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AddTwoInstantiate_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AddTwoInstantiate_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AddTwoInstantiate_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_AddTwoInstantiate_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_AddTwoInstantiate_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AddTwoInstantiate_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AddTwoInstantiate_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AddTwoInstantiate_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_AddTwoInstantiate_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AddTwoInstantiate_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AddTwoInstantiate_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AddTwoInstantiate_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h2 class="anchor anchorWithStickyNavbar_LWe7" id="how-do-i-access-internal-fields-of-an-instance">How do I access internal fields of an instance?<a href="#how-do-i-access-internal-fields-of-an-instance" class="hash-link" aria-label="Direct link to How do I access internal fields of an instance?" title="Direct link to How do I access internal fields of an instance?">​</a></h2>
 <p>You can mark internal members of a class or trait marked with <code>@instantiable</code> with the <code>@public</code> annotation.
 The requirements are that the field is publicly accessible, is a <code>val</code> or <code>lazy val</code>, and is a valid type.
@@ -66,12 +66,12 @@ <h2 class="anchor anchorWithStickyNavbar_LWe7" id="how-do-i-make-my-parameters-a
 you are careful about what you mark as <code>IsLookupable</code>.</p>
 <p>In the following example, we added the trait <code>IsLookupable</code> to allow the member to be marked <code>@public</code>.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">hierarchy</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">Definition</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> Instance</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> instantiable</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> IsLookupable</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> public</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">case</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MyCaseClass</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">Int</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> IsLookupable</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token annotation punctuation" style="color:#393A34">@instantiable</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MyModule </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token annotation punctuation" style="color:#393A34">@public</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> x </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> MyCaseClass</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">10</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Top </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> inst </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Instance</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Definition</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyModule</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  println</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string-interpolation id function" style="color:#d73a49">s</span><span class="token string-interpolation string" style="color:#e3116c">&quot;Width is </span><span class="token string-interpolation interpolation punctuation" style="color:#393A34">${</span><span class="token string-interpolation interpolation expression">inst</span><span class="token string-interpolation interpolation expression punctuation" style="color:#393A34">.</span><span class="token string-interpolation interpolation expression">x</span><span class="token string-interpolation interpolation expression punctuation" style="color:#393A34">.</span><span class="token string-interpolation interpolation expression">width</span><span class="token string-interpolation interpolation punctuation" style="color:#393A34">}</span><span class="token string-interpolation string" style="color:#e3116c">&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">Width is 10</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">Circuit(Top,List(DefModule(repl.MdocSession$MdocApp5$MyModule@47eac141,MyModule,false,List(),List(Port(MyModule.clock: IO[Clock],Input,SourceLine(hierarchy.md,105,2)), Port(MyModule.reset: IO[Reset],Input,SourceLine(hierarchy.md,105,2))),Vector()), DefModule(repl.MdocSession$MdocApp5$Top@1fddaa2a,Top,true,List(),List(Port(Top.clock: IO[Clock],Input,SourceLine(hierarchy.md,111,7)), Port(Top.reset: IO[Bool],Input,SourceLine(hierarchy.md,111,7))),Vector(DefInstance(SourceLine(hierarchy.md,112,22),ModuleClone(repl.MdocSession$MdocApp5$MyModule@47eac141),List(Port(MyModule.clock: IO[Clock],Input,SourceLine(hierarchy.md,105,2)), Port(MyModule.reset: IO[Reset],Input,SourceLine(hierarchy.md,105,2)))), Connect(SourceLine(hierarchy.md,112,22),Node(MyModule.inst.clock: IO[Clock]),Node(Top.clock: IO[Clock])), Connect(SourceLine(hierarchy.md,112,22),Node(MyModule.inst.reset: IO[Reset]),Node(Top.reset: IO[Bool]))))),List(),firrtl.renamemap.package$MutableRenameMap@79862851,List(),List(),List(),List())</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">Width is 10</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">Circuit(Top,List(DefModule(repl.MdocSession$MdocApp5$MyModule@5b6d1953,MyModule,false,List(),List(Port(MyModule.clock: IO[Clock],Input,SourceLine(hierarchy.md,105,2)), Port(MyModule.reset: IO[Reset],Input,SourceLine(hierarchy.md,105,2))),Vector()), DefModule(repl.MdocSession$MdocApp5$Top@7590e65b,Top,true,List(),List(Port(Top.clock: IO[Clock],Input,SourceLine(hierarchy.md,111,7)), Port(Top.reset: IO[Bool],Input,SourceLine(hierarchy.md,111,7))),Vector(DefInstance(SourceLine(hierarchy.md,112,22),ModuleClone(repl.MdocSession$MdocApp5$MyModule@5b6d1953),List(Port(MyModule.clock: IO[Clock],Input,SourceLine(hierarchy.md,105,2)), Port(MyModule.reset: IO[Reset],Input,SourceLine(hierarchy.md,105,2)))), Connect(SourceLine(hierarchy.md,112,22),Node(MyModule.inst.clock: IO[Clock]),Node(Top.clock: IO[Clock])), Connect(SourceLine(hierarchy.md,112,22),Node(MyModule.inst.reset: IO[Reset]),Node(Top.reset: IO[Bool]))))),List(),firrtl.renamemap.package$MutableRenameMap@207b07c1,List(),List(),List(Layer(UnlocatableSourceInfo,Verification,Extract(Some(Verification)),List(Layer(UnlocatableSourceInfo,Assert,Extract(Some(Verification/Assert)),List()), Layer(UnlocatableSourceInfo,Assume,Extract(Some(Verification/Assume)),List()), Layer(UnlocatableSourceInfo,Cover,Extract(Some(Verification/Cover)),List())))),List())</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h2 class="anchor anchorWithStickyNavbar_LWe7" id="how-do-i-look-up-parameters-from-a-definition-if-i-dont-want-to-instantiate-it">How do I look up parameters from a Definition, if I don&#x27;t want to instantiate it?<a href="#how-do-i-look-up-parameters-from-a-definition-if-i-dont-want-to-instantiate-it" class="hash-link" aria-label="Direct link to How do I look up parameters from a Definition, if I don&#x27;t want to instantiate it?" title="Direct link to How do I look up parameters from a Definition, if I don&#x27;t want to instantiate it?">​</a></h2>
 <p>Just like <code>Instance</code>s, <code>Definition</code>&#x27;s also contain accessors for <code>@public</code> members.
 As such, you can directly access them:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">hierarchy</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">Definition</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> instantiable</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> public</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token annotation punctuation" style="color:#393A34">@instantiable</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> AddOne</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> width</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">Int</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token annotation punctuation" style="color:#393A34">@public</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> width </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> width</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token annotation punctuation" style="color:#393A34">@public</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in  </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token annotation punctuation" style="color:#393A34">@public</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Top </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> definition </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Definition</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> AddOne</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">10</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  println</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string-interpolation id function" style="color:#d73a49">s</span><span class="token string-interpolation string" style="color:#e3116c">&quot;Width is: </span><span class="token string-interpolation interpolation punctuation" style="color:#393A34">${</span><span class="token string-interpolation interpolation expression">definition</span><span class="token string-interpolation interpolation expression punctuation" style="color:#393A34">.</span><span class="token string-interpolation interpolation expression">width</span><span class="token string-interpolation interpolation punctuation" style="color:#393A34">}</span><span class="token string-interpolation string" style="color:#e3116c">&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Top</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:157:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:157:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        reset	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:157:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Top</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:157:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:157:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        reset	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:157:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Top_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Top_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Top_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Top_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Top_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Top_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Top_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Top_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Top_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Top_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Top_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Top_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Top_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Top_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Top_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Top_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Top_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Top_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Top_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h2 class="anchor anchorWithStickyNavbar_LWe7" id="how-do-i-parameterize-a-module-by-its-children-instances">How do I parameterize a module by its children instances?<a href="#how-do-i-parameterize-a-module-by-its-children-instances" class="hash-link" aria-label="Direct link to How do I parameterize a module by its children instances?" title="Direct link to How do I parameterize a module by its children instances?">​</a></h2>
 <p>Prior to the introduction of this package, a parent module would have to pass all necessary parameters
 when instantiating a child module.
@@ -83,7 +83,7 @@ <h2 class="anchor anchorWithStickyNavbar_LWe7" id="how-do-i-parameterize-a-modul
 <p>In the following example, we create a definition of <code>AddOne</code>, and pass the definition to <code>AddTwo</code>.
 The width of the <code>AddTwo</code> ports are now derived from the parameterization of the <code>AddOne</code> instance.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">hierarchy</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">Definition</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> Instance</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> instantiable</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> public</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token annotation punctuation" style="color:#393A34">@instantiable</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> AddOne</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> width</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">Int</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token annotation punctuation" style="color:#393A34">@public</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> width </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> width</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token annotation punctuation" style="color:#393A34">@public</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in  </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token annotation punctuation" style="color:#393A34">@public</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> AddTwo</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">addOneDef</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> Definition</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">AddOne</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> i0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Instance</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">addOneDef</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> i1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Instance</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">addOneDef</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in  </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">addOneDef</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">width</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">addOneDef</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">width</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  i0</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  i1</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> i0</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out   </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> i1</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">AddOne</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:181:2</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:184:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:185:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">10&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:181:2, :186:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">AddTwo</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:190:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:190:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:190:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:193:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:194:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> _i0_out</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:191:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  AddOne i0 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:191:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in  </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_i0_out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:191:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  AddOne i1 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:192:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in  </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_i0_out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:191:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:192:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">AddOne</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:181:2</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:184:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:185:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">10&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:181:2, :186:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">AddTwo</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:190:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:190:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:190:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:193:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:194:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> _i0_out</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:191:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  AddOne i0 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:191:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in  </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_i0_out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:191:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  AddOne i1 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:192:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in  </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_i0_out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:191:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// hierarchy.md:192:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_AddTwo_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_AddTwo_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AddTwo_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AddTwo_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AddTwo_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_AddTwo_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_AddTwo_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AddTwo_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AddTwo_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AddTwo_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_AddTwo_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_AddTwo_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AddTwo_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AddTwo_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AddTwo_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_AddTwo_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AddTwo_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AddTwo_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AddTwo_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h2 class="anchor anchorWithStickyNavbar_LWe7" id="how-do-i-use-the-new-hierarchy-specific-select-functions">How do I use the new hierarchy-specific Select functions?<a href="#how-do-i-use-the-new-hierarchy-specific-select-functions" class="hash-link" aria-label="Direct link to How do I use the new hierarchy-specific Select functions?" title="Direct link to How do I use the new hierarchy-specific Select functions?">​</a></h2>
 <p>Select functions can be applied after a module has been elaborated, either in a Chisel Aspect or in a parent module applied to a child module.</p>
 <p>There are seven hierarchy-specific functions, which (with the exception of <code>ios</code>) either return <code>Instance</code>&#x27;s or <code>Definition</code>&#x27;s:</p>
diff --git a/docs/cookbooks/naming.html b/docs/cookbooks/naming.html
index 079ae386b6..c35479749f 100644
--- a/docs/cookbooks/naming.html
+++ b/docs/cookbooks/naming.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Naming Cookbook | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/cookbooks/naming"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Naming Cookbook | Chisel"><meta data-rh="true" name="description" content="I still have _T signals, can this be fixed?"><meta data-rh="true" property="og:description" content="I still have _T signals, can this be fixed?"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/cookbooks/naming"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/cookbooks/naming" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/cookbooks/naming" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
@@ -22,11 +22,11 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="i-have-so-many-wires-with-the
 intermediate signals and can&#x27;t name them at all or has to make up a unique name for them.</p>
 <p>We recommend you manually insert calls to <code>prefix</code> to clarify these cases:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">prefix</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> ExamplePrefix </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  Seq</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">tabulate</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> i </span><span class="token keyword" style="color:#00009f">=&gt;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    Seq</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">tabulate</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> j </span><span class="token keyword" style="color:#00009f">=&gt;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      prefix</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string-interpolation id function" style="color:#d73a49">s</span><span class="token string-interpolation string" style="color:#e3116c">&quot;loop_</span><span class="token string-interpolation interpolation punctuation" style="color:#393A34">${</span><span class="token string-interpolation interpolation expression">i</span><span class="token string-interpolation interpolation punctuation" style="color:#393A34">}</span><span class="token string-interpolation string" style="color:#e3116c">_</span><span class="token string-interpolation interpolation punctuation" style="color:#393A34">${</span><span class="token string-interpolation interpolation expression">j</span><span class="token string-interpolation interpolation punctuation" style="color:#393A34">}</span><span class="token string-interpolation string" style="color:#e3116c">&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> x </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> WireInit</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">i</span><span class="token operator" style="color:#393A34">*</span><span class="token number" style="color:#36acaa">0x10</span><span class="token operator" style="color:#393A34">+</span><span class="token plain">j</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        dontTouch</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">x</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">ExamplePrefix</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        reset</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> loop_0_0_x </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> loop_0_1_x </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> loop_1_0_x </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h10</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> loop_1_1_x </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h11</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">ExamplePrefix</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        reset</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> loop_0_0_x </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> loop_0_1_x </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> loop_1_0_x </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h10</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> loop_1_1_x </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8&#x27;h11</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_ExamplePrefix_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_ExamplePrefix_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ExamplePrefix_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ExamplePrefix_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ExamplePrefix_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_ExamplePrefix_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_ExamplePrefix_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ExamplePrefix_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ExamplePrefix_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ExamplePrefix_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_ExamplePrefix_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_ExamplePrefix_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ExamplePrefix_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ExamplePrefix_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ExamplePrefix_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_ExamplePrefix_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ExamplePrefix_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ExamplePrefix_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ExamplePrefix_Verification</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="how-can-i-get-better-names-for-code-generated-by-when-clauses">How can I get better names for code generated by <code>when</code> clauses?<a href="#how-can-i-get-better-names-for-code-generated-by-when-clauses" class="hash-link" aria-label="Direct link to how-can-i-get-better-names-for-code-generated-by-when-clauses" title="Direct link to how-can-i-get-better-names-for-code-generated-by-when-clauses">​</a></h3>
 <p>The <code>prefix</code> API can help with code inside <code>when</code> clauses:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> ExampleWhenPrefix </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DontCare</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  Seq</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">tabulate</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> i </span><span class="token keyword" style="color:#00009f">=&gt;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> j </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> i </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    prefix</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string-interpolation id function" style="color:#d73a49">s</span><span class="token string-interpolation string" style="color:#e3116c">&quot;clause_</span><span class="token string-interpolation interpolation punctuation" style="color:#393A34">${</span><span class="token string-interpolation interpolation expression">j</span><span class="token string-interpolation interpolation punctuation" style="color:#393A34">}</span><span class="token string-interpolation string" style="color:#e3116c">&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      when </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in </span><span class="token operator" style="color:#393A34">==</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> j</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Reg</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        foo </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> j</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> foo</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">ExampleWhenPrefix</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> clause_1_foo</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> clause_2_foo</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">begin</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    clause_1_foo </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    clause_2_foo </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h2</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">end</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// always @(posedge)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">==</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h2</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">?</span><span class="token plain"> clause_2_foo </span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> clause_1_foo</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">ExampleWhenPrefix</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> clause_1_foo</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> clause_2_foo</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">begin</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    clause_1_foo </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    clause_2_foo </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h2</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">end</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// always @(posedge)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">==</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h2</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">?</span><span class="token plain"> clause_2_foo </span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> clause_1_foo</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_ExampleWhenPrefix_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_ExampleWhenPrefix_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ExampleWhenPrefix_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ExampleWhenPrefix_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ExampleWhenPrefix_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_ExampleWhenPrefix_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_ExampleWhenPrefix_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ExampleWhenPrefix_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ExampleWhenPrefix_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ExampleWhenPrefix_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_ExampleWhenPrefix_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_ExampleWhenPrefix_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ExampleWhenPrefix_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ExampleWhenPrefix_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ExampleWhenPrefix_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_ExampleWhenPrefix_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ExampleWhenPrefix_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ExampleWhenPrefix_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ExampleWhenPrefix_Verification</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="i-still-see-_gen-signals-can-this-be-fixed">I still see _GEN signals, can this be fixed?<a href="#i-still-see-_gen-signals-can-this-be-fixed" class="hash-link" aria-label="Direct link to I still see _GEN signals, can this be fixed?" title="Direct link to I still see _GEN signals, can this be fixed?">​</a></h3>
 <p><code>_GEN</code> signals are usually generated from the FIRRTL compiler, rather than the Chisel library. We are working on
 renaming these signals with more context-dependent names, but it is a work in progress. Thanks for caring!</p>
@@ -61,18 +61,18 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="can-i-name-my-bundles-in-firr
 <p>These can be automatically emitted from Chisel by mixing <code>HasTypeAlias</code> into a user-defined <code>Record</code>, and implementing a field named <code>aliasName</code> with a <code>RecordAlias(...)</code> instance.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">HasTypeAlias</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> RecordAlias</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> AliasedBundle </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token keyword" style="color:#00009f">with</span><span class="token plain"> HasTypeAlias </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">override</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">def</span><span class="token plain"> aliasName </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> RecordAlias</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;MyAliasedBundle&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> bar </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Let&#x27;s see what happens when we generate FIRRTL using this <code>Bundle</code>:</p>
-<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">emitFIRRTL</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> wire </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Wire</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> AliasedBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res10: String = &quot;&quot;&quot;FIRRTL version 4.0.0</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// circuit _18_Anon :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   type MyAliasedBundle = { foo : UInt&lt;8&gt;, bar : UInt&lt;1&gt;}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   public module _18_Anon : @[naming.md 252:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input clock : Clock @[naming.md 252:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input reset : UInt&lt;1&gt; @[naming.md 252:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     wire wire : MyAliasedBundle @[naming.md 253:18]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// &quot;&quot;&quot;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">emitFIRRTL</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> wire </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Wire</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> AliasedBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res10: String = &quot;&quot;&quot;FIRRTL version 4.0.0</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// circuit _18_Anon :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   type MyAliasedBundle = { foo : UInt&lt;8&gt;, bar : UInt&lt;1&gt;}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   layer Verification, bind, &quot;Verification&quot; :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     layer Assert, bind, &quot;Verification/Assert&quot; :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     layer Assume, bind, &quot;Verification/Assume&quot; :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     layer Cover, bind, &quot;Verification/Cover&quot; :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   public module _18_Anon : @[naming.md 252:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input clock : Clock @[naming.md 252:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input reset : UInt&lt;1&gt; @[naming.md 252:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     wire wire : MyAliasedBundle @[naming.md 253:18]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// &quot;&quot;&quot;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p><code>HasTypeAlias</code> also supports nested bundles, too:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Child </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token keyword" style="color:#00009f">with</span><span class="token plain"> HasTypeAlias </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">override</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">def</span><span class="token plain"> aliasName </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> RecordAlias</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;ChildBundle&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> x </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Parent </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token keyword" style="color:#00009f">with</span><span class="token plain"> HasTypeAlias </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">override</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">def</span><span class="token plain"> aliasName </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> RecordAlias</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;ParentBundle&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> child </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Child</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">emitFIRRTL</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> wire </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Wire</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Parent</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res11: String = &quot;&quot;&quot;FIRRTL version 4.0.0</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// circuit _22_Anon :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   type ChildBundle = { x : UInt&lt;8&gt;}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   type ParentBundle = { child : ChildBundle}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   public module _22_Anon : @[naming.md 275:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input clock : Clock @[naming.md 275:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input reset : UInt&lt;1&gt; @[naming.md 275:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     wire wire : ParentBundle @[naming.md 276:18]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// &quot;&quot;&quot;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">emitFIRRTL</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> wire </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Wire</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Parent</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res11: String = &quot;&quot;&quot;FIRRTL version 4.0.0</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// circuit _22_Anon :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   type ChildBundle = { x : UInt&lt;8&gt;}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   type ParentBundle = { child : ChildBundle}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   layer Verification, bind, &quot;Verification&quot; :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     layer Assert, bind, &quot;Verification/Assert&quot; :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     layer Assume, bind, &quot;Verification/Assume&quot; :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     layer Cover, bind, &quot;Verification/Cover&quot; :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   public module _22_Anon : @[naming.md 275:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input clock : Clock @[naming.md 275:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input reset : UInt&lt;1&gt; @[naming.md 275:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     wire wire : ParentBundle @[naming.md 276:18]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// &quot;&quot;&quot;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="why-do-i-keep-seeing-_stripped-suffixing-everywhere-in-my-firrtl-i-didnt-specify-that-in-my-aliasname">Why do I keep seeing _stripped suffixing everywhere in my FIRRTL? I didn&#x27;t specify that in my <code>aliasName</code>.<a href="#why-do-i-keep-seeing-_stripped-suffixing-everywhere-in-my-firrtl-i-didnt-specify-that-in-my-aliasname" class="hash-link" aria-label="Direct link to why-do-i-keep-seeing-_stripped-suffixing-everywhere-in-my-firrtl-i-didnt-specify-that-in-my-aliasname" title="Direct link to why-do-i-keep-seeing-_stripped-suffixing-everywhere-in-my-firrtl-i-didnt-specify-that-in-my-aliasname">​</a></h3>
 <p>You&#x27;re using an <code>Input(...)</code> or <code>Output(...)</code> in conjunction with an aliased <code>Record</code> that contains a <code>Flipped(...)</code>. These flipped values are stripped by <code>Input</code> and <code>Output</code> which fundamentally changes the type of the parent <code>Record</code>:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> StrippedBundle </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token keyword" style="color:#00009f">with</span><span class="token plain"> HasTypeAlias </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">override</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">def</span><span class="token plain"> aliasName </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> RecordAlias</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;StrippedBundle&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> flipped </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> normal </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">emitFIRRTL</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> StrippedBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res12: String = &quot;&quot;&quot;FIRRTL version 4.0.0</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// circuit _26_Anon :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   type StrippedBundle_stripped = { flipped : UInt&lt;8&gt;, normal : UInt&lt;8&gt;}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   public module _26_Anon : @[naming.md 293:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input clock : Clock @[naming.md 293:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input reset : UInt&lt;1&gt; @[naming.md 293:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input in : StrippedBundle_stripped @[naming.md 294:14]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     skip</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// &quot;&quot;&quot;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">emitFIRRTL</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> StrippedBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res12: String = &quot;&quot;&quot;FIRRTL version 4.0.0</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// circuit _26_Anon :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   type StrippedBundle_stripped = { flipped : UInt&lt;8&gt;, normal : UInt&lt;8&gt;}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   layer Verification, bind, &quot;Verification&quot; :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     layer Assert, bind, &quot;Verification/Assert&quot; :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     layer Assume, bind, &quot;Verification/Assume&quot; :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     layer Cover, bind, &quot;Verification/Cover&quot; :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   public module _26_Anon : @[naming.md 293:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input clock : Clock @[naming.md 293:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input reset : UInt&lt;1&gt; @[naming.md 293:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input in : StrippedBundle_stripped @[naming.md 294:14]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     skip</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// &quot;&quot;&quot;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Note how the bundle type doesn&#x27;t contain a <code>flip flipped : UInt&lt;8&gt;</code> field, and the alias gains a <code>&quot;_stripped&quot;</code> suffix! This <code>Bundle</code> type is no longer the same as the one we wrote in Chisel, so we have to distinguish it as such.</p>
 <p>By default, the suffix appended to <code>Record</code> names is <code>&quot;_stripped&quot;</code>. This can be defined by users with an additional string argument passed to <code>RecordAlias(alias, strippedSuffix)</code>:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> CustomStrippedBundle </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token keyword" style="color:#00009f">with</span><span class="token plain"> HasTypeAlias </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">override</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">def</span><span class="token plain"> aliasName </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> RecordAlias</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;StrippedBundle&quot;</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Foo&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> flipped </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> normal </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">emitFIRRTL</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> CustomStrippedBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res13: String = &quot;&quot;&quot;FIRRTL version 4.0.0</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// circuit _30_Anon :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   type StrippedBundleFoo = { flipped : UInt&lt;8&gt;, normal : UInt&lt;8&gt;}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   public module _30_Anon : @[naming.md 311:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input clock : Clock @[naming.md 311:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input reset : UInt&lt;1&gt; @[naming.md 311:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input in : StrippedBundleFoo @[naming.md 312:14]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     skip</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// &quot;&quot;&quot;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">emitFIRRTL</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> CustomStrippedBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res13: String = &quot;&quot;&quot;FIRRTL version 4.0.0</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// circuit _30_Anon :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   type StrippedBundleFoo = { flipped : UInt&lt;8&gt;, normal : UInt&lt;8&gt;}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   layer Verification, bind, &quot;Verification&quot; :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     layer Assert, bind, &quot;Verification/Assert&quot; :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     layer Assume, bind, &quot;Verification/Assume&quot; :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     layer Cover, bind, &quot;Verification/Cover&quot; :</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   public module _30_Anon : @[naming.md 311:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input clock : Clock @[naming.md 311:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input reset : UInt&lt;1&gt; @[naming.md 311:28]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     input in : StrippedBundleFoo @[naming.md 312:14]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     skip</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// &quot;&quot;&quot;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="i-want-to-add-some-hardware-or-assertions-but-each-time-i-do-all-the-signal-names-get-bumped">I want to add some hardware or assertions, but each time I do all the signal names get bumped!<a href="#i-want-to-add-some-hardware-or-assertions-but-each-time-i-do-all-the-signal-names-get-bumped" class="hash-link" aria-label="Direct link to I want to add some hardware or assertions, but each time I do all the signal names get bumped!" title="Direct link to I want to add some hardware or assertions, but each time I do all the signal names get bumped!">​</a></h3>
 <p>This is the classic &quot;ECO&quot; problem, and we provide descriptions in <a href="/docs/explanations/naming">explanation</a>. In short,
 we recommend wrapping all additional logic in a prefix scope, which enables a unique namespace. This should prevent
@@ -82,11 +82,11 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="i-want-to-force-a-signal-or-i
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="how-can-i-omit-the-prefix-in-certain-parts-of-the-code">How can I omit the prefix in certain parts of the code?<a href="#how-can-i-omit-the-prefix-in-certain-parts-of-the-code" class="hash-link" aria-label="Direct link to How can I omit the prefix in certain parts of the code?" title="Direct link to How can I omit the prefix in certain parts of the code?">​</a></h3>
 <p>You can use the <code>noPrefix { ... }</code> to strip the prefix from all signals generated in that scope.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">noPrefix</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> ExampleNoPrefix </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">5.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> add </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> noPrefix </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// foo will not get a prefix</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> RegNext</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    foo </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> in</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> add</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">ExampleNoPrefix</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">4</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> foo</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    foo </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">3&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> in</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">ExampleNoPrefix</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">4</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> foo</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    foo </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">3&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> in</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_ExampleNoPrefix_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_ExampleNoPrefix_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ExampleNoPrefix_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ExampleNoPrefix_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ExampleNoPrefix_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_ExampleNoPrefix_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_ExampleNoPrefix_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ExampleNoPrefix_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ExampleNoPrefix_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ExampleNoPrefix_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_ExampleNoPrefix_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_ExampleNoPrefix_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ExampleNoPrefix_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ExampleNoPrefix_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ExampleNoPrefix_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_ExampleNoPrefix_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ExampleNoPrefix_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ExampleNoPrefix_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ExampleNoPrefix_Verification</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="i-am-still-not-getting-the-name-i-want-for-example-inlining-an-instance-changes-my-name">I am still not getting the name I want. For example, inlining an instance changes my name!<a href="#i-am-still-not-getting-the-name-i-want-for-example-inlining-an-instance-changes-my-name" class="hash-link" aria-label="Direct link to I am still not getting the name I want. For example, inlining an instance changes my name!" title="Direct link to I am still not getting the name I want. For example, inlining an instance changes my name!">​</a></h3>
 <p>In cases where a FIRRTL transform renames a signal/instance, you can use the <code>forcename</code> API:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">util</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">forceName</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> InlineInstance</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> WrapperExample </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">3.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">3.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> inst </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Wrapper</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  inst</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> inst</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Wrapper </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token keyword" style="color:#00009f">with</span><span class="token plain"> InlineInstance </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">3.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">3.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> inst </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyLeaf</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  forceName</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">inst</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;inst&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  inst</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> inst</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MyLeaf </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">3.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">3.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">MyLeaf</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">WrapperExample</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  MyLeaf inst </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in  </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">MyLeaf</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">WrapperExample</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  MyLeaf inst </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in  </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_WrapperExample_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_WrapperExample_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_WrapperExample_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_WrapperExample_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_WrapperExample_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_WrapperExample_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_WrapperExample_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_WrapperExample_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_WrapperExample_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_WrapperExample_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_WrapperExample_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_WrapperExample_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_WrapperExample_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_WrapperExample_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_WrapperExample_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_WrapperExample_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_WrapperExample_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_WrapperExample_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_WrapperExample_Verification</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This can be used to rename instances and non-aggregate typed signals.</p></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/chipsalliance/chisel/tree/main/docs/src/cookbooks/naming.md" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_vwxv"></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/docs/cookbooks/cookbook"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">General Cookbook</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/docs/cookbooks/hierarchy"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Hierarchy Cookbook</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#i-still-have-_t-signals-can-this-be-fixed" class="table-of-contents__link toc-highlight">I still have _T signals, can this be fixed?</a></li><li><a href="#i-have-so-many-wires-with-the-same-name-like-x-x_1-and-x_2-how-can-i-make-them-easier-to-understand" class="table-of-contents__link toc-highlight">I have so many wires with the same name, like <code>x</code>, <code>x_1</code> and <code>x_2</code>. How can I make them easier to understand?</a></li><li><a href="#how-can-i-get-better-names-for-code-generated-by-when-clauses" class="table-of-contents__link toc-highlight">How can I get better names for code generated by <code>when</code> clauses?</a></li><li><a href="#i-still-see-_gen-signals-can-this-be-fixed" class="table-of-contents__link toc-highlight">I still see _GEN signals, can this be fixed?</a></li><li><a href="#how-do-i-make-my-modules-have-more-stable-names-instead-of-module_1-and-module_42" class="table-of-contents__link toc-highlight">How do I make my modules have more stable names instead of &#39;Module_1&#39; and &#39;Module_42&#39;?</a></li><li><a href="#how-would-i-write-my-own-typename-for-my-data-types" class="table-of-contents__link toc-highlight">How would I write my own <code>typeName</code> for my data types?</a></li><li><a href="#i-dont-want-to-override-typename-over-and-over-is-there-any-easy-way-to-generate-a-typename" class="table-of-contents__link toc-highlight">I don&#39;t want to override <code>typeName</code> over and over! Is there any easy way to generate a <code>typeName</code>?</a></li><li><a href="#can-i-name-my-bundles-in-firrtl-so-i-dont-generate-extremely-long-bundle-types" class="table-of-contents__link toc-highlight">Can I name my bundles in FIRRTL, so I don&#39;t generate extremely long bundle types?</a></li><li><a href="#why-do-i-keep-seeing-_stripped-suffixing-everywhere-in-my-firrtl-i-didnt-specify-that-in-my-aliasname" class="table-of-contents__link toc-highlight">Why do I keep seeing _stripped suffixing everywhere in my FIRRTL? I didn&#39;t specify that in my <code>aliasName</code>.</a></li><li><a href="#i-want-to-add-some-hardware-or-assertions-but-each-time-i-do-all-the-signal-names-get-bumped" class="table-of-contents__link toc-highlight">I want to add some hardware or assertions, but each time I do all the signal names get bumped!</a></li><li><a href="#i-want-to-force-a-signal-or-instance-name-to-something-how-do-i-do-that" class="table-of-contents__link toc-highlight">I want to force a signal (or instance) name to something, how do I do that?</a></li><li><a href="#how-can-i-omit-the-prefix-in-certain-parts-of-the-code" class="table-of-contents__link toc-highlight">How can I omit the prefix in certain parts of the code?</a></li><li><a href="#i-am-still-not-getting-the-name-i-want-for-example-inlining-an-instance-changes-my-name" class="table-of-contents__link toc-highlight">I am still not getting the name I want. For example, inlining an instance changes my name!</a></li></ul></div></div></div></div></main></div></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">Docs</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/docs">Docs</a></li><li class="footer__item"><a href="/api/latest" target="_blank" rel="noopener noreferrer" class="footer__link-item">ScalaDoc</a></li></ul></div><div class="col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://stackoverflow.com/questions/tagged/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">Stack Overflow<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://gitter.im/freechipsproject/chisel3" target="_blank" rel="noopener noreferrer" class="footer__link-item">Gitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://twitter.com/chisel_lang" target="_blank" rel="noopener noreferrer" class="footer__link-item">Twitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">More</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://github.com/chipsalliance/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2024 ChipsAlliance. Built with Docusaurus.</div></div></div></footer></div>
 </body>
 </html>
\ No newline at end of file
diff --git a/docs/cookbooks/serialization.html b/docs/cookbooks/serialization.html
index 47a44b4cf4..c0c53d19f5 100644
--- a/docs/cookbooks/serialization.html
+++ b/docs/cookbooks/serialization.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Serialization Cookbook | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/cookbooks/serialization"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Serialization Cookbook | Chisel"><meta data-rh="true" name="description" content="Why do I need to serialize Modules"><meta data-rh="true" property="og:description" content="Why do I need to serialize Modules"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/cookbooks/serialization"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/cookbooks/serialization" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/cookbooks/serialization" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/cookbooks/troubleshooting.html b/docs/cookbooks/troubleshooting.html
index 7e1a853686..1a9dfe3f38 100644
--- a/docs/cookbooks/troubleshooting.html
+++ b/docs/cookbooks/troubleshooting.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Troubleshooting | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/cookbooks/troubleshooting"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Troubleshooting | Chisel"><meta data-rh="true" name="description" content="This page is a starting point for recording common and not so common problems in developing with Chisel3.  In particular, those situations where there is a work around that will keep you going."><meta data-rh="true" property="og:description" content="This page is a starting point for recording common and not so common problems in developing with Chisel3.  In particular, those situations where there is a work around that will keep you going."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/cookbooks/troubleshooting"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/cookbooks/troubleshooting" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/cookbooks/troubleshooting" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/developers.html b/docs/developers.html
index 061e7cfb10..de79d7d6b2 100644
--- a/docs/developers.html
+++ b/docs/developers.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Developer Documentation | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/developers"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Developer Documentation | Chisel"><meta data-rh="true" name="description" content="Tips and tricks for Chisel developers:"><meta data-rh="true" property="og:description" content="Tips and tricks for Chisel developers:"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/developers"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/developers" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/developers" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/developers/scaladoc.html b/docs/developers/scaladoc.html
index f8ca9a19ac..243e714b48 100644
--- a/docs/developers/scaladoc.html
+++ b/docs/developers/scaladoc.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Scaladoc | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/developers/scaladoc"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Scaladoc | Chisel"><meta data-rh="true" name="description" content="Scaladoc"><meta data-rh="true" property="og:description" content="Scaladoc"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/developers/scaladoc"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/developers/scaladoc" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/developers/scaladoc" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/developers/style.html b/docs/developers/style.html
index 331c4d7f18..890fddfc39 100644
--- a/docs/developers/style.html
+++ b/docs/developers/style.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Style Guide | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/developers/style"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Style Guide | Chisel"><meta data-rh="true" name="description" content="This document describes the syle used within the chisel3"><meta data-rh="true" property="og:description" content="This document describes the syle used within the chisel3"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/developers/style"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/developers/style" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/developers/style" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/developers/test-coverage.html b/docs/developers/test-coverage.html
index e5c7872adf..3ae0a69a3b 100644
--- a/docs/developers/test-coverage.html
+++ b/docs/developers/test-coverage.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Test Coverage | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/developers/test-coverage"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Test Coverage | Chisel"><meta data-rh="true" name="description" content="Test Coverage Setup"><meta data-rh="true" property="og:description" content="Test Coverage Setup"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/developers/test-coverage"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/developers/test-coverage" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/developers/test-coverage" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations.html b/docs/explanations.html
index 7899a854bd..a55093e17a 100644
--- a/docs/explanations.html
+++ b/docs/explanations.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Explanations | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Explanations | Chisel"><meta data-rh="true" name="description" content="Explanation documentation gives background and context."><meta data-rh="true" property="og:description" content="Explanation documentation gives background and context."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/annotations.html b/docs/explanations/annotations.html
index 1e3dd13c10..0e02145215 100644
--- a/docs/explanations/annotations.html
+++ b/docs/explanations/annotations.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Annotations | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/annotations"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Annotations | Chisel"><meta data-rh="true" name="description" content="Annotations are metadata containers associated with zero or more &quot;things&quot; in a FIRRTL circuit."><meta data-rh="true" property="og:description" content="Annotations are metadata containers associated with zero or more &quot;things&quot; in a FIRRTL circuit."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/annotations"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/annotations" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/annotations" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/blackboxes.html b/docs/explanations/blackboxes.html
index fac86f4715..b6ccc7b553 100644
--- a/docs/explanations/blackboxes.html
+++ b/docs/explanations/blackboxes.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Blackboxes | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/blackboxes"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Blackboxes | Chisel"><meta data-rh="true" name="description" content="Chisel BlackBoxes are used to instantiate externally defined modules. This construct is useful"><meta data-rh="true" property="og:description" content="Chisel BlackBoxes are used to instantiate externally defined modules. This construct is useful"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/blackboxes"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/blackboxes" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/blackboxes" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/bundles-and-vecs.html b/docs/explanations/bundles-and-vecs.html
index 419f5df4f7..27b27c926e 100644
--- a/docs/explanations/bundles-and-vecs.html
+++ b/docs/explanations/bundles-and-vecs.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Bundles and Vecs | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/bundles-and-vecs"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Bundles and Vecs | Chisel"><meta data-rh="true" name="description" content="Bundle and Vec are classes that allow the user to expand the set of Chisel datatypes with aggregates of other types."><meta data-rh="true" property="og:description" content="Bundle and Vec are classes that allow the user to expand the set of Chisel datatypes with aggregates of other types."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/bundles-and-vecs"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/bundles-and-vecs" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/bundles-and-vecs" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
@@ -35,7 +35,7 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="flipping-bundles">Flipping Bu
 <p>The <code>Flipped()</code> function recursively flips all elements in a Bundle/Record. This is very useful for building bidirectional interfaces that connect to each other (e.g. <code>Decoupled</code>). See below for an example.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> ABBundle </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MyFlippedModule </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// Normal instantiation of the bundle</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// &#x27;a&#x27; is an Input and &#x27;b&#x27; is an Output</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> normalBundle </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> ABBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  normalBundle</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> normalBundle</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// Flipped recursively flips the direction of all Bundle fields</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// Now &#x27;a&#x27; is an Output and &#x27;b&#x27; is an Input</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> flippedBundle </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> ABBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  flippedBundle</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> flippedBundle</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This generates the following Verilog:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">MyFlippedModule</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// bundles-and-vecs.md:57:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  normalBundle_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// bundles-and-vecs.md:60:24</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> normalBundle_b</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// bundles-and-vecs.md:60:24</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">         flippedBundle_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// bundles-and-vecs.md:65:25</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  flippedBundle_b	</span><span class="token comment" style="color:#999988;font-style:italic">// bundles-and-vecs.md:65:25</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> normalBundle_b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> normalBundle_a</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// bundles-and-vecs.md:57:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> flippedBundle_a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> flippedBundle_b</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// bundles-and-vecs.md:57:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">MyFlippedModule</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// bundles-and-vecs.md:57:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  normalBundle_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// bundles-and-vecs.md:60:24</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> normalBundle_b</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// bundles-and-vecs.md:60:24</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">         flippedBundle_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// bundles-and-vecs.md:65:25</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  flippedBundle_b	</span><span class="token comment" style="color:#999988;font-style:italic">// bundles-and-vecs.md:65:25</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> normalBundle_b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> normalBundle_a</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// bundles-and-vecs.md:57:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> flippedBundle_a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> flippedBundle_b</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// bundles-and-vecs.md:57:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_MyFlippedModule_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyFlippedModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyFlippedModule_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyFlippedModule_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyFlippedModule_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_MyFlippedModule_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyFlippedModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyFlippedModule_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyFlippedModule_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyFlippedModule_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_MyFlippedModule_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyFlippedModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyFlippedModule_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyFlippedModule_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyFlippedModule_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_MyFlippedModule_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyFlippedModule_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyFlippedModule_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyFlippedModule_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="mixedvec">MixedVec<a href="#mixedvec" class="hash-link" aria-label="Direct link to MixedVec" title="Direct link to MixedVec">​</a></h3>
 <p>(Chisel 3.2+)</p>
 <p>All elements of a <code>Vec</code> must have the same parameterization. If we want to create a Vec where the elements have the same type but different parameterizations, we can use a MixedVec:</p>
diff --git a/docs/explanations/chisel-enum.html b/docs/explanations/chisel-enum.html
index 1d5c8b7fe8..b7853f68cc 100644
--- a/docs/explanations/chisel-enum.html
+++ b/docs/explanations/chisel-enum.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Enumerations | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/chisel-enum"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Enumerations | Chisel"><meta data-rh="true" name="description" content="The ChiselEnum type can be used to reduce the chance of error when encoding mux selectors, opcodes, and functional unit operations."><meta data-rh="true" property="og:description" content="The ChiselEnum type can be used to reduce the chance of error when encoding mux selectors, opcodes, and functional unit operations."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/chisel-enum"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/chisel-enum" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/chisel-enum" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
@@ -17,7 +17,7 @@ <h2 class="anchor anchorWithStickyNavbar_LWe7" id="functionality-and-examples">F
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// package CPUTypes {</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">object</span><span class="token plain"> AluMux1Sel </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> ChiselEnum </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> selectRS1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> selectPC </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Value</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// We can see the mapping by printing each Value</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">AluMux1Sel</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">all</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">foreach</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">println</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// AluMux1Sel(0=selectRS1)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// AluMux1Sel(1=selectPC)</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Here we see a mux using the AluMux1Sel to select between different inputs.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> AluMux1Sel</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> AluMux1Bundle </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> aluMux1Sel </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">AluMux1Sel</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> rs1Out     </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Bits</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> pcOut      </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Bits</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> aluMux1Out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Bits</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> AluMux1File </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> AluMux1Bundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// Default value for aluMux1Out</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">aluMux1Out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">0.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  switch </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">aluMux1Sel</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    is </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">selectRS1</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">aluMux1Out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">rs1Out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    is </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">selectPC</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">aluMux1Out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">pcOut</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">AluMux1File</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// chisel-enum.md:62:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// chisel-enum.md:62:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">                reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// chisel-enum.md:62:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">                io_aluMux1Sel</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// chisel-enum.md:63:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> io_rs1Out</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// chisel-enum.md:63:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">                io_pcOut</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// chisel-enum.md:63:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> io_aluMux1Out	</span><span class="token comment" style="color:#999988;font-style:italic">// chisel-enum.md:63:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> io_aluMux1Out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> io_aluMux1Sel </span><span class="token operator" style="color:#393A34">?</span><span class="token plain"> io_pcOut </span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> io_rs1Out</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// chisel-enum.md:62:7, :68:26, :70:21</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">AluMux1File</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// chisel-enum.md:62:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// chisel-enum.md:62:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">                reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// chisel-enum.md:62:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">                io_aluMux1Sel</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// chisel-enum.md:63:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> io_rs1Out</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// chisel-enum.md:63:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">                io_pcOut</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// chisel-enum.md:63:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> io_aluMux1Out	</span><span class="token comment" style="color:#999988;font-style:italic">// chisel-enum.md:63:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> io_aluMux1Out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> io_aluMux1Sel </span><span class="token operator" style="color:#393A34">?</span><span class="token plain"> io_pcOut </span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> io_rs1Out</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// chisel-enum.md:62:7, :68:26, :70:21</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_AluMux1File_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_AluMux1File_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AluMux1File_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AluMux1File_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:20:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AluMux1File_Verification_Cover	// &lt;stdin&gt;:20:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_AluMux1File_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_AluMux1File_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AluMux1File_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AluMux1File_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:19:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AluMux1File_Verification_Assume	// &lt;stdin&gt;:19:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_AluMux1File_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_AluMux1File_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AluMux1File_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AluMux1File_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:18:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AluMux1File_Verification_Assert	// &lt;stdin&gt;:18:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_AluMux1File_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AluMux1File_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AluMux1File_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:17:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AluMux1File_Verification	// &lt;stdin&gt;:17:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>ChiselEnum also allows for the user to directly set the Values by passing an <code>UInt</code> to <code>Value(...)</code>
 as shown below. Note that the magnitude of each <code>Value</code> must be strictly greater than the one before
 it.</p>
diff --git a/docs/explanations/chisel-type-vs-scala-type.html b/docs/explanations/chisel-type-vs-scala-type.html
index 7f2cce1ec7..2d14cc5f74 100644
--- a/docs/explanations/chisel-type-vs-scala-type.html
+++ b/docs/explanations/chisel-type-vs-scala-type.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Chisel Type vs Scala Type | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/chisel-type-vs-scala-type"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Chisel Type vs Scala Type | Chisel"><meta data-rh="true" name="description" content="The Scala compiler cannot distinguish between Chisel&#x27;s representation of hardware such as false.B, Reg(Bool())"><meta data-rh="true" property="og:description" content="The Scala compiler cannot distinguish between Chisel&#x27;s representation of hardware such as false.B, Reg(Bool())"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/chisel-type-vs-scala-type"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/chisel-type-vs-scala-type" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/chisel-type-vs-scala-type" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
@@ -60,12 +60,12 @@ <h2 class="anchor anchorWithStickyNavbar_LWe7" id="asinstanceof-vs-astypeof-vs-c
 <p>This works if we do indeed have more information than the compiler:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">elaborate</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> ScalaCastingModule</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">=&gt;</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyBundle</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>But if we are wrong, we can get a Scala runtime exception:</p>
-<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> NotMyBundle </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> baz </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">elaborate</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> ScalaCastingModule</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">=&gt;</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> NotMyBundle</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// java.lang.ClassCastException: class repl.MdocSession$MdocApp$$anonfun$79$NotMyBundle$1 cannot be cast to class repl.MdocSession$MdocApp$MyBundle (repl.MdocSession$MdocApp$$anonfun$79$NotMyBundle$1 and repl.MdocSession$MdocApp$MyBundle are in unnamed module of loader scala.reflect.internal.util.AbstractFileClassLoader @25c61518)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71$$anonfun$apply$72$$anonfun$apply$73.apply(chisel-type-vs-scala-type.md:293)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71$$anonfun$apply$72$$anonfun$apply$73.apply(chisel-type-vs-scala-type.md:293)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.SpecifiedDirection$.specifiedDirection(Data.scala:75)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.Output$.apply(Data.scala:316)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71$$anonfun$apply$72.apply(chisel-type-vs-scala-type.md:293)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71$$anonfun$apply$72.apply(chisel-type-vs-scala-type.md:293)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.IO$.apply(IO.scala:34)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.experimental.BaseModule.IO(Module.scala:878)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71.apply(chisel-type-vs-scala-type.md:293)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71.apply(chisel-type-vs-scala-type.md:293)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.experimental.prefix$.apply(prefix.scala:50)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76.apply(chisel-type-vs-scala-type.md:293)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76.apply(chisel-type-vs-scala-type.md)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$ScalaCastingModule.&lt;init&gt;(chisel-type-vs-scala-type.md:293)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$$anonfun$79$$anonfun$apply$75.apply(chisel-type-vs-scala-type.md:309)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$$anonfun$79$$anonfun$apply$75.apply(chisel-type-vs-scala-type.md:309)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.Module$.evaluate(Module.scala:94)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.Module$.do_apply(Module.scala:37)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.internal.Builder$.buildImpl(Builder.scala:1071)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at logger.Logger$.makeScope(Logger.scala:146)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at logger.Logger$.makeScope(Logger.scala:133)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at ... ()</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> NotMyBundle </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> baz </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">elaborate</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> ScalaCastingModule</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">=&gt;</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> NotMyBundle</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// java.lang.ClassCastException: class repl.MdocSession$MdocApp$$anonfun$79$NotMyBundle$1 cannot be cast to class repl.MdocSession$MdocApp$MyBundle (repl.MdocSession$MdocApp$$anonfun$79$NotMyBundle$1 and repl.MdocSession$MdocApp$MyBundle are in unnamed module of loader scala.reflect.internal.util.AbstractFileClassLoader @3a39a49f)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71$$anonfun$apply$72$$anonfun$apply$73.apply(chisel-type-vs-scala-type.md:293)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71$$anonfun$apply$72$$anonfun$apply$73.apply(chisel-type-vs-scala-type.md:293)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.SpecifiedDirection$.specifiedDirection(Data.scala:75)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.Output$.apply(Data.scala:316)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71$$anonfun$apply$72.apply(chisel-type-vs-scala-type.md:293)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71$$anonfun$apply$72.apply(chisel-type-vs-scala-type.md:293)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.IO$.apply(IO.scala:34)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.experimental.BaseModule.IO(Module.scala:878)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71.apply(chisel-type-vs-scala-type.md:293)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76$$anonfun$apply$71.apply(chisel-type-vs-scala-type.md:293)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.experimental.prefix$.apply(prefix.scala:50)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76.apply(chisel-type-vs-scala-type.md:293)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$ScalaCastingModule$$anonfun$76.apply(chisel-type-vs-scala-type.md)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.internal.plugin.package$.autoNameRecursively(package.scala:33)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$ScalaCastingModule.&lt;init&gt;(chisel-type-vs-scala-type.md:293)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$$anonfun$79$$anonfun$apply$75.apply(chisel-type-vs-scala-type.md:309)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp$$anonfun$79$$anonfun$apply$75.apply(chisel-type-vs-scala-type.md:309)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.Module$.evaluate(Module.scala:94)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.Module$.do_apply(Module.scala:37)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.internal.Builder$.buildImpl(Builder.scala:1071)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at logger.Logger$.makeScope(Logger.scala:146)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at logger.Logger$.makeScope(Logger.scala:133)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at ... ()</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p><code>.asTypeOf</code> is a conversion from one <code>Data</code> subclass to another.
 It is commonly used to assign data to all-zeros, as described in <a href="https://www.chisel-lang.org/chisel3/docs/cookbooks/cookbook.html#how-can-i-tieoff-a-bundlevec-to-0" target="_blank" rel="noopener noreferrer">this cookbook recipe</a>, but it can
 also be used (though not really recommended, as there is no checking on
 width matches) to convert one Chisel type to another:</p>
-<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> SimilarToMyBundle</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">w</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">Int</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> foobar </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2</span><span class="token operator" style="color:#393A34">*</span><span class="token plain">w</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyBundle</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> SimilarToMyBundle</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">asTypeOf</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res12: String = &quot;&quot;&quot;// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module _82_Anon(	// chisel-type-vs-scala-type.md:323:47</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        clock,	// chisel-type-vs-scala-type.md:323:47</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//                reset,	// chisel-type-vs-scala-type.md:323:47</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [2:0] in_foo,	// chisel-type-vs-scala-type.md:324:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//                in_bar,	// chisel-type-vs-scala-type.md:324:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [5:0] out_foobar	// chisel-type-vs-scala-type.md:325:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign out_foobar = {in_foo, in_bar};	// chisel-type-vs-scala-type.md:323:47, :327:21</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// &quot;&quot;&quot;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> SimilarToMyBundle</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">w</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">Int</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> foobar </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2</span><span class="token operator" style="color:#393A34">*</span><span class="token plain">w</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyBundle</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> SimilarToMyBundle</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">asTypeOf</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res12: String = &quot;&quot;&quot;// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module _82_Anon(	// chisel-type-vs-scala-type.md:323:47</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        clock,	// chisel-type-vs-scala-type.md:323:47</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//                reset,	// chisel-type-vs-scala-type.md:323:47</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [2:0] in_foo,	// chisel-type-vs-scala-type.md:324:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//                in_bar,	// chisel-type-vs-scala-type.md:324:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [5:0] out_foobar	// chisel-type-vs-scala-type.md:325:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign out_foobar = {in_foo, in_bar};	// chisel-type-vs-scala-type.md:323:47, :327:21</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // ----- 8&lt; ----- FILE &quot;Verification/Cover/layers__82_Anon_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `include &quot;Verification/layers__82_Anon_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `ifndef layers__82_Anon_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `define layers__82_Anon_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `endif // layers__82_Anon_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // ----- 8&lt; ----- FILE &quot;Verification/Assume/layers__82_Anon_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `include &quot;Verification/layers__82_Anon_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `ifndef layers__82_Anon_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `define layers__82_Anon_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `endif // layers__82_Anon_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // ----- 8&lt; ----- FILE &quot;Verification/Assert/layers__82_Anon_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `include &quot;Verification/layers__82_Anon_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `ifndef layers__82_Anon_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `define layers__82_Anon_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `endif // layers__82_Anon_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // ----- 8&lt; ----- FILE &quot;Verification/layers__82_Anon_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `ifndef layers__82_Anon_Verification</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `define layers__82_Anon_Verification	// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `endif // layers__82_Anon_Verification	// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// &quot;&quot;&quot;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>In contrast to <code>asInstanceOf</code> and <code>asTypeOf</code>,
 <code>chiselTypeOf</code> is not a casting operation. It returns a Scala object which
 can be used as shown in the examples above to create more Chisel types and
diff --git a/docs/explanations/combinational-circuits.html b/docs/explanations/combinational-circuits.html
index 2d6d441ab7..9bd514b7c9 100644
--- a/docs/explanations/combinational-circuits.html
+++ b/docs/explanations/combinational-circuits.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Combinational Circuits | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/combinational-circuits"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Combinational Circuits | Chisel"><meta data-rh="true" name="description" content="A circuit is represented as a graph of nodes in Chisel.  Each node is"><meta data-rh="true" property="og:description" content="A circuit is represented as a graph of nodes in Chisel.  Each node is"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/combinational-circuits"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/combinational-circuits" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/combinational-circuits" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/connectable.html b/docs/explanations/connectable.html
index 234a45faea..1bb403ed2a 100644
--- a/docs/explanations/connectable.html
+++ b/docs/explanations/connectable.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Connectable Operators | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/connectable"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Connectable Operators | Chisel"><meta data-rh="true" name="description" content="Table of Contents"><meta data-rh="true" property="og:description" content="Table of Contents"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/connectable"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/connectable" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/connectable" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
@@ -216,7 +216,7 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="mono-direction-connection-ope
 <p>For simple connections where all members are aligned (non-flipped) w.r.t. one another, use <code>:=</code>:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> FullyAlignedBundle </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example0 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> incoming </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> FullyAlignedBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> outgoing </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> FullyAlignedBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  outgoing </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> incoming</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This generates the following Verilog, where each member of <code>incoming</code> drives every member of <code>outgoing</code>:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example0</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:85:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  incoming_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:86:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">         incoming_b</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:86:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> outgoing_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:87:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">         outgoing_b	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:87:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> outgoing_a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> incoming_a</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:85:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> outgoing_b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> incoming_b</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:85:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example0</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:85:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  incoming_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:86:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">         incoming_b</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:86:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> outgoing_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:87:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">         outgoing_b	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:87:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> outgoing_a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> incoming_a</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:85:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> outgoing_b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> incoming_b</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:85:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example0_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example0_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example0_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example0_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example0_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example0_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example0_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example0_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example0_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example0_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example0_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example0_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example0_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example0_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example0_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example0_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example0_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example0_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example0_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <blockquote>
 <p>You may be thinking &quot;Wait, I&#x27;m confused! Isn&#x27;t <code>incoming</code> flipped and <code>outgoing</code> aligned?&quot; -- Noo! Whether <code>incoming</code> is aligned with <code>outgoing</code> makes no sense; remember, you only evaluate alignment between members of the same component or Chisel type.
 Because components are always aligned to themselves, <code>outgoing</code> is aligned to <code>outgoing</code>, and <code>incoming</code> is aligned to <code>incoming</code>, there is no problem.
@@ -232,7 +232,7 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="bi-direction-connection-opera
 <p>For connections where you want &#x27;bulk-connect-like-semantics&#x27; where the aligned members are driven producer-to-consumer and flipped members are driven consumer-to-producer, use <code>:&lt;&gt;=</code>.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example1 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> incoming </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MixedAlignmentBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> outgoing </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MixedAlignmentBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  outgoing </span><span class="token operator" style="color:#393A34">:</span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> incoming</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This generates the following Verilog, where the aligned members are driven <code>incoming</code> to <code>outgoing</code> and flipped members are driven <code>outgoing</code> to <code>incoming</code>:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example1</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:113:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  incoming_alignedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:114:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> incoming_flippedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:114:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">         outgoing_alignedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:115:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  outgoing_flippedChild	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:115:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> incoming_flippedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> outgoing_flippedChild</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:113:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> outgoing_alignedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> incoming_alignedChild</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:113:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example1</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:113:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  incoming_alignedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:114:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> incoming_flippedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:114:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">         outgoing_alignedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:115:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  outgoing_flippedChild	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:115:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> incoming_flippedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> outgoing_flippedChild</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:113:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> outgoing_alignedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> incoming_alignedChild</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:113:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example1_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example1_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example1_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example1_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example1_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example1_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example1_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example1_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example1_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example1_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example1_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example1_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example1_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example1_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example1_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example1_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example1_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example1_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example1_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="port-direction-computation-versus-connection-direction-computation">Port-Direction Computation versus Connection-Direction Computation<a href="#port-direction-computation-versus-connection-direction-computation" class="hash-link" aria-label="Direct link to Port-Direction Computation versus Connection-Direction Computation" title="Direct link to Port-Direction Computation versus Connection-Direction Computation">​</a></h3>
 <p>A common question is if you use a mixed-alignment connection (such as <code>:&lt;&gt;=</code>) to connect submembers of parent components, does the alignment of the submember to their parent affect anything? The answer is no, because <em>alignment is always computed relative to what is being connected to, and members are always aligned with themselves.</em></p>
 <p>In the following example connecting from <code>incoming.alignedChild</code> to <code>outgoing.alignedChild</code>, whether <code>incoming.alignedChild</code> is aligned with <code>incoming</code> is irrelevant because the <code>:&lt;&gt;=</code> only computes alignment relative to the thing being connected to, and <code>incoming.alignedChild</code> is aligned with <code>incoming.alignedChild</code>.</p>
@@ -256,12 +256,12 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="aligned-connection-operator-"
 <p>For connections where you want the aligned-half of &#x27;bulk-connect-like-semantics&#x27; where the aligned members are driven producer-to-consumer and flipped members are ignored, use <code>:&lt;=</code> (the &quot;aligned connection&quot;).</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example2 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> incoming </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MixedAlignmentBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> outgoing </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MixedAlignmentBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  incoming</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">flippedChild </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DontCare </span><span class="token comment" style="color:#999988;font-style:italic">// Otherwise FIRRTL throws an uninitialization error</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  outgoing </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> incoming</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This generates the following Verilog, where the aligned members are driven <code>incoming</code> to <code>outgoing</code> and flipped members are ignored:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example2</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:139:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  incoming_alignedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:140:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> incoming_flippedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:140:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">         outgoing_alignedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:141:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  outgoing_flippedChild	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:141:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> incoming_flippedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:139:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> outgoing_alignedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> incoming_alignedChild</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:139:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example2</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:139:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  incoming_alignedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:140:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> incoming_flippedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:140:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">         outgoing_alignedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:141:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  outgoing_flippedChild	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:141:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> incoming_flippedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:139:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> outgoing_alignedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> incoming_alignedChild</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:139:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example2_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example2_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example2_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example2_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example2_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example2_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example2_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example2_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example2_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example2_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example2_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example2_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example2_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example2_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example2_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example2_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example2_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example2_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example2_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="flipped-connection-operator-">Flipped connection operator (<code>:&gt;=</code>)<a href="#flipped-connection-operator-" class="hash-link" aria-label="Direct link to flipped-connection-operator-" title="Direct link to flipped-connection-operator-">​</a></h3>
 <p>For connections where you want the flipped-half of &#x27;bulk-connect-like-semantics&#x27; where the aligned members are ignored and flipped members are connected consumer-to-producer, use <code>:&gt;=</code> (the &quot;flipped connection&quot;, or &quot;backpressure connection&quot;).</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example3 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> incoming </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MixedAlignmentBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> outgoing </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MixedAlignmentBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  outgoing</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">alignedChild </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DontCare </span><span class="token comment" style="color:#999988;font-style:italic">// Otherwise FIRRTL throws an uninitialization error</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  outgoing </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">&gt;=</span><span class="token plain"> incoming</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This generates the following Verilog, where the aligned members are ignored and the flipped members are driven <code>outgoing</code> to <code>incoming</code>:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example3</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:156:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  incoming_alignedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:157:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> incoming_flippedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:157:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">         outgoing_alignedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:158:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  outgoing_flippedChild	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:158:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> incoming_flippedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> outgoing_flippedChild</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:156:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> outgoing_alignedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:156:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example3</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:156:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  incoming_alignedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:157:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> incoming_flippedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:157:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">         outgoing_alignedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:158:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  outgoing_flippedChild	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:158:20</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> incoming_flippedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> outgoing_flippedChild</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:156:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> outgoing_alignedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:156:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example3_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example3_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example3_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example3_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example3_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example3_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example3_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example3_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example3_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example3_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example3_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example3_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example3_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example3_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example3_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example3_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example3_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example3_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example3_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <blockquote>
 <p>Note: Astute observers will realize that <code>c :&lt;&gt;= p</code> is semantically equivalent to <code>c :&lt;= p</code> followed by <code>c :&gt;= p</code>.</p>
 </blockquote>
@@ -270,14 +270,14 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="coercing-mono-direction-conne
 This operator is useful for initializing wires whose types contain members of mixed alignment.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">BundleLiterals</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example4 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> w </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Wire</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MixedAlignmentBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  dontTouch</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">w</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// So we see it in the output Verilog</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  w </span><span class="token operator" style="color:#393A34">:</span><span class="token plain">#</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MixedAlignmentBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Lit</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">alignedChild </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token boolean" style="color:#36acaa">true</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">B</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">flippedChild </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token boolean" style="color:#36acaa">true</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">B</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This generates the following Verilog, where all members are driven from the literal to <code>w</code>, regardless of alignment:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example4</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:176:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> w_alignedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:177:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> w_flippedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:177:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example4</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:176:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> w_alignedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:177:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> w_flippedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:177:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example4_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example4_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example4_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example4_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:15:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example4_Verification_Cover	// &lt;stdin&gt;:15:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example4_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example4_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example4_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example4_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:14:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example4_Verification_Assume	// &lt;stdin&gt;:14:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example4_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example4_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example4_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example4_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:13:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example4_Verification_Assert	// &lt;stdin&gt;:13:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example4_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example4_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example4_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:12:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example4_Verification	// &lt;stdin&gt;:12:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <blockquote>
 <p>Note: Astute observers will realize that <code>c :#= p</code> is semantically equivalent to <code>c :&lt;= p</code> followed by <code>p :&gt;= c</code> (note <code>p</code> and <code>c</code> switched places in the second connection).</p>
 </blockquote>
 <p>Another use case for <code>:#=</code> is for connecting a mixed-directional bundle to a fully-aligned monitor.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">BundleLiterals</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example4b </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> monitor </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MixedAlignmentBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> w </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Wire</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MixedAlignmentBundle</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  dontTouch</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">w</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// So we see it in the output Verilog</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  w </span><span class="token operator" style="color:#393A34">:</span><span class="token plain">#</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DontCare</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  monitor </span><span class="token operator" style="color:#393A34">:</span><span class="token plain">#</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> w</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This generates the following Verilog, where all members are driven from the literal to <code>w</code>, regardless of alignment:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example4b</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:195:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> monitor_alignedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:196:19</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">         monitor_flippedChild	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:196:19</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> w_alignedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:197:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> w_flippedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:197:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> monitor_alignedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> w_alignedChild</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:195:7, :197:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> monitor_flippedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> w_flippedChild</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:195:7, :197:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example4b</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:195:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> monitor_alignedChild</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:196:19</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">         monitor_flippedChild	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:196:19</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> w_alignedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:197:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> w_flippedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:197:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> monitor_alignedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> w_alignedChild</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:195:7, :197:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> monitor_flippedChild </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> w_flippedChild</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:195:7, :197:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example4b_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example4b_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example4b_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example4b_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:15:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example4b_Verification_Cover	// &lt;stdin&gt;:15:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example4b_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example4b_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example4b_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example4b_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:14:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example4b_Verification_Assume	// &lt;stdin&gt;:14:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example4b_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example4b_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example4b_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example4b_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:13:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example4b_Verification_Assert	// &lt;stdin&gt;:13:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example4b_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example4b_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example4b_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:12:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example4b_Verification	// &lt;stdin&gt;:12:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h2 class="anchor anchorWithStickyNavbar_LWe7" id="connectable">Connectable<a href="#connectable" class="hash-link" aria-label="Direct link to Connectable" title="Direct link to Connectable">​</a></h2>
 <p>Sometimes a user wants to connect Chisel components which are not type equivalent.
 For example, a user may want to hook up anonymous <code>Record</code> components who may have an intersection of their fields being equivalent, but cannot because they are not structurally equivalent.
@@ -295,38 +295,38 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="connecting-records">Connectin
 </blockquote>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">scala</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">collection</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">immutable</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">SeqMap</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example9 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> abType </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Record </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> elements </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> SeqMap</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;a&quot;</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;b&quot;</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> bcType </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Record </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> elements </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> SeqMap</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;b&quot;</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;c&quot;</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> p </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">abType</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">bcType</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  DontCare </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">&gt;=</span><span class="token plain"> p</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  c </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> DontCare</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  c</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">waive</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">elements</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;c&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token operator" style="color:#393A34">:</span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">waive</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">elements</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;a&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This generates the following Verilog, where <code>p.b</code> is driven from <code>c.b</code>:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example9</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:216:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> p_b</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:220:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  p_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:220:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> c_c</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:221:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  c_b	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:221:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> p_b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> c_b</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:216:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> c_c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:216:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example9</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:216:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> p_b</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:220:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  p_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:220:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> c_c</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:221:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  c_b	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:221:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> p_b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> c_b</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:216:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> c_c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:216:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example9_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example9_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example9_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example9_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example9_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example9_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example9_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example9_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example9_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example9_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example9_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example9_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example9_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example9_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example9_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example9_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example9_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example9_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example9_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="defaults-with-waived-connections">Defaults with waived connections<a href="#defaults-with-waived-connections" class="hash-link" aria-label="Direct link to Defaults with waived connections" title="Direct link to Defaults with waived connections">​</a></h3>
 <p>Another use case is to try to connect two <code>Record</code>s; for matching members, they should be connected, but for unmatched members, <em>they should be connected to a default value</em>.
 To accomplish this, use the other operators to initialize all <code>Record</code> members, then use <code>:&lt;&gt;=</code> with <code>.waive</code> to connect only the matching members.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">scala</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">collection</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">immutable</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">SeqMap</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example10 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> abType </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Record </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> elements </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> SeqMap</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;a&quot;</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;b&quot;</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> bcType </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Record </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> elements </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> SeqMap</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;b&quot;</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;c&quot;</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> p </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Wire</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">abType</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Wire</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">bcType</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  dontTouch</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">p</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// So it doesn&#x27;t get constant-propped away for the example</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  dontTouch</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">c</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// So it doesn&#x27;t get constant-propped away for the example</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  p </span><span class="token operator" style="color:#393A34">:</span><span class="token plain">#</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> abType</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Lit</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">elements</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;a&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token boolean" style="color:#36acaa">true</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">B</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">elements</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;b&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token boolean" style="color:#36acaa">true</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">B</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  c </span><span class="token operator" style="color:#393A34">:</span><span class="token plain">#</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> bcType</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Lit</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">elements</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;b&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token boolean" style="color:#36acaa">true</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">B</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">elements</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;c&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> </span><span class="token boolean" style="color:#36acaa">true</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">B</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  c</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">waive</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">elements</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;c&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">:</span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">waive</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">elements</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;a&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This generates the following Verilog, where <code>p.b</code> is driven from <code>c.b</code>, and <code>p.a</code>, <code>c.b</code>, and <code>c.c</code> are initialized to default values:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example10</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:242:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> p_a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:246:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> c_c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:247:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> c_b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:247:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> p_b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> c_b</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:246:15, :247:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example10</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:242:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> p_a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:246:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> c_c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:247:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> c_b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:247:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> p_b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> c_b</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:246:15, :247:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example10_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example10_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example10_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example10_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:23:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example10_Verification_Cover	// &lt;stdin&gt;:23:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example10_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example10_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example10_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example10_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:22:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example10_Verification_Assume	// &lt;stdin&gt;:22:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example10_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example10_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example10_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example10_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:21:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example10_Verification_Assert	// &lt;stdin&gt;:21:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example10_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example10_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example10_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:20:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example10_Verification	// &lt;stdin&gt;:20:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="connecting-types-with-optional-members">Connecting types with optional members<a href="#connecting-types-with-optional-members" class="hash-link" aria-label="Direct link to Connecting types with optional members" title="Direct link to Connecting types with optional members">​</a></h3>
 <p>In the following example, we can use <code>:&lt;&gt;=</code> and <code>.waive</code> to connect two <code>MyDecoupledOpts</code>&#x27;s, where only one has a <code>bits</code> member.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MyDecoupledOpt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">hasBits</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">Boolean</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> valid </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> ready </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> bits </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">hasBits</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> Some</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">else</span><span class="token plain"> None</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example6 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in  </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyDecoupledOpt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token boolean" style="color:#36acaa">true</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyDecoupledOpt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token boolean" style="color:#36acaa">false</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">waive</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">bits</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">get</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// We can know to call .get because we can inspect in.bits.isEmpty</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This generates the following Verilog, where <code>ready</code> and <code>valid</code> are connected, and <code>bits</code> is ignored:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example6</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:275:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         in_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:276:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        in_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:276:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in_bits</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:276:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        out_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:277:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         out_ready	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:277:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_ready </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_ready</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:275:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_valid </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in_valid</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:275:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example6</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:275:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         in_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:276:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        in_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:276:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in_bits</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:276:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        out_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:277:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         out_ready	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:277:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_ready </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_ready</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:275:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_valid </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in_valid</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:275:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example6_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example6_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example6_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example6_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example6_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example6_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example6_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example6_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example6_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example6_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example6_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example6_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example6_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example6_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example6_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example6_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example6_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example6_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example6_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="always-ignore-errors-caused-by-extra-members-partial-connection-operator">Always ignore errors caused by extra members (partial connection operator)<a href="#always-ignore-errors-caused-by-extra-members-partial-connection-operator" class="hash-link" aria-label="Direct link to Always ignore errors caused by extra members (partial connection operator)" title="Direct link to Always ignore errors caused by extra members (partial connection operator)">​</a></h3>
 <p>The most unsafe connection is to connect only members that are present in both consumer and producer, and ignore all other members.
 This is unsafe because this connection will never error on any Chisel types.</p>
 <p>To do this, you can use <code>.waiveAll</code> and static cast to <code>Data</code>:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> OnlyA </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> OnlyB </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example11 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in  </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> OnlyA</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> OnlyB</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DontCare</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">out</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> Data</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">waiveAll </span><span class="token operator" style="color:#393A34">:</span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> Data</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">waiveAll</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This generates the following Verilog, where nothing is connected:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example11</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:301:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:302:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_b	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:303:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">32&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:301:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example11</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:301:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:302:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_b	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:303:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">32&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:301:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example11_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example11_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example11_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example11_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example11_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example11_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example11_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example11_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example11_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example11_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example11_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example11_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example11_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example11_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example11_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example11_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example11_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example11_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example11_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="connecting-components-with-different-widths">Connecting components with different widths<a href="#connecting-components-with-different-widths" class="hash-link" aria-label="Direct link to Connecting components with different widths" title="Direct link to Connecting components with different widths">​</a></h3>
 <p>Non-<code>Connectable</code> operators implicitly truncate if a component with a larger width is connected to a component with a smaller width.
 <code>Connectable</code> operators disallow this implicit truncation behavior and require the driven component to be equal or larger in width that the sourcing component.</p>
 <p>If implicit truncation behavior is desired, then <code>Connectable</code> provides a <code>squeeze</code> mechanism which will allow the connection to continue with implicit truncation.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">scala</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">collection</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">immutable</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">SeqMap</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example14 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> p </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">3.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  c </span><span class="token operator" style="color:#393A34">:</span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">squeeze</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This generates the following Verilog, where <code>p</code> is truncated prior to driving <code>c</code>:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example14</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:323:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> p</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:324:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> c	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:325:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> p</span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:323:7, :327:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example14</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:323:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> p</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:324:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> c	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:325:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> p</span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:323:7, :327:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example14_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example14_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example14_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example14_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example14_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example14_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example14_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example14_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example14_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example14_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example14_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example14_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example14_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example14_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example14_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example14_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example14_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example14_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example14_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="excluding-members-from-any-operator-on-a-connectable">Excluding members from any operator on a Connectable<a href="#excluding-members-from-any-operator-on-a-connectable" class="hash-link" aria-label="Direct link to Excluding members from any operator on a Connectable" title="Direct link to Excluding members from any operator on a Connectable">​</a></h3>
 <p>If a user wants to always exclude a field from a connect, use the <code>.exclude</code> mechanism which will never connect the field (as if it didn&#x27;t exist to the connection).</p>
 <p>Note that if a field matches in both producer and consumer, but only one is excluded, the other non-excluded field will still trigger an error; to fix this, use either <code>.waive</code> or <code>.exclude</code>.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">scala</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">collection</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">immutable</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">SeqMap</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> BundleWithSpecialField </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">3.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> special </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example15 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> p </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> BundleWithSpecialField</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> BundleWithSpecialField</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  c</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">special </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token boolean" style="color:#36acaa">true</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">B </span><span class="token comment" style="color:#999988;font-style:italic">// must initialize it</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  c</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">exclude</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">special</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">:</span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">exclude</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">special</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This generates the following Verilog, where the <code>special</code> field is not connected:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example15</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:349:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> p_foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:350:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        p_special</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:350:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> c_foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:351:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">       c_special	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:351:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> c_foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> p_foo</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:349:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> c_special </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:349:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example15</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:349:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> p_foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:350:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        p_special</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:350:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> c_foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:351:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">       c_special	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:351:13</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> c_foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> p_foo</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:349:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> c_special </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:349:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example15_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example15_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example15_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example15_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example15_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example15_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example15_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example15_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example15_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example15_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example15_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example15_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example15_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example15_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example15_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example15_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example15_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example15_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example15_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h2 class="anchor anchorWithStickyNavbar_LWe7" id="techniques-for-connecting-structurally-inequivalent-chisel-types">Techniques for connecting structurally inequivalent Chisel types<a href="#techniques-for-connecting-structurally-inequivalent-chisel-types" class="hash-link" aria-label="Direct link to Techniques for connecting structurally inequivalent Chisel types" title="Direct link to Techniques for connecting structurally inequivalent Chisel types">​</a></h2>
 <p><code>DataView</code> and <code>.viewAsSupertype</code> create a view of the component that has a different Chisel type.
 This means that a user can first create a <code>DataView</code> of the consumer or producer (or both) so that the Chisel types are structurally equivalent.
@@ -356,7 +356,7 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="connecting-different-sub-type
 Because it changes the Chisel type to omit both <code>bits</code> fields, the <code>bits</code> fields are unconnected.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">dataview</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MyDecoupledOtherBits </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> MyReadyValid </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> bits </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example12 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in  </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyDecoupled</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyDecoupledOtherBits</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DontCare</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">viewAsSupertype</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyReadyValid</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">:</span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">viewAsSupertype</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyReadyValid</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Note that the <code>bits</code> fields are unconnected.</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example12</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:376:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         in_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:377:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        in_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:377:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in_bits</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:377:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        out_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:378:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         out_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:378:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_bits	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:378:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_ready </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_ready</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:376:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_valid </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in_valid</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:376:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_bits </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">32&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:376:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example12</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:376:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         in_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:377:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        in_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:377:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in_bits</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:377:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        out_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:378:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         out_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:378:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_bits	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:378:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_ready </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_ready</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:376:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_valid </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in_valid</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:376:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_bits </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">32&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:376:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example12_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example12_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example12_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example12_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example12_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example12_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example12_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example12_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example12_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example12_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example12_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example12_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example12_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example12_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example12_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example12_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example12_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example12_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example12_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>The second example will use a static cast and <code>.waive(_.bits)</code> to connect them as <code>MyReadyValid</code>.
 Note that because the static cast does not change the Chisel type, the connection finds that both consumer and producer have a <code>bits</code> field.
 This means that since they are structurally equivalent, they match and are connected.
@@ -364,7 +364,7 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="connecting-different-sub-type
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">dataview</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example13 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in  </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyDecoupled</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyDecoupledOtherBits</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DontCare</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">waiveAs</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">MyReadyValid</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">bits</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">:</span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">waiveAs</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">MyReadyValid</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">bits</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Note that the <code>bits</code> fields ARE connected, even though they are waived, as <code>.waive</code> just changes whether an error should be thrown if they are missing, NOT to not connect them if they are structurally equivalent.
 To always omit the connection, use <code>.exclude</code> on one side and either <code>.exclude</code> or <code>.waive</code> on the other side.</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example13</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:398:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         in_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:399:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        in_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:399:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in_bits</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:399:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        out_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:400:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         out_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:400:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_bits	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:400:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_ready </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_ready</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:398:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_valid </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in_valid</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:398:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_bits </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in_bits</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:398:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example13</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:398:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         in_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:399:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        in_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:399:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in_bits</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:399:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        out_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:400:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         out_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:400:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_bits	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:400:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_ready </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_ready</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:398:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_valid </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in_valid</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:398:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_bits </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in_bits</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:398:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example13_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example13_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example13_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example13_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example13_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example13_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example13_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example13_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example13_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example13_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example13_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example13_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example13_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example13_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example13_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example13_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example13_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example13_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example13_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="connecting-sub-types-to-super-types-by-waiving-extra-members">Connecting sub-types to super-types by waiving extra members<a href="#connecting-sub-types-to-super-types-by-waiving-extra-members" class="hash-link" aria-label="Direct link to Connecting sub-types to super-types by waiving extra members" title="Direct link to Connecting sub-types to super-types by waiving extra members">​</a></h3>
 <blockquote>
 <p>Note that in this example, it would be better to use <code>.viewAsSupertype</code>.</p>
@@ -372,7 +372,7 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="connecting-sub-types-to-super
 <p>In the following example, we can use <code>:&lt;&gt;=</code> to connect a <code>MyReadyValid</code> to a <code>MyDecoupled</code> by waiving the <code>bits</code> member.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MyReadyValid </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> valid </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> ready </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MyDecoupled </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> MyReadyValid </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> bits </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example5 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in  </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyDecoupled</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyReadyValid</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">waiveAs</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">MyReadyValid</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">bits</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This generates the following Verilog, where <code>ready</code> and <code>valid</code> are connected, and <code>bits</code> is ignored:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example5</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:428:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         in_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:429:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        in_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:429:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in_bits</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:429:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        out_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:430:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         out_ready	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:430:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_ready </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_ready</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:428:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_valid </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in_valid</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:428:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example5</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:428:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         in_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:429:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        in_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:429:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in_bits</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:429:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        out_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:430:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         out_ready	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:430:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_ready </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_ready</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:428:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_valid </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in_valid</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:428:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example5_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example5_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example5_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example5_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example5_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example5_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example5_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example5_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example5_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example5_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example5_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example5_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example5_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example5_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example5_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example5_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example5_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example5_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example5_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="connecting-different-sub-types">Connecting different sub-types<a href="#connecting-different-sub-types" class="hash-link" aria-label="Direct link to Connecting different sub-types" title="Direct link to Connecting different sub-types">​</a></h3>
 <blockquote>
 <p>Note that in this example, it would be better to use <code>.viewAsSupertype</code>.</p>
@@ -381,7 +381,7 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="connecting-different-sub-type
 <p>In the following example, we can use <code>:&lt;&gt;=</code> and <code>.waiveAs</code> to connect two different sub-types of <code>MyReadyValid</code>.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> HasBits </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> MyReadyValid </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> bits </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> HasEcho </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> MyReadyValid </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> echo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example7 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in  </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> HasBits</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> HasEcho</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">waiveAs</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">MyReadyValid</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">echo</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">:</span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">waiveAs</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">MyReadyValid</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">bits</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This generates the following Verilog, where <code>ready</code> and <code>valid</code> are connected, and <code>bits</code> and <code>echo</code> are ignored:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example7</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:454:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         in_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:455:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        in_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:455:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in_bits</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:455:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        out_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:456:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         out_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:456:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_echo	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:456:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_ready </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_ready</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:454:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_valid </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in_valid</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:454:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example7</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:454:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         in_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:455:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        in_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:455:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in_bits</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:455:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        out_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:456:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         out_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:456:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_echo	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:456:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_ready </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_ready</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:454:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_valid </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in_valid</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// connectable.md:454:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example7_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example7_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example7_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example7_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example7_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example7_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example7_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example7_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example7_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example7_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example7_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example7_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example7_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example7_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example7_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example7_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example7_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example7_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example7_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h2 class="anchor anchorWithStickyNavbar_LWe7" id="faq">FAQ<a href="#faq" class="hash-link" aria-label="Direct link to FAQ" title="Direct link to FAQ">​</a></h2>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="how-do-i-connect-two-items-as-flexibly-as-possible-try-your-best-but-never-error">How do I connect two items as flexibly as possible (try your best but never error)<a href="#how-do-i-connect-two-items-as-flexibly-as-possible-try-your-best-but-never-error" class="hash-link" aria-label="Direct link to How do I connect two items as flexibly as possible (try your best but never error)" title="Direct link to How do I connect two items as flexibly as possible (try your best but never error)">​</a></h3>
 <p>Use <code>.unsafe</code> (both waives and allows squeezing of all fields).</p>
diff --git a/docs/explanations/connection-operators.html b/docs/explanations/connection-operators.html
index 8baf1d0928..dcb106aaac 100644
--- a/docs/explanations/connection-operators.html
+++ b/docs/explanations/connection-operators.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Deep Dive into &lt;&gt; and := Connection Operators | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/connection-operators"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Deep Dive into &lt;&gt; and := Connection Operators | Chisel"><meta data-rh="true" name="description" content="Chisel contains two connection operators, := and `. This document provides a deeper explanation of the differences of the two and when to use one or the other. The differences are demonstrated with experiments using Scastie examples which use DecoupledIO`."><meta data-rh="true" property="og:description" content="Chisel contains two connection operators, := and `. This document provides a deeper explanation of the differences of the two and when to use one or the other. The differences are demonstrated with experiments using Scastie examples which use DecoupledIO`."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/connection-operators"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/connection-operators" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/connection-operators" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
@@ -16,14 +16,14 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="experiment-setup">Experiment
 <img decoding="async" loading="lazy" src="https://raw.githubusercontent.com/chipsalliance/chisel3/master/docs/src/images/connection-operators-experiment.svg?sanitize=true" alt="Experiment Image" class="img_ev3q"></p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Wrapper </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> p </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> PipelineStage</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> PipelineStage</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// connect Producer to IO</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// connect producer to consumer</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  c</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// connect consumer to IO</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> c</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> PipelineStage </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Below we can see the resulting Verilog for this example:</p>
-<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Wrapper</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res0: String = &quot;&quot;&quot;// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module PipelineStage(	// connection-operators.md:36:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_a_ready,	// connection-operators.md:37:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_a_valid,	// connection-operators.md:37:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_a_bits,	// connection-operators.md:37:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_b_ready,	// connection-operators.md:37:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_b_valid,	// connection-operators.md:37:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_b_bits	// connection-operators.md:37:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_a_ready = io_b_ready;	// connection-operators.md:36:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_valid = io_a_valid;	// connection-operators.md:36:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_bits = io_a_bits;	// connection-operators.md:36:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module Wrapper(	// connection-operators.md:20:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        clock,	// connection-operators.md:20:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//                reset,	// connection-operators.md:20:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_in_ready,	// connection-operators.md:21:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_in_valid,	// connection-operators.md:21:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_in_bits,	// connection-operators.md:21:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_out_ready,	// connection-operators.md:21:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_out_valid,	// connection-operators.md:21:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_out_bits	// connection-operators.md:21:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _c_io_a_ready;	// connection-operators.md:26:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _p_io_b_valid;	// connection-operators.md:25:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire [7:0] _p_io_b_bits;	// connection-operators.md:25:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage p (	// connection-operators.md:25:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (io_in_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (io_in_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (io_in_bits),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (_c_io_a_ready),	// connection-operators.md:26:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (_p_io_b_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (_p_io_b_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:25:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage c (	// connection-operators.md:26:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (_c_io_a_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (_p_io_b_valid),	// connection-operators.md:25:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (_p_io_b_bits),	// connection-operators.md:25:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (io_out_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (io_out_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (io_out_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:26:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// &quot;&quot;&quot;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Wrapper</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res0: String = &quot;&quot;&quot;// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module PipelineStage(	// connection-operators.md:36:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_a_ready,	// connection-operators.md:37:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_a_valid,	// connection-operators.md:37:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_a_bits,	// connection-operators.md:37:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_b_ready,	// connection-operators.md:37:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_b_valid,	// connection-operators.md:37:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_b_bits	// connection-operators.md:37:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_a_ready = io_b_ready;	// connection-operators.md:36:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_valid = io_a_valid;	// connection-operators.md:36:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_bits = io_a_bits;	// connection-operators.md:36:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module Wrapper(	// connection-operators.md:20:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        clock,	// connection-operators.md:20:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//                reset,	// connection-operators.md:20:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_in_ready,	// connection-operators.md:21:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_in_valid,	// connection-operators.md:21:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_in_bits,	// connection-operators.md:21:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_out_ready,	// connection-operators.md:21:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_out_valid,	// connection-operators.md:21:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_out_bits	// connection-operators.md:21:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _c_io_a_ready;	// connection-operators.md:26:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _p_io_b_valid;	// connection-operators.md:25:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire [7:0] _p_io_b_bits;	// connection-operators.md:25:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage p (	// connection-operators.md:25:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (io_in_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (io_in_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (io_in_bits),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (_c_io_a_ready),	// connection-operators.md:26:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (_p_io_b_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (_p_io_b_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:25:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage c (	// connection-operators.md:26:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (_c_io_a_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (_p_io_b_valid),	// connection-operators.md:25:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (_p_io_b_bits),	// connection-operators.md:25:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (io_out_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (io_out_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (io_out_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:26:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Wrapper_Verification_Cover.sv&quot;...</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h2 class="anchor anchorWithStickyNavbar_LWe7" id="concept-1--is-commutative">Concept 1: <code>&lt;&gt;</code> is Commutative<a href="#concept-1--is-commutative" class="hash-link" aria-label="Direct link to concept-1--is-commutative" title="Direct link to concept-1--is-commutative">​</a></h2>
 <p>This experiment is set up to test for the function of <code>&lt;&gt;</code> using the experiment above.</p>
 <p>Achieving this involves flipping the RHS and LHS of the <code>&lt;&gt;</code> operator and seeing how <code>&lt;&gt;</code>  will react.
 ( Scastie link for the experiment:<a href="https://scastie.scala-lang.org/Shorla/LVhlbkFQQnq7X3trHfgZZQ" target="_blank" rel="noopener noreferrer">https://scastie.scala-lang.org/Shorla/LVhlbkFQQnq7X3trHfgZZQ</a> )</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">util</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">DecoupledIO</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">circt</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">stage</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">ChiselStage</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Wrapper </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> p </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> PipelineStage</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> PipelineStage</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// connect producer to I/O</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// connect producer  to consumer</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> c</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// connect consumer to I/O</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  c</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> PipelineStage </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Below we can see the resulting Verilog for this example:</p>
-<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Wrapper</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res2: String = &quot;&quot;&quot;// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module PipelineStage(	// connection-operators.md:82:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_a_ready,	// connection-operators.md:83:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_a_valid,	// connection-operators.md:83:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_a_bits,	// connection-operators.md:83:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_b_ready,	// connection-operators.md:83:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_b_valid,	// connection-operators.md:83:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_b_bits	// connection-operators.md:83:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_a_ready = io_b_ready;	// connection-operators.md:82:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_valid = io_a_valid;	// connection-operators.md:82:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_bits = io_a_bits;	// connection-operators.md:82:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module Wrapper(	// connection-operators.md:66:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        clock,	// connection-operators.md:66:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//                reset,	// connection-operators.md:66:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_in_ready,	// connection-operators.md:67:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_in_valid,	// connection-operators.md:67:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_in_bits,	// connection-operators.md:67:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_out_ready,	// connection-operators.md:67:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_out_valid,	// connection-operators.md:67:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_out_bits	// connection-operators.md:67:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _c_io_a_ready;	// connection-operators.md:72:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _p_io_b_valid;	// connection-operators.md:71:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire [7:0] _p_io_b_bits;	// connection-operators.md:71:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage p (	// connection-operators.md:71:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (io_in_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (io_in_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (io_in_bits),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (_c_io_a_ready),	// connection-operators.md:72:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (_p_io_b_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (_p_io_b_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:71:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage c (	// connection-operators.md:72:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (_c_io_a_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (_p_io_b_valid),	// connection-operators.md:71:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (_p_io_b_bits),	// connection-operators.md:71:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (io_out_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (io_out_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (io_out_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:72:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// &quot;&quot;&quot;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Wrapper</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res2: String = &quot;&quot;&quot;// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module PipelineStage(	// connection-operators.md:82:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_a_ready,	// connection-operators.md:83:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_a_valid,	// connection-operators.md:83:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_a_bits,	// connection-operators.md:83:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_b_ready,	// connection-operators.md:83:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_b_valid,	// connection-operators.md:83:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_b_bits	// connection-operators.md:83:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_a_ready = io_b_ready;	// connection-operators.md:82:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_valid = io_a_valid;	// connection-operators.md:82:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_bits = io_a_bits;	// connection-operators.md:82:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module Wrapper(	// connection-operators.md:66:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        clock,	// connection-operators.md:66:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//                reset,	// connection-operators.md:66:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_in_ready,	// connection-operators.md:67:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_in_valid,	// connection-operators.md:67:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_in_bits,	// connection-operators.md:67:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_out_ready,	// connection-operators.md:67:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_out_valid,	// connection-operators.md:67:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_out_bits	// connection-operators.md:67:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _c_io_a_ready;	// connection-operators.md:72:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _p_io_b_valid;	// connection-operators.md:71:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire [7:0] _p_io_b_bits;	// connection-operators.md:71:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage p (	// connection-operators.md:71:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (io_in_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (io_in_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (io_in_bits),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (_c_io_a_ready),	// connection-operators.md:72:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (_p_io_b_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (_p_io_b_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:71:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage c (	// connection-operators.md:72:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (_c_io_a_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (_p_io_b_valid),	// connection-operators.md:71:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (_p_io_b_bits),	// connection-operators.md:71:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (io_out_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (io_out_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (io_out_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:72:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Wrapper_Verification_Cover.sv&quot;...</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="conclusion">Conclusion:<a href="#conclusion" class="hash-link" aria-label="Direct link to Conclusion:" title="Direct link to Conclusion:">​</a></h3>
 <p>The Verilog remained the same without incurring errors, showing that the <code>&lt;&gt;</code> operator is commutative.</p>
 <h2 class="anchor anchorWithStickyNavbar_LWe7" id="concept-2--means-assign-all-lhs-signals-from-the-rhs-regardless-of-the-direction-on-the-lhs">Concept 2: <code>:=</code> means assign ALL LHS signals from the RHS, regardless of the direction on the LHS.<a href="#concept-2--means-assign-all-lhs-signals-from-the-rhs-regardless-of-the-direction-on-the-lhs" class="hash-link" aria-label="Direct link to concept-2--means-assign-all-lhs-signals-from-the-rhs-regardless-of-the-direction-on-the-lhs" title="Direct link to concept-2--means-assign-all-lhs-signals-from-the-rhs-regardless-of-the-direction-on-the-lhs">​</a></h2>
@@ -41,7 +41,7 @@ <h2 class="anchor anchorWithStickyNavbar_LWe7" id="concept-3-always-use--to-assi
 ( Scastie link for the experiment:<a href="https://scastie.scala-lang.org/Shorla/ZIGsWcylRqKJhZCkKWlSIA/1" target="_blank" rel="noopener noreferrer">https://scastie.scala-lang.org/Shorla/ZIGsWcylRqKJhZCkKWlSIA/1</a>)</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">util</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">DecoupledIO</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">circt</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">stage</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">ChiselStage</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Wrapper </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> p </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> PipelineStage</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> PipelineStage</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">//connect Producer to IO</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DontCare</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> DontCare</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> tmp </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Wire</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  tmp </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DontCare</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// connect producer to consumer</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  c</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">//connect consumer to IO</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> c</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> PipelineStage </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Below we can see the resulting Verilog for this example:</p>
-<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Wrapper</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res5: String = &quot;&quot;&quot;// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module PipelineStage(	// connection-operators.md:182:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_a_ready,	// connection-operators.md:183:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_a_valid,	// connection-operators.md:183:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_a_bits,	// connection-operators.md:183:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_b_ready,	// connection-operators.md:183:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_b_valid,	// connection-operators.md:183:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_b_bits	// connection-operators.md:183:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_a_ready = io_b_ready;	// connection-operators.md:182:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_valid = io_a_valid;	// connection-operators.md:182:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_bits = io_a_bits;	// connection-operators.md:182:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module Wrapper(	// connection-operators.md:162:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        clock,	// connection-operators.md:162:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//                reset,	// connection-operators.md:162:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_in_ready,	// connection-operators.md:163:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_in_valid,	// connection-operators.md:163:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_in_bits,	// connection-operators.md:163:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_out_ready,	// connection-operators.md:163:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_out_valid,	// connection-operators.md:163:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_out_bits	// connection-operators.md:163:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _c_io_a_ready;	// connection-operators.md:168:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _p_io_b_valid;	// connection-operators.md:167:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire [7:0] _p_io_b_bits;	// connection-operators.md:167:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage p (	// connection-operators.md:167:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (io_in_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (io_in_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (io_in_bits),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (_c_io_a_ready),	// connection-operators.md:168:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (_p_io_b_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (_p_io_b_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:167:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage c (	// connection-operators.md:168:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (_c_io_a_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (_p_io_b_valid),	// connection-operators.md:167:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (_p_io_b_bits),	// connection-operators.md:167:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (io_out_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (io_out_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (io_out_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:168:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// &quot;&quot;&quot;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Wrapper</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res5: String = &quot;&quot;&quot;// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module PipelineStage(	// connection-operators.md:182:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_a_ready,	// connection-operators.md:183:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_a_valid,	// connection-operators.md:183:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_a_bits,	// connection-operators.md:183:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_b_ready,	// connection-operators.md:183:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_b_valid,	// connection-operators.md:183:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_b_bits	// connection-operators.md:183:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_a_ready = io_b_ready;	// connection-operators.md:182:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_valid = io_a_valid;	// connection-operators.md:182:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_bits = io_a_bits;	// connection-operators.md:182:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module Wrapper(	// connection-operators.md:162:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        clock,	// connection-operators.md:162:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//                reset,	// connection-operators.md:162:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_in_ready,	// connection-operators.md:163:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_in_valid,	// connection-operators.md:163:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_in_bits,	// connection-operators.md:163:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_out_ready,	// connection-operators.md:163:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_out_valid,	// connection-operators.md:163:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_out_bits	// connection-operators.md:163:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _c_io_a_ready;	// connection-operators.md:168:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _p_io_b_valid;	// connection-operators.md:167:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire [7:0] _p_io_b_bits;	// connection-operators.md:167:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage p (	// connection-operators.md:167:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (io_in_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (io_in_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (io_in_bits),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (_c_io_a_ready),	// connection-operators.md:168:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (_p_io_b_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (_p_io_b_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:167:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage c (	// connection-operators.md:168:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (_c_io_a_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (_p_io_b_valid),	// connection-operators.md:167:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (_p_io_b_bits),	// connection-operators.md:167:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (io_out_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (io_out_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (io_out_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:168:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Wrapper_Verification_Cover.sv&quot;...</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="conclusion-2">Conclusion:<a href="#conclusion-2" class="hash-link" aria-label="Direct link to Conclusion:" title="Direct link to Conclusion:">​</a></h3>
 <p>If <code>&lt;&gt;</code> were used to assign the unidrectioned wire <code>tmp</code> to DontCare, we would get an error. But in the example above, we used <code>:=</code> and no errors occurred.
 But when <code>:=</code> was used to assign the wire to DontCare, no errors will occur.</p>
@@ -52,7 +52,7 @@ <h2 class="anchor anchorWithStickyNavbar_LWe7" id="concept-4-you-can-use--or--to
 ( Scastie link for the experiment:<a href="https://scastie.scala-lang.org/Shorla/ZIGsWcylRqKJhZCkKWlSIA/1" target="_blank" rel="noopener noreferrer">https://scastie.scala-lang.org/Shorla/ZIGsWcylRqKJhZCkKWlSIA/1</a>)</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">util</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">DecoupledIO</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">circt</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">stage</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">ChiselStage</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Wrapper </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> p </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> PipelineStage</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> PipelineStage</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">//connect Producer to IO</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DontCare</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> DontCare</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> tmp </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Wire</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  tmp </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DontCare</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// connect producer to consumer</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  c</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">//connect consumer to IO</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> c</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> PipelineStage </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Below we can see the resulting Verilog for this example:</p>
-<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Wrapper</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res7: String = &quot;&quot;&quot;// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module PipelineStage(	// connection-operators.md:232:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_a_ready,	// connection-operators.md:233:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_a_valid,	// connection-operators.md:233:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_a_bits,	// connection-operators.md:233:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_b_ready,	// connection-operators.md:233:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_b_valid,	// connection-operators.md:233:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_b_bits	// connection-operators.md:233:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_a_ready = io_b_ready;	// connection-operators.md:232:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_valid = io_a_valid;	// connection-operators.md:232:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_bits = io_a_bits;	// connection-operators.md:232:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module Wrapper(	// connection-operators.md:212:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        clock,	// connection-operators.md:212:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//                reset,	// connection-operators.md:212:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_in_ready,	// connection-operators.md:213:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_in_valid,	// connection-operators.md:213:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_in_bits,	// connection-operators.md:213:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_out_ready,	// connection-operators.md:213:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_out_valid,	// connection-operators.md:213:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_out_bits	// connection-operators.md:213:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _c_io_a_ready;	// connection-operators.md:218:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _p_io_b_valid;	// connection-operators.md:217:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire [7:0] _p_io_b_bits;	// connection-operators.md:217:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage p (	// connection-operators.md:217:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (io_in_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (io_in_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (io_in_bits),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (_c_io_a_ready),	// connection-operators.md:218:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (_p_io_b_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (_p_io_b_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:217:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage c (	// connection-operators.md:218:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (_c_io_a_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (_p_io_b_valid),	// connection-operators.md:217:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (_p_io_b_bits),	// connection-operators.md:217:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (io_out_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (io_out_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (io_out_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:218:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// &quot;&quot;&quot;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Wrapper</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res7: String = &quot;&quot;&quot;// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module PipelineStage(	// connection-operators.md:232:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_a_ready,	// connection-operators.md:233:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_a_valid,	// connection-operators.md:233:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_a_bits,	// connection-operators.md:233:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_b_ready,	// connection-operators.md:233:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_b_valid,	// connection-operators.md:233:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_b_bits	// connection-operators.md:233:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_a_ready = io_b_ready;	// connection-operators.md:232:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_valid = io_a_valid;	// connection-operators.md:232:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_bits = io_a_bits;	// connection-operators.md:232:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module Wrapper(	// connection-operators.md:212:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        clock,	// connection-operators.md:212:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//                reset,	// connection-operators.md:212:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_in_ready,	// connection-operators.md:213:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_in_valid,	// connection-operators.md:213:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_in_bits,	// connection-operators.md:213:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_out_ready,	// connection-operators.md:213:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_out_valid,	// connection-operators.md:213:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_out_bits	// connection-operators.md:213:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _c_io_a_ready;	// connection-operators.md:218:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _p_io_b_valid;	// connection-operators.md:217:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire [7:0] _p_io_b_bits;	// connection-operators.md:217:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage p (	// connection-operators.md:217:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (io_in_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (io_in_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (io_in_bits),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (_c_io_a_ready),	// connection-operators.md:218:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (_p_io_b_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (_p_io_b_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:217:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage c (	// connection-operators.md:218:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (_c_io_a_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (_p_io_b_valid),	// connection-operators.md:217:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (_p_io_b_bits),	// connection-operators.md:217:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (io_out_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (io_out_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (io_out_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:218:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Wrapper_Verification_Cover.sv&quot;...</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="conclusion-3">Conclusion:<a href="#conclusion-3" class="hash-link" aria-label="Direct link to Conclusion:" title="Direct link to Conclusion:">​</a></h3>
 <p>Both <code>&lt;&gt;</code> and <code>:=</code> can be used to assign directioned things (IOs) to DontCare as shown in <code>io.in</code> and <code>p.io.a</code> respectively. This is basically equivalent because in this case both <code>&lt;&gt;</code> and <code>:=</code> will determine the direction from the LHS.</p>
 <h2 class="anchor anchorWithStickyNavbar_LWe7" id="concept-5---works-between-things-with-at-least-one-known-flow-an-io-or-childs-io">Concept 5: <code>&lt;&gt;</code>  works between things with at least one known flow (An IO or child&#x27;s IO).<a href="#concept-5---works-between-things-with-at-least-one-known-flow-an-io-or-childs-io" class="hash-link" aria-label="Direct link to concept-5---works-between-things-with-at-least-one-known-flow-an-io-or-childs-io" title="Direct link to concept-5---works-between-things-with-at-least-one-known-flow-an-io-or-childs-io">​</a></h2>
@@ -60,7 +60,7 @@ <h2 class="anchor anchorWithStickyNavbar_LWe7" id="concept-5---works-between-thi
 ( Scastie link for the experiment:<a href="https://scastie.scala-lang.org/Shorla/gKx9ReLVTTqDTk9vmw5ozg" target="_blank" rel="noopener noreferrer">https://scastie.scala-lang.org/Shorla/gKx9ReLVTTqDTk9vmw5ozg</a>)</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">util</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">DecoupledIO</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">circt</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">stage</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">ChiselStage</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Wrapper </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> p </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> PipelineStage</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> PipelineStage</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">//connect Producer to IO</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// For this experiment, we add a temporary wire and see if it works...</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">//p.io.a &lt;&gt; io.in</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> tmp </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Wire</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// connect intermediate wire</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  tmp </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> tmp</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// connect producer to consumer</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  c</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">//connect consumer to IO</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> c</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> PipelineStage </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Below we can see the resulting Verilog for this example:</p>
-<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Wrapper</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res9: String = &quot;&quot;&quot;// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module PipelineStage(	// connection-operators.md:283:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_a_ready,	// connection-operators.md:284:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_a_valid,	// connection-operators.md:284:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_a_bits,	// connection-operators.md:284:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_b_ready,	// connection-operators.md:284:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_b_valid,	// connection-operators.md:284:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_b_bits	// connection-operators.md:284:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_a_ready = io_b_ready;	// connection-operators.md:283:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_valid = io_a_valid;	// connection-operators.md:283:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_bits = io_a_bits;	// connection-operators.md:283:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module Wrapper(	// connection-operators.md:262:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        clock,	// connection-operators.md:262:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//                reset,	// connection-operators.md:262:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_in_ready,	// connection-operators.md:263:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_in_valid,	// connection-operators.md:263:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_in_bits,	// connection-operators.md:263:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_out_ready,	// connection-operators.md:263:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_out_valid,	// connection-operators.md:263:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_out_bits	// connection-operators.md:263:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _c_io_a_ready;	// connection-operators.md:268:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _p_io_b_valid;	// connection-operators.md:267:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire [7:0] _p_io_b_bits;	// connection-operators.md:267:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage p (	// connection-operators.md:267:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (io_in_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (io_in_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (io_in_bits),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (_c_io_a_ready),	// connection-operators.md:268:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (_p_io_b_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (_p_io_b_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:267:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage c (	// connection-operators.md:268:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (_c_io_a_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (_p_io_b_valid),	// connection-operators.md:267:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (_p_io_b_bits),	// connection-operators.md:267:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (io_out_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (io_out_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (io_out_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:268:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// &quot;&quot;&quot;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Wrapper</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res9: String = &quot;&quot;&quot;// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module PipelineStage(	// connection-operators.md:283:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_a_ready,	// connection-operators.md:284:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_a_valid,	// connection-operators.md:284:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_a_bits,	// connection-operators.md:284:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_b_ready,	// connection-operators.md:284:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_b_valid,	// connection-operators.md:284:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_b_bits	// connection-operators.md:284:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_a_ready = io_b_ready;	// connection-operators.md:283:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_valid = io_a_valid;	// connection-operators.md:283:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_bits = io_a_bits;	// connection-operators.md:283:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module Wrapper(	// connection-operators.md:262:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        clock,	// connection-operators.md:262:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//                reset,	// connection-operators.md:262:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_in_ready,	// connection-operators.md:263:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_in_valid,	// connection-operators.md:263:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_in_bits,	// connection-operators.md:263:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_out_ready,	// connection-operators.md:263:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_out_valid,	// connection-operators.md:263:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_out_bits	// connection-operators.md:263:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _c_io_a_ready;	// connection-operators.md:268:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _p_io_b_valid;	// connection-operators.md:267:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire [7:0] _p_io_b_bits;	// connection-operators.md:267:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage p (	// connection-operators.md:267:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (io_in_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (io_in_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (io_in_bits),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (_c_io_a_ready),	// connection-operators.md:268:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (_p_io_b_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (_p_io_b_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:267:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage c (	// connection-operators.md:268:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (_c_io_a_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (_p_io_b_valid),	// connection-operators.md:267:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (_p_io_b_bits),	// connection-operators.md:267:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (io_out_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (io_out_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (io_out_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:268:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Wrapper_Verification_Cover.sv&quot;...</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="conclusion-4">Conclusion:<a href="#conclusion-4" class="hash-link" aria-label="Direct link to Conclusion:" title="Direct link to Conclusion:">​</a></h3>
 <p>The connection above went smoothly with no errors, this goes to show <code>&lt;&gt;</code> will work as long as there is at least one directioned thing (IO or submodule&#x27;s IO) to &quot;fix&quot; the direction.</p>
 <h2 class="anchor anchorWithStickyNavbar_LWe7" id="concept-6--and--connect-signals-by-field-name">Concept 6: <code>&lt;&gt;</code> and <code>:=</code> connect signals by field name.<a href="#concept-6--and--connect-signals-by-field-name" class="hash-link" aria-label="Direct link to concept-6--and--connect-signals-by-field-name" title="Direct link to concept-6--and--connect-signals-by-field-name">​</a></h2>
@@ -68,7 +68,7 @@ <h2 class="anchor anchorWithStickyNavbar_LWe7" id="concept-6--and--connect-signa
 ( Scastie link for the experiment:<a href="https://scastie.scala-lang.org/Uf4tQquvQYigZAW705NFIQ" target="_blank" rel="noopener noreferrer">https://scastie.scala-lang.org/Uf4tQquvQYigZAW705NFIQ</a>)</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">util</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">DecoupledIO</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">circt</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">stage</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">ChiselStage</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MockDecoupledIO </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> valid </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> ready </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> bits </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Wrapper </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MockDecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MockDecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> p </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> PipelineStage</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> PipelineStage</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// connect producer to I/O</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// connect producer  to consumer</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  c</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// connect consumer to I/O</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> c</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> PipelineStage </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Below we can see the resulting Verilog for this example:</p>
-<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Wrapper</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res11: String = &quot;&quot;&quot;// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module PipelineStage(	// connection-operators.md:336:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_a_ready,	// connection-operators.md:337:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_a_valid,	// connection-operators.md:337:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_a_bits,	// connection-operators.md:337:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_b_ready,	// connection-operators.md:337:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_b_valid,	// connection-operators.md:337:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_b_bits	// connection-operators.md:337:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_a_ready = io_b_ready;	// connection-operators.md:336:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_valid = io_a_valid;	// connection-operators.md:336:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_bits = io_a_bits;	// connection-operators.md:336:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module Wrapper(	// connection-operators.md:320:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        clock,	// connection-operators.md:320:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//                reset,	// connection-operators.md:320:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//                io_in_valid,	// connection-operators.md:321:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_in_ready,	// connection-operators.md:321:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_in_bits,	// connection-operators.md:321:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_out_valid,	// connection-operators.md:321:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_out_ready,	// connection-operators.md:321:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_out_bits	// connection-operators.md:321:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _c_io_a_ready;	// connection-operators.md:326:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _p_io_b_valid;	// connection-operators.md:325:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire [7:0] _p_io_b_bits;	// connection-operators.md:325:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage p (	// connection-operators.md:325:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (io_in_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (io_in_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (io_in_bits),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (_c_io_a_ready),	// connection-operators.md:326:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (_p_io_b_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (_p_io_b_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:325:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage c (	// connection-operators.md:326:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (_c_io_a_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (_p_io_b_valid),	// connection-operators.md:325:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (_p_io_b_bits),	// connection-operators.md:325:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (io_out_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (io_out_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (io_out_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:326:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// &quot;&quot;&quot;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Wrapper</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res11: String = &quot;&quot;&quot;// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module PipelineStage(	// connection-operators.md:336:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_a_ready,	// connection-operators.md:337:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_a_valid,	// connection-operators.md:337:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_a_bits,	// connection-operators.md:337:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_b_ready,	// connection-operators.md:337:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_b_valid,	// connection-operators.md:337:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_b_bits	// connection-operators.md:337:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_a_ready = io_b_ready;	// connection-operators.md:336:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_valid = io_a_valid;	// connection-operators.md:336:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   assign io_b_bits = io_a_bits;	// connection-operators.md:336:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module Wrapper(	// connection-operators.md:320:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        clock,	// connection-operators.md:320:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//                reset,	// connection-operators.md:320:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//                io_in_valid,	// connection-operators.md:321:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_in_ready,	// connection-operators.md:321:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input  [7:0] io_in_bits,	// connection-operators.md:321:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output       io_out_valid,	// connection-operators.md:321:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input        io_out_ready,	// connection-operators.md:321:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   output [7:0] io_out_bits	// connection-operators.md:321:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _c_io_a_ready;	// connection-operators.md:326:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire       _p_io_b_valid;	// connection-operators.md:325:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   wire [7:0] _p_io_b_bits;	// connection-operators.md:325:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage p (	// connection-operators.md:325:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (io_in_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (io_in_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (io_in_bits),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (_c_io_a_ready),	// connection-operators.md:326:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (_p_io_b_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (_p_io_b_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:325:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   PipelineStage c (	// connection-operators.md:326:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_ready (_c_io_a_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_valid (_p_io_b_valid),	// connection-operators.md:325:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_a_bits  (_p_io_b_bits),	// connection-operators.md:325:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_ready (io_out_ready),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_valid (io_out_valid),</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//     .io_b_bits  (io_out_bits)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   );	// connection-operators.md:326:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Wrapper_Verification_Cover.sv&quot;...</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>And here is another experiment, where we remove one of the fields of MockDecoupledIO:
 ( Scastie link for the experiment:<a href="https://scastie.scala-lang.org/ChtkhKCpS9CvJkjjqpdeIA" target="_blank" rel="noopener noreferrer">https://scastie.scala-lang.org/ChtkhKCpS9CvJkjjqpdeIA</a>)</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">util</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">DecoupledIO</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">circt</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">stage</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">ChiselStage</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MockDecoupledIO </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> valid </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> ready </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Bool</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">//val bits = Output(UInt(8.W))</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Wrapper </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MockDecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MockDecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> p </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> PipelineStage</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> PipelineStage</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// connect producer to I/O</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// connect producer  to consumer</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  c</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> p</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// connect consumer to I/O</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> c</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> PipelineStage </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DecoupledIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
diff --git a/docs/explanations/data-types.html b/docs/explanations/data-types.html
index 70aa2b4e5b..18c13c9c68 100644
--- a/docs/explanations/data-types.html
+++ b/docs/explanations/data-types.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Chisel Data Types | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/data-types"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Chisel Data Types | Chisel"><meta data-rh="true" name="description" content="Chisel datatypes are used to specify the type of values held in state"><meta data-rh="true" property="og:description" content="Chisel datatypes are used to specify the type of values held in state"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/data-types"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/data-types" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/data-types" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/dataview.html b/docs/explanations/dataview.html
index 0a7c1b8f36..d021ab46ae 100644
--- a/docs/explanations/dataview.html
+++ b/docs/explanations/dataview.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">DataView | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/dataview"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="DataView | Chisel"><meta data-rh="true" name="description" content="New in Chisel 3.5"><meta data-rh="true" property="og:description" content="New in Chisel 3.5"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/dataview"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/dataview" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/dataview" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
@@ -34,7 +34,7 @@ <h2 class="anchor anchorWithStickyNavbar_LWe7" id="a-motivating-example-axi4">A
 A more &quot;Chisel-y&quot; implementation of this interface might look like:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Note that both the AW and AR channels look similar and could use the same Bundle definition</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> AXIAddressChannel</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> addrWidth</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">Int</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> id </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> addr </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">addrWidth</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> len </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> size </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// ...</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">util</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">Decoupled</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// We can compose the various AXI channels together</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> AXIBundle</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> addrWidth</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">Int</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> aw </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Decoupled</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> AXIAddressChannel</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">addrWidth</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// val ar = new AXIAddressChannel</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// ... Other channels here ...</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Instantiated as</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MyModule </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> axi </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> AXIBundle</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">20</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Of course, this would result in very different looking Verilog:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">MyModule</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:60:33</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         axi_aw_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:53:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        axi_aw_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:53:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">  axi_aw_bits_id</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:53:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">19</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> axi_aw_bits_addr</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:53:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">  axi_aw_bits_len</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:53:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">                axi_aw_bits_size	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:53:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> axi_aw_valid </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:60:33</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> axi_aw_bits_id </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:60:33</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> axi_aw_bits_addr </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">20&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:60:33</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> axi_aw_bits_len </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:60:33</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> axi_aw_bits_size </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:60:33</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">MyModule</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:60:33</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         axi_aw_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:53:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        axi_aw_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:53:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">  axi_aw_bits_id</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:53:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">19</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> axi_aw_bits_addr</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:53:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">  axi_aw_bits_len</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:53:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">                axi_aw_bits_size	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:53:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> axi_aw_valid </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:60:33</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> axi_aw_bits_id </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:60:33</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> axi_aw_bits_addr </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">20&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:60:33</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> axi_aw_bits_len </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:60:33</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> axi_aw_bits_size </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:60:33</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_MyModule_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_MyModule_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_MyModule_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_MyModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_MyModule_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_MyModule_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_MyModule_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_MyModule_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>So how can we use our more structured types while maintaining expected Verilog interfaces?
 Meet DataView:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">dataview</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// We recommend putting DataViews in a companion object of one of the involved types</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">object</span><span class="token plain"> AXIBundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// Don&#x27;t be afraid of the use of implicits, we will discuss this pattern in more detail later</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">implicit</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> axiView </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DataView</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">VerilogAXIBundle</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> AXIBundle</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// The first argument is a function constructing an object of View type (AXIBundle)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// from an object of the Target type (VerilogAXIBundle)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    vab </span><span class="token keyword" style="color:#00009f">=&gt;</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> AXIBundle</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">vab</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">addrWidth</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// The remaining arguments are a mapping of the corresponding fields of the two types</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">AWVALID </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">aw</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">AWREADY </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">aw</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">AWID </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">aw</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">bits</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">id</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">AWADDR </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">aw</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">bits</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">addr</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">AWLEN </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">aw</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">bits</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">len</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">AWSIZE </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">aw</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">bits</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">size</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// ...</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
@@ -44,7 +44,7 @@ <h2 class="anchor anchorWithStickyNavbar_LWe7" id="a-motivating-example-axi4">A
 it were the more structured type:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> AXIStub </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> AXI </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> VerilogAXIBundle</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">20</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> view </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> AXI</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">viewAs</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">AXIBundle</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// We can now manipulate `AXI` via `view`</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  view</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">aw</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">bits </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">0.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">asTypeOf</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> AXIAddressChannel</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">20</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// zero everything out by default</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  view</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">aw</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">valid </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token boolean" style="color:#36acaa">true</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">B</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  when </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">view</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">aw</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">ready</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    view</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">aw</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">bits</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">id </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">5.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    view</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">aw</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">bits</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">addr </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1234.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// We can still manipulate AXI as well</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    AXI</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">AWLEN </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This will generate Verilog that matches the standard naming convention:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">AXIStub</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:93:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        AXI_AWVALID</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:94:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         AXI_AWREADY</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:94:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">  AXI_AWID</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:94:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">19</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> AXI_AWADDR</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:94:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">  AXI_AWLEN</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:94:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">                AXI_AWSIZE	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:94:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> AXI_AWVALID </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:93:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> AXI_AWID </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> AXI_AWREADY </span><span class="token operator" style="color:#393A34">?</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h5</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:93:7, :98:16, :100:24, :101:21</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> AXI_AWADDR </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> AXI_AWREADY </span><span class="token operator" style="color:#393A34">?</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">20&#x27;h4D2</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">20&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:93:7, :98:16, :100:24, :102:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> AXI_AWLEN </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> AXI_AWREADY</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:93:7, :98:16, :100:24, :104:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> AXI_AWSIZE </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:93:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">AXIStub</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:93:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        AXI_AWVALID</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:94:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         AXI_AWREADY</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:94:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">  AXI_AWID</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:94:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">19</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> AXI_AWADDR</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:94:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">  AXI_AWLEN</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:94:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">                AXI_AWSIZE	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:94:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> AXI_AWVALID </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:93:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> AXI_AWID </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> AXI_AWREADY </span><span class="token operator" style="color:#393A34">?</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h5</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:93:7, :98:16, :100:24, :101:21</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> AXI_AWADDR </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> AXI_AWREADY </span><span class="token operator" style="color:#393A34">?</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">20&#x27;h4D2</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">20&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:93:7, :98:16, :100:24, :102:23</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> AXI_AWLEN </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> AXI_AWREADY</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:93:7, :98:16, :100:24, :104:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> AXI_AWSIZE </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:93:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_AXIStub_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_AXIStub_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AXIStub_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AXIStub_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AXIStub_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_AXIStub_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_AXIStub_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AXIStub_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AXIStub_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AXIStub_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_AXIStub_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_AXIStub_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AXIStub_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AXIStub_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AXIStub_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_AXIStub_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_AXIStub_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_AXIStub_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_AXIStub_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Note that if both the <em>Target</em> and the <em>View</em> types are subtypes of <code>Data</code> (as they are in this example),
 the <code>DataView</code> is <em>invertible</em>.
 This means that we can easily create a <code>DataView[AXIBundle, VerilogAXIBundle]</code> from our existing
@@ -55,7 +55,7 @@ <h2 class="anchor anchorWithStickyNavbar_LWe7" id="a-motivating-example-axi4">A
 types:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> ConnectionExample </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> AXIBundle</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">20</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Flipped</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> VerilogAXIBundle</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">20</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">viewAs</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">AXIBundle</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> </span><span class="token generics punctuation" style="color:#393A34">&lt;</span><span class="token generics punctuation" style="color:#393A34">&gt;</span><span class="token plain"> in</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This results in the corresponding fields being connected in the emitted Verilog:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">ConnectionExample</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:124:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         in_aw_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:125:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        in_aw_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:125:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">  in_aw_bits_id</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:125:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">19</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in_aw_bits_addr</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:125:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">  in_aw_bits_len</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:125:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">                in_aw_bits_size</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:125:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         out_AWVALID</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:126:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        out_AWREADY</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:126:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">  out_AWID</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:126:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">19</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_AWADDR</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:126:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">  out_AWLEN</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:126:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">                out_AWSIZE	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:126:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_aw_valid </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_AWVALID</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:124:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_aw_bits_id </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_AWID</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:124:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_aw_bits_addr </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_AWADDR</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:124:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_aw_bits_len </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_AWLEN</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:124:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_aw_bits_size </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_AWSIZE</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:124:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_AWREADY </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in_aw_ready</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:124:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">ConnectionExample</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:124:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         in_aw_ready</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:125:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        in_aw_valid</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:125:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">  in_aw_bits_id</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:125:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">19</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in_aw_bits_addr</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:125:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">  in_aw_bits_len</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:125:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">                in_aw_bits_size</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:125:14</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         out_AWVALID</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:126:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain">        out_AWREADY</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:126:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">  out_AWID</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:126:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">19</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_AWADDR</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:126:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain">  out_AWLEN</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:126:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">                out_AWSIZE	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:126:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_aw_valid </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_AWVALID</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:124:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_aw_bits_id </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_AWID</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:124:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_aw_bits_addr </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_AWADDR</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:124:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_aw_bits_len </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_AWLEN</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:124:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> in_aw_bits_size </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out_AWSIZE</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:124:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_AWREADY </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in_aw_ready</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:124:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_ConnectionExample_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_ConnectionExample_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ConnectionExample_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ConnectionExample_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ConnectionExample_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_ConnectionExample_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_ConnectionExample_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ConnectionExample_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ConnectionExample_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ConnectionExample_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_ConnectionExample_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_ConnectionExample_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ConnectionExample_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ConnectionExample_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ConnectionExample_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_ConnectionExample_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ConnectionExample_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ConnectionExample_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ConnectionExample_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h2 class="anchor anchorWithStickyNavbar_LWe7" id="other-use-cases">Other Use Cases<a href="#other-use-cases" class="hash-link" aria-label="Direct link to Other Use Cases" title="Direct link to Other Use Cases">​</a></h2>
 <p>While the ability to map between <code>Bundle</code> types as in the AXI4 example is pretty compelling,
 DataView has many other applications.
@@ -90,7 +90,7 @@ <h2 class="anchor anchorWithStickyNavbar_LWe7" id="totality-and-partialdataview"
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// We forgot BundleA.foo in the mapping!</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">implicit</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> myView </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DataView</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">BundleA</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> BundleB</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_ </span><span class="token keyword" style="color:#00009f">=&gt;</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> BundleB</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">bar </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">fizz</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> BadMapping </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">   </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> BundleA</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">   </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> BundleB</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">   out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">viewAs</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">BundleB</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// We must run Chisel to see the error</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">getVerilogString</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> BadMapping</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// chisel3.experimental.dataview.package$InvalidViewException: Viewing BadMapping.in: IO[BundleA] as BundleB is non-Total!</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   Target field &#x27;_.foo&#x27; is missing.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   DataView used is DataView(defined @[dataview.md:228:49]).</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   If the view *should* be non-total, try a &#x27;PartialDataView&#x27;.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at ... ()</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp6$$anonfun$55$BadMapping$1$$anonfun$60.apply(dataview.md:232)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp6$$anonfun$55$BadMapping$1$$anonfun$60.apply(dataview.md:232)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.Data.$anonfun$$colon$eq$1(Data.scala:806)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at scala.runtime.java8.JFunction0$mcV$sp.apply(JFunction0$mcV$sp.scala:18)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.experimental.prefix$.apply(prefix.scala:33)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.Data.$colon$eq(Data.scala:806)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp6$$anonfun$55$BadMapping$1.&lt;init&gt;(dataview.md:232)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp6$$anonfun$55$$anonfun$apply$67.apply(dataview.md:234)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at repl.MdocSession$MdocApp6$$anonfun$55$$anonfun$apply$67.apply(dataview.md:234)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.Module$.evaluate(Module.scala:94)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.Module$.do_apply(Module.scala:37)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.stage.phases.Elaborate.$anonfun$transform$2(Elaborate.scala:54)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.internal.Builder$.$anonfun$buildImpl$1(Builder.scala:1081)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.internal.Builder$.buildImpl(Builder.scala:1071)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at chisel3.internal.Builder$.$anonfun$build$1(Builder.scala:1063)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at logger.Logger$.$anonfun$makeScope$4(Logger.scala:148)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at scala.util.DynamicVariable.withValue(DynamicVariable.scala:59)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at logger.Logger$.makeScope(Logger.scala:146)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at logger.Logger$.makeScope(Logger.scala:133)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at ... ()</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// 	at ... (Stack trace trimmed to user code only. Rerun with --full-stacktrace to see the full stack trace)</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>As that error suggests, if we <em>want</em> the view to be non-total, we can use a <code>PartialDataView</code>:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// A PartialDataView does not have to be total for the Target</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">implicit</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> myView </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> PartialDataView</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">BundleA</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> BundleB</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_ </span><span class="token keyword" style="color:#00009f">=&gt;</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> BundleB</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">bar </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">fizz</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// myView: DataView[BundleA, BundleB] = PartialDataView(defined @[dataview.md:243:56])</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> PartialDataViewModule </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">   </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> BundleA</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">   </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> BundleB</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">   out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">viewAs</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">BundleB</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">PartialDataViewModule</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:246:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:246:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:246:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in_foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:247:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               in_bar</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:247:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_fizz	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:248:16</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_fizz </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in_bar</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:246:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">PartialDataViewModule</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:246:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:246:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:246:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in_foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:247:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               in_bar</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:247:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out_fizz	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:248:16</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_fizz </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in_bar</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:246:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_PartialDataViewModule_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_PartialDataViewModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_PartialDataViewModule_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_PartialDataViewModule_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_PartialDataViewModule_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_PartialDataViewModule_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_PartialDataViewModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_PartialDataViewModule_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_PartialDataViewModule_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_PartialDataViewModule_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_PartialDataViewModule_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_PartialDataViewModule_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_PartialDataViewModule_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_PartialDataViewModule_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_PartialDataViewModule_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_PartialDataViewModule_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_PartialDataViewModule_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_PartialDataViewModule_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_PartialDataViewModule_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>While <code>PartialDataViews</code> need not be total for the <em>Target</em>, both <code>PartialDataViews</code> and <code>DataViews</code>
 must always be total for the <em>View</em>.
 This has the consequence that <code>PartialDataViews</code> are <strong>not</strong> invertible in the same way as <code>DataViews</code>.</p>
@@ -117,7 +117,7 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="type-classes">Type Classes<a
 </ol>
 <p>For <code>DataView</code>, (1) is crucial because we want to be able to implement <code>DataViews</code> of built-in Scala
 types like tuples and <code>Seqs</code>. Furthermore, <code>DataView</code> has two type parameters (the <em>Target</em> and the
-<em>View</em> types) so inheritance does not really make sense—which type would <code>extend</code> <code>DataView</code>?</p>
+<em>View</em> types) so inheritance does not really make sense—which type would <code>extend</code> <code>DataView</code>?</p>
 <p>In Scala 2, type classes are not a built-in language feature, but rather are implemented using implicits.
 There are great resources out there for interested readers:</p>
 <ul>
@@ -173,11 +173,11 @@ <h4 class="anchor anchorWithStickyNavbar_LWe7" id="implicit-resolution-example">
 <p>This provides an implementation of <code>DataView</code> in the <em>implicit scope</em> as a &quot;default&quot; mapping between
 <code>Foo</code> and <code>Bar</code> (and it doesn&#x27;t even require an import!):</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> FooToBar </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Foo</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> bar </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bar</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  bar </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> foo</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">viewAs</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">Bar</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">FooToBar</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:300:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:300:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:300:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> foo_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:301:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               foo_b</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:301:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> bar_c</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:302:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               bar_d	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:302:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar_c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> foo_a</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:300:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar_d </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> foo_b</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:300:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">FooToBar</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:300:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:300:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:300:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> foo_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:301:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               foo_b</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:301:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> bar_c</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:302:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               bar_d	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:302:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar_c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> foo_a</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:300:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar_d </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> foo_b</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:300:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_FooToBar_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_FooToBar_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_FooToBar_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_FooToBar_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_FooToBar_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_FooToBar_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_FooToBar_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_FooToBar_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_FooToBar_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_FooToBar_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_FooToBar_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_FooToBar_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_FooToBar_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_FooToBar_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_FooToBar_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_FooToBar_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_FooToBar_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_FooToBar_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_FooToBar_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>However, it&#x27;s possible that some user of <code>Foo</code> and <code>Bar</code> wants different behavior,
 perhaps they would prefer more of &quot;swizzling&quot; behavior rather than a direct mapping:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">object</span><span class="token plain"> Swizzle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">implicit</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> swizzle </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DataView</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">Foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> Bar</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">_ </span><span class="token keyword" style="color:#00009f">=&gt;</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bar</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">d</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b </span><span class="token operator" style="color:#393A34">-&gt;</span><span class="token plain"> _</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">c</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Current scope always wins over implicit scope</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> Swizzle</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> FooToBarSwizzled </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Foo</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> bar </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bar</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  bar </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> foo</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">viewAs</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">Bar</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">FooToBarSwizzled</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:324:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:324:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:324:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> foo_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:325:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               foo_b</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:325:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> bar_c</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:326:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               bar_d	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:326:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar_c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> foo_b</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:324:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar_d </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> foo_a</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:324:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">FooToBarSwizzled</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:324:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:324:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:324:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> foo_a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:325:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               foo_b</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:325:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> bar_c</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:326:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               bar_d	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:326:15</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar_c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> foo_b</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:324:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar_d </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> foo_a</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// dataview.md:324:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_FooToBarSwizzled_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_FooToBarSwizzled_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_FooToBarSwizzled_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_FooToBarSwizzled_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_FooToBarSwizzled_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_FooToBarSwizzled_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_FooToBarSwizzled_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_FooToBarSwizzled_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_FooToBarSwizzled_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_FooToBarSwizzled_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_FooToBarSwizzled_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_FooToBarSwizzled_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_FooToBarSwizzled_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_FooToBarSwizzled_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_FooToBarSwizzled_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_FooToBarSwizzled_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_FooToBarSwizzled_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_FooToBarSwizzled_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_FooToBarSwizzled_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="dataproduct">DataProduct<a href="#dataproduct" class="hash-link" aria-label="Direct link to DataProduct" title="Direct link to DataProduct">​</a></h3>
 <p><code>DataProduct</code> is a type class used by <code>DataView</code> to validate the correctness of a user-provided mapping.
 In order for a type to be &quot;viewable&quot; (ie. the <code>Target</code> type of a <code>DataView</code>), it must have an
diff --git a/docs/explanations/decoder.html b/docs/explanations/decoder.html
index 5d3db329b1..c2f954a23b 100644
--- a/docs/explanations/decoder.html
+++ b/docs/explanations/decoder.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Decoders | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/decoder"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Decoders | Chisel"><meta data-rh="true" name="description" content="It is common in a complex design to recognize certain patterns from a big UInt coming from a data bus and dispatch"><meta data-rh="true" property="og:description" content="It is common in a complex design to recognize certain patterns from a big UInt coming from a data bus and dispatch"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/decoder"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/decoder" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/decoder" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/functional-abstraction.html b/docs/explanations/functional-abstraction.html
index 222bb8cb11..689abefecd 100644
--- a/docs/explanations/functional-abstraction.html
+++ b/docs/explanations/functional-abstraction.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Functional Abstraction | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/functional-abstraction"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Functional Abstraction | Chisel"><meta data-rh="true" name="description" content="We can define functions to factor out a repeated piece of logic that"><meta data-rh="true" property="og:description" content="We can define functions to factor out a repeated piece of logic that"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/functional-abstraction"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/functional-abstraction" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/functional-abstraction" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/functional-module-creation.html b/docs/explanations/functional-module-creation.html
index d90b24ab5a..38e6806b7a 100644
--- a/docs/explanations/functional-module-creation.html
+++ b/docs/explanations/functional-module-creation.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Functional Module Creation | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/functional-module-creation"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Functional Module Creation | Chisel"><meta data-rh="true" name="description" content="Objects in Scala have a pre-existing creation function (method) called apply."><meta data-rh="true" property="og:description" content="Objects in Scala have a pre-existing creation function (method) called apply."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/functional-module-creation"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/functional-module-creation" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/functional-module-creation" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/instchoice.html b/docs/explanations/instchoice.html
index c7ba23c7ba..523dfb8733 100644
--- a/docs/explanations/instchoice.html
+++ b/docs/explanations/instchoice.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Instance Choices | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/instchoice"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Instance Choices | Chisel"><meta data-rh="true" name="description" content="Instance Choices are instances of modules whose targets are configurable post-elaboration."><meta data-rh="true" property="og:description" content="Instance Choices are instances of modules whose targets are configurable post-elaboration."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/instchoice"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/instchoice" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/instchoice" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/interfaces-and-connections.html b/docs/explanations/interfaces-and-connections.html
index d34b835b83..dfbec154a1 100644
--- a/docs/explanations/interfaces-and-connections.html
+++ b/docs/explanations/interfaces-and-connections.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Interfaces and Connections | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/interfaces-and-connections"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Interfaces and Connections | Chisel"><meta data-rh="true" name="description" content="For more sophisticated modules it is often useful to define and instantiate interface classes while defining the IO for a module. First and foremost, interface classes promote reuse allowing users to capture once and for all common interfaces in a useful form."><meta data-rh="true" property="og:description" content="For more sophisticated modules it is often useful to define and instantiate interface classes while defining the IO for a module. First and foremost, interface classes promote reuse allowing users to capture once and for all common interfaces in a useful form."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/interfaces-and-connections"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/interfaces-and-connections" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/interfaces-and-connections" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/intrinsics.html b/docs/explanations/intrinsics.html
index 619b58e1a1..1f7420fa99 100644
--- a/docs/explanations/intrinsics.html
+++ b/docs/explanations/intrinsics.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Intrinsics | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/intrinsics"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Intrinsics | Chisel"><meta data-rh="true" name="description" content="Chisel Intrinsics are used to express implementation defined functionality."><meta data-rh="true" property="og:description" content="Chisel Intrinsics are used to express implementation defined functionality."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/intrinsics"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/intrinsics" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/intrinsics" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/layers.html b/docs/explanations/layers.html
index e91a3dec8d..bac31f4561 100644
--- a/docs/explanations/layers.html
+++ b/docs/explanations/layers.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Layers | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/layers"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Layers | Chisel"><meta data-rh="true" name="description" content="Layers are used to describe functionality of a Chisel circuit or module that a"><meta data-rh="true" property="og:description" content="Layers are used to describe functionality of a Chisel circuit or module that a"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/layers"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/layers" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/layers" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
@@ -48,6 +48,21 @@ <h2 class="anchor anchorWithStickyNavbar_LWe7" id="conventions">Conventions<a hr
 SystemVerilog <code>bind</code> mechanism.  The lowering to Verilog of layer blocks avoids
 illegal nested usage of <code>bind</code>.</p>
 <p>More conventions may be supported in the future.</p>
+<h2 class="anchor anchorWithStickyNavbar_LWe7" id="built-in-layers-and-user-defined-layers">Built-in Layers and User-defined Layers<a href="#built-in-layers-and-user-defined-layers" class="hash-link" aria-label="Direct link to Built-in Layers and User-defined Layers" title="Direct link to Built-in Layers and User-defined Layers">​</a></h2>
+<p>Chisel provides several built-in layers.  These are shown below with their full
+Scala paths:</p>
+<div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">`chisel3.layers.Verification`</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">├── `chisel3.layers.Verification.Assert`</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">├── `chisel3.layers.Verification.Assume`</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">└── `chisel3.layers.Verification.Cover`</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<p>These built-in layers are dual purpose.  First, they are layers that match
+common use cases for sequestering verification code.  The <code>Verification</code> layer
+is for common verification collateral.  The <code>Assert</code>, <code>Assume</code>, and <code>Cover</code>
+layers are for, respectively, assertions, assumptions, and cover statements.
+Second, the Chisel standard library uses them for some of its APIs.</p>
+<p>For predictability of output, these layers will always be show up in the FIRRTL
+that Chisel emits.</p>
+<p>A user is free to define their own layers, as shown previously with layer <code>A</code>,
+<code>A.B</code>, etc.  User-defined layers are only emitted into FIRRTL if they have layer
+block users.  Layers can be unconditionally emitted using the
+<code>chisel3.layer.addLayer</code> API.</p>
 <h2 class="anchor anchorWithStickyNavbar_LWe7" id="examples">Examples<a href="#examples" class="hash-link" aria-label="Direct link to Examples" title="Direct link to Examples">​</a></h2>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="design-verification-example">Design Verification Example<a href="#design-verification-example" class="hash-link" aria-label="Direct link to Design Verification Example" title="Direct link to Design Verification Example">​</a></h3>
 <p>Consider a use case where a design or design verification engineer would like to
@@ -55,28 +70,33 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="design-verification-example">
 asserts and debug prints requires additional computation.  All of this code
 should not be included in the final Verilog.  The engineer can use three layers
 to do this.</p>
-<p>There are three layers that emerge from this example:</p>
+<p>There are four layers that emerge from this example.</p>
 <ol>
-<li>A common <code>Verification</code> layer</li>
-<li>An <code>Assert</code> layer nested under the <code>Verification</code> layer</li>
-<li>A <code>Debug</code> layer also nested under the <code>Verification</code> layer</li>
+<li>The built-in <code>Verification</code> layer</li>
+<li>The built-in <code>Assert</code> layer which is nested under the built-in <code>Verification</code>
+layer</li>
+<li>The built-in <code>Cover</code> layer which is also nested under the built-in
+<code>Verification</code> layer</li>
+<li>A user-defined <code>Debug</code> layer</li>
 </ol>
 <p>The <code>Verification</code> layer can be used to store common logic used by both the
-<code>Assert</code> and <code>Debug</code> layers.  The latter two layers allow for separation of,
-respectively, assertions from prints.</p>
+<code>Assert</code> and <code>Cover</code> layers.  The <code>Assert</code> and <code>Cover</code> layers contain,
+respectively, assertions and cover statements.  The <code>Debug</code> layer contains
+debugging prints.</p>
 <p>One way to write this in Scala is the following:</p>
-<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">layer</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">Layer</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> LayerConfig</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> block</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// All layers are declared here.  The Assert and Debug layers are nested under</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// the Verification layer.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">object</span><span class="token plain"> Verification </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Layer</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">LayerConfig</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Extract</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">object</span><span class="token plain"> Assert </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Layer</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">LayerConfig</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Extract</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">object</span><span class="token plain"> Debug </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Layer</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">LayerConfig</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Extract</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Foo </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  b </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">+</span><span class="token operator" style="color:#393A34">%</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// This adds a `Verification` layer block inside Foo.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  block</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Verification</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// Some common logic added here.  The input port `a` is &quot;captured&quot; and</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// used here.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> a_d0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> RegNext</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">a</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// This adds an `Assert` layer block.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    block</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Verification</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Assert</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      chisel3</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">assert</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">a </span><span class="token operator" style="color:#393A34">&gt;=</span><span class="token plain"> a_d0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;a must always increment&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// This adds a `Debug` layer block.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    block</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Verification</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Debug</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      printf</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;a: %x, a_d0: %x&quot;</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> a_d0</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">layer</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain">Layer</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> LayerConfig</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> block</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">layers</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// User-defined layers are declared here.  Built-in layers do not need to be declared.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">object</span><span class="token plain"> Debug </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Layer</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">LayerConfig</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Extract</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Foo </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  b </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">+</span><span class="token operator" style="color:#393A34">%</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// This adds a `Verification` layer block inside Foo.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  block</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Verification</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// Some common logic added here.  The input port `a` is &quot;captured&quot; and</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// used here.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> a_d0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> RegNext</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">a</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// This adds an `Assert` layer block.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    block</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Verification</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Assert</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      chisel3</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">assert</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">a </span><span class="token operator" style="color:#393A34">&gt;=</span><span class="token plain"> a_d0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;a must always increment&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// This adds a `Cover` layer block.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    block</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Verification</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">Cover</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      chisel3</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">cover</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">a </span><span class="token operator" style="color:#393A34">==</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;a_ took a value of 8&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      chisel3</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">cover</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">a_d0 </span><span class="token operator" style="color:#393A34">==</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;a_d0 took a value of 8&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// This adds a `Debug` layer block.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  block</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Debug</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    printf</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;a: %x&quot;</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> a</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>After compilation, this will produce three layer include files with the
 following filenames.  One file is created for each layer:</p>
 <ol>
 <li><code>layers_Foo_Verification.sv</code></li>
 <li><code>layers_Foo_Verification_Assert.sv</code></li>
-<li><code>layers_Foo_Verification_Debug.sv</code></li>
+<li><code>layers_Foo_Verification_Cover.sv</code></li>
+<li><code>layers_Foo_Debug.sv</code></li>
 </ol>
 <p>A user can then include any combination of these files in their design to
-include the optional functionality describe by the <code>Verification</code>, <code>Assert</code>, or
-<code>Debug</code> layers.  The <code>Assert</code> and <code>Debug</code> bind files automatically include the
-<code>Verification</code> bind file for the user.</p>
+include the optional functionality describe by the <code>Verification</code>, <code>Assert</code>,
+<code>Cover</code>, or <code>Debug</code> layers.  The <code>Assert</code> and <code>Cover</code> bind files automatically
+include the <code>Verification</code> bind file for the user.</p>
 <h4 class="anchor anchorWithStickyNavbar_LWe7" id="implementation-notes">Implementation Notes<a href="#implementation-notes" class="hash-link" aria-label="Direct link to Implementation Notes" title="Direct link to Implementation Notes">​</a></h4>
 <p><em>Note: the names of the modules and the names of any files that contain these
 modules are FIRRTL compiler implementation defined!  The only guarantee is the
@@ -88,18 +108,20 @@ <h4 class="anchor anchorWithStickyNavbar_LWe7" id="implementation-notes">Impleme
 <li><code>Foo</code></li>
 <li><code>Foo_Verification</code></li>
 <li><code>Foo_Verification_Assert</code></li>
-<li><code>Foo_Verification_Debug</code></li>
+<li><code>Foo_Verification_Cover</code></li>
+<li><code>Foo_Debug</code></li>
 </ol>
 <p>These will typically be created in separate files with names that match the
 modules, i.e., <code>Foo.sv</code>, <code>Foo_Verification.sv</code>, <code>Foo_Verification_Assert.sv</code>,
-and <code>Foo_Verification_Debug.sv</code>.</p>
+<code>Foo_Verification_Cover.sv</code>, and <code>Foo_Debug.sv</code>.</p>
 <p>The ports of each module created from a layer block will be automatically
 determined based on what that layer block captured from outside the layer block.
 In the example above, the <code>Verification</code> layer block captured port <code>a</code>.  Both
-the <code>Assert</code> and <code>Debug</code> layer blocks captured <code>a</code> and <code>a_d0</code>.  Layer blocks may
-be optimized to remove/add ports or to move logic into a layer block.</p>
+the <code>Assert</code> and <code>Cover</code> layer blocks captured <code>a</code> and <code>a_d0</code>.  The <code>Debug</code>
+layer only captured <code>a</code>.  Layer blocks may be optimized to remove/add ports or
+to move logic into a layer block.</p>
 <h4 class="anchor anchorWithStickyNavbar_LWe7" id="verilog-output">Verilog Output<a href="#verilog-output" class="hash-link" aria-label="Direct link to Verilog Output" title="Direct link to Verilog Output">​</a></h4>
 <p>The complete Verilog output for this example is reproduced below:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Foo</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">                reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">32&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Debug/layers_Foo_Verification_Debug.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Foo_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Foo_Verification_Debug</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Foo_Verification_Debug</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">bind</span><span class="token plain"> Foo Foo_Verification_Debug verification_debug </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">reset </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">reset</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">clock </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Foo</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">verification</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">clock_probe_0</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a     </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Foo</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">verification</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a_probe_0</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a_d0  </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Foo</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">verification</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a_d0_probe_0</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Foo_Verification_Debug</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Foo_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Foo_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Foo_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Foo_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">bind</span><span class="token plain"> Foo Foo_Verification_Assert verification_assert </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a     </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Foo</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">verification</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a_probe</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a_d0  </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Foo</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">verification</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a_d0_probe</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">reset </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">reset</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">clock </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Foo</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">verification</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">clock_probe</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Foo_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Foo_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Foo_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Foo_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">bind</span><span class="token plain"> Foo Foo_Verification verification </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">clock </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a     </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">a</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Foo_Verification</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/Foo_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Users can define &#x27;STOP_COND&#x27; to add an extra gate to stop conditions.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> STOP_COND_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`ifdef</span><span class="token plain"> STOP_COND</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> STOP_COND_ </span><span class="token punctuation" style="color:#393A34">(</span><span class="token constant" style="color:#36acaa">`STOP_COND</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`else</span><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// STOP_COND</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> STOP_COND_ </span><span class="token number" style="color:#36acaa">1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// STOP_COND</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// not def STOP_COND_</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Users can define &#x27;ASSERT_VERBOSE_COND&#x27; to add an extra gate to assert error printing.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> ASSERT_VERBOSE_COND_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`ifdef</span><span class="token plain"> ASSERT_VERBOSE_COND</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> ASSERT_VERBOSE_COND_ </span><span class="token punctuation" style="color:#393A34">(</span><span class="token constant" style="color:#36acaa">`ASSERT_VERBOSE_COND</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`else</span><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// ASSERT_VERBOSE_COND</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> ASSERT_VERBOSE_COND_ </span><span class="token number" style="color:#36acaa">1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// ASSERT_VERBOSE_COND</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// not def ASSERT_VERBOSE_COND_</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Foo_Verification_Assert</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               a_d0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               clock</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> SYNTHESIS</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">begin</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token operator" style="color:#393A34">~</span><span class="token plain">reset </span><span class="token operator" style="color:#393A34">&amp;</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">&lt;</span><span class="token plain"> a_d0</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">begin</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token constant" style="color:#36acaa">`ASSERT_VERBOSE_COND_</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token kernel-function property" style="color:#36acaa">$error</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;Assertion failed: a must always increment\n&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token constant" style="color:#36acaa">`STOP_COND_</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token kernel-function property" style="color:#36acaa">$fatal</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token keyword" style="color:#00009f">end</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">end</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// always @(posedge)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// not def SYNTHESIS</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Debug/Foo_Verification_Debug.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Users can define &#x27;PRINTF_COND&#x27; to add an extra gate to prints.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> PRINTF_COND_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`ifdef</span><span class="token plain"> PRINTF_COND</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> PRINTF_COND_ </span><span class="token punctuation" style="color:#393A34">(</span><span class="token constant" style="color:#36acaa">`PRINTF_COND</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`else</span><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// PRINTF_COND</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> PRINTF_COND_ </span><span class="token number" style="color:#36acaa">1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// PRINTF_COND</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// not def PRINTF_COND_</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Foo_Verification_Debug</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               a_d0</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> SYNTHESIS</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">begin</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token constant" style="color:#36acaa">`PRINTF_COND_</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">&amp;</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">~</span><span class="token plain">reset</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token kernel-function property" style="color:#36acaa">$fwrite</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32&#x27;h80000002</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;a: %x, a_d0: %x&quot;</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> a_d0</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">end</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// always @(posedge)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// not def SYNTHESIS</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Foo_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Foo_Verification</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain">        clock_probe </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a_probe </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> a</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a_probe_0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> a</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain">        clock_probe_0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a_d0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a_d0_probe </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> a_d0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a_d0_probe_0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> a_d0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    a_d0 </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> a</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/layers.md" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_vwxv"></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/docs/explanations/intrinsics"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Intrinsics</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/docs/explanations/memories"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Memories</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#conventions" class="table-of-contents__link toc-highlight">Conventions</a></li><li><a href="#examples" class="table-of-contents__link toc-highlight">Examples</a><ul><li><a href="#design-verification-example" class="table-of-contents__link toc-highlight">Design Verification Example</a></li></ul></li></ul></div></div></div></div></main></div></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">Docs</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/docs">Docs</a></li><li class="footer__item"><a href="/api/latest" target="_blank" rel="noopener noreferrer" class="footer__link-item">ScalaDoc</a></li></ul></div><div class="col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://stackoverflow.com/questions/tagged/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">Stack Overflow<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://gitter.im/freechipsproject/chisel3" target="_blank" rel="noopener noreferrer" class="footer__link-item">Gitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://twitter.com/chisel_lang" target="_blank" rel="noopener noreferrer" class="footer__link-item">Twitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">More</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://github.com/chipsalliance/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2024 ChipsAlliance. Built with Docusaurus.</div></div></div></footer></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Foo</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">         clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">                reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">32&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Debug/layers_Foo_Verification_Debug.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Foo_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Foo_Verification_Debug</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Foo_Verification_Debug</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Foo_Verification_Debug</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Foo_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Foo_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Foo_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Foo_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Foo_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Foo_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Foo_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Foo_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Foo_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">bind</span><span class="token plain"> Foo Foo_Verification_Cover verification_cover </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a     </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Foo</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">verification</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a_probe_0</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">reset </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">reset</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">clock </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Foo</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">verification</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">clock_probe_0</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a_d0  </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Foo</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">verification</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a_d0_probe_0</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Foo_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Foo_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Foo_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Foo_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Foo_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">bind</span><span class="token plain"> Foo Foo_Verification_Assert verification_assert </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a     </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Foo</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">verification</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a_probe</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a_d0  </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Foo</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">verification</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a_d0_probe</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">reset </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">reset</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">clock </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Foo</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">verification</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">clock_probe</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Foo_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Foo_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Foo_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Foo_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">bind</span><span class="token plain"> Foo Foo_Verification verification </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">clock </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a     </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">a</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Foo_Verification</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/Foo_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Users can define &#x27;STOP_COND&#x27; to add an extra gate to stop conditions.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> STOP_COND_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`ifdef</span><span class="token plain"> STOP_COND</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> STOP_COND_ </span><span class="token punctuation" style="color:#393A34">(</span><span class="token constant" style="color:#36acaa">`STOP_COND</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`else</span><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// STOP_COND</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> STOP_COND_ </span><span class="token number" style="color:#36acaa">1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// STOP_COND</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// not def STOP_COND_</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Users can define &#x27;ASSERT_VERBOSE_COND&#x27; to add an extra gate to assert error printing.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> ASSERT_VERBOSE_COND_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`ifdef</span><span class="token plain"> ASSERT_VERBOSE_COND</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> ASSERT_VERBOSE_COND_ </span><span class="token punctuation" style="color:#393A34">(</span><span class="token constant" style="color:#36acaa">`ASSERT_VERBOSE_COND</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`else</span><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// ASSERT_VERBOSE_COND</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> ASSERT_VERBOSE_COND_ </span><span class="token number" style="color:#36acaa">1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// ASSERT_VERBOSE_COND</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// not def ASSERT_VERBOSE_COND_</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Foo_Verification_Assert</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               a_d0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               clock</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> SYNTHESIS</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">begin</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token operator" style="color:#393A34">~</span><span class="token plain">reset </span><span class="token operator" style="color:#393A34">&amp;</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">&lt;</span><span class="token plain"> a_d0</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">begin</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token constant" style="color:#36acaa">`ASSERT_VERBOSE_COND_</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token kernel-function property" style="color:#36acaa">$error</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;Assertion failed: a must always increment\n&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token constant" style="color:#36acaa">`STOP_COND_</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">          </span><span class="token kernel-function property" style="color:#36acaa">$fatal</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token keyword" style="color:#00009f">end</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">end</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// always @(posedge)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// not def SYNTHESIS</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/Foo_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Foo_Verification_Cover</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a_d0</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">begin</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token operator" style="color:#393A34">~</span><span class="token plain">reset</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">begin</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      cover__cover</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">cover</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">a </span><span class="token operator" style="color:#393A34">==</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">32&#x27;h8</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      cover__cover_1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">cover</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">a_d0 </span><span class="token operator" style="color:#393A34">==</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">32&#x27;h8</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">end</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">end</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// always @(posedge)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Foo_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Foo_Verification</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain">        clock_probe </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a_probe </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> a</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain">        clock_probe_0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a_probe_0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> a</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a_d0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a_d0_probe </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> a_d0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a_d0_probe_0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> a_d0</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    a_d0 </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> a</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Debug/Foo_Debug.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Users can define &#x27;PRINTF_COND&#x27; to add an extra gate to prints.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> PRINTF_COND_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`ifdef</span><span class="token plain"> PRINTF_COND</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> PRINTF_COND_ </span><span class="token punctuation" style="color:#393A34">(</span><span class="token constant" style="color:#36acaa">`PRINTF_COND</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`else</span><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// PRINTF_COND</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> PRINTF_COND_ </span><span class="token number" style="color:#36acaa">1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// PRINTF_COND</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// not def PRINTF_COND_</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Foo_Debug</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">31</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> a</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> SYNTHESIS</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">begin</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token constant" style="color:#36acaa">`PRINTF_COND_</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">&amp;</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">~</span><span class="token plain">reset</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token kernel-function property" style="color:#36acaa">$fwrite</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32&#x27;h80000002</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;a: %x&quot;</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> a</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">end</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// always @(posedge)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// not def SYNTHESIS</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Debug/layers_Foo_Debug.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">bind</span><span class="token plain"> Foo Foo_Debug debug </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">reset </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">reset</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">clock </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a     </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">a</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/layers.md" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_vwxv"></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/docs/explanations/intrinsics"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Intrinsics</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/docs/explanations/memories"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Memories</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#conventions" class="table-of-contents__link toc-highlight">Conventions</a></li><li><a href="#built-in-layers-and-user-defined-layers" class="table-of-contents__link toc-highlight">Built-in Layers and User-defined Layers</a></li><li><a href="#examples" class="table-of-contents__link toc-highlight">Examples</a><ul><li><a href="#design-verification-example" class="table-of-contents__link toc-highlight">Design Verification Example</a></li></ul></li></ul></div></div></div></div></main></div></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">Docs</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/docs">Docs</a></li><li class="footer__item"><a href="/api/latest" target="_blank" rel="noopener noreferrer" class="footer__link-item">ScalaDoc</a></li></ul></div><div class="col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://stackoverflow.com/questions/tagged/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">Stack Overflow<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://gitter.im/freechipsproject/chisel3" target="_blank" rel="noopener noreferrer" class="footer__link-item">Gitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://twitter.com/chisel_lang" target="_blank" rel="noopener noreferrer" class="footer__link-item">Twitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">More</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://github.com/chipsalliance/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2024 ChipsAlliance. Built with Docusaurus.</div></div></div></footer></div>
 </body>
 </html>
\ No newline at end of file
diff --git a/docs/explanations/memories.html b/docs/explanations/memories.html
index 55cc03dece..a3a5393231 100644
--- a/docs/explanations/memories.html
+++ b/docs/explanations/memories.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Memories | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/memories"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Memories | Chisel"><meta data-rh="true" name="description" content="Chisel provides facilities for creating both read only and read/write memories."><meta data-rh="true" property="og:description" content="Chisel provides facilities for creating both read only and read/write memories."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/memories"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/memories" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/memories" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/modules.html b/docs/explanations/modules.html
index 854706e30c..a7f57267a4 100644
--- a/docs/explanations/modules.html
+++ b/docs/explanations/modules.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Modules | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/modules"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Modules | Chisel"><meta data-rh="true" name="description" content="Chisel modules are very similar to Verilog modules in"><meta data-rh="true" property="og:description" content="Chisel modules are very similar to Verilog modules in"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/modules"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/modules" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/modules" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/motivation.html b/docs/explanations/motivation.html
index 2ad8e4347c..6350d804a8 100644
--- a/docs/explanations/motivation.html
+++ b/docs/explanations/motivation.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Motivation | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/motivation"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Motivation | Chisel"><meta data-rh="true" name="description" content="We were motivated to develop a new hardware language by years of"><meta data-rh="true" property="og:description" content="We were motivated to develop a new hardware language by years of"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/motivation"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/motivation" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/motivation" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/multi-clock.html b/docs/explanations/multi-clock.html
index 1c9430954b..9df038ca62 100644
--- a/docs/explanations/multi-clock.html
+++ b/docs/explanations/multi-clock.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Multiple Clock Domains | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/multi-clock"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Multiple Clock Domains | Chisel"><meta data-rh="true" name="description" content="Chisel 3 supports multiple clock domains as follows."><meta data-rh="true" property="og:description" content="Chisel 3 supports multiple clock domains as follows."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/multi-clock"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/multi-clock" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/multi-clock" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/muxes-and-input-selection.html b/docs/explanations/muxes-and-input-selection.html
index 927a3c0346..e32cc64615 100644
--- a/docs/explanations/muxes-and-input-selection.html
+++ b/docs/explanations/muxes-and-input-selection.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Muxes and Input Selection | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/muxes-and-input-selection"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Muxes and Input Selection | Chisel"><meta data-rh="true" name="description" content="Selecting inputs is very useful in hardware description, and therefore Chisel provides several built-in generic input-selection implementations."><meta data-rh="true" property="og:description" content="Selecting inputs is very useful in hardware description, and therefore Chisel provides several built-in generic input-selection implementations."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/muxes-and-input-selection"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/muxes-and-input-selection" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/muxes-and-input-selection" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/naming.html b/docs/explanations/naming.html
index 1b27960b55..ae87785f30 100644
--- a/docs/explanations/naming.html
+++ b/docs/explanations/naming.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Naming | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/naming"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Naming | Chisel"><meta data-rh="true" name="description" content="Historically, Chisel has had trouble reliably capturing the names of signals. The reasons for this are due to (1)"><meta data-rh="true" property="og:description" content="Historically, Chisel has had trouble reliably capturing the names of signals. The reasons for this are due to (1)"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/naming"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/naming" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/naming" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
@@ -28,21 +28,21 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="compiler-plugin">Compiler Plu
 <p>If the line is within a bundle declaration or is a module instantiation, it is rewritten to replace the right hand
 side with a call to <code>autoNameRecursively</code>, which names the signal/module.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MyBundle </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">3.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// val foo = autoNameRecursively(&quot;foo&quot;)(Input(UInt(3.W)))</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example1 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyBundle</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// val io = autoNameRecursively(&quot;io&quot;)(IO(new MyBundle()))</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example1</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">       clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">              reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> io_foo</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example1</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">       clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">              reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> io_foo</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example1_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example1_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example1_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example1_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example1_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example1_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example1_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example1_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example1_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example1_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example1_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example1_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example1_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example1_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example1_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example1_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example1_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example1_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example1_Verification</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Otherwise, it is rewritten to also include the name as a prefix to any signals generated while executing the right-hand-
 side of the val declaration:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example2 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// val in = autoNameRecursively(&quot;in&quot;)(prefix(&quot;in&quot;)(IO(Input(UInt(2.W)))))</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// val out1 = autoNameRecursively(&quot;out1&quot;)(prefix(&quot;out1&quot;)(IO(Output(UInt(4.W)))))</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out2 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// val out2 = autoNameRecursively(&quot;out2&quot;)(prefix(&quot;out2&quot;)(IO(Output(UInt(4.W)))))</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out3 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// val out3 = autoNameRecursively(&quot;out3&quot;)(prefix(&quot;out3&quot;)(IO(Output(UInt(4.W)))))</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">def</span><span class="token plain"> func</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> squared </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">*</span><span class="token plain"> in</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// val squared = autoNameRecursively(&quot;squared&quot;)(prefix(&quot;squared&quot;)(in * in))</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    out1 </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> squared</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> delay </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> RegNext</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">squared</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// val delay = autoNameRecursively(&quot;delay&quot;)(prefix(&quot;delay&quot;)(RegNext(squared)))</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    delay</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> masked </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">0xa</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">U </span><span class="token operator" style="color:#393A34">&amp;</span><span class="token plain"> func</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// val masked = autoNameRecursively(&quot;masked&quot;)(prefix(&quot;masked&quot;)(0xa.U &amp; func()))</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// Note that values created inside of `func()`` are prefixed with `masked`</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out2 </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> masked </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out3 </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> masked </span><span class="token operator" style="color:#393A34">-</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example2</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out3</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> _GEN </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> in</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> masked_squared </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> _GEN </span><span class="token operator" style="color:#393A34">*</span><span class="token plain"> _GEN</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> masked_delay</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> masked </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> masked_delay </span><span class="token operator" style="color:#393A34">&amp;</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;hA</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    masked_delay </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> masked_squared</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> masked_squared</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out2 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> masked </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out3 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> masked </span><span class="token operator" style="color:#393A34">-</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example2</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out3</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> _GEN </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> in</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> masked_squared </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> _GEN </span><span class="token operator" style="color:#393A34">*</span><span class="token plain"> _GEN</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> masked_delay</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> masked </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> masked_delay </span><span class="token operator" style="color:#393A34">&amp;</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;hA</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    masked_delay </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> masked_squared</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> masked_squared</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out2 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> masked </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out3 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> masked </span><span class="token operator" style="color:#393A34">-</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example2_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example2_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example2_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example2_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example2_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example2_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example2_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example2_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example2_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example2_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example2_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example2_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example2_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example2_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example2_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example2_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example2_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example2_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example2_Verification</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Prefixing can also be derived from the name of signals on the left-hand side of a connection.
 While this is not implemented via the compiler plugin, the behavior should feel similar:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> ConnectPrefixing </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// val in = autoNameRecursively(&quot;in&quot;)(prefix(&quot;in&quot;)(IO(Input(UInt(2.W)))))</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// val out1 = autoNameRecursively(&quot;out1&quot;)(prefix(&quot;out1&quot;)(IO(Output(UInt(4.W)))))</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out2 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// val out2 = autoNameRecursively(&quot;out2&quot;)(prefix(&quot;out2&quot;)(IO(Output(UInt(4.W)))))</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out1 </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// technically this is not wrapped in autoNameRecursively nor prefix</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// But the Chisel runtime will still use the name of `out1` as a prefix</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> squared </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">*</span><span class="token plain"> in</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    out2 </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> squared</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> delayed </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> RegNext</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">squared</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// val delayed = autoNameRecursively(&quot;delayed&quot;)(prefix(&quot;delayed&quot;)(RegNext(squared)))</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    delayed </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">ConnectPrefixing</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out2</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> _GEN </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> in</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out1_squared </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> _GEN </span><span class="token operator" style="color:#393A34">*</span><span class="token plain"> _GEN</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out1_delayed</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    out1_delayed </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> out1_squared</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out1_delayed </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out2 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out1_squared</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">ConnectPrefixing</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out2</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> _GEN </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> in</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out1_squared </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> _GEN </span><span class="token operator" style="color:#393A34">*</span><span class="token plain"> _GEN</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out1_delayed</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    out1_delayed </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> out1_squared</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out1_delayed </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out2 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> out1_squared</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_ConnectPrefixing_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_ConnectPrefixing_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ConnectPrefixing_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ConnectPrefixing_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ConnectPrefixing_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_ConnectPrefixing_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_ConnectPrefixing_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ConnectPrefixing_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ConnectPrefixing_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ConnectPrefixing_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_ConnectPrefixing_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_ConnectPrefixing_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ConnectPrefixing_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ConnectPrefixing_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ConnectPrefixing_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_ConnectPrefixing_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ConnectPrefixing_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ConnectPrefixing_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ConnectPrefixing_Verification</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Note that the naming also works if the hardware type is nested in an <code>Option</code> or a subtype of <code>Iterable</code>:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example3 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// val in = autoNameRecursively(&quot;in&quot;)(prefix(&quot;in&quot;)(IO(Input(UInt(2.W)))))</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// val out = autoNameRecursively(&quot;out&quot;)(prefix(&quot;out&quot;)(IO(Output(UInt(4.W)))))</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">def</span><span class="token plain"> func</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> delay </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> RegNext</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    delay </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> opt </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Some</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">func</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// Note that the register in func() is prefixed with `opt`:</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// val opt = autoNameRecursively(&quot;opt&quot;)(prefix(&quot;opt&quot;)(Some(func()))</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> opt</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">get </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example3</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> opt_delay</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    opt_delay </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> opt_delay </span><span class="token operator" style="color:#393A34">-</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h2</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example3</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> opt_delay</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    opt_delay </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> opt_delay </span><span class="token operator" style="color:#393A34">-</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h2</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example3_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example3_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example3_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example3_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example3_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example3_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example3_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example3_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example3_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example3_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example3_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example3_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example3_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example3_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example3_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example3_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example3_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example3_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example3_Verification</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>There is also a slight variant (<code>autoNameRecursivelyProduct</code>) for naming hardware with names provided by an unapply:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> UnapplyExample </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">def</span><span class="token plain"> mkIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> mkIO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// val (in, out) = autoNameRecursivelyProduct(List(Some(&quot;in&quot;), Some(&quot;out&quot;)))(mkIO())</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">UnapplyExample</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">UnapplyExample</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_UnapplyExample_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_UnapplyExample_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_UnapplyExample_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_UnapplyExample_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_UnapplyExample_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_UnapplyExample_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_UnapplyExample_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_UnapplyExample_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_UnapplyExample_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_UnapplyExample_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_UnapplyExample_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_UnapplyExample_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_UnapplyExample_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_UnapplyExample_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_UnapplyExample_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_UnapplyExample_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_UnapplyExample_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_UnapplyExample_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_UnapplyExample_Verification</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Note that the compiler plugin will not insert a prefix in these cases because it is ambiguous what the prefix should be.
 Users who desire a prefix are encouraged to provide one as <a href="#prefixing">described below</a>.</p>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="prefixing">Prefixing<a href="#prefixing" class="hash-link" aria-label="Direct link to Prefixing" title="Direct link to Prefixing">​</a></h3>
@@ -50,35 +50,35 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="prefixing">Prefixing<a href="
 However, you as a user can also add your own prefixes by calling <code>prefix(...)</code>:</p>
 <p>Also note that the prefixes append to each other (including the prefix generated by the compiler plugin):</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example6 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> add </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> prefix</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;foo&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> sum </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> RegNext</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    sum </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> add</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example6</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> add_foo_sum</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    add_foo_sum </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> add_foo_sum </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example6</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> add_foo_sum</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    add_foo_sum </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> add_foo_sum </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example6_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example6_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example6_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example6_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example6_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example6_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example6_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example6_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example6_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example6_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example6_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example6_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example6_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example6_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example6_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example6_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example6_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example6_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example6_Verification</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Sometimes you may want to disable the prefixing. This might occur if you are writing a library function and
 don&#x27;t want the prefixing behavior. In this case, you can call <code>noPrefix</code>:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example7 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> add </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> noPrefix </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> sum </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> RegNext</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    sum </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> add</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example7</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> sum</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    sum </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> sum </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example7</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> sum</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    sum </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> sum </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example7_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example7_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example7_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example7_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example7_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example7_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example7_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example7_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example7_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example7_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example7_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example7_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example7_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example7_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example7_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example7_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example7_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example7_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example7_Verification</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="suggest-a-signals-name-or-the-instance-name-of-a-module">Suggest a Signal&#x27;s Name (or the instance name of a Module)<a href="#suggest-a-signals-name-or-the-instance-name-of-a-module" class="hash-link" aria-label="Direct link to Suggest a Signal&#x27;s Name (or the instance name of a Module)" title="Direct link to Suggest a Signal&#x27;s Name (or the instance name of a Module)">​</a></h3>
 <p>If you want to specify the name of a signal, you can always use the <code>.suggestName</code> API. Please note that the suggested
 name will still be prefixed (including by the plugin). You can always use the <code>noPrefix</code> object to strip this.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example8 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> add </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> sum </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> RegNext</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">suggestName</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;foo&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    sum </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> add</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example8</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> add_foo</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    add_foo </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> add_foo </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Example8</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> add_foo</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    add_foo </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> add_foo </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Example8_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example8_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example8_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example8_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example8_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Example8_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example8_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example8_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example8_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example8_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Example8_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_Example8_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example8_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example8_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example8_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_Example8_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_Example8_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_Example8_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_Example8_Verification</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Note that using <code>.suggestName</code> does <strong>not</strong> affect prefixes derived from val names;
 however, it <em>can</em> affect prefixes derived from connections (eg. <code>:=</code>):</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> ConnectionPrefixExample </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> port </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">5.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// Even though this suggestName is before mul, the prefix used in this scope</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// is derived from `val out0`, so this does not affect the name of mul</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    port</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">suggestName</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;foo&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// out0_mul</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> mul </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> RegNext</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in0 </span><span class="token operator" style="color:#393A34">*</span><span class="token plain"> in1</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    port </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> mul </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    port</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out2 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out1 </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// out1_sum</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> sum </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> RegNext</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in0 </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> in1</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    sum </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// Comes after so does *not* affect prefix above</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out1</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">suggestName</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;bar&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// Comes before so *does* affect prefix below</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out2</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">suggestName</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;fizz&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out2 </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// fizz_diff</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> diff </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> RegNext</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in0 </span><span class="token operator" style="color:#393A34">-</span><span class="token plain"> in1</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    diff </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">ConnectionPrefixExample</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               in1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">4</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> bar</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               fizz</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out0_mul</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out1_sum</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> fizz_diff</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">begin</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    out0_mul </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> in0</span><span class="token operator" style="color:#393A34">}</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">*</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> in1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    out1_sum </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in0 </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> in1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    fizz_diff </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in0 </span><span class="token operator" style="color:#393A34">-</span><span class="token plain"> in1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">end</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// always @(posedge)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> out0_mul </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> out1_sum </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> fizz </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> fizz_diff </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">ConnectionPrefixExample</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               in1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">4</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> foo</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> bar</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               fizz</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out0_mul</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out1_sum</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">reg</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> fizz_diff</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">begin</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    out0_mul </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> in0</span><span class="token operator" style="color:#393A34">}</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">*</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> in1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    out1_sum </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in0 </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> in1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    fizz_diff </span><span class="token operator" style="color:#393A34">&lt;=</span><span class="token plain"> in0 </span><span class="token operator" style="color:#393A34">-</span><span class="token plain"> in1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">end</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// always @(posedge)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> foo </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> out0_mul </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">4&#x27;h1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> bar </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> out1_sum </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> fizz </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> fizz_diff </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_ConnectionPrefixExample_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_ConnectionPrefixExample_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ConnectionPrefixExample_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ConnectionPrefixExample_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ConnectionPrefixExample_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_ConnectionPrefixExample_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_ConnectionPrefixExample_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ConnectionPrefixExample_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ConnectionPrefixExample_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ConnectionPrefixExample_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_ConnectionPrefixExample_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_ConnectionPrefixExample_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ConnectionPrefixExample_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ConnectionPrefixExample_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ConnectionPrefixExample_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_ConnectionPrefixExample_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_ConnectionPrefixExample_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_ConnectionPrefixExample_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_ConnectionPrefixExample_Verification</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>As this example illustrates, this behavior is slightly inconsistent so is subject to change in a future version of Chisel.</p>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="behavior-for-unnamed-signals-aka-temporaries">Behavior for &quot;Unnamed signals&quot; (aka &quot;Temporaries&quot;)<a href="#behavior-for-unnamed-signals-aka-temporaries" class="hash-link" aria-label="Direct link to Behavior for &quot;Unnamed signals&quot; (aka &quot;Temporaries&quot;)" title="Direct link to Behavior for &quot;Unnamed signals&quot; (aka &quot;Temporaries&quot;)">​</a></h3>
 <p>If you want to signify that the name of a signal does not matter, you can prefix the name of your val with <code>_</code>.
 Chisel will preserve the convention of leading <code>_</code> signifying an unnamed signal across prefixes.
 For example:</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> TemporaryExample </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// We need 2 ports so firtool will maintain the common subexpression</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> port0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// out_port1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> port1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> _sum </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in0 </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> in1</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    port0 </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> _sum </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    port1 </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> _sum </span><span class="token operator" style="color:#393A34">-</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token comment" style="color:#999988;font-style:italic">// port0 is returned so will get the name &quot;out&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    port0</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">TemporaryExample</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               in1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_port1</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> _out_sum_T </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in0 </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> in1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> _out_sum_T </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_port1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> _out_sum_T </span><span class="token operator" style="color:#393A34">-</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">TemporaryExample</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               in1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               out_port1</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> _out_sum_T </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in0 </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> in1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> _out_sum_T </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out_port1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> _out_sum_T </span><span class="token operator" style="color:#393A34">-</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_TemporaryExample_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_TemporaryExample_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_TemporaryExample_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_TemporaryExample_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_TemporaryExample_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_TemporaryExample_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_TemporaryExample_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_TemporaryExample_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_TemporaryExample_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_TemporaryExample_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_TemporaryExample_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_TemporaryExample_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_TemporaryExample_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_TemporaryExample_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_TemporaryExample_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_TemporaryExample_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_TemporaryExample_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_TemporaryExample_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_TemporaryExample_Verification</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>If an unnamed signal is itself used to generate a prefix, the leading <code>_</code> will be ignored to avoid double <code>__</code> in the names of further nested signals.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> TemporaryPrefixExample </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">2.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">3.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">4.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> _sum </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> x </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in0 </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> in1</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    out0 </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> x</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    x </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out1 </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> _sum </span><span class="token operator" style="color:#393A34">&amp;</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">0x2</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">U</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">TemporaryPrefixExample</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               in1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out1</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> _sum_x_T </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in0 </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> in1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> _sum_x_T</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> _sum_x_T </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">&amp;</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h2</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">TemporaryPrefixExample</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               in1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">3</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out1</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">wire</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">1</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> _sum_x_T </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in0 </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> in1</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out0 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> _sum_x_T</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> _sum_x_T </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h1</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">&amp;</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2&#x27;h2</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_TemporaryPrefixExample_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_TemporaryPrefixExample_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_TemporaryPrefixExample_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_TemporaryPrefixExample_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_TemporaryPrefixExample_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_TemporaryPrefixExample_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_TemporaryPrefixExample_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_TemporaryPrefixExample_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_TemporaryPrefixExample_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_TemporaryPrefixExample_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_TemporaryPrefixExample_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_TemporaryPrefixExample_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_TemporaryPrefixExample_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_TemporaryPrefixExample_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_TemporaryPrefixExample_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_TemporaryPrefixExample_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_TemporaryPrefixExample_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_TemporaryPrefixExample_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_TemporaryPrefixExample_Verification</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="set-a-module-name">Set a Module Name<a href="#set-a-module-name" class="hash-link" aria-label="Direct link to Set a Module Name" title="Direct link to Set a Module Name">​</a></h3>
 <p>If you want to specify the module&#x27;s name (not the instance name of a module), you can always override the <code>desiredName</code>
 value. Note that you can parameterize the name by the module&#x27;s parameters. This is an excellent way to make your module
 names more stable and is highly recommended to do.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Example9</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token builtin">Int</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">override</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> desiredName </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token string-interpolation id function" style="color:#d73a49">s</span><span class="token string-interpolation string" style="color:#e3116c">&quot;EXAMPLE9WITHWIDTH</span><span class="token string-interpolation interpolation punctuation" style="color:#393A34">$</span><span class="token string-interpolation interpolation expression">width</span><span class="token string-interpolation string" style="color:#e3116c">&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">width </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> add </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">suggestName</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string" style="color:#e3116c">&quot;foo&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> add</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">EXAMPLE9WITHWIDTH8</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token plain">in</span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">6</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token operator" style="color:#393A34">}}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">EXAMPLE9WITHWIDTH1</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> in</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/naming.md" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_vwxv"></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/docs/explanations/muxes-and-input-selection"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Muxes and Input Selection</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/docs/explanations/operators"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Operators</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#compiler-plugin" class="table-of-contents__link toc-highlight">Compiler Plugin</a></li><li><a href="#prefixing" class="table-of-contents__link toc-highlight">Prefixing</a></li><li><a href="#suggest-a-signals-name-or-the-instance-name-of-a-module" class="table-of-contents__link toc-highlight">Suggest a Signal&#39;s Name (or the instance name of a Module)</a></li><li><a href="#behavior-for-unnamed-signals-aka-temporaries" class="table-of-contents__link toc-highlight">Behavior for &quot;Unnamed signals&quot; (aka &quot;Temporaries&quot;)</a></li><li><a href="#set-a-module-name" class="table-of-contents__link toc-highlight">Set a Module Name</a></li></ul></div></div></div></div></main></div></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">Docs</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/docs">Docs</a></li><li class="footer__item"><a href="/api/latest" target="_blank" rel="noopener noreferrer" class="footer__link-item">ScalaDoc</a></li></ul></div><div class="col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://stackoverflow.com/questions/tagged/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">Stack Overflow<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://gitter.im/freechipsproject/chisel3" target="_blank" rel="noopener noreferrer" class="footer__link-item">Gitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://twitter.com/chisel_lang" target="_blank" rel="noopener noreferrer" class="footer__link-item">Twitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">More</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://github.com/chipsalliance/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2024 ChipsAlliance. Built with Docusaurus.</div></div></div></footer></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">EXAMPLE9WITHWIDTH8</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">9</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> in </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token plain">in</span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">6</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token number" style="color:#36acaa">1&#x27;h0</span><span class="token operator" style="color:#393A34">}}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_EXAMPLE9WITHWIDTH8_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_EXAMPLE9WITHWIDTH8_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_EXAMPLE9WITHWIDTH8_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_EXAMPLE9WITHWIDTH8_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_EXAMPLE9WITHWIDTH8_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_EXAMPLE9WITHWIDTH8_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_EXAMPLE9WITHWIDTH8_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_EXAMPLE9WITHWIDTH8_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_EXAMPLE9WITHWIDTH8_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_EXAMPLE9WITHWIDTH8_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_EXAMPLE9WITHWIDTH8_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_EXAMPLE9WITHWIDTH8_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_EXAMPLE9WITHWIDTH8_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_EXAMPLE9WITHWIDTH8_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_EXAMPLE9WITHWIDTH8_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_EXAMPLE9WITHWIDTH8_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_EXAMPLE9WITHWIDTH8_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_EXAMPLE9WITHWIDTH8_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_EXAMPLE9WITHWIDTH8_Verification</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">EXAMPLE9WITHWIDTH1</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               in</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">2</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">{</span><span class="token number" style="color:#36acaa">2&#x27;h0</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> in</span><span class="token operator" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_EXAMPLE9WITHWIDTH1_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_EXAMPLE9WITHWIDTH1_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_EXAMPLE9WITHWIDTH1_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_EXAMPLE9WITHWIDTH1_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_EXAMPLE9WITHWIDTH1_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_EXAMPLE9WITHWIDTH1_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_EXAMPLE9WITHWIDTH1_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_EXAMPLE9WITHWIDTH1_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_EXAMPLE9WITHWIDTH1_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_EXAMPLE9WITHWIDTH1_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_EXAMPLE9WITHWIDTH1_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_EXAMPLE9WITHWIDTH1_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_EXAMPLE9WITHWIDTH1_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_EXAMPLE9WITHWIDTH1_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_EXAMPLE9WITHWIDTH1_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_EXAMPLE9WITHWIDTH1_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_EXAMPLE9WITHWIDTH1_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_EXAMPLE9WITHWIDTH1_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_EXAMPLE9WITHWIDTH1_Verification</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/naming.md" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_vwxv"></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/docs/explanations/muxes-and-input-selection"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Muxes and Input Selection</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/docs/explanations/operators"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Operators</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#compiler-plugin" class="table-of-contents__link toc-highlight">Compiler Plugin</a></li><li><a href="#prefixing" class="table-of-contents__link toc-highlight">Prefixing</a></li><li><a href="#suggest-a-signals-name-or-the-instance-name-of-a-module" class="table-of-contents__link toc-highlight">Suggest a Signal&#39;s Name (or the instance name of a Module)</a></li><li><a href="#behavior-for-unnamed-signals-aka-temporaries" class="table-of-contents__link toc-highlight">Behavior for &quot;Unnamed signals&quot; (aka &quot;Temporaries&quot;)</a></li><li><a href="#set-a-module-name" class="table-of-contents__link toc-highlight">Set a Module Name</a></li></ul></div></div></div></div></main></div></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">Docs</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/docs">Docs</a></li><li class="footer__item"><a href="/api/latest" target="_blank" rel="noopener noreferrer" class="footer__link-item">ScalaDoc</a></li></ul></div><div class="col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://stackoverflow.com/questions/tagged/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">Stack Overflow<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://gitter.im/freechipsproject/chisel3" target="_blank" rel="noopener noreferrer" class="footer__link-item">Gitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://twitter.com/chisel_lang" target="_blank" rel="noopener noreferrer" class="footer__link-item">Twitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">More</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://github.com/chipsalliance/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2024 ChipsAlliance. Built with Docusaurus.</div></div></div></footer></div>
 </body>
 </html>
\ No newline at end of file
diff --git a/docs/explanations/operators.html b/docs/explanations/operators.html
index 52e0ab4513..5c6fb6b169 100644
--- a/docs/explanations/operators.html
+++ b/docs/explanations/operators.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Operators | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/operators"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Operators | Chisel"><meta data-rh="true" name="description" content="Chisel defines a set of hardware operators:"><meta data-rh="true" property="og:description" content="Chisel defines a set of hardware operators:"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/operators"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/operators" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/operators" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/polymorphism-and-parameterization.html b/docs/explanations/polymorphism-and-parameterization.html
index 7b8f41e0c8..a97118ef18 100644
--- a/docs/explanations/polymorphism-and-parameterization.html
+++ b/docs/explanations/polymorphism-and-parameterization.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Polymorphism and Parameterization | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/polymorphism-and-parameterization"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Polymorphism and Parameterization | Chisel"><meta data-rh="true" name="description" content="This section is advanced and can be skipped at first reading."><meta data-rh="true" property="og:description" content="This section is advanced and can be skipped at first reading."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/polymorphism-and-parameterization"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/polymorphism-and-parameterization" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/polymorphism-and-parameterization" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
@@ -46,6 +46,6 @@ <h2 class="anchor anchorWithStickyNavbar_LWe7" id="parametrization-based-on-modu
 <p>You can also parametrize modules based on other modules rather than just types. The following is an example of a module parametrized by other modules as opposed to e.g. types.</p>
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">RawModule</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">experimental</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">BaseModule</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">circt</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">stage</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">ChiselStage</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Provides a more specific interface since generic Module</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// provides no compile-time information on generic module&#x27;s IOs.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">trait</span><span class="token plain"> MyAdder </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">def</span><span class="token plain"> in1</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> UInt</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">def</span><span class="token plain"> in2</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> UInt</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">def</span><span class="token plain"> out</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> UInt</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Mod1 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token keyword" style="color:#00009f">with</span><span class="token plain"> MyAdder </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in2 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in1 </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> in2</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Mod2 </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> RawModule </span><span class="token keyword" style="color:#00009f">with</span><span class="token plain"> MyAdder </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in2 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in1 </span><span class="token operator" style="color:#393A34">-</span><span class="token plain"> in2</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> X</span><span class="token punctuation" style="color:#393A34">[</span><span class="token plain">T </span><span class="token operator" style="color:#393A34">&lt;</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> BaseModule </span><span class="token keyword" style="color:#00009f">with</span><span class="token plain"> MyAdder</span><span class="token punctuation" style="color:#393A34">]</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">genT</span><span class="token operator" style="color:#393A34">:</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">=&gt;</span><span class="token plain"> T</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in1 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> in2 </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> subMod </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">genT</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> subMod</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    subMod</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in1 </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in1</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    subMod</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in2 </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> io</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in2</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">println</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> X</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Mod1</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">println</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> X</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Mod2</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Output:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Mod1</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:170:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:171:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               in2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:172:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:173:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in1 </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> in2</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:170:7, :174:16</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">X</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:186:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:186:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:186:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> io_in1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:187:16</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:187:16</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> io_out	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:187:16</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  Mod1 subMod </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:192:24</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in1 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">io_in1</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in2 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">io_in2</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">io_out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:192:24</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Mod2</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:178:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:179:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               in2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:180:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:181:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in1 </span><span class="token operator" style="color:#393A34">-</span><span class="token plain"> in2</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:178:7, :182:16</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">X</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:186:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:186:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:186:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> io_in1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:187:16</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:187:16</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> io_out	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:187:16</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  Mod2 subMod </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:192:24</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in1 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">io_in1</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in2 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">io_in2</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">io_out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:192:24</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/polymorphism-and-parameterization.md" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_vwxv"></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/docs/explanations/operators"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Operators</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/docs/explanations/ports"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Ports</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#parameterized-functions" class="table-of-contents__link toc-highlight">Parameterized Functions</a></li><li><a href="#parameterized-classes" class="table-of-contents__link toc-highlight">Parameterized Classes</a></li><li><a href="#parametrization-based-on-modules" class="table-of-contents__link toc-highlight">Parametrization based on Modules</a></li></ul></div></div></div></div></main></div></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">Docs</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/docs">Docs</a></li><li class="footer__item"><a href="/api/latest" target="_blank" rel="noopener noreferrer" class="footer__link-item">ScalaDoc</a></li></ul></div><div class="col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://stackoverflow.com/questions/tagged/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">Stack Overflow<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://gitter.im/freechipsproject/chisel3" target="_blank" rel="noopener noreferrer" class="footer__link-item">Gitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://twitter.com/chisel_lang" target="_blank" rel="noopener noreferrer" class="footer__link-item">Twitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">More</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://github.com/chipsalliance/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2024 ChipsAlliance. Built with Docusaurus.</div></div></div></footer></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Mod1</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:170:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:171:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               in2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:172:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:173:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in1 </span><span class="token operator" style="color:#393A34">+</span><span class="token plain"> in2</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:170:7, :174:16</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">X</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:186:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:186:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:186:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> io_in1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:187:16</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:187:16</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> io_out	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:187:16</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  Mod1 subMod </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:192:24</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in1 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">io_in1</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in2 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">io_in2</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">io_out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:192:24</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_X_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_X_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_X_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_X_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_X_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_X_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_X_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_X_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_X_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_X_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_X_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_X_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_X_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_X_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_X_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_X_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_X_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_X_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_X_Verification	// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">Mod2</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:178:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> in1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:179:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               in2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:180:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> out	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:181:17</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">assign</span><span class="token plain"> out </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> in1 </span><span class="token operator" style="color:#393A34">-</span><span class="token plain"> in2</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:178:7, :182:16</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">X</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:186:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">        clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:186:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               reset</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:186:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> io_in1</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:187:16</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">               io_in2</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:187:16</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">output</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">[</span><span class="token number" style="color:#36acaa">7</span><span class="token punctuation" style="color:#393A34">:</span><span class="token number" style="color:#36acaa">0</span><span class="token punctuation" style="color:#393A34">]</span><span class="token plain"> io_out	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:187:16</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  Mod2 subMod </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:192:24</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in1 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">io_in1</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">in2 </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">io_in2</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">out </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">io_out</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// polymorphism-and-parameterization.md:192:24</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_X_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_X_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_X_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_X_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_X_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_X_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_X_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_X_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_X_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_X_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_X_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_X_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_X_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_X_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_X_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_X_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_X_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_X_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_X_Verification	// &lt;stdin&gt;:3:3</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/polymorphism-and-parameterization.md" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_vwxv"></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/docs/explanations/operators"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Operators</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/docs/explanations/ports"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Ports</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#parameterized-functions" class="table-of-contents__link toc-highlight">Parameterized Functions</a></li><li><a href="#parameterized-classes" class="table-of-contents__link toc-highlight">Parameterized Classes</a></li><li><a href="#parametrization-based-on-modules" class="table-of-contents__link toc-highlight">Parametrization based on Modules</a></li></ul></div></div></div></div></main></div></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">Docs</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/docs">Docs</a></li><li class="footer__item"><a href="/api/latest" target="_blank" rel="noopener noreferrer" class="footer__link-item">ScalaDoc</a></li></ul></div><div class="col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://stackoverflow.com/questions/tagged/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">Stack Overflow<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://gitter.im/freechipsproject/chisel3" target="_blank" rel="noopener noreferrer" class="footer__link-item">Gitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://twitter.com/chisel_lang" target="_blank" rel="noopener noreferrer" class="footer__link-item">Twitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">More</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://github.com/chipsalliance/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2024 ChipsAlliance. Built with Docusaurus.</div></div></div></footer></div>
 </body>
 </html>
\ No newline at end of file
diff --git a/docs/explanations/ports.html b/docs/explanations/ports.html
index 9344c09368..2e0bca30df 100644
--- a/docs/explanations/ports.html
+++ b/docs/explanations/ports.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Ports | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/ports"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Ports | Chisel"><meta data-rh="true" name="description" content="Ports are used as interfaces to hardware components.  A port is simply"><meta data-rh="true" property="og:description" content="Ports are used as interfaces to hardware components.  A port is simply"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/ports"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/ports" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/ports" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
@@ -25,6 +25,6 @@ <h2 class="anchor anchorWithStickyNavbar_LWe7" id="inspecting-module-ports">Insp
 <p>(Chisel 3.2+)</p>
 <p>Chisel 3.2 introduced <code>DataMirror.modulePorts</code> which can be used to inspect the IOs of any Chisel module (this includes modules in both <code>import chisel3._</code> and <code>import Chisel._</code>, as well as BlackBoxes from each package).
 Here is an example of how to use this API:</p>
-<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">reflect</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">DataMirror</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">stage</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">ChiselGeneratorAnnotation</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">circt</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">stage</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">ChiselStage</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Adder </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  c </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">+</span><span class="token operator" style="color:#393A34">&amp;</span><span class="token plain"> b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Test </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> adder </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Adder</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// for debug only</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  adder</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DontCare</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  adder</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DontCare</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// Inspect ports of adder</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// See the result below.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">   DataMirror</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">modulePorts</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">adder</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">foreach </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">case</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">name</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> port</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">=&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    println</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string-interpolation id function" style="color:#d73a49">s</span><span class="token string-interpolation string" style="color:#e3116c">&quot;Found port </span><span class="token string-interpolation interpolation punctuation" style="color:#393A34">$</span><span class="token string-interpolation interpolation expression">name</span><span class="token string-interpolation string" style="color:#e3116c">: </span><span class="token string-interpolation interpolation punctuation" style="color:#393A34">$</span><span class="token string-interpolation interpolation expression">port</span><span class="token string-interpolation string" style="color:#e3116c">&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Test</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Found port clock: Adder.clock: IO[Clock]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Found port reset: Adder.reset: IO[Reset]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Found port a: Adder.a: IO[UInt&lt;8&gt;]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Found port b: Adder.b: IO[UInt&lt;8&gt;]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Found port c: Adder.c: IO[UInt&lt;8&gt;]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res0: String = &quot;&quot;&quot;// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module Test(	// ports.md:41:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input clock,	// ports.md:41:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//         reset	// ports.md:41:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// &quot;&quot;&quot;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/ports.md" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_vwxv"></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/docs/explanations/polymorphism-and-parameterization"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Polymorphism and Parameterization</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/docs/explanations/printing"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Printing</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#inspecting-module-ports" class="table-of-contents__link toc-highlight">Inspecting Module ports</a></li></ul></div></div></div></div></main></div></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">Docs</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/docs">Docs</a></li><li class="footer__item"><a href="/api/latest" target="_blank" rel="noopener noreferrer" class="footer__link-item">ScalaDoc</a></li></ul></div><div class="col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://stackoverflow.com/questions/tagged/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">Stack Overflow<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://gitter.im/freechipsproject/chisel3" target="_blank" rel="noopener noreferrer" class="footer__link-item">Gitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://twitter.com/chisel_lang" target="_blank" rel="noopener noreferrer" class="footer__link-item">Twitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">More</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://github.com/chipsalliance/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2024 ChipsAlliance. Built with Docusaurus.</div></div></div></footer></div>
+<div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">reflect</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">DataMirror</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">stage</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">ChiselGeneratorAnnotation</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">circt</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">stage</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">ChiselStage</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Adder </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> b </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Input</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> c </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">Output</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">UInt</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">8.</span><span class="token plain">W</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  c </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> a </span><span class="token operator" style="color:#393A34">+</span><span class="token operator" style="color:#393A34">&amp;</span><span class="token plain"> b</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> Test </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> adder </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> Module</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Adder</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// for debug only</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  adder</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">a </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DontCare</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  adder</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">b </span><span class="token operator" style="color:#393A34">:</span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> DontCare</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// Inspect ports of adder</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// See the result below.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">   DataMirror</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">modulePorts</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">adder</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">foreach </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">case</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">name</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> port</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">=&gt;</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    println</span><span class="token punctuation" style="color:#393A34">(</span><span class="token string-interpolation id function" style="color:#d73a49">s</span><span class="token string-interpolation string" style="color:#e3116c">&quot;Found port </span><span class="token string-interpolation interpolation punctuation" style="color:#393A34">$</span><span class="token string-interpolation interpolation expression">name</span><span class="token string-interpolation string" style="color:#e3116c">: </span><span class="token string-interpolation interpolation punctuation" style="color:#393A34">$</span><span class="token string-interpolation interpolation expression">port</span><span class="token string-interpolation string" style="color:#e3116c">&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitSystemVerilog</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Test</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Found port clock: Adder.clock: IO[Clock]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Found port reset: Adder.reset: IO[Reset]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Found port a: Adder.a: IO[UInt&lt;8&gt;]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Found port b: Adder.b: IO[UInt&lt;8&gt;]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Found port c: Adder.c: IO[UInt&lt;8&gt;]</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// res0: String = &quot;&quot;&quot;// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// module Test(	// ports.md:41:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//   input clock,	// ports.md:41:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">//         reset	// ports.md:41:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// );</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_Test_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `include &quot;Verification/layers_Test_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `ifndef layers_Test_Verification_Cover</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `define layers_Test_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `endif // layers_Test_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_Test_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `include &quot;Verification/layers_Test_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `ifndef layers_Test_Verification_Assume</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `define layers_Test_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `endif // layers_Test_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_Test_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `include &quot;Verification/layers_Test_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `ifndef layers_Test_Verification_Assert</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `define layers_Test_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `endif // layers_Test_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // ----- 8&lt; ----- FILE &quot;Verification/layers_Test_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// </span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// // Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `ifndef layers_Test_Verification</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `define layers_Test_Verification	// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// `endif // layers_Test_Verification	// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// &quot;&quot;&quot;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div></div><footer class="theme-doc-footer docusaurus-mt-lg"><div class="theme-doc-footer-edit-meta-row row"><div class="col"><a href="https://github.com/chipsalliance/chisel/tree/main/docs/src/explanations/ports.md" target="_blank" rel="noopener noreferrer" class="theme-edit-this-page"><svg fill="currentColor" height="20" width="20" viewBox="0 0 40 40" class="iconEdit_Z9Sw" aria-hidden="true"><g><path d="m34.5 11.7l-3 3.1-6.3-6.3 3.1-3q0.5-0.5 1.2-0.5t1.1 0.5l3.9 3.9q0.5 0.4 0.5 1.1t-0.5 1.2z m-29.5 17.1l18.4-18.5 6.3 6.3-18.4 18.4h-6.3v-6.2z"></path></g></svg>Edit this page</a></div><div class="col lastUpdated_vwxv"></div></div></footer></article><nav class="pagination-nav docusaurus-mt-lg" aria-label="Docs pages"><a class="pagination-nav__link pagination-nav__link--prev" href="/docs/explanations/polymorphism-and-parameterization"><div class="pagination-nav__sublabel">Previous</div><div class="pagination-nav__label">Polymorphism and Parameterization</div></a><a class="pagination-nav__link pagination-nav__link--next" href="/docs/explanations/printing"><div class="pagination-nav__sublabel">Next</div><div class="pagination-nav__label">Printing</div></a></nav></div></div><div class="col col--3"><div class="tableOfContents_bqdL thin-scrollbar theme-doc-toc-desktop"><ul class="table-of-contents table-of-contents__left-border"><li><a href="#inspecting-module-ports" class="table-of-contents__link toc-highlight">Inspecting Module ports</a></li></ul></div></div></div></div></main></div></div></div><footer class="footer footer--dark"><div class="container container-fluid"><div class="row footer__links"><div class="col footer__col"><div class="footer__title">Docs</div><ul class="footer__items clean-list"><li class="footer__item"><a class="footer__link-item" href="/docs">Docs</a></li><li class="footer__item"><a href="/api/latest" target="_blank" rel="noopener noreferrer" class="footer__link-item">ScalaDoc</a></li></ul></div><div class="col footer__col"><div class="footer__title">Community</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://stackoverflow.com/questions/tagged/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">Stack Overflow<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://gitter.im/freechipsproject/chisel3" target="_blank" rel="noopener noreferrer" class="footer__link-item">Gitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li><li class="footer__item"><a href="https://twitter.com/chisel_lang" target="_blank" rel="noopener noreferrer" class="footer__link-item">Twitter<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div><div class="col footer__col"><div class="footer__title">More</div><ul class="footer__items clean-list"><li class="footer__item"><a href="https://github.com/chipsalliance/chisel" target="_blank" rel="noopener noreferrer" class="footer__link-item">GitHub<svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" class="iconExternalLink_nPIU"><path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path></svg></a></li></ul></div></div><div class="footer__bottom text--center"><div class="footer__copyright">Copyright © 2024 ChipsAlliance. Built with Docusaurus.</div></div></div></footer></div>
 </body>
 </html>
\ No newline at end of file
diff --git a/docs/explanations/printing.html b/docs/explanations/printing.html
index 6fa722c6e6..e6db992e1c 100644
--- a/docs/explanations/printing.html
+++ b/docs/explanations/printing.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Printing | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/printing"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Printing | Chisel"><meta data-rh="true" name="description" content="Chisel provides the printf function for debugging purposes. It comes in two flavors:"><meta data-rh="true" property="og:description" content="Chisel provides the printf function for debugging purposes. It comes in two flavors:"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/printing"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/printing" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/printing" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/properties.html b/docs/explanations/properties.html
index 8a14d6c438..c058b1fa22 100644
--- a/docs/explanations/properties.html
+++ b/docs/explanations/properties.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Properties | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/properties"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Properties | Chisel"><meta data-rh="true" name="description" content="Chisel properties represent information about the design that is not hardware."><meta data-rh="true" property="og:description" content="Chisel properties represent information about the design that is not hardware."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/properties"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/properties" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/properties" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/reset.html b/docs/explanations/reset.html
index 3d9eaa83c0..5af1e2934e 100644
--- a/docs/explanations/reset.html
+++ b/docs/explanations/reset.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Reset | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/reset"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Reset | Chisel"><meta data-rh="true" name="description" content="As of Chisel 3.2.0, Chisel 3 supports both synchronous and asynchronous reset,"><meta data-rh="true" property="og:description" content="As of Chisel 3.2.0, Chisel 3 supports both synchronous and asynchronous reset,"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/reset"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/reset" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/reset" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/sequential-circuits.html b/docs/explanations/sequential-circuits.html
index e7e9f197fb..4e54e128fe 100644
--- a/docs/explanations/sequential-circuits.html
+++ b/docs/explanations/sequential-circuits.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Sequential Circuits | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/sequential-circuits"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Sequential Circuits | Chisel"><meta data-rh="true" name="description" content="The simplest form of state element supported by Chisel is a positive edge-triggered register, which can be instantiated as:"><meta data-rh="true" property="og:description" content="The simplest form of state element supported by Chisel is a positive edge-triggered register, which can be instantiated as:"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/sequential-circuits"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/sequential-circuits" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/sequential-circuits" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/source-locators.html b/docs/explanations/source-locators.html
index 89fe461dca..85113ce956 100644
--- a/docs/explanations/source-locators.html
+++ b/docs/explanations/source-locators.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Source Locators | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/source-locators"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Source Locators | Chisel"><meta data-rh="true" name="description" content="When elaborating a Chisel design and emitting a FIRRTL file or Verilog file, Chisel will automatically"><meta data-rh="true" property="og:description" content="When elaborating a Chisel design and emitting a FIRRTL file or Verilog file, Chisel will automatically"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/source-locators"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/source-locators" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/source-locators" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/supported-hardware.html b/docs/explanations/supported-hardware.html
index 4fbf36860d..d9da6ba29f 100644
--- a/docs/explanations/supported-hardware.html
+++ b/docs/explanations/supported-hardware.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Supported Hardware | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/supported-hardware"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Supported Hardware | Chisel"><meta data-rh="true" name="description" content="While Chisel focuses on binary logic, Chisel can support analog and tri-state wires with the Analog type - see Datatypes in Chisel."><meta data-rh="true" property="og:description" content="While Chisel focuses on binary logic, Chisel can support analog and tri-state wires with the Analog type - see Datatypes in Chisel."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/supported-hardware"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/supported-hardware" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/supported-hardware" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/unconnected-wires.html b/docs/explanations/unconnected-wires.html
index 5008031c91..3e943ccbea 100644
--- a/docs/explanations/unconnected-wires.html
+++ b/docs/explanations/unconnected-wires.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Unconnected Wires | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/unconnected-wires"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Unconnected Wires | Chisel"><meta data-rh="true" name="description" content="The Invalidate API (#645) adds support to Chisel"><meta data-rh="true" property="og:description" content="The Invalidate API (#645) adds support to Chisel"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/unconnected-wires"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/unconnected-wires" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/unconnected-wires" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/warnings.html b/docs/explanations/warnings.html
index 31b3c8bbb1..7016b45f0b 100644
--- a/docs/explanations/warnings.html
+++ b/docs/explanations/warnings.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Warnings | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/warnings"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Warnings | Chisel"><meta data-rh="true" name="description" content="Warnings in Chisel are used for deprecating old APIs or semantics for later removal."><meta data-rh="true" property="og:description" content="Warnings in Chisel are used for deprecating old APIs or semantics for later removal."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/warnings"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/warnings" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/warnings" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/explanations/width-inference.html b/docs/explanations/width-inference.html
index b8b5c16de7..f1334f958f 100644
--- a/docs/explanations/width-inference.html
+++ b/docs/explanations/width-inference.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Width Inference | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/explanations/width-inference"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Width Inference | Chisel"><meta data-rh="true" name="description" content="Chisel provides bit width inference to reduce design effort. Users are encouraged to manually specify widths of ports and registers to prevent any surprises, but otherwise unspecified widths will be inferred by the FIRRTL compiler."><meta data-rh="true" property="og:description" content="Chisel provides bit width inference to reduce design effort. Users are encouraged to manually specify widths of ports and registers to prevent any surprises, but otherwise unspecified widths will be inferred by the FIRRTL compiler."><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/explanations/width-inference"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/width-inference" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/explanations/width-inference" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/installation.html b/docs/installation.html
index 381ea17725..e312b02721 100644
--- a/docs/installation.html
+++ b/docs/installation.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Installation | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/installation"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Installation | Chisel"><meta data-rh="true" name="description" content="How to install and run Chisel"><meta data-rh="true" property="og:description" content="How to install and run Chisel"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/installation"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/installation" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/installation" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/resources.html b/docs/resources.html
index f49df9eba5..1b3434f97f 100644
--- a/docs/resources.html
+++ b/docs/resources.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Chisel Resources | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/resources"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Chisel Resources | Chisel"><meta data-rh="true" name="description" content="The best resource to learn about Chisel is the online Chisel Bootcamp. This runs in your browser and assumes no prior Scala knowledge. (You may also run this locally via the backing chisel-bootcamp GitHub repository.)"><meta data-rh="true" property="og:description" content="The best resource to learn about Chisel is the online Chisel Bootcamp. This runs in your browser and assumes no prior Scala knowledge. (You may also run this locally via the backing chisel-bootcamp GitHub repository.)"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/resources"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/resources" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/resources" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/docs/resources/faqs.html b/docs/resources/faqs.html
index c0b3793b5d..2fdf5e4e9f 100644
--- a/docs/resources/faqs.html
+++ b/docs/resources/faqs.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Frequently Asked Questions | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/docs/resources/faqs"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docusaurus_version" content="current"><meta data-rh="true" name="docusaurus_tag" content="docs-default-current"><meta data-rh="true" name="docsearch:version" content="current"><meta data-rh="true" name="docsearch:docusaurus_tag" content="docs-default-current"><meta data-rh="true" property="og:title" content="Frequently Asked Questions | Chisel"><meta data-rh="true" name="description" content="* Where should I start if I want to learn Chisel?"><meta data-rh="true" property="og:description" content="* Where should I start if I want to learn Chisel?"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/docs/resources/faqs"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/resources/faqs" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/docs/resources/faqs" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
@@ -57,7 +57,7 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="get-me-verilog">Get me Verilo
 <p>or as a one-liner:</p>
 <div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">bash&gt; sbt &#x27;runMain intro.VerilogMain&#x27;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>After either of the above there will be a HelloWorld.v file in the current directory:</p>
-<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Users can define &#x27;PRINTF_COND&#x27; to add an extra gate to prints.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> PRINTF_COND_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`ifdef</span><span class="token plain"> PRINTF_COND</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> PRINTF_COND_ </span><span class="token punctuation" style="color:#393A34">(</span><span class="token constant" style="color:#36acaa">`PRINTF_COND</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`else</span><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// PRINTF_COND</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> PRINTF_COND_ </span><span class="token number" style="color:#36acaa">1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// PRINTF_COND</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// not def PRINTF_COND_</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">HelloWorld</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// faqs.md:11:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// faqs.md:11:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        reset	</span><span class="token comment" style="color:#999988;font-style:italic">// faqs.md:11:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> SYNTHESIS	</span><span class="token comment" style="color:#999988;font-style:italic">// faqs.md:13:9</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">begin</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// faqs.md:13:9</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token constant" style="color:#36acaa">`PRINTF_COND_</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">&amp;</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">~</span><span class="token plain">reset</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// faqs.md:13:9</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token kernel-function property" style="color:#36acaa">$fwrite</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32&#x27;h80000002</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;hello world\n&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// faqs.md:13:9</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">end</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// always @(posedge)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// not def SYNTHESIS</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="language-verilog codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-verilog codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Users can define &#x27;PRINTF_COND&#x27; to add an extra gate to prints.</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> PRINTF_COND_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`ifdef</span><span class="token plain"> PRINTF_COND</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> PRINTF_COND_ </span><span class="token punctuation" style="color:#393A34">(</span><span class="token constant" style="color:#36acaa">`PRINTF_COND</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`else</span><span class="token plain">  </span><span class="token comment" style="color:#999988;font-style:italic">// PRINTF_COND</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> PRINTF_COND_ </span><span class="token number" style="color:#36acaa">1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// PRINTF_COND</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// not def PRINTF_COND_</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">module</span><span class="token plain"> </span><span class="token function" style="color:#d73a49">HelloWorld</span><span class="token punctuation" style="color:#393A34">(</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// faqs.md:11:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">input</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// faqs.md:11:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        reset	</span><span class="token comment" style="color:#999988;font-style:italic">// faqs.md:11:7</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> SYNTHESIS	</span><span class="token comment" style="color:#999988;font-style:italic">// faqs.md:13:9</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token important">always @</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">posedge</span><span class="token plain"> clock</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token keyword" style="color:#00009f">begin</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// faqs.md:13:9</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">      </span><span class="token keyword" style="color:#00009f">if</span><span class="token plain"> </span><span class="token punctuation" style="color:#393A34">(</span><span class="token punctuation" style="color:#393A34">(</span><span class="token constant" style="color:#36acaa">`PRINTF_COND_</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">&amp;</span><span class="token plain"> </span><span class="token operator" style="color:#393A34">~</span><span class="token plain">reset</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// faqs.md:13:9</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">        </span><span class="token kernel-function property" style="color:#36acaa">$fwrite</span><span class="token punctuation" style="color:#393A34">(</span><span class="token number" style="color:#36acaa">32&#x27;h80000002</span><span class="token punctuation" style="color:#393A34">,</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;hello world\n&quot;</span><span class="token punctuation" style="color:#393A34">)</span><span class="token punctuation" style="color:#393A34">;</span><span class="token plain">	</span><span class="token comment" style="color:#999988;font-style:italic">// faqs.md:13:9</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    </span><span class="token keyword" style="color:#00009f">end</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// always @(posedge)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// not def SYNTHESIS</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">endmodule</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Cover/layers_HelloWorld_Verification_Cover.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_HelloWorld_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_HelloWorld_Verification_Cover</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_HelloWorld_Verification_Cover	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_HelloWorld_Verification_Cover	// &lt;stdin&gt;:6:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assume/layers_HelloWorld_Verification_Assume.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_HelloWorld_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_HelloWorld_Verification_Assume</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_HelloWorld_Verification_Assume	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_HelloWorld_Verification_Assume	// &lt;stdin&gt;:5:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/Assert/layers_HelloWorld_Verification_Assert.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`include</span><span class="token plain"> </span><span class="token string" style="color:#e3116c">&quot;Verification/layers_HelloWorld_Verification.sv&quot;</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_HelloWorld_Verification_Assert</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_HelloWorld_Verification_Assert	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_HelloWorld_Verification_Assert	// &lt;stdin&gt;:4:5</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// ----- 8&lt; ----- FILE &quot;Verification/layers_HelloWorld_Verification.sv&quot; ----- 8&lt; -----</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token comment" style="color:#999988;font-style:italic">// Generated by CIRCT firtool-1.81.1</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`ifndef</span><span class="token plain"> layers_HelloWorld_Verification</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`define</span><span class="token plain"> layers_HelloWorld_Verification	</span><span class="token comment" style="color:#999988;font-style:italic">// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token constant" style="color:#36acaa">`endif</span><span class="token plain"> </span><span class="token comment" style="color:#999988;font-style:italic">// layers_HelloWorld_Verification	// &lt;stdin&gt;:3:3</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>You can see additional options with</p>
 <div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">bash&gt; sbt &#x27;runMain intro.HelloWorld --help&#x27;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>This will return a comprehensive usage line with available options.</p>
@@ -75,7 +75,7 @@ <h3 class="anchor anchorWithStickyNavbar_LWe7" id="get-me-firrtl">Get me FIRRTL<
 <div class="language-scala codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-scala codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">chisel3</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">_</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">import</span><span class="token plain"> </span><span class="token namespace" style="opacity:0.7">circt</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token namespace" style="opacity:0.7">stage</span><span class="token namespace punctuation" style="opacity:0.7;color:#393A34">.</span><span class="token plain">ChiselStage</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">class</span><span class="token plain"> MyFirrtlModule </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> Module </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  </span><span class="token keyword" style="color:#00009f">val</span><span class="token plain"> io </span><span class="token operator" style="color:#393A34">=</span><span class="token plain"> IO</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> Bundle</span><span class="token punctuation" style="color:#393A34">{</span><span class="token punctuation" style="color:#393A34">}</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token keyword" style="color:#00009f">object</span><span class="token plain"> FirrtlMain </span><span class="token keyword" style="color:#00009f">extends</span><span class="token plain"> App </span><span class="token punctuation" style="color:#393A34">{</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  ChiselStage</span><span class="token punctuation" style="color:#393A34">.</span><span class="token plain">emitCHIRRTL</span><span class="token punctuation" style="color:#393A34">(</span><span class="token keyword" style="color:#00009f">new</span><span class="token plain"> MyFirrtlModule</span><span class="token punctuation" style="color:#393A34">)</span><span class="token plain"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain"></span><span class="token punctuation" style="color:#393A34">}</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Run it with:</p>
 <div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">sbt &#x27;runMain intro.FirrtlMain&#x27;</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
-<div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">FIRRTL version 4.0.0</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">circuit MyFirrtlModule :</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  public module MyFirrtlModule : @[faqs.md 64:7]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    input clock : Clock @[faqs.md 64:7]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    input reset : UInt&lt;1&gt; @[faqs.md 64:7]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    output io : { } @[faqs.md 65:14]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    skip</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
+<div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">FIRRTL version 4.0.0</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">circuit MyFirrtlModule :</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  layer Verification, bind, &quot;Verification&quot; :</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    layer Assert, bind, &quot;Verification/Assert&quot; :</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    layer Assume, bind, &quot;Verification/Assume&quot; :</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    layer Cover, bind, &quot;Verification/Cover&quot; :</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">  public module MyFirrtlModule : @[faqs.md 64:7]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    input clock : Clock @[faqs.md 64:7]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    input reset : UInt&lt;1&gt; @[faqs.md 64:7]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    output io : { } @[faqs.md 65:14]</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">    skip</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <p>Alternatively, you can also use the sbt console to invoke the FIRRTL driver directly (replace MyFirrtlModule with your module name):</p>
 <div class="codeBlockContainer_Ckt0 theme-code-block" style="--prism-color:#393A34;--prism-background-color:#f6f8fa"><div class="codeBlockContent_biex"><pre tabindex="0" class="prism-code language-text codeBlock_bY9V thin-scrollbar" style="color:#393A34;background-color:#f6f8fa"><code class="codeBlockLines_e6Vv"><span class="token-line" style="color:#393A34"><span class="token plain">$ sbt</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">&gt; console</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">[info] Starting scala interpreter...</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">Welcome to Scala 2.12.13 (OpenJDK 64-Bit Server VM, Java 1.8.0_275).</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">Type in expressions for evaluation. Or try :help.</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain" style="display:inline-block"></span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">scala&gt; circt.stage.ChiselStage.emitCHIRRTL(new MyFirrtlModule)</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">Elaborating design...</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">Done elaborating.</span><br></span><span class="token-line" style="color:#393A34"><span class="token plain">res3: String = ...</span><br></span></code></pre><div class="buttonGroup__atx"><button type="button" aria-label="Copy code to clipboard" title="Copy" class="clean-btn"><span class="copyButtonIcons_eSgA" aria-hidden="true"><svg viewBox="0 0 24 24" class="copyButtonIcon_y97N"><path fill="currentColor" d="M19,21H8V7H19M19,5H8A2,2 0 0,0 6,7V21A2,2 0 0,0 8,23H19A2,2 0 0,0 21,21V7A2,2 0 0,0 19,5M16,1H4A2,2 0 0,0 2,3V17H4V3H16V1Z"></path></svg><svg viewBox="0 0 24 24" class="copyButtonSuccessIcon_LjdS"><path fill="currentColor" d="M21,7L9,19L3.5,13.5L4.91,12.09L9,16.17L19.59,5.59L21,7Z"></path></svg></span></button></div></div></div>
 <h3 class="anchor anchorWithStickyNavbar_LWe7" id="why-doesnt-chisel-tell-me-which-wires-arent-connected">Why doesn&#x27;t Chisel tell me which wires aren&#x27;t connected?<a href="#why-doesnt-chisel-tell-me-which-wires-arent-connected" class="hash-link" aria-label="Direct link to Why doesn&#x27;t Chisel tell me which wires aren&#x27;t connected?" title="Direct link to Why doesn&#x27;t Chisel tell me which wires aren&#x27;t connected?">​</a></h3>
diff --git a/generated/contributors.html b/generated/contributors.html
index 0d3fad8533..fb1e796352 100644
--- a/generated/contributors.html
+++ b/generated/contributors.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Chisel</title><meta data-rh="true" property="og:title" content="Chisel"><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/generated/contributors"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docusaurus_tag" content="default"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docsearch:docusaurus_tag" content="default"><meta data-rh="true" name="description" content="- @abejgonzalez"><meta data-rh="true" property="og:description" content="- @abejgonzalez"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/generated/contributors"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/generated/contributors" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/generated/contributors" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/generated/scaladoc_links.html b/generated/scaladoc_links.html
index 134b17c175..a9ffca52b3 100644
--- a/generated/scaladoc_links.html
+++ b/generated/scaladoc_links.html
@@ -4,13 +4,13 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Chisel</title><meta data-rh="true" property="og:title" content="Chisel"><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/generated/scaladoc_links"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docusaurus_tag" content="default"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docsearch:docusaurus_tag" content="default"><meta data-rh="true" name="description" content="- Latest (6.5.0)"><meta data-rh="true" property="og:description" content="- Latest (6.5.0)"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/generated/scaladoc_links"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/generated/scaladoc_links" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/generated/scaladoc_links" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
 <script>!function(){function t(t){document.documentElement.setAttribute("data-theme",t)}var e=function(){try{return new URLSearchParams(window.location.search).get("docusaurus-theme")}catch(t){}}()||function(){try{return localStorage.getItem("theme")}catch(t){}}();t(null!==e?e:"light")}(),function(){try{const c=new URLSearchParams(window.location.search).entries();for(var[t,e]of c)if(t.startsWith("docusaurus-data-")){var a=t.replace("docusaurus-data-","data-");document.documentElement.setAttribute(a,e)}}catch(t){}}()</script><div id="__docusaurus"><div role="region" aria-label="Skip to main content"><a class="skipToContent_fXgn" href="#__docusaurus_skipToContent_fallback">Skip to main content</a></div><nav aria-label="Main" class="navbar navbar--fixed-top"><div class="navbar__inner"><div class="navbar__items"><button aria-label="Toggle navigation bar" aria-expanded="false" class="navbar__toggle clean-btn" type="button"><svg width="30" height="30" viewBox="0 0 30 30" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-miterlimit="10" stroke-width="2" d="M4 7h22M4 15h22M4 23h22"></path></svg></button><a class="navbar__brand" href="/"><div class="navbar__logo"><img src="/img/chisel-tool.svg" alt="Chisel Logo" class="themedComponent_mlkZ themedComponent--light_NVdE"><img src="/img/chisel-tool.svg" alt="Chisel Logo" class="themedComponent_mlkZ themedComponent--dark_xIcU"></div><b class="navbar__title text--truncate">Chisel</b></a><a class="navbar__item navbar__link" href="/docs">Docs</a><a class="navbar__item navbar__link" href="/community">Community</a><a class="navbar__item navbar__link" href="/api">API</a></div><div class="navbar__items navbar__items--right"><a href="https://www.chipsalliance.org/" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link header-chipsalliance-link" aria-label="ChipsAlliance link"></a><a href="https://github.com/chipsalliance/chisel" target="_blank" rel="noopener noreferrer" class="navbar__item navbar__link header-github-link" aria-label="GitHub repository"></a><div class="toggle_vylO colorModeToggle_DEke"><button class="clean-btn toggleButton_gllP toggleButtonDisabled_aARS" type="button" disabled="" title="Switch between dark and light mode (currently light mode)" aria-label="Switch between dark and light mode (currently light mode)" aria-live="polite"><svg viewBox="0 0 24 24" width="24" height="24" class="lightToggleIcon_pyhR"><path fill="currentColor" d="M12,9c1.65,0,3,1.35,3,3s-1.35,3-3,3s-3-1.35-3-3S10.35,9,12,9 M12,7c-2.76,0-5,2.24-5,5s2.24,5,5,5s5-2.24,5-5 S14.76,7,12,7L12,7z M2,13l2,0c0.55,0,1-0.45,1-1s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S1.45,13,2,13z M20,13l2,0c0.55,0,1-0.45,1-1 s-0.45-1-1-1l-2,0c-0.55,0-1,0.45-1,1S19.45,13,20,13z M11,2v2c0,0.55,0.45,1,1,1s1-0.45,1-1V2c0-0.55-0.45-1-1-1S11,1.45,11,2z M11,20v2c0,0.55,0.45,1,1,1s1-0.45,1-1v-2c0-0.55-0.45-1-1-1C11.45,19,11,19.45,11,20z M5.99,4.58c-0.39-0.39-1.03-0.39-1.41,0 c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0s0.39-1.03,0-1.41L5.99,4.58z M18.36,16.95 c-0.39-0.39-1.03-0.39-1.41,0c-0.39,0.39-0.39,1.03,0,1.41l1.06,1.06c0.39,0.39,1.03,0.39,1.41,0c0.39-0.39,0.39-1.03,0-1.41 L18.36,16.95z M19.42,5.99c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06c-0.39,0.39-0.39,1.03,0,1.41 s1.03,0.39,1.41,0L19.42,5.99z M7.05,18.36c0.39-0.39,0.39-1.03,0-1.41c-0.39-0.39-1.03-0.39-1.41,0l-1.06,1.06 c-0.39,0.39-0.39,1.03,0,1.41s1.03,0.39,1.41,0L7.05,18.36z"></path></svg><svg viewBox="0 0 24 24" width="24" height="24" class="darkToggleIcon_wfgR"><path fill="currentColor" d="M9.37,5.51C9.19,6.15,9.1,6.82,9.1,7.5c0,4.08,3.32,7.4,7.4,7.4c0.68,0,1.35-0.09,1.99-0.27C17.45,17.19,14.93,19,12,19 c-3.86,0-7-3.14-7-7C5,9.07,6.81,6.55,9.37,5.51z M12,3c-4.97,0-9,4.03-9,9s4.03,9,9,9s9-4.03,9-9c0-0.46-0.04-0.92-0.1-1.36 c-0.98,1.37-2.58,2.26-4.4,2.26c-2.98,0-5.4-2.42-5.4-5.4c0-1.81,0.89-3.42,2.26-4.4C12.92,3.04,12.46,3,12,3L12,3z"></path></svg></button></div><div class="navbarSearchContainer_Bca1"><button type="button" class="DocSearch DocSearch-Button" aria-label="Search"><span class="DocSearch-Button-Container"><svg width="20" height="20" class="DocSearch-Search-Icon" viewBox="0 0 20 20" aria-hidden="true"><path d="M14.386 14.386l4.0877 4.0877-4.0877-4.0877c-2.9418 2.9419-7.7115 2.9419-10.6533 0-2.9419-2.9418-2.9419-7.7115 0-10.6533 2.9418-2.9419 7.7115-2.9419 10.6533 0 2.9419 2.9418 2.9419 7.7115 0 10.6533z" stroke="currentColor" fill="none" fill-rule="evenodd" stroke-linecap="round" stroke-linejoin="round"></path></svg><span class="DocSearch-Button-Placeholder">Search</span></span><span class="DocSearch-Button-Keys"></span></button></div></div></div><div role="presentation" class="navbar-sidebar__backdrop"></div></nav><div id="__docusaurus_skipToContent_fallback" class="main-wrapper mainWrapper_z2l0"><main class="container container--fluid margin-vert--lg"><div class="row mdxPageWrapper_j9I6"><div class="col col--8"><article><ul>
 <li><a href="/api/latest/index.html" target="_blank" rel="noopener noreferrer">Latest (6.5.0)</a></li>
-<li><a href="https://s01.oss.sonatype.org/service/local/repositories/snapshots/archive/org/chipsalliance/chisel_2.13/7.0.0-M2+49-ab82fc22-SNAPSHOT/chisel_2.13-7.0.0-M2+49-ab82fc22-SNAPSHOT-javadoc.jar/!/index.html" target="_blank" rel="noopener noreferrer">Snapshot</a></li>
+<li><a href="https://s01.oss.sonatype.org/service/local/repositories/snapshots/archive/org/chipsalliance/chisel_2.13/7.0.0-M2+50-f347914d-SNAPSHOT/chisel_2.13-7.0.0-M2+50-f347914d-SNAPSHOT-javadoc.jar/!/index.html" target="_blank" rel="noopener noreferrer">Snapshot</a></li>
 <li><a href="https://javadoc.io/doc/org.chipsalliance/chisel_2.13/7.0.0-M2" target="_blank" rel="noopener noreferrer">7.0.0-M2</a></li>
 <li><a href="https://javadoc.io/doc/org.chipsalliance/chisel_2.13/6.5.0" target="_blank" rel="noopener noreferrer">6.5.0</a></li>
 <li><a href="https://javadoc.io/doc/org.chipsalliance/chisel_2.13/5.3.0" target="_blank" rel="noopener noreferrer">5.3.0</a></li>
diff --git a/index.html b/index.html
index 2e88cb37a9..2827f1a024 100644
--- a/index.html
+++ b/index.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Chisel | Chisel</title><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docusaurus_tag" content="default"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docsearch:docusaurus_tag" content="default"><meta data-rh="true" property="og:title" content="Chisel | Chisel"><meta data-rh="true" name="description" content="Software-defined hardware"><meta data-rh="true" property="og:description" content="Software-defined hardware"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><script data-rh="true">function insertBanner(){var n=document.createElement("div");n.id="__docusaurus-base-url-issue-banner-container";n.innerHTML='\n<div id="__docusaurus-base-url-issue-banner" style="border: thick solid red; background-color: rgb(255, 230, 179); margin: 20px; padding: 20px; font-size: 20px;">\n   <p style="font-weight: bold; font-size: 30px;">Your Docusaurus site did not load properly.</p>\n   <p>A very common reason is a wrong site <a href="https://docusaurus.io/docs/docusaurus.config.js/#baseUrl" style="font-weight: bold;">baseUrl configuration</a>.</p>\n   <p>Current configured baseUrl = <span style="font-weight: bold; color: red;">/</span>  (default value)</p>\n   <p>We suggest trying baseUrl = <span id="__docusaurus-base-url-issue-banner-suggestion-container" style="font-weight: bold; color: green;"></span></p>\n</div>\n',document.body.prepend(n);var e=document.getElementById("__docusaurus-base-url-issue-banner-suggestion-container"),s=window.location.pathname,o="/"===s.substr(-1)?s:s+"/";e.innerHTML=o}document.addEventListener("DOMContentLoaded",(function(){void 0===window.docusaurus&&insertBanner()}))</script><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">
diff --git a/search.html b/search.html
index 3063d0d6b8..27d702aace 100644
--- a/search.html
+++ b/search.html
@@ -4,7 +4,7 @@
 <meta charset="UTF-8">
 <meta name="generator" content="Docusaurus v3.1.1">
 <title data-rh="true">Search the documentation | Chisel</title><meta data-rh="true" property="og:title" content="Chisel"><meta data-rh="true" name="viewport" content="width=device-width,initial-scale=1"><meta data-rh="true" name="twitter:card" content="summary_large_image"><meta data-rh="true" property="og:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" name="twitter:image" content="https://www.chisel-lang.org/img/chisel-tool.svg"><meta data-rh="true" property="og:url" content="https://www.chisel-lang.org/search"><meta data-rh="true" property="og:locale" content="en"><meta data-rh="true" name="docusaurus_locale" content="en"><meta data-rh="true" name="docusaurus_tag" content="default"><meta data-rh="true" name="docsearch:language" content="en"><meta data-rh="true" name="docsearch:docusaurus_tag" content="default"><meta data-rh="true" property="robots" content="noindex, follow"><link data-rh="true" rel="icon" href="/img/chisel-tool-icon.svg"><link data-rh="true" rel="canonical" href="https://www.chisel-lang.org/search"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/search" hreflang="en"><link data-rh="true" rel="alternate" href="https://www.chisel-lang.org/search" hreflang="x-default"><link data-rh="true" rel="preconnect" href="https://TTFNIAC3CJ-dsn.algolia.net" crossorigin="anonymous"><link rel="search" type="application/opensearchdescription+xml" title="Chisel" href="/opensearch.xml"><link rel="stylesheet" href="/assets/css/styles.e0eb6f43.css">
-<script src="/assets/js/runtime~main.8290adcf.js" defer="defer"></script>
+<script src="/assets/js/runtime~main.4c8ffac5.js" defer="defer"></script>
 <script src="/assets/js/main.74859d55.js" defer="defer"></script>
 </head>
 <body class="navigation-with-keyboard">