fs: use kmem_cache_zalloc instead
[pv_ops_mirror.git] / Documentation / scsi / hptiop.txt
blobd28a31247d4c0997a10415d8562449afffeaac82
1 HIGHPOINT ROCKETRAID 3xxx RAID DRIVER (hptiop)
3 Controller Register Map
4 -------------------------
6 The controller IOP is accessed via PCI BAR0.
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
22 I/O Request Workflow
23 ----------------------
25 All queued requests are handled via inbound/outbound queue port.
26 A request packet can be allocated in either IOP or host memory.
28 To send a request to the controller:
30     - Get a free request packet by reading the inbound queue port or
31       allocate a free request in host DMA coherent memory.
33       The value returned from the inbound queue port is an offset
34       relative to the IOP BAR0.
36       Requests allocated in host memory must be aligned on 32-bytes boundary.
38     - Fill the packet.
40     - Post the packet to IOP by writing it to inbound queue. For requests
41       allocated in IOP memory, write the offset to inbound queue port. For
42       requests allocated in host memory, write (0x80000000|(bus_addr>>5))
43       to the inbound queue port.
45     - The IOP process the request. When the request is completed, it
46       will be put into outbound queue. An outbound interrupt will be
47       generated.
49       For requests allocated in IOP memory, the request offset is posted to
50       outbound queue.
52       For requests allocated in host memory, (0x80000000|(bus_addr>>5))
53       is posted to the outbound queue. If IOP_REQUEST_FLAG_OUTPUT_CONTEXT
54       flag is set in the request, the low 32-bit context value will be
55       posted instead.
57     - The host read the outbound queue and complete the request.
59       For requests allocated in IOP memory, the host driver free the request
60       by writing it to the outbound queue.
62 Non-queued requests (reset/flush etc) can be sent via inbound message
63 register 0. An outbound message with the same value indicates the completion
64 of an inbound message.
67 User-level Interface
68 ---------------------
70 The driver exposes following sysfs attributes:
72      NAME                 R/W    Description
73      driver-version        R     driver version string
74      firmware-version      R     firmware version string
76 The driver registers char device "hptiop" to communicate with HighPoint RAID
77 management software. Its ioctl routine acts as a general binary interface 
78 between the IOP firmware and HighPoint RAID management software. New management
79 functions can be implemented in application/firmware without modification
80 in driver code.
83 -----------------------------------------------------------------------------
84 Copyright (C) 2006 HighPoint Technologies, Inc. All Rights Reserved.
86   This file is distributed in the hope that it will be useful,
87   but WITHOUT ANY WARRANTY; without even the implied warranty of
88   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
89   GNU General Public License for more details.
91   linux@highpoint-tech.com
92   http://www.highpoint-tech.com