| Message ID | 20180628075540.1757-2-daniel@zonque.org |
|---|---|
| State | Changes Requested, archived |
| Headers | show |
| Series | Add devicetree functionality to w1 busses | expand |
On Thu, Jun 28, 2018 at 09:55:37AM +0200, Daniel Mack wrote: > This patch add a generic w1 bindings document that merely describes how > slave deviceses are grouped under master nodes. It also adds a specific > binding for the ds2760 battery monitor. > > Signed-off-by: Daniel Mack <daniel@zonque.org> > --- > .../devicetree/bindings/w1/maxim,ds2760.txt | 15 +++++++++++++++ > .../devicetree/bindings/w1/w1-gpio.txt | 6 ++++++ > Documentation/devicetree/bindings/w1/w1.txt | 18 ++++++++++++++++++ > 3 files changed, 39 insertions(+) > create mode 100644 Documentation/devicetree/bindings/w1/maxim,ds2760.txt > create mode 100644 Documentation/devicetree/bindings/w1/w1.txt > > diff --git a/Documentation/devicetree/bindings/w1/maxim,ds2760.txt b/Documentation/devicetree/bindings/w1/maxim,ds2760.txt > new file mode 100644 > index 000000000000..d916fdd213f7 > --- /dev/null > +++ b/Documentation/devicetree/bindings/w1/maxim,ds2760.txt > @@ -0,0 +1,15 @@ > +Devicetree bindings for Maxim DS2760 > +==================================== > + > +The ds2760 is a w1 slave device and must hence have its sub-node in DT > +under a w1 bus master node. > + > +The device exposes a power supply, so the details described in > +Documentation/devicetree/bindings/power/supply/power_supply.txt apply. > + > +Required properties: > +- compatible: must be "maxim,ds2760" > + > +Optional properties: > +- power-supplies: Refers to one or more power supplies connected to > + this battery. > diff --git a/Documentation/devicetree/bindings/w1/w1-gpio.txt b/Documentation/devicetree/bindings/w1/w1-gpio.txt > index 6e09c35d9f1a..6694317bcbed 100644 > --- a/Documentation/devicetree/bindings/w1/w1-gpio.txt > +++ b/Documentation/devicetree/bindings/w1/w1-gpio.txt > @@ -13,10 +13,16 @@ Optional properties: > - linux,open-drain: if specified, the data pin is considered in > open-drain mode. > > +Also refer to the generic w1.txt document. > + > Examples: > > onewire@0 { > compatible = "w1-gpio"; > gpios = <&gpio 126 0>, <&gpio 105 0>; > + > + battery { > + compatible = "maxim,ds2760"; Perhaps show the power-supplies property as that's the whole point to have in DT. > + }; > }; > > diff --git a/Documentation/devicetree/bindings/w1/w1.txt b/Documentation/devicetree/bindings/w1/w1.txt > new file mode 100644 > index 000000000000..6ac103f972a0 > --- /dev/null > +++ b/Documentation/devicetree/bindings/w1/w1.txt > @@ -0,0 +1,18 @@ > +Generic devicetree bindings for onewire (w1) busses > +=================================================== > + > +Onewire busses are described through nodes of their master bus controller. > +Slave devices are listed as sub-nodes of such master devices. For now, one > +one slave is allowed per bus master. s/one one/only one/ > + > + > +Example: > + > + onewire { > + compatible = "w1-gpio"; > + gpios = <&gpio 0 GPIO_ACTIVE_HIGH>; > + > + battery { > + compatible = "maxim,ds2760"; > + }; > + }; > -- > 2.17.1 > -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
diff --git a/Documentation/devicetree/bindings/w1/maxim,ds2760.txt b/Documentation/devicetree/bindings/w1/maxim,ds2760.txt new file mode 100644 index 000000000000..d916fdd213f7 --- /dev/null +++ b/Documentation/devicetree/bindings/w1/maxim,ds2760.txt @@ -0,0 +1,15 @@ +Devicetree bindings for Maxim DS2760 +==================================== + +The ds2760 is a w1 slave device and must hence have its sub-node in DT +under a w1 bus master node. + +The device exposes a power supply, so the details described in +Documentation/devicetree/bindings/power/supply/power_supply.txt apply. + +Required properties: +- compatible: must be "maxim,ds2760" + +Optional properties: +- power-supplies: Refers to one or more power supplies connected to + this battery. diff --git a/Documentation/devicetree/bindings/w1/w1-gpio.txt b/Documentation/devicetree/bindings/w1/w1-gpio.txt index 6e09c35d9f1a..6694317bcbed 100644 --- a/Documentation/devicetree/bindings/w1/w1-gpio.txt +++ b/Documentation/devicetree/bindings/w1/w1-gpio.txt @@ -13,10 +13,16 @@ Optional properties: - linux,open-drain: if specified, the data pin is considered in open-drain mode. +Also refer to the generic w1.txt document. + Examples: onewire@0 { compatible = "w1-gpio"; gpios = <&gpio 126 0>, <&gpio 105 0>; + + battery { + compatible = "maxim,ds2760"; + }; }; diff --git a/Documentation/devicetree/bindings/w1/w1.txt b/Documentation/devicetree/bindings/w1/w1.txt new file mode 100644 index 000000000000..6ac103f972a0 --- /dev/null +++ b/Documentation/devicetree/bindings/w1/w1.txt @@ -0,0 +1,18 @@ +Generic devicetree bindings for onewire (w1) busses +=================================================== + +Onewire busses are described through nodes of their master bus controller. +Slave devices are listed as sub-nodes of such master devices. For now, one +one slave is allowed per bus master. + + +Example: + + onewire { + compatible = "w1-gpio"; + gpios = <&gpio 0 GPIO_ACTIVE_HIGH>; + + battery { + compatible = "maxim,ds2760"; + }; + };
This patch add a generic w1 bindings document that merely describes how slave deviceses are grouped under master nodes. It also adds a specific binding for the ds2760 battery monitor. Signed-off-by: Daniel Mack <daniel@zonque.org> --- .../devicetree/bindings/w1/maxim,ds2760.txt | 15 +++++++++++++++ .../devicetree/bindings/w1/w1-gpio.txt | 6 ++++++ Documentation/devicetree/bindings/w1/w1.txt | 18 ++++++++++++++++++ 3 files changed, 39 insertions(+) create mode 100644 Documentation/devicetree/bindings/w1/maxim,ds2760.txt create mode 100644 Documentation/devicetree/bindings/w1/w1.txt