1Title: Bluetooth tester application
2
3Description:
4
5Tester application uses binary protocol to control Zephyr stack and is aimed at
6automated testing. It requires two serial ports to operate.
7The first serial is used by Bluetooth Testing Protocol (BTP) to drive Bluetooth
8stack. BTP commands and events are received and buffered for further processing
9over the same serial.
10
11BTP specification can be found in auto-pts project repository:
12https://github.com/intel/auto-pts
13The auto-pts is an automation framework for PTS Bluetooth testing tool provided
14by Bluetooth SIG.
15
16See https://docs.zephyrproject.org/latest/guides/bluetooth/index.html for full
17documentation about how to use this test.
18
19--------------------------------------------------------------------------------
20
21Supported Profiles:
22
23GAP, GATT, SM
24--------------------------------------------------------------------------------
25
26Building and running on QEMU:
27
28QEMU should have connection with the external host Bluetooth hardware.
29The btproxy tool from BlueZ can be used to give access to a Bluetooth controller
30attached to the Linux host OS:
31
32$ sudo tools/btproxy -u
33Listening on /tmp/bt-server-bredr
34
35/tmp/bt-server-bredr option is already set in Makefile through QEMU_EXTRA_FLAGS.
36
37To build tester application for QEMU use BOARD=qemu_cortex_m3 and
38CONF_FILE=qemu.conf. After this qemu can be started through the "run"
39build target.
40
41Note: Target board have to support enough UARTs for BTP and controller.
42      We recommend using qemu_cortex_m3.
43
44'bt-stack-tester' UNIX socket (previously set in Makefile) can be used for now
45to control tester application.
46--------------------------------------------------------------------------------
47
48Next, build and flash tester application by employing the "flash" build
49target.
50
51Use serial client, e.g. PUTTY to communicate over the serial port
52(typically /dev/ttyUSBx) with the tester using BTP.
53
54