Corrected meaning of bit 4 of QG reply (pen up/down state) and left note that this correction has been made

feature/Issue_224_UpdaterNickname
EmbeddedMan 2024-05-07 21:25:18 -05:00
rodzic c84ebaefad
commit cc91ded2b7
1 zmienionych plików z 3 dodań i 2 usunięć

Wyświetl plik

@ -1819,7 +1819,7 @@
<div style="font-weight:bold;">Bit 5: PRG &mdash; PRG Button Pressed</div> This bit will be 1 if the PRG button has been pushed since the last <code>QG</code> or <code><a href="#QB">QB</a></code> query. Otherwise it will be 0. Note that input B0 can be used to trigger a "button push" event; see the description of <code><a href="#QB">QB</a></code> for more information.
</p>
<p>
<div style="font-weight:bold;">Bit 4: PEN &mdash; Pen is down</div> This bit is 1 when the pen is down, and 0 when the pen is up. The pen status is given by the position of the pen-lift servo output, which can be controlled with the <code><a href="#SP">SP</a></code> command and can be read with the <code><a href="#QP">QP</a></code> query. Note that this is the <i>commanded state</i> of the pen, and that it does physically take time to lift from or lower to the page.
<div style="font-weight:bold;">Bit 4: PEN &mdash; Pen is up</div> This bit is 1 when the pen is up, and 0 when the pen is down. The pen status is given by the position of the pen-lift servo output, which can be controlled with the <code><a href="#SP">SP</a></code> command and can be read with the <code><a href="#QP">QP</a></code> query. Note that this is the <i>commanded state</i> of the pen, and that it does physically take time to lift from or lower to the page.
</p>
<p>
<div style="font-weight:bold;">Bit 3: CMD &mdash; Command Executing</div> This bit will be 1 when a command is being executed, and 0 otherwise. The command may be a command that causes motion (like a motor move command) or any other command listed in this document as 'Execution: Added to FIFO motion queue'.
@ -1850,7 +1850,8 @@
<span style="font-weight: bold;">Example Return Packet (legacy mode; default):</span> <code>3E&lt;CR&gt;&lt;NL&gt;</code>
<p>This query returns value of <code>3E</code>, which corresponds to <code>0011 1110</code> in binary, indicates that the limit switch has not been triggered, the power has not gone below the set threshold, the PRG button has been pressed, the pen is down, a command is being executed, Motor 1 and Motor 2 are moving, and the FIFO motion queue is empty.</p>
</li>
<li><span style="font-weight: bold;">Version History:</span> V3.0: bit 7 now reports if the limit switch trigger has fired. Also with v3.0 bit 6 now reports the power lost flag. If you have PC code which is relying upon the old meanings of these bits (bit 7 was showing the state of the RB5 pin and bit 6 was showing the state of the RB2 pin) it will need to be updated to use v3.0.</li>
<li><span style="font-weight: bold;">Version History:</span> V3.0: bit 7 now reports if the limit switch trigger has fired. Also with v3.0 bit 6 now reports the power lost flag. If you have PC code which is relying upon the old meanings of these bits (bit 7 was showing the state of the RB5 pin and bit 6 was showing the state of the RB2 pin) it will need to be updated to use v3.0. On 5/7/2024 the meaning of bit 4 was corrected. Previous versions had the state inverted.
</li>
</ul>
<hr class="short" />