Return to aha154x CVS log

Up to [MW Coherent from dump] / coherent / f / usr / man / KERNEL

Annotation of coherent/f/usr/man/KERNEL/aha154x, revision 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: 

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