tests: Bluetooth: Classic: Add test suites gap_discovery

Add test cases gap_central.test_01_gap_central_general_discovery and
gap_central.test_02_gap_central_limited_discovery.

Add test cases gap_peripheral.test_01_gap_peripheral_general_discovery
and gap_peripheral.test_02_gap_peripheral_limited_discovery.

Signed-off-by: Lyle Zhu <[email protected]>

Author: lylezhu2012

tests/bluetooth/classic/gap_discovery/CMakeLists.txt

@@ -0,0 +1,17 @@
+# SPDX-License-Identifier: Apache-2.0
+
+cmake_minimum_required(VERSION 3.20.0)
+set(NO_QEMU_SERIAL_BT_SERVER 1)
+
+find_package(Zephyr REQUIRED HINTS $ENV{ZEPHYR_BASE})
+project(bluetooth)
+
+if(CONFIG_TEST_GAP_PERIPHERAL)
+FILE(GLOB app_sources src/test_peripheral.c)
+endif ()
+
+if(CONFIG_TEST_GAP_CENTRAL)
+FILE(GLOB app_sources src/test_central.c)
+endif()
+
+target_sources(app PRIVATE ${app_sources})

tests/bluetooth/classic/gap_discovery/Kconfig

@@ -0,0 +1,39 @@
+# Copyright 2025 NXP
+#
+# SPDX-License-Identifier: Apache-2.0
+
+source "Kconfig.zephyr"
+
+choice TEST_GAP_ROLE
+	prompt "GAP Role"
+	default TEST_GAP_PERIPHERAL
+	help
+	  Select the GAP role for testing
+
+config TEST_GAP_PERIPHERAL
+	bool "GAP Role Peripheral"
+	help
+	  Test GAP role as peripheral device
+
+config TEST_GAP_CENTRAL
+	bool "GAP Role Central"
+	help
+	  Test GAP role as central device
+
+endchoice
+
+config TEST_GAP_CENTRAL_ADDRESS
+	string "Central Device Address"
+	default "00:11:22:33:44:55"
+	help
+	  GAP central device Bluetooth address in format XX:XX:XX:XX:XX:XX
+
+config TEST_GAP_PERIPHERAL_ADDRESS
+	string "Peripheral Device Address"
+	default "AA:BB:CC:DD:EE:FF"
+	help
+	  GAP peripheral device Bluetooth address in format XX:XX:XX:XX:XX:XX
+
+module = TEST_GAP_DISCOVERY
+module-str = test_gap_discovery
+source "subsys/logging/Kconfig.template.log_config"

tests/bluetooth/classic/gap_discovery/README.rst

@@ -0,0 +1,78 @@
+.. _bluetooth_classic_gap_discovery_test:
+
+Bluetooth Classic GAP Discovery Test
+#####################################
+
+Overview
+********
+
+This test verifies the Bluetooth Classic GAP (Generic Access Profile) discovery
+functionality. It tests the device's ability to discover nearby Bluetooth Classic
+devices through inquiry procedures.
+
+Requirements
+************
+
+* A board with Bluetooth Classic support
+* Bluetooth Classic controller enabled in the configuration
+
+Building and Running
+********************
+
+This test can be built and executed on boards with Bluetooth Classic support.
+
+.. code-block:: console
+
+   ./tests/bluetooth/classic/gap_discovery/tests_scripts/gap_discovery_run.sh
+
+If the error "Permission denied" occurs, the following command should be used to add permission for
+the script.
+
+.. code-block:: console
+
+   chmod +x ./tests/bluetooth/classic/gap_discovery/tests_scripts/gap_discovery_run.sh
+
+If the error "west: command not found" occurs, the following command should be used to activate the
+virtual environment. Refer to :ref:`getting_started` for details.
+
+.. code-block:: console
+
+   source ~/zephyrproject/.venv/bin/activate
+
+Sample Output
+*************
+
+.. code-block:: console
+
+    ------ TESTSUITE SUMMARY START ------
+
+    SUITE PASS - 100.00% [gap_central]: pass = 2, fail = 0, skip = 0, total = 2 duration = 46.640 seconds
+     - PASS - [gap_central.test_01_gap_central_general_discovery] duration = 5.180 seconds
+     - PASS - [gap_central.test_02_gap_central_limited_discovery] duration = 41.460 seconds
+
+    ------ TESTSUITE SUMMARY END ------
+
+    ------ TESTSUITE SUMMARY START ------
+
+    SUITE PASS - 100.00% [gap_peripheral]: pass = 2, fail = 0, skip = 0, total = 2 duration = 48.620 seconds
+     - PASS - [gap_peripheral.test_01_gap_peripheral_general_discovery] duration = 7.180 seconds
+     - PASS - [gap_peripheral.test_02_gap_peripheral_limited_discovery] duration = 41.440 seconds
+
+    ------ TESTSUITE SUMMARY END ------
+
+Test Coverage
+*************
+
+This test covers:
+
+* Bluetooth Classic initialization
+* GAP inquiry start/stop procedures
+* Device discovery callbacks
+* Inquiry result handling
+
+Configuration Options
+*********************
+
+See :file:`prj.conf` for the default configuration.
+
+Additional configuration options can be found in :file:`Kconfig`.

tests/bluetooth/classic/gap_discovery/prj.conf

@@ -0,0 +1,12 @@
+CONFIG_BT=y
+CONFIG_BT_CLASSIC=y
+CONFIG_LOG=y
+CONFIG_ZTEST=y
+
+CONFIG_BT_DEVICE_NAME="gap_discovery"
+
+CONFIG_BT_CREATE_CONN_TIMEOUT=30
+CONFIG_BT_PAGE_TIMEOUT=0xFFFF
+CONFIG_BT_LIMITED_DISCOVERABLE_DURATION=31
+
+CONFIG_TEST_GAP_DISCOVERY_LOG_LEVEL_DBG=y

tests/bluetooth/classic/gap_discovery/src/test_central.c

@@ -0,0 +1,231 @@
+/*
+ * Copyright 2025 NXP
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <zephyr/kernel.h>
+#include <zephyr/sys/byteorder.h>
+#include <zephyr/bluetooth/bluetooth.h>
+#include <zephyr/bluetooth/hci.h>
+#include <zephyr/logging/log.h>
+#include <zephyr/ztest.h>
+
+#define LOG_MODULE_NAME test_gap_discovery_central
+LOG_MODULE_REGISTER(LOG_MODULE_NAME, CONFIG_TEST_GAP_DISCOVERY_LOG_LEVEL);
+
+static struct bt_br_discovery_param br_discover_param;
+#define BR_DISCOVER_RESULT_COUNT 10
+static struct bt_br_discovery_result br_discover_result[BR_DISCOVER_RESULT_COUNT];
+
+static K_SEM_DEFINE(br_discover_sem, 0, 1);
+
+static bt_addr_t peer_addr;
+static ATOMIC_DEFINE(test_flags, 32);
+
+#define TEST_FLAG_DEVICE_FOUND      0
+#define TEST_FLAG_CONN_CONNECTED    1
+#define TEST_FLAG_CONN_DISCONNECTED 2
+
+static void br_discover_timeout(const struct bt_br_discovery_result *results, size_t count)
+{
+	LOG_DBG("BR discovery done, found %zu devices", count);
+
+	k_sem_give(&br_discover_sem);
+}
+
+static void br_discover_recv(const struct bt_br_discovery_result *result)
+{
+	char br_addr[BT_ADDR_STR_LEN];
+
+	bt_addr_to_str(&result->addr, br_addr, sizeof(br_addr));
+
+	LOG_DBG("[DEVICE]: %s, RSSI %i", br_addr, result->rssi);
+
+	if (bt_addr_eq(&peer_addr, &result->addr)) {
+		atomic_set_bit(test_flags, TEST_FLAG_DEVICE_FOUND);
+		LOG_DBG("  Target %s is found", br_addr);
+		k_sem_give(&br_discover_sem);
+	}
+}
+
+static struct bt_br_discovery_cb br_discover = {
+	.recv = br_discover_recv,
+	.timeout = br_discover_timeout,
+};
+
+static void br_connected(struct bt_conn *conn, uint8_t conn_err)
+{
+	LOG_DBG("connected: conn %p err 0x%02x", (void *)conn, conn_err);
+	if (conn_err == 0) {
+		k_sem_give(&br_discover_sem);
+		atomic_set_bit(test_flags, TEST_FLAG_CONN_CONNECTED);
+	} else {
+		LOG_ERR("Connection failed");
+	}
+}
+
+static void br_disconnected(struct bt_conn *conn, uint8_t reason)
+{
+	LOG_DBG("disconnected: conn %p reason 0x%02x", (void *)conn, reason);
+	k_sem_give(&br_discover_sem);
+	atomic_set_bit(test_flags, TEST_FLAG_CONN_DISCONNECTED);
+}
+
+BT_CONN_CB_DEFINE(conn_callbacks) = {
+	.connected = br_connected,
+	.disconnected = br_disconnected,
+};
+
+#define GAP_DISCOVERY_TIMEOUT(count) ((double)count * (double)1.25 + (double)5)
+
+static bool peer_device_discovery(bool limited)
+{
+	int err;
+	double timeout;
+
+	atomic_clear_bit(test_flags, TEST_FLAG_DEVICE_FOUND);
+
+	LOG_DBG("Starting Bluetooth inquiry");
+
+	br_discover_param.length = BR_DISCOVER_RESULT_COUNT;
+	br_discover_param.limited = limited;
+
+	err = bt_br_discovery_start(&br_discover_param, br_discover_result,
+				    ARRAY_SIZE(br_discover_result));
+	zassert_equal(err, 0, "Bluetooth inquiry failed (err %d)", err);
+
+	/* Wait for all discovery results to be processed */
+	timeout = GAP_DISCOVERY_TIMEOUT(ARRAY_SIZE(br_discover_result));
+	LOG_DBG("Will wait for GAP discovery done (timeout %us)", (uint32_t)timeout);
+	err = k_sem_take(&br_discover_sem, K_SECONDS(timeout));
+	zassert_equal(err, 0, "Failed to wait for discovery done (err %d)", err);
+
+	err = bt_br_discovery_stop();
+	if (err != 0) {
+		LOG_ERR("Failed to stop GAP discovery procedure (err %d)", err);
+	}
+
+	LOG_DBG("Bluetooth inquiry completed");
+
+	return atomic_test_bit(test_flags, TEST_FLAG_DEVICE_FOUND);
+}
+
+static void peer_device_connect(void)
+{
+	int err;
+	struct bt_conn *conn;
+
+	conn = bt_conn_create_br(&peer_addr, BT_BR_CONN_PARAM_DEFAULT);
+	zassert_true(conn != NULL, "BR connection creating failed");
+
+	err = k_sem_take(&br_discover_sem, K_SECONDS(30));
+	zassert_equal(err, 0, "Connection timeout (err %d)", err);
+	zassert_true(atomic_test_bit(test_flags, TEST_FLAG_CONN_CONNECTED), "Connection failed");
+
+	k_sem_reset(&br_discover_sem);
+
+	k_sleep(K_SECONDS(5));
+
+	err = bt_conn_disconnect(conn, BT_HCI_ERR_REMOTE_USER_TERM_CONN);
+	zassert_equal(err, 0, "Disconnection ACL failed (err %d)", err);
+
+	err = k_sem_take(&br_discover_sem, K_SECONDS(30));
+	zassert_equal(err, 0, "Disconnection timeout (err %d)", err);
+	zassert_true(atomic_test_bit(test_flags, TEST_FLAG_CONN_DISCONNECTED),
+		     "Disconnection failed");
+
+	bt_conn_unref(conn);
+}
+
+ZTEST(gap_central, test_01_gap_central_general_discovery)
+{
+	bool found;
+
+	found = peer_device_discovery(false);
+
+	zassert_true(found, "Peer device not found");
+
+	peer_device_connect();
+}
+
+#define BT_COD_MAJOR_SVC_CLASS_LIMITED_DISCOVER BIT(13)
+
+ZTEST(gap_central, test_02_gap_central_limited_discovery)
+{
+	bool found;
+	uint32_t cod;
+
+	found = peer_device_discovery(true);
+
+	zassert_true(found, "Peer device not found");
+
+	found = peer_device_discovery(true);
+
+	zassert_true(found, "Peer device not found");
+
+	cod = sys_get_le24(br_discover_result[0].cod);
+	zassert_true((cod & BT_COD_MAJOR_SVC_CLASS_LIMITED_DISCOVER) != 0,
+		     "Invalid COD (limited bit not set)");
+
+	k_sleep(K_SECONDS(CONFIG_BT_LIMITED_DISCOVERABLE_DURATION + 5));
+
+	found = peer_device_discovery(true);
+	if (found) {
+		cod = sys_get_le24(br_discover_result[0].cod);
+		zassert_true((cod & BT_COD_MAJOR_SVC_CLASS_LIMITED_DISCOVER) == 0,
+			     "Invalid COD (limited bit is set)");
+	}
+
+	peer_device_connect();
+}
+
+static void *setup(void)
+{
+	int err;
+
+	LOG_DBG("Initializing Bluetooth");
+
+	/* Initialize the Bluetooth Subsystem */
+	err = bt_enable(NULL);
+	zassert_equal(err, 0, "Bluetooth init failed (err %d)", err);
+
+	LOG_DBG("Bluetooth initialized");
+
+	err = bt_addr_from_str(CONFIG_TEST_GAP_PERIPHERAL_ADDRESS, &peer_addr);
+	zassert_equal(err, 0, "Invalid peer address (err %d)", err);
+
+	LOG_DBG("Register discovery callback");
+
+	bt_br_discovery_cb_register(&br_discover);
+
+	return NULL;
+}
+
+static void teardown(void *f)
+{
+	int err;
+
+	LOG_DBG("Disabling Bluetooth");
+
+	/* De-initialize the Bluetooth Subsystem */
+	err = bt_disable();
+	zassert_equal(err, 0, "Bluetooth de-init failed (err %d)", err);
+
+	LOG_DBG("Bluetooth de-initialized");
+}
+
+static void before(void *f)
+{
+	atomic_clear_bit(test_flags, TEST_FLAG_DEVICE_FOUND);
+	atomic_clear_bit(test_flags, TEST_FLAG_CONN_CONNECTED);
+	atomic_clear_bit(test_flags, TEST_FLAG_CONN_DISCONNECTED);
+
+	k_sem_reset(&br_discover_sem);
+}
+
+static void after(void *f)
+{
+}
+
+ZTEST_SUITE(gap_central, NULL, setup, before, after, teardown);