1/*
2 * This file is part of the Chelsio FCoE driver for Linux.
3 *
4 * Copyright (c) 2008-2012 Chelsio Communications, Inc. All rights reserved.
5 *
6 * This software is available to you under a choice of one of two
7 * licenses. You may choose to be licensed under the terms of the GNU
8 * General Public License (GPL) Version 2, available from the file
9 * COPYING in the main directory of this source tree, or the
10 * OpenIB.org BSD license below:
11 *
12 * Redistribution and use in source and binary forms, with or
13 * without modification, are permitted provided that the following
14 * conditions are met:
15 *
16 * - Redistributions of source code must retain the above
17 * copyright notice, this list of conditions and the following
18 * disclaimer.
19 *
20 * - Redistributions in binary form must reproduce the above
21 * copyright notice, this list of conditions and the following
22 * disclaimer in the documentation and/or other materials
23 * provided with the distribution.
24 *
25 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
26 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
27 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
28 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
29 * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
30 * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
31 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
32 * SOFTWARE.
33 */
34
35#ifndef __CSIO_MB_H__
36#define __CSIO_MB_H__
37
38#include <linux/timer.h>
39#include <linux/completion.h>
40
41#include "t4fw_api.h"
42#include "t4fw_api_stor.h"
43#include "csio_defs.h"
44
45#define CSIO_STATS_OFFSET (2)
46#define CSIO_NUM_STATS_PER_MB (6)
47
48struct fw_fcoe_port_cmd_params {
49 uint8_t portid;
50 uint8_t idx;
51 uint8_t nstats;
52};
53
54#define CSIO_DUMP_MB(__hw, __num, __mb) \
55 csio_dbg(__hw, "\t%llx %llx %llx %llx %llx %llx %llx %llx\n", \
56 (unsigned long long)csio_rd_reg64(__hw, __mb), \
57 (unsigned long long)csio_rd_reg64(__hw, __mb + 8), \
58 (unsigned long long)csio_rd_reg64(__hw, __mb + 16), \
59 (unsigned long long)csio_rd_reg64(__hw, __mb + 24), \
60 (unsigned long long)csio_rd_reg64(__hw, __mb + 32), \
61 (unsigned long long)csio_rd_reg64(__hw, __mb + 40), \
62 (unsigned long long)csio_rd_reg64(__hw, __mb + 48), \
63 (unsigned long long)csio_rd_reg64(__hw, __mb + 56))
64
65#define CSIO_MB_MAX_REGS 8
66#define CSIO_MAX_MB_SIZE 64
67#define CSIO_MB_POLL_FREQ 5 /* 5 ms */
68#define CSIO_MB_DEFAULT_TMO FW_CMD_MAX_TIMEOUT
69
70/* Device master in HELLO command */
71enum csio_dev_master { CSIO_MASTER_CANT, CSIO_MASTER_MAY, CSIO_MASTER_MUST };
72
73enum csio_mb_owner { CSIO_MBOWNER_NONE, CSIO_MBOWNER_FW, CSIO_MBOWNER_PL };
74
75enum csio_dev_state {
76 CSIO_DEV_STATE_UNINIT,
77 CSIO_DEV_STATE_INIT,
78 CSIO_DEV_STATE_ERR
79};
80
81#define FW_PARAM_DEV(param) \
82 (FW_PARAMS_MNEM_V(FW_PARAMS_MNEM_DEV) | \
83 FW_PARAMS_PARAM_X_V(FW_PARAMS_PARAM_DEV_##param))
84
85#define FW_PARAM_PFVF(param) \
86 (FW_PARAMS_MNEM_V(FW_PARAMS_MNEM_PFVF) | \
87 FW_PARAMS_PARAM_X_V(FW_PARAMS_PARAM_PFVF_##param)| \
88 FW_PARAMS_PARAM_Y_V(0) | \
89 FW_PARAMS_PARAM_Z_V(0))
90
91#define CSIO_INIT_MBP(__mbp, __cp, __tmo, __priv, __fn, __clear) \
92do { \
93 if (__clear) \
94 memset((__cp), 0, \
95 CSIO_MB_MAX_REGS * sizeof(__be64)); \
96 INIT_LIST_HEAD(&(__mbp)->list); \
97 (__mbp)->tmo = (__tmo); \
98 (__mbp)->priv = (void *)(__priv); \
99 (__mbp)->mb_cbfn = (__fn); \
100 (__mbp)->mb_size = sizeof(*(__cp)); \
101} while (0)
102
103struct csio_mbm_stats {
104 uint32_t n_req; /* number of mbox req */
105 uint32_t n_rsp; /* number of mbox rsp */
106 uint32_t n_activeq; /* number of mbox req active Q */
107 uint32_t n_cbfnq; /* number of mbox req cbfn Q */
108 uint32_t n_tmo; /* number of mbox timeout */
109 uint32_t n_cancel; /* number of mbox cancel */
110 uint32_t n_err; /* number of mbox error */
111};
112
113/* Driver version of Mailbox */
114struct csio_mb {
115 struct list_head list; /* for req/resp */
116 /* queue in driver */
117 __be64 mb[CSIO_MB_MAX_REGS]; /* MB in HW format */
118 int mb_size; /* Size of this
119 * mailbox.
120 */
121 uint32_t tmo; /* Timeout */
122 struct completion cmplobj; /* MB Completion
123 * object
124 */
125 void (*mb_cbfn) (struct csio_hw *, struct csio_mb *);
126 /* Callback fn */
127 void *priv; /* Owner private ptr */
128};
129
130struct csio_mbm {
131 uint32_t a_mbox; /* Async mbox num */
132 uint32_t intr_idx; /* Interrupt index */
133 struct timer_list timer; /* Mbox timer */
134 struct csio_hw *hw; /* Hardware pointer */
135 struct list_head req_q; /* Mbox request queue */
136 struct list_head cbfn_q; /* Mbox completion q */
137 struct csio_mb *mcurrent; /* Current mailbox */
138 uint32_t req_q_cnt; /* Outstanding mbox
139 * cmds
140 */
141 struct csio_mbm_stats stats; /* Statistics */
142};
143
144#define csio_set_mb_intr_idx(_m, _i) ((_m)->intr_idx = (_i))
145#define csio_get_mb_intr_idx(_m) ((_m)->intr_idx)
146
147struct csio_iq_params;
148struct csio_eq_params;
149
150enum fw_retval csio_mb_fw_retval(struct csio_mb *);
151
152/* MB helpers */
153void csio_mb_hello(struct csio_hw *, struct csio_mb *, uint32_t,
154 uint32_t, uint32_t, enum csio_dev_master,
155 void (*)(struct csio_hw *, struct csio_mb *));
156
157void csio_mb_process_hello_rsp(struct csio_hw *, struct csio_mb *,
158 enum fw_retval *, enum csio_dev_state *,
159 uint8_t *);
160
161void csio_mb_bye(struct csio_hw *, struct csio_mb *, uint32_t,
162 void (*)(struct csio_hw *, struct csio_mb *));
163
164void csio_mb_reset(struct csio_hw *, struct csio_mb *, uint32_t, int, int,
165 void (*)(struct csio_hw *, struct csio_mb *));
166
167void csio_mb_params(struct csio_hw *, struct csio_mb *, uint32_t, unsigned int,
168 unsigned int, unsigned int, const u32 *, u32 *, bool,
169 void (*)(struct csio_hw *, struct csio_mb *));
170
171void csio_mb_process_read_params_rsp(struct csio_hw *, struct csio_mb *,
172 enum fw_retval *, unsigned int , u32 *);
173
174void csio_mb_ldst(struct csio_hw *hw, struct csio_mb *mbp, uint32_t tmo,
175 int reg);
176
177void csio_mb_caps_config(struct csio_hw *, struct csio_mb *, uint32_t,
178 bool, bool, bool, bool,
179 void (*)(struct csio_hw *, struct csio_mb *));
180
181void csio_mb_port(struct csio_hw *, struct csio_mb *, uint32_t,
182 uint8_t, bool, uint32_t, uint16_t,
183 void (*) (struct csio_hw *, struct csio_mb *));
184
185void csio_mb_process_read_port_rsp(struct csio_hw *, struct csio_mb *,
186 enum fw_retval *, uint16_t,
187 uint32_t *, uint32_t *);
188
189void csio_mb_initialize(struct csio_hw *, struct csio_mb *, uint32_t,
190 void (*)(struct csio_hw *, struct csio_mb *));
191
192void csio_mb_iq_alloc_write(struct csio_hw *, struct csio_mb *, void *,
193 uint32_t, struct csio_iq_params *,
194 void (*) (struct csio_hw *, struct csio_mb *));
195
196void csio_mb_iq_alloc_write_rsp(struct csio_hw *, struct csio_mb *,
197 enum fw_retval *, struct csio_iq_params *);
198
199void csio_mb_iq_free(struct csio_hw *, struct csio_mb *, void *,
200 uint32_t, struct csio_iq_params *,
201 void (*) (struct csio_hw *, struct csio_mb *));
202
203void csio_mb_eq_ofld_alloc_write(struct csio_hw *, struct csio_mb *, void *,
204 uint32_t, struct csio_eq_params *,
205 void (*) (struct csio_hw *, struct csio_mb *));
206
207void csio_mb_eq_ofld_alloc_write_rsp(struct csio_hw *, struct csio_mb *,
208 enum fw_retval *, struct csio_eq_params *);
209
210void csio_mb_eq_ofld_free(struct csio_hw *, struct csio_mb *, void *,
211 uint32_t , struct csio_eq_params *,
212 void (*) (struct csio_hw *, struct csio_mb *));
213
214void csio_fcoe_read_res_info_init_mb(struct csio_hw *, struct csio_mb *,
215 uint32_t,
216 void (*) (struct csio_hw *, struct csio_mb *));
217
218void csio_write_fcoe_link_cond_init_mb(struct csio_lnode *, struct csio_mb *,
219 uint32_t, uint8_t, uint32_t, uint8_t, bool, uint32_t,
220 void (*) (struct csio_hw *, struct csio_mb *));
221
222void csio_fcoe_vnp_alloc_init_mb(struct csio_lnode *, struct csio_mb *,
223 uint32_t, uint32_t , uint32_t , uint16_t,
224 uint8_t [8], uint8_t [8],
225 void (*) (struct csio_hw *, struct csio_mb *));
226
227void csio_fcoe_vnp_read_init_mb(struct csio_lnode *, struct csio_mb *,
228 uint32_t, uint32_t , uint32_t ,
229 void (*) (struct csio_hw *, struct csio_mb *));
230
231void csio_fcoe_vnp_free_init_mb(struct csio_lnode *, struct csio_mb *,
232 uint32_t , uint32_t, uint32_t ,
233 void (*) (struct csio_hw *, struct csio_mb *));
234
235void csio_fcoe_read_fcf_init_mb(struct csio_lnode *, struct csio_mb *,
236 uint32_t, uint32_t, uint32_t,
237 void (*cbfn) (struct csio_hw *, struct csio_mb *));
238
239void csio_fcoe_read_portparams_init_mb(struct csio_hw *hw,
240 struct csio_mb *mbp, uint32_t mb_tmo,
241 struct fw_fcoe_port_cmd_params *portparams,
242 void (*cbfn)(struct csio_hw *, struct csio_mb *));
243
244void csio_mb_process_portparams_rsp(struct csio_hw *hw, struct csio_mb *mbp,
245 enum fw_retval *retval,
246 struct fw_fcoe_port_cmd_params *portparams,
247 struct fw_fcoe_port_stats *portstats);
248
249/* MB module functions */
250int csio_mbm_init(struct csio_mbm *, struct csio_hw *,
251 void (*)(struct timer_list *));
252void csio_mbm_exit(struct csio_mbm *);
253void csio_mb_intr_enable(struct csio_hw *);
254void csio_mb_intr_disable(struct csio_hw *);
255
256int csio_mb_issue(struct csio_hw *, struct csio_mb *);
257void csio_mb_completions(struct csio_hw *, struct list_head *);
258int csio_mb_fwevt_handler(struct csio_hw *, __be64 *);
259int csio_mb_isr_handler(struct csio_hw *);
260struct csio_mb *csio_mb_tmo_handler(struct csio_hw *);
261void csio_mb_cancel_all(struct csio_hw *, struct list_head *);
262
263#endif /* ifndef __CSIO_MB_H__ */
264

source code of linux/drivers/scsi/csiostor/csio_mb.h