linux-kernel - Re: [PATCH v2 1/2] dt-bindings: sound: add bindings for TAS6424

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite for Android: free password hash cracker in your pocket

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <20170717202455.tgewq6kldoml6g2k@rob-hp-laptop>
Date:   Mon, 17 Jul 2017 15:24:55 -0500
From:   Rob Herring <robh@...nel.org>
To:     Michael Stecklein <m-stecklein@...com>
Cc:     Mark Rutland <mark.rutland@....com>,
        Jaroslav Kysela <perex@...ex.cz>,
        Takashi Iwai <tiwai@...e.com>, alsa-devel@...a-project.org,
        devicetree@...r.kernel.org, linux-kernel@...r.kernel.org,
        "Andrew F . Davis" <afd@...com>
Subject: Re: [PATCH v2 1/2] dt-bindings: sound: add bindings for TAS6424

On Mon, Jul 17, 2017 at 11:25:46AM -0500, Michael Stecklein wrote:
> Add the bindings for the TAS6424 digital amplifier.
> 
> Signed-off-by: Michael Stecklein <m-stecklein@...com>
> ---
>  .../devicetree/bindings/sound/ti,tas6424.txt       | 31 ++++++++++++++++++++++
>  1 file changed, 31 insertions(+)
>  create mode 100644 Documentation/devicetree/bindings/sound/ti,tas6424.txt
> 
> diff --git a/Documentation/devicetree/bindings/sound/ti,tas6424.txt b/Documentation/devicetree/bindings/sound/ti,tas6424.txt
> new file mode 100644
> index 0000000..27227b1
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/sound/ti,tas6424.txt
> @@ -0,0 +1,31 @@
> +Texas Instruments TAS6424 Quad-Channel Audio amplifier
> +
> +The TAS6424 serial control bus communicates through I2C protocols.
> +
> +Required properties:
> +	- compatible - One of: "ti,tas6424" - TAS6424
> +	- reg - I2C slave address
> +	- sound-dai-cells: must be equal to 0
> +
> +Optional properties:
> +	- pinctrl-names, pinctrl-0 - Please refer to pinctrl-bindings.txt
> +	- interrupts-extended - describe the interrupt line used to inform the
> +	  host. Please refer to interrupt-controller/interrupts.txt

There's no need for interrupts-extended here. Generally, we just 
document "interrupts" though interrupts-extended can be used instead as 
needed.

> +
> +Example:
> +
> +tas6424: tas6424@6a {
> +	#sound-dai-cells = <0>;
> +
> +	status = "okay";

Don't show status for examples.

> +
> +	compatible = "ti,tas6424";

Generally, this comes first style-wise.

> +	reg = <0x6a>;
> +
> +	pinctrl-names = "default";
> +	pinctrl-0 = <&tas6424_int_pin>;
> +	interrupts-extended = <&gpio1 28 IRQ_TYPE_EDGE_FALLING>;
> +};
> +
> +For more product information please see the link below:
> +http://www.ti.com/product/TAS6424-Q1
> -- 
> 2.7.4
>