Optional support for ASHA Sink with advertisement

Author: arkq

.github/spellcheck-wordlist.txt

@@ -153,6 +153,7 @@ ARGS
 asound
 asoundrc
 asrsync
+ATT
 autoreconf
 ay
 BAC
@@ -163,8 +164,8 @@ BCS
 bdaddr
 bfr
 bluealsa
-bluealsad
 BlueALSA's
+bluealsad
 bluetoothctl
 bluetoothd
 BRSF
@@ -182,6 +183,7 @@ CKPD
 CLCC
 CLCK
 CMER
+CoC
 ctrl
 ctx
 dbus
@@ -195,7 +197,6 @@ dpsnk
 dpsrc
 DYN
 EAGAIN
-EDE
 EINTR
 EINVAL
 ENODEV
@@ -207,7 +208,6 @@ EQMID
 errno
 FB
 FC
-fdf
 fdX
 ffb
 ffff
@@ -225,6 +225,7 @@ HCTL
 HEv
 hfpag
 hfphf
+HiSync
 HiSyncId
 hspag
 hsphs
@@ -258,6 +259,7 @@ openaptx
 PCH
 pfd
 pfds
+PSM
 pthread
 ptr
 qsort

.github/spellcheck.yaml

@@ -52,6 +52,10 @@ matrix:
       # Ignore parameter name in docstring
       - open: '@param '
         close: '\W'
+      # Ignore UUID strings
+      - open: '[0-9a-f]{8}-[0-9a-f]{4}-'
+        content: '[0-9a-f]{4}-[0-9a-f]{4}-'
+        close: '[0-9a-f]{12}'
       # Ignore printf format placeholder
       - open: '%'
         content: '#?(l|z)'

doc/bluealsad.8.rst

@@ -1,4 +1,4 @@
-.. SPDX-FileCopyrightText: 2020-2025 BlueALSA developers
+.. SPDX-FileCopyrightText: 2020-2026 BlueALSA developers
 .. SPDX-License-Identifier: MIT
 
 =========
@@ -9,7 +9,7 @@ bluealsad
 Bluetooth Audio ALSA Backend
 ----------------------------
 
-:Date: December 2025
+:Date: January 2026
 :Manual section: 8
 :Manual group: System Manager's Manual
 :Version: $VERSION$
@@ -264,8 +264,31 @@ OPTIONS
     - **standard** - standard quality (44.1 kHz: 606 kbps, 48 kHz: 660 kbps)
     - **high** - high quality (44.1 kHz: 909 kbps, 48 kHz: 990 kbps)
 
+--asha-sync-id=ID
+    Set ASHA Sink HiSync ID to *ID*.
+
+    The *ID* must be a 16-digit hexadecimal number (64 bits).
+
+--asha-side=SIDE
+    Set ASHA Sink device side to *SIDE*.
+    Default value is **left**.
+
+    The *SIDE* can be one of:
+
+    - **left** - left side device
+    - **left+** - left side of a binaural device
+    - **right** - right side device
+    - **right+** - right side of a binaural device
+
+--asha-advertise
+    Enable LE advertising for ASHA Sink.
+
+--asha-adv-name=NAME
+    Set the name used in the ASHA Sink advertising.
+    By default, the name is set as "BlueALSA ASHA".
+
 --midi-advertise
-    Advertise BLE-MIDI service using Bluetooth LE advertising.
+    Enable LE advertising for BLE-MIDI.
 
 --midi-adv-name=NAME
     Set the name used in the BLE-MIDI advertising.
@@ -340,6 +363,7 @@ The list of profile *NAME*-s accepted by the ``--profile=NAME`` option:
 - **a2dp-source** - Advanced Audio Source (streaming audio to connected device)
 - **a2dp-sink** - Advanced Audio Sink (receiving audio from connected device)
 - **asha-source** - Audio Streaming for Hearing Aids Source
+- **asha-sink** - Audio Streaming for Hearing Aids Sink
 - **hfp-ofono** - Hands-Free AG/HF handled by oFono
 - **hfp-ag** - Hands-Free Audio Gateway
 - **hfp-hf** - Hands-Free

misc/bash-completion/bluealsad

@@ -211,7 +211,7 @@ _bluealsad() {
 			readarray -t COMPREPLY < <(compgen -P "$prefix" -W "${list[*]}" -- "$cur")
 			return
 			;;
-		--loglevel|--sbc-quality|--aac-latm-version|--mp3-algorithm|--mp3-vbr-quality|--ldac-quality)
+		--loglevel|--sbc-quality|--aac-latm-version|--mp3-algorithm|--mp3-vbr-quality|--ldac-quality|--asha-side)
 			readarray -t list < <(_bluealsa_enum_values "$1" "$prev")
 			readarray -t COMPREPLY < <(compgen -W "${list[*]}" -- "$cur")
 			return

src/Makefile.am

@@ -1,5 +1,5 @@
 # BlueALSA - Makefile.am
-# SPDX-FileCopyrightText: 2016-2025 BlueALSA developers
+# SPDX-FileCopyrightText: 2016-2026 BlueALSA developers
 # SPDX-License-Identifier: MIT
 
 SUBDIRS = shared
@@ -23,6 +23,8 @@ BUILT_SOURCES = \
 	dbus/org.ofono.h \
 	dbus/org.ofono.c
 
+CODEGEN_DEFS =
+
 MOSTLYCLEANFILES = \
 	$(dist_dbusconf_DATA) \
 	$(BUILT_SOURCES)
@@ -83,9 +85,13 @@ libbluealsad_la_SOURCES += \
 endif
 
 if ENABLE_ASHA
+CODEGEN_DEFS += --define=ENABLE_GATT
 libbluealsad_la_SOURCES += \
 	asha-g722.c \
-	asha.c
+	asha.c \
+	bt-asha.c \
+	bt-advertising.c \
+	bt-gatt.c
 endif
 
 if ENABLE_FASTSTREAM
@@ -110,9 +116,10 @@ libbluealsad_la_SOURCES += \
 endif
 
 if ENABLE_MIDI
+CODEGEN_DEFS += --define=ENABLE_GATT
 libbluealsad_la_SOURCES += \
 	ble-midi.c \
-	bluez-midi.c \
+	bt-midi.c \
 	bt-advertising.c \
 	bt-gatt.c \
 	midi.c
@@ -201,11 +208,6 @@ DBUSCONF_SUBS = \
 .conf.in.conf:
 	$(SED) -e '$(DBUSCONF_SUBS)' < $< > $@
 
-CODEGEN_DEFS =
-if ENABLE_MIDI
-CODEGEN_DEFS += --define=ENABLE_MIDI
-endif
-
 .xml.h:
 	$(srcdir)/dbus/dbus-codegen.py --output $@ $(CODEGEN_DEFS) \
 		--interface-info-header --interface-skeleton-header $<

src/ba-config.c

@@ -24,6 +24,8 @@
 
 #include "codec-sbc.h"
 #include "hfp.h"
+#include "shared/bluetooth.h"
+#include "shared/bluetooth-asha.h"
 
 /* Initialize global configuration variable. */
 struct ba_config config = {
@@ -55,8 +57,8 @@ struct ba_config config = {
 	.hfp.codecs.lc3_swb = true,
 #endif
 
-	/* built-in Apple accessory identification */
-	.hfp.xapl_vendor_id = 0xB103,
+	/* Built-in Apple accessory identification. */
+	.hfp.xapl_vendor_id = BT_COMPID_LINUX_FOUNDATION,
 	.hfp.xapl_product_id = 0xA15A,
 	.hfp.xapl_sw_version = 0x0400,
 	.hfp.xapl_product_name = "BlueALSA",
@@ -74,7 +76,12 @@ struct ba_config config = {
 	.a2dp.force_44100 = false,
 
 #if ENABLE_ASHA
+	.asha.id = ASHA_HI_SYNC_ID_INIT(
+			BT_COMPID_LINUX_FOUNDATION, 0xB1, 0x03, 0xA1, 0x5A, 0x04, 0x05),
+	.asha.side = ASHA_CAPABILITY_SIDE_LEFT,
 	.asha.codecs.g722 = true,
+	.asha.advertise = false,
+	.asha.name = "BlueALSA ASHA",
 #endif
 
 #if ENABLE_MIDI
@@ -134,13 +141,9 @@ struct ba_config config = {
 };
 
 int ba_config_init(void) {
-
 	config.hci_filter = g_array_sized_new(FALSE, FALSE, sizeof(const char *), 4);
-
 	config.main_thread = pthread_self();
-
 	config.null_fd = open("/dev/null", O_WRONLY | O_NONBLOCK);
-
 	return 0;
 }
 

src/ba-config.h

@@ -23,6 +23,8 @@
 #include <gio/gio.h>
 #include <glib.h>
 
+#include "shared/bluetooth-asha.h"
+
 struct ba_config {
 
 	/* set of enabled profiles */
@@ -120,11 +122,26 @@ struct ba_config {
 		bool force_44100;
 
 	} a2dp;
+
 #if ENABLE_ASHA
 	struct {
+
+		/* Device ID. */
+		asha_hi_sync_id_t id;
+		/* The side of the device. */
+		unsigned int side;
+		/* Indicates whether the device is part of a binaural set. */
+		bool binaural;
+
 		struct {
 			bool g722;
 		} codecs;
+
+		/* Advertise ASHA via LE advertisement. */
+		bool advertise;
+		/* Name used in the LE advertisement. */
+		char name[16];
+
 	} asha;
 #endif
 

src/bluez.c

@@ -1,6 +1,6 @@
 /*
  * BlueALSA - bluez.c
- * SPDX-FileCopyrightText: 2016-2025 BlueALSA developers
+ * SPDX-FileCopyrightText: 2016-2026 BlueALSA developers
  * SPDX-License-Identifier: MIT
  */
 
@@ -39,9 +39,8 @@
 #include "ba-transport-pcm.h"
 #include "bluealsa-dbus.h"
 #include "bluez-iface.h"
-#if ENABLE_MIDI
-# include "bluez-midi.h"
-#endif
+#include "bt-asha.h"
+#include "bt-midi.h"
 #include "dbus.h"
 #include "error.h"
 #include "hci.h"
@@ -83,18 +82,22 @@ struct bluez_dbus_object_data {
 /**
  * BlueALSA copy of BlueZ adapter data. */
 struct bluez_adapter {
-	/* reference to the adapter structure */
-	struct ba_adapter *adapter;
-	/* manager for media endpoint objects */
-	GDBusObjectManagerServer *manager_media_application;
-	/* manager for battery provider objects */
-	GDBusObjectManagerServer *manager_battery_provider;
+	/* Reference to the adapter structure. */
+	struct ba_adapter * adapter;
+	/* Manager for media endpoint objects. */
+	GDBusObjectManagerServer * manager_media_application;
+	/* Manager for battery provider objects. */
+	GDBusObjectManagerServer * manager_battery_provider;
+#if ENABLE_ASHA
+	/* Bluetooth ASHA based on BlueZ GATT application. */
+	BluetoothASHA * asha;
+#endif
 #if ENABLE_MIDI
 	/* Bluetooth LE MIDI based on BlueZ GATT application. */
 	BluetoothMIDI * midi;
 #endif
-	/* array of SEP configs per connected devices */
-	GHashTable *device_sep_configs_map;
+	/* Array of SEP configs per connected devices. */
+	GHashTable * device_sep_configs_map;
 };
 
 static pthread_mutex_t bluez_mutex = PTHREAD_MUTEX_INITIALIZER;
@@ -222,6 +225,14 @@ static void bluez_adapter_register_media_application(
  * to be available on the given adapter. */
 static void bluez_adapter_register_gatt_applications(
 		G_GNUC_UNUSED struct bluez_adapter * b_adapter) {
+#if ENABLE_ASHA
+	if (config.profile.asha_sink) {
+		char path[64];
+		struct ba_adapter * a = b_adapter->adapter;
+		snprintf(path, sizeof(path), "/org/bluez/%s/ASHA", a->hci.name);
+		b_adapter->asha = bluetooth_asha_new(a, path);
+	}
+#endif
 #if ENABLE_MIDI
 	if (config.profile.midi) {
 		char path[64];
@@ -236,6 +247,9 @@ static void bluez_adapter_free(
 		struct bluez_adapter * b_adapter) {
 	if (b_adapter->adapter == NULL)
 		return;
+#if ENABLE_ASHA
+	g_clear_object(&b_adapter->asha);
+#endif
 #if ENABLE_MIDI
 	g_clear_object(&b_adapter->midi);
 #endif
@@ -1294,9 +1308,9 @@ static void bluez_media_endpoint_process_asha(
 		goto fail;
 	}
 
-	/* Make sure that HiSyncId size is valid. */
+	/* Make sure that HiSync ID size is valid. */
 	if (id_size != sizeof(asha_hi_sync_id_t)) {
-		error("Invalid HiSyncId size: %zu != %zu", id_size, sizeof(asha_hi_sync_id_t));
+		error("Invalid HiSync ID size: %zu != %zu", id_size, sizeof(asha_hi_sync_id_t));
 		goto fail;
 	}