platdata.h 1.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960
  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. #ifndef _DM_PLATDATA_H
  10. #define _DM_PLATDATA_H
  11. #include <linker_lists.h>
  12. /**
  13. * struct driver_info - Information required to instantiate a device
  14. *
  15. * NOTE: Avoid using this except in extreme circumstances, where device tree
  16. * is not feasible (e.g. serial driver in SPL where <8KB of SRAM is
  17. * available). U-Boot's driver model uses device tree for configuration.
  18. *
  19. * @name: Driver name
  20. * @platdata: Driver-specific platform data
  21. * @platdata_size: Size of platform data structure
  22. * @dev: Device created from this structure data
  23. */
  24. struct driver_info {
  25. const char *name;
  26. const void *platdata;
  27. #if CONFIG_IS_ENABLED(OF_PLATDATA)
  28. uint platdata_size;
  29. struct udevice *dev;
  30. #endif
  31. };
  32. /**
  33. * NOTE: Avoid using these except in extreme circumstances, where device tree
  34. * is not feasible (e.g. serial driver in SPL where <8KB of SRAM is
  35. * available). U-Boot's driver model uses device tree for configuration.
  36. */
  37. #define U_BOOT_DEVICE(__name) \
  38. ll_entry_declare(struct driver_info, __name, driver_info)
  39. /* Declare a list of devices. The argument is a driver_info[] array */
  40. #define U_BOOT_DEVICES(__name) \
  41. ll_entry_declare_list(struct driver_info, __name, driver_info)
  42. /* Get a pointer to a given driver */
  43. #define DM_GET_DEVICE(__name) \
  44. ll_entry_get(struct driver_info, __name, driver_info)
  45. /**
  46. * dm_populate_phandle_data() - Populates phandle data in platda
  47. *
  48. * This populates phandle data with an U_BOOT_DEVICE entry get by
  49. * DM_GET_DEVICE. The implementation of this function will be done
  50. * by dtoc when parsing dtb.
  51. */
  52. void dm_populate_phandle_data(void);
  53. #endif