Using catalogs: /etc/sgml/catalog Using stylesheet: /usr/share/sgml/docbook/utils-0.6.9/docbook-utils.dsl#html Working on: /home/jdavila/lucas/doc-manual-linux-tulip/doc-manual-linux-tulip.xml Gu�a de Usuario del Controlador Tulip

Gu�a de Usuario del Controlador Tulip

Jeff Garzik


      jgarzik@mandrakesoft.com
     

Copyright © 2001 por Jeff Garzik

Esta documentaci�n es software libre; puedes redistrubuirla y/o modificarla bajo los t�rminos de la GNU General Public License tal como ha sido publicada por la Free Software Foundation; por la versi�n 2 de la licencia, o (a tu elecci�n) por cualquier versi�n posterior.

Este programa es distribuido con la esperanza de que sea �til, pero SIN NINGUNA GARANTIA; sin incluso la garant�a implicada de COMERCIABILIDAD o ADECUACCION PARA UN PROPOSITO PARTICULAR. Para m�s detalles refi�rase a la GNU General Public License.

Deber�a de haber recibido una copia de la GNU General Public License con este programa; si no es as�, escriba a la Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

Para m�s detalles v�ase el archivo COPYING en la distribuci�n fuente de Linux.

Tabla de contenidos
1. Introducci�n
2. Compatibilidad de Controlador
3. Par�metros espec�ficos de la placa
4. Operaci�n del Controlador
4.1. buffers de Anillo
4.2. Sincronizaci�n
5. Errores
6. Historia de Cambios del Controlador
6.1. Versi�n 0.9.14 (20 de Febrero, 2001)
6.2. Versi�n 0.9.11 (3 de Noviembre, 2000)
6.3. Versi�n 0.9.10 (6 de Septiembre, 2000)
6.4. Versi�n 0.9.9 (11 de Agosto, 2000)
6.5. Versi�n 0.9.8 (13 de Julio, 2000)
6.6. Versi�n 0.9.7 (17 de Junio, 2000)
6.7. Versi�n 0.9.6 (31 de Mayo, 2000)
6.8. Versi�n 0.9.5 (31 de Mayo, 2000)
6.9. Versi�n 0.9.4.3 (14 de Abril, 2000)
6.10. Versi�n 0.9.4.2 (31 de Marzo, 2000)
6.11. Versi�n 0.9.4.1 (18 de Marzo, 2000)
7. Sobre la traducci�n

Cap�tulo 1. Introducci�n

EL controlador de la tarjeta Ethernet Tulip es mantenido por Jeff Garzik ().

El controlador Tulip fue desarrollado por Donald Becker y cambiado por Jeff Garzik, Takashi Manabe y unos miles m�s.

Para 2.4.x y n�cleos posteriores, el controlador Linux Tulip driver est� disponible en http://sourceforge.net/projects/tulip/

Este controlador es para la interfaz del adaptador Ethernet Digital "Tulip" Deber�a de trabajar con la mayor�a de las tarjetas de red/chips basados en DEC 21*4*, al igual que con los chips similares de Lite-On (PNIC) y Macronix (MXIC) y ASIX.

El autor original puede ser encontrado como becker@scyld.com, o C/O Scyld Computing Corporation, 410 Severn Ave., Suite 210, Annapolis MD 21403

Informaci�n adicional del tulip.c de Donald Becker est� disponible en http://www.scyld.com/network/tulip.html

Cap�tulo 2. Compatibilidad de Controlador

Este controlador de dispositivo est� dise�ado para el chip de DEC "Tulip", los controladores ethernet de un s�lo chip de Digital para PCI (no propietario de Intel). Los miembros soportados de la familia son 21040, 21041, 21140, 21140A, 21142, y 21143. Los chips similares de Lite-On, Macronics, ASIX, Compex y otros listados m�s abajo tambi�n son soportados.

Estos chips son usados en al menos 140 dise�os �nicos de placas PCI. El gran n�mero de chips y dise�os de placas soportadas es el motivo para el tama�o y complejidad del controlador. La mayor�a del aumento de la complejidad est� en la configuraci�n de la placa y el c�digo de selecci�n de medio. Hay muy poco incremento en la longitud del camino cr�tico operacional.

Cap�tulo 3. Par�metros espec�ficos de la placa

Los dispositivos del bus PCI son configurados por el sistema en tiempo de arranque, por lo tanto ning�n jumper tiene que ser establecido en la placa. Preferiblemente la BIOS del sistema deber�a de asignar la se�al PCI INTA o en otro caso una linea IRQ del sistema sin usar.

Algunas placas tienen tablas de EEPROMS con una entrada de medio por defecto. La opci�n por defecto de la f�brica es "autoselect". Esto deber�a de ser s�lo sobreescrito cuando se usan conexiones transmisoras sin latido de enlace, ej. 10base2 o AUI, o (�r�ramente!) para forzar full-duplex cuando es usado con compa�eros de enlace viejos que no realizan autonegociaci�n.

Cap�tulo 4. Operaci�n del Controlador

4.1. buffers de Anillo

El Tulip puede usar buffers de anillo o lista de descriptores Tx y Rx. Este controlador usa anillos est�ticamente asignados de descriptores Rx y Tx, establecidos en tiempo de compilaci�n por RX/TX_RING_SIZE. Esta versi�n del controlador asigna skbuffs para los buffers de anillo Rx en tiempo de open() y pasa el campo skb-data al Tulip cuando recibe los buffers de datos. Cuando un frame que llega es menor que RX_COPYBREAK bytes de grande, un nuevo skbuff es asignado y el frame es copiado en el nuevo skbuff. Cuando el frame que llega es m�s grande, el skbuff es pasado directamente a la pila de protocolos y reemplazado por un skbuff nuevamente asignado.

El valor RX_COPYBREAK es escogido para equilibrar la memoria gastada usando un skbuff lleno para los frames peque�os vs. los costes de copiado para los frames grandes. Para los frames peque�os los costes de copiado son insignificantes (considerando que estamos precargando la cach� con inmediatamente con informaci�n �til de la cabecera). Para frames grandes los costes de copiado no son triviales, y la copia m�s grande quiz�s borre datos �tiles de la cach�. Un aspecto sutil de esta elecci�n es que el Tulip s�lo recibe en buffers de palabras grandes (64 bits) alineadas, esto es, la cabecera IP con un desplazamiento de 14 no es una palabra grande alineada para un procesamiento m�s amplio. Los frames copiados son puestos en el nuevo skbuff con un desplazamiento de "+2", entonces copiando tiene el efecto beneficioso de alinear la cabecera IP y precargar la cach�.

4.2. Sincronizaci�n

El controlador se ejecuta como dos flujos de control de un s�lo hilo independientes. Uno es la rutina de enviar paquetes, que fuerza el uso de un hilo simple por medio de la flag dev->tbusy. El otro hilo es el manejador de interrupciones, que es un hilo simple por culpa del hardware y de otro software.

El hilo de enviar paquetes tiene control parcial sobre el anillo Tx y sobre la bandera 'dev->tbusy'. Establece la bandera tbusy cuando est� encolando un paquete Tx. Si el siguiente slot de la cola est� vac�o, l�mpia la bandera tbusy cuando ha acabado y en otro caso establece la bandera 'tp->tx_full'.

El manejador de interrupciones tiene un control exclusivo sobre el anillo Tx y las estad�sticas grabadas para el anillo Tx. (La interrupci�n Tx-done no puede ser desconectada selectivamente, por lo tanto no podemos eliminar la interrupci�n sobre nosotros teniendo la rutina Tx recogiendo las estad�sticas Tx.) Despu�s de recoger las estad�sticas, marca la cola de entrada como vac�a estableciendo la 'base' a cero. Si la bandera 'tp->tx_full' est� establecida, entonces limpia las banderas tx_full y tbusy.

Cap�tulo 5. Errores

Los viejos libros de datos DEC eran ligeros en los detalles. El libro de datos 21040 ped�a que CSR13, CSR14 y CSR15 deber�an de ser el �ltimo registro del conjunto CSR12-15 escrito. Ummm, �c�mo es esto posible?

El formato DEC SROM est� muy mal dise�ado y no precisamente definido, llevando a la parte de selecci�n del medio la cabecera desperdiciada posterior. Algunas placas no tienen las tablas de medios EEPROM y necesitan ser arregladas. Peor, otras placas usan el kit de dise�o DEC de tablas de medios cuando no es correcto para sus placas.

No podemos usar las interrupciones MII porque no est� definido el pin GPIO para atacarlas. El status del transmisor MII es preguntado usando un cron�metro del n�cleo.

Cap�tulo 6. Historia de Cambios del Controlador

6.1. Versi�n 0.9.14 (20 de Febrero, 2001)

6.2. Versi�n 0.9.11 (3 de Noviembre, 2000)

6.3. Versi�n 0.9.10 (6 de Septiembre, 2000)

6.4. Versi�n 0.9.9 (11 de Agosto, 2000)

6.5. Versi�n 0.9.8 (13 de Julio, 2000)

6.6. Versi�n 0.9.7 (17 de Junio, 2000)

6.7. Versi�n 0.9.6 (31 de Mayo, 2000)

6.8. Versi�n 0.9.5 (31 de Mayo, 2000)

6.9. Versi�n 0.9.4.3 (14 de Abril, 2000)

6.10. Versi�n 0.9.4.2 (31 de Marzo, 2000)

6.11. Versi�n 0.9.4.1 (18 de Marzo, 2000)

Cap�tulo 7. Sobre la traducci�n

Este documento es la traducci�n de "Tulip Driver User's Guide", documento que acompa�a al c�digo del n�cleo de Linux, versi�n 2.4.18.

Este documento ha sido traducido por Rub�n Melc�n ; y es publicado por el Proyecto Lucas

Versi�n de la traduci�n 0.04 ( Julio de 2002 ).

Si tienes comentarios sobre la traducci�n, ponte en contacto con Rub�n Melc�n

Done.