Linux Audio

Check our new training course

Loading...
v3.15
 
  1/****************************************************************************
  2 * Driver for Solarflare network controllers and boards
  3 * Copyright 2008-2013 Solarflare Communications Inc.
  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/**
 14 * enum efx_mcdi_state - MCDI request handling state
 15 * @MCDI_STATE_QUIESCENT: No pending MCDI requests. If the caller holds the
 16 *	mcdi @iface_lock then they are able to move to %MCDI_STATE_RUNNING
 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.
 
 
 20 * @MCDI_STATE_COMPLETED: An MCDI request has completed, but the owning thread
 21 *	has not yet consumed the result. For all other threads, equivalent to
 22 *	%MCDI_STATE_RUNNING.
 23 */
 24enum efx_mcdi_state {
 25	MCDI_STATE_QUIESCENT,
 26	MCDI_STATE_RUNNING_SYNC,
 27	MCDI_STATE_RUNNING_ASYNC,
 
 28	MCDI_STATE_COMPLETED,
 29};
 30
 31/**
 32 * enum efx_mcdi_mode - MCDI transaction mode
 33 * @MCDI_MODE_POLL: poll for MCDI completion, until timeout
 34 * @MCDI_MODE_EVENTS: wait for an mcdi_event.  On timeout, poll once
 35 * @MCDI_MODE_FAIL: we think MCDI is dead, so fail-fast all calls
 36 */
 37enum efx_mcdi_mode {
 38	MCDI_MODE_POLL,
 39	MCDI_MODE_EVENTS,
 40	MCDI_MODE_FAIL,
 41};
 42
 43/**
 44 * struct efx_mcdi_iface - MCDI protocol context
 45 * @efx: The associated NIC.
 46 * @state: Request handling state. Waited for by @wq.
 47 * @mode: Poll for mcdi completion, or wait for an mcdi_event.
 48 * @wq: Wait queue for threads waiting for @state != %MCDI_STATE_RUNNING
 49 * @new_epoch: Indicates start of day or start of MC reboot recovery
 50 * @iface_lock: Serialises access to @seqno, @credits and response metadata
 51 * @seqno: The next sequence number to use for mcdi requests.
 52 * @credits: Number of spurious MCDI completion events allowed before we
 53 *     trigger a fatal error
 54 * @resprc: Response error/success code (Linux numbering)
 55 * @resp_hdr_len: Response header length
 56 * @resp_data_len: Response data (SDU or error) length
 57 * @async_lock: Serialises access to @async_list while event processing is
 58 *	enabled
 59 * @async_list: Queue of asynchronous requests
 60 * @async_timer: Timer for asynchronous request timeout
 
 
 
 
 
 61 */
 62struct efx_mcdi_iface {
 63	struct efx_nic *efx;
 64	enum efx_mcdi_state state;
 65	enum efx_mcdi_mode mode;
 66	wait_queue_head_t wq;
 67	spinlock_t iface_lock;
 68	bool new_epoch;
 69	unsigned int credits;
 70	unsigned int seqno;
 71	int resprc;
 
 72	size_t resp_hdr_len;
 73	size_t resp_data_len;
 74	spinlock_t async_lock;
 75	struct list_head async_list;
 76	struct timer_list async_timer;
 
 
 
 
 
 
 
 77};
 78
 79struct efx_mcdi_mon {
 80	struct efx_buffer dma_buf;
 81	struct mutex update_lock;
 82	unsigned long last_update;
 83	struct device *device;
 84	struct efx_mcdi_mon_attribute *attrs;
 85	struct attribute_group group;
 86	const struct attribute_group *groups[2];
 87	unsigned int n_attrs;
 88};
 89
 90struct efx_mcdi_mtd_partition {
 91	struct efx_mtd_partition common;
 92	bool updating;
 93	u16 nvram_type;
 94	u16 fw_subtype;
 95};
 96
 97#define to_efx_mcdi_mtd_partition(mtd)				\
 98	container_of(mtd, struct efx_mcdi_mtd_partition, common.mtd)
 99
100/**
101 * struct efx_mcdi_data - extra state for NICs that implement MCDI
102 * @iface: Interface/protocol state
103 * @hwmon: Hardware monitor state
104 * @fn_flags: Flags for this function, as returned by %MC_CMD_DRV_ATTACH.
105 */
106struct efx_mcdi_data {
107	struct efx_mcdi_iface iface;
108#ifdef CONFIG_SFC_MCDI_MON
109	struct efx_mcdi_mon hwmon;
110#endif
111	u32 fn_flags;
112};
113
114static inline struct efx_mcdi_iface *efx_mcdi(struct efx_nic *efx)
115{
116	EFX_BUG_ON_PARANOID(!efx->mcdi);
117	return &efx->mcdi->iface;
118}
119
120#ifdef CONFIG_SFC_MCDI_MON
121static inline struct efx_mcdi_mon *efx_mcdi_mon(struct efx_nic *efx)
122{
123	EFX_BUG_ON_PARANOID(!efx->mcdi);
124	return &efx->mcdi->hwmon;
125}
126#endif
127
128int efx_mcdi_init(struct efx_nic *efx);
 
129void efx_mcdi_fini(struct efx_nic *efx);
130
131int efx_mcdi_rpc(struct efx_nic *efx, unsigned cmd, const efx_dword_t *inbuf,
132		 size_t inlen, efx_dword_t *outbuf, size_t outlen,
133		 size_t *outlen_actual);
134int efx_mcdi_rpc_quiet(struct efx_nic *efx, unsigned cmd,
135		       const efx_dword_t *inbuf, size_t inlen,
136		       efx_dword_t *outbuf, size_t outlen,
137		       size_t *outlen_actual);
138
139int efx_mcdi_rpc_start(struct efx_nic *efx, unsigned cmd,
140		       const efx_dword_t *inbuf, size_t inlen);
141int efx_mcdi_rpc_finish(struct efx_nic *efx, unsigned cmd, size_t inlen,
142			efx_dword_t *outbuf, size_t outlen,
143			size_t *outlen_actual);
144int efx_mcdi_rpc_finish_quiet(struct efx_nic *efx, unsigned cmd,
145			      size_t inlen, efx_dword_t *outbuf,
146			      size_t outlen, size_t *outlen_actual);
147
148typedef void efx_mcdi_async_completer(struct efx_nic *efx,
149				      unsigned long cookie, int rc,
150				      efx_dword_t *outbuf,
151				      size_t outlen_actual);
152int efx_mcdi_rpc_async(struct efx_nic *efx, unsigned int cmd,
153		       const efx_dword_t *inbuf, size_t inlen, size_t outlen,
154		       efx_mcdi_async_completer *complete,
155		       unsigned long cookie);
156int efx_mcdi_rpc_async_quiet(struct efx_nic *efx, unsigned int cmd,
157			     const efx_dword_t *inbuf, size_t inlen,
158			     size_t outlen,
159			     efx_mcdi_async_completer *complete,
160			     unsigned long cookie);
161
162void efx_mcdi_display_error(struct efx_nic *efx, unsigned cmd,
163			    size_t inlen, efx_dword_t *outbuf,
164			    size_t outlen, int rc);
165
166int efx_mcdi_poll_reboot(struct efx_nic *efx);
167void efx_mcdi_mode_poll(struct efx_nic *efx);
168void efx_mcdi_mode_event(struct efx_nic *efx);
169void efx_mcdi_flush_async(struct efx_nic *efx);
170
171void efx_mcdi_process_event(struct efx_channel *channel, efx_qword_t *event);
172void efx_mcdi_sensor_event(struct efx_nic *efx, efx_qword_t *ev);
173
174/* We expect that 16- and 32-bit fields in MCDI requests and responses
175 * are appropriately aligned, but 64-bit fields are only
176 * 32-bit-aligned.  Also, on Siena we must copy to the MC shared
177 * memory strictly 32 bits at a time, so add any necessary padding.
178 */
179#define MCDI_DECLARE_BUF(_name, _len)					\
180	efx_dword_t _name[DIV_ROUND_UP(_len, 4)]
181#define MCDI_DECLARE_BUF_OUT_OR_ERR(_name, _len)			\
182	MCDI_DECLARE_BUF(_name, max_t(size_t, _len, 8))
 
 
183#define _MCDI_PTR(_buf, _offset)					\
184	((u8 *)(_buf) + (_offset))
185#define MCDI_PTR(_buf, _field)						\
186	_MCDI_PTR(_buf, MC_CMD_ ## _field ## _OFST)
187#define _MCDI_CHECK_ALIGN(_ofst, _align)				\
188	((_ofst) + BUILD_BUG_ON_ZERO((_ofst) & (_align - 1)))
189#define _MCDI_DWORD(_buf, _field)					\
190	((_buf) + (_MCDI_CHECK_ALIGN(MC_CMD_ ## _field ## _OFST, 4) >> 2))
191
 
 
 
192#define MCDI_WORD(_buf, _field)						\
193	((u16)BUILD_BUG_ON_ZERO(MC_CMD_ ## _field ## _LEN != 2) +	\
194	 le16_to_cpu(*(__force const __le16 *)MCDI_PTR(_buf, _field)))
195#define MCDI_SET_DWORD(_buf, _field, _value)				\
196	EFX_POPULATE_DWORD_1(*_MCDI_DWORD(_buf, _field), EFX_DWORD_0, _value)
197#define MCDI_DWORD(_buf, _field)					\
198	EFX_DWORD_FIELD(*_MCDI_DWORD(_buf, _field), EFX_DWORD_0)
199#define MCDI_POPULATE_DWORD_1(_buf, _field, _name1, _value1)		\
200	EFX_POPULATE_DWORD_1(*_MCDI_DWORD(_buf, _field),		\
201			     MC_CMD_ ## _name1, _value1)
202#define MCDI_POPULATE_DWORD_2(_buf, _field, _name1, _value1,		\
203			      _name2, _value2)				\
204	EFX_POPULATE_DWORD_2(*_MCDI_DWORD(_buf, _field),		\
205			     MC_CMD_ ## _name1, _value1,		\
206			     MC_CMD_ ## _name2, _value2)
207#define MCDI_POPULATE_DWORD_3(_buf, _field, _name1, _value1,		\
208			      _name2, _value2, _name3, _value3)		\
209	EFX_POPULATE_DWORD_3(*_MCDI_DWORD(_buf, _field),		\
210			     MC_CMD_ ## _name1, _value1,		\
211			     MC_CMD_ ## _name2, _value2,		\
212			     MC_CMD_ ## _name3, _value3)
213#define MCDI_POPULATE_DWORD_4(_buf, _field, _name1, _value1,		\
214			      _name2, _value2, _name3, _value3,		\
215			      _name4, _value4)				\
216	EFX_POPULATE_DWORD_4(*_MCDI_DWORD(_buf, _field),		\
217			     MC_CMD_ ## _name1, _value1,		\
218			     MC_CMD_ ## _name2, _value2,		\
219			     MC_CMD_ ## _name3, _value3,		\
220			     MC_CMD_ ## _name4, _value4)
221#define MCDI_POPULATE_DWORD_5(_buf, _field, _name1, _value1,		\
222			      _name2, _value2, _name3, _value3,		\
223			      _name4, _value4, _name5, _value5)		\
224	EFX_POPULATE_DWORD_5(*_MCDI_DWORD(_buf, _field),		\
225			     MC_CMD_ ## _name1, _value1,		\
226			     MC_CMD_ ## _name2, _value2,		\
227			     MC_CMD_ ## _name3, _value3,		\
228			     MC_CMD_ ## _name4, _value4,		\
229			     MC_CMD_ ## _name5, _value5)
230#define MCDI_POPULATE_DWORD_6(_buf, _field, _name1, _value1,		\
231			      _name2, _value2, _name3, _value3,		\
232			      _name4, _value4, _name5, _value5,		\
233			      _name6, _value6)				\
234	EFX_POPULATE_DWORD_6(*_MCDI_DWORD(_buf, _field),		\
235			     MC_CMD_ ## _name1, _value1,		\
236			     MC_CMD_ ## _name2, _value2,		\
237			     MC_CMD_ ## _name3, _value3,		\
238			     MC_CMD_ ## _name4, _value4,		\
239			     MC_CMD_ ## _name5, _value5,		\
240			     MC_CMD_ ## _name6, _value6)
241#define MCDI_POPULATE_DWORD_7(_buf, _field, _name1, _value1,		\
242			      _name2, _value2, _name3, _value3,		\
243			      _name4, _value4, _name5, _value5,		\
244			      _name6, _value6, _name7, _value7)		\
245	EFX_POPULATE_DWORD_7(*_MCDI_DWORD(_buf, _field),		\
246			     MC_CMD_ ## _name1, _value1,		\
247			     MC_CMD_ ## _name2, _value2,		\
248			     MC_CMD_ ## _name3, _value3,		\
249			     MC_CMD_ ## _name4, _value4,		\
250			     MC_CMD_ ## _name5, _value5,		\
251			     MC_CMD_ ## _name6, _value6,		\
252			     MC_CMD_ ## _name7, _value7)
253#define MCDI_SET_QWORD(_buf, _field, _value)				\
254	do {								\
255		EFX_POPULATE_DWORD_1(_MCDI_DWORD(_buf, _field)[0],	\
256				     EFX_DWORD_0, (u32)(_value));	\
257		EFX_POPULATE_DWORD_1(_MCDI_DWORD(_buf, _field)[1],	\
258				     EFX_DWORD_0, (u64)(_value) >> 32);	\
259	} while (0)
260#define MCDI_QWORD(_buf, _field)					\
261	(EFX_DWORD_FIELD(_MCDI_DWORD(_buf, _field)[0], EFX_DWORD_0) |	\
262	(u64)EFX_DWORD_FIELD(_MCDI_DWORD(_buf, _field)[1], EFX_DWORD_0) << 32)
263#define MCDI_FIELD(_ptr, _type, _field)					\
264	EFX_EXTRACT_DWORD(						\
265		*(efx_dword_t *)					\
266		_MCDI_PTR(_ptr, MC_CMD_ ## _type ## _ ## _field ## _OFST & ~3),\
267		MC_CMD_ ## _type ## _ ## _field ## _LBN & 0x1f,	\
268		(MC_CMD_ ## _type ## _ ## _field ## _LBN & 0x1f) +	\
269		MC_CMD_ ## _type ## _ ## _field ## _WIDTH - 1)
270
271#define _MCDI_ARRAY_PTR(_buf, _field, _index, _align)			\
272	(_MCDI_PTR(_buf, _MCDI_CHECK_ALIGN(MC_CMD_ ## _field ## _OFST, _align))\
273	 + (_index) * _MCDI_CHECK_ALIGN(MC_CMD_ ## _field ## _LEN, _align))
274#define MCDI_DECLARE_STRUCT_PTR(_name)					\
275	efx_dword_t *_name
276#define MCDI_ARRAY_STRUCT_PTR(_buf, _field, _index)			\
277	((efx_dword_t *)_MCDI_ARRAY_PTR(_buf, _field, _index, 4))
278#define MCDI_VAR_ARRAY_LEN(_len, _field)				\
279	min_t(size_t, MC_CMD_ ## _field ## _MAXNUM,			\
280	      ((_len) - MC_CMD_ ## _field ## _OFST) / MC_CMD_ ## _field ## _LEN)
281#define MCDI_ARRAY_WORD(_buf, _field, _index)				\
282	(BUILD_BUG_ON_ZERO(MC_CMD_ ## _field ## _LEN != 2) +		\
283	 le16_to_cpu(*(__force const __le16 *)				\
284		     _MCDI_ARRAY_PTR(_buf, _field, _index, 2)))
285#define _MCDI_ARRAY_DWORD(_buf, _field, _index)				\
286	(BUILD_BUG_ON_ZERO(MC_CMD_ ## _field ## _LEN != 4) +		\
287	 (efx_dword_t *)_MCDI_ARRAY_PTR(_buf, _field, _index, 4))
288#define MCDI_SET_ARRAY_DWORD(_buf, _field, _index, _value)		\
289	EFX_SET_DWORD_FIELD(*_MCDI_ARRAY_DWORD(_buf, _field, _index),	\
290			    EFX_DWORD_0, _value)
291#define MCDI_ARRAY_DWORD(_buf, _field, _index)				\
292	EFX_DWORD_FIELD(*_MCDI_ARRAY_DWORD(_buf, _field, _index), EFX_DWORD_0)
293#define _MCDI_ARRAY_QWORD(_buf, _field, _index)				\
294	(BUILD_BUG_ON_ZERO(MC_CMD_ ## _field ## _LEN != 8) +		\
295	 (efx_dword_t *)_MCDI_ARRAY_PTR(_buf, _field, _index, 4))
296#define MCDI_SET_ARRAY_QWORD(_buf, _field, _index, _value)		\
297	do {								\
298		EFX_SET_DWORD_FIELD(_MCDI_ARRAY_QWORD(_buf, _field, _index)[0],\
299				    EFX_DWORD_0, (u32)(_value));	\
300		EFX_SET_DWORD_FIELD(_MCDI_ARRAY_QWORD(_buf, _field, _index)[1],\
301				    EFX_DWORD_0, (u64)(_value) >> 32);	\
302	} while (0)
303#define MCDI_ARRAY_FIELD(_buf, _field1, _type, _index, _field2)		\
304	MCDI_FIELD(MCDI_ARRAY_STRUCT_PTR(_buf, _field1, _index),	\
305		   _type ## _TYPEDEF, _field2)
306
307#define MCDI_EVENT_FIELD(_ev, _field)			\
308	EFX_QWORD_FIELD(_ev, MCDI_EVENT_ ## _field)
309
 
 
 
 
 
 
 
 
 
 
 
310void efx_mcdi_print_fwver(struct efx_nic *efx, char *buf, size_t len);
311int efx_mcdi_get_board_cfg(struct efx_nic *efx, u8 *mac_address,
312			   u16 *fw_subtype_list, u32 *capabilities);
313int efx_mcdi_log_ctrl(struct efx_nic *efx, bool evq, bool uart, u32 dest_evq);
314int efx_mcdi_nvram_types(struct efx_nic *efx, u32 *nvram_types_out);
315int efx_mcdi_nvram_info(struct efx_nic *efx, unsigned int type,
316			size_t *size_out, size_t *erase_size_out,
317			bool *protected_out);
 
318int efx_mcdi_nvram_test_all(struct efx_nic *efx);
319int efx_mcdi_handle_assertion(struct efx_nic *efx);
320void efx_mcdi_set_id_led(struct efx_nic *efx, enum efx_led_mode mode);
321int efx_mcdi_wol_filter_set_magic(struct efx_nic *efx, const u8 *mac,
322				  int *id_out);
323int efx_mcdi_wol_filter_get_magic(struct efx_nic *efx, int *id_out);
324int efx_mcdi_wol_filter_remove(struct efx_nic *efx, int id);
325int efx_mcdi_wol_filter_reset(struct efx_nic *efx);
326int efx_mcdi_flush_rxqs(struct efx_nic *efx);
327int efx_mcdi_port_probe(struct efx_nic *efx);
328void efx_mcdi_port_remove(struct efx_nic *efx);
329int efx_mcdi_port_reconfigure(struct efx_nic *efx);
330int efx_mcdi_port_get_number(struct efx_nic *efx);
331u32 efx_mcdi_phy_get_caps(struct efx_nic *efx);
332void efx_mcdi_process_link_change(struct efx_nic *efx, efx_qword_t *ev);
333int efx_mcdi_set_mac(struct efx_nic *efx);
334#define EFX_MC_STATS_GENERATION_INVALID ((__force __le64)(-1))
335void efx_mcdi_mac_start_stats(struct efx_nic *efx);
336void efx_mcdi_mac_stop_stats(struct efx_nic *efx);
337void efx_mcdi_mac_pull_stats(struct efx_nic *efx);
338bool efx_mcdi_mac_check_fault(struct efx_nic *efx);
339enum reset_type efx_mcdi_map_reset_reason(enum reset_type reason);
340int efx_mcdi_reset(struct efx_nic *efx, enum reset_type method);
341int efx_mcdi_set_workaround(struct efx_nic *efx, u32 type, bool enabled);
 
 
 
342
343#ifdef CONFIG_SFC_MCDI_MON
344int efx_mcdi_mon_probe(struct efx_nic *efx);
345void efx_mcdi_mon_remove(struct efx_nic *efx);
346#else
347static inline int efx_mcdi_mon_probe(struct efx_nic *efx) { return 0; }
348static inline void efx_mcdi_mon_remove(struct efx_nic *efx) {}
349#endif
350
351#ifdef CONFIG_SFC_MTD
352int efx_mcdi_mtd_read(struct mtd_info *mtd, loff_t start, size_t len,
353		      size_t *retlen, u8 *buffer);
354int efx_mcdi_mtd_erase(struct mtd_info *mtd, loff_t start, size_t len);
355int efx_mcdi_mtd_write(struct mtd_info *mtd, loff_t start, size_t len,
356		       size_t *retlen, const u8 *buffer);
357int efx_mcdi_mtd_sync(struct mtd_info *mtd);
358void efx_mcdi_mtd_rename(struct efx_mtd_partition *part);
359#endif
360
361#endif /* EFX_MCDI_H */
v5.9
  1/* SPDX-License-Identifier: GPL-2.0-only */
  2/****************************************************************************
  3 * Driver for Solarflare network controllers and boards
  4 * Copyright 2008-2013 Solarflare Communications Inc.
 
 
 
 
  5 */
  6
  7#ifndef EFX_MCDI_H
  8#define EFX_MCDI_H
  9
 10/**
 11 * enum efx_mcdi_state - MCDI request handling state
 12 * @MCDI_STATE_QUIESCENT: No pending MCDI requests. If the caller holds the
 13 *	mcdi @iface_lock then they are able to move to %MCDI_STATE_RUNNING
 14 * @MCDI_STATE_RUNNING_SYNC: There is a synchronous MCDI request pending.
 15 *	Only the thread that moved into this state is allowed to move out of it.
 16 * @MCDI_STATE_RUNNING_ASYNC: There is an asynchronous MCDI request pending.
 17 * @MCDI_STATE_PROXY_WAIT: An MCDI request has completed with a response that
 18 *	indicates we must wait for a proxy try again message.
 19 * @MCDI_STATE_COMPLETED: An MCDI request has completed, but the owning thread
 20 *	has not yet consumed the result. For all other threads, equivalent to
 21 *	%MCDI_STATE_RUNNING.
 22 */
 23enum efx_mcdi_state {
 24	MCDI_STATE_QUIESCENT,
 25	MCDI_STATE_RUNNING_SYNC,
 26	MCDI_STATE_RUNNING_ASYNC,
 27	MCDI_STATE_PROXY_WAIT,
 28	MCDI_STATE_COMPLETED,
 29};
 30
 31/**
 32 * enum efx_mcdi_mode - MCDI transaction mode
 33 * @MCDI_MODE_POLL: poll for MCDI completion, until timeout
 34 * @MCDI_MODE_EVENTS: wait for an mcdi_event.  On timeout, poll once
 35 * @MCDI_MODE_FAIL: we think MCDI is dead, so fail-fast all calls
 36 */
 37enum efx_mcdi_mode {
 38	MCDI_MODE_POLL,
 39	MCDI_MODE_EVENTS,
 40	MCDI_MODE_FAIL,
 41};
 42
 43/**
 44 * struct efx_mcdi_iface - MCDI protocol context
 45 * @efx: The associated NIC.
 46 * @state: Request handling state. Waited for by @wq.
 47 * @mode: Poll for mcdi completion, or wait for an mcdi_event.
 48 * @wq: Wait queue for threads waiting for @state != %MCDI_STATE_RUNNING
 49 * @new_epoch: Indicates start of day or start of MC reboot recovery
 50 * @iface_lock: Serialises access to @seqno, @credits and response metadata
 51 * @seqno: The next sequence number to use for mcdi requests.
 52 * @credits: Number of spurious MCDI completion events allowed before we
 53 *     trigger a fatal error
 54 * @resprc: Response error/success code (Linux numbering)
 55 * @resp_hdr_len: Response header length
 56 * @resp_data_len: Response data (SDU or error) length
 57 * @async_lock: Serialises access to @async_list while event processing is
 58 *	enabled
 59 * @async_list: Queue of asynchronous requests
 60 * @async_timer: Timer for asynchronous request timeout
 61 * @logging_buffer: buffer that may be used to build MCDI tracing messages
 62 * @logging_enabled: whether to trace MCDI
 63 * @proxy_rx_handle: Most recently received proxy authorisation handle
 64 * @proxy_rx_status: Status of most recent proxy authorisation
 65 * @proxy_rx_wq: Wait queue for updates to proxy_rx_handle
 66 */
 67struct efx_mcdi_iface {
 68	struct efx_nic *efx;
 69	enum efx_mcdi_state state;
 70	enum efx_mcdi_mode mode;
 71	wait_queue_head_t wq;
 72	spinlock_t iface_lock;
 73	bool new_epoch;
 74	unsigned int credits;
 75	unsigned int seqno;
 76	int resprc;
 77	int resprc_raw;
 78	size_t resp_hdr_len;
 79	size_t resp_data_len;
 80	spinlock_t async_lock;
 81	struct list_head async_list;
 82	struct timer_list async_timer;
 83#ifdef CONFIG_SFC_MCDI_LOGGING
 84	char *logging_buffer;
 85	bool logging_enabled;
 86#endif
 87	unsigned int proxy_rx_handle;
 88	int proxy_rx_status;
 89	wait_queue_head_t proxy_rx_wq;
 90};
 91
 92struct efx_mcdi_mon {
 93	struct efx_buffer dma_buf;
 94	struct mutex update_lock;
 95	unsigned long last_update;
 96	struct device *device;
 97	struct efx_mcdi_mon_attribute *attrs;
 98	struct attribute_group group;
 99	const struct attribute_group *groups[2];
100	unsigned int n_attrs;
101};
102
103struct efx_mcdi_mtd_partition {
104	struct efx_mtd_partition common;
105	bool updating;
106	u16 nvram_type;
107	u16 fw_subtype;
108};
109
110#define to_efx_mcdi_mtd_partition(mtd)				\
111	container_of(mtd, struct efx_mcdi_mtd_partition, common.mtd)
112
113/**
114 * struct efx_mcdi_data - extra state for NICs that implement MCDI
115 * @iface: Interface/protocol state
116 * @hwmon: Hardware monitor state
117 * @fn_flags: Flags for this function, as returned by %MC_CMD_DRV_ATTACH.
118 */
119struct efx_mcdi_data {
120	struct efx_mcdi_iface iface;
121#ifdef CONFIG_SFC_MCDI_MON
122	struct efx_mcdi_mon hwmon;
123#endif
124	u32 fn_flags;
125};
126
127static inline struct efx_mcdi_iface *efx_mcdi(struct efx_nic *efx)
128{
129	EFX_WARN_ON_PARANOID(!efx->mcdi);
130	return &efx->mcdi->iface;
131}
132
133#ifdef CONFIG_SFC_MCDI_MON
134static inline struct efx_mcdi_mon *efx_mcdi_mon(struct efx_nic *efx)
135{
136	EFX_WARN_ON_PARANOID(!efx->mcdi);
137	return &efx->mcdi->hwmon;
138}
139#endif
140
141int efx_mcdi_init(struct efx_nic *efx);
142void efx_mcdi_detach(struct efx_nic *efx);
143void efx_mcdi_fini(struct efx_nic *efx);
144
145int efx_mcdi_rpc(struct efx_nic *efx, unsigned cmd, const efx_dword_t *inbuf,
146		 size_t inlen, efx_dword_t *outbuf, size_t outlen,
147		 size_t *outlen_actual);
148int efx_mcdi_rpc_quiet(struct efx_nic *efx, unsigned cmd,
149		       const efx_dword_t *inbuf, size_t inlen,
150		       efx_dword_t *outbuf, size_t outlen,
151		       size_t *outlen_actual);
152
153int efx_mcdi_rpc_start(struct efx_nic *efx, unsigned cmd,
154		       const efx_dword_t *inbuf, size_t inlen);
155int efx_mcdi_rpc_finish(struct efx_nic *efx, unsigned cmd, size_t inlen,
156			efx_dword_t *outbuf, size_t outlen,
157			size_t *outlen_actual);
158int efx_mcdi_rpc_finish_quiet(struct efx_nic *efx, unsigned cmd,
159			      size_t inlen, efx_dword_t *outbuf,
160			      size_t outlen, size_t *outlen_actual);
161
162typedef void efx_mcdi_async_completer(struct efx_nic *efx,
163				      unsigned long cookie, int rc,
164				      efx_dword_t *outbuf,
165				      size_t outlen_actual);
166int efx_mcdi_rpc_async(struct efx_nic *efx, unsigned int cmd,
167		       const efx_dword_t *inbuf, size_t inlen, size_t outlen,
168		       efx_mcdi_async_completer *complete,
169		       unsigned long cookie);
170int efx_mcdi_rpc_async_quiet(struct efx_nic *efx, unsigned int cmd,
171			     const efx_dword_t *inbuf, size_t inlen,
172			     size_t outlen,
173			     efx_mcdi_async_completer *complete,
174			     unsigned long cookie);
175
176void efx_mcdi_display_error(struct efx_nic *efx, unsigned cmd,
177			    size_t inlen, efx_dword_t *outbuf,
178			    size_t outlen, int rc);
179
180int efx_mcdi_poll_reboot(struct efx_nic *efx);
181void efx_mcdi_mode_poll(struct efx_nic *efx);
182void efx_mcdi_mode_event(struct efx_nic *efx);
183void efx_mcdi_flush_async(struct efx_nic *efx);
184
185void efx_mcdi_process_event(struct efx_channel *channel, efx_qword_t *event);
186void efx_mcdi_sensor_event(struct efx_nic *efx, efx_qword_t *ev);
187
188/* We expect that 16- and 32-bit fields in MCDI requests and responses
189 * are appropriately aligned, but 64-bit fields are only
190 * 32-bit-aligned.  Also, on Siena we must copy to the MC shared
191 * memory strictly 32 bits at a time, so add any necessary padding.
192 */
193#define _MCDI_DECLARE_BUF(_name, _len)					\
194	efx_dword_t _name[DIV_ROUND_UP(_len, 4)]
195#define MCDI_DECLARE_BUF(_name, _len)					\
196	_MCDI_DECLARE_BUF(_name, _len) = {{{0}}}
197#define MCDI_DECLARE_BUF_ERR(_name)					\
198	MCDI_DECLARE_BUF(_name, 8)
199#define _MCDI_PTR(_buf, _offset)					\
200	((u8 *)(_buf) + (_offset))
201#define MCDI_PTR(_buf, _field)						\
202	_MCDI_PTR(_buf, MC_CMD_ ## _field ## _OFST)
203#define _MCDI_CHECK_ALIGN(_ofst, _align)				\
204	((_ofst) + BUILD_BUG_ON_ZERO((_ofst) & (_align - 1)))
205#define _MCDI_DWORD(_buf, _field)					\
206	((_buf) + (_MCDI_CHECK_ALIGN(MC_CMD_ ## _field ## _OFST, 4) >> 2))
207
208#define MCDI_BYTE(_buf, _field)						\
209	((void)BUILD_BUG_ON_ZERO(MC_CMD_ ## _field ## _LEN != 1),	\
210	 *MCDI_PTR(_buf, _field))
211#define MCDI_WORD(_buf, _field)						\
212	((u16)BUILD_BUG_ON_ZERO(MC_CMD_ ## _field ## _LEN != 2) +	\
213	 le16_to_cpu(*(__force const __le16 *)MCDI_PTR(_buf, _field)))
214#define MCDI_SET_DWORD(_buf, _field, _value)				\
215	EFX_POPULATE_DWORD_1(*_MCDI_DWORD(_buf, _field), EFX_DWORD_0, _value)
216#define MCDI_DWORD(_buf, _field)					\
217	EFX_DWORD_FIELD(*_MCDI_DWORD(_buf, _field), EFX_DWORD_0)
218#define MCDI_POPULATE_DWORD_1(_buf, _field, _name1, _value1)		\
219	EFX_POPULATE_DWORD_1(*_MCDI_DWORD(_buf, _field),		\
220			     MC_CMD_ ## _name1, _value1)
221#define MCDI_POPULATE_DWORD_2(_buf, _field, _name1, _value1,		\
222			      _name2, _value2)				\
223	EFX_POPULATE_DWORD_2(*_MCDI_DWORD(_buf, _field),		\
224			     MC_CMD_ ## _name1, _value1,		\
225			     MC_CMD_ ## _name2, _value2)
226#define MCDI_POPULATE_DWORD_3(_buf, _field, _name1, _value1,		\
227			      _name2, _value2, _name3, _value3)		\
228	EFX_POPULATE_DWORD_3(*_MCDI_DWORD(_buf, _field),		\
229			     MC_CMD_ ## _name1, _value1,		\
230			     MC_CMD_ ## _name2, _value2,		\
231			     MC_CMD_ ## _name3, _value3)
232#define MCDI_POPULATE_DWORD_4(_buf, _field, _name1, _value1,		\
233			      _name2, _value2, _name3, _value3,		\
234			      _name4, _value4)				\
235	EFX_POPULATE_DWORD_4(*_MCDI_DWORD(_buf, _field),		\
236			     MC_CMD_ ## _name1, _value1,		\
237			     MC_CMD_ ## _name2, _value2,		\
238			     MC_CMD_ ## _name3, _value3,		\
239			     MC_CMD_ ## _name4, _value4)
240#define MCDI_POPULATE_DWORD_5(_buf, _field, _name1, _value1,		\
241			      _name2, _value2, _name3, _value3,		\
242			      _name4, _value4, _name5, _value5)		\
243	EFX_POPULATE_DWORD_5(*_MCDI_DWORD(_buf, _field),		\
244			     MC_CMD_ ## _name1, _value1,		\
245			     MC_CMD_ ## _name2, _value2,		\
246			     MC_CMD_ ## _name3, _value3,		\
247			     MC_CMD_ ## _name4, _value4,		\
248			     MC_CMD_ ## _name5, _value5)
249#define MCDI_POPULATE_DWORD_6(_buf, _field, _name1, _value1,		\
250			      _name2, _value2, _name3, _value3,		\
251			      _name4, _value4, _name5, _value5,		\
252			      _name6, _value6)				\
253	EFX_POPULATE_DWORD_6(*_MCDI_DWORD(_buf, _field),		\
254			     MC_CMD_ ## _name1, _value1,		\
255			     MC_CMD_ ## _name2, _value2,		\
256			     MC_CMD_ ## _name3, _value3,		\
257			     MC_CMD_ ## _name4, _value4,		\
258			     MC_CMD_ ## _name5, _value5,		\
259			     MC_CMD_ ## _name6, _value6)
260#define MCDI_POPULATE_DWORD_7(_buf, _field, _name1, _value1,		\
261			      _name2, _value2, _name3, _value3,		\
262			      _name4, _value4, _name5, _value5,		\
263			      _name6, _value6, _name7, _value7)		\
264	EFX_POPULATE_DWORD_7(*_MCDI_DWORD(_buf, _field),		\
265			     MC_CMD_ ## _name1, _value1,		\
266			     MC_CMD_ ## _name2, _value2,		\
267			     MC_CMD_ ## _name3, _value3,		\
268			     MC_CMD_ ## _name4, _value4,		\
269			     MC_CMD_ ## _name5, _value5,		\
270			     MC_CMD_ ## _name6, _value6,		\
271			     MC_CMD_ ## _name7, _value7)
272#define MCDI_SET_QWORD(_buf, _field, _value)				\
273	do {								\
274		EFX_POPULATE_DWORD_1(_MCDI_DWORD(_buf, _field)[0],	\
275				     EFX_DWORD_0, (u32)(_value));	\
276		EFX_POPULATE_DWORD_1(_MCDI_DWORD(_buf, _field)[1],	\
277				     EFX_DWORD_0, (u64)(_value) >> 32);	\
278	} while (0)
279#define MCDI_QWORD(_buf, _field)					\
280	(EFX_DWORD_FIELD(_MCDI_DWORD(_buf, _field)[0], EFX_DWORD_0) |	\
281	(u64)EFX_DWORD_FIELD(_MCDI_DWORD(_buf, _field)[1], EFX_DWORD_0) << 32)
282#define MCDI_FIELD(_ptr, _type, _field)					\
283	EFX_EXTRACT_DWORD(						\
284		*(efx_dword_t *)					\
285		_MCDI_PTR(_ptr, MC_CMD_ ## _type ## _ ## _field ## _OFST & ~3),\
286		MC_CMD_ ## _type ## _ ## _field ## _LBN & 0x1f,	\
287		(MC_CMD_ ## _type ## _ ## _field ## _LBN & 0x1f) +	\
288		MC_CMD_ ## _type ## _ ## _field ## _WIDTH - 1)
289
290#define _MCDI_ARRAY_PTR(_buf, _field, _index, _align)			\
291	(_MCDI_PTR(_buf, _MCDI_CHECK_ALIGN(MC_CMD_ ## _field ## _OFST, _align))\
292	 + (_index) * _MCDI_CHECK_ALIGN(MC_CMD_ ## _field ## _LEN, _align))
293#define MCDI_DECLARE_STRUCT_PTR(_name)					\
294	efx_dword_t *_name
295#define MCDI_ARRAY_STRUCT_PTR(_buf, _field, _index)			\
296	((efx_dword_t *)_MCDI_ARRAY_PTR(_buf, _field, _index, 4))
297#define MCDI_VAR_ARRAY_LEN(_len, _field)				\
298	min_t(size_t, MC_CMD_ ## _field ## _MAXNUM,			\
299	      ((_len) - MC_CMD_ ## _field ## _OFST) / MC_CMD_ ## _field ## _LEN)
300#define MCDI_ARRAY_WORD(_buf, _field, _index)				\
301	(BUILD_BUG_ON_ZERO(MC_CMD_ ## _field ## _LEN != 2) +		\
302	 le16_to_cpu(*(__force const __le16 *)				\
303		     _MCDI_ARRAY_PTR(_buf, _field, _index, 2)))
304#define _MCDI_ARRAY_DWORD(_buf, _field, _index)				\
305	(BUILD_BUG_ON_ZERO(MC_CMD_ ## _field ## _LEN != 4) +		\
306	 (efx_dword_t *)_MCDI_ARRAY_PTR(_buf, _field, _index, 4))
307#define MCDI_SET_ARRAY_DWORD(_buf, _field, _index, _value)		\
308	EFX_SET_DWORD_FIELD(*_MCDI_ARRAY_DWORD(_buf, _field, _index),	\
309			    EFX_DWORD_0, _value)
310#define MCDI_ARRAY_DWORD(_buf, _field, _index)				\
311	EFX_DWORD_FIELD(*_MCDI_ARRAY_DWORD(_buf, _field, _index), EFX_DWORD_0)
312#define _MCDI_ARRAY_QWORD(_buf, _field, _index)				\
313	(BUILD_BUG_ON_ZERO(MC_CMD_ ## _field ## _LEN != 8) +		\
314	 (efx_dword_t *)_MCDI_ARRAY_PTR(_buf, _field, _index, 4))
315#define MCDI_SET_ARRAY_QWORD(_buf, _field, _index, _value)		\
316	do {								\
317		EFX_SET_DWORD_FIELD(_MCDI_ARRAY_QWORD(_buf, _field, _index)[0],\
318				    EFX_DWORD_0, (u32)(_value));	\
319		EFX_SET_DWORD_FIELD(_MCDI_ARRAY_QWORD(_buf, _field, _index)[1],\
320				    EFX_DWORD_0, (u64)(_value) >> 32);	\
321	} while (0)
322#define MCDI_ARRAY_FIELD(_buf, _field1, _type, _index, _field2)		\
323	MCDI_FIELD(MCDI_ARRAY_STRUCT_PTR(_buf, _field1, _index),	\
324		   _type ## _TYPEDEF, _field2)
325
326#define MCDI_EVENT_FIELD(_ev, _field)			\
327	EFX_QWORD_FIELD(_ev, MCDI_EVENT_ ## _field)
328
329#define MCDI_CAPABILITY(field)						\
330	MC_CMD_GET_CAPABILITIES_V8_OUT_ ## field ## _LBN
331
332#define MCDI_CAPABILITY_OFST(field) \
333	MC_CMD_GET_CAPABILITIES_V8_OUT_ ## field ## _OFST
334
335#define efx_has_cap(efx, field) \
336	efx->type->check_caps(efx, \
337			      MCDI_CAPABILITY(field), \
338			      MCDI_CAPABILITY_OFST(field))
339
340void efx_mcdi_print_fwver(struct efx_nic *efx, char *buf, size_t len);
341int efx_mcdi_get_board_cfg(struct efx_nic *efx, u8 *mac_address,
342			   u16 *fw_subtype_list, u32 *capabilities);
343int efx_mcdi_log_ctrl(struct efx_nic *efx, bool evq, bool uart, u32 dest_evq);
344int efx_mcdi_nvram_types(struct efx_nic *efx, u32 *nvram_types_out);
345int efx_mcdi_nvram_info(struct efx_nic *efx, unsigned int type,
346			size_t *size_out, size_t *erase_size_out,
347			bool *protected_out);
348int efx_new_mcdi_nvram_test_all(struct efx_nic *efx);
349int efx_mcdi_nvram_test_all(struct efx_nic *efx);
350int efx_mcdi_handle_assertion(struct efx_nic *efx);
351void efx_mcdi_set_id_led(struct efx_nic *efx, enum efx_led_mode mode);
352int efx_mcdi_wol_filter_set_magic(struct efx_nic *efx, const u8 *mac,
353				  int *id_out);
354int efx_mcdi_wol_filter_get_magic(struct efx_nic *efx, int *id_out);
355int efx_mcdi_wol_filter_remove(struct efx_nic *efx, int id);
356int efx_mcdi_wol_filter_reset(struct efx_nic *efx);
357int efx_mcdi_flush_rxqs(struct efx_nic *efx);
 
 
358int efx_mcdi_port_reconfigure(struct efx_nic *efx);
 
 
359void efx_mcdi_process_link_change(struct efx_nic *efx, efx_qword_t *ev);
 
 
360void efx_mcdi_mac_start_stats(struct efx_nic *efx);
361void efx_mcdi_mac_stop_stats(struct efx_nic *efx);
362void efx_mcdi_mac_pull_stats(struct efx_nic *efx);
 
363enum reset_type efx_mcdi_map_reset_reason(enum reset_type reason);
364int efx_mcdi_reset(struct efx_nic *efx, enum reset_type method);
365int efx_mcdi_set_workaround(struct efx_nic *efx, u32 type, bool enabled,
366			    unsigned int *flags);
367int efx_mcdi_get_workarounds(struct efx_nic *efx, unsigned int *impl_out,
368			     unsigned int *enabled_out);
369
370#ifdef CONFIG_SFC_MCDI_MON
371int efx_mcdi_mon_probe(struct efx_nic *efx);
372void efx_mcdi_mon_remove(struct efx_nic *efx);
373#else
374static inline int efx_mcdi_mon_probe(struct efx_nic *efx) { return 0; }
375static inline void efx_mcdi_mon_remove(struct efx_nic *efx) {}
376#endif
377
378#ifdef CONFIG_SFC_MTD
379int efx_mcdi_mtd_read(struct mtd_info *mtd, loff_t start, size_t len,
380		      size_t *retlen, u8 *buffer);
381int efx_mcdi_mtd_erase(struct mtd_info *mtd, loff_t start, size_t len);
382int efx_mcdi_mtd_write(struct mtd_info *mtd, loff_t start, size_t len,
383		       size_t *retlen, const u8 *buffer);
384int efx_mcdi_mtd_sync(struct mtd_info *mtd);
385void efx_mcdi_mtd_rename(struct efx_mtd_partition *part);
386#endif
387
388#endif /* EFX_MCDI_H */