| Message ID | 20220526112456.2488536-1-josephsih@chromium.org |
|---|---|
| State | New |
| Headers | show |
| Series | [BlueZ,v6,1/8] doc: Introduce the quality report command and event | expand |
Hello: This series was applied to bluetooth/bluez.git (master) by Marcel Holtmann <marcel@holtmann.org>: On Thu, 26 May 2022 19:24:49 +0800 you wrote: > Add the MGMT quality report command and event in doc/mgmt-api.txt. > > --- > > Changes in v6: > - No update in this patch. The patch 3/8 is updated to resolve a > patch conflict. > > [...] Here is the summary with links: - [BlueZ,v6,1/8] doc: Introduce the quality report command and event https://git.kernel.org/pub/scm/bluetooth/bluez.git/?id=93850c827d54 - [BlueZ,v6,2/8] lib: Add structures and constants for quality report command and event (no matching commit) - [BlueZ,v6,3/8] adapter: remove quality report from experimental features (no matching commit) - [BlueZ,v6,4/8] adapter: support AOSP MGMT_EV_QUALITY_REPORT (no matching commit) - [BlueZ,v6,5/8] adapter: support Intel MGMT_EV_QUALITY_REPORT (no matching commit) - [BlueZ,v6,6/8] tools/btmgmt: fix quality report command (no matching commit) - [BlueZ,v6,7/8] monitor: print quality report cmd (no matching commit) - [BlueZ,v6,8/8] monitor: packet: add missing decodings of MGMT commands to todo (no matching commit) You are awesome, thank you!
Hi Marcel: Do you mean to apply the first patch in the series or to apply the 8 patches in the whole series? It seems that only the first patch was applied in https://git.kernel.org/pub/scm/bluetooth/bluez.git Just would like to confirm with you. Thanks! Regards, Joseph On Fri, Jun 3, 2022 at 12:00 AM <patchwork-bot+bluetooth@kernel.org> wrote: > > Hello: > > This series was applied to bluetooth/bluez.git (master) > by Marcel Holtmann <marcel@holtmann.org>: > > On Thu, 26 May 2022 19:24:49 +0800 you wrote: > > Add the MGMT quality report command and event in doc/mgmt-api.txt. > > > > --- > > > > Changes in v6: > > - No update in this patch. The patch 3/8 is updated to resolve a > > patch conflict. > > > > [...] > > Here is the summary with links: > - [BlueZ,v6,1/8] doc: Introduce the quality report command and event > https://git.kernel.org/pub/scm/bluetooth/bluez.git/?id=93850c827d54 > - [BlueZ,v6,2/8] lib: Add structures and constants for quality report command and event > (no matching commit) > - [BlueZ,v6,3/8] adapter: remove quality report from experimental features > (no matching commit) > - [BlueZ,v6,4/8] adapter: support AOSP MGMT_EV_QUALITY_REPORT > (no matching commit) > - [BlueZ,v6,5/8] adapter: support Intel MGMT_EV_QUALITY_REPORT > (no matching commit) > - [BlueZ,v6,6/8] tools/btmgmt: fix quality report command > (no matching commit) > - [BlueZ,v6,7/8] monitor: print quality report cmd > (no matching commit) > - [BlueZ,v6,8/8] monitor: packet: add missing decodings of MGMT commands to todo > (no matching commit) > > You are awesome, thank you! > -- > Deet-doot-dot, I am a bot. > https://korg.docs.kernel.org/patchwork/pwbot.html > >
diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt index ebe56afa4..a429f0ef3 100644 --- a/doc/mgmt-api.txt +++ b/doc/mgmt-api.txt @@ -332,6 +332,7 @@ Read Controller Information Command 15 Static Address 16 PHY Configuration 17 Wideband Speech + 18 Quality Report This command generates a Command Complete event on success or a Command Status event on failure. @@ -2924,6 +2925,7 @@ Read Extended Controller Information Command 15 Static Address 16 PHY Configuration 17 Wideband Speech + 18 Quality Report The EIR_Data field contains information about class of device, local name and other values. Not all of them might be present. For @@ -3858,6 +3860,45 @@ Add Advertisement Patterns Monitor With RSSI Threshold Command Invalid Parameters +Set Quality Report Command +========================== + + Command Code: 0x0057 + Controller Index: <controller id> + Command Parameters: Quality_Report (1 Octet) + Return Parameters: Current_Settings (4 Octets) + + This command is used to enable and disable the controller's quality + report feature. The allowed values for the Quality_Report command + parameter are 0x00 and 0x01. All other values will return Invalid + Parameters. + + The value 0x00 disables the Quality Report, and the value 0x01 + enables the Quality Report feature. + + This command is only available for the controllers that support + either AOSP Bluetooth quality report or Intel telemetry event. + It is supported if the supported_settings indicate support for it. + + This command requires to use a valid controller index. Otherwise, + an Invalid Index status will be returned. + + The command is sent to the controller to enable/disable the quality + report feature, and generates a Command Complete event on success. + If the controller failed to execute the action, a Failed status will + be returned. + + The quality report state is maintained by the kernel over the adapter + power cycle. When the adapter is powered off, the quality report + feature is disabled by the kernel. When the adapter is powered on, it + is enabled again by the kernel if it was enabled before. + + Possible errors: Failed + Invalid Index + Invalid Parameters + Not Supported + + Command Complete Event ====================== @@ -4978,3 +5019,22 @@ Advertisement Monitor Device Lost Event 2 LE Random This event will be sent to all management sockets. + + +Quality Report Event +==================== + + Event code: 0x0031 + Controller Index: <controller_id> + Event Parameters: Quality_Spec (1 Octet) + Report_Len (2 Octets) + Report (0-65535 Octets) + + This event carries the Bluetooth quality report sent by the + controller. + + Possible values for the Quality_Spec parameter: + 0 AOSP Bluetooth Quality Report Event + 1 Intel Telemetry Event + + This event will be sent to all management sockets.