workbench/devs/networks/etherlink3/Notes

   1 TO DO:
   2
   3  - "Boomerang" generation cards don't work with this driver yet.
   4
   5
   6 DESIGN NOTES:
   7
   8  - The single-fragment bus-master mode of 3c59x cards is unused as it
   9    does not appear to be worthwhile.
  10  - Type tracking has been implemented in an unusual way in order to make it
  11    more suitable for multiple users. Each client that tracks a particular
  12    packet type is given the impression that it is the only one doing so.
  13    When a client begins tracking a packet type that is already being
  14    tracked, the current packet statistics are recorded internally. These
  15    initial statistics are then subtracted from the figures returned from
  16    every S2_GETTYPESTATS call the client makes.
  17  - The port_choices array gives the order of preference for the media ports.
  18  - When selecting which media port to use, we progressively filter the
  19    ports, first by availability, then by user choice, and finally by the
  20    detection of an active link. We then choose from the remainder in order
  21    of priority.
  22  - We can't run out of space in the header buffer...
  23  - The driver is designed to work best with protocols that provide the S2R3
  24    DMA hooks. Other protocols may suffer poor transmission performance, as
  25    the driver's single transmit buffer must be used.
  26  - tx_out_slot points to the next packet to finish. tx_in_slot points to the
  27    next free slot. If tx_out_slot equals tx_in_slot, there are no packets
  28    waiting to complete.
  29  - There is nothing in the SANA-II docs to indicate that providing a tag
  30    list is optional, so it is assumed to be present.
  31
  32
  33 TCP/IP STACK BUGS TO CONSIDER:
  34
  35  - Miami(DX) doesn't like requests being aborted upon S2_OFFLINE.
  36  - MiamiDX's CopyFromBuff16/32 functions appear to be broken.
  37  - Genesis calls S2_ONLINE before S2_CONFIGINTERFACE?
  38  - When a device goes back online without Genesis's intervention, Genesis
  39    displays the message "eth0 is online again" or similar, but keeps the
  40    interface's indicator red and doesn't disable the "Online" button or
  41    enable the "Offline" button.
  42
  43