This commit is contained in:
MarekZegare4
2026-08-12 21:16:38 +00:00
parent 0555a14e78
commit 6f2ac09a43
3 changed files with 52 additions and 5 deletions
File diff suppressed because one or more lines are too long
+50 -3
View File
@@ -988,6 +988,17 @@
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#built-in-keyboards-cardputer-adv-t-echo-lite-keyshield" class="md-nav__link">
<span class="md-ellipsis">
Built-in keyboards (Cardputer ADV, T-Echo Lite + KeyShield)
</span>
</a>
</li>
</ul>
@@ -1615,6 +1626,17 @@
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#built-in-keyboards-cardputer-adv-t-echo-lite-keyshield" class="md-nav__link">
<span class="md-ellipsis">
Built-in keyboards (Cardputer ADV, T-Echo Lite + KeyShield)
</span>
</a>
</li>
</ul>
@@ -1647,7 +1669,9 @@
<h2 id="external-keyboard-joystick">External Keyboard &amp; Joystick</h2>
<p><a href="../../README.md">Go back</a></p>
<p>Two optional hardware add-ons, both auto-detected and both entirely optional — a
build with them enabled runs exactly the same with nothing plugged in.</p>
build with them enabled runs exactly the same with nothing plugged in. Two of
the newer boards also ship with their own <strong>built-in</strong> keypad instead —
see <a href="#built-in-keyboards-cardputer-adv-t-echo-lite--keyshield">Built-in keyboards</a>.</p>
<ul>
<li><strong>CardKB</strong> — an M5Stack I2C QWERTY keyboard (address <code>0x5F</code>), for typing
messages, names and labels without walking the on-screen letter grid.</li>
@@ -1680,15 +1704,25 @@ build with them enabled runs exactly the same with nothing plugged in.</p>
<td style="text-align: center;">onboard</td>
</tr>
<tr>
<td>Heltec V3</td>
<td>Heltec V3 <em>(experimental)</em></td>
<td style="text-align: center;">✅ solder to free GPIOs</td>
<td style="text-align: center;">✅ solder to free GPIOs</td>
</tr>
<tr>
<td>Heltec V4</td>
<td>Heltec V4 <em>(experimental)</em></td>
<td style="text-align: center;">✅ solder to free GPIOs</td>
<td style="text-align: center;">✅ solder to free GPIOs</td>
</tr>
<tr>
<td>M5Stack Cardputer ADV <em>(experimental)</em></td>
<td style="text-align: center;"></td>
<td style="text-align: center;">built-in keyboard instead, see below</td>
</tr>
<tr>
<td>LilyGO T-Echo Lite + KeyShield <em>(experimental)</em></td>
<td style="text-align: center;"></td>
<td style="text-align: center;">built-in keypad instead, see below</td>
</tr>
</tbody>
</table>
<hr />
@@ -1856,6 +1890,19 @@ hardware</strong>; still worth checking against your own V3 module before solder
and <a href="../../variants/heltec_v4/platformio.ini"><code>variants/heltec_v4/platformio.ini</code></a>,
with comments explaining which pins are safe to reuse. To build a CardKB-only
device, comment out the joystick block and set Ext. KB to Compact.</p>
<hr />
<h2 id="built-in-keyboards-cardputer-adv-t-echo-lite-keyshield">Built-in keyboards (Cardputer ADV, T-Echo Lite + KeyShield)</h2>
<p><em>Experimental</em> — newly-added board support, not the CardKB/joystick add-ons
above. Both keypads are TCA8418-based and share one polling path, entirely
independent of the CardKB code — a board can have either, or neither.</p>
<ul>
<li><strong>M5Stack Cardputer ADV</strong> — built-in QWERTY, no CardKB or joystick needed.</li>
<li><strong>LilyGO T-Echo Lite + KeyShield</strong> — the KeyShield add-on gives the T-Echo
Lite a T9 keypad; without it the board has no usable input for the solo UI.</li>
</ul>
<p>Neither keypad follows CardKB's exact Fn-shortcut table (Fn+Enter,
Fn+letter accent popups, Tab, Fn+Esc lock) — see each board's own
<code>platformio.ini</code> / keyboard driver under <code>variants/</code> for its current keymap.</p>
@@ -1942,7 +1942,7 @@
<tr>
<td>GPS pwr <em>(if GPS detected)</em></td>
<td>off / 1 min / 5 min / 15 min / 30 min / 1 h</td>
<td><strong>Battery saver.</strong> Cycles GPS off between fixes instead of running it continuously; each wake waits for a fix (up to 60 s) before sleeping again for the chosen interval. Automatically stays continuously on regardless of this setting whenever something needs a live position — an active Trail recording, Map Live share, an armed Locator, or the Compass / Nearby navigate view. <code>off</code> (default) matches earlier releases: GPS runs continuously whenever enabled. The GPS status icon blinks while napping between fixes.</td>
<td><strong>Battery saver.</strong> Cycles GPS off between fixes instead of running it continuously; each wake waits for a fix (up to 60 s) before sleeping again for the chosen interval. Automatically stays continuously on regardless of this setting whenever something needs a live position — an active Trail recording, Map Live share, an armed Locator, the Compass / Nearby navigate view, or an in-flight <code>!gps fix</code> bot request. <code>off</code> (default) matches earlier releases: GPS runs continuously whenever enabled. The GPS status icon blinks while napping between fixes.</td>
</tr>
<tr>
<td>Units</td>