Devices                                                 socal(7D)



NAME
     socal - Serial Optical Controller for  Fibre  Channel  Arbi-
     trated Loop (SOC]) device driver

SYNOPSIS
     socal@sbus-slot,0


DESCRIPTION
     The Fibre Channel Host Bus Adapter is  an  SBus  card  which
     implements  two  full duplex Fibre Channel interfaces.  Each
     Fibre Channel interface can connect to a Fibre Channel Arbi-
     trated Loop (FC-AL).


     The  socal device driver is a nexus  driver  and  implements
     portions of the FC-2 and FC-4 layers of FC-AL.

FILES
     /kernel/drv/socal    ELF Kernel Module


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Architecture                 SPARC                       
    


SEE ALSO
     sbus(4), sf(7D), ssd(7D)


     Writing Device Drivers


     ANSI X3.230-1994,  Fibre  Channel  Physical  and  Signalling
     Interface (FC-PH)


     ANSI X3.272-1996, Fibre Channel Arbitrated Loop (FC-AL)


     Fibre Channel Private Loop SCSI Direct Attach (FC-PLDA)





SunOS 5.11           Last change: 9 May 1997                    1






Devices                                                 socal(7D)



DIAGNOSTICS
     The messages described below  may appear on  system  console
     in addition to being logged.


     On the console, these messages are preceded by:

       socal%d: port %a




     where  %d is the instance number of  the   socal  controller
     and  %a is the port on the host adapter.

     Fibre Channel Loop is ONLINE

         The Fibre Channel loop is now online.


     Fibre Channel Loop is OFLINE

         The Fibre Channel loop is now offline.


     attach failed: device in slave-only slot.

         Move soc] card to another slot.


     attach failed: bad soft state.

         Driver did not attach, devices will be inaccessible.


     attach failed: unable to alloc xport struct.

         Driver did not attach, devices will be inaccessible.


     attach failed: unable to map eeprom

         Driver was unable to map device memory;  check  for  bad
         hardware.  Driver did not attach to device, devices will
         be inaccessible.


     attach failed: unable to map XRAM

         Driver was unable to map device memory;  check  for  bad
         hardware.   Driver  did   not  attach to device, devices
         will be inaccessible.



SunOS 5.11           Last change: 9 May 1997                    2






Devices                                                 socal(7D)



     attach failed: unable to map registers

         Driver was unable to map device registers; check for bad
         hardware.   Driver   did  not  attach to device, devices
         will be inaccessible.


     attach failed: unable to access status register

         Driver was unable to map device registers; check for bad
         hardware.   Driver   did  not  attach to device, devices
         will be inaccessible.


     attach failed: unable to install interrupt handler

         Driver was not able to add the interrupt routine to  the
         kernel.   Driver  did not attach to device, devices will
         be inaccessible.


     attach failed: unable to access host adapter XRAM

         Driver was unable to access device RAM;  check  for  bad
         hardware.   Driver   did  not  attach to device, devices
         will be inaccessible.


     attach failed: unable to write host adapter XRAM

         Driver was unable to write device  RAM;  check  for  bad
         hardware.   Driver   did  not  attach to device, devices
         will be inaccessible.


     attach failed: read/write mismatch in XRAM

         Driver was unable to verify device RAM;  check  for  bad
         hardware.   Driver   did  not  attach to device, devices
         will be inaccessible.















SunOS 5.11           Last change: 9 May 1997                    3