git.oblomov.eu Git - linux-2.6/blob - Documentation/scsi/hptiop.txt

   1 HIGHPOINT ROCKETRAID 3xxx/4xxx ADAPTER DRIVER (hptiop)
   2
   3 Controller Register Map
   4 -------------------------
   5
   6 For Intel IOP based adapters, the controller IOP is accessed via PCI BAR0:
   7
   8      BAR0 offset    Register
   9             0x10    Inbound Message Register 0
  10             0x14    Inbound Message Register 1
  11             0x18    Outbound Message Register 0
  12             0x1C    Outbound Message Register 1
  13             0x20    Inbound Doorbell Register
  14             0x24    Inbound Interrupt Status Register
  15             0x28    Inbound Interrupt Mask Register
  16             0x30    Outbound Interrupt Status Register
  17             0x34    Outbound Interrupt Mask Register
  18             0x40    Inbound Queue Port
  19             0x44    Outbound Queue Port
  20
  21 For Marvell IOP based adapters, the IOP is accessed via PCI BAR0 and BAR1:
  22
  23      BAR0 offset    Register
  24          0x20400    Inbound Doorbell Register
  25          0x20404    Inbound Interrupt Mask Register
  26          0x20408    Outbound Doorbell Register
  27          0x2040C    Outbound Interrupt Mask Register
  28
  29      BAR1 offset    Register
  30              0x0    Inbound Queue Head Pointer
  31              0x4    Inbound Queue Tail Pointer
  32              0x8    Outbound Queue Head Pointer
  33              0xC    Outbound Queue Tail Pointer
  34             0x10    Inbound Message Register
  35             0x14    Outbound Message Register
  36      0x40-0x1040    Inbound Queue
  37    0x1040-0x2040    Outbound Queue
  38
  39
  40 I/O Request Workflow
  41 ----------------------
  42
  43 All queued requests are handled via inbound/outbound queue port.
  44 A request packet can be allocated in either IOP or host memory.
  45
  46 To send a request to the controller:
  47
  48     - Get a free request packet by reading the inbound queue port or
  49       allocate a free request in host DMA coherent memory.
  50
  51       The value returned from the inbound queue port is an offset
  52       relative to the IOP BAR0.
  53
  54       Requests allocated in host memory must be aligned on 32-bytes boundary.
  55
  56     - Fill the packet.
  57
  58     - Post the packet to IOP by writing it to inbound queue. For requests
  59       allocated in IOP memory, write the offset to inbound queue port. For
  60       requests allocated in host memory, write (0x80000000|(bus_addr>>5))
  61       to the inbound queue port.
  62
  63     - The IOP process the request. When the request is completed, it
  64       will be put into outbound queue. An outbound interrupt will be
  65       generated.
  66
  67       For requests allocated in IOP memory, the request offset is posted to
  68       outbound queue.
  69
  70       For requests allocated in host memory, (0x80000000|(bus_addr>>5))
  71       is posted to the outbound queue. If IOP_REQUEST_FLAG_OUTPUT_CONTEXT
  72       flag is set in the request, the low 32-bit context value will be
  73       posted instead.
  74
  75     - The host read the outbound queue and complete the request.
  76
  77       For requests allocated in IOP memory, the host driver free the request
  78       by writing it to the outbound queue.
  79
  80 Non-queued requests (reset/flush etc) can be sent via inbound message
  81 register 0. An outbound message with the same value indicates the completion
  82 of an inbound message.
  83
  84
  85 User-level Interface
  86 ---------------------
  87
  88 The driver exposes following sysfs attributes:
  89
  90      NAME                 R/W    Description
  91      driver-version        R     driver version string
  92      firmware-version      R     firmware version string
  93
  94
  95 -----------------------------------------------------------------------------
  96 Copyright (C) 2006-2007 HighPoint Technologies, Inc. All Rights Reserved.
  97
  98   This file is distributed in the hope that it will be useful,
  99   but WITHOUT ANY WARRANTY; without even the implied warranty of
 100   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 101   GNU General Public License for more details.
 102
 103   linux@highpoint-tech.com
 104   http://www.highpoint-tech.com