core-common/org.meshtastic.core.common.util/MetricFormatter

MetricFormatter

Centralized metric formatting for display strings. Eliminates duplicated formatString patterns across Node, NodeItem, and metric screens.

All methods return locale-independent strings using NumberFormatter (dot decimal separator), which is intentional for a mesh networking app where consistency matters.

Functions

current

fun current(milliAmps: Float, decimalPlaces: Int = 1): String

humidity

fun humidity(value: Float): String

percent

fun percent(value: Int): String

fun percent(value: Float, decimalPlaces: Int = 1): String

pressure

fun pressure(hPa: Float, decimalPlaces: Int = 1): String

rainfall

fun rainfall(millimeters: Float, isImperial: Boolean, decimalPlaces: Int = 1): String

rssi

fun rssi(value: Int?): String

Formats a received signal strength, or UNKNOWN_VALUE when the radio reported none. 0 dBm is a legitimate reading on some radios, so it must never stand in for a missing one.

snr

fun snr(value: Float?, decimalPlaces: Int = 1): String

Formats a signal-to-noise ratio, or UNKNOWN_VALUE when the packet carried no measurement. 0 dB is a legitimate reading, so it must never stand in for a missing one.

temperature

fun temperature(celsius: Float, isFahrenheit: Boolean): String

voltage

fun voltage(volts: Float, decimalPlaces: Int = 2): String

weight

fun weight(kilograms: Float, isImperial: Boolean, decimalPlaces: Int = 2): String

windSpeed

fun windSpeed(metersPerSecond: Float, isImperial: Boolean, decimalPlaces: Int = 1): String