Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 1 | #ifndef DEVICE_H |
Aaron Durbin | a0dabd1 | 2018-07-25 08:49:19 -0600 | [diff] [blame] | 2 | |
Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 3 | #define DEVICE_H |
| 4 | |
| 5 | #include <device/resource.h> |
Eric Biederman | e9a271e3 | 2003-09-02 03:36:25 +0000 | [diff] [blame] | 6 | #include <device/path.h> |
Elyes HAOUAS | e3682b6 | 2018-12-03 09:32:31 +0100 | [diff] [blame] | 7 | #include <device/pci_type.h> |
Elyes HAOUAS | c712144 | 2020-04-10 18:04:59 +0200 | [diff] [blame] | 8 | #include <smbios.h> |
Julius Werner | a214837 | 2019-11-13 19:50:33 -0800 | [diff] [blame] | 9 | #include <types.h> |
Aaron Durbin | c30d913 | 2017-08-07 16:55:43 -0600 | [diff] [blame] | 10 | |
Duncan Laurie | 36e6c6f | 2020-05-09 19:20:10 -0700 | [diff] [blame] | 11 | struct fw_config; |
Elyes HAOUAS | f9e47cc | 2018-12-05 11:03:36 +0100 | [diff] [blame] | 12 | struct device; |
Eric Biederman | 992cd00 | 2004-10-14 21:10:23 +0000 | [diff] [blame] | 13 | struct pci_operations; |
Duncan Laurie | ec00968 | 2016-06-07 15:38:14 -0700 | [diff] [blame] | 14 | struct i2c_bus_operations; |
Eric Biederman | 992cd00 | 2004-10-14 21:10:23 +0000 | [diff] [blame] | 15 | struct smbus_bus_operations; |
Nico Huber | dd4715b | 2013-06-10 22:08:35 +0200 | [diff] [blame] | 16 | struct pnp_mode_ops; |
Furquan Shaikh | 7606c37 | 2017-02-11 10:57:23 -0800 | [diff] [blame] | 17 | struct spi_bus_operations; |
Duncan Laurie | bae9f85 | 2018-05-07 14:18:13 -0700 | [diff] [blame] | 18 | struct usb_bus_operations; |
Eric Biederman | 7a5416a | 2003-06-12 19:23:51 +0000 | [diff] [blame] | 19 | |
Eric Biederman | 7003ba4 | 2004-10-16 06:20:29 +0000 | [diff] [blame] | 20 | /* Chip operations */ |
| 21 | struct chip_operations { |
Eric Biederman | 7003ba4 | 2004-10-16 06:20:29 +0000 | [diff] [blame] | 22 | void (*enable_dev)(struct device *dev); |
Nico Huber | acd7d95 | 2012-07-25 10:33:05 +0200 | [diff] [blame] | 23 | void (*init)(void *chip_info); |
Marc Jones | 2a58ecd | 2013-10-29 17:32:00 -0600 | [diff] [blame] | 24 | void (*final)(void *chip_info); |
Nico Huber | acd7d95 | 2012-07-25 10:33:05 +0200 | [diff] [blame] | 25 | unsigned int initialized : 1; |
Marc Jones | 2a58ecd | 2013-10-29 17:32:00 -0600 | [diff] [blame] | 26 | unsigned int finalized : 1; |
Myles Watson | 6e23576 | 2009-09-29 14:56:15 +0000 | [diff] [blame] | 27 | const char *name; |
Eric Biederman | 7003ba4 | 2004-10-16 06:20:29 +0000 | [diff] [blame] | 28 | }; |
| 29 | |
Eric Biederman | 018d8dd | 2004-11-04 11:04:33 +0000 | [diff] [blame] | 30 | #define CHIP_NAME(X) .name = X, |
Eric Biederman | 018d8dd | 2004-11-04 11:04:33 +0000 | [diff] [blame] | 31 | |
Yinghai Lu | 13f1c2a | 2005-07-08 02:49:49 +0000 | [diff] [blame] | 32 | struct bus; |
| 33 | |
Vladimir Serbinenko | 2d7bd8a | 2014-08-30 19:28:05 +0200 | [diff] [blame] | 34 | struct acpi_rsdp; |
Vladimir Serbinenko | 6abb33c | 2014-08-27 23:42:45 +0200 | [diff] [blame] | 35 | |
Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 36 | struct device_operations { |
Aaron Durbin | c30d913 | 2017-08-07 16:55:43 -0600 | [diff] [blame] | 37 | void (*read_resources)(struct device *dev); |
| 38 | void (*set_resources)(struct device *dev); |
| 39 | void (*enable_resources)(struct device *dev); |
| 40 | void (*init)(struct device *dev); |
| 41 | void (*final)(struct device *dev); |
| 42 | void (*scan_bus)(struct device *bus); |
| 43 | void (*enable)(struct device *dev); |
| 44 | void (*disable)(struct device *dev); |
Yinghai Lu | 13f1c2a | 2005-07-08 02:49:49 +0000 | [diff] [blame] | 45 | void (*reset_bus)(struct bus *bus); |
Julius Werner | cd49cce | 2019-03-05 16:53:33 -0800 | [diff] [blame] | 46 | #if CONFIG(GENERATE_SMBIOS_TABLES) |
Aaron Durbin | c30d913 | 2017-08-07 16:55:43 -0600 | [diff] [blame] | 47 | int (*get_smbios_data)(struct device *dev, int *handle, |
Lee Leahy | 6a566d7 | 2017-03-07 17:45:12 -0800 | [diff] [blame] | 48 | unsigned long *current); |
Aaron Durbin | c30d913 | 2017-08-07 16:55:43 -0600 | [diff] [blame] | 49 | void (*get_smbios_strings)(struct device *dev, struct smbios_type11 *t); |
Sven Schnelle | 164bcfd | 2011-08-14 20:56:34 +0200 | [diff] [blame] | 50 | #endif |
Julius Werner | cd49cce | 2019-03-05 16:53:33 -0800 | [diff] [blame] | 51 | #if CONFIG(HAVE_ACPI_TABLES) |
Furquan Shaikh | 0f007d8 | 2020-04-24 06:41:18 -0700 | [diff] [blame] | 52 | unsigned long (*write_acpi_tables)(const struct device *dev, |
Aaron Durbin | c30d913 | 2017-08-07 16:55:43 -0600 | [diff] [blame] | 53 | unsigned long start, struct acpi_rsdp *rsdp); |
Furquan Shaikh | 7536a39 | 2020-04-24 21:59:21 -0700 | [diff] [blame] | 54 | void (*acpi_fill_ssdt)(const struct device *dev); |
Furquan Shaikh | 338fd9a | 2020-04-24 22:57:05 -0700 | [diff] [blame] | 55 | void (*acpi_inject_dsdt)(const struct device *dev); |
Aaron Durbin | aa090cb | 2017-09-13 16:01:52 -0600 | [diff] [blame] | 56 | const char *(*acpi_name)(const struct device *dev); |
Patrick Rudolph | eeb8e74 | 2019-08-20 08:20:01 +0200 | [diff] [blame] | 57 | /* Returns the optional _HID (Hardware ID) */ |
| 58 | const char *(*acpi_hid)(const struct device *dev); |
Vladimir Serbinenko | 2d7bd8a | 2014-08-30 19:28:05 +0200 | [diff] [blame] | 59 | #endif |
Eric Biederman | a9e632c | 2004-11-18 22:38:08 +0000 | [diff] [blame] | 60 | const struct pci_operations *ops_pci; |
Duncan Laurie | ec00968 | 2016-06-07 15:38:14 -0700 | [diff] [blame] | 61 | const struct i2c_bus_operations *ops_i2c_bus; |
Furquan Shaikh | 7606c37 | 2017-02-11 10:57:23 -0800 | [diff] [blame] | 62 | const struct spi_bus_operations *ops_spi_bus; |
Eric Biederman | a9e632c | 2004-11-18 22:38:08 +0000 | [diff] [blame] | 63 | const struct smbus_bus_operations *ops_smbus_bus; |
Nico Huber | dd4715b | 2013-06-10 22:08:35 +0200 | [diff] [blame] | 64 | const struct pnp_mode_ops *ops_pnp_mode; |
Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 65 | }; |
Kyösti Mälkki | f41cb4e | 2014-06-30 13:15:42 +0300 | [diff] [blame] | 66 | |
Edward O'Callaghan | 530355d | 2014-10-31 08:31:44 +1100 | [diff] [blame] | 67 | /** |
| 68 | * Standard device operations function pointers shims. |
| 69 | */ |
Nico Huber | 2f8ba69 | 2020-04-05 14:05:24 +0200 | [diff] [blame] | 70 | static inline void noop_read_resources(struct device *dev) {} |
| 71 | static inline void noop_set_resources(struct device *dev) {} |
Edward O'Callaghan | 530355d | 2014-10-31 08:31:44 +1100 | [diff] [blame] | 72 | |
Eric Biederman | e9a271e3 | 2003-09-02 03:36:25 +0000 | [diff] [blame] | 73 | struct bus { |
Stefan Reinauer | 57879c9 | 2012-07-31 16:47:25 -0700 | [diff] [blame] | 74 | |
Aaron Durbin | e4d7abc | 2017-04-16 22:05:36 -0500 | [diff] [blame] | 75 | DEVTREE_CONST struct device *dev; /* This bridge device */ |
| 76 | DEVTREE_CONST struct device *children; /* devices behind this bridge */ |
| 77 | DEVTREE_CONST struct bus *next; /* The next bridge on this device */ |
Lee Leahy | 0ca2a06 | 2017-03-06 18:01:04 -0800 | [diff] [blame] | 78 | unsigned int bridge_ctrl; /* Bridge control register */ |
Kyösti Mälkki | 3345240 | 2015-02-23 06:58:26 +0200 | [diff] [blame] | 79 | uint16_t bridge_cmd; /* Bridge command register */ |
Myles Watson | 894a347 | 2010-06-09 22:41:35 +0000 | [diff] [blame] | 80 | unsigned char link_num; /* The index of this link */ |
Lee Leahy | 84d20d0 | 2017-03-07 15:00:18 -0800 | [diff] [blame] | 81 | uint16_t secondary; /* secondary bus number */ |
Yinghai Lu | d4b278c | 2006-10-04 20:46:15 +0000 | [diff] [blame] | 82 | uint16_t subordinate; /* max subordinate bus number */ |
Eric Biederman | e9a271e3 | 2003-09-02 03:36:25 +0000 | [diff] [blame] | 83 | unsigned char cap; /* PCi capability offset */ |
Kyösti Mälkki | 7752147 | 2015-02-22 11:38:49 +0200 | [diff] [blame] | 84 | uint32_t hcdn_reg; /* For HyperTransport link */ |
| 85 | |
Lee Leahy | 0ca2a06 | 2017-03-06 18:01:04 -0800 | [diff] [blame] | 86 | unsigned int reset_needed : 1; |
| 87 | unsigned int disable_relaxed_ordering : 1; |
| 88 | unsigned int ht_link_up : 1; |
Nico Huber | 061b905 | 2019-09-21 15:58:23 +0200 | [diff] [blame] | 89 | unsigned int no_vga16 : 1; /* No support for 16-bit VGA decoding */ |
Eric Biederman | e9a271e3 | 2003-09-02 03:36:25 +0000 | [diff] [blame] | 90 | }; |
| 91 | |
Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 92 | /* |
Eric Biederman | 2c018fb | 2003-07-21 20:13:45 +0000 | [diff] [blame] | 93 | * There is one device structure for each slot-number/function-number |
Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 94 | * combination: |
| 95 | */ |
| 96 | |
Sven Schnelle | 0fa50a1 | 2012-06-21 22:19:48 +0200 | [diff] [blame] | 97 | struct pci_irq_info { |
| 98 | unsigned int ioapic_irq_pin; |
| 99 | unsigned int ioapic_src_pin; |
| 100 | unsigned int ioapic_dst_id; |
| 101 | unsigned int ioapic_flags; |
| 102 | }; |
| 103 | |
Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 104 | struct device { |
Aaron Durbin | e4d7abc | 2017-04-16 22:05:36 -0500 | [diff] [blame] | 105 | DEVTREE_CONST struct bus *bus; /* bus this device is on, for bridge |
Li-Ta Lo | 0493069 | 2004-11-25 17:37:19 +0000 | [diff] [blame] | 106 | * devices, it is the up stream bus */ |
Stefan Reinauer | 57879c9 | 2012-07-31 16:47:25 -0700 | [diff] [blame] | 107 | |
Aaron Durbin | e4d7abc | 2017-04-16 22:05:36 -0500 | [diff] [blame] | 108 | DEVTREE_CONST struct device *sibling; /* next device on this bus */ |
Stefan Reinauer | 57879c9 | 2012-07-31 16:47:25 -0700 | [diff] [blame] | 109 | |
Aaron Durbin | e4d7abc | 2017-04-16 22:05:36 -0500 | [diff] [blame] | 110 | DEVTREE_CONST struct device *next; /* chain of all devices */ |
Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 111 | |
Eric Biederman | e9a271e3 | 2003-09-02 03:36:25 +0000 | [diff] [blame] | 112 | struct device_path path; |
Lee Leahy | 0ca2a06 | 2017-03-06 18:01:04 -0800 | [diff] [blame] | 113 | unsigned int vendor; |
| 114 | unsigned int device; |
Sven Schnelle | b8269e2 | 2011-03-01 21:51:29 +0000 | [diff] [blame] | 115 | u16 subsystem_vendor; |
| 116 | u16 subsystem_device; |
Stefan Reinauer | debb11f | 2008-10-29 04:46:52 +0000 | [diff] [blame] | 117 | unsigned int class; /* 3 bytes: (base, sub, prog-if) */ |
Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 118 | unsigned int hdr_type; /* PCI header type */ |
Li-Ta Lo | 69c5a90 | 2004-04-29 20:08:54 +0000 | [diff] [blame] | 119 | unsigned int enabled : 1; /* set if we should enable the device */ |
Lee Leahy | 6a566d7 | 2017-03-07 17:45:12 -0800 | [diff] [blame] | 120 | unsigned int initialized : 1; /* 1 if we have initialized the device */ |
Eric Biederman | dbec2d4 | 2004-10-21 10:44:08 +0000 | [diff] [blame] | 121 | unsigned int on_mainboard : 1; |
Nico Huber | 570b183 | 2017-08-30 13:38:50 +0200 | [diff] [blame] | 122 | unsigned int disable_pcie_aspm : 1; |
Ronald G. Minnich | 466ca2c | 2019-10-22 02:02:24 +0000 | [diff] [blame] | 123 | /* set if we should hide from UI */ |
| 124 | unsigned int hidden : 1; |
| 125 | /* set if this device is used even in minimum PCI cases */ |
| 126 | unsigned int mandatory : 1; |
Myles Watson | 29cc9ed | 2009-07-02 18:56:24 +0000 | [diff] [blame] | 127 | u8 command; |
Jeremy Soller | cf2ac54 | 2019-10-09 21:40:36 -0600 | [diff] [blame] | 128 | uint16_t hotplug_buses; /* Number of hotplug buses to allocate */ |
Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 129 | |
Li-Ta Lo | 85e76c6 | 2004-12-27 17:53:45 +0000 | [diff] [blame] | 130 | /* Base registers for this device. I/O, MEM and Expansion ROM */ |
Aaron Durbin | e4d7abc | 2017-04-16 22:05:36 -0500 | [diff] [blame] | 131 | DEVTREE_CONST struct resource *resource_list; |
Eric Biederman | e9a271e3 | 2003-09-02 03:36:25 +0000 | [diff] [blame] | 132 | |
Myles Watson | 29cc9ed | 2009-07-02 18:56:24 +0000 | [diff] [blame] | 133 | /* links are (downstream) buses attached to the device, usually a leaf |
Myles Watson | c25cc11 | 2010-05-21 14:33:48 +0000 | [diff] [blame] | 134 | * device with no children has 0 buses attached and a bridge has 1 bus |
Yinghai Lu | 13f1c2a | 2005-07-08 02:49:49 +0000 | [diff] [blame] | 135 | */ |
Aaron Durbin | e4d7abc | 2017-04-16 22:05:36 -0500 | [diff] [blame] | 136 | DEVTREE_CONST struct bus *link_list; |
Eric Biederman | e9a271e3 | 2003-09-02 03:36:25 +0000 | [diff] [blame] | 137 | |
Aaron Durbin | e4d7abc | 2017-04-16 22:05:36 -0500 | [diff] [blame] | 138 | #if !DEVTREE_EARLY |
Kyösti Mälkki | 1557a67 | 2019-06-30 10:51:31 +0300 | [diff] [blame] | 139 | struct pci_irq_info pci_irq_info[4]; |
Kyösti Mälkki | cac0231 | 2019-06-30 08:40:04 +0300 | [diff] [blame] | 140 | struct device_operations *ops; |
Nico Huber | acd7d95 | 2012-07-25 10:33:05 +0200 | [diff] [blame] | 141 | struct chip_operations *chip_ops; |
Kyösti Mälkki | 7d54eb8 | 2012-10-10 23:14:28 +0300 | [diff] [blame] | 142 | const char *name; |
Patrick Rudolph | ac24d3c | 2019-04-12 14:42:17 +0200 | [diff] [blame] | 143 | #if CONFIG(GENERATE_SMBIOS_TABLES) |
| 144 | u8 smbios_slot_type; |
| 145 | u8 smbios_slot_data_width; |
| 146 | u8 smbios_slot_length; |
| 147 | const char *smbios_slot_designation; |
| 148 | #endif |
Stefan Reinauer | a675d49 | 2012-08-07 14:50:47 -0700 | [diff] [blame] | 149 | #endif |
Aaron Durbin | e4d7abc | 2017-04-16 22:05:36 -0500 | [diff] [blame] | 150 | DEVTREE_CONST void *chip_info; |
Duncan Laurie | 36e6c6f | 2020-05-09 19:20:10 -0700 | [diff] [blame] | 151 | |
| 152 | /* Zero-terminated array of fields and options to probe. */ |
| 153 | DEVTREE_CONST struct fw_config *probe_list; |
Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 154 | }; |
| 155 | |
Myles Watson | 3fe6b70 | 2009-10-09 20:13:43 +0000 | [diff] [blame] | 156 | /** |
| 157 | * This is the root of the device tree. The device tree is defined in the |
| 158 | * static.c file and is generated by the config tool at compile time. |
| 159 | */ |
Aaron Durbin | e4d7abc | 2017-04-16 22:05:36 -0500 | [diff] [blame] | 160 | extern DEVTREE_CONST struct device dev_root; |
Aaron Durbin | f034902 | 2017-11-10 10:47:54 -0700 | [diff] [blame] | 161 | /* list of all devices */ |
| 162 | extern DEVTREE_CONST struct device * DEVTREE_CONST all_devices; |
Myles Watson | c25cc11 | 2010-05-21 14:33:48 +0000 | [diff] [blame] | 163 | extern struct resource *free_resources; |
Myles Watson | 894a347 | 2010-06-09 22:41:35 +0000 | [diff] [blame] | 164 | extern struct bus *free_links; |
Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 165 | |
Kyösti Mälkki | a93c3fe | 2012-10-09 22:28:56 +0300 | [diff] [blame] | 166 | extern const char mainboard_name[]; |
| 167 | |
Julius Werner | cd49cce | 2019-03-05 16:53:33 -0800 | [diff] [blame] | 168 | #if CONFIG(GFXUMA) |
Kyösti Mälkki | cc55b9b | 2012-07-11 07:55:21 +0300 | [diff] [blame] | 169 | /* IGD UMA memory */ |
Kyösti Mälkki | cc55b9b | 2012-07-11 07:55:21 +0300 | [diff] [blame] | 170 | extern uint64_t uma_memory_base; |
| 171 | extern uint64_t uma_memory_size; |
Kyösti Mälkki | 5f09807 | 2013-10-18 11:02:46 +0300 | [diff] [blame] | 172 | #endif |
Kyösti Mälkki | cc55b9b | 2012-07-11 07:55:21 +0300 | [diff] [blame] | 173 | |
Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 174 | /* Generic device interface functions */ |
Aaron Durbin | f034902 | 2017-11-10 10:47:54 -0700 | [diff] [blame] | 175 | struct device *alloc_dev(struct bus *parent, struct device_path *path); |
Nico Huber | acd7d95 | 2012-07-25 10:33:05 +0200 | [diff] [blame] | 176 | void dev_initialize_chips(void); |
Stefan Reinauer | be7f798 | 2009-03-13 15:42:27 +0000 | [diff] [blame] | 177 | void dev_enumerate(void); |
| 178 | void dev_configure(void); |
| 179 | void dev_enable(void); |
| 180 | void dev_initialize(void); |
| 181 | void dev_optimize(void); |
Marc Jones | 2a58ecd | 2013-10-29 17:32:00 -0600 | [diff] [blame] | 182 | void dev_finalize(void); |
| 183 | void dev_finalize_chips(void); |
Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 184 | |
| 185 | /* Generic device helper functions */ |
Stefan Reinauer | be7f798 | 2009-03-13 15:42:27 +0000 | [diff] [blame] | 186 | int reset_bus(struct bus *bus); |
Kyösti Mälkki | 2d2367c | 2015-02-20 21:28:31 +0200 | [diff] [blame] | 187 | void scan_bridges(struct bus *bus); |
Stefan Reinauer | be7f798 | 2009-03-13 15:42:27 +0000 | [diff] [blame] | 188 | void assign_resources(struct bus *bus); |
Furquan Shaikh | 5b5c233 | 2020-04-24 21:31:35 -0700 | [diff] [blame] | 189 | const char *dev_name(const struct device *dev); |
Lubomir Rintel | 9ba8f7c | 2018-04-26 00:00:22 +0200 | [diff] [blame] | 190 | const char *dev_path(const struct device *dev); |
Subrata Banik | 564547f | 2018-05-02 10:27:36 +0530 | [diff] [blame] | 191 | u32 dev_path_encode(const struct device *dev); |
Yinghai Lu | 13f1c2a | 2005-07-08 02:49:49 +0000 | [diff] [blame] | 192 | const char *bus_path(struct bus *bus); |
Aaron Durbin | f034902 | 2017-11-10 10:47:54 -0700 | [diff] [blame] | 193 | void dev_set_enabled(struct device *dev, int enable); |
Stefan Reinauer | be7f798 | 2009-03-13 15:42:27 +0000 | [diff] [blame] | 194 | void disable_children(struct bus *bus); |
Aaron Durbin | f034902 | 2017-11-10 10:47:54 -0700 | [diff] [blame] | 195 | bool dev_is_active_bridge(struct device *dev); |
Jacob Garber | 464f4d6 | 2019-06-05 17:03:30 -0600 | [diff] [blame] | 196 | void add_more_links(struct device *dev, unsigned int total_links); |
Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 197 | |
Angel Pons | a7d9266 | 2020-07-25 16:00:28 +0200 | [diff] [blame] | 198 | static inline bool is_dev_enabled(const struct device *const dev) |
| 199 | { |
| 200 | return dev && dev->enabled; |
| 201 | } |
| 202 | |
Myles Watson | b025911 | 2010-03-05 18:27:19 +0000 | [diff] [blame] | 203 | /* Option ROM helper functions */ |
| 204 | void run_bios(struct device *dev, unsigned long addr); |
| 205 | |
Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 206 | /* Helper functions */ |
Kyösti Mälkki | 2df1c12 | 2018-05-21 01:52:10 +0300 | [diff] [blame] | 207 | DEVTREE_CONST struct device *find_dev_path( |
| 208 | const struct bus *parent, |
| 209 | const struct device_path *path); |
Rob Barnes | a223e65 | 2020-07-23 08:25:42 -0600 | [diff] [blame] | 210 | DEVTREE_CONST struct device *find_dev_nested_path( |
| 211 | const struct bus *parent, |
| 212 | const struct device_path nested_path[], |
| 213 | size_t nested_path_length); |
Aaron Durbin | f034902 | 2017-11-10 10:47:54 -0700 | [diff] [blame] | 214 | struct device *alloc_find_dev(struct bus *parent, struct device_path *path); |
| 215 | struct device *dev_find_device(u16 vendor, u16 device, struct device *from); |
| 216 | struct device *dev_find_class(unsigned int class, struct device *from); |
Nico Huber | f6a4344 | 2018-05-15 14:13:32 +0200 | [diff] [blame] | 217 | DEVTREE_CONST struct device *dev_find_path( |
| 218 | DEVTREE_CONST struct device *prev_match, |
| 219 | enum device_path_type path_type); |
Aaron Durbin | f034902 | 2017-11-10 10:47:54 -0700 | [diff] [blame] | 220 | struct device *dev_find_lapic(unsigned int apic_id); |
Stefan Reinauer | dc8448fd | 2012-03-30 13:52:58 -0700 | [diff] [blame] | 221 | int dev_count_cpu(void); |
arch import user (historical) | 98d0d30 | 2005-07-06 17:13:46 +0000 | [diff] [blame] | 222 | |
Furquan Shaikh | 1f3055a | 2020-04-20 17:59:50 -0700 | [diff] [blame] | 223 | /* |
| 224 | * Signature for matching function that is used by dev_find_matching_device_on_bus() to decide |
| 225 | * if the device being considered is the one that matches the caller's criteria. This function |
| 226 | * is supposed to return true if the provided device matches the criteria, else false. |
| 227 | */ |
| 228 | typedef bool (*match_device_fn)(DEVTREE_CONST struct device *dev); |
| 229 | /* |
| 230 | * Returns the first device on the bus that the match_device_fn returns true for. If no such |
| 231 | * device is found, it returns NULL. |
| 232 | */ |
| 233 | DEVTREE_CONST struct device *dev_find_matching_device_on_bus(const struct bus *bus, |
| 234 | match_device_fn fn); |
| 235 | |
Aaron Durbin | f034902 | 2017-11-10 10:47:54 -0700 | [diff] [blame] | 236 | struct device *add_cpu_device(struct bus *cpu_bus, unsigned int apic_id, |
| 237 | int enabled); |
| 238 | void set_cpu_topology(struct device *cpu, unsigned int node, |
| 239 | unsigned int package, unsigned int core, unsigned int thread); |
Kyösti Mälkki | c33f1e9 | 2012-08-07 17:12:11 +0300 | [diff] [blame] | 240 | |
| 241 | #define amd_cpu_topology(cpu, node, core) \ |
| 242 | set_cpu_topology(cpu, node, 0, core, 0) |
| 243 | |
| 244 | #define intel_cpu_topology(cpu, package, core, thread) \ |
| 245 | set_cpu_topology(cpu, 0, package, core, thread) |
| 246 | |
Kyösti Mälkki | b3267e0 | 2019-08-13 16:44:04 +0300 | [diff] [blame] | 247 | void mp_init_cpus(DEVTREE_CONST struct bus *cpu_bus); |
| 248 | static inline void mp_cpu_bus_init(struct device *dev) |
| 249 | { |
| 250 | mp_init_cpus(dev->link_list); |
| 251 | } |
| 252 | |
Myles Watson | bb3d812 | 2009-05-11 22:45:35 +0000 | [diff] [blame] | 253 | /* Debug functions */ |
Lubomir Rintel | 9ba8f7c | 2018-04-26 00:00:22 +0200 | [diff] [blame] | 254 | void print_resource_tree(const struct device *root, int debug_level, |
Myles Watson | bb3d812 | 2009-05-11 22:45:35 +0000 | [diff] [blame] | 255 | const char *msg); |
Lubomir Rintel | 9ba8f7c | 2018-04-26 00:00:22 +0200 | [diff] [blame] | 256 | void show_devs_tree(const struct device *dev, int debug_level, int depth); |
Myles Watson | bb3d812 | 2009-05-11 22:45:35 +0000 | [diff] [blame] | 257 | void show_devs_subtree(struct device *root, int debug_level, const char *msg); |
| 258 | void show_all_devs(int debug_level, const char *msg); |
Maciej Pijanka | ea92185 | 2009-10-27 14:29:29 +0000 | [diff] [blame] | 259 | void show_all_devs_tree(int debug_level, const char *msg); |
Myles Watson | bb3d812 | 2009-05-11 22:45:35 +0000 | [diff] [blame] | 260 | void show_one_resource(int debug_level, struct device *dev, |
| 261 | struct resource *resource, const char *comment); |
Lee Leahy | 6d71a43 | 2017-03-07 15:24:16 -0800 | [diff] [blame] | 262 | void show_all_devs_resources(int debug_level, const char *msg); |
Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 263 | |
Marc Jones | 5b5c52e | 2020-10-12 11:44:46 -0600 | [diff] [blame] | 264 | /* Debug macros */ |
| 265 | #if CONFIG(DEBUG_RESOURCES) |
| 266 | #include <console/console.h> |
| 267 | #define LOG_MEM_RESOURCE(type, dev, index, base_kb, size_kb) \ |
| 268 | printk(BIOS_SPEW, "%s:%d res: %s, dev: %s, index: 0x%x, base: 0x%llx, " \ |
| 269 | "end: 0x%llx, size_kb: 0x%llx\n", \ |
| 270 | __func__, __LINE__, type, dev_path(dev), index, (base_kb << 10), \ |
| 271 | (base_kb << 10) + (size_kb << 10) - 1, size_kb) |
| 272 | |
| 273 | #define LOG_IO_RESOURCE(type, dev, index, base, size) \ |
| 274 | printk(BIOS_SPEW, "%s:%d res: %s, dev: %s, index: 0x%x, base: 0x%llx, " \ |
| 275 | "end: 0x%llx, size: 0x%llx\n", \ |
| 276 | __func__, __LINE__, type, dev_path(dev), index, base, base + size - 1, size) |
| 277 | #else /* DEBUG_RESOURCES*/ |
| 278 | #define LOG_MEM_RESOURCE(type, dev, index, base_kb, size_kb) |
| 279 | #define LOG_IO_RESOURCE(type, dev, index, base, size) |
| 280 | #endif /* DEBUG_RESOURCES*/ |
| 281 | |
Marc Jones | 8b522db | 2020-10-12 11:58:46 -0600 | [diff] [blame] | 282 | #if CONFIG(DEBUG_FUNC) |
| 283 | #include <console/console.h> |
| 284 | #define DEV_FUNC_ENTER(dev) \ |
| 285 | printk(BIOS_SPEW, "%s:%s:%d: ENTER (dev: %s)\n", \ |
| 286 | __FILE__, __func__, __LINE__, dev_path(dev)) |
| 287 | |
| 288 | #define DEV_FUNC_EXIT(dev) \ |
| 289 | printk(BIOS_SPEW, "%s:%s:%d: EXIT (dev: %s)\n", __FILE__, \ |
| 290 | __func__, __LINE__, dev_path(dev)) |
| 291 | #else /* DEBUG_FUNC */ |
| 292 | #define DEV_FUNC_ENTER(dev) |
| 293 | #define DEV_FUNC_EXIT(dev) |
| 294 | #endif /* DEBUG_FUNC */ |
| 295 | |
Stefan Reinauer | 14e2277 | 2010-04-27 06:56:47 +0000 | [diff] [blame] | 296 | /* Rounding for boundaries. |
Myles Watson | bb3d812 | 2009-05-11 22:45:35 +0000 | [diff] [blame] | 297 | * Due to some chip bugs, go ahead and round IO to 16 |
Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 298 | */ |
Stefan Reinauer | 14e2277 | 2010-04-27 06:56:47 +0000 | [diff] [blame] | 299 | #define DEVICE_IO_ALIGN 16 |
Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 300 | #define DEVICE_MEM_ALIGN 4096 |
| 301 | |
Stefan Reinauer | be7f798 | 2009-03-13 15:42:27 +0000 | [diff] [blame] | 302 | extern struct device_operations default_dev_ops_root; |
Myles Watson | 29cc9ed | 2009-07-02 18:56:24 +0000 | [diff] [blame] | 303 | void pci_domain_read_resources(struct device *dev); |
Raul E Rangel | 5cb34e2 | 2020-05-04 16:41:22 -0600 | [diff] [blame] | 304 | void pci_domain_set_resources(struct device *dev); |
Kyösti Mälkki | 580e722 | 2015-03-19 21:04:23 +0200 | [diff] [blame] | 305 | void pci_domain_scan_bus(struct device *dev); |
Uwe Hermann | 4b42a62 | 2010-10-11 19:36:13 +0000 | [diff] [blame] | 306 | |
Subrata Banik | 217ca36 | 2019-03-15 17:18:44 +0530 | [diff] [blame] | 307 | void fixed_io_resource(struct device *dev, unsigned long index, |
| 308 | unsigned long base, unsigned long size); |
| 309 | |
Aaron Durbin | f034902 | 2017-11-10 10:47:54 -0700 | [diff] [blame] | 310 | void fixed_mem_resource(struct device *dev, unsigned long index, |
Kyösti Mälkki | ecf1ed4 | 2012-07-27 08:37:12 +0300 | [diff] [blame] | 311 | unsigned long basek, unsigned long sizek, unsigned long type); |
| 312 | |
Kyösti Mälkki | e25b5ef | 2016-12-02 08:56:05 +0200 | [diff] [blame] | 313 | void mmconf_resource_init(struct resource *res, resource_t base, int buses); |
| 314 | void mmconf_resource(struct device *dev, unsigned long index); |
| 315 | |
Kyösti Mälkki | 1ec5e74 | 2012-07-26 23:51:20 +0300 | [diff] [blame] | 316 | /* It is the caller's responsibility to adjust regions such that ram_resource() |
| 317 | * and mmio_resource() do not overlap. |
Kyösti Mälkki | 1ec5e74 | 2012-07-26 23:51:20 +0300 | [diff] [blame] | 318 | */ |
Kyösti Mälkki | ecf1ed4 | 2012-07-27 08:37:12 +0300 | [diff] [blame] | 319 | #define ram_resource(dev, idx, basek, sizek) \ |
| 320 | fixed_mem_resource(dev, idx, basek, sizek, IORESOURCE_CACHEABLE) |
| 321 | |
Aaron Durbin | c965076 | 2013-03-22 22:03:09 -0500 | [diff] [blame] | 322 | #define reserved_ram_resource(dev, idx, basek, sizek) \ |
Lee Leahy | 6a566d7 | 2017-03-07 17:45:12 -0800 | [diff] [blame] | 323 | fixed_mem_resource(dev, idx, basek, sizek, IORESOURCE_CACHEABLE \ |
| 324 | | IORESOURCE_RESERVE) |
Aaron Durbin | c965076 | 2013-03-22 22:03:09 -0500 | [diff] [blame] | 325 | |
Kyösti Mälkki | ecf1ed4 | 2012-07-27 08:37:12 +0300 | [diff] [blame] | 326 | #define bad_ram_resource(dev, idx, basek, sizek) \ |
Aaron Durbin | c965076 | 2013-03-22 22:03:09 -0500 | [diff] [blame] | 327 | reserved_ram_resource((dev), (idx), (basek), (sizek)) |
Kyösti Mälkki | ecf1ed4 | 2012-07-27 08:37:12 +0300 | [diff] [blame] | 328 | |
| 329 | #define uma_resource(dev, idx, basek, sizek) \ |
Aaron Durbin | a755614 | 2013-03-22 22:09:46 -0500 | [diff] [blame] | 330 | fixed_mem_resource(dev, idx, basek, sizek, IORESOURCE_RESERVE) |
Kyösti Mälkki | ecf1ed4 | 2012-07-27 08:37:12 +0300 | [diff] [blame] | 331 | |
| 332 | #define mmio_resource(dev, idx, basek, sizek) \ |
Aaron Durbin | a755614 | 2013-03-22 22:09:46 -0500 | [diff] [blame] | 333 | fixed_mem_resource(dev, idx, basek, sizek, IORESOURCE_RESERVE) |
Kyösti Mälkki | ecf1ed4 | 2012-07-27 08:37:12 +0300 | [diff] [blame] | 334 | |
Subrata Banik | 217ca36 | 2019-03-15 17:18:44 +0530 | [diff] [blame] | 335 | #define io_resource(dev, idx, base, size) \ |
| 336 | fixed_io_resource(dev, idx, base, size) |
| 337 | |
Uwe Hermann | 4b42a62 | 2010-10-11 19:36:13 +0000 | [diff] [blame] | 338 | void tolm_test(void *gp, struct device *dev, struct resource *new); |
| 339 | u32 find_pci_tolm(struct bus *bus); |
Kyösti Mälkki | ef84401 | 2013-06-25 23:17:43 +0300 | [diff] [blame] | 340 | |
Aaron Durbin | e4d7abc | 2017-04-16 22:05:36 -0500 | [diff] [blame] | 341 | DEVTREE_CONST struct device *dev_find_next_pci_device( |
| 342 | DEVTREE_CONST struct device *previous_dev); |
| 343 | DEVTREE_CONST struct device *dev_find_slot_on_smbus(unsigned int bus, |
Stefan Reinauer | 57879c9 | 2012-07-31 16:47:25 -0700 | [diff] [blame] | 344 | unsigned int addr); |
Aaron Durbin | e4d7abc | 2017-04-16 22:05:36 -0500 | [diff] [blame] | 345 | DEVTREE_CONST struct device *dev_find_slot_pnp(u16 port, u16 device); |
Aaron Durbin | a0dabd1 | 2018-07-25 08:49:19 -0600 | [diff] [blame] | 346 | DEVTREE_CONST struct device *dev_bus_each_child(const struct bus *parent, |
| 347 | DEVTREE_CONST struct device *prev_child); |
Kyösti Mälkki | ef84401 | 2013-06-25 23:17:43 +0300 | [diff] [blame] | 348 | |
Kyösti Mälkki | ad7674e | 2018-05-20 10:31:23 +0300 | [diff] [blame] | 349 | DEVTREE_CONST struct device *pcidev_path_behind(const struct bus *parent, |
| 350 | pci_devfn_t devfn); |
| 351 | DEVTREE_CONST struct device *pcidev_path_on_root(pci_devfn_t devfn); |
Kyösti Mälkki | ab275f0 | 2019-07-04 07:16:59 +0300 | [diff] [blame] | 352 | DEVTREE_CONST struct device *pcidev_path_on_bus(unsigned int bus, pci_devfn_t devfn); |
Kyösti Mälkki | ad7674e | 2018-05-20 10:31:23 +0300 | [diff] [blame] | 353 | DEVTREE_CONST struct device *pcidev_on_root(uint8_t dev, uint8_t fn); |
Kyösti Mälkki | fffc9f3 | 2019-07-03 09:55:01 +0300 | [diff] [blame] | 354 | DEVTREE_CONST struct bus *pci_root_bus(void); |
Furquan Shaikh | 7778e5c | 2020-04-16 08:25:58 -0700 | [diff] [blame] | 355 | /* Find PCI device with given D#:F# sitting behind the given PCI-to-PCI bridge device. */ |
| 356 | DEVTREE_CONST struct device *pcidev_path_behind_pci2pci_bridge( |
| 357 | const struct device *bridge, |
| 358 | pci_devfn_t devfn); |
Kyösti Mälkki | ad7674e | 2018-05-20 10:31:23 +0300 | [diff] [blame] | 359 | |
Aaron Durbin | 55ef0d2 | 2019-09-26 12:05:27 -0600 | [diff] [blame] | 360 | /* To be deprecated, avoid using. |
| 361 | * |
| 362 | * Note that this function can return the incorrect device prior |
| 363 | * to PCI enumeration because the secondary field of the bus object |
| 364 | * is 0. The failing scenario is determined by the order of the |
| 365 | * devices in all_devices singly-linked list as well as the time |
| 366 | * when this function is called (secondary reflecting topology). |
| 367 | */ |
Kyösti Mälkki | f2ac013 | 2019-07-12 15:26:29 +0300 | [diff] [blame] | 368 | DEVTREE_CONST struct device *pcidev_path_on_root_debug(pci_devfn_t devfn, const char *func); |
| 369 | |
Kyösti Mälkki | 4323d26 | 2019-07-12 16:20:14 +0300 | [diff] [blame] | 370 | /* Robust discovery of chip_info. */ |
| 371 | void devtree_bug(const char *func, pci_devfn_t devfn); |
| 372 | void __noreturn devtree_die(void); |
| 373 | |
Nico Huber | 7e6ee91 | 2020-10-05 11:08:44 +0200 | [diff] [blame] | 374 | /* |
| 375 | * Dies if `dev` or `dev->chip_info` are NULL. Returns `dev->chip_info` otherwise. |
| 376 | * |
| 377 | * Only use if missing `chip_info` is fatal and we can't boot. If it's |
| 378 | * not fatal, please handle the NULL case gracefully. |
| 379 | */ |
Kyösti Mälkki | 4323d26 | 2019-07-12 16:20:14 +0300 | [diff] [blame] | 380 | static inline DEVTREE_CONST void *config_of(const struct device *dev) |
| 381 | { |
| 382 | if (dev && dev->chip_info) |
| 383 | return dev->chip_info; |
| 384 | |
| 385 | devtree_die(); |
| 386 | } |
| 387 | |
Felix Held | f914dcf | 2020-12-05 19:12:36 +0100 | [diff] [blame^] | 388 | /* config_of_soc() either returns a non-NULL pointer or dies in the config_of() call. */ |
Kyösti Mälkki | d5f645c | 2019-09-28 00:20:27 +0300 | [diff] [blame] | 389 | static inline DEVTREE_CONST void *config_of_soc(void) |
Kyösti Mälkki | 4323d26 | 2019-07-12 16:20:14 +0300 | [diff] [blame] | 390 | { |
Kyösti Mälkki | d5f645c | 2019-09-28 00:20:27 +0300 | [diff] [blame] | 391 | return config_of(pcidev_on_root(0, 0)); |
Kyösti Mälkki | 4323d26 | 2019-07-12 16:20:14 +0300 | [diff] [blame] | 392 | } |
| 393 | |
Duncan Laurie | 3e4a14e1 | 2020-10-18 15:04:41 -0700 | [diff] [blame] | 394 | void enable_static_device(struct device *dev); |
Nico Huber | f7ed3d4 | 2019-03-14 15:50:06 +0100 | [diff] [blame] | 395 | void enable_static_devices(struct device *bus); |
Aaron Durbin | 6f1e8d2 | 2017-11-09 12:38:03 -0700 | [diff] [blame] | 396 | void scan_smbus(struct device *bus); |
| 397 | void scan_generic_bus(struct device *bus); |
Nico Huber | a89c82e | 2017-09-14 15:40:28 +0200 | [diff] [blame] | 398 | void scan_static_bus(struct device *bus); |
Kyösti Mälkki | ef84401 | 2013-06-25 23:17:43 +0300 | [diff] [blame] | 399 | |
Eric Biederman | 5899fd8 | 2003-04-24 06:25:08 +0000 | [diff] [blame] | 400 | #endif /* DEVICE_H */ |