apparmor-bluez-avrcp-volume manual

medium

Image Types:
target-armhf-internal / target-armhf / target-amd64
Image Deployment:
APT, OSTree
Type:
functional

Description

Test functionality and AppArmor profile for Bluez AVRCP volume up and down commands.

Resources

  • A Bluetooth adapter.
  • An A2DP Source and AVRCP capable phone (Galaxy Nexus)

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/apparmor-bluez-setup/-/archive/apertis/v2022dev0/apparmor-bluez-setup.tar.gz
    $ tar -xvf apparmor-bluez-setup.tar.gz
  2. Copy the apparmor-bluez-setup-* folder to the target device:
    3. $ DUT_IP=<device-ip>
    $ scp -r apparmor-bluez-setup-* 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 apparmor-bluez-setup-*
  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. From a PC, download and unpack the test data tarball from the gitlab test repository:
    7. $ wget https://gitlab.apertis.org/tests/bluez-phone/-/archive/apertis/v2022dev0/bluez-phone.tar.gz
    $ tar -xvf bluez-phone.tar.gz
  7. Copy the bluez-phone-* folder to the target device:
    8. $ DUT_IP=<device-ip>
    $ scp -r bluez-phone-* user@$DUT_IP:
  8. Log into the target device:
    9. $ ssh user@$DUT_IP
  9. After log into the DUT, enter the test directory
    10. $ cd bluez-phone-*
  10. 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.
  11. Please note that connman disables bluetooth by default on a fresh image. If it's already enabled, connmanctl will give an "In progress" error that may be ignored. To enable the device:
    12. $ connmanctl enable bluetooth

Execution Steps

  1. First ensure that the bluez-avrcp-volume test case is passing before executing the apparmor-bluez-avrcp-volume test one (otherwise false-negative might occur):
  2. Ensure PulseAudio is activated:
    3. $ pactl stat
  3. Run btmon before any connection happens:
    4. $ sudo btmon  | grep -A4 'AV/C: Control'
  4. Execute the test suite in another terminal:
    5. $ cd $HOME/bluez-phone ; ./bluez-avrcp-volume.sh
  5. After verifying that the bluez-avrcp-volume test is passing, open a new terminal and run the following. Do not yet answer to the question.
    6. $ cd $HOME/apparmor-bluez-setup-master; ./aa_get_complaints.sh
  6. Now, run the bluez-avrcp-volume test case again in the previous terminal.
    7. $ cd $HOME/bluez-phone ; ./bluez-avrcp-volume.sh
  7. After the bluez-avrcp-volume test ended, answer y to check for complaints.

Expected

When the TC has been run, once the log collection script finishes check its output.

On Success, aa_get_complaints.sh will find no complaints:

[...snip useless output...]

>>> Checking for apparmor complaints ...

>>> No complaints found!

If something goes wrong, the output will be similar to:

[...snip useless output...]

>>> Complaints found, creating report ...

aa-dump_20180710-100931/

aa-dump_20180710-100931/complaint_tokens.log

aa-dump_20180710-100931/audit.log

aa-dump_20180710-100931/ps_aux.log

aa-dump_20180710-100931/uname.log

aa-dump_20180710-100931/journalctl.log

aa-dump_20180710-100931/image_version

aa-dump_20180710-100931/os-release

>>> Report created as /home/chaiwala/aa-dump_20180710-100931.tar.bz2

In this case file a bug report against AppArmor attaching the tar.bz2 file created.