1 /*        $NetBSD: sgecreg.h,v 1.4 2005/12/11 12:21:28 christos Exp $ */
2 /*
3  * Copyright (c) 1988 Regents of the University of California.
4  * All rights reserved.
5  *
6  * This code is derived from software contributed to Berkeley by
7  * Digital Equipment Corp.
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  * 3. Neither the name of the University nor the names of its contributors
18  *    may be used to endorse or promote products derived from this software
19  *    without specific prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31  * SUCH DAMAGE.
32  *
33  */
34 
35 #ifndef _DEV_IC_SGECREG_H_
36 #define _DEV_IC_SGECREG_H_
37 
38 /* Driver for SGEC (second generation Ethernet controller) chip, type DC-541,
39    found on the KA670 (and prob ably other) CPU.
40 
41    17 May 1998...Jay Maynard, jmaynard@phoenix.net
42 */
43 
44 /* SGEC CSRs */
45 struct zedevice {
46           u_long ze_nicsr0;   /* vector address, IPL, sync mode */
47           u_long ze_nicsr1;   /* TX poll demand */
48           u_long ze_nicsr2;   /* RX poll demand */
49           struct ze_rdes *ze_nicsr3;    /* RX descriptor list address */
50           struct ze_tdes *ze_nicsr4;    /* TX descriptor list address */
51           u_long ze_nicsr5;   /* SGEC status */
52           u_long ze_nicsr6;   /* SGEC command/mode */
53           u_long ze_nicsr7;   /* system page table base address */
54           u_long ze_nivcsr8;  /* reserved virtual CSR */
55           u_long ze_nivcsr9;  /* watchdog timers (virtual) */
56           u_long ze_nivcsr10; /* revision, missed frame count (v) */
57           u_long ze_nivcsr11; /* boot message verification (low) (v) */
58           u_long ze_nivcsr12; /* boot message verification (high) (v) */
59           u_long ze_nivcsr13; /* boot message processor (v) */
60           u_long ze_nivcsr14; /* diagnostic breakpoint (v) */
61           u_long ze_nicsr15;  /* monitor command */
62 };
63 
64 /*
65  * Register offsets.
66  */
67 #define   ZE_CSR0             0
68 #define   ZE_CSR1             4
69 #define   ZE_CSR2             8
70 #define   ZE_CSR3             12
71 #define   ZE_CSR4             16
72 #define   ZE_CSR5             20
73 #define   ZE_CSR6             24
74 #define   ZE_CSR7             28
75 #define   ZE_CSR8             32
76 #define   ZE_CSR9             36
77 #define   ZE_CSR10  40
78 #define   ZE_CSR11  44
79 #define   ZE_CSR12  48
80 #define   ZE_CSR13  52
81 #define   ZE_CSR14  56
82 #define   ZE_CSR15  60
83 
84 /* SGEC bit definitions */
85 /* NICSR0: */
86 #define ZE_NICSR0_IPL 0xc0000000        /* interrupt priority level: */
87 #define ZE_NICSR0_IPL14 0x00000000      /* 0x14 */
88 #define ZE_NICSR0_IPL15 0x40000000      /* 0x15 */
89 #define ZE_NICSR0_IPL16 0x80000000      /* 0x16 */
90 #define ZE_NICSR0_IPL17 0xc0000000      /* 0x17 */
91 #define ZE_NICSR0_SA 0x20000000                   /* sync(1)/async mode */
92 #define ZE_NICSR0_MBO 0x1fff0003        /* must be set to one on write */
93 #define ZE_NICSR0_IV_MASK 0x0000fffc    /* bits for the interrupt vector */
94 
95 /* NICSR1: */
96 #define ZE_NICSR1_TXPD 0xffffffff       /* transmit polling demand */
97 
98 /* NICSR2: */
99 #define ZE_NICSR2_RXPD 0xffffffff       /* receive polling demand */
100 
101 /* NICSR3 and NICSR4 are pure addresses */
102 /* NICSR5: */
103 #define ZE_NICSR5_ID 0x80000000                   /* init done */
104 #define ZE_NICSR5_SF 0x40000000                   /* self-test failed */
105 #define ZE_NICSR5_SS 0x3c000000                   /* self-test status field */
106 #define ZE_NICSR5_TS 0x03000000                   /* transmission state: */
107 #define ZE_NICSR5_TS_STOP 0x00000000    /* stopped */
108 #define ZE_NICSR5_TS_RUN 0x01000000     /* running */
109 #define ZE_NICSR5_TS_SUSP 0x02000000    /* suspended */
110 #define ZE_NICSR5_RS 0x00c00000                   /* reception state: */
111 #define ZE_NICSR5_RS_STOP 0x00000000    /* stopped */
112 #define ZE_NICSR5_RS_RUN 0x00400000     /* running */
113 #define ZE_NICSR5_RS_SUSP 0x00800000    /* suspended */
114 #define ZE_NICSR5_OM 0x00060000                   /* operating mode: */
115 #define ZE_NICSR5_OM_NORM 0x00000000    /* normal */
116 #define ZE_NICSR5_OM_ILBK 0x00020000    /* internal loopback */
117 #define ZE_NICSR5_OM_ELBK 0x00040000    /* external loopback */
118 #define ZE_NICSR5_OM_DIAG 0x00060000    /* reserved for diags */
119 #define ZE_NICSR5_DN 0x00010000                   /* virtual CSR access done */
120 #define ZE_NICSR5_MBO 0x0038ff00        /* must be one */
121 #define ZE_NICSR5_BO 0x00000080                   /* boot message received */
122 #define ZE_NICSR5_TW 0x00000040                   /* transmit watchdog timeout */
123 #define ZE_NICSR5_RW 0x00000020                   /* receive watchdog timeout */
124 #define ZE_NICSR5_ME 0x00000010                   /* memory error */
125 #define ZE_NICSR5_RU 0x00000008                   /* receive buffer unavailable */
126 #define ZE_NICSR5_RI 0x00000004                   /* receiver interrupt */
127 #define ZE_NICSR5_TI 0x00000002                   /* transmitter interrupt */
128 #define ZE_NICSR5_IS 0x00000001                   /* interrupt summary */
129 /* whew! */
130 
131 /* NICSR6: */
132 #define ZE_NICSR6_RE 0x80000000                   /* reset */
133 #define ZE_NICSR6_IE 0x40000000                   /* interrupt enable */
134 #define ZE_NICSR6_MBO 0x01e7f000        /* must be one */
135 #define ZE_NICSR6_BL 0x1e000000                   /* burst limit mask */
136 #define ZE_NICSR6_BL_8 0x10000000       /* 8 longwords */
137 #define ZE_NICSR6_BL_4 0x08000000       /* 4 longwords */
138 #define ZE_NICSR6_BL_2 0x04000000       /* 2 longwords */
139 #define ZE_NICSR6_BL_1 0x02000000       /* 1 longword */
140 #define ZE_NICSR6_BE 0x00100000                   /* boot message enable */
141 #define ZE_NICSR6_SE 0x00080000                   /* single cycle enable */
142 #define ZE_NICSR6_ST 0x00000800                   /* start(1)/stop(0) transmission */
143 #define ZE_NICSR6_SR 0x00000400                   /* start(1)/stop(0) reception */
144 #define ZE_NICSR6_OM 0x00000300                   /* operating mode: */
145 #define ZE_NICSR6_OM_NORM 0x00000000    /* normal */
146 #define ZE_NICSR6_OM_ILBK 0x00000100    /* internal loopback */
147 #define ZE_NICSR6_OM_ELBK 0x00000200    /* external loopback */
148 #define ZE_NICSR6_OM_DIAG 0x00000300    /* reserved for diags */
149 #define ZE_NICSR6_DC 0x00000080                   /* disable data chaining */
150 #define ZE_NICSR6_FC 0x00000040                   /* force collision mode */
151 #define ZE_NICSR6_PB 0x00000008                   /* pass bad frames */
152 #define ZE_NICSR6_AF 0x00000006                   /* address filtering mode: */
153 #define ZE_NICSR6_AF_NORM 0x00000000    /* normal filtering */
154 #define ZE_NICSR6_AF_PROM 0x00000002    /* promiscuous mode */
155 #define ZE_NICSR6_AF_ALLM 0x00000004    /* all multicasts */
156 
157 /* NICSR7 is an address, NICSR8 is reserved */
158 /* NICSR9: */
159 #define ZE_VNICSR9_RT 0xffff0000        /* receiver timeout, *1.6 us */
160 #define ZE_VNICSR9_TT 0x0000ffff        /* transmitter timeout */
161 
162 /* NICSR10: */
163 #define ZE_VNICSR10_RN 0x001f0000       /* SGEC version */
164 #define ZE_VNICSR10_MFC 0x0000ffff      /* missed frame counter */
165 
166 /* if you want to know what's in NICSRs 11-15, define them yourself! */
167 
168 /* Descriptors: */
169 /* Receive descriptor */
170 struct ze_rdes {
171           u_short ze_rdes0;             /* descriptor word 0 flags */
172           u_short ze_framelen;                    /* received frame length */
173           u_char ze_rsvd1[3];           /* unused bytes */
174           u_char ze_rdes1;              /* descriptor word 1 flags */
175           short ze_pageoffset;                    /* offset of buffer in page */
176           short ze_bufsize;             /* length of data buffer */
177           u_char *ze_bufaddr;           /* address of data buffer */
178 };
179 
180 /* Receive descriptor bits */
181 #define ZE_FRAMELEN_OW 0x8000           /* SGEC owns this descriptor */
182 #define ZE_RDES0_ES 0x8000              /* an error has occurred */
183 #define ZE_RDES0_LE 0x4000              /* length error */
184 #define ZE_RDES0_DT 0x3000              /* data type: */
185 #define ZE_RDES0_DT_NORM 0x0000                   /* normal frame */
186 #define ZE_RDES0_DT_ILBK 0x1000                   /* internally looped back frame */
187 #define ZE_RDES0_DT_ELBK 0x2000                   /* externally looped back frame */
188 #define ZE_RDES0_RF 0x0800              /* runt frame */
189 #define ZE_RDES0_BO 0x0400              /* buffer overflow */
190 #define ZE_RDES0_FS 0x0200              /* first segment */
191 #define ZE_RDES0_LS 0x0100              /* last segment */
192 #define ZE_RDES0_TL 0x0080              /* frame too long */
193 #define ZE_RDES0_CS 0x0040              /* collision seen */
194 #define ZE_RDES0_FT 0x0020              /* Ethernet frame type */
195 #define ZE_RDES0_TN 0x0008              /* address translation not valid */
196 #define ZE_RDES0_DB 0x0004              /* dribbling bits seen */
197 #define ZE_RDES0_CE 0x0002              /* CRC error */
198 #define ZE_RDES0_OF 0x0001              /* internal FIFO overflow */
199 #define ZE_RDES1_CA 0x80                /* chain address */
200 #define ZE_RDES1_VA 0x40                /* virtual address */
201 #define ZE_RDES1_VT 0x20                /* virtual(1)/phys PTE address */
202 
203 /* Transmit descriptor */
204 struct ze_tdes {
205           u_short ze_tdes0;             /* descriptor word 0 flags */
206           u_short ze_tdr;                         /* TDR count of cable fault */
207           u_char ze_rsvd1[2];           /* unused bytes */
208           u_short ze_tdes1;             /* descriptor word 1 flags */
209           short ze_pageoffset;                    /* offset of buffer in page */
210           short ze_bufsize;             /* length of data buffer */
211           u_char *ze_bufaddr;           /* address of data buffer */
212 };
213 
214 /* Receive descriptor bits */
215 #define ZE_TDR_OW 0x8000                /* SGEC owns this descriptor */
216 #define ZE_TDES0_ES 0x8000              /* an error has occurred */
217 #define ZE_TDES0_TO 0x4000              /* transmit watchdog timeout */
218 #define ZE_TDES0_LE 0x1000              /* length error */
219 #define ZE_TDES0_LO 0x0800              /* loss of carrier */
220 #define ZE_TDES0_NC 0x0400              /* no carrier */
221 #define ZE_TDES0_LC 0x0200              /* late collision */
222 #define ZE_TDES0_EC 0x0100              /* excessive collisions */
223 #define ZE_TDES0_HF 0x0080              /* heartbeat fail */
224 #define ZE_TDES0_CC 0x0078              /* collision count mask */
225 #define ZE_TDES0_TN 0x0004              /* address translation invalid */
226 #define ZE_TDES0_UF 0x0002              /* underflow */
227 #define ZE_TDES0_DE 0x0001              /* transmission deferred */
228 #define ZE_TDES1_CA 0x8000              /* chain address */
229 #define ZE_TDES1_VA 0x4000              /* virtual address */
230 #define ZE_TDES1_DT 0x3000              /* data type: */
231 #define ZE_TDES1_DT_NORM 0x0000                   /* normal transmit frame */
232 #define ZE_TDES1_DT_SETUP 0x2000        /* setup frame */
233 #define ZE_TDES1_DT_DIAG 0x3000                   /* diagnostic frame */
234 #define ZE_TDES1_AC 0x0800              /* CRC disable */
235 #define ZE_TDES1_FS 0x0400              /* first segment */
236 #define ZE_TDES1_LS 0x0200              /* last segment */
237 #define ZE_TDES1_IC 0x0100              /* interrupt on completion */
238 #define ZE_TDES1_VT 0x0080              /* virtual(1)/phys PTE address */
239 
240 #endif /* _DEV_IC_SGECREG_H_ */
241