bluez-hfp-call-hold manual
medium
- Image Types:
- basesdk-amd64 / hmi-armhf / hmi-amd64 / sdk-amd64
- Image Deployment:
- APT, OSTree
- Type:
- functional
Description
Test Hands Free Profile (HFP) BlueZ feature call and hold.
Resources
- A Bluetooth adapter
- A Bluetooth-enabled phone with a SIM card and a data plan. (https://www.apertis.org/reference_hardware/extras/)
Pre Conditions
- From a PC, download and unpack the test data tarball from the gitlab test repository:
- Copy the bluez-phone-* folder to the target device:
- Log into the target device:
- After log into the DUT, enter the test directory
- Note that the tarball may change depending on the release/branch being tested, please make sure to download the correct tarball for the release in question.
- Please note that connman disables bluetooth by default on a fresh image.
- Enable device:
- When running the test on SabreLite boards using the headphone jack to check the audio output, the audio manager needs to be configured to route it accordingly as it defaults to the HDMI output:
- After reboot ensure that headphones will not be muted:
$ wget https://gitlab.apertis.org/tests/bluez-phone/-/archive/apertis/v2025dev1/bluez-phone.tar.gz
$ tar -xvf bluez-phone.tar.gz
$ DUT_IP=<device-ip>
$ scp -r bluez-phone-* user@$DUT_IP:
$ ssh user@$DUT_IP
$ cd bluez-phone-*
$ connmanctl enable bluetooth
$ pactl set-default-sink alsa_output.platform-sound.stereo-fallback
$ pactl set-sink-port alsa_output.platform-sound.stereo-fallback analog-output-headphones
$ pactl set-sink-mute alsa_output.platform-sound.stereo-fallback false
Execution Steps
- The phone must be in discoverable mode for starting this test. Look for the phone in this list, and save the BT address. It will be used while running the test.
- Execute the test suite inside an environment with dbus:
- There are some options:
- Once the test begins, after Apertis finishes pairing with the phone, you must initiate pairing from the phone and do the pairing again as part of the test. You may need to unpair Apertis from within the phone first. The test will display the following message when that is required:
- After you've initiated the pairing from the phone, the test will continue.
- If the pairing fails from the test, try to do the pairing separately, and then run the test using './bluez_hfp.sh -a <phone addr> -s'. To do a separate pairing: unpair the phone, and run 'bluetoothctl'. Then, in bluetoothctl prompt, issue the following commands in order: 'remove <phone addr>', 'discoverable on', 'agent off', 'agent NoInputNoOutput', 'default-agent'. The either 'pairable on' to pair from phone, or 'pair <phone addr>' to issue a pairing to the phone. '<phone addr>' is the phone address of the form 'a1:b2:c3:d4:e5:f6'.
- The next step is to initiate a call from the phone. This can be done by entering the contact.The test will display the following message when that is required:
- Pick up the call and then put the call on Hold
- Resume the conversation by unselecting the hold option the phone
$ ./bluez-hfp.sh
-a select which device you want to pair with (specify the address)
-s skip pairing because the device is already paired. -a must be present when using this.
-x enables test debugging (only useful if a test fails)
Start a pairing from the phone! was it successful (y/n).
Did you recieved the call (y/n)
Expected
If PASSED is displayed, all of the test have passed. The output should be similar to that:
select_adapter
Selected /org/bluez/hci0
hci0
select_device: Discovering...
(According to introspection data, you need to pass 'ss')
Device found: 20:34:FB:8B:C6:06 <unnamed>
Device found: 30:C3:D9:90:C2:43 ICC6.5in
Device found: 20:34:FB:6E:2F:FC pairing
Input device address: 20:34:FB:6E:2F:FC
Selected address: 20:34:FB:6E:2F:FC
test_pairing_initiator
Master: hci0
Slave: 20:34:FB:6E:2F:FC (bdaddr)
Master address: 00:02:72:A7:C3:03
Slave address: 20:34:FB:6E:2F:FC
Matching type='signal',interface='org.freedesktop.DBus.ObjectManager',member='InterfacesAdded',path=/,
Matching type='signal',interface='org.freedesktop.DBus.Properties',member='PropertiesChanged',arg0='org.bluez.Device1'
Scanning
Property changed: org.bluez.Device1
Property: RSSI
Property changed: org.bluez.Device1
Property: RSSI
Property: Name
Property: Alias
Property: UUIDs
Device added: /org/bluez/hci0/dev_20_34_FB_6E_2F_FC
Pairing requested: /org/bluez/hci0/dev_20_34_FB_6E_2F_FC
Property changed: org.bluez.Device1
Property: Connected
RequestConfirmation (/org/bluez/hci0/dev_20_34_FB_6E_2F_FC, 696478)
Device added: /org/bluez/hci0/dev_20_34_FB_6E_2F_FC
Property changed: org.bluez.Device1
Property: Modalias
Property: UUIDs
Property: ServicesResolved
Property: Paired=1
Successfully paired to /org/bluez/hci0/dev_20_34_FB_6E_2F_FC
Done
Device found: /org/bluez/hci0/dev_20_34_FB_6E_2F_FC
Device 20_34_FB_6E_2F_FC is paired
test_profiles
OBEXObjectPush
AudioSource
AV Remote Control Target
Unknown profile '0000110d-0000-1000-8000-00805f9b34fb',
AV Remote Control
Headset Audio Gateway
PANU
NAP
Handsfree Audio Gateway
test_profile_hfp_src
select_objectpath_hfp
/org/bluez/hci0
/hfp/org/bluez/hci0
'/hfp/org/bluez/hci0/dev_20_34_FB_6E_2F_FC',
object path going/hfp/org/bluez/hci0/dev_20_34_FB_6E_2F_FC
$OBJECTPATHHFP is not empty
Type the phone number to call:7798433607
Dialing to the phone number: 7798433607
Calling .......
CALL_PATH /hfp/org/bluez/hci0/dev_20_34_FB_6E_2F_FC/voicecall01
Did you recieved the call (y/n):
y
Receive the call and then put the call on Hold for 15-20 seconds
Resume the call by unselecting the Hold option on your phone
If FAILED is displayed, bluez-hfp test has failed and the test sequence is interrupted.
Notes
- Errors most frequently occurs at pairing. This can be used to circumvent pairing problems, though this does not mean the test is a full pass, as the pairing is part of the test:
cd ~/bluez-phone-master
armhf/bin/pair_two hci0 <bt address of the phone>
./bluez-hfp.sh -a <address of the phone> -s