Add "Show BLE bandwidth usage" option to developer settings
This commit is contained in:
1 parent
641e8e322e
commit
85508b87ca
10 files changed
+153
-2
No files matched your search
@@ -2243,6 +2243,7 @@ public class FaceclawBleCommunicator implements FaceclawBleListener, Runnable {
|
||||
return;
|
||||
}
|
||||
long ackedAtMs = SystemClock.elapsedRealtime();
|
||||
FaceclawBleManager.recordDisplayFrameSent();
|
||||
BleImageOptimizer.ImageUpdateStats stats = imageUpdateStats.remove(message.imageUpdateId);
|
||||
if (stats != null && stats.firstWriteStartedAtMs > 0) {
|
||||
emitFrameMetrics(stats.paintMs, (int) Math.max(0, ackedAtMs - stats.firstWriteStartedAtMs), stats.tileCount);
|
||||
|
||||
@@ -21,6 +21,7 @@ import java.util.UUID;
|
||||
import java.util.concurrent.ConcurrentHashMap;
|
||||
import java.util.concurrent.CountDownLatch;
|
||||
import java.util.concurrent.TimeUnit;
|
||||
import java.util.concurrent.atomic.AtomicLong;
|
||||
|
||||
@SuppressLint("MissingPermission")
|
||||
public class FaceclawBleManager {
|
||||
@@ -51,6 +52,23 @@ public class FaceclawBleManager {
|
||||
|
||||
private volatile FaceclawBleListener listener;
|
||||
|
||||
// Process-wide outbound-traffic totals, sampled by the phone UI's BLE
|
||||
// bandwidth indicator. Static so counts from every manager instance and
|
||||
// isolate land in the same totals.
|
||||
private static final AtomicLong outboundMessages = new AtomicLong();
|
||||
private static final AtomicLong outboundBytes = new AtomicLong();
|
||||
private static final AtomicLong displayFramesSent = new AtomicLong();
|
||||
|
||||
/** Called by the communicator when a display frame's last message is acked. */
|
||||
public static void recordDisplayFrameSent() {
|
||||
displayFramesSent.incrementAndGet();
|
||||
}
|
||||
|
||||
/** Running totals of outbound BLE traffic since process start: [messages, bytes, display frames]. */
|
||||
public static long[] sampleOutboundTraffic() {
|
||||
return new long[] { outboundMessages.get(), outboundBytes.get(), displayFramesSent.get() };
|
||||
}
|
||||
|
||||
public FaceclawBleManager(Context context) {
|
||||
this.context = context.getApplicationContext();
|
||||
BluetoothManager bluetoothManager = (BluetoothManager) this.context.getSystemService(Context.BLUETOOTH_SERVICE);
|
||||
@@ -250,8 +268,10 @@ public class FaceclawBleManager {
|
||||
if (!startWrite(gatt, characteristic, address, frame, writeType, timeoutMs)) {
|
||||
return false;
|
||||
}
|
||||
outboundBytes.addAndGet(frame != null ? frame.length : 0);
|
||||
}
|
||||
}
|
||||
outboundMessages.incrementAndGet();
|
||||
int totalSize = frames.stream().mapToInt(frame -> frame != null ? frame.length : 0).sum();
|
||||
Log.i(TAG, "writeFrames wrote " + frames.size() + " frames totaling " + totalSize + " bytes in " + (System.currentTimeMillis() - startMs) + "ms");
|
||||
return true;
|
||||
|
||||
@@ -5,6 +5,7 @@
|
||||
* Add support for the short-then-long-press gesture
|
||||
* Update EvenHub compatibility layer to include new functions from 0.0.14
|
||||
* EvenHub permissions dialog scrolls when it overflows
|
||||
* Add "Show BLE bandwidth usage" option to developer settings
|
||||
|
||||
## 0.6.2 - 2026-08-30
|
||||
* Preview Only mode works
|
||||
|
||||
@@ -98,6 +98,13 @@ Button.-primary {
|
||||
font-size: 13;
|
||||
}
|
||||
|
||||
/* Developer BLE-bandwidth totals overlaid on the main page's bottom edge. */
|
||||
.ble-bandwidth-indicator {
|
||||
color: #777777;
|
||||
font-size: 12;
|
||||
padding: 2 8;
|
||||
}
|
||||
|
||||
/*
|
||||
* Stands in for the lens preview when showing it would be misleading (silent
|
||||
* mode, or a disconnect explained by a flat battery). Sized by the view model
|
||||
|
||||
@@ -71,7 +71,7 @@ const GRAVITY = 240;
|
||||
const DRAG_PER_S = 0.12;
|
||||
const MAX_SPEED = 600;
|
||||
const PHYSICS_DT = 1 / 120;
|
||||
const RENDER_TICK_MS = 110;
|
||||
const RENDER_TICK_MS = 50;
|
||||
/** Launch speed by power setting (index = power - 1). */
|
||||
const LAUNCH_SPEEDS = [320, 380, 440, 500, 560] as const;
|
||||
const BUMPER_KICK = 340;
|
||||
|
||||
@@ -0,0 +1,16 @@
|
||||
declare const com: any;
|
||||
|
||||
export interface BleTrafficSample {
|
||||
/** Outbound messages (writeFrames calls) since process start. */
|
||||
messages: number;
|
||||
/** Outbound payload bytes (sum of frame sizes) since process start. */
|
||||
bytes: number;
|
||||
/** Display frames whose last message was acked, since process start. */
|
||||
frames: number;
|
||||
}
|
||||
|
||||
/** Running totals of outbound BLE traffic, counted process-wide in FaceclawBleManager. */
|
||||
export function sampleBleTraffic(): BleTrafficSample {
|
||||
const raw = com.faceclaw.app.FaceclawBleManager.sampleOutboundTraffic();
|
||||
return { messages: Number(raw[0]), bytes: Number(raw[1]), frames: Number(raw[2]) };
|
||||
}
|
||||
@@ -64,6 +64,14 @@
|
||||
</StackLayout>
|
||||
</GridLayout>
|
||||
</GridLayout>
|
||||
<!-- Developer BLE-bandwidth indicator: overlays the bottom edge of the
|
||||
page in both orientations, on every tab. -->
|
||||
<Label
|
||||
text="{{ bleBandwidthLabel }}"
|
||||
visibility="{{ bleBandwidthVisibility }}"
|
||||
class="ble-bandwidth-indicator"
|
||||
horizontalAlignment="center"
|
||||
verticalAlignment="bottom" />
|
||||
<ScrollView
|
||||
class="warnings-modal"
|
||||
visibility="{{ warningsModalVisibility }}"
|
||||
|
||||
@@ -19,9 +19,11 @@ import {
|
||||
displayModeSetting,
|
||||
mirrorTouchSetting,
|
||||
onAnySettingChanged,
|
||||
showBleBandwidthSetting,
|
||||
type BrightnessSetting,
|
||||
type DisplayModeSetting,
|
||||
} from "../ui/dashboard-settings";
|
||||
import { sampleBleTraffic } from "../native/ble-traffic";
|
||||
import { isValidMacAddress, loadDeviceAddresses } from "../g2/device-addresses";
|
||||
import { isAutoReconnectSuppressed, resumeAutoReconnect } from "../g2/reconnect-policy";
|
||||
import { formatErrorMessage } from "../util/format-error";
|
||||
@@ -111,7 +113,12 @@ export class MainViewModel extends Observable {
|
||||
this.refreshPadFocusLine();
|
||||
}));
|
||||
// Brightness / display mode can change from the glasses' Settings app too.
|
||||
this.unsubscribers.push(onAnySettingChanged(() => this.refreshDisplayControls()));
|
||||
this.unsubscribers.push(onAnySettingChanged(() => {
|
||||
this.refreshDisplayControls();
|
||||
this.syncBleBandwidthPolling();
|
||||
}));
|
||||
this.syncBleBandwidthPolling();
|
||||
this.unsubscribers.push(() => this.stopBleBandwidthPolling());
|
||||
}
|
||||
|
||||
/** Detach from the controller and settings; the page calls this when it lets go of the model. */
|
||||
@@ -1128,6 +1135,72 @@ export class MainViewModel extends Observable {
|
||||
this.notifyPropertyChange("displayModeLabel", this.displayModeLabel);
|
||||
}
|
||||
|
||||
// ---- BLE bandwidth indicator (Settings > Developer > Show BLE bandwidth usage) ----
|
||||
//
|
||||
// A running total of outbound BLE messages/bytes, overlaid at the bottom of
|
||||
// the page on every tab. Polled from the Java-side counters while enabled.
|
||||
|
||||
private _bleBandwidthLabel = "";
|
||||
private bleBandwidthTimer: ReturnType<typeof setInterval> | null = null;
|
||||
// Recent counter samples, one per poll tick, for the windowed rates.
|
||||
private bleRateHistory: Array<{ atMs: number; bytes: number; frames: number }> = [];
|
||||
|
||||
get bleBandwidthVisibility(): "visible" | "collapse" {
|
||||
return showBleBandwidthSetting.get() ? "visible" : "collapse";
|
||||
}
|
||||
|
||||
get bleBandwidthLabel(): string {
|
||||
return this._bleBandwidthLabel;
|
||||
}
|
||||
|
||||
/** Start or stop the poll to match the setting; safe to call repeatedly. */
|
||||
private syncBleBandwidthPolling(): void {
|
||||
const enabled = showBleBandwidthSetting.get();
|
||||
if (enabled && this.bleBandwidthTimer === null) {
|
||||
this.refreshBleBandwidth();
|
||||
this.bleBandwidthTimer = setInterval(() => this.refreshBleBandwidth(), 1000);
|
||||
this.notifyPropertyChange("bleBandwidthVisibility", this.bleBandwidthVisibility);
|
||||
} else if (!enabled && this.bleBandwidthTimer !== null) {
|
||||
this.stopBleBandwidthPolling();
|
||||
this.notifyPropertyChange("bleBandwidthVisibility", this.bleBandwidthVisibility);
|
||||
}
|
||||
}
|
||||
|
||||
private stopBleBandwidthPolling(): void {
|
||||
if (this.bleBandwidthTimer !== null) {
|
||||
clearInterval(this.bleBandwidthTimer);
|
||||
this.bleBandwidthTimer = null;
|
||||
}
|
||||
// Don't let a later re-enable compute a rate across the disabled gap.
|
||||
this.bleRateHistory = [];
|
||||
}
|
||||
|
||||
private refreshBleBandwidth(): void {
|
||||
let label: string;
|
||||
try {
|
||||
const sample = sampleBleTraffic();
|
||||
const atMs = Date.now();
|
||||
this.bleRateHistory.push({ atMs, bytes: sample.bytes, frames: sample.frames });
|
||||
while (this.bleRateHistory.length > 0 && this.bleRateHistory[0]!.atMs < atMs - BLE_RATE_WINDOW_MS) {
|
||||
this.bleRateHistory.shift();
|
||||
}
|
||||
label = `BLE sent: ${formatCount(sample.messages)} messages, ${formatCount(sample.bytes)} bytes`;
|
||||
const oldest = this.bleRateHistory[0]!;
|
||||
const elapsedSec = (atMs - oldest.atMs) / 1000;
|
||||
if (elapsedSec > 0) {
|
||||
const byteRate = (sample.bytes - oldest.bytes) / elapsedSec;
|
||||
const frameRate = (sample.frames - oldest.frames) / elapsedSec;
|
||||
label += ` · ${formatByteRate(byteRate)}, ${frameRate.toFixed(1)} fps`;
|
||||
}
|
||||
} catch (error) {
|
||||
label = `BLE sent: ${this.formatError(error)}`;
|
||||
}
|
||||
if (label !== this._bleBandwidthLabel) {
|
||||
this._bleBandwidthLabel = label;
|
||||
this.notifyPropertyChange("bleBandwidthLabel", label);
|
||||
}
|
||||
}
|
||||
|
||||
private readLayoutOrientation(): LayoutOrientation {
|
||||
const applicationOrientation = Application.orientation();
|
||||
if (applicationOrientation === "landscape" || applicationOrientation === "portrait") {
|
||||
@@ -1141,6 +1214,20 @@ export class MainViewModel extends Observable {
|
||||
}
|
||||
}
|
||||
|
||||
/** 1234567 -> "1,234,567"; kept exact rather than rounded so growth is visible at a glance. */
|
||||
function formatCount(value: number): string {
|
||||
return String(Math.round(value)).replace(/\B(?=(\d{3})+(?!\d))/g, ",");
|
||||
}
|
||||
|
||||
/** How far back the BLE bandwidth indicator's rates look. */
|
||||
const BLE_RATE_WINDOW_MS = 5000;
|
||||
|
||||
function formatByteRate(bytesPerSec: number): string {
|
||||
if (bytesPerSec >= 1e6) return (bytesPerSec / 1e6).toFixed(2) + " MB/s";
|
||||
if (bytesPerSec >= 1e3) return (bytesPerSec / 1e3).toFixed(1) + " kB/s";
|
||||
return Math.round(bytesPerSec) + " B/s";
|
||||
}
|
||||
|
||||
/** NativeScript swipe direction -> the watch-scheme directional gesture. */
|
||||
function swipeKind(direction: SwipeDirection): "swipe-up" | "swipe-down" | "swipe-left" | "swipe-right" {
|
||||
switch (direction) {
|
||||
|
||||
@@ -399,6 +399,15 @@ export const useMicControlSetting = new ConfigSettingBoolean({
|
||||
"Use the custom firmware's per-temple mic-control channel (caps token micctl) for the Microphones app's array capture. When off, behave as if the firmware doesn't have the feature and use the standard single mixed stream.",
|
||||
});
|
||||
|
||||
export const showBleBandwidthSetting = new ConfigSettingBoolean({
|
||||
id: "show-ble-bandwidth",
|
||||
label: "Show BLE bandwidth usage",
|
||||
storageKey: "developer.showBleBandwidth",
|
||||
defaultValue: false,
|
||||
description:
|
||||
"Show a running total of Bluetooth messages and bytes sent, at the bottom of the phone app's main screen.",
|
||||
});
|
||||
|
||||
export type RingConnectionMode = "glasses" | "direct";
|
||||
|
||||
export const ringConnectionModeSetting = new ConfigSettingEnum<RingConnectionMode>({
|
||||
|
||||
@@ -47,6 +47,7 @@ import {
|
||||
firmwareDebugFlagsSetting,
|
||||
lockScreenEnabledSetting,
|
||||
saveVoiceRecordingsSetting,
|
||||
showBleBandwidthSetting,
|
||||
suspendEvenHubWhenScreenOffSetting,
|
||||
terminalAutoReconnectSetting,
|
||||
terminalLaunchPresetsSetting,
|
||||
@@ -176,6 +177,7 @@ function settingsSections(): SettingsSection[] {
|
||||
toggleSettingMenuItem(firmwareDebugFlagsSetting),
|
||||
toggleSettingMenuItem(suspendEvenHubWhenScreenOffSetting),
|
||||
toggleSettingMenuItem(useMicControlSetting),
|
||||
toggleSettingMenuItem(showBleBandwidthSetting),
|
||||
],
|
||||
},
|
||||
{
|
||||
|
||||
Reference in new issue
Block a user