Adding Bluetooth validation test case

This test validates the Bluetooth controller by checking for the presence of
bluetoothctl, ensuring bluetoothd is running, and toggling the controller power
state using bluetoothctl.

- Compliant with qcom-linux-testkit structure
- Generates .res file for CI/CD
- Uses functestlib logging and dependency checks

Signed-off-by: Anil Yadav <[email protected]>

Author: qcom-anilyada

Runner/suites/Connectivity/Bluetooth/README.md

@@ -0,0 +1,59 @@
+Copyright (c) Qualcomm Technologies, Inc. and/or its subsidiaries.
+SPDX-License-Identifier: BSD-3-Clause-Clear
+
+# Bluetooth Validation Test
+
+## Overview
+
+This test case validates the basic functionality of the Bluetooth controller on the device. It checks for:
+
+- Presence of `bluetoothctl`
+- Running status of `bluetoothd`
+- Power state toggling of the Bluetooth controller
+
+## Usage
+
+Instructions:
+
+1. Copy repo to Target Device: Use scp to transfer the scripts from the host to the target device. The scripts should be copied to any directory on the target device.
+2. Verify Transfer: Ensure that the repo have been successfully copied to any directory on the target device.
+3. Run Scripts: Navigate to the directory where these files are copied on the target device and execute the scripts as needed.
+
+Run a Connectivity Bluetooth test using:
+---
+#### Quick Example
+```
+git clone <this-repo>
+cd <this-repo>
+scp -r common Runner user@target_device_ip:<Path in device>
+ssh user@target_device_ip
+cd <Path in device>/Runner && ./run-test.sh Bluetooth
+```
+
+## Prerequisites
+- bluez package must be installed (provides bluetoothctl)
+- bluetoothd daemon must be running
+- Root access may be required for complete validation
+
+## Result Format
+
+Test result will be saved in Bluetooth.res as:  
+#### Pass Criteria  
+- bluetoothctl is available
+- bluetoothd is running
+- Power on command returns success
+- Bluetooth controller powered on successfully. – if all validations pass  
+<!-- -->
+#### Fail Criteria  
+- bluetoothctl not found
+- bluetoothd not running
+- Power on command fails
+- Failed to power on Bluetooth controller. – if any check fails
+
+
+## Output
+A .res file is generated in the same directory:
+
+`PASS Bluetooth`  OR   `FAIL Bluetooth`
+
+

Runner/suites/Connectivity/Bluetooth/run.sh

@@ -0,0 +1,96 @@
+#!/bin/sh
+
+# Copyright (c) Qualcomm Technologies, Inc. and/or its subsidiaries.
+# SPDX-License-Identifier: BSD-3-Clause-Clear
+
+# Source init_env and functestlib.sh
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+INIT_ENV=""
+SEARCH="$SCRIPT_DIR"
+while [ "$SEARCH" != "/" ]; do
+    if [ -f "$SEARCH/init_env" ]; then
+        INIT_ENV="$SEARCH/init_env"
+        break
+    fi
+    SEARCH=$(dirname "$SEARCH")
+done
+
+if [ -z "$INIT_ENV" ]; then
+    echo "[ERROR] Could not find init_env (starting at $SCRIPT_DIR)" >&2
+    exit 1
+fi
+
+# shellcheck disable=SC1090
+. "$INIT_ENV"
+
+# shellcheck disable=SC1090,SC1091
+. "$TOOLS/functestlib.sh"
+
+TESTNAME="Bluetooth"
+test_path=$(find_test_case_by_name "$TESTNAME") || {
+    log_fail "$TESTNAME : Test directory not found."
+    echo "FAIL $TESTNAME" > "./$TESTNAME.res"
+    exit 1
+}
+
+cd "$test_path" || exit 1
+res_file="./$TESTNAME.res"
+rm -f "$res_file"
+
+log_info "--------------------------------------------------------------------------"
+log_info "-------------------Starting $TESTNAME Testcase----------------------------"
+
+log_info "Checking if dependency: bluez is available"
+check_dependencies bluez
+
+log_info "Starting Bluetooth Test..."
+
+# Check if bluetoothctl is available
+if ! command -v bluetoothctl >/dev/null 2>&1; then
+    log_fail "bluetoothctl not found. Please install bluez."
+    echo "FAIL $TESTNAME" > "$res_file"
+    exit 1
+fi
+
+# Check if bluetoothd is running
+MAX_RETRIES=3
+RETRY_DELAY=10 # seconds
+retry=0
+
+while [ "$retry" -lt "$MAX_RETRIES" ]; do
+    if pgrep bluetoothd >/dev/null; then
+        break
+    fi
+    log_info "Bluetooth daemon not found, retrying in ${RETRY_DELAY} seconds..."
+    sleep "$RETRY_DELAY"
+    retry=$((retry + 1))
+done
+
+if [ "$retry" -eq "$MAX_RETRIES" ]; then
+    log_fail "Failed to start bluetoothd after ${MAX_RETRIES} retries. Aborting test."
+    echo "FAIL $TESTNAME" > "$res_file"
+    exit 1
+else
+    log_info "Bluetooth daemon started successfully."
+fi
+
+# Power off Bluetooth controller
+log_info "Powering off Bluetooth controller..."
+bluetoothctl power off
+
+# Power on Bluetooth controller
+log_info "Powering on Bluetooth controller..."
+output=$(bluetoothctl power on)
+
+# Check for success message
+if echo "$output" | grep -q "Changing power on succeeded"; then
+    log_pass "Bluetooth controller powered on successfully."
+    echo "PASS $TESTNAME" > "$res_file"
+else
+    log_fail "Failed to power on Bluetooth controller."
+    echo "FAIL $TESTNAME" > "$res_file"
+fi
+
+log_info "-------------------Completed $TESTNAME Testcase----------------------------"
+
+