From patchwork Mon Feb 3 14:57:07 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lars-Peter Clausen X-Patchwork-Id: 316172 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 543E92C0092 for ; Tue, 4 Feb 2014 01:57:13 +1100 (EST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751949AbaBCO5L (ORCPT ); Mon, 3 Feb 2014 09:57:11 -0500 Received: from smtp-out-088.synserver.de ([212.40.185.88]:1046 "EHLO smtp-out-052.synserver.de" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1751678AbaBCO5L (ORCPT ); Mon, 3 Feb 2014 09:57:11 -0500 Received: (qmail 19102 invoked by uid 0); 3 Feb 2014 14:57:06 -0000 X-SynServer-TrustedSrc: 1 X-SynServer-AuthUser: lars@metafoo.de X-SynServer-PPID: 18895 Received: from p4fe60004.dip0.t-ipconnect.de (HELO lars-adi-laptop.analog.com) [79.230.0.4] by 217.119.54.73 with SMTP; 3 Feb 2014 14:57:06 -0000 From: Lars-Peter Clausen To: Mark Brown , Liam Girdwood Cc: alsa-devel@alsa-project.org, Lars-Peter Clausen , Rob Herring , Pawel Moll , Mark Rutland , Ian Campbell , Kumar Gala , devicetree@vger.kernel.org Subject: [PATCH 1/2] devicetree: Add devicetree bindings documentation for the ADAU1977 Date: Mon, 3 Feb 2014 15:57:07 +0100 Message-Id: <1391439428-3198-1-git-send-email-lars@metafoo.de> X-Mailer: git-send-email 1.8.0 Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org The ADAU1977 is a four channel audio ADC. It can either be connected to an I2C or a SPI bus. Both bindings are described in this document. Other than the standard I2C and SPI bus properties a regulator for the AVDD supply needs to be specified in the bindings. Optionally, if present in the hardware design, a regulator for the DVDD supply and a GPIO connected to the chips reset pin can be specified. The bindings also allow to specify the microphone bias voltage that should be used with the hardware design. Cc: Rob Herring Cc: Pawel Moll Cc: Mark Rutland Cc: Ian Campbell Cc: Kumar Gala Cc: devicetree@vger.kernel.org Signed-off-by: Lars-Peter Clausen --- .../devicetree/bindings/sound/adi,adau1977.txt | 58 ++++++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 Documentation/devicetree/bindings/sound/adi,adau1977.txt diff --git a/Documentation/devicetree/bindings/sound/adi,adau1977.txt b/Documentation/devicetree/bindings/sound/adi,adau1977.txt new file mode 100644 index 0000000..3cf03d8 --- /dev/null +++ b/Documentation/devicetree/bindings/sound/adi,adau1977.txt @@ -0,0 +1,58 @@ +Analog Devices ADAU1977, ADAU1978, ADAU1979 devicetree bindings + +The ADAU1977 is a four channel audio ADC. It can either be connected to an I2C +or a SPI bus. Both bindings are described in this document. Depending on the bus +type different properties must/can be specified. + +Shared required properties: + - compatible: Must be "adi,adau1977", "adi,adau1978" or adi,adau1979" + - AVDD-supply: A handle to the power supply connected to the AVDD pin + +Shared optional properties: + - DVDD-supply: A handle to the power supply connected to the DVDD pin. If + specified the internal LDO will be disabled. + - reset-gpios: GPIO chip handle and specifier that define which GPIO is + connected to the chips PD/RST pin. If not specified the reset pin is assumed + to be hardwired to VCC. + - adi,micbias: Configures the voltage setting for the MICBIAS pin. If not + specified the default value will be 8.5 Volts. This property is only valid + for the ADAU1977. + Valid values for this property are: + 0: 5.0V + 1: 5.5V + 2: 6.0V + 3: 6.5V + 4: 7.0V + 5: 7.5V + 6: 8.0V + 7: 8.5V + 8: 9.0V + +I2C required properties: + - reg: The I2C address of the chip + +SPI required properties: + - reg: The SPI chipselect signal of the SPI master associated with this chip + - spi-max-frequency: Maximum spi frequency to use. + +Examples: + +&i2c_bus { + adau1977: codec@11 { + compatible = "adi,adau1977"; + reg = <0x11>; + reset-gpios = <&gpio 5 0>; + AVDD-supply = <&codec_avdd_supply>; + DVDD-supply = <&codec_dvdd_supply>; + }; +}; + +&spi_bus { + adau1977: codec@1 { + compatible = "adi,adau1977"; + reg = <0x1>; + spi-max-frequency = <10000000>; + AVDD-supply = <&codec_avdd_supply>; + adi,micbias = <5>; + }; +};