Sync usage with man page.
[netbsd-mini2440.git] / sys / dev / ic / mpt.h
blob3710062aa107304d60e8b3cbcc21d66b965784c2
1 /* $NetBSD: mpt.h,v 1.5 2005/12/11 12:21:27 christos Exp $ */
3 /*
4 * Copyright (c) 2000, 2001 by Greg Ansley
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.
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.
28 * Additional Copyright (c) 2002 by Matthew Jacob under same license.
32 * mpt.h:
34 * Generic definitions for LSI Fusion adapters.
36 * Adapted from the FreeBSD "mpt" driver by Jason R. Thorpe for
37 * Wasabi Systems, Inc.
40 #ifndef _DEV_IC_MPT_H_
41 #define _DEV_IC_MPT_H_
43 #include <dev/ic/mpt_netbsd.h>
45 #define MPT_OK (0)
46 #define MPT_FAIL (0x10000)
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
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
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
75 #define MPT_STATE(v) ((enum DB_STATE_BITS)((v) & MPT_DB_STATE_MASK))
77 #define MPT_DB_LENGTH_SHIFT (16)
78 #define MPT_DB_DATA_MASK (0xffff)
80 #define MPT_DB_DB_USED 0x08000000
81 #define MPT_DB_IS_IN_USE(v) (((v) & MPT_DB_DB_USED) != 0)
84 * "Whom" initializor values
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
93 #define MPT_WHO(v) \
94 ((v & MPI_DOORBELL_WHO_INIT_MASK) >> MPI_DOORBELL_WHO_INIT_SHIFT)
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
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
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)
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
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
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)
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)
153 #define MPT_REPLY_EMPTY (0xffffffff) /* Reply Queue Empty Symbol */
154 #define MPT_CONTEXT_REPLY (0x80000000)
155 #define MPT_CONTEXT_MASK (~0xE0000000)
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 *);
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 *);
176 int mpt_read_cfg_page(mpt_softc_t *, int, fCONFIG_PAGE_HEADER *);
177 int mpt_write_cfg_page(mpt_softc_t *, int, fCONFIG_PAGE_HEADER *);
179 /* mpt_debug.c functions */
180 void mpt_print_reply(void *);
181 void mpt_print_db(u_int32_t);
182 void mpt_print_config_reply(void *);
183 char *mpt_ioc_diag(u_int32_t);
184 const char *mpt_req_state(enum mpt_req_state);
185 void mpt_print_scsi_io_request(MSG_SCSI_IO_REQUEST *);
186 void mpt_print_config_request(void *);
187 void mpt_print_request(void *);
188 #endif /* _KERNEL */
190 #endif /* _DEV_IC_MPT_H_ */