Emulation/switch-coreboot
1
0
Fork 0
mirror of https://github.com/fail0verflow/switch-coreboot.git synced 2025-05-04 01:39:18 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

This patch clarifies comments and changes a little whitespace in device/device.c

Browse source 
Signed-off-by: Myles Watson <mylesgw@gmail.com>
Acked-by: Myles Watson <mylesgw@gmail.com>


git-svn-id: svn://coreboot.org/repository/coreboot-v3@966 f3766cd6-281f-0410-b1cd-43a5c92072e9
This commit is contained in:
Myles Watson 2008-10-31 17:57:42 +00:00
parent cfa4c50225
commit 7741b2273c
1 changed files with 46 additions and 44 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

90
device/device.c
View file

@ -18,10 +18,10 @@
/* /*
* (c) 1999--2000 Martin Mares <mj@suse.cz> * (c) 1999--2000 Martin Mares <mj@suse.cz>
*/ */
/* lots of mods by ron minnich (rminnich@lanl.gov), with /* lots of mods by ron minnich (rminnich@lanl.gov), with
* the final architecture guidance from Tom Merritt (tjm@codegen.com) * the final architecture guidance from Tom Merritt (tjm@codegen.com)
* In particular, we changed from the one-pass original version to * In particular, we changed from the one-pass original version to
* Tom's recommended multiple-pass version. I wasn't sure about doing * Tom's recommended multiple-pass version. I wasn't sure about doing
* it with multiple passes, until I actually started doing it and saw * it with multiple passes, until I actually started doing it and saw
* the wisdom of Tom's recommendations ... * the wisdom of Tom's recommendations ...
* *
@ -67,14 +67,14 @@ struct device **last_dev_p;
static struct device devs[MAX_DEVICES]; static struct device devs[MAX_DEVICES];
/** /**
* the number of devices that have been allocated * the number of devices that have been allocated
*/ */
static int devcnt; static int devcnt;
/** /**
* The device creator. * The device creator.
* *
* reserves a piece of memory for a device in the tree * reserves a piece of memory for a device in the tree
* *
* @return Pointer to the newly created device structure. * @return Pointer to the newly created device structure.
@ -95,7 +95,7 @@ static struct device *new_device(void)
/** /**
* The default constructor, which simply sets the ops pointer. * The default constructor, which simply sets the ops pointer.
* *
* Initialize device->ops of a newly allocated device structure. * Initialize device->ops of a newly allocated device structure.
* *
* @param dev Pointer to the newly created device structure. * @param dev Pointer to the newly created device structure.
@ -136,12 +136,12 @@ struct device_operations *find_device_operations(struct device_id *id)
} }
/** /**
* Initialization tasks for the device tree code. * Initialization tasks for the device tree code.
* *
* Sets up last_dev_p, which used to be done by * Sets up last_dev_p, which used to be done by
* Fucking Magic (FM) in the config tool. Also, for each of the * Fucking Magic (FM) in the config tool. Also, for each of the
* devices, tries to find the constructor, and from there, the ops, * devices, tries to find the constructor, and from there, the ops,
* for the device. * for the device.
*/ */
void dev_init(void) void dev_init(void)
{ {
@ -152,10 +152,10 @@ void dev_init(void)
c = dev->ops; c = dev->ops;
if (c) if (c)
dev->id = c->id; dev->id = c->id;
/* note the difference from the constructor function below. /* note the difference from the constructor function below.
* we are not allocating the device here, just setting the id. * we are not allocating the device here, just setting the id.
* We set the id here because we don't want to set it in the dts * We set the id here because we don't want to set it in the dts
* as we used to. The user sees none of this work. * as we used to. The user sees none of this work.
*/ */
if (c) if (c)
dev->ops = c; dev->ops = c;
@ -165,11 +165,11 @@ void dev_init(void)
} }
/** /**
* Given a device, find a constructor function and, if found, run it. * Given a device, find a constructor function and, if found, run it.
* *
* Given a device, use the device id in the device to find a device_operations. * Given a device, use the device id in the device to find a device_operations.
* Call the device_operations->constructor, with itself as * Call the device_operations->constructor, with itself as
* a parameter; return the result. If there is no constructor, * a parameter; return the result. If there is no constructor,
* then no constructor is run. * then no constructor is run.
* *
* @param dev Pointer to the newly created device structure. * @param dev Pointer to the newly created device structure.
@ -185,7 +185,7 @@ void constructor(struct device *dev)
c = find_device_operations(&dev->id); c = find_device_operations(&dev->id);
printk(BIOS_SPEW, "%s: constructor is %p\n", __func__, c); printk(BIOS_SPEW, "%s: constructor is %p\n", __func__, c);
if(c) { if(c) {
if(c->constructor) if(c->constructor)
c->constructor(dev, c); c->constructor(dev, c);
@ -193,7 +193,7 @@ void constructor(struct device *dev)
default_device_constructor(dev, c); default_device_constructor(dev, c);
} }
else else
printk(BIOS_INFO, "No ops found and no constructor called for %s.\n", printk(BIOS_INFO, "No ops found and no constructor called for %s.\n",
dev_id_string(&dev->id)); dev_id_string(&dev->id));
} }
@ -290,7 +290,7 @@ void read_resources(struct bus *bus)
int i; int i;
printk(BIOS_SPEW, printk(BIOS_SPEW,
"%s: %s(%s) dtsname %s have_resources %d enabled %d\n", "%s: %s(%s) dtsname %s have_resources %d enabled %d\n",
__func__, bus->dev? bus->dev->dtsname : "NOBUSDEV", __func__, bus->dev? bus->dev->dtsname : "NOBUSDEV",
bus->dev ? dev_path(bus->dev) : "NOBUSDEV", bus->dev ? dev_path(bus->dev) : "NOBUSDEV",
curdev->dtsname, curdev->dtsname,
curdev->have_resources, curdev->enabled); curdev->have_resources, curdev->enabled);
@ -393,7 +393,7 @@ static struct device *largest_resource(struct bus *bus, struct resource
/** /**
* This function is the guts of the resource allocator. * This function is the guts of the resource allocator.
* *
* The problem. * The problem.
* - Allocate resource locations for every device. * - Allocate resource locations for every device.
* - Don't overlap, and follow the rules of bridges. * - Don't overlap, and follow the rules of bridges.
@ -456,7 +456,7 @@ void compute_allocate_resource(struct bus *bus, struct resource *bridge,
/* Remember we haven't found anything yet. */ /* Remember we haven't found anything yet. */
resource = 0; resource = 0;
/* Walk through all the devices on the current bus and /* Walk through all the devices on the current bus and
* compute the addresses. * compute the addresses.
*/ */
while ((dev = largest_resource(bus, &resource, type_mask, type))) { while ((dev = largest_resource(bus, &resource, type_mask, type))) {
@ -476,7 +476,7 @@ void compute_allocate_resource(struct bus *bus, struct resource *bridge,
align = min_align; align = min_align;
} }
/* Propogate the resource alignment to the bridge register */ /* Propagate the resource alignment to the bridge register */
if (align > bridge->align) { if (align > bridge->align) {
bridge->align = align; bridge->align = align;
} }
@ -552,7 +552,7 @@ int vga_inited = 0;
static void allocate_vga_resource(void) static void allocate_vga_resource(void)
{ {
#warning Modify allocate_vga_resource so it is less PCI centric. #warning Modify allocate_vga_resource so it is less PCI centric.
// FIXME: This function knows too much about PCI stuff, // FIXME: This function knows too much about PCI stuff,
// it should just be an iterator/visitor. // it should just be an iterator/visitor.
/* FIXME: Handle the VGA palette snooping. */ /* FIXME: Handle the VGA palette snooping. */
@ -653,13 +653,13 @@ void phase4_assign_resources(struct bus *bus)
} }
if (!curdev->ops->phase4_set_resources) { if (!curdev->ops->phase4_set_resources) {
printk(BIOS_WARNING, printk(BIOS_WARNING,
"%s(%s) ops has no missing phase4_set_resources\n", "%s(%s) ops has no phase4_set_resources\n",
curdev->dtsname, dev_path(curdev)); curdev->dtsname, dev_path(curdev));
continue; continue;
} }
curdev->ops->phase4_set_resources(curdev); curdev->ops->phase4_set_resources(curdev);
} }
printk(BIOS_SPEW, "%s(%s) assign_resources, bus %d link: %d\n", printk(BIOS_SPEW, "%s(%s) assign_resources done, bus %d link: %d\n",
bus->dev->dtsname, dev_path(bus->dev), bus->secondary, bus->dev->dtsname, dev_path(bus->dev), bus->secondary,
bus->link); bus->link);
} }
@ -700,7 +700,7 @@ void dev_phase5(struct device *dev)
dev->ops->phase5_enable_resources(dev); dev->ops->phase5_enable_resources(dev);
} }
/** /**
* Reset all of the devices on a bus and clear the bus's reset_needed flag. * Reset all of the devices on a bus and clear the bus's reset_needed flag.
* *
* @param bus Pointer to the bus structure. * @param bus Pointer to the bus structure.
@ -744,7 +744,7 @@ void dev_phase1(void)
* *
* Starting at the first device on the global device link list, * Starting at the first device on the global device link list,
* walk the list and call the device's phase2() method to do * walk the list and call the device's phase2() method to do
* early setup. * early setup.
*/ */
void dev_phase2(void) void dev_phase2(void)
{ {
@ -755,7 +755,7 @@ void dev_phase2(void)
for (dev = all_devices; dev; dev = dev->next) { for (dev = all_devices; dev; dev = dev->next) {
printk(BIOS_SPEW, printk(BIOS_SPEW,
"%s: dev %s: ops %p ops->phase2_fixup %p\n", "%s: dev %s: ops %p ops->phase2_fixup %p\n",
__FUNCTION__, dev->dtsname, dev->ops, __FUNCTION__, dev->dtsname, dev->ops,
dev->ops? dev->ops->phase2_fixup : NULL); dev->ops? dev->ops->phase2_fixup : NULL);
if (dev->ops && dev->ops->phase2_fixup) { if (dev->ops && dev->ops->phase2_fixup) {
printk(BIOS_SPEW, printk(BIOS_SPEW,
@ -770,7 +770,7 @@ void dev_phase2(void)
post_code(POST_STAGE2_PHASE2_EXIT); post_code(POST_STAGE2_PHASE2_EXIT);
} }
/** /**
* Scan for devices on a bus. * Scan for devices on a bus.
* *
* If there are bridges on the bus, recursively scan the buses behind the * If there are bridges on the bus, recursively scan the buses behind the
@ -802,7 +802,7 @@ unsigned int dev_phase3_scan(struct device *busdevice, unsigned int max)
int link; int link;
printk(BIOS_INFO, "%s: scanning %s(%s)\n", __FUNCTION__, printk(BIOS_INFO, "%s: scanning %s(%s)\n", __FUNCTION__,
busdevice->dtsname, dev_path(busdevice)); busdevice->dtsname, dev_path(busdevice));
#warning do we call phase3_enable here. #warning do we call phase3_enable here.
new_max = busdevice->ops->phase3_scan(busdevice, max); new_max = busdevice->ops->phase3_scan(busdevice, max);
do_phase3 = 0; do_phase3 = 0;
/* do we *ever* use this path */ /* do we *ever* use this path */
@ -842,7 +842,7 @@ unsigned int dev_phase3_scan(struct device *busdevice, unsigned int max)
* This function has no idea how to scan and probe buses and devices at all. * This function has no idea how to scan and probe buses and devices at all.
* It depends on the bus/device specific scan_bus() method to do it. The * It depends on the bus/device specific scan_bus() method to do it. The
* scan_bus() method also has to create the device structure and attach * scan_bus() method also has to create the device structure and attach
* it to the device tree. * it to the device tree.
*/ */
void dev_root_phase3(void) void dev_root_phase3(void)
{ {
@ -872,7 +872,7 @@ void dev_root_phase3(void)
/** /**
* Configure devices on the device tree. * Configure devices on the device tree.
* *
* Starting at the root of the device tree, travel it recursively in two * Starting at the root of the device tree, travel it recursively in two
* passes. In the first pass, we compute and allocate resources (ranges) * passes. In the first pass, we compute and allocate resources (ranges)
* required by each device. In the second pass, the resources ranges are * required by each device. In the second pass, the resources ranges are
@ -882,7 +882,7 @@ void dev_root_phase3(void)
* at DEVICE_MEM_START and grow downward. * at DEVICE_MEM_START and grow downward.
* *
* Since the assignment is hierarchical we set the values into the dev_root * Since the assignment is hierarchical we set the values into the dev_root
* struct. * struct.
*/ */
void dev_phase4(void) void dev_phase4(void)
{ {
@ -913,13 +913,16 @@ void dev_phase4(void)
root->ops->phase4_read_resources(root); root->ops->phase4_read_resources(root);
printk(BIOS_INFO, "Phase 4: Done reading resources.\n"); printk(BIOS_INFO, "Phase 4: Done reading resources.\n");
/* we have read the resources. We now compute the global allocation of resources. /* We have read the resources. We now compute the global allocation of
* We have to create a root resource for the base of the tree. The root resource should contain the entire * resources. We have to create a root resource for the base of the
* address space for IO and MEM resources. The allocation of device resources will be done from this * tree. The root resource should contain the entire address space for
* resource address space. * IO and MEM resources. The allocation of device resources will be done
* from this resource address space.
*/ */
/* Allocate a resource from the root device resource pool and initialize the system wide I/O space constraints. */ /* Allocate a resource from the root device resource pool and initialize
* the system-wide I/O space constraints.
*/
io = new_resource(root, 0); io = new_resource(root, 0);
io->base = 0x400; io->base = 0x400;
io->size = 0; io->size = 0;
@ -928,8 +931,8 @@ void dev_phase4(void)
io->limit = 0xffffUL; io->limit = 0xffffUL;
io->flags = IORESOURCE_IO; io->flags = IORESOURCE_IO;
/* Allocate a resource from the root device resource pool and initialize the system wide /* Allocate a resource from the root device resource pool and initialize
* memory resources constraints. * the system-wide memory resources constraints.
*/ */
mem = new_resource(root, 1); mem = new_resource(root, 1);
mem->base = 0; mem->base = 0;
@ -945,10 +948,9 @@ void dev_phase4(void)
compute_allocate_resource(&root->link[0], mem, compute_allocate_resource(&root->link[0], mem,
IORESOURCE_MEM, IORESOURCE_MEM); IORESOURCE_MEM, IORESOURCE_MEM);
/* Now we need to adjust the resources. The issue is that mem grows downward. /* Now we need to adjust the resources. The issue is that mem grows
io = &root->resource[0]; * downward.
mem = &root->resource[1]; */
/* Make certain the I/O devices are allocated somewhere safe. */ /* Make certain the I/O devices are allocated somewhere safe. */
io->base = DEVICE_IO_START; io->base = DEVICE_IO_START;
io->flags |= IORESOURCE_ASSIGNED; io->flags |= IORESOURCE_ASSIGNED;