Linux Audio

Check our new training course

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