include/dm/platdata.h

   1 /* SPDX-License-Identifier: GPL-2.0+ */
   2 /*
   3  * Copyright (c) 2013 Google, Inc
   4  *
   5  * (C) Copyright 2012
   6  * Pavel Herrmann <morpheus.ibis@gmail.com>
   7  * Marek Vasut <marex@denx.de>
   8  */
   9
  10 #ifndef _DM_PLATDATA_H
  11 #define _DM_PLATDATA_H
  12
  13 #include <linker_lists.h>
  14
  15 /**
  16  * struct driver_info - Information required to instantiate a device
  17  *
  18  * NOTE: Avoid using this except in extreme circumstances, where device tree
  19  * is not feasible (e.g. serial driver in SPL where <8KB of SRAM is
  20  * available). U-Boot's driver model uses device tree for configuration.
  21  *
  22  * @name:       Driver name
  23  * @platdata:   Driver-specific platform data
  24  * @platdata_size: Size of platform data structure
  25  */
  26 struct driver_info {
  27         const char *name;
  28         const void *platdata;
  29 #if CONFIG_IS_ENABLED(OF_PLATDATA)
  30         uint platdata_size;
  31 #endif
  32 };
  33
  34 /**
  35  * driver_rt - runtime information set up by U-Boot
  36  *
  37  * There is one of these for every driver_info in the linker list, indexed by
  38  * the driver_info idx value.
  39  *
  40  * @dev: Device created from this idx
  41  */
  42 struct driver_rt {
  43         struct udevice *dev;
  44 };
  45
  46 /**
  47  * NOTE: Avoid using these except in extreme circumstances, where device tree
  48  * is not feasible (e.g. serial driver in SPL where <8KB of SRAM is
  49  * available). U-Boot's driver model uses device tree for configuration.
  50  */
  51 #define U_BOOT_DEVICE(__name)                                           \
  52         ll_entry_declare(struct driver_info, __name, driver_info)
  53
  54 /* Declare a list of devices. The argument is a driver_info[] array */
  55 #define U_BOOT_DEVICES(__name)                                          \
  56         ll_entry_declare_list(struct driver_info, __name, driver_info)
  57
  58 /**
  59  * Get a pointer to a given device info given its name
  60  *
  61  * With the declaration U_BOOT_DEVICE(name), DM_GET_DEVICE(name) will return a
  62  * pointer to the struct driver_info created by that declaration.
  63  *
  64  * if OF_PLATDATA is enabled, from this it is possible to use the @dev member of
  65  * struct driver_info to find the device pointer itself.
  66  *
  67  * TODO(sjg@chromium.org): U_BOOT_DEVICE() tells U-Boot to create a device, so
  68  * the naming seems sensible, but DM_GET_DEVICE() is a bit of misnomer, since it
  69  * finds the driver_info record, not the device.
  70  *
  71  * @__name: Driver name (C identifier, not a string. E.g. gpio7_at_ff7e0000)
  72  * @return struct driver_info * to the driver that created the device
  73  */
  74 #define DM_GET_DEVICE(__name)                                           \
  75         ll_entry_get(struct driver_info, __name, driver_info)
  76
  77 /**
  78  * dm_populate_phandle_data() - Populates phandle data in platda
  79  *
  80  * This populates phandle data with an U_BOOT_DEVICE entry get by
  81  * DM_GET_DEVICE. The implementation of this function will be done
  82  * by dtoc when parsing dtb.
  83  */
  84 void dm_populate_phandle_data(void);
  85 #endif