Annotation of sys/dev/sbus/spifreg.h, Revision 1.1.1.1
1.1 nbrk 1: /* $OpenBSD: spifreg.h,v 1.5 2003/06/02 18:32:41 jason Exp $ */
2:
3: /*
4: * Copyright (c) 1999-2002 Jason L. Wright (jason@thought.net)
5: * All rights reserved.
6: *
7: * Redistribution and use in source and binary forms, with or without
8: * modification, are permitted provided that the following conditions
9: * are met:
10: * 1. Redistributions of source code must retain the above copyright
11: * notice, this list of conditions and the following disclaimer.
12: * 2. Redistributions in binary form must reproduce the above copyright
13: * notice, this list of conditions and the following disclaimer in the
14: * documentation and/or other materials provided with the distribution.
15: *
16: * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
17: * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
18: * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
19: * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
20: * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
21: * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
22: * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
24: * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
25: * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
26: * POSSIBILITY OF SUCH DAMAGE.
27: *
28: * Effort sponsored in part by the Defense Advanced Research Projects
29: * Agency (DARPA) and Air Force Research Laboratory, Air Force
30: * Materiel Command, USAF, under agreement number F30602-01-2-0537.
31: *
32: */
33:
34: #define PPC_IN_PDATA 0x000 /* input data */
35: #define PPC_IN_PSTAT 0x001 /* input status */
36: #define PPC_IN_CTRL 0x002 /* input control */
37: #define PPC_IN_PWEIRD 0x003 /* input weird */
38: #define PPC_OUT_PDATA 0x000 /* output data */
39: #define PPC_OUT_PSTAT 0x001 /* output status */
40: #define PPC_OUT_PCTRL 0x002 /* output control */
41: #define PPC_OUT_PWEIRD 0x003 /* output weird */
42: #define PPC_IACK_PDATA 0x1fc /* iack data */
43: #define PPC_IACK_PSTAT 0x1fd /* iack status */
44: #define PPC_IACK_PCTRL 0x1fe /* iack control */
45: #define PPC_IACK_PWEIRD 0x1ff /* iack weird */
46:
47: /* Parallel Status: read only */
48: #define PPC_PSTAT_ERROR 0x08 /* error */
49: #define PPC_PSTAT_SELECT 0x10 /* select */
50: #define PPC_PSTAT_PAPER 0x20 /* paper out */
51: #define PPC_PSTAT_ACK 0x40 /* ack */
52: #define PPC_PSTAT_BUSY 0x80 /* busy */
53:
54: /* Parallel Control: read/write */
55: #define PPC_CTRL_STROBE 0x01 /* strobe, 1=drop strobe */
56: #define PPC_CTRL_AFX 0x02 /* auto form-feed */
57: #define PPC_CTRL_INIT 0x04 /* init, 1=enable printer */
58: #define PPC_CTRL_SLCT 0x08 /* SLC, 1=select printer */
59: #define PPC_CTRL_IRQE 0x10 /* IRQ, 1=enable intrs */
60: #define PPC_CTRL_OUTPUT 0x20 /* direction: 1=ppc out */
61:
62: /*
63: * The 'stc' is a Cirrus Logic CL-CD180 (either revision B or revision C)
64: */
65: #define STC_CCR 0x01 /* channel command */
66: #define STC_SRER 0x02 /* service request enable */
67: #define STC_COR1 0x03 /* channel option 1 */
68: #define STC_COR2 0x04 /* channel option 2 */
69: #define STC_COR3 0x05 /* channel option 3 */
70: #define STC_CCSR 0x06 /* channel control status */
71: #define STC_RDCR 0x07 /* rx data count */
72: #define STC_SCHR1 0x09 /* special character 1 */
73: #define STC_SCHR2 0x0a /* special character 2 */
74: #define STC_SCHR3 0x0b /* special character 3 */
75: #define STC_SCHR4 0x0c /* special character 4 */
76: #define STC_MCOR1 0x10 /* modem change option 1 */
77: #define STC_MCOR2 0x11 /* modem change option 2 */
78: #define STC_MCR 0x12 /* modem change */
79: #define STC_RTPR 0x18 /* rx timeout period */
80: #define STC_MSVR 0x28 /* modem signal value */
81: #define STC_MSVRTS 0x29 /* modem signal value rts */
82: #define STC_MSVDTR 0x2a /* modem signal value dtr */
83: #define STC_RBPRH 0x31 /* rx bit rate period high */
84: #define STC_RBPRL 0x32 /* rx bit rate period low */
85: #define STC_RBR 0x33 /* rx bit */
86: #define STC_TBPRH 0x39 /* tx bit rate period high */
87: #define STC_TBPRL 0x3a /* tx bit rate period low */
88: #define STC_GSVR 0x40 /* global service vector */
89: #define STC_GSCR1 0x41 /* global service channel 1 */
90: #define STC_GSCR2 0x42 /* global service channel 2 */
91: #define STC_GSCR3 0x43 /* global service channel 3 */
92: #define STC_MSMR 0x61 /* modem service match */
93: #define STC_TSMR 0x62 /* tx service match */
94: #define STC_RSMR 0x63 /* rx service match */
95: #define STC_CAR 0x64 /* channel access */
96: #define STC_SRSR 0x65 /* service request status */
97: #define STC_SRCR 0x66 /* service request config */
98: #define STC_GFRCR 0x6b /* global firmware rev code */
99: #define STC_PPRH 0x70 /* prescalar period high */
100: #define STC_PPRL 0x71 /* prescalar period low */
101: #define STC_MRAR 0x75 /* modem request ack */
102: #define STC_TRAR 0x76 /* tx request ack */
103: #define STC_RRAR 0x77 /* rx request ack */
104: #define STC_RDR 0x78 /* rx data */
105: #define STC_RCSR 0x7a /* rx character status */
106: #define STC_TDR 0x7b /* tx data */
107: #define STC_EOSRR 0x7f /* end of service */
108:
109: #define STC_REGMAPSIZE 0x80
110:
111: /* Global Firmware Revision Code Register (rw) */
112: #define CD180_GFRCR_REV_B 0x81 /* CL-CD180B */
113: #define CD180_GFRCR_REV_C 0x82 /* CL-CD180C */
114:
115: /* Service Request Configuration Register (rw) (CD180C or higher) */
116: #define CD180_SRCR_PKGTYP 0x80 /* pkg type,0=PLCC,1=PQFP */
117: #define CD180_SRCR_REGACKEN 0x40 /* register ack enable */
118: #define CD180_SRCR_DAISYEN 0x20 /* daisy chain enable */
119: #define CD180_SRCR_GLOBPRI 0x10 /* global priority */
120: #define CD180_SRCR_UNFAIR 0x08 /* use unfair interrupts */
121: #define CD180_SRCR_AUTOPRI 0x02 /* automatic priority */
122: #define CD180_SRCR_PRISEL 0x01 /* select rx/tx as high pri */
123:
124: /* Prescalar Period Register High (rw) */
125: #define CD180_PPRH 0xf0 /* high byte */
126: #define CD180_PPRL 0x00 /* low byte */
127:
128: /* Global Service Vector Register (rw) */
129: /* Modem Request Acknowledgement Register (ro) (and IACK equivalent) */
130: /* Receive Request Acknowledgement Register (ro) (and IACK equivalent) */
131: /* Transmit Request Acknowledgement Register (ro) (and IACK equivalent) */
132: #define CD180_GSVR_USERMASK 0xf8 /* user defined bits */
133: #define CD180_GSVR_IMASK 0x07 /* interrupt type mask */
134: #define CD180_GSVR_NOREQUEST 0x00 /* no request pending */
135: #define CD180_GSVR_STATCHG 0x01 /* modem signal change */
136: #define CD180_GSVR_TXDATA 0x02 /* tx service request */
137: #define CD180_GSVR_RXGOOD 0x03 /* rx service request */
138: #define CD180_GSVR_reserved1 0x04 /* reserved */
139: #define CD180_GSVR_reserved2 0x05 /* reserved */
140: #define CD180_GSVR_reserved3 0x06 /* reserved */
141: #define CD180_GSVR_RXEXCEPTION 0x07 /* rx exception request */
142:
143: /* Service Request Status Register (ro) (CD180C and higher) */
144: #define CD180_SRSR_MREQINT 0x01 /* modem request internal */
145: #define CD180_SRSR_MREQEXT 0x02 /* modem request external */
146: #define CD180_SRSR_TREQINT 0x04 /* tx request internal */
147: #define CD180_SRSR_TREQEXT 0x08 /* tx request external */
148: #define CD180_SRSR_RREQINT 0x10 /* rx request internal */
149: #define CD180_SRSR_RREQEXT 0x20 /* rx request external */
150: #define CD180_SRSR_ILV_MASK 0xc0 /* internal service context */
151: #define CD180_SRSR_ILV_NONE 0x00 /* not in service context */
152: #define CD180_SRSR_ILV_RX 0xc0 /* in rx service context */
153: #define CD180_SRSR_ILV_TX 0x80 /* in tx service context */
154: #define CD180_SRSR_ILV_MODEM 0x40 /* in modem service context */
155:
156: /* Global Service Channel Register 1,2,3 (rw) */
157: #define CD180_GSCR_CHANNEL(gscr) (((gscr) >> 2) & 7)
158:
159: /* Receive Data Count Register (ro) */
160: #define CD180_RDCR_MASK 0x0f /* mask for fifo length */
161:
162: /* Receive Character Status Register (ro) */
163: #define CD180_RCSR_TO 0x80 /* time out */
164: #define CD180_RCSR_SCD2 0x40 /* special char detect 2 */
165: #define CD180_RCSR_SCD1 0x20 /* special char detect 1 */
166: #define CD180_RCSR_SCD0 0x10 /* special char detect 0 */
167: #define CD180_RCSR_BE 0x08 /* break exception */
168: #define CD180_RCSR_PE 0x04 /* parity exception */
169: #define CD180_RCSR_FE 0x02 /* framing exception */
170: #define CD180_RCSR_OE 0x01 /* overrun exception */
171:
172: /* Service Request Enable Register (rw) */
173: #define CD180_SRER_DSR 0x80 /* DSR service request */
174: #define CD180_SRER_CD 0x40 /* CD service request */
175: #define CD180_SRER_CTS 0x20 /* CTS service request */
176: #define CD180_SRER_RXD 0x10 /* RXD service request */
177: #define CD180_SRER_RXSCD 0x08 /* RX special char request */
178: #define CD180_SRER_TXD 0x04 /* TX ready service request */
179: #define CD180_SRER_TXE 0x02 /* TX empty service request */
180: #define CD180_SRER_NNDT 0x01 /* No new data timeout req */
181:
182: /* Channel Command Register (rw) */
183: /* Reset Channel Command */
184: #define CD180_CCR_CMD_RESET 0x80 /* chip/channel reset */
185: #define CD180_CCR_RESETALL 0x01 /* global reset */
186: #define CD180_CCR_RESETCHAN 0x00 /* current channel reset */
187: /* Channel Option Register Command */
188: #define CD180_CCR_CMD_COR 0x40 /* channel opt reg changed */
189: #define CD180_CCR_CORCHG1 0x02 /* cor1 has changed */
190: #define CD180_CCR_CORCHG2 0x04 /* cor2 has changed */
191: #define CD180_CCR_CORCHG3 0x08 /* cor3 has changed */
192: /* Send Special Character Command */
193: #define CD180_CCR_CMD_SPC 0x20 /* send special chars changed */
194: #define CD180_CCR_SSPC0 0x01 /* send special char 0 change */
195: #define CD180_CCR_SSPC1 0x02 /* send special char 1 change */
196: #define CD180_CCR_SSPC2 0x04 /* send special char 2 change */
197: /* Channel Control Command */
198: #define CD180_CCR_CMD_CHAN 0x10 /* channel control command */
199: #define CD180_CCR_CHAN_TXEN 0x08 /* enable channel tx */
200: #define CD180_CCR_CHAN_TXDIS 0x04 /* disable channel tx */
201: #define CD180_CCR_CHAN_RXEN 0x02 /* enable channel rx */
202: #define CD180_CCR_CHAN_RXDIS 0x01 /* disable channel rx */
203:
204: /* Channel Option Register 1 (rw) */
205: #define CD180_COR1_EVENPAR 0x00 /* even parity */
206: #define CD180_COR1_ODDPAR 0x80 /* odd parity */
207: #define CD180_COR1_PARMODE_NO 0x00 /* no parity */
208: #define CD180_COR1_PARMODE_FORCE 0x20 /* force (odd=1, even=0) */
209: #define CD180_COR1_PARMODE_NORMAL 0x40 /* normal parity mode */
210: #define CD180_COR1_PARMODE_NA 0x60 /* notused */
211: #define CD180_COR1_IGNPAR 0x10 /* ignore parity */
212: #define CD180_COR1_STOP1 0x00 /* 1 stop bit */
213: #define CD180_COR1_STOP15 0x04 /* 1.5 stop bits */
214: #define CD180_COR1_STOP2 0x08 /* 2 stop bits */
215: #define CD180_COR1_STOP25 0x0c /* 2.5 stop bits */
216: #define CD180_COR1_CS5 0x00 /* 5 bit characters */
217: #define CD180_COR1_CS6 0x01 /* 6 bit characters */
218: #define CD180_COR1_CS7 0x02 /* 7 bit characters */
219: #define CD180_COR1_CS8 0x03 /* 8 bit characters */
220:
221: /* Channel Option Register 2 (rw) */
222: #define CD180_COR2_IXM 0x80 /* implied xon mode */
223: #define CD180_COR2_TXIBE 0x40 /* tx in-band flow control */
224: #define CD180_COR2_ETC 0x20 /* embedded tx command enbl */
225: #define CD180_COR2_LLM 0x10 /* local loopback mode */
226: #define CD180_COR2_RLM 0x08 /* remote loopback mode */
227: #define CD180_COR2_RTSAO 0x04 /* RTS automatic output enbl */
228: #define CD180_COR2_CTSAE 0x02 /* CTS automatic enable */
229: #define CD180_COR2_DSRAE 0x01 /* DSR automatic enable */
230:
231: /* Channel Option Register 3 (rw) */
232: #define CD180_COR3_XON2 0x80 /* XON char in spc1&3 */
233: #define CD180_COR3_XON1 0x00 /* XON char in spc1 */
234: #define CD180_COR3_XOFF2 0x40 /* XOFF char in spc2&4 */
235: #define CD180_COR3_XOFF1 0x00 /* XOFF char in spc2 */
236: #define CD180_COR3_FCT 0x20 /* flow control transparency */
237: #define CD180_COR3_SCDE 0x10 /* special char recognition */
238: #define CD180_COR3_RXFIFO_MASK 0x0f /* rx fifo threshold */
239:
240: /* Channel Control Status Register (ro) */
241: #define CD180_CCSR_RXEN 0x80 /* rx is enabled */
242: #define CD180_CCSR_RXFLOFF 0x40 /* rx flow-off */
243: #define CD180_CCSR_RXFLON 0x20 /* rx flow-on */
244: #define CD180_CCSR_TXEN 0x08 /* tx is enabled */
245: #define CD180_CCSR_TXFLOFF 0x04 /* tx flow-off */
246: #define CD180_CCSR_TXFLON 0x02 /* tx flow-on */
247:
248: /* Receiver Bit Register (ro) */
249: #define CD180_RBR_RXD 0x40 /* state of RxD pin */
250: #define CD180_RBR_STARTHUNT 0x20 /* looking for start bit */
251:
252: /* Modem Change Register (rw) */
253: #define CD180_MCR_DSR 0x80 /* DSR changed */
254: #define CD180_MCR_CD 0x40 /* CD changed */
255: #define CD180_MCR_CTS 0x20 /* CTS changed */
256:
257: /* Modem Change Option Register 1 (rw) */
258: #define CD180_MCOR1_DSRZD 0x80 /* catch 0->1 DSR changes */
259: #define CD180_MCOR1_CDZD 0x40 /* catch 0->1 CD changes */
260: #define CD180_MCOR1_CTSZD 0x40 /* catch 0->1 CTS changes */
261: #define CD180_MCOR1_DTRTHRESH 0x0f /* DTR threshold mask */
262:
263: /* Modem Change Option Register 2 (rw) */
264: #define CD180_MCOR2_DSROD 0x80 /* catch 1->0 DSR changes */
265: #define CD180_MCOR2_CDOD 0x40 /* catch 1->0 CD changes */
266: #define CD180_MCOR2_CTSOD 0x20 /* catch 1->0 CTS changes */
267:
268: /* Modem Signal Value Register (rw) */
269: #define CD180_MSVR_DSR 0x80 /* DSR input state */
270: #define CD180_MSVR_CD 0x40 /* CD input state */
271: #define CD180_MSVR_CTS 0x20 /* CTS input state */
272: #define CD180_MSVR_DTR 0x02 /* DTR output state */
273: #define CD180_MSVR_RTS 0x01 /* RTS output state */
274:
275: /* Modem Signal Value Register - Request To Send (w) (CD180C and higher) */
276: #define CD180_MSVRTS_RTS 0x01 /* RTS signal value */
277:
278: /* Modem Signal Value Register - Data Terminal Ready (w) (CD180C and higher) */
279: #define CD180_MSVDTR_DTR 0x02 /* DTR signal value */
280:
281: /*
282: * The register map for the SUNW,spif looks something like:
283: * Offset: Function:
284: * 0000 - 03ff Boot ROM
285: * 0400 - 0407 dtr latches (one per port)
286: * 0409 - 07ff unused
287: * 0800 - 087f CD180 registers (normal mapping)
288: * 0880 - 0bff unused
289: * 0c00 - 0c7f CD180 registers (*iack mapping)
290: * 0c80 - 0dff unused
291: * 0e00 - 1fff PPC registers
292: *
293: * One note about the DTR latches: The values stored there are reversed.
294: * By writing a 1 to the latch, DTR is lowered, and by writing a 0, DTR
295: * is raised. The latches cannot be read, and no other value can be written
296: * there or the system will crash due to "excessive bus loading (see
297: * SBus loading and capacitance spec)"
298: *
299: * The *iack registers are read/written with the IACK bit set. When
300: * the interrupt routine starts, it reads the MRAR, TRAR, and RRAR registers
301: * from this mapping. This signals an interrupt acknowledgement cycle.
302: * (NOTE: these are not really the MRAR, TRAR, and RRAR... They are copies
303: * of the GSVR, I just mapped them to the same location as the mrar, trar,
304: * and rrar because it seemed appropriate).
305: */
306: #define DTR_REG_OFFSET 0x400 /* DTR latches */
307: #define DTR_REG_LEN 0x8
308: #define STC_REG_OFFSET 0x800 /* normal cd180 access */
309: #define STC_REG_LEN 0x80
310: #define ISTC_REG_OFFSET 0xc00 /* IACK cd180 access */
311: #define ISTC_REG_LEN STC_REG_LEN
312: #define PPC_REG_OFFSET 0xe00 /* PPC registers */
313: #define PPC_REG_LEN 0x200
314:
315: /*
316: * The mapping of minor device number -> card and port is done as
317: * follows by default:
318: *
319: * +---+---+---+---+---+---+---+---+
320: * | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 |
321: * +---+---+---+---+---+---+---+---+
322: * | | | | | | | |
323: * | | | | | +---+---+---> port number
324: * | | | | |
325: * | | | | +---------------> unused
326: * | | | |
327: * | | | +-------------------> dialout (on tty ports)
328: * | | |
329: * | | +-----------------------> unused
330: * | |
331: * +---+---------------------------> card number
332: *
333: */
334: #define SPIF_MAX_CARDS 4
335: #define SPIF_MAX_TTY 8
336: #define SPIF_MAX_BPP 1
337:
338: /*
339: * device selectors
340: */
341: #define SPIF_CARD(x) ((minor(x) >> 6) & 0x03)
342: #define SPIF_PORT(x) (minor(x) & 0x07)
343: #define STTY_DIALOUT(x) (minor(x) & 0x10)
344:
345: #define STTY_RX_FIFO_THRESHOLD 4
346: #define STTY_RX_DTR_THRESHOLD 7
347: #define CD180_TX_FIFO_SIZE 8 /* 8 chars of fifo */
348:
349: /*
350: * These are the offsets of the MRAR, TRAR, and RRAR in *IACK space.
351: * The high bit must be set as per specs for the MSMR, TSMR, and RSMR.
352: */
353: #define SPIF_MSMR (0x80 | STC_MRAR) /* offset of MRAR | 0x80 */
354: #define SPIF_TSMR (0x80 | STC_TRAR) /* offset of TRAR | 0x80 */
355: #define SPIF_RSMR (0x80 | STC_RRAR) /* offset of RRAR | 0x80 */
356:
357: /*
358: * "verosc" node tells which oscillator we have.
359: */
360: #define SPIF_OSC9 1 /* 9.8304 MHz */
361: #define SPIF_OSC10 2 /* 10MHz */
362:
363: /*
364: * There are two interrupts, serial gets interrupt[0], and parallel
365: * gets interrupt[1]
366: */
367: #define SERIAL_INTR 0
368: #define PARALLEL_INTR 1
369:
370: /*
371: * spif tty flags
372: */
373: #define STTYF_CDCHG 0x01 /* carrier changed */
374: #define STTYF_RING_OVERFLOW 0x02 /* ring buffer overflowed */
375: #define STTYF_DONE 0x04 /* done... flush buffers */
376: #define STTYF_SET_BREAK 0x08 /* set break signal */
377: #define STTYF_CLR_BREAK 0x10 /* clear break signal */
378: #define STTYF_STOP 0x20 /* stopped */
379:
380: #define STTY_RBUF_SIZE (2 * 512)
CVSweb