1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*  Driver for the PPA3 parallel port SCSI HBA embedded in
3  * the Iomega ZIP drive
4  *
5  * (c) 1996     Grant R. Guenther  grant@torque.net
6  *              David Campbell
7  *
8  *      All comments to David.
9  */
10 
11 #ifndef _PPA_H
12 #define _PPA_H
13 
14 #define   PPA_VERSION   "2.07 (for Linux 2.4.x)"
15 
16 /*
17  * this driver has been hacked by Matteo Frigo (athena@theory.lcs.mit.edu)
18  * to support EPP and scatter-gather.                        [0.26-athena]
19  *
20  * additional hacks by David Campbell
21  * in response to this driver "mis-behaving" on his machine.
22  *      Fixed EPP to handle "software" changing of EPP port data direction.
23  *      Chased down EPP timeouts
24  *      Made this driver "kernel version friendly"           [0.28-athena]
25  *
26  * [ Stuff removed ]
27  *
28  * Corrected ppa.h for 2.1.x kernels (>=2.1.85)
29  * Modified "Nat Semi Kludge" for extended chipsets
30  *                                                      [1.41]
31  *
32  * Fixed id_probe for EPP 1.9 chipsets (misdetected as EPP 1.7)
33  *                                                      [1.42]
34  *
35  * Development solely for 2.1.x kernels from now on!
36  *                                                      [2.00]
37  *
38  * Hack and slash at the init code (EPP device check routine)
39  * Added INSANE option.
40  *                                                      [2.01]
41  *
42  * Patch applied to sync against the 2.1.x kernel code
43  * Included qboot_zip.sh
44  *                                                      [2.02]
45  *
46  * Cleaned up the mess left by someone else trying to fix the
47  * asm section to keep egcc happy. The asm section no longer
48  * exists, the nibble code is *almost* as fast as the asm code
49  * providing it is compiled with egcc.
50  *
51  * Other clean ups include the follow changes:
52  *    CONFIG_SCSI_PPA_HAVE_PEDANTIC => CONFIG_SCSI_IZIP_EPP16
53  *    added CONFIG_SCSI_IZIP_SLOW_CTR option
54  *                                                      [2.03]
55  *
56  * Use ppa_wait() to check for ready AND connected status bits
57  * Add ppa_wait() calls to ppa_completion()
58  *  by Peter Cherriman <pjc@ecs.soton.ac.uk> and
59  *     Tim Waugh <twaugh@redhat.com>
60  *							[2.04]
61  *
62  * Fix kernel panic on scsi timeout, 2000-08-18		[2.05]
63  *
64  * Avoid io_request_lock problems.
65  * John Cavan <johncavan@home.com>			[2.06]
66  *
67  * Busy wait for connected status bit in ppa_completion()
68  *  in order to cope with some hardware that has this bit low
69  *  for short periods of time.
70  * Add udelay() to ppa_select()
71  *  by Peter Cherriman <pjc@ecs.soton.ac.uk> and
72  *     Oleg Makarenko <omakarenko@cyberplat.ru>
73  *                                                      [2.07]
74  */
75 /* ------ END OF USER CONFIGURABLE PARAMETERS ----- */
76 
77 #include  <linux/stddef.h>
78 #include  <linux/module.h>
79 #include  <linux/kernel.h>
80 #include  <linux/ioport.h>
81 #include  <linux/delay.h>
82 #include  <linux/proc_fs.h>
83 #include  <linux/stat.h>
84 #include  <linux/blkdev.h>
85 #include  <linux/sched.h>
86 #include  <linux/interrupt.h>
87 
88 #include  <asm/io.h>
89 #include  <scsi/scsi_host.h>
90 /* batteries not included :-) */
91 
92 /*
93  * modes in which the driver can operate
94  */
95 #define   PPA_AUTODETECT        0	/* Autodetect mode                */
96 #define   PPA_NIBBLE            1	/* work in standard 4 bit mode    */
97 #define   PPA_PS2               2	/* PS/2 byte mode         */
98 #define   PPA_EPP_8             3	/* EPP mode, 8 bit                */
99 #define   PPA_EPP_16            4	/* EPP mode, 16 bit               */
100 #define   PPA_EPP_32            5	/* EPP mode, 32 bit               */
101 #define   PPA_UNKNOWN           6	/* Just in case...                */
102 
103 static char *PPA_MODE_STRING[] =
104 {
105     "Autodetect",
106     "SPP",
107     "PS/2",
108     "EPP 8 bit",
109     "EPP 16 bit",
110 #ifdef CONFIG_SCSI_IZIP_EPP16
111     "EPP 16 bit",
112 #else
113     "EPP 32 bit",
114 #endif
115     "Unknown"};
116 
117 /* other options */
118 #define PPA_BURST_SIZE	512	/* data burst size */
119 #define PPA_SELECT_TMO  5000	/* how long to wait for target ? */
120 #define PPA_SPIN_TMO    50000	/* ppa_wait loop limiter */
121 #define PPA_RECON_TMO   500	/* scsi reconnection loop limiter */
122 #define PPA_DEBUG	0	/* debugging option */
123 #define IN_EPP_MODE(x) (x == PPA_EPP_8 || x == PPA_EPP_16 || x == PPA_EPP_32)
124 
125 /* args to ppa_connect */
126 #define CONNECT_EPP_MAYBE 1
127 #define CONNECT_NORMAL  0
128 
129 #define r_dtr(x)        (unsigned char)inb((x))
130 #define r_str(x)        (unsigned char)inb((x)+1)
131 #define r_ctr(x)        (unsigned char)inb((x)+2)
132 #define r_epp(x)        (unsigned char)inb((x)+4)
133 #define r_fifo(x)       (unsigned char)inb((x)) /* x must be base_hi */
134 					/* On PCI is base+0x400 != base_hi */
135 #define r_ecr(x)        (unsigned char)inb((x)+0x2) /* x must be base_hi */
136 
137 #define w_dtr(x,y)      outb(y, (x))
138 #define w_str(x,y)      outb(y, (x)+1)
139 #define w_epp(x,y)      outb(y, (x)+4)
140 #define w_fifo(x,y)     outb(y, (x))	/* x must be base_hi */
141 #define w_ecr(x,y)      outb(y, (x)+0x2)/* x must be base_hi */
142 
143 #ifdef CONFIG_SCSI_IZIP_SLOW_CTR
144 #define w_ctr(x,y)      outb_p(y, (x)+2)
145 #else
146 #define w_ctr(x,y)      outb(y, (x)+2)
147 #endif
148 
149 static int ppa_engine(ppa_struct *, struct scsi_cmnd *);
150 
151 #endif				/* _PPA_H */
152