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: /homes/cvs/ftape-stacked/include/linux/qic117.h,v $ 24 * $Revision: 1.2 $ 25 * $Date: 1997/10/05 19:19:32 $ 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 */ 291