Bluetooth: Audio: Upgrade from experimental to unstable

Thalley · carlescufi · commit c547079cc255 · 2024-05-17T14:33:39.000+02:00
This commit upgrades the LE audio API and implementation
from experimental to unstable.

LE Audio have existing for quite a few years in Zephyr
and is not going anywhere, but at the same time it still
has significant effort remaining before it can be
considered stable.

Signed-off-by: Emil Gydesen &lt;emil.gydesen@nordicsemi.no&gt;
diff --git a/include/zephyr/bluetooth/audio/aics.h b/include/zephyr/bluetooth/audio/aics.h
@@ -12,6 +12,9 @@
  *
  * @defgroup bt_gatt_aics Audio Input Control Service (AICS)
  *
+ * @since 2.6
+ * @version 0.8.0
+ *
  * @ingroup bluetooth
  * @{
  *
@@ -23,7 +26,6 @@
  * automatically handle any changes to that. If out of date, the client implementation will
  * autonomously read the change counter value when executing a write request.
  *
- * [Experimental] Users should note that the APIs can change as a part of ongoing development.
  */
 
 #include <zephyr/bluetooth/bluetooth.h>
diff --git a/include/zephyr/bluetooth/audio/cap.h b/include/zephyr/bluetooth/audio/cap.h
@@ -12,11 +12,11 @@
  *
  * @defgroup bt_cap Common Audio Profile (CAP)
  *
+ * @since 3.2
+ * @version 0.8.0
+ *
  * @ingroup bluetooth
  * @{
- *
- * [Experimental] Users should note that the APIs can change
- * as a part of ongoing development.
  */
 
 #include <stdint.h>
diff --git a/include/zephyr/bluetooth/audio/csip.h b/include/zephyr/bluetooth/audio/csip.h
@@ -12,10 +12,11 @@
  *
  * @defgroup bt_gatt_csip Coordinated Set Identification Profile (CSIP)
  *
+ * @since 3.0
+ * @version 0.8.0
+ *
  * @ingroup bluetooth
  * @{
- * *
- * [Experimental] Users should note that the APIs can change as a part of ongoing development.
  */
 
 #include <zephyr/bluetooth/conn.h>
diff --git a/include/zephyr/bluetooth/audio/has.h b/include/zephyr/bluetooth/audio/has.h
@@ -12,14 +12,14 @@
  *
  * @defgroup bt_has Hearing Access Service (HAS)
  *
+ * @since 3.1
+ * @version 0.8.0
+ *
  * @ingroup bluetooth
  * @{
  *
  * The Hearing Access Service is used to identify a hearing aid and optionally
  * to control hearing aid presets.
- *
- * [Experimental] Users should note that the APIs can change as a part of
- * ongoing development.
  */
 
 #include <sys/types.h>
diff --git a/include/zephyr/bluetooth/audio/mcc.h b/include/zephyr/bluetooth/audio/mcc.h
@@ -5,11 +5,11 @@
  *
  * @defgroup bt_gatt_mcc Media Control Client (MCC)
  *
+ * @since 3.0
+ * @version 0.8.0
+ *
  * @ingroup bluetooth
  * @{
- *
- * [Experimental] Users should note that the APIs can change
- * as a part of ongoing development.
  */
 
 /*
diff --git a/include/zephyr/bluetooth/audio/mcs.h b/include/zephyr/bluetooth/audio/mcs.h
@@ -12,12 +12,12 @@
  *
  * @defgroup bt_mcs Media Control Service (MCS)
  *
+ * @since 3.0
+ * @version 0.8.0
+ *
  * @ingroup bluetooth
  * @{
  *
- * [Experimental] Users should note that the APIs can change
- * as a part of ongoing development.
- *
  * Definitions and types related to the Media Control Service and Media Control
  * Profile specifications.
  */
diff --git a/include/zephyr/bluetooth/audio/media_proxy.h b/include/zephyr/bluetooth/audio/media_proxy.h
@@ -11,6 +11,9 @@
  *
  * @defgroup bt_media_proxy Media Proxy
  *
+ * @since 3.0
+ * @version 0.8.0
+ *
  * @ingroup bluetooth
  * @{
  *
@@ -31,9 +34,6 @@
  * application, or it may be a Media Control Service relaying requests
  * from a remote Media Control Client. There may be either local or
  * remote control, or both, or even multiple instances of each.
- *
- * [Experimental] Users should note that the APIs can change
- * as a part of ongoing development.
  */
 
 #include <stdint.h>
diff --git a/include/zephyr/bluetooth/audio/micp.h b/include/zephyr/bluetooth/audio/micp.h
@@ -12,11 +12,11 @@
  *
  * @defgroup bt_gatt_micp Microphone Control Profile (MICP)
  *
+ * @since 2.7
+ * @version 0.8.0
+ *
  * @ingroup bluetooth
  * @{
- *
- * [Experimental] Users should note that the APIs can change
- * as a part of ongoing development.
  */
 
 #include <stdint.h>
diff --git a/include/zephyr/bluetooth/audio/pbp.h b/include/zephyr/bluetooth/audio/pbp.h
@@ -12,11 +12,11 @@
  *
  * @defgroup bt_pbp Public Broadcast Profile (PBP)
  *
+ * @since 3.5
+ * @version 0.8.0
+ *
  * @ingroup bluetooth
  * @{
- *
- * [Experimental] Users should note that the APIs can change
- * as a part of ongoing development.
  */
 
 #include <zephyr/sys/util.h>
diff --git a/include/zephyr/bluetooth/audio/vcp.h b/include/zephyr/bluetooth/audio/vcp.h
@@ -12,11 +12,11 @@
  *
  * @defgroup bt_gatt_vcp Volume Control Profile (VCP)
  *
+ * @since 2.7
+ * @version 0.8.0
+ *
  * @ingroup bluetooth
  * @{
- *
- * [Experimental] Users should note that the APIs can change
- * as a part of ongoing development.
  */
 
 #include <stdint.h>
diff --git a/include/zephyr/bluetooth/audio/vocs.h b/include/zephyr/bluetooth/audio/vocs.h
@@ -12,6 +12,9 @@
  *
  * @defgroup bt_gatt_vocs Volume Offset Control Service (VOCS)
  *
+ * @since 2.6
+ * @version 0.8.0
+ *
  * @ingroup bluetooth
  * @{
  *
@@ -22,8 +25,6 @@
  * Note that the API abstracts away the change counter in the volume offset control state and will
  * automatically handle any changes to that. If out of date, the client implementation will
  * autonomously read the change counter value when executing a write request.
- *
- * [Experimental] Users should note that the APIs can change as a part of ongoing development.
  */
 
 #include <stdint.h>
diff --git a/subsys/bluetooth/audio/Kconfig b/subsys/bluetooth/audio/Kconfig
@@ -8,8 +8,7 @@
 #
 
 menuconfig BT_AUDIO
-	bool "Bluetooth Audio support [EXPERIMENTAL]"
-	select EXPERIMENTAL
+	bool "Bluetooth Audio support"
 	help
 	  This option enables Bluetooth Audio support. The specific
 	  features that are available may depend on other features
diff --git a/subsys/bluetooth/audio/Kconfig.aics b/subsys/bluetooth/audio/Kconfig.aics
@@ -9,7 +9,7 @@
 ##################### Audio Input Control Service #####################
 
 config BT_AICS_MAX_INSTANCE_COUNT
-	int "Audio Input Control Service max instance count [EXPERIMENTAL]"
+	int "Audio Input Control Service max instance count"
 	default 0
 	range 0 15
 	help
@@ -19,7 +19,6 @@ config BT_AICS_MAX_INSTANCE_COUNT
 config BT_AICS
 	bool # hidden
 	default y if BT_AICS_MAX_INSTANCE_COUNT > 0
-	select EXPERIMENTAL
 	select BT_GATT_DYNAMIC_DB
 	help
 	  This hidden option enables support for Audio Input Control Service.
@@ -38,7 +37,7 @@ endif # BT_AICS
 ##################### Audio Input Control Service Client #####################
 
 config BT_AICS_CLIENT_MAX_INSTANCE_COUNT
-	int "Audio Input Control Service client max instance count [EXPERIMENTAL]"
+	int "Audio Input Control Service client max instance count"
 	default 0
 	range 0 15
 	help
@@ -48,6 +47,5 @@ config BT_AICS_CLIENT_MAX_INSTANCE_COUNT
 config BT_AICS_CLIENT
 	bool # hidden
 	default y if BT_AICS_CLIENT_MAX_INSTANCE_COUNT > 0
-	select EXPERIMENTAL
 	help
 	  This hidden option enables support for Audio Input Control Service.
diff --git a/subsys/bluetooth/audio/Kconfig.bap b/subsys/bluetooth/audio/Kconfig.bap
@@ -13,8 +13,7 @@ config BT_BAP_UNICAST
 	select BT_ISO_UNICAST
 
 config BT_BAP_UNICAST_SERVER
-	bool "Bluetooth Unicast Audio Server Support [EXPERIMENTAL]"
-	select EXPERIMENTAL
+	bool "Bluetooth Unicast Audio Server Support"
 	select BT_BAP_UNICAST
 	select BT_GATT_DYNAMIC_DB
 	select BT_GATT_CACHING
@@ -27,8 +26,7 @@ config BT_BAP_UNICAST_SERVER
 	  using Isochronous channels.
 
 config BT_BAP_UNICAST_CLIENT
-	bool "Bluetooth Unicast Audio Client Support [EXPERIMENTAL]"
-	select EXPERIMENTAL
+	bool "Bluetooth Unicast Audio Client Support"
 	select BT_BAP_UNICAST
 	select BT_ISO_CENTRAL
 	select BT_CENTRAL
@@ -127,8 +125,7 @@ config BT_BAP_UNICAST_CLIENT_ASE_SRC
 endif # BT_BAP_UNICAST_CLIENT
 
 config BT_BAP_BROADCAST_SOURCE
-	bool "Bluetooth Broadcast Source Audio Support [EXPERIMENTAL]"
-	select EXPERIMENTAL
+	bool "Bluetooth Broadcast Source Audio Support"
 	select BT_ISO_BROADCASTER
 	select BT_AUDIO_TX
 	help
@@ -167,8 +164,7 @@ config BT_BAP_BROADCAST_SRC_STREAM_COUNT
 endif # BT_BAP_BROADCAST_SOURCE
 
 config BT_BAP_BROADCAST_SINK
-	bool "Bluetooth Broadcast Sink Audio Support [EXPERIMENTAL]"
-	select EXPERIMENTAL
+	bool "Bluetooth Broadcast Sink Audio Support"
 	select BT_ISO_SYNC_RECEIVER
 	select BT_AUDIO_RX
 	select BT_PAC_SNK
@@ -211,8 +207,7 @@ config BT_BAP_BROADCAST_SNK_STREAM_COUNT
 endif # BT_BAP_BROADCAST_SINK
 
 config BT_BAP_SCAN_DELEGATOR
-	bool "Basic Audio Profile Scan Delegator role support [EXPERIMENTAL]"
-	select EXPERIMENTAL
+	bool "Basic Audio Profile Scan Delegator role support"
 	select BT_OBSERVER
 	select BT_EXT_ADV
 	select BT_PER_ADV_SYNC
@@ -244,8 +239,7 @@ config BT_BAP_SCAN_DELEGATOR_BUF_TIMEOUT
 endif # BT_BAP_SCAN_DELEGATOR
 
 config BT_BAP_BROADCAST_ASSISTANT
-	bool "Basic Audio Profile Broadcast Assistant role support [EXPERIMENTAL]"
-	select EXPERIMENTAL
+	bool "Basic Audio Profile Broadcast Assistant role support"
 	select BT_OBSERVER
 	select BT_EXT_ADV
 	select BT_PER_ADV_SYNC
diff --git a/subsys/bluetooth/audio/Kconfig.cap b/subsys/bluetooth/audio/Kconfig.cap
@@ -9,10 +9,9 @@ config BT_CAP
 	def_bool BT_CAP_ACCEPTOR || BT_CAP_INITIATOR
 
 config BT_CAP_ACCEPTOR
-	bool "Common Audio Profile Acceptor Role Support [EXPERIMENTAL]"
+	bool "Common Audio Profile Acceptor Role Support"
 	depends on BT_BAP_UNICAST_SERVER || (BT_BAP_BROADCAST_SINK && BT_BAP_SCAN_DELEGATOR)
 	depends on BT_AUDIO_CODEC_CFG_MAX_METADATA_SIZE >= 4
-	select EXPERIMENTAL
 	help
 	  Enabling this will enable the CAP Acceptor role. This instantiates the
 	  common audio service (CAS).
@@ -32,22 +31,20 @@ config BT_CAP_INITIATOR_UNICAST
 	def_bool BT_CAP_INITIATOR && BT_BAP_UNICAST_CLIENT
 
 config BT_CAP_INITIATOR
-	bool "Common Audio Profile Initiator Role Support [EXPERIMENTAL]"
+	bool "Common Audio Profile Initiator Role Support"
 	depends on (BT_BAP_UNICAST_CLIENT && BT_CSIP_SET_COORDINATOR) || BT_BAP_BROADCAST_SOURCE
 	depends on BT_AUDIO_CODEC_CFG_MAX_METADATA_SIZE >= 4
-	select EXPERIMENTAL
 	help
 	  Enabling this will enable the CAP Initiator role.
 
 
 config BT_CAP_COMMANDER
-	bool "Common Audio Profile Initiator Role Support [EXPERIMENTAL]"
+	bool "Common Audio Profile Initiator Role Support"
 	depends on (BT_BAP_BROADCAST_ASSISTANT && BT_BAP_SCAN_DELEGATOR && BT_CSIP_SET_COORDINATOR) || \
 		   (BT_BAP_SCAN_DELEGATOR && BT_CSIP_SET_COORDINATOR) || \
 		   (BT_VCP_VOL_CTLR && BT_CSIP_SET_COORDINATOR) || \
 		   (BT_MICP_MIC_CTLR && BT_CSIP_SET_COORDINATOR) || \
 		   BT_TBS_CLIENT || \
 		   BT_MCC
-	select EXPERIMENTAL
 	help
 	  Enabling this will enable the CAP Initiator role.
diff --git a/subsys/bluetooth/audio/Kconfig.csip b/subsys/bluetooth/audio/Kconfig.csip
@@ -9,9 +9,8 @@
 #################### Coordinated Set Identification Service ####################
 
 config BT_CSIP_SET_MEMBER
-	bool "Coordinated Set Identification Profile Set Member support [EXPERIMENTAL]"
+	bool "Coordinated Set Identification Profile Set Member support"
 	imply BT_EXT_ADV if BT_PRIVACY
-	select EXPERIMENTAL
 	help
 	  This option enables support for Coordinated Set Identification
 	  Profile Set Member role and the Coordinated Set Identification
@@ -57,10 +56,9 @@ endif # BT_CSIP_SET_MEMBER
 #################### Coordinated Set Identification Client ####################
 
 config BT_CSIP_SET_COORDINATOR
-	bool "Coordinated Set Identification Profile Set Coordinator Support [EXPERIMENTAL]"
+	bool "Coordinated Set Identification Profile Set Coordinator Support"
 	select BT_GATT_CLIENT
 	select BT_GATT_AUTO_DISCOVER_CCC
-	select EXPERIMENTAL
 	help
 	  This option enables support for Coordinated Set Identification
 	  Profile Set Coordinator.
diff --git a/subsys/bluetooth/audio/Kconfig.gmap b/subsys/bluetooth/audio/Kconfig.gmap
@@ -18,9 +18,8 @@ config BT_GMAP_BGR_SUPPORTED
 	def_bool BT_CAP_ACCEPTOR && BT_BAP_BROADCAST_SINK && BT_VCP_VOL_REND
 
 config BT_GMAP
-	bool "Gaming Audio Profile [EXPERIMENTAL]"
+	bool "Gaming Audio Profile"
 	depends on BT_CAP_ACCEPTOR || BT_CAP_INITIATOR
-	select EXPERIMENTAL
 	help
 	  Enabling this will enable GMAP.
 
diff --git a/subsys/bluetooth/audio/Kconfig.has b/subsys/bluetooth/audio/Kconfig.has
@@ -5,8 +5,7 @@
 # SPDX-License-Identifier: Apache-2.0
 
 menuconfig BT_HAS
-	bool "Hearing Access Service support [EXPERIMENTAL]"
-	select EXPERIMENTAL
+	bool "Hearing Access Service support"
 	select UTF8
 	select BT_GATT_DYNAMIC_DB
 	depends on BT_BAP_UNICAST_SERVER
@@ -56,8 +55,7 @@ endif # BT_HAS_PRESET_SUPPORT
 endif # BT_HAS
 
 config BT_HAS_CLIENT
-	bool "Hearing Access Service Client support [EXPERIMENTAL]"
-	select EXPERIMENTAL
+	bool "Hearing Access Service Client support"
 	select BT_GATT_CLIENT
 	select BT_GATT_AUTO_DISCOVER_CCC
 	select BT_GATT_AUTO_UPDATE_MTU
diff --git a/subsys/bluetooth/audio/Kconfig.mcs b/subsys/bluetooth/audio/Kconfig.mcs
@@ -13,7 +13,6 @@ config BT_MCS
 	depends on MCTL_LOCAL_PLAYER_REMOTE_CONTROL
 	depends on UTF8
 	select BT_CCID
-	select EXPERIMENTAL
 	select BT_GATT_DYNAMIC_DB
 	help
 	  This option enables support for the Media Control Service.
@@ -24,7 +23,6 @@ config BT_MCC
 	bool "Media Control Client Support"
 	select BT_GATT_CLIENT
 	select BT_GATT_AUTO_DISCOVER_CCC
-	select EXPERIMENTAL
 	help
 	  This option enables support for the Media Control Client.
 
diff --git a/subsys/bluetooth/audio/Kconfig.mctl b/subsys/bluetooth/audio/Kconfig.mctl
@@ -11,7 +11,6 @@
 
 config MCTL
 	bool "Support for media player control"
-	select EXPERIMENTAL
 	help
 	  Enables support for control of local and remote media players
 	  To enable support for control of a local media player, support for
diff --git a/subsys/bluetooth/audio/Kconfig.micp b/subsys/bluetooth/audio/Kconfig.micp
diff --git a/subsys/bluetooth/audio/Kconfig.mpl b/subsys/bluetooth/audio/Kconfig.mpl
diff --git a/subsys/bluetooth/audio/Kconfig.pbp b/subsys/bluetooth/audio/Kconfig.pbp
diff --git a/subsys/bluetooth/audio/Kconfig.tmap b/subsys/bluetooth/audio/Kconfig.tmap
diff --git a/subsys/bluetooth/audio/Kconfig.vcp b/subsys/bluetooth/audio/Kconfig.vcp
diff --git a/subsys/bluetooth/audio/Kconfig.vocs b/subsys/bluetooth/audio/Kconfig.vocs

Original file line number	Diff line number	Diff line change
`@@ -12,6 +12,9 @@`
`12`	`12`	`*`
`13`	`13`	`* @defgroup bt_gatt_aics Audio Input Control Service (AICS)`
`14`	`14`	`*`
	`15`	`+ * @since 2.6`
	`16`	`+ * @version 0.8.0`
	`17`	`+ *`
`15`	`18`	`* @ingroup bluetooth`
`16`	`19`	`* @{`
`17`	`20`	`*`
`@@ -23,7 +26,6 @@`
`23`	`26`	`* automatically handle any changes to that. If out of date, the client implementation will`
`24`	`27`	`* autonomously read the change counter value when executing a write request.`
`25`	`28`	`*`
`26`		`- * [Experimental] Users should note that the APIs can change as a part of ongoing development.`
`27`	`29`	`*/`
`28`	`30`
`29`	`31`	`#include <zephyr/bluetooth/bluetooth.h>`
Original file line number	Diff line number	Diff line change
`@@ -12,11 +12,11 @@`
`12`	`12`	`*`
`13`	`13`	`* @defgroup bt_cap Common Audio Profile (CAP)`
`14`	`14`	`*`
	`15`	`+ * @since 3.2`
	`16`	`+ * @version 0.8.0`
	`17`	`+ *`
`15`	`18`	`* @ingroup bluetooth`
`16`	`19`	`* @{`
`17`		`- *`
`18`		`- * [Experimental] Users should note that the APIs can change`
`19`		`- * as a part of ongoing development.`
`20`	`20`	`*/`
`21`	`21`
`22`	`22`	`#include <stdint.h>`
Original file line number	Diff line number	Diff line change
`@@ -12,10 +12,11 @@`
`12`	`12`	`*`
`13`	`13`	`* @defgroup bt_gatt_csip Coordinated Set Identification Profile (CSIP)`
`14`	`14`	`*`
	`15`	`+ * @since 3.0`
	`16`	`+ * @version 0.8.0`
	`17`	`+ *`
`15`	`18`	`* @ingroup bluetooth`
`16`	`19`	`* @{`
`17`		`- * *`
`18`		`- * [Experimental] Users should note that the APIs can change as a part of ongoing development.`
`19`	`20`	`*/`
`20`	`21`
`21`	`22`	`#include <zephyr/bluetooth/conn.h>`
Original file line number	Diff line number	Diff line change
`@@ -12,14 +12,14 @@`
`12`	`12`	`*`
`13`	`13`	`* @defgroup bt_has Hearing Access Service (HAS)`
`14`	`14`	`*`
	`15`	`+ * @since 3.1`
	`16`	`+ * @version 0.8.0`
	`17`	`+ *`
`15`	`18`	`* @ingroup bluetooth`
`16`	`19`	`* @{`
`17`	`20`	`*`
`18`	`21`	`* The Hearing Access Service is used to identify a hearing aid and optionally`
`19`	`22`	`* to control hearing aid presets.`
`20`		`- *`
`21`		`- * [Experimental] Users should note that the APIs can change as a part of`
`22`		`- * ongoing development.`
`23`	`23`	`*/`
`24`	`24`
`25`	`25`	`#include <sys/types.h>`
Original file line number	Diff line number	Diff line change
`@@ -5,11 +5,11 @@`
`5`	`5`	`*`
`6`	`6`	`* @defgroup bt_gatt_mcc Media Control Client (MCC)`
`7`	`7`	`*`
	`8`	`+ * @since 3.0`
	`9`	`+ * @version 0.8.0`
	`10`	`+ *`
`8`	`11`	`* @ingroup bluetooth`
`9`	`12`	`* @{`
`10`		`- *`
`11`		`- * [Experimental] Users should note that the APIs can change`
`12`		`- * as a part of ongoing development.`
`13`	`13`	`*/`
`14`	`14`
`15`	`15`	`/*`
Original file line number	Diff line number	Diff line change
`@@ -12,12 +12,12 @@`
`12`	`12`	`*`
`13`	`13`	`* @defgroup bt_mcs Media Control Service (MCS)`
`14`	`14`	`*`
	`15`	`+ * @since 3.0`
	`16`	`+ * @version 0.8.0`
	`17`	`+ *`
`15`	`18`	`* @ingroup bluetooth`
`16`	`19`	`* @{`
`17`	`20`	`*`
`18`		`- * [Experimental] Users should note that the APIs can change`
`19`		`- * as a part of ongoing development.`
`20`		`- *`
`21`	`21`	`* Definitions and types related to the Media Control Service and Media Control`
`22`	`22`	`* Profile specifications.`
`23`	`23`	`*/`
Original file line number	Diff line number	Diff line change
`@@ -11,6 +11,9 @@`
`11`	`11`	`*`
`12`	`12`	`* @defgroup bt_media_proxy Media Proxy`
`13`	`13`	`*`
	`14`	`+ * @since 3.0`
	`15`	`+ * @version 0.8.0`
	`16`	`+ *`
`14`	`17`	`* @ingroup bluetooth`
`15`	`18`	`* @{`
`16`	`19`	`*`
`@@ -31,9 +34,6 @@`
`31`	`34`	`* application, or it may be a Media Control Service relaying requests`
`32`	`35`	`* from a remote Media Control Client. There may be either local or`
`33`	`36`	`* remote control, or both, or even multiple instances of each.`
`34`		`- *`
`35`		`- * [Experimental] Users should note that the APIs can change`
`36`		`- * as a part of ongoing development.`
`37`	`37`	`*/`
`38`	`38`
`39`	`39`	`#include <stdint.h>`