kernel-ark/include/linux/dio.h
Bjorn Helgaas e51c01b084 [PATCH] hp300: fix driver_register() return handling, remove dio_module_init()
Remove the assumption that driver_register() returns the number of devices
bound to the driver.  In fact, it returns zero for success or a negative
error value.

dio_module_init() used the device count to automatically unregister and
unload drivers that found no devices.  That might have worked at one time,
but has been broken for some time because dio_register_driver() returned
either a negative error or a positive count (never zero).  So it could only
unregister on failure, when it's not needed anyway.

This functionality could be resurrected in individual drivers by counting
devices in their .probe() methods.

Signed-off-by: Bjorn Helgaas <bjorn.helgaas@hp.com>
Cc: Philip Blundell <philb@gnu.org>
Cc: Jochen Friedrich <jochen@scram.de>
Cc: "Antonino A. Daplas" <adaplas@pol.net>
Cc: Jeff Garzik <jeff@garzik.org>
Signed-off-by: Andrew Morton <akpm@osdl.org>
Signed-off-by: Linus Torvalds <torvalds@osdl.org>
2006-03-25 08:22:53 -08:00

281 lines
11 KiB
C

/* header file for DIO boards for the HP300 architecture.
* Maybe this should handle DIO-II later?
* The general structure of this is vaguely based on how
* the Amiga port handles Zorro boards.
* Copyright (C) Peter Maydell 05/1998 <pmaydell@chiark.greenend.org.uk>
* Converted to driver model Jochen Friedrich <jochen@scram.de>
*
* The board IDs are from the NetBSD kernel, which for once provided
* helpful comments...
*
* This goes with drivers/dio/dio.c
*/
#ifndef _LINUX_DIO_H
#define _LINUX_DIO_H
/* The DIO boards in a system are distinguished by 'select codes' which
* range from 0-63 (DIO) and 132-255 (DIO-II).
* The DIO board with select code sc is located at physical address
* 0x600000 + sc * 0x10000
* So DIO cards cover [0x600000-0x800000); the areas [0x200000-0x400000) and
* [0x800000-0x1000000) are for additional space required by things
* like framebuffers. [0x400000-0x600000) is for miscellaneous internal I/O.
* On Linux, this is currently all mapped into the virtual address space
* at 0xf0000000 on bootup.
* DIO-II boards are at 0x1000000 + (sc - 132) * 0x400000
* which is address range [0x1000000-0x20000000) -- too big to map completely,
* so currently we just don't handle DIO-II boards. It wouldn't be hard to
* do with ioremap() though.
*/
#include <linux/device.h>
#ifdef __KERNEL__
#include <asm/hp300hw.h>
typedef __u16 dio_id;
/*
* DIO devices
*/
struct dio_dev {
struct dio_bus *bus;
dio_id id;
int scode;
struct dio_driver *driver; /* which driver has allocated this device */
struct device dev; /* Generic device interface */
u8 ipl;
char name[64];
struct resource resource;
};
#define to_dio_dev(n) container_of(n, struct dio_dev, dev)
/*
* DIO bus
*/
struct dio_bus {
struct list_head devices; /* list of devices on this bus */
unsigned int num_resources; /* number of resources */
struct resource resources[2]; /* address space routed to this bus */
struct device dev;
char name[10];
};
extern struct dio_bus dio_bus; /* Single DIO bus */
extern struct bus_type dio_bus_type;
/*
* DIO device IDs
*/
struct dio_device_id {
dio_id id; /* Device ID or DIO_WILDCARD */
unsigned long driver_data; /* Data private to the driver */
};
/*
* DIO device drivers
*/
struct dio_driver {
struct list_head node;
char *name;
const struct dio_device_id *id_table; /* NULL if wants all devices */
int (*probe)(struct dio_dev *z, const struct dio_device_id *id);
/* New device inserted */
void (*remove)(struct dio_dev *z); /* Device removed (NULL if not a hot-plug capable driver) */
struct device_driver driver;
};
#define to_dio_driver(drv) container_of(drv, struct dio_driver, driver)
/* DIO/DIO-II boards all have the following 8bit registers.
* These are offsets from the base of the device.
*/
#define DIO_IDOFF 0x01 /* primary device ID */
#define DIO_IPLOFF 0x03 /* interrupt priority level */
#define DIO_SECIDOFF 0x15 /* secondary device ID */
#define DIOII_SIZEOFF 0x101 /* device size, DIO-II only */
#define DIO_VIRADDRBASE 0xf0000000UL /* vir addr where IOspace is mapped */
#define DIO_BASE 0x600000 /* start of DIO space */
#define DIO_END 0x1000000 /* end of DIO space */
#define DIO_DEVSIZE 0x10000 /* size of a DIO device */
#define DIOII_BASE 0x01000000 /* start of DIO-II space */
#define DIOII_END 0x20000000 /* end of DIO-II space */
#define DIOII_DEVSIZE 0x00400000 /* size of a DIO-II device */
/* Highest valid select code. If we add DIO-II support this should become
* 256 for everything except HP320, which only has DIO.
*/
#define DIO_SCMAX (hp300_model == HP_320 ? 32 : 256)
#define DIOII_SCBASE 132 /* lowest DIO-II select code */
#define DIO_SCINHOLE(scode) (((scode) >= 32) && ((scode) < DIOII_SCBASE))
#define DIO_ISDIOII(scode) ((scode) >= 132 && (scode) < 256)
/* macros to read device IDs, given base address */
#define DIO_ID(baseaddr) in_8((baseaddr) + DIO_IDOFF)
#define DIO_SECID(baseaddr) in_8((baseaddr) + DIO_SECIDOFF)
/* extract the interrupt level */
#define DIO_IPL(baseaddr) (((in_8((baseaddr) + DIO_IPLOFF) >> 4) & 0x03) + 3)
/* find the size of a DIO-II board's address space.
* DIO boards are all fixed length.
*/
#define DIOII_SIZE(baseaddr) ((in_8((baseaddr) + DIOII_SIZEOFF) + 1) * 0x100000)
/* general purpose macro for both DIO and DIO-II */
#define DIO_SIZE(scode, base) (DIO_ISDIOII((scode)) ? DIOII_SIZE((base)) : DIO_DEVSIZE)
/* The hardware has primary and secondary IDs; we encode these in a single
* int as PRIMARY ID & (SECONDARY ID << 8).
* In practice this is only important for framebuffers,
* and everybody else just sets ID fields equal to the DIO_ID_FOO value.
*/
#define DIO_ENCODE_ID(pr,sec) ((((int)sec & 0xff) << 8) | ((int)pr & 0xff))
/* macro to determine whether a given primary ID requires a secondary ID byte */
#define DIO_NEEDSSECID(id) ((id) == DIO_ID_FBUFFER)
#define DIO_WILDCARD 0xff
/* Now a whole slew of macros giving device IDs and descriptive strings: */
#define DIO_ID_DCA0 0x02 /* 98644A serial */
#define DIO_DESC_DCA0 "98644A DCA0 serial"
#define DIO_ID_DCA0REM 0x82 /* 98644A serial */
#define DIO_DESC_DCA0REM "98644A DCA0REM serial"
#define DIO_ID_DCA1 0x42 /* 98644A serial */
#define DIO_DESC_DCA1 "98644A DCA1 serial"
#define DIO_ID_DCA1REM 0xc2 /* 98644A serial */
#define DIO_DESC_DCA1REM "98644A DCA1REM serial"
#define DIO_ID_DCM 0x05 /* 98642A serial MUX */
#define DIO_DESC_DCM "98642A DCM serial MUX"
#define DIO_ID_DCMREM 0x85 /* 98642A serial MUX */
#define DIO_DESC_DCMREM "98642A DCMREM serial MUX"
#define DIO_ID_LAN 0x15 /* 98643A LAN */
#define DIO_DESC_LAN "98643A LANCE ethernet"
#define DIO_ID_FHPIB 0x08 /* 98625A/98625B fast HP-IB */
#define DIO_DESC_FHPIB "98625A/98625B fast HPIB"
#define DIO_ID_NHPIB 0x01 /* 98624A HP-IB (normal ie slow) */
#define DIO_DESC_NHPIB "98624A HPIB"
#define DIO_ID_SCSI0 0x07 /* 98265A SCSI */
#define DIO_DESC_SCSI0 "98265A SCSI0"
#define DIO_ID_SCSI1 0x27 /* ditto */
#define DIO_DESC_SCSI1 "98265A SCSI1"
#define DIO_ID_SCSI2 0x47 /* ditto */
#define DIO_DESC_SCSI2 "98265A SCSI2"
#define DIO_ID_SCSI3 0x67 /* ditto */
#define DIO_DESC_SCSI3 "98265A SCSI3"
#define DIO_ID_FBUFFER 0x39 /* framebuffer: flavour is distinguished by secondary ID */
#define DIO_DESC_FBUFFER "bitmapped display"
/* the NetBSD kernel source is a bit unsure as to what these next IDs actually do :-> */
#define DIO_ID_MISC0 0x03 /* 98622A */
#define DIO_DESC_MISC0 "98622A"
#define DIO_ID_MISC1 0x04 /* 98623A */
#define DIO_DESC_MISC1 "98623A"
#define DIO_ID_PARALLEL 0x06 /* internal parallel */
#define DIO_DESC_PARALLEL "internal parallel"
#define DIO_ID_MISC2 0x09 /* 98287A keyboard */
#define DIO_DESC_MISC2 "98287A keyboard"
#define DIO_ID_MISC3 0x0a /* HP98635A FP accelerator */
#define DIO_DESC_MISC3 "HP98635A FP accelerator"
#define DIO_ID_MISC4 0x0b /* timer */
#define DIO_DESC_MISC4 "timer"
#define DIO_ID_MISC5 0x12 /* 98640A */
#define DIO_DESC_MISC5 "98640A"
#define DIO_ID_MISC6 0x16 /* 98659A */
#define DIO_DESC_MISC6 "98659A"
#define DIO_ID_MISC7 0x19 /* 237 display */
#define DIO_DESC_MISC7 "237 display"
#define DIO_ID_MISC8 0x1a /* quad-wide card */
#define DIO_DESC_MISC8 "quad-wide card"
#define DIO_ID_MISC9 0x1b /* 98253A */
#define DIO_DESC_MISC9 "98253A"
#define DIO_ID_MISC10 0x1c /* 98627A */
#define DIO_DESC_MISC10 "98253A"
#define DIO_ID_MISC11 0x1d /* 98633A */
#define DIO_DESC_MISC11 "98633A"
#define DIO_ID_MISC12 0x1e /* 98259A */
#define DIO_DESC_MISC12 "98259A"
#define DIO_ID_MISC13 0x1f /* 8741 */
#define DIO_DESC_MISC13 "8741"
#define DIO_ID_VME 0x31 /* 98577A VME adapter */
#define DIO_DESC_VME "98577A VME adapter"
#define DIO_ID_DCL 0x34 /* 98628A serial */
#define DIO_DESC_DCL "98628A DCL serial"
#define DIO_ID_DCLREM 0xb4 /* 98628A serial */
#define DIO_DESC_DCLREM "98628A DCLREM serial"
/* These are the secondary IDs for the framebuffers */
#define DIO_ID2_GATORBOX 0x01 /* 98700/98710 "gatorbox" */
#define DIO_DESC2_GATORBOX "98700/98710 \"gatorbox\" display"
#define DIO_ID2_TOPCAT 0x02 /* 98544/98545/98547 "topcat" */
#define DIO_DESC2_TOPCAT "98544/98545/98547 \"topcat\" display"
#define DIO_ID2_RENAISSANCE 0x04 /* 98720/98721 "renaissance" */
#define DIO_DESC2_RENAISSANCE "98720/98721 \"renaissance\" display"
#define DIO_ID2_LRCATSEYE 0x05 /* lowres "catseye" */
#define DIO_DESC2_LRCATSEYE "low-res catseye display"
#define DIO_ID2_HRCCATSEYE 0x06 /* highres colour "catseye" */
#define DIO_DESC2_HRCCATSEYE "high-res color catseye display"
#define DIO_ID2_HRMCATSEYE 0x07 /* highres mono "catseye" */
#define DIO_DESC2_HRMCATSEYE "high-res mono catseye display"
#define DIO_ID2_DAVINCI 0x08 /* 98730/98731 "davinci" */
#define DIO_DESC2_DAVINCI "98730/98731 \"davinci\" display"
#define DIO_ID2_XXXCATSEYE 0x09 /* "catseye" */
#define DIO_DESC2_XXXCATSEYE "catseye display"
#define DIO_ID2_HYPERION 0x0e /* A1096A "hyperion" */
#define DIO_DESC2_HYPERION "A1096A \"hyperion\" display"
#define DIO_ID2_XGENESIS 0x0b /* "x-genesis"; no NetBSD support */
#define DIO_DESC2_XGENESIS "\"x-genesis\" display"
#define DIO_ID2_TIGER 0x0c /* "tiger"; no NetBSD support */
#define DIO_DESC2_TIGER "\"tiger\" display"
#define DIO_ID2_YGENESIS 0x0d /* "y-genesis"; no NetBSD support */
#define DIO_DESC2_YGENESIS "\"y-genesis\" display"
/* if you add new IDs then you should tell dio.c about them so it can
* identify them...
*/
extern int dio_find(int deviceid);
extern unsigned long dio_scodetophysaddr(int scode);
extern void dio_create_sysfs_dev_files(struct dio_dev *);
/* New-style probing */
extern int dio_register_driver(struct dio_driver *);
extern void dio_unregister_driver(struct dio_driver *);
extern const struct dio_device_id *dio_match_device(const struct dio_device_id *ids, const struct dio_dev *z);
static inline struct dio_driver *dio_dev_driver(const struct dio_dev *d)
{
return d->driver;
}
#define dio_resource_start(d) ((d)->resource.start)
#define dio_resource_end(d) ((d)->resource.end)
#define dio_resource_len(d) ((d)->resource.end-(d)->resource.start+1)
#define dio_resource_flags(d) ((d)->resource.flags)
#define dio_request_device(d, name) \
request_mem_region(dio_resource_start(d), dio_resource_len(d), name)
#define dio_release_device(d) \
release_mem_region(dio_resource_start(d), dio_resource_len(d))
/* Similar to the helpers above, these manipulate per-dio_dev
* driver-specific data. They are really just a wrapper around
* the generic device structure functions of these calls.
*/
static inline void *dio_get_drvdata (struct dio_dev *d)
{
return dev_get_drvdata(&d->dev);
}
static inline void dio_set_drvdata (struct dio_dev *d, void *data)
{
dev_set_drvdata(&d->dev, data);
}
#endif /* __KERNEL__ */
#endif /* ndef _LINUX_DIO_H */