fdt_support.h 6.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198
  1. /*
  2. * (C) Copyright 2007
  3. * Gerald Van Baren, Custom IDEAS, vanbaren@cideas.com
  4. *
  5. * SPDX-License-Identifier: GPL-2.0+
  6. */
  7. #ifndef __FDT_SUPPORT_H
  8. #define __FDT_SUPPORT_H
  9. #ifdef CONFIG_OF_LIBFDT
  10. #include <libfdt.h>
  11. u32 fdt_getprop_u32_default_node(const void *fdt, int off, int cell,
  12. const char *prop, const u32 dflt);
  13. u32 fdt_getprop_u32_default(const void *fdt, const char *path,
  14. const char *prop, const u32 dflt);
  15. int fdt_root(void *fdt);
  16. int fdt_chosen(void *fdt);
  17. int fdt_initrd(void *fdt, ulong initrd_start, ulong initrd_end);
  18. void do_fixup_by_path(void *fdt, const char *path, const char *prop,
  19. const void *val, int len, int create);
  20. void do_fixup_by_path_u32(void *fdt, const char *path, const char *prop,
  21. u32 val, int create);
  22. static inline void do_fixup_by_path_string(void *fdt, const char *path,
  23. const char *prop, const char *status)
  24. {
  25. do_fixup_by_path(fdt, path, prop, status, strlen(status) + 1, 1);
  26. }
  27. void do_fixup_by_prop(void *fdt,
  28. const char *pname, const void *pval, int plen,
  29. const char *prop, const void *val, int len,
  30. int create);
  31. void do_fixup_by_prop_u32(void *fdt,
  32. const char *pname, const void *pval, int plen,
  33. const char *prop, u32 val, int create);
  34. void do_fixup_by_compat(void *fdt, const char *compat,
  35. const char *prop, const void *val, int len, int create);
  36. void do_fixup_by_compat_u32(void *fdt, const char *compat,
  37. const char *prop, u32 val, int create);
  38. int fdt_fixup_memory(void *blob, u64 start, u64 size);
  39. int fdt_fixup_memory_banks(void *blob, u64 start[], u64 size[], int banks);
  40. void fdt_fixup_ethernet(void *fdt);
  41. int fdt_find_and_setprop(void *fdt, const char *node, const char *prop,
  42. const void *val, int len, int create);
  43. void fdt_fixup_qe_firmware(void *fdt);
  44. /**
  45. * Update native-mode property of display-timings node to the phandle
  46. * of the timings matching a display by name (case insensitive).
  47. *
  48. * see kernel Documentation/devicetree/bindings/video/display-timing.txt
  49. *
  50. * @param blob FDT blob to update
  51. * @param path path within dt
  52. * @param display name of display timing to match
  53. * @return 0 if ok, or -FDT_ERR_... on error
  54. */
  55. int fdt_fixup_display(void *blob, const char *path, const char *display);
  56. #if defined(CONFIG_HAS_FSL_DR_USB) || defined(CONFIG_HAS_FSL_MPH_USB)
  57. void fdt_fixup_dr_usb(void *blob, bd_t *bd);
  58. #else
  59. static inline void fdt_fixup_dr_usb(void *blob, bd_t *bd) {}
  60. #endif /* defined(CONFIG_HAS_FSL_DR_USB) || defined(CONFIG_HAS_FSL_MPH_USB) */
  61. #if defined(CONFIG_SYS_FSL_SEC_COMPAT)
  62. void fdt_fixup_crypto_node(void *blob, int sec_rev);
  63. #else
  64. static inline void fdt_fixup_crypto_node(void *blob, int sec_rev) {}
  65. #endif
  66. #ifdef CONFIG_PCI
  67. #include <pci.h>
  68. int fdt_pci_dma_ranges(void *blob, int phb_off, struct pci_controller *hose);
  69. #endif
  70. int fdt_find_or_add_subnode(void *fdt, int parentoffset, const char *name);
  71. /**
  72. * Add board-specific data to the FDT before booting the OS.
  73. *
  74. * Use CONFIG_SYS_FDT_PAD to ensure there is sufficient space.
  75. * This function is called if CONFIG_OF_BOARD_SETUP is defined
  76. *
  77. * @param blob FDT blob to update
  78. * @param bd_t Pointer to board data
  79. * @return 0 if ok, or -FDT_ERR_... on error
  80. */
  81. int ft_board_setup(void *blob, bd_t *bd);
  82. /*
  83. * The keystone2 SOC requires all 32 bit aliased addresses to be converted
  84. * to their 36 physical format. This has to happen after all fdt nodes
  85. * are added or modified by the image_setup_libfdt(). The ft_board_setup_ex()
  86. * called at the end of the image_setup_libfdt() is to do that convertion.
  87. */
  88. void ft_board_setup_ex(void *blob, bd_t *bd);
  89. void ft_cpu_setup(void *blob, bd_t *bd);
  90. void ft_pci_setup(void *blob, bd_t *bd);
  91. /**
  92. * Add system-specific data to the FDT before booting the OS.
  93. *
  94. * Use CONFIG_SYS_FDT_PAD to ensure there is sufficient space.
  95. * This function is called if CONFIG_OF_SYSTEM_SETUP is defined
  96. *
  97. * @param blob FDT blob to update
  98. * @param bd_t Pointer to board data
  99. * @return 0 if ok, or -FDT_ERR_... on error
  100. */
  101. int ft_system_setup(void *blob, bd_t *bd);
  102. void set_working_fdt_addr(ulong addr);
  103. int fdt_shrink_to_minimum(void *blob);
  104. int fdt_increase_size(void *fdt, int add_len);
  105. int fdt_fixup_nor_flash_size(void *blob);
  106. void fdt_fixup_mtdparts(void *fdt, void *node_info, int node_info_size);
  107. void fdt_del_node_and_alias(void *blob, const char *alias);
  108. u64 fdt_translate_address(void *blob, int node_offset, const __be32 *in_addr);
  109. int fdt_node_offset_by_compat_reg(void *blob, const char *compat,
  110. phys_addr_t compat_off);
  111. int fdt_alloc_phandle(void *blob);
  112. int fdt_set_phandle(void *fdt, int nodeoffset, uint32_t phandle);
  113. unsigned int fdt_create_phandle(void *fdt, int nodeoffset);
  114. int fdt_add_edid(void *blob, const char *compat, unsigned char *buf);
  115. int fdt_verify_alias_address(void *fdt, int anode, const char *alias,
  116. u64 addr);
  117. u64 fdt_get_base_address(void *fdt, int node);
  118. int fdt_read_range(void *fdt, int node, int n, uint64_t *child_addr,
  119. uint64_t *addr, uint64_t *len);
  120. enum fdt_status {
  121. FDT_STATUS_OKAY,
  122. FDT_STATUS_DISABLED,
  123. FDT_STATUS_FAIL,
  124. FDT_STATUS_FAIL_ERROR_CODE,
  125. };
  126. int fdt_set_node_status(void *fdt, int nodeoffset,
  127. enum fdt_status status, unsigned int error_code);
  128. static inline int fdt_status_okay(void *fdt, int nodeoffset)
  129. {
  130. return fdt_set_node_status(fdt, nodeoffset, FDT_STATUS_OKAY, 0);
  131. }
  132. static inline int fdt_status_disabled(void *fdt, int nodeoffset)
  133. {
  134. return fdt_set_node_status(fdt, nodeoffset, FDT_STATUS_DISABLED, 0);
  135. }
  136. static inline int fdt_status_fail(void *fdt, int nodeoffset)
  137. {
  138. return fdt_set_node_status(fdt, nodeoffset, FDT_STATUS_FAIL, 0);
  139. }
  140. int fdt_set_status_by_alias(void *fdt, const char *alias,
  141. enum fdt_status status, unsigned int error_code);
  142. static inline int fdt_status_okay_by_alias(void *fdt, const char *alias)
  143. {
  144. return fdt_set_status_by_alias(fdt, alias, FDT_STATUS_OKAY, 0);
  145. }
  146. static inline int fdt_status_disabled_by_alias(void *fdt, const char *alias)
  147. {
  148. return fdt_set_status_by_alias(fdt, alias, FDT_STATUS_DISABLED, 0);
  149. }
  150. static inline int fdt_status_fail_by_alias(void *fdt, const char *alias)
  151. {
  152. return fdt_set_status_by_alias(fdt, alias, FDT_STATUS_FAIL, 0);
  153. }
  154. /* Helper to read a big number; size is in cells (not bytes) */
  155. static inline u64 of_read_number(const fdt32_t *cell, int size)
  156. {
  157. u64 r = 0;
  158. while (size--)
  159. r = (r << 32) | fdt32_to_cpu(*(cell++));
  160. return r;
  161. }
  162. void of_bus_default_count_cells(void *blob, int parentoffset,
  163. int *addrc, int *sizec);
  164. int ft_verify_fdt(void *fdt);
  165. int arch_fixup_memory_node(void *blob);
  166. int fdt_setup_simplefb_node(void *fdt, int node, u64 base_address, u32 width,
  167. u32 height, u32 stride, const char *format);
  168. #endif /* ifdef CONFIG_OF_LIBFDT */
  169. #ifdef USE_HOSTCC
  170. int fdtdec_get_int(const void *blob, int node, const char *prop_name,
  171. int default_val);
  172. #endif
  173. #endif /* ifndef __FDT_SUPPORT_H */