Documentation/digiepca.txt

   1 The Digi Intl. epca driver.
   2 ----------------------------
   3 The Digi Intl. epca driver for Linux supports the following boards:
   4
   5 Digi PC/Xem, PC/Xr, PC/Xe, PC/Xi, PC/Xeve
   6 Digi EISA/Xem, PCI/Xem, PCI/Xr
   7
   8 Limitations:
   9 ------------
  10 Currently the driver only autoprobes for supported PCI boards.
  11
  12 The Linux MAKEDEV command does not support generating the Digiboard
  13 Devices.  Users executing digiConfig to setup EISA and PC series cards
  14 will have their device nodes automatically constructed (cud?? for ~CLOCAL,
  15 and ttyD?? for CLOCAL).  Users wishing to boot their board from the LILO
  16 prompt, or those users booting PCI cards may use buildDIGI to construct
  17 the necessary nodes.
  18
  19 Notes:
  20 ------
  21 This driver may be configured via LILO.  For users who have already configured
  22 their driver using digiConfig, configuring from LILO will override previous
  23 settings.  Multiple boards may be configured by issuing multiple LILO command
  24 lines.  For examples see the bottom of this document.
  25
  26 Device names start at 0 and continue up.  Beware of this as previous Digi
  27 drivers started device names with 1.
  28
  29 PCI boards are auto-detected and configured by the driver.  PCI boards will
  30 be allocated device numbers (internally) beginning with the lowest PCI slot
  31 first.  In other words a PCI card in slot 3 will always have higher device
  32 nodes than a PCI card in slot 1.
  33
  34 LILO config examples:
  35 ---------------------
  36 Using LILO's APPEND command, a string of comma separated identifiers or
  37 integers can be used to configure supported boards.  The six values in order
  38 are:
  39
  40    Enable/Disable this card or Override,
  41    Type of card: PC/Xe (AccelePort) (0), PC/Xeve (1), PC/Xem or PC/Xr (2),
  42                  EISA/Xem (3), PC/64Xe (4), PC/Xi (5),
  43    Enable/Disable alternate pin arrangement,
  44    Number of ports on this card,
  45    I/O Port where card is configured (in HEX if using string identifiers),
  46    Base of memory window (in HEX if using string identifiers),
  47
  48 NOTE : PCI boards are auto-detected and configured.  Do not attempt to
  49 configure PCI boards with the LILO append command.  If you wish to override
  50 previous configuration data (As set by digiConfig), but you do not wish to
  51 configure any specific card (Example if there are PCI cards in the system)
  52 the following override command will accomplish this:
  53 -> append="digi=2"
  54
  55 Samples:
  56    append="digiepca=E,PC/Xe,D,16,200,D0000"
  57                   or
  58    append="digi=1,0,0,16,512,851968"
  59
  60 Supporting Tools:
  61 -----------------
  62 Supporting tools include digiDload, digiConfig, buildPCI, and ditty.  See
  63 /usr/src/linux/Documentation/README.epca.dir/user.doc for more details.  Note,
  64 this driver REQUIRES that digiDload be executed prior to it being used.
  65 Failure to do this will result in an ENODEV error.
  66
  67 The latest version of the tool package is available at:
  68 ftp://ftp.dgii.com/drivers/linux/released/async/
  69
  70 Documentation:
  71 --------------
  72 Complete documentation for this product may be found in the tool package.
  73
  74 Sources of information and support:
  75 -----------------------------------
  76 Digi Intl. support site for this product:
  77 -> digilnux@dgii.com
  78
  79 Related information and information concerning other drivers supporting
  80 Digi Intl. products:
  81
  82 -> FTP: ftp://dgii.com
  83 -> Webpage: http://www.dgii.com
  84 -> Webpage: http://lameter.com/digi
  85
  86 Acknowledgments:
  87 ----------------
  88 Much of this work (And even text) was derived from a similar document
  89 supporting the original public domain DigiBoard driver Copyright (C)
  90 1994,1995 Troy De Jongh.  Many thanks to Christoph Lameter
  91 (christoph@lameter.com) and Mike McLagan (mike.mclagan@linux.org) who authored
  92 and contributed to the original document.