summaryrefslogtreecommitdiffstats
path: root/include
diff options
context:
space:
mode:
authorSimon Glass <sjg@chromium.org>2015-07-06 12:54:22 -0600
committerSimon Glass <sjg@chromium.org>2015-07-21 17:39:30 -0600
commit97f3ee34b6725f9fa5431e91db3223a53e55761c (patch)
tree7464b3e88a053adba51fb8f5fde20e7d9104ba0f /include
parente15bb3e63c87672c1f3b82edd9853eb7c3abfa20 (diff)
downloadtalos-obmc-uboot-97f3ee34b6725f9fa5431e91db3223a53e55761c.tar.gz
talos-obmc-uboot-97f3ee34b6725f9fa5431e91db3223a53e55761c.zip
dm: Add platform data advice and admonishment
We should guide people more strongly towards device tree to avoid the proliferation of platform data structures. Add documentation to the driver model README, and also the platform data header file. Signed-off-by: Simon Glass <sjg@chromium.org>
Diffstat (limited to 'include')
-rw-r--r--include/dm/platdata.h9
1 files changed, 9 insertions, 0 deletions
diff --git a/include/dm/platdata.h b/include/dm/platdata.h
index fbc8a6b3ad..6f4f00140e 100644
--- a/include/dm/platdata.h
+++ b/include/dm/platdata.h
@@ -16,6 +16,10 @@
/**
* struct driver_info - Information required to instantiate a device
*
+ * NOTE: Avoid using this except in extreme circumstances, where device tree
+ * is not feasible (e.g. serial driver in SPL where <8KB of SRAM is
+ * available). U-Boot's driver model uses device tree for configuration.
+ *
* @name: Driver name
* @platdata: Driver-specific platform data
*/
@@ -24,6 +28,11 @@ struct driver_info {
const void *platdata;
};
+/**
+ * NOTE: Avoid using these except in extreme circumstances, where device tree
+ * is not feasible (e.g. serial driver in SPL where <8KB of SRAM is
+ * available). U-Boot's driver model uses device tree for configuration.
+ */
#define U_BOOT_DEVICE(__name) \
ll_entry_declare(struct driver_info, __name, driver_info)
OpenPOWER on IntegriCloud