if_npereg.h revision 186352
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 186352 2008-12-20 03:26:09Z 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#define NPE_PORTS_MAX		2	/* logical ports */
88#define NPE_FRAME_SIZE_DEFAULT	1536
89#define NPE_FRAME_SIZE_MAX	(65536-64)
90#define NPE_FRAME_SIZE_MIN	64
91
92/*
93 * Queue Manager-related definitions.
94 *
95 * These define the layout of 32-bit Q entries passed
96 * between the host cpu and the NPE's.
97 */
98#define	NPE_QM_Q_NPE(e)		(((e)>>0)&0x3)		/* NPE ID */
99#define	NPE_QM_Q_PORT(e)	(((e)>>3)&0x1)		/* Port ID */
100#define	NPE_QM_Q_PRIO(e)	(((e)>>0)&0x3)		/* 802.1d priority */
101#define	NPE_QM_Q_ADDR(e)	((e)&0xfffffffe0)	/* phys address */
102
103/*
104 * Host->NPE requests written to the shared mailbox.
105 * The NPE writes the same value back as an ACK.
106 */
107#define	NPE_GETSTATUS		0x00	/* get firmware revision */
108#define	NPE_SETPORTADDRESS	0x01	/* set port id and mac address */
109#define	NPE_GETMACADDRDB	0x02	/* upload filter database */
110#define	NPE_SETMACADDRDB	0x03	/* download filter database */
111#define	NPE_GETSTATS		0x04	/* get statistics */
112#define	NPE_RESETSTATS		0x05	/* reset stats + return result */
113#define	NPE_SETMAXFRAME		0x06	/* configure max tx/rx frame lengths */
114#define	NPE_SETRXTAGMODE	0x07	/* configure VLAN rx operating mode */
115#define	NPE_SETDEFRXVID		0x08	/* set def VLAN tag + traffic class */
116#define	NPE_SETRXQOSENTRY	0x0b	/* map user pri -> QoS class+rx qid */
117#define	NPE_SETFIREWALLMODE	0x0e	/* config firewall services */
118#define	NPE_SETLOOPBACK		0x12	/* enable/disable loopback */
119/* ... XXX more */
120
121#define	NPE_MAC_MSGID_SHL	24
122#define	NPE_MAC_PORTID_SHL	16
123
124/*
125 * MAC register definitions; see section
126 * 15.2 of the Intel Developers Manual.
127 */
128#define	NPE_MAC_TX_CNTRL1	0x000
129#define	NPE_MAC_TX_CNTRL2	0x004
130#define	NPE_MAC_RX_CNTRL1	0x010
131#define	NPE_MAC_RX_CNTRL2	0x014
132#define	NPE_MAC_RANDOM_SEED	0x020
133#define	NPE_MAC_THRESH_P_EMPTY	0x030
134#define	NPE_MAC_THRESH_P_FULL	0x038
135#define	NPE_MAC_BUF_SIZE_TX	0x040
136#define	NPE_MAC_TX_DEFER	0x050
137#define	NPE_MAC_RX_DEFER	0x054
138#define	NPE_MAC_TX_TWO_DEFER_1	0x060
139#define	NPE_MAC_TX_TWO_DEFER_2	0x064
140#define	NPE_MAC_SLOT_TIME	0x070
141#define	NPE_MAC_MDIO_CMD_1	0x080
142#define	NPE_MAC_MDIO_CMD_2	0x084
143#define	NPE_MAC_MDIO_CMD_3	0x088
144#define	NPE_MAC_MDIO_CMD_4	0x08c
145#define	NPE_MAC_MDIO_STS_1	0x090
146#define	NPE_MAC_MDIO_STS_2	0x094
147#define	NPE_MAC_MDIO_STS_3	0x098
148#define	NPE_MAC_MDIO_STS_4	0x09c
149#define	NPE_MAC_ADDR_MASK_1	0x0A0
150#define	NPE_MAC_ADDR_MASK_2	0x0A4
151#define	NPE_MAC_ADDR_MASK_3	0x0A8
152#define	NPE_MAC_ADDR_MASK_4	0x0AC
153#define	NPE_MAC_ADDR_MASK_5	0x0B0
154#define	NPE_MAC_ADDR_MASK_6	0x0B4
155#define	NPE_MAC_ADDR_1		0x0C0
156#define	NPE_MAC_ADDR_2		0x0C4
157#define	NPE_MAC_ADDR_3		0x0C8
158#define	NPE_MAC_ADDR_4		0x0CC
159#define	NPE_MAC_ADDR_5		0x0D0
160#define	NPE_MAC_ADDR_6		0x0D4
161#define	NPE_MAC_INT_CLK_THRESH	0x0E0
162#define	NPE_MAC_UNI_ADDR_1	0x0F0
163#define	NPE_MAC_UNI_ADDR_2	0x0F4
164#define	NPE_MAC_UNI_ADDR_3	0x0F8
165#define	NPE_MAC_UNI_ADDR_4	0x0FC
166#define	NPE_MAC_UNI_ADDR_5	0x100
167#define	NPE_MAC_UNI_ADDR_6	0x104
168#define	NPE_MAC_CORE_CNTRL	0x1FC
169
170#define	NPE_MAC_ADDR_MASK(i)    (NPE_MAC_ADDR_MASK_1 + ((i)<<2))
171#define	NPE_MAC_ADDR(i)     	(NPE_MAC_ADDR_1 + ((i)<<2))
172#define	NPE_MAC_UNI_ADDR(i)    	(NPE_MAC_UNI_ADDR_1 + ((i)<<2))
173
174/*
175 * Bit definitions
176 */
177
178/* TX Control Register 1*/
179#define	NPE_TX_CNTRL1_TX_EN		0x01	/* enable TX engine */
180#define	NPE_TX_CNTRL1_DUPLEX		0x02	/* select half duplex */
181#define	NPE_TX_CNTRL1_RETRY		0x04	/* auto-retry on collision */
182#define	NPE_TX_CNTRL1_PAD_EN		0x08	/* pad frames <64 bytes */
183#define	NPE_TX_CNTRL1_FCS_EN		0x10	/* append FCS */
184#define	NPE_TX_CNTRL1_2DEFER		0x20	/* select 2-part deferral */
185#define	NPE_TX_CNTRL1_RMII		0x40
186
187/* TX Control Register 2 */
188#define	NPE_TX_CNTRL2_RETRIES_MASK	0xf	/* max retry count */
189
190/* RX Control Register 1 */
191#define	NPE_RX_CNTRL1_RX_EN		0x01	/* enable RX engine */
192#define	NPE_RX_CNTRL1_PADSTRIP_EN	0x02	/* strip frame padding */
193#define	NPE_RX_CNTRL1_CRC_EN		0x04	/* include CRC in RX frame */
194#define	NPE_RX_CNTRL1_PAUSE_EN		0x08	/* detect Pause frames */
195#define	NPE_RX_CNTRL1_LOOP_EN		0x10	/* loopback tx/rx */
196#define	NPE_RX_CNTRL1_ADDR_FLTR_EN	0x20	/* enable address filtering */
197#define	NPE_RX_CNTRL1_RX_RUNT_EN	0x40	/* enable RX of runt frames */
198#define	NPE_RX_CNTRL1_BCAST_DIS		0x80	/* discard broadcast frames */
199
200/* RX Control Register 2 */
201#define	NPE_RX_CNTRL2_DEFER_EN	0x01
202
203/* Core Control Register */
204#define	NPE_CORE_RESET			0x01	/* MAC reset state */
205#define	NPE_CORE_RX_FIFO_FLUSH		0x02	/* flush RX FIFO */
206#define	NPE_CORE_TX_FIFO_FLUSH		0x04	/* flush TX FIFO */
207#define	NPE_CORE_SEND_JAM		0x08	/* send JAM on packet RX */
208#define	NPE_CORE_MDC_EN			0x10	/* IXP42X drives MDC clock */
209
210/*
211 * Stat block returned by NPE with NPE_GETSTATS msg.
212 */
213struct npestats {
214	uint32_t dot3StatsAlignmentErrors;
215	uint32_t dot3StatsFCSErrors;
216	uint32_t dot3StatsInternalMacReceiveErrors;
217	uint32_t RxOverrunDiscards;
218	uint32_t RxLearnedEntryDiscards;
219	uint32_t RxLargeFramesDiscards;
220	uint32_t RxSTPBlockedDiscards;
221	uint32_t RxVLANTypeFilterDiscards;
222	uint32_t RxVLANIdFilterDiscards;
223	uint32_t RxInvalidSourceDiscards;
224	uint32_t RxBlackListDiscards;
225	uint32_t RxWhiteListDiscards;
226	uint32_t RxUnderflowEntryDiscards;
227	uint32_t dot3StatsSingleCollisionFrames;
228	uint32_t dot3StatsMultipleCollisionFrames;
229	uint32_t dot3StatsDeferredTransmissions;
230	uint32_t dot3StatsLateCollisions;
231	uint32_t dot3StatsExcessiveCollisions;
232	uint32_t dot3StatsInternalMacTransmitErrors;
233	uint32_t dot3StatsCarrierSenseErrors;
234	uint32_t TxLargeFrameDiscards;
235	uint32_t TxVLANIdFilterDiscards;
236};
237
238/*
239 * Default values
240 */
241#define NPE_MAC_INT_CLK_THRESH_DEFAULT  0x1
242
243#define NPE_MAC_RESET_DELAY    1
244
245/* This value applies to RMII */
246#define NPE_MAC_SLOT_TIME_RMII_DEFAULT  0xFF
247
248/*
249 * MII definitions - these have been verified against the LXT971 and LXT972 PHYs
250 */
251#define	NPE_MII_REG_SHL		16
252#define	NPE_MII_ADDR_SHL	21
253
254/* NB: shorthands for mii bus mdio routines */
255#define	NPE_MAC_MDIO_CMD	NPE_MAC_MDIO_CMD_1
256#define	NPE_MAC_MDIO_STS	NPE_MAC_MDIO_STS_1
257
258#define NPE_MII_GO                  (1<<31)
259#define NPE_MII_WRITE               (1<<26)
260#define NPE_MII_TIMEOUT_10TH_SECS        5
261#define NPE_MII_10TH_SEC_IN_MILLIS     100
262#define NPE_MII_READ_FAIL           (1<<31)
263
264#define NPE_MII_PHY_DEF_DELAY	300	/* max delay before link up, etc. */
265#define NPE_MII_PHY_NO_DELAY	0x0	/* do not delay */
266#define NPE_MII_PHY_NULL	0xff	/* PHY is not present */
267#define NPE_MII_PHY_DEF_ADDR	0x0	/* default PHY's logical address */
268
269/* Register definition */
270#define NPE_MII_CTRL_REG	0x0	/* Control Register */
271#define NPE_MII_STAT_REG	0x1	/* Status Register */
272#define NPE_MII_PHY_ID1_REG	0x2	/* PHY identifier 1 Register */
273#define NPE_MII_PHY_ID2_REG	0x3	/* PHY identifier 2 Register */
274#define NPE_MII_AN_ADS_REG	0x4	/* Auto-Negotiation 	  */
275					/* Advertisement Register */
276#define NPE_MII_AN_PRTN_REG	0x5	/* Auto-Negotiation 	    */
277					/* partner ability Register */
278#define NPE_MII_AN_EXP_REG	0x6	/* Auto-Negotiation   */
279					/* Expansion Register */
280#define NPE_MII_AN_NEXT_REG	0x7	/* Auto-Negotiation 	       */
281					/* next-page transmit Register */
282#endif /* ARM_XSCALE_IF_NPEREG_H */
283