Details | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
422 | giacomo | 1 | #ifndef _QIC117_H |
2 | #define _QIC117_H |
||
3 | |||
4 | /* |
||
5 | * Copyright (C) 1993-1996 Bas Laarhoven, |
||
6 | * (C) 1997 Claus-Justus Heine. |
||
7 | |||
8 | This program is free software; you can redistribute it and/or modify |
||
9 | it under the terms of the GNU General Public License as published by |
||
10 | the Free Software Foundation; either version 2, or (at your option) |
||
11 | any later version. |
||
12 | |||
13 | This program is distributed in the hope that it will be useful, |
||
14 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
||
15 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
||
16 | GNU General Public License for more details. |
||
17 | |||
18 | You should have received a copy of the GNU General Public License |
||
19 | along with this program; see the file COPYING. If not, write to |
||
20 | the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. |
||
21 | |||
22 | * |
||
23 | * $Source: /home/fabio/w/shark/sharkcvs/CVSROOT/shark/drivers/linuxc26/include/linux/qic117.h,v $ |
||
24 | * $Revision: 1.1 $ |
||
25 | * $Date: 2004-01-28 15:26:24 $ |
||
26 | * |
||
27 | * This file contains QIC-117 spec. related definitions for the |
||
28 | * QIC-40/80/3010/3020 floppy-tape driver "ftape" for Linux. |
||
29 | * |
||
30 | * These data were taken from the Quarter-Inch Cartridge |
||
31 | * Drive Standards, Inc. document titled: |
||
32 | * `Common Command Set Interface Specification for Flexible |
||
33 | * Disk Controller Based Minicartridge Tape Drives' |
||
34 | * document QIC-117 Revision J, 28 Aug 96. |
||
35 | * For more information, contact: |
||
36 | * Quarter-Inch Cartridge Drive Standards, Inc. |
||
37 | * 311 East Carrillo Street |
||
38 | * Santa Barbara, California 93101 |
||
39 | * Telephone (805) 963-3853 |
||
40 | * Fax (805) 962-1541 |
||
41 | * WWW http://www.qic.org |
||
42 | * |
||
43 | * Current QIC standard revisions (of interest) are: |
||
44 | * QIC-40-MC, Rev. M, 2 Sep 92. |
||
45 | * QIC-80-MC, Rev. N, 20 Mar 96. |
||
46 | * QIC-80-MC, Rev. K, 15 Dec 94. |
||
47 | * QIC-113, Rev. G, 15 Jun 95. |
||
48 | * QIC-117, Rev. J, 28 Aug 96. |
||
49 | * QIC-122, Rev. B, 6 Mar 91. |
||
50 | * QIC-130, Rev. C, 2 Sep 92. |
||
51 | * QIC-3010-MC, Rev. F, 14 Jun 95. |
||
52 | * QIC-3020-MC, Rev. G, 31 Aug 95. |
||
53 | * QIC-CRF3, Rev. B, 15 Jun 95. |
||
54 | * */ |
||
55 | |||
56 | /* |
||
57 | * QIC-117 common command set rev. J. |
||
58 | * These commands are sent to the tape unit |
||
59 | * as number of pulses over the step line. |
||
60 | */ |
||
61 | |||
62 | typedef enum { |
||
63 | QIC_NO_COMMAND = 0, |
||
64 | QIC_RESET = 1, |
||
65 | QIC_REPORT_NEXT_BIT = 2, |
||
66 | QIC_PAUSE = 3, |
||
67 | QIC_MICRO_STEP_PAUSE = 4, |
||
68 | QIC_ALTERNATE_TIMEOUT = 5, |
||
69 | QIC_REPORT_DRIVE_STATUS = 6, |
||
70 | QIC_REPORT_ERROR_CODE = 7, |
||
71 | QIC_REPORT_DRIVE_CONFIGURATION = 8, |
||
72 | QIC_REPORT_ROM_VERSION = 9, |
||
73 | QIC_LOGICAL_FORWARD = 10, |
||
74 | QIC_PHYSICAL_REVERSE = 11, |
||
75 | QIC_PHYSICAL_FORWARD = 12, |
||
76 | QIC_SEEK_HEAD_TO_TRACK = 13, |
||
77 | QIC_SEEK_LOAD_POINT = 14, |
||
78 | QIC_ENTER_FORMAT_MODE = 15, |
||
79 | QIC_WRITE_REFERENCE_BURST = 16, |
||
80 | QIC_ENTER_VERIFY_MODE = 17, |
||
81 | QIC_STOP_TAPE = 18, |
||
82 | /* commands 19-20: reserved */ |
||
83 | QIC_MICRO_STEP_HEAD_UP = 21, |
||
84 | QIC_MICRO_STEP_HEAD_DOWN = 22, |
||
85 | QIC_SOFT_SELECT = 23, |
||
86 | QIC_SOFT_DESELECT = 24, |
||
87 | QIC_SKIP_REVERSE = 25, |
||
88 | QIC_SKIP_FORWARD = 26, |
||
89 | QIC_SELECT_RATE = 27, |
||
90 | /* command 27, in ccs2: Select Rate or Format */ |
||
91 | QIC_ENTER_DIAGNOSTIC_1 = 28, |
||
92 | QIC_ENTER_DIAGNOSTIC_2 = 29, |
||
93 | QIC_ENTER_PRIMARY_MODE = 30, |
||
94 | /* command 31: vendor unique */ |
||
95 | QIC_REPORT_VENDOR_ID = 32, |
||
96 | QIC_REPORT_TAPE_STATUS = 33, |
||
97 | QIC_SKIP_EXTENDED_REVERSE = 34, |
||
98 | QIC_SKIP_EXTENDED_FORWARD = 35, |
||
99 | QIC_CALIBRATE_TAPE_LENGTH = 36, |
||
100 | QIC_REPORT_FORMAT_SEGMENTS = 37, |
||
101 | QIC_SET_FORMAT_SEGMENTS = 38, |
||
102 | /* commands 39-45: reserved */ |
||
103 | QIC_PHANTOM_SELECT = 46, |
||
104 | QIC_PHANTOM_DESELECT = 47 |
||
105 | } qic117_cmd_t; |
||
106 | |||
107 | typedef enum { |
||
108 | discretional = 0, required, ccs1, ccs2 |
||
109 | } qic_compatibility; |
||
110 | |||
111 | typedef enum { |
||
112 | unused, mode, motion, report |
||
113 | } command_types; |
||
114 | |||
115 | struct qic117_command_table { |
||
116 | char *name; |
||
117 | __u8 mask; |
||
118 | __u8 state; |
||
119 | __u8 cmd_type; |
||
120 | __u8 non_intr; |
||
121 | __u8 level; |
||
122 | }; |
||
123 | |||
124 | #define QIC117_COMMANDS {\ |
||
125 | /* command mask state cmd_type */\ |
||
126 | /* | name | | | non_intr */\ |
||
127 | /* | | | | | | level */\ |
||
128 | /* 0*/ {NULL, 0x00, 0x00, mode, 0, discretional},\ |
||
129 | /* 1*/ {"soft reset", 0x00, 0x00, motion, 1, required},\ |
||
130 | /* 2*/ {"report next bit", 0x00, 0x00, report, 0, required},\ |
||
131 | /* 3*/ {"pause", 0x36, 0x24, motion, 1, required},\ |
||
132 | /* 4*/ {"micro step pause", 0x36, 0x24, motion, 1, required},\ |
||
133 | /* 5*/ {"alternate command timeout", 0x00, 0x00, mode, 0, required},\ |
||
134 | /* 6*/ {"report drive status", 0x00, 0x00, report, 0, required},\ |
||
135 | /* 7*/ {"report error code", 0x01, 0x01, report, 0, required},\ |
||
136 | /* 8*/ {"report drive configuration",0x00, 0x00, report, 0, required},\ |
||
137 | /* 9*/ {"report rom version", 0x00, 0x00, report, 0, required},\ |
||
138 | /*10*/ {"logical forward", 0x37, 0x25, motion, 0, required},\ |
||
139 | /*11*/ {"physical reverse", 0x17, 0x05, motion, 0, required},\ |
||
140 | /*12*/ {"physical forward", 0x17, 0x05, motion, 0, required},\ |
||
141 | /*13*/ {"seek head to track", 0x37, 0x25, motion, 0, required},\ |
||
142 | /*14*/ {"seek load point", 0x17, 0x05, motion, 1, required},\ |
||
143 | /*15*/ {"enter format mode", 0x1f, 0x05, mode, 0, required},\ |
||
144 | /*16*/ {"write reference burst", 0x1f, 0x05, motion, 1, required},\ |
||
145 | /*17*/ {"enter verify mode", 0x37, 0x25, mode, 0, required},\ |
||
146 | /*18*/ {"stop tape", 0x00, 0x00, motion, 1, required},\ |
||
147 | /*19*/ {"reserved (19)", 0x00, 0x00, unused, 0, discretional},\ |
||
148 | /*20*/ {"reserved (20)", 0x00, 0x00, unused, 0, discretional},\ |
||
149 | /*21*/ {"micro step head up", 0x02, 0x00, motion, 0, required},\ |
||
150 | /*22*/ {"micro step head down", 0x02, 0x00, motion, 0, required},\ |
||
151 | /*23*/ {"soft select", 0x00, 0x00, mode, 0, discretional},\ |
||
152 | /*24*/ {"soft deselect", 0x00, 0x00, mode, 0, discretional},\ |
||
153 | /*25*/ {"skip segments reverse", 0x36, 0x24, motion, 1, required},\ |
||
154 | /*26*/ {"skip segments forward", 0x36, 0x24, motion, 1, required},\ |
||
155 | /*27*/ {"select rate or format", 0x03, 0x01, mode, 0, required /* [ccs2] */},\ |
||
156 | /*28*/ {"enter diag mode 1", 0x00, 0x00, mode, 0, discretional},\ |
||
157 | /*29*/ {"enter diag mode 2", 0x00, 0x00, mode, 0, discretional},\ |
||
158 | /*30*/ {"enter primary mode", 0x00, 0x00, mode, 0, required},\ |
||
159 | /*31*/ {"vendor unique (31)", 0x00, 0x00, unused, 0, discretional},\ |
||
160 | /*32*/ {"report vendor id", 0x00, 0x00, report, 0, required},\ |
||
161 | /*33*/ {"report tape status", 0x04, 0x04, report, 0, ccs1},\ |
||
162 | /*34*/ {"skip extended reverse", 0x36, 0x24, motion, 1, ccs1},\ |
||
163 | /*35*/ {"skip extended forward", 0x36, 0x24, motion, 1, ccs1},\ |
||
164 | /*36*/ {"calibrate tape length", 0x17, 0x05, motion, 1, ccs2},\ |
||
165 | /*37*/ {"report format segments", 0x17, 0x05, report, 0, ccs2},\ |
||
166 | /*38*/ {"set format segments", 0x17, 0x05, mode, 0, ccs2},\ |
||
167 | /*39*/ {"reserved (39)", 0x00, 0x00, unused, 0, discretional},\ |
||
168 | /*40*/ {"vendor unique (40)", 0x00, 0x00, unused, 0, discretional},\ |
||
169 | /*41*/ {"vendor unique (41)", 0x00, 0x00, unused, 0, discretional},\ |
||
170 | /*42*/ {"vendor unique (42)", 0x00, 0x00, unused, 0, discretional},\ |
||
171 | /*43*/ {"vendor unique (43)", 0x00, 0x00, unused, 0, discretional},\ |
||
172 | /*44*/ {"vendor unique (44)", 0x00, 0x00, unused, 0, discretional},\ |
||
173 | /*45*/ {"vendor unique (45)", 0x00, 0x00, unused, 0, discretional},\ |
||
174 | /*46*/ {"phantom select", 0x00, 0x00, mode, 0, discretional},\ |
||
175 | /*47*/ {"phantom deselect", 0x00, 0x00, mode, 0, discretional},\ |
||
176 | } |
||
177 | |||
178 | /* |
||
179 | * Status bits returned by QIC_REPORT_DRIVE_STATUS |
||
180 | */ |
||
181 | |||
182 | #define QIC_STATUS_READY 0x01 /* Drive is ready or idle. */ |
||
183 | #define QIC_STATUS_ERROR 0x02 /* Error detected, must read |
||
184 | error code to clear this */ |
||
185 | #define QIC_STATUS_CARTRIDGE_PRESENT 0x04 /* Tape is present */ |
||
186 | #define QIC_STATUS_WRITE_PROTECT 0x08 /* Tape is write protected */ |
||
187 | #define QIC_STATUS_NEW_CARTRIDGE 0x10 /* New cartridge inserted, must |
||
188 | read error status to clear. */ |
||
189 | #define QIC_STATUS_REFERENCED 0x20 /* Cartridge appears to have been |
||
190 | formatted. */ |
||
191 | #define QIC_STATUS_AT_BOT 0x40 /* Cartridge is at physical |
||
192 | beginning of tape. */ |
||
193 | #define QIC_STATUS_AT_EOT 0x80 /* Cartridge is at physical end |
||
194 | of tape. */ |
||
195 | /* |
||
196 | * Status bits returned by QIC_REPORT_DRIVE_CONFIGURATION |
||
197 | */ |
||
198 | |||
199 | #define QIC_CONFIG_RATE_MASK 0x18 |
||
200 | #define QIC_CONFIG_RATE_SHIFT 3 |
||
201 | #define QIC_CONFIG_RATE_250 0 |
||
202 | #define QIC_CONFIG_RATE_500 2 |
||
203 | #define QIC_CONFIG_RATE_1000 3 |
||
204 | #define QIC_CONFIG_RATE_2000 1 |
||
205 | #define QIC_CONFIG_RATE_4000 0 /* since QIC-117 Rev. J */ |
||
206 | |||
207 | #define QIC_CONFIG_LONG 0x40 /* Extra Length Tape Detected */ |
||
208 | #define QIC_CONFIG_80 0x80 /* QIC-80 detected. */ |
||
209 | |||
210 | /* |
||
211 | * Status bits returned by QIC_REPORT_TAPE_STATUS |
||
212 | */ |
||
213 | |||
214 | #define QIC_TAPE_STD_MASK 0x0f |
||
215 | #define QIC_TAPE_QIC40 0x01 |
||
216 | #define QIC_TAPE_QIC80 0x02 |
||
217 | #define QIC_TAPE_QIC3020 0x03 |
||
218 | #define QIC_TAPE_QIC3010 0x04 |
||
219 | |||
220 | #define QIC_TAPE_LEN_MASK 0x70 |
||
221 | #define QIC_TAPE_205FT 0x10 |
||
222 | #define QIC_TAPE_307FT 0x20 |
||
223 | #define QIC_TAPE_VARIABLE 0x30 |
||
224 | #define QIC_TAPE_1100FT 0x40 |
||
225 | #define QIC_TAPE_FLEX 0x60 |
||
226 | |||
227 | #define QIC_TAPE_WIDE 0x80 |
||
228 | |||
229 | /* Define a value (in feet) slightly higher than |
||
230 | * the possible maximum tape length. |
||
231 | */ |
||
232 | #define QIC_TOP_TAPE_LEN 1500 |
||
233 | |||
234 | /* |
||
235 | * Errors: List of error codes, and their severity. |
||
236 | */ |
||
237 | |||
238 | typedef struct { |
||
239 | char *message; /* Text describing the error. */ |
||
240 | unsigned int fatal:1; /* Non-zero if the error is fatal. */ |
||
241 | } ftape_error; |
||
242 | |||
243 | #define QIC117_ERRORS {\ |
||
244 | /* 0*/ { "No error", 0, },\ |
||
245 | /* 1*/ { "Command Received while Drive Not Ready", 0, },\ |
||
246 | /* 2*/ { "Cartridge Not Present or Removed", 1, },\ |
||
247 | /* 3*/ { "Motor Speed Error (not within 1%)", 1, },\ |
||
248 | /* 4*/ { "Motor Speed Fault (jammed, or gross speed error", 1, },\ |
||
249 | /* 5*/ { "Cartridge Write Protected", 1, },\ |
||
250 | /* 6*/ { "Undefined or Reserved Command Code", 1, },\ |
||
251 | /* 7*/ { "Illegal Track Address Specified for Seek", 1, },\ |
||
252 | /* 8*/ { "Illegal Command in Report Subcontext", 0, },\ |
||
253 | /* 9*/ { "Illegal Entry into a Diagnostic Mode", 1, },\ |
||
254 | /*10*/ { "Broken Tape Detected (based on hole sensor)", 1, },\ |
||
255 | /*11*/ { "Warning--Read Gain Setting Error", 1, },\ |
||
256 | /*12*/ { "Command Received While Error Status Pending (obs)", 1, },\ |
||
257 | /*13*/ { "Command Received While New Cartridge Pending", 1, },\ |
||
258 | /*14*/ { "Command Illegal or Undefined in Primary Mode", 1, },\ |
||
259 | /*15*/ { "Command Illegal or Undefined in Format Mode", 1, },\ |
||
260 | /*16*/ { "Command Illegal or Undefined in Verify Mode", 1, },\ |
||
261 | /*17*/ { "Logical Forward Not at Logical BOT or no Format Segments in Format Mode", 1, },\ |
||
262 | /*18*/ { "Logical EOT Before All Segments generated", 1, },\ |
||
263 | /*19*/ { "Command Illegal When Cartridge Not Referenced", 1, },\ |
||
264 | /*20*/ { "Self-Diagnostic Failed (cannot be cleared)", 1, },\ |
||
265 | /*21*/ { "Warning EEPROM Not Initialized, Defaults Set", 1, },\ |
||
266 | /*22*/ { "EEPROM Corrupted or Hardware Failure", 1, },\ |
||
267 | /*23*/ { "Motion Time-out Error", 1, },\ |
||
268 | /*24*/ { "Data Segment Too Long -- Logical Forward or Pause", 1, },\ |
||
269 | /*25*/ { "Transmit Overrun (obs)", 1, },\ |
||
270 | /*26*/ { "Power On Reset Occurred", 0, },\ |
||
271 | /*27*/ { "Software Reset Occurred", 0, },\ |
||
272 | /*28*/ { "Diagnostic Mode 1 Error", 1, },\ |
||
273 | /*29*/ { "Diagnostic Mode 2 Error", 1, },\ |
||
274 | /*30*/ { "Command Received During Non-Interruptible Process", 1, },\ |
||
275 | /*31*/ { "Rate or Format Selection Error", 1, },\ |
||
276 | /*32*/ { "Illegal Command While in High Speed Mode", 1, },\ |
||
277 | /*33*/ { "Illegal Seek Segment Value", 1, },\ |
||
278 | /*34*/ { "Invalid Media", 1, },\ |
||
279 | /*35*/ { "Head Positioning Failure", 1, },\ |
||
280 | /*36*/ { "Write Reference Burst Failure", 1, },\ |
||
281 | /*37*/ { "Prom Code Missing", 1, },\ |
||
282 | /*38*/ { "Invalid Format", 1, },\ |
||
283 | /*39*/ { "EOT/BOT System Failure", 1, },\ |
||
284 | /*40*/ { "Prom A Checksum Error", 1, },\ |
||
285 | /*41*/ { "Drive Wakeup Reset Occurred", 1, },\ |
||
286 | /*42*/ { "Prom B Checksum Error", 1, },\ |
||
287 | /*43*/ { "Illegal Entry into Format Mode", 1, },\ |
||
288 | } |
||
289 | |||
290 | #endif /* _QIC117_H */ |