home *** CD-ROM | disk | FTP | other *** search
/ PC Welt 1999 October (Suse) / SU6203.E01.ISO / docu / i82365.txt < prev    next >
Encoding:
Text File  |  1999-08-23  |  10.8 KB  |  331 lines
  1.  
  2.  
  3.  
  4. I82365(4)                                               I82365(4)
  5.  
  6.  
  7. NAME
  8.        i82365 - Intel i82365sl PCMCIA controller driver
  9.  
  10. SYNOPSIS
  11.        insmod   i82365.o  [pc_debug=n]  [i365_base=n]  [ignore=n]
  12.        [extra_sockets=n]      [do_scan=n]      [irq_list=i,j,...]
  13.        [cs_irq=n]         [poll_interval=n]        [cycle_time=n]
  14.        [do_pci_probe=n]      [cb_mem_base=n]      [cb_bus_base=n]
  15.        [cb_bus_step=n]  [cb_write_post=n] [pci_csc=n] [pci_int=n]
  16.        [has_dma=n]   [has_led=n]   [has_ring=n]   [freq_bypass=n]
  17.        [setup_time=n]   [cmd_time=n]   [recov_time=n]  [wakeup=n]
  18.        [fast_pci=n] [async_clock=n] [cable_mode=n] [has_clkrun=n]
  19.        [clkrun_sel=n] [irq_mode=n]
  20.  
  21. DESCRIPTION
  22.        This is the low-level driver for the Intel i82365sl PCMCIA
  23.        host controller, and many derivative controllers.  It also
  24.        implements  the  Intel  "Yenta" register specification for
  25.        CardBus bridges.  Common clones of  the  i82365sl  include
  26.        controllers  made  by  Cirrus  Logic,  IBM, O2Micro, Omega
  27.        Micro, Ricoh, SMC, Texas Instruments, Toshiba, Vadem,  and
  28.        VLSI.   The  overwhelming  majority of current PCMCIA con¡
  29.        trollers, and all CardBus bridges, are register compatible
  30.        with  the  i82365sl.  This driver is used by Card Services
  31.        for configuring the host controller,  and  for  monitoring
  32.        card status change events.
  33.  
  34.        When the i82365 driver is loaded, it will try to determine
  35.        what interrupts can safely be allocated for use by  PCMCIA
  36.        devices.   Cirrus  controllers  support some optional fea¡
  37.        tures that interfere with the  use  of  certain  interrupt
  38.        lines.  Cirrus chips also lack the functionality needed to
  39.        detect whether or not  an  interrupt  can  be  used.   The
  40.        has_dma, has_ring, and has_led options are used to specify
  41.        if these features are implemented.
  42.  
  43.        An i82365-compatible controller normally sits  at  the  IO
  44.        addresses  0x3e0-0x3e1.   Two controllers can cooperate to
  45.        share the same IO ports, supporting a total of four  sock¡
  46.        ets.   A  second  pair  of  controllers  can be located at
  47.        0x3e2-0x3e3.  Probing at this position  is  controlled  by
  48.        the  extra_sockets  parameter.   The driver will support a
  49.        maximum of eight sockets.
  50.  
  51.  
  52. PARAMETERS
  53.        pc_debug=n
  54.               Selects the PCMCIA debugging level.  This parameter
  55.               is  only  available  if the module is compiled with
  56.               debugging enabled.  A non-zero value enables debug¡
  57.               ging.
  58.  
  59.        i365_base=n
  60.               Sets  the  base  I/O  port  address of the i82365sl
  61.  
  62.  
  63.  
  64. pcmcia-cs              1999/06/14 04:32:18                      1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. I82365(4)                                               I82365(4)
  71.  
  72.  
  73.               chip.  The default is 0x3e0.
  74.  
  75.        ignore=n
  76.               Causes the driver to ignore a single socket.  Sock¡
  77.               ets are numbered starting at 0.  The socket will be
  78.               left in whatever state it was already in, so it can
  79.               be  used  for cards with point enablers that do not
  80.               cooperate with Card Services.
  81.  
  82.        extra_sockets=n
  83.               A flag indicating if the driver should probe for as
  84.               many  as  eight sockets, or stop after checking for
  85.               four sockets.  The default is 0 (stop at four sock¡
  86.               ets).   Systems  with  two  independent PCMCIA con¡
  87.               trollers (say, one internal and one  in  a  docking
  88.               station)  may  require  this  flag  to be set, even
  89.               though they have a total of only four sockets.   If
  90.               this flag is set, then poll_interval will automati¡
  91.               cally be enabled.
  92.  
  93.        do_scan=n
  94.               This flag specifies that all free interrupts should
  95.               be  tested  to  see if they can be triggered by the
  96.               PCMCIA controller.  The default is 1 (true).
  97.  
  98.        irq_list=i,j,...
  99.               Specifies the set of interrupts that may  be  allo¡
  100.               cated  by this driver, if they are otherwise avail¡
  101.               able.  The default list is 3, 4, 5, 7, 9,  10,  11,
  102.               12, 14, and 15.
  103.  
  104.        cs_irq=n
  105.               Sets  the interrupt line to use for monitoring card
  106.               status changes.  The default is 0, which means pick
  107.               the highest-numbered legal interrupt not already in
  108.               use.  Legal values are 15, 14, 12, 11, 10, 9, 7, 5,
  109.               4, and 3.
  110.  
  111.        poll_interval=n
  112.               Sets the card status polling delay, in 1/100 second
  113.               increments.  If this parameter is set, card  status
  114.               interrupts will be disabled.  A reasonable value is
  115.               100.
  116.  
  117.        cycle_time=n
  118.               Sets the length of a host bus  cycle,  in  nanosec¡
  119.               onds.   The  default  is 210 ns, corresponding to a
  120.               standard 4.77 MHz clock.
  121.  
  122.  
  123. Options for CardBus controllers
  124.        do_pci_probe=n
  125.               This flag indicates if the PCI bus should be probed
  126.               for  PCI-to-PCMCIA  and/or  PCI-to-CardBus bridges.
  127.  
  128.  
  129.  
  130. pcmcia-cs              1999/06/14 04:32:18                      2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. I82365(4)                                               I82365(4)
  137.  
  138.  
  139.               The default is 1 (true).
  140.  
  141.        cb_mem_base=n
  142.               Sets the base address to  use  for  memory  mapping
  143.               CardBus registers, if not set by the PCI BIOS.  The
  144.               default is 0x68000000.
  145.  
  146.        cb_bus_base=n
  147.               Specifies that PCI bus numbers for  CardBus  busses
  148.               should  be renumbered starting with this value.  By
  149.               default, bus values that are uninitialized at  boot
  150.               time will be numbered starting with bus 0x20.
  151.  
  152.        cb_bus_step=n
  153.               Specifies  the  number  of bus slots to reserve for
  154.               secondary PCI busses, for each CardBus socket, when
  155.               busses are renumbered.  The default is 2.
  156.  
  157.        cb_write_post=n
  158.               A  flag  indicating if write posting (a performance
  159.               feature) should  be  enabled.   The  default  is  1
  160.               (true), except on TI 1130 bridges.
  161.  
  162.        pci_csc=n
  163.               Specifies that card status change interrupts should
  164.               be routed  to  PCI  interrupts,  for  CardBus  con¡
  165.               trollers.  The default is 0 (false).
  166.  
  167.        pci_int=n
  168.               Specifies  that  functional interrupts for IO cards
  169.               should be routed to  PCI  interrupts,  for  CardBus
  170.               controllers.  The default is 0 (false).
  171.  
  172.  
  173. Options specific for Cirrus controllers
  174.        has_dma=n
  175.               A  flag  indicating  if the controller has DMA sup¡
  176.               port.
  177.  
  178.        has_led=n
  179.               A flag indicating if the controller is wired for  a
  180.               disk status LED.  This is set by default.
  181.  
  182.        has_ring=n
  183.               A  flag  indicating if the controller's "ring indi¡
  184.               cate"  signal  is  implemented.   This  is  set  by
  185.               default.
  186.  
  187.        freq_bypass=n
  188.               A flag indicating that the controller should be set
  189.               up in "frequency bypass" mode.  This  disables  the
  190.               normal  7/4  clock  multiplier,  and slows down all
  191.               PCMCIA bus access, for  systems  with  fast  system
  192.               clocks.
  193.  
  194.  
  195.  
  196. pcmcia-cs              1999/06/14 04:32:18                      3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. I82365(4)                                               I82365(4)
  203.  
  204.  
  205.        setup_time=n
  206.               Sets  the bus setup time, in internal clock cycles.
  207.               The default is 1.
  208.  
  209.        cmd_time=n
  210.               Sets  the  bus  command  time,  in  internal  clock
  211.               cycles. The default is 6.
  212.  
  213.        recov_time=n
  214.               Sets  the  bus  recovery  time,  in  internal clock
  215.               cycles. The default is 0.
  216.  
  217.        wakeup=n
  218.               A flag indicating  if  the  probe  function  should
  219.               attempt  to  wake  up  a suspended controller chip.
  220.               The default is 0.
  221.  
  222.        fast_pci=n
  223.               A flag for the CL6729  PCI  controller,  indicating
  224.               that the PCI bus speed exceeds 25 MHz.
  225.  
  226.  
  227. Options specific for Ricoh CardBus controllers
  228.        irq_mode=n
  229.               Selects the interrupt routing method.  A value of 1
  230.               selects ISA interrupt routing, and 2 selects inter¡
  231.               rupt  routing via an external serial interrupt con¡
  232.               troller.  The default is to  use  whatever  routing
  233.               method is already enabled.
  234.  
  235.        setup_time=n
  236.               Sets  the bus setup time, in internal clock cycles.
  237.               The default is 3.
  238.  
  239.        cmd_time=n
  240.               Sets  the  bus  command  time,  in  internal  clock
  241.               cycles. The default is 6.
  242.  
  243.        hold_time=n
  244.               Sets  the  bus hold time, in internal clock cycles.
  245.               The default is 1.
  246.  
  247.  
  248. Options specific for Vadem controllers
  249.        async_clock=n
  250.               This flag specifies that PCMCIA bus  cycles  should
  251.               be clocked asynchronously from host bus cycles.  It
  252.               effectively adds a wait state to  some  operations.
  253.               cable_mode=n  For the VG469, this flag adjusts cer¡
  254.               tain socket signals for driving a socket  connected
  255.               via a cable.
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262. pcmcia-cs              1999/06/14 04:32:18                      4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. I82365(4)                                               I82365(4)
  269.  
  270.  
  271. Options specific for TI CardBus controllers
  272.        Normally,  a  system's  BIOS  will configure these options
  273.        appropriately, so all these  options  default  to  leaving
  274.        these features configured the way the driver finds them.
  275.  
  276.        has_ring=n
  277.               A  flag  indicating  if the controller is wired for
  278.               "ring indicate".  The default is to read  the  cur¡
  279.               rent setting from the controller.
  280.  
  281.        has_clkrun=n
  282.               A  flag  indicating  if the controller is wired for
  283.               PCI CLKRUN support.  The default  is  to  read  the
  284.               current setting from the controller.
  285.  
  286.        clkrun_sel=n
  287.               A  flag indicating if the CLKRUN signal is wired to
  288.               the ISA interrupt 12 pin, as opposed to ISA  inter¡
  289.               rupt  10.   The default is to read the current set¡
  290.               ting from the controller.
  291.  
  292.        irq_mode=n
  293.               Selects the interrupt routing method.  A value of 1
  294.               selects ISA interrupt routing; 2 selects ISA inter¡
  295.               rupt routing via an external serial interrupt  con¡
  296.               troller;  and 3 selects serial routing for both PCI
  297.               and ISA interrupts.  The default is to use whatever
  298.               routing method is already active, or ISA routing if
  299.               no method is enabled.
  300.  
  301.  
  302. AUTHOR
  303.        David Hinds - dhinds@hyper.stanford.edu
  304.  
  305. SEE ALSO
  306.        cardmgr(8), pcmcia(5).
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328. pcmcia-cs              1999/06/14 04:32:18                      5
  329.  
  330.  
  331.