[PATCH] Add section on function return values to CodingStyle
[linux-2.6/mini2440.git] / drivers / scsi / imm.h
blobece936ac29c731d3cc4d0773ea462386f4a8a19b
2 /* Driver for the Iomega MatchMaker parallel port SCSI HBA embedded in
3 * the Iomega ZIP Plus drive
4 *
5 * (c) 1998 David Campbell
7 * Please note that I live in Perth, Western Australia. GMT+0800
8 */
10 #ifndef _IMM_H
11 #define _IMM_H
13 #define IMM_VERSION "2.05 (for Linux 2.4.0)"
15 /*
16 * 10 Apr 1998 (Good Friday) - Received EN144302 by email from Iomega.
17 * Scarry thing is the level of support from one of their managers.
18 * The onus is now on us (the developers) to shut up and start coding.
19 * 11Apr98 [ 0.10 ]
21 * --- SNIP ---
23 * It manages to find the drive which is a good start. Writing data during
24 * data phase is known to be broken (due to requirements of two byte writes).
25 * Removing "Phase" debug messages.
27 * PS: Took four hours of coding after I bought a drive.
28 * ANZAC Day (Aus "War Veterans Holiday") 25Apr98 [ 0.14 ]
30 * Ten minutes later after a few fixes.... (LITERALLY!!!)
31 * Have mounted disk, copied file, dismounted disk, remount disk, diff file
32 * ----- It actually works!!! -----
33 * 25Apr98 [ 0.15 ]
35 * Twenty minutes of mucking around, rearanged the IEEE negotiate mechanism.
36 * Now have byte mode working (only EPP and ECP to go now... :=)
37 * 26Apr98 [ 0.16 ]
39 * Thirty minutes of further coding results in EPP working on my machine.
40 * 27Apr98 [ 0.17 ]
42 * Due to work commitments and inability to get a "true" ECP mode functioning
43 * I have decided to code the parport support into imm.
44 * 09Jun98 [ 0.18 ]
46 * Driver is now out of beta testing.
47 * Support for parport has been added.
48 * Now distributed with the ppa driver.
49 * 12Jun98 [ 2.00 ]
51 * Err.. It appears that imm-2.00 was broken....
52 * 18Jun98 [ 2.01 ]
54 * Patch applied to sync this against the Linux 2.1.x kernel code
55 * Included qboot_zip.sh
56 * 21Jun98 [ 2.02 ]
58 * Other clean ups include the follow changes:
59 * CONFIG_SCSI_PPA_HAVE_PEDANTIC => CONFIG_SCSI_IZIP_EPP16
60 * added CONFIG_SCSI_IZIP_SLOW_CTR option
61 * [2.03]
62 * Fix kernel panic on scsi timeout. 20Aug00 [2.04]
64 * Avoid io_request_lock problems.
65 * John Cavan <johncavan@home.com> 16Nov00 [2.05]
67 /* ------ END OF USER CONFIGURABLE PARAMETERS ----- */
69 #include <linux/config.h>
70 #include <linux/stddef.h>
71 #include <linux/module.h>
72 #include <linux/kernel.h>
73 #include <linux/ioport.h>
74 #include <linux/delay.h>
75 #include <linux/proc_fs.h>
76 #include <linux/stat.h>
77 #include <linux/blkdev.h>
78 #include <linux/sched.h>
79 #include <linux/interrupt.h>
81 #include <asm/io.h>
82 #include <scsi/scsi_host.h>
83 /* batteries not included :-) */
86 * modes in which the driver can operate
88 #define IMM_AUTODETECT 0 /* Autodetect mode */
89 #define IMM_NIBBLE 1 /* work in standard 4 bit mode */
90 #define IMM_PS2 2 /* PS/2 byte mode */
91 #define IMM_EPP_8 3 /* EPP mode, 8 bit */
92 #define IMM_EPP_16 4 /* EPP mode, 16 bit */
93 #define IMM_EPP_32 5 /* EPP mode, 32 bit */
94 #define IMM_UNKNOWN 6 /* Just in case... */
96 static char *IMM_MODE_STRING[] =
98 [IMM_AUTODETECT] = "Autodetect",
99 [IMM_NIBBLE] = "SPP",
100 [IMM_PS2] = "PS/2",
101 [IMM_EPP_8] = "EPP 8 bit",
102 [IMM_EPP_16] = "EPP 16 bit",
103 #ifdef CONFIG_SCSI_IZIP_EPP16
104 [IMM_EPP_32] = "EPP 16 bit",
105 #else
106 [IMM_EPP_32] = "EPP 32 bit",
107 #endif
108 [IMM_UNKNOWN] = "Unknown",
111 /* other options */
112 #define IMM_BURST_SIZE 512 /* data burst size */
113 #define IMM_SELECT_TMO 500 /* 500 how long to wait for target ? */
114 #define IMM_SPIN_TMO 5000 /* 50000 imm_wait loop limiter */
115 #define IMM_DEBUG 0 /* debugging option */
116 #define IN_EPP_MODE(x) (x == IMM_EPP_8 || x == IMM_EPP_16 || x == IMM_EPP_32)
118 /* args to imm_connect */
119 #define CONNECT_EPP_MAYBE 1
120 #define CONNECT_NORMAL 0
122 #define r_dtr(x) (unsigned char)inb((x))
123 #define r_str(x) (unsigned char)inb((x)+1)
124 #define r_ctr(x) (unsigned char)inb((x)+2)
125 #define r_epp(x) (unsigned char)inb((x)+4)
126 #define r_fifo(x) (unsigned char)inb((x)) /* x must be base_hi */
127 /* On PCI is: base+0x400 != base_hi */
128 #define r_ecr(x) (unsigned char)inb((x)+2) /* x must be base_hi */
130 #define w_dtr(x,y) outb(y, (x))
131 #define w_str(x,y) outb(y, (x)+1)
132 #define w_epp(x,y) outb(y, (x)+4)
133 #define w_fifo(x,y) outb(y, (x)) /* x must be base_hi */
134 #define w_ecr(x,y) outb(y, (x)+0x2) /* x must be base_hi */
136 #ifdef CONFIG_SCSI_IZIP_SLOW_CTR
137 #define w_ctr(x,y) outb_p(y, (x)+2)
138 #else
139 #define w_ctr(x,y) outb(y, (x)+2)
140 #endif
142 static int imm_engine(imm_struct *, struct scsi_cmnd *);
144 #endif /* _IMM_H */