Merge git://git.denx.de/u-boot-marvell

[people/ms/u-boot.git] / include / dm / platdata.h

diff --git a/include/dm/platdata.h b/include/dm/platdata.h
index 2bc8b147edfed01f152c1ca5e310ba8248637534..6f4f00140e5690f404b3169e2dce4e2c0133e735 100644 (file)
--- a/include/dm/platdata.h
+++ b/include/dm/platdata.h
@@ -11,10 +11,16 @@
 #ifndef _DM_PLATDATA_H
 #define _DM_PLATDATA_H
 
+#include <linker_lists.h>
+
 /**
  * struct driver_info - Information required to instantiate a device
  *
- * @name:      Device name
+ * 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
  */
 struct driver_info {
@@ -22,7 +28,16 @@ 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)
 
+/* Declare a list of devices. The argument is a driver_info[] array */
+#define U_BOOT_DEVICES(__name)                                         \
+       ll_entry_declare_list(struct driver_info, __name, driver_info)
+
 #endif