This commit is contained in:
trabucayre 2026-02-16 14:31:48 +00:00
parent 6dc9366859
commit bfc9a2f2ea
24 changed files with 47 additions and 40 deletions

Binary file not shown.

View File

@ -1,7 +1,7 @@
.. _troubleshooting:
Troubleshooting Guide
#####################
Troubleshooting
###############
I installed openFPGALoader but it says `command not found` when I try to launch it
==================================================================================

View File

@ -1013,77 +1013,84 @@ openFPGALoader<span class="w"> </span>-b<span class="w"> </span>arty<span class=
<td><p>OK</p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>zc702</p></td>
<tr class="row-odd"><td><p>ypcb003381p1</p></td>
<td><p><a class="reference external" href="https://www.tiferking.cn/index.php/2024/12/19/650/">YPCB-00338-1P1 Kintex-7 Accelerator Card</a></p></td>
<td><p>Kintex7 xc7k480tffg1156</p></td>
<td><p>OK</p></td>
<td><p>OK. BPI parallel NOR flash (MT28GU512AAA1EGC)</p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>zc702</p></td>
<td><p><a class="reference external" href="https://www.xilinx.com/products/boards-and-kits/ek-z7-zc702-g.html">Xilinx ZC702</a></p></td>
<td><p>zynq7000 xc7z020clg484</p></td>
<td><p>OK</p></td>
<td><p>NA</p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>zc706</p></td>
<tr class="row-odd"><td><p>zc706</p></td>
<td><p><a class="reference external" href="https://www.xilinx.com/products/boards-and-kits/ek-z7-zc706-g.html">Xilinx ZC706</a></p></td>
<td><p>zynq7000 xc7z045ffg900</p></td>
<td><p>OK</p></td>
<td><p>NA</p></td>
<td><p><a class="reference external" href="https://hdl.github.io/constraints/Data/Boards/index.html#boards-zc706" title="(in FPGA Board Constraints latest)"><span class="xref std std-ref">ZC706 ➚</span></a></p></td>
</tr>
<tr class="row-odd"><td><p>zcu102</p></td>
<tr class="row-even"><td><p>zcu102</p></td>
<td><p><a class="reference external" href="https://www.xilinx.com/products/boards-and-kits/ek-u1-zcu102-g.html">Xilinx ZCU102</a></p></td>
<td><p>zynqMPSoC XCZU9EG</p></td>
<td><p>OK</p></td>
<td><p>NA</p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>zcu106</p></td>
<tr class="row-odd"><td><p>zcu106</p></td>
<td><p><a class="reference external" href="https://www.xilinx.com/products/boards-and-kits/zcu106.html">Xilinx ZCU106</a></p></td>
<td><p>zynqMPSoC XCZU7EV</p></td>
<td><p>OK</p></td>
<td><p>NA</p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>zedboard</p></td>
<tr class="row-even"><td><p>zedboard</p></td>
<td><p><a class="reference external" href="https://www.avnet.com/wps/portal/us/products/avnet-boards/avnet-board-families/zedboard/">Avnet ZedBoard</a></p></td>
<td><p>zynq7000 xc7z020clg484</p></td>
<td><p>OK</p></td>
<td><p>NA</p></td>
<td><p><a class="reference external" href="https://hdl.github.io/constraints/Data/Boards/index.html#boards-zedboard" title="(in FPGA Board Constraints latest)"><span class="xref std std-ref">ZedBoard ➚</span></a></p></td>
</tr>
<tr class="row-even"><td><p>zybo_z7_10</p></td>
<tr class="row-odd"><td><p>zybo_z7_10</p></td>
<td><p><a class="reference external" href="https://reference.digilentinc.com/reference/programmable-logic/zybo-z7/start">Digilent Zybo Z7-10</a></p></td>
<td><p>zynq7000 xc7z010clg400</p></td>
<td><p>OK</p></td>
<td><p>NA</p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>zybo_z7_20</p></td>
<tr class="row-even"><td><p>zybo_z7_20</p></td>
<td><p><a class="reference external" href="https://reference.digilentinc.com/reference/programmable-logic/zybo-z7/start">Digilent Zybo Z7-20</a></p></td>
<td><p>zynq7000 xc7z020clg400</p></td>
<td><p>OK</p></td>
<td><p>NA</p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>VMM3</p></td>
<tr class="row-odd"><td><p>VMM3</p></td>
<td><p><a class="reference external" href="https://vmm-srs.docs.cern.ch/">CERN board with VMM3</a></p></td>
<td><p>xc7s50csga324?</p></td>
<td><p>OK</p></td>
<td><p>OK</p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>efinix_jtag_ft2232</p></td>
<tr class="row-even"><td><p>efinix_jtag_ft2232</p></td>
<td><p><a class="reference external" href="https://www.efinixinc.com/products-devkits-titaniumti180j484.html">Efinix FT2232 development boards with JTAG on port 2 (Ti180J484 EVK, etc)</a></p></td>
<td><p>Titanium Ti180J484 (and others)</p></td>
<td><p>OK</p></td>
<td><p>NA</p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>step-max10_v1</p></td>
<tr class="row-odd"><td><p>step-max10_v1</p></td>
<td><p><a class="reference external" href="https://wiki.stepfpga.com/step-max10">STEP MAX10 V1</a></p></td>
<td><p>Altera 10M02SCM153C8G</p></td>
<td><p>OK</p></td>
<td><p>NA</p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>step-mxo2_v2</p></td>
<tr class="row-even"><td><p>step-mxo2_v2</p></td>
<td><p><a class="reference external" href="https://wiki.stepfpga.com/xo2-4000hc">STEP MXO2 V2</a></p></td>
<td><p>Lattice LCMXO2-4000HC-4MG132CC</p></td>
<td><p>OK</p></td>
@ -1131,7 +1138,7 @@ openFPGALoader<span class="w"> </span>-b<span class="w"> </span>arty<span class=
<ul>
<li class="toctree-l1"><a class="reference internal" href="../guide/first-steps.html">First steps with openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/install.html">Installing openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/advanced.html">Advanced usage of openFPGALoader</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Compatibility</span></p>

View File

@ -289,7 +289,7 @@
<ul>
<li class="toctree-l1"><a class="reference internal" href="../guide/first-steps.html">First steps with openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/install.html">Installing openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/advanced.html">Advanced usage of openFPGALoader</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Compatibility</span></p>

View File

@ -355,7 +355,7 @@
<ul>
<li class="toctree-l1"><a class="reference internal" href="../guide/first-steps.html">First steps with openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/install.html">Installing openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/advanced.html">Advanced usage of openFPGALoader</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Compatibility</span></p>

View File

@ -67,7 +67,7 @@
<ul>
<li class="toctree-l1"><a class="reference internal" href="guide/first-steps.html">First steps with openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="guide/install.html">Installing openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="guide/troubleshooting.html">Troubleshooting Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="guide/troubleshooting.html">Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="guide/advanced.html">Advanced usage of openFPGALoader</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Compatibility</span></p>

View File

@ -15,7 +15,7 @@
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="FPGAs" href="../compatibility/fpga.html" />
<link rel="prev" title="Troubleshooting Guide" href="troubleshooting.html" />
<link rel="prev" title="Troubleshooting" href="troubleshooting.html" />
<link rel="stylesheet" href="../_static/custom.css" type="text/css" />
@ -189,7 +189,7 @@ openFPGALoader<span class="w"> </span>xxxx
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="first-steps.html">First steps with openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="install.html">Installing openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">Troubleshooting Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">Troubleshooting</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Advanced usage of openFPGALoader</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#resetting-an-fpga">Resetting an FPGA</a></li>
<li class="toctree-l2"><a class="reference internal" href="#using-negative-edge-for-tdo-s-sampling">Using negative edge for TDOs sampling</a></li>
@ -227,7 +227,7 @@ openFPGALoader<span class="w"> </span>xxxx
<h3>Related Topics</h3>
<ul>
<li><a href="../index.html">Documentation overview</a><ul>
<li>Previous: <a href="troubleshooting.html" title="previous chapter">Troubleshooting Guide</a></li>
<li>Previous: <a href="troubleshooting.html" title="previous chapter">Troubleshooting</a></li>
<li>Next: <a href="../compatibility/fpga.html" title="next chapter">FPGAs</a></li>
</ul></li>
</ul>

View File

@ -86,7 +86,7 @@ Therefore it is preferable to use this flag if your computer is connected to mul
</section>
<section id="troubleshooting">
<h2>Troubleshooting<a class="headerlink" href="#troubleshooting" title="Link to this heading"></a></h2>
<p>Please refer to <a class="reference internal" href="troubleshooting.html#troubleshooting"><span class="std std-ref">Troubleshooting Guide</span></a>.</p>
<p>Please refer to <a class="reference internal" href="troubleshooting.html#troubleshooting"><span class="std std-ref">Troubleshooting</span></a>.</p>
</section>
</section>
@ -126,7 +126,7 @@ Therefore it is preferable to use this flag if your computer is connected to mul
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="install.html">Installing openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">Troubleshooting Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="advanced.html">Advanced usage of openFPGALoader</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Compatibility</span></p>

View File

@ -14,7 +14,7 @@
<script src="../_static/sphinx_highlight.js?v=6ffebe34"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="Troubleshooting Guide" href="troubleshooting.html" />
<link rel="next" title="Troubleshooting" href="troubleshooting.html" />
<link rel="prev" title="First steps with openFPGALoader" href="first-steps.html" />
<link rel="stylesheet" href="../_static/custom.css" type="text/css" />
@ -300,7 +300,7 @@ that only depends on standard Windows system DLLs (KERNEL32, msvcrt, WS2_32).</p
<li class="toctree-l2"><a class="reference internal" href="#common">Common</a></li>
</ul>
</li>
<li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">Troubleshooting Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="troubleshooting.html">Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="advanced.html">Advanced usage of openFPGALoader</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Compatibility</span></p>
@ -329,7 +329,7 @@ that only depends on standard Windows system DLLs (KERNEL32, msvcrt, WS2_32).</p
<ul>
<li><a href="../index.html">Documentation overview</a><ul>
<li>Previous: <a href="first-steps.html" title="previous chapter">First steps with openFPGALoader</a></li>
<li>Next: <a href="troubleshooting.html" title="next chapter">Troubleshooting Guide</a></li>
<li>Next: <a href="troubleshooting.html" title="next chapter">Troubleshooting</a></li>
</ul></li>
</ul>
</div>

View File

@ -5,7 +5,7 @@
<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" />
<title>Troubleshooting Guide &#8212; openFPGALoader: universal utility for programming FPGA latest documentation</title>
<title>Troubleshooting &#8212; openFPGALoader: universal utility for programming FPGA latest documentation</title>
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=5ecbeea2" />
<link rel="stylesheet" type="text/css" href="../_static/basic.css?v=b08954a9" />
<link rel="stylesheet" type="text/css" href="../_static/alabaster.css?v=27fed22d" />
@ -33,8 +33,8 @@
<div class="body" role="main">
<section id="troubleshooting-guide">
<span id="troubleshooting"></span><h1>Troubleshooting Guide<a class="headerlink" href="#troubleshooting-guide" title="Link to this heading"></a></h1>
<section id="troubleshooting">
<span id="id1"></span><h1>Troubleshooting<a class="headerlink" href="#troubleshooting" title="Link to this heading"></a></h1>
<section id="i-installed-openfpgaloader-but-it-says-command-not-found-when-i-try-to-launch-it">
<h2>I installed openFPGALoader but it says <cite>command not found</cite> when I try to launch it<a class="headerlink" href="#i-installed-openfpgaloader-but-it-says-command-not-found-when-i-try-to-launch-it" title="Link to this heading"></a></h2>
<p>The correct spelling of the program is <em>openFPGALoader</em> with FPGA and the “L” of “Loader” in uppercase.
@ -103,7 +103,7 @@ To recover you have to pull down this pin (before power up) to recover JTAG inte
<ul class="current">
<li class="toctree-l1"><a class="reference internal" href="first-steps.html">First steps with openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="install.html">Installing openFPGALoader</a></li>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Troubleshooting Guide</a><ul>
<li class="toctree-l1 current"><a class="current reference internal" href="#">Troubleshooting</a><ul>
<li class="toctree-l2"><a class="reference internal" href="#i-installed-openfpgaloader-but-it-says-command-not-found-when-i-try-to-launch-it">I installed openFPGALoader but it says <cite>command not found</cite> when I try to launch it</a></li>
<li class="toctree-l2"><a class="reference internal" href="#gowin-device-could-not-communicate-since-last-bitstream-flashed-issue-206">Gowin device could not communicate since last bitstream flashed. (issue #206)</a></li>
<li class="toctree-l2"><a class="reference internal" href="#jtag-init-failed">JTAG init failed</a></li>

View File

@ -94,7 +94,7 @@ openFPGALoader works on Linux, Windows and macOS.</p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="guide/first-steps.html">First steps with openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="guide/install.html">Installing openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="guide/troubleshooting.html">Troubleshooting Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="guide/troubleshooting.html">Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="guide/advanced.html">Advanced usage of openFPGALoader</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Compatibility</span></p>

Binary file not shown.

View File

@ -85,7 +85,7 @@
<ul>
<li class="toctree-l1"><a class="reference internal" href="guide/first-steps.html">First steps with openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="guide/install.html">Installing openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="guide/troubleshooting.html">Troubleshooting Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="guide/troubleshooting.html">Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="guide/advanced.html">Advanced usage of openFPGALoader</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Compatibility</span></p>

File diff suppressed because one or more lines are too long

View File

@ -97,7 +97,7 @@
<ul>
<li class="toctree-l1"><a class="reference internal" href="guide/first-steps.html">First steps with openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="guide/install.html">Installing openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="guide/troubleshooting.html">Troubleshooting Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="guide/troubleshooting.html">Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="guide/advanced.html">Advanced usage of openFPGALoader</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Compatibility</span></p>

View File

@ -107,7 +107,7 @@ make
<ul>
<li class="toctree-l1"><a class="reference internal" href="../guide/first-steps.html">First steps with openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/install.html">Installing openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/advanced.html">Advanced usage of openFPGALoader</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Compatibility</span></p>

View File

@ -150,7 +150,7 @@
<ul>
<li class="toctree-l1"><a class="reference internal" href="../guide/first-steps.html">First steps with openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/install.html">Installing openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/advanced.html">Advanced usage of openFPGALoader</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Compatibility</span></p>

2
vendors/efinix.html vendored
View File

@ -103,7 +103,7 @@ NOTE: JTAG chains with more than one device (eg index-chain) are currently no
<ul>
<li class="toctree-l1"><a class="reference internal" href="../guide/first-steps.html">First steps with openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/install.html">Installing openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/advanced.html">Advanced usage of openFPGALoader</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Compatibility</span></p>

2
vendors/gowin.html vendored
View File

@ -136,7 +136,7 @@ flash section can also be programmed via the JTAG interface:</p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../guide/first-steps.html">First steps with openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/install.html">Installing openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/advanced.html">Advanced usage of openFPGALoader</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Compatibility</span></p>

2
vendors/intel.html vendored
View File

@ -258,7 +258,7 @@ and <code class="docutils literal notranslate"><span class="pre">CFM2</span></co
<ul>
<li class="toctree-l1"><a class="reference internal" href="../guide/first-steps.html">First steps with openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/install.html">Installing openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/advanced.html">Advanced usage of openFPGALoader</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Compatibility</span></p>

View File

@ -168,7 +168,7 @@ file.</p>
<ul>
<li class="toctree-l1"><a class="reference internal" href="../guide/first-steps.html">First steps with openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/install.html">Installing openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/advanced.html">Advanced usage of openFPGALoader</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Compatibility</span></p>

2
vendors/xilinx.html vendored
View File

@ -175,7 +175,7 @@ The default target is the <code class="docutils literal notranslate"><span class
<ul>
<li class="toctree-l1"><a class="reference internal" href="../guide/first-steps.html">First steps with openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/install.html">Installing openFPGALoader</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting Guide</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/troubleshooting.html">Troubleshooting</a></li>
<li class="toctree-l1"><a class="reference internal" href="../guide/advanced.html">Advanced usage of openFPGALoader</a></li>
</ul>
<p class="caption" role="heading"><span class="caption-text">Compatibility</span></p>