Rev 1324 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed
| Rev | Author | Line No. | Line |
|---|---|---|---|
| 1301 | jermar | 1 | /* |
| 2 | * The PCI Library |
||
| 3 | * |
||
| 4 | * Copyright (c) 1997--2005 Martin Mares <mj@ucw.cz> |
||
| 5 | * |
||
| 1324 | jermar | 6 | * May 8, 2006 - Modified and ported to HelenOS by Jakub Jermar. |
| 1301 | jermar | 7 | * |
| 8 | * Can be freely distributed and used under the terms of the GNU GPL. |
||
| 9 | */ |
||
| 10 | |||
| 11 | #ifndef _PCI_LIB_H |
||
| 12 | #define _PCI_LIB_H |
||
| 13 | |||
| 14 | #include "header.h" |
||
| 15 | #include "types.h" |
||
| 16 | |||
| 17 | #define PCI_LIB_VERSION 0x020200 |
||
| 18 | |||
| 19 | /* |
||
| 20 | * PCI Access Structure |
||
| 21 | */ |
||
| 22 | |||
| 23 | struct pci_methods; |
||
| 24 | |||
| 25 | enum pci_access_type { |
||
| 1302 | jermar | 26 | /* Known access methods, remember to update access.c as well */ |
| 27 | PCI_ACCESS_I386_TYPE1, /* i386 ports, type 1 (params: none) */ |
||
| 28 | PCI_ACCESS_I386_TYPE2, /* i386 ports, type 2 (params: none) */ |
||
| 29 | PCI_ACCESS_MAX |
||
| 1301 | jermar | 30 | }; |
| 31 | |||
| 32 | struct pci_access { |
||
| 1302 | jermar | 33 | /* Options you can change: */ |
| 34 | unsigned int method; /* Access method */ |
||
| 35 | char *method_params[PCI_ACCESS_MAX]; /* Parameters for the methods */ |
||
| 36 | int writeable; /* Open in read/write mode */ |
||
| 37 | int buscentric; /* Bus-centric view of the world */ |
||
| 38 | int numeric_ids; /* Don't resolve device IDs to names */ |
||
| 39 | int debugging; /* Turn on debugging messages */ |
||
| 1301 | jermar | 40 | |
| 1302 | jermar | 41 | /* Functions you can override: */ |
| 42 | void (*error) (char *msg, ...); /* Write error message and quit */ |
||
| 43 | void (*warning) (char *msg, ...); /* Write a warning message */ |
||
| 44 | void (*debug) (char *msg, ...); /* Write a debugging message */ |
||
| 1301 | jermar | 45 | |
| 1302 | jermar | 46 | struct pci_dev *devices; /* Devices found on this bus */ |
| 1301 | jermar | 47 | |
| 1302 | jermar | 48 | /* Fields used internally: */ |
| 49 | struct pci_methods *methods; |
||
| 50 | struct id_entry **id_hash; /* names.c */ |
||
| 51 | struct id_bucket *current_id_bucket; |
||
| 1301 | jermar | 52 | }; |
| 53 | |||
| 54 | /* Initialize PCI access */ |
||
| 55 | struct pci_access *pci_alloc(void); |
||
| 56 | void pci_init(struct pci_access *); |
||
| 57 | void pci_cleanup(struct pci_access *); |
||
| 58 | |||
| 59 | /* Scanning of devices */ |
||
| 60 | void pci_scan_bus(struct pci_access *acc); |
||
| 1302 | jermar | 61 | struct pci_dev *pci_get_dev(struct pci_access *acc, int domain, int bus, int dev, int func); /* Raw access to specified device */ |
| 1301 | jermar | 62 | void pci_free_dev(struct pci_dev *); |
| 63 | |||
| 64 | /* |
||
| 65 | * Devices |
||
| 66 | */ |
||
| 67 | |||
| 68 | struct pci_dev { |
||
| 1302 | jermar | 69 | struct pci_dev *next; /* Next device in the chain */ |
| 70 | u16 domain; /* PCI domain (host bridge) */ |
||
| 71 | u8 bus, dev, func; /* Bus inside domain, device and function */ |
||
| 1301 | jermar | 72 | |
| 1302 | jermar | 73 | /* These fields are set by pci_fill_info() */ |
| 74 | int known_fields; /* Set of info fields already known */ |
||
| 75 | u16 vendor_id, device_id; /* Identity of the device */ |
||
| 76 | int irq; /* IRQ number */ |
||
| 77 | pciaddr_t base_addr[6]; /* Base addresses */ |
||
| 78 | pciaddr_t size[6]; /* Region sizes */ |
||
| 79 | pciaddr_t rom_base_addr; /* Expansion ROM base address */ |
||
| 80 | pciaddr_t rom_size; /* Expansion ROM size */ |
||
| 1301 | jermar | 81 | |
| 1302 | jermar | 82 | /* Fields used internally: */ |
| 83 | struct pci_access *access; |
||
| 84 | struct pci_methods *methods; |
||
| 85 | u8 *cache; /* Cached config registers */ |
||
| 86 | int cache_len; |
||
| 87 | int hdrtype; /* Cached low 7 bits of header type, -1 if unknown */ |
||
| 88 | void *aux; /* Auxillary data */ |
||
| 1301 | jermar | 89 | }; |
| 90 | |||
| 91 | #define PCI_ADDR_IO_MASK (~(pciaddr_t) 0x3) |
||
| 92 | #define PCI_ADDR_MEM_MASK (~(pciaddr_t) 0xf) |
||
| 93 | |||
| 1302 | jermar | 94 | u8 pci_read_byte(struct pci_dev *, int pos); /* Access to configuration space */ |
| 1301 | jermar | 95 | u16 pci_read_word(struct pci_dev *, int pos); |
| 1302 | jermar | 96 | u32 pci_read_long(struct pci_dev *, int pos); |
| 97 | int pci_read_block(struct pci_dev *, int pos, u8 * buf, int len); |
||
| 1301 | jermar | 98 | int pci_write_byte(struct pci_dev *, int pos, u8 data); |
| 99 | int pci_write_word(struct pci_dev *, int pos, u16 data); |
||
| 100 | int pci_write_long(struct pci_dev *, int pos, u32 data); |
||
| 1302 | jermar | 101 | int pci_write_block(struct pci_dev *, int pos, u8 * buf, int len); |
| 1301 | jermar | 102 | |
| 1302 | jermar | 103 | int pci_fill_info(struct pci_dev *, int flags); /* Fill in device information */ |
| 1301 | jermar | 104 | |
| 105 | #define PCI_FILL_IDENT 1 |
||
| 106 | #define PCI_FILL_IRQ 2 |
||
| 107 | #define PCI_FILL_BASES 4 |
||
| 108 | #define PCI_FILL_ROM_BASE 8 |
||
| 109 | #define PCI_FILL_SIZES 16 |
||
| 110 | #define PCI_FILL_RESCAN 0x10000 |
||
| 111 | |||
| 1302 | jermar | 112 | void pci_setup_cache(struct pci_dev *, u8 * cache, int len); |
| 1301 | jermar | 113 | |
| 114 | /* |
||
| 115 | * Conversion of PCI ID's to names (according to the pci.ids file) |
||
| 116 | * |
||
| 117 | * Call pci_lookup_name() to identify different types of ID's: |
||
| 118 | * |
||
| 119 | * VENDOR (vendorID) -> vendor |
||
| 120 | * DEVICE (vendorID, deviceID) -> device |
||
| 121 | * VENDOR | DEVICE (vendorID, deviceID) -> combined vendor and device |
||
| 122 | * SUBSYSTEM | VENDOR (subvendorID) -> subsystem vendor |
||
| 123 | * SUBSYSTEM | DEVICE (vendorID, deviceID, subvendorID, subdevID) -> subsystem device |
||
| 124 | * SUBSYSTEM | VENDOR | DEVICE (vendorID, deviceID, subvendorID, subdevID) -> combined subsystem v+d |
||
| 125 | * SUBSYSTEM | ... (-1, -1, subvendorID, subdevID) -> generic subsystem |
||
| 126 | * CLASS (classID) -> class |
||
| 127 | * PROGIF (classID, progif) -> programming interface |
||
| 128 | */ |
||
| 129 | |||
| 1302 | jermar | 130 | char *pci_lookup_name(struct pci_access *a, char *buf, int size, int flags, |
| 131 | ...); |
||
| 1301 | jermar | 132 | |
| 133 | int pci_load_name_list(struct pci_access *a); /* Called automatically by pci_lookup_*() when needed; returns success */ |
||
| 134 | void pci_free_name_list(struct pci_access *a); /* Called automatically by pci_cleanup() */ |
||
| 135 | |||
| 136 | enum pci_lookup_mode { |
||
| 1302 | jermar | 137 | PCI_LOOKUP_VENDOR = 1, /* Vendor name (args: vendorID) */ |
| 138 | PCI_LOOKUP_DEVICE = 2, /* Device name (args: vendorID, deviceID) */ |
||
| 139 | PCI_LOOKUP_CLASS = 4, /* Device class (args: classID) */ |
||
| 140 | PCI_LOOKUP_SUBSYSTEM = 8, |
||
| 141 | PCI_LOOKUP_PROGIF = 16, /* Programming interface (args: classID, prog_if) */ |
||
| 142 | PCI_LOOKUP_NUMERIC = 0x10000, /* Want only formatted numbers; default if access->numeric_ids is set */ |
||
| 143 | PCI_LOOKUP_NO_NUMBERS = 0x20000 /* Return NULL if not found in the database; default is to print numerically */ |
||
| 1301 | jermar | 144 | }; |
| 145 | |||
| 146 | #endif |