Outbound paths start the suggested routes, for each site and fixed device
The user names the ways out of their node, one or more hops long, in order. Each site of this computer (Home, Foulab) has its own list, one site is active, and a fixed device keeps its own list. - Explore > Outbound paths: the sites with the active mark, the fixed devices, and a staged editor for each list. Each path shows how well its first hop hears us (out) and how well we hear it (in). Measure sends one trace out along a path and back, after the cooldown. - The path composer has an outbound mode, and puts the active paths first while the insertion slot is at our node (trace target, trace path, the TX sweep route). - MeshTopology.outbound_scenarios: one route through each path. It scores from the link after the path, lets the user's order win a near tie, and skips a path whose first hop was silent for outbound_silent_hours. These routes lead Explore paths, the node page's Routes tab, and the trace auto route, ahead of a device route that starts on another hop. - A first link out of our node is scored from what the far end measured, when a trace gave such readings. - The site suggestion: when the radio hears the first hop of another site three times, the main menu asks to use that site and says what it heard. "Never suggest" sets the new suggest_site preference off. - CLI: meshterm outbound [show|sites|use|set|remove|fix|unfix], plain and --json. Refs: #35 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
c50656c586
commit
ec64076d44
19 files changed
+2468
-55
No files matched your search
@@ -1622,6 +1622,49 @@ $ meshterm trace-path --path "a1,d4" --json | jq -r '.edges | min_by(.snr_db) |
|
||||
a1 -> d4 2.0 dB
|
||||
```
|
||||
|
||||
#### `meshterm outbound`
|
||||
|
||||
Show and change the outbound paths: the ways out of your node that the trace features
|
||||
start their routes on. A path is a spec, the same as `--path` (`3d63,f2c2`), from your
|
||||
node outward. Each site of this computer has its own paths, and one site is active. A
|
||||
fixed device keeps its own paths, and the active site does not apply to it.
|
||||
|
||||
| Command | What it does |
|
||||
| --- | --- |
|
||||
| `outbound` or `outbound show` | The paths that apply to the connected device now, and where they come from. |
|
||||
| `outbound sites` | Each site, whether it is active, and its paths. |
|
||||
| `outbound use SITE` | Make a site active. `outbound use --none` makes no site active. |
|
||||
| `outbound set SITE PATH…` | Make a site, or replace its paths, in your order. When no site is active, the new site becomes active. |
|
||||
| `outbound remove SITE --yes` | Delete a site and its paths. |
|
||||
| `outbound fix [PATH…]` | Give the connected device its own paths. With no path, it starts with the paths of the active site. |
|
||||
| `outbound unfix --yes` | The connected device follows the active site again. |
|
||||
|
||||
```console
|
||||
$ meshterm outbound set Home 3d63c6429436 27d4,f2c2
|
||||
✓ site Home: 2 outbound path(s)
|
||||
$ meshterm outbound sites
|
||||
SITE ACTIVE PATHS
|
||||
Home yes 3d63c6429436 27d4,f2c2
|
||||
Foulab no a100
|
||||
$ meshterm outbound
|
||||
SOURCE site
|
||||
NAME Home
|
||||
|
||||
RANK PATH HOPS
|
||||
1 3d63c6429436 3d63c6429436
|
||||
2 27d4,f2c2 27d4 → f2c2
|
||||
```
|
||||
|
||||
`sites`, `use`, `set`, and `remove` do not open the device. `show`, `fix`, and `unfix`
|
||||
open it, because the fixed devices are known by their public key. `show` returns `5` when
|
||||
no list applies. `sites` returns `5` when there is no site. A path with a node two times,
|
||||
or a hop that is not whole bytes of hex, is a usage error (`2`).
|
||||
|
||||
**`--json`** gives `show` as one object, `{"source": …, "name": …, "paths": [{"rank": …,
|
||||
"path": …, "hops": […]}]}`. `source` is `site`, `device`, or `null`. `sites` is an array of
|
||||
`{"site", "active", "paths"}`. Each change prints the object that it wrote, for example
|
||||
`{"active": "Foulab"}`.
|
||||
|
||||
#### `meshterm tx-optimize`
|
||||
|
||||
Sweep the transmit power of a remote node against a target. Then select the lowest level
|
||||
|
||||
@@ -40,6 +40,7 @@ This page lists each interactive screen with its scripted equivalent, where one
|
||||
| **🌐 Mesh walk** | The observed shape of the mesh, which you walk one node at a time. It is a graph of evidence from trace walks, firmware routes, overheard relay chains, and the neighbour tables of repeaters. It has braille edges that are coloured by SNR, and quality bars. Press Enter to walk to a node. Press ⌫ to go back. Type to find any node. The map shows where the nodes are. The walk shows how the nodes connect. | none |
|
||||
| **🎯 Trace target** | A live trace screen. Select a target, and each trace streams in, hop by hop. The screen shows the running median and the reliability of each hop. You can compose a route through specific repeaters, or force one. A trace transmits **exactly once**, because repeaters can blacklist nodes that send bursts. To get more samples, run the trace again. | `meshterm trace --target …` |
|
||||
| **👣 Trace path** | The other half of tracing. You compose the whole circuit by hand, out and back, by the way that you choose. Then you walk it. The path composer suggests each next hop from the links that MeshTerm observed, strongest first. If you have the admin password of a repeater, the composer can also get the neighbour table of that repeater over the mesh. | `meshterm trace-path --path …` |
|
||||
| **🧭 Outbound paths** | The ways out of your node that you trust, in your order. A radio link is not the same in the two directions: a repeater that your node hears well can hear your node badly, and most of what MeshTerm knows comes from what your node hears. Thus you name the way out, one or more hops long. Each site where you take the computer (Home, Work) has its own list, and one site is active. A companion that never moves can keep its own list. The trace features then start their suggested routes on your paths. Each path shows how well its first hop hears you (`out`) and how well you hear it (`in`). Measure sends one trace out along a path and back. When your radio hears the way out of another site, the menu asks if you want to use that site. | `meshterm outbound …` |
|
||||
| **🏆 Trophy case** | MeshTerm scores each trace that comes home on seven boards: longest distance, farthest node, longest single leg, most nodes (with and without revisits), weakest surviving link, and biggest enclosed loop. It keeps the records for each hash width. A record walk must be a trail, which means that no link is crossed twice in the same direction. | `meshterm records` |
|
||||
|
||||
## 🔧 This node: the radio in your hand
|
||||
|
||||
Reference in new issue
Block a user