linux-kernel.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH] dt-bindings: hwmon: max20730: adding device tree doc for max20730
@ 2020-09-10 17:06 Chu Lin
  2020-09-16  3:04 ` Guenter Roeck
  0 siblings, 1 reply; 3+ messages in thread
From: Chu Lin @ 2020-09-10 17:06 UTC (permalink / raw)
  To: linchuyuan, jdelvare, linux, robh+dt, linux-hwmon, devicetree,
	linux-kernel, qiongwang, zhongqil, jasonling, belgaied

Testing:
make dt_binding_check

Signed-off-by: Chu Lin <linchuyuan@google.com>
---
 .../devicetree/bindings/hwmon/max20730.txt    | 23 +++++++++++++++++++
 MAINTAINERS                                   |  1 +
 2 files changed, 24 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/hwmon/max20730.txt

diff --git a/Documentation/devicetree/bindings/hwmon/max20730.txt b/Documentation/devicetree/bindings/hwmon/max20730.txt
new file mode 100644
index 000000000000..3afb42b04567
--- /dev/null
+++ b/Documentation/devicetree/bindings/hwmon/max20730.txt
@@ -0,0 +1,23 @@
+max20730 properties
+
+Required properties:
+- compatible: Must be one of the supported compatible strings:
+	"maxim,max20730" for max20730
+	"maxim,max20734" for max20734
+	"maxim,max20743" for max20743
+- reg: I2C address
+
+Optional properties:
+
+- vout-voltage-divider
+	Resistance of the vout voltage divider.
+	Two numbers, the first number is the output resistor,
+	the second number is the total resistance.
+
+Example:
+
+max20730@10 {
+	compatible = "maxim,max20730";
+	reg = <0x10>;
+	vout-voltage-divider = <1000 2000>;
+};
diff --git a/MAINTAINERS b/MAINTAINERS
index 0a6ac3f00ed5..a04bf34a65b8 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -12371,6 +12371,7 @@ W:	http://www.roeck-us.net/linux/drivers/
 T:	git git://git.kernel.org/pub/scm/linux/kernel/git/groeck/linux-staging.git
 S:	Maintained
 F:	Documentation/devicetree/bindings/hwmon/ibm,cffps1.txt
+F:	Documentation/devicetree/bindings/hwmon/max20730.txt
 F:	Documentation/devicetree/bindings/hwmon/max31785.txt
 F:	Documentation/devicetree/bindings/hwmon/ltc2978.txt
 F:	Documentation/hwmon/adm1275
-- 
2.28.0.526.ge36021eeef-goog


^ permalink raw reply related	[flat|nested] 3+ messages in thread

* Re: [PATCH] dt-bindings: hwmon: max20730: adding device tree doc for max20730
  2020-09-10 17:06 [PATCH] dt-bindings: hwmon: max20730: adding device tree doc for max20730 Chu Lin
@ 2020-09-16  3:04 ` Guenter Roeck
  2020-09-22 22:25   ` Rob Herring
  0 siblings, 1 reply; 3+ messages in thread
From: Guenter Roeck @ 2020-09-16  3:04 UTC (permalink / raw)
  To: Chu Lin, jdelvare, robh+dt, linux-hwmon, devicetree,
	linux-kernel, qiongwang, zhongqil, jasonling, belgaied

On 9/10/20 10:06 AM, Chu Lin wrote:
> Testing:
> make dt_binding_check
> 

This isn't really an appropriate patch description.

> Signed-off-by: Chu Lin <linchuyuan@google.com>
> ---
>  .../devicetree/bindings/hwmon/max20730.txt    | 23 +++++++++++++++++++

AFAIK this needs to be written as .yaml file.

Guenter

>  MAINTAINERS                                   |  1 +
>  2 files changed, 24 insertions(+)
>  create mode 100644 Documentation/devicetree/bindings/hwmon/max20730.txt
> 
> diff --git a/Documentation/devicetree/bindings/hwmon/max20730.txt b/Documentation/devicetree/bindings/hwmon/max20730.txt
> new file mode 100644
> index 000000000000..3afb42b04567
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/hwmon/max20730.txt
> @@ -0,0 +1,23 @@
> +max20730 properties
> +
> +Required properties:
> +- compatible: Must be one of the supported compatible strings:
> +	"maxim,max20730" for max20730
> +	"maxim,max20734" for max20734
> +	"maxim,max20743" for max20743
> +- reg: I2C address
> +
> +Optional properties:
> +
> +- vout-voltage-divider
> +	Resistance of the vout voltage divider.
> +	Two numbers, the first number is the output resistor,
> +	the second number is the total resistance.
> +
> +Example:
> +
> +max20730@10 {
> +	compatible = "maxim,max20730";
> +	reg = <0x10>;
> +	vout-voltage-divider = <1000 2000>;
> +};
> diff --git a/MAINTAINERS b/MAINTAINERS
> index 0a6ac3f00ed5..a04bf34a65b8 100644
> --- a/MAINTAINERS
> +++ b/MAINTAINERS
> @@ -12371,6 +12371,7 @@ W:	http://www.roeck-us.net/linux/drivers/
>  T:	git git://git.kernel.org/pub/scm/linux/kernel/git/groeck/linux-staging.git
>  S:	Maintained
>  F:	Documentation/devicetree/bindings/hwmon/ibm,cffps1.txt
> +F:	Documentation/devicetree/bindings/hwmon/max20730.txt
>  F:	Documentation/devicetree/bindings/hwmon/max31785.txt
>  F:	Documentation/devicetree/bindings/hwmon/ltc2978.txt
>  F:	Documentation/hwmon/adm1275
> 


^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: [PATCH] dt-bindings: hwmon: max20730: adding device tree doc for max20730
  2020-09-16  3:04 ` Guenter Roeck
@ 2020-09-22 22:25   ` Rob Herring
  0 siblings, 0 replies; 3+ messages in thread
From: Rob Herring @ 2020-09-22 22:25 UTC (permalink / raw)
  To: Guenter Roeck
  Cc: Chu Lin, jdelvare, linux-hwmon, devicetree, linux-kernel,
	qiongwang, zhongqil, jasonling, belgaied

On Tue, Sep 15, 2020 at 08:04:24PM -0700, Guenter Roeck wrote:
> On 9/10/20 10:06 AM, Chu Lin wrote:
> > Testing:
> > make dt_binding_check
> > 
> 
> This isn't really an appropriate patch description.

And will always pass with a .txt file...

> 
> > Signed-off-by: Chu Lin <linchuyuan@google.com>
> > ---
> >  .../devicetree/bindings/hwmon/max20730.txt    | 23 +++++++++++++++++++
> 
> AFAIK this needs to be written as .yaml file.

Yes.

> 
> Guenter
> 
> >  MAINTAINERS                                   |  1 +
> >  2 files changed, 24 insertions(+)
> >  create mode 100644 Documentation/devicetree/bindings/hwmon/max20730.txt
> > 
> > diff --git a/Documentation/devicetree/bindings/hwmon/max20730.txt b/Documentation/devicetree/bindings/hwmon/max20730.txt
> > new file mode 100644
> > index 000000000000..3afb42b04567
> > --- /dev/null
> > +++ b/Documentation/devicetree/bindings/hwmon/max20730.txt
> > @@ -0,0 +1,23 @@
> > +max20730 properties
> > +
> > +Required properties:
> > +- compatible: Must be one of the supported compatible strings:
> > +	"maxim,max20730" for max20730
> > +	"maxim,max20734" for max20734
> > +	"maxim,max20743" for max20743
> > +- reg: I2C address
> > +
> > +Optional properties:
> > +
> > +- vout-voltage-divider
> > +	Resistance of the vout voltage divider.
> > +	Two numbers, the first number is the output resistor,
> > +	the second number is the total resistance.

Is this a common property for this type of device? And what type of 
device is it because there's no description telling me?

> > +
> > +Example:
> > +
> > +max20730@10 {
> > +	compatible = "maxim,max20730";
> > +	reg = <0x10>;
> > +	vout-voltage-divider = <1000 2000>;
> > +};
> > diff --git a/MAINTAINERS b/MAINTAINERS
> > index 0a6ac3f00ed5..a04bf34a65b8 100644
> > --- a/MAINTAINERS
> > +++ b/MAINTAINERS
> > @@ -12371,6 +12371,7 @@ W:	http://www.roeck-us.net/linux/drivers/
> >  T:	git git://git.kernel.org/pub/scm/linux/kernel/git/groeck/linux-staging.git
> >  S:	Maintained
> >  F:	Documentation/devicetree/bindings/hwmon/ibm,cffps1.txt
> > +F:	Documentation/devicetree/bindings/hwmon/max20730.txt
> >  F:	Documentation/devicetree/bindings/hwmon/max31785.txt
> >  F:	Documentation/devicetree/bindings/hwmon/ltc2978.txt
> >  F:	Documentation/hwmon/adm1275
> > 
> 

^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2020-09-22 22:25 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2020-09-10 17:06 [PATCH] dt-bindings: hwmon: max20730: adding device tree doc for max20730 Chu Lin
2020-09-16  3:04 ` Guenter Roeck
2020-09-22 22:25   ` Rob Herring

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).