Chamelium Audio Board

Chromium OS‎ > ‎Testing Home‎ > ‎

Contents

1 Introduction
2 Components
3 Bootstrap
4 Setup Chamelium Info
5 Run the test
6 Test output/input devices basic function
1. 6.1 Output audio devices
2. 6.2 Input audio devices
7 Advanced tests

Introduction

Chamelium audio board routes audio between four endpoints with two stereo audio buses:

DUT device headphone jack
Chamelium FPGA board line-out/line-in
Peripheral speaker/microphone
Bluetooth audio module

It helps Chamelium automate audio testing including:

3.5mm headphone
3.5mm external microphone
Onboard internal speaker
Onboard internal microphone
Bluetooth A2DP playback
Bluetooth HSP/HFP playback
Bluetooth HSP/HFP record

Components

Chamelium

Audio Board Block Diagram

Audio Board

Two 3-ring (TRS) audio jack cables
One 4-ring (TRRS) audio jack cable
One serial ribbon cable (connecting CN4 on audio board with J13_LTC_CON on FPGA)
USB-A to mini-USB cable
3-ring (TRS) 3.5mm microphone

Bootstrap

Connect audio board and FPGA board with the serial ribbon grey cable (see the assembled picture).
Connect audio board and Chamelium line-in and line-out (blue jack to blue jack, green jack to green jack) using two 3.5mm 3-ring(TRS) cables.
For audio jack external audio - connect tested device with audio board using 3.5mm 4-ring (TRRS) cable.
For USB audio - connect tested device with the middle USB port on FPGA (top) board.
For internal speaker test - connect 3-ring microphone to pink port on Chamelium.
For internal microphone test - connect a speaker to black SPK port on audio board.
For Bluetooth test - Chamelium Eth MAC and audio board BT MAC should be related in chameleon_info.

Setup Chamelium Info

Use the interactive script ~/trunk/src/platform/chameleon/client/test_server to connect to chameleond server. ~/trunk/src/platform/chameleon/client/test_server --chameleon_host=<chameleon ip>
Get the MAC address of chamelium: >>> p.GetMacAddress()
'94:eb:2c:00:01:27'

Disable the bluetooth module on audio board:
>>> p.AudioBoardDisableBluetooth()
ssh into Cros device:
ssh chromeos1-row5-rack1-host2.cros
Use bluetoothctl to turn on adapter and start scanning

localhost ~ # bluetoothctl

[NEW] Controller 7C:7A:91:9A:EE:89 Chromebook [default]

[bluetooth]# power on

Changing power on succeeded

[bluetooth]# scan on

Discovery started

[CHG] Controller 7C:7A:91:9A:EE:89 Discovering: yes

Enable the bluetooth module on audio board using test_server: >>> p.AudioBoardResetBluetooth()

In bluetoothctl console, check there is a new SX3868-3Y device being scanned:

[NEW] Device 00:1F:84:01:03:5B SX3868-3Y

[CHG] Device 00:1F:84:01:03:5B RSSI: -67

[CHG] Device 00:1F:84:01:03:5B RSSI: -56

[CHG] Device 00:1F:84:01:03:5B RSSI: -68

Now we know Chamelium with MAC address '94:eb:2c:00:01:27' has a Bluetooth module with MAC address ‘00:1F:84:01:03:5B’ on its audio board.
Add the mapping info to client/cros/chameleon/chameleon_info.py

_CHAMELEON_BOARD_INFO = {

'94:eb:2c:00:00:fb': ChameleonInfo('00:1F:84:01:03:68'),

'94:eb:2c:00:01:2b': ChameleonInfo('00:1F:84:01:03:5E'),

'94:eb:2c:00:01:27': ChameleonInfo('00:1F:84:01:03:5B'), }

Run the test

For example, run basic headphone test on a squawks board 5 times:

test_that --board=squawks --fast --debug --args="chameleon_host=$CHAMELIUM_IP" $DUT_IP audio_AudioBasicHeadphone --iterations 5

Test output/input devices basic function

Output audio devices

Internal speaker - audio_AudioBasicInternalSpeaker

Headphone - audio_AudioBasicHeadphone

HDMI/DisplayPort - audio_AudioBasicHDMI

USB headphone - audio_AudioBasicUSBPlayback

Bluetooth headphone - audio_AudioBasicBluetoothPlayback

Input audio devices

Internal microphone - audio_AudioBasicInternalMicrophone
External microphone - audio_AudioBasicExternalMicrophone
USB microphone - audio_AudioBasicUSBRecord
Bluetooth microphone - audio_AudioBasicBluetoothRecord

Advanced tests

Volume control: audio_AudioVolume
Suspend/Resume, Reboot: audio_AudioAfterSuspend, audio_AudioAfterReboot, audio_AudioQualityAfterSuspend
Quality and artifacts: audio_AudioArtifacts
BT connection: audio_AudioBluetoothConnectionStability
BT playback + record: audio_AudioBasicBluetoothPlaybackRecord
USB playback + record: audio_AudioBasicUSBPlaybackRecord
Chrome media player: audio_MediaBasicVerification
WebRTC: audio_AudioWebRTCLoopback
ARC: audio_AudioARCPlayback, audio_AudioARCRecord