MeshCore-Solo/docs/solo/tools.md

Tools

On joystick devices, the tools are in Tools, grouped into Location, Comms and System; the Tools home page keeps the two you used last. The navigation tools are on the Navigation page, Nodes and Admin on Contacts; the Status screen opens from its own home page.

Note

Wio Tracker L2: the tools are apps on the home screen: Messages, Nodes, Settings, Compass, Clock, GPS, Bot, Repeater, Admin, Diagnostics, Flashlight. The trail, live sharing and the locator are on the map (its tools button) and in Settings › Map.

Clock

The Clock home page shows the time with a bar under it that fills with the seconds (Settings › Display › Clock seconds), the date, and up to three fields you choose (hold Enter): battery, temperature, humidity, pressure, altitude (barometric or GPS), light, CO₂, GPS position, satellites, contacts, unread messages. The time comes from GPS or the phone app; the time zone is in Settings.

Enter on the clock opens the clock tools:

• Alarm: a time, repeating daily, on weekdays, at weekends or once. It rings with the screen off or locked, but not after a shutdown.
• Timer: a countdown that rings when it reaches zero, whatever screen you're on.
• Stopwatch.
• Calendar: the month with today marked and the alarm's days underlined; Left / Right pages through the months, Enter comes back to this one.

Any key silences the ringing; it stops by itself after a minute.

Remote bot

Tools › Bot answers messages for you. It watches your direct messages, one channel and one room, each switched on separately:

• Trigger and reply: when a message contains the trigger (several can be separated by commas, * matches any message), the bot sends the reply. The reply can use placeholders, plus {name} (the sender), {hops}, {path} (the route in, as hop hashes oldest first: 3f:a1:c8, or direct), {snr} and {rssi} (how its last hop was heard).

• Commands: messages starting with ! get live data back:

  Command	Reply
  !ping	pong
  !batt, !temp, !time, !loc	battery, temperature, time, position
  !hops	how many hops the command took
  !path	which way it came: the hop hashes, oldest first (3f:a1:c8; 2-byte mode 3fa1:c802), or direct
  !snr	how its last hop was heard here: SNR and RSSI
  !dist	how far away and which way the sender is (both need a position)
  !status	battery, position and time
  !help	the list of commands

  Several in one message get one reply: !batt !time → 4.10V | 14:30.

• Actions (off by default) let the command change the device: !buzz (sounds the buzzer to find it), !gps on / !gps off, !gps fix (turns the GPS on, waits for a good fix and sends it), !advert. Actions by = Fav (Other tab) lets only your favourites run them; on a channel the sender is just a name, so there it's a weak check.

On ESP32 boards (L2, Heltec, ...) the Log tab lists the bot's last 32 replies: when, who, what they asked and what it answered. Kept until a restart.

DM allow = Fav limits the DM bot to your favourites, and quiet hours stop trigger replies at night (commands still answer). Replies are rate limited so two bots can't answer each other forever. The room bot uses the room's saved login.

Auto-advert

Tools › Auto-advert sends your advert every 30 seconds to 1 hour (with your position if Settings › Privacy › Advert pos is on), so others see you in their Nearby list. With it on at both ends and Settings › Sound › AD sound set, each device beeps when it hears the other: a hands-free "still in range".

Repeater

Tools › Repeater makes the device relay other people's packets while it keeps working as a companion. By default it relays on a separate repeater profile (the community's repeater frequency) and switches back when you turn it off; Network = Current relays on your own frequency instead.

Optional filters keep a mobile repeater from adding noise: skip adverts, a maximum hop count, Yield (let fixed repeaters go first), a minimum SNR, drop duplicates already relayed by someone else, and relay only your scopes. The Status screen's Mesh tab shows how much it forwards.

Ringtones

Tools › Ringtone composes two melodies of up to 32 notes (pitch, octave, length, tempo). Use them for notifications in Settings › Sound, or for a single contact or channel from its options.

Note

Wio Tracker L2: the melody editor is under Settings › Sound.

Flashlight

Tools › System › Flashlight lights the whole screen white at full brightness and keeps it on until you press a key; the brightness goes back when you leave. Not on e-ink, which gives no light.

Note

Wio Tracker L2: the Flashlight app. A tap, the side button or the top button puts it away.

Status

The Status home page sums up the radio, GPS, battery and mesh in four tiles; Enter opens the Status screen, one tab per subject (Left / Right between them, Up / Down scrolls):

Tab	Shows
Radio	Frequency, SF / BW / CR, TX power, the noise floor over the last half hour, the last packet's signal
GPS	On / off (Enter switches it), fix, satellites, position, altitude, speed, precision, time to first fix
Sky	The satellites on a sky plot, or each one's signal as bars (Enter swaps them); Wio Tracker L1
Power	Battery level, voltage, source and trend, then the readings of any sensors
Mesh	Packets received and sent with a traffic line, forwarded, nodes heard, contacts; hold Enter resets the counters
System	Uptime, firmware, device, memory, the send queue, errors, and a sample of every script the font covers; Enter shows your contact as a QR code, which the phone app scans to add you, and Enter again a QR code that opens this manual; any other key closes it

GPS pwr in Settings › System turns the GPS off between fixes to save battery; anything that needs your position (the trail, live share, the locator) keeps it on.

Note

Wio Tracker L2: the Diagnostics app, with a Noise tab that measures the noise floor over time and history charts you can touch for the value at that moment, and the GPS app, on three tabs: Sky (a plot of the satellites and the fix), Signal (a bar per satellite with its strength, and the constellations) and Details (position, precision, time to first fix and what the receiver reports). Your contact's QR code and the manual's are in Settings › About.

GPIO

Wio Tracker L1 only. Tools › GPIO sets four spare pins as input, output or (GPIO1–2) analog input, shows their level and switches outputs. The bot's !gpio1…!gpio4 commands read and set the same pins.