device property: Add a note to the fwnode.h
Subsystems (3)
Andy Shevchenko
reviewerPATCH v2 1/1 device property: Add a note to the fwnode.h
Add a note to the fwnode.h that the header should not be used directly in the leaf drivers, they all should use the higher level APIs and the respective headers.
---
v2: added "...into the driver" piece at the end to remove ambiguity
include/linux/fwnode.h | 6 ++++++ 1 file changed, 6 insertions(+)
include/linux/fwnode.h +6 -0
@@ -2,6 +2,12 @@/* * fwnode.h - Firmware device node object handle type definition. * +* Note, this header is not meant to be used by the leaf drivers. +* It provides the low level data types and definitions for the firmware +* and device property providers. The respective API headers should +* guarantee all the required data types and definitions without including +* this header directly into the driver. +* * Copyright (C) 2015, Intel Corporation * Author: Rafael J. Wysocki <[email protected]> */
Signature · 1 line
2.47.2
Quoted 6 lines · Andy Shevchenko
+ * Note, this header is not meant to be used by the leaf drivers.
+ * It provides the low level data types and definitions for the firmware
+ * and device property providers. The respective API headers should
+ * guarantee all the required data types and definitions without including
+ * this header directly into the driver.
+ *
sorry, i don't understand both "leaf drivers" and "respective API headers". could you have examples ?
Andy Shevchenko
reviewerQuoted 9 lines · Zijun Hu
Quoted 5 lines · Andy Shevchenko
+ * Note, this header is not meant to be used by the leaf drivers.
+ * It provides the low level data types and definitions for the firmware
+ * and device property providers. The respective API headers should
+ * guarantee all the required data types and definitions without including
+ * this header directly into the driver.sorry, i don't understand both "leaf drivers" and "respective API headers". could you have examples ?
leaf driver is like almost anything under drivers/iio, for example. The respective API headers is usually: of.h or property.h (the latter is highly preferred in a new code). TL;DR: the rule of thumb is do not include this until you know exactly what you are doing.
Signature · 2 lines
With Best Regards, Andy Shevchenko
Quoted 17 lines · Andy Shevchenko
Add a note to the
fwnode.hthat the header should not be used directly in the leaf drivers, they all should use the higher level APIs and the respective headers.Signed-off-by Andy Shevchenko <[email protected]>---
v2: added "...into the driver" piece at the end to remove ambiguity
include/linux/fwnode.h | 6 ++++++ 1 file changed, 6 insertions(+)include/linux/fwnode.h +0
-0
include/linux/fwnode.h line 6
Quoted 5 lines
include/linux/fwnode.h +2
-0@@ -2,6 +2,12 @@/* * fwnode.h - Firmware device node object handle type definition. * +* Note, this header is not meant to be used by the leaf drivers. +* It provides the low level data types and definitions for the firmware
Ack
include/linux/fwnode.h line 9
Quoted 3 lines
include/linux/fwnode.h +3
-0+* and device property providers. The respective API headers should +* guarantee all the required data types and definitions without including +* this header directly into the driver.
device property(include/linux/property.h)
^ | firmware node(include/linux/fwnode.h) ^ ^ ^ ^ | | | |
DT ACPI SWNODE ...
For various firmware implementations(DT|ACPI|SWNODE...), i feel we may allow them include fwnode.h by their header or source files.
Quoted 4 lines
include/linux/fwnode.h +1
-0+* * Copyright (C) 2015, Intel Corporation * Author: Rafael J. Wysocki <[email protected]> */
Andy Shevchenko
reviewerQuoted 4 lines · Zijun Hu
Quoted 3 lines · Andy Shevchenko
Add a note to the
fwnode.hthat the header should not be used directly in the leaf drivers, they all should use the higher level APIs and the respective headers.
...
Quoted 15 lines
Quoted 2 lines
+ * Note, this header is not meant to be used by the leaf drivers.
+ * It provides the low level data types and definitions for the firmwareAck
Quoted 3 lines
+ * and device property providers. The respective API headers should
+ * guarantee all the required data types and definitions without including
+ * this header directly into the driver.device property(include/linux/property.h)
^ | firmware node(include/linux/fwnode.h) ^ ^ ^ ^ | | | |
Quoted 4 lines
DT ACPI SWNODE ...
For various firmware implementations(DT|ACPI|SWNODE...), i feel we may allow them include
fwnode.hby their header or source files.
That's the point, yes. And that's what exactly I put under the first sentence. The device property providers are not the leaf drivers in this sense.
Signature · 2 lines
With Best Regards, Andy Shevchenko
Andy Shevchenko
reviewerQuoted 2 lines · Andy Shevchenko
Quoted 1 line · Zijun Hu
On 2025/4/1 00:35, Andy Shevchenko wrote:
...
Quoted 12 lines
Quoted 12 lines
Quoted 3 lines
+ * The respective API headers should
+ * guarantee all the required data types and definitions without including
+ * this header directly into the driver.device property(include/linux/property.h)
^ | firmware node(include/linux/fwnode.h) ^ ^ ^ ^ | | | |DT ACPI SWNODE ...
Quoted 5 lines
Quoted 2 lines
For various firmware implementations(DT|ACPI|SWNODE...), i feel we may allow them include
fwnode.hby their header or source files.That's the point, yes. And that's what exactly I put under the first sentence. The device property providers are not the leaf drivers in this sense.
FWIW, Rafael proposed better wording which I'm going to use in v3 in the header. Commit message would be similar, though.
Signature · 2 lines
With Best Regards, Andy Shevchenko