3 * ===================================
4 * HARP | Host ATM Research Platform
5 * ===================================
8 * This Host ATM Research Platform ("HARP") file (the "Software") is
9 * made available by Network Computing Services, Inc. ("NetworkCS")
10 * "AS IS". NetworkCS does not provide maintenance, improvements or
11 * support of any kind.
13 * NETWORKCS MAKES NO WARRANTIES OR REPRESENTATIONS, EXPRESS OR IMPLIED,
14 * INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY
15 * AND FITNESS FOR A PARTICULAR PURPOSE, AS TO ANY ELEMENT OF THE
16 * SOFTWARE OR ANY SUPPORT PROVIDED IN CONNECTION WITH THIS SOFTWARE.
17 * In no event shall NetworkCS be responsible for any damages, including
18 * but not limited to consequential damages, arising from or relating to
19 * any use of the Software or related support.
21 * Copyright 1994-1998 Network Computing Services, Inc.
23 * Copies of this Software may be made, however, the above copyright
24 * notice must be reproduced on all copies.
26 * @(#) $FreeBSD: src/sys/dev/hea/eni_transmit.c,v 1.6 1999/12/21 08:24:35 eivind Exp $
27 * @(#) $DragonFly: src/sys/dev/atm/hea/eni_transmit.c,v 1.7 2005/06/02 21:36:08 dillon Exp $
31 * Efficient ENI Adapter Support
32 * -----------------------------
34 * Transmit queue management and PDU output processing
39 #include <netproto/atm/kern_include.h>
41 #include "eni_stats.h"
46 * Make a variable which controls printing of PDUs
47 * as they travel through the driver.
50 int eni_pdu_print = 0;
54 * Some PCI chipsets do not handle one or more of the 8WORD or
55 * 4WORD DMA transfer sizes. Default to using only 1WORD transfer
56 * sizes unless the user wishes to experiment.
58 * Make sure that these have to be changed here in this module.
64 * Create a DMA list entry
66 * DMA entries consist of a control word and a physical address.
67 * Control words are comprised of a DMA type, a count of type transfers
68 * to occur, and a variable which for TX requests is the TX channel
69 * number and for RX requests is the VCC number.
72 * eup pointer to unit structure
74 * dma_list pointer to DMA list structure
75 * list_size length of DMA list structure
76 * idx pointer to current list entry
77 * val TX channel or RX vcc
78 * addr virtual DMA address of data buffer
79 * size size in bytes of DMA request to be built
82 * dma_list updated with new entries
83 * idx points to next list entry
84 * -1 no room in DMA list structure or DMA_GET_ADDR failed
87 eni_set_dma ( eup, rx, dma_list, list_size, idx, val, addr, size )
96 int dsize; /* Size of current DMA request */
99 * Round up to multiple of word and convert to number
100 * of words rather then number of bytes.
102 size = ( size + 3 ) >> 2;
106 * Check for room in DMA list - we need two entires
108 if ( *idx + 2 >= list_size )
112 * Here is the big win. Move as much data possible with
116 * Check if we can do one or more 8WORD DMAs
120 dma_list[(*idx)++] = ( dsize >> 3 ) << DMA_COUNT_SHIFT |
121 val << DMA_VCC_SHIFT | DMA_8WORD;
122 dma_list[*idx] = (u_long)DMA_GET_ADDR ( addr, dsize, 0, 0 );
123 if ( dma_list[*idx] == 0 ) {
125 eup->eu_stats.eni_st_drv.drv_rv_segdma++;
127 eup->eu_stats.eni_st_drv.drv_xm_segdma++;
128 return ( -1 ); /* DMA_GET_ADDR failed */
130 (*idx)++; /* increment index */
132 * Adjust addr and size
137 #endif /* DMA_USE_8WORD */
141 * Check for room in DMA list - we need two entries
143 if ( *idx + 2 >= list_size )
147 * Kindof a tossup from this point on. Since we hacked as many
148 * 8WORD DMAs off as possible, we are left with 0-7 words
149 * of remaining data. We could do upto one 4WORD with 0-3
150 * words left, or upto three 2WORDS with 0-1 words left,
151 * or upto seven WORDS with nothing left. Someday we should
152 * experiment with performance and see if any particular
153 * combination is a better win then some other...
156 * Check if we can do one or more 4WORD DMAs
160 dma_list[(*idx)++] = ( dsize >> 2 ) << DMA_COUNT_SHIFT |
161 val << DMA_VCC_SHIFT | DMA_4WORD;
162 dma_list[*idx] = (u_long)DMA_GET_ADDR ( addr, dsize, 0, 0 );
163 if ( dma_list[*idx] == 0 ) {
165 eup->eu_stats.eni_st_drv.drv_rv_segdma++;
167 eup->eu_stats.eni_st_drv.drv_xm_segdma++;
168 return ( -1 ); /* DMA_GET_ADDR failed */
170 (*idx)++; /* increment index */
172 * Adjust addr and size
177 #endif /* DMA_USE_4WORD */
180 * Check for room in DMA list - we need two entries
182 if ( *idx + 2 >= list_size )
186 * Hard to know if one 2WORD and 0/1 WORD DMA would be better
187 * then 2/3 WORD DMAs. For now, skip 2WORD DMAs in favor of
192 * Finish remaining size a 1WORD DMAs
195 dma_list[(*idx)++] = ( size ) << DMA_COUNT_SHIFT |
196 val << DMA_VCC_SHIFT | DMA_WORD;
197 dma_list[*idx] = (u_long)DMA_GET_ADDR ( addr, size, 0, 0 );
198 if ( dma_list[*idx] == 0 ) {
200 eup->eu_stats.eni_st_drv.drv_rv_segdma++;
202 eup->eu_stats.eni_st_drv.drv_xm_segdma++;
203 return ( -1 ); /* DMA_GET_ADDR failed */
205 (*idx)++; /* increment index */
209 * Inserted descriptor okay
215 * Drain Transmit queue
217 * As PDUs are given to the adapter to be transmitted, we
218 * place them into a private ifqueue so that we can free
219 * any resources AFTER we know they've been successfully DMAed.
220 * As part of the output processing, we record the PDUs start
221 * and stop entries in the DMA list, and prevent wrapping. When
222 * we pull the top element off, we simply check that the current
223 * DMA location is outside this PDU and if so, it's okay to free
226 * PDUs are always in ascending order in the queue.
229 * eup pointer to device unit structure
236 eni_xmit_drain ( eup )
249 * Pull the top element (PDU) off
251 IF_DEQUEUE ( &eup->eu_txqueue, m );
253 * As long as there are valid elements
259 * Find start of buffer
261 KB_DATASTART ( m, up, u_long * );
264 * First word is the VCC for this PDU
267 * NOTE: There is a potential problem here in that
268 * if the VCC is closed after this buffer was transmitted
269 * but before we get here, that while evp is non-null,
270 * it will not reference a valid vccb. We need to either
271 * delay closing the VCC until all references are removed
272 * from the drain stacks, actually go through the drain
273 * stacks and remove any references, or find someway of
274 * indicating that this vccb is nolonger usable.
276 evp = (Eni_vcc *)*up++;
278 * Second word is the start and stop DMA pointers
281 stop = *up++ & 0xffff;
283 * Find out where the TX engine is at
285 dmap = eup->eu_midway[MIDWAY_TX_RD];
287 * Check to see if TX engine has processed this
288 * PDU yet. Remember that everything is circular
289 * and that stop might be less than start numerically.
291 if ( start > stop ) {
292 if ( !(dmap >= stop && dmap < start) ) {
294 * Haven't finished this PDU yet - replace
295 * it as the head of list.
297 IF_PREPEND ( &eup->eu_txqueue, m );
299 * If this one isn't done, none of the others
306 if ( dmap < stop && dmap >= start ) {
308 * Haven't finished this PDU yet - replace
309 * it as the head of list.
311 IF_PREPEND ( &eup->eu_txqueue, m );
313 * If this one isn't done, none of the others
322 * Count the PDU stats for this interface
324 eup->eu_pif.pif_opdus++;
326 * Third word is PDU length from eni_output().
329 eup->eu_txfirst = (eup->eu_txfirst + *up) &
330 (eup->eu_txsize - 1);
331 eup->eu_pif.pif_obytes += pdulen;
334 * Now lookup the VCC entry and counts the stats for
338 vcp = evp->ev_connvc->cvc_vcc;
341 vcp->vc_obytes += pdulen;
343 * If we also have a network interface, count the PDU
347 vcp->vc_nif->nif_obytes += pdulen;
348 vcp->vc_nif->nif_if.if_opackets++;
349 vcp->vc_nif->nif_if.if_obytes += pdulen;
354 * Free the buffer chain
359 * Advance DMA write okay pointer
361 eup->eu_txdmawr = stop;
364 * Look for next completed transmit PDU
366 IF_DEQUEUE ( &eup->eu_txqueue, m );
369 * We've drained the queue...
377 * This function is called via the common driver code after receiving a
378 * stack *_DATA* command. The common code has already validated most of
379 * the request so we just need to check a few more ENI-specific details.
380 * Then we just build a segmentation structure for the PDU and place the
381 * address into the DMA_Transmit_queue.
384 * cup pointer to device common unit
385 * cvp pointer to common VCC entry
386 * m pointer to output PDU buffer chain head
393 eni_output ( cup, cvp, m )
398 Eni_unit *eup = (Eni_unit *)cup;
399 Eni_vcc *evp = (Eni_vcc *)cvp;
403 u_long dma_rd, dma_wr;
404 u_long dma[TEMP_DMA_SIZE];
411 KBuffer *m0 = m, *m1, *mprev = NULL;
418 atm_dev_pdu_print ( cup, cvp, m, "eni output" );
422 * Re-entry point for after buffer compression (if needed)
427 * We can avoid traversing the buffer list twice by building
428 * the middle (minus header and trailer) dma list at the
429 * same time we massage address and size alignments. Since
430 * this list remains local until we determine we've enough
431 * room, we're not going to trash anything by not checking
432 * sizes, etc. yet. Skip first entry to be used later to skip
437 * Do data positioning for address and length alignment
440 u_long buf_addr; /* For passing addr to eni_set_dma() */
443 * Get rid of any zero length buffers
445 if ( KB_LEN ( m ) == 0 ) {
447 KB_UNLINK ( m, mprev, m1 );
449 KB_UNLINKHEAD ( m, m1 );
456 * Get start of data onto full-word alignment
458 KB_DATASTART ( m, cp, caddr_t );
459 if ((align = ((u_int)cp) & (sizeof(u_long)-1)) != 0) {
461 * Gotta slide the data up
463 eup->eu_stats.eni_st_drv.drv_xm_segnoal++;
465 KM_COPY ( cp, bfr, KB_LEN ( m ) );
466 KB_HEADMOVE ( m, -align );
469 * Data already aligned
474 * Now work on getting the data length correct
477 while ( ( align = ( len & (sizeof(u_long)-1))) &&
478 (m1 = KB_NEXT ( m ) ) ) {
481 * Have to move some data from following buffer(s)
482 * to word-fill this buffer
484 u_int ncopy = MIN ( sizeof(u_long) - align,
489 * Move data to current buffer
493 eup->eu_stats.eni_st_drv.drv_xm_seglen++;
494 KB_DATASTART ( m1, cp, caddr_t );
496 KB_HEADADJ ( m1, -ncopy );
497 KB_TAILADJ ( m, ncopy );
505 * If we've drained the buffer, free it
507 if ( KB_LEN ( m1 ) == 0 ) {
510 KB_UNLINK ( m1, m, m2 );
515 * Address and size are now aligned. Build dma list
516 * using TX channel 0. Also, round length up to a word
517 * size which should only effect the last buffer in the
518 * chain. This works because the PDU length is maintained
519 * separately and we're not really adjusting the buffer's
520 * idea of its length.
522 KB_DATASTART ( m, buf_addr, u_long );
523 if ( eni_set_dma ( eup, 0, dma, TEMP_DMA_SIZE, &j, 0,
524 buf_addr, KB_LEN ( m ) ) < 0 ) {
526 * Failed to build DMA list. First, we'll try to
527 * compress the buffer chain into a smaller number
528 * of buffers. After compressing, we'll try to send
529 * the new buffer chain. If we still fail, then
530 * we'll drop the pdu.
535 "eni_output: eni_set_dma failed\n" );
537 eup->eu_pif.pif_oerrors++;
542 eup->eu_stats.eni_st_drv.drv_xm_maxpdu++;
544 m = atm_dev_compress ( m0 );
548 "eni_output: atm_dev_compress() failed\n" );
550 eup->eu_pif.pif_oerrors++;
555 * Reset to new head of buffer chain
560 * Indicate we've been through here
565 * Retry to build the DMA descriptors for the newly
566 * compressed buffer chain
573 * Now count the length
575 pdulen += KB_LEN ( m );
578 * Bump counters and get ready for next buffer
585 * Get a buffer to use in a private queue so that we can
586 * reclaim resources after the DMA has finished.
588 KB_ALLOC ( m, ENI_SMALL_BSIZE, KB_F_NOWAIT, KB_T_DATA );
591 * Link the PDU onto our new head
596 * Drop this PDU and let the sender try again.
598 eup->eu_stats.eni_st_drv.drv_xm_norsc++;
600 log(LOG_ERR, "eni_output: Unable to allocate drain buffer.\n");
602 eup->eu_pif.pif_oerrors++;
610 * Calculate size of buffer necessary to store PDU. If this
611 * is an AAL5 PDU, we'll need to know where to stuff the length
612 * value in the trailer.
615 * AAL5 PDUs need an extra two words for control/length and
616 * CRC. Check for AAL5 and add requirements here.
618 if ((aal5 = (evp->ev_connvc->cvc_attr.aal.type == ATM_AAL5)) != 0)
619 size = pdulen + 2 * sizeof(long);
623 * Pad to next complete cell boundary
625 size += (BYTES_PER_CELL - 1);
626 size -= size % BYTES_PER_CELL;
628 * Convert size to words and add 2 words overhead for every
629 * PDU (descriptor and cell header).
631 size = (size >> 2) + 2;
634 * First, check to see if there's enough buffer space to
635 * store the PDU. We do this by checking to see if the size
636 * required crosses the eu_txfirst pointer. However, we don't
637 * want to exactly fill the buffer, because we won't be able to
638 * distinguish between a full and empty buffer.
640 if ( eup->eu_txpos == eup->eu_txfirst )
641 buf_avail = eup->eu_txsize;
643 if ( eup->eu_txpos > eup->eu_txfirst )
644 buf_avail = eup->eu_txsize - ( eup->eu_txpos - eup->eu_txfirst );
646 buf_avail = eup->eu_txfirst - eup->eu_txpos;
648 if ( size >= buf_avail )
651 * No buffer space in the adapter to store this PDU.
652 * Drop PDU and return.
654 eup->eu_stats.eni_st_drv.drv_xm_nobuf++;
657 "eni_output: not enough room in buffer\n" );
659 eup->eu_pif.pif_oerrors++;
666 * Find out where current DMA pointers are at
668 dma_start = dma_wr = eup->eu_midway[MIDWAY_TX_WR];
669 dma_rd = eup->eu_midway[MIDWAY_TX_RD];
672 * Figure out how much DMA room we have available
674 if ( dma_rd == dma_wr ) { /* Queue is empty */
675 dma_avail = DMA_LIST_SIZE;
677 dma_avail = ( dma_rd + DMA_LIST_SIZE - dma_wr )
678 & ( DMA_LIST_SIZE - 1 );
681 * Check to see if we can describe this PDU or if we're:
682 * out of room, will wrap past recovered resources.
684 if ( dma_avail < (j / 2 + 4) ||
685 ( dma_wr + (j / 2 + 4) > eup->eu_txdmawr + DMA_LIST_SIZE ) ) {
687 * No space to insert DMA list into queue. Drop this PDU.
689 eup->eu_stats.eni_st_drv.drv_xm_nodma++;
692 "eni_output: not enough room in DMA queue\n" );
694 eup->eu_pif.pif_oerrors++;
701 * Create DMA descriptor for header. There is a descriptor word
702 * and also a cell header word which we'll set manually.
704 dma[0] = (((int)(eup->eu_txpos + 2) & (eup->eu_txsize-1)) <<
705 DMA_COUNT_SHIFT) | DMA_JK;
709 * JK for AAL5 trailer. Set END bit as well.
712 dma[j++] = (((int)(eup->eu_txpos+size) & (eup->eu_txsize-1)) <<
713 DMA_COUNT_SHIFT) | DMA_END_BIT | DMA_JK;
716 dma[j-2] |= DMA_END_BIT; /* Backup and set END bit */
720 * Find out where in adapter memory this TX buffer starts.
723 ((((int)eup->eu_midway[MIDWAY_TXPLACE] & 0x7ff) << ENI_LOC_PREDIV) +
727 * Set descriptor word
729 tx_send[eup->eu_txpos] =
730 (MIDWAY_UNQ_ID << 28) | (aal5 ? 1 << 27 : 0)
731 | (size / WORDS_PER_CELL);
735 tx_send[(eup->eu_txpos+1)&(eup->eu_txsize-1)] =
736 evp->ev_connvc->cvc_vcc->vc_vci << 4;
739 * We've got all our resources, count the stats
743 * If this is an AAL5 PDU, we need to set the length
745 tx_send[(eup->eu_txpos+size-2) &
746 (eup->eu_txsize-1)] = pdulen;
748 * Increment AAL5 stats
750 eup->eu_stats.eni_st_aal5.aal5_pdu_xmit++;
751 eup->eu_stats.eni_st_aal5.aal5_xmit += (size - 2) / WORDS_PER_CELL;
754 * Increment AAL0 stats
756 eup->eu_stats.eni_st_aal0.aal0_xmit += (size - 2) / WORDS_PER_CELL;
759 * Increment ATM stats
761 eup->eu_stats.eni_st_atm.atm_xmit += (size - 2) / WORDS_PER_CELL;
767 for ( i = 0; i < j; i++ ) {
768 eup->eu_txdma[dma_wr*2] = dma[i*2];
769 eup->eu_txdma[dma_wr*2+1] = dma[i*2+1];
770 dma_wr = (dma_wr+1) & (DMA_LIST_SIZE-1);
776 * We toss four words in to help keep track of this
777 * PDU. The first is a pointer to the VC control block
778 * so we can find which VCI this went out on, the second
779 * is the start and stop pointers for the DMA list which
780 * describes this PDU, the third is the PDU length
781 * since we'll want to know that for stats gathering,
782 * and the fourth is the number of DMA words.
784 KB_DATASTART ( m, up, u_long * );
786 *up++ = dma_start << 16 | dma_wr;
791 * Set length of our buffer
793 KB_LEN ( m ) = 4 * sizeof ( long );
796 * Place buffers onto transmit queue for draining
798 IF_ENQUEUE ( &eup->eu_txqueue, m );
801 * Update next word to be stored
803 eup->eu_txpos = ((eup->eu_txpos + size) & (eup->eu_txsize - 1));
806 * Update MIDWAY_TX_WR pointer
808 eup->eu_midway[MIDWAY_TX_WR] = dma_wr;