xref: /openbmc/linux/drivers/net/fddi/skfp/h/hwmtm.h (revision e8f6f3b4)
1 /******************************************************************************
2  *
3  *	(C)Copyright 1998,1999 SysKonnect,
4  *	a business unit of Schneider & Koch & Co. Datensysteme GmbH.
5  *
6  *	This program is free software; you can redistribute it and/or modify
7  *	it under the terms of the GNU General Public License as published by
8  *	the Free Software Foundation; either version 2 of the License, or
9  *	(at your option) any later version.
10  *
11  *	The information in this file is provided "AS IS" without warranty.
12  *
13  ******************************************************************************/
14 
15 #ifndef	_HWM_
16 #define	_HWM_
17 
18 #include "mbuf.h"
19 
20 /*
21  * MACRO for DMA synchronization:
22  *	The descriptor 'desc' is flushed for the device 'flag'.
23  *	Devices are the CPU (DDI_DMA_SYNC_FORCPU) and the
24  *	adapter (DDI_DMA_SYNC_FORDEV).
25  *
26  *	'desc'	Pointer to a Rx or Tx descriptor.
27  *	'flag'	Flag for direction (view for CPU or DEVICE) that
28  *		should be synchronized.
29  *
30  *	Empty macros and defines are specified here. The real macro
31  *	is os-specific and should be defined in osdef1st.h.
32  */
33 #ifndef DRV_BUF_FLUSH
34 #define DRV_BUF_FLUSH(desc,flag)
35 #define DDI_DMA_SYNC_FORCPU
36 #define DDI_DMA_SYNC_FORDEV
37 #endif
38 
39 	/*
40 	 * hardware modul dependent receive modes
41 	 */
42 #define	RX_ENABLE_PASS_SMT	21
43 #define	RX_DISABLE_PASS_SMT	22
44 #define	RX_ENABLE_PASS_NSA	23
45 #define	RX_DISABLE_PASS_NSA	24
46 #define	RX_ENABLE_PASS_DB	25
47 #define	RX_DISABLE_PASS_DB	26
48 #define	RX_DISABLE_PASS_ALL	27
49 #define	RX_DISABLE_LLC_PROMISC	28
50 #define	RX_ENABLE_LLC_PROMISC	29
51 
52 
53 #ifndef	DMA_RD
54 #define DMA_RD		1	/* memory -> hw */
55 #endif
56 #ifndef DMA_WR
57 #define DMA_WR		2	/* hw -> memory */
58 #endif
59 #define SMT_BUF		0x80
60 
61 	/*
62 	 * bits of the frame status byte
63 	 */
64 #define EN_IRQ_EOF	0x02	/* get IRQ after end of frame transmission */
65 #define	LOC_TX		0x04	/* send frame to the local SMT */
66 #define LAST_FRAG	0x08	/* last TxD of the frame */
67 #define	FIRST_FRAG	0x10	/* first TxD of the frame */
68 #define	LAN_TX		0x20	/* send frame to network if set */
69 #define RING_DOWN	0x40	/* error: unable to send, ring down */
70 #define OUT_OF_TXD	0x80	/* error: not enough TxDs available */
71 
72 
73 #ifndef NULL
74 #define NULL 		0
75 #endif
76 
77 #ifdef	LITTLE_ENDIAN
78 #define HWM_REVERSE(x)	(x)
79 #else
80 #define	HWM_REVERSE(x)		((((x)<<24L)&0xff000000L)	+	\
81 				 (((x)<< 8L)&0x00ff0000L)	+	\
82 				 (((x)>> 8L)&0x0000ff00L)	+	\
83 				 (((x)>>24L)&0x000000ffL))
84 #endif
85 
86 #define C_INDIC		(1L<<25)
87 #define A_INDIC		(1L<<26)
88 #define	RD_FS_LOCAL	0x80
89 
90 	/*
91 	 * DEBUG FLAGS
92 	 */
93 #define	DEBUG_SMTF	1
94 #define	DEBUG_SMT	2
95 #define	DEBUG_ECM	3
96 #define	DEBUG_RMT	4
97 #define	DEBUG_CFM	5
98 #define	DEBUG_PCM	6
99 #define	DEBUG_SBA	7
100 #define	DEBUG_ESS	8
101 
102 #define	DB_HWM_RX	10
103 #define	DB_HWM_TX	11
104 #define DB_HWM_GEN	12
105 
106 struct s_mbuf_pool {
107 #ifndef	MB_OUTSIDE_SMC
108 	SMbuf		mb[MAX_MBUF] ;		/* mbuf pool */
109 #endif
110 	SMbuf		*mb_start ;		/* points to the first mb */
111 	SMbuf		*mb_free ;		/* free queue */
112 } ;
113 
114 struct hwm_r {
115 	/*
116 	 * hardware modul specific receive variables
117 	 */
118 	u_int			len ;		/* length of the whole frame */
119 	char			*mb_pos ;	/* SMbuf receive position */
120 } ;
121 
122 struct hw_modul {
123 	/*
124 	 * All hardware modul specific variables
125 	 */
126 	struct	s_mbuf_pool	mbuf_pool ;
127 	struct	hwm_r	r ;
128 
129 	union s_fp_descr volatile *descr_p ; /* points to the desriptor area */
130 
131 	u_short pass_SMT ;		/* pass SMT frames */
132 	u_short pass_NSA ;		/* pass all NSA frames */
133 	u_short pass_DB ;		/* pass Direct Beacon Frames */
134 	u_short pass_llc_promisc ;	/* pass all llc frames (default ON) */
135 
136 	SMbuf	*llc_rx_pipe ;		/* points to the first queued llc fr */
137 	SMbuf	*llc_rx_tail ;		/* points to the last queued llc fr */
138 	int	queued_rx_frames ;	/* number of queued frames */
139 
140 	SMbuf	*txd_tx_pipe ;		/* points to first mb in the txd ring */
141 	SMbuf	*txd_tx_tail ;		/* points to last mb in the txd ring */
142 	int	queued_txd_mb ;		/* number of SMT MBufs in txd ring */
143 
144 	int	rx_break ;		/* rev. was breaked because ind. off */
145 	int	leave_isr ;		/* leave fddi_isr immedeately if set */
146 	int	isr_flag ;		/* set, when HWM is entered from isr */
147 	/*
148 	 * variables for the current transmit frame
149 	 */
150 	struct s_smt_tx_queue *tx_p ;	/* pointer to the transmit queue */
151 	u_long	tx_descr ;		/* tx descriptor for FORMAC+ */
152 	int	tx_len ;		/* tx frame length */
153 	SMbuf	*tx_mb ;		/* SMT tx MBuf pointer */
154 	char	*tx_data ;		/* data pointer to the SMT tx Mbuf */
155 
156 	int	detec_count ;		/* counter for out of RxD condition */
157 	u_long	rx_len_error ;		/* rx len FORMAC != sum of fragments */
158 } ;
159 
160 
161 /*
162  * DEBUG structs and macros
163  */
164 
165 #ifdef	DEBUG
166 struct os_debug {
167 	int	hwm_rx ;
168 	int	hwm_tx ;
169 	int	hwm_gen ;
170 } ;
171 #endif
172 
173 #ifdef	DEBUG
174 #ifdef	DEBUG_BRD
175 #define	DB_P	smc->debug
176 #else
177 #define DB_P	debug
178 #endif
179 
180 #define DB_RX(a,b,c,lev) if (DB_P.d_os.hwm_rx >= (lev))	printf(a,b,c)
181 #define DB_TX(a,b,c,lev) if (DB_P.d_os.hwm_tx >= (lev))	printf(a,b,c)
182 #define DB_GEN(a,b,c,lev) if (DB_P.d_os.hwm_gen >= (lev)) printf(a,b,c)
183 #else	/* DEBUG */
184 #define DB_RX(a,b,c,lev)
185 #define DB_TX(a,b,c,lev)
186 #define DB_GEN(a,b,c,lev)
187 #endif	/* DEBUG */
188 
189 #ifndef	SK_BREAK
190 #define	SK_BREAK()
191 #endif
192 
193 
194 /*
195  * HWM Macros
196  */
197 
198 /*
199  *	BEGIN_MANUAL_ENTRY(HWM_GET_TX_PHYS)
200  *	u_long HWM_GET_TX_PHYS(txd)
201  *
202  * function	MACRO		(hardware module, hwmtm.h)
203  *		This macro may be invoked by the OS-specific module to read
204  *		the physical address of the specified TxD.
205  *
206  * para	txd	pointer to the TxD
207  *
208  *	END_MANUAL_ENTRY
209  */
210 #define	HWM_GET_TX_PHYS(txd)		(u_long)AIX_REVERSE((txd)->txd_tbadr)
211 
212 /*
213  *	BEGIN_MANUAL_ENTRY(HWM_GET_TX_LEN)
214  *	int HWM_GET_TX_LEN(txd)
215  *
216  * function	MACRO		(hardware module, hwmtm.h)
217  *		This macro may be invoked by the OS-specific module to read
218  *		the fragment length of the specified TxD
219  *
220  * para	rxd	pointer to the TxD
221  *
222  * return	the length of the fragment in bytes
223  *
224  *	END_MANUAL_ENTRY
225  */
226 #define	HWM_GET_TX_LEN(txd)	((int)AIX_REVERSE((txd)->txd_tbctrl)& RD_LENGTH)
227 
228 /*
229  *	BEGIN_MANUAL_ENTRY(HWM_GET_TX_USED)
230  *	txd *HWM_GET_TX_USED(smc,queue)
231  *
232  * function	MACRO		(hardware module, hwmtm.h)
233  *		This macro may be invoked by the OS-specific module to get the
234  *		number of used TxDs for the queue, specified by the index.
235  *
236  * para	queue	the number of the send queue: Can be specified by
237  *		QUEUE_A0, QUEUE_S or (frame_status & QUEUE_A0)
238  *
239  * return	number of used TxDs for this send queue
240  *
241  *	END_MANUAL_ENTRY
242  */
243 #define	HWM_GET_TX_USED(smc,queue)	(int) (smc)->hw.fp.tx_q[queue].tx_used
244 
245 /*
246  *	BEGIN_MANUAL_ENTRY(HWM_GET_CURR_TXD)
247  *	txd *HWM_GET_CURR_TXD(smc,queue)
248  *
249  * function	MACRO		(hardware module, hwmtm.h)
250  *		This macro may be invoked by the OS-specific module to get the
251  *		pointer to the TxD which points to the current queue put
252  *		position.
253  *
254  * para	queue	the number of the send queue: Can be specified by
255  *		QUEUE_A0, QUEUE_S or (frame_status & QUEUE_A0)
256  *
257  * return	pointer to the current TxD
258  *
259  *	END_MANUAL_ENTRY
260  */
261 #define	HWM_GET_CURR_TXD(smc,queue)	(struct s_smt_fp_txd volatile *)\
262 					(smc)->hw.fp.tx_q[queue].tx_curr_put
263 
264 /*
265  *	BEGIN_MANUAL_ENTRY(HWM_GET_RX_FRAG_LEN)
266  *	int HWM_GET_RX_FRAG_LEN(rxd)
267  *
268  * function	MACRO		(hardware module, hwmtm.h)
269  *		This macro may be invoked by the OS-specific module to read
270  *		the fragment length of the specified RxD
271  *
272  * para	rxd	pointer to the RxD
273  *
274  * return	the length of the fragment in bytes
275  *
276  *	END_MANUAL_ENTRY
277  */
278 #define	HWM_GET_RX_FRAG_LEN(rxd)	((int)AIX_REVERSE((rxd)->rxd_rbctrl)& \
279 				RD_LENGTH)
280 
281 /*
282  *	BEGIN_MANUAL_ENTRY(HWM_GET_RX_PHYS)
283  *	u_long HWM_GET_RX_PHYS(rxd)
284  *
285  * function	MACRO		(hardware module, hwmtm.h)
286  *		This macro may be invoked by the OS-specific module to read
287  *		the physical address of the specified RxD.
288  *
289  * para	rxd	pointer to the RxD
290  *
291  * return	the RxD's physical pointer to the data fragment
292  *
293  *	END_MANUAL_ENTRY
294  */
295 #define	HWM_GET_RX_PHYS(rxd)	(u_long)AIX_REVERSE((rxd)->rxd_rbadr)
296 
297 /*
298  *	BEGIN_MANUAL_ENTRY(HWM_GET_RX_USED)
299  *	int HWM_GET_RX_USED(smc)
300  *
301  * function	MACRO		(hardware module, hwmtm.h)
302  *		This macro may be invoked by the OS-specific module to get
303  *		the count of used RXDs in receive queue 1.
304  *
305  * return	the used RXD count of receive queue 1
306  *
307  * NOTE: Remember, because of an ASIC bug at least one RXD should be unused
308  *	 in the descriptor ring !
309  *
310  *	END_MANUAL_ENTRY
311  */
312 #define	HWM_GET_RX_USED(smc)	((int)(smc)->hw.fp.rx_q[QUEUE_R1].rx_used)
313 
314 /*
315  *	BEGIN_MANUAL_ENTRY(HWM_GET_RX_FREE)
316  *	int HWM_GET_RX_FREE(smc)
317  *
318  * function	MACRO		(hardware module, hwmtm.h)
319  *		This macro may be invoked by the OS-specific module to get
320  *		the rxd_free count of receive queue 1.
321  *
322  * return	the rxd_free count of receive queue 1
323  *
324  *	END_MANUAL_ENTRY
325  */
326 #define	HWM_GET_RX_FREE(smc)	((int)(smc)->hw.fp.rx_q[QUEUE_R1].rx_free-1)
327 
328 /*
329  *	BEGIN_MANUAL_ENTRY(HWM_GET_CURR_RXD)
330  *	rxd *HWM_GET_CURR_RXD(smc)
331  *
332  * function	MACRO		(hardware module, hwmtm.h)
333  *		This macro may be invoked by the OS-specific module to get the
334  *		pointer to the RxD which points to the current queue put
335  *		position.
336  *
337  * return	pointer to the current RxD
338  *
339  *	END_MANUAL_ENTRY
340  */
341 #define	HWM_GET_CURR_RXD(smc)	(struct s_smt_fp_rxd volatile *)\
342 				(smc)->hw.fp.rx_q[QUEUE_R1].rx_curr_put
343 
344 /*
345  *	BEGIN_MANUAL_ENTRY(HWM_RX_CHECK)
346  *	void HWM_RX_CHECK(smc,low_water)
347  *
348  * function	MACRO		(hardware module, hwmtm.h)
349  *		This macro is invoked by the OS-specific before it left the
350  *		function mac_drv_rx_complete. This macro calls mac_drv_fill_rxd
351  *		if the number of used RxDs is equal or lower than the
352  *		the given low water mark.
353  *
354  * para	low_water	low water mark of used RxD's
355  *
356  *	END_MANUAL_ENTRY
357  */
358 #ifndef HWM_NO_FLOW_CTL
359 #define	HWM_RX_CHECK(smc,low_water) {\
360 	if ((low_water) >= (smc)->hw.fp.rx_q[QUEUE_R1].rx_used) {\
361 		mac_drv_fill_rxd(smc) ;\
362 	}\
363 }
364 #else
365 #define	HWM_RX_CHECK(smc,low_water)		mac_drv_fill_rxd(smc)
366 #endif
367 
368 #ifndef	HWM_EBASE
369 #define	HWM_EBASE	500
370 #endif
371 
372 #define	HWM_E0001	HWM_EBASE + 1
373 #define	HWM_E0001_MSG	"HWM: Wrong size of s_rxd_os struct"
374 #define	HWM_E0002	HWM_EBASE + 2
375 #define	HWM_E0002_MSG	"HWM: Wrong size of s_txd_os struct"
376 #define	HWM_E0003	HWM_EBASE + 3
377 #define	HWM_E0003_MSG	"HWM: smt_free_mbuf() called with NULL pointer"
378 #define	HWM_E0004	HWM_EBASE + 4
379 #define	HWM_E0004_MSG	"HWM: Parity error rx queue 1"
380 #define	HWM_E0005	HWM_EBASE + 5
381 #define	HWM_E0005_MSG	"HWM: Encoding error rx queue 1"
382 #define	HWM_E0006	HWM_EBASE + 6
383 #define	HWM_E0006_MSG	"HWM: Encoding error async tx queue"
384 #define	HWM_E0007	HWM_EBASE + 7
385 #define	HWM_E0007_MSG	"HWM: Encoding error sync tx queue"
386 #define	HWM_E0008	HWM_EBASE + 8
387 #define	HWM_E0008_MSG	""
388 #define	HWM_E0009	HWM_EBASE + 9
389 #define	HWM_E0009_MSG	"HWM: Out of RxD condition detected"
390 #define	HWM_E0010	HWM_EBASE + 10
391 #define	HWM_E0010_MSG	"HWM: A protocol layer has tried to send a frame with an invalid frame control"
392 #define HWM_E0011	HWM_EBASE + 11
393 #define HWM_E0011_MSG	"HWM: mac_drv_clear_tx_queue was called although the hardware wasn't stopped"
394 #define HWM_E0012	HWM_EBASE + 12
395 #define HWM_E0012_MSG	"HWM: mac_drv_clear_rx_queue was called although the hardware wasn't stopped"
396 #define HWM_E0013	HWM_EBASE + 13
397 #define HWM_E0013_MSG	"HWM: mac_drv_repair_descr was called although the hardware wasn't stopped"
398 
399 #endif
400