From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: MIME-Version: 1.0 References: <20181224164755.286932-1-tmaimon77@gmail.com> <20181224164755.286932-2-tmaimon77@gmail.com> <20190103211447.GA4618@bogus> In-Reply-To: <20190103211447.GA4618@bogus> From: Tomer Maimon Date: Wed, 9 Jan 2019 18:48:59 +0200 Message-ID: Subject: Re: [PATCH v1 1/2] dt-binding: iio: add NPCM ADC documentation Content-Type: multipart/alternative; boundary="00000000000065478e057f0926cf" To: Rob Herring Cc: jic23@kernel.org, knaack.h@gmx.de, lars@metafoo.de, pmeerw@pmeerw.net, Mark Rutland , Nancy Yuen , Patrick Venture , Brendan Higgins , Avi Fishman , Joel Stanley , linux-iio@vger.kernel.org, OpenBMC Maillist , Linux Kernel Mailing List , devicetree List-ID: --00000000000065478e057f0926cf Content-Type: text/plain; charset="UTF-8" Hi Rob, On Thu, 3 Jan 2019 at 23:14, Rob Herring wrote: > On Mon, Dec 24, 2018 at 06:47:54PM +0200, Tomer Maimon wrote: > > Added device tree binding documentation for Nuvoton BMC > > NPCM Analog-to-Digital Converter(ADC). > > > > Signed-off-by: Tomer Maimon > > --- > > .../bindings/iio/adc/nuvoton,npcm-adc.txt | 35 > ++++++++++++++++++++++ > > 1 file changed, 35 insertions(+) > > create mode 100644 > Documentation/devicetree/bindings/iio/adc/nuvoton,npcm-adc.txt > > > > diff --git > a/Documentation/devicetree/bindings/iio/adc/nuvoton,npcm-adc.txt > b/Documentation/devicetree/bindings/iio/adc/nuvoton,npcm-adc.txt > > new file mode 100644 > > index 000000000000..6f0843d837cc > > --- /dev/null > > +++ b/Documentation/devicetree/bindings/iio/adc/nuvoton,npcm-adc.txt > > @@ -0,0 +1,35 @@ > > +Nuvoton NPCM Analog to Digital Converter (ADC) > > + > > +The NPCM ADC is a 10-bit converter for eight channel inputs. > > + > > +Required properties: > > +- compatible : "nuvoton,npcm750-adc" for the NPCM7XX BMC. > > +- reg : specifies physical base address and size > of the registers. > > +- interrupts : Contain the ADC interrupt with flags for falling edge. > > + > > +Optional properties: > > +- clocks : phandle of ADC reference clock, in case the > clock is not > > + added the ADC will use the default ADC > sample rate. > > +- vref-supply : The regulator supply ADC reference voltage, in > case the > > + vref-supply is not added the ADC will > use internal voltage > > + reference. > > + > > +Required Node in the NPCM7xx BMC: > > +An additional register is present in the NPCM7xx SOC which is > > +assumed to be in the same device tree, with and marked as > > +compatible with "nuvoton,npcm750-rst". > > + > > +Example: > > + > > +adc: adc@f000c000 { > > + compatible = "nuvoton,npcm750-adc"; > > + reg = <0xf000c000 0x8>; > > + interrupts = ; > > + clocks = <&clk NPCM7XX_CLK_ADC>; > > +}; > > + > > +rst: rst@f0801000 { > > Why is this node here? > example for the reset node that required when using NPCM7xx SOC. (Required Node in the NPCM7xx BMC: An additional register is present in the NPCM7xx SOC which is assumed to be in the same device tree, with and marked as compatible with "nuvoton,npcm750-rst") > > > + compatible = "nuvoton,npcm750-rst", "syscon", > > + "simple-mfd"; > > + reg = <0xf0801000 0x6C>; > > +}; > > -- > > 2.14.1 > > > Thanks, Tomer --00000000000065478e057f0926cf Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Hi Rob,

On Thu, 3 Jan 2019 at 23:14, Rob Herrin= g <robh@kernel.org> wrote:
=
On Mon, Dec 24, 201= 8 at 06:47:54PM +0200, Tomer Maimon wrote:
> Added device tree binding documentation for Nuvoton BMC
> NPCM Analog-to-Digital Converter(ADC).
>
> Signed-off-by: Tomer Maimon <tmaimon77@gmail.com>
> ---
>=C2=A0 .../bindings/iio/adc/nuvoton,npcm-adc.txt=C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0 | 35 ++++++++++++++++++++++
>=C2=A0 1 file changed, 35 insertions(+)
>=C2=A0 create mode 100644 Documentation/devicetree/bindings/iio/adc/nuv= oton,npcm-adc.txt
>
> diff --git a/Documentation/devicetree/bindings/iio/adc/nuvoton,npcm-ad= c.txt b/Documentation/devicetree/bindings/iio/adc/nuvoton,npcm-adc.txt
> new file mode 100644
> index 000000000000..6f0843d837cc
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/iio/adc/nuvoton,npcm-adc.txt > @@ -0,0 +1,35 @@
> +Nuvoton NPCM Analog to Digital Converter (ADC)
> +
> +The NPCM ADC is a 10-bit converter for eight channel inputs.
> +
> +Required properties:
> +- compatible : "nuvoton,npcm750-adc" for the NPCM7XX BMC. > +- reg=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0 =C2=A0 : specifies physical base address and size of the regi= sters.
> +- interrupts : Contain the ADC interrupt with flags for falling edge.=
> +
> +Optional properties:
> +- clocks=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0: phandle of = ADC reference clock, in case the clock is not
> +=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0= =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0added the ADC will use the defaul= t ADC sample rate.
> +- vref-supply=C2=A0 =C2=A0 =C2=A0 =C2=A0 : The regulator supply ADC r= eference voltage, in case the
> +=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0= =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0vref-supply is not added the ADC = will use internal voltage
> +=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0= =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0reference.
> +
> +Required Node in the NPCM7xx BMC:
> +An additional register is present in the NPCM7xx SOC which is
> +assumed to be in the same device tree, with and marked as
> +compatible with "nuvoton,npcm750-rst".
> +
> +Example:
> +
> +adc: adc@f000c000 {
> +=C2=A0 =C2=A0 =C2=A0compatible =3D "nuvoton,npcm750-adc"; > +=C2=A0 =C2=A0 =C2=A0reg =3D <0xf000c000 0x8>;
> +=C2=A0 =C2=A0 =C2=A0interrupts =3D <GIC_SPI 0 IRQ_TYPE_LEVEL_HIGH&= gt;;
> +=C2=A0 =C2=A0 =C2=A0clocks =3D <&clk NPCM7XX_CLK_ADC>;
> +};
> +
> +rst: rst@f0801000 {

Why is this node here?
example for the reset node that= required when using NPCM7xx SOC.
(Required Node in the NPCM7xx B= MC:
An additional register is present in the NPCM7xx SOC which is
a= ssumed to be in the same device tree, with and marked as
compatible with= "nuvoton,npcm750-rst")

> +=C2=A0 =C2=A0 =C2=A0compatible =3D "nuvoton,npcm750-rst", &= quot;syscon",
> +=C2=A0 =C2=A0 =C2=A0"simple-mfd";
> +=C2=A0 =C2=A0 =C2=A0reg =3D <0xf0801000 0x6C>;
> +};
> --
> 2.14.1
>

Thanks,

= Tomer=C2=A0
--00000000000065478e057f0926cf-- From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Authentication-Results: lists.ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=gmail.com (client-ip=2607:f8b0:4864:20::141; helo=mail-it1-x141.google.com; envelope-from=tmaimon77@gmail.com; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: lists.ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="IYDBtcKA"; dkim-atps=neutral Received: from mail-it1-x141.google.com (mail-it1-x141.google.com [IPv6:2607:f8b0:4864:20::141]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 43ZZg57205zDqb9 for ; Thu, 10 Jan 2019 03:42:41 +1100 (AEDT) Received: by mail-it1-x141.google.com with SMTP id z7so12627255iti.0 for ; Wed, 09 Jan 2019 08:42:41 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=bm2yqOoBmYxMpVVYBoY2a0t3msTbgbv8p+iGlbylsMk=; b=IYDBtcKAuD5mtV/Kp2b2ft4Cx5DzMcBIExfEVIDV7Qh3QiIN4VS4HvwY2M9cJpaN7Z LZLRj9M94CQ4uK4Y3Js4CAqRCNRc5YuF1/FVBK9efOchzi/l9upIVbEH62+ATt7FU+fK GHU2CNkEmoeAc1fmuQueeTiz1Ndqu5a3eVtJR4K2rC4o4yv5m6Rgrp2Oy++earv4Qbzm neWdog4XHHISS2oikMd9ZNlRrWpLZUaX7cXdJ7lSQFzcJjQOmTkctXuaeYIMNlVcOdir xuFqWZqTqBJWUhwTfj3goimahGr7o936uj3VFc7LNulACwP1qpojvJLPf9mspsOpErlY QFmQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=bm2yqOoBmYxMpVVYBoY2a0t3msTbgbv8p+iGlbylsMk=; b=Z1UESjjZYbHDtG9FyjRv9kdz3FSPX+Vz/UO/2408M/1jGV/BMNVw6oZjChrcwQL7ku /tuapUhIN3tlFLJEOlrwnLI4HRNM/KC6jWuDcEmdEhPEpwvWCLdTBUn2iY6MvjyRDoEB PAy3bh/z9E6tL0wQ97rGCPguLQcBeZGl9TEZZpW8fiqhAirvQImYZNe06/M9LkOZIyeB rYZv1Q1ffN9JsGoa2L8077J9oBlrRAdPqZ9SlbCPLXLasw8uuVLU0oKDN8Sk/1Pvt9Uz kHyTk/RQR57s3k8PjCuVOwEZcfDgbYfNuWRW1Eqniodzg7D2zyMoM0Hha4UE/68rviSP gHRw== X-Gm-Message-State: AJcUukejWyrqfAlH2iW9nkdJ0cO/eVbgB2Q9foQcbu15ih85+NwkVGya 7km+m+1sbSX6Zp7NvVibP3rHFO1PIxfOeGyAAhc= X-Google-Smtp-Source: ALg8bN6GeTV2msiHJXkaWb8M1ZXXvWSRqtIMof1gTpIycGuUh8RaGT6VBZfy/1y93LpcY8fe5fVKTRg9/zeTCM5jPqM= X-Received: by 2002:a24:7094:: with SMTP id f142mr4553837itc.90.1547052159156; Wed, 09 Jan 2019 08:42:39 -0800 (PST) MIME-Version: 1.0 References: <20181224164755.286932-1-tmaimon77@gmail.com> <20181224164755.286932-2-tmaimon77@gmail.com> <20190103211447.GA4618@bogus> In-Reply-To: <20190103211447.GA4618@bogus> From: Tomer Maimon Date: Wed, 9 Jan 2019 18:48:59 +0200 Message-ID: Subject: Re: [PATCH v1 1/2] dt-binding: iio: add NPCM ADC documentation To: Rob Herring Cc: jic23@kernel.org, knaack.h@gmx.de, lars@metafoo.de, pmeerw@pmeerw.net, Mark Rutland , Nancy Yuen , Patrick Venture , Brendan Higgins , Avi Fishman , Joel Stanley , linux-iio@vger.kernel.org, OpenBMC Maillist , Linux Kernel Mailing List , devicetree Content-Type: multipart/alternative; boundary="00000000000065478e057f0926cf" X-BeenThere: openbmc@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Development list for OpenBMC List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 09 Jan 2019 16:42:43 -0000 --00000000000065478e057f0926cf Content-Type: text/plain; charset="UTF-8" Hi Rob, On Thu, 3 Jan 2019 at 23:14, Rob Herring wrote: > On Mon, Dec 24, 2018 at 06:47:54PM +0200, Tomer Maimon wrote: > > Added device tree binding documentation for Nuvoton BMC > > NPCM Analog-to-Digital Converter(ADC). > > > > Signed-off-by: Tomer Maimon > > --- > > .../bindings/iio/adc/nuvoton,npcm-adc.txt | 35 > ++++++++++++++++++++++ > > 1 file changed, 35 insertions(+) > > create mode 100644 > Documentation/devicetree/bindings/iio/adc/nuvoton,npcm-adc.txt > > > > diff --git > a/Documentation/devicetree/bindings/iio/adc/nuvoton,npcm-adc.txt > b/Documentation/devicetree/bindings/iio/adc/nuvoton,npcm-adc.txt > > new file mode 100644 > > index 000000000000..6f0843d837cc > > --- /dev/null > > +++ b/Documentation/devicetree/bindings/iio/adc/nuvoton,npcm-adc.txt > > @@ -0,0 +1,35 @@ > > +Nuvoton NPCM Analog to Digital Converter (ADC) > > + > > +The NPCM ADC is a 10-bit converter for eight channel inputs. > > + > > +Required properties: > > +- compatible : "nuvoton,npcm750-adc" for the NPCM7XX BMC. > > +- reg : specifies physical base address and size > of the registers. > > +- interrupts : Contain the ADC interrupt with flags for falling edge. > > + > > +Optional properties: > > +- clocks : phandle of ADC reference clock, in case the > clock is not > > + added the ADC will use the default ADC > sample rate. > > +- vref-supply : The regulator supply ADC reference voltage, in > case the > > + vref-supply is not added the ADC will > use internal voltage > > + reference. > > + > > +Required Node in the NPCM7xx BMC: > > +An additional register is present in the NPCM7xx SOC which is > > +assumed to be in the same device tree, with and marked as > > +compatible with "nuvoton,npcm750-rst". > > + > > +Example: > > + > > +adc: adc@f000c000 { > > + compatible = "nuvoton,npcm750-adc"; > > + reg = <0xf000c000 0x8>; > > + interrupts = ; > > + clocks = <&clk NPCM7XX_CLK_ADC>; > > +}; > > + > > +rst: rst@f0801000 { > > Why is this node here? > example for the reset node that required when using NPCM7xx SOC. (Required Node in the NPCM7xx BMC: An additional register is present in the NPCM7xx SOC which is assumed to be in the same device tree, with and marked as compatible with "nuvoton,npcm750-rst") > > > + compatible = "nuvoton,npcm750-rst", "syscon", > > + "simple-mfd"; > > + reg = <0xf0801000 0x6C>; > > +}; > > -- > > 2.14.1 > > > Thanks, Tomer --00000000000065478e057f0926cf Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
Hi Rob,

On Thu, 3 Jan 2019 at 23:14, Rob Herrin= g <robh@kernel.org> wrote:
=
On Mon, Dec 24, 201= 8 at 06:47:54PM +0200, Tomer Maimon wrote:
> Added device tree binding documentation for Nuvoton BMC
> NPCM Analog-to-Digital Converter(ADC).
>
> Signed-off-by: Tomer Maimon <tmaimon77@gmail.com>
> ---
>=C2=A0 .../bindings/iio/adc/nuvoton,npcm-adc.txt=C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0 | 35 ++++++++++++++++++++++
>=C2=A0 1 file changed, 35 insertions(+)
>=C2=A0 create mode 100644 Documentation/devicetree/bindings/iio/adc/nuv= oton,npcm-adc.txt
>
> diff --git a/Documentation/devicetree/bindings/iio/adc/nuvoton,npcm-ad= c.txt b/Documentation/devicetree/bindings/iio/adc/nuvoton,npcm-adc.txt
> new file mode 100644
> index 000000000000..6f0843d837cc
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/iio/adc/nuvoton,npcm-adc.txt > @@ -0,0 +1,35 @@
> +Nuvoton NPCM Analog to Digital Converter (ADC)
> +
> +The NPCM ADC is a 10-bit converter for eight channel inputs.
> +
> +Required properties:
> +- compatible : "nuvoton,npcm750-adc" for the NPCM7XX BMC. > +- reg=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 = =C2=A0 =C2=A0 =C2=A0 : specifies physical base address and size of the regi= sters.
> +- interrupts : Contain the ADC interrupt with flags for falling edge.=
> +
> +Optional properties:
> +- clocks=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0: phandle of = ADC reference clock, in case the clock is not
> +=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0= =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0added the ADC will use the defaul= t ADC sample rate.
> +- vref-supply=C2=A0 =C2=A0 =C2=A0 =C2=A0 : The regulator supply ADC r= eference voltage, in case the
> +=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0= =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0vref-supply is not added the ADC = will use internal voltage
> +=C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0= =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0reference.
> +
> +Required Node in the NPCM7xx BMC:
> +An additional register is present in the NPCM7xx SOC which is
> +assumed to be in the same device tree, with and marked as
> +compatible with "nuvoton,npcm750-rst".
> +
> +Example:
> +
> +adc: adc@f000c000 {
> +=C2=A0 =C2=A0 =C2=A0compatible =3D "nuvoton,npcm750-adc"; > +=C2=A0 =C2=A0 =C2=A0reg =3D <0xf000c000 0x8>;
> +=C2=A0 =C2=A0 =C2=A0interrupts =3D <GIC_SPI 0 IRQ_TYPE_LEVEL_HIGH&= gt;;
> +=C2=A0 =C2=A0 =C2=A0clocks =3D <&clk NPCM7XX_CLK_ADC>;
> +};
> +
> +rst: rst@f0801000 {

Why is this node here?
example for the reset node that= required when using NPCM7xx SOC.
(Required Node in the NPCM7xx B= MC:
An additional register is present in the NPCM7xx SOC which is
a= ssumed to be in the same device tree, with and marked as
compatible with= "nuvoton,npcm750-rst")

> +=C2=A0 =C2=A0 =C2=A0compatible =3D "nuvoton,npcm750-rst", &= quot;syscon",
> +=C2=A0 =C2=A0 =C2=A0"simple-mfd";
> +=C2=A0 =C2=A0 =C2=A0reg =3D <0xf0801000 0x6C>;
> +};
> --
> 2.14.1
>

Thanks,

= Tomer=C2=A0
--00000000000065478e057f0926cf--