releasenotes update

2026-09-16 13:22:39 +00:00 · 2026-08-25 15:23:20 +02:00
parent 2e3f5f3f59
commit 8adbe2a648
2 changed files with 117 additions and 117 deletions
@@ -1,68 +0,0 @@
-# ZephCore 1.17.4-zephcore
-
-Two new settings for people who put their node in a case it did not come in: the screen can be turned
-upside down, and the joystick can be flipped to match.
-
-> [!NOTE]
-> Upgrading from 1.17.3 is straightforward — your contacts, settings and phone pairing all survive.
-> Both new settings default to off, so a node you do not touch behaves exactly as it did.
-
---
-
-## The screen can be turned upside down
-
-DIY builds and upgrade kits do not always hold the board the way the original case did. The
-**Meshnology N37E**, for instance, takes a Wio Tracker L1 and puts it in a different enclosure — one
-that mounts the screen the other way up. Until now the only answer was to build your own firmware with
-the panel flipped, which meant giving up the published builds everyone else uses.
-
-`set display.rotate on` turns the picture 180 degrees. It survives reboots, and the same firmware
-everybody else runs is now the firmware you run too.
-
-On the boards with a joystick there is a menu entry as well — **System → Display → Rotate 180** — so it
-can be set on the device without a cable.
-
-The rotation costs nothing to keep on. It is not done by redrawing the screen the other way round; the
-firmware asks the display chip itself to scan its rows and columns in reverse, which is two bytes sent
-once. Every frame after that is drawn exactly as before.
-
-> [!IMPORTANT]
-> **This works on OLED screens only** — the SSD1306 and SH1106 panels, which covers the **RAK4631**,
-> **GAT562 30S**, **Heltec WiFi LoRa 32 V4** and **V4.3**, **LilyGo T3S3**, **Station G2** and
-> **Wio Tracker L1**.
->
-> Boards with a colour screen or e-paper answer `Error: this panel cannot rotate`, and the setting is
-> not saved — so a stored value can never claim something the screen is not doing. Those panels can be
-> rotated in principle, but it would mean turning every frame around in software rather than asking the
-> chip to do it, and that is a different piece of work. The joystick flip below works on all of them.
-
-> [!NOTE]
-> **The LilyGo T-Impulse Plus is the one OLED board left out.** Its small screen only occupies part of
-> the display chip's memory, and the trick that flips the picture flips the chip's whole range — which
-> would have slid the image off the visible area rather than turning it over. It reports the setting as
-> unsupported, like the colour and e-paper boards.
-
-## The joystick can be flipped to match
-
-Turning the screen over does not turn the buttons over. A case that mounts the board upside down puts
-the joystick upside down as well, so pushing up walks the menu down and left goes right.
-
-`set input.rotate on` swaps both axes back. On the joystick boards there is a menu entry next to the
-rotation one — **System → Display → Flip input**.
-
-It is deliberately a **separate** setting rather than part of the rotation. A case can put the screen
-somewhere new without moving the stick, and boards whose screen cannot rotate can still end up with the
-controls the wrong way round — so tying the two together would have made both less useful. Set whichever
-you actually need.
-
-Only the four directions are affected. Buttons, tap gestures and long presses are untouched, and on the
-single-button boards the flip swaps which way the pages step.
-
---
-
-Both settings are readable with `get display.rotate` and `get input.rotate`. `get display.rotate`
-reports what the panel is actually doing rather than what is stored, so a refused rotation shows up as
-refused.
-
-Suggested by **celsoazevedo** ([@celsoazevedo](https://github.com/celsoazevedo)) in
-[issue #76](https://github.com/liquidraver/ZephCore/issues/76).