feature-node/org.meshtastic.feature.node.metrics

Package-level declarations

Types

Utility object for chart styling and component creation. Provides reusable styled lines, points, and axes for Vico charts.

CommonCharts

object CommonCharts

Environment

enum Environment : Enum<Environment>

EnvironmentGraphingData

data class EnvironmentGraphingData(val metrics: List<Telemetry>, val shouldPlot: List<Boolean>, val leftMinMax: Pair<Float, Float> = Pair(0f, 0f), val rightMinMax: Pair<Float, Float> = Pair(0f, 0f), val times: Pair<Int, Int> = Pair(0, 0))

EnvironmentMetricsState

data class EnvironmentMetricsState(val environmentMetrics: List<Telemetry> = emptyList())

InfoDialogData

data class InfoDialogData(val titleRes: StringResource, val definitionRes: StringResource, val color: Color)

LegendData

data class LegendData(val nameRes: StringResource, val color: Color, val isLine: Boolean = false, val metricKey: Any? = null, val labelOverride: String? = null)

MetricsViewModel

open class MetricsViewModel(val destNum: Int, dispatchers: CoroutineDispatchers, meshLogRepository: MeshLogRepository, serviceRepository: ServiceRepository, nodeRepository: NodeRepository, tracerouteSnapshotRepository: TracerouteSnapshotRepository, nodeRequestActions: NodeRequestActions, alertManager: AlertManager, getNodeDetailsUseCase: GetNodeDetailsUseCase, fileService: FileService) : ViewModel

ViewModel responsible for managing and graphing metrics (telemetry, signal strength, paxcount) for a specific node.

Properties

BYTES_IN_GB

const val BYTES_IN_GB: Double

BYTES_IN_KB

const val BYTES_IN_KB: Double = 1024.0

BYTES_IN_MB

const val BYTES_IN_MB: Double

Functions

AdaptiveMetricLayout

@Composable

fun AdaptiveMetricLayout(chartPart: @Composable (Modifier) -> Unit, listPart: @Composable (Modifier) -> Unit, modifier: Modifier = Modifier, isChartExpanded: Boolean = false)

An adaptive layout for metric screens. Uses a split Row for wide screens (tablets/landscape) and a stacked Column for narrow screens (phones). When isChartExpanded is true, the card list is hidden and the chart fills the available space.

BaseMetricScreen

@Composable

fun <T> BaseMetricScreen(onNavigateUp: () -> Unit, telemetryType: TelemetryType?, titleRes: StringResource, nodeName: String, data: List<T>, timeProvider: (T) -> Double, infoData: List<InfoDialogData> = emptyList(), onRequestTelemetry: () -> Unit? = null, onExportCsv: () -> Unit? = null, extraActions: @Composable () -> Unit = {}, chartPart: @Composable (Modifier, Double?, VicoScrollState, (Double) -> Unit) -> Unit, listPart: @Composable (Modifier, Double?, LazyListState, (Double) -> Unit) -> Unit, controlPart: @Composable () -> Unit = {})

A high-level template for metric screens that handles the Scaffold, AppBar, adaptive layout, and chart-to-list synchronisation.

DeleteItem

@Composable

fun DeleteItem(onClick: () -> Unit)

DeviceMetricsScreen

@Composable

fun DeviceMetricsScreen(viewModel: MetricsViewModel, onNavigateUp: () -> Unit)

EnvironmentMetricsChart

@Composable

fun EnvironmentMetricsChart(modifier: Modifier = Modifier, telemetries: List<Telemetry>, graphData: EnvironmentGraphingData, vicoScrollState: VicoScrollState, selectedX: Double?, onPointSelected: (Double) -> Unit)

EnvironmentMetricsScreen

@Composable

fun EnvironmentMetricsScreen(viewModel: MetricsViewModel, onNavigateUp: () -> Unit)

formatBytes

fun formatBytes(bytes: Long, decimalPlaces: Int = 2): String

GenericMetricChart

@Composable

fun GenericMetricChart(modelProducer: CartesianChartModelProducer, layers: List<LineCartesianLayer>, modifier: Modifier = Modifier, startAxis: VerticalAxis<Axis.Position.Vertical.Start>? = null, endAxis: VerticalAxis<Axis.Position.Vertical.End>? = null, bottomAxis: HorizontalAxis<Axis.Position.Horizontal.Bottom>? = null, marker: CartesianMarker? = null, decorations: List<Decoration> = emptyList(), selectedX: Double? = null, onPointSelected: (Double) -> Unit? = null, vicoScrollState: VicoScrollState = rememberVicoScrollState())

A generic chart host for Meshtastic metric charts. Handles common boilerplate for markers, scrolling, and point selection synchronization.

HostMetricsLogScreen

@Composable

fun HostMetricsLogScreen(viewModel: MetricsViewModel, onNavigateUp: () -> Unit)

Full-screen host metrics log with chart and card list, built on BaseMetricScreen. Shows load averages and free memory over time with time-frame filtering, chart expand/collapse, and card-to-chart synchronisation.

Legend

@Composable

fun Legend(legendData: List<LegendData>, modifier: Modifier = Modifier, hiddenSet: Set<Int> = emptySet(), onToggle: (Int) -> Unit? = null)

Creates the legend that identifies the colors used for the graph.

LegendIndicator

@Composable

fun LegendIndicator(color: Color, isLine: Boolean = false)

Draws a small colored line segment or circle to identify a chart series.

LegendInfoDialog

@Composable

fun LegendInfoDialog(infoData: List<InfoDialogData>, onDismiss: () -> Unit)

Displays a dialog with information about the legend items.

LogLine

@Composable

fun LogLine(modifier: Modifier = Modifier, label: String, value: String)

MetricChartScaffold

@Composable

fun MetricChartScaffold(isEmpty: Boolean, legendData: List<LegendData>, modifier: Modifier = Modifier, hiddenSet: Set<Int> = emptySet(), onToggle: (Int) -> Unit? = null, content: @Composable ColumnScope.(CartesianChartModelProducer, Modifier) -> Unit)

Common scaffold for all metric chart composables. Provides:

MetricIndicator

@Composable

fun MetricIndicator(color: Color, modifier: Modifier = Modifier)

MetricLogItem

@Composable

fun MetricLogItem(icon: ImageVector, text: String, contentDescription: String, modifier: Modifier = Modifier)

Shared metric log/list UI components used by TracerouteLog, NeighborInfoLog, HostMetricsLog, and PositionLog.

MetricValueRow

@Composable

fun MetricValueRow(color: Color, text: String, modifier: Modifier = Modifier)

A compact row displaying a colored MetricIndicator dot/line followed by a text value.

NeighborInfoLogScreen

@Composable

fun NeighborInfoLogScreen(modifier: Modifier = Modifier, viewModel: MetricsViewModel, onNavigateUp: () -> Unit)

PaxcountInfo

@Composable

fun PaxcountInfo(pax: String, modifier: Modifier = Modifier, contentColor: Color = MaterialTheme.colorScheme.onSurface)

PaxMetricsItem

@Composable

fun PaxMetricsItem(log: MeshLog, pax: Paxcount, isSelected: Boolean, onClick: () -> Unit)

PaxMetricsScreen

@Composable

fun PaxMetricsScreen(metricsViewModel: MetricsViewModel, onNavigateUp: () -> Unit)

PositionCard

@Composable

fun PositionCard(position: Position, displayUnits: Config.DisplayConfig.DisplayUnits, isSelected: Boolean, onClick: () -> Unit)

A SelectableMetricCard-based position item that matches the visual style of DeviceMetricsCard, SignalMetricsCard, and other metric cards. Replaces the previous table-row layout with a card that shows timestamp, coordinates, satellites, altitude, speed, and heading.

PositionLogScreen

@Composable

fun PositionLogScreen(viewModel: MetricsViewModel, onNavigateUp: () -> Unit)

PowerMetricsScreen

@Composable

fun PowerMetricsScreen(viewModel: MetricsViewModel, onNavigateUp: () -> Unit)

rememberConditionalLayer

@Composable

fun rememberConditionalLayer(hasData: Boolean, lineProvider: LineCartesianLayer.LineProvider, verticalAxisPosition: Axis.Position.Vertical, rangeProvider: CartesianLayerRangeProvider? = null): LineCartesianLayer?

Creates a LineCartesianLayer only when hasData is true, returning null otherwise.

safeNumber

fun HardwareModel.safeNumber(fallbackValue: Int = -1): Int

Safely extracts the hardware model number from a HardwareModel enum.

SelectableMetricCard

@Composable

fun SelectableMetricCard(isSelected: Boolean, onClick: () -> Unit, modifier: Modifier = Modifier, content: @Composable () -> Unit)

A selectable Card for metric log items. Provides consistent selection styling (primary border + primaryContainer background) and text selection support across all metric screens.

SignalMetricsScreen

@Composable

fun SignalMetricsScreen(viewModel: MetricsViewModel, onNavigateUp: () -> Unit)

TimeFrameSelector

@Composable

fun TimeFrameSelector(selectedTimeFrame: TimeFrame, availableTimeFrames: List<TimeFrame>, onTimeFrameSelected: (TimeFrame) -> Unit, modifier: Modifier = Modifier)

TracerouteLogScreen

@Composable

fun TracerouteLogScreen(modifier: Modifier = Modifier, viewModel: MetricsViewModel, onNavigateUp: () -> Unit, onViewOnMap: (requestId: Int, responseLogUuid: String) -> Unit = { _, _ -> })

Full-screen traceroute log with chart and card list, built on BaseMetricScreen. Shows forward/return hops and round-trip duration over time. Supports time-frame filtering, chart expand/collapse, and card-to-chart synchronisation.

TracerouteMapScreen

@Composable

fun TracerouteMapScreen(metricsViewModel: MetricsViewModel, requestId: Int, logUuid: String? = null, onNavigateUp: () -> Unit)