mirror of
https://github.com/meshtastic/Meshtastic-Android.git
synced 2026-10-03 00:54:34 -04:00
49 lines
3.1 KiB
HTML
49 lines
3.1 KiB
HTML
<h1 id="home-screen-widget">Home Screen Widget</h1>
|
||
|
||
<p>On Android, Meshtastic provides a home screen <strong>widget</strong> that shows live local statistics from your connected radio at a glance — no need to open the app.</p>
|
||
|
||
<h2 id="what-it-shows">What It Shows</h2>
|
||
|
||
<p>The widget displays the <strong>connected radio’s</strong> current local stats:</p>
|
||
|
||
<ul>
|
||
<li>A <strong>node chip</strong> across the top, carrying the radio’s short name in its own colors</li>
|
||
<li><strong>Battery</strong> — the radio’s battery level, or <em>Powered</em> when running on external power</li>
|
||
<li><strong>ChUtil</strong> — channel utilization (how busy the LoRa channel is, as a percentage)</li>
|
||
<li><strong>AirUtil</strong> — airtime utilization (how much of the duty cycle your radio is transmitting)</li>
|
||
<li><strong>Traffic</strong> — packets transmitted / received, and duplicates seen</li>
|
||
<li><strong>Relays</strong> — packets relayed and relay cancellations (shown when the radio is relaying)</li>
|
||
<li><strong>Diagnostics</strong> — a combined line carrying <strong>Noise</strong> (the background noise level in dBm), <strong>Bad</strong> (corrupt packets received), and <strong>Dropped</strong> (packets the radio discarded). Bad and Dropped appear only once they are above zero, so a quiet radio may show the noise reading alone</li>
|
||
<li><strong>Heap</strong> — free versus total memory on the radio, drawn as a bar</li>
|
||
<li><strong>Nodes</strong> — how many nodes are online, out of the total known</li>
|
||
<li><strong>Uptime</strong> — how long the radio has been running since its last reboot, shown beside Nodes</li>
|
||
<li><strong>Updated</strong> — the time the stats last refreshed, along the foot of the widget</li>
|
||
</ul>
|
||
|
||
<p>Tap the widget to open the app, or use its refresh control to request fresh stats.</p>
|
||
|
||
<blockquote>
|
||
<p>ℹ️ <strong>Note:</strong> The values reflect the connected radio. If the radio disconnects, the widget replaces the stats with a status line — <strong>Disconnected</strong>, <strong>Connecting</strong>, or <strong>Device sleeping</strong>. It does not keep the last-known numbers on screen.</p>
|
||
</blockquote>
|
||
|
||
<h2 id="adding-the-widget">Adding the Widget</h2>
|
||
|
||
<ol>
|
||
<li>Touch & hold an empty area of your Android home screen.</li>
|
||
<li>Tap <strong>Widgets</strong>.</li>
|
||
<li>Drag the <strong>Meshtastic</strong> widget to your home screen. The app ships one widget, so the picker entry is just the app name.</li>
|
||
<li>Resize it as needed — the layout adapts to the available space.</li>
|
||
</ol>
|
||
|
||
<blockquote>
|
||
<p>ℹ️ <strong>Note:</strong> The widget is Android-only. It is not available on the Desktop or iOS builds.</p>
|
||
</blockquote>
|
||
|
||
<h2 id="related-topics">Related Topics</h2>
|
||
|
||
<ul>
|
||
<li><a href="node-metrics">Node Metrics</a> — the full Signal Quality and Local Stats history inside the app</li>
|
||
<li><a href="connections">Connections</a> — connect to a radio so the widget has stats to show</li>
|
||
<li><a href="discovery">Local Mesh Discovery</a> — channel and airtime utilization across the mesh</li>
|
||
</ul>
|