1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  *  linux/drivers/acorn/net/ether1.h
4  *
5  *  Copyright (C) 1996 Russell King
6  *
7  *  Network driver for Acorn Ether1 cards.
8  */
9 
10 #ifndef _LINUX_ether1_H
11 #define _LINUX_ether1_H
12 
13 #ifdef __ETHER1_C
14 /* use 0 for production, 1 for verification, >2 for debug */
15 #ifndef NET_DEBUG
16 #define NET_DEBUG 0
17 #endif
18 
19 #define priv(dev)	((struct ether1_priv *)netdev_priv(dev))
20 
21 /* Page register */
22 #define REG_PAGE	(priv(dev)->base + 0x0000)
23 
24 /* Control register */
25 #define REG_CONTROL	(priv(dev)->base + 0x0004)
26 #define CTRL_RST	0x01
27 #define CTRL_LOOPBACK	0x02
28 #define CTRL_CA		0x04
29 #define CTRL_ACK	0x08
30 
31 #define ETHER1_RAM	(priv(dev)->base + 0x2000)
32 
33 /* HW address */
34 #define IDPROM_ADDRESS	(priv(dev)->base + 0x0024)
35 
36 struct ether1_priv {
37 	void __iomem *base;
38 	unsigned int tx_link;
39 	unsigned int tx_head;
40 	volatile unsigned int tx_tail;
41 	volatile unsigned int rx_head;
42 	volatile unsigned int rx_tail;
43 	unsigned char bus_type;
44 	unsigned char resetting;
45 	unsigned char initialising : 1;
46 	unsigned char restart      : 1;
47 };
48 
49 #define I82586_NULL (-1)
50 
51 typedef struct { /* tdr */
52 	unsigned short tdr_status;
53 	unsigned short tdr_command;
54 	unsigned short tdr_link;
55 	unsigned short tdr_result;
56 #define TDR_TIME	(0x7ff)
57 #define TDR_SHORT	(1 << 12)
58 #define TDR_OPEN	(1 << 13)
59 #define TDR_XCVRPROB	(1 << 14)
60 #define TDR_LNKOK	(1 << 15)
61 } tdr_t;
62 
63 typedef struct { /* transmit */
64 	unsigned short tx_status;
65 	unsigned short tx_command;
66 	unsigned short tx_link;
67 	unsigned short tx_tbdoffset;
68 } tx_t;
69 
70 typedef struct { /* tbd */
71 	unsigned short tbd_opts;
72 #define TBD_CNT		(0x3fff)
73 #define TBD_EOL		(1 << 15)
74 	unsigned short tbd_link;
75 	unsigned short tbd_bufl;
76 	unsigned short tbd_bufh;
77 } tbd_t;
78 
79 typedef struct { /* rfd */
80 	unsigned short rfd_status;
81 #define RFD_NOEOF	(1 << 6)
82 #define RFD_FRAMESHORT	(1 << 7)
83 #define RFD_DMAOVRN	(1 << 8)
84 #define RFD_NORESOURCES	(1 << 9)
85 #define RFD_ALIGNERROR	(1 << 10)
86 #define RFD_CRCERROR	(1 << 11)
87 #define RFD_OK		(1 << 13)
88 #define RFD_FDCONSUMED	(1 << 14)
89 #define RFD_COMPLETE	(1 << 15)
90 	unsigned short rfd_command;
91 #define RFD_CMDSUSPEND	(1 << 14)
92 #define RFD_CMDEL	(1 << 15)
93 	unsigned short rfd_link;
94 	unsigned short rfd_rbdoffset;
95 	unsigned char  rfd_dest[6];
96 	unsigned char  rfd_src[6];
97 	unsigned short rfd_len;
98 } rfd_t;
99 
100 typedef struct { /* rbd */
101 	unsigned short rbd_status;
102 #define RBD_ACNT	(0x3fff)
103 #define RBD_ACNTVALID	(1 << 14)
104 #define RBD_EOF		(1 << 15)
105 	unsigned short rbd_link;
106 	unsigned short rbd_bufl;
107 	unsigned short rbd_bufh;
108 	unsigned short rbd_len;
109 } rbd_t;
110 
111 typedef struct { /* nop */
112 	unsigned short nop_status;
113 	unsigned short nop_command;
114 	unsigned short nop_link;
115 } nop_t;
116 
117 typedef struct { /* set multicast */
118 	unsigned short mc_status;
119 	unsigned short mc_command;
120 	unsigned short mc_link;
121 	unsigned short mc_cnt;
122 	unsigned char  mc_addrs[1][6];
123 } mc_t;
124 
125 typedef struct { /* set address */
126 	unsigned short sa_status;
127 	unsigned short sa_command;
128 	unsigned short sa_link;
129 	unsigned char  sa_addr[6];
130 } sa_t;
131 
132 typedef struct { /* config command */
133 	unsigned short cfg_status;
134 	unsigned short cfg_command;
135 	unsigned short cfg_link;
136 	unsigned char  cfg_bytecnt;	/* size foll data: 4 - 12		 */
137 	unsigned char  cfg_fifolim;	/* FIFO threshold			 */
138 	unsigned char  cfg_byte8;
139 #define CFG8_SRDY	(1 << 6)
140 #define CFG8_SAVEBADF	(1 << 7)
141 	unsigned char  cfg_byte9;
142 #define CFG9_ADDRLEN(x)	(x)
143 #define CFG9_ADDRLENBUF	(1 << 3)
144 #define CFG9_PREAMB2	(0 << 4)
145 #define CFG9_PREAMB4	(1 << 4)
146 #define CFG9_PREAMB8	(2 << 4)
147 #define CFG9_PREAMB16	(3 << 4)
148 #define CFG9_ILOOPBACK	(1 << 6)
149 #define CFG9_ELOOPBACK	(1 << 7)
150 	unsigned char  cfg_byte10;
151 #define CFG10_LINPRI(x)	(x)
152 #define CFG10_ACR(x)	(x << 4)
153 #define CFG10_BOFMET	(1 << 7)
154 	unsigned char  cfg_ifs;
155 	unsigned char  cfg_slotl;
156 	unsigned char  cfg_byte13;
157 #define CFG13_SLOTH(x)	(x)
158 #define CFG13_RETRY(x)	(x << 4)
159 	unsigned char  cfg_byte14;
160 #define CFG14_PROMISC	(1 << 0)
161 #define CFG14_DISBRD	(1 << 1)
162 #define CFG14_MANCH	(1 << 2)
163 #define CFG14_TNCRS	(1 << 3)
164 #define CFG14_NOCRC	(1 << 4)
165 #define CFG14_CRC16	(1 << 5)
166 #define CFG14_BTSTF	(1 << 6)
167 #define CFG14_FLGPAD	(1 << 7)
168 	unsigned char  cfg_byte15;
169 #define CFG15_CSTF(x)	(x)
170 #define CFG15_ICSS	(1 << 3)
171 #define CFG15_CDTF(x)	(x << 4)
172 #define CFG15_ICDS	(1 << 7)
173 	unsigned short cfg_minfrmlen;
174 } cfg_t;
175 
176 typedef struct { /* scb */
177 	unsigned short scb_status;	/* status of 82586			*/
178 #define SCB_STRXMASK		(7 << 4)	/* Receive unit status		*/
179 #define SCB_STRXIDLE		(0 << 4)	/* Idle				*/
180 #define SCB_STRXSUSP		(1 << 4)	/* Suspended			*/
181 #define SCB_STRXNRES		(2 << 4)	/* No resources			*/
182 #define SCB_STRXRDY		(4 << 4)	/* Ready			*/
183 #define SCB_STCUMASK		(7 << 8)	/* Command unit status		*/
184 #define SCB_STCUIDLE		(0 << 8)	/* Idle				*/
185 #define SCB_STCUSUSP		(1 << 8)	/* Suspended			*/
186 #define SCB_STCUACTV		(2 << 8)	/* Active			*/
187 #define SCB_STRNR		(1 << 12)	/* Receive unit not ready	*/
188 #define SCB_STCNA		(1 << 13)	/* Command unit not ready	*/
189 #define SCB_STFR		(1 << 14)	/* Frame received		*/
190 #define SCB_STCX		(1 << 15)	/* Command completed		*/
191 	unsigned short scb_command;	/* Next command				*/
192 #define SCB_CMDRXSTART		(1 << 4)	/* Start (at rfa_offset)	*/
193 #define SCB_CMDRXRESUME		(2 << 4)	/* Resume reception		*/
194 #define SCB_CMDRXSUSPEND	(3 << 4)	/* Suspend reception		*/
195 #define SCB_CMDRXABORT		(4 << 4)	/* Abort reception		*/
196 #define SCB_CMDCUCSTART		(1 << 8)	/* Start (at cbl_offset)	*/
197 #define SCB_CMDCUCRESUME	(2 << 8)	/* Resume execution		*/
198 #define SCB_CMDCUCSUSPEND	(3 << 8)	/* Suspend execution		*/
199 #define SCB_CMDCUCABORT		(4 << 8)	/* Abort execution		*/
200 #define SCB_CMDACKRNR		(1 << 12)	/* Ack RU not ready		*/
201 #define SCB_CMDACKCNA		(1 << 13)	/* Ack CU not ready		*/
202 #define SCB_CMDACKFR		(1 << 14)	/* Ack Frame received		*/
203 #define SCB_CMDACKCX		(1 << 15)	/* Ack Command complete		*/
204 	unsigned short scb_cbl_offset;	/* Offset of first command unit		*/
205 	unsigned short scb_rfa_offset;	/* Offset of first receive frame area	*/
206 	unsigned short scb_crc_errors;	/* Properly aligned frame with CRC error*/
207 	unsigned short scb_aln_errors;	/* Misaligned frames			*/
208 	unsigned short scb_rsc_errors;	/* Frames lost due to no space		*/
209 	unsigned short scb_ovn_errors;	/* Frames lost due to slow bus		*/
210 } scb_t;
211 
212 typedef struct { /* iscp */
213 	unsigned short iscp_busy;	/* set by CPU before CA			*/
214 	unsigned short iscp_offset;	/* offset of SCB			*/
215 	unsigned short iscp_basel;	/* base of SCB				*/
216 	unsigned short iscp_baseh;
217 } iscp_t;
218 
219     /* this address must be 0xfff6 */
220 typedef struct { /* scp */
221 	unsigned short scp_sysbus;	/* bus size */
222 #define SCP_SY_16BBUS	0x00
223 #define SCP_SY_8BBUS	0x01
224 	unsigned short scp_junk[2];	/* junk */
225 	unsigned short scp_iscpl;	/* lower 16 bits of iscp */
226 	unsigned short scp_iscph;	/* upper 16 bits of iscp */
227 } scp_t;
228 
229 /* commands */
230 #define CMD_NOP			0
231 #define CMD_SETADDRESS		1
232 #define CMD_CONFIG		2
233 #define CMD_SETMULTICAST	3
234 #define CMD_TX			4
235 #define CMD_TDR			5
236 #define CMD_DUMP		6
237 #define CMD_DIAGNOSE		7
238 
239 #define CMD_MASK		7
240 
241 #define CMD_INTR		(1 << 13)
242 #define CMD_SUSP		(1 << 14)
243 #define CMD_EOL			(1 << 15)
244 
245 #define STAT_COLLISIONS		(15)
246 #define STAT_COLLEXCESSIVE	(1 << 5)
247 #define STAT_COLLAFTERTX	(1 << 6)
248 #define STAT_TXDEFERRED		(1 << 7)
249 #define STAT_TXSLOWDMA		(1 << 8)
250 #define STAT_TXLOSTCTS		(1 << 9)
251 #define STAT_NOCARRIER		(1 << 10)
252 #define STAT_FAIL		(1 << 11)
253 #define STAT_ABORTED		(1 << 12)
254 #define STAT_OK			(1 << 13)
255 #define STAT_BUSY		(1 << 14)
256 #define STAT_COMPLETE		(1 << 15)
257 #endif
258 #endif
259 
260 /*
261  * Ether1 card definitions:
262  *
263  * FAST accesses:
264  *	+0	Page register
265  * 			16 pages
266  *	+4	Control
267  *			'1' = reset
268  *			'2' = loopback
269  *			'4' = CA
270  *			'8' = int ack
271  *
272  * RAM at address + 0x2000
273  * Pod. Prod id = 3
274  * Words after ID block [base + 8 words]
275  *	+0 pcb issue (0x0c and 0xf3 invalid)
276  *	+1 - +6 eth hw address
277  */
278