1 /* SPDX-License-Identifier: BSD-3-Clause
3 * Copyright(c) 2019-2020 Xilinx, Inc.
4 * Copyright(c) 2009-2019 Solarflare Communications Inc.
7 #ifndef _SYS_EFX_MCDI_H
8 #define _SYS_EFX_MCDI_H
11 #include "efx_regs_mcdi.h"
14 #include "efx_regs_mcdi_strs.h"
15 #endif /* EFSYS_OPT_NAMES */
22 * A reboot/assertion causes the MCDI status word to be set after the
23 * command word is set or a REBOOT event is sent. If we notice a reboot
24 * via these mechanisms then wait 10ms for the status word to be set.
26 #define EFX_MCDI_STATUS_SLEEP_US 10000
28 struct efx_mcdi_req_s {
30 /* Inputs: Command #, input buffer and length */
34 /* Outputs: retcode, buffer, length and length used */
37 size_t emr_out_length;
38 size_t emr_out_length_used;
39 /* Internals: low level transport details */
40 unsigned int emr_err_code;
41 unsigned int emr_err_arg;
42 #if EFSYS_OPT_MCDI_PROXY_AUTH
43 uint32_t emr_proxy_handle;
47 typedef struct efx_mcdi_iface_s {
48 unsigned int emi_port;
49 unsigned int emi_max_version;
51 efx_mcdi_req_t *emi_pending_req;
53 boolean_t emi_new_epoch;
55 uint32_t emi_poll_cnt;
56 uint32_t emi_mc_reboot_status;
63 __inout efx_mcdi_req_t *emrp);
67 efx_mcdi_execute_quiet(
69 __inout efx_mcdi_req_t *emrp);
75 __in unsigned int seq,
76 __in unsigned int outlen,
79 #if EFSYS_OPT_MCDI_PROXY_AUTH
81 extern __checkReturn efx_rc_t
82 efx_mcdi_get_proxy_handle(
84 __in efx_mcdi_req_t *emrp,
85 __out uint32_t *handlep);
89 efx_mcdi_ev_proxy_response(
91 __in unsigned int handle,
92 __in unsigned int status);
95 #if EFSYS_OPT_MCDI_PROXY_AUTH_SERVER
98 efx_mcdi_ev_proxy_request(
100 __in unsigned int index);
101 #endif /* EFSYS_OPT_MCDI_PROXY_AUTH_SERVER */
110 extern __checkReturn efx_rc_t
111 efx_mcdi_request_errcode(
112 __in unsigned int err);
116 efx_mcdi_raise_exception(
118 __in_opt efx_mcdi_req_t *emrp,
121 typedef struct efx_mcdi_version_s {
122 /* Basic version information */
123 uint16_t emv_version[4];
124 uint32_t emv_firmware;
125 } efx_mcdi_version_t;
128 extern __checkReturn efx_rc_t
129 efx_mcdi_get_version(
131 __out efx_mcdi_version_t *verp);
133 typedef enum efx_mcdi_boot_e {
134 EFX_MCDI_BOOT_PRIMARY,
135 EFX_MCDI_BOOT_SECONDARY,
140 extern __checkReturn efx_rc_t
143 __out_ecount_opt(4) uint16_t versionp[4],
144 __out_opt uint32_t *buildp,
145 __out_opt efx_mcdi_boot_t *statusp);
148 extern __checkReturn efx_rc_t
149 efx_mcdi_get_capabilities(
151 __out_opt uint32_t *flagsp,
152 __out_opt uint16_t *rx_dpcpu_fw_idp,
153 __out_opt uint16_t *tx_dpcpu_fw_idp,
154 __out_opt uint32_t *flags2p,
155 __out_opt uint32_t *tso2ncp);
158 extern __checkReturn efx_rc_t
159 efx_mcdi_read_assertion(
160 __in efx_nic_t *enp);
163 extern __checkReturn efx_rc_t
164 efx_mcdi_exit_assertion_handler(
165 __in efx_nic_t *enp);
168 extern __checkReturn efx_rc_t
171 __in boolean_t attach);
174 extern __checkReturn efx_rc_t
175 efx_mcdi_get_board_cfg(
177 __out_opt uint32_t *board_typep,
178 __out_opt efx_dword_t *capabilitiesp,
179 __out_ecount_opt(6) uint8_t mac_addrp[6]);
182 extern __checkReturn efx_rc_t
183 efx_mcdi_get_phy_cfg(
184 __in efx_nic_t *enp);
187 extern __checkReturn efx_rc_t
188 efx_mcdi_firmware_update_supported(
190 __out boolean_t *supportedp);
193 extern __checkReturn efx_rc_t
194 efx_mcdi_macaddr_change_supported(
196 __out boolean_t *supportedp);
199 extern __checkReturn efx_rc_t
200 efx_mcdi_link_control_supported(
202 __out boolean_t *supportedp);
205 extern __checkReturn efx_rc_t
206 efx_mcdi_mac_spoofing_supported(
208 __out boolean_t *supportedp);
214 extern __checkReturn efx_rc_t
215 efx_mcdi_bist_enable_offline(
216 __in efx_nic_t *enp);
217 #endif /* EFX_OPTS_EF10() */
219 extern __checkReturn efx_rc_t
222 __in efx_bist_type_t type);
223 #endif /* EFSYS_OPT_BIST */
226 extern __checkReturn efx_rc_t
227 efx_mcdi_get_resource_limits(
229 __out_opt uint32_t *nevqp,
230 __out_opt uint32_t *nrxqp,
231 __out_opt uint32_t *ntxqp);
234 extern __checkReturn efx_rc_t
236 __in efx_nic_t *enp);
239 extern __checkReturn efx_rc_t
240 efx_mcdi_mac_stats_clear(
241 __in efx_nic_t *enp);
244 extern __checkReturn efx_rc_t
245 efx_mcdi_mac_stats_upload(
247 __in efsys_mem_t *esmp);
250 extern __checkReturn efx_rc_t
251 efx_mcdi_mac_stats_periodic(
253 __in efsys_mem_t *esmp,
254 __in uint16_t period_ms,
255 __in boolean_t events);
258 #if EFSYS_OPT_LOOPBACK
260 extern __checkReturn efx_rc_t
261 efx_mcdi_get_loopback_modes(
262 __in efx_nic_t *enp);
263 #endif /* EFSYS_OPT_LOOPBACK */
266 extern __checkReturn efx_rc_t
267 efx_mcdi_phy_module_get_info(
269 __in uint8_t dev_addr,
272 __out_bcount(len) uint8_t *data);
274 #define MCDI_IN(_emr, _type, _ofst) \
275 ((_type *)((_emr).emr_in_buf + (_ofst)))
277 #define MCDI_IN2(_emr, _type, _ofst) \
278 MCDI_IN(_emr, _type, MC_CMD_ ## _ofst ## _OFST)
280 #define MCDI_IN_SET_BYTE(_emr, _ofst, _value) \
281 EFX_POPULATE_BYTE_1(*MCDI_IN2(_emr, efx_byte_t, _ofst), \
284 #define MCDI_IN_SET_WORD(_emr, _ofst, _value) \
285 EFX_POPULATE_WORD_1(*MCDI_IN2(_emr, efx_word_t, _ofst), \
288 #define MCDI_IN_SET_DWORD(_emr, _ofst, _value) \
289 EFX_POPULATE_DWORD_1(*MCDI_IN2(_emr, efx_dword_t, _ofst), \
292 #define MCDI_IN_SET_DWORD_FIELD(_emr, _ofst, _field, _value) \
293 EFX_SET_DWORD_FIELD(*MCDI_IN2(_emr, efx_dword_t, _ofst), \
294 MC_CMD_ ## _field, _value)
296 #define MCDI_IN_POPULATE_DWORD_1(_emr, _ofst, _field1, _value1) \
297 EFX_POPULATE_DWORD_1(*MCDI_IN2(_emr, efx_dword_t, _ofst), \
298 MC_CMD_ ## _field1, _value1)
300 #define MCDI_IN_POPULATE_DWORD_2(_emr, _ofst, _field1, _value1, \
302 EFX_POPULATE_DWORD_2(*MCDI_IN2(_emr, efx_dword_t, _ofst), \
303 MC_CMD_ ## _field1, _value1, \
304 MC_CMD_ ## _field2, _value2)
306 #define MCDI_IN_POPULATE_DWORD_3(_emr, _ofst, _field1, _value1, \
307 _field2, _value2, _field3, _value3) \
308 EFX_POPULATE_DWORD_3(*MCDI_IN2(_emr, efx_dword_t, _ofst), \
309 MC_CMD_ ## _field1, _value1, \
310 MC_CMD_ ## _field2, _value2, \
311 MC_CMD_ ## _field3, _value3)
313 #define MCDI_IN_POPULATE_DWORD_4(_emr, _ofst, _field1, _value1, \
314 _field2, _value2, _field3, _value3, _field4, _value4) \
315 EFX_POPULATE_DWORD_4(*MCDI_IN2(_emr, efx_dword_t, _ofst), \
316 MC_CMD_ ## _field1, _value1, \
317 MC_CMD_ ## _field2, _value2, \
318 MC_CMD_ ## _field3, _value3, \
319 MC_CMD_ ## _field4, _value4)
321 #define MCDI_IN_POPULATE_DWORD_5(_emr, _ofst, _field1, _value1, \
322 _field2, _value2, _field3, _value3, _field4, _value4, \
324 EFX_POPULATE_DWORD_5(*MCDI_IN2(_emr, efx_dword_t, _ofst), \
325 MC_CMD_ ## _field1, _value1, \
326 MC_CMD_ ## _field2, _value2, \
327 MC_CMD_ ## _field3, _value3, \
328 MC_CMD_ ## _field4, _value4, \
329 MC_CMD_ ## _field5, _value5)
331 #define MCDI_IN_POPULATE_DWORD_6(_emr, _ofst, _field1, _value1, \
332 _field2, _value2, _field3, _value3, _field4, _value4, \
333 _field5, _value5, _field6, _value6) \
334 EFX_POPULATE_DWORD_6(*MCDI_IN2(_emr, efx_dword_t, _ofst), \
335 MC_CMD_ ## _field1, _value1, \
336 MC_CMD_ ## _field2, _value2, \
337 MC_CMD_ ## _field3, _value3, \
338 MC_CMD_ ## _field4, _value4, \
339 MC_CMD_ ## _field5, _value5, \
340 MC_CMD_ ## _field6, _value6)
342 #define MCDI_IN_POPULATE_DWORD_7(_emr, _ofst, _field1, _value1, \
343 _field2, _value2, _field3, _value3, _field4, _value4, \
344 _field5, _value5, _field6, _value6, _field7, _value7) \
345 EFX_POPULATE_DWORD_7(*MCDI_IN2(_emr, efx_dword_t, _ofst), \
346 MC_CMD_ ## _field1, _value1, \
347 MC_CMD_ ## _field2, _value2, \
348 MC_CMD_ ## _field3, _value3, \
349 MC_CMD_ ## _field4, _value4, \
350 MC_CMD_ ## _field5, _value5, \
351 MC_CMD_ ## _field6, _value6, \
352 MC_CMD_ ## _field7, _value7)
354 #define MCDI_IN_POPULATE_DWORD_8(_emr, _ofst, _field1, _value1, \
355 _field2, _value2, _field3, _value3, _field4, _value4, \
356 _field5, _value5, _field6, _value6, _field7, _value7, \
358 EFX_POPULATE_DWORD_8(*MCDI_IN2(_emr, efx_dword_t, _ofst), \
359 MC_CMD_ ## _field1, _value1, \
360 MC_CMD_ ## _field2, _value2, \
361 MC_CMD_ ## _field3, _value3, \
362 MC_CMD_ ## _field4, _value4, \
363 MC_CMD_ ## _field5, _value5, \
364 MC_CMD_ ## _field6, _value6, \
365 MC_CMD_ ## _field7, _value7, \
366 MC_CMD_ ## _field8, _value8)
368 #define MCDI_IN_POPULATE_DWORD_9(_emr, _ofst, _field1, _value1, \
369 _field2, _value2, _field3, _value3, _field4, _value4, \
370 _field5, _value5, _field6, _value6, _field7, _value7, \
371 _field8, _value8, _field9, _value9) \
372 EFX_POPULATE_DWORD_9(*MCDI_IN2(_emr, efx_dword_t, _ofst), \
373 MC_CMD_ ## _field1, _value1, \
374 MC_CMD_ ## _field2, _value2, \
375 MC_CMD_ ## _field3, _value3, \
376 MC_CMD_ ## _field4, _value4, \
377 MC_CMD_ ## _field5, _value5, \
378 MC_CMD_ ## _field6, _value6, \
379 MC_CMD_ ## _field7, _value7, \
380 MC_CMD_ ## _field8, _value8, \
381 MC_CMD_ ## _field9, _value9)
383 #define MCDI_IN_POPULATE_DWORD_10(_emr, _ofst, _field1, _value1, \
384 _field2, _value2, _field3, _value3, _field4, _value4, \
385 _field5, _value5, _field6, _value6, _field7, _value7, \
386 _field8, _value8, _field9, _value9, _field10, _value10) \
387 EFX_POPULATE_DWORD_10(*MCDI_IN2(_emr, efx_dword_t, _ofst), \
388 MC_CMD_ ## _field1, _value1, \
389 MC_CMD_ ## _field2, _value2, \
390 MC_CMD_ ## _field3, _value3, \
391 MC_CMD_ ## _field4, _value4, \
392 MC_CMD_ ## _field5, _value5, \
393 MC_CMD_ ## _field6, _value6, \
394 MC_CMD_ ## _field7, _value7, \
395 MC_CMD_ ## _field8, _value8, \
396 MC_CMD_ ## _field9, _value9, \
397 MC_CMD_ ## _field10, _value10)
400 * Native setters (MCDI_IN_SET_*_NATIVE) are used when MCDI field is in
401 * network order to avoid conversion to little-endian that is done in
404 #define MCDI_IN_SET_WORD_NATIVE(_emr, _ofst, _value) \
405 MCDI_IN2((_emr), efx_word_t, _ofst)->ew_u16[0] = (_value)
407 #define MCDI_IN_SET_DWORD_NATIVE(_emr, _ofst, _value) \
408 MCDI_IN2((_emr), efx_dword_t, _ofst)->ed_u32[0] = (_value)
410 #define MCDI_OUT(_emr, _type, _ofst) \
411 ((_type *)((_emr).emr_out_buf + (_ofst)))
413 #define MCDI_OUT2(_emr, _type, _ofst) \
414 MCDI_OUT(_emr, _type, MC_CMD_ ## _ofst ## _OFST)
416 #define MCDI_OUT_BYTE(_emr, _ofst) \
417 EFX_BYTE_FIELD(*MCDI_OUT2(_emr, efx_byte_t, _ofst), \
420 #define MCDI_OUT_WORD(_emr, _ofst) \
421 EFX_WORD_FIELD(*MCDI_OUT2(_emr, efx_word_t, _ofst), \
424 #define MCDI_OUT_WORD_FIELD(_emr, _ofst, _field) \
425 EFX_WORD_FIELD(*MCDI_OUT2(_emr, efx_word_t, _ofst), \
428 #define MCDI_OUT_DWORD(_emr, _ofst) \
429 EFX_DWORD_FIELD(*MCDI_OUT2(_emr, efx_dword_t, _ofst), \
432 #define MCDI_OUT_DWORD_FIELD(_emr, _ofst, _field) \
433 EFX_DWORD_FIELD(*MCDI_OUT2(_emr, efx_dword_t, _ofst), \
436 #define MCDI_OUT_INDEXED_DWORD_FIELD(_emr, _ofst, _idx, _field) \
437 EFX_DWORD_FIELD(*(MCDI_OUT2(_emr, efx_dword_t, _ofst) + \
440 #define MCDI_EV_FIELD(_eqp, _field) \
441 EFX_QWORD_FIELD(*_eqp, MCDI_EVENT_ ## _field)
443 #define MCDI_CMD_DWORD_FIELD(_edp, _field) \
444 EFX_DWORD_FIELD(*_edp, MC_CMD_ ## _field)
446 #define EFX_MCDI_HAVE_PRIVILEGE(mask, priv) \
447 (((mask) & (MC_CMD_PRIVILEGE_MASK_IN_GRP_ ## priv)) == \
448 (MC_CMD_PRIVILEGE_MASK_IN_GRP_ ## priv))
450 #define EFX_MCDI_BUF_SIZE(_in_len, _out_len) \
451 EFX_P2ROUNDUP(size_t, \
452 MAX(MAX(_in_len, _out_len), (2 * sizeof (efx_dword_t))),\
453 sizeof (efx_dword_t))
456 * The buffer size must be a multiple of dword to ensure that MCDI works
457 * properly with Siena based boards (which use on-chip buffer). Also, it
458 * should be at minimum the size of two dwords to allow space for extended
459 * error responses if the request/response buffer sizes are smaller.
461 #define EFX_MCDI_DECLARE_BUF(_name, _in_len, _out_len) \
462 uint8_t _name[EFX_MCDI_BUF_SIZE(_in_len, _out_len)] = {0}
464 typedef enum efx_mcdi_feature_id_e {
465 EFX_MCDI_FEATURE_FW_UPDATE = 0,
466 EFX_MCDI_FEATURE_LINK_CONTROL,
467 EFX_MCDI_FEATURE_MACADDR_CHANGE,
468 EFX_MCDI_FEATURE_MAC_SPOOFING,
469 EFX_MCDI_FEATURE_NIDS
470 } efx_mcdi_feature_id_t;
476 #endif /* _SYS_EFX_MCDI_H */