Files
roro9stack/site/content/guide/wifi-tools.md
T
twislaandClaude Opus 5.5 34e6714785
CI / build (pull_request) Successful in 7m14s
Site / build (pull_request) Successful in 8s
Keys: one table file for the device's help panel and the website's key tables (#72)
Every screen's keys are constant tables in lib/core/src/app_keys.h (52 of
them, each under an `// id: Title` comment). An App's help() picks the table
of the state it is in. site/tools/gen_dev_docs.py reads the same file and
writes site/data/keys.toml; the `keys` shortcode shows a screen's tables on
its guide page, and /guide/keys/ shows all of them.

The Site job fails when the data file is out of date or a page asks for a
table that doesn't exist, and now also runs when app_keys.h changes. A key
added to an App shows up on the website without anyone editing a page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EhqxQ49eCju4CzKYNjZzwT
2026-10-07 01:42:48 +02:00

43 lines
2.1 KiB
Markdown

+++
title = "Wi-Fi tools"
description = "See the networks around you, which Wi-Fi channels are busy, and follow one network's signal as you move."
weight = 6
[extra]
tag = "Wi-Fi tools"
+++
The Wi-Fi tools show what the radio hears **now**: they scan for the networks around you and list them. They do not join anything.
## The menu
Three entries: **Networks nearby**, **Channel occupancy** and **Signal tracker**. Pick one with the arrows and press <kbd>Enter</kbd>.
## Networks nearby
A list that refreshes by itself: each network's name (or `(hidden)`), channel, signal in dBm and security. The top line says how it is sorted and filtered.
| Key | Does |
|---|---|
| <kbd>s</kbd> | Sorts by signal, channel or name, in turn |
| <kbd>o</kbd> | Shows only open networks |
| <kbd>h</kbd> | Hides the hidden networks |
| <kbd>w</kbd> | Shows only the strong ones |
| <kbd>l</kbd> | Starts and stops **logging** |
| <kbd>Enter</kbd> | Opens the **Signal tracker** on that network |
**Logging** adds each scan to `/wifi/scans/<date>.csv` on the SD card, one row per network, once the device knows the date; `LOG` and a row count show while it runs. Logs stop when the card passes 90% full.
## Channel occupancy
One bar for each of the 13 Wi-Fi channels shows how busy it is: how many networks use it, and how strong they are. The top line counts the networks and names the quietest of the three channels that don't overlap, **1, 6 and 11**. It is the quick answer to "which channel should my router use?". <kbd>`</kbd> (Back) returns to the menu.
## Signal tracker
Follows one network: its name, address and channel, then the signal in dBm in large type, a strength bar, and a graph of the recent readings, so you can walk towards the strongest signal. <kbd>m</kbd> turns audible clicks on and off. If the network is no longer heard the screen says `lost`. <kbd>`</kbd> (Back) returns to the list.
## The keys, as the device lists them
What <kbd>Fn</kbd> + <kbd>h</kbd> shows on these screens. These tables are generated from the firmware's own lists, so they are always the current ones.
{{ keys(scopes=["wifi-tools", "wifi-networks", "wifi-tracker"]) }}