Skip to content

Commit b0a5cde

Browse files
krzklag-linaro
authored andcommitted
dt-bindings: mfd: Explain lack of child dependency in simple-mfd
Common mistake of usage of 'simple-mfd' compatible is a dependency of children on resources acquired and managed by the parent, e.g. clocks. Extend the simple-mfd documentation to cover this case. Cc: Linus Walleij <[email protected]> Cc: Arnd Bergmann <[email protected]> Signed-off-by: Krzysztof Kozlowski <[email protected]> Reviewed-by: Conor Dooley <[email protected]> Reviewed-by: Rob Herring (Arm) <[email protected]> Link: https://lore.kernel.org/r/[email protected] Signed-off-by: Lee Jones <[email protected]>
1 parent 1d84531 commit b0a5cde

File tree

1 file changed

+8
-7
lines changed
  • Documentation/devicetree/bindings/mfd

1 file changed

+8
-7
lines changed

Documentation/devicetree/bindings/mfd/mfd.txt

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -17,13 +17,14 @@ A typical MFD can be:
1717

1818
Optional properties:
1919

20-
- compatible : "simple-mfd" - this signifies that the operating system should
21-
consider all subnodes of the MFD device as separate devices akin to how
22-
"simple-bus" indicates when to see subnodes as children for a simple
23-
memory-mapped bus. For more complex devices, when the nexus driver has to
24-
probe registers to figure out what child devices exist etc, this should not
25-
be used. In the latter case the child devices will be determined by the
26-
operating system.
20+
- compatible : "simple-mfd" - this signifies that the operating system
21+
should consider all subnodes of the MFD device as separate and independent
22+
devices, so not needing any resources to be provided by the parent device.
23+
Similarly to how "simple-bus" indicates when to see subnodes as children for
24+
a simple memory-mapped bus.
25+
For more complex devices, when the nexus driver has to probe registers to
26+
figure out what child devices exist etc, this should not be used. In the
27+
latter case the child devices will be determined by the operating system.
2728

2829
- ranges: Describes the address mapping relationship to the parent. Should set
2930
the child's base address to 0, the physical address within parent's address

0 commit comments

Comments
 (0)