Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | /* |
| 2 | * ioport.h Definitions of routines for detecting, reserving and |
| 3 | * allocating system resources. |
| 4 | * |
| 5 | * Authors: Linus Torvalds |
| 6 | */ |
| 7 | |
| 8 | #ifndef _LINUX_IOPORT_H |
| 9 | #define _LINUX_IOPORT_H |
| 10 | |
Bernhard Walle | c9cce83 | 2008-01-30 13:30:32 +0100 | [diff] [blame] | 11 | #ifndef __ASSEMBLY__ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 12 | #include <linux/compiler.h> |
Greg Kroah-Hartman | cf7c712 | 2006-06-12 15:49:31 -0700 | [diff] [blame] | 13 | #include <linux/types.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 14 | /* |
| 15 | * Resources are tree-like, allowing |
| 16 | * nesting etc.. |
| 17 | */ |
| 18 | struct resource { |
Greg Kroah-Hartman | cf7c712 | 2006-06-12 15:49:31 -0700 | [diff] [blame] | 19 | resource_size_t start; |
| 20 | resource_size_t end; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 21 | const char *name; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 22 | unsigned long flags; |
| 23 | struct resource *parent, *sibling, *child; |
| 24 | }; |
| 25 | |
| 26 | struct resource_list { |
| 27 | struct resource_list *next; |
| 28 | struct resource *res; |
| 29 | struct pci_dev *dev; |
| 30 | }; |
| 31 | |
| 32 | /* |
| 33 | * IO resources have these defined flags. |
| 34 | */ |
| 35 | #define IORESOURCE_BITS 0x000000ff /* Bus-specific bits */ |
| 36 | |
| 37 | #define IORESOURCE_IO 0x00000100 /* Resource type */ |
| 38 | #define IORESOURCE_MEM 0x00000200 |
| 39 | #define IORESOURCE_IRQ 0x00000400 |
| 40 | #define IORESOURCE_DMA 0x00000800 |
| 41 | |
| 42 | #define IORESOURCE_PREFETCH 0x00001000 /* No side effects */ |
| 43 | #define IORESOURCE_READONLY 0x00002000 |
| 44 | #define IORESOURCE_CACHEABLE 0x00004000 |
| 45 | #define IORESOURCE_RANGELENGTH 0x00008000 |
| 46 | #define IORESOURCE_SHADOWABLE 0x00010000 |
| 47 | #define IORESOURCE_BUS_HAS_VGA 0x00080000 |
| 48 | |
| 49 | #define IORESOURCE_DISABLED 0x10000000 |
| 50 | #define IORESOURCE_UNSET 0x20000000 |
| 51 | #define IORESOURCE_AUTO 0x40000000 |
| 52 | #define IORESOURCE_BUSY 0x80000000 /* Driver has marked this resource busy */ |
| 53 | |
| 54 | /* ISA PnP IRQ specific bits (IORESOURCE_BITS) */ |
| 55 | #define IORESOURCE_IRQ_HIGHEDGE (1<<0) |
| 56 | #define IORESOURCE_IRQ_LOWEDGE (1<<1) |
| 57 | #define IORESOURCE_IRQ_HIGHLEVEL (1<<2) |
| 58 | #define IORESOURCE_IRQ_LOWLEVEL (1<<3) |
Bjorn Helgaas | c32928c | 2006-07-03 00:24:10 -0700 | [diff] [blame] | 59 | #define IORESOURCE_IRQ_SHAREABLE (1<<4) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 60 | |
| 61 | /* ISA PnP DMA specific bits (IORESOURCE_BITS) */ |
| 62 | #define IORESOURCE_DMA_TYPE_MASK (3<<0) |
| 63 | #define IORESOURCE_DMA_8BIT (0<<0) |
| 64 | #define IORESOURCE_DMA_8AND16BIT (1<<0) |
| 65 | #define IORESOURCE_DMA_16BIT (2<<0) |
| 66 | |
| 67 | #define IORESOURCE_DMA_MASTER (1<<2) |
| 68 | #define IORESOURCE_DMA_BYTE (1<<3) |
| 69 | #define IORESOURCE_DMA_WORD (1<<4) |
| 70 | |
| 71 | #define IORESOURCE_DMA_SPEED_MASK (3<<6) |
| 72 | #define IORESOURCE_DMA_COMPATIBLE (0<<6) |
| 73 | #define IORESOURCE_DMA_TYPEA (1<<6) |
| 74 | #define IORESOURCE_DMA_TYPEB (2<<6) |
| 75 | #define IORESOURCE_DMA_TYPEF (3<<6) |
| 76 | |
| 77 | /* ISA PnP memory I/O specific bits (IORESOURCE_BITS) */ |
| 78 | #define IORESOURCE_MEM_WRITEABLE (1<<0) /* dup: IORESOURCE_READONLY */ |
| 79 | #define IORESOURCE_MEM_CACHEABLE (1<<1) /* dup: IORESOURCE_CACHEABLE */ |
| 80 | #define IORESOURCE_MEM_RANGELENGTH (1<<2) /* dup: IORESOURCE_RANGELENGTH */ |
| 81 | #define IORESOURCE_MEM_TYPE_MASK (3<<3) |
| 82 | #define IORESOURCE_MEM_8BIT (0<<3) |
| 83 | #define IORESOURCE_MEM_16BIT (1<<3) |
| 84 | #define IORESOURCE_MEM_8AND16BIT (2<<3) |
| 85 | #define IORESOURCE_MEM_32BIT (3<<3) |
| 86 | #define IORESOURCE_MEM_SHADOWABLE (1<<5) /* dup: IORESOURCE_SHADOWABLE */ |
| 87 | #define IORESOURCE_MEM_EXPANSIONROM (1<<6) |
| 88 | |
| 89 | /* PCI ROM control bits (IORESOURCE_BITS) */ |
| 90 | #define IORESOURCE_ROM_ENABLE (1<<0) /* ROM is enabled, same as PCI_ROM_ADDRESS_ENABLE */ |
| 91 | #define IORESOURCE_ROM_SHADOW (1<<1) /* ROM is copy at C000:0 */ |
| 92 | #define IORESOURCE_ROM_COPY (1<<2) /* ROM is alloc'd copy, resource field overlaid */ |
John Keller | a2302c6 | 2006-10-04 16:49:52 -0500 | [diff] [blame] | 93 | #define IORESOURCE_ROM_BIOS_COPY (1<<3) /* ROM is BIOS copy, resource field overlaid */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 94 | |
Ralf Baechle | fb0f2b4 | 2006-12-19 13:12:08 -0800 | [diff] [blame] | 95 | /* PCI control bits. Shares IORESOURCE_BITS with above PCI ROM. */ |
| 96 | #define IORESOURCE_PCI_FIXED (1<<4) /* Do not move resource */ |
| 97 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 98 | /* PC/ISA/whatever - the normal PC address spaces: IO and memory */ |
| 99 | extern struct resource ioport_resource; |
| 100 | extern struct resource iomem_resource; |
| 101 | |
| 102 | extern int request_resource(struct resource *root, struct resource *new); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 103 | extern int release_resource(struct resource *new); |
Adrian Bunk | cd6ef2ad | 2006-06-30 02:15:42 -0700 | [diff] [blame] | 104 | extern int insert_resource(struct resource *parent, struct resource *new); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 105 | extern int allocate_resource(struct resource *root, struct resource *new, |
Greg Kroah-Hartman | d75fc8b | 2006-06-12 16:09:23 -0700 | [diff] [blame] | 106 | resource_size_t size, resource_size_t min, |
| 107 | resource_size_t max, resource_size_t align, |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 108 | void (*alignf)(void *, struct resource *, |
Greg Kroah-Hartman | d75fc8b | 2006-06-12 16:09:23 -0700 | [diff] [blame] | 109 | resource_size_t, resource_size_t), |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 110 | void *alignf_data); |
Greg Kroah-Hartman | d75fc8b | 2006-06-12 16:09:23 -0700 | [diff] [blame] | 111 | int adjust_resource(struct resource *res, resource_size_t start, |
| 112 | resource_size_t size); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 113 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 114 | /* Convenience shorthand with allocation */ |
| 115 | #define request_region(start,n,name) __request_region(&ioport_resource, (start), (n), (name)) |
| 116 | #define request_mem_region(start,n,name) __request_region(&iomem_resource, (start), (n), (name)) |
| 117 | #define rename_region(region, newname) do { (region)->name = (newname); } while (0) |
| 118 | |
Greg Kroah-Hartman | d75fc8b | 2006-06-12 16:09:23 -0700 | [diff] [blame] | 119 | extern struct resource * __request_region(struct resource *, |
| 120 | resource_size_t start, |
| 121 | resource_size_t n, const char *name); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 122 | |
| 123 | /* Compatibility cruft */ |
| 124 | #define release_region(start,n) __release_region(&ioport_resource, (start), (n)) |
| 125 | #define check_mem_region(start,n) __check_region(&iomem_resource, (start), (n)) |
| 126 | #define release_mem_region(start,n) __release_region(&iomem_resource, (start), (n)) |
| 127 | |
Greg Kroah-Hartman | d75fc8b | 2006-06-12 16:09:23 -0700 | [diff] [blame] | 128 | extern int __check_region(struct resource *, resource_size_t, resource_size_t); |
| 129 | extern void __release_region(struct resource *, resource_size_t, |
| 130 | resource_size_t); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 131 | |
Greg Kroah-Hartman | d75fc8b | 2006-06-12 16:09:23 -0700 | [diff] [blame] | 132 | static inline int __deprecated check_region(resource_size_t s, |
| 133 | resource_size_t n) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 134 | { |
| 135 | return __check_region(&ioport_resource, s, n); |
| 136 | } |
Tejun Heo | 9ac7849 | 2007-01-20 16:00:26 +0900 | [diff] [blame] | 137 | |
| 138 | /* Wrappers for managed devices */ |
| 139 | struct device; |
| 140 | #define devm_request_region(dev,start,n,name) \ |
| 141 | __devm_request_region(dev, &ioport_resource, (start), (n), (name)) |
| 142 | #define devm_request_mem_region(dev,start,n,name) \ |
| 143 | __devm_request_region(dev, &iomem_resource, (start), (n), (name)) |
| 144 | |
| 145 | extern struct resource * __devm_request_region(struct device *dev, |
| 146 | struct resource *parent, resource_size_t start, |
| 147 | resource_size_t n, const char *name); |
| 148 | |
| 149 | #define devm_release_region(start,n) \ |
| 150 | __devm_release_region(dev, &ioport_resource, (start), (n)) |
| 151 | #define devm_release_mem_region(start,n) \ |
| 152 | __devm_release_region(dev, &iomem_resource, (start), (n)) |
| 153 | |
| 154 | extern void __devm_release_region(struct device *dev, struct resource *parent, |
| 155 | resource_size_t start, resource_size_t n); |
| 156 | |
Bernhard Walle | c9cce83 | 2008-01-30 13:30:32 +0100 | [diff] [blame] | 157 | #endif /* __ASSEMBLY__ */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 158 | #endif /* _LINUX_IOPORT_H */ |