2 * This file is part of the coreboot project.
4 * It was originally based on the Linux kernel (arch/i386/kernel/pci-pc.c).
7 * Copyright (C) 2003 Eric Biederman <ebiederm@xmission.com>
8 * Copyright (C) 2003-2004 Linux Networx
9 * (Written by Eric Biederman <ebiederman@lnxi.com> for Linux Networx)
10 * Copyright (C) 2003 Ronald G. Minnich <rminnich@gmail.com>
11 * Copyright (C) 2004-2005 Li-Ta Lo <ollie@lanl.gov>
12 * Copyright (C) 2005-2006 Tyan
13 * (Written by Yinghai Lu <yhlu@tyan.com> for Tyan)
14 * Copyright (C) 2005-2006 Stefan Reinauer <stepan@openbios.org>
15 * Copyright (C) 2009 Myles Watson <mylesgw@gmail.com>
19 * (c) 1999--2000 Martin Mares <mj@suse.cz>
21 /* lots of mods by ron minnich (rminnich@lanl.gov), with
22 * the final architecture guidance from Tom Merritt (tjm@codegen.com)
23 * In particular, we changed from the one-pass original version to
24 * Tom's recommended multiple-pass version. I wasn't sure about doing
25 * it with multiple passes, until I actually started doing it and saw
26 * the wisdom of Tom's recommendations ...
28 * Lots of cleanups by Eric Biederman to handle bridges, and to
29 * handle resource allocation for non-pci devices.
32 #include <console/console.h>
35 #include <device/device.h>
36 #include <device/pci.h>
37 #include <device/pci_ids.h>
40 #include <smp/spinlock.h>
42 /** Linked list of ALL devices */
43 struct device *all_devices = &dev_root;
44 /** Pointer to the last device */
45 extern struct device **last_dev_p;
49 * @brief Allocate a new device structure.
51 * Allocte a new device structure and attached it to the device tree as a
52 * child of the parent bus.
54 * @param parent parent bus the newly created device attached to.
55 * @param path path to the device to be created.
57 * @return pointer to the newly created device structure.
61 static spinlock_t dev_lock = SPIN_LOCK_UNLOCKED;
62 device_t alloc_dev(struct bus *parent, struct device_path *path)
69 /* Find the last child of our parent. */
70 for (child = parent->children; child && child->sibling; /* */ ) {
71 child = child->sibling;
74 dev = malloc(sizeof(*dev));
76 die("DEV: out of memory.\n");
78 memset(dev, 0, sizeof(*dev));
79 memcpy(&dev->path, path, sizeof(*path));
81 /* Initialize the back pointers in the link fields. */
82 for (link = 0; link < MAX_LINKS; link++) {
83 dev->link[link].dev = dev;
84 dev->link[link].link = link;
87 /* By default devices are enabled. */
90 /* Add the new device to the list of children of the bus. */
95 parent->children = dev;
98 /* Append a new device to the global device list.
99 * The list is used to find devices once everything is set up.
102 last_dev_p = &dev->next;
104 spin_unlock(&dev_lock);
109 * @brief round a number up to an alignment.
110 * @param val the starting value
111 * @param roundup Alignment as a power of two
112 * @returns rounded up number
114 static resource_t round(resource_t val, unsigned long pow)
117 mask = (1ULL << pow) - 1ULL;
123 /** Read the resources on all devices of a given bus.
124 * @param bus bus to read the resources on.
126 static void read_resources(struct bus *bus)
128 struct device *curdev;
130 printk_spew("%s %s bus %x link: %d\n", dev_path(bus->dev), __func__,
131 bus->secondary, bus->link);
133 /* Walk through all devices and find which resources they need. */
134 for (curdev = bus->children; curdev; curdev = curdev->sibling) {
136 if (!curdev->enabled) {
139 if (!curdev->ops || !curdev->ops->read_resources) {
140 printk_err("%s missing read_resources\n",
144 curdev->ops->read_resources(curdev);
146 /* Read in the resources behind the current device's links. */
147 for (i = 0; i < curdev->links; i++)
148 read_resources(&curdev->link[i]);
150 printk_spew("%s read_resources bus %d link: %d done\n",
151 dev_path(bus->dev), bus->secondary, bus->link);
154 struct pick_largest_state {
155 struct resource *last;
156 struct device *result_dev;
157 struct resource *result;
161 static void pick_largest_resource(void *gp, struct device *dev,
162 struct resource *resource)
164 struct pick_largest_state *state = gp;
165 struct resource *last;
169 /* Be certain to pick the successor to last. */
170 if (resource == last) {
171 state->seen_last = 1;
174 if (resource->flags & IORESOURCE_FIXED)
176 if (last && ((last->align < resource->align) ||
177 ((last->align == resource->align) &&
178 (last->size < resource->size)) ||
179 ((last->align == resource->align) &&
180 (last->size == resource->size) && (!state->seen_last)))) {
183 if (!state->result ||
184 (state->result->align < resource->align) ||
185 ((state->result->align == resource->align) &&
186 (state->result->size < resource->size))) {
187 state->result_dev = dev;
188 state->result = resource;
192 static struct device *largest_resource(struct bus *bus,
193 struct resource **result_res,
194 unsigned long type_mask,
197 struct pick_largest_state state;
199 state.last = *result_res;
200 state.result_dev = NULL;
204 search_bus_resources(bus, type_mask, type, pick_largest_resource,
207 *result_res = state.result;
208 return state.result_dev;
211 /* Compute allocate resources is the guts of the resource allocator.
214 * - Allocate resource locations for every device.
215 * - Don't overlap, and follow the rules of bridges.
216 * - Don't overlap with resources in fixed locations.
217 * - Be efficient so we don't have ugly strategies.
220 * - Devices that have fixed addresses are the minority so don't
221 * worry about them too much. Instead only use part of the address
222 * space for devices with programmable addresses. This easily handles
223 * everything except bridges.
225 * - PCI devices are required to have their sizes and their alignments
226 * equal. In this case an optimal solution to the packing problem
227 * exists. Allocate all devices from highest alignment to least
228 * alignment or vice versa. Use this.
230 * - So we can handle more than PCI run two allocation passes on bridges. The
231 * first to see how large the resources are behind the bridge, and what
232 * their alignment requirements are. The second to assign a safe address to
233 * the devices behind the bridge. This allows us to treat a bridge as just
234 * a device with a couple of resources, and not need to special case it in
235 * the allocator. Also this allows handling of other types of bridges.
238 static void compute_resources(struct bus *bus, struct resource *bridge,
239 unsigned long type_mask, unsigned long type)
242 struct resource *resource;
244 base = round(bridge->base, bridge->align);
246 printk_spew( "%s %s_%s: base: %llx size: %llx align: %d gran: %d limit: %llx\n",
247 dev_path(bus->dev), __func__,
248 (type & IORESOURCE_IO) ? "io" : (type & IORESOURCE_PREFETCH) ?
250 base, bridge->size, bridge->align, bridge->gran, bridge->limit);
252 /* For each child which is a bridge, compute_resource_needs. */
253 for (dev = bus->children; dev; dev = dev->sibling) {
255 struct resource *child_bridge;
260 /* Find the resources with matching type flags. */
261 for (i = 0; i < dev->resources; i++) {
263 child_bridge = &dev->resource[i];
265 if (!(child_bridge->flags & IORESOURCE_BRIDGE) ||
266 (child_bridge->flags & type_mask) != type)
269 /* Split prefetchable memory if combined. Many domains
270 * use the same address space for prefetchable memory
271 * and non-prefetchable memory. Bridges below them
272 * need it separated. Add the PREFETCH flag to the
273 * type_mask and type.
275 link = IOINDEX_LINK(child_bridge->index);
276 compute_resources(&dev->link[link], child_bridge,
277 type_mask | IORESOURCE_PREFETCH,
278 type | (child_bridge->flags &
279 IORESOURCE_PREFETCH));
283 /* Remember we haven't found anything yet. */
286 /* Walk through all the resources on the current bus and compute the
287 * amount of address space taken by them. Take granularity and
288 * alignment into account.
290 while ((dev = largest_resource(bus, &resource, type_mask, type))) {
292 /* Size 0 resources can be skipped. */
293 if (!resource->size) {
297 /* Propagate the resource alignment to the bridge resource. */
298 if (resource->align > bridge->align) {
299 bridge->align = resource->align;
302 /* Propagate the resource limit to the bridge register. */
303 if (bridge->limit > resource->limit) {
304 bridge->limit = resource->limit;
307 /* Warn if it looks like APICs aren't declared. */
308 if ((resource->limit == 0xffffffff) &&
309 (resource->flags & IORESOURCE_ASSIGNED)) {
310 printk_err("Resource limit looks wrong! (no APIC?)\n");
311 printk_err("%s %02lx limit %08Lx\n", dev_path(dev),
312 resource->index, resource->limit);
315 if (resource->flags & IORESOURCE_IO) {
316 /* Don't allow potential aliases over the legacy PCI
317 * expansion card addresses. The legacy PCI decodes
318 * only 10 bits, uses 0x100 - 0x3ff. Therefore, only
319 * 0x00 - 0xff can be used out of each 0x400 block of
322 if ((base & 0x300) != 0) {
323 base = (base & ~0x3ff) + 0x400;
325 /* Don't allow allocations in the VGA I/O range.
326 * PCI has special cases for that.
328 else if ((base >= 0x3b0) && (base <= 0x3df)) {
332 /* Base must be aligned. */
333 base = round(base, resource->align);
334 resource->base = base;
335 base += resource->size;
337 printk_spew("%s %02lx * [0x%llx - 0x%llx] %s\n",
338 dev_path(dev), resource->index,
340 resource->base + resource->size - 1,
341 (resource->flags & IORESOURCE_IO) ? "io" :
342 (resource->flags & IORESOURCE_PREFETCH) ?
345 /* A pci bridge resource does not need to be a power
346 * of two size, but it does have a minimum granularity.
347 * Round the size up to that minimum granularity so we
348 * know not to place something else at an address postitively
349 * decoded by the bridge.
351 bridge->size = round(base, bridge->gran) -
352 round(bridge->base, bridge->align);
354 printk_spew("%s %s_%s: base: %llx size: %llx align: %d gran: %d limit: %llx done\n",
355 dev_path(bus->dev), __func__,
356 (bridge->flags & IORESOURCE_IO) ? "io" :
357 (bridge->flags & IORESOURCE_PREFETCH) ? "prefmem" : "mem",
358 base, bridge->size, bridge->align, bridge->gran, bridge->limit);
362 * This function is the second part of the resource allocator.
365 * - Allocate resource locations for every device.
366 * - Don't overlap, and follow the rules of bridges.
367 * - Don't overlap with resources in fixed locations.
368 * - Be efficient so we don't have ugly strategies.
371 * - Devices that have fixed addresses are the minority so don't
372 * worry about them too much. Instead only use part of the address
373 * space for devices with programmable addresses. This easily handles
374 * everything except bridges.
376 * - PCI devices are required to have their sizes and their alignments
377 * equal. In this case an optimal solution to the packing problem
378 * exists. Allocate all devices from highest alignment to least
379 * alignment or vice versa. Use this.
381 * - So we can handle more than PCI run two allocation passes on bridges. The
382 * first to see how large the resources are behind the bridge, and what
383 * their alignment requirements are. The second to assign a safe address to
384 * the devices behind the bridge. This allows us to treat a bridge as just
385 * a device with a couple of resources, and not need to special case it in
386 * the allocator. Also this allows handling of other types of bridges.
388 * - This function assigns the resources a value.
390 * @param bus The bus we are traversing.
391 * @param bridge The bridge resource which must contain the bus' resources.
392 * @param type_mask This value gets anded with the resource type.
393 * @param type This value must match the result of the and.
395 static void allocate_resources(struct bus *bus, struct resource *bridge,
396 unsigned long type_mask, unsigned long type)
399 struct resource *resource;
403 printk_spew("%s %s_%s: base:%llx size:%llx align:%d gran:%d limit:%llx\n",
404 dev_path(bus->dev), __func__,
405 (type & IORESOURCE_IO) ? "io" : (type & IORESOURCE_PREFETCH) ?
407 base, bridge->size, bridge->align, bridge->gran, bridge->limit);
409 /* Remember we haven't found anything yet. */
412 /* Walk through all the resources on the current bus and allocate them
415 while ((dev = largest_resource(bus, &resource, type_mask, type))) {
417 /* Propagate the bridge limit to the resource register. */
418 if (resource->limit > bridge->limit) {
419 resource->limit = bridge->limit;
422 /* Size 0 resources can be skipped. */
423 if (!resource->size) {
424 /* Set the base to limit so it doesn't confuse tolm. */
425 resource->base = resource->limit;
426 resource->flags |= IORESOURCE_ASSIGNED;
430 if (resource->flags & IORESOURCE_IO) {
431 /* Don't allow potential aliases over the legacy PCI
432 * expansion card addresses. The legacy PCI decodes
433 * only 10 bits, uses 0x100 - 0x3ff. Therefore, only
434 * 0x00 - 0xff can be used out of each 0x400 block of
437 if ((base & 0x300) != 0) {
438 base = (base & ~0x3ff) + 0x400;
440 /* Don't allow allocations in the VGA I/O range.
441 * PCI has special cases for that.
443 else if ((base >= 0x3b0) && (base <= 0x3df)) {
448 if ((round(base, resource->align) + resource->size - 1) <=
450 /* Base must be aligned. */
451 base = round(base, resource->align);
452 resource->base = base;
453 resource->flags |= IORESOURCE_ASSIGNED;
454 resource->flags &= ~IORESOURCE_STORED;
455 base += resource->size;
457 printk_err("!! Resource didn't fit !!\n");
458 printk_err(" aligned base %llx size %llx limit %llx\n",
459 round(base, resource->align), resource->size,
461 printk_err(" %llx needs to be <= %llx (limit)\n",
462 (round(base, resource->align) +
463 resource->size) - 1, resource->limit);
464 printk_err(" %s%s %02lx * [0x%llx - 0x%llx] %s\n",
466 flags & IORESOURCE_ASSIGNED) ? "Assigned: " :
467 "", dev_path(dev), resource->index,
469 resource->base + resource->size - 1,
471 flags & IORESOURCE_IO) ? "io" : (resource->
474 ? "prefmem" : "mem");
477 printk_spew("%s%s %02lx * [0x%llx - 0x%llx] %s\n",
478 (resource->flags & IORESOURCE_ASSIGNED) ? "Assigned: "
480 dev_path(dev), resource->index, resource->base,
481 resource->size ? resource->base + resource->size - 1 :
483 (resource->flags & IORESOURCE_IO) ? "io" :
484 (resource->flags & IORESOURCE_PREFETCH) ? "prefmem" :
487 /* A PCI bridge resource does not need to be a power of two size, but
488 * it does have a minimum granularity. Round the size up to that
489 * minimum granularity so we know not to place something else at an
490 * address positively decoded by the bridge.
493 bridge->flags |= IORESOURCE_ASSIGNED;
495 printk_spew("%s %s_%s: next_base: %llx size: %llx align: %d gran: %d done\n",
496 dev_path(bus->dev), __func__,
497 (type & IORESOURCE_IO) ? "io" : (type & IORESOURCE_PREFETCH) ?
499 base, bridge->size, bridge->align, bridge->gran);
501 /* For each child which is a bridge, allocate_resources. */
502 for (dev = bus->children; dev; dev = dev->sibling) {
504 struct resource *child_bridge;
509 /* Find the resources with matching type flags. */
510 for (i = 0; i < dev->resources; i++) {
512 child_bridge = &dev->resource[i];
514 if (!(child_bridge->flags & IORESOURCE_BRIDGE) ||
515 (child_bridge->flags & type_mask) != type)
518 /* Split prefetchable memory if combined. Many domains
519 * use the same address space for prefetchable memory
520 * and non-prefetchable memory. Bridges below them
521 * need it separated. Add the PREFETCH flag to the
522 * type_mask and type.
524 link = IOINDEX_LINK(child_bridge->index);
525 allocate_resources(&dev->link[link], child_bridge,
526 type_mask | IORESOURCE_PREFETCH,
527 type | (child_bridge->flags &
528 IORESOURCE_PREFETCH));
533 #if CONFIG_PCI_64BIT_PREF_MEM == 1
534 #define MEM_MASK (IORESOURCE_PREFETCH | IORESOURCE_MEM)
536 #define MEM_MASK (IORESOURCE_MEM)
538 #define IO_MASK (IORESOURCE_IO)
539 #define PREF_TYPE (IORESOURCE_PREFETCH | IORESOURCE_MEM)
540 #define MEM_TYPE (IORESOURCE_MEM)
541 #define IO_TYPE (IORESOURCE_IO)
544 struct resource pref, io, mem;
547 static void constrain_resources(struct device *dev, struct constraints* limits)
549 struct device *child;
550 struct resource *res;
551 struct resource *lim;
554 printk_spew("%s: %s\n", __func__, dev_path(dev));
556 /* Constrain limits based on the fixed resources of this device. */
557 for (i = 0; i < dev->resources; i++) {
558 res = &dev->resource[i];
559 if (!(res->flags & IORESOURCE_FIXED))
562 /* It makes no sense to have 0-sized, fixed resources.*/
563 printk_err("skipping %s@%lx fixed resource, size=0!\n",
564 dev_path(dev), res->index);
568 /* PREFETCH, MEM, or I/O - skip any others. */
569 if ((res->flags & MEM_MASK) == PREF_TYPE)
571 else if ((res->flags & MEM_MASK) == MEM_TYPE)
573 else if ((res->flags & IO_MASK) == IO_TYPE)
578 /* Is it already outside the limits? */
579 if (res->size && (((res->base + res->size -1) < lim->base) ||
580 (res->base > lim->limit)))
583 /* Choose to be above or below fixed resources. This
584 * check is signed so that "negative" amounts of space
585 * are handled correctly.
587 if ((signed long long)(lim->limit - (res->base + res->size -1)) >
588 (signed long long)(res->base - lim->base))
589 lim->base = res->base + res->size;
591 lim->limit = res->base -1;
594 /* Descend into every enabled child and look for fixed resources. */
595 for (i = 0; i < dev->links; i++)
596 for (child = dev->link[i].children; child;
597 child = child->sibling)
599 constrain_resources(child, limits);
602 static void avoid_fixed_resources(struct device *dev)
604 struct constraints limits;
605 struct resource *res;
608 printk_spew("%s: %s\n", __func__, dev_path(dev));
609 /* Initialize constraints to maximum size. */
611 limits.pref.base = 0;
612 limits.pref.limit = 0xffffffffffffffffULL;
614 limits.io.limit = 0xffffffffffffffffULL;
616 limits.mem.limit = 0xffffffffffffffffULL;
618 /* Constrain the limits to dev's initial resources. */
619 for (i = 0; i < dev->resources; i++) {
620 res = &dev->resource[i];
621 if ((res->flags & IORESOURCE_FIXED))
623 printk_spew("%s:@%s %02lx limit %08Lx\n", __func__,
624 dev_path(dev), res->index, res->limit);
625 if ((res->flags & MEM_MASK) == PREF_TYPE &&
626 (res->limit < limits.pref.limit))
627 limits.pref.limit = res->limit;
628 if ((res->flags & MEM_MASK) == MEM_TYPE &&
629 (res->limit < limits.mem.limit))
630 limits.mem.limit = res->limit;
631 if ((res->flags & IO_MASK) == IO_TYPE &&
632 (res->limit < limits.io.limit))
633 limits.io.limit = res->limit;
636 /* Look through the tree for fixed resources and update the limits. */
637 constrain_resources(dev, &limits);
639 /* Update dev's resources with new limits. */
640 for (i = 0; i < dev->resources; i++) {
641 struct resource *lim;
642 res = &dev->resource[i];
644 if ((res->flags & IORESOURCE_FIXED))
647 /* PREFETCH, MEM, or I/O - skip any others. */
648 if ((res->flags & MEM_MASK) == PREF_TYPE)
650 else if ((res->flags & MEM_MASK) == MEM_TYPE)
652 else if ((res->flags & IO_MASK) == IO_TYPE)
657 printk_spew("%s2: %s@%02lx limit %08Lx\n", __func__,
658 dev_path(dev), res->index, res->limit);
659 printk_spew("\tlim->base %08Lx lim->limit %08Lx\n",
660 lim->base, lim->limit);
662 /* Is the resource outside the limits? */
663 if (lim->base > res->base)
664 res->base = lim->base;
665 if (res->limit > lim->limit)
666 res->limit = lim->limit;
670 #if CONFIG_VGA_BRIDGE_SETUP == 1
671 device_t vga_pri = 0;
672 static void set_vga_bridge_bits(void)
674 #warning "FIXME modify set_vga_bridge so it is less pci centric!"
675 #warning "This function knows too much about PCI stuff, it should be just a iterator/visitor."
677 /* FIXME: Handle the VGA palette snooping. */
678 struct device *dev, *vga, *vga_onboard, *vga_first, *vga_last;
685 for (dev = all_devices; dev; dev = dev->next) {
688 if (((dev->class >> 16) == PCI_BASE_CLASS_DISPLAY) &&
689 ((dev->class >> 8) != PCI_CLASS_DISPLAY_OTHER)) {
691 if (dev->on_mainboard) {
697 if (dev->on_mainboard) {
704 /* It isn't safe to enable other VGA cards. */
705 dev->command &= ~(PCI_COMMAND_MEMORY | PCI_COMMAND_IO);
714 #if CONFIG_CONSOLE_VGA_ONBOARD_AT_FIRST == 1
715 if (vga_onboard) // Will use on board VGA as pri.
717 if (!vga) // Will use last add on adapter as pri.
724 /* VGA is first add on card or the only onboard VGA. */
725 printk_debug("Setting up VGA for %s\n", dev_path(vga));
726 /* All legacy VGA cards have MEM & I/O space registers. */
727 vga->command |= (PCI_COMMAND_MEMORY | PCI_COMMAND_IO);
731 /* Now walk up the bridges setting the VGA enable. */
733 printk_debug("Setting PCI_BRIDGE_CTL_VGA for bridge %s\n",
735 bus->bridge_ctrl |= PCI_BRIDGE_CTL_VGA;
736 bus = (bus == bus->dev->bus) ? 0 : bus->dev->bus;
743 * @brief Assign the computed resources to the devices on the bus.
745 * @param bus Pointer to the structure for this bus
747 * Use the device specific set_resources method to store the computed
748 * resources to hardware. For bridge devices, the set_resources() method
749 * has to recurse into every down stream buses.
752 * assign_resources() -> device_operation::set_resources()
753 * device_operation::set_resources() -> assign_resources()
755 void assign_resources(struct bus *bus)
757 struct device *curdev;
759 printk_spew("%s assign_resources, bus %d link: %d\n",
760 dev_path(bus->dev), bus->secondary, bus->link);
762 for (curdev = bus->children; curdev; curdev = curdev->sibling) {
763 if (!curdev->enabled || !curdev->resources) {
766 if (!curdev->ops || !curdev->ops->set_resources) {
767 printk_err("%s missing set_resources\n",
771 curdev->ops->set_resources(curdev);
773 printk_spew("%s assign_resources, bus %d link: %d\n",
774 dev_path(bus->dev), bus->secondary, bus->link);
778 * @brief Enable the resources for a specific device
780 * @param dev the device whose resources are to be enabled
782 * Enable resources of the device by calling the device specific
783 * enable_resources() method.
785 * The parent's resources should be enabled first to avoid having enabling
786 * order problem. This is done by calling the parent's enable_resources()
787 * method and let that method to call it's children's enable_resoruces()
788 * method via the (global) enable_childrens_resources().
790 * Indirect mutual recursion:
791 * enable_resources() -> device_operations::enable_resource()
792 * device_operations::enable_resource() -> enable_children_resources()
793 * enable_children_resources() -> enable_resources()
795 void enable_resources(struct device *dev)
800 if (!dev->ops || !dev->ops->enable_resources) {
801 printk_err("%s missing enable_resources\n", dev_path(dev));
804 dev->ops->enable_resources(dev);
808 * @brief Reset all of the devices a bus
810 * Reset all of the devices on a bus and clear the bus's reset_needed flag.
812 * @param bus pointer to the bus structure
814 * @return 1 if the bus was successfully reset, 0 otherwise.
817 int reset_bus(struct bus *bus)
819 if (bus && bus->dev && bus->dev->ops && bus->dev->ops->reset_bus) {
820 bus->dev->ops->reset_bus(bus);
821 bus->reset_needed = 0;
828 * @brief Scan for devices on a bus.
830 * If there are bridges on the bus, recursively scan the buses behind the
831 * bridges. If the setting up and tuning of the bus causes a reset to be
832 * required, reset the bus and scan it again.
834 * @param busdev Pointer to the bus device.
835 * @param max Current bus number.
836 * @return The maximum bus number found, after scanning all subordinate buses.
838 unsigned int scan_bus(struct device *busdev, unsigned int max)
840 unsigned int new_max;
842 if (!busdev || !busdev->enabled || !busdev->ops ||
843 !busdev->ops->scan_bus) {
848 while (do_scan_bus) {
850 new_max = busdev->ops->scan_bus(busdev, max);
852 for (link = 0; link < busdev->links; link++) {
853 if (busdev->link[link].reset_needed) {
854 if (reset_bus(&busdev->link[link])) {
857 busdev->bus->reset_needed = 1;
866 * @brief Determine the existence of devices and extend the device tree.
868 * Most of the devices in the system are listed in the mainboard Config.lb
869 * file. The device structures for these devices are generated at compile
870 * time by the config tool and are organized into the device tree. This
871 * function determines if the devices created at compile time actually exist
872 * in the physical system.
874 * For devices in the physical system but not listed in the Config.lb file,
875 * the device structures have to be created at run time and attached to the
878 * This function starts from the root device 'dev_root', scan the buses in
879 * the system recursively, modify the device tree according to the result of
882 * This function has no idea how to scan and probe buses and devices at all.
883 * It depends on the bus/device specific scan_bus() method to do it. The
884 * scan_bus() method also has to create the device structure and attach
885 * it to the device tree.
887 void dev_enumerate(void)
890 printk_info("Enumerating buses...\n");
893 show_all_devs(BIOS_DEBUG, "Before Device Enumeration.");
894 printk_debug("Compare with tree...\n");
896 show_devs_tree(root, BIOS_DEBUG, 0, 0);
898 if (root->chip_ops && root->chip_ops->enable_dev) {
899 root->chip_ops->enable_dev(root);
901 if (!root->ops || !root->ops->scan_bus) {
902 printk_err("dev_root missing scan_bus operation");
906 printk_info("done\n");
910 * @brief Configure devices on the devices tree.
912 * Starting at the root of the device tree, travel it recursively in two
913 * passes. In the first pass, we compute and allocate resources (ranges)
914 * requried by each device. In the second pass, the resources ranges are
915 * relocated to their final position and stored to the hardware.
917 * I/O resources grow upward. MEM resources grow downward.
919 * Since the assignment is hierarchical we set the values into the dev_root
922 void dev_configure(void)
924 struct resource *res;
926 struct device *child;
929 #if CONFIG_VGA_BRIDGE_SETUP == 1
930 set_vga_bridge_bits();
933 printk_info("Allocating resources...\n");
937 /* Each domain should create resources which contain the entire address
938 * space for IO, MEM, and PREFMEM resources in the domain. The
939 * allocation of device resources will be done from this address space.
942 /* Read the resources for the entire tree. */
944 printk_info("Reading resources...\n");
945 read_resources(&root->link[0]);
946 printk_info("Done reading resources.\n");
948 print_resource_tree(root, BIOS_DEBUG, "After reading.");
950 /* Compute resources for all domains. */
951 for (child = root->link[0].children; child; child = child->sibling) {
952 if (!(child->path.type == DEVICE_PATH_PCI_DOMAIN))
954 for (i = 0; i < child->resources; i++) {
955 res = &child->resource[i];
956 if (res->flags & IORESOURCE_FIXED)
958 if (res->flags & IORESOURCE_PREFETCH) {
959 compute_resources(&child->link[0],
960 res, MEM_MASK, PREF_TYPE);
963 if (res->flags & IORESOURCE_MEM) {
964 compute_resources(&child->link[0],
965 res, MEM_MASK, MEM_TYPE);
968 if (res->flags & IORESOURCE_IO) {
969 compute_resources(&child->link[0],
970 res, IO_MASK, IO_TYPE);
976 /* For all domains. */
977 for (child = root->link[0].children; child; child=child->sibling)
978 if (child->path.type == DEVICE_PATH_PCI_DOMAIN)
979 avoid_fixed_resources(child);
981 /* Now we need to adjust the resources. MEM resources need to start at
982 * the highest address managable.
984 for (child = root->link[0].children; child; child = child->sibling) {
985 if (child->path.type != DEVICE_PATH_PCI_DOMAIN)
987 for (i = 0; i < child->resources; i++) {
988 res = &child->resource[i];
989 if (!(res->flags & IORESOURCE_MEM) ||
990 res->flags & IORESOURCE_FIXED)
992 res->base = resource_max(res);
996 /* Store the computed resource allocations into device registers ... */
997 printk_info("Setting resources...\n");
998 for (child = root->link[0].children; child; child = child->sibling) {
999 if (!(child->path.type == DEVICE_PATH_PCI_DOMAIN))
1001 for (i = 0; i < child->resources; i++) {
1002 res = &child->resource[i];
1003 if (res->flags & IORESOURCE_FIXED)
1005 if (res->flags & IORESOURCE_PREFETCH) {
1006 allocate_resources(&child->link[0],
1007 res, MEM_MASK, PREF_TYPE);
1010 if (res->flags & IORESOURCE_MEM) {
1011 allocate_resources(&child->link[0],
1012 res, MEM_MASK, MEM_TYPE);
1015 if (res->flags & IORESOURCE_IO) {
1016 allocate_resources(&child->link[0],
1017 res, IO_MASK, IO_TYPE);
1022 assign_resources(&root->link[0]);
1023 printk_info("Done setting resources.\n");
1024 print_resource_tree(root, BIOS_DEBUG, "After assigning values.");
1026 printk_info("Done allocating resources.\n");
1030 * @brief Enable devices on the device tree.
1032 * Starting at the root, walk the tree and enable all devices/bridges by
1033 * calling the device's enable_resources() method.
1035 void dev_enable(void)
1037 printk_info("Enabling resources...\n");
1039 /* now enable everything. */
1040 enable_resources(&dev_root);
1042 printk_info("done.\n");
1046 * @brief Initialize all devices in the global device list.
1048 * Starting at the first device on the global device link list,
1049 * walk the list and call the device's init() method to do deivce
1052 void dev_initialize(void)
1056 printk_info("Initializing devices...\n");
1057 for (dev = all_devices; dev; dev = dev->next) {
1058 if (dev->enabled && !dev->initialized &&
1059 dev->ops && dev->ops->init) {
1060 if (dev->path.type == DEVICE_PATH_I2C) {
1061 printk_debug("smbus: %s[%d]->",
1062 dev_path(dev->bus->dev),
1065 printk_debug("%s init\n", dev_path(dev));
1066 dev->initialized = 1;
1067 dev->ops->init(dev);
1070 printk_info("Devices initialized\n");
1071 show_all_devs(BIOS_DEBUG, "After init.");