[mirror_ubuntu-zesty-kernel.git] / drivers / net / wireless / rt2x00 / rt2800usb.h

/*
	Copyright (C) 2009 Ivo van Doorn <IvDoorn@gmail.com>
	Copyright (C) 2009 Mattias Nissler <mattias.nissler@gmx.de>
	Copyright (C) 2009 Felix Fietkau <nbd@openwrt.org>
	Copyright (C) 2009 Xose Vazquez Perez <xose.vazquez@gmail.com>
	Copyright (C) 2009 Axel Kollhofer <rain_maker@root-forum.org>
	<http://rt2x00.serialmonkey.com>

	This program is free software; you can redistribute it and/or modify
	it under the terms of the GNU General Public License as published by
	the Free Software Foundation; either version 2 of the License, or
	(at your option) any later version.

	This program is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	GNU General Public License for more details.

	You should have received a copy of the GNU General Public License
	along with this program; if not, write to the
	Free Software Foundation, Inc.,
	59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
 */

/*
	Module: rt2800usb
	Abstract: Data structures and registers for the rt2800usb module.
	Supported chipsets: RT2800U.
 */

#ifndef RT2800USB_H
#define RT2800USB_H

/*
 * USB registers.
 */

/*
 * USB_DMA_CFG
 * RX_BULK_AGG_TIMEOUT: Rx Bulk Aggregation TimeOut in unit of 33ns.
 * RX_BULK_AGG_LIMIT: Rx Bulk Aggregation Limit in unit of 256 bytes.
 * PHY_CLEAR: phy watch dog enable.
 * TX_CLEAR: Clear USB DMA TX path.
 * TXOP_HALT: Halt TXOP count down when TX buffer is full.
 * RX_BULK_AGG_EN: Enable Rx Bulk Aggregation.
 * RX_BULK_EN: Enable USB DMA Rx.
 * TX_BULK_EN: Enable USB DMA Tx.
 * EP_OUT_VALID: OUT endpoint data valid.
 * RX_BUSY: USB DMA RX FSM busy.
 * TX_BUSY: USB DMA TX FSM busy.
 */
#define USB_DMA_CFG			0x02a0
#define USB_DMA_CFG_RX_BULK_AGG_TIMEOUT	FIELD32(0x000000ff)
#define USB_DMA_CFG_RX_BULK_AGG_LIMIT	FIELD32(0x0000ff00)
#define USB_DMA_CFG_PHY_CLEAR		FIELD32(0x00010000)
#define USB_DMA_CFG_TX_CLEAR		FIELD32(0x00080000)
#define USB_DMA_CFG_TXOP_HALT		FIELD32(0x00100000)
#define USB_DMA_CFG_RX_BULK_AGG_EN	FIELD32(0x00200000)
#define USB_DMA_CFG_RX_BULK_EN		FIELD32(0x00400000)
#define USB_DMA_CFG_TX_BULK_EN		FIELD32(0x00800000)
#define USB_DMA_CFG_EP_OUT_VALID	FIELD32(0x3f000000)
#define USB_DMA_CFG_RX_BUSY		FIELD32(0x40000000)
#define USB_DMA_CFG_TX_BUSY		FIELD32(0x80000000)

/*
 * USB_CYC_CFG
 */
#define USB_CYC_CFG			0x02a4
#define USB_CYC_CFG_CLOCK_CYCLE		FIELD32(0x000000ff)

/*
 * 8051 firmware image.
 */
#define FIRMWARE_RT2870			"rt2870.bin"
#define FIRMWARE_IMAGE_BASE		0x3000

/*
 * DMA descriptor defines.
 */
#define TXINFO_DESC_SIZE		( 1 * sizeof(__le32) )
#define RXINFO_DESC_SIZE		( 1 * sizeof(__le32) )

/*
 * TX Info structure
 */

/*
 * Word0
 * WIV: Wireless Info Valid. 1: Driver filled WI,  0: DMA needs to copy WI
 * QSEL: Select on-chip FIFO ID for 2nd-stage output scheduler.
 *       0:MGMT, 1:HCCA 2:EDCA
 * USB_DMA_NEXT_VALID: Used ONLY in USB bulk Aggregation, NextValid
 * DMA_TX_BURST: used ONLY in USB bulk Aggregation.
 *               Force USB DMA transmit frame from current selected endpoint
 */
#define TXINFO_W0_USB_DMA_TX_PKT_LEN	FIELD32(0x0000ffff)
#define TXINFO_W0_WIV			FIELD32(0x01000000)
#define TXINFO_W0_QSEL			FIELD32(0x06000000)
#define TXINFO_W0_SW_USE_LAST_ROUND	FIELD32(0x08000000)
#define TXINFO_W0_USB_DMA_NEXT_VALID	FIELD32(0x40000000)
#define TXINFO_W0_USB_DMA_TX_BURST	FIELD32(0x80000000)

/*
 * RX descriptor format for RX Ring.
 */

/*
 * Word0
 * UNICAST_TO_ME: This RX frame is unicast to me.
 * MULTICAST: This is a multicast frame.
 * BROADCAST: This is a broadcast frame.
 * MY_BSS: this frame belongs to the same BSSID.
 * CRC_ERROR: CRC error.
 * CIPHER_ERROR: 0: decryption okay, 1:ICV error, 2:MIC error, 3:KEY not valid.
 * AMSDU: rx with 802.3 header, not 802.11 header.
 */

#define RXINFO_W0_BA			FIELD32(0x00000001)
#define RXINFO_W0_DATA			FIELD32(0x00000002)
#define RXINFO_W0_NULLDATA		FIELD32(0x00000004)
#define RXINFO_W0_FRAG			FIELD32(0x00000008)
#define RXINFO_W0_UNICAST_TO_ME		FIELD32(0x00000010)
#define RXINFO_W0_MULTICAST		FIELD32(0x00000020)
#define RXINFO_W0_BROADCAST		FIELD32(0x00000040)
#define RXINFO_W0_MY_BSS		FIELD32(0x00000080)
#define RXINFO_W0_CRC_ERROR		FIELD32(0x00000100)
#define RXINFO_W0_CIPHER_ERROR		FIELD32(0x00000600)
#define RXINFO_W0_AMSDU			FIELD32(0x00000800)
#define RXINFO_W0_HTC			FIELD32(0x00001000)
#define RXINFO_W0_RSSI			FIELD32(0x00002000)
#define RXINFO_W0_L2PAD			FIELD32(0x00004000)
#define RXINFO_W0_AMPDU			FIELD32(0x00008000)
#define RXINFO_W0_DECRYPTED		FIELD32(0x00010000)
#define RXINFO_W0_PLCP_RSSI		FIELD32(0x00020000)
#define RXINFO_W0_CIPHER_ALG		FIELD32(0x00040000)
#define RXINFO_W0_LAST_AMSDU		FIELD32(0x00080000)
#define RXINFO_W0_PLCP_SIGNAL		FIELD32(0xfff00000)

#endif /* RT2800USB_H */
Commit	Line	Data
d53d9e67	1	/*
9c9a0d14 GW	2	Copyright (C) 2009 Ivo van Doorn <IvDoorn@gmail.com>
	3	Copyright (C) 2009 Mattias Nissler <mattias.nissler@gmx.de>
	4	Copyright (C) 2009 Felix Fietkau <nbd@openwrt.org>
	5	Copyright (C) 2009 Xose Vazquez Perez <xose.vazquez@gmail.com>
	6	Copyright (C) 2009 Axel Kollhofer <rain_maker@root-forum.org>
d53d9e67 ID	7	<http://rt2x00.serialmonkey.com>
	8
	9	This program is free software; you can redistribute it and/or modify
	10	it under the terms of the GNU General Public License as published by
	11	the Free Software Foundation; either version 2 of the License, or
	12	(at your option) any later version.
	13
	14	This program is distributed in the hope that it will be useful,
	15	but WITHOUT ANY WARRANTY; without even the implied warranty of
	16	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	17	GNU General Public License for more details.
	18
	19	You should have received a copy of the GNU General Public License
	20	along with this program; if not, write to the
	21	Free Software Foundation, Inc.,
	22	59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
	23	*/
	24
	25	/*
	26	Module: rt2800usb
	27	Abstract: Data structures and registers for the rt2800usb module.
	28	Supported chipsets: RT2800U.
	29	*/
	30
	31	#ifndef RT2800USB_H
	32	#define RT2800USB_H
	33
	34	/*
b54f78a8	35	* USB registers.
d53d9e67	36	*/
d53d9e67 ID	37
d53d9e67 ID	38	/*
b54f78a8 BZ	39	* USB_DMA_CFG
	40	* RX_BULK_AGG_TIMEOUT: Rx Bulk Aggregation TimeOut in unit of 33ns.
	41	* RX_BULK_AGG_LIMIT: Rx Bulk Aggregation Limit in unit of 256 bytes.
	42	* PHY_CLEAR: phy watch dog enable.
	43	* TX_CLEAR: Clear USB DMA TX path.
	44	* TXOP_HALT: Halt TXOP count down when TX buffer is full.
	45	* RX_BULK_AGG_EN: Enable Rx Bulk Aggregation.
	46	* RX_BULK_EN: Enable USB DMA Rx.
	47	* TX_BULK_EN: Enable USB DMA Tx.
	48	* EP_OUT_VALID: OUT endpoint data valid.
	49	* RX_BUSY: USB DMA RX FSM busy.
	50	* TX_BUSY: USB DMA TX FSM busy.
d53d9e67	51	*/
b54f78a8 BZ	52	#define USB_DMA_CFG 0x02a0
	53	#define USB_DMA_CFG_RX_BULK_AGG_TIMEOUT FIELD32(0x000000ff)
	54	#define USB_DMA_CFG_RX_BULK_AGG_LIMIT FIELD32(0x0000ff00)
	55	#define USB_DMA_CFG_PHY_CLEAR FIELD32(0x00010000)
	56	#define USB_DMA_CFG_TX_CLEAR FIELD32(0x00080000)
	57	#define USB_DMA_CFG_TXOP_HALT FIELD32(0x00100000)
	58	#define USB_DMA_CFG_RX_BULK_AGG_EN FIELD32(0x00200000)
	59	#define USB_DMA_CFG_RX_BULK_EN FIELD32(0x00400000)
	60	#define USB_DMA_CFG_TX_BULK_EN FIELD32(0x00800000)
	61	#define USB_DMA_CFG_EP_OUT_VALID FIELD32(0x3f000000)
	62	#define USB_DMA_CFG_RX_BUSY FIELD32(0x40000000)
	63	#define USB_DMA_CFG_TX_BUSY FIELD32(0x80000000)
d53d9e67 ID	64
d53d9e67 ID	65	/*
b54f78a8	66	* USB_CYC_CFG
d53d9e67	67	*/
b54f78a8 BZ	68	#define USB_CYC_CFG 0x02a4
b54f78a8 BZ	69	#define USB_CYC_CFG_CLOCK_CYCLE FIELD32(0x000000ff)
d53d9e67 ID	70
	71	/*
	72	* 8051 firmware image.
	73	*/
	74	#define FIRMWARE_RT2870 "rt2870.bin"
	75	#define FIRMWARE_IMAGE_BASE 0x3000
	76
d53d9e67 ID	77	/*
	78	* DMA descriptor defines.
	79	*/
d53d9e67	80	#define TXINFO_DESC_SIZE ( 1 * sizeof(__le32) )
d42c8d86	81	#define RXINFO_DESC_SIZE ( 1 * sizeof(__le32) )
d53d9e67 ID	82
	83	/*
	84	* TX Info structure
	85	*/
	86
	87	/*
	88	* Word0
	89	* WIV: Wireless Info Valid. 1: Driver filled WI, 0: DMA needs to copy WI
	90	* QSEL: Select on-chip FIFO ID for 2nd-stage output scheduler.
	91	* 0:MGMT, 1:HCCA 2:EDCA
	92	* USB_DMA_NEXT_VALID: Used ONLY in USB bulk Aggregation, NextValid
	93	* DMA_TX_BURST: used ONLY in USB bulk Aggregation.
	94	* Force USB DMA transmit frame from current selected endpoint
	95	*/
	96	#define TXINFO_W0_USB_DMA_TX_PKT_LEN FIELD32(0x0000ffff)
	97	#define TXINFO_W0_WIV FIELD32(0x01000000)
	98	#define TXINFO_W0_QSEL FIELD32(0x06000000)
	99	#define TXINFO_W0_SW_USE_LAST_ROUND FIELD32(0x08000000)
	100	#define TXINFO_W0_USB_DMA_NEXT_VALID FIELD32(0x40000000)
	101	#define TXINFO_W0_USB_DMA_TX_BURST FIELD32(0x80000000)
	102
d53d9e67 ID	103	/*
	104	* RX descriptor format for RX Ring.
	105	*/
	106
	107	/*
	108	* Word0
	109	* UNICAST_TO_ME: This RX frame is unicast to me.
	110	* MULTICAST: This is a multicast frame.
	111	* BROADCAST: This is a broadcast frame.
	112	* MY_BSS: this frame belongs to the same BSSID.
	113	* CRC_ERROR: CRC error.
	114	* CIPHER_ERROR: 0: decryption okay, 1:ICV error, 2:MIC error, 3:KEY not valid.
	115	* AMSDU: rx with 802.3 header, not 802.11 header.
	116	*/
	117
4116cb48 BZ	118	#define RXINFO_W0_BA FIELD32(0x00000001)
	119	#define RXINFO_W0_DATA FIELD32(0x00000002)
	120	#define RXINFO_W0_NULLDATA FIELD32(0x00000004)
	121	#define RXINFO_W0_FRAG FIELD32(0x00000008)
	122	#define RXINFO_W0_UNICAST_TO_ME FIELD32(0x00000010)
	123	#define RXINFO_W0_MULTICAST FIELD32(0x00000020)
	124	#define RXINFO_W0_BROADCAST FIELD32(0x00000040)
	125	#define RXINFO_W0_MY_BSS FIELD32(0x00000080)
	126	#define RXINFO_W0_CRC_ERROR FIELD32(0x00000100)
	127	#define RXINFO_W0_CIPHER_ERROR FIELD32(0x00000600)
	128	#define RXINFO_W0_AMSDU FIELD32(0x00000800)
	129	#define RXINFO_W0_HTC FIELD32(0x00001000)
	130	#define RXINFO_W0_RSSI FIELD32(0x00002000)
	131	#define RXINFO_W0_L2PAD FIELD32(0x00004000)
	132	#define RXINFO_W0_AMPDU FIELD32(0x00008000)
	133	#define RXINFO_W0_DECRYPTED FIELD32(0x00010000)
	134	#define RXINFO_W0_PLCP_RSSI FIELD32(0x00020000)
	135	#define RXINFO_W0_CIPHER_ALG FIELD32(0x00040000)
	136	#define RXINFO_W0_LAST_AMSDU FIELD32(0x00080000)
	137	#define RXINFO_W0_PLCP_SIGNAL FIELD32(0xfff00000)
d53d9e67	138
d53d9e67	139	#endif /* RT2800USB_H */