xref: /OK3568_Linux_fs/kernel/drivers/scsi/mpt3sas/mpt3sas_debug.h (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun /*
2*4882a593Smuzhiyun  * Logging Support for MPT (Message Passing Technology) based controllers
3*4882a593Smuzhiyun  *
4*4882a593Smuzhiyun  * This code is based on drivers/scsi/mpt3sas/mpt3sas_debug.c
5*4882a593Smuzhiyun  * Copyright (C) 2012-2014  LSI Corporation
6*4882a593Smuzhiyun  * Copyright (C) 2013-2014 Avago Technologies
7*4882a593Smuzhiyun  *  (mailto: MPT-FusionLinux.pdl@avagotech.com)
8*4882a593Smuzhiyun  *
9*4882a593Smuzhiyun  * This program is free software; you can redistribute it and/or
10*4882a593Smuzhiyun  * modify it under the terms of the GNU General Public License
11*4882a593Smuzhiyun  * as published by the Free Software Foundation; either version 2
12*4882a593Smuzhiyun  * of the License, or (at your option) any later version.
13*4882a593Smuzhiyun  *
14*4882a593Smuzhiyun  * This program is distributed in the hope that it will be useful,
15*4882a593Smuzhiyun  * but WITHOUT ANY WARRANTY; without even the implied warranty of
16*4882a593Smuzhiyun  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17*4882a593Smuzhiyun  * GNU General Public License for more details.
18*4882a593Smuzhiyun  *
19*4882a593Smuzhiyun  * NO WARRANTY
20*4882a593Smuzhiyun  * THE PROGRAM IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR
21*4882a593Smuzhiyun  * CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT
22*4882a593Smuzhiyun  * LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT,
23*4882a593Smuzhiyun  * MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is
24*4882a593Smuzhiyun  * solely responsible for determining the appropriateness of using and
25*4882a593Smuzhiyun  * distributing the Program and assumes all risks associated with its
26*4882a593Smuzhiyun  * exercise of rights under this Agreement, including but not limited to
27*4882a593Smuzhiyun  * the risks and costs of program errors, damage to or loss of data,
28*4882a593Smuzhiyun  * programs or equipment, and unavailability or interruption of operations.
29*4882a593Smuzhiyun 
30*4882a593Smuzhiyun  * DISCLAIMER OF LIABILITY
31*4882a593Smuzhiyun  * NEITHER RECIPIENT NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY
32*4882a593Smuzhiyun  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
33*4882a593Smuzhiyun  * DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND
34*4882a593Smuzhiyun  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
35*4882a593Smuzhiyun  * TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
36*4882a593Smuzhiyun  * USE OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED
37*4882a593Smuzhiyun  * HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES
38*4882a593Smuzhiyun 
39*4882a593Smuzhiyun  * You should have received a copy of the GNU General Public License
40*4882a593Smuzhiyun  * along with this program; if not, write to the Free Software
41*4882a593Smuzhiyun  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301,
42*4882a593Smuzhiyun  * USA.
43*4882a593Smuzhiyun  */
44*4882a593Smuzhiyun 
45*4882a593Smuzhiyun #ifndef MPT3SAS_DEBUG_H_INCLUDED
46*4882a593Smuzhiyun #define MPT3SAS_DEBUG_H_INCLUDED
47*4882a593Smuzhiyun 
48*4882a593Smuzhiyun #define MPT_DEBUG			0x00000001
49*4882a593Smuzhiyun #define MPT_DEBUG_MSG_FRAME		0x00000002
50*4882a593Smuzhiyun #define MPT_DEBUG_SG			0x00000004
51*4882a593Smuzhiyun #define MPT_DEBUG_EVENTS		0x00000008
52*4882a593Smuzhiyun #define MPT_DEBUG_EVENT_WORK_TASK	0x00000010
53*4882a593Smuzhiyun #define MPT_DEBUG_INIT			0x00000020
54*4882a593Smuzhiyun #define MPT_DEBUG_EXIT			0x00000040
55*4882a593Smuzhiyun #define MPT_DEBUG_FAIL			0x00000080
56*4882a593Smuzhiyun #define MPT_DEBUG_TM			0x00000100
57*4882a593Smuzhiyun #define MPT_DEBUG_REPLY		0x00000200
58*4882a593Smuzhiyun #define MPT_DEBUG_HANDSHAKE		0x00000400
59*4882a593Smuzhiyun #define MPT_DEBUG_CONFIG		0x00000800
60*4882a593Smuzhiyun #define MPT_DEBUG_DL			0x00001000
61*4882a593Smuzhiyun #define MPT_DEBUG_RESET		0x00002000
62*4882a593Smuzhiyun #define MPT_DEBUG_SCSI			0x00004000
63*4882a593Smuzhiyun #define MPT_DEBUG_IOCTL		0x00008000
64*4882a593Smuzhiyun #define MPT_DEBUG_SAS			0x00020000
65*4882a593Smuzhiyun #define MPT_DEBUG_TRANSPORT		0x00040000
66*4882a593Smuzhiyun #define MPT_DEBUG_TASK_SET_FULL	0x00080000
67*4882a593Smuzhiyun 
68*4882a593Smuzhiyun #define MPT_DEBUG_TRIGGER_DIAG		0x00200000
69*4882a593Smuzhiyun 
70*4882a593Smuzhiyun 
71*4882a593Smuzhiyun #define MPT_CHECK_LOGGING(IOC, CMD, BITS)			\
72*4882a593Smuzhiyun {								\
73*4882a593Smuzhiyun 	if (IOC->logging_level & BITS)				\
74*4882a593Smuzhiyun 		CMD;						\
75*4882a593Smuzhiyun }
76*4882a593Smuzhiyun 
77*4882a593Smuzhiyun /*
78*4882a593Smuzhiyun  * debug macros
79*4882a593Smuzhiyun  */
80*4882a593Smuzhiyun 
81*4882a593Smuzhiyun #define dprintk(IOC, CMD)			\
82*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG)
83*4882a593Smuzhiyun 
84*4882a593Smuzhiyun #define dsgprintk(IOC, CMD)			\
85*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_SG)
86*4882a593Smuzhiyun 
87*4882a593Smuzhiyun #define devtprintk(IOC, CMD)			\
88*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_EVENTS)
89*4882a593Smuzhiyun 
90*4882a593Smuzhiyun #define dewtprintk(IOC, CMD)		\
91*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_EVENT_WORK_TASK)
92*4882a593Smuzhiyun 
93*4882a593Smuzhiyun #define dinitprintk(IOC, CMD)			\
94*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_INIT)
95*4882a593Smuzhiyun 
96*4882a593Smuzhiyun #define dexitprintk(IOC, CMD)			\
97*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_EXIT)
98*4882a593Smuzhiyun 
99*4882a593Smuzhiyun #define dfailprintk(IOC, CMD)			\
100*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_FAIL)
101*4882a593Smuzhiyun 
102*4882a593Smuzhiyun #define dtmprintk(IOC, CMD)			\
103*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_TM)
104*4882a593Smuzhiyun 
105*4882a593Smuzhiyun #define dreplyprintk(IOC, CMD)			\
106*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_REPLY)
107*4882a593Smuzhiyun 
108*4882a593Smuzhiyun #define dhsprintk(IOC, CMD)			\
109*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_HANDSHAKE)
110*4882a593Smuzhiyun 
111*4882a593Smuzhiyun #define dcprintk(IOC, CMD)			\
112*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_CONFIG)
113*4882a593Smuzhiyun 
114*4882a593Smuzhiyun #define ddlprintk(IOC, CMD)			\
115*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_DL)
116*4882a593Smuzhiyun 
117*4882a593Smuzhiyun #define drsprintk(IOC, CMD)			\
118*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_RESET)
119*4882a593Smuzhiyun 
120*4882a593Smuzhiyun #define dsprintk(IOC, CMD)			\
121*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_SCSI)
122*4882a593Smuzhiyun 
123*4882a593Smuzhiyun #define dctlprintk(IOC, CMD)			\
124*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_IOCTL)
125*4882a593Smuzhiyun 
126*4882a593Smuzhiyun #define dsasprintk(IOC, CMD)			\
127*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_SAS)
128*4882a593Smuzhiyun 
129*4882a593Smuzhiyun #define dsastransport(IOC, CMD)		\
130*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_SAS_WIDE)
131*4882a593Smuzhiyun 
132*4882a593Smuzhiyun #define dmfprintk(IOC, CMD)			\
133*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_MSG_FRAME)
134*4882a593Smuzhiyun 
135*4882a593Smuzhiyun #define dtsfprintk(IOC, CMD)			\
136*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_TASK_SET_FULL)
137*4882a593Smuzhiyun 
138*4882a593Smuzhiyun #define dtransportprintk(IOC, CMD)			\
139*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_TRANSPORT)
140*4882a593Smuzhiyun 
141*4882a593Smuzhiyun #define dTriggerDiagPrintk(IOC, CMD)			\
142*4882a593Smuzhiyun 	MPT_CHECK_LOGGING(IOC, CMD, MPT_DEBUG_TRIGGER_DIAG)
143*4882a593Smuzhiyun 
144*4882a593Smuzhiyun 
145*4882a593Smuzhiyun 
146*4882a593Smuzhiyun /* inline functions for dumping debug data*/
147*4882a593Smuzhiyun 
148*4882a593Smuzhiyun /**
149*4882a593Smuzhiyun  * _debug_dump_mf - print message frame contents
150*4882a593Smuzhiyun  * @mpi_request: pointer to message frame
151*4882a593Smuzhiyun  * @sz: number of dwords
152*4882a593Smuzhiyun  */
153*4882a593Smuzhiyun static inline void
_debug_dump_mf(void * mpi_request,int sz)154*4882a593Smuzhiyun _debug_dump_mf(void *mpi_request, int sz)
155*4882a593Smuzhiyun {
156*4882a593Smuzhiyun 	int i;
157*4882a593Smuzhiyun 	__le32 *mfp = (__le32 *)mpi_request;
158*4882a593Smuzhiyun 
159*4882a593Smuzhiyun 	pr_info("mf:\n\t");
160*4882a593Smuzhiyun 	for (i = 0; i < sz; i++) {
161*4882a593Smuzhiyun 		if (i && ((i % 8) == 0))
162*4882a593Smuzhiyun 			pr_info("\n\t");
163*4882a593Smuzhiyun 		pr_info("%08x ", le32_to_cpu(mfp[i]));
164*4882a593Smuzhiyun 	}
165*4882a593Smuzhiyun 	pr_info("\n");
166*4882a593Smuzhiyun }
167*4882a593Smuzhiyun /**
168*4882a593Smuzhiyun  * _debug_dump_reply - print message frame contents
169*4882a593Smuzhiyun  * @mpi_request: pointer to message frame
170*4882a593Smuzhiyun  * @sz: number of dwords
171*4882a593Smuzhiyun  */
172*4882a593Smuzhiyun static inline void
_debug_dump_reply(void * mpi_request,int sz)173*4882a593Smuzhiyun _debug_dump_reply(void *mpi_request, int sz)
174*4882a593Smuzhiyun {
175*4882a593Smuzhiyun 	int i;
176*4882a593Smuzhiyun 	__le32 *mfp = (__le32 *)mpi_request;
177*4882a593Smuzhiyun 
178*4882a593Smuzhiyun 	pr_info("reply:\n\t");
179*4882a593Smuzhiyun 	for (i = 0; i < sz; i++) {
180*4882a593Smuzhiyun 		if (i && ((i % 8) == 0))
181*4882a593Smuzhiyun 			pr_info("\n\t");
182*4882a593Smuzhiyun 		pr_info("%08x ", le32_to_cpu(mfp[i]));
183*4882a593Smuzhiyun 	}
184*4882a593Smuzhiyun 	pr_info("\n");
185*4882a593Smuzhiyun }
186*4882a593Smuzhiyun /**
187*4882a593Smuzhiyun  * _debug_dump_config - print config page contents
188*4882a593Smuzhiyun  * @mpi_request: pointer to message frame
189*4882a593Smuzhiyun  * @sz: number of dwords
190*4882a593Smuzhiyun  */
191*4882a593Smuzhiyun static inline void
_debug_dump_config(void * mpi_request,int sz)192*4882a593Smuzhiyun _debug_dump_config(void *mpi_request, int sz)
193*4882a593Smuzhiyun {
194*4882a593Smuzhiyun 	int i;
195*4882a593Smuzhiyun 	__le32 *mfp = (__le32 *)mpi_request;
196*4882a593Smuzhiyun 
197*4882a593Smuzhiyun 	pr_info("config:\n\t");
198*4882a593Smuzhiyun 	for (i = 0; i < sz; i++) {
199*4882a593Smuzhiyun 		if (i && ((i % 8) == 0))
200*4882a593Smuzhiyun 			pr_info("\n\t");
201*4882a593Smuzhiyun 		pr_info("%08x ", le32_to_cpu(mfp[i]));
202*4882a593Smuzhiyun 	}
203*4882a593Smuzhiyun 	pr_info("\n");
204*4882a593Smuzhiyun }
205*4882a593Smuzhiyun 
206*4882a593Smuzhiyun #endif /* MPT3SAS_DEBUG_H_INCLUDED */
207