bluez-phone manual

critical

Image Types:
basesdk-amd64 / hmi-armhf / hmi-arm64 / hmi-amd64 / sdk-amd64
Image Deployment:
APT, OSTree
Type:
functional

Description

Test all BlueZ features needing interaction with a phone (Pairing, OBEX, PBAP, AVRCP, A2DP, HSP, HFP, PAN). Strategic component: Bluetooth phone calls is part of smartphone interaction functionality.

Resources

  • A Bluetooth adapter (if you have two plugged, please remove one to avoid confusion)
  • A Bluetooth-enabled phone with a SIM card and a data plan. (https://www.apertis.org/reference_hardware/extras/)

Pre Conditions

  1. From a PC, download and unpack the test data tarball from the gitlab test repository:
    2. $ wget https://gitlab.apertis.org/tests/bluez-phone/-/archive/apertis/v2025pre/bluez-phone.tar.gz
    $ tar -xvf bluez-phone.tar.gz
  2. Copy the bluez-phone-* folder to the target device:
    3. $ DUT_IP=<device-ip>
    $ scp -r bluez-phone-* user@$DUT_IP:
  3. Log into the target device:
    4. $ ssh user@$DUT_IP
  4. After log into the DUT, enter the test directory
    5. $ cd bluez-phone-*
  5. 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.
  6. If running the test on an SDK image, kill the blueman-applet process, as it prevents the test from installing its own pairing agent.
  7. 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:
    8. $ pactl set-default-sink alsa_output.platform-sound.stereo-fallback
    $ pactl set-sink-port alsa_output.platform-sound.stereo-fallback analog-output-headphones
  8. After reboot ensure that headphones will not be muted:
    9. $ pactl set-sink-mute alsa_output.platform-sound.stereo-fallback false

Execution Steps

  1. 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.
  2. Execute the test suite inside an environment with dbus:
    3. $ ./bluez-phone.sh
  3. There are some options:

    4. -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)

  4. 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:

    5. Start a pairing from the phone! was it successful (y/n).

  5. After you've initiated the pairing from the phone, the test will continue.
  6. If the pairing fails from the test, try to do the pairing separately, and then run the test using './bluez-phone.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'.
  7. The next step is to initiate a file transfer from the phone. This can be done by sending a contact from the phone. The test will display the following message when that is required:

    8. Start an OPP transfer in the phone, was it successful? (y/n)

  8. After you’ve initiated the file transfer from the phone, the test will continue.

Expected

If PASSED is displayed, all of the test have passed. The output should be similar to that:

select_adapter

Selected /org/bluez/hci0

select_device: Discovering...

Device found: F0:39:42:86:2E:1B Charge 2

Device found: 88:83:22:2F:56:2A Galaxy A5 2016

Input device address: 88:83:22:2F:56:2A

Selected address: 88:83:22:2F:56:2A

start_agent

test_pairing_initiator

Scanning in progress...

Pairing request to 88:83:22:2F:56:2A in progress...

Device found: /org/bluez/hci0/dev_88_83_22_2F_56_2A

Device 88_83_22_2F_56_2A is paired

test_pairing_responder

Start a pairing from the phone! was it successful (y/n): 

y

Device found: /org/bluez/hci0/dev_88_83_22_2F_56_2A

Device 88_83_22_2F_56_2A is paired

stop_agent

test_profiles

OBEXObjectPush

test_profile_opp_server

./bluez-phone.sh: 360: kill: Usage: kill [-s sigspec | -signum | -sigspec] [pid | job]... or

kill -l [exitstatus]

Start an OPP transfer in the phone, was it successful? (y/n)

y

AudioSource

test_profile_a2dp_src

Connecting

Play music from the device! Did you hear it (y/n): 

y

Disconnecting

AV Remote Control Target

Headset Audio Gateway

PANU

NAP

test_profile_nap

NAP:service name 

Handsfree Audio Gateway

SimAccess

PBAP Phonebook Access PSE

test_profile_pbap_pse

PB

Number of contacts: (uint16 119,)

ICH

Number of contacts: (uint16 87,)

OCH

Number of contacts: (uint16 321,)

MCH

Number of contacts: (uint16 92,)

CCH

Number of contacts: (uint16 500,)

MAP Message Access Server

test_profile_map_mse

()

PnPInformation

Unknown profile '00001800-0000-1000-8000-00805f9b34fb',

Unknown profile '00001801-0000-1000-8000-00805f9b34fb']>,)

test_profile_opp_client

Transfer will start

(objectpath '/org/bluez/obex/client/session8/transfer56', {'Status': <'queued'>, 'Name': <'vcard.vcf'>, 'Size': <uint64 81>, 'Filename': <'/tmp/vcard.vcf'>, 'Session': <objectpath '/org/bluez/obex/client/session8'>})

Please ensure the transfer is received on the target, was it received? (y/n)

y

PASSED

If FAILED is displayed, one of the test has failed and the test sequence is interrupted.

Some specific settings has to be enabled on the iPhone in order to make the MAP test pass. In Bluetooth > Settings, notifications must be enabled in the device specific screen. The notifications can only be enabled after the device is paired. The following procedure can be used. MAP test should pass after that:

1 - Run bluez-phone.sh a first time: pair, run all tests, and let MAP test fail.

2 - Go to Settings > Bluetooth. In the device speficic screen, enable notifications.

3 - Run bluez-phone.sh with the following options: -s -a <bluetooth address of target device>.

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-phone.sh -a <address of the phone> -s