Skip to content

Commit

Permalink
deploy: 1c6ae51
Browse files Browse the repository at this point in the history
  • Loading branch information
Risto97 committed Oct 5, 2024
1 parent d8d47d2 commit 44098ed
Show file tree
Hide file tree
Showing 21 changed files with 28 additions and 199 deletions.
1 change: 0 additions & 1 deletion api_html/_sources/peakrdl/index.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -13,5 +13,4 @@ cmake.peakrdl
peakrdl_ipblocksvg
peakrdl_print
peakrdl_regblock
peakrdl_regblock_wrap

20 changes: 11 additions & 9 deletions api_html/_sources/peakrdl/peakrdl_regblock.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -13,33 +13,35 @@ cmake.peakrdl/peakrdl_regblock
PeakRDL-regblock is transforming SystemRDL input files to SystemVerilog register block files.
Regblock documentation can be found on this `link <https://peakrdl-regblock.readthedocs.io/en/latest/>`_.

Function expects that **${IP_LIB}** *INTERFACE_LIBRARY* has **SYSTEMRDL_SOURCES** property set with
Function expects that **${IP_LIB}** has **SYSTEMRDL_SOURCES** property set with
a list of SystemRDL files to be used as inputs. To set the SYSTEMRDL_SOURCES property use the ip_sources()
function from SoCMake (internally using `set_property()
<https://cmake.org/cmake/help/latest/command/set_property.html>`_ CMake function):

.. code-block:: cmake
ip_sources(IP_LIB LANGUAGE [SYSTEMRDL|SYSTEMVERILOG|...] ${PROJECT_SOURCE_DIR}/file.rdl)
ip_sources(ip SYSTEMRDL ${PROJECT_SOURCE_DIR}/file.rdl)
This function will append 2 generated files from PeakRDL-regblock to the **SOURCES** property of the
This function will append 2 generated files from PeakRDL-regblock to the **SYSTEMVERILOG_SOURCES** property of the
**${IP_LIB}**.

:param IP_LIB: RTL interface library, it needs to have SYSTEMRDL_SOURCES property set with a list of
SystemRDL files.
:type IP_LIB: INTERFACE_LIBRARY
:param IP_LIB: IP for which to create regblock target.
:type IP_LIB: IP library

**Keyword Arguments**

:keyword OUTDIR: output directory in which the files will be generated.
If ommited ${BINARY_DIR}/regblock will be used.
:type OUTDIR: string path
:type OUTDIR: string
:keyword RENAME: Rename the generated module and file name to a custom string, otherwise the
name will be ${IP_LIB}.sv.
:type RENAME: string
:keyword INTF: Interface to use for the regblock. Possible values are:
[apb3 (default), apb3-flat, apb4, apb4-flat, axi4-lite, axi4-lite-flat, avalon-mm, avalon-mm-flat, passthrough]
:type INTF: string
:keyword RESET: reset type for generated regblock. Possible values are:
[rst (default), rst,rst_n,arst,arst_n]
:type RESET: string
:keyword ARGS: any additional arguments to pass to regblock cli executable
:type ARGS: list


12 changes: 0 additions & 12 deletions api_html/_sources/peakrdl/peakrdl_regblock_wrap.rst.txt

This file was deleted.

11 changes: 0 additions & 11 deletions api_html/genindex.html
Original file line number Diff line number Diff line change
Expand Up @@ -181,13 +181,6 @@ <h2 id="C">C</h2>

<ul>
<li><a href="peakrdl/peakrdl_regblock.html#module-cmake.peakrdl-peakrdl_regblock">module</a>
</li>
</ul></li>
<li>
cmake.peakrdl/peakrdl_regblock_wrap

<ul>
<li><a href="peakrdl/peakrdl_regblock_wrap.html#module-cmake.peakrdl-peakrdl_regblock_wrap">module</a>
</li>
</ul></li>
<li>
Expand Down Expand Up @@ -456,8 +449,6 @@ <h2 id="M">M</h2>
<li><a href="peakrdl/peakrdl_print.html#module-cmake.peakrdl-peakrdl_print">cmake.peakrdl/peakrdl_print</a>
</li>
<li><a href="peakrdl/peakrdl_regblock.html#module-cmake.peakrdl-peakrdl_regblock">cmake.peakrdl/peakrdl_regblock</a>
</li>
<li><a href="peakrdl/peakrdl_regblock_wrap.html#module-cmake.peakrdl-peakrdl_regblock_wrap">cmake.peakrdl/peakrdl_regblock_wrap</a>
</li>
<li><a href="peakrdl/peakrdl_socgen/peakrdl_socgen.html#module-cmake.peakrdl-peakrdl_socgen-peakrdl_socgen">cmake.peakrdl/peakrdl_socgen/peakrdl_socgen</a>
</li>
Expand Down Expand Up @@ -547,8 +538,6 @@ <h2 id="P">P</h2>
<li><a href="peakrdl/peakrdl_print.html#cmake.peakrdl-peakrdl_print.peakrdl_print">peakrdl_print() (in module cmake.peakrdl/peakrdl_print)</a>
</li>
<li><a href="peakrdl/peakrdl_regblock.html#cmake.peakrdl-peakrdl_regblock.peakrdl_regblock">peakrdl_regblock() (in module cmake.peakrdl/peakrdl_regblock)</a>
</li>
<li><a href="peakrdl/peakrdl_regblock_wrap.html#cmake.peakrdl-peakrdl_regblock_wrap.peakrdl_regblock_wrap">peakrdl_regblock_wrap() (in module cmake.peakrdl/peakrdl_regblock_wrap)</a>
</li>
<li><a href="peakrdl/peakrdl_socgen/peakrdl_socgen.html#cmake.peakrdl-peakrdl_socgen-peakrdl_socgen.peakrdl_socgen">peakrdl_socgen() (in module cmake.peakrdl/peakrdl_socgen/peakrdl_socgen)</a>
</li>
Expand Down
1 change: 0 additions & 1 deletion api_html/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,6 @@ <h1>cmake<a class="headerlink" href="#cmake" title="Link to this heading">¶</a>
<li class="toctree-l2"><a class="reference internal" href="peakrdl/peakrdl_ipblocksvg.html">cmake.peakrdl/peakrdl_ipblocksvg</a></li>
<li class="toctree-l2"><a class="reference internal" href="peakrdl/peakrdl_print.html">cmake.peakrdl/peakrdl_print</a></li>
<li class="toctree-l2"><a class="reference internal" href="peakrdl/peakrdl_regblock.html">cmake.peakrdl/peakrdl_regblock</a></li>
<li class="toctree-l2"><a class="reference internal" href="peakrdl/peakrdl_regblock_wrap.html">cmake.peakrdl/peakrdl_regblock_wrap</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="synth/index.html">cmake.synth</a><ul>
Expand Down
Binary file modified api_html/objects.inv
Binary file not shown.
5 changes: 0 additions & 5 deletions api_html/peakrdl/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -66,10 +66,6 @@ <h1>cmake.peakrdl<a class="headerlink" href="#cmake-peakrdl" title="Link to this
<li class="toctree-l2"><a class="reference internal" href="peakrdl_regblock.html#cmake.peakrdl-peakrdl_regblock.peakrdl_regblock"><code class="docutils literal notranslate"><span class="pre">peakrdl_regblock()</span></code></a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="peakrdl_regblock_wrap.html">cmake.peakrdl/peakrdl_regblock_wrap</a><ul>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_regblock_wrap.html#cmake.peakrdl-peakrdl_regblock_wrap.peakrdl_regblock_wrap"><code class="docutils literal notranslate"><span class="pre">peakrdl_regblock_wrap()</span></code></a></li>
</ul>
</li>
</ul>
</div>
</section>
Expand Down Expand Up @@ -101,7 +97,6 @@ <h3>Navigation</h3>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_ipblocksvg.html">cmake.peakrdl/peakrdl_ipblocksvg</a></li>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_print.html">cmake.peakrdl/peakrdl_print</a></li>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_regblock.html">cmake.peakrdl/peakrdl_regblock</a></li>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_regblock_wrap.html">cmake.peakrdl/peakrdl_regblock_wrap</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../synth/index.html">cmake.synth</a></li>
Expand Down
1 change: 0 additions & 1 deletion api_html/peakrdl/peakrdl_docusaurus.html
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,6 @@ <h3>Navigation</h3>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_ipblocksvg.html">cmake.peakrdl/peakrdl_ipblocksvg</a></li>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_print.html">cmake.peakrdl/peakrdl_print</a></li>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_regblock.html">cmake.peakrdl/peakrdl_regblock</a></li>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_regblock_wrap.html">cmake.peakrdl/peakrdl_regblock_wrap</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../synth/index.html">cmake.synth</a></li>
Expand Down
1 change: 0 additions & 1 deletion api_html/peakrdl/peakrdl_halcpp.html
Original file line number Diff line number Diff line change
Expand Up @@ -108,7 +108,6 @@ <h3>Navigation</h3>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_ipblocksvg.html">cmake.peakrdl/peakrdl_ipblocksvg</a></li>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_print.html">cmake.peakrdl/peakrdl_print</a></li>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_regblock.html">cmake.peakrdl/peakrdl_regblock</a></li>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_regblock_wrap.html">cmake.peakrdl/peakrdl_regblock_wrap</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../synth/index.html">cmake.synth</a></li>
Expand Down
1 change: 0 additions & 1 deletion api_html/peakrdl/peakrdl_html/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,6 @@ <h3>Navigation</h3>
<li class="toctree-l2"><a class="reference internal" href="../peakrdl_ipblocksvg.html">cmake.peakrdl/peakrdl_ipblocksvg</a></li>
<li class="toctree-l2"><a class="reference internal" href="../peakrdl_print.html">cmake.peakrdl/peakrdl_print</a></li>
<li class="toctree-l2"><a class="reference internal" href="../peakrdl_regblock.html">cmake.peakrdl/peakrdl_regblock</a></li>
<li class="toctree-l2"><a class="reference internal" href="../peakrdl_regblock_wrap.html">cmake.peakrdl/peakrdl_regblock_wrap</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../synth/index.html">cmake.synth</a></li>
Expand Down
1 change: 0 additions & 1 deletion api_html/peakrdl/peakrdl_html/peakrdl_html.html
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,6 @@ <h3>Navigation</h3>
<li class="toctree-l2"><a class="reference internal" href="../peakrdl_ipblocksvg.html">cmake.peakrdl/peakrdl_ipblocksvg</a></li>
<li class="toctree-l2"><a class="reference internal" href="../peakrdl_print.html">cmake.peakrdl/peakrdl_print</a></li>
<li class="toctree-l2"><a class="reference internal" href="../peakrdl_regblock.html">cmake.peakrdl/peakrdl_regblock</a></li>
<li class="toctree-l2"><a class="reference internal" href="../peakrdl_regblock_wrap.html">cmake.peakrdl/peakrdl_regblock_wrap</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../synth/index.html">cmake.synth</a></li>
Expand Down
1 change: 0 additions & 1 deletion api_html/peakrdl/peakrdl_html/peakrdl_html_md.html
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,6 @@ <h3>Navigation</h3>
<li class="toctree-l2"><a class="reference internal" href="../peakrdl_ipblocksvg.html">cmake.peakrdl/peakrdl_ipblocksvg</a></li>
<li class="toctree-l2"><a class="reference internal" href="../peakrdl_print.html">cmake.peakrdl/peakrdl_print</a></li>
<li class="toctree-l2"><a class="reference internal" href="../peakrdl_regblock.html">cmake.peakrdl/peakrdl_regblock</a></li>
<li class="toctree-l2"><a class="reference internal" href="../peakrdl_regblock_wrap.html">cmake.peakrdl/peakrdl_regblock_wrap</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../../synth/index.html">cmake.synth</a></li>
Expand Down
1 change: 0 additions & 1 deletion api_html/peakrdl/peakrdl_ipblocksvg.html
Original file line number Diff line number Diff line change
Expand Up @@ -108,7 +108,6 @@ <h3>Navigation</h3>
<li class="toctree-l2 current"><a class="current reference internal" href="#">cmake.peakrdl/peakrdl_ipblocksvg</a></li>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_print.html">cmake.peakrdl/peakrdl_print</a></li>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_regblock.html">cmake.peakrdl/peakrdl_regblock</a></li>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_regblock_wrap.html">cmake.peakrdl/peakrdl_regblock_wrap</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../synth/index.html">cmake.synth</a></li>
Expand Down
1 change: 0 additions & 1 deletion api_html/peakrdl/peakrdl_print.html
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,6 @@ <h3>Navigation</h3>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_ipblocksvg.html">cmake.peakrdl/peakrdl_ipblocksvg</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">cmake.peakrdl/peakrdl_print</a></li>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_regblock.html">cmake.peakrdl/peakrdl_regblock</a></li>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_regblock_wrap.html">cmake.peakrdl/peakrdl_regblock_wrap</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../synth/index.html">cmake.synth</a></li>
Expand Down
27 changes: 14 additions & 13 deletions api_html/peakrdl/peakrdl_regblock.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="cmake.peakrdl/peakrdl_regblock_wrap" href="peakrdl_regblock_wrap.html" />
<link rel="next" title="cmake.synth" href="../synth/index.html" />
<link rel="prev" title="cmake.peakrdl/peakrdl_print" href="peakrdl_print.html" />

<link rel="stylesheet" href="../_static/custom.css" type="text/css" />
Expand All @@ -40,35 +40,37 @@
<dd><p>Create a target for invoking PeakRDL-regblock on IP_LIB.</p>
<p>PeakRDL-regblock is transforming SystemRDL input files to SystemVerilog register block files.
Regblock documentation can be found on this <a class="reference external" href="https://peakrdl-regblock.readthedocs.io/en/latest/">link</a>.</p>
<p>Function expects that <strong>${IP_LIB}</strong> <em>INTERFACE_LIBRARY</em> has <strong>SYSTEMRDL_SOURCES</strong> property set with
a list of SystemRDL files to be used as inputs. To set the SYSTEMRDL_SOURCES property use the ip_sources()
function from SoCMake (internally using <a class="reference external" href="https://cmake.org/cmake/help/latest/command/set_property.html">set_property()</a> CMake function):</p>
<div class="highlight-cmake notranslate"><div class="highlight"><pre><span></span><span class="nb">ip_sources</span><span class="p">(</span><span class="s">IP_LIB</span><span class="w"> </span><span class="s">LANGUAGE</span><span class="w"> </span><span class="s">[SYSTEMRDL|SYSTEMVERILOG|...]</span><span class="w"> </span><span class="o">${</span><span class="nv">PROJECT_SOURCE_DIR</span><span class="o">}</span><span class="s">/file.rdl</span><span class="p">)</span>
<p>Function expects that <strong>${IP_LIB}</strong> has <strong>SYSTEMRDL_SOURCES</strong> property set with
a list of SystemRDL files to be used as inputs. To set the SYSTEMRDL_SOURCES property use the ip_sources()</p>
<div class="highlight-cmake notranslate"><div class="highlight"><pre><span></span><span class="nb">ip_sources</span><span class="p">(</span><span class="s">ip</span><span class="w"> </span><span class="s">SYSTEMRDL</span><span class="w"> </span><span class="o">${</span><span class="nv">PROJECT_SOURCE_DIR</span><span class="o">}</span><span class="s">/file.rdl</span><span class="p">)</span>
</pre></div>
</div>
<p>This function will append 2 generated files from PeakRDL-regblock to the <strong>SOURCES</strong> property of the
<p>This function will append 2 generated files from PeakRDL-regblock to the <strong>SYSTEMVERILOG_SOURCES</strong> property of the
<strong>${IP_LIB}</strong>.</p>
<dl class="field-list simple">
<dt class="field-odd">Parameters<span class="colon">:</span></dt>
<dd class="field-odd"><p><strong>IP_LIB</strong> – RTL interface library, it needs to have SYSTEMRDL_SOURCES property set with a list of</p>
<dd class="field-odd"><p><strong>IP_LIB</strong> (<em>IP library</em>) – IP for which to create regblock target.</p>
</dd>
</dl>
<p>SystemRDL files.
:type IP_LIB: INTERFACE_LIBRARY</p>
<p><strong>Keyword Arguments</strong></p>
<dl class="field-list simple">
<dt class="field-odd">Parameters<span class="colon">:</span></dt>
<dd class="field-odd"><p><strong>OUTDIR</strong> – output directory in which the files will be generated.</p>
</dd>
</dl>
<p>If ommited ${BINARY_DIR}/regblock will be used.
:type OUTDIR: string path
:type OUTDIR: string
:keyword RENAME: Rename the generated module and file name to a custom string, otherwise the
name will be ${IP_LIB}.sv.
:type RENAME: string
:keyword INTF: Interface to use for the regblock. Possible values are:
[apb3 (default), apb3-flat, apb4, apb4-flat, axi4-lite, axi4-lite-flat, avalon-mm, avalon-mm-flat, passthrough]
:type INTF: string</p>
:type INTF: string
:keyword RESET: reset type for generated regblock. Possible values are:
[rst (default), rst,rst_n,arst,arst_n]
:type RESET: string
:keyword ARGS: any additional arguments to pass to regblock cli executable
:type ARGS: list</p>
</dd></dl>

</section>
Expand Down Expand Up @@ -100,7 +102,6 @@ <h3>Navigation</h3>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_ipblocksvg.html">cmake.peakrdl/peakrdl_ipblocksvg</a></li>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_print.html">cmake.peakrdl/peakrdl_print</a></li>
<li class="toctree-l2 current"><a class="current reference internal" href="#">cmake.peakrdl/peakrdl_regblock</a></li>
<li class="toctree-l2"><a class="reference internal" href="peakrdl_regblock_wrap.html">cmake.peakrdl/peakrdl_regblock_wrap</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="../synth/index.html">cmake.synth</a></li>
Expand All @@ -116,7 +117,7 @@ <h3>Related Topics</h3>
<li><a href="../index.html">Documentation overview</a><ul>
<li><a href="index.html">cmake.peakrdl</a><ul>
<li>Previous: <a href="peakrdl_print.html" title="previous chapter">cmake.peakrdl/peakrdl_print</a></li>
<li>Next: <a href="peakrdl_regblock_wrap.html" title="next chapter">cmake.peakrdl/peakrdl_regblock_wrap</a></li>
<li>Next: <a href="../synth/index.html" title="next chapter">cmake.synth</a></li>
</ul></li>
</ul></li>
</ul>
Expand Down
Loading

0 comments on commit 44098ed

Please sign in to comment.