xref: /netbsd/sys/dev/ic/mpt.h (revision 3c4c4c64)
1 /*	$NetBSD: mpt.h,v 1.9 2021/11/10 17:19:30 msaitoh Exp $	*/
2 
3 /*
4  * Copyright (c) 2000, 2001 by Greg Ansley
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice immediately at the beginning of the file, without modification,
11  *    this list of conditions, and the following disclaimer.
12  * 2. The name of the author may not be used to endorse or promote products
13  *    derived from this software without specific prior written permission.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR
19  * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25  * SUCH DAMAGE.
26  */
27 /*
28  * Additional Copyright (c) 2002 by Matthew Jacob under same license.
29  */
30 
31 /*
32  * mpt.h:
33  *
34  * Generic definitions for LSI Fusion adapters.
35  *
36  * Adapted from the FreeBSD "mpt" driver by Jason R. Thorpe for
37  * Wasabi Systems, Inc.
38  */
39 
40 #ifndef _DEV_IC_MPT_H_
41 #define	_DEV_IC_MPT_H_
42 
43 #include <dev/ic/mpt_netbsd.h>
44 
45 #define MPT_OK (0)
46 #define MPT_FAIL (0x10000)
47 
48 /* Register Offset to chip registers */
49 #define MPT_OFFSET_DOORBELL     0x00
50 #define MPT_OFFSET_SEQUENCE     0x04
51 #define MPT_OFFSET_DIAGNOSTIC   0x08
52 #define MPT_OFFSET_TEST         0x0C
53 #define MPT_OFFSET_INTR_STATUS  0x30
54 #define MPT_OFFSET_INTR_MASK    0x34
55 #define MPT_OFFSET_REQUEST_Q    0x40
56 #define MPT_OFFSET_REPLY_Q      0x44
57 #define MPT_OFFSET_HOST_INDEX   0x50
58 #define MPT_OFFSET_FUBAR        0x90
59 
60 #define MPT_DIAG_SEQUENCE_1     0x04
61 #define MPT_DIAG_SEQUENCE_2     0x0b
62 #define MPT_DIAG_SEQUENCE_3     0x02
63 #define MPT_DIAG_SEQUENCE_4     0x07
64 #define MPT_DIAG_SEQUENCE_5     0x0d
65 
66 /* Bit Maps for DOORBELL register */
67 enum DB_STATE_BITS {
68 	MPT_DB_STATE_RESET   =    0x00000000,
69 	MPT_DB_STATE_READY   =    0x10000000,
70 	MPT_DB_STATE_RUNNING =    0x20000000,
71 	MPT_DB_STATE_FAULT   =    0x40000000,
72 	MPT_DB_STATE_MASK    =    0xf0000000
73 };
74 
75 #define MPT_STATE(v) ((enum DB_STATE_BITS)((v) & MPT_DB_STATE_MASK))
76 
77 #define MPT_DB_LENGTH_SHIFT (16)
78 #define MPT_DB_DATA_MASK (0xffff)
79 
80 #define MPT_DB_DB_USED            0x08000000
81 #define MPT_DB_IS_IN_USE(v) (((v) & MPT_DB_DB_USED) != 0)
82 
83 /*
84  * "Whom" initializor values
85  */
86 #define	MPT_DB_INIT_NOONE       0x00
87 #define	MPT_DB_INIT_BIOS        0x01
88 #define	MPT_DB_INIT_ROMBIOS     0x02
89 #define	MPT_DB_INIT_PCIPEER     0x03
90 #define	MPT_DB_INIT_HOST        0x04
91 #define	MPT_DB_INIT_MANUFACTURE 0x05
92 
93 #define MPT_WHO(v)	\
94 	((v & MPI_DOORBELL_WHO_INIT_MASK) >> MPI_DOORBELL_WHO_INIT_SHIFT)
95 
96 /* Function Maps for DOORBELL register */
97 enum DB_FUNCTION_BITS {
98 	MPT_FUNC_IOC_RESET    =    0x40000000,
99 	MPT_FUNC_UNIT_RESET   =    0x41000000,
100 	MPT_FUNC_HANDSHAKE    =    0x42000000,
101 	MPT_FUNC_REPLY_REMOVE =    0x43000000,
102 	MPT_FUNC_MASK         =    0xff000000
103 };
104 
105 /* Function Maps for INTERRUPT request register */
106 enum _MPT_INTR_REQ_BITS {
107 	MPT_INTR_DB_BUSY      =    0x80000000,
108 	MPT_INTR_REPLY_READY  =    0x00000008,
109 	MPT_INTR_DB_READY     =    0x00000001
110 };
111 
112 #define MPT_DB_IS_BUSY(v) (((v) & MPT_INTR_DB_BUSY) != 0)
113 #define MPT_DB_INTR(v)    (((v) & MPT_INTR_DB_READY) != 0)
114 #define MPT_REPLY_INTR(v) (((v) & MPT_INTR_REPLY_READY) != 0)
115 
116 /* Function Maps for INTERRUPT make register */
117 enum _MPT_INTR_MASK_BITS {
118 	MPT_INTR_REPLY_MASK   =    0x00000008,
119 	MPT_INTR_DB_MASK      =    0x00000001
120 };
121 
122 /* Function Maps for DIAGNOSTIC make register */
123 enum _MPT_DIAG_BITS {
124 	MPT_DIAG_ENABLED      =    0x00000080,
125 	MPT_DIAG_FLASHBAD     =    0x00000040,
126 	MPT_DIAG_RESET_HIST   =    0x00000020,
127 	MPT_DIAG_TTLI         =    0x00000008,
128 	MPT_DIAG_RESET_IOC    =    0x00000004,
129 	MPT_DIAG_ARM_DISABLE  =    0x00000002,
130 	MPT_DIAG_DME          =    0x00000001
131 };
132 
133 /* Magic addresses in diagnostic memory space */
134 #define MPT_DIAG_IOP_BASE        (0x00000000)
135 #define MPT_DIAG_IOP_SIZE                      (0x00002000)
136 #define MPT_DIAG_GPIO            (0x00030010)
137 #define MPT_DIAG_IOPQ_REG_BASE0  (0x00050004)
138 #define MPT_DIAG_IOPQ_REG_BASE1  (0x00051004)
139 #define MPT_DIAG_MEM_CFG_BASE    (0x00040000)
140 #define MPT_DIAG_CTX0_BASE       (0x000E0000)
141 #define MPT_DIAG_CTX0_SIZE                     (0x00002000)
142 #define MPT_DIAG_CTX1_BASE       (0x001E0000)
143 #define MPT_DIAG_CTX1_SIZE                     (0x00002000)
144 #define MPT_DIAG_FLASH_BASE      (0x00800000)
145 #define MPT_DIAG_RAM_BASE        (0x01000000)
146 #define MPT_DIAG_RAM_SIZE                      (0x00400000)
147 
148 /* GPIO bit assignments */
149 #define MPT_DIAG_GPIO_SCL	(0x00010000)
150 #define MPT_DIAG_GPIO_SDA_OUT	(0x00008000)
151 #define MPT_DIAG_GPIO_SDA_IN	(0x00004000)
152 
153 #define MPT_REPLY_EMPTY   (0xffffffff)    /* Reply Queue Empty Symbol */
154 #define MPT_CONTEXT_REPLY (0x80000000)
155 #define MPT_CONTEXT_MASK  (~0xE0000000)
156 
157 #ifdef _KERNEL
158 int mpt_soft_reset(mpt_softc_t *);
159 void mpt_hard_reset(mpt_softc_t *);
160 int mpt_recv_handshake_reply(mpt_softc_t *, size_t, void *);
161 
162 void mpt_send_cmd(mpt_softc_t *, request_t *);
163 void mpt_free_reply(mpt_softc_t *, u_int32_t);
164 void mpt_enable_ints(mpt_softc_t *);
165 void mpt_disable_ints(mpt_softc_t *);
166 u_int32_t mpt_pop_reply_queue(mpt_softc_t *);
167 int mpt_hw_init(mpt_softc_t *);
168 int mpt_init(mpt_softc_t *, u_int32_t);
169 int mpt_reset(mpt_softc_t *);
170 int mpt_send_handshake_cmd(mpt_softc_t *, size_t, void *);
171 request_t * mpt_get_request(mpt_softc_t *);
172 void mpt_free_request(mpt_softc_t *, request_t *);
173 int mpt_intr(void *);
174 void mpt_check_doorbell(mpt_softc_t *);
175 
176 int mpt_read_cfg_header(mpt_softc_t *, int, int, int, fCONFIG_PAGE_HEADER *);
177 int mpt_read_cfg_page(mpt_softc_t *, int, fCONFIG_PAGE_HEADER *);
178 int mpt_write_cfg_page(mpt_softc_t *, int, fCONFIG_PAGE_HEADER *);
179 
180 /* mpt_debug.c functions */
181 void mpt_print_reply(void *);
182 void mpt_print_db(u_int32_t);
183 void mpt_print_config_reply(void *);
184 char *mpt_ioc_diag(u_int32_t);
185 const char *mpt_req_state(enum mpt_req_state);
186 void mpt_print_scsi_io_request(MSG_SCSI_IO_REQUEST *);
187 void mpt_print_config_request(void *);
188 void mpt_print_request(void *);
189 
190 /******************************** Endianness *********************************/
191 #define	MPT_2_HOST64(ptr, tag)	ptr->tag = le64toh(ptr->tag)
192 #define	MPT_2_HOST32(ptr, tag)	ptr->tag = le32toh(ptr->tag)
193 #define	MPT_2_HOST16(ptr, tag)	ptr->tag = le16toh(ptr->tag)
194 
195 #define	HOST_2_MPT64(ptr, tag)	ptr->tag = htole64(ptr->tag)
196 #define	HOST_2_MPT32(ptr, tag)	ptr->tag = htole32(ptr->tag)
197 #define	HOST_2_MPT16(ptr, tag)	ptr->tag = htole16(ptr->tag)
198 
199 #if	_BYTE_ORDER == _BIG_ENDIAN
200 void mpt2host_sge_simple_union(SGE_SIMPLE_UNION *);
201 void mpt2host_iocfacts_reply(MSG_IOC_FACTS_REPLY *);
202 void mpt2host_portfacts_reply(MSG_PORT_FACTS_REPLY *);
203 void mpt2host_config_page_scsi_port_0(fCONFIG_PAGE_SCSI_PORT_0 *);
204 void mpt2host_config_page_scsi_port_1(fCONFIG_PAGE_SCSI_PORT_1 *);
205 void host2mpt_config_page_scsi_port_1(fCONFIG_PAGE_SCSI_PORT_1 *);
206 void mpt2host_config_page_scsi_port_2(fCONFIG_PAGE_SCSI_PORT_2 *);
207 void mpt2host_config_page_scsi_device_0(fCONFIG_PAGE_SCSI_DEVICE_0 *);
208 void host2mpt_config_page_scsi_device_0(fCONFIG_PAGE_SCSI_DEVICE_0 *);
209 void mpt2host_config_page_scsi_device_1(fCONFIG_PAGE_SCSI_DEVICE_1 *);
210 void host2mpt_config_page_scsi_device_1(fCONFIG_PAGE_SCSI_DEVICE_1 *);
211 void mpt2host_config_page_fc_port_0(fCONFIG_PAGE_FC_PORT_0 *);
212 void mpt2host_config_page_fc_port_1(fCONFIG_PAGE_FC_PORT_1 *);
213 void host2mpt_config_page_fc_port_1(fCONFIG_PAGE_FC_PORT_1 *);
214 void mpt2host_config_page_raid_vol_0(fCONFIG_PAGE_RAID_VOL_0 *);
215 void mpt2host_config_page_raid_phys_disk_0(fCONFIG_PAGE_RAID_PHYS_DISK_0 *);
216 void mpt2host_config_page_raid_phys_disk_0(fCONFIG_PAGE_RAID_PHYS_DISK_0 *);
217 void mpt2host_config_page_ioc_2(fCONFIG_PAGE_IOC_2 *);
218 #else
219 #define	mpt2host_sge_simple_union(x)		do { ; } while (0)
220 #define	mpt2host_iocfacts_reply(x)		do { ; } while (0)
221 #define	mpt2host_portfacts_reply(x)		do { ; } while (0)
222 #define	mpt2host_config_page_scsi_port_0(x)	do { ; } while (0)
223 #define	host2mpt_config_page_scsi_device_0(x)	do { ; } while (0)
224 #define	mpt2host_config_page_scsi_port_1(x)	do { ; } while (0)
225 #define	host2mpt_config_page_scsi_port_1(x)	do { ; } while (0)
226 #define	mpt2host_config_page_scsi_port_2(x)	do { ; } while (0)
227 #define	mpt2host_config_page_scsi_device_0(x)	do { ; } while (0)
228 #define	mpt2host_config_page_scsi_device_1(x)	do { ; } while (0)
229 #define	host2mpt_config_page_scsi_device_1(x)	do { ; } while (0)
230 #define	mpt2host_config_page_fc_port_0(x)	do { ; } while (0)
231 #define	mpt2host_config_page_fc_port_1(x)	do { ; } while (0)
232 #define	host2mpt_config_page_fc_port_1(x)	do { ; } while (0)
233 #define	mpt2host_config_page_raid_vol_0(x)	do { ; } while (0)
234 #define	mpt2host_config_page_raid_phys_disk_0(x)			\
235 	do { ; } while (0)
236 #define mpt2host_config_page_ioc_2(x)		do { ; } while (0)
237 #endif
238 
239 #endif /* _KERNEL */
240 
241 #endif /* _DEV_IC_MPT_H_ */
242