mirror of
https://github.com/MarekZegare4/MeshCore-Solo.git
synced 2026-11-01 10:21:59 +00:00
docs(eink): the two e-ink builds in the docs and the site's sim
Docs: the E-ink section describes the landscape and portrait builds, what the tall screens add, and the settings, with three screenshots; the e-ink build flags; the release file names. Sim: each orientation gets its own factory, so a page can load both, and simEinkScale 0 leaves the canvas' CSS size to the page. CI builds both into solo-sim-wasm.zip (wasm/eink/). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
+2
-2
@@ -39,9 +39,9 @@ These docs mark the differences with notes like this:
|
||||
| **Keyboard** | M5Stack Cardputer ADV, T-Echo Lite + KeyShield, any board with a CardKB | Keys; arrows or their Fn combinations for the directions |
|
||||
| **Touch** | Wio Tracker L2 | Taps, swipes and holds; two side buttons |
|
||||
|
||||
| OLED / e-ink | | Wio Tracker L2 |
|
||||
| OLED | E-ink | Wio Tracker L2 |
|
||||
| :---: | :---: | :---: |
|
||||
|  |  |  |
|
||||
|  |  |  |
|
||||
|
||||
The joystick and keyboard devices share one interface, sized for small OLED
|
||||
and e-ink screens. The Wio Tracker L2 has its own, built for a 320 × 240
|
||||
|
||||
@@ -84,6 +84,8 @@ existing `solo/<board>/platformio.ini` for what's already claimed).
|
||||
| --- | --- |
|
||||
| `OLED_MISC_FIXED_FONT=1` | Pulls in a full Latin/Greek/Cyrillic 6×9 fixed font (~14 KB flash) so typed text in those alphabets renders as itself instead of block placeholders. Worth it on any board with a keyboard; skip it on space-constrained builds without one. |
|
||||
| `DISPLAY_ROTATION=<0-3>` | Rotates the panel in 90° steps, for a board mounted sideways or upside down. |
|
||||
| `EINK_LARGE_FONT=1` | E-ink: writes in the 8×13 font at the panel's own resolution, with the larger icon set. The landscape e-ink build sets it; the narrow portrait screen keeps the 6×9. |
|
||||
| `JOYSTICK_UPRIGHT_ROTATION=<0-3>` | The display rotation at which the joystick reads upright; the joystick then turns with the screen. Set by the e-ink builds. |
|
||||
| `ENABLE_SCREENSHOT` | Lets the site's [USB tools](https://solo.marekzegarek.com/#pc-tools) (or `tools/screenshot.py`) capture the screen over USB. A colour screen (the L2) renders a fresh frame and sends it as RGB565. |
|
||||
| `KEEP_DISPLAY_ON_USB` | Refreshes the auto-off deadline continuously while externally (USB) powered, so the auto-off timer only starts counting once power is actually removed. Off by default because OLED panels burn in quickly with a permanently-lit screen — only worth enabling for an LCD/e-ink target, or a display you don't mind replacing. |
|
||||
| `AUTO_OFF_MILLIS=<ms>` | How long the display stays on before auto-off. Default 15000 (15s); `0` disables auto-off entirely. |
|
||||
|
||||
+26
-7
@@ -64,16 +64,35 @@ Fn shortcuts.
|
||||
|
||||
## E-ink
|
||||
|
||||
The e-ink Wio Tracker L1 (250 × 122) has a few settings of its own in
|
||||
Settings › Display:
|
||||
The e-ink Wio Tracker L1 (250 × 122) comes in two builds, one per
|
||||
orientation, since every screen is laid out for one shape:
|
||||
|
||||
- **Rotation**: landscape or portrait, applied at once; every screen reflows.
|
||||
- **Joystick rotation**, independent of the display's.
|
||||
- **Full refresh**: how many partial updates between full ones, against
|
||||
- **Landscape** writes in a larger 8 × 13 font, with larger icons.
|
||||
- **Portrait** keeps the 6 × 9 font and fits more lines.
|
||||
|
||||
| Landscape | Portrait | |
|
||||
| :---: | :---: | :---: |
|
||||
|  |  |  |
|
||||
|
||||
The e-ink screens show more than the OLED, the portrait one most:
|
||||
|
||||
- a month calendar (portrait) under the clock and on the lock screen, the
|
||||
alarm's days marked;
|
||||
- whole message bubbles;
|
||||
- charts of the last 8 hours on the Status screen;
|
||||
- a compass rose and the path's hops on a contact's details, and direction
|
||||
arrows in the node list;
|
||||
- under a saved trail (portrait), its map and elevation profile.
|
||||
|
||||
Settings › Display has a few settings of its own:
|
||||
|
||||
- **Rotation** turns the screen upside down; the joystick turns with it.
|
||||
- **Joystick** rotation, for a joystick mounted another way.
|
||||
- **Full rfsh**: how many partial updates between full ones, against
|
||||
ghosting.
|
||||
|
||||
Clock seconds are hidden by default, and live timers refresh coarsely, to
|
||||
spare the panel.
|
||||
The panel refreshes only when what it shows changes. Times are shown to the
|
||||
minute (no seconds counting up), and clock seconds are hidden by default.
|
||||
|
||||
## Wio Tracker L2
|
||||
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 2.5 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 2.2 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 2.3 KiB |
Reference in New Issue
Block a user