if_npereg.h revision 164426
1/*-
2 * Copyright (c) 2006 Sam Leffler, Errno Consulting
3 * All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * 1. Redistributions of source code must retain the above copyright
9 *    notice, this list of conditions and the following disclaimer,
10 *    without modification.
11 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
12 *    similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any
13 *    redistribution must be conditioned upon including a substantially
14 *    similar Disclaimer requirement for further binary redistribution.
15 *
16 * NO WARRANTY
17 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
18 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
19 * LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY
20 * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
21 * THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY,
22 * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
23 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
24 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
25 * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
26 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
27 * THE POSSIBILITY OF SUCH DAMAGES.
28 *
29 * $FreeBSD: head/sys/arm/xscale/ixp425/if_npereg.h 164426 2006-11-19 23:55:23Z sam $
30 */
31
32/*
33 * Copyright (c) 2001-2005, Intel Corporation.
34 * All rights reserved.
35 *
36 * Redistribution and use in source and binary forms, with or without
37 * modification, are permitted provided that the following conditions
38 * are met:
39 * 1. Redistributions of source code must retain the above copyright
40 *    notice, this list of conditions and the following disclaimer.
41 * 2. Redistributions in binary form must reproduce the above copyright
42 *    notice, this list of conditions and the following disclaimer in the
43 *    documentation and/or other materials provided with the distribution.
44 * 3. Neither the name of the Intel Corporation nor the names of its contributors
45 *    may be used to endorse or promote products derived from this software
46 *    without specific prior written permission.
47 *
48 *
49 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS''
50 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
51 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
52 * ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
53 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
54 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
55 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
56 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
57 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
58 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
59 * SUCH DAMAGE.
60 */
61
62#ifndef ARM_XSCALE_IF_NPEREG_H
63#define	ARM_XSCALE_IF_NPEREG_H
64
65/*
66 * NPE/NPE tx/rx descriptor format.  This is just the area
67 * shared with ucode running in the NPE; the driver-specific
68 * state is defined in the driver.  The shared area must be
69 * cacheline-aligned.  We allocate NPE_MAXSEG "descriptors"
70 * per buffer; this allows us to do minimal s/g.  The number
71 * of descriptors can be expanded but doing so uses memory
72 * so should be done with care.
73 *
74 * The driver sets up buffers in uncached memory.
75 */
76#define	NPE_MAXSEG	3		/* empirically selected */
77
78struct npehwbuf {
79	struct {			/* NPE shared area, cacheline aligned */
80		uint32_t next;		/* phys addr of next segment */
81		uint32_t len;		/* buffer/segment length (bytes) */
82		uint32_t data;		/* phys addr of data segment */
83		uint32_t pad[5];	/* pad to cacheline */
84	} ix_ne[NPE_MAXSEG];
85};
86
87/* NPE ID's */
88#define	NPE_A		0
89#define	NPE_B		1
90#define	NPE_C		2
91#define	NPE_MAX		(NPE_C+1)
92
93#define NPE_PORTS_MAX		2	/* logical ports */
94#define NPE_FRAME_SIZE_DEFAULT	1536
95#define NPE_FRAME_SIZE_MAX	(65536-64)
96#define NPE_FRAME_SIZE_MIN	64
97
98/*
99 * Queue Manager-related definitions.
100 *
101 * These define the layout of 32-bit Q entries passed
102 * between the host cpu and the NPE's.
103 */
104#define	NPE_QM_Q_NPE(e)		(((e)>>0)&0x3)		/* NPE ID */
105#define	NPE_QM_Q_PORT(e)	(((e)>>3)&0x1)		/* Port ID */
106#define	NPE_QM_Q_PRIO(e)	(((e)>>0)&0x3)		/* 802.1d priority */
107#define	NPE_QM_Q_ADDR(e)	((e)&0xfffffffe0)	/* phys address */
108
109/*
110 * Host->NPE requests written to the shared mailbox.
111 * The NPE writes the same value back as an ACK.
112 */
113#define	NPE_GETSTATUS		0x00	/* get firmware revision */
114#define	NPE_SETPORTADDRESS	0x01	/* set port id and mac address */
115#define	NPE_GETMACADDRDB	0x02	/* upload filter database */
116#define	NPE_SETMACADDRDB	0x03	/* download filter database */
117#define	NPE_GETSTATS		0x04	/* get statistics */
118#define	NPE_RESETSTATS		0x05	/* reset stats + return result */
119#define	NPE_SETMAXFRAME		0x06	/* configure max tx/rx frame lengths */
120#define	NPE_SETRXTAGMODE	0x07	/* configure VLAN rx operating mode */
121#define	NPE_SETDEFRXVID		0x08	/* set def VLAN tag + traffic class */
122#define	NPE_SETRXQOSENTRY	0x0b	/* map user pri -> QoS class+rx qid */
123#define	NPE_SETFIREWALLMODE	0x0e	/* config firewall services */
124#define	NPE_SETLOOPBACK		0x12	/* enable/disable loopback */
125/* ... XXX more */
126
127#define	NPE_MAC_MSGID_SHL	24
128#define	NPE_MAC_PORTID_SHL	16
129
130/*
131 * MAC register definitions; see section
132 * 15.2 of the Intel Developers Manual.
133 */
134#define	NPE_MAC_TX_CNTRL1	0x000
135#define	NPE_MAC_TX_CNTRL2	0x004
136#define	NPE_MAC_RX_CNTRL1	0x010
137#define	NPE_MAC_RX_CNTRL2	0x014
138#define	NPE_MAC_RANDOM_SEED	0x020
139#define	NPE_MAC_THRESH_P_EMPTY	0x030
140#define	NPE_MAC_THRESH_P_FULL	0x038
141#define	NPE_MAC_BUF_SIZE_TX	0x040
142#define	NPE_MAC_TX_DEFER	0x050
143#define	NPE_MAC_RX_DEFER	0x054
144#define	NPE_MAC_TX_TWO_DEFER_1	0x060
145#define	NPE_MAC_TX_TWO_DEFER_2	0x064
146#define	NPE_MAC_SLOT_TIME	0x070
147#define	NPE_MAC_MDIO_CMD_1	0x080
148#define	NPE_MAC_MDIO_CMD_2	0x084
149#define	NPE_MAC_MDIO_CMD_3	0x088
150#define	NPE_MAC_MDIO_CMD_4	0x08c
151#define	NPE_MAC_MDIO_STS_1	0x090
152#define	NPE_MAC_MDIO_STS_2	0x094
153#define	NPE_MAC_MDIO_STS_3	0x098
154#define	NPE_MAC_MDIO_STS_4	0x09c
155#define	NPE_MAC_ADDR_MASK_1	0x0A0
156#define	NPE_MAC_ADDR_MASK_2	0x0A4
157#define	NPE_MAC_ADDR_MASK_3	0x0A8
158#define	NPE_MAC_ADDR_MASK_4	0x0AC
159#define	NPE_MAC_ADDR_MASK_5	0x0B0
160#define	NPE_MAC_ADDR_MASK_6	0x0B4
161#define	NPE_MAC_ADDR_1		0x0C0
162#define	NPE_MAC_ADDR_2		0x0C4
163#define	NPE_MAC_ADDR_3		0x0C8
164#define	NPE_MAC_ADDR_4		0x0CC
165#define	NPE_MAC_ADDR_5		0x0D0
166#define	NPE_MAC_ADDR_6		0x0D4
167#define	NPE_MAC_INT_CLK_THRESH	0x0E0
168#define	NPE_MAC_UNI_ADDR_1	0x0F0
169#define	NPE_MAC_UNI_ADDR_2	0x0F4
170#define	NPE_MAC_UNI_ADDR_3	0x0F8
171#define	NPE_MAC_UNI_ADDR_4	0x0FC
172#define	NPE_MAC_UNI_ADDR_5	0x100
173#define	NPE_MAC_UNI_ADDR_6	0x104
174#define	NPE_MAC_CORE_CNTRL	0x1FC
175
176#define	NPE_MAC_ADDR_MASK(i)    (NPE_MAC_ADDR_MASK_1 + ((i)<<2))
177#define	NPE_MAC_ADDR(i)     	(NPE_MAC_ADDR_1 + ((i)<<2))
178#define	NPE_MAC_UNI_ADDR(i)    	(NPE_MAC_UNI_ADDR_1 + ((i)<<2))
179
180/*
181 * Bit definitions
182 */
183
184/* TX Control Register 1*/
185#define	NPE_TX_CNTRL1_TX_EN		0x01	/* enable TX engine */
186#define	NPE_TX_CNTRL1_DUPLEX		0x02	/* select half duplex */
187#define	NPE_TX_CNTRL1_RETRY		0x04	/* auto-retry on collision */
188#define	NPE_TX_CNTRL1_PAD_EN		0x08	/* pad frames <64 bytes */
189#define	NPE_TX_CNTRL1_FCS_EN		0x10	/* append FCS */
190#define	NPE_TX_CNTRL1_2DEFER		0x20	/* select 2-part deferral */
191#define	NPE_TX_CNTRL1_RMII		0x40
192
193/* TX Control Register 2 */
194#define	NPE_TX_CNTRL2_RETRIES_MASK	0xf	/* max retry count */
195
196/* RX Control Register 1 */
197#define	NPE_RX_CNTRL1_RX_EN		0x01	/* enable RX engine */
198#define	NPE_RX_CNTRL1_PADSTRIP_EN	0x02	/* strip frame padding */
199#define	NPE_RX_CNTRL1_CRC_EN		0x04	/* include CRC in RX frame */
200#define	NPE_RX_CNTRL1_PAUSE_EN		0x08	/* detect Pause frames */
201#define	NPE_RX_CNTRL1_LOOP_EN		0x10	/* loopback tx/rx */
202#define	NPE_RX_CNTRL1_ADDR_FLTR_EN	0x20	/* enable address filtering */
203#define	NPE_RX_CNTRL1_RX_RUNT_EN	0x40	/* enable RX of runt frames */
204#define	NPE_RX_CNTRL1_BCAST_DIS		0x80	/* discard broadcast frames */
205
206/* RX Control Register 2 */
207#define	NPE_RX_CNTRL2_DEFER_EN	0x01
208
209/* Core Control Register */
210#define	NPE_CORE_RESET			0x01	/* MAC reset state */
211#define	NPE_CORE_RX_FIFO_FLUSH		0x02	/* flush RX FIFO */
212#define	NPE_CORE_TX_FIFO_FLUSH		0x04	/* flush TX FIFO */
213#define	NPE_CORE_SEND_JAM		0x08	/* send JAM on packet RX */
214#define	NPE_CORE_MDC_EN			0x10	/* IXP42X drives MDC clock */
215
216/*
217 * Stat block returned by NPE with NPE_GETSTATS msg.
218 */
219struct npestats {
220	uint32_t dot3StatsAlignmentErrors;
221	uint32_t dot3StatsFCSErrors;
222	uint32_t dot3StatsInternalMacReceiveErrors;
223	uint32_t RxOverrunDiscards;
224	uint32_t RxLearnedEntryDiscards;
225	uint32_t RxLargeFramesDiscards;
226	uint32_t RxSTPBlockedDiscards;
227	uint32_t RxVLANTypeFilterDiscards;
228	uint32_t RxVLANIdFilterDiscards;
229	uint32_t RxInvalidSourceDiscards;
230	uint32_t RxBlackListDiscards;
231	uint32_t RxWhiteListDiscards;
232	uint32_t RxUnderflowEntryDiscards;
233	uint32_t dot3StatsSingleCollisionFrames;
234	uint32_t dot3StatsMultipleCollisionFrames;
235	uint32_t dot3StatsDeferredTransmissions;
236	uint32_t dot3StatsLateCollisions;
237	uint32_t dot3StatsExcessiveCollisions;
238	uint32_t dot3StatsInternalMacTransmitErrors;
239	uint32_t dot3StatsCarrierSenseErrors;
240	uint32_t TxLargeFrameDiscards;
241	uint32_t TxVLANIdFilterDiscards;
242};
243
244/*
245 * Default values
246 */
247#define NPE_MAC_INT_CLK_THRESH_DEFAULT  0x1
248
249#define NPE_MAC_RESET_DELAY    1
250
251/* This value applies to RMII */
252#define NPE_MAC_SLOT_TIME_RMII_DEFAULT  0xFF
253
254/*
255 * MII definitions - these have been verified against the LXT971 and LXT972 PHYs
256 */
257#define	NPE_MII_REG_SHL		16
258#define	NPE_MII_ADDR_SHL	21
259
260/* NB: shorthands for mii bus mdio routines */
261#define	NPE_MAC_MDIO_CMD	NPE_MAC_MDIO_CMD_1
262#define	NPE_MAC_MDIO_STS	NPE_MAC_MDIO_STS_1
263
264#define NPE_MII_GO                  (1<<31)
265#define NPE_MII_WRITE               (1<<26)
266#define NPE_MII_TIMEOUT_10TH_SECS        5
267#define NPE_MII_10TH_SEC_IN_MILLIS     100
268#define NPE_MII_READ_FAIL           (1<<31)
269
270#define NPE_MII_PHY_DEF_DELAY	300	/* max delay before link up, etc. */
271#define NPE_MII_PHY_NO_DELAY	0x0	/* do not delay */
272#define NPE_MII_PHY_NULL	0xff	/* PHY is not present */
273#define NPE_MII_PHY_DEF_ADDR	0x0	/* default PHY's logical address */
274
275/* Register definition */
276#define NPE_MII_CTRL_REG	0x0	/* Control Register */
277#define NPE_MII_STAT_REG	0x1	/* Status Register */
278#define NPE_MII_PHY_ID1_REG	0x2	/* PHY identifier 1 Register */
279#define NPE_MII_PHY_ID2_REG	0x3	/* PHY identifier 2 Register */
280#define NPE_MII_AN_ADS_REG	0x4	/* Auto-Negotiation 	  */
281					/* Advertisement Register */
282#define NPE_MII_AN_PRTN_REG	0x5	/* Auto-Negotiation 	    */
283					/* partner ability Register */
284#define NPE_MII_AN_EXP_REG	0x6	/* Auto-Negotiation   */
285					/* Expansion Register */
286#define NPE_MII_AN_NEXT_REG	0x7	/* Auto-Negotiation 	       */
287					/* next-page transmit Register */
288#endif /* ARM_XSCALE_IF_NPEREG_H */
289