From patchwork Wed Jun 29 11:26:36 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Sylwester Nawrocki/Kernel \\(PLT\\) /SRPOL/Staff Engineer/Samsung Electronics" X-Patchwork-Id: 9204913 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 3BF5D60757 for ; Wed, 29 Jun 2016 11:28:48 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 2CD2028593 for ; Wed, 29 Jun 2016 11:28:48 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 1FD3C28630; Wed, 29 Jun 2016 11:28:48 +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=-6.9 required=2.0 tests=BAYES_00,RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id ECE1A28593 for ; Wed, 29 Jun 2016 11:28:46 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752050AbcF2L2q (ORCPT ); Wed, 29 Jun 2016 07:28:46 -0400 Received: from mailout3.samsung.com ([203.254.224.33]:50222 "EHLO mailout3.samsung.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752031AbcF2L2p (ORCPT ); Wed, 29 Jun 2016 07:28:45 -0400 Received: from epcpsbgm1new.samsung.com (epcpsbgm1 [203.254.230.26]) by mailout3.samsung.com (Oracle Communications Messaging Server 7.0.5.31.0 64bit (built May 5 2014)) with ESMTP id <0O9J02NHX6JU2J00@mailout3.samsung.com>; Wed, 29 Jun 2016 20:28:42 +0900 (KST) X-AuditID: cbfee61a-f79106d000000835-7c-5773b0eaf6e3 Received: from epmmp1.local.host ( [203.254.227.16]) by epcpsbgm1new.samsung.com (EPCPMTA) with SMTP id 79.45.02101.AE0B3775; Wed, 29 Jun 2016 20:28:42 +0900 (KST) Received: from AMDC1344.digital.local ([106.116.147.32]) by mmp1.samsung.com (Oracle Communications Messaging Server 7.0.5.31.0 64bit (built May 5 2014)) with ESMTPA id <0O9J00JKH6GN47A0@mmp1.samsung.com>; Wed, 29 Jun 2016 20:28:42 +0900 (KST) From: Sylwester Nawrocki To: broonie@kernel.org Cc: robh@kernel.org, alsa-devel@alsa-project.org, devicetree@vger.kernel.org, ideal.song@samsung.com, inki.dae@samsung.com, b.zolnierkie@samsung.com, linux-samsung-soc@vger.kernel.org, Sylwester Nawrocki Subject: [PATCH v3 3/6] ASoC: Add DT bindings documentation for max98504 amplifier Date: Wed, 29 Jun 2016 13:26:36 +0200 Message-id: <1467199599-6892-4-git-send-email-s.nawrocki@samsung.com> X-Mailer: git-send-email 1.9.1 In-reply-to: <1467199599-6892-1-git-send-email-s.nawrocki@samsung.com> References: <1467199599-6892-1-git-send-email-s.nawrocki@samsung.com> X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFprDLMWRmVeSWpSXmKPExsVy+t9jAd1XG4rDDW7dN7G4cvEQk8XGGetZ LaY+fMJmMf/IOVaLXX/vM1pMuj+BxWLG+X1MFv/37GC3OPymndWB02PD5yY2j02rOtk8+ras YvT4vEkugCWKyyYlNSezLLVI3y6BK2Pt3ZssBfeEK379X8fewLhZoIuRk0NCwETixrS7zBC2 mMSFe+vZuhi5OIQEljJKdG65xQ7h/GKU2PdwFytIFZuAoUTv0T5GEFsEqOP2nE5mkCJmgReM Eg3dy8ESwgIhEo+PHASyOThYBFQlWh/GgoR5BVwlJu34xQ6xTU7i5LHJYDM5BdwkHv5qB2sV Aqq5c6SDcQIj7wJGhlWMEqkFyQXFSem5hnmp5XrFibnFpXnpesn5uZsYwWH2TGoH48Fd7ocY BTgYlXh4M1yLw4VYE8uKK3MPMUpwMCuJ8P5eBxTiTUmsrEotyo8vKs1JLT7EKM3BoiTO+/j/ ujAhgfTEktTs1NSC1CKYLBMHp1QDI3uSWonu9IcTnvkaq+e4ia1qOe6/fvpW1fX7H069v/Ve s5xV0+IjPrOOvXuVLpn78/+1+gl6K7OCDlXfUQ63nOd4ovdTQNmchcYfdl0++1VxSllaW9B2 oculR+V8l0qct2oofysbZlYtzHz1iezMF9+POO3XENS9qOr4col9nHl6RcRbZ+n4BiWW4oxE Qy3mouJEAJ4DPl4vAgAA Sender: linux-samsung-soc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-samsung-soc@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP This patch adds DT bindings documentation for Maxim MAX98504 speaker amplifier. Signed-off-by: Sylwester Nawrocki --- Changes since v2: - added properties for VBAT brownout. Changes since v1: - added 'interrupts' property. --- .../devicetree/bindings/sound/max98504.txt | 44 ++++++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 Documentation/devicetree/bindings/sound/max98504.txt diff --git a/Documentation/devicetree/bindings/sound/max98504.txt b/Documentation/devicetree/bindings/sound/max98504.txt new file mode 100644 index 0000000..583ed5f --- /dev/null +++ b/Documentation/devicetree/bindings/sound/max98504.txt @@ -0,0 +1,44 @@ +Maxim MAX98504 class D mono speaker amplifier + +This device supports I2C control interface and an IRQ output signal. It features +a PCM and PDM digital audio interface (DAI) and a differential analog input. + +Required properties: + + - compatible : "maxim,max98504" + - reg : should contain the I2C slave device address + - DVDD-supply, DIOVDD-supply, PVDD-supply: power supplies for the device, + as covered in ../regulator/regulator.txt + - interrupts : should specify the interrupt line the device is connected to, + as described in ../interrupt-controller/interrupts.txt + +Optional properties: + + - maxim,brownout-threshold - the PVDD brownout threshold, the value must be + from 0, 1...21 range, corresponding to 2.6V, 2.65V...3.65V voltage range + - maxim,brownout-attenuation - the brownout attenuation to the speaker gain + applied during the "attack hold" and "timed hold" phase, the value must be + from 0...6 (dB) range + - maxim,brownout-attack-hold-ms - the brownout attack hold phase time in ms, + 0...255 (VBATBROWN_ATTK_HOLD, register 0x0018) + - maxim,brownout-timed-hold-ms - the brownout timed hold phase time in ms, + 0...255 (VBATBROWN_TIME_HOLD, register 0x0019) + - maxim,brownout-release-rate-ms - the brownout release phase step time in ms, + 0...255 (VBATBROWN_RELEASE, register 0x001A) + +The default value when the above properties are not specified is 0, +the maxim,brownout-threshold property must be specified to actually enable +the PVDD brownout protection. + +Example: + + max98504@31 { + compatible = "maxim,max98504"; + reg = <0x31>; + interrupt-parent = <&gpio_bank_0>; + interrupts = <2 0>; + + DVDD-supply = <®ulator>; + DIOVDD-supply = <®ulator>; + PVDD-supply = <®ulator>; +};