Skip to content

Auracast link mode, stereo channel control, and working preset EQ for the Go 4 - #9

Open
StrangeSid wants to merge 4 commits into
ffrafat:mainfrom
StrangeSid:feat/auracast-stereo-eq
Open

StrangeSid wants to merge 4 commits into
ffrafat:mainfrom
StrangeSid:feat/auracast-stereo-eq

Conversation

@StrangeSid

@StrangeSid StrangeSid commented Nov 15, 2026 •

Copy link
Copy Markdown

What this does

Adds the multi-speaker controls JBL's own app uses, fixes preset EQ on the five-band models, and promotes the Go 4 to Verified.

  • Auracast on/off with AA 6A 01 02 / AA 6A 01 00 and the AA 6B / AA 16 role reply — the real link-mode command, not the PartyBox AA 13 04 00 3C … token.
  • Left / Right / Mono with AA 15 03 00 46 0|1|2 (JBL's SetChannelCommand), plus a swap action and a "connect to the other unit" shortcut. AirTouch Duos stay read-only because their firmware picks the halves itself.
  • Group status from AA A1 / AA A2 (type, channel, role, 4-byte group id), and Protocol 4 AuraCastMode / PartyChannelType for the P4 models, so the same card works on the Go 4, Clip 5, Xtreme 4/5, Boombox 3/4, Flip 7 and Charge 6.
  • Presets actually work on the Go 4 now. Selecting a preset with the level frame + the preset's category byte is silently ignored by the firmware. JBL's app sends DefaultPresetEQPayload: category + five fixed-point biquad coefficients per band. That encoder is ported (PresetEQ), and Signature/Chill/Vocal were confirmed on a Go 4 — the AA 99 reply switched to 06/22/03 and echoed the coefficients. Custom EQ stays on the level frame.
  • 3-band models get JBL Signature back (AA 6E 02 01 00), so Charge 5 / Flip 6 / Xtreme 3 / Boombox 2-3 are no longer custom-only.
  • Go 4 is Verified: the EQ write captured on 20E4 reads back band for band, so 20E4 and 210A need no experimental opt-in. The Duo (215C/2181) is the same firmware but stays Beta until someone captures it. Xtreme 4's AKM preset encoder is the one .legacyLevels model not ported; its presets are hidden rather than left silently broken.
  • Firmware token fix: the Go 4 returns ASCII 30 36 34 30, which was rendered as 48.54.52.48; it now shows 0.6.4.0 (the Flip 7's binary form still works).

Hardware status

Verified on a single Go 4 (20E4, firmware 0.6.4.0): custom EQ write/read-back/restore, Signature/Chill/Vocal preset frames, channel ACK, and the link-mode reply.

Not yet tested: a second Go 4, the actual L/R split, and the AA A0 group flow. The two-speaker test is the next step; the commands are the ones the decompiled app builds.

One caveat found on hardware: AA 6A 01 02 puts the Go 4 into broadcast mode and it then stops answering new BLE control connections. JBLControl holds its own link, but if it drops, the speaker's Auracast button is the way out. That is documented in docs/PROTOCOL-GO4.md, and the UI explains the button flow.

Protocol evidence

  • JBL Portable 6.9.33 (com.harman.ble.jbllink), decompiled with jadx: SetLinkModeCommand, SetChannelCommand, SetChannelLockCommand, ReqAuracastGroupCommand, SetAuraCastGroupCommand, SetAuracastGroupNonLLSCommand, DefaultPresetEQPayload.
  • Single-unit capture from a Go 4, reproduced in Tests/JBLControlKitTests/Go4Tests.swift and AuracastTests.swift.
  • Details and the token map: docs/PROTOCOL-GO4.md.

Tests

  • Swift: 45 tests (swift test).
  • Windows kit: 40 tests (dotnet test windows/JBLControlKit.Windows.Tests).

Windows gets the protocol, catalog, preset encoder and tests; the Windows panel UI for Auracast is not included in this PR. Both apps share the catalog, and it was regenerated with scripts/generate-catalog.py.

Try it

  1. Pair two Go 4s by pressing Auracast on both.
  2. Connect to one, open the Auracast card (panel or main window), choose Left; use "Connect to the other Go 4" and choose Right.
  3. Play something and check that the pair splits L/R. The picker should not jump back to Mono when the speaker reports token 0x46 = 00 outside a group; the app trusts the ACK.
  4. EQ: move a custom band, then select Signature/Chill/Vocal; the AA 99 reply's active category should match.

- Go 4 and Go 4 Duo are verified: the EQ write captured on PID 20E4 reads back band for band.
- Auracast uses the app's real switch, AA 6A 01 02 (0x6B/0x16 role), instead of the PartyBox token.
- Left/right uses AA 15 03 00 46 0/1/2, with a Mono/Left/Right picker in the panel, main window and menu.
- Read tokens 45/46/49/4C, AA A1/A2 group status, and Protocol 4 AuraCastMode/PartyChannelType.
- Presets on the five-band models are JBL's biquad coefficient payload; the level form is ignored
  by the firmware. Signature/Chill/Vocal were verified on a Go 4.
- 3-band models can select JBL Signature with AA 6E 02 01 00.
- Firmware token 0x4D accepts the Go 4's ASCII form (30 36 34 30 -> 0.6.4.0).
- Windows kit and catalog mirror the protocol; Swift 45 tests and C# 40 tests pass.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant