Memfault BORT SDK 5.5.0 (Build 3483284)

Author: Memfault Inc.

CHANGELOG.md

@@ -6,6 +6,184 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 This project currently does not attempt to adhere to Semantic Versioning, but
 breaking changes are avoided unless absolutely necessary.
 
+## v5.5.0 - November 18, 2025
+
+### :rocket: New Features
+
+- Added ability to ignore common WTF patterns. These were chosen across multiple
+  projects based off of WTF volume and usefulness. Ignoring these will make the
+  WTFs that do show up more useful. In addition, introduces new SDK settings to
+  control whether these patterns are used, and to add additional WTF ignore
+  patterns.
+  - The default ignored patterns are:
+    - "No service published for: appwidget at
+      android.app.SystemServiceRegistry.onServiceNotFound.\*"
+    - "EXTRA_USER_HANDLE missing or invalid, value=0.\*"
+    - "Failed to read field SystemLocale.\*"
+    - "BUG: NetworkAgentInfo.\*"
+    - "Attempt to decrement existing alarm count 0 by 1 for uid 1000.\*"
+    - "Removed TIME_TICK alarm.\*"
+    - "requesting nits when no mapping exists.\*"
+    - "Could not open /sys/kernel/tracing/instances/bootreceiver/trace_pipe.\*"
+- Added Bluetooth quality metrics.
+  - `bluetooth.ble_scan_result.count` tracks the number of BLE devices found in
+    each scan
+  - `bluetooth.ble_scan_result.attribution` tracks the initiator of the BLE scan
+  - `bluetooth.device_rssi.(min|mean|max)` tracks the Bluetooth RSSI
+    distribution
+  - `bluetooth.device_rssi.device_id.latest` tracks the Bluetooth device
+    reporting the RSSI value
+  - `bluetooth.device_tx_power_level.(min|mean|max)` tracks the Bluetooth TX
+    power level distribution
+  - `bluetooth.device_tx_power_level.device_id` tracks the Bluetooth device
+    reporting the TX power level value
+  - `bluetooth.quality_report.rssi.(min|mean|max)` tracks the Bluetooth RSSI
+    distribution reported by the Bluetooth quality report (if available)
+  - `bluetooth.quality_report.snr.(min|mean|max)` tracks the Bluetooth SNR
+    distribution reported by the Bluetooth quality report (if available)
+  - `bluetooth.quality_report.retransmission_count.(mean|max|sum)` tracks the
+    number of retransmissions reported by the Bluetooth quality report (if
+    available).
+  - `bluetooth.quality_report.reported.latest` reports the latest Bluetooth
+    quality report.
+- Added heartbeat metrics for any batterystats metrics that were previously only
+  used in HRT.
+  - camera
+    - `camera_on_ratio`
+  - video
+    - `video_on_ratio`
+  - flashlight
+    - `flashlight_on_ratio`
+  - bluetooth
+    - `bluetooth_on_ratio`
+  - usb_data
+    - `usb_data_on_ratio`
+  - wake_lock
+    - `wake_lock_on_ratio`
+  - wifi_full_lock
+    - `wifi_full_lock_ratio`
+  - long_wake_lock
+    - `long_wake_lock_on_ratio`
+  - screen_wake
+    - `screen_wake_count`
+  - package_install
+    - `package_install_count`
+  - phone_connection
+    - `phone_connection_latest`
+  - phone_in_call
+    - `phone_in_call_ratio`
+  - phone_state
+    - `phone_state_in_ratio`
+    - `phone_state_out_ratio`
+    - `phone_state_em_ratio`
+  - cellular_high_tx_power
+    - `cellular_high_tx_power_on_ratio`
+  - nr_state
+    - `nr_state_none_ratio`
+    - `nr_state_restricted_ratio`
+    - `nr_state_not_restricted_ratio`
+    - `nr_state_connected_ratio`
+- Added support for reporting USB contaminant events.
+  - `usb.contaminant_reported.latest`
+- Updated existing network metrics to generate a heartbeat metric as well.
+  - `connectivity.airplane_mode.latest`
+  - `connectivity.internet.latest`
+  - `connectivity.validated.latest`
+  - `connectivity.captive_portal.latest`
+  - `connectivity.roaming.latest`
+  - `connectivity.unmetered_temporarily.latest`
+- Added basic IPv4 and IPv6 connectivity metrics.
+  - `connectivity.ip_version.latest` with states "IPv4", "IPv6", "IPv4+IPv6",
+    "?"
+  - `connectivity.ipv4_status.latest` with states "Internet Available",
+    "Configuration Error", "Not Available"
+  - `connectivity.ipv6_status.latest` with states "Internet Available", "Local
+    Only", "Not Available"
+- Added Wi-Fi RSSI time-based moving average metric. This metric is calculated
+  from raw values obtained from WifiManager broadcasts using an exponential
+  moving average.
+  - `connectivity.wifi.rssi.moving_avg`
+- Added Wi-Fi roaming and channel hop counters.
+  - `connectivity.wifi.roaming_count` increments when connected to the same
+    configured network but the connected access point changed
+  - `connectivity.wifi.channel_hop_count` increments when connected to the same
+    network, but the channel changed
+- Added metric to distinguish between 2.4/5/6 GHz Wi-Fi frequency bands for
+  easier device identification.
+  - `connectivity.wifi.frequency`
+  - `connectivity.wifi.frequency_band`
+- Added count of scanned Wi-Fi networks metric from statsd.
+  - `connectivity.wifi.scan_network_count`
+  - `connectivity.wifi.scan_network_count.count`
+  - `connectivity.wifi.scan_network_count.mean`
+- Added low memory event reporting when low memory is reported by the System
+  Server.
+  - `memory.low_mem_reported`
+- Added slow I/O event metrics which contain a 24h count of the slow I/O events
+  of a given type.
+  - `disk.slow_io_(read|write|unmap|sync|unknown)_24h_count`
+- Added USB device attached/detached event reports. These will be reported when
+  USB devices are attached or detached and will contain the full list of
+  connected devices in each category.
+  - `usb.devices`
+  - `usb.accessories`
+- Added Wi-Fi OUI (Organizationally Unique Identifier) support. The OUI is
+  queried via the Dumpster service using `dumpsys wifi`. Memfault will
+  automatically calculate the manufacturer of the device based off of its OUI.
+  - `connectivity.wifi.ap_oui`
+- Added Wi-Fi disconnected session metric. The event contains the disconnect
+  reason, time connected, last RSSI and link speed as well as channel. These
+  metrics are available in Android 12+.
+  - `wifi_disconnect_session`
+    - `wifi.frequency-band-bucket`
+    - `wifi.frequency-band`
+    - `wifi.failure-code-name`
+    - `wifi.failure-code`
+    - `wifi.last-rssi`
+    - `wifi.last-link-speed`
+- Added low memory kill event reporting when applications are killed by the
+  system due to low memory.
+  - `memory.lmk_kill_occurred`
+
+### :construction: Fixes
+
+- Coalesced consecutive logcat "switch to" separators. This should reduce the
+  spam where multiple log lines in a row are just buffer switches.
+- Fixed incorrect session end time. The session end will now be recorded when
+  end is called, instead of at the heartbeat collection time.
+- Cleaned up continuous logcat "switch to" buffer logs to always append a
+  newline. This avoids the "switch to" lines intermixing with normal output.
+- Fixed invalid boot id parsing in Bort Lite. Returns a zero'd UUID instead of
+  "unknown" for the Linux boot id. Also, falls back to "reboot,permissiondenied"
+  instead of "reboot,bort_unknown" for better clarity.
+- Fixed potential memory leak in UsageReporter found by LeakCanary.
+- Fixed session deadlock when the sessions rate limit is hit.
+- Increased rate limit defaults.
+  - The Sessions rate limit was thought to be 125 every day, but ended up being
+    125, and then 1 back every day due to the token bucket algorithm.
+  - Similarly, the mar_file/client server mar file rate limit implied 500 files
+    per hour but ended up being 24 a day once the limit was hit.
+- Ignored potential Room database migration failures. Fallback to destructive
+  migration if the database migration fails on downgrade.
+
+### :chart_with_upwards_trend: Improvements
+
+- Bumped to reporting library 1.6.0.
+- Added support for Gradle testFixtures.
+- Changed Android Studio default project. Load the project root in Android
+  Studio instead of `MemfaultPackages/`. `MemfaultDumpstateRunner`,
+  `MemfaultDumpster`, and `MemfaultStructuredLogd` will now be visible in the
+  IDE.
+- Updated MAR unspooling to use new `data_upload_start_date` device config
+  variable to control what data should be uploaded.
+- Added leakcanary to the Bort, OTA, and Reporter apps to check for leaks.
+- Enabled Android lint.
+- Deleted `log_buffer_expired` counter metric. This was too spammy.
+
+### :house: Internal
+
+- Fixed MetricsIntegrationTest race condition.
+
 ## v5.4.2 - August 4, 2025
 
 ### :construction: Fixes

MemfaultDumpster/ContinuousLogcat.cpp

@@ -19,19 +19,14 @@
 #include <utils/String8.h>
 #include <utils/String16.h>
 #include <utils/SystemClock.h>
-#include <reporting.h>
 
 namespace memfault {
 
-static constexpr char kLogBufferExpiredCounterName[] = "log_buffer_expired_counter";
-
 ContinuousLogcat::ContinuousLogcat() :
     logger_list(nullptr, android_logger_list_close),
     log_format(nullptr, android_log_format_free),
     total_bytes_written(0),
     last_collection_uptime_ms(android::uptimeMillis()) {
-  report_ = std::make_unique<Report>();
-  log_buffer_expired_counter_ = report_->counter(kLogBufferExpiredCounterName);
   // Compute the list of buffers we want to read from. Buffers
   // may vary between platform versions we use the liblog API
   // to match names to buffer ids.
@@ -277,7 +272,6 @@ void ContinuousLogcat::run() {
 
       if ((log_mode & ANDROID_LOG_WRAP) && !expiry_reported) {
         expiry_reported = true;
-        log_buffer_expired_counter_->increment();
       }
 
       AndroidLogEntry entry;
@@ -345,13 +339,24 @@ void ContinuousLogcat::run() {
           snprintf(buf, sizeof(buf), "--------- %s %s\n",
               hasPrinted ? "switch to" : "beginning of", name->second);
           auto len = strlen(buf);
+#if PLATFORM_SDK_VERSION <= 32
           if (write(output_fd, buf, len) >= 0) {
             total_bytes_written += len;
             last_printed_log_id = log_id;
             fsync(output_fd);
           } else {
             ALOGW("Failed to write separator to continuous log output");
           }
+#else
+          if (fwrite(buf, 1, len, output_fp) == len) {
+            total_bytes_written += len;
+            last_printed_log_id = log_id;
+            fflush(output_fp);
+            fsync(output_fd);
+          } else {
+            ALOGW("Failed to write separator to continuous log output");
+          }
+#endif
         }
       }
 

MemfaultDumpster/ContinuousLogcat.h

@@ -13,7 +13,6 @@
 #include <log/log_time.h>
 #include <log/log_id.h>
 #include <utils/String16.h>
-#include <reporting.h>
 
 #define CONTINUOUS_LOGCAT_TAG "memfault_clog"
 #define CONTINUOUS_LOGCAT_FILE "/data/system/MemfaultDumpster/clog"
@@ -111,9 +110,6 @@ class ContinuousLogcat {
     FILE *output_fp;
     ContinuousLogcatConfig config;
 
-    std::unique_ptr<Report> report_;
-    std::unique_ptr<Counter> log_buffer_expired_counter_;
-
     std::unique_ptr<EventTagMap, decltype(&android_closeEventTagMap)> event_tag_map_{
             nullptr, &android_closeEventTagMap};
     bool has_opened_event_tag_map_ = false;

MemfaultPackages/bort-ota-lib/src/main/java/com/memfault/bort/ota/lib/OtaAppModule.kt

@@ -3,14 +3,12 @@ package com.memfault.bort.ota
 import android.app.Application
 import android.content.Context
 import android.content.SharedPreferences
-import com.memfault.bort.BasicCommandTimeout
 import com.memfault.bort.ota.lib.ABUpdateActionHandler
 import com.memfault.bort.ota.lib.DEFAULT_STATE_PREFERENCE_FILE
 import com.memfault.bort.ota.lib.IsAbDevice
 import com.memfault.bort.ota.lib.RecoveryBasedUpdateActionHandler
 import com.memfault.bort.ota.lib.SoftwareUpdateSettingsProvider
 import com.memfault.bort.ota.lib.UpdateActionHandler
-import com.memfault.bort.shared.BASIC_COMMAND_TIMEOUT_MS
 import com.memfault.cloud.sdk.MemfaultCloud
 import dagger.Lazy
 import dagger.Module
@@ -25,10 +23,6 @@ class OtaAppModule {
     fun updaterSharedPreferences(application: Application): SharedPreferences =
         application.getSharedPreferences(DEFAULT_STATE_PREFERENCE_FILE, Context.MODE_PRIVATE)
 
-    @Provides
-    @BasicCommandTimeout
-    fun basicTimeout(): Long = BASIC_COMMAND_TIMEOUT_MS
-
     @Provides
     fun createDefaultActionHandlerFactory(
         isAbDevice: IsAbDevice,

MemfaultPackages/bort-ota/build.gradle

@@ -49,6 +49,8 @@ dependencies {
     api project(':bort-ota-lib')
     api project(':bort-shared')
 
+    debugImplementation deps.leakcanary
+
     implementation deps.android.activity
     implementation deps.android.appcompat
     implementation deps.android.fragment

MemfaultPackages/bort-shared/src/debug/java/com/memfault/bort/DebugConfigureStrictMode.kt

@@ -2,7 +2,6 @@ package com.memfault.bort
 
 import android.os.Build
 import android.os.StrictMode
-import com.memfault.bort.scopes.ForScope
 import com.memfault.bort.scopes.Scope
 import com.memfault.bort.scopes.Scoped
 import com.memfault.bort.scopes.Scoped.ScopedPriority
@@ -12,7 +11,6 @@ import dagger.hilt.components.SingletonComponent
 import java.util.concurrent.Executors
 import javax.inject.Inject
 
-@ForScope(SingletonComponent::class)
 @ContributesMultibinding(SingletonComponent::class)
 class DebugConfigureStrictMode
 @Inject constructor() : Scoped {

MemfaultPackages/bort-shared/src/main/java/com/memfault/bort/android/BroadcastReceivers.kt

@@ -8,7 +8,7 @@ import kotlinx.coroutines.channels.awaitClose
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.callbackFlow
 
-suspend fun Context.registerForIntents(
+fun Context.registerForIntents(
     vararg actions: String,
     sticky: Boolean = false,
 ): Flow<Intent> {

MemfaultPackages/bort-shared/src/main/java/com/memfault/bort/android/ConnectivityManagers.kt

@@ -2,6 +2,7 @@ package com.memfault.bort.android
 
 import android.annotation.SuppressLint
 import android.net.ConnectivityManager
+import android.net.LinkProperties
 import android.net.Network
 import android.net.NetworkCapabilities
 import kotlinx.coroutines.channels.awaitClose
@@ -15,6 +16,10 @@ sealed class NetworkCallbackEvent {
         val network: Network,
         val networkCapabilities: NetworkCapabilities,
     ) : NetworkCallbackEvent()
+    data class OnLinkPropertiesChanged(
+        val network: Network,
+        val linkProperties: LinkProperties,
+    ) : NetworkCallbackEvent()
 }
 
 /**
@@ -38,6 +43,10 @@ suspend fun ConnectivityManager.registerForDefaultNetworkCallback(): Flow<Networ
         ) {
             trySend(NetworkCallbackEvent.OnCapabilitiesChanged(network, networkCapabilities))
         }
+
+        override fun onLinkPropertiesChanged(network: Network, linkProperties: LinkProperties) {
+            trySend(NetworkCallbackEvent.OnLinkPropertiesChanged(network, linkProperties))
+        }
     }
 
     registerDefaultNetworkCallback(callback)

MemfaultPackages/bort-shared/src/main/java/com/memfault/bort/android/SharedAndroidModule.kt

@@ -13,9 +13,11 @@ import android.net.wifi.WifiManager
 import android.os.BatteryManager
 import android.os.DropBoxManager
 import android.os.Looper
+import com.memfault.bort.BasicCommandTimeout
 import com.memfault.bort.Default
 import com.memfault.bort.IO
 import com.memfault.bort.Main
+import com.memfault.bort.shared.BASIC_COMMAND_TIMEOUT_MS
 import com.squareup.anvil.annotations.ContributesTo
 import dagger.Module
 import dagger.Provides
@@ -85,4 +87,8 @@ class SharedAndroidModule {
     @Provides
     fun usageStatsManager(application: Application): UsageStatsManager =
         application.getSystemService(UsageStatsManager::class.java)
+
+    @Provides
+    @BasicCommandTimeout
+    fun basicTimeout(): Long = BASIC_COMMAND_TIMEOUT_MS
 }