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