aboutsummaryrefslogtreecommitdiffstats
path: root/desktop/island/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'desktop/island/README.md')
-rw-r--r--desktop/island/README.md20
1 files changed, 16 insertions, 4 deletions
diff --git a/desktop/island/README.md b/desktop/island/README.md
index 9c33f41..9353f7e 100644
--- a/desktop/island/README.md
+++ b/desktop/island/README.md
@@ -47,10 +47,22 @@ is open or not. Click opens the calendar panel.
## Status pill
-Left to right: volume icon, tray, layout flag. The performance panel that
-used to open from here is the drawer's Performance page now
-(`desktop/modules/perf/`).
-
+Left to right: headphones icon, volume icon, tray, layout flag. The
+performance panel that used to open from here is the drawer's Performance
+page now (`desktop/modules/perf/`).
+
+- **Headphones icon** shows while Sony headphones are connected (a BlueZ
+ name starting `WH-`, `WF-` or `LinkBuds`). Click opens the headphones
+ panel: battery (BlueZ), noise control tiles (ANC, ambient, off), the
+ ambient level (1-20, drag or wheel, sent once it settles) and focus on
+ voice (both shown in ambient mode only), the headphones'
+ own sink volume (their `bluez_output` node, not the default sink; wheel
+ steps 5%, the icon mutes), power off and refresh. The mode goes
+ through `sonyctl`, which speaks Sony's v2 protocol over RFCOMM channel 18
+ and is read on every open, since the headphones' button changes it too.
+ Each call is about 2s, so the panel takes one at a time. Test:
+ `/usr/bin/python3 desktop/island/test_sonyctl.py` (codec only, no
+ Bluetooth).
- **Volume icon** shows the default sink (muted, low, medium, high). Click
opens the sound panel.
- **Tray** shows `SystemTray` items. Left click activates, right click opens