[deliverable/linux.git] / drivers / net / ethernet / sfc / mcdi.h

/****************************************************************************
 * Driver for Solarflare Solarstorm network controllers and boards
 * Copyright 2008-2010 Solarflare Communications Inc.
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 as published
 * by the Free Software Foundation, incorporated herein by reference.
 */

#ifndef EFX_MCDI_H
#define EFX_MCDI_H

/**
 * enum efx_mcdi_state - MCDI request handling state
 * @MCDI_STATE_QUIESCENT: No pending MCDI requests. If the caller holds the
 *	mcdi @iface_lock then they are able to move to %MCDI_STATE_RUNNING
 * @MCDI_STATE_RUNNING_SYNC: There is a synchronous MCDI request pending.
 *	Only the thread that moved into this state is allowed to move out of it.
 * @MCDI_STATE_RUNNING_ASYNC: There is an asynchronous MCDI request pending.
 * @MCDI_STATE_COMPLETED: An MCDI request has completed, but the owning thread
 *	has not yet consumed the result. For all other threads, equivalent to
 *	%MCDI_STATE_RUNNING.
 */
enum efx_mcdi_state {
	MCDI_STATE_QUIESCENT,
	MCDI_STATE_RUNNING_SYNC,
	MCDI_STATE_RUNNING_ASYNC,
	MCDI_STATE_COMPLETED,
};

enum efx_mcdi_mode {
	MCDI_MODE_POLL,
	MCDI_MODE_EVENTS,
};

/**
 * struct efx_mcdi_iface - MCDI protocol context
 * @efx: The associated NIC.
 * @state: Request handling state. Waited for by @wq.
 * @mode: Poll for mcdi completion, or wait for an mcdi_event.
 * @wq: Wait queue for threads waiting for @state != %MCDI_STATE_RUNNING
 * @new_epoch: Indicates start of day or start of MC reboot recovery
 * @iface_lock: Serialises access to @seqno, @credits and response metadata
 * @seqno: The next sequence number to use for mcdi requests.
 * @credits: Number of spurious MCDI completion events allowed before we
 *     trigger a fatal error
 * @resprc: Response error/success code (Linux numbering)
 * @resp_hdr_len: Response header length
 * @resp_data_len: Response data (SDU or error) length
 * @async_lock: Serialises access to @async_list while event processing is
 *	enabled
 * @async_list: Queue of asynchronous requests
 * @async_timer: Timer for asynchronous request timeout
 */
struct efx_mcdi_iface {
	struct efx_nic *efx;
	enum efx_mcdi_state state;
	enum efx_mcdi_mode mode;
	wait_queue_head_t wq;
	spinlock_t iface_lock;
	bool new_epoch;
	unsigned int credits;
	unsigned int seqno;
	int resprc;
	size_t resp_hdr_len;
	size_t resp_data_len;
	spinlock_t async_lock;
	struct list_head async_list;
	struct timer_list async_timer;
};

struct efx_mcdi_mon {
	struct efx_buffer dma_buf;
	struct mutex update_lock;
	unsigned long last_update;
	struct device *device;
	struct efx_mcdi_mon_attribute *attrs;
	unsigned int n_attrs;
};

struct efx_mcdi_mtd_partition {
	struct efx_mtd_partition common;
	bool updating;
	u8 nvram_type;
	u16 fw_subtype;
};

#define to_efx_mcdi_mtd_partition(mtd)				\
	container_of(mtd, struct efx_mcdi_mtd_partition, common.mtd)

/**
 * struct efx_mcdi_data - extra state for NICs that implement MCDI
 * @iface: Interface/protocol state
 * @hwmon: Hardware monitor state
 */
struct efx_mcdi_data {
	struct efx_mcdi_iface iface;
#ifdef CONFIG_SFC_MCDI_MON
	struct efx_mcdi_mon hwmon;
#endif
};

#ifdef CONFIG_SFC_MCDI_MON
static inline struct efx_mcdi_mon *efx_mcdi_mon(struct efx_nic *efx)
{
	EFX_BUG_ON_PARANOID(!efx->mcdi);
	return &efx->mcdi->hwmon;
}
#endif

extern int efx_mcdi_init(struct efx_nic *efx);
extern void efx_mcdi_fini(struct efx_nic *efx);

extern int efx_mcdi_rpc(struct efx_nic *efx, unsigned cmd,
			const efx_dword_t *inbuf, size_t inlen,
			efx_dword_t *outbuf, size_t outlen,
			size_t *outlen_actual);

extern int efx_mcdi_rpc_start(struct efx_nic *efx, unsigned cmd,
			      const efx_dword_t *inbuf, size_t inlen);
extern int efx_mcdi_rpc_finish(struct efx_nic *efx, unsigned cmd, size_t inlen,
			       efx_dword_t *outbuf, size_t outlen,
			       size_t *outlen_actual);

typedef void efx_mcdi_async_completer(struct efx_nic *efx,
				      unsigned long cookie, int rc,
				      efx_dword_t *outbuf,
				      size_t outlen_actual);
extern int efx_mcdi_rpc_async(struct efx_nic *efx, unsigned int cmd,
			      const efx_dword_t *inbuf, size_t inlen,
			      size_t outlen,
			      efx_mcdi_async_completer *complete,
			      unsigned long cookie);

extern int efx_mcdi_poll_reboot(struct efx_nic *efx);
extern void efx_mcdi_mode_poll(struct efx_nic *efx);
extern void efx_mcdi_mode_event(struct efx_nic *efx);
extern void efx_mcdi_flush_async(struct efx_nic *efx);

extern void efx_mcdi_process_event(struct efx_channel *channel,
				   efx_qword_t *event);
extern void efx_mcdi_sensor_event(struct efx_nic *efx, efx_qword_t *ev);

/* We expect that 16- and 32-bit fields in MCDI requests and responses
 * are appropriately aligned, but 64-bit fields are only
 * 32-bit-aligned.  Also, on Siena we must copy to the MC shared
 * memory strictly 32 bits at a time, so add any necessary padding.
 */
#define MCDI_DECLARE_BUF(_name, _len)					\
	efx_dword_t _name[DIV_ROUND_UP(_len, 4)]
#define _MCDI_PTR(_buf, _offset)					\
	((u8 *)(_buf) + (_offset))
#define MCDI_PTR(_buf, _field)						\
	_MCDI_PTR(_buf, MC_CMD_ ## _field ## _OFST)
#define _MCDI_CHECK_ALIGN(_ofst, _align)				\
	((_ofst) + BUILD_BUG_ON_ZERO((_ofst) & (_align - 1)))
#define _MCDI_DWORD(_buf, _field)					\
	((_buf) + (_MCDI_CHECK_ALIGN(MC_CMD_ ## _field ## _OFST, 4) >> 2))

#define MCDI_SET_DWORD(_buf, _field, _value)				\
	EFX_POPULATE_DWORD_1(*_MCDI_DWORD(_buf, _field), EFX_DWORD_0, _value)
#define MCDI_DWORD(_buf, _field)					\
	EFX_DWORD_FIELD(*_MCDI_DWORD(_buf, _field), EFX_DWORD_0)
#define MCDI_POPULATE_DWORD_1(_buf, _field, _name1, _value1)		\
	EFX_POPULATE_DWORD_1(*_MCDI_DWORD(_buf, _field),		\
			     MC_CMD_ ## _name1, _value1)
#define MCDI_POPULATE_DWORD_2(_buf, _field, _name1, _value1,		\
			      _name2, _value2)				\
	EFX_POPULATE_DWORD_2(*_MCDI_DWORD(_buf, _field),		\
			     MC_CMD_ ## _name1, _value1,		\
			     MC_CMD_ ## _name2, _value2)
#define MCDI_POPULATE_DWORD_3(_buf, _field, _name1, _value1,		\
			      _name2, _value2, _name3, _value3)		\
	EFX_POPULATE_DWORD_3(*_MCDI_DWORD(_buf, _field),		\
			     MC_CMD_ ## _name1, _value1,		\
			     MC_CMD_ ## _name2, _value2,		\
			     MC_CMD_ ## _name3, _value3)
#define MCDI_POPULATE_DWORD_4(_buf, _field, _name1, _value1,		\
			      _name2, _value2, _name3, _value3,		\
			      _name4, _value4)				\
	EFX_POPULATE_DWORD_4(*_MCDI_DWORD(_buf, _field),		\
			     MC_CMD_ ## _name1, _value1,		\
			     MC_CMD_ ## _name2, _value2,		\
			     MC_CMD_ ## _name3, _value3,		\
			     MC_CMD_ ## _name4, _value4)
#define MCDI_POPULATE_DWORD_5(_buf, _field, _name1, _value1,		\
			      _name2, _value2, _name3, _value3,		\
			      _name4, _value4, _name5, _value5)		\
	EFX_POPULATE_DWORD_5(*_MCDI_DWORD(_buf, _field),		\
			     MC_CMD_ ## _name1, _value1,		\
			     MC_CMD_ ## _name2, _value2,		\
			     MC_CMD_ ## _name3, _value3,		\
			     MC_CMD_ ## _name4, _value4,		\
			     MC_CMD_ ## _name5, _value5)
#define MCDI_POPULATE_DWORD_6(_buf, _field, _name1, _value1,		\
			      _name2, _value2, _name3, _value3,		\
			      _name4, _value4, _name5, _value5,		\
			      _name6, _value6)				\
	EFX_POPULATE_DWORD_6(*_MCDI_DWORD(_buf, _field),		\
			     MC_CMD_ ## _name1, _value1,		\
			     MC_CMD_ ## _name2, _value2,		\
			     MC_CMD_ ## _name3, _value3,		\
			     MC_CMD_ ## _name4, _value4,		\
			     MC_CMD_ ## _name5, _value5,		\
			     MC_CMD_ ## _name6, _value6)
#define MCDI_POPULATE_DWORD_7(_buf, _field, _name1, _value1,		\
			      _name2, _value2, _name3, _value3,		\
			      _name4, _value4, _name5, _value5,		\
			      _name6, _value6, _name7, _value7)		\
	EFX_POPULATE_DWORD_7(*_MCDI_DWORD(_buf, _field),		\
			     MC_CMD_ ## _name1, _value1,		\
			     MC_CMD_ ## _name2, _value2,		\
			     MC_CMD_ ## _name3, _value3,		\
			     MC_CMD_ ## _name4, _value4,		\
			     MC_CMD_ ## _name5, _value5,		\
			     MC_CMD_ ## _name6, _value6,		\
			     MC_CMD_ ## _name7, _value7)
#define MCDI_SET_QWORD(_buf, _field, _value)				\
	do {								\
		EFX_POPULATE_DWORD_1(_MCDI_DWORD(_buf, _field)[0],	\
				     EFX_DWORD_0, (u32)(_value));	\
		EFX_POPULATE_DWORD_1(_MCDI_DWORD(_buf, _field)[1],	\
				     EFX_DWORD_0, (u64)(_value) >> 32);	\
	} while (0)
#define MCDI_QWORD(_buf, _field)					\
	(EFX_DWORD_FIELD(_MCDI_DWORD(_buf, _field)[0], EFX_DWORD_0) |	\
	(u64)EFX_DWORD_FIELD(_MCDI_DWORD(_buf, _field)[1], EFX_DWORD_0) << 32)
#define MCDI_FIELD(_ptr, _type, _field)					\
	EFX_EXTRACT_DWORD(						\
		*(efx_dword_t *)					\
		_MCDI_PTR(_ptr, MC_CMD_ ## _type ## _ ## _field ## _OFST & ~3),\
		MC_CMD_ ## _type ## _ ## _field ## _LBN & 0x1f,	\
		(MC_CMD_ ## _type ## _ ## _field ## _LBN & 0x1f) +	\
		MC_CMD_ ## _type ## _ ## _field ## _WIDTH - 1)

#define _MCDI_ARRAY_PTR(_buf, _field, _index, _align)			\
	(_MCDI_PTR(_buf, _MCDI_CHECK_ALIGN(MC_CMD_ ## _field ## _OFST, _align))\
	 + (_index) * _MCDI_CHECK_ALIGN(MC_CMD_ ## _field ## _LEN, _align))
#define MCDI_DECLARE_STRUCT_PTR(_name)					\
	efx_dword_t *_name
#define MCDI_ARRAY_STRUCT_PTR(_buf, _field, _index)			\
	((efx_dword_t *)_MCDI_ARRAY_PTR(_buf, _field, _index, 4))
#define MCDI_VAR_ARRAY_LEN(_len, _field)				\
	min_t(size_t, MC_CMD_ ## _field ## _MAXNUM,			\
	      ((_len) - MC_CMD_ ## _field ## _OFST) / MC_CMD_ ## _field ## _LEN)
#define MCDI_ARRAY_WORD(_buf, _field, _index)				\
	(BUILD_BUG_ON_ZERO(MC_CMD_ ## _field ## _LEN != 2) +		\
	 le16_to_cpu(*(__force const __le16 *)				\
		     _MCDI_ARRAY_PTR(_buf, _field, _index, 2)))
#define _MCDI_ARRAY_DWORD(_buf, _field, _index)				\
	(BUILD_BUG_ON_ZERO(MC_CMD_ ## _field ## _LEN != 4) +		\
	 (efx_dword_t *)_MCDI_ARRAY_PTR(_buf, _field, _index, 4))
#define MCDI_SET_ARRAY_DWORD(_buf, _field, _index, _value)		\
	EFX_SET_DWORD_FIELD(*_MCDI_ARRAY_DWORD(_buf, _field, _index),	\
			    EFX_DWORD_0, _value)
#define MCDI_ARRAY_DWORD(_buf, _field, _index)				\
	EFX_DWORD_FIELD(*_MCDI_ARRAY_DWORD(_buf, _field, _index), EFX_DWORD_0)
#define _MCDI_ARRAY_QWORD(_buf, _field, _index)				\
	(BUILD_BUG_ON_ZERO(MC_CMD_ ## _field ## _LEN != 8) +		\
	 (efx_dword_t *)_MCDI_ARRAY_PTR(_buf, _field, _index, 4))
#define MCDI_SET_ARRAY_QWORD(_buf, _field, _index, _value)		\
	do {								\
		EFX_SET_DWORD_FIELD(_MCDI_ARRAY_QWORD(_buf, _field, _index)[0],\
				    EFX_DWORD_0, (u32)(_value));	\
		EFX_SET_DWORD_FIELD(_MCDI_ARRAY_QWORD(_buf, _field, _index)[1],\
				    EFX_DWORD_0, (u64)(_value) >> 32);	\
	} while (0)
#define MCDI_ARRAY_FIELD(_buf, _field1, _type, _index, _field2)		\
	MCDI_FIELD(MCDI_ARRAY_STRUCT_PTR(_buf, _field1, _index),	\
		   _type ## _TYPEDEF, _field2)

#define MCDI_EVENT_FIELD(_ev, _field)			\
	EFX_QWORD_FIELD(_ev, MCDI_EVENT_ ## _field)

extern void efx_mcdi_print_fwver(struct efx_nic *efx, char *buf, size_t len);
extern int efx_mcdi_drv_attach(struct efx_nic *efx, bool driver_operating,
			       bool *was_attached_out);
extern int efx_mcdi_get_board_cfg(struct efx_nic *efx, u8 *mac_address,
				  u16 *fw_subtype_list, u32 *capabilities);
extern int efx_mcdi_log_ctrl(struct efx_nic *efx, bool evq, bool uart,
			     u32 dest_evq);
extern int efx_mcdi_nvram_types(struct efx_nic *efx, u32 *nvram_types_out);
extern int efx_mcdi_nvram_info(struct efx_nic *efx, unsigned int type,
			       size_t *size_out, size_t *erase_size_out,
			       bool *protected_out);
extern int efx_mcdi_nvram_test_all(struct efx_nic *efx);
extern int efx_mcdi_handle_assertion(struct efx_nic *efx);
extern void efx_mcdi_set_id_led(struct efx_nic *efx, enum efx_led_mode mode);
extern int efx_mcdi_wol_filter_set_magic(struct efx_nic *efx,
					 const u8 *mac, int *id_out);
extern int efx_mcdi_wol_filter_get_magic(struct efx_nic *efx, int *id_out);
extern int efx_mcdi_wol_filter_remove(struct efx_nic *efx, int id);
extern int efx_mcdi_wol_filter_reset(struct efx_nic *efx);
extern int efx_mcdi_flush_rxqs(struct efx_nic *efx);
extern int efx_mcdi_port_probe(struct efx_nic *efx);
extern void efx_mcdi_port_remove(struct efx_nic *efx);
extern int efx_mcdi_port_reconfigure(struct efx_nic *efx);
extern void efx_mcdi_process_link_change(struct efx_nic *efx, efx_qword_t *ev);
extern int efx_mcdi_set_mac(struct efx_nic *efx);
#define EFX_MC_STATS_GENERATION_INVALID ((__force __le64)(-1))
extern void efx_mcdi_mac_start_stats(struct efx_nic *efx);
extern void efx_mcdi_mac_stop_stats(struct efx_nic *efx);
extern bool efx_mcdi_mac_check_fault(struct efx_nic *efx);
extern enum reset_type efx_mcdi_map_reset_reason(enum reset_type reason);
extern int efx_mcdi_reset(struct efx_nic *efx, enum reset_type method);

#ifdef CONFIG_SFC_MCDI_MON
extern int efx_mcdi_mon_probe(struct efx_nic *efx);
extern void efx_mcdi_mon_remove(struct efx_nic *efx);
#else
static inline int efx_mcdi_mon_probe(struct efx_nic *efx) { return 0; }
static inline void efx_mcdi_mon_remove(struct efx_nic *efx) {}
#endif

#ifdef CONFIG_SFC_MTD
extern int efx_mcdi_mtd_read(struct mtd_info *mtd, loff_t start,
			     size_t len, size_t *retlen, u8 *buffer);
extern int efx_mcdi_mtd_erase(struct mtd_info *mtd, loff_t start, size_t len);
extern int efx_mcdi_mtd_write(struct mtd_info *mtd, loff_t start,
			      size_t len, size_t *retlen, const u8 *buffer);
extern int efx_mcdi_mtd_sync(struct mtd_info *mtd);
extern void efx_mcdi_mtd_rename(struct efx_mtd_partition *part);
#endif

#endif /* EFX_MCDI_H */
Commit	Line	Data
afd4aea0 BH	1	/****************************************************************************
afd4aea0 BH	2	* Driver for Solarflare Solarstorm network controllers and boards
0a6f40c6	3	* Copyright 2008-2010 Solarflare Communications Inc.
afd4aea0 BH	4	*
	5	* This program is free software; you can redistribute it and/or modify it
	6	* under the terms of the GNU General Public License version 2 as published
	7	* by the Free Software Foundation, incorporated herein by reference.
	8	*/
	9
	10	#ifndef EFX_MCDI_H
	11	#define EFX_MCDI_H
	12
	13	/**
f76fe120	14	* enum efx_mcdi_state - MCDI request handling state
afd4aea0	15	* @MCDI_STATE_QUIESCENT: No pending MCDI requests. If the caller holds the
f76fe120	16	* mcdi @iface_lock then they are able to move to %MCDI_STATE_RUNNING
cade715f BH	17	* @MCDI_STATE_RUNNING_SYNC: There is a synchronous MCDI request pending.
	18	* Only the thread that moved into this state is allowed to move out of it.
	19	* @MCDI_STATE_RUNNING_ASYNC: There is an asynchronous MCDI request pending.
afd4aea0 BH	20	* @MCDI_STATE_COMPLETED: An MCDI request has completed, but the owning thread
afd4aea0 BH	21	* has not yet consumed the result. For all other threads, equivalent to
f76fe120	22	* %MCDI_STATE_RUNNING.
afd4aea0 BH	23	*/
	24	enum efx_mcdi_state {
	25	MCDI_STATE_QUIESCENT,
cade715f BH	26	MCDI_STATE_RUNNING_SYNC,
cade715f BH	27	MCDI_STATE_RUNNING_ASYNC,
afd4aea0 BH	28	MCDI_STATE_COMPLETED,
	29	};
	30
	31	enum efx_mcdi_mode {
	32	MCDI_MODE_POLL,
	33	MCDI_MODE_EVENTS,
	34	};
	35
	36	/**
f76fe120	37	* struct efx_mcdi_iface - MCDI protocol context
cade715f	38	* @efx: The associated NIC.
f76fe120	39	* @state: Request handling state. Waited for by @wq.
afd4aea0	40	* @mode: Poll for mcdi completion, or wait for an mcdi_event.
f76fe120	41	* @wq: Wait queue for threads waiting for @state != %MCDI_STATE_RUNNING
d36a08b4	42	* @new_epoch: Indicates start of day or start of MC reboot recovery
cade715f	43	* @iface_lock: Serialises access to @seqno, @credits and response metadata
afd4aea0	44	* @seqno: The next sequence number to use for mcdi requests.
afd4aea0	45	* @credits: Number of spurious MCDI completion events allowed before we
f76fe120	46	* trigger a fatal error
5bc283e5	47	* @resprc: Response error/success code (Linux numbering)
df2cd8af BH	48	* @resp_hdr_len: Response header length
df2cd8af BH	49	* @resp_data_len: Response data (SDU or error) length
cade715f BH	50	* @async_lock: Serialises access to @async_list while event processing is
	51	* enabled
	52	* @async_list: Queue of asynchronous requests
	53	* @async_timer: Timer for asynchronous request timeout
afd4aea0 BH	54	*/
afd4aea0 BH	55	struct efx_mcdi_iface {
cade715f	56	struct efx_nic *efx;
251111d9	57	enum efx_mcdi_state state;
f76fe120	58	enum efx_mcdi_mode mode;
afd4aea0 BH	59	wait_queue_head_t wq;
afd4aea0 BH	60	spinlock_t iface_lock;
d36a08b4	61	bool new_epoch;
afd4aea0 BH	62	unsigned int credits;
afd4aea0 BH	63	unsigned int seqno;
5bc283e5	64	int resprc;
df2cd8af BH	65	size_t resp_hdr_len;
df2cd8af BH	66	size_t resp_data_len;
cade715f BH	67	spinlock_t async_lock;
	68	struct list_head async_list;
	69	struct timer_list async_timer;
afd4aea0 BH	70	};
afd4aea0 BH	71
55c5e0f8 BH	72	struct efx_mcdi_mon {
	73	struct efx_buffer dma_buf;
	74	struct mutex update_lock;
	75	unsigned long last_update;
	76	struct device *device;
	77	struct efx_mcdi_mon_attribute *attrs;
	78	unsigned int n_attrs;
	79	};
	80
45a3fd55 BH	81	struct efx_mcdi_mtd_partition {
	82	struct efx_mtd_partition common;
	83	bool updating;
	84	u8 nvram_type;
	85	u16 fw_subtype;
	86	};
	87
	88	#define to_efx_mcdi_mtd_partition(mtd) \
	89	container_of(mtd, struct efx_mcdi_mtd_partition, common.mtd)
	90
f3ad5003 BH	91	/**
	92	* struct efx_mcdi_data - extra state for NICs that implement MCDI
	93	* @iface: Interface/protocol state
	94	* @hwmon: Hardware monitor state
	95	*/
	96	struct efx_mcdi_data {
	97	struct efx_mcdi_iface iface;
	98	#ifdef CONFIG_SFC_MCDI_MON
	99	struct efx_mcdi_mon hwmon;
	100	#endif
	101	};
	102
	103	#ifdef CONFIG_SFC_MCDI_MON
	104	static inline struct efx_mcdi_mon efx_mcdi_mon(struct efx_nic efx)
	105	{
	106	EFX_BUG_ON_PARANOID(!efx->mcdi);
	107	return &efx->mcdi->hwmon;
	108	}
	109	#endif
	110
f073dde0	111	extern int efx_mcdi_init(struct efx_nic *efx);
f3ad5003	112	extern void efx_mcdi_fini(struct efx_nic *efx);
afd4aea0	113
9528b921 BH	114	extern int efx_mcdi_rpc(struct efx_nic *efx, unsigned cmd,
	115	const efx_dword_t *inbuf, size_t inlen,
	116	efx_dword_t *outbuf, size_t outlen,
afd4aea0 BH	117	size_t *outlen_actual);
afd4aea0 BH	118
df2cd8af BH	119	extern int efx_mcdi_rpc_start(struct efx_nic *efx, unsigned cmd,
df2cd8af BH	120	const efx_dword_t *inbuf, size_t inlen);
c3cba721	121	extern int efx_mcdi_rpc_finish(struct efx_nic *efx, unsigned cmd, size_t inlen,
9528b921	122	efx_dword_t *outbuf, size_t outlen,
c3cba721 SH	123	size_t *outlen_actual);
c3cba721 SH	124
cade715f BH	125	typedef void efx_mcdi_async_completer(struct efx_nic *efx,
	126	unsigned long cookie, int rc,
	127	efx_dword_t *outbuf,
	128	size_t outlen_actual);
	129	extern int efx_mcdi_rpc_async(struct efx_nic *efx, unsigned int cmd,
	130	const efx_dword_t *inbuf, size_t inlen,
	131	size_t outlen,
	132	efx_mcdi_async_completer *complete,
	133	unsigned long cookie);
9528b921	134
afd4aea0 BH	135	extern int efx_mcdi_poll_reboot(struct efx_nic *efx);
	136	extern void efx_mcdi_mode_poll(struct efx_nic *efx);
	137	extern void efx_mcdi_mode_event(struct efx_nic *efx);
cade715f	138	extern void efx_mcdi_flush_async(struct efx_nic *efx);
afd4aea0 BH	139
	140	extern void efx_mcdi_process_event(struct efx_channel *channel,
	141	efx_qword_t *event);
55c5e0f8	142	extern void efx_mcdi_sensor_event(struct efx_nic efx, efx_qword_t ev);
afd4aea0	143
9528b921	144	/* We expect that 16- and 32-bit fields in MCDI requests and responses
338f74df BH	145	* are appropriately aligned, but 64-bit fields are only
	146	* 32-bit-aligned. Also, on Siena we must copy to the MC shared
	147	* memory strictly 32 bits at a time, so add any necessary padding.
9528b921	148	*/
59cfc479	149	#define MCDI_DECLARE_BUF(_name, _len) \
9528b921	150	efx_dword_t _name[DIV_ROUND_UP(_len, 4)]
a649dfcb BH	151	#define _MCDI_PTR(_buf, _offset) \
a649dfcb BH	152	((u8 *)(_buf) + (_offset))
30af6910	153	#define MCDI_PTR(_buf, _field) \
a649dfcb	154	_MCDI_PTR(_buf, MC_CMD_ ## _field ## _OFST)
9528b921 BH	155	#define _MCDI_CHECK_ALIGN(_ofst, _align) \
9528b921 BH	156	((_ofst) + BUILD_BUG_ON_ZERO((_ofst) & (_align - 1)))
30af6910	157	#define _MCDI_DWORD(_buf, _field) \
9528b921	158	((_buf) + (_MCDI_CHECK_ALIGN(MC_CMD_ ## _field ## _OFST, 4) >> 2))
59cfc479	159
30af6910 BH	160	#define MCDI_SET_DWORD(_buf, _field, _value) \
	161	EFX_POPULATE_DWORD_1(*_MCDI_DWORD(_buf, _field), EFX_DWORD_0, _value)
	162	#define MCDI_DWORD(_buf, _field) \
	163	EFX_DWORD_FIELD(*_MCDI_DWORD(_buf, _field), EFX_DWORD_0)
f5253d92 BH	164	#define MCDI_POPULATE_DWORD_1(_buf, _field, _name1, _value1) \
	165	EFX_POPULATE_DWORD_1(*_MCDI_DWORD(_buf, _field), \
	166	MC_CMD_ ## _name1, _value1)
	167	#define MCDI_POPULATE_DWORD_2(_buf, _field, _name1, _value1, \
	168	_name2, _value2) \
	169	EFX_POPULATE_DWORD_2(*_MCDI_DWORD(_buf, _field), \
	170	MC_CMD_ ## _name1, _value1, \
	171	MC_CMD_ ## _name2, _value2)
	172	#define MCDI_POPULATE_DWORD_3(_buf, _field, _name1, _value1, \
	173	_name2, _value2, _name3, _value3) \
	174	EFX_POPULATE_DWORD_3(*_MCDI_DWORD(_buf, _field), \
	175	MC_CMD_ ## _name1, _value1, \
	176	MC_CMD_ ## _name2, _value2, \
	177	MC_CMD_ ## _name3, _value3)
	178	#define MCDI_POPULATE_DWORD_4(_buf, _field, _name1, _value1, \
	179	_name2, _value2, _name3, _value3, \
	180	_name4, _value4) \
	181	EFX_POPULATE_DWORD_4(*_MCDI_DWORD(_buf, _field), \
	182	MC_CMD_ ## _name1, _value1, \
	183	MC_CMD_ ## _name2, _value2, \
	184	MC_CMD_ ## _name3, _value3, \
	185	MC_CMD_ ## _name4, _value4)
	186	#define MCDI_POPULATE_DWORD_5(_buf, _field, _name1, _value1, \
	187	_name2, _value2, _name3, _value3, \
	188	_name4, _value4, _name5, _value5) \
	189	EFX_POPULATE_DWORD_5(*_MCDI_DWORD(_buf, _field), \
	190	MC_CMD_ ## _name1, _value1, \
	191	MC_CMD_ ## _name2, _value2, \
	192	MC_CMD_ ## _name3, _value3, \
	193	MC_CMD_ ## _name4, _value4, \
	194	MC_CMD_ ## _name5, _value5)
	195	#define MCDI_POPULATE_DWORD_6(_buf, _field, _name1, _value1, \
	196	_name2, _value2, _name3, _value3, \
	197	_name4, _value4, _name5, _value5, \
	198	_name6, _value6) \
	199	EFX_POPULATE_DWORD_6(*_MCDI_DWORD(_buf, _field), \
	200	MC_CMD_ ## _name1, _value1, \
	201	MC_CMD_ ## _name2, _value2, \
	202	MC_CMD_ ## _name3, _value3, \
	203	MC_CMD_ ## _name4, _value4, \
	204	MC_CMD_ ## _name5, _value5, \
	205	MC_CMD_ ## _name6, _value6)
	206	#define MCDI_POPULATE_DWORD_7(_buf, _field, _name1, _value1, \
	207	_name2, _value2, _name3, _value3, \
	208	_name4, _value4, _name5, _value5, \
	209	_name6, _value6, _name7, _value7) \
	210	EFX_POPULATE_DWORD_7(*_MCDI_DWORD(_buf, _field), \
	211	MC_CMD_ ## _name1, _value1, \
	212	MC_CMD_ ## _name2, _value2, \
	213	MC_CMD_ ## _name3, _value3, \
	214	MC_CMD_ ## _name4, _value4, \
	215	MC_CMD_ ## _name5, _value5, \
	216	MC_CMD_ ## _name6, _value6, \
	217	MC_CMD_ ## _name7, _value7)
338f74df BH	218	#define MCDI_SET_QWORD(_buf, _field, _value) \
	219	do { \
	220	EFX_POPULATE_DWORD_1(_MCDI_DWORD(_buf, _field)[0], \
	221	EFX_DWORD_0, (u32)(_value)); \
	222	EFX_POPULATE_DWORD_1(_MCDI_DWORD(_buf, _field)[1], \
	223	EFX_DWORD_0, (u64)(_value) >> 32); \
	224	} while (0)
30af6910 BH	225	#define MCDI_QWORD(_buf, _field) \
	226	(EFX_DWORD_FIELD(_MCDI_DWORD(_buf, _field)[0], EFX_DWORD_0) \| \
	227	(u64)EFX_DWORD_FIELD(_MCDI_DWORD(_buf, _field)[1], EFX_DWORD_0) << 32)
a649dfcb BH	228	#define MCDI_FIELD(_ptr, _type, _field) \
	229	EFX_EXTRACT_DWORD( \
	230	(efx_dword_t ) \
	231	_MCDI_PTR(_ptr, MC_CMD_ ## _type ## _ ## _field ## _OFST & ~3),\
	232	MC_CMD_ ## _type ## _ ## _field ## _LBN & 0x1f, \
	233	(MC_CMD_ ## _type ## _ ## _field ## _LBN & 0x1f) + \
	234	MC_CMD_ ## _type ## _ ## _field ## _WIDTH - 1)
30af6910	235
9528b921 BH	236	#define _MCDI_ARRAY_PTR(_buf, _field, _index, _align) \
	237	(_MCDI_PTR(_buf, _MCDI_CHECK_ALIGN(MC_CMD_ ## _field ## _OFST, _align))\
	238	+ (_index) * _MCDI_CHECK_ALIGN(MC_CMD_ ## _field ## _LEN, _align))
a649dfcb	239	#define MCDI_DECLARE_STRUCT_PTR(_name) \
9528b921 BH	240	efx_dword_t *_name
	241	#define MCDI_ARRAY_STRUCT_PTR(_buf, _field, _index) \
	242	((efx_dword_t *)_MCDI_ARRAY_PTR(_buf, _field, _index, 4))
a649dfcb BH	243	#define MCDI_VAR_ARRAY_LEN(_len, _field) \
	244	min_t(size_t, MC_CMD_ ## _field ## _MAXNUM, \
	245	((_len) - MC_CMD_ ## _field ## _OFST) / MC_CMD_ ## _field ## _LEN)
	246	#define MCDI_ARRAY_WORD(_buf, _field, _index) \
	247	(BUILD_BUG_ON_ZERO(MC_CMD_ ## _field ## _LEN != 2) + \
	248	le16_to_cpu((__force const __le16 ) \
9528b921	249	_MCDI_ARRAY_PTR(_buf, _field, _index, 2)))
a649dfcb BH	250	#define _MCDI_ARRAY_DWORD(_buf, _field, _index) \
a649dfcb BH	251	(BUILD_BUG_ON_ZERO(MC_CMD_ ## _field ## _LEN != 4) + \
9528b921	252	(efx_dword_t *)_MCDI_ARRAY_PTR(_buf, _field, _index, 4))
a649dfcb BH	253	#define MCDI_SET_ARRAY_DWORD(_buf, _field, _index, _value) \
	254	EFX_SET_DWORD_FIELD(*_MCDI_ARRAY_DWORD(_buf, _field, _index), \
	255	EFX_DWORD_0, _value)
	256	#define MCDI_ARRAY_DWORD(_buf, _field, _index) \
	257	EFX_DWORD_FIELD(*_MCDI_ARRAY_DWORD(_buf, _field, _index), EFX_DWORD_0)
338f74df BH	258	#define _MCDI_ARRAY_QWORD(_buf, _field, _index) \
	259	(BUILD_BUG_ON_ZERO(MC_CMD_ ## _field ## _LEN != 8) + \
	260	(efx_dword_t *)_MCDI_ARRAY_PTR(_buf, _field, _index, 4))
	261	#define MCDI_SET_ARRAY_QWORD(_buf, _field, _index, _value) \
	262	do { \
	263	EFX_SET_DWORD_FIELD(_MCDI_ARRAY_QWORD(_buf, _field, _index)[0],\
	264	EFX_DWORD_0, (u32)(_value)); \
	265	EFX_SET_DWORD_FIELD(_MCDI_ARRAY_QWORD(_buf, _field, _index)[1],\
	266	EFX_DWORD_0, (u64)(_value) >> 32); \
	267	} while (0)
55c5e0f8	268	#define MCDI_ARRAY_FIELD(_buf, _field1, _type, _index, _field2) \
a649dfcb BH	269	MCDI_FIELD(MCDI_ARRAY_STRUCT_PTR(_buf, _field1, _index), \
a649dfcb BH	270	_type ## _TYPEDEF, _field2)
afd4aea0	271
30af6910 BH	272	#define MCDI_EVENT_FIELD(_ev, _field) \
	273	EFX_QWORD_FIELD(_ev, MCDI_EVENT_ ## _field)
	274
e5f0fd27	275	extern void efx_mcdi_print_fwver(struct efx_nic efx, char buf, size_t len);
afd4aea0 BH	276	extern int efx_mcdi_drv_attach(struct efx_nic *efx, bool driver_operating,
	277	bool *was_attached_out);
	278	extern int efx_mcdi_get_board_cfg(struct efx_nic efx, u8 mac_address,
6aa9c7f6	279	u16 fw_subtype_list, u32 capabilities);
afd4aea0 BH	280	extern int efx_mcdi_log_ctrl(struct efx_nic *efx, bool evq, bool uart,
	281	u32 dest_evq);
	282	extern int efx_mcdi_nvram_types(struct efx_nic efx, u32 nvram_types_out);
	283	extern int efx_mcdi_nvram_info(struct efx_nic *efx, unsigned int type,
	284	size_t size_out, size_t erase_size_out,
	285	bool *protected_out);
2e803407	286	extern int efx_mcdi_nvram_test_all(struct efx_nic *efx);
afd4aea0 BH	287	extern int efx_mcdi_handle_assertion(struct efx_nic *efx);
afd4aea0 BH	288	extern void efx_mcdi_set_id_led(struct efx_nic *efx, enum efx_led_mode mode);
afd4aea0 BH	289	extern int efx_mcdi_wol_filter_set_magic(struct efx_nic *efx,
	290	const u8 mac, int id_out);
	291	extern int efx_mcdi_wol_filter_get_magic(struct efx_nic efx, int id_out);
	292	extern int efx_mcdi_wol_filter_remove(struct efx_nic *efx, int id);
	293	extern int efx_mcdi_wol_filter_reset(struct efx_nic *efx);
cd2d5b52	294	extern int efx_mcdi_flush_rxqs(struct efx_nic *efx);
43f775b2 BH	295	extern int efx_mcdi_port_probe(struct efx_nic *efx);
	296	extern void efx_mcdi_port_remove(struct efx_nic *efx);
	297	extern int efx_mcdi_port_reconfigure(struct efx_nic *efx);
	298	extern void efx_mcdi_process_link_change(struct efx_nic efx, efx_qword_t ev);
cd2d5b52	299	extern int efx_mcdi_set_mac(struct efx_nic *efx);
43f775b2 BH	300	#define EFX_MC_STATS_GENERATION_INVALID ((__force __le64)(-1))
	301	extern void efx_mcdi_mac_start_stats(struct efx_nic *efx);
	302	extern void efx_mcdi_mac_stop_stats(struct efx_nic *efx);
710b208d	303	extern bool efx_mcdi_mac_check_fault(struct efx_nic *efx);
6bff861d BH	304	extern enum reset_type efx_mcdi_map_reset_reason(enum reset_type reason);
6bff861d BH	305	extern int efx_mcdi_reset(struct efx_nic *efx, enum reset_type method);
afd4aea0	306
55c5e0f8 BH	307	#ifdef CONFIG_SFC_MCDI_MON
	308	extern int efx_mcdi_mon_probe(struct efx_nic *efx);
	309	extern void efx_mcdi_mon_remove(struct efx_nic *efx);
	310	#else
	311	static inline int efx_mcdi_mon_probe(struct efx_nic *efx) { return 0; }
	312	static inline void efx_mcdi_mon_remove(struct efx_nic *efx) {}
	313	#endif
	314
45a3fd55 BH	315	#ifdef CONFIG_SFC_MTD
	316	extern int efx_mcdi_mtd_read(struct mtd_info *mtd, loff_t start,
	317	size_t len, size_t retlen, u8 buffer);
	318	extern int efx_mcdi_mtd_erase(struct mtd_info *mtd, loff_t start, size_t len);
	319	extern int efx_mcdi_mtd_write(struct mtd_info *mtd, loff_t start,
	320	size_t len, size_t retlen, const u8 buffer);
	321	extern int efx_mcdi_mtd_sync(struct mtd_info *mtd);
	322	extern void efx_mcdi_mtd_rename(struct efx_mtd_partition *part);
	323	#endif
	324
afd4aea0	325	#endif /* EFX_MCDI_H */