| <!DOCTYPE html> |
| |
| <html lang="en" data-content_root="../../"> |
| <head> |
| <meta charset="utf-8" /> |
| <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" /> |
| |
| <meta name="viewport" content="width=device-width,initial-scale=1"> |
| <meta http-equiv="x-ua-compatible" content="ie=edge"> |
| <meta name="lang:clipboard.copy" content="Copy to clipboard"> |
| <meta name="lang:clipboard.copied" content="Copied to clipboard"> |
| <meta name="lang:search.language" content="en"> |
| <meta name="lang:search.pipeline.stopwords" content="True"> |
| <meta name="lang:search.pipeline.trimmer" content="True"> |
| <meta name="lang:search.result.none" content="No matching documents"> |
| <meta name="lang:search.result.one" content="1 matching document"> |
| <meta name="lang:search.result.other" content="# matching documents"> |
| <meta name="lang:search.tokenizer" content="[\s\-]+"> |
| |
| |
| <link href="https://fonts.gstatic.com/" rel="preconnect" crossorigin> |
| <link href="https://fonts.googleapis.com/css?family=Roboto+Mono:400,500,700|Roboto:300,400,400i,700&display=fallback" rel="stylesheet"> |
| |
| <style> |
| body, |
| input { |
| font-family: "Roboto", "Helvetica Neue", Helvetica, Arial, sans-serif |
| } |
| |
| code, |
| kbd, |
| pre { |
| font-family: "Roboto Mono", "Courier New", Courier, monospace |
| } |
| </style> |
| |
| |
| <link rel="stylesheet" href="../../_static/stylesheets/application.css"/> |
| <link rel="stylesheet" href="../../_static/stylesheets/application-palette.css"/> |
| <link rel="stylesheet" href="../../_static/stylesheets/application-fixes.css"/> |
| <link rel="stylesheet" href="../../_static/stylesheets/f4pga.css"/> |
| |
| <link rel="stylesheet" href="../../_static/fonts/material-icons.css"/> |
| |
| <meta name="theme-color" content="#3f51b5"> |
| <script src="../../_static/javascripts/modernizr.js"></script> |
| |
| |
| |
| <title>synth — F4PGA documentation</title> |
| <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=80d5e7a1" /> |
| <link rel="stylesheet" type="text/css" href="../../_static/material.css?v=79c92029" /> |
| <script src="../../_static/documentation_options.js?v=5929fcd5"></script> |
| <script src="../../_static/doctools.js?v=9bcbadda"></script> |
| <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script> |
| <link rel="icon" href="../../_static/favicon.svg"/> |
| <link rel="index" title="Index" href="../../genindex.html" /> |
| <link rel="search" title="Search" href="../../search.html" /> |
| <link rel="next" title="Developer’s notes" href="../DevNotes.html" /> |
| <link rel="prev" title="route" href="route.html" /> |
| |
| |
| |
| </head> |
| <body dir=ltr |
| data-md-color-primary=indigo data-md-color-accent=blue> |
| |
| <svg class="md-svg"> |
| <defs data-children-count="0"> |
| |
| <svg xmlns="http://www.w3.org/2000/svg" width="416" height="448" viewBox="0 0 416 448" id="__github"><path fill="currentColor" d="M160 304q0 10-3.125 20.5t-10.75 19T128 352t-18.125-8.5-10.75-19T96 304t3.125-20.5 10.75-19T128 256t18.125 8.5 10.75 19T160 304zm160 0q0 10-3.125 20.5t-10.75 19T288 352t-18.125-8.5-10.75-19T256 304t3.125-20.5 10.75-19T288 256t18.125 8.5 10.75 19T320 304zm40 0q0-30-17.25-51T296 232q-10.25 0-48.75 5.25Q229.5 240 208 240t-39.25-2.75Q130.75 232 120 232q-29.5 0-46.75 21T56 304q0 22 8 38.375t20.25 25.75 30.5 15 35 7.375 37.25 1.75h42q20.5 0 37.25-1.75t35-7.375 30.5-15 20.25-25.75T360 304zm56-44q0 51.75-15.25 82.75-9.5 19.25-26.375 33.25t-35.25 21.5-42.5 11.875-42.875 5.5T212 416q-19.5 0-35.5-.75t-36.875-3.125-38.125-7.5-34.25-12.875T37 371.5t-21.5-28.75Q0 312 0 260q0-59.25 34-99-6.75-20.5-6.75-42.5 0-29 12.75-54.5 27 0 47.5 9.875t47.25 30.875Q171.5 96 212 96q37 0 70 8 26.25-20.5 46.75-30.25T376 64q12.75 25.5 12.75 54.5 0 21.75-6.75 42 34 40 34 99.5z"/></svg> |
| |
| </defs> |
| </svg> |
| |
| <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer"> |
| <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search"> |
| <label class="md-overlay" data-md-component="overlay" for="__drawer"></label> |
| <a href="#f4pga/modules/synth" tabindex="1" class="md-skip"> Skip to content </a> |
| <header class="md-header" data-md-component="header"> |
| <nav class="md-header-nav md-grid"> |
| <div class="md-flex navheader"> |
| <div class="md-flex__cell md-flex__cell--shrink"> |
| <a href="../../index.html" title="F4PGA documentation" |
| class="md-header-nav__button md-logo"> |
| |
| |
| |
| </a> |
| </div> |
| <div class="md-flex__cell md-flex__cell--shrink"> |
| <label class="md-icon md-icon--menu md-header-nav__button" for="__drawer"></label> |
| </div> |
| <div class="md-flex__cell md-flex__cell--stretch"> |
| <div class="md-flex__ellipsis md-header-nav__title" data-md-component="title"> |
| <span class="md-header-nav__topic">F4PGA documentation</span> |
| <span class="md-header-nav__topic"> synth </span> |
| </div> |
| </div> |
| <div class="md-flex__cell md-flex__cell--shrink"> |
| <label class="md-icon md-icon--search md-header-nav__button" for="__search"></label> |
| <div class="md-search" data-md-component="search" role="dialog"> |
| <label class="md-search__overlay" for="__search"></label> |
| <div class="md-search__inner" role="search"> |
| <form class="md-search__form" action="../../search.html" method="GET" name="search"> |
| <input type="text" class="md-search__input" name="q" placeholder="Search" |
| autocapitalize="off" autocomplete="off" spellcheck="false" |
| data-md-component="query" data-md-state="active"> |
| <label class="md-icon md-search__icon" for="__search"></label> |
| <button type="reset" class="md-icon md-search__icon" data-md-component="reset" tabindex="-1"> |
|  |
| </button> |
| </form> |
| <div class="md-search__output"> |
| <div class="md-search__scrollwrap" data-md-scrollfix> |
| <div class="md-search-result" data-md-component="result"> |
| <div class="md-search-result__meta"> |
| Type to start searching |
| </div> |
| <ol class="md-search-result__list"></ol> |
| </div> |
| </div> |
| </div> |
| </div> |
| </div> |
| </div> |
| |
| <div class="md-flex__cell md-flex__cell--shrink"> |
| <div class="md-header-nav__source"> |
| <a href="https://github.com/chipsalliance/f4pga" title="Go to repository" class="md-source" data-md-source="github"> |
| |
| <div class="md-source__icon"> |
| <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 24 24" width="28" height="28"> |
| <use xlink:href="#__github" width="24" height="24"></use> |
| </svg> |
| </div> |
| |
| <div class="md-source__repository"> |
| chipsalliance/f4pga |
| </div> |
| </a> |
| </div> |
| </div> |
| |
| |
| |
| <script src="../../_static/javascripts/version_dropdown.js"></script> |
| <script> |
| var json_loc = "../../"versions.json"", |
| target_loc = "../../../", |
| text = "Versions"; |
| $( document ).ready( add_version_dropdown(json_loc, target_loc, text)); |
| </script> |
| |
| |
| </div> |
| </nav> |
| </header> |
| |
| |
| <div class="md-container"> |
| |
| |
| |
| <nav class="md-tabs" data-md-component="tabs"> |
| <div class="md-tabs__inner md-grid"> |
| <ul class="md-tabs__list" style="float:left"> |
| <li class="md-tabs__item"><a href="../../index.html" class="md-tabs__link">F4PGA documentation</a></li> |
| <li class="md-tabs__item"><a href="index.html" class="md-tabs__link">Modules</a></li> |
| </ul> |
| <ul class="md-tabs__list" id="chipsalliance-header" style="float:right"> |
| |
| <li class="md-tabs__item"><a href="https://chipsalliance.org" class="md-tabs__link"> |
| <i class="md-icon">web</i> CHIPS Alliance Website</a></li> |
| </ul> |
| </div> |
| </nav> |
| <main class="md-main"> |
| <div class="md-main__inner md-grid" data-md-component="container"> |
| |
| <div class="md-sidebar md-sidebar--primary" data-md-component="navigation"> |
| <div class="md-sidebar__scrollwrap"> |
| <div class="md-sidebar__inner"> |
| <nav class="md-nav md-nav--primary" data-md-level="0"> |
| <label class="md-nav__title md-nav__title--site" for="__drawer"> |
| <a href="../../index.html" title="F4PGA documentation" class="md-nav__button md-logo"> |
| |
| <img src="../../_static/" alt=" logo" width="48" height="48"> |
| |
| </a> |
| <a href="../../index.html" |
| title="F4PGA documentation">F4PGA documentation</a> |
| </label> |
| <div class="md-nav__source"> |
| <a href="https://github.com/chipsalliance/f4pga" title="Go to repository" class="md-source" data-md-source="github"> |
| |
| <div class="md-source__icon"> |
| <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 24 24" width="28" height="28"> |
| <use xlink:href="#__github" width="24" height="24"></use> |
| </svg> |
| </div> |
| |
| <div class="md-source__repository"> |
| chipsalliance/f4pga |
| </div> |
| </a> |
| </div> |
| |
| |
| |
| <ul class="md-nav__list"> |
| <li class="md-nav__item"> |
| |
| <span class="md-nav__link caption"><span class="caption-text">About F4PGA</span></span> |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="../../getting-started.html" class="md-nav__link"> |
| Getting started</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="../../how.html" class="md-nav__link"> |
| How it works</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="../../status.html" class="md-nav__link"> |
| Supported Architectures</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="../../community.html" class="md-nav__link"> |
| Community</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <span class="md-nav__link caption"><span class="caption-text">Python utils</span></span> |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="../index.html" class="md-nav__link"> |
| Overview</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="../Usage.html" class="md-nav__link"> |
| Usage</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="index.html" class="md-nav__link"> |
| Modules</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="../DevNotes.html" class="md-nav__link"> |
| Developer’s notes</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="../Deprecated.html" class="md-nav__link"> |
| Understanding the (deprecated) flow</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <span class="md-nav__link caption"><span class="caption-text">Development</span></span> |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="../../development/changes.html" class="md-nav__link"> |
| Changes</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="../../development/building-docs.html" class="md-nav__link"> |
| Building the documentation</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="../../development/venv.html" class="md-nav__link"> |
| Packages in virtual environment</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <span class="md-nav__link caption"><span class="caption-text">Design Flows</span></span> |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="../../flows/index.html" class="md-nav__link"> |
| Introduction</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="../../flows/synthesis.html" class="md-nav__link"> |
| Synthesis</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="../../flows/pnr.html" class="md-nav__link"> |
| Place & Route</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="../../flows/bitstream.html" class="md-nav__link"> |
| Bitstream translation</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="../../flows/f4pga.html" class="md-nav__link"> |
| In F4PGA</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <span class="md-nav__link caption"><span class="caption-text">Specifications</span></span> |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="https://fasm.readthedocs.io/en/latest/" class="md-nav__link"> |
| FPGA Assembly (FASM) ➚</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="https://chipsalliance/fpga-interchange-schema" class="md-nav__link"> |
| FPGA Interchange schema ➚</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <span class="md-nav__link caption"><span class="caption-text">Appendix</span></span> |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="../../glossary.html" class="md-nav__link"> |
| Glossary</a> |
| |
| |
| |
| </li> |
| <li class="md-nav__item"> |
| |
| <a href="../../references.html" class="md-nav__link"> |
| References</a> |
| |
| |
| |
| </li> |
| </ul> |
| |
| </nav> |
| </div> |
| </div> |
| </div> |
| <div class="md-sidebar md-sidebar--secondary" data-md-component="toc"> |
| <div class="md-sidebar__scrollwrap"> |
| <div class="md-sidebar__inner"> |
| |
| <nav class="md-nav md-nav--secondary"> |
| <label class="md-nav__title" for="__toc">Contents</label> |
| <ul class="md-nav__list" data-md-scrollfix=""> |
| <li class="md-nav__item"><a href="#f4pga-modules-synth--page-root" class="md-nav__link">synth</a><nav class="md-nav"> |
| <ul class="md-nav__list"> |
| <li class="md-nav__item"><a href="#parameters" class="md-nav__link">Parameters</a> |
| </li> |
| <li class="md-nav__item"><a href="#values" class="md-nav__link">Values</a> |
| </li></ul> |
| </nav> |
| </li> |
| |
| <li class="md-nav__item"><a class="md-nav__extra_link" href="../../_sources/f4pga/modules/synth.md.txt">Show Source</a> </li> |
| |
| <li id="searchbox" class="md-nav__item"></li> |
| |
| </ul> |
| </nav> |
| </div> |
| </div> |
| </div> |
| |
| <div class="md-content"> |
| <article class="md-content__inner md-typeset" role="main"> |
| |
| <section id="synth"> |
| <h1 id="f4pga-modules-synth--page-root">synth<a class="headerlink" href="#f4pga-modules-synth--page-root" title="Link to this heading">¶</a></h1> |
| <p>The <em>synth</em> module is meant to be used to execute YOSYS synthesis.</p> |
| <p>The module should guarantee the following outputs:</p> |
| <ul class="simple"> |
| <li><p><code class="docutils literal notranslate"><span class="pre">eblif</span></code></p></li> |
| <li><p><code class="docutils literal notranslate"><span class="pre">fasm_extra</span></code> (can be empty)</p></li> |
| <li><p><code class="docutils literal notranslate"><span class="pre">json</span></code></p></li> |
| <li><p><code class="docutils literal notranslate"><span class="pre">synth_json</span></code></p></li> |
| <li><p><code class="docutils literal notranslate"><span class="pre">synth_log</span></code> (on demand)</p></li> |
| </ul> |
| <p>For detailed information about these targets, please refer to |
| <code class="docutils literal notranslate"><span class="pre">docs/common</span> <span class="pre">targets</span> <span class="pre">and</span> <span class="pre">variables.md</span></code></p> |
| <p>What files and how are they generated is dependent on TCL scripts executed |
| withing YOSYS and the script vary depending on the target platform. Due to this |
| design choice it is required for the author of the flow definition to parameterize |
| the <code class="docutils literal notranslate"><span class="pre">synth</span></code> module in a way that will <strong>GUARANTEE</strong> the targets mentioned above |
| will be generated upon a successful YOSYS run.</p> |
| <p>The setup of the synth module follows the following specifications:</p> |
| <section id="parameters"> |
| <h2 id="parameters">Parameters<a class="headerlink" href="#parameters" title="Link to this heading">¶</a></h2> |
| <p>The <code class="docutils literal notranslate"><span class="pre">params</span></code> section of a stage configuration may contain a <code class="docutils literal notranslate"><span class="pre">produces</span></code> list. |
| The list should specify additional targets that will be generated |
| (<code class="docutils literal notranslate"><span class="pre">?</span></code> qualifier is allowed).</p> |
| </section> |
| <section id="values"> |
| <h2 id="values">Values<a class="headerlink" href="#values" title="Link to this heading">¶</a></h2> |
| <p>The <code class="docutils literal notranslate"><span class="pre">synth</span></code> module requires the following values:</p> |
| <ul class="simple"> |
| <li><p><code class="docutils literal notranslate"><span class="pre">tcl_scripts</span></code> (string, required): A path to a directory containing <code class="docutils literal notranslate"><span class="pre">synth.tcl</span></code> |
| and <code class="docutils literal notranslate"><span class="pre">conv.tcl</span></code> scripts that will be used by YOSYS.</p></li> |
| <li><p><code class="docutils literal notranslate"><span class="pre">read_verilog_args</span></code> (list[string | number], optional) - If specified, the Verilog |
| sources will be read using the <code class="docutils literal notranslate"><span class="pre">read_verilog</span></code> procedure with options contained in |
| this value.</p></li> |
| <li><p><code class="docutils literal notranslate"><span class="pre">yosys_tcl_env</span></code> (dict[string -> string | list[string], required) - A mapping that |
| defines environmental variables that will be used within the TCL scripts. This |
| should contain the references to module’s inputs and outputs in order to guarantee |
| the generation of the desired targets.</p></li> |
| </ul> |
| </section> |
| </section> |
| |
| |
| </article> |
| </div> |
| </div> |
| </main> |
| </div> |
| <footer class="md-footer"> |
| <div class="md-footer-nav"> |
| <nav class="md-footer-nav__inner md-grid"> |
| |
| <a href="route.html" title="route" |
| class="md-flex md-footer-nav__link md-footer-nav__link--prev" |
| rel="prev"> |
| <div class="md-flex__cell md-flex__cell--shrink"> |
| <i class="md-icon md-icon--arrow-back md-footer-nav__button"></i> |
| </div> |
| <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"> |
| <span class="md-flex__ellipsis"> |
| <span |
| class="md-footer-nav__direction"> Previous </span> route </span> |
| </div> |
| </a> |
| |
| |
| <a href="../DevNotes.html" title="Developer’s notes" |
| class="md-flex md-footer-nav__link md-footer-nav__link--next" |
| rel="next"> |
| <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title"><span |
| class="md-flex__ellipsis"> <span |
| class="md-footer-nav__direction"> Next </span> Developer’s notes </span> |
| </div> |
| <div class="md-flex__cell md-flex__cell--shrink"><i |
| class="md-icon md-icon--arrow-forward md-footer-nav__button"></i> |
| </div> |
| |
| </a> |
| |
| </nav> |
| </div> |
| <div class="md-footer-meta md-typeset"> |
| <div class="md-footer-meta__inner md-grid"> |
| <div class="md-footer-social"> |
| |
| <div class="md-footer-social__link"> |
| <a href="https://chipsalliance.org/" target="_blank">CHIPS Alliance</a> |
| </div> |
| </ul> |
| <div class="md-footer-social__link"> |
| <a href="https://github.com/chipsalliance/f4pga" target="_blank">GitHub</a> |
| </div> |
| </div> |
| <div class="md-footer-copyright"> |
| <div class="md-footer-copyright__highlight"> |
| © Copyright F4PGA Authors, 2019 - 2022. |
| |
| </div> |
| Created using |
| <a href="http://www.sphinx-doc.org/">Sphinx</a> 8.1.3. |
| and |
| <a href="https://github.com/f4pga/sphinx_f4pga_theme">Material for |
| Sphinx</a> |
| </div> |
| </div> |
| </div> |
| </footer> |
| <script src="../../_static/javascripts/application.js"></script> |
| <script src="../../_static/javascripts/f4pga.js"></script> |
| <script>app.initialize({version: "1.0.4", url: {base: ".."}})</script> |
| </body> |
| </html> |
