calvin.erfmann/librepods
1
0
Fork 0
mirror of https://github.com/kavishdevar/librepods.git synced 2026-01-28 22:01:50 +00:00
Code Issues Packages Projects Releases Wiki Activity

android: multidevice capabilites and accessiblity features (and "liquid glass") (#202)

Browse Source 
many thanks to @rithvikvibhu for help with the hearing aids feature

adds:
hearing aid
two-device connection
new UI
transparency mode customization

commits:
* android: add accessibility stuff

adds option for customizing transparency mode, amplification, tone, etc.

* docs: update transparency mode format

* android: don't 'start' service every time MainActivity is launched

* android: add basic multidevice capabilities

use at your own risk, may or may not work

* android: clean up a bit of AI gen'd code

* android: clean up main service and remove minimum API on head gestures

* android: clean up a lot of stuff

* android: implement the accessiblity settings page

* android: add EQ settings for phone and media

* android: add toggle for DID hook

* docs: add 'has ownership' control cmd

* android: fix balance NaN error when amplification L/R is both zero

* android: bring back some accessiblity settings and add listeners for all config

* android: add header to ATTManager

* android: use device name sent by the connected device in island

* android: fix track color in tone volume

* android: remove unused composable

* android: update eq sliders style

* android: fix text color in selectors

* android: add delay before starting head tracking again

* android: add a few options

ik not the right branch/pr but, eh, i am not merging this hook until i test further, and if i don't merge, conflicts, a lot of 'em

* android: a small ui fix

* docs: a few more control cmds

* android: add microphone setting

also, un-hardcoded strings, and updated text sizes

* android: improve dropdowns

ai generated

* android: move attmanager to service to avoid trying to connect multiple times

* android: add ui for hearing stuff

mostly copied from the transparency settings, which are now updated to match ios <26 ui

* android: add media assist options in hearing aid

ui only

* android: add hearing aid adjustments

* android: liquidglass sliders

* android: improve liquid glass sliders

* android: little more liquid glass

* android: fix hearing aid parsing

* android: remove customdeviceactivity from manifest

* android: remove unused strings

* android: small ui tweaks

* android: a very big commit

refactoring ui, mostly

* android: move padding to StyledScaffold's content

because haze needs it

* android: revert accidental capitalization on toggle label

* android: update usages for toggle

* android: liquidglass, maybe?

the switch and icon button took quite a while. i forgot the order of modifiers matters!

* remove bleonly mode, use CAPod instead

* remove bleonly mode, use CAPod instead

* android: fix switch styling

* android: remove fade from transition

* android: add A16's new bluetooth identifier for log collection

just why...

* android: fix crash in head gestures screen

* android: show head gestures status in the navigation button

* android: don't crash if att not available

* android: use lazycolumn in airpods settings for better performance and navigation transitions

* android: fix text color in troubshooting button and pressandhold settings

* android: bring back original confirmation dialog

too lazy to fix/implement properly the glassy one

* android: prevent hearing aid turning off itself

* android: hide media assist, not implemented

* docs: update README with new features

* docs: add demo video

* docs: add new screenshots for android

* docs: update demo video position

* docs: app3 compatibility

* docs: new control cmds '25 (again)

* docs: change section title in control cmd doc

Updated section title from 'Control Commands' to 'Identifiers and details'.

* android: ui tweaks

* android: update styled slider thumb

* android: add accessiblity service for camera control

* android: add camera control, finally

i got too lazy to find out how to listen to app openings earlier, wasn't too hard

* android: add option to change camera app id

* android: not use relative paths for executing commands

i hope it's the same across all skins

* android: fix transparency and noise cancellation flags

huh... was it always like this?

* android: revert to using relative paths for su

compatibility issues with magisk

* android: bump version

* android: don't crash if self MAC is not available

* android: remove unused LOCAL_ADDRESS permission

* android: add opensource licenses

should've done this a long time ago!

* android: move navigation button to activity level

* android: update animation time on switch tap

* android: implement setting hearing test results

* android: update title in hearing test screen

* docs: add screenshot for hearing test

* android: fix haze for dialog when enabling hearing aid

* android: parse device info

* android: add support for various models

still need to update images or find a way to fetch from apple's cdn

* android: fix a2dp connection

* android: remove stray eq config in accessibility settings

* android: improve connection handling

* android: add a (very important) support dialog

to not be invasive, this only shows up once, and never again.

* docs: add note for DID hook on android
This commit is contained in:
Kavish Devar
2025-10-26 21:03:49 +05:30
committed by GitHub
parent e437572355
commit 8eb6eba049
152 changed files with 17176 additions and 5304 deletions
Download Patch File Download Diff File Expand all files Collapse all files

258
docs/control_commands.md
View File

@@ -4,7 +4,7 @@ AACP uses opcode `9` for control commands. opcodes are 16 bit integers that spec
An AACP packet is formated as:
`04 00 04 00 [opcode, little endianness] [data]`
`04 00 04 00 [opcode, little endian] [data]`
So, our control commands becomes
@@ -14,51 +14,221 @@ So, our control commands becomes
Bytes that are not used are set to `0x00`. From what I've observed, the `data3` and `data4` are never used, and hence always zero. And, the `data2` is usually used when the configuration can be different for the two buds: like, to change the long press mode. Or, if there can be two "state" variables for the same feature: like the Hearing Aid feature.
## Control Commands
These commands
## Identifiers and details
| Command identifier | Description | Format |
|--------------|---------------------|--------|
| 0x01 | Mic Mode | Single value (1 byte) |
| 0x05 | Button Send Mode | Single value (1 byte) |
| 0x12 | VoiceTrigger for Siri | Single Value (1 byte): `0x01` = enabled, `0x01` = disabled |
| 0x14 | SingleClickMode | Single value (1 byte) |
| 0x15 | DoubleClickMode | Single value (1 byte) |
| 0x16 | ClickHoldMode | Two values (2 bytes; First byte = right bud Second byte = for left): `0x01` = Noise control `0x05` = Siri |
| 0x17 | DoubleClickInterval | Single value (1 byte): 0x00 = Default, `0x01` = Slower, `0x02` = Slowest|
| 0x18 | ClickHoldInterval | Single value (1 byte): 0x00 = Default, `0x01` = Slower, `0x02` = Slowest|
| 0x1A | ListeningModeConfigs | Single value (1 byte): bitmask, Off mode = `0x01`, ANC=`0x02`, Transparency = 0x04, Adaptive = `0x08` |
| 0x1B | OneBudANCMode | Single value (1 byte): `0x01` = enabled, `0x02` = disabled |
| 0x1C | CrownRotationDirection | Single value (1 byte): `0x01` = reversed, `0x02` = default |
| 0x0D | ListeningMode | Single value (1 byte): 1 = Off, 2 = noise cancellation, 3 = transparency, 4 = adaptive |
| 0x1E | AutoAnswerMode | Single value (1 byte) |
| 0x1F | Chime Volume | Single value (1 byte): 0 to 100|
| 0x23 | VolumeSwipeInterval | Single value (1 byte): 0x00 = Default, `0x01` = Longer, `0x02` = Longest |
| 0x24 | Call Management Config | Single value (1 byte) |
| 0x25 | VolumeSwipeMode | Single value (1 byte): `0x01` = enabled, `0x02` = disabled |
| 0x26 | Adaptive Volume Config | Single value (1 byte): `0x01` = enabled, `0x02` = disabled |
| 0x27 | Software Mute config | Single value (1 byte) |
| 0x28 | Conversation Detect config | Single value (1 byte): `0x01` = enabled, `0x02` = disabled |
| 0x29 | SSL | Single value (1 byte) |
| 0x2C | Hearing Aid Enrolled and Hearing Aid Enabled | Two values (2 bytes; First byte - enrolled, Second byte = enabled): `0x01` = enabled, `0x02` = disabled |
| 0x2E | AutoANC Strength | Single value (1 byte): 0 to 100|
| 0x2F | HPS Gain Swipe | Single value (1 byte) |
| 0x30 | HRM enable/disable state | Single value (1 byte) |
| 0x31 | In Case Tone config | Single value (1 byte): `0x01` = enabled, `0x02` = disabled |
| 0x32 | Siri Multitone config | Single value (1 byte) |
| 0x33 | Hearing Assist config | Single value (1 byte): `0x01` = enabled, `0x02` = disabled |
| 0x34 | Allow Off Option for Listening Mode config | Single value (1 byte): `0x01` = enabled, `0x02` = disabled |
| 0x35 | Sleep Detection config | Single value (1 byte): `0x01` = enabled, `0x02` = disabled |
| 0x36 | Allow Auto Connect | Single value (1 byte): `0x01` = allow, `0x02` = disallow |
| 0x39 | Raw Gestures config | Single value (1 byte): bitmask, single press = `0x01`, double press = `0x02`, triple press = `0x04`, long press = `0x08` |
| 0x3C | System Siri message config | Single value (1 byte) |
| 0x3E | Uplink EQ Bud config | Single value (1 byte) |
| 0x3F | Uplink EQ Source config | Single value (1 byte) |
| 0x40 | In Case Tone Volume | Single value (1 byte): 0 to 100 |
| 0x41 | Disable Button Input config | Single value (1 byte) |
| Command identifier | Description |
|--------------|---------------------|
| 0x01 | Mic Mode |
| 0x05 | Button Send Mode |
| 0x06 | Owns connection |
| 0x0A | Ear Detection |
| 0x12 | VoiceTrigger for Siri |
| 0x14 | SingleClickMode |
| 0x15 | DoubleClickMode |
| 0x16 | ClickHoldMode |
| 0x17 | DoubleClickInterval |
| 0x18 | ClickHoldInterval |
| 0x1A | ListeningModeConfigs |
| 0x1B | OneBudANCMode |
| 0x1C | CrownRotationDirection |
| 0x0D | ListeningMode |
| 0x1E | AutoAnswerMode |
| 0x1F | Chime Volume |
| 0x20 | Connect Automatically |
| 0x23 | VolumeSwipeInterval |
| 0x24 | Call Management Config |
| 0x25 | VolumeSwipeMode |
| 0x26 | Adaptive Volume Config |
| 0x27 | Software Mute config |
| 0x28 | Conversation Detect config |
| 0x29 | SSL |
| 0x2C | Hearing Aid Enrolled and Hearing Aid Enabled |
| 0x2E | AutoANC Strength |
| 0x2F | HPS Gain Swipe |
| 0x30 | HRM enable/disable state |
| 0x31 | In Case Tone config |
| 0x32 | Siri Multitone config |
| 0x33 | Hearing Assist config |
| 0x34 | Allow Off Option for Listening Mode config |
| 0x35 | Sleep Detection config |
| 0x36 | Allow Auto Connect |
| 0x37 | PPE Toggle config |
| 0x38 | Personal Protective Equipment Cap Level config |
| 0x39 | Raw Gestures config |
| 0x3A | Temporary Pairing Config |
| 0x3B | Dynamic End of Charge config |
| 0x3C | System Siri message config |
| 0x3D | Hearing Aid Generic config |
| 0x3E | Uplink EQ Bud config |
| 0x3F | Uplink EQ Source config |
| 0x40 | In Case Tone Volume |
| 0x41 | Disable Button Input config |
## Command Details
### 0x01 - Mic Mode
Format: Single value (1 byte)
Values: `0x00` = Automatic, `0x01` = Right, `0x02` = Left.
### 0x05 - Button Send Mode
Format: Single value (1 byte)
Additional notes: Logged as "Set Button Send Mode: %d". May involve context updates for button handling.
### 0x06 - Owns connection
Format: Single value (1 byte)
Values: `0x01` = own, `0x00` = doesn't own.
### 0x0A - Ear Detection
Format: Single value (1 byte)
Values: `0x01` = enabled, `0x02` = disabled.
### 0x12 - VoiceTrigger for Siri
Format: Single value (1 byte)
Values: `0x01` = enabled, `0x02` = disabled.
### 0x14 - SingleClickMode
Format: Single value (1 byte)
### 0x15 - DoubleClickMode
Format: Single value (1 byte)
### 0x16 - ClickHoldMode
Format: Two values (2 bytes; First byte = right bud, Second byte = left bud).
Values: `0x01` = Noise control, `0x05` = Siri.
### 0x17 - DoubleClickInterval
Format: Single value (1 byte)
Values: 0x00 = Default, `0x01` = Slower, `0x02` = Slowest.
### 0x18 - ClickHoldInterval
Format: Single value (1 byte)
Values: 0x00 = Default, `0x01` = Slower, `0x02` = Slowest.
### 0x1A - ListeningModeConfigs
Format: Single value (1 byte)
Values: Bitmask, Off mode = `0x01`, ANC=`0x02`, Transparency = 0x04, Adaptive = `0x08`.
### 0x1B - OneBudANCMode
Format: Single value (1 byte)
Values: `0x01` = enabled, `0x02` = disabled
### 0x1C - CrownRotationDirection
Format: Single value (1 byte)
Values: `0x01` = reversed, `0x02` = default.
### 0x0D - ListeningMode
Format: Single value (1 byte)
Values: 1 = Off, 2 = noise cancellation, 3 = transparency, 4 = adaptive.
### 0x1E - AutoAnswerMode
Format: Single value (1 byte)
### 0x1F - Chime Volume
Format: Single value (1 byte)
Values: 0 to 100.
### 0x20 - Connect Automatically
Format: Single value (1 byte)
Values: `0x01` = enabled, `0x02` = disabled.
### 0x23 - VolumeSwipeInterval
Format: Single value (1 byte)
Values: 0x00 = Default, `0x01` = Longer, `0x02` = Longest.
### 0x24 - Call Management Config
Format: Single value (1 byte)
### 0x25 - VolumeSwipeMode
Format: Single value (1 byte)
Values: `0x01` = enabled, `0x02` = disabled
### 0x26 - Adaptive Volume Config
Format: Single value (1 byte)
Values: `0x01` = enabled, `0x02` = disabled
### 0x27 - Software Mute config
Format: Single value (1 byte)
### 0x28 - Conversation Detect config
Format: Single value (1 byte)
Values: `0x01` = enabled, `0x02` = disabled
### 0x29 - SSL
Format: Single value (1 byte)
### 0x2C - Hearing Aid Enrolled and Hearing Aid Enabled
Format: Two values (2 bytes; First byte - enrolled, Second byte = enabled)
Values: `0x01` = enabled, `0x02` = disabled
### 0x2E - AutoANC Strength
Format: Single value (1 byte)
Values: 0 to 100.
### 0x2F - HPS Gain Swipe (swipe to adjust amplification)
Format: Single value (1 byte)
### 0x30 - HRM enable/disable state
Format: Single value (1 byte)
### 0x31 - In Case Tone config
Format: Single value (1 byte)
Values: `0x01` = enabled, `0x02` = disabled
### 0x32 - Siri Multitone config
Format: Single value (1 byte)
### 0x33 - Hearing Assist config
Format: Single value (1 byte)
Values: `0x01` = enabled, `0x02` = disabled
### 0x34 - Allow Off Option for Listening Mode config
Format: Single value (1 byte)
Values: `0x01` = enabled, `0x02` = disabled
### 0x35 - Sleep Detection config
Format: Single value (1 byte)
Values: `0x01` = enabled, `0x02` = disabled
### 0x36 - Allow Auto Connect
Format: Single value (1 byte)
Values: `0x01` = allow, `0x02` = disallow
### 0x37 - PPE Toggle config
Format: Single value (1 byte)
### 0x38 - Personal Protective Equipment Cap Level config
Format: Single value (1 byte)
### 0x39 - Raw Gestures config
Format: Single value (1 byte)
Values: Bitmask, single press = `0x01`, double press = `0x02`, triple press = `0x04`, long press = `0x08`.
### 0x3A - Temporary Pairing Config
Format: Single value (1 byte)
Values: `0x01` = Temporary, `0x02` = Permanent
### 0x3B - Dynamic End of Charge config
Format: Single value (1 byte)
### 0x3C - System Siri message config
Format: Single value (1 byte)
### 0x3D - Hearing Aid Generic config
Format: Single value (1 byte)
### 0x3E - Uplink EQ Bud config
Format: Single value (1 byte)
### 0x3F - Uplink EQ Source config
Format: Single value (1 byte)
### 0x40 - In Case Tone Volume
Format: Single value (1 byte)
Values: 0 to 100.
### 0x41 - Disable Button Input config
Format: Single value (1 byte)
> [!NOTE]
> - These identifiers have been extracted from the macOS 15.4 Beta (24E5238a)'s bluetooth stack.
> - I have already added the ranges of values a command takes that I know of. Feel free to experiemnt by sending the packets for which the range/values are not given here.
> - These identifiers have been extracted from the iOS 19.1 Beta (23B5044l)'s bluetooth stack.
> - I have already added the ranges of values a command takes that I know of. Feel free to experiment by sending the packets for which the range/values are not given here.