Skip to content

About

Unofficial iOS transport probe for Soundcore Liberty 4

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

Soundcore Mini

iOS CI

Important

Soundcore Mini is an independent, unofficial project. It is not affiliated with, endorsed by, or sponsored by Soundcore, Anker Innovations, Apple, or OpenSCQ30. All product names, logos, brands, and trademarks are the property of their respective owners.

A deliberately small iOS prototype for switching the listening mode on the original Soundcore Liberty 4 (A3953).

The reverse-engineered packet protocol is implemented. The remaining feasibility question is transport: the verified desktop implementation talks to the earbuds over Bluetooth Classic RFCOMM. Core Bluetooth can access GATT over both BLE and BR/EDR (Classic), but that does not provide arbitrary RFCOMM/SPP access. This prototype discovers everything the Liberty 4 exposes to Core Bluetooth and lets a tester probe a writable characteristic without pretending that an iOS-accessible control path is already known.

Implemented

  • Soundcore packet framing, little-endian length, and additive checksum
  • Request-state command 01 01
  • A3953 sound-mode command 06 81
  • Parsing both full A3953 state responses and direct 06 01 mode updates
  • State-preserving changes between Noise Cancellation, Transparency, and Normal
  • BLE scanning plus paired GATT-over-Classic connection-event discovery
  • Core Bluetooth connect, service/characteristic discovery, notifications, and writes
  • An on-device protocol log for collecting evidence from a real Liberty 4
  • Unit tests based on the OpenSCQ30 framing and A3953 captures

The app refuses to enable the mode controls until it has decoded the current six-byte settings block. Only the first byte changes; the other device settings are preserved.

Build

Requirements: macOS, Xcode 16 or newer, a physical iPhone, and XcodeGen.

brew install xcodegen
xcodegen generate
open SoundcoreMini.xcodeproj

Choose a development team in Xcode, then run on an iPhone. Bluetooth transport cannot be tested in the iOS Simulator.

Hardware test flow

  1. Pair the Liberty 4 in iOS Settings.
  2. Open Soundcore Mini, then reconnect or power-cycle the earbuds so iOS emits a Classic connection event.
  3. Scan for BLE advertisements as a second discovery path.
  4. Connect to the likely Soundcore result.
  5. Review the discovered services and characteristics.
  6. Select a writable characteristic as the experimental control path.
  7. The app sends a state request and listens on every notifiable characteristic.
  8. If an A3953 state response arrives, the three mode controls unlock.

If no writable characteristic appears, or no Soundcore-framed response arrives, that is useful evidence that ANC control is only exposed over the RFCOMM service and therefore unavailable to a normal third-party iOS app.

Protocol references

Next milestone

Run the probe on a physical Liberty 4 and capture the service/characteristic list plus protocol log. That result decides whether to wire the discovered GATT route into a one-tap controller or document RFCOMM as the iOS platform blocker.

About

Unofficial iOS transport probe for Soundcore Liberty 4

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages