RF Sentinel (RFSentinel): free, open-source police detector app for Android. Spots police body cams, Flock ALPR cameras, AirTag trackers, Remote ID drones, smart glasses and fake cell towers from Bluetooth LE and WiFi. No root.
Kotlin airtagalprandroidandroid-autoanti-surveillancebluetooth-low-energybody-cameracounter-surveillancedrone-detectionflock-safetyimsi-catcher-detectorpolice-detectorpolice-scannerprivacyremote-idrtl-sdrsdrsurveillance-detectiontracker-detectionwifi
USB WiFi: back off on a burst of empty USB transfers; MT7612U says when it came up uncalibrated
CIS-C01aca2af2d4e6
diff --git a/app/src/main/java/com/rfsentinel/app/usb/BulkRx.kt b/app/src/main/java/com/rfsentinel/app/usb/BulkRx.ktindex e4e72ca..07abd0e 100644--- a/app/src/main/java/com/rfsentinel/app/usb/BulkRx.kt+++ b/app/src/main/java/com/rfsentinel/app/usb/BulkRx.kt@@ -34,6 +34,7 @@ internal object BulkRx {}UsbWifi.log("$tag: async RX live - $count buffers in flight")val scratch = ByteArray(size)+ val guard = EmptyGuard(tag)var total = 0Ltry {while (!stopped()) {@@ -53,7 +54,7 @@ internal object BulkRx {if (runCatching { nr.queue(b) }.getOrDefault(false)) reqs[idx] = nr}}- if (n in 1..size) { total += n; runCatching { onData(scratch, n) } }+ if (n in 1..size) { total += n; guard.data(); runCatching { onData(scratch, n) } } else guard.empty()}}onTick(System.currentTimeMillis())@@ -76,6 +77,35 @@ internal object BulkRx {return total}+ /**+ * Guards an async receive loop against a burst of empty completions (after Wardrive Go): with+ * a loose connector or a stalled endpoint every queued transfer can come straight back empty,+ * and the loop then spins flat out. After [BURST] in a row it logs once and pauses briefly+ * before each next one until data flows again; the drivers' own watchdogs restart the radio.+ * Used from the RX thread only.+ */+ class EmptyGuard(private val tag: String) {+ private var run = 0+ private var logged = 0++ fun data() {+ if (run >= BURST && logged <= MAX_LOGS) UsbWifi.log("$tag: data flowing again after $run empty USB transfers")+ run = 0+ }++ fun empty() {+ if (++run == BURST && ++logged <= MAX_LOGS)+ UsbWifi.log("$tag: $BURST empty USB transfers in a row (loose connection or stalled endpoint?) - backing off")+ if (run >= BURST) try { Thread.sleep(PAUSE_MS) } catch (_: InterruptedException) {}+ }++ companion object {+ const val BURST = 500+ private const val PAUSE_MS = 20L+ private const val MAX_LOGS = 5+ }+ }+/*** Receive counters for the driver log, so a tester's exported log shows what arrived,* what was thrown away and the signal range. Only descriptor bytes are ever logged,diff --git a/app/src/main/java/com/rfsentinel/app/usb/Mt7612uMonitor.kt b/app/src/main/java/com/rfsentinel/app/usb/Mt7612uMonitor.ktindex 34ad864..dfd09ff 100644--- a/app/src/main/java/com/rfsentinel/app/usb/Mt7612uMonitor.kt+++ b/app/src/main/java/com/rfsentinel/app/usb/Mt7612uMonitor.kt@@ -84,6 +84,7 @@ object Mt7612uMonitor {private const val AUTO_RSP_NO_RESPONDER = 0x12private const val MIN_FRAME = 10; private const val MAX_BAD_LOGS = 12; private const val DEAF_MS = 15_000L+ private const val UNCALIBRATED = " · not calibrated: unplug the adapter and plug it back in"private const val FW_ATTEMPTS = 3; private const val CLAIM_WAITS = 10private const val DMA_HDR = 4; private const val RXWI_LEN = 32; private const val FCE_INFO = 4/** Room for the largest 802.11ac MPDU (11454 B) plus descriptors: a smaller buffer splits big frames over two transfers. */@@ -106,6 +107,14 @@ object Mt7612uMonitor {private var epResp: UsbEndpoint? = nullprivate var seq = 0private var mcuLogged = 0+ /**+ * MCU commands that wait for an answer, and how many got one. None answered at bring-up: the+ * adapter kept power through a USB self-reset and its firmware lost track of the endpoints, so+ * calibration never applied. Frames may still arrive, but only a replug fully resets it.+ */+ private var mcuAsked = 0+ private var mcuAnswered = 0+ @Volatile private var uncalibrated = falseprivate var mcuGain = 0private var rssiOff2g = 0; private var rssiOff5g = 0; private var lna2g = 0; private var lna5g = 0/** Chain 1's RSSI offsets (the EEPROM words' high bytes, as mt76x2_read_rx_gain reads them). */@@ -118,7 +127,7 @@ object Mt7612uMonitor {fun run(ctx: Context, device: UsbDevice, chipName: String, onStatus: (String) -> Unit,onFrame: (List<MonitorSighting>) -> Unit) {if (running) return- running = true; stop = false; frames.clear(); lastCalMs.clear(); mcuLogged = 0; ctlErrors = 0+ running = true; stop = false; frames.clear(); lastCalMs.clear(); mcuLogged = 0; ctlErrors = 0; mcuAsked = 0; mcuAnswered = 0; uncalibrated = falseval mgr = ctx.getSystemService(Context.USB_SERVICE) as UsbManagerval c = mgr.openDevice(device) ?: run { onStatus("$chipName: couldn't reopen adapter"); running = false; return }conn = c@@ -202,7 +211,10 @@ object Mt7612uMonitor {UsbWifi.log("MT7612U: started in %d ms - SYS_CTRL 0x%08x STATUS 0x%08x U3DMA 0x%08x RX_FILTR 0x%08x AUTO_RSP 0x%08x AGC0 0x%08x, USB errors %d - monitor live ch %d".format(System.currentTimeMillis() - t0, regRd(MAC_SYS_CTRL), regRd(MAC_STATUS), cfgRd(USB_U3DMA_CFG), regRd(RX_FILTR_CFG),regRd(AUTO_RSP_CFG), regRd(BBP_AGC0), ctlErrors, HOP[0]))- onStatus("$chipName · live · 2.4 + 5 GHz monitor")+ uncalibrated = mcuAsked >= 3 && mcuAnswered == 0+ if (uncalibrated) UsbWifi.log("MT7612U: none of $mcuAsked MCU commands answered - the adapter kept power through a USB reset, " ++ "so calibration didn't apply. Unplug the adapter and plug it back in.")+ onStatus("$chipName · live · 2.4 + 5 GHz monitor" + UNCALIBRATED.takeIf { uncalibrated }.orEmpty())rxLoop(chipName, cmdOut, rx, onFrame, onStatus)} catch (e: Exception) {UsbWifi.log("MT7612U: bring-up error - ${UsbWifi.describe(e)}")@@ -442,6 +454,7 @@ object Mt7612uMonitor {val rep = epResp ?: run { sleep(10); return }val rb = ByteArray(512)val n = conn.bulkTransfer(rep, rb, rb.size, 300)+ mcuAsked++; if (n > 0) mcuAnswered++if (mcuLogged < 6) {mcuLogged++UsbWifi.log(if (n > 0) "MT7612U: MCU cmd $cmd answered ($n B, 0x%08x)".format(if (n >= 4) le32(rb, 0) else 0)@@ -522,7 +535,8 @@ object Mt7612uMonitor {runCatching { tune(epCmd, HOP[st.hopIdx], scan = true) }drainCmdResp()val (aps, clients) = frames.live(now, REPORT_MS)- onStatus("$chipName · live · $aps access points · $clients devices · ch ${HOP[st.hopIdx]}")+ onStatus("$chipName · live · $aps access points · $clients devices · ch ${HOP[st.hopIdx]}" ++ UNCALIBRATED.takeIf { uncalibrated }.orEmpty())st.hopAt = System.currentTimeMillis() // the dwell starts once the retune is done}}diff --git a/app/src/main/java/com/rfsentinel/app/usb/Rtl8812auMonitor.kt b/app/src/main/java/com/rfsentinel/app/usb/Rtl8812auMonitor.ktindex 9492e74..84e4c64 100644--- a/app/src/main/java/com/rfsentinel/app/usb/Rtl8812auMonitor.kt+++ b/app/src/main/java/com/rfsentinel/app/usb/Rtl8812auMonitor.kt@@ -294,6 +294,7 @@ object Rtl8812auMonitor {UsbWifi.log("RTL8812AU: async RX live — $nbuf buffers in flight")val scratch = ByteArray(bufSz)val st = RxState().apply { start() }+ val guard = BulkRx.EmptyGuard("RTL8812AU")try {while (!stop) {val req = try { conn.requestWait(100L) } catch (e: TimeoutException) { null }@@ -304,9 +305,9 @@ object Rtl8812auMonitor {val b = buffers[idx]val n = b.position()val parseLen = if (n in 1..bufSz) {- st.total += n; st.bufs+++ st.total += n; st.bufs++; guard.data()b.rewind(); b.get(scratch, 0, n); n- } else 0+ } else { guard.empty(); 0 }b.clear()if (!runCatching { req.queue(b) }.getOrDefault(false)) {diff --git a/app/src/main/java/com/rfsentinel/app/usb/Rtl8821auMonitor.kt b/app/src/main/java/com/rfsentinel/app/usb/Rtl8821auMonitor.ktindex a4dee86..db87729 100644--- a/app/src/main/java/com/rfsentinel/app/usb/Rtl8821auMonitor.kt+++ b/app/src/main/java/com/rfsentinel/app/usb/Rtl8821auMonitor.kt@@ -231,6 +231,7 @@ object Rtl8821auMonitor {UsbWifi.log("RTL8821AU: async RX live — $nbuf buffers in flight")val scratch = ByteArray(bufSz)val st = RxState().apply { start() }+ val guard = BulkRx.EmptyGuard("RTL8821AU")try {while (!stop) {val req = try { conn.requestWait(100L) } catch (e: TimeoutException) { null }@@ -241,9 +242,9 @@ object Rtl8821auMonitor {val b = buffers[idx]val n = b.position()val parseLen = if (n in 1..bufSz) {- st.total += n; st.bufs+++ st.total += n; st.bufs++; guard.data()b.rewind(); b.get(scratch, 0, n); n- } else 0+ } else { guard.empty(); 0 }b.clear()if (!runCatching { req.queue(b) }.getOrDefault(false)) {diff --git a/app/src/main/java/com/rfsentinel/app/usb/Rtl8822buMonitor.kt b/app/src/main/java/com/rfsentinel/app/usb/Rtl8822buMonitor.ktindex 2dd7e02..692eb02 100644--- a/app/src/main/java/com/rfsentinel/app/usb/Rtl8822buMonitor.kt+++ b/app/src/main/java/com/rfsentinel/app/usb/Rtl8822buMonitor.kt@@ -258,6 +258,7 @@ object Rtl8822buMonitor {} else {UsbWifi.log("$label: async RX live — $nbuf buffers in flight")val scratch = ByteArray(bufSz)+ val guard = BulkRx.EmptyGuard(label)try {while (!stop) {val req = try { conn.requestWait(100L) } catch (e: TimeoutException) { null }@@ -266,7 +267,7 @@ object Rtl8822buMonitor {if (idx in 0 until nbuf) {val b = buffers[idx]val n = b.position()- if (n in 1..bufSz) { st.total += n; st.bufs++; b.rewind(); b.get(scratch, 0, n) }+ if (n in 1..bufSz) { st.total += n; st.bufs++; guard.data(); b.rewind(); b.get(scratch, 0, n) } else guard.empty()b.clear()if (!runCatching { req.queue(b) }.getOrDefault(false)) {runCatching { req.close() }