- Major update of the dynamic device tree so it can handle
[coreboot.git] / src / include / device / device.h
1 #ifndef DEVICE_H
2 #define DEVICE_H
3
4 #include <stdint.h>
5 #include <device/resource.h>
6 #include <device/path.h>
7
8 struct device;
9 typedef struct device * device_t;
10
11 struct device_operations {
12         void (*read_resources)(device_t dev);
13         void (*set_resources)(device_t dev);
14         void (*enable_resources)(device_t dev);
15         void (*init)(device_t dev);
16         unsigned int (*scan_bus)(device_t  bus, unsigned int max);
17         void (*enable)(device_t dev);
18 };
19
20
21 struct bus {
22         device_t        dev;            /* This bridge device */
23         device_t        children;       /* devices behind this bridge */
24         unsigned        bridge_ctrl;    /* Bridge control register */
25         unsigned char   link;           /* The index of this link */
26         unsigned char   secondary;      /* secondary bus number */
27         unsigned char   subordinate;    /* max subordinate bus number */
28         unsigned char   cap;            /* PCi capability offset */
29 };
30
31 #define MAX_RESOURCES 6
32 #define MAX_LINKS     3
33 /*
34  * There is one device structure for each slot-number/function-number
35  * combination:
36  */
37
38 struct device {
39         struct bus *    bus;            /* bus this device is on */
40         device_t        sibling;        /* next device on this bus */
41         device_t        next;           /* chain of all devices */
42
43         struct device_path path;
44         unsigned short  vendor;
45         unsigned short  device;
46         unsigned int    class;          /* 3 bytes: (base,sub,prog-if) */
47         unsigned int    hdr_type;       /* PCI header type */
48         unsigned int    enable : 1;     /* set if we should enable the device */
49
50         uint8_t command;
51         /*
52          * In theory, the irq level can be read from configuration
53          * space and all would be fine.  However, old PCI chips don't
54          * support these registers and return 0 instead.  For example,
55          * the Vision864-P rev 0 chip can uses INTA, but returns 0 in
56          * the interrupt line and pin registers.  pci_init()
57          * initializes this field with the value at PCI_INTERRUPT_LINE
58          * and it is the job of pcibios_fixup() to change it if
59          * necessary.  The field must not be 0 unless the device
60          * cannot generate interrupts at all.
61          */
62         unsigned int    irq;            /* irq generated by this device */
63
64         /* Base registers for this device, can be adjusted by
65          * pcibios_fixup() as necessary.
66          */
67         struct resource resource[MAX_RESOURCES];
68         unsigned int resources;
69
70         struct bus link[MAX_LINKS];
71         unsigned int links;
72
73         unsigned long rom_address;
74         struct device_operations *ops;
75 };
76
77 extern struct device    dev_root;       /* root bus */
78 extern struct device    *all_devices;   /* list of all devices */
79
80
81 /* Generic device interface functions */
82 extern device_t alloc_dev(struct bus *parent, struct device_path *path);
83 extern void dev_enumerate(void);
84 extern void dev_configure(void);
85 extern void dev_enable(void);
86 extern void dev_initialize(void);
87
88 /* Generic device helper functions */
89 extern void compute_allocate_resource(struct bus *bus, struct resource *bridge,
90         unsigned long type_mask, unsigned long type);
91 extern void assign_resources(struct bus *bus);
92 extern void enable_resources(struct device *dev);
93 extern void enumerate_static_device(void);
94 extern const char *dev_path(device_t dev);
95
96 /* Helper functions */
97 device_t alloc_find_dev(struct bus *bus, struct device_path *path);
98 device_t dev_find_device (unsigned int vendor, unsigned int device, device_t from);
99 device_t dev_find_class (unsigned int class, device_t from);
100 device_t dev_find_slot (unsigned int bus, unsigned int devfn);
101
102 /* Rounding for boundaries. 
103  * Due to some chip bugs, go ahead and roung IO to 16
104  */
105 #define DEVICE_IO_ALIGN 16 
106 #define DEVICE_MEM_ALIGN 4096
107
108 struct device_operations default_dev_ops_root;
109 extern void root_dev_read_resources(device_t dev);
110 extern void root_dev_set_resources(device_t dev);
111 extern unsigned int walk_static_devices(device_t bus, unsigned int max);
112 extern void enable_childrens_resources(device_t dev);
113
114 #endif /* DEVICE_H */