Adaptec 1737100 Programmer Manual - Page 183

Receive and Transmit Completion Descriptor Queue producer indices.

Page 183 highlights

Sample Driver Required Fields: - RxCompletionQ1ConsumerIndex = 0: Initialize the Receive Completion Descriptor Queue 1 consumer index to zero. Note: this entry is also covered in the Receive Initialization section. - TxCompletionConsumerIndex = 0: Initialize the Transmit Completion Descriptor Queue consumer index to zero. 11 COMPLETIONQUEUE1PRODUCERINDEX (offset C8h): This register contains both the Receive and Transmit Completion Descriptor Queue producer indices. Required Fields: - RxCompletionQ1ProducerIndex = 0: Initialize the Receive Completion Descriptor Queue 1 producer index to zero. Note: this entry is also covered in the Receive Initialization section. - TxCompletionProducerIndex = 0: Initialize the Transmit Completion Descriptor Queue producer index to zero. 12 RXCOMPLETIONQ2PTRS (offset CCh): This register is used only if two receive completion queues are implemented. In this case, RxCompletionQ2ConsumerIndex should be initialized to zero. Example: // Windows NT driver example // Single Transmit Completion and Buffer Descriptor Queues // Type 1 32 bit buffer descriptors with an 8-byte skip field // First, setup all fields in the descriptor control register // This includes the descriptor type, minimum spacing, and skip length TxDescQCtrlValue.TxDescType = 1; // basic 32 bit buffer descriptor TxDescQCtrlValue.DisableTxCompletion = 0; // do not disable TX interrupts TxDescQCtrlValue.MinFrameDescSpacing = 0; // no restrictions TxDescQCtrlValue.TxDescQ64bitAddr = 0; // using 32 bit descriptors TxDescQCtrlValue.TxDmaBurstSize = Adapter->TxDmaBurstSize; // from registry TxDescQCtrlValue.SkipLength = 1; // 8 byte skip field length TxDescQCtrlValue.TxHighPriorityFifoThreshold = Adapter->TxHighPriorityFifoThreshold; // from registry AIC6915_WRITE_REG(TxDescQCtrl, TxDescQCtrlValue); // We're using a single buffer descriptor queue // Use the low priority queue (could use either one) 8-23

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190

8-23
Sample Driver
Required Fields:
RxCompletionQ1ConsumerIndex = 0: Initialize the Receive Completion
Descriptor Queue 1 consumer index to zero.
Note: this entry is also covered in the
Receive Initialization section.
TxCompletionConsumerIndex = 0: Initialize the Transmit Completion Descriptor
Queue consumer index to zero.
11
C
OMPLETION
Q
UEUE
1P
RODUCER
I
NDEX
(offset C8h):
This register contains both the
Receive and Transmit Completion Descriptor Queue producer indices.
Required Fields:
RxCompletionQ1ProducerIndex = 0: Initialize the Receive Completion Descriptor
Queue 1 producer index to zero.
Note: this entry is also covered in the Receive
Initialization section.
TxCompletionProducerIndex = 0: Initialize the Transmit Completion Descriptor
Queue producer index to zero.
12
R
X
C
OMPLETION
Q2P
TRS
(offset CCh):
This register is used only if two receive
completion queues are implemented.
In this case, RxCompletionQ2ConsumerIndex
should be initialized to zero.
Example:
// Windows NT driver example
// Single Transmit Completion and Buffer Descriptor Queues
// Type 1 32 bit buffer descriptors with an 8-byte skip field
// First, setup all fields in the descriptor control register
// This includes the descriptor type, minimum spacing, and skip length
TxDescQCtrlValue.TxDescType = 1;
// basic 32 bit buffer descriptor
TxDescQCtrlValue.DisableTxCompletion = 0;
// do not disable TX interrupts
TxDescQCtrlValue.MinFrameDescSpacing = 0;
// no restrictions
TxDescQCtrlValue.TxDescQ64bitAddr = 0;
// using 32 bit descriptors
TxDescQCtrlValue.TxDmaBurstSize =
Adapter->TxDmaBurstSize;
// from registry
TxDescQCtrlValue.SkipLength = 1;
// 8 byte skip field length
TxDescQCtrlValue.TxHighPriorityFifoThreshold =
Adapter->TxHighPriorityFifoThreshold;
// from registry
AIC6915_WRITE_REG(TxDescQCtrl, TxDescQCtrlValue);
// We're using a single buffer descriptor queue
// Use the low priority queue (could use either one)