1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
|
/* $Id: parport.h,v 1.2.6.3 1997/04/16 21:21:03 phil Exp $ */
#ifndef _PARPORT_H_
#define _PARPORT_H_
#include <asm/system.h>
#include <asm/ptrace.h>
#include <linux/proc_fs.h>
/* Maximum of 8 ports per machine */
#define PARPORT_MAX 8
/* Magic numbers */
#define PARPORT_IRQ_NONE -1
#define PARPORT_DMA_NONE -1
#define PARPORT_DISABLE -2
/* Type classes for Plug-and-Play probe */
typedef enum {
PARPORT_CLASS_LEGACY = 0, /* Non-IEEE1284 device */
PARPORT_CLASS_PRINTER,
PARPORT_CLASS_MODEM,
PARPORT_CLASS_NET,
PARPORT_CLASS_HDC, /* Hard disk controller */
PARPORT_CLASS_PCMCIA,
PARPORT_CLASS_MEDIA, /* Multimedia device */
PARPORT_CLASS_FDC, /* Floppy disk controller */
PARPORT_CLASS_PORTS,
PARPORT_CLASS_SCANNER,
PARPORT_CLASS_DIGCAM,
PARPORT_CLASS_OTHER, /* Anything else */
PARPORT_CLASS_UNSPEC /* No CLS field in ID */
} parport_device_class;
struct parport_device_info {
parport_device_class class;
char *mfr;
char *model;
char *cmdset;
char *description;
};
/* Definitions for parallel port sharing */
/* Forward declare some stuff so we can use mutually circular structures */
struct ppd;
struct parport;
/* Each device can have two callback functions:
* 1) a preemption function, called by the resource manager to request
* that the driver relinquish control of the port. The driver should
* return zero if it agrees to release the port, and nonzero if it
* refuses. Do not call parport_release() - the kernel will do this
* implicitly.
*
* 2) a wake-up function, called by the resource manager to tell drivers
* that the port is available to be claimed. If a driver wants to use
* the port, it should call parport_claim() here. The return value from
* this function is ignored.
*/
typedef int (*callback_func) (void *);
/* This is an ordinary kernel IRQ handler routine.
* The dev_id field (void *) will point the the port structure
* associated with the interrupt request (to allow IRQ sharing)
* Please make code IRQ sharing as this function may be called
* when it isn't meant for you...
*/
typedef void (*irq_handler_func) (int, void *, struct pt_regs *);
/* A parallel port device */
struct ppd {
char *name;
struct parport *port; /* The port this is associated with */
callback_func preempt; /* preemption function */
callback_func wakeup; /* kick function */
void *private;
irq_handler_func irq_func;
int flags;
unsigned char ctr; /* SPP CTR register */
unsigned char ecr; /* ECP ECR register */
struct ppd *next;
struct ppd *prev;
};
struct parport_dir{
struct proc_dir_entry *entry; /* Directory /proc/parport/X */
struct proc_dir_entry *irq; /* IRQ entry /proc/parport/X/irq */
struct proc_dir_entry *devices; /* /proc/parport/X/devices */
struct proc_dir_entry *hardware; /* /proc/parport/X/hardware */
char name[4]; /* /proc/parport/"XXXX" */
};
/* A parallel port */
struct parport {
unsigned int base; /* base address */
unsigned int size; /* IO extent */
char *name;
int irq; /* interrupt (or -1 for none) */
int dma;
unsigned int modes;
struct ppd *devices;
struct ppd *cad; /* port owner */
struct ppd *lurker;
unsigned int ctr; /* SPP CTR register */
unsigned int ecr; /* ECP ECR register */
struct parport *next;
unsigned int flags;
struct parport_dir pdir;
struct parport_device_info probe_info;
int speed; /* Max Write in Bytes/s */
};
/* parport_register_port registers a new parallel port at the given address (if
* one does not already exist) and returns a pointer to it. This entails
* claiming the I/O region, IRQ and DMA.
* NULL is returned if initialisation fails.
*/
struct parport *parport_register_port(unsigned long base, int irq, int dma);
/* parport_in_use returns nonzero if there are devices attached to a port. */
#define parport_in_use(x) ((x)->devices != NULL)
/* parport_destroy blows away a parallel port. This fails if any devices are
* registered.
*/
void parport_destroy(struct parport *);
/* parport_enumerate returns a pointer to the linked list of all the ports
* in this machine.
*/
struct parport *parport_enumerate(void);
/* parport_register_device declares that a device is connected to a port, and
* tells the kernel all it needs to know.
* pf is the preemption function (may be NULL for a transient driver)
* kf is the wake-up function (may be NULL for a transient driver)
* irq_func is the interrupt handler (may be NULL for no interrupts)
* Only one lurking driver can be used on a given port.
* handle is a user pointer that gets handed to callback functions.
*/
struct ppd *parport_register_device(struct parport *port, const char *name,
callback_func pf, callback_func kf,
irq_handler_func irq_func, int flags,
void *handle);
/* parport_deregister causes the kernel to forget about a device */
void parport_unregister_device(struct ppd *dev);
/* parport_claim tries to gain ownership of the port for a particular driver.
* This may fail (return non-zero) if another driver is busy. If this
* driver has registered an interrupt handler, it will be enabled.
*/
int parport_claim(struct ppd *dev);
/* parport_release reverses a previous parport_claim. This can never fail,
* though the effects are undefined (except that they are bad) if you didn't
* previously own the port. Once you have released the port you should make
* sure that neither your code nor the hardware on the port tries to initiate
* any communication without first re-claiming the port.
* If you mess with the port state (enabling ECP for example) you should
* clean up before releasing the port.
*/
void parport_release(struct ppd *dev);
/* The "modes" entry in parport is a bit field representing the following
* modes.
* Note that LP_ECPEPP is for the SMC EPP+ECP mode which is NOT
* 100% compatible with EPP.
*/
#define PARPORT_MODE_SPP 0x0001
#define PARPORT_MODE_PS2 0x0002
#define PARPORT_MODE_EPP 0x0004
#define PARPORT_MODE_ECP 0x0008
#define PARPORT_MODE_ECPEPP 0x0010
#define PARPORT_MODE_ECR 0x0020 /* ECR Register Exists */
#define PARPORT_MODE_ECPPS2 0x0040
/* Flags used to identify what a device does
*/
#define PARPORT_DEV_TRAN 0x0000
#define PARPORT_DEV_LURK 0x0001
#define PARPORT_FLAG_COMA 1
extern int parport_ieee1284_nibble_mode_ok(struct parport *, unsigned char);
extern int parport_wait_peripheral(struct parport *, unsigned char, unsigned
char);
/* Prototypes from parport_procfs */
extern int parport_proc_init(void);
extern int parport_proc_cleanup(void);
extern int parport_proc_register(struct parport *pp);
extern int parport_proc_unregister(struct parport *pp);
/* Prototypes from parport_ksyms.c */
extern void dec_parport_count(void);
extern void inc_parport_count(void);
extern int parport_probe(struct parport *port, char *buffer, int len);
extern void parport_probe_one(struct parport *port);
/* Primitive port access functions */
extern inline void parport_w_ctrl(struct parport *port, int val)
{
outb(val, port->base+2);
}
extern inline int parport_r_ctrl(struct parport *port)
{
return inb(port->base+2);
}
extern inline void parport_w_data(struct parport *port, int val)
{
outb(val, port->base);
}
extern inline int parport_r_data(struct parport *port)
{
return inb(port->base);
}
extern inline int parport_r_status(struct parport *port)
{
return inb(port->base+1);
}
#endif /* _PARPORT_H_ */
|
