From 4e96e4235f8f38f6c39604fd073567fd0187959a Mon Sep 17 00:00:00 2001 From: pelgraine <140762863+pelgraine@users.noreply.github.com> Date: Sun, 26 Jul 2026 16:00:45 +1000 Subject: [PATCH] update readme --- README.md | 50 ++++++++++++++++++------ variants/lilygo_tdeck_pro/platformio.ini | 2 +- 2 files changed, 38 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index e70172c6..74401304 100644 --- a/README.md +++ b/README.md @@ -99,7 +99,7 @@ Meck currently targets three LilyGo devices and also supports the Heltec V3 and | Device | Display | Input | LoRa | Battery | GPS | RTC | |--------|---------|-------|------|---------|-----|-----| | **T-Deck Pro** | 240×320 e-ink (GxEPD2) | TCA8418 keyboard + optional touch | SX1262 | BQ27220 fuel gauge, 1400 mAh | Yes | No (uses GPS time) | -| **T-Deck Max** | 240×320 e-ink (GxEPD2) + frontlight | TCA8418 keyboard + CST328 capacitive touch + 3 capacitive buttons | SX1262 | BQ27220 fuel gauge, 1500 mAh | Yes (multi-constellation) | No (uses GPS time) | +| **T-Deck Max** | 240×320 e-ink (GxEPD2) + frontlight | TCA8418 keyboard + CST328 capacitive touch + 3 capacitive buttons | SX1262 | BQ27220 fuel gauge, 1400 mAh | Yes (multi-constellation) | No (uses GPS time) | | **T5S3 E-Paper Pro** (V2, H752-B) | 960×540 e-ink (FastEPD, parallel) | GT911 capacitive touch (no keyboard) | SX1262 | BQ27220 fuel gauge, 1500 mAh | No (non-GPS variant) | Yes (PCF8563 hardware RTC) | | **Heltec V3** (remote repeater only) | 0.96" OLED (SSD1306) | — | SX1262 | — | No | No | | **Heltec V4** (remote repeater only) | 0.96" OLED (SSD1306) | — | SX1262 | — | No | No | @@ -256,10 +256,10 @@ The T-Deck Pro firmware includes full keyboard support for standalone messaging | E | Open e-book reader | | N | Open notes | | S | Open settings | -| B | Open web browser (BLE and 4G variants only) | -| T | Open SMS & Phone app (4G variant only) | +| B | Open web browser (BLE, WiFi, and 4G variants -- not standalone audio) | +| T | Open SMS & Phone app (Pro 4G & Max only) | | P | Open audiobook player (audio variant only) | -| K | Open alarm clock (audio variant only) | +| K | Open alarm clock (Pro Audio & Max only) | | F | Open node discovery (search for nearby repeaters/nodes) | | H | Open last heard list (passive advert history) | | R | Open trace route screen (v1.9+) -- see [Trace Route Screen](#trace-route-screen-v19) | @@ -269,6 +269,8 @@ The T-Deck Pro firmware includes full keyboard support for standalone messaging | Q | Back to home screen | | Double-click Boot | Lock / unlock screen | +**Touch tile home screen:** the first home page is a tile grid -- Messages, Contacts, Map, Notes, Settings and the rest -- that can be tapped directly instead of using the key shortcuts above. Originally a T-Deck Max feature, this is now the home screen on **all T-Deck Pro builds**. Tiles for features a given build does not include (for example Phone on audio builds, or Audiobooks on 4G builds) are inert. + ### Bluetooth (BLE) BLE is **disabled by default** at boot to support standalone-first operation. The device is fully functional without a phone — you can send and receive messages, browse contacts, read e-books, and set your timezone directly from the keyboard. @@ -337,6 +339,8 @@ Pressing **X** on any highlighted channel brings up a confirmation overlay. Pres On the T5S3, swiping left or right on the channel messages screen also opens the channel picker, which displays a **vertical bubble list** matching the Meck P4 aesthetic. Long-press a channel to bring up the delete history confirmation. +**Unread counts and the companion app (v1.12.3+):** on standalone builds (no BLE or WiFi) the home-screen **MSG** count and the per-channel `*N` badges climb as messages arrive, and opening a channel clears that channel's count. On BLE and WiFi builds the on-device counts intentionally stay at zero while a companion app is connected, because the app marks each message read as it arrives; they resume counting once the app disconnects. Earlier firmware treated standalone builds as though a companion were permanently connected, so those counts -- along with the DM counter and the new-message screen wake -- never updated. + ### Contacts Screen Press **C** from the home screen to open the contacts list. All known mesh contacts are shown sorted by most recently heard, with their type prefix, estimated hop count, and time since last advert. @@ -418,6 +422,8 @@ Press **R** on the contacts list (outside select mode) to import contacts from a Select a **Chat** contact in the contacts list and press **Enter** to start composing a direct message. The compose screen will show `DM: ContactName` in the header. Type your message and press **Enter** to send. The DM is sent encrypted directly to that contact (or flooded if no direct path is known). After sending or cancelling, you're returned to the contacts list. +While a DM is in flight the conversation view shows its delivery state: **Sending x/N** as the device retries, a **delivered tick** once the recipient acknowledges, or **Failed** if every attempt goes unanswered. Retries are handled on the device, so this works without a companion app connected. + Contacts with unread direct messages show a `*` marker next to their name in the contacts list. **Reading received DMs:** From the home screen, press **M** to open the channel picker, then select the **DM Inbox** entry to view received direct messages. This shows all received direct messages with sender name and timestamp. Entering the DM inbox marks all DM messages as read and clears the unread indicator. @@ -657,7 +663,7 @@ Press **S** from the home screen to open settings. On first boot (when the devic | Setting | Edit Method | |---------|-------------| | Device Name | Text entry — type a name, Enter to confirm | -| Radio Preset | A / D to cycle presets (MeshCore Default, Long Range, Fast/Short, EU Default), Enter to apply | +| Radio Preset | A / D to cycle region presets, Enter to apply. Includes Australia, Australia (Mid), Australia (Wide), Australia: SA/WA, Australia: QLD, EU/UK (Narrow / Long Range / Medium Range), Czech Republic and others | | Frequency | Text entry — type exact value (e.g. 916.575), Enter to confirm | | Bandwidth | W / S to cycle standard values (31.25 / 62.5 / 125 / 250 / 500 kHz), Enter to confirm | | Spreading Factor | W / S to adjust (5–12), Enter to confirm | @@ -672,6 +678,8 @@ Press **S** from the home screen to open settings. On first boot (when the devic | Larger Font | Toggle larger text size on channel messages, contacts, DM inbox, and repeater admin screens (Enter to toggle) | | Font Style | A / D to cycle styles (Classic / Noto Sans / Montserrat), Enter to apply. See [Font Styles](#font-styles). | | Auto Lock | A / D to cycle timeout (None / 2 / 5 / 10 / 15 / 30 min), Enter to confirm | +| Backlight Brightness | W / S to adjust 5-100% in 5% steps (MAX only) -- e-ink frontlight level | +| Keyboard LED | W / S to adjust 5-100% in 5% steps, default 50% (MAX only) -- see [Keyboard Backlight](#keyboard-backlight) | | Contacts >> | Opens the Contacts sub-screen (see below) | | Channels >> | Opens the Channels sub-screen (see below) | | OTA Tools >> | Opens the OTA sub-screen — Firmware Update and SD File Manager (see [OTA Firmware Update](#ota-firmware-update-v13)) | @@ -752,6 +760,9 @@ Press the **Sym** key then the letter key to enter numbers and symbols: | Shift | Uppercase next letter | | Alt | Same as Sym (for numbers/symbols) | | Space | Space character / Next in navigation | +| Q | Back / exit the current screen (see note below) | + +**Exit key:** on the T-Deck Pro and Max, **Q** is the back/exit key across the interface. The exception is text entry -- while typing, Q is a normal character, so **Shift+Backspace** exits instead. ### Emoji Picker @@ -766,13 +777,22 @@ While in compose mode, press the **$** key to open the emoji picker. A scrollabl ### SMS & Phone App (Pro 4G * Max only) -Press **T** from the home screen to open the SMS & Phone app. The app opens to a menu screen where you can choose between the **Phone** dialer (for calling any number) or the **SMS Inbox** (for messaging and calling saved contacts). The SMS Inbox entry shows the number of unread received messages in brackets (e.g. **SMS Inbox [3]**); the badge disappears once everything is read. +Press **T** from the home screen to open the SMS & Phone app. The app opens to a menu screen with four entries: + +| Row | Purpose | +|-----|---------| +| **Dial** | Keypad for calling any number | +| **Call Log** | Incoming, outgoing and missed calls, stored on the SD card | +| **Contacts** | Saved contacts -- add, edit, dial, message and delete | +| **SMS Inbox** | Message conversations | + +Two of the rows carry a count in brackets. **Call Log [n]** shows missed calls you have not looked at yet, and **SMS Inbox [n]** shows unread received messages. Each badge clears when you open that screen, and both persist across a reboot. + +The **Call Log** stores the 32 most recent calls with the number, the contact name where known, the call type and the duration. Enter dials the highlighted entry back, and D deletes it. Calls that arrive without caller ID are still logged, shown as `Unknown`. + +The **Contacts** screen lists saved contacts, with A to add a new one and M to send an SMS. Opening a contact gives a page with editable Name and Number fields and a Save row, plus F to dial and D to delete. Contacts are stored on the SD card in `/sms/contacts.txt`. -<<<<<<< HEAD **Note for US users: the A7682E modem in the T-Deck Pro and T-Deck Pro Max supports very limited US cellular bands, so 4G is almost entirely unusable with US SIMs. For example, the 4G is wholly unusable on T-Mobile and may have very limited use on AT&T, due to the nature of the A7682E and the bands used by it.** -======= -# Note for US users: the A7682E modem in the T-Deck Pro and T-Deck Pro Max supports very limited US cellular bands, so 4G is almost entirely unusable with US SIMs. For example, the 4G is wholly unusable on T-Mobile and may have very limited use on AT&T, due to the nature of the A7682E and the bands used by it. ->>>>>>> dev For full documentation including key mappings, dialpad usage, contacts management, and troubleshooting, see the [SMS & Phone App Guide](SMS___Phone_App_Guide.md). @@ -869,7 +889,9 @@ Packets are sent with staggered 3-second delays to avoid congesting the channel. ### Lock Screen (T-Deck Pro & Max) -Double-click the Boot button to lock the screen. The lock screen shows the current time, battery percentage, and unread message count. The CPU drops to 40 MHz while locked to reduce power consumption. +Double-click the Boot button to lock the screen. The lock screen shows the current time, battery percentage, and unread message count. The CPU drops to 40 MHz while locked to reduce power consumption. On the MAX, the e-ink frontlight switches off when the lock screen activates, and is not restored automatically on unlock -- press the Heart button to turn it back on. + +On Pro 4G and Max builds the lock screen also shows outstanding **unread SMS** and **missed calls**. These counts are read from the SMS inbox and call log rather than counted while locked, so they survive locking, unlocking and a reboot, and clear only when you open that conversation or the Call Log. Double-click the Boot button again to unlock and return to whatever screen you were on. @@ -922,7 +944,7 @@ The MAX has a DRV2605 haptic motor, so each channel (and the DM inbox) can be se ### Capacitive Touch & Buttons -The MAX adds a CST328 capacitive touchscreen and **three capacitive buttons** along the bottom of the front bezel — none of which the T-Deck Pro has: +Both the MAX and the T-Deck Pro have a CST328 capacitive touchscreen. What the MAX adds is **three capacitive buttons** along the bottom of the front bezel, which the T-Deck Pro does not have: | Button | Action | |--------|--------| @@ -938,6 +960,8 @@ The MAX has an e-ink frontlight. The brightness it turns on to is set in **Setti Press **both Shift keys together** to toggle the keyboard backlight on and off. +The brightness is set in **Settings -> Keyboard LED**, directly below Backlight Brightness, adjustable from **5% to 100%** in 5% steps (default **50%**). Before v1.12.3 the keyboard backlight was fixed at a very dim level. A change to the setting takes effect the next time you toggle the backlight on. + ### Multi-Constellation GPS The MAX's GPS is configured for multi-constellation positioning (GPS, Galileo, and BeiDou) via the `$PCAS04,7` command, for faster fixes and better coverage than single-constellation GPS. @@ -1491,4 +1515,4 @@ However, this firmware links against libraries with different license terms. Bec ¹ Includes INA219, INA260, INA3221, AHTX0, BME280, BMP280, BME680, BMP085, SHTC3, MLX90614, VL53L0X — all MIT or BSD licensed. Used via the sensor manager for optional environmental monitoring. -Full license texts for each dependency are available in their respective repositories linked above. +Full license texts for each dependency are available in their respective repositories linked above. \ No newline at end of file diff --git a/variants/lilygo_tdeck_pro/platformio.ini b/variants/lilygo_tdeck_pro/platformio.ini index 63d09afc..56f2d6cb 100644 --- a/variants/lilygo_tdeck_pro/platformio.ini +++ b/variants/lilygo_tdeck_pro/platformio.ini @@ -158,7 +158,7 @@ build_flags = -D MECK_AUDIO_VARIANT -D MECK_WEB_READER=1 -D MECK_OTA_UPDATE=1 - -D FIRMWARE_VERSION='"Meck v1.12.5.WiFi"' + -D FIRMWARE_VERSION='"Meck v1.12.6.WiFi"' ;-D WIFI_DEBUG_LOGGING=1 ;-D MESH_PACKET_LOGGING=1 ;-D MESH_DEBUG=1