[PATCH v2] Bluetooth: Add ABI doc for sysfs reset

Hsin-chen Chuang posted 1 patch 1 year ago
Documentation/ABI/stable/sysfs-class-bluetooth | 9 +++++++++
MAINTAINERS                                    | 1 +
2 files changed, 10 insertions(+)
create mode 100644 Documentation/ABI/stable/sysfs-class-bluetooth
[PATCH v2] Bluetooth: Add ABI doc for sysfs reset
Posted by Hsin-chen Chuang 1 year ago
From: Hsin-chen Chuang <chharry@chromium.org>

The functionality was implemented in commit 0f8a00137411 ("Bluetooth:
Allow reset via sysfs")

Fixes: 0f8a00137411 ("Bluetooth: Allow reset via sysfs")
Signed-off-by: Hsin-chen Chuang <chharry@chromium.org>
---

Changes in v2:
- Resolved review comments from Paul

 Documentation/ABI/stable/sysfs-class-bluetooth | 9 +++++++++
 MAINTAINERS                                    | 1 +
 2 files changed, 10 insertions(+)
 create mode 100644 Documentation/ABI/stable/sysfs-class-bluetooth

diff --git a/Documentation/ABI/stable/sysfs-class-bluetooth b/Documentation/ABI/stable/sysfs-class-bluetooth
new file mode 100644
index 000000000000..36be02471174
--- /dev/null
+++ b/Documentation/ABI/stable/sysfs-class-bluetooth
@@ -0,0 +1,9 @@
+What: 		/sys/class/bluetooth/hci<index>/reset
+Date:		14-Jan-2025
+KernelVersion:	6.13
+Contact:	linux-bluetooth@vger.kernel.org
+Description: 	This write-only attribute allows users to trigger the vendor reset
+		method on the Bluetooth device when arbitrary data is written.
+		The reset may or may not be done through the device transport
+		(e.g., UART/USB), and can also be done through an out-of-band
+		approach such as GPIO.
diff --git a/MAINTAINERS b/MAINTAINERS
index 797e94ba74f7..e949c3ac7846 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -4058,6 +4058,7 @@ S:	Supported
 W:	http://www.bluez.org/
 T:	git git://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth.git
 T:	git git://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth-next.git
+F:	Documentation/ABI/stable/sysfs-class-bluetooth
 F:	include/net/bluetooth/
 F:	net/bluetooth/
 
-- 
2.48.0.rc2.279.g1de40edade-goog
Re: [PATCH v2] Bluetooth: Add ABI doc for sysfs reset
Posted by Luiz Augusto von Dentz 1 year ago
Hi Hsin-chen,

On Mon, Jan 20, 2025 at 3:47 AM Hsin-chen Chuang <chharry@google.com> wrote:
>
> From: Hsin-chen Chuang <chharry@chromium.org>
>
> The functionality was implemented in commit 0f8a00137411 ("Bluetooth:
> Allow reset via sysfs")
>
> Fixes: 0f8a00137411 ("Bluetooth: Allow reset via sysfs")
> Signed-off-by: Hsin-chen Chuang <chharry@chromium.org>
> ---
>
> Changes in v2:
> - Resolved review comments from Paul
>
>  Documentation/ABI/stable/sysfs-class-bluetooth | 9 +++++++++
>  MAINTAINERS                                    | 1 +
>  2 files changed, 10 insertions(+)
>  create mode 100644 Documentation/ABI/stable/sysfs-class-bluetooth
>
> diff --git a/Documentation/ABI/stable/sysfs-class-bluetooth b/Documentation/ABI/stable/sysfs-class-bluetooth
> new file mode 100644
> index 000000000000..36be02471174
> --- /dev/null
> +++ b/Documentation/ABI/stable/sysfs-class-bluetooth
> @@ -0,0 +1,9 @@
> +What:          /sys/class/bluetooth/hci<index>/reset
> +Date:          14-Jan-2025
> +KernelVersion: 6.13
> +Contact:       linux-bluetooth@vger.kernel.org
> +Description:   This write-only attribute allows users to trigger the vendor reset
> +               method on the Bluetooth device when arbitrary data is written.
> +               The reset may or may not be done through the device transport
> +               (e.g., UART/USB), and can also be done through an out-of-band
> +               approach such as GPIO.
> diff --git a/MAINTAINERS b/MAINTAINERS
> index 797e94ba74f7..e949c3ac7846 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -4058,6 +4058,7 @@ S:        Supported
>  W:     http://www.bluez.org/
>  T:     git git://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth.git
>  T:     git git://git.kernel.org/pub/scm/linux/kernel/git/bluetooth/bluetooth-next.git
> +F:     Documentation/ABI/stable/sysfs-class-bluetooth
>  F:     include/net/bluetooth/
>  F:     net/bluetooth/
>
> --
> 2.48.0.rc2.279.g1de40edade-goog

We also need something similar for Bluetooth: btusb: add sysfs
attribute to control USB alt setting

-- 
Luiz Augusto von Dentz