feat(node): add local stats noise floor metrics (#5782)

Co-authored-by: James Rich <james.a.rich@gmail.com>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: 3 people

.skills/compose-ui/strings-index.txt

@@ -174,6 +174,25 @@ open class MeshLogRepositoryImpl(
         dbManager.currentDb.value.meshLogDao().deleteLogs(logId, portNum)
     }
 
+    /** Deletes only local stats telemetry logs for [nodeNum], preserving other telemetry types. */
+    override suspend fun deleteLocalStatsLogs(nodeNum: Int) = withContext(dispatchers.io) {
+        val myNodeNum = nodeInfoReadDataSource.myNodeInfoFlow().firstOrNull()?.myNodeNum
+        val logId = if (nodeNum == myNodeNum) MeshLog.NODE_NUM_LOCAL else nodeNum
+        val dao = dbManager.currentDb.value.meshLogDao()
+        val localStatsLogs =
+            dao.getLogsFrom(logId, PortNum.TELEMETRY_APP.value, Int.MAX_VALUE)
+                .firstOrNull()
+                .orEmpty()
+                .map { it.asExternalModel() }
+                .filter { parseTelemetryLog(it)?.local_stats != null }
+
+        val localStatsLogIds = localStatsLogs.map { it.uuid }
+        // Chunk to stay under SQLite's bind-variable limit; re-fetch DAO per chunk if the active DB switches.
+        for (chunk in localStatsLogIds.chunked(DELETE_CHUNK_SIZE)) {
+            dbManager.currentDb.value.meshLogDao().deleteLogsByUuid(chunk)
+        }
+    }
+
     /** Prunes the log database based on the configured [retentionDays]. */
     @Suppress("MagicNumber")
     override suspend fun deleteLogsOlderThan(retentionDays: Int) = withContext(dispatchers.io) {
@@ -183,5 +202,8 @@ open class MeshLogRepositoryImpl(
 
     companion object {
         private const val MILLIS_PER_SEC = 1000L
+
+        /** Max UUIDs per DELETE IN-clause; keeps us under SQLite's bind-variable limit. */
+        private const val DELETE_CHUNK_SIZE = 500
     }
 }

core/data/src/commonMain/kotlin/org/meshtastic/core/data/repository/MeshLogRepositoryImpl.kt

@@ -32,8 +32,10 @@ import org.meshtastic.core.model.MeshLog
 import org.meshtastic.core.testing.FakeDatabaseProvider
 import org.meshtastic.core.testing.FakeMeshLogPrefs
 import org.meshtastic.proto.Data
+import org.meshtastic.proto.DeviceMetrics
 import org.meshtastic.proto.EnvironmentMetrics
 import org.meshtastic.proto.FromRadio
+import org.meshtastic.proto.LocalStats
 import org.meshtastic.proto.MeshPacket
 import org.meshtastic.proto.PortNum
 import org.meshtastic.proto.Telemetry
@@ -144,4 +146,73 @@ abstract class CommonMeshLogRepositoryTest {
         val logs = repository.getAllLogsUnbounded().first()
         assertTrue(logs.isEmpty())
     }
+
+    @Test
+    fun `deleteLocalStatsLogs deletes only local stats telemetry`() = runTest(testDispatcher) {
+        val nodeNum = 1234
+        val localStatsLog =
+            telemetryLog(
+                uuid = "local-stats",
+                nodeNum = nodeNum,
+                telemetry = Telemetry(local_stats = LocalStats(noise_floor = -112)),
+                receivedDate = nowMillis + 3,
+            )
+        val deviceLog =
+            telemetryLog(
+                uuid = "device",
+                nodeNum = nodeNum,
+                telemetry = Telemetry(device_metrics = DeviceMetrics(battery_level = 80)),
+                receivedDate = nowMillis + 2,
+            )
+        val environmentLog =
+            telemetryLog(
+                uuid = "environment",
+                nodeNum = nodeNum,
+                telemetry = Telemetry(environment_metrics = EnvironmentMetrics(temperature = 21f)),
+                receivedDate = nowMillis + 1,
+            )
+        val localStatsRequestLog =
+            telemetryLog(
+                uuid = "local-stats-request",
+                nodeNum = nodeNum,
+                telemetry = Telemetry(local_stats = LocalStats()),
+                receivedDate = nowMillis,
+                wantResponse = true,
+            )
+
+        listOf(localStatsLog, deviceLog, environmentLog, localStatsRequestLog).forEach { repository.insert(it) }
+
+        repository.deleteLocalStatsLogs(nodeNum)
+
+        val remainingIds = repository.getAllLogsUnbounded().first().map { it.uuid }.toSet()
+        assertEquals(setOf("device", "environment", "local-stats-request"), remainingIds)
+    }
+
+    private fun telemetryLog(
+        uuid: String,
+        nodeNum: Int,
+        telemetry: Telemetry,
+        receivedDate: Long,
+        wantResponse: Boolean = false,
+    ) = MeshLog(
+        uuid = uuid,
+        message_type = "telemetry",
+        received_date = receivedDate,
+        raw_message = "",
+        fromNum = nodeNum,
+        portNum = PortNum.TELEMETRY_APP.value,
+        fromRadio =
+        FromRadio(
+            packet =
+            MeshPacket(
+                from = nodeNum,
+                decoded =
+                Data(
+                    payload = telemetry.encode().toByteString(),
+                    portnum = PortNum.TELEMETRY_APP,
+                    want_response = wantResponse,
+                ),
+            ),
+        ),
+    )
 }

core/data/src/commonTest/kotlin/org/meshtastic/core/data/repository/CommonMeshLogRepositoryTest.kt

@@ -53,6 +53,9 @@ interface MeshLogDao {
     @Query("DELETE FROM log WHERE uuid = :uuid")
     suspend fun deleteLog(uuid: String)
 
+    @Query("DELETE FROM log WHERE uuid IN (:uuids)")
+    suspend fun deleteLogsByUuid(uuids: List<String>)
+
     @Query("DELETE FROM log WHERE from_num = :fromNum AND port_num = :portNum")
     suspend fun deleteLogs(fromNum: Int, portNum: Int)
 

core/database/src/commonMain/kotlin/org/meshtastic/core/database/dao/MeshLogDao.kt

@@ -73,6 +73,9 @@ interface MeshLogRepository {
     /** Deletes all logs associated with a specific [nodeNum] and [portNum]. */
     suspend fun deleteLogs(nodeNum: Int, portNum: Int)
 
+    /** Deletes only local stats telemetry logs for [nodeNum], preserving other telemetry logs. */
+    suspend fun deleteLocalStatsLogs(nodeNum: Int)
+
     /** Prunes the log database based on the configured [retentionDays]. */
     suspend fun deleteLogsOlderThan(retentionDays: Int)
 

core/repository/src/commonMain/kotlin/org/meshtastic/core/repository/MeshLogRepository.kt

@@ -137,6 +137,7 @@
     <string name="bold_heading">Bold Heading</string>
     <string name="bottom_nav_settings">Settings</string>
     <string name="broadcast_interval">Broadcast Interval</string>
+    <string name="busy_noise_floor">Busy floor</string>
     <string name="button_gpio">Button GPIO</string>
     <string name="buzzer_gpio">Buzzer GPIO</string>
     <string name="calculating">Calculating…</string>
@@ -1008,6 +1009,9 @@
     <string name="nodes_empty_searching_hint">Nearby nodes will appear here as they're discovered.</string>
     <string name="nodes_empty_searching_title">Searching for nodes</string>
     <string name="nodes_queued_for_deletion">%1$d nodes queued for deletion:</string>
+    <string name="noise_floor">Noise Floor</string>
+    <string name="noise_floor_definition">The background RF noise measured by the radio receiver. Lower values usually indicate a quieter receiver environment; -85 dBm is a busy reference point, not a hard failure threshold.</string>
+    <string name="noise_floor_no_reading">Noise Floor: No reading</string>
     <string name="none">None (disable)</string>
     <string name="none_quality">None</string>
     <string name="not_connected">Not connected</string>
@@ -1193,6 +1197,7 @@
     <string name="request_device_metrics">Device Metrics</string>
     <string name="request_environment_metrics">Environment Metrics</string>
     <string name="request_host_metrics">Host Metrics</string>
+    <string name="request_local_stats">Local Stats</string>
     <string name="request_metadata">Metadata</string>
     <string name="request_pax_metrics">Pax Metrics</string>
     <string name="request_power_metrics">Power Metrics</string>
@@ -1244,6 +1249,7 @@
     <string name="routing_error_timeout">Timeout</string>
     <string name="routing_error_too_large">Packet too large</string>
     <string name="rssi">RSSI</string>
+    <string name="rssi_definition">Received Signal Strength Indicator, a measurement used to determine the power level being received by the antenna. A higher RSSI value generally indicates a stronger and more stable connection.</string>
     <string name="rsyslog_server">rsyslog server</string>
     <string name="sample_message" translatable="false">hey I found the cache, it is over here next to the big tiger. I'm kinda scared.</string>
     <string name="sats">Sats</string>
@@ -1338,6 +1344,7 @@
     <string name="slot">Slot</string>
     <string name="smart_position">Smart Position</string>
     <string name="snr">SNR</string>
+    <string name="snr_definition">Signal-to-Noise Ratio, a measure used in communications to quantify the level of a desired signal to the level of background noise. In Meshtastic and other wireless systems, a higher SNR indicates a clearer signal that can enhance the reliability and quality of data transmission.</string>
     <string name="soil_moisture">Soil Moist</string>
     <string name="soil_temperature">Soil Temp</string>
     <string name="speed">Speed</string>
@@ -1576,4 +1583,3 @@
     <string name="zh_CN" translatable="false">简体中文</string>
     <string name="zh_TW" translatable="false">繁體中文</string>
 </resources>
-

core/resources/src/commonMain/composeResources/values/strings.xml

@@ -41,10 +41,14 @@ class FakeMeshLogRepository :
     var deleteAllCalled = false
         private set
 
+    var lastDeletedLocalStatsNodeNum: Int? = null
+        private set
+
     override fun reset() {
         super.reset()
         lastDeletedOlderThan = null
         deleteAllCalled = false
+        lastDeletedLocalStatsNodeNum = null
     }
 
     override fun getAllLogs(maxItem: Int): Flow<List<MeshLog>> = logsFlow.map { it.take(maxItem) }
@@ -82,11 +86,26 @@ class FakeMeshLogRepository :
         logsFlow.value = logsFlow.value.filterNot { it.fromNum == nodeNum && it.portNum == portNum }
     }
 
+    override suspend fun deleteLocalStatsLogs(nodeNum: Int) {
+        lastDeletedLocalStatsNodeNum = nodeNum
+        logsFlow.value =
+            logsFlow.value.filterNot { log ->
+                log.fromNum == nodeNum && log.portNum == PortNum.TELEMETRY_APP.value && log.hasLocalStatsTelemetry()
+            }
+    }
+
     override suspend fun deleteLogsOlderThan(retentionDays: Int) {
         lastDeletedOlderThan = retentionDays
     }
 
     fun setLogs(logs: List<MeshLog>) {
         logsFlow.value = logs
     }
+
+    private fun MeshLog.hasLocalStatsTelemetry(): Boolean = runCatching {
+        val decoded = fromRadio.packet?.decoded ?: return false
+        if (decoded.want_response == true) return false
+        Telemetry.ADAPTER.decode(decoded.payload).local_stats != null
+    }
+        .getOrDefault(false)
 }

core/testing/src/commonMain/kotlin/org/meshtastic/core/testing/FakeMeshLogRepository.kt

@@ -2,7 +2,7 @@
 title: Node Metrics
 parent: User Guide
 nav_order: 5
-last_updated: 2026-06-11
+last_updated: 2026-06-16
 description: Telemetry dashboards for each mesh node — device health, environment sensors, air quality, signal quality, power, traceroute, and position history.
 aliases:
   - metrics
@@ -87,6 +87,7 @@ Radio signal quality information:
 |--------|-------------|
 | SNR | Signal-to-Noise Ratio (higher is better) |
 | RSSI | Received Signal Strength Indicator (closer to 0 is better) |
+| Noise Floor | Local background RF noise in dBm (more negative is quieter) |
 | Hop Count | Number of mesh hops for last message |
 
 ### Signal Quality Reference
@@ -98,6 +99,8 @@ Radio signal quality information:
 | -10 to 0 dB | Fair |
 | < -10 dB | Poor |
 
+Local Stats from your connected radio are also shown in Signal Quality when available. These logs include noise floor, traffic counters, relay counters, online node counts, and radio uptime. The noise floor chart uses a dashed reference line at -85 dBm to help identify a busy RF environment. Use **Request** to ask the connected radio for a fresh Local Stats telemetry report, **Clear** to remove Local Stats logs for that node, and **Save** to export the visible Local Stats history as CSV.
+
 ## Power Metrics
 
 Power management telemetry (requires INA sensor or compatible hardware):
@@ -159,4 +162,3 @@ The position tab shows location data for nodes that share GPS:
 - [Units & Locale](units-and-locale) — temperature, distance, and speed display formats
 
 ---
-

docs/en/user/node-metrics.md

@@ -136,6 +136,28 @@ fun TelemetricActionsSectionEmptyPreview() {
     }
 }
 
+@PreviewLightDark
+@Suppress("PreviewPublic")
+@Composable
+fun TelemetricActionsSectionLocalPreview() {
+    val node = previewData.mickeyMouse
+    AppTheme {
+        Surface {
+            TelemetricActionsSection(
+                node = node,
+                ourNode = node,
+                availableLogs = emptySet(),
+                lastTracerouteTime = null,
+                lastRequestNeighborsTime = null,
+                displayUnits = Config.DisplayConfig.DisplayUnits.METRIC,
+                isFahrenheit = false,
+                onAction = {},
+                isLocal = true,
+            )
+        }
+    }
+}
+
 // ---------------------------------------------------------------------------
 // PositionInlineContent preview
 // ---------------------------------------------------------------------------

feature/node/src/commonMain/kotlin/org/meshtastic/feature/node/component/NodeDetailComponentPreviews.kt

@@ -159,7 +159,6 @@ private fun rememberTelemetricFeatures(
                 icon = LogsType.SIGNAL.icon,
                 requestAction = { NodeMenuAction.RequestTelemetry(it, TelemetryType.LOCAL_STATS) },
                 logsType = LogsType.SIGNAL,
-                isVisible = { !isLocal },
             ),
             TelemetricFeature(
                 titleRes = LogsType.DEVICE.titleRes,