adam/Meck
1
0 Fork 0
mirror of https://github.com/pelgraine/Meck.git synced 2026-10-30 19:52:01 +01:00
Code Issues 8 Packages Projects Releases Wiki Activity

Updated SMS & Phone app guide

Browse Source
This commit is contained in:
pelgraine committed 2026-07-26 16:15:41 +10:00
1 parent 4e96e4235f
commit 0bbbc04ab8
2 files changed
+212 -95
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

SMS & Phone App Guide.md
+193 -95
View File
@@ -1,37 +1,72 @@
## SMS & Phone App (4G variant only) - Meck v0.9.5 ## SMS & Phone App (Pro 4G & Max) - Meck v1.12.6
Press **T** from the home screen to open the SMS & Phone app. Press **T** from the home screen to open the SMS & Phone app.
Requires a nano SIM card inserted in the T-Deck Pro V1.1 4G modem slot and an
SD card formatted as FAT32. The modem registers on the cellular network Available on the **T-Deck Pro 4G** and the **T-Deck Pro Max**. Requires a nano
automatically at boot — the red LED on the board indicates the modem is SIM card in the A7682E modem slot and an SD card formatted as FAT32. The modem
powered. The modem (and its red LED) can be switched off and on from the registers on the cellular network automatically at boot -- the red LED on the
settings screen. After each modem startup, the system clock syncs from the board indicates the modem is powered. The modem (and its red LED) can be
cellular network, which takes roughly 15 seconds. switched off and on from the settings screen. After each modem startup the
system clock syncs from the cellular network, which takes roughly 15 seconds.
**Note for US users:** the A7682E supports very limited US cellular bands, so
4G is almost entirely unusable with US SIMs. It is wholly unusable on T-Mobile
and may have very limited use on AT&T.
### App Menu ### App Menu
The SMS & Phone app opens to a landing screen with two options: The app opens to a landing screen with four entries:
| Option | Description | | Row | Description |
|--------|-------------| |-----|-------------|
| **Phone** | Open the phone dialer to call any number | | **Dial** | Keypad for calling any number |
| **SMS Inbox** | Open the SMS inbox for messaging and calling saved contacts | | **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 |
Use **W / S** to select an option and **Enter** to confirm. Press **Q** to Use **W / S** to move between rows and **Enter** to open one. Press **Q** to
return to the home screen. return to the home screen.
Two rows carry a count in brackets:
- **Call Log [n]** -- missed calls you have not yet viewed. Clears when you
open the Call Log.
- **SMS Inbox [n]** -- unread received messages. Clears per conversation as
you read them.
Both counts are held on the SD card rather than in memory, so they survive a
reboot and only clear when you actually open the relevant screen.
### Key Mapping ### Key Mapping
| Context | Key | Action | | Context | Key | Action |
|---------|-----|--------| |---------|-----|--------|
| Home screen | T | Open SMS & Phone app | | Home screen | T | Open SMS & Phone app |
| App menu | W / S | Select Phone or SMS Inbox | | App menu | W / S | Move between the four rows |
| App menu | Enter | Open selected option | | App menu | Enter | Open selected row |
| App menu | Q | Back to home screen | | App menu | Q | Back to home screen |
| Call Log | W / S | Scroll entries |
| Call Log | Enter | Dial the highlighted entry back |
| Call Log | D | Delete the highlighted entry |
| Call Log | Q | Back to app menu |
| Contacts | W / S | Scroll contact list |
| Contacts | Enter | Open the contact page |
| Contacts | A | Add a new contact |
| Contacts | M | Compose an SMS to the selected contact |
| Contacts | F | Call the selected contact |
| Contacts | Q | Back to app menu (or to the inbox if opened from there) |
| Contact page | W / S | Move between Name, Number and Save |
| Contact page | Enter | Edit the highlighted field, or save from the Save row |
| Contact page | F | Dial this contact |
| Contact page | D | Delete this contact |
| Contact page | Q | Back without saving |
| Field editing | Enter | Commit the field |
| Field editing | Backspace | Delete last character |
| Field editing | Shift+Del | Abandon this field edit |
| Inbox | W / S | Scroll conversations | | Inbox | W / S | Scroll conversations |
| Inbox | Enter | Open conversation | | Inbox | Enter | Open conversation |
| Inbox | C | Compose new SMS (enter phone number) | | Inbox | C | Compose new SMS (enter phone number) |
| Inbox | D | Open contacts directory | | Inbox | D | Open contacts list |
| Inbox | Q | Back to app menu | | Inbox | Q | Back to app menu |
| Conversation | W / S | Scroll messages | | Conversation | W / S | Scroll messages |
| Conversation | C | Reply to this conversation | | Conversation | C | Reply to this conversation |
@@ -40,68 +75,124 @@ return to the home screen.
| Conversation | Q | Back to inbox | | Conversation | Q | Back to inbox |
| Compose | Enter | Send SMS (from body) / Confirm phone number (from phone input) | | Compose | Enter | Send SMS (from body) / Confirm phone number (from phone input) |
| Compose | Shift+Del | Cancel and return | | Compose | Shift+Del | Cancel and return |
| Contacts | W / S | Scroll contact list | | Phone Dialer | 0-9, *, +, # | Enter phone number (see input methods below) |
| Contacts | Enter | Compose SMS to selected contact |
| Contacts | F | Call selected contact |
| Contacts | Q | Back to inbox |
| Edit Contact | Enter | Save contact name |
| Edit Contact | Shift+Del | Cancel without saving |
| Phone Dialer | 0–9, *, +, # | Enter phone number (see input methods below) |
| Phone Dialer | Enter | Place call | | Phone Dialer | Enter | Place call |
| Phone Dialer | Backspace | Delete last digit | | Phone Dialer | Backspace | Delete last digit |
| Phone Dialer | Q | Back to app menu | | Phone Dialer | Shift+Del | Back to app menu |
| Dialing | Enter or Q | Cancel / hang up | | Dialing | Enter or Shift+Del | Cancel / hang up |
| Incoming Call | Enter | Answer call | | Incoming Call | Enter | Answer call |
| Incoming Call | Q | Reject call | | Incoming Call | Shift+Del | Reject call |
| In Call | Enter or Q | Hang up | | In Call | Enter or Shift+Del | Hang up |
| In Call | W / S | Volume up / down (0–5) | | In Call | W / S | Volume up / down (0-5) |
| In Call | 0–9, *, # | Send DTMF tone | | In Call | 0-9, *, # | Send DTMF tone |
**Exit key:** across the T-Deck Pro and Max interface, **Q** is the back key.
The exception is anywhere you are typing -- while text or number entry is
active, Q is a normal character, so **Shift+Del** exits instead. That is why
the dialer and the call screens use Shift+Del rather than Q.
### Call Log
The Call Log records every call the device handles, stored on the SD card at
`/sms/calllog.dat` so it survives reboots. The **32 most recent** calls are
kept; older entries are trimmed automatically as new ones arrive.
Each entry shows the contact name where the number is saved (the raw number
otherwise), the call type, the duration for calls that connected, and the
local date and time.
| Type | Meaning |
|------|---------|
| **Missed** | Rang but was not answered |
| **In** | Incoming call that connected, with duration |
| **Out** | Outgoing call that connected, with duration |
Outgoing attempts that never connect -- busy, or no answer -- are logged as
**Out** with no duration. Calls that arrive with no caller ID are still
logged, listed as **Unknown**; Enter does nothing on those entries as there is
no number to dial back.
Press **Enter** on an entry to call that number back, or **D** to delete the
entry. Opening the Call Log clears the missed-call badge on the app menu and
on the lock screen.
### Contacts
Contacts assign display names to phone numbers. Names appear in the inbox
list, conversation headers, call screens, the call log and the compose screen
instead of raw numbers.
Open **Contacts** from the app menu to see the saved list. From there:
- **A** adds a new contact.
- **Enter** opens the highlighted contact.
- **M** composes an SMS to them.
- **F** calls them directly.
**The contact page** is used for both adding and editing. It has three rows --
**Name**, **Number** and **Save**. Move between them with W / S. Press
**Enter** on Name or Number to type into that field: Backspace deletes,
**Enter** commits the field, and **Shift+Del** abandons that edit. Press
**Enter** on **Save** to write the contact to the SD card.
A contact cannot be saved without a number, since the number is what the
entry is stored against -- attempting to do so leaves you on the page with a
"A number is required" prompt. Changing the number of an existing contact
replaces the old entry rather than creating a second one.
Press **F** on a saved contact to dial it, or **D** to delete it. **Q** leaves
the page **without saving**, so commit your changes on the Save row first.
Contacts can also still be created from a conversation: press **A** while
reading messages from a number to name it.
Contacts are stored as a plain text file at `/sms/contacts.txt` in
`phone=Display Name` format -- one per line, human-editable. Up to **30**
contacts are supported, and names can be up to **23** characters.
### Sending an SMS ### Sending an SMS
There are three ways to start a new message: There are four ways to start a new message:
1. **From inbox** — press **C**, type the destination phone number, press 1. **From the inbox** -- press **C**, type the destination number, press
**Enter**, then type your message and press **Enter** to send. **Enter**, then type your message and press **Enter** to send.
2. **From a conversation** — press **C** to reply. The recipient is 2. **From a conversation** -- press **C** to reply. The recipient is
pre-filled so you go straight to typing the message body. pre-filled, so you go straight to the message body.
3. **From the contacts directory** — press **D** from the inbox, scroll to a 3. **From the contacts list** -- press **M** on a contact. The compose screen
contact, and press **Enter**. The compose screen opens with the number opens with the number pre-filled.
pre-filled. 4. **From the inbox contacts view** -- press **D** from the inbox to reach the
same contacts list.
Messages are limited to 160 characters (standard SMS). A character counter is Messages are limited to 160 characters. A character counter is shown in the
shown in the footer while composing. footer while composing.
### Making a Phone Call ### Making a Phone Call
There are three ways to start a call: There are four ways to start a call:
1. **From the phone dialer** — select **Phone** from the app menu to open the 1. **From the dialer** -- select **Dial** from the app menu, enter a number
dialer. Enter a phone number and press **Enter** to call. This is the and press **Enter**.
easiest way to call a number you haven't messaged before. 2. **From the Call Log** -- press **Enter** on any entry to call it back.
2. **From a conversation** — open a conversation and press **F**. You can call 3. **From a conversation** -- press **F** to call the number you are reading.
any number you have previously exchanged messages with, whether or not it is 4. **From contacts** -- press **F** on the list, or **F** on the contact page.
saved as a named contact.
3. **From the contacts directory** — press **D** from the inbox, scroll to a
contact, and press **F**.
The display switches to a dialing screen showing the contact name (or phone The display switches to a dialing screen showing the contact name (or number)
number) and an animated progress indicator. Once the remote party answers, the and an animated progress indicator. Once the remote party answers, the screen
screen transitions to the in-call view with a live call timer. transitions to the in-call view with a live call timer.
During an active call, **W** and **S** adjust the speaker volume (0–5). The During a call, **W** and **S** adjust the speaker volume (0-5). The number
number keys **0–9**, **\***, and **#** send DTMF tones for navigating phone keys **0-9**, **\***, and **#** send DTMF tones for navigating phone menus and
menus and voicemail systems. Press **Enter** or **Q** to hang up. voicemail. Press **Enter** or **Shift+Del** to hang up.
Audio is routed through the A7682E modem's internal codec to the board speaker Audio is routed through the A7682E modem's internal codec to the board speaker
and microphone — no headphones or external audio hardware are required. and microphone -- no headphones or external audio hardware are required.
### Phone Dialer Input Methods ### Phone Dialer Input Methods
The phone dialer supports three ways to enter digits: The dialer supports three ways to enter digits:
1. **Direct key press** — press the keyboard letter that corresponds to each 1. **Direct key press** -- press the keyboard letter that corresponds to each
number using the silk-screened labels on the T-Deck Pro keys: number using the silk-screened labels on the keys:
| Key | Digit | | Key | Digit | | Key | Digit | | Key | Digit | | Key | Digit | | Key | Digit |
|-----|-------|-|-----|-------|-|-----|-------| |-----|-------|-|-----|-------|-|-----|-------|
@@ -110,71 +201,72 @@ The phone dialer supports three ways to enter digits:
| R | 3 | | F | 6 | | C | 9 | | R | 3 | | F | 6 | | C | 9 |
| A | * | | O | + | | Mic | 0 | | A | * | | O | + | | Mic | 0 |
2. **Touchscreen tap** — tap the on-screen number buttons directly. Note: this 2. **Touchscreen tap** -- tap the on-screen buttons directly. The bottom row
currently requires fairly precise taps on the numbers themselves. of the keypad carries **+**, **Backspace** and **Call**, so a number can be
dialled entirely by touch. Note that this currently requires fairly precise
taps on the buttons themselves.
3. **Sym+key** — the standard symbol entry method (e.g. Sym+W for 1, Sym+S for 3. **Sym+key** -- the standard symbol entry method (e.g. Sym+W for 1).
4, etc.)
### Receiving a Phone Call ### Receiving a Phone Call
When an incoming call arrives, the app automatically switches to the incoming When an incoming call arrives, the app switches to the incoming call screen
call screen regardless of which view is active. A short alert and buzzer regardless of which view is active. A short alert and buzzer notification are
notification are triggered. The caller's name is shown if saved in contacts, triggered. The caller's name is shown if saved in contacts, otherwise the raw
otherwise the raw phone number is displayed. number is displayed.
Press **Enter** to answer or **Q** to reject the call. If the call is not If the device is locked when a call arrives, it unlocks itself so the call can
answered it is logged as a missed call and a "Missed: ..." alert is shown be answered, and stays unlocked afterwards.
briefly.
### Contacts Press **Enter** to answer or **Shift+Del** to reject. If the call is not
answered it is recorded in the Call Log as a missed call, a "Missed: ..."
alert is shown briefly, and the missed-call count appears on the app menu and
lock screen.
The contacts directory lets you assign display names to phone numbers. ### Lock Screen Notifications
Names appear in the inbox list, conversation headers, call screens, and
compose screen instead of raw numbers.
To add or edit a contact, open a conversation with that number and press **A**. On Pro 4G and Max builds, the lock screen shows any outstanding **unread SMS**
Type the display name and press **Enter** to save. Names can be up to 23 and **missed calls** below the battery and mesh unread line, for example
characters long. `SMS: 2 Missed: 1`. Either part is hidden when its count is zero.
Contacts are stored as a plain text file at `/sms/contacts.txt` on the SD card These are read from the inbox and the call log rather than tallied while the
in `phone=Display Name` format — one per line, human-editable. Up to 30 screen is locked, so they persist across locking, unlocking and rebooting.
contacts are supported. They clear only when you open the relevant conversation or the Call Log.
### Conversation History ### Conversation History
Messages are saved to the SD card automatically and persist across reboots. Messages are saved to the SD card automatically and persist across reboots.
Each phone number gets its own file under `/sms/` on the SD card. The inbox Each phone number gets its own file under `/sms/`. The inbox shows the most
shows the most recent 20 conversations sorted by last activity. Within a recent 20 conversations sorted by last activity. Within a conversation the
conversation, the most recent 30 messages are loaded with the newest at the most recent 30 messages are loaded, newest at the bottom. Sent messages are
bottom (chat-style). Sent messages are shown with `>>>` and received messages shown with `>>>` and received messages with `<<<`.
with `<<<`.
Message timestamps use the cellular network clock (synced via NITZ roughly 15 Message timestamps use the cellular network clock (synced via NITZ roughly 15
seconds after each modem startup) and display as relative times (e.g. 5m, 2h, seconds after each modem startup) and display as relative times (e.g. 5m, 2h,
1d). If the modem is toggled off and back on, the clock re-syncs automatically. 1d). If the modem is toggled off and back on, the clock re-syncs
automatically.
### Modem Power Control ### Modem Power Control
The 4G modem can be toggled on or off from the settings screen. Scroll to The 4G modem can be toggled on or off from the settings screen. Scroll to
**4G Modem: ON/OFF** and press **Enter** to toggle. Switching the modem off **4G Modem: ON/OFF** and press **Enter** to toggle. Switching the modem off
kills its red status LED and stops all cellular activity. The setting persists kills its red status LED and stops all cellular activity. The setting persists
to SD card and is respected on subsequent boots — if disabled, the modem and to SD and is respected on subsequent boots -- if disabled, the modem and LED
LED stay off until re-enabled. The SMS & Phone app remains accessible when the stay off until re-enabled. The SMS & Phone app remains accessible when the
modem is off but will not be able to send or receive messages or calls. modem is off, but cannot send or receive messages or calls.
### Signal Indicator ### Signal Indicator
A signal strength indicator is shown in the top-right corner of all SMS and A signal strength indicator is shown in the top-right corner of all SMS and
call screens. Bars are derived from the modem's CSQ (signal quality) reading, call screens. Bars are derived from the modem's CSQ (signal quality) reading,
updated every 30 seconds. The modem state (REG, READY, OFF, etc.) is shown updated every 30 seconds. The modem state (REG, READY, OFF, etc.) is shown
when not yet connected. During a call, the signal indicator remains visible. when not yet connected. During a call the indicator remains visible.
### IMEI, Carrier & APN ### IMEI, Carrier & APN
The 4G modem's IMEI, current carrier name, and APN are displayed at the bottom The modem's IMEI, current carrier name, and APN are displayed at the bottom of
of the settings screen (press **S** from the home screen), alongside your node the settings screen (press **S** from the home screen), alongside your node ID
ID and firmware version. and firmware version.
### SD Card Structure ### SD Card Structure
@@ -182,6 +274,7 @@ ID and firmware version.
SD Card SD Card
├── sms/ ├── sms/
│ ├── contacts.txt (plain text, phone=Name format) │ ├── contacts.txt (plain text, phone=Name format)
│ ├── calllog.dat (binary, 32 most recent calls)
│ ├── modem.cfg (0 or 1, modem enable state) │ ├── modem.cfg (0 or 1, modem enable state)
│ ├── 0412345678.sms (binary message log per phone number) │ ├── 0412345678.sms (binary message log per phone number)
│ └── 0498765432.sms │ └── 0498765432.sms
@@ -196,11 +289,16 @@ SD Card
|---------|-------------| |---------|-------------|
| Modem icon stays at REG / never reaches READY | SIM not inserted, no signal, or SIM requires PIN unlock (not currently supported) | | Modem icon stays at REG / never reaches READY | SIM not inserted, no signal, or SIM requires PIN unlock (not currently supported) |
| Timestamps show `---` | Modem clock hasn't synced yet (wait ~15 seconds after modem startup), or messages were saved before clock sync was available | | Timestamps show `---` | Modem clock hasn't synced yet (wait ~15 seconds after modem startup), or messages were saved before clock sync was available |
| Red LED stays on after disabling modem | Toggle the setting off, then reboot — the boot sequence ensures power is cut when disabled | | Red LED stays on after disabling modem | Toggle the setting off, then reboot -- the boot sequence ensures power is cut when disabled |
| SMS sends but no delivery | Check signal strength; below 5 bars is marginal. Move to better coverage | | SMS sends but no delivery | Check signal strength; below 5 bars is marginal. Move to better coverage |
| Call drops immediately after dialing | Check signal strength and ensure the SIM plan supports voice calls | | Call drops immediately after dialing | Check signal strength and ensure the SIM plan supports voice calls |
| No audio during call | The A7682E routes audio through its own codec; ensure the board speaker is not obstructed. Try adjusting volume with W/S | | No audio during call | The A7682E routes audio through its own codec; ensure the board speaker is not obstructed. Try adjusting volume with W/S |
| Contact will not save | The Number field is empty -- a contact is stored against its number, so one is required |
| Call Log entry shows "Unknown" | The network withheld the caller ID, or it did not arrive before the caller rang off. The call is still logged |
| Missed-call count will not clear | It clears when the Call Log is opened, not when the device is unlocked |
> **Note:** The SMS & Phone app is only available on the 4G modem variant of > **Note:** The SMS & Phone app is available on the 4G variants of the T-Deck
> the T-Deck Pro. It is not present on the audio or standalone BLE builds due > Pro and on the T-Deck Pro Max. It is not present on the audio or standalone
> to shared GPIO pin conflicts between the A7682E modem and PCM5102A DAC. > BLE builds of the T-Deck Pro, due to shared GPIO pin conflicts between the
> A7682E modem and the PCM5102A DAC. The Max avoids that conflict by wiring
> its modem and ES8311 codec through an XL9555 I/O expander, so it has both.
examples/companion_radio/ui-new/SMSScreen.h
+19
View File
@@ -1696,6 +1696,25 @@ public:
// physW/physH: physical touch panel dimensions (240/320) // physW/physH: physical touch panel dimensions (240/320)
bool handleTouch(int16_t px, int16_t py, int dispW = 128, int dispH = 128, bool handleTouch(int16_t px, int16_t py, int dispW = 128, int dispH = 128,
int physW = 240, int physH = 320) { int physW = 240, int physH = 320) {
// App menu: first tap highlights a row, tapping the same row again opens it
if (_view == APP_MENU) {
int my = (int)py * dispH / physH;
const int menuTop = 24; // must match renderAppMenu
const int menuLineH = 16;
for (int i = 0; i < 4; i++) {
if (my >= menuTop + i * menuLineH && my < menuTop + (i + 1) * menuLineH) {
if (_menuCursor == i) {
handleAppMenuInput(0x0D); // second tap == Enter
} else {
_menuCursor = i;
}
_needsRefresh = true;
return true;
}
}
return false;
}
if (_view != PHONE_DIALER) return false; if (_view != PHONE_DIALER) return false;
// Map physical touch coordinates to virtual display coordinates // Map physical touch coordinates to virtual display coordinates