Merge changes Ib65bfd76,I87d211df,I82836ee5,I1572b6e8,I723bf784 into main am: 7ee1c8c3

btsnoop_net

====

btsnoop_net exposes Bluetooth snoop logs over a local TCP socket which enables

real-time debugging of HCI data with hcidump.

This feature is enabled by  enabling  "Enable Bluetooth HCI snoop log" in the

Developer options and setting BT_NET_DEBUG flag to TRUE in the btsnoop_net.cc.

Once it has been enabled and the stack restarted, the stack will listen for

incoming TCP connections on port 8872.

To use this feature with btmon on a Linux host, you can run:

```

  $ adb forward tcp:8872 tcp:8872

  $ nc localhost 8872 | btmon -P -r /dev/stdin

```

Log Tags

===

This document lists all of the log tags used by the Bluetooth stack.

* audio_a2dp_hw

* BTA_AG_CO:

* bta_sys_main

* bt_btif

* bt_btif_config

* bt_btif_config_transcode

* bt_classic_peer

* bte_conf

* BtGatt.btif

* BtGatt.btif_test

* bt_hci

* bt_hci_h4

* bt_hci_inject

* bt_hci_mct

* bt_hci_packet_fragmenter

* BTIF_AV

* BTIF_CORE

* BTIF_HF

* BTIF_HF_CLIENT

* BTIF_HH

* BTIF_HL

* BTIF-MEDIA

* BTIF_PAN

* BTIF_QUEUE

* BTIF_RC

* BTIF_SM

* btif_sock

* BTIF_SOCK

* btif_sock_rfcomm

* btif_sock_sco

* BTIF_SOCK_SDP

* BTIF_STORAGE

* BTIF_UTIL

* BTLD

* bt_module

* bt_osi_alarm

* bt_osi_config

* bt_osi_data_dispatcher

* bt_osi_reactor

* bt_osi_socket

* bt_profile_manager

* bt_sdp_client

* btsnoop

* btsnoop_net

* bt_stack_config

* bt_stack_manager

* bt_task

* btu_task

* BT_UTILS

* bt_vendor

* osi_future

* osi_semaphore

* osi_thread

Network Ports

===

This document lists all of the network ports used by the bluetooth stack.

It should be used as a reference and as a mechanism to avoid port

namespace conflicts.

* TCP 8872 (hci/src/btsnoop_net.cc) - read live btsnoop logs

* TCP 8873 (hci/src/hci_inject.cc) - inject HCI packets into HCI stream

Properties

===

This document describes all of the Android properties used by the Bluetooth

stack.

Please keep the following list in alphabetical order.

* ``` bluetooth.enable_timeout_ms ```  

  Maximum amount of time Bluetooth can take to start-up, upload firmware etc.  

  Used in hci/src/hci_layer.cc, default 8000.

### TODO: write descriptions of what each property means and how

it's used.

* ``` debug.sys.noschedgroups ```

* ``` persist.service.bdroid.bdaddr ```

* ``` ro.bluetooth.hfp.ver ```

* ``` ro.bt.bdaddr_path ```

* ``` ro.product.model ```

* ``` service.brcm.bt.oob ```

# Fluoride Bluetooth Profile Tuning Suite (PTS) Test Mode

This document provides commands to enable PTS test mode for Fluoride stack. We

need special handling for some test cases as they are not applicable for the

Fluoride stack.

## PTS Test Mode system property

Profile services in packages/apps/Bluetooth uses system property

`persist.bluetooth.pts` to check if the PTS test mode is enabled. To enable it:

```sh

adb shell setprop persist.bluetooth.pts true

```

To disable it:

```sh

adb shell setprop persist.bluetooth.pts false

```

### Current use case

- In `newavrcp`, we send active player update to remote device only in PTS test

  mode (AVRCP/TG/MPS/BV-05-C AVRCP/TG/MPS/BV-07-C).

## PTS Helpers in stack config

Native stack also requires some special handling, and the config is stored in

`conf/bt_stack.conf`. To enable a flag, uncomment the corresponding line and

push the config file to `/etc/bluetooth/` in IUT.

### Current use case

- `PTS_SecurePairOnly` enables secure connections only mode.

- `PTS_DisableConnUpdates` disables LE Connection updates.

- `PTS_DisableSDPOnLEPair` disables BR/EDR discovery after LE pairing to avoid

  cross key derivation errors.

- `PTS_SmpOptions` sets SMP Pair options (formatted as hex bytes) `auth, io,

  ikey, rkey, ksize`.

- `PTS_AvrcpTest` enables AVRCP test mode. The UID is set to 0xffffffffffffffff

  in `TrackChangedNotificationResponse` (AVRCP/TG/NFY/BV-04-C).

- `PTS_SmpFailureCase` enables handling for various SMP failure cases.