From patchwork Mon Aug 28 08:12:05 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Paul Kocialkowki X-Patchwork-Id: 9924543 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 3A90360311 for ; Mon, 28 Aug 2017 08:12:22 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 283B628697 for ; Mon, 28 Aug 2017 08:12:22 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 19A1E286B0; Mon, 28 Aug 2017 08:12:22 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.2 required=2.0 tests=BAYES_00, RCVD_IN_DNSWL_MED autolearn=ham version=3.3.1 Received: from gabe.freedesktop.org (gabe.freedesktop.org [131.252.210.177]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id A505E1FF4D for ; Mon, 28 Aug 2017 08:12:21 +0000 (UTC) Received: from gabe.freedesktop.org (localhost [127.0.0.1]) by gabe.freedesktop.org (Postfix) with ESMTP id 1AF6D6E264; Mon, 28 Aug 2017 08:12:21 +0000 (UTC) X-Original-To: intel-gfx@lists.freedesktop.org Delivered-To: intel-gfx@lists.freedesktop.org Received: from mga09.intel.com (mga09.intel.com [134.134.136.24]) by gabe.freedesktop.org (Postfix) with ESMTPS id 3DBD76E261 for ; Mon, 28 Aug 2017 08:12:19 +0000 (UTC) Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by orsmga102.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 28 Aug 2017 01:12:18 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.41,440,1498546800"; d="scan'208";a="305089768" Received: from linux.intel.com ([10.54.29.200]) by fmsmga004.fm.intel.com with ESMTP; 28 Aug 2017 01:12:18 -0700 Received: from workstation.fi.intel.com (workstation.fi.intel.com [10.237.68.31]) by linux.intel.com (Postfix) with ESMTP id B53AE5804B9; Mon, 28 Aug 2017 01:12:16 -0700 (PDT) From: Paul Kocialkowski To: intel-gfx@lists.freedesktop.org Date: Mon, 28 Aug 2017 11:12:05 +0300 Message-Id: <20170828081205.2928-4-paul.kocialkowski@linux.intel.com> X-Mailer: git-send-email 2.14.0 In-Reply-To: <20170828081205.2928-1-paul.kocialkowski@linux.intel.com> References: <20170828081205.2928-1-paul.kocialkowski@linux.intel.com> Subject: [Intel-gfx] [PATCH i-g-t v2 3/3] docs: Add user documentation about audio support X-BeenThere: intel-gfx@lists.freedesktop.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: Intel graphics driver community testing & development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" X-Virus-Scanned: ClamAV using ClamSMTP This introduces plain-text documentation about the audio test, aimed at users who wish to setup and run the audio tests. Given the contents of this documentation, it felt more relevant to make it part of the tree instead of the API reference. Signed-off-by: Paul Kocialkowski Reviewed-by: Lyude Paul --- docs/audio.txt | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 docs/audio.txt diff --git a/docs/audio.txt b/docs/audio.txt new file mode 100644 index 00000000..158ad5d1 --- /dev/null +++ b/docs/audio.txt @@ -0,0 +1,45 @@ +Audio Support in IGT +==================== + +This document provides information and instructions about audio support in IGT. + +Introduction +------------ + +The audio test is aimed at testing the audio features of display connectors, +such as HDMI. + +Test setup +---------- + +The setup required for the audio test consists of using an HDMI-VGA adapter with +an audio-out 3.5 mm jack to extract the audio from the HDMI interface. +The audio-out jack is connected back to the device-under-test's line-in. + +Depending on the behavior of the adapter, it may be necessary to connect a +ghost VGA dongle to it (in order to emulate a connected display) to enable the +audio output. There are guides available detailing how to build these. + +When executed, the test will automatically send the test audio signal to all +ALSA audio HDMI outputs and record from the standard ALSA capture device. + +Configuration +------------- + +In order to deploy the test, ALSA controls have to be configured to set the +ALSA capture source to line-in. On Intel x86 systems, this can be achieved +with the following calls to the amixer utility: +# amixer sset Line 31 on +# amixer sset "Input Source" Line + +It is then useful to store the ALSA state permanently with the alsactl utility: +# alsactl store + +These settings can be restored with the alsactl utility: +# alsactl restore + +It is desirable to ensure that the alsa-restore and alsa-state systemd services +are enabled to do this job automatically, especially in the case of an +automated testing system: +# systemctl enable alsa-restore +# systemctl enable alsa-state