| Message ID | 20190604003218.241354-4-saravanak@google.com |
|---|---|
| State | Superseded, archived |
| Headers | show |
| Series | Solve postboot supplier cleanup and optimize probe ordering | expand |
| Context | Check | Description |
|---|---|---|
| robh/checkpatch | success |
On Mon, Jun 03, 2019 at 05:32:16PM -0700, Saravana Kannan wrote: > The depends-on property is used to list the mandatory functional > dependencies of a consumer device on zero or more supplier devices. > > Signed-off-by: Saravana Kannan <saravanak@google.com> > --- > .../devicetree/bindings/depends-on.txt | 26 +++++++++++++++++++ > 1 file changed, 26 insertions(+) > create mode 100644 Documentation/devicetree/bindings/depends-on.txt > > diff --git a/Documentation/devicetree/bindings/depends-on.txt b/Documentation/devicetree/bindings/depends-on.txt > new file mode 100644 > index 000000000000..1cbddd11cf17 > --- /dev/null > +++ b/Documentation/devicetree/bindings/depends-on.txt > @@ -0,0 +1,26 @@ > +Functional dependency linking > +============================= > + > +Apart from parent-child relationships, devices (consumers) often have > +functional dependencies on other devices (suppliers). Common examples of > +suppliers are clock, regulators, pinctrl, etc. However not all of them are > +dependencies with well defined devicetree bindings. Also, not all functional > +dependencies are mandatory as the device might be able to operate in a limited > +mode without some of the dependencies. > + > +The depends-on property allows marking these mandatory functional dependencies > +between one or more devices. The depends-on property is used by the consumer > +device to point to all its mandatory supplier devices. > + > +Optional properties: > +- depends-on: A list of phandles to mandatory suppliers of the device. > + > + > +Examples: > +Here, the device is dependent on only 2 of the 3 clock providers > +dev@40031000 { > + compatible = "name"; > + reg = <0x40031000 0x1000>; > + clocks = <&osc_1 1>, <&osc_2 7> <&osc_3 5>; > + depends-on = <&osc_1>, <&osc_3>; Why is this not implicit from clocks property and why is there need for explicit mention of this ? What happens if there's a cyclic dependency ? From hardware perspective, cyclic dependency is quite feasible, so IMO it's hard to define this property unambiguously. And being optional, we need to deal with the absence of these, and if we fallback to marking clock, regulators, pinctrl suppliers as depends-on, this may end up redundant. You may need to show examples(preferably with DTs in mainline just to help understand it quickly and easily) that are beyond these standard suppliers that are not implicit to add this property. -- Regards, Sudeep
diff --git a/Documentation/devicetree/bindings/depends-on.txt b/Documentation/devicetree/bindings/depends-on.txt new file mode 100644 index 000000000000..1cbddd11cf17 --- /dev/null +++ b/Documentation/devicetree/bindings/depends-on.txt @@ -0,0 +1,26 @@ +Functional dependency linking +============================= + +Apart from parent-child relationships, devices (consumers) often have +functional dependencies on other devices (suppliers). Common examples of +suppliers are clock, regulators, pinctrl, etc. However not all of them are +dependencies with well defined devicetree bindings. Also, not all functional +dependencies are mandatory as the device might be able to operate in a limited +mode without some of the dependencies. + +The depends-on property allows marking these mandatory functional dependencies +between one or more devices. The depends-on property is used by the consumer +device to point to all its mandatory supplier devices. + +Optional properties: +- depends-on: A list of phandles to mandatory suppliers of the device. + + +Examples: +Here, the device is dependent on only 2 of the 3 clock providers +dev@40031000 { + compatible = "name"; + reg = <0x40031000 0x1000>; + clocks = <&osc_1 1>, <&osc_2 7> <&osc_3 5>; + depends-on = <&osc_1>, <&osc_3>; +};
The depends-on property is used to list the mandatory functional dependencies of a consumer device on zero or more supplier devices. Signed-off-by: Saravana Kannan <saravanak@google.com> --- .../devicetree/bindings/depends-on.txt | 26 +++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 Documentation/devicetree/bindings/depends-on.txt