Files
MeshCore-Solo/docs/solo/contacts.md
T
JakubandClaude Opus 5.5 c779bf46b5 feat(ui-lvgl): title bar with the clock, tidier controls, contextual nav bar
Density from less chrome instead of smaller rows (ROW_H stays 44):
- titled screens drop the status bar; the title bar (APPBAR_H) holds back,
  the title, the screen's actions and the time/battery on a pill; the status
  bar returns for Home, the map, typing, the quick panel and the lock
- one radius (RADIUS) for everything tapped: buttons, tabs, choices, chips
- tabs are all segmented at TAB_H in the body (GPS, Clock converted)
- Nodes: chips row + sort + status line become one toolbar row with
  Show / Order choices; Messages' All/Favourites is the same choice
- nav map: the target bar only while there is a target; the pin opens one
  "Places" popup; back from a map options page restores the map and Map
  tools as left, without a jump
- node detail actions at the top of the scroll; Home tiles fill the page
- rowsFit() leaves growing labels to the flex (a screen title cut to one
  letter after Messages' filter changed)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-14 12:51:03 +02:00

133 lines
6.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Contacts
## Nearby nodes
**Tools › Nodes** lists the nodes the device has heard: their type, how long
ago, and, when they have a position, distance and bearing. **Left / Right**
filters by type (All, Fav, Companions, Repeaters, Rooms, Sensors); the sort,
by distance or by last heard, is in the options. A ★ marks a favourite, a ♦
someone sharing their position live.
> [!NOTE]
> **Wio Tracker L2:** the line over the list holds the count and two choices,
> which nodes to show and in what order; **Scan** and the map are in the
> title bar.
**Enter** shows a node's details. **Hold Enter**, in the list or the details,
for what you can do with it:
| Option | Does |
| ------ | ---- |
| Map | Every node with a position on a map (below) |
| Navigate | Distance and bearing to the node; follows it if it shares its position live |
| Ping | Sends a ping and shows the round trip time and SNR |
| Save waypoint, Set as target | Its position as a waypoint, or as the [Locator](./navigation.md#locator) target |
| Fav, Pin to dial | Favourite, or a place on the Favourites page |
| Telem | What this contact may ask for: None, Status, Stat+loc, Stat+sens, All. Shown when a [Privacy](./settings.md#privacy) setting is **Allowed** |
| Path / trace | The route to the node: edit it, trace it, save it (below) |
| Reset path | Forgets the learned route; the next message floods and finds a new one. Shown when there is a route |
| Share nearby | Sends the contact's last advert to the nodes in direct range, so they can add it |
| Admin | Remote admin, for a repeater or room (below) |
| Discover scan | Asks the repeaters, rooms and sensors in direct range to answer, with their signal |
**Map** shows the nodes of the current filter that have a position, with you
and the target, fitted to the screen, north up, with a scale. **Flow** in its
options draws what the radio hears: each packet as a line from the node that
sent it, through the repeaters it passed, to you, for a minute; a packet you
send is a ring around you. Only nodes with a position can be placed, so a
line may skip a hop. Nodes are dots
(a diamond for a live share); the selected one is boxed, and the line under
the map gives its name and distance, with **+n** when others sit on the same
spot. **Left / Right** selects the next node, **Up / Down** zooms in on it and
back out, **Enter** opens its details and **Hold Enter** its options.
> [!NOTE]
> **Wio Tracker L2:** **Packet flow** is in the map's options (On the map).
> Each packet runs along its line as a dot and fades, coloured by kind:
> adverts blue, direct messages green, channels amber, the rest violet.
> [!NOTE]
> **Wio Tracker L2:** the **Nodes** app. Filter chips at the top, the sort in
> the header, and a map button that shows every node with a position. A
> node's card has buttons for the same actions, plus **Add** for a node that
> isn't a contact yet and **Delete**. The telemetry permissions are three
> switches under **Can ask for**.
## Path and trace
**Path / trace** in a contact's options shows the repeaters its messages go
through, in order, and the node at the end. **+ Add repeater** picks one from
the Nodes list, **Enter** on a hop moves or removes it, and **Left / Right**
moves it up or down.
**Trace** sends a trace along the route and back the same way. Each node
answers with how well it heard the one before it, so every hop shows two
numbers in dB: the way out and the way back. Only a node that repeats can
answer: repeaters do, companions only with repeat on. **To node** off traces
just the repeaters, which still tells you whether the way to the node is good.
With no reply, **Find break** traces to the first repeater, then the second,
and so on, and shows where it stops. If every repeater answers, the node
itself didn't.
**Save path** makes the list the contact's route; saved empty, messages go
straight to the node. The route a node sends back usually replaces it again;
**Keep path** stops that, and keeps the route after failed sends too.
**Reset path** forgets it, keep included.
> [!NOTE]
> **Wio Tracker L2:** **Route** in a node's card. Each repeater and the node
> take one line, with the link's out / back dB on the right: green when good,
> amber when fair, red when weak. Tap a repeater to move or remove it, tap
> the node to trace to it or stop at the last repeater. **Keep** is in the
> header, **Find where** appears next to a "No reply". The repeaters can also
> be tapped on the map, in order (**Map**); **Undo** takes the last one out.
## Your own contact
**Status › System**, **Enter** shows your contact as a QR code: the phone
app's scanner adds you from it, with your name and key. On the Wio Tracker L2
it is in **Settings › About**.
## Favourites
The **Favourites** home page holds six slots for the conversations you open
most: a contact, a room or a channel, each with its unread count. **Enter** on
an empty slot picks one from Messages; **hold Enter** on a filled slot to
replace or remove it. **Pin to dial** in any contact, channel or node menu
does the same.
A pinned slot is not the same as a favourite. **Fav** is the star shared with
the phone app: it sorts contacts to the top and drives the "favourites only"
filters in Settings › Contacts.
> [!NOTE]
> **Wio Tracker L2:** the first home page. Tap a slot to open it, hold it to
> change it.
## Cleaning up
Settings › Contacts › **Expire** (7, 30 or 90 days) sets when a contact you
haven't heard from counts as inactive, and **Prune now** removes those after
showing how many it will delete. Favourites are always kept, and nothing is
removed without **Prune now**.
## Remote admin
**Tools › Admin** manages a repeater or room server you are an admin on, the
same way the phone app does. Pick the node, type its admin password (saved for
next time), then choose a field:
- **System**: name, owner info, admin password.
- **Radio**: frequency, bandwidth, spreading factor, coding rate, TX power.
- **Routing**: repeat on/off, advert intervals, max hops.
- **Actions**: send an advert, sync its clock, reboot, start OTA, or any
[CLI command](../cli_commands.md).
Name and owner info are read from the node first, so you edit the current
value. Reboot and OTA ask before sending.
> [!WARNING]
> Admin commands change the remote node. Check the node and the value before
> sending.