deploy: 276e42c

Author: lbnl-atg

_downloads/154749296992c7b81e8456297654299c/block.pdf

@@ -124,45 +124,6 @@
 <span id="readme"></span><h1>i2c README<a class="headerlink" href="#i2c-readme" title="Permalink to this heading"></a></h1>
 <section id="marble-platform-support-for-i2cbridge-programming">
 <h2>Marble Platform Support for I2CBridge Programming<a class="headerlink" href="#marble-platform-support-for-i2cbridge-programming" title="Permalink to this heading"></a></h2>
-<section id="one-shot-i2c-transactions">
-<h3>One-shot I2C transactions<a class="headerlink" href="#one-shot-i2c-transactions" title="Permalink to this heading"></a></h3>
-<p>The script <code class="docutils literal notranslate"><span class="pre">oneshot.py</span></code> is included here to allow composing and running single-transaction
-<code class="docutils literal notranslate"><span class="pre">i2cbridge</span></code> programs to a live target with a (hopefully) user-friendly interface.  Without
-worrying about the I2C tree on the Marble board or chip addresses, you can simply read from
-or write to any register in any chip just referring to the chip by name (refdes on the
-schematic).</p>
-<p>Example: turn on LD13 via the GPIO expander U39 by writing to register 3
-<strong>WARNING</strong>: The user LEDs are on the same port as <code class="docutils literal notranslate"><span class="pre">/CLKMUX_RST</span></code> which means we can shut down the board on accident
-if we aren’t very careful to ensure we always keep bit 7 asserted when writing to this register!</p>
-<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">PYTHONPATH</span><span class="o">=</span>../../../peripheral_drivers/i2cbridge:<span class="nv">$PYTHONPATH</span><span class="w"> </span>python3<span class="w"> </span>oneshot.py<span class="w"> </span>leep://<span class="nv">$IP</span>:<span class="nv">$PORT</span><span class="w"> </span>U39.3<span class="o">=</span>0x80
-</pre></div>
-</div>
-<p>Example: turn off LD13</p>
-<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">PYTHONPATH</span><span class="o">=</span>../../../peripheral_drivers/i2cbridge:<span class="nv">$PYTHONPATH</span><span class="w"> </span>python3<span class="w"> </span>oneshot.py<span class="w"> </span>leep://<span class="nv">$IP</span>:<span class="nv">$PORT</span><span class="w"> </span>U39.3<span class="o">=</span>0x88
-</pre></div>
-</div>
-<p>Example: read the inputs to port 0 on the GPIO expander U39 by reading from register 0</p>
-<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">PYTHONPATH</span><span class="o">=</span>../../../peripheral_drivers/i2cbridge:<span class="nv">$PYTHONPATH</span><span class="w"> </span>python3<span class="w"> </span>oneshot.py<span class="w"> </span>leep://192.168.19.40:803<span class="w"> </span>U39.0
-</pre></div>
-</div>
-<p><em>(The following demos assume you have exported ``PYTHONPATH`` for brevity)</em></p>
-<p>We can also read more than 1 byte (very much dependent on the specifics of the IC’s I2C implementation).
-Example: read shunt voltage (addr 1, 16 bits) from INA219 U57</p>
-<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>python3<span class="w"> </span>oneshot.py<span class="w"> </span>leep://<span class="nv">$IP</span>:<span class="nv">$PORT</span><span class="w"> </span>U57.1:2
-<span class="c1"># Note the &#39;:&#39; instead of a &#39;=&#39; (the latter indicates a write!)</span>
-</pre></div>
-</div>
-<p>Note that you can perform many transactions in one “one shot” program, including adding pauses between
-transactions, as in this demo disabling and re-enabling QSFP1 channel 0:</p>
-<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>python3<span class="w"> </span>oneshot.py<span class="w"> </span>leep://<span class="nv">$IP</span>:<span class="nv">$PORT</span><span class="w"> </span>J17.86<span class="o">=</span><span class="m">1</span><span class="w"> </span>J17.86<span class="o">=</span><span class="m">0</span>
-</pre></div>
-</div>
-<p>And breaking the “one shot” model, you can tell the program to continue looping after the script exits.
-This demo makes LD13 continually blink.</p>
-<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>python3<span class="w"> </span>oneshot.py<span class="w"> </span>leep://<span class="nv">$IP</span>:<span class="nv">$PORT</span><span class="w"> </span>U39.3<span class="o">=</span>0x80<span class="w"> </span><span class="nv">pause</span><span class="o">=</span><span class="m">500</span><span class="w"> </span>U39.3<span class="o">=</span>0x88<span class="w"> </span><span class="nv">pause</span><span class="o">=</span><span class="m">500</span><span class="w"> </span>-l
-</pre></div>
-</div>
-</section>
 <section id="usage">
 <h3>Usage:<a class="headerlink" href="#usage" title="Permalink to this heading"></a></h3>
 <p>These tools assume usage of the i2cbridge modules in <code class="docutils literal notranslate"><span class="pre">bedrock/peripheral_drivers/i2cbridge</span></code>.
@@ -226,7 +187,7 @@ <h4>Test 2: Decode the program without platform awareness<a class="headerlink" h
 <h4>Test 3: Test assembler violations<a class="headerlink" href="#test-3-test-assembler-violations" title="Permalink to this heading"></a></h4>
 <p>This last test is not truly platform-specific but shows various violations of the I2C assembler rules
 using the Marble platform-aware interface.  None of the rules violated are specific to the platform.</p>
-<p><code class="docutils literal notranslate"><span class="pre">make</span> <span class="pre">violations</span></code></p>
+<p><code class="docutils literal notranslate"><span class="pre">make</span> <span class="pre">test</span></code></p>
 <p>See <code class="docutils literal notranslate"><span class="pre">demo_i2c_baddy.py</span></code> for examples of what to avoid.</p>
 </section>
 </section>

_downloads/40e329b5490cebba08fcd11cb34fbeb7/tuning_dsp4.pdf

@@ -223,7 +223,13 @@ <h2>Parameters<a class="headerlink" href="#parameters" title="Permalink to this
 <td><p>14</p></td>
 <td></td>
 </tr>
-<tr class="row-odd"><td><p>delta</p></td>
+<tr class="row-odd"><td><p>adv</p></td>
+<td><p>?</p></td>
+<td><p>?</p></td>
+<td><p>3861</p></td>
+<td></td>
+</tr>
+<tr class="row-even"><td><p>delta</p></td>
 <td><p>?</p></td>
 <td><p>?</p></td>
 <td><p>16</p></td>
@@ -263,23 +269,19 @@ <h2>Ports<a class="headerlink" href="#ports" title="Permalink to this heading">
 <td><p>Input</p></td>
 <td><p>readout clock (data transfer, local bus)</p></td>
 </tr>
-<tr class="row-odd"><td><p>adv[dw-1:0]</p></td>
-<td><p>Input</p></td>
-<td><p>make adv a runtime variable</p></td>
-</tr>
-<tr class="row-even"><td><p>err</p></td>
+<tr class="row-odd"><td><p>err</p></td>
 <td><p>Output</p></td>
 <td></td>
 </tr>
-<tr class="row-odd"><td><p>phdiff_out[dw-2:0]</p></td>
+<tr class="row-even"><td><p>phdiff_out[dw-2:0]</p></td>
 <td><p>Output</p></td>
 <td></td>
 </tr>
-<tr class="row-even"><td><p>vfreq_out[dw-1:0]</p></td>
+<tr class="row-odd"><td><p>vfreq_out[dw-1:0]</p></td>
 <td><p>Output</p></td>
 <td></td>
 </tr>
-<tr class="row-odd"><td><p>err_ff</p></td>
+<tr class="row-even"><td><p>err_ff</p></td>
 <td><p>Output</p></td>
 <td></td>
 </tr>

_downloads/cfdab7f028ba73f6ed1e8eeab0acdc59/physics.pdf

@@ -221,7 +221,13 @@ <h2>Parameters<a class="headerlink" href="#parameters" title="Permalink to this
 <td><p>14</p></td>
 <td></td>
 </tr>
-<tr class="row-even"><td><p>delta</p></td>
+<tr class="row-even"><td><p>adv</p></td>
+<td><p>?</p></td>
+<td><p>?</p></td>
+<td><p>3861</p></td>
+<td></td>
+</tr>
+<tr class="row-odd"><td><p>delta</p></td>
 <td><p>?</p></td>
 <td><p>?</p></td>
 <td><p>16</p></td>
@@ -253,15 +259,11 @@ <h2>Ports<a class="headerlink" href="#ports" title="Permalink to this heading">
 <td><p>Input</p></td>
 <td></td>
 </tr>
-<tr class="row-odd"><td><p>adv[dw-1:0]</p></td>
-<td><p>Input</p></td>
-<td></td>
-</tr>
-<tr class="row-even"><td><p>phase[dw-1:0]</p></td>
+<tr class="row-odd"><td><p>phase[dw-1:0]</p></td>
 <td><p>Output</p></td>
 <td></td>
 </tr>
-<tr class="row-odd"><td><p>fault</p></td>
+<tr class="row-even"><td><p>fault</p></td>
 <td><p>Output</p></td>
 <td><p>single cycle</p></td>
 </tr>