1 /*
2  * Linux network driver for Brocade Converged Network Adapter.
3  *
4  * This program is free software; you can redistribute it and/or modify it
5  * under the terms of the GNU General Public License (GPL) Version 2 as
6  * published by the Free Software Foundation
7  *
8  * This program is distributed in the hope that it will be useful, but
9  * WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
11  * General Public License for more details.
12  */
13 /*
14  * Copyright (c) 2005-2010 Brocade Communications Systems, Inc.
15  * All rights reserved
16  * www.brocade.com
17  */
18 
19 #ifndef __BFA_IOC_H__
20 #define __BFA_IOC_H__
21 
22 #include "bfa_cs.h"
23 #include "bfi.h"
24 #include "cna.h"
25 
26 #define BFA_IOC_TOV		3000	/* msecs */
27 #define BFA_IOC_HWSEM_TOV	500	/* msecs */
28 #define BFA_IOC_HB_TOV		500	/* msecs */
29 #define BFA_IOC_POLL_TOV	200	/* msecs */
30 #define BNA_DBG_FWTRC_LEN      (BFI_IOC_TRC_ENTS * BFI_IOC_TRC_ENT_SZ + \
31 				BFI_IOC_TRC_HDR_SZ)
32 
33 /* PCI device information required by IOC */
34 struct bfa_pcidev {
35 	int	pci_slot;
36 	u8	pci_func;
37 	u16	device_id;
38 	u16	ssid;
39 	void	__iomem *pci_bar_kva;
40 };
41 
42 /* Structure used to remember the DMA-able memory block's KVA and Physical
43  * Address
44  */
45 struct bfa_dma {
46 	void	*kva;	/* ! Kernel virtual address	*/
47 	u64	pa;	/* ! Physical address		*/
48 };
49 
50 #define BFA_DMA_ALIGN_SZ	256
51 
52 /* smem size for Crossbow and Catapult */
53 #define BFI_SMEM_CB_SIZE	0x200000U	/* ! 2MB for crossbow	*/
54 #define BFI_SMEM_CT_SIZE	0x280000U	/* ! 2.5MB for catapult	*/
55 
56 /* BFA dma address assignment macro. (big endian format) */
57 #define bfa_dma_be_addr_set(dma_addr, pa)	\
58 		__bfa_dma_be_addr_set(&dma_addr, (u64)pa)
59 static inline void
60 __bfa_dma_be_addr_set(union bfi_addr_u *dma_addr, u64 pa)
61 {
62 	dma_addr->a32.addr_lo = (u32) htonl(pa);
63 	dma_addr->a32.addr_hi = (u32) htonl(upper_32_bits(pa));
64 }
65 
66 #define bfa_alen_set(__alen, __len, __pa)	\
67 	__bfa_alen_set(__alen, __len, (u64)__pa)
68 
69 static inline void
70 __bfa_alen_set(struct bfi_alen *alen, u32 len, u64 pa)
71 {
72 	alen->al_len = cpu_to_be32(len);
73 	bfa_dma_be_addr_set(alen->al_addr, pa);
74 }
75 
76 struct bfa_ioc_regs {
77 	void __iomem *hfn_mbox_cmd;
78 	void __iomem *hfn_mbox;
79 	void __iomem *lpu_mbox_cmd;
80 	void __iomem *lpu_mbox;
81 	void __iomem *lpu_read_stat;
82 	void __iomem *pss_ctl_reg;
83 	void __iomem *pss_err_status_reg;
84 	void __iomem *app_pll_fast_ctl_reg;
85 	void __iomem *app_pll_slow_ctl_reg;
86 	void __iomem *ioc_sem_reg;
87 	void __iomem *ioc_usage_sem_reg;
88 	void __iomem *ioc_init_sem_reg;
89 	void __iomem *ioc_usage_reg;
90 	void __iomem *host_page_num_fn;
91 	void __iomem *heartbeat;
92 	void __iomem *ioc_fwstate;
93 	void __iomem *alt_ioc_fwstate;
94 	void __iomem *ll_halt;
95 	void __iomem *alt_ll_halt;
96 	void __iomem *err_set;
97 	void __iomem *ioc_fail_sync;
98 	void __iomem *shirq_isr_next;
99 	void __iomem *shirq_msk_next;
100 	void __iomem *smem_page_start;
101 	u32	smem_pg0;
102 };
103 
104 /* IOC Mailbox structures */
105 typedef void (*bfa_mbox_cmd_cbfn_t)(void *cbarg);
106 struct bfa_mbox_cmd {
107 	struct list_head	qe;
108 	bfa_mbox_cmd_cbfn_t     cbfn;
109 	void		    *cbarg;
110 	u32     msg[BFI_IOC_MSGSZ];
111 };
112 
113 /* IOC mailbox module */
114 typedef void (*bfa_ioc_mbox_mcfunc_t)(void *cbarg, struct bfi_mbmsg *m);
115 struct bfa_ioc_mbox_mod {
116 	struct list_head	cmd_q;		/*!< pending mbox queue	*/
117 	int			nmclass;	/*!< number of handlers */
118 	struct {
119 		bfa_ioc_mbox_mcfunc_t	cbfn;	/*!< message handlers	*/
120 		void			*cbarg;
121 	} mbhdlr[BFI_MC_MAX];
122 };
123 
124 /* IOC callback function interfaces */
125 typedef void (*bfa_ioc_enable_cbfn_t)(void *bfa, enum bfa_status status);
126 typedef void (*bfa_ioc_disable_cbfn_t)(void *bfa);
127 typedef void (*bfa_ioc_hbfail_cbfn_t)(void *bfa);
128 typedef void (*bfa_ioc_reset_cbfn_t)(void *bfa);
129 struct bfa_ioc_cbfn {
130 	bfa_ioc_enable_cbfn_t	enable_cbfn;
131 	bfa_ioc_disable_cbfn_t	disable_cbfn;
132 	bfa_ioc_hbfail_cbfn_t	hbfail_cbfn;
133 	bfa_ioc_reset_cbfn_t	reset_cbfn;
134 };
135 
136 /* IOC event notification mechanism. */
137 enum bfa_ioc_event {
138 	BFA_IOC_E_ENABLED	= 1,
139 	BFA_IOC_E_DISABLED	= 2,
140 	BFA_IOC_E_FAILED	= 3,
141 };
142 
143 typedef void (*bfa_ioc_notify_cbfn_t)(void *, enum bfa_ioc_event);
144 
145 struct bfa_ioc_notify {
146 	struct list_head	qe;
147 	bfa_ioc_notify_cbfn_t	cbfn;
148 	void			*cbarg;
149 };
150 
151 /* Initialize a IOC event notification structure */
152 #define bfa_ioc_notify_init(__notify, __cbfn, __cbarg) do {	\
153 	(__notify)->cbfn = (__cbfn);				\
154 	(__notify)->cbarg = (__cbarg);				\
155 } while (0)
156 
157 struct bfa_iocpf {
158 	bfa_fsm_t		fsm;
159 	struct bfa_ioc		*ioc;
160 	bool			fw_mismatch_notified;
161 	bool			auto_recover;
162 	u32			poll_time;
163 };
164 
165 struct bfa_ioc {
166 	bfa_fsm_t		fsm;
167 	struct bfa		*bfa;
168 	struct bfa_pcidev	pcidev;
169 	struct timer_list	ioc_timer;
170 	struct timer_list	iocpf_timer;
171 	struct timer_list	sem_timer;
172 	struct timer_list	hb_timer;
173 	u32			hb_count;
174 	struct list_head	notify_q;
175 	void			*dbg_fwsave;
176 	int			dbg_fwsave_len;
177 	bool			dbg_fwsave_once;
178 	enum bfi_pcifn_class	clscode;
179 	struct bfa_ioc_regs	ioc_regs;
180 	struct bfa_ioc_drv_stats stats;
181 	bool			fcmode;
182 	bool			pllinit;
183 	bool			stats_busy;	/*!< outstanding stats */
184 	u8			port_id;
185 
186 	struct bfa_dma		attr_dma;
187 	struct bfi_ioc_attr	*attr;
188 	struct bfa_ioc_cbfn	*cbfn;
189 	struct bfa_ioc_mbox_mod	mbox_mod;
190 	const struct bfa_ioc_hwif *ioc_hwif;
191 	struct bfa_iocpf	iocpf;
192 	enum bfi_asic_gen	asic_gen;
193 	enum bfi_asic_mode	asic_mode;
194 	enum bfi_port_mode	port0_mode;
195 	enum bfi_port_mode	port1_mode;
196 	enum bfa_mode		port_mode;
197 	u8			ad_cap_bm;	/*!< adapter cap bit mask */
198 	u8			port_mode_cfg;	/*!< config port mode */
199 };
200 
201 struct bfa_ioc_hwif {
202 	enum bfa_status (*ioc_pll_init) (void __iomem *rb,
203 						enum bfi_asic_mode m);
204 	bool		(*ioc_firmware_lock)	(struct bfa_ioc *ioc);
205 	void		(*ioc_firmware_unlock)	(struct bfa_ioc *ioc);
206 	void		(*ioc_reg_init)	(struct bfa_ioc *ioc);
207 	void		(*ioc_map_port)	(struct bfa_ioc *ioc);
208 	void		(*ioc_isr_mode_set)	(struct bfa_ioc *ioc,
209 					bool msix);
210 	void		(*ioc_notify_fail)	(struct bfa_ioc *ioc);
211 	void		(*ioc_ownership_reset)	(struct bfa_ioc *ioc);
212 	bool		(*ioc_sync_start)       (struct bfa_ioc *ioc);
213 	void		(*ioc_sync_join)	(struct bfa_ioc *ioc);
214 	void		(*ioc_sync_leave)	(struct bfa_ioc *ioc);
215 	void		(*ioc_sync_ack)		(struct bfa_ioc *ioc);
216 	bool		(*ioc_sync_complete)	(struct bfa_ioc *ioc);
217 	bool		(*ioc_lpu_read_stat)	(struct bfa_ioc *ioc);
218 	void		(*ioc_set_fwstate)	(struct bfa_ioc *ioc,
219 					enum bfi_ioc_state fwstate);
220 	enum bfi_ioc_state (*ioc_get_fwstate) (struct bfa_ioc *ioc);
221 	void		(*ioc_set_alt_fwstate)	(struct bfa_ioc *ioc,
222 					enum bfi_ioc_state fwstate);
223 	enum bfi_ioc_state (*ioc_get_alt_fwstate) (struct bfa_ioc *ioc);
224 
225 };
226 
227 #define bfa_ioc_pcifn(__ioc)		((__ioc)->pcidev.pci_func)
228 #define bfa_ioc_devid(__ioc)		((__ioc)->pcidev.device_id)
229 #define bfa_ioc_bar0(__ioc)		((__ioc)->pcidev.pci_bar_kva)
230 #define bfa_ioc_portid(__ioc)		((__ioc)->port_id)
231 #define bfa_ioc_asic_gen(__ioc)		((__ioc)->asic_gen)
232 #define bfa_ioc_is_default(__ioc)	\
233 	(bfa_ioc_pcifn(__ioc) == bfa_ioc_portid(__ioc))
234 #define bfa_ioc_fetch_stats(__ioc, __stats) \
235 		(((__stats)->drv_stats) = (__ioc)->stats)
236 #define bfa_ioc_clr_stats(__ioc)	\
237 		memset(&(__ioc)->stats, 0, sizeof((__ioc)->stats))
238 #define bfa_ioc_maxfrsize(__ioc)	((__ioc)->attr->maxfrsize)
239 #define bfa_ioc_rx_bbcredit(__ioc)	((__ioc)->attr->rx_bbcredit)
240 #define bfa_ioc_speed_sup(__ioc)	\
241 	BFI_ADAPTER_GETP(SPEED, (__ioc)->attr->adapter_prop)
242 #define bfa_ioc_get_nports(__ioc)	\
243 	BFI_ADAPTER_GETP(NPORTS, (__ioc)->attr->adapter_prop)
244 
245 #define bfa_ioc_stats(_ioc, _stats)	((_ioc)->stats._stats++)
246 #define bfa_ioc_stats_hb_count(_ioc, _hb_count)	\
247 	((_ioc)->stats.hb_count = (_hb_count))
248 #define BFA_IOC_FWIMG_MINSZ	(16 * 1024)
249 #define BFA_IOC_FW_SMEM_SIZE(__ioc)					\
250 	((bfa_ioc_asic_gen(__ioc) == BFI_ASIC_GEN_CB)			\
251 	? BFI_SMEM_CB_SIZE : BFI_SMEM_CT_SIZE)
252 #define BFA_IOC_FLASH_CHUNK_NO(off)		(off / BFI_FLASH_CHUNK_SZ_WORDS)
253 #define BFA_IOC_FLASH_OFFSET_IN_CHUNK(off)	(off % BFI_FLASH_CHUNK_SZ_WORDS)
254 #define BFA_IOC_FLASH_CHUNK_ADDR(chunkno)  (chunkno * BFI_FLASH_CHUNK_SZ_WORDS)
255 
256 /* IOC mailbox interface */
257 bool bfa_nw_ioc_mbox_queue(struct bfa_ioc *ioc,
258 			struct bfa_mbox_cmd *cmd,
259 			bfa_mbox_cmd_cbfn_t cbfn, void *cbarg);
260 void bfa_nw_ioc_mbox_isr(struct bfa_ioc *ioc);
261 void bfa_nw_ioc_mbox_regisr(struct bfa_ioc *ioc, enum bfi_mclass mc,
262 		bfa_ioc_mbox_mcfunc_t cbfn, void *cbarg);
263 
264 /* IOC interfaces */
265 
266 #define bfa_ioc_pll_init_asic(__ioc) \
267 	((__ioc)->ioc_hwif->ioc_pll_init((__ioc)->pcidev.pci_bar_kva, \
268 			   (__ioc)->asic_mode))
269 
270 #define	bfa_ioc_isr_mode_set(__ioc, __msix) do {			\
271 	if ((__ioc)->ioc_hwif->ioc_isr_mode_set)			\
272 		((__ioc)->ioc_hwif->ioc_isr_mode_set(__ioc, __msix));	\
273 } while (0)
274 #define	bfa_ioc_ownership_reset(__ioc)				\
275 			((__ioc)->ioc_hwif->ioc_ownership_reset(__ioc))
276 
277 #define bfa_ioc_lpu_read_stat(__ioc) do {				\
278 		if ((__ioc)->ioc_hwif->ioc_lpu_read_stat)		\
279 			((__ioc)->ioc_hwif->ioc_lpu_read_stat(__ioc));	\
280 } while (0)
281 
282 void bfa_nw_ioc_set_ct_hwif(struct bfa_ioc *ioc);
283 void bfa_nw_ioc_set_ct2_hwif(struct bfa_ioc *ioc);
284 void bfa_nw_ioc_ct2_poweron(struct bfa_ioc *ioc);
285 
286 void bfa_nw_ioc_attach(struct bfa_ioc *ioc, void *bfa,
287 		struct bfa_ioc_cbfn *cbfn);
288 void bfa_nw_ioc_auto_recover(bool auto_recover);
289 void bfa_nw_ioc_detach(struct bfa_ioc *ioc);
290 void bfa_nw_ioc_pci_init(struct bfa_ioc *ioc, struct bfa_pcidev *pcidev,
291 		enum bfi_pcifn_class clscode);
292 u32 bfa_nw_ioc_meminfo(void);
293 void bfa_nw_ioc_mem_claim(struct bfa_ioc *ioc,  u8 *dm_kva, u64 dm_pa);
294 void bfa_nw_ioc_enable(struct bfa_ioc *ioc);
295 void bfa_nw_ioc_disable(struct bfa_ioc *ioc);
296 
297 void bfa_nw_ioc_error_isr(struct bfa_ioc *ioc);
298 bool bfa_nw_ioc_is_disabled(struct bfa_ioc *ioc);
299 bool bfa_nw_ioc_is_operational(struct bfa_ioc *ioc);
300 void bfa_nw_ioc_get_attr(struct bfa_ioc *ioc, struct bfa_ioc_attr *ioc_attr);
301 enum bfa_status bfa_nw_ioc_fwsig_invalidate(struct bfa_ioc *ioc);
302 void bfa_nw_ioc_notify_register(struct bfa_ioc *ioc,
303 	struct bfa_ioc_notify *notify);
304 bool bfa_nw_ioc_sem_get(void __iomem *sem_reg);
305 void bfa_nw_ioc_sem_release(void __iomem *sem_reg);
306 void bfa_nw_ioc_hw_sem_release(struct bfa_ioc *ioc);
307 void bfa_nw_ioc_fwver_get(struct bfa_ioc *ioc,
308 			struct bfi_ioc_image_hdr *fwhdr);
309 bool bfa_nw_ioc_fwver_cmp(struct bfa_ioc *ioc,
310 			struct bfi_ioc_image_hdr *fwhdr);
311 mac_t bfa_nw_ioc_get_mac(struct bfa_ioc *ioc);
312 void bfa_nw_ioc_debug_memclaim(struct bfa_ioc *ioc, void *dbg_fwsave);
313 int bfa_nw_ioc_debug_fwtrc(struct bfa_ioc *ioc, void *trcdata, int *trclen);
314 int bfa_nw_ioc_debug_fwsave(struct bfa_ioc *ioc, void *trcdata, int *trclen);
315 
316 /*
317  * Timeout APIs
318  */
319 void bfa_nw_ioc_timeout(void *ioc);
320 void bfa_nw_ioc_hb_check(void *ioc);
321 void bfa_nw_iocpf_timeout(void *ioc);
322 void bfa_nw_iocpf_sem_timeout(void *ioc);
323 
324 /*
325  * F/W Image Size & Chunk
326  */
327 u32 *bfa_cb_image_get_chunk(enum bfi_asic_gen asic_gen, u32 off);
328 u32 bfa_cb_image_get_size(enum bfi_asic_gen asic_gen);
329 
330 /*
331  *	Flash module specific
332  */
333 typedef void	(*bfa_cb_flash) (void *cbarg, enum bfa_status status);
334 
335 struct bfa_flash {
336 	struct bfa_ioc *ioc;		/* back pointer to ioc */
337 	u32		type;		/* partition type */
338 	u8		instance;	/* partition instance */
339 	u8		rsv[3];
340 	u32		op_busy;	/*  operation busy flag */
341 	u32		residue;	/*  residual length */
342 	u32		offset;		/*  offset */
343 	enum bfa_status	status;		/*  status */
344 	u8		*dbuf_kva;	/*  dma buf virtual address */
345 	u64		dbuf_pa;	/*  dma buf physical address */
346 	bfa_cb_flash	cbfn;		/*  user callback function */
347 	void		*cbarg;		/*  user callback arg */
348 	u8		*ubuf;		/*  user supplied buffer */
349 	u32		addr_off;	/*  partition address offset */
350 	struct bfa_mbox_cmd mb;		/*  mailbox */
351 	struct bfa_ioc_notify ioc_notify; /*  ioc event notify */
352 };
353 
354 enum bfa_status bfa_nw_flash_get_attr(struct bfa_flash *flash,
355 			struct bfa_flash_attr *attr,
356 			bfa_cb_flash cbfn, void *cbarg);
357 enum bfa_status bfa_nw_flash_update_part(struct bfa_flash *flash,
358 			u32 type, u8 instance, void *buf, u32 len, u32 offset,
359 			bfa_cb_flash cbfn, void *cbarg);
360 enum bfa_status bfa_nw_flash_read_part(struct bfa_flash *flash,
361 			u32 type, u8 instance, void *buf, u32 len, u32 offset,
362 			bfa_cb_flash cbfn, void *cbarg);
363 u32	bfa_nw_flash_meminfo(void);
364 void	bfa_nw_flash_attach(struct bfa_flash *flash,
365 			    struct bfa_ioc *ioc, void *dev);
366 void	bfa_nw_flash_memclaim(struct bfa_flash *flash, u8 *dm_kva, u64 dm_pa);
367 
368 #endif /* __BFA_IOC_H__ */
369