2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
4 * Copyright (c) 1997, 1998, 1999 Nicolas Souchu
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34 #define n(flags) (~(flags) & (flags))
37 * Parallel Port Chipset control bits.
43 #define IRQENABLE 0x10
46 #define nSTROBE n(STROBE)
47 #define nAUTOFEED n(AUTOFEED)
49 #define nSELECTIN n(SELECTIN)
53 * Parallel Port Chipset status bits.
63 #include <sys/queue.h>
66 * Parallel Port Bus sleep/wakeup queue.
68 #define PPBPRI (PZERO+8)
71 * Parallel Port Chipset mode masks.
72 * NIBBLE mode is supposed to be available under each other modes.
74 #define PPB_COMPATIBLE 0x0 /* Centronics compatible mode */
76 #define PPB_NIBBLE 0x1 /* reverse 4 bit mode */
77 #define PPB_PS2 0x2 /* PS/2 byte mode */
78 #define PPB_EPP 0x4 /* EPP mode, 32 bit */
79 #define PPB_ECP 0x8 /* ECP mode */
82 #define PPB_SPP PPB_NIBBLE|PPB_PS2
83 #define PPB_BYTE PPB_PS2
86 #define PPB_OPTIONS_MASK 0xf0
88 #define PPB_IS_EPP(mode) (mode & PPB_EPP)
89 #define PPB_IN_EPP_MODE(bus) (PPB_IS_EPP (ppb_get_mode (bus)))
90 #define PPB_IN_NIBBLE_MODE(bus) (ppb_get_mode (bus) & PPB_NIBBLE)
91 #define PPB_IN_PS2_MODE(bus) (ppb_get_mode (bus) & PPB_PS2)
94 * Structure to store status information.
99 unsigned int timeout:1;
100 unsigned int error:1;
101 unsigned int select:1;
102 unsigned int paper_end:1;
107 /* Parallel port bus I/O opcodes */
108 #define PPB_OUTSB_EPP 1
109 #define PPB_OUTSW_EPP 2
110 #define PPB_OUTSL_EPP 3
111 #define PPB_INSB_EPP 4
112 #define PPB_INSW_EPP 5
113 #define PPB_INSL_EPP 6
117 #define PPB_REPP_A 10
118 #define PPB_REPP_D 11
124 #define PPB_WEPP_A 17
125 #define PPB_WEPP_D 18
130 * How tsleep() is called in ppb_request_bus().
132 #define PPB_DONTWAIT 0
137 #define PPB_FOREVER -1
140 * Microsequence stuff.
142 #define PPB_MS_MAXLEN 64 /* XXX according to MS_INS_MASK */
143 #define PPB_MS_MAXARGS 3 /* according to MS_ARG_MASK */
145 /* maximum number of mode dependent
146 * submicrosequences for in/out operations
148 #define PPB_MAX_XFER 6
154 int (* f)(void *, char *);
157 struct ppb_microseq {
158 int opcode; /* microins. opcode */
159 union ppb_insarg arg[PPB_MS_MAXARGS]; /* arguments */
162 /* microseqences used for GET/PUT operations */
164 struct ppb_microseq *loop; /* the loop microsequence */
168 * Parallel Port Bus Device structure.
170 struct ppb_data; /* see below */
173 int valid; /* 1 if the struct is valid */
174 int mode; /* XXX chipset operating mode */
176 struct microseq *curpc; /* pc in curmsq */
177 struct microseq *curmsq; /* currently executed microseqence */
181 * List of IVARS available to ppb device drivers
183 #define PPBUS_IVAR_MODE 0
185 /* other fields are reserved to the ppbus internals */
189 const char *name; /* name of the device */
191 u_int flags; /* flags */
193 struct ppb_context ctx; /* context of the device */
195 /* mode dependent get msq. If NULL,
196 * IEEE1284 code is used */
198 get_xfer[PPB_MAX_XFER];
200 /* mode dependent put msq. If NULL,
201 * IEEE1284 code is used */
203 put_xfer[PPB_MAX_XFER];
205 driver_intr_t *intr_hook;
210 #define EPP_1_9 0x0 /* default */
213 /* Parallel Port Chipset IVARS */ /* elsewhere XXX */
214 #define PPC_IVAR_EPP_PROTO 0
215 #define PPC_IVAR_LOCK 1
216 #define PPC_IVAR_INTR_HANDLER 2
219 * Maximum size of the PnP info string
221 #define PPB_PnP_STRING_SIZE 256 /* XXX */
224 * Parallel Port Bus structure.
228 #define PPB_PnP_PRINTER 0
229 #define PPB_PnP_MODEM 1
230 #define PPB_PnP_NET 2
231 #define PPB_PnP_HDC 3
232 #define PPB_PnP_PCMCIA 4
233 #define PPB_PnP_MEDIA 5
234 #define PPB_PnP_FDC 6
235 #define PPB_PnP_PORTS 7
236 #define PPB_PnP_SCANNER 8
237 #define PPB_PnP_DIGICAM 9
238 #define PPB_PnP_UNKNOWN 10
239 int class_id; /* not a PnP device if class_id < 0 */
241 int state; /* current IEEE1284 state */
242 int error; /* last IEEE1284 error */
244 int mode; /* IEEE 1284-1994 mode
245 * NIBBLE, PS2, EPP or ECP */
247 device_t ppb_owner; /* device which owns the bus */
249 struct mtx *ppc_lock; /* lock of parent device */
250 struct resource *ppc_irq_res;
255 typedef int (*ppc_intr_handler)(void *);
257 extern int ppb_attach_device(device_t);
258 extern int ppb_request_bus(device_t, device_t, int);
259 extern int ppb_release_bus(device_t, device_t);
261 /* bus related functions */
262 extern void ppb_lock(device_t);
263 extern void ppb_unlock(device_t);
264 extern void _ppb_assert_locked(device_t, const char *, int);
265 extern void ppb_init_callout(device_t, struct callout *, int);
266 extern int ppb_sleep(device_t, void *, int, const char *, int);
267 extern int ppb_get_status(device_t, struct ppb_status *);
268 extern int ppb_poll_bus(device_t, int, uint8_t, uint8_t, int);
269 extern int ppb_reset_epp_timeout(device_t);
270 extern int ppb_ecp_sync(device_t);
271 extern int ppb_get_epp_protocol(device_t);
272 extern int ppb_set_mode(device_t, int); /* returns old mode */
273 extern int ppb_get_mode(device_t); /* returns current mode */
274 extern int ppb_write(device_t, char *, int, int);
277 #define ppb_assert_locked(dev) _ppb_assert_locked(dev, __FILE__, __LINE__)
279 #define ppb_assert_locked(dev)
283 #endif /* !__PPBCONF_H */