Annotation of coherent/f/usr/man/KERNEL/aha154x, revision 1.1.1.1

1.1       root        1: aahhaa115544xx -- Device Driver
                      2: 
                      3: 
                      4: The device  driver aahhaa115544xx lets you use SCSI  interface devices attached to
                      5: an Adaptec AHA-154x series host  adapter.  This driver has major number 13.
                      6: It can  be accessed  either as  a block-special device  or as  a character-
                      7: special device.  The minor number specifies the device and partition number
                      8: for disk-type  devices, letting you  use up to  eight SCSI-IDs, with  up to
                      9: four logical unit numbers (LUNs) per  SCSI-ID and up to four partitions per
                     10: LUN.
                     11: 
                     12: The  first  ooppeenn call  on  a  SCSI disk  device  allocates  memory for  the
                     13: partition table and reads it into memory.
                     14: 
                     15: _C_o_n_t_r_o_l_l_e_r _C_o_n_f_i_g_u_r_a_t_i_o_n
                     16: Prior  to installing  the Adaptec  host  adapter in  your system,  you must
                     17: configure  the  I/O base  address,  interrupt vector,  and  DMA channel  as
                     18: follows:
                     19: 
                     20:        I/O base address:0x330
                     21:        DMA channel:    5
                     22:        Interrupt vector:IRQ11
                     23: 
                     24: In addition, if you are using any synchronous SCSI peripherals, disable the
                     25: synchronous transfer option on the Adaptec host adapter.
                     26: 
                     27: After verifying that your controller works with COHERENT, you may select an
                     28: alternate I/O base address or an alternate interrupt vector.  Device-driver
                     29: variables SSDDBBAASSEE and SSDDIIRRQQ correspond to the I/O base address and interrupt
                     30: vector, respectively.   Variable SSDDDDMMAA sets  the number of  the DMA channel
                     31: being used.   See Lexicon article hhss  for an example of  how to configure a
                     32: device driver.
                     33: 
                     34: When processing  BIOS I/O requests  prior to booting  COHERENT, the Adaptec
                     35: host  adapter uses  translation  mode drive  parameters:  number of  heads,
                     36: cylinders, and  sectors per track.   Most current versions  of the AHA-154x
                     37: use values of  64 heads and 32 sectors per  track, and calculate the number
                     38: of cylinders based upon drive capacity.  Note that these numbers are called
                     39: ``translation-mode'' parameters  because they have  nothing to do  with the
                     40: geometry of  the physical drive.  Some early versions  of the AHA-154x, and
                     41: some versions distributed by Tandy, use  16 heads and 32 sectors per track.
                     42: Device driver variable SSDD_HHDDSS is initialized to 64 as shipped; it should be
                     43: patched  to  a value  of  16  for adapters  whose  BIOS  code uses  16-head
                     44: translation mode.   The translation-mode parameters  used by the  BIOS code
                     45: present on  your host adapter can  be obtained using the  iinnffoo command from
                     46: the  tertiary boot  in  versions 3.2.1  and  later of  COHERENT.  (See  the
                     47: article  on ttbboooott  for details.)  Note that  the BIOS  code is  executed by
                     48: COHERENT only  during initial bootstrap.  After  that, drive parameters are
                     49: of  no consequence  since SCSI  I/O requests are  based upon  logical block
                     50: number, rather than on cylinder/head/sector addressing.
                     51: 
                     52: The installation  procedure for COHERENT  versions 3.2.0 and  later patches
                     53: all necessary variables for  the accompanying version of the aahhaa115544xx driver
                     54: by executing the command:
                     55: 
                     56:     /etc/mkdev scsi
                     57: 
                     58: _M_i_n_o_r _D_e_v_i_c_e _N_u_m_b_e_r_s
                     59: The minor device number is decoded as follows:
                     60: 
                     61:        _B_i_t _n_u_m_b_e_r:  7 6 5 4 3 2 1 0
                     62:        _M_e_a_n_i_n_g:     S I I I L L P P
                     63: 
                     64: where  _S indicates  the ``special''  bit, _I_I_I  indicates a  three-bit field
                     65: containing the SCSI-ID  in the range of zero through  seven, _L_L indicates a
                     66: two-bit field containing  a LUN in the range of  zero through three, and _P_P
                     67: indicates a two-bit field that contains either a partition number for disk-
                     68: type devices or a set of special modes for devices other than disks.
                     69: 
                     70: The ``special'' bit and the partition number interact as follows:
                     71: 
                     72: _D_e_s_c_r_i_p_t_i_o_n        _S _B_i_t  _P_P  _D_e_v_i_c_e      _T_y_p_e
                     73: partition a        0      00 /dev/sd?a    disk
                     74: partition b        0      01 /dev/sd?b    disk
                     75: partition c        0      10 /dev/sd?c    disk
                     76: partition d        0      11 /dev/sd?d    disk
                     77: partition table    1      00 /dev/sd?x    disk
                     78: no rewind          1      01 /dev/sd?n    tape
                     79: RESERVED           1      10     ---      ----
                     80: rewind on close    1      11 /dev/sd?     tape
                     81: 
                     82: _L_o_a_d_i_n_g _t_h_e _D_r_i_v_e_r
                     83: On  COHERENT releases  which support loadable  device drivers,  the aahhaa115544xx
                     84: device driver  must be loaded  on a system  that does not have  a SCSI hard
                     85: disk as the root device.  To do so, use the command /eettcc/ddrrvvlldd, as follows:
                     86: 
                     87:                    /etc/drvld -r /drv/aha154x
                     88: 
                     89: _F_i_l_e_s
                     90: /ddeevv/ssdd* -- bblloocckk-ssppeecciiaall ddeevviicceess
                     91: /ddeevv/rrssdd* -- cchhaarraacctteerr-ssppeecciiaall ddeevviicceess
                     92: 
                     93: _S_e_e _A_l_s_o
                     94: ddeevviiccee ddrriivveerrss, ddrrvvlldd, ssccssii, ttbboooott
                     95: 

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.