About Kernel Documentation Linux Kernel Contact Linux Resources Linux Blog

Documentation / scsi / hptiop.txt

Based on kernel version 2.6.25. Page generated on 2008-04-18 21:22 EST.

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[AT]highpoint-tech[DOT]com
104	  http://www.highpoint-tech.com
Hide Line Numbers
About Kernel Documentation Linux Kernel Contact Linux Resources Linux Blog

Information is copyright its respective author. All material is available from the Linux Kernel Source distributed under a GPL License. This page is provided as a free service by mjmwired.net.