Skip to content

BLE Wire Protocol v2: throughput cleanup across asg, mobile SDK, and app layer #3286

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
nic-olo wants to merge 65 commits into from
Closed

BLE Wire Protocol v2: throughput cleanup across asg, mobile SDK, and app layer #3286

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
65 commits
Select commit Hold shift + click to select a range
c976289
Hardcode 1/90s manual exposure for video recording and WHIP live streams
cursoragent Jun 30, 2026
34b3dba
asg: add BLE wire v2 framing with LE length and binary transport
nic-olo Jun 30, 2026
b9d6f40
asg: update BesWireFormat tests for LE length encoding
nic-olo Jun 30, 2026
0539d55
asg: add binary message chunker unit tests
nic-olo Jun 30, 2026
d0bb44f
asg: add compact JSON helper for BLE wire efficiency
nic-olo Jun 30, 2026
838d70f
asg: add BleJsonCompact unit tests
nic-olo Jun 30, 2026
8f3b217
asg: support binary fragment chunking in MessageChunker
nic-olo Jun 30, 2026
f135d33
asg: reassemble binary BLE fragments in ChunkReassembler
nic-olo Jun 30, 2026
1f354d0
asg: route binary frames through chunked protocol strategy
nic-olo Jun 30, 2026
e01ff53
asg: integrate BLE wire v2 transport in K900BluetoothManager
nic-olo Jun 30, 2026
9001167
asg: extend BLE trace logging for binary wire frames
nic-olo Jun 30, 2026
59a5521
asg: wire v2 handshake and binary transport in AsgClientService
nic-olo Jun 30, 2026
17c3983
asg: handle phone_ready over BLE wire v2 path
nic-olo Jun 30, 2026
d1bcdef
mobile-sdk: add BLE wire v2 protocol constants and helpers
nic-olo Jun 30, 2026
99400af
mobile-sdk: use LE length encoding in K900ProtocolUtils
nic-olo Jun 30, 2026
8563974
mobile-sdk: add K900 endianness regression tests
nic-olo Jun 30, 2026
d7e9bf6
mobile-sdk: add compact JSON helper for BLE efficiency
nic-olo Jun 30, 2026
801ff93
mobile-sdk: add BleJsonCompact unit tests
nic-olo Jun 30, 2026
aa37673
mobile-sdk: add binary fragment chunking to MessageChunker
nic-olo Jun 30, 2026
516659f
mobile-sdk: add binary message chunker unit tests
nic-olo Jun 30, 2026
fdeb6b5
mobile-sdk: reassemble binary BLE fragments on Android
nic-olo Jun 30, 2026
7d43372
mobile-sdk: integrate BLE wire v2 in MentraLive Android
nic-olo Jun 30, 2026
ed2b1a6
mobile-sdk: add BLE wire v2 protocol helpers on iOS
nic-olo Jun 30, 2026
c3f3add
mobile-sdk: add compact JSON helper on iOS
nic-olo Jun 30, 2026
f2af3ad
mobile-sdk: add binary fragment chunking on iOS
nic-olo Jun 30, 2026
ac81161
mobile-sdk: reassemble binary BLE fragments on iOS
nic-olo Jun 30, 2026
1c9d4ab
mobile-sdk: integrate BLE wire v2 in MentraLive iOS
nic-olo Jun 30, 2026
6609894
mobile: add debouncedPatch utility for BLE setting writes
nic-olo Jun 30, 2026
02e1fa7
mobile: define Mentra Live BLE setting key subset
nic-olo Jun 30, 2026
584369c
mobile: add outbound JSON compaction helpers
nic-olo Jun 30, 2026
976de5b
mobile: slim stream_status payloads for BLE
nic-olo Jun 30, 2026
8cc4788
mobile: debounce glasses settings BLE writes
nic-olo Jun 30, 2026
3db4aad
mobile: add settings store debounce tests
nic-olo Jun 30, 2026
0229804
mobile: coalesce display updates over BLE
nic-olo Jun 30, 2026
1265bdf
mobile: reduce duplicate BLE reporting in MantleManager
nic-olo Jun 30, 2026
67ddeea
mobile: update MantleManager tests for BLE throughput
nic-olo Jun 30, 2026
b5d90c1
mobile: use compact outbound JSON in RestComms
nic-olo Jun 30, 2026
38034da
mobile: update RestComms tests for compact JSON
nic-olo Jun 30, 2026
d9a38cc
mobile: use compact outbound JSON in SocketComms
nic-olo Jun 30, 2026
92acc1b
mobile: update SocketComms display tests
nic-olo Jun 30, 2026
1b3c692
mobile: batch menu_apps BLE re-sends
nic-olo Jun 30, 2026
1ecd14b
mobile: shorten photo requestId and drop duplicate camera writes
nic-olo Jun 30, 2026
6a74524
mobile: update PhonePhotoCoordinator tests
nic-olo Jun 30, 2026
3110f32
mobile: forward slim stream_status over BLE
nic-olo Jun 30, 2026
e465a43
mobile: remove duplicate camera BLE write from settings
nic-olo Jun 30, 2026
0ed4ee3
mobile: add camera settings BLE write tests
nic-olo Jun 30, 2026
bdf37d0
fix(pr-agent): round 1 [pr-agent-fix]
github-actions[bot] Jun 30, 2026
259474a
fix(pr-agent): round 2 [pr-agent-fix]
github-actions[bot] Jun 30, 2026
289564f
Cloud V2 console, registry, and preinstall updates (#3272)
isaiahb Jun 30, 2026
124d849
Add camera warm-up primitive (session.camera.warmUp) (#3287)
aisraelov Jul 1, 2026
7d5dacd
Console org roles (owner/admin/member) + default mobile to Cloud V2 D…
aisraelov Jul 1, 2026
fb72c64
Merge origin/dev into feat/ble-wire-protocol-v2
nic-olo Jul 1, 2026
47b9802
Merge branch 'cursor/hardcode-1-90s-exposure-video-streams-49e0' of g…
nic-olo Jul 1, 2026
c8278a5
Add K900 length codec.
nic-olo Jul 1, 2026
a0d3248
Add endian-aware BES wire formatting.
nic-olo Jul 1, 2026
e89ca47
Gate ASG wire v2 on BES capabilities.
nic-olo Jul 1, 2026
da828a0
Publish proven wire caps in version info.
nic-olo Jul 1, 2026
17a293a
Keep phone ready on legacy BES path.
nic-olo Jul 1, 2026
2d66e23
Test OTA auth legacy string framing.
nic-olo Jul 1, 2026
c624f66
Test phone ready BES capability gating.
nic-olo Jul 1, 2026
b07e427
Fix chunked UART endian, wire_caps parsing, and duplicate JSON compac…
nic-olo Jul 1, 2026
aad318f
Address Bugbot and cubic review findings for BLE wire v2.
nic-olo Jul 1, 2026
1b27c70
Fix binary frame LE packing and remove hardcoded video exposure.
nic-olo Jul 1, 2026
2136a61
Fix BLE wire v2 compatibility regressions.
nic-olo Jul 2, 2026
03631fc
Update .gitignore to include local agent/tooling state files and nest…
nic-olo Jul 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions .github/workflows/staging-builds.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ name: Staging Builds
# - https://staging.ota.mentraglass.com/staging_live_version.json
# once the custom domain is attached.
# This intentionally does not deploy to the production ota.mentraglass.com
# project or include prod_live_version.json.
# project or include test_bes_ota_prod_live_version.json.
#
# Mobile also uploads to TestFlight (iOS) and Play Store internal track
# (Android), as the release scripts already do, IF the runner has the creds
Expand Down Expand Up @@ -905,8 +905,8 @@ jobs:
' Cache-Control: public, max-age=0, must-revalidate' \
> asg-pages-site/_headers

if [ -e asg-pages-site/prod_live_version.json ]; then
echo "Staging OTA payload must not contain prod_live_version.json." >&2
if [ -e asg-pages-site/test_bes_ota_prod_live_version.json ]; then
echo "Staging OTA payload must not contain test_bes_ota_prod_live_version.json." >&2
exit 1
Comment on lines +908 to 910

@cubic-dev-ai cubic-dev-ai Bot Jul 2, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1: The staging payload guard was narrowed from prod_live_version.json to test_bes_ota_prod_live_version.json, but the canonical production manifest filename used throughout the codebase is still prod_live_version.json (found in 7 files across mobile SDK, mobile app, and ASG client). The new filename does not exist anywhere else in the repository, so the guard is no longer effective at preventing accidental inclusion of the production manifest in the staging Pages payload. To preserve the intended channel isolation, continue checking for prod_live_version.json (either alongside or instead of the new name).

Prompt for AI agents 
Check if this issue is valid — if so, understand the root cause and fix it. At .github/workflows/staging-builds.yml, line 908:

<comment>The staging payload guard was narrowed from `prod_live_version.json` to `test_bes_ota_prod_live_version.json`, but the canonical production manifest filename used throughout the codebase is still `prod_live_version.json` (found in 7 files across mobile SDK, mobile app, and ASG client). The new filename does not exist anywhere else in the repository, so the guard is no longer effective at preventing accidental inclusion of the production manifest in the staging Pages payload. To preserve the intended channel isolation, continue checking for `prod_live_version.json` (either alongside or instead of the new name).</comment>

<file context>
@@ -905,8 +905,8 @@ jobs:
 
-          if [ -e asg-pages-site/prod_live_version.json ]; then
-            echo "Staging OTA payload must not contain prod_live_version.json." >&2
+          if [ -e asg-pages-site/test_bes_ota_prod_live_version.json ]; then
+            echo "Staging OTA payload must not contain test_bes_ota_prod_live_version.json." >&2
             exit 1
</file context>
Suggested change
if [ -e asg-pages-site/test_bes_ota_prod_live_version.json ]; then
echo "Staging OTA payload must not contain test_bes_ota_prod_live_version.json." >&2
exit 1
if [ -e asg-pages-site/prod_live_version.json ] || [ -e asg-pages-site/test_bes_ota_prod_live_version.json ]; then
echo "Staging OTA payload must not contain production manifest." >&2
exit 1
fi

fi

Expand Down
10 changes: 10 additions & 0 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -391,8 +391,18 @@ MEMORY.md
# PR agent orchestrator local outputs
.pr-agent/

# Local agent/tooling state
.mcp.json
.codex/

# Local Cursor/agent skills
mobile/agents/

# Nested starter-kit repo (separate git history)
Mentra-Bluetooth-SDK-Starter-Kit/

# Nested Zephyr glasses client repo (separate git history)
Mentra-Zephyr-Glasses-Client/

# Navigation miniapp build output
miniapps/navigation/build/
305 changes: 292 additions & 13 deletions ...t/app/src/main/java/com/mentra/asg_client/io/bluetooth/managers/K900BluetoothManager.java
View file
Open in desktop

Large diffs are not rendered by default.

Loading
Loading