Merge pull request #288 from avi951/main

Axon: Connectivity: Bluetooth 5.2

Author: djkabutar

source/vicharak_sbcs/axon/connectivity/bluetooth.rst

@@ -3,7 +3,158 @@
 Bluetooth
 ##############
 
-.. note::
+.. image:: /_static/images/rk3588-axon/axon-wifi-bt.webp
+   :width: 80%
 
-   **Documentation coming soon!** 
-   This section will be updated shortly with detailed instructions and information. Stay tuned for more!
+The Axon SBC includes an integrated Bluetooth 5.2 interface based on the
+**Realtek RTL8852BS** chipset (module: 6252B-SR).  
+Bluetooth is used for connecting wireless peripherals such as keyboards,
+mice, audio devices, and sensors.
+
+.. image:: /_static/images/rk3588-axon/accessory-wifi-antenna.webp
+   :width: 30%
+
+.. danger:: 
+    Kindly, attached Antenna on Bluetooth U.FL connector as mentioned in above picture.
+
+
+Hardware Details
+----------------
+
+- **Chipset**: Realtek RTL8852BS
+- **Bluetooth Version**: Bluetooth 5.2 / BLE
+- **Host Interface**: UART
+
+Linux Support
+-------------
+
+Bluetooth is supported using the Linux **BlueZ** stack.
+Firmware must be available under ``/lib/firmware/rtl_bt/``.
+
+The Bluetooth controller is typically exposed as ``hci0``.
+
+Using Blueman (GUI Method)
+--------------------------
+
+1. Launch Blueman Manager:
+
+   .. code-block:: bash
+
+      blueman-manager
+
+2. Ensure Bluetooth is **ON** (top toolbar).
+
+3. Click **Search** to scan for nearby Bluetooth devices.
+
+4. Select the target device from the list and click **Pair**.
+
+5. Confirm the pairing request on both devices if prompted.
+
+6. After pairing, right-click the device and select **Connect**.
+
+Blueman provides an easy graphical interface for managing Bluetooth devices.
+
+Using bluetoothctl (CLI Method)
+-------------------------------
+
+Start Bluetooth control utility:
+
+.. code-block:: bash
+
+   bluetoothctl
+
+Inside the prompt, run:
+
+.. code-block:: bash 
+
+   power on
+
+.. code-block:: bash
+
+   scan on
+
+Once the device appears (example MAC address):
+
+Pair device using MAC addresse:
+
+.. code-block:: bash 
+
+   pair AA:BB:CC:DD:EE:FF
+
+Trust device using MAC addresse:
+
+.. code-block:: bash
+
+   trust AA:BB:CC:DD:EE:FF
+
+Connect device using MAC addresse:
+
+.. code-block:: bash
+
+   connect AA:BB:CC:DD:EE:FF
+
+Stop scanning and exit:
+
+.. code-block:: bash
+
+   scan off
+
+.. code-block:: bash
+
+   quit
+
+Troubleshooting
+---------------
+
+- Check hci device using below command :
+
+.. code-block::
+    
+      hciconfig -a
+
+**Expected Device**
+
+.. code-block::
+      
+      hci0:	Type: Primary  Bus: UART
+      	BD Address: 40:F4:C9:94:85:5B  ACL MTU: 1021:5  SCO MTU: 255:11
+      	UP RUNNING
+      	RX bytes:2823 acl:0 sco:0 events:79 errors:0
+      	TX bytes:7087 acl:0 sco:0 commands:98 errors:0
+      	Features: 0xff 0xff 0xff 0xfa 0xdb 0xbf 0x7b 0x87
+      	Packet type: DM1 DM3 DM5 DH1 DH3 DH5 HV1 HV2 HV3
+      	Link policy: RSWITCH HOLD SNIFF PARK
+      	Link mode: PERIPHERAL ACCEPT
+      	Name: 'cow'
+      	Class: 0x7c0000
+      	Service Classes: Rendering, Capturing, Object Transfer, Audio, Telephony
+      	Device Class: Miscellaneous,
+      	HCI Version: 5.2 (0xb)  Revision: 0x530
+      	LMP Version: 5.2 (0xb)  Subversion: 0xf2b7
+      	Manufacturer: Realtek Semiconductor Corporation (93)
+
+- Check kernel logs if Bluetooth does not appear:
+
+  .. code-block:: bash
+
+     dmesg | grep -i bluetooth
+
+- Verify firmware files:
+
+  .. code-block:: bash
+
+     ls /lib/firmware/rtl_bt/
+
+- You can reinstall firmware by using below command :
+
+.. code-block::
+      
+      sudo apt update
+      sudo apt install vicharak-firmware
+
+- Reboot after installing firmware or drivers.
+
+Notes
+-----
+
+- BLE support depends on kernel and BlueZ version.