MeshCore-Solo/docs/solo/contacts.md

# 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).
> Every packet heard shows. One that can be placed runs along its line as a
> dot and fades. One that can't (its sender or repeaters have no position)
> is a ring around you. Colours by kind: adverts blue, direct messages
> green, channels amber, requests violet, acks and paths teal, the rest
> pink, your own white. The pill at the top counts each kind over the last
> minute.

> [!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.