Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Data Structures | Macros | Variables
iwl-fh.h File Reference
#include <linux/types.h>

Go to the source code of this file.

Data Structures

struct  iwl_rb_status
 
struct  iwl_tfd_tb
 
struct  iwl_tfd
 
struct  iwlagn_scd_bc_tbl
 

Macros

#define FH_MEM_LOWER_BOUND   (0x1000)
 
#define FH_MEM_UPPER_BOUND   (0x2000)
 
#define FH_KW_MEM_ADDR_REG   (FH_MEM_LOWER_BOUND + 0x97C)
 
#define FH_MEM_CBBC_0_15_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0x9D0)
 
#define FH_MEM_CBBC_0_15_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0xA10)
 
#define FH_MEM_CBBC_16_19_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0xBF0)
 
#define FH_MEM_CBBC_16_19_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0xC00)
 
#define FH_MEM_CBBC_20_31_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0xB20)
 
#define FH_MEM_CBBC_20_31_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0xB80)
 
#define FH_MEM_RSCSR_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0xBC0)
 
#define FH_MEM_RSCSR_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0xC00)
 
#define FH_MEM_RSCSR_CHNL0   (FH_MEM_RSCSR_LOWER_BOUND)
 
#define FH_RSCSR_CHNL0_STTS_WPTR_REG   (FH_MEM_RSCSR_CHNL0)
 
#define FH_RSCSR_CHNL0_RBDCB_BASE_REG   (FH_MEM_RSCSR_CHNL0 + 0x004)
 
#define FH_RSCSR_CHNL0_RBDCB_WPTR_REG   (FH_MEM_RSCSR_CHNL0 + 0x008)
 
#define FH_RSCSR_CHNL0_WPTR   (FH_RSCSR_CHNL0_RBDCB_WPTR_REG)
 
#define FH_MEM_RCSR_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0xC00)
 
#define FH_MEM_RCSR_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0xCC0)
 
#define FH_MEM_RCSR_CHNL0   (FH_MEM_RCSR_LOWER_BOUND)
 
#define FH_MEM_RCSR_CHNL0_CONFIG_REG   (FH_MEM_RCSR_CHNL0)
 
#define FH_RCSR_CHNL0_RX_CONFIG_RB_TIMEOUT_MSK   (0x00000FF0) /* bits 4-11 */
 
#define FH_RCSR_CHNL0_RX_CONFIG_IRQ_DEST_MSK   (0x00001000) /* bits 12 */
 
#define FH_RCSR_CHNL0_RX_CONFIG_SINGLE_FRAME_MSK   (0x00008000) /* bit 15 */
 
#define FH_RCSR_CHNL0_RX_CONFIG_RB_SIZE_MSK   (0x00030000) /* bits 16-17 */
 
#define FH_RCSR_CHNL0_RX_CONFIG_RBDBC_SIZE_MSK   (0x00F00000) /* bits 20-23 */
 
#define FH_RCSR_CHNL0_RX_CONFIG_DMA_CHNL_EN_MSK   (0xC0000000) /* bits 30-31*/
 
#define FH_RCSR_RX_CONFIG_RBDCB_SIZE_POS   (20)
 
#define FH_RCSR_RX_CONFIG_REG_IRQ_RBTH_POS   (4)
 
#define RX_RB_TIMEOUT   (0x10)
 
#define FH_RCSR_RX_CONFIG_CHNL_EN_PAUSE_VAL   (0x00000000)
 
#define FH_RCSR_RX_CONFIG_CHNL_EN_PAUSE_EOF_VAL   (0x40000000)
 
#define FH_RCSR_RX_CONFIG_CHNL_EN_ENABLE_VAL   (0x80000000)
 
#define FH_RCSR_RX_CONFIG_REG_VAL_RB_SIZE_4K   (0x00000000)
 
#define FH_RCSR_RX_CONFIG_REG_VAL_RB_SIZE_8K   (0x00010000)
 
#define FH_RCSR_RX_CONFIG_REG_VAL_RB_SIZE_12K   (0x00020000)
 
#define FH_RCSR_RX_CONFIG_REG_VAL_RB_SIZE_16K   (0x00030000)
 
#define FH_RCSR_CHNL0_RX_IGNORE_RXF_EMPTY   (0x00000004)
 
#define FH_RCSR_CHNL0_RX_CONFIG_IRQ_DEST_NO_INT_VAL   (0x00000000)
 
#define FH_RCSR_CHNL0_RX_CONFIG_IRQ_DEST_INT_HOST_VAL   (0x00001000)
 
#define FH_MEM_RSSR_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0xC40)
 
#define FH_MEM_RSSR_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0xD00)
 
#define FH_MEM_RSSR_SHARED_CTRL_REG   (FH_MEM_RSSR_LOWER_BOUND)
 
#define FH_MEM_RSSR_RX_STATUS_REG   (FH_MEM_RSSR_LOWER_BOUND + 0x004)
 
#define FH_MEM_RSSR_RX_ENABLE_ERR_IRQ2DRV   (FH_MEM_RSSR_LOWER_BOUND + 0x008)
 
#define FH_RSSR_CHNL0_RX_STATUS_CHNL_IDLE   (0x01000000)
 
#define FH_MEM_TFDIB_REG1_ADDR_BITSHIFT   28
 
#define FH_MEM_TFDIB_DRAM_ADDR_LSB_MSK   (0xFFFFFFFF)
 
#define FH_TFDIB_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0x900)
 
#define FH_TFDIB_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0x958)
 
#define FH_TFDIB_CTRL0_REG(_chnl)   (FH_TFDIB_LOWER_BOUND + 0x8 * (_chnl))
 
#define FH_TFDIB_CTRL1_REG(_chnl)   (FH_TFDIB_LOWER_BOUND + 0x8 * (_chnl) + 0x4)
 
#define FH_TCSR_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0xD00)
 
#define FH_TCSR_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0xE60)
 
#define FH_TCSR_CHNL_NUM   (8)
 
#define FH_TCSR_CHNL_TX_CONFIG_REG(_chnl)   (FH_TCSR_LOWER_BOUND + 0x20 * (_chnl))
 
#define FH_TCSR_CHNL_TX_CREDIT_REG(_chnl)   (FH_TCSR_LOWER_BOUND + 0x20 * (_chnl) + 0x4)
 
#define FH_TCSR_CHNL_TX_BUF_STS_REG(_chnl)   (FH_TCSR_LOWER_BOUND + 0x20 * (_chnl) + 0x8)
 
#define FH_TCSR_TX_CONFIG_REG_VAL_MSG_MODE_TXF   (0x00000000)
 
#define FH_TCSR_TX_CONFIG_REG_VAL_MSG_MODE_DRV   (0x00000001)
 
#define FH_TCSR_TX_CONFIG_REG_VAL_DMA_CREDIT_DISABLE   (0x00000000)
 
#define FH_TCSR_TX_CONFIG_REG_VAL_DMA_CREDIT_ENABLE   (0x00000008)
 
#define FH_TCSR_TX_CONFIG_REG_VAL_CIRQ_HOST_NOINT   (0x00000000)
 
#define FH_TCSR_TX_CONFIG_REG_VAL_CIRQ_HOST_ENDTFD   (0x00100000)
 
#define FH_TCSR_TX_CONFIG_REG_VAL_CIRQ_HOST_IFTFD   (0x00200000)
 
#define FH_TCSR_TX_CONFIG_REG_VAL_CIRQ_RTC_NOINT   (0x00000000)
 
#define FH_TCSR_TX_CONFIG_REG_VAL_CIRQ_RTC_ENDTFD   (0x00400000)
 
#define FH_TCSR_TX_CONFIG_REG_VAL_CIRQ_RTC_IFTFD   (0x00800000)
 
#define FH_TCSR_TX_CONFIG_REG_VAL_DMA_CHNL_PAUSE   (0x00000000)
 
#define FH_TCSR_TX_CONFIG_REG_VAL_DMA_CHNL_PAUSE_EOF   (0x40000000)
 
#define FH_TCSR_TX_CONFIG_REG_VAL_DMA_CHNL_ENABLE   (0x80000000)
 
#define FH_TCSR_CHNL_TX_BUF_STS_REG_VAL_TFDB_EMPTY   (0x00000000)
 
#define FH_TCSR_CHNL_TX_BUF_STS_REG_VAL_TFDB_WAIT   (0x00002000)
 
#define FH_TCSR_CHNL_TX_BUF_STS_REG_VAL_TFDB_VALID   (0x00000003)
 
#define FH_TCSR_CHNL_TX_BUF_STS_REG_POS_TB_NUM   (20)
 
#define FH_TCSR_CHNL_TX_BUF_STS_REG_POS_TB_IDX   (12)
 
#define FH_TSSR_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0xEA0)
 
#define FH_TSSR_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0xEC0)
 
#define FH_TSSR_TX_STATUS_REG   (FH_TSSR_LOWER_BOUND + 0x010)
 
#define FH_TSSR_TX_ERROR_REG   (FH_TSSR_LOWER_BOUND + 0x018)
 
#define FH_TSSR_TX_STATUS_REG_MSK_CHNL_IDLE(_chnl)   ((1 << (_chnl)) << 16)
 
#define FH_SRVC_CHNL   (9)
 
#define FH_SRVC_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0x9C8)
 
#define FH_SRVC_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0x9D0)
 
#define FH_SRVC_CHNL_SRAM_ADDR_REG(_chnl)   (FH_SRVC_LOWER_BOUND + ((_chnl) - 9) * 0x4)
 
#define FH_TX_CHICKEN_BITS_REG   (FH_MEM_LOWER_BOUND + 0xE98)
 
#define FH_TX_TRB_REG(_chan)   (FH_MEM_LOWER_BOUND + 0x958 + (_chan) * 4)
 
#define FH_TX_CHICKEN_BITS_SCD_AUTO_RETRY_EN   (0x00000002)
 
#define RX_QUEUE_SIZE   256
 
#define RX_QUEUE_MASK   255
 
#define RX_QUEUE_SIZE_LOG   8
 
#define RX_FREE_BUFFERS   64
 
#define RX_LOW_WATERMARK   8
 
#define TFD_QUEUE_SIZE_MAX   (256)
 
#define TFD_QUEUE_SIZE_BC_DUP   (64)
 
#define TFD_QUEUE_BC_SIZE   (TFD_QUEUE_SIZE_MAX + TFD_QUEUE_SIZE_BC_DUP)
 
#define IWL_TX_DMA_MASK   DMA_BIT_MASK(36)
 
#define IWL_NUM_OF_TBS   20
 
#define IWL_KW_SIZE   0x1000 /* 4k */
 

Variables

struct iwl_rb_status __packed
 

Macro Definition Documentation

#define FH_KW_MEM_ADDR_REG   (FH_MEM_LOWER_BOUND + 0x97C)

Keep-Warm (KW) buffer base address.

Driver must allocate a 4KByte buffer that is for keeping the host DRAM powered on (via dummy accesses to DRAM) to maintain low-latency DRAM access when doing Txing or Rxing. The dummy accesses prevent host from going into a power-savings mode that would cause higher DRAM latency, and possible data over/under-runs, before all Tx/Rx is complete.

Driver loads FH_KW_MEM_ADDR_REG with the physical address (bits 35:4) of the buffer, which must be 4K aligned. Once this is set up, the device automatically invokes keep-warm accesses when normal accesses might not be sufficient to maintain fast DRAM response.

Bit fields: 31-0: Keep-warm buffer physical base address [35:4], must be 4K aligned

Definition at line 96 of file iwl-fh.h.

#define FH_MEM_CBBC_0_15_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0x9D0)

TFD Circular Buffers Base (CBBC) addresses

Device has 16 base pointer registers, one for each of 16 host-DRAM-resident circular buffers (CBs/queues) containing Transmit Frame Descriptors (TFDs) (see struct iwl_tfd_frame). These 16 pointer registers are offset by 0x04 bytes from one another. Each TFD circular buffer in DRAM must be 256-byte aligned (address bits 0-7 must be 0). Later devices have 20 (5000 series) or 30 (higher) queues, but the registers for them are in different places.

Bit fields in each pointer register: 27-0: TFD CB physical base address [35:8], must be 256-byte aligned

Definition at line 113 of file iwl-fh.h.

#define FH_MEM_CBBC_0_15_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0xA10)

Definition at line 114 of file iwl-fh.h.

#define FH_MEM_CBBC_16_19_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0xBF0)

Definition at line 115 of file iwl-fh.h.

#define FH_MEM_CBBC_16_19_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0xC00)

Definition at line 116 of file iwl-fh.h.

#define FH_MEM_CBBC_20_31_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0xB20)

Definition at line 117 of file iwl-fh.h.

#define FH_MEM_CBBC_20_31_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0xB80)

Definition at line 118 of file iwl-fh.h.

#define FH_MEM_LOWER_BOUND   (0x1000)

This I/O area is directly read/writable by driver (e.g. Linux uses writel()) Addresses are offsets from device's PCI hardware base address.

Definition at line 76 of file iwl-fh.h.

#define FH_MEM_RCSR_CHNL0   (FH_MEM_RCSR_LOWER_BOUND)

Definition at line 257 of file iwl-fh.h.

#define FH_MEM_RCSR_CHNL0_CONFIG_REG   (FH_MEM_RCSR_CHNL0)

Definition at line 259 of file iwl-fh.h.

#define FH_MEM_RCSR_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0xC00)

Rx Config/Status Registers (RCSR) Rx Config Reg for channel 0 (only channel used)

Driver must initialize FH_MEM_RCSR_CHNL0_CONFIG_REG as follows for normal operation (see bit fields).

Clearing FH_MEM_RCSR_CHNL0_CONFIG_REG to 0 turns off Rx DMA. Driver should poll FH_MEM_RSSR_RX_STATUS_REG for FH_RSSR_CHNL0_RX_STATUS_CHNL_IDLE (bit 24) before continuing.

Bit fields: 31-30: Rx DMA channel enable: '00' off/pause, '01' pause at end of frame, '10' operate normally 29-24: reserved 23-20: # RBDs in circular buffer = 2^value; use "8" for 256 RBDs (normal), min "5" for 32 RBDs, max "12" for 4096 RBDs. 19-18: reserved 17-16: size of each receive buffer; '00' 4K (normal), '01' 8K, '10' 12K, '11' 16K. 15-14: reserved 13-12: IRQ destination; '00' none, '01' host driver (normal operation) 11- 4: timeout for closing Rx buffer and interrupting host (units 32 usec) typical value 0x10 (about 1/2 msec) 3- 0: reserved

Definition at line 255 of file iwl-fh.h.

#define FH_MEM_RCSR_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0xCC0)

Definition at line 256 of file iwl-fh.h.

#define FH_MEM_RSCSR_CHNL0   (FH_MEM_RSCSR_LOWER_BOUND)

Definition at line 203 of file iwl-fh.h.

#define FH_MEM_RSCSR_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0xBC0)

Rx SRAM Control and Status Registers (RSCSR)

These registers provide handshake between driver and device for the Rx queue (this queue handles all command responses, notifications, Rx data, etc. sent from uCode to host driver). Unlike Tx, there is only one Rx queue, and only one Rx DMA/FIFO channel. Also unlike Tx, which can concatenate up to 20 DRAM buffers to form a Tx frame, each Receive Buffer Descriptor (RBD) points to only one Rx Buffer (RB); there is a 1:1 mapping between RBDs and RBs.

Driver must allocate host DRAM memory for the following, and set the physical address of each into device registers:

1) Receive Buffer Descriptor (RBD) circular buffer (CB), typically with 256 entries (although any power of 2, up to 4096, is selectable by driver). Each entry (1 dword) points to a receive buffer (RB) of consistent size (typically 4K, although 8K or 16K are also selectable by driver). Driver sets up RB size and number of RBDs in the CB via Rx config register FH_MEM_RCSR_CHNL0_CONFIG_REG.

Bit fields within one RBD: 27-0: Receive Buffer physical address bits [35:8], 256-byte aligned

Driver sets physical address [35:8] of base of RBD circular buffer into FH_RSCSR_CHNL0_RBDCB_BASE_REG [27:0].

2) Rx status buffer, 8 bytes, in which uCode indicates which Rx Buffers (RBs) have been filled, via a "write pointer", actually the index of the RB's corresponding RBD within the circular buffer. Driver sets physical address [35:4] into FH_RSCSR_CHNL0_STTS_WPTR_REG [31:0].

Bit fields in lower dword of Rx status buffer (upper dword not used by driver: 31-12: Not used by driver 11- 0: Index of last filled Rx buffer descriptor (device writes, driver reads this value)

As the driver prepares Receive Buffers (RBs) for device to fill, driver must enter pointers to these RBs into contiguous RBD circular buffer entries, and update the device's "write" index register, FH_RSCSR_CHNL0_RBDCB_WPTR_REG.

This "write" index corresponds to the next RBD that the driver will make available, i.e. one RBD past the tail of the ready-to-fill RBDs within the circular buffer. This value should initially be 0 (before preparing any RBs), should be 8 after preparing the first 8 RBs (for example), and must wrap back to 0 at the end of the circular buffer (but don't wrap before "read" index has advanced past 1! See below). NOTE: DEVICE EXPECTS THE WRITE INDEX TO BE INCREMENTED IN MULTIPLES OF 8.

As the device fills RBs (referenced from contiguous RBDs within the circular buffer), it updates the Rx status buffer in host DRAM, 2) described above, to tell the driver the index of the latest filled RBD. The driver must read this "read" index from DRAM after receiving an Rx interrupt from device

The driver must also internally keep track of a third index, which is the next RBD to process. When receiving an Rx interrupt, driver should process all filled but unprocessed RBs up to, but not including, the RB corresponding to the "read" index. For example, if "read" index becomes "1", driver may process the RB pointed to by RBD 0. Depending on volume of traffic, there may be many RBs to process.

If read index == write index, device thinks there is no room to put new data. Due to this, the maximum number of filled RBs is 255, instead of 256. To be safe, make sure that there is a gap of at least 2 RBDs between "write" and "read" indexes; that is, make sure that there are no more than 254 buffers waiting to be filled.

Definition at line 201 of file iwl-fh.h.

#define FH_MEM_RSCSR_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0xC00)

Definition at line 202 of file iwl-fh.h.

#define FH_MEM_RSSR_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0xC40)

Rx Shared Status Registers (RSSR)

After stopping Rx DMA channel (writing 0 to FH_MEM_RCSR_CHNL0_CONFIG_REG), driver must poll FH_MEM_RSSR_RX_STATUS_REG until Rx channel is idle.

Bit fields: 24: 1 = Channel 0 is idle

FH_MEM_RSSR_SHARED_CTRL_REG and FH_MEM_RSSR_RX_ENABLE_ERR_IRQ2DRV contain default values that should not be altered by the driver.

Definition at line 298 of file iwl-fh.h.

#define FH_MEM_RSSR_RX_ENABLE_ERR_IRQ2DRV   (FH_MEM_RSSR_LOWER_BOUND + 0x008)

Definition at line 303 of file iwl-fh.h.

#define FH_MEM_RSSR_RX_STATUS_REG   (FH_MEM_RSSR_LOWER_BOUND + 0x004)

Definition at line 302 of file iwl-fh.h.

#define FH_MEM_RSSR_SHARED_CTRL_REG   (FH_MEM_RSSR_LOWER_BOUND)

Definition at line 301 of file iwl-fh.h.

#define FH_MEM_RSSR_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0xD00)

Definition at line 299 of file iwl-fh.h.

#define FH_MEM_TFDIB_DRAM_ADDR_LSB_MSK   (0xFFFFFFFF)

Definition at line 311 of file iwl-fh.h.

#define FH_MEM_TFDIB_REG1_ADDR_BITSHIFT   28

Definition at line 308 of file iwl-fh.h.

#define FH_MEM_UPPER_BOUND   (0x2000)

Definition at line 77 of file iwl-fh.h.

#define FH_RCSR_CHNL0_RX_CONFIG_DMA_CHNL_EN_MSK   (0xC0000000) /* bits 30-31*/

Definition at line 266 of file iwl-fh.h.

#define FH_RCSR_CHNL0_RX_CONFIG_IRQ_DEST_INT_HOST_VAL   (0x00001000)

Definition at line 283 of file iwl-fh.h.

#define FH_RCSR_CHNL0_RX_CONFIG_IRQ_DEST_MSK   (0x00001000) /* bits 12 */

Definition at line 262 of file iwl-fh.h.

#define FH_RCSR_CHNL0_RX_CONFIG_IRQ_DEST_NO_INT_VAL   (0x00000000)

Definition at line 282 of file iwl-fh.h.

#define FH_RCSR_CHNL0_RX_CONFIG_RB_SIZE_MSK   (0x00030000) /* bits 16-17 */

Definition at line 264 of file iwl-fh.h.

#define FH_RCSR_CHNL0_RX_CONFIG_RB_TIMEOUT_MSK   (0x00000FF0) /* bits 4-11 */

Definition at line 261 of file iwl-fh.h.

#define FH_RCSR_CHNL0_RX_CONFIG_RBDBC_SIZE_MSK   (0x00F00000) /* bits 20-23 */

Definition at line 265 of file iwl-fh.h.

#define FH_RCSR_CHNL0_RX_CONFIG_SINGLE_FRAME_MSK   (0x00008000) /* bit 15 */

Definition at line 263 of file iwl-fh.h.

#define FH_RCSR_CHNL0_RX_IGNORE_RXF_EMPTY   (0x00000004)

Definition at line 281 of file iwl-fh.h.

#define FH_RCSR_RX_CONFIG_CHNL_EN_ENABLE_VAL   (0x80000000)

Definition at line 274 of file iwl-fh.h.

#define FH_RCSR_RX_CONFIG_CHNL_EN_PAUSE_EOF_VAL   (0x40000000)

Definition at line 273 of file iwl-fh.h.

#define FH_RCSR_RX_CONFIG_CHNL_EN_PAUSE_VAL   (0x00000000)

Definition at line 272 of file iwl-fh.h.

#define FH_RCSR_RX_CONFIG_RBDCB_SIZE_POS   (20)

Definition at line 268 of file iwl-fh.h.

#define FH_RCSR_RX_CONFIG_REG_IRQ_RBTH_POS   (4)

Definition at line 269 of file iwl-fh.h.

#define FH_RCSR_RX_CONFIG_REG_VAL_RB_SIZE_12K   (0x00020000)

Definition at line 278 of file iwl-fh.h.

#define FH_RCSR_RX_CONFIG_REG_VAL_RB_SIZE_16K   (0x00030000)

Definition at line 279 of file iwl-fh.h.

#define FH_RCSR_RX_CONFIG_REG_VAL_RB_SIZE_4K   (0x00000000)

Definition at line 276 of file iwl-fh.h.

#define FH_RCSR_RX_CONFIG_REG_VAL_RB_SIZE_8K   (0x00010000)

Definition at line 277 of file iwl-fh.h.

#define FH_RSCSR_CHNL0_RBDCB_BASE_REG   (FH_MEM_RSCSR_CHNL0 + 0x004)

Physical base address of Rx Buffer Descriptor Circular Buffer. Bit fields: 27-0: RBD CD physical base address [35:8], must be 256-byte aligned.

Definition at line 217 of file iwl-fh.h.

#define FH_RSCSR_CHNL0_RBDCB_WPTR_REG   (FH_MEM_RSCSR_CHNL0 + 0x008)

Rx write pointer (index, really!). Bit fields: 11-0: Index of driver's most recent prepared-to-be-filled RBD, + 1. NOTE: For 256-entry circular buffer, use only bits [7:0].

Definition at line 225 of file iwl-fh.h.

#define FH_RSCSR_CHNL0_STTS_WPTR_REG   (FH_MEM_RSCSR_CHNL0)

Physical base address of 8-byte Rx Status buffer. Bit fields: 31-0: Rx status buffer physical base address [35:4], must 16-byte aligned.

Definition at line 210 of file iwl-fh.h.

#define FH_RSCSR_CHNL0_WPTR   (FH_RSCSR_CHNL0_RBDCB_WPTR_REG)

Definition at line 226 of file iwl-fh.h.

#define FH_RSSR_CHNL0_RX_STATUS_CHNL_IDLE   (0x01000000)

Definition at line 306 of file iwl-fh.h.

#define FH_SRVC_CHNL   (9)

Definition at line 417 of file iwl-fh.h.

#define FH_SRVC_CHNL_SRAM_ADDR_REG (   _chnl)    (FH_SRVC_LOWER_BOUND + ((_chnl) - 9) * 0x4)

Definition at line 420 of file iwl-fh.h.

#define FH_SRVC_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0x9C8)

Definition at line 418 of file iwl-fh.h.

#define FH_SRVC_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0x9D0)

Definition at line 419 of file iwl-fh.h.

#define FH_TCSR_CHNL_NUM   (8)

Definition at line 343 of file iwl-fh.h.

#define FH_TCSR_CHNL_TX_BUF_STS_REG (   _chnl)    (FH_TCSR_LOWER_BOUND + 0x20 * (_chnl) + 0x8)

Definition at line 350 of file iwl-fh.h.

#define FH_TCSR_CHNL_TX_BUF_STS_REG_POS_TB_IDX   (12)

Definition at line 376 of file iwl-fh.h.

#define FH_TCSR_CHNL_TX_BUF_STS_REG_POS_TB_NUM   (20)

Definition at line 375 of file iwl-fh.h.

#define FH_TCSR_CHNL_TX_BUF_STS_REG_VAL_TFDB_EMPTY   (0x00000000)

Definition at line 371 of file iwl-fh.h.

#define FH_TCSR_CHNL_TX_BUF_STS_REG_VAL_TFDB_VALID   (0x00000003)

Definition at line 373 of file iwl-fh.h.

#define FH_TCSR_CHNL_TX_BUF_STS_REG_VAL_TFDB_WAIT   (0x00002000)

Definition at line 372 of file iwl-fh.h.

#define FH_TCSR_CHNL_TX_CONFIG_REG (   _chnl)    (FH_TCSR_LOWER_BOUND + 0x20 * (_chnl))

Definition at line 346 of file iwl-fh.h.

#define FH_TCSR_CHNL_TX_CREDIT_REG (   _chnl)    (FH_TCSR_LOWER_BOUND + 0x20 * (_chnl) + 0x4)

Definition at line 348 of file iwl-fh.h.

#define FH_TCSR_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0xD00)

Transmit DMA Channel Control/Status Registers (TCSR)

Device has one configuration register for each of 8 Tx DMA/FIFO channels supported in hardware (don't confuse these with the 16 Tx queues in DRAM, which feed the DMA/FIFO channels); config regs are separated by 0x20 bytes.

To use a Tx DMA channel, driver must initialize its FH_TCSR_CHNL_TX_CONFIG_REG(chnl) with:

FH_TCSR_TX_CONFIG_REG_VAL_DMA_CHNL_ENABLE | FH_TCSR_TX_CONFIG_REG_VAL_DMA_CREDIT_ENABLE_VAL

All other bits should be 0.

Bit fields: 31-30: Tx DMA channel enable: '00' off/pause, '01' pause at end of frame, '10' operate normally 29- 4: Reserved, set to "0" 3: Enable internal DMA requests (1, normal operation), disable (0) 2- 0: Reserved, set to "0"

Definition at line 339 of file iwl-fh.h.

#define FH_TCSR_TX_CONFIG_REG_VAL_CIRQ_HOST_ENDTFD   (0x00100000)

Definition at line 360 of file iwl-fh.h.

#define FH_TCSR_TX_CONFIG_REG_VAL_CIRQ_HOST_IFTFD   (0x00200000)

Definition at line 361 of file iwl-fh.h.

#define FH_TCSR_TX_CONFIG_REG_VAL_CIRQ_HOST_NOINT   (0x00000000)

Definition at line 359 of file iwl-fh.h.

#define FH_TCSR_TX_CONFIG_REG_VAL_CIRQ_RTC_ENDTFD   (0x00400000)

Definition at line 364 of file iwl-fh.h.

#define FH_TCSR_TX_CONFIG_REG_VAL_CIRQ_RTC_IFTFD   (0x00800000)

Definition at line 365 of file iwl-fh.h.

#define FH_TCSR_TX_CONFIG_REG_VAL_CIRQ_RTC_NOINT   (0x00000000)

Definition at line 363 of file iwl-fh.h.

#define FH_TCSR_TX_CONFIG_REG_VAL_DMA_CHNL_ENABLE   (0x80000000)

Definition at line 369 of file iwl-fh.h.

#define FH_TCSR_TX_CONFIG_REG_VAL_DMA_CHNL_PAUSE   (0x00000000)

Definition at line 367 of file iwl-fh.h.

#define FH_TCSR_TX_CONFIG_REG_VAL_DMA_CHNL_PAUSE_EOF   (0x40000000)

Definition at line 368 of file iwl-fh.h.

#define FH_TCSR_TX_CONFIG_REG_VAL_DMA_CREDIT_DISABLE   (0x00000000)

Definition at line 356 of file iwl-fh.h.

#define FH_TCSR_TX_CONFIG_REG_VAL_DMA_CREDIT_ENABLE   (0x00000008)

Definition at line 357 of file iwl-fh.h.

#define FH_TCSR_TX_CONFIG_REG_VAL_MSG_MODE_DRV   (0x00000001)

Definition at line 354 of file iwl-fh.h.

#define FH_TCSR_TX_CONFIG_REG_VAL_MSG_MODE_TXF   (0x00000000)

Definition at line 353 of file iwl-fh.h.

#define FH_TCSR_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0xE60)

Definition at line 340 of file iwl-fh.h.

#define FH_TFDIB_CTRL0_REG (   _chnl)    (FH_TFDIB_LOWER_BOUND + 0x8 * (_chnl))

Definition at line 314 of file iwl-fh.h.

#define FH_TFDIB_CTRL1_REG (   _chnl)    (FH_TFDIB_LOWER_BOUND + 0x8 * (_chnl) + 0x4)

Definition at line 315 of file iwl-fh.h.

#define FH_TFDIB_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0x900)

Definition at line 312 of file iwl-fh.h.

#define FH_TFDIB_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0x958)

Definition at line 313 of file iwl-fh.h.

#define FH_TSSR_LOWER_BOUND   (FH_MEM_LOWER_BOUND + 0xEA0)

Tx Shared Status Registers (TSSR)

After stopping Tx DMA channel (writing 0 to FH_TCSR_CHNL_TX_CONFIG_REG(chnl)), driver must poll FH_TSSR_TX_STATUS_REG until selected Tx channel is idle (channel's buffers empty | no pending requests).

Bit fields: 31-24: 1 = Channel buffers empty (channel 7:0) 23-16: 1 = No pending requests (channel 7:0)

Definition at line 390 of file iwl-fh.h.

#define FH_TSSR_TX_ERROR_REG   (FH_TSSR_LOWER_BOUND + 0x018)

Bit fields for TSSR(Tx Shared Status & Control) error status register: 31: Indicates an address error when accessed to internal memory uCode/driver must write "1" in order to clear this flag 30: Indicates that Host did not send the expected number of dwords to FH uCode/driver must write "1" in order to clear this flag 16-9:Each status bit is for one channel. Indicates that an (Error) ActDMA command was received from the scheduler while the TRB was already full with previous command uCode/driver must write "1" in order to clear this flag 7-0: Each status bit indicates a channel's TxCredit error. When an error bit is set, it indicates that the FH has received a full indication from the RTC TxFIFO and the current value of the TxCredit counter was not equal to zero. This mean that the credit mechanism was not synchronized to the TxFIFO status uCode/driver must write "1" in order to clear this flag

Definition at line 412 of file iwl-fh.h.

#define FH_TSSR_TX_STATUS_REG   (FH_TSSR_LOWER_BOUND + 0x010)

Definition at line 393 of file iwl-fh.h.

#define FH_TSSR_TX_STATUS_REG_MSK_CHNL_IDLE (   _chnl)    ((1 << (_chnl)) << 16)

Definition at line 414 of file iwl-fh.h.

#define FH_TSSR_UPPER_BOUND   (FH_MEM_LOWER_BOUND + 0xEC0)

Definition at line 391 of file iwl-fh.h.

#define FH_TX_CHICKEN_BITS_REG   (FH_MEM_LOWER_BOUND + 0xE98)

Definition at line 423 of file iwl-fh.h.

#define FH_TX_CHICKEN_BITS_SCD_AUTO_RETRY_EN   (0x00000002)

Definition at line 429 of file iwl-fh.h.

#define FH_TX_TRB_REG (   _chan)    (FH_MEM_LOWER_BOUND + 0x958 + (_chan) * 4)

Definition at line 424 of file iwl-fh.h.

#define IWL_KW_SIZE   0x1000 /* 4k */

Definition at line 521 of file iwl-fh.h.

#define IWL_NUM_OF_TBS   20

Definition at line 464 of file iwl-fh.h.

#define IWL_TX_DMA_MASK   DMA_BIT_MASK(36)

Definition at line 463 of file iwl-fh.h.

#define RX_FREE_BUFFERS   64

Definition at line 438 of file iwl-fh.h.

#define RX_LOW_WATERMARK   8

Definition at line 439 of file iwl-fh.h.

#define RX_QUEUE_MASK   255

Definition at line 432 of file iwl-fh.h.

#define RX_QUEUE_SIZE   256

Definition at line 431 of file iwl-fh.h.

#define RX_QUEUE_SIZE_LOG   8

Definition at line 433 of file iwl-fh.h.

#define RX_RB_TIMEOUT   (0x10)

Definition at line 270 of file iwl-fh.h.

#define TFD_QUEUE_BC_SIZE   (TFD_QUEUE_SIZE_MAX + TFD_QUEUE_SIZE_BC_DUP)

Definition at line 462 of file iwl-fh.h.

#define TFD_QUEUE_SIZE_BC_DUP   (64)

Definition at line 461 of file iwl-fh.h.

#define TFD_QUEUE_SIZE_MAX   (256)

Definition at line 460 of file iwl-fh.h.

Variable Documentation