xref: /netbsd-src/sys/dev/qbus/tsreg.h (revision 90b2b356728a76288075bf5e8524c25efb9938f7)
1 /*	$NetBSD: tsreg.h,v 1.6 2024/02/05 22:18:18 andvar Exp $ */
2 /*
3  * Copyright (c) 1995 Ludd, University of Lule}, Sweden.
4  * All rights reserved.
5  *
6  * This code is derived from software contributed to Ludd by
7  * Bertram Barth.
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions
11  * are met:
12  * 1. Redistributions of source code must retain the above copyright
13  *    notice, this list of conditions and the following disclaimer.
14  * 2. Redistributions in binary form must reproduce the above copyright
15  *    notice, this list of conditions and the following disclaimer in the
16  *    documentation and/or other materials provided with the distribution.
17  *
18  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
19  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
20  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
21  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
22  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
23  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
27  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28  */
29 
30 /*
31  * TSV05 u.g. 5-11:
32  *
33  * The TSV05 Subsystem has four device registers that occupy only two
34  * LSI-11 Bus word locations: a Data Buffer (TSDB), a Bus Address
35  * Register (TSBA), a Status Register (TSSR), and an Extended Data
36  * Buffer (TSDBX). The TSDB is an 18-bit register that is ...
37  */
38 
39 #ifdef notdef
40 struct tsdevice {
41 	unsigned short tsdb;/* Data Buffer (TSDB)/Bus Address Register (TSBA) */
42 	unsigned short tssr;/* Status Reg. (TSSR)/Extended Data Buffer(TSDBX) */
43 };
44 #endif
45 #define	TSDB	0
46 #define	TSBA	0
47 #define	TSSR	2
48 #define	TSDBX	3
49 
50 /*
51  * TSSR Register bit definitions
52  */
53 #define TS_SC	0x8000	/* Special Condition */
54 #define TS_UPE	0x4000	/* not used in TSV05, UPE in TS11 */
55 #define TS_SCE	0x2000	/* Sanity Check Error, SPE in TS11 */
56 #define TS_RMR	0x1000	/* Register Modification Refused */
57 #define TS_NXM	0x0800	/* Nonexistent Memory */
58 #define TS_NBA	0x0400	/* Need Buffer Address */
59 #define TS_A11	0x0300	/* Address Bits 17-16 */
60 #define TS_SSR	0x0080	/* Subsystem Ready */
61 #define TS_OFL	0x0040	/* Off Line */
62 #define TS_FTC	0x0030	/* Fatal Termination Class Code */
63 #define TS_TC	0x000E	/* Termination Class Code */
64 #define TS_NU	0x0001	/* Not Used */
65 
66 #define TS_TSSR_BITS	"\20\20SC\17UPE\16SCE\15RMR\14NXM\13NBA\12A17\11A16" \
67 			   "\10SSR\7OFL\6FTC\5FTC\4FTL\3ERR\2ATTN\1NU"
68 
69 /*
70  * Termination Codes
71  */
72 #define TS_FTC_IDF	(0<<4)	/* internal diagnostic failure */
73 #define TS_FTC_RSVD	(1<<4)	/* Reserved */
74 #define TS_FTC_NU	(2<<4)	/* Not Used */
75 #define TS_FTC_DPD	(3<<4)	/* Detection of Power Down (not implemented) */
76 
77 #define TS_TC_NORM	(0<<1)	/* Normal Termination */
78 #define TS_TC_ATTN	(1<<1)	/* Attention Condition */
79 #define TS_TC_TSA	(2<<1)	/* Tape status alert */
80 #define TS_TC_FR	(3<<1)	/* Function reject */
81 #define TS_TC_TPD	(4<<1)	/* Tape position is one record down (recov.) */
82 #define TS_TC_TNM	(5<<1)	/* Tape not moved (recoverable) */
83 #define TS_TC_TPL	(6<<1)	/* Tape position lost (unrecoverable) */
84 #define TS_TC_FCE	(7<<1)	/* Fatal Controller Error (see FTC) */
85 
86 struct cmd {			/* command packet (not all words required) */
87 	unsigned short cmdr;	/* command word */
88 	unsigned short cw1;	/* low order data pointer address  (A15-00) */
89 	unsigned short cw2;	/* high order data pointer address (A21-16) */
90 	unsigned short cw3;	/* count parameter */
91 };
92 
93 /*
94  * Command flags
95  */
96 #define TS_CF_ACK	(1<<15)		/* Acknowledge */
97 #define TS_CF_CVC	(1<<14)		/* Clear Volume Check */
98 #define TS_CF_OPP	(1<<13)		/* Opposite */
99 #define TS_CF_SWB	(1<<12)		/* Swap Bytes */
100 #define TS_CF_IE	(1<< 7)		/* Interrupt Enable */
101 #define TS_CF_CMODE	0x0F00		/* Command Mode Field */
102 #define TS_CF_CCODE	0x001F		/* Command Code (major) */
103 #define TS_CF_CMASK	0x0F1F		/* mask for complete command */
104 
105 #define TS_CMD(cMode,cCode)	((cMode<<8)|cCode)
106 
107 #define TS_CC_READ	0x01			/* READ */
108 #define TS_CMD_RNF	TS_CMD(0,TS_CC_READ)	/* Read Next (Forward) */
109 #define TS_CMD_RPR	TS_CMD(1,TS_CC_READ)	/* Read Previous (Reverse) */
110 #define TS_CMD_RPF	TS_CMD(2,TS_CC_READ)	/* Read Previous (Forward) */
111 #define TS_CMD_RNR	TS_CMD(3,TS_CC_READ)	/* Read Next (Reverse) */
112 
113 #define TS_CC_WCHAR	0x04			/* WRITE CHARACTERISTICS */
114 #define TS_CMD_WCHAR	TS_CMD(0,TS_CC_WCHAR)	/* Load msg-buffer etc. */
115 
116 #define TS_CC_WRITE	0x05			/* WRITE */
117 #define TS_CMD_WD	TS_CMD(0,TS_CC_WRITE)	/* Write Data (Next) */
118 #define TS_CMD_WDR	TS_CMD(1,TS_CC_WRITE)	/* Write Data (Retry) */
119 
120 #define TS_CC_WSM	0x06			/* WRITE SUBSYSTEM MEMORY */
121 #define TS_CMD_WSM	TS_CMD(0,TS_CC_WSM)	/* (diagnostics only) */
122 
123 #define TS_CC_POS	0x08			/* POSITION */
124 #define TS_CMD_SRF	TS_CMD(0,TS_CC_POS)	/* Space Records Forward */
125 #define TS_CMD_SRR	TS_CMD(1,TS_CC_POS)	/* Space Records Reverse */
126 #define TS_CMD_STMF	TS_CMD(2,TS_CC_POS)	/* Skip Tape Marks Forward */
127 #define TS_CMD_STMR	TS_CMD(3,TS_CC_POS)	/* Skip Tape Marks Reverse */
128 #define TS_CMD_RWND	TS_CMD(4,TS_CC_POS)	/* Rewind */
129 
130 #define TS_CC_FRMT	0x09			/* FORMAT */
131 #define TS_CMD_WTM	TS_CMD(0,TS_CC_FRMT)	/* Write Tape Mark */
132 #define TS_CMD_ETM	TS_CMD(1,TS_CC_FRMT)	/* Erase */
133 #define TS_CMD_WTMR	TS_CMD(2,TS_CC_FRMT)	/* Write Tape Mark (Retry) */
134 
135 #define TS_CC_CTRL	0x0A			/* CONTROL */
136 #define TS_CMD_MBR	TS_CMD(0,TS_CC_CTRL)	/* Message Buffer Release */
137 #define TS_CMD_RWUL	TS_CMD(1,TS_CC_CTRL)	/* Rewind and Unload */
138 #define TS_CMD_NOP	TS_CMD(2,TS_CC_CTRL)	/* NO-OP (TS11: clean tape) */
139 #define TS_CMD_RWII	TS_CMD(4,TS_CC_CTRL)	/* Rewind with intermediate */
140 						/* interrupt (TS11: N.A.) */
141 #define TS_CC_INIT	0x0B			/* INITIALIZE */
142 #define TS_CMD_INIT	TS_CMD(0,TS_CC_INIT)	/* Controller/Drive Initial. */
143 
144 #define TS_CC_STAT	0x0F			/* GET STATUS */
145 #define TS_CMD_STAT	TS_CMD(0,TS_CC_STAT)	/* Get Status (END) */
146 
147 struct status {			/* message packet */
148 	unsigned short hdr;	/* ACK, class-code, format 1, message type */
149 	unsigned short dfl;	/* data field length (8 bit) */
150 	unsigned short rbpcr;	/* residual b/r/tm count word */
151 	unsigned short xst0;	/* Extended Status Registers 0-4 */
152 	unsigned short xst1;
153 	unsigned short xst2;
154 	unsigned short xst3;
155 	unsigned short xst4;	/* total size: 16 bytes */
156 };
157 
158 struct chr {
159 	unsigned short sadrl;	/* low-word of status addr */
160 	unsigned short sadrh;
161 	unsigned short onesix;	/* 016/020 */
162 	unsigned short chrw;	/* Characteristics word */
163 	unsigned short xchrw;	/* TS05 extra word */
164 };
165 /*
166  * Flags used in write-characteristics command
167  */
168 #define TS_WC_ESS	(1<<7)	/* Enable Skip Tape Marks Stop */
169 #define TS_WC_ENB	(1<<6)  /* Enable Tape Mark Stop at Bot */
170 #define TS_WC_EAI	(1<<5)	/* Enable Attention interrupts */
171 #define TS_WC_ERI	(1<<4)	/* Enable Message Buffer Release interrupts */
172 #define TS_WCX_HSP	(1<<5)	/* High Speed Select (25 in/s vs. 100 in/s) */
173 #define TS_WCX_RBUF	(1<<4)	/* Enable read buffering */
174 #define TS_WCX_WBUF	(1<<3)	/* Enable write buffering */
175 
176 /*
177  * Status flags
178  *
179  * Extended Status register 0 (XST0)  --  XST0 appears as the fourth word
180  * in the message buffer stored by the TSV05 subsystem upon completion of
181  * a command or an ATTN
182  */
183 #define TS_SF_TMK	(1<<15)	/* Tape Mark Detected */
184 #define TS_SF_RLS	(1<<14)	/* Record Length Short */
185 #define TS_SF_LET	(1<<13)	/* Logical End of Tape */
186 #define TS_SF_RLL	(1<<12)	/* Record Length Long */
187 #define TS_SF_WLE	(1<<11)	/* Write Lock Error */
188 #define TS_SF_NEF	(1<<10) /* Nonexecutable Function */
189 #define TS_SF_ILC	(1<< 9)	/* Illegal Command */
190 #define TS_SF_ILA	(1<< 8)	/* Illegal Address */
191 #define TS_SF_MOT	(1<< 7)	/* Motion */
192 #define TS_SF_ONL	(1<< 6)	/* On-Line */
193 #define TS_SF_IE	(1<< 5)	/* Interrupt Enable */
194 #define TS_SF_VCK	(1<< 4)	/* Volume Check */
195 #define TS_SF_PED	(1<< 3)	/* Phase Encoded Drive */
196 #define TS_SF_WLK	(1<< 2)	/* Write Locked */
197 #define TS_SF_BOT	(1<< 1)	/* Beginning of Tape */
198 #define TS_SF_EOT	(1<< 0)	/* End of Tape */
199 
200 #define TS_XST0_BITS	"\20\20TMK\17RLS\16LET\15RLL\14WLE\13NEF\12ILC\11ILA" \
201 			   "\10MOT\07ONL\06IE \05VCK\04PED\03WLK\02BOT\01EOT"
202 /*
203  * Extended Status register 1 (XST1)  --  XST1 appears as the fifth word
204  * in the message buffer stored by the TSV05 subsystem upon completion of
205  * a command or an ATTN
206  */
207 #define TS_SF_DLT	(1<<15)	/* Data Late */
208 #define TS_SF_COR	(1<<13)	/* Correctable Data */
209 #define TS_SF_CRS	(1<<12)	/* TS11: Crease Detected */
210 #define TS_SF_TIG	(1<<11)	/* TS11: Trash in Gap */
211 #define TS_SF_DBF	(1<<10)	/* TS11: Desckew Buffer Fail */
212 #define TS_SF_SCK	(1<< 9)	/* TS11: Speed Check */
213 #define TS_SF_RBP	(1<< 8)	/* Read Bus Parity Error */
214 #define TS_SF_IPR	(1<< 7)	/* TS11: Invalid Preamble */
215 #define TS_SF_IPO	(1<< 6)	/* TS11: Invalid Postamble */
216 #define TS_SF_SYN	(1<< 5)	/* TS11: Sync Failure */
217 #define TS_SF_IED	(1<< 4)	/* TS11: Invalid End Data */
218 #define TS_SF_POS	(1<< 3)	/* TS11: Postamble short */
219 #define TS_SF_POL	(1<< 2)	/* TS11: Postamble long */
220 #define TS_SF_UNC	(1<< 1)	/* Uncorrectable Data or Hard Error */
221 #define TS_SF_MTE	(1<< 0)	/* TS11: Multitrack Error */
222 
223 #define TS_XST1_BITS	"\20\20DLT\16COR\15CRS\14TIG\13DBF\12SCK\11RBP" \
224 			   "\10IPR\07IPO\06SYN\05IED\04POS\03POL\02UNC\01MTE"
225 
226 /*
227  * Extended Status register 2 (XST2)  --  sixth word
228  */
229 #define TS_SF_OPM	(1<<15)	/* Operation in Progress (tape moving) */
230 #define TS_SF_RCE	(1<<14)	/* RAM Checksum Error */
231 #define TS_SF_SBP	(1<<13)	/* TS11: Serial 08 bus parity */
232 #define TS_SF_CAF	(1<<12)	/* TS11: Capstan Acceleration fail */
233 #define	TS_SF_TU80	(1<<11)	/* Is a TU80 */
234 #define TS_SF_WCF	(1<<10)	/* Write Clock Failure */
235 #define TS_SF_PDT	(1<< 8)	/* TS11: Parity Dead Track */
236 #define TS_SF_RL	0x00FF	/* Revision Level */
237 #define TS_SF_EFES	(1<< 7)	/* extended features enable switch */
238 #define TS_SF_BES	(1<< 6)	/* Buffering enable switch */
239 #define TS_SF_MCRL	0x003F	/* micro-code revision level */
240 #define TS_SF_UNIT	0x0003	/* unit number of selected transport */
241 
242 #define TS_XST2_BITS	"\20\20OPM\17RCE\16SBP\15CAF\13WCF\11PDT\10EFES\7BES"
243 
244 /*
245  * Extended Status register 3 (XST3))  --  seventh word
246  */
247 #define TS_SF_MDE	0xFF00	/* Micro-Diagnostics Error Code */
248 #define TS_SF_LMX	(1<< 7)	/* TS11: Tension Arm Limit Exceeded */
249 #define TS_SF_OPI	(1<< 6)	/* Operation Incomplete */
250 #define TS_SF_REV	(1<< 5)	/* Revers */
251 #define TS_SF_CRF	(1<< 4)	/* TS11: Capstan Response Failure */
252 #define TS_SF_DCK	(1<< 3)	/* Density Check */
253 #define TS_SF_NBE	(1<< 2)	/* TS11: Noise Bit during Erase */
254 #define TS_SF_LSA	(1<< 1)	/* TS11: Limit Switch Activated */
255 #define TS_SF_RIB	(1<< 0)	/* Reverse into BOT */
256 
257 #define TS_XST3_BITS	"\20\10LMX\07OPI\06REV\05CRF\04DCK\03NBE\02LSA\01RIB"
258 
259 /*
260  * Extended Status register 4 (XST4))  --  eighth word
261  */
262 #define TS_SF_HSP	(1<<15)	/* High Speed */
263 #define TS_SF_RCX	(1<<14)	/* Retry Count Exceeded */
264 #define TS_SF_WRC	0x00FF	/* Write Retry Count Statistics */
265 
266 #define TS_XST4_BITS	"\20\20HSP\17RCX"
267 
268 
269