ioport.h 10.5 KB
Newer Older
Linus Torvalds's avatar
Linus Torvalds committed
1 2 3 4 5 6 7 8 9 10
/*
 * ioport.h	Definitions of routines for detecting, reserving and
 *		allocating system resources.
 *
 * Authors:	Linus Torvalds
 */

#ifndef _LINUX_IOPORT_H
#define _LINUX_IOPORT_H

11
#ifndef __ASSEMBLY__
Linus Torvalds's avatar
Linus Torvalds committed
12
#include <linux/compiler.h>
13
#include <linux/types.h>
Linus Torvalds's avatar
Linus Torvalds committed
14 15 16 17 18
/*
 * Resources are tree-like, allowing
 * nesting etc..
 */
struct resource {
19 20
	resource_size_t start;
	resource_size_t end;
Linus Torvalds's avatar
Linus Torvalds committed
21 22
	const char *name;
	unsigned long flags;
23
	unsigned long desc;
Linus Torvalds's avatar
Linus Torvalds committed
24 25 26 27 28
	struct resource *parent, *sibling, *child;
};

/*
 * IO resources have these defined flags.
29 30 31
 *
 * PCI devices expose these flags to userspace in the "resource" sysfs file,
 * so don't move them.
Linus Torvalds's avatar
Linus Torvalds committed
32 33 34
 */
#define IORESOURCE_BITS		0x000000ff	/* Bus-specific bits */

35
#define IORESOURCE_TYPE_BITS	0x00001f00	/* Resource type */
36
#define IORESOURCE_IO		0x00000100	/* PCI/ISA I/O ports */
Linus Torvalds's avatar
Linus Torvalds committed
37
#define IORESOURCE_MEM		0x00000200
38
#define IORESOURCE_REG		0x00000300	/* Register offsets */
Linus Torvalds's avatar
Linus Torvalds committed
39 40
#define IORESOURCE_IRQ		0x00000400
#define IORESOURCE_DMA		0x00000800
41
#define IORESOURCE_BUS		0x00001000
Linus Torvalds's avatar
Linus Torvalds committed
42

43 44 45 46 47
#define IORESOURCE_PREFETCH	0x00002000	/* No side effects */
#define IORESOURCE_READONLY	0x00004000
#define IORESOURCE_CACHEABLE	0x00008000
#define IORESOURCE_RANGELENGTH	0x00010000
#define IORESOURCE_SHADOWABLE	0x00020000
48

49 50
#define IORESOURCE_SIZEALIGN	0x00040000	/* size indicates alignment */
#define IORESOURCE_STARTALIGN	0x00080000	/* start field is alignment */
Linus Torvalds's avatar
Linus Torvalds committed
51

52
#define IORESOURCE_MEM_64	0x00100000
53
#define IORESOURCE_WINDOW	0x00200000	/* forwarded by bridge */
54
#define IORESOURCE_MUXED	0x00400000	/* Resource is software muxed */
55

56 57 58
#define IORESOURCE_EXT_TYPE_BITS 0x01000000	/* Resource extended types */
#define IORESOURCE_SYSRAM	0x01000000	/* System RAM (modifier) */

59
#define IORESOURCE_EXCLUSIVE	0x08000000	/* Userland may not map this resource */
60

Linus Torvalds's avatar
Linus Torvalds committed
61
#define IORESOURCE_DISABLED	0x10000000
62
#define IORESOURCE_UNSET	0x20000000	/* No address assigned yet */
Linus Torvalds's avatar
Linus Torvalds committed
63 64 65
#define IORESOURCE_AUTO		0x40000000
#define IORESOURCE_BUSY		0x80000000	/* Driver has marked this resource busy */

66 67 68
/* I/O resource extended types */
#define IORESOURCE_SYSTEM_RAM		(IORESOURCE_MEM|IORESOURCE_SYSRAM)

69
/* PnP IRQ specific bits (IORESOURCE_BITS) */
Linus Torvalds's avatar
Linus Torvalds committed
70 71 72 73
#define IORESOURCE_IRQ_HIGHEDGE		(1<<0)
#define IORESOURCE_IRQ_LOWEDGE		(1<<1)
#define IORESOURCE_IRQ_HIGHLEVEL	(1<<2)
#define IORESOURCE_IRQ_LOWLEVEL		(1<<3)
74
#define IORESOURCE_IRQ_SHAREABLE	(1<<4)
75
#define IORESOURCE_IRQ_OPTIONAL 	(1<<5)
Linus Torvalds's avatar
Linus Torvalds committed
76

77
/* PnP DMA specific bits (IORESOURCE_BITS) */
Linus Torvalds's avatar
Linus Torvalds committed
78 79 80 81 82 83 84 85 86 87 88 89 90 91 92
#define IORESOURCE_DMA_TYPE_MASK	(3<<0)
#define IORESOURCE_DMA_8BIT		(0<<0)
#define IORESOURCE_DMA_8AND16BIT	(1<<0)
#define IORESOURCE_DMA_16BIT		(2<<0)

#define IORESOURCE_DMA_MASTER		(1<<2)
#define IORESOURCE_DMA_BYTE		(1<<3)
#define IORESOURCE_DMA_WORD		(1<<4)

#define IORESOURCE_DMA_SPEED_MASK	(3<<6)
#define IORESOURCE_DMA_COMPATIBLE	(0<<6)
#define IORESOURCE_DMA_TYPEA		(1<<6)
#define IORESOURCE_DMA_TYPEB		(2<<6)
#define IORESOURCE_DMA_TYPEF		(3<<6)

93
/* PnP memory I/O specific bits (IORESOURCE_BITS) */
Linus Torvalds's avatar
Linus Torvalds committed
94 95 96 97 98 99 100 101 102 103 104
#define IORESOURCE_MEM_WRITEABLE	(1<<0)	/* dup: IORESOURCE_READONLY */
#define IORESOURCE_MEM_CACHEABLE	(1<<1)	/* dup: IORESOURCE_CACHEABLE */
#define IORESOURCE_MEM_RANGELENGTH	(1<<2)	/* dup: IORESOURCE_RANGELENGTH */
#define IORESOURCE_MEM_TYPE_MASK	(3<<3)
#define IORESOURCE_MEM_8BIT		(0<<3)
#define IORESOURCE_MEM_16BIT		(1<<3)
#define IORESOURCE_MEM_8AND16BIT	(2<<3)
#define IORESOURCE_MEM_32BIT		(3<<3)
#define IORESOURCE_MEM_SHADOWABLE	(1<<5)	/* dup: IORESOURCE_SHADOWABLE */
#define IORESOURCE_MEM_EXPANSIONROM	(1<<6)

105 106 107
/* PnP I/O specific bits (IORESOURCE_BITS) */
#define IORESOURCE_IO_16BIT_ADDR	(1<<0)
#define IORESOURCE_IO_FIXED		(1<<1)
108
#define IORESOURCE_IO_SPARSE		(1<<2)
109

Linus Torvalds's avatar
Linus Torvalds committed
110 111
/* PCI ROM control bits (IORESOURCE_BITS) */
#define IORESOURCE_ROM_ENABLE		(1<<0)	/* ROM is enabled, same as PCI_ROM_ADDRESS_ENABLE */
112
#define IORESOURCE_ROM_SHADOW		(1<<1)	/* Use RAM image, not ROM BAR */
Linus Torvalds's avatar
Linus Torvalds committed
113

Ralf Baechle's avatar
Ralf Baechle committed
114 115
/* PCI control bits.  Shares IORESOURCE_BITS with above PCI ROM.  */
#define IORESOURCE_PCI_FIXED		(1<<4)	/* Do not move resource */
116
#define IORESOURCE_PCI_EA_BEI		(1<<5)	/* BAR Equivalent Indicator */
Ralf Baechle's avatar
Ralf Baechle committed
117

118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133
/*
 * I/O Resource Descriptors
 *
 * Descriptors are used by walk_iomem_res_desc() and region_intersects()
 * for searching a specific resource range in the iomem table.  Assign
 * a new descriptor when a resource range supports the search interfaces.
 * Otherwise, resource.desc must be set to IORES_DESC_NONE (0).
 */
enum {
	IORES_DESC_NONE				= 0,
	IORES_DESC_CRASH_KERNEL			= 1,
	IORES_DESC_ACPI_TABLES			= 2,
	IORES_DESC_ACPI_NV_STORAGE		= 3,
	IORES_DESC_PERSISTENT_MEMORY		= 4,
	IORES_DESC_PERSISTENT_MEMORY_LEGACY	= 5,
};
134 135 136 137 138 139 140 141

/* helpers to define resources */
#define DEFINE_RES_NAMED(_start, _size, _name, _flags)			\
	{								\
		.start = (_start),					\
		.end = (_start) + (_size) - 1,				\
		.name = (_name),					\
		.flags = (_flags),					\
142
		.desc = IORES_DESC_NONE,				\
143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164
	}

#define DEFINE_RES_IO_NAMED(_start, _size, _name)			\
	DEFINE_RES_NAMED((_start), (_size), (_name), IORESOURCE_IO)
#define DEFINE_RES_IO(_start, _size)					\
	DEFINE_RES_IO_NAMED((_start), (_size), NULL)

#define DEFINE_RES_MEM_NAMED(_start, _size, _name)			\
	DEFINE_RES_NAMED((_start), (_size), (_name), IORESOURCE_MEM)
#define DEFINE_RES_MEM(_start, _size)					\
	DEFINE_RES_MEM_NAMED((_start), (_size), NULL)

#define DEFINE_RES_IRQ_NAMED(_irq, _name)				\
	DEFINE_RES_NAMED((_irq), 1, (_name), IORESOURCE_IRQ)
#define DEFINE_RES_IRQ(_irq)						\
	DEFINE_RES_IRQ_NAMED((_irq), NULL)

#define DEFINE_RES_DMA_NAMED(_dma, _name)				\
	DEFINE_RES_NAMED((_dma), 1, (_name), IORESOURCE_DMA)
#define DEFINE_RES_DMA(_dma)						\
	DEFINE_RES_DMA_NAMED((_dma), NULL)

Linus Torvalds's avatar
Linus Torvalds committed
165 166 167 168
/* PC/ISA/whatever - the normal PC address spaces: IO and memory */
extern struct resource ioport_resource;
extern struct resource iomem_resource;

169
extern struct resource *request_resource_conflict(struct resource *root, struct resource *new);
Linus Torvalds's avatar
Linus Torvalds committed
170 171
extern int request_resource(struct resource *root, struct resource *new);
extern int release_resource(struct resource *new);
172
void release_child_resources(struct resource *new);
173 174 175
extern void reserve_region_with_split(struct resource *root,
			     resource_size_t start, resource_size_t end,
			     const char *name);
176
extern struct resource *insert_resource_conflict(struct resource *parent, struct resource *new);
177
extern int insert_resource(struct resource *parent, struct resource *new);
178
extern void insert_resource_expand_to_fit(struct resource *root, struct resource *new);
179
extern int remove_resource(struct resource *old);
180
extern void arch_remove_reservations(struct resource *avail);
Linus Torvalds's avatar
Linus Torvalds committed
181
extern int allocate_resource(struct resource *root, struct resource *new,
182 183
			     resource_size_t size, resource_size_t min,
			     resource_size_t max, resource_size_t align,
184
			     resource_size_t (*alignf)(void *,
185
						       const struct resource *,
186 187
						       resource_size_t,
						       resource_size_t),
Linus Torvalds's avatar
Linus Torvalds committed
188
			     void *alignf_data);
189
struct resource *lookup_resource(struct resource *root, resource_size_t start);
190 191
int adjust_resource(struct resource *res, resource_size_t start,
		    resource_size_t size);
192
resource_size_t resource_alignment(struct resource *res);
193
static inline resource_size_t resource_size(const struct resource *res)
194 195 196
{
	return res->end - res->start + 1;
}
197
static inline unsigned long resource_type(const struct resource *res)
198 199 200
{
	return res->flags & IORESOURCE_TYPE_BITS;
}
201 202 203 204
static inline unsigned long resource_ext_type(const struct resource *res)
{
	return res->flags & IORESOURCE_EXT_TYPE_BITS;
}
205 206 207 208 209 210 211 212 213 214
/* True iff r1 completely contains r2 */
static inline bool resource_contains(struct resource *r1, struct resource *r2)
{
	if (resource_type(r1) != resource_type(r2))
		return false;
	if (r1->flags & IORESOURCE_UNSET || r2->flags & IORESOURCE_UNSET)
		return false;
	return r1->start <= r2->start && r1->end >= r2->end;
}

Linus Torvalds's avatar
Linus Torvalds committed
215 216

/* Convenience shorthand with allocation */
217 218
#define request_region(start,n,name)		__request_region(&ioport_resource, (start), (n), (name), 0)
#define request_muxed_region(start,n,name)	__request_region(&ioport_resource, (start), (n), (name), IORESOURCE_MUXED)
219 220 221 222
#define __request_mem_region(start,n,name, excl) __request_region(&iomem_resource, (start), (n), (name), excl)
#define request_mem_region(start,n,name) __request_region(&iomem_resource, (start), (n), (name), 0)
#define request_mem_region_exclusive(start,n,name) \
	__request_region(&iomem_resource, (start), (n), (name), IORESOURCE_EXCLUSIVE)
Linus Torvalds's avatar
Linus Torvalds committed
223 224
#define rename_region(region, newname) do { (region)->name = (newname); } while (0)

225 226
extern struct resource * __request_region(struct resource *,
					resource_size_t start,
227 228
					resource_size_t n,
					const char *name, int flags);
Linus Torvalds's avatar
Linus Torvalds committed
229 230 231 232 233

/* Compatibility cruft */
#define release_region(start,n)	__release_region(&ioport_resource, (start), (n))
#define release_mem_region(start,n)	__release_region(&iomem_resource, (start), (n))

234 235
extern void __release_region(struct resource *, resource_size_t,
				resource_size_t);
236 237 238 239
#ifdef CONFIG_MEMORY_HOTREMOVE
extern int release_mem_region_adjustable(struct resource *, resource_size_t,
				resource_size_t);
#endif
Linus Torvalds's avatar
Linus Torvalds committed
240

241 242
/* Wrappers for managed devices */
struct device;
243 244 245 246 247

extern int devm_request_resource(struct device *dev, struct resource *root,
				 struct resource *new);
extern void devm_release_resource(struct device *dev, struct resource *new);

248 249 250 251 252 253 254 255 256
#define devm_request_region(dev,start,n,name) \
	__devm_request_region(dev, &ioport_resource, (start), (n), (name))
#define devm_request_mem_region(dev,start,n,name) \
	__devm_request_region(dev, &iomem_resource, (start), (n), (name))

extern struct resource * __devm_request_region(struct device *dev,
				struct resource *parent, resource_size_t start,
				resource_size_t n, const char *name);

257
#define devm_release_region(dev, start, n) \
258
	__devm_release_region(dev, &ioport_resource, (start), (n))
259
#define devm_release_mem_region(dev, start, n) \
260 261 262 263
	__devm_release_region(dev, &iomem_resource, (start), (n))

extern void __devm_release_region(struct device *dev, struct resource *parent,
				  resource_size_t start, resource_size_t n);
264
extern int iomem_map_sanity_check(resource_size_t addr, unsigned long size);
265
extern int iomem_is_exclusive(u64 addr);
266

267 268 269
extern int
walk_system_ram_range(unsigned long start_pfn, unsigned long nr_pages,
		void *arg, int (*func)(unsigned long, unsigned long, void *));
270 271 272 273
extern int
walk_system_ram_res(u64 start, u64 end, void *arg,
		    int (*func)(u64, u64, void *));
extern int
274 275
walk_iomem_res_desc(unsigned long desc, unsigned long flags, u64 start, u64 end,
		    void *arg, int (*func)(u64, u64, void *));
276

277 278 279 280 281 282 283
/* True if any part of r1 overlaps r2 */
static inline bool resource_overlaps(struct resource *r1, struct resource *r2)
{
       return (r1->start <= r2->end && r1->end >= r2->start);
}


284
#endif /* __ASSEMBLY__ */
Linus Torvalds's avatar
Linus Torvalds committed
285
#endif	/* _LINUX_IOPORT_H */