drivers/net/sfc/base/efx_mcdi.c

   1 /* SPDX-License-Identifier: BSD-3-Clause
   2  *
   3  * Copyright (c) 2008-2018 Solarflare Communications Inc.
   4  * All rights reserved.
   5  */
   6
   7 #include "efx.h"
   8 #include "efx_impl.h"
   9
  10 #if EFSYS_OPT_MCDI
  11
  12 /*
  13  * There are three versions of the MCDI interface:
  14  *  - MCDIv0: Siena BootROM. Transport uses MCDIv1 headers.
  15  *  - MCDIv1: Siena firmware and Huntington BootROM.
  16  *  - MCDIv2: EF10 firmware (Huntington/Medford) and Medford BootROM.
  17  *            Transport uses MCDIv2 headers.
  18  *
  19  * MCDIv2 Header NOT_EPOCH flag
  20  * ----------------------------
  21  * A new epoch begins at initial startup or after an MC reboot, and defines when
  22  * the MC should reject stale MCDI requests.
  23  *
  24  * The first MCDI request sent by the host should contain NOT_EPOCH=0, and all
  25  * subsequent requests (until the next MC reboot) should contain NOT_EPOCH=1.
  26  *
  27  * After rebooting the MC will fail all requests with NOT_EPOCH=1 by writing a
  28  * response with ERROR=1 and DATALEN=0 until a request is seen with NOT_EPOCH=0.
  29  */
  30
  31
  32
  33 #if EFSYS_OPT_SIENA
  34
  35 static const efx_mcdi_ops_t     __efx_mcdi_siena_ops = {
  36         siena_mcdi_init,                /* emco_init */
  37         siena_mcdi_send_request,        /* emco_send_request */
  38         siena_mcdi_poll_reboot,         /* emco_poll_reboot */
  39         siena_mcdi_poll_response,       /* emco_poll_response */
  40         siena_mcdi_read_response,       /* emco_read_response */
  41         siena_mcdi_fini,                /* emco_fini */
  42         siena_mcdi_feature_supported,   /* emco_feature_supported */
  43         siena_mcdi_get_timeout,         /* emco_get_timeout */
  44 };
  45
  46 #endif  /* EFSYS_OPT_SIENA */
  47
  48 #if EFSYS_OPT_HUNTINGTON || EFSYS_OPT_MEDFORD || EFSYS_OPT_MEDFORD2
  49
  50 static const efx_mcdi_ops_t     __efx_mcdi_ef10_ops = {
  51         ef10_mcdi_init,                 /* emco_init */
  52         ef10_mcdi_send_request,         /* emco_send_request */
  53         ef10_mcdi_poll_reboot,          /* emco_poll_reboot */
  54         ef10_mcdi_poll_response,        /* emco_poll_response */
  55         ef10_mcdi_read_response,        /* emco_read_response */
  56         ef10_mcdi_fini,                 /* emco_fini */
  57         ef10_mcdi_feature_supported,    /* emco_feature_supported */
  58         ef10_mcdi_get_timeout,          /* emco_get_timeout */
  59 };
  60
  61 #endif  /* EFSYS_OPT_HUNTINGTON || EFSYS_OPT_MEDFORD || EFSYS_OPT_MEDFORD2 */
  62
  63
  64
  65         __checkReturn   efx_rc_t
  66 efx_mcdi_init(
  67         __in            efx_nic_t *enp,
  68         __in            const efx_mcdi_transport_t *emtp)
  69 {
  70         const efx_mcdi_ops_t *emcop;
  71         efx_rc_t rc;
  72
  73         EFSYS_ASSERT3U(enp->en_magic, ==, EFX_NIC_MAGIC);
  74         EFSYS_ASSERT3U(enp->en_mod_flags, ==, 0);
  75
  76         switch (enp->en_family) {
  77 #if EFSYS_OPT_SIENA
  78         case EFX_FAMILY_SIENA:
  79                 emcop = &__efx_mcdi_siena_ops;
  80                 break;
  81 #endif  /* EFSYS_OPT_SIENA */
  82
  83 #if EFSYS_OPT_HUNTINGTON
  84         case EFX_FAMILY_HUNTINGTON:
  85                 emcop = &__efx_mcdi_ef10_ops;
  86                 break;
  87 #endif  /* EFSYS_OPT_HUNTINGTON */
  88
  89 #if EFSYS_OPT_MEDFORD
  90         case EFX_FAMILY_MEDFORD:
  91                 emcop = &__efx_mcdi_ef10_ops;
  92                 break;
  93 #endif  /* EFSYS_OPT_MEDFORD */
  94
  95 #if EFSYS_OPT_MEDFORD2
  96         case EFX_FAMILY_MEDFORD2:
  97                 emcop = &__efx_mcdi_ef10_ops;
  98                 break;
  99 #endif  /* EFSYS_OPT_MEDFORD2 */
 100
 101         default:
 102                 EFSYS_ASSERT(0);
 103                 rc = ENOTSUP;
 104                 goto fail1;
 105         }
 106
 107         if (enp->en_features & EFX_FEATURE_MCDI_DMA) {
 108                 /* MCDI requires a DMA buffer in host memory */
 109                 if ((emtp == NULL) || (emtp->emt_dma_mem) == NULL) {
 110                         rc = EINVAL;
 111                         goto fail2;
 112                 }
 113         }
 114         enp->en_mcdi.em_emtp = emtp;
 115
 116         if (emcop != NULL && emcop->emco_init != NULL) {
 117                 if ((rc = emcop->emco_init(enp, emtp)) != 0)
 118                         goto fail3;
 119         }
 120
 121         enp->en_mcdi.em_emcop = emcop;
 122         enp->en_mod_flags |= EFX_MOD_MCDI;
 123
 124         return (0);
 125
 126 fail3:
 127         EFSYS_PROBE(fail3);
 128 fail2:
 129         EFSYS_PROBE(fail2);
 130 fail1:
 131         EFSYS_PROBE1(fail1, efx_rc_t, rc);
 132
 133         enp->en_mcdi.em_emcop = NULL;
 134         enp->en_mcdi.em_emtp = NULL;
 135         enp->en_mod_flags &= ~EFX_MOD_MCDI;
 136
 137         return (rc);
 138 }
 139
 140                         void
 141 efx_mcdi_fini(
 142         __in            efx_nic_t *enp)
 143 {
 144         efx_mcdi_iface_t *emip = &(enp->en_mcdi.em_emip);
 145         const efx_mcdi_ops_t *emcop = enp->en_mcdi.em_emcop;
 146
 147         EFSYS_ASSERT3U(enp->en_magic, ==, EFX_NIC_MAGIC);
 148         EFSYS_ASSERT3U(enp->en_mod_flags, ==, EFX_MOD_MCDI);
 149
 150         if (emcop != NULL && emcop->emco_fini != NULL)
 151                 emcop->emco_fini(enp);
 152
 153         emip->emi_port = 0;
 154         emip->emi_aborted = 0;
 155
 156         enp->en_mcdi.em_emcop = NULL;
 157         enp->en_mod_flags &= ~EFX_MOD_MCDI;
 158 }
 159
 160                         void
 161 efx_mcdi_new_epoch(
 162         __in            efx_nic_t *enp)
 163 {
 164         efx_mcdi_iface_t *emip = &(enp->en_mcdi.em_emip);
 165         efsys_lock_state_t state;
 166
 167         /* Start a new epoch (allow fresh MCDI requests to succeed) */
 168         EFSYS_LOCK(enp->en_eslp, state);
 169         emip->emi_new_epoch = B_TRUE;
 170         EFSYS_UNLOCK(enp->en_eslp, state);
 171 }
 172
 173 static                  void
 174 efx_mcdi_send_request(
 175         __in            efx_nic_t *enp,
 176         __in            void *hdrp,
 177         __in            size_t hdr_len,
 178         __in            void *sdup,
 179         __in            size_t sdu_len)
 180 {
 181         const efx_mcdi_ops_t *emcop = enp->en_mcdi.em_emcop;
 182
 183         emcop->emco_send_request(enp, hdrp, hdr_len, sdup, sdu_len);
 184 }
 185
 186 static                  efx_rc_t
 187 efx_mcdi_poll_reboot(
 188         __in            efx_nic_t *enp)
 189 {
 190         const efx_mcdi_ops_t *emcop = enp->en_mcdi.em_emcop;
 191         efx_rc_t rc;
 192
 193         rc = emcop->emco_poll_reboot(enp);
 194         return (rc);
 195 }
 196
 197 static                  boolean_t
 198 efx_mcdi_poll_response(
 199         __in            efx_nic_t *enp)
 200 {
 201         const efx_mcdi_ops_t *emcop = enp->en_mcdi.em_emcop;
 202         boolean_t available;
 203
 204         available = emcop->emco_poll_response(enp);
 205         return (available);
 206 }
 207
 208 static                  void
 209 efx_mcdi_read_response(
 210         __in            efx_nic_t *enp,
 211         __out           void *bufferp,
 212         __in            size_t offset,
 213         __in            size_t length)
 214 {
 215         const efx_mcdi_ops_t *emcop = enp->en_mcdi.em_emcop;
 216
 217         emcop->emco_read_response(enp, bufferp, offset, length);
 218 }
 219
 220                         void
 221 efx_mcdi_request_start(
 222         __in            efx_nic_t *enp,
 223         __in            efx_mcdi_req_t *emrp,
 224         __in            boolean_t ev_cpl)
 225 {
 226 #if EFSYS_OPT_MCDI_LOGGING
 227         const efx_mcdi_transport_t *emtp = enp->en_mcdi.em_emtp;
 228 #endif
 229         efx_mcdi_iface_t *emip = &(enp->en_mcdi.em_emip);
 230         efx_dword_t hdr[2];
 231         size_t hdr_len;
 232         unsigned int max_version;
 233         unsigned int seq;
 234         unsigned int xflags;
 235         boolean_t new_epoch;
 236         efsys_lock_state_t state;
 237
 238         EFSYS_ASSERT3U(enp->en_magic, ==, EFX_NIC_MAGIC);
 239         EFSYS_ASSERT3U(enp->en_mod_flags, &, EFX_MOD_MCDI);
 240         EFSYS_ASSERT3U(enp->en_features, &, EFX_FEATURE_MCDI);
 241
 242         /*
 243          * efx_mcdi_request_start() is naturally serialised against both
 244          * efx_mcdi_request_poll() and efx_mcdi_ev_cpl()/efx_mcdi_ev_death(),
 245          * by virtue of there only being one outstanding MCDI request.
 246          * Unfortunately, upper layers may also call efx_mcdi_request_abort()
 247          * at any time, to timeout a pending mcdi request, That request may
 248          * then subsequently complete, meaning efx_mcdi_ev_cpl() or
 249          * efx_mcdi_ev_death() may end up running in parallel with
 250          * efx_mcdi_request_start(). This race is handled by ensuring that
 251          * %emi_pending_req, %emi_ev_cpl and %emi_seq are protected by the
 252          * en_eslp lock.
 253          */
 254         EFSYS_LOCK(enp->en_eslp, state);
 255         EFSYS_ASSERT(emip->emi_pending_req == NULL);
 256         emip->emi_pending_req = emrp;
 257         emip->emi_ev_cpl = ev_cpl;
 258         emip->emi_poll_cnt = 0;
 259         seq = emip->emi_seq++ & EFX_MASK32(MCDI_HEADER_SEQ);
 260         new_epoch = emip->emi_new_epoch;
 261         max_version = emip->emi_max_version;
 262         EFSYS_UNLOCK(enp->en_eslp, state);
 263
 264         xflags = 0;
 265         if (ev_cpl)
 266                 xflags |= MCDI_HEADER_XFLAGS_EVREQ;
 267
 268         /*
 269          * Huntington firmware supports MCDIv2, but the Huntington BootROM only
 270          * supports MCDIv1. Use MCDIv1 headers for MCDIv1 commands where
 271          * possible to support this.
 272          */
 273         if ((max_version >= 2) &&
 274             ((emrp->emr_cmd > MC_CMD_CMD_SPACE_ESCAPE_7) ||
 275             (emrp->emr_in_length > MCDI_CTL_SDU_LEN_MAX_V1) ||
 276             (emrp->emr_out_length > MCDI_CTL_SDU_LEN_MAX_V1))) {
 277                 /* Construct MCDI v2 header */
 278                 hdr_len = sizeof (hdr);
 279                 EFX_POPULATE_DWORD_8(hdr[0],
 280                     MCDI_HEADER_CODE, MC_CMD_V2_EXTN,
 281                     MCDI_HEADER_RESYNC, 1,
 282                     MCDI_HEADER_DATALEN, 0,
 283                     MCDI_HEADER_SEQ, seq,
 284                     MCDI_HEADER_NOT_EPOCH, new_epoch ? 0 : 1,
 285                     MCDI_HEADER_ERROR, 0,
 286                     MCDI_HEADER_RESPONSE, 0,
 287                     MCDI_HEADER_XFLAGS, xflags);
 288
 289                 EFX_POPULATE_DWORD_2(hdr[1],
 290                     MC_CMD_V2_EXTN_IN_EXTENDED_CMD, emrp->emr_cmd,
 291                     MC_CMD_V2_EXTN_IN_ACTUAL_LEN, emrp->emr_in_length);
 292         } else {
 293                 /* Construct MCDI v1 header */
 294                 hdr_len = sizeof (hdr[0]);
 295                 EFX_POPULATE_DWORD_8(hdr[0],
 296                     MCDI_HEADER_CODE, emrp->emr_cmd,
 297                     MCDI_HEADER_RESYNC, 1,
 298                     MCDI_HEADER_DATALEN, emrp->emr_in_length,
 299                     MCDI_HEADER_SEQ, seq,
 300                     MCDI_HEADER_NOT_EPOCH, new_epoch ? 0 : 1,
 301                     MCDI_HEADER_ERROR, 0,
 302                     MCDI_HEADER_RESPONSE, 0,
 303                     MCDI_HEADER_XFLAGS, xflags);
 304         }
 305
 306 #if EFSYS_OPT_MCDI_LOGGING
 307         if (emtp->emt_logger != NULL) {
 308                 emtp->emt_logger(emtp->emt_context, EFX_LOG_MCDI_REQUEST,
 309                     &hdr[0], hdr_len,
 310                     emrp->emr_in_buf, emrp->emr_in_length);
 311         }
 312 #endif /* EFSYS_OPT_MCDI_LOGGING */
 313
 314         efx_mcdi_send_request(enp, &hdr[0], hdr_len,
 315             emrp->emr_in_buf, emrp->emr_in_length);
 316 }
 317
 318
 319 static                  void
 320 efx_mcdi_read_response_header(
 321         __in            efx_nic_t *enp,
 322         __inout         efx_mcdi_req_t *emrp)
 323 {
 324 #if EFSYS_OPT_MCDI_LOGGING
 325         const efx_mcdi_transport_t *emtp = enp->en_mcdi.em_emtp;
 326 #endif /* EFSYS_OPT_MCDI_LOGGING */
 327         efx_mcdi_iface_t *emip = &(enp->en_mcdi.em_emip);
 328         efx_dword_t hdr[2];
 329         unsigned int hdr_len;
 330         unsigned int data_len;
 331         unsigned int seq;
 332         unsigned int cmd;
 333         unsigned int error;
 334         efx_rc_t rc;
 335
 336         EFSYS_ASSERT(emrp != NULL);
 337
 338         efx_mcdi_read_response(enp, &hdr[0], 0, sizeof (hdr[0]));
 339         hdr_len = sizeof (hdr[0]);
 340
 341         cmd = EFX_DWORD_FIELD(hdr[0], MCDI_HEADER_CODE);
 342         seq = EFX_DWORD_FIELD(hdr[0], MCDI_HEADER_SEQ);
 343         error = EFX_DWORD_FIELD(hdr[0], MCDI_HEADER_ERROR);
 344
 345         if (cmd != MC_CMD_V2_EXTN) {
 346                 data_len = EFX_DWORD_FIELD(hdr[0], MCDI_HEADER_DATALEN);
 347         } else {
 348                 efx_mcdi_read_response(enp, &hdr[1], hdr_len, sizeof (hdr[1]));
 349                 hdr_len += sizeof (hdr[1]);
 350
 351                 cmd = EFX_DWORD_FIELD(hdr[1], MC_CMD_V2_EXTN_IN_EXTENDED_CMD);
 352                 data_len =
 353                     EFX_DWORD_FIELD(hdr[1], MC_CMD_V2_EXTN_IN_ACTUAL_LEN);
 354         }
 355
 356         if (error && (data_len == 0)) {
 357                 /* The MC has rebooted since the request was sent. */
 358                 EFSYS_SPIN(EFX_MCDI_STATUS_SLEEP_US);
 359                 efx_mcdi_poll_reboot(enp);
 360                 rc = EIO;
 361                 goto fail1;
 362         }
 363         if ((cmd != emrp->emr_cmd) ||
 364             (seq != ((emip->emi_seq - 1) & EFX_MASK32(MCDI_HEADER_SEQ)))) {
 365                 /* Response is for a different request */
 366                 rc = EIO;
 367                 goto fail2;
 368         }
 369         if (error) {
 370                 efx_dword_t err[2];
 371                 unsigned int err_len = MIN(data_len, sizeof (err));
 372                 int err_code = MC_CMD_ERR_EPROTO;
 373                 int err_arg = 0;
 374
 375                 /* Read error code (and arg num for MCDI v2 commands) */
 376                 efx_mcdi_read_response(enp, &err, hdr_len, err_len);
 377
 378                 if (err_len >= (MC_CMD_ERR_CODE_OFST + sizeof (efx_dword_t)))
 379                         err_code = EFX_DWORD_FIELD(err[0], EFX_DWORD_0);
 380 #ifdef WITH_MCDI_V2
 381                 if (err_len >= (MC_CMD_ERR_ARG_OFST + sizeof (efx_dword_t)))
 382                         err_arg = EFX_DWORD_FIELD(err[1], EFX_DWORD_0);
 383 #endif
 384                 emrp->emr_err_code = err_code;
 385                 emrp->emr_err_arg = err_arg;
 386
 387 #if EFSYS_OPT_MCDI_PROXY_AUTH
 388                 if ((err_code == MC_CMD_ERR_PROXY_PENDING) &&
 389                     (err_len == sizeof (err))) {
 390                         /*
 391                          * The MCDI request would normally fail with EPERM, but
 392                          * firmware has forwarded it to an authorization agent
 393                          * attached to a privileged PF.
 394                          *
 395                          * Save the authorization request handle. The client
 396                          * must wait for a PROXY_RESPONSE event, or timeout.
 397                          */
 398                         emrp->emr_proxy_handle = err_arg;
 399                 }
 400 #endif /* EFSYS_OPT_MCDI_PROXY_AUTH */
 401
 402 #if EFSYS_OPT_MCDI_LOGGING
 403                 if (emtp->emt_logger != NULL) {
 404                         emtp->emt_logger(emtp->emt_context,
 405                             EFX_LOG_MCDI_RESPONSE,
 406                             &hdr[0], hdr_len,
 407                             &err[0], err_len);
 408                 }
 409 #endif /* EFSYS_OPT_MCDI_LOGGING */
 410
 411                 if (!emrp->emr_quiet) {
 412                         EFSYS_PROBE3(mcdi_err_arg, int, emrp->emr_cmd,
 413                             int, err_code, int, err_arg);
 414                 }
 415
 416                 rc = efx_mcdi_request_errcode(err_code);
 417                 goto fail3;
 418         }
 419
 420         emrp->emr_rc = 0;
 421         emrp->emr_out_length_used = data_len;
 422 #if EFSYS_OPT_MCDI_PROXY_AUTH
 423         emrp->emr_proxy_handle = 0;
 424 #endif /* EFSYS_OPT_MCDI_PROXY_AUTH */
 425         return;
 426
 427 fail3:
 428 fail2:
 429 fail1:
 430         emrp->emr_rc = rc;
 431         emrp->emr_out_length_used = 0;
 432 }
 433
 434 static                  void
 435 efx_mcdi_finish_response(
 436         __in            efx_nic_t *enp,
 437         __in            efx_mcdi_req_t *emrp)
 438 {
 439 #if EFSYS_OPT_MCDI_LOGGING
 440         const efx_mcdi_transport_t *emtp = enp->en_mcdi.em_emtp;
 441 #endif /* EFSYS_OPT_MCDI_LOGGING */
 442         efx_dword_t hdr[2];
 443         unsigned int hdr_len;
 444         size_t bytes;
 445
 446         if (emrp->emr_out_buf == NULL)
 447                 return;
 448
 449         /* Read the command header to detect MCDI response format */
 450         hdr_len = sizeof (hdr[0]);
 451         efx_mcdi_read_response(enp, &hdr[0], 0, hdr_len);
 452         if (EFX_DWORD_FIELD(hdr[0], MCDI_HEADER_CODE) == MC_CMD_V2_EXTN) {
 453                 /*
 454                  * Read the actual payload length. The length given in the event
 455                  * is only correct for responses with the V1 format.
 456                  */
 457                 efx_mcdi_read_response(enp, &hdr[1], hdr_len, sizeof (hdr[1]));
 458                 hdr_len += sizeof (hdr[1]);
 459
 460                 emrp->emr_out_length_used = EFX_DWORD_FIELD(hdr[1],
 461                                             MC_CMD_V2_EXTN_IN_ACTUAL_LEN);
 462         }
 463
 464         /* Copy payload out into caller supplied buffer */
 465         bytes = MIN(emrp->emr_out_length_used, emrp->emr_out_length);
 466         efx_mcdi_read_response(enp, emrp->emr_out_buf, hdr_len, bytes);
 467
 468 #if EFSYS_OPT_MCDI_LOGGING
 469         if (emtp->emt_logger != NULL) {
 470                 emtp->emt_logger(emtp->emt_context,
 471                     EFX_LOG_MCDI_RESPONSE,
 472                     &hdr[0], hdr_len,
 473                     emrp->emr_out_buf, bytes);
 474         }
 475 #endif /* EFSYS_OPT_MCDI_LOGGING */
 476 }
 477
 478
 479         __checkReturn   boolean_t
 480 efx_mcdi_request_poll(
 481         __in            efx_nic_t *enp)
 482 {
 483         efx_mcdi_iface_t *emip = &(enp->en_mcdi.em_emip);
 484         efx_mcdi_req_t *emrp;
 485         efsys_lock_state_t state;
 486         efx_rc_t rc;
 487
 488         EFSYS_ASSERT3U(enp->en_magic, ==, EFX_NIC_MAGIC);
 489         EFSYS_ASSERT3U(enp->en_mod_flags, &, EFX_MOD_MCDI);
 490         EFSYS_ASSERT3U(enp->en_features, &, EFX_FEATURE_MCDI);
 491
 492         /* Serialise against post-watchdog efx_mcdi_ev* */
 493         EFSYS_LOCK(enp->en_eslp, state);
 494
 495         EFSYS_ASSERT(emip->emi_pending_req != NULL);
 496         EFSYS_ASSERT(!emip->emi_ev_cpl);
 497         emrp = emip->emi_pending_req;
 498
 499         /* Check for reboot atomically w.r.t efx_mcdi_request_start */
 500         if (emip->emi_poll_cnt++ == 0) {
 501                 if ((rc = efx_mcdi_poll_reboot(enp)) != 0) {
 502                         emip->emi_pending_req = NULL;
 503                         EFSYS_UNLOCK(enp->en_eslp, state);
 504
 505                         /* Reboot/Assertion */
 506                         if (rc == EIO || rc == EINTR)
 507                                 efx_mcdi_raise_exception(enp, emrp, rc);
 508
 509                         goto fail1;
 510                 }
 511         }
 512
 513         /* Check if a response is available */
 514         if (efx_mcdi_poll_response(enp) == B_FALSE) {
 515                 EFSYS_UNLOCK(enp->en_eslp, state);
 516                 return (B_FALSE);
 517         }
 518
 519         /* Read the response header */
 520         efx_mcdi_read_response_header(enp, emrp);
 521
 522         /* Request complete */
 523         emip->emi_pending_req = NULL;
 524
 525         /* Ensure stale MCDI requests fail after an MC reboot. */
 526         emip->emi_new_epoch = B_FALSE;
 527
 528         EFSYS_UNLOCK(enp->en_eslp, state);
 529
 530         if ((rc = emrp->emr_rc) != 0)
 531                 goto fail2;
 532
 533         efx_mcdi_finish_response(enp, emrp);
 534         return (B_TRUE);
 535
 536 fail2:
 537         if (!emrp->emr_quiet)
 538                 EFSYS_PROBE(fail2);
 539 fail1:
 540         if (!emrp->emr_quiet)
 541                 EFSYS_PROBE1(fail1, efx_rc_t, rc);
 542
 543         return (B_TRUE);
 544 }
 545
 546         __checkReturn   boolean_t
 547 efx_mcdi_request_abort(
 548         __in            efx_nic_t *enp)
 549 {
 550         efx_mcdi_iface_t *emip = &(enp->en_mcdi.em_emip);
 551         efx_mcdi_req_t *emrp;
 552         boolean_t aborted;
 553         efsys_lock_state_t state;
 554
 555         EFSYS_ASSERT3U(enp->en_magic, ==, EFX_NIC_MAGIC);
 556         EFSYS_ASSERT3U(enp->en_mod_flags, &, EFX_MOD_MCDI);
 557         EFSYS_ASSERT3U(enp->en_features, &, EFX_FEATURE_MCDI);
 558
 559         /*
 560          * efx_mcdi_ev_* may have already completed this event, and be
 561          * spinning/blocked on the upper layer lock. So it *is* legitimate
 562          * to for emi_pending_req to be NULL. If there is a pending event
 563          * completed request, then provide a "credit" to allow
 564          * efx_mcdi_ev_cpl() to accept a single spurious completion.
 565          */
 566         EFSYS_LOCK(enp->en_eslp, state);
 567         emrp = emip->emi_pending_req;
 568         aborted = (emrp != NULL);
 569         if (aborted) {
 570                 emip->emi_pending_req = NULL;
 571
 572                 /* Error the request */
 573                 emrp->emr_out_length_used = 0;
 574                 emrp->emr_rc = ETIMEDOUT;
 575
 576                 /* Provide a credit for seqno/emr_pending_req mismatches */
 577                 if (emip->emi_ev_cpl)
 578                         ++emip->emi_aborted;
 579
 580                 /*
 581                  * The upper layer has called us, so we don't
 582                  * need to complete the request.
 583                  */
 584         }
 585         EFSYS_UNLOCK(enp->en_eslp, state);
 586
 587         return (aborted);
 588 }
 589
 590                         void
 591 efx_mcdi_get_timeout(
 592         __in            efx_nic_t *enp,
 593         __in            efx_mcdi_req_t *emrp,
 594         __out           uint32_t *timeoutp)
 595 {
 596         const efx_mcdi_ops_t *emcop = enp->en_mcdi.em_emcop;
 597
 598         emcop->emco_get_timeout(enp, emrp, timeoutp);
 599 }
 600
 601         __checkReturn   efx_rc_t
 602 efx_mcdi_request_errcode(
 603         __in            unsigned int err)
 604 {
 605
 606         switch (err) {
 607                 /* MCDI v1 */
 608         case MC_CMD_ERR_EPERM:
 609                 return (EACCES);
 610         case MC_CMD_ERR_ENOENT:
 611                 return (ENOENT);
 612         case MC_CMD_ERR_EINTR:
 613                 return (EINTR);
 614         case MC_CMD_ERR_EACCES:
 615                 return (EACCES);
 616         case MC_CMD_ERR_EBUSY:
 617                 return (EBUSY);
 618         case MC_CMD_ERR_EINVAL:
 619                 return (EINVAL);
 620         case MC_CMD_ERR_EDEADLK:
 621                 return (EDEADLK);
 622         case MC_CMD_ERR_ENOSYS:
 623                 return (ENOTSUP);
 624         case MC_CMD_ERR_ETIME:
 625                 return (ETIMEDOUT);
 626         case MC_CMD_ERR_ENOTSUP:
 627                 return (ENOTSUP);
 628         case MC_CMD_ERR_EALREADY:
 629                 return (EALREADY);
 630
 631                 /* MCDI v2 */
 632         case MC_CMD_ERR_EEXIST:
 633                 return (EEXIST);
 634 #ifdef MC_CMD_ERR_EAGAIN
 635         case MC_CMD_ERR_EAGAIN:
 636                 return (EAGAIN);
 637 #endif
 638 #ifdef MC_CMD_ERR_ENOSPC
 639         case MC_CMD_ERR_ENOSPC:
 640                 return (ENOSPC);
 641 #endif
 642         case MC_CMD_ERR_ERANGE:
 643                 return (ERANGE);
 644
 645         case MC_CMD_ERR_ALLOC_FAIL:
 646                 return (ENOMEM);
 647         case MC_CMD_ERR_NO_VADAPTOR:
 648                 return (ENOENT);
 649         case MC_CMD_ERR_NO_EVB_PORT:
 650                 return (ENOENT);
 651         case MC_CMD_ERR_NO_VSWITCH:
 652                 return (ENODEV);
 653         case MC_CMD_ERR_VLAN_LIMIT:
 654                 return (EINVAL);
 655         case MC_CMD_ERR_BAD_PCI_FUNC:
 656                 return (ENODEV);
 657         case MC_CMD_ERR_BAD_VLAN_MODE:
 658                 return (EINVAL);
 659         case MC_CMD_ERR_BAD_VSWITCH_TYPE:
 660                 return (EINVAL);
 661         case MC_CMD_ERR_BAD_VPORT_TYPE:
 662                 return (EINVAL);
 663         case MC_CMD_ERR_MAC_EXIST:
 664                 return (EEXIST);
 665
 666         case MC_CMD_ERR_PROXY_PENDING:
 667                 return (EAGAIN);
 668
 669         default:
 670                 EFSYS_PROBE1(mc_pcol_error, int, err);
 671                 return (EIO);
 672         }
 673 }
 674
 675                         void
 676 efx_mcdi_raise_exception(
 677         __in            efx_nic_t *enp,
 678         __in_opt        efx_mcdi_req_t *emrp,
 679         __in            int rc)
 680 {
 681         const efx_mcdi_transport_t *emtp = enp->en_mcdi.em_emtp;
 682         efx_mcdi_exception_t exception;
 683
 684         /* Reboot or Assertion failure only */
 685         EFSYS_ASSERT(rc == EIO || rc == EINTR);
 686
 687         /*
 688          * If MC_CMD_REBOOT causes a reboot (dependent on parameters),
 689          * then the EIO is not worthy of an exception.
 690          */
 691         if (emrp != NULL && emrp->emr_cmd == MC_CMD_REBOOT && rc == EIO)
 692                 return;
 693
 694         exception = (rc == EIO)
 695                 ? EFX_MCDI_EXCEPTION_MC_REBOOT
 696                 : EFX_MCDI_EXCEPTION_MC_BADASSERT;
 697
 698         emtp->emt_exception(emtp->emt_context, exception);
 699 }
 700
 701                         void
 702 efx_mcdi_execute(
 703         __in            efx_nic_t *enp,
 704         __inout         efx_mcdi_req_t *emrp)
 705 {
 706         const efx_mcdi_transport_t *emtp = enp->en_mcdi.em_emtp;
 707
 708         EFSYS_ASSERT3U(enp->en_mod_flags, &, EFX_MOD_MCDI);
 709         EFSYS_ASSERT3U(enp->en_features, &, EFX_FEATURE_MCDI);
 710
 711         emrp->emr_quiet = B_FALSE;
 712         emtp->emt_execute(emtp->emt_context, emrp);
 713 }
 714
 715                         void
 716 efx_mcdi_execute_quiet(
 717         __in            efx_nic_t *enp,
 718         __inout         efx_mcdi_req_t *emrp)
 719 {
 720         const efx_mcdi_transport_t *emtp = enp->en_mcdi.em_emtp;
 721
 722         EFSYS_ASSERT3U(enp->en_mod_flags, &, EFX_MOD_MCDI);
 723         EFSYS_ASSERT3U(enp->en_features, &, EFX_FEATURE_MCDI);
 724
 725         emrp->emr_quiet = B_TRUE;
 726         emtp->emt_execute(emtp->emt_context, emrp);
 727 }
 728
 729                         void
 730 efx_mcdi_ev_cpl(
 731         __in            efx_nic_t *enp,
 732         __in            unsigned int seq,
 733         __in            unsigned int outlen,
 734         __in            int errcode)
 735 {
 736         efx_mcdi_iface_t *emip = &(enp->en_mcdi.em_emip);
 737         const efx_mcdi_transport_t *emtp = enp->en_mcdi.em_emtp;
 738         efx_mcdi_req_t *emrp;
 739         efsys_lock_state_t state;
 740
 741         EFSYS_ASSERT3U(enp->en_mod_flags, &, EFX_MOD_MCDI);
 742         EFSYS_ASSERT3U(enp->en_features, &, EFX_FEATURE_MCDI);
 743
 744         /*
 745          * Serialise against efx_mcdi_request_poll()/efx_mcdi_request_start()
 746          * when we're completing an aborted request.
 747          */
 748         EFSYS_LOCK(enp->en_eslp, state);
 749         if (emip->emi_pending_req == NULL || !emip->emi_ev_cpl ||
 750             (seq != ((emip->emi_seq - 1) & EFX_MASK32(MCDI_HEADER_SEQ)))) {
 751                 EFSYS_ASSERT(emip->emi_aborted > 0);
 752                 if (emip->emi_aborted > 0)
 753                         --emip->emi_aborted;
 754                 EFSYS_UNLOCK(enp->en_eslp, state);
 755                 return;
 756         }
 757
 758         emrp = emip->emi_pending_req;
 759         emip->emi_pending_req = NULL;
 760         EFSYS_UNLOCK(enp->en_eslp, state);
 761
 762         if (emip->emi_max_version >= 2) {
 763                 /* MCDIv2 response details do not fit into an event. */
 764                 efx_mcdi_read_response_header(enp, emrp);
 765         } else {
 766                 if (errcode != 0) {
 767                         if (!emrp->emr_quiet) {
 768                                 EFSYS_PROBE2(mcdi_err, int, emrp->emr_cmd,
 769                                     int, errcode);
 770                         }
 771                         emrp->emr_out_length_used = 0;
 772                         emrp->emr_rc = efx_mcdi_request_errcode(errcode);
 773                 } else {
 774                         emrp->emr_out_length_used = outlen;
 775                         emrp->emr_rc = 0;
 776                 }
 777         }
 778         if (emrp->emr_rc == 0)
 779                 efx_mcdi_finish_response(enp, emrp);
 780
 781         emtp->emt_ev_cpl(emtp->emt_context);
 782 }
 783
 784 #if EFSYS_OPT_MCDI_PROXY_AUTH
 785
 786         __checkReturn   efx_rc_t
 787 efx_mcdi_get_proxy_handle(
 788         __in            efx_nic_t *enp,
 789         __in            efx_mcdi_req_t *emrp,
 790         __out           uint32_t *handlep)
 791 {
 792         efx_rc_t rc;
 793
 794         _NOTE(ARGUNUSED(enp))
 795
 796         /*
 797          * Return proxy handle from MCDI request that returned with error
 798          * MC_MCD_ERR_PROXY_PENDING. This handle is used to wait for a matching
 799          * PROXY_RESPONSE event.
 800          */
 801         if ((emrp == NULL) || (handlep == NULL)) {
 802                 rc = EINVAL;
 803                 goto fail1;
 804         }
 805         if ((emrp->emr_rc != 0) &&
 806             (emrp->emr_err_code == MC_CMD_ERR_PROXY_PENDING)) {
 807                 *handlep = emrp->emr_proxy_handle;
 808                 rc = 0;
 809         } else {
 810                 *handlep = 0;
 811                 rc = ENOENT;
 812         }
 813         return (rc);
 814
 815 fail1:
 816         EFSYS_PROBE1(fail1, efx_rc_t, rc);
 817         return (rc);
 818 }
 819
 820                         void
 821 efx_mcdi_ev_proxy_response(
 822         __in            efx_nic_t *enp,
 823         __in            unsigned int handle,
 824         __in            unsigned int status)
 825 {
 826         const efx_mcdi_transport_t *emtp = enp->en_mcdi.em_emtp;
 827         efx_rc_t rc;
 828
 829         /*
 830          * Handle results of an authorization request for a privileged MCDI
 831          * command. If authorization was granted then we must re-issue the
 832          * original MCDI request. If authorization failed or timed out,
 833          * then the original MCDI request should be completed with the
 834          * result code from this event.
 835          */
 836         rc = (status == 0) ? 0 : efx_mcdi_request_errcode(status);
 837
 838         emtp->emt_ev_proxy_response(emtp->emt_context, handle, rc);
 839 }
 840 #endif /* EFSYS_OPT_MCDI_PROXY_AUTH */
 841
 842                         void
 843 efx_mcdi_ev_death(
 844         __in            efx_nic_t *enp,
 845         __in            int rc)
 846 {
 847         efx_mcdi_iface_t *emip = &(enp->en_mcdi.em_emip);
 848         const efx_mcdi_transport_t *emtp = enp->en_mcdi.em_emtp;
 849         efx_mcdi_req_t *emrp = NULL;
 850         boolean_t ev_cpl;
 851         efsys_lock_state_t state;
 852
 853         /*
 854          * The MCDI request (if there is one) has been terminated, either
 855          * by a BADASSERT or REBOOT event.
 856          *
 857          * If there is an outstanding event-completed MCDI operation, then we
 858          * will never receive the completion event (because both MCDI
 859          * completions and BADASSERT events are sent to the same evq). So
 860          * complete this MCDI op.
 861          *
 862          * This function might run in parallel with efx_mcdi_request_poll()
 863          * for poll completed mcdi requests, and also with
 864          * efx_mcdi_request_start() for post-watchdog completions.
 865          */
 866         EFSYS_LOCK(enp->en_eslp, state);
 867         emrp = emip->emi_pending_req;
 868         ev_cpl = emip->emi_ev_cpl;
 869         if (emrp != NULL && emip->emi_ev_cpl) {
 870                 emip->emi_pending_req = NULL;
 871
 872                 emrp->emr_out_length_used = 0;
 873                 emrp->emr_rc = rc;
 874                 ++emip->emi_aborted;
 875         }
 876
 877         /*
 878          * Since we're running in parallel with a request, consume the
 879          * status word before dropping the lock.
 880          */
 881         if (rc == EIO || rc == EINTR) {
 882                 EFSYS_SPIN(EFX_MCDI_STATUS_SLEEP_US);
 883                 (void) efx_mcdi_poll_reboot(enp);
 884                 emip->emi_new_epoch = B_TRUE;
 885         }
 886
 887         EFSYS_UNLOCK(enp->en_eslp, state);
 888
 889         efx_mcdi_raise_exception(enp, emrp, rc);
 890
 891         if (emrp != NULL && ev_cpl)
 892                 emtp->emt_ev_cpl(emtp->emt_context);
 893 }
 894
 895         __checkReturn           efx_rc_t
 896 efx_mcdi_version(
 897         __in                    efx_nic_t *enp,
 898         __out_ecount_opt(4)     uint16_t versionp[4],
 899         __out_opt               uint32_t *buildp,
 900         __out_opt               efx_mcdi_boot_t *statusp)
 901 {
 902         efx_mcdi_req_t req;
 903         uint8_t payload[MAX(MAX(MC_CMD_GET_VERSION_IN_LEN,
 904                                 MC_CMD_GET_VERSION_OUT_LEN),
 905                             MAX(MC_CMD_GET_BOOT_STATUS_IN_LEN,
 906                                 MC_CMD_GET_BOOT_STATUS_OUT_LEN))];
 907         efx_word_t *ver_words;
 908         uint16_t version[4];
 909         uint32_t build;
 910         efx_mcdi_boot_t status;
 911         efx_rc_t rc;
 912
 913         EFSYS_ASSERT3U(enp->en_features, &, EFX_FEATURE_MCDI);
 914
 915         (void) memset(payload, 0, sizeof (payload));
 916         req.emr_cmd = MC_CMD_GET_VERSION;
 917         req.emr_in_buf = payload;
 918         req.emr_in_length = MC_CMD_GET_VERSION_IN_LEN;
 919         req.emr_out_buf = payload;
 920         req.emr_out_length = MC_CMD_GET_VERSION_OUT_LEN;
 921
 922         efx_mcdi_execute(enp, &req);
 923
 924         if (req.emr_rc != 0) {
 925                 rc = req.emr_rc;
 926                 goto fail1;
 927         }
 928
 929         /* bootrom support */
 930         if (req.emr_out_length_used == MC_CMD_GET_VERSION_V0_OUT_LEN) {
 931                 version[0] = version[1] = version[2] = version[3] = 0;
 932                 build = MCDI_OUT_DWORD(req, GET_VERSION_OUT_FIRMWARE);
 933
 934                 goto version;
 935         }
 936
 937         if (req.emr_out_length_used < MC_CMD_GET_VERSION_OUT_LEN) {
 938                 rc = EMSGSIZE;
 939                 goto fail2;
 940         }
 941
 942         ver_words = MCDI_OUT2(req, efx_word_t, GET_VERSION_OUT_VERSION);
 943         version[0] = EFX_WORD_FIELD(ver_words[0], EFX_WORD_0);
 944         version[1] = EFX_WORD_FIELD(ver_words[1], EFX_WORD_0);
 945         version[2] = EFX_WORD_FIELD(ver_words[2], EFX_WORD_0);
 946         version[3] = EFX_WORD_FIELD(ver_words[3], EFX_WORD_0);
 947         build = MCDI_OUT_DWORD(req, GET_VERSION_OUT_FIRMWARE);
 948
 949 version:
 950         /* The bootrom doesn't understand BOOT_STATUS */
 951         if (MC_FW_VERSION_IS_BOOTLOADER(build)) {
 952                 status = EFX_MCDI_BOOT_ROM;
 953                 goto out;
 954         }
 955
 956         (void) memset(payload, 0, sizeof (payload));
 957         req.emr_cmd = MC_CMD_GET_BOOT_STATUS;
 958         req.emr_in_buf = payload;
 959         req.emr_in_length = MC_CMD_GET_BOOT_STATUS_IN_LEN;
 960         req.emr_out_buf = payload;
 961         req.emr_out_length = MC_CMD_GET_BOOT_STATUS_OUT_LEN;
 962
 963         efx_mcdi_execute_quiet(enp, &req);
 964
 965         if (req.emr_rc == EACCES) {
 966                 /* Unprivileged functions cannot access BOOT_STATUS */
 967                 status = EFX_MCDI_BOOT_PRIMARY;
 968                 version[0] = version[1] = version[2] = version[3] = 0;
 969                 build = 0;
 970                 goto out;
 971         }
 972
 973         if (req.emr_rc != 0) {
 974                 rc = req.emr_rc;
 975                 goto fail3;
 976         }
 977
 978         if (req.emr_out_length_used < MC_CMD_GET_BOOT_STATUS_OUT_LEN) {
 979                 rc = EMSGSIZE;
 980                 goto fail4;
 981         }
 982
 983         if (MCDI_OUT_DWORD_FIELD(req, GET_BOOT_STATUS_OUT_FLAGS,
 984             GET_BOOT_STATUS_OUT_FLAGS_PRIMARY))
 985                 status = EFX_MCDI_BOOT_PRIMARY;
 986         else
 987                 status = EFX_MCDI_BOOT_SECONDARY;
 988
 989 out:
 990         if (versionp != NULL)
 991                 memcpy(versionp, version, sizeof (version));
 992         if (buildp != NULL)
 993                 *buildp = build;
 994         if (statusp != NULL)
 995                 *statusp = status;
 996
 997         return (0);
 998
 999 fail4:
1000         EFSYS_PROBE(fail4);
1001 fail3:
1002         EFSYS_PROBE(fail3);
1003 fail2:
1004         EFSYS_PROBE(fail2);
1005 fail1:
1006         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1007
1008         return (rc);
1009 }
1010
1011         __checkReturn   efx_rc_t
1012 efx_mcdi_get_capabilities(
1013         __in            efx_nic_t *enp,
1014         __out_opt       uint32_t *flagsp,
1015         __out_opt       uint16_t *rx_dpcpu_fw_idp,
1016         __out_opt       uint16_t *tx_dpcpu_fw_idp,
1017         __out_opt       uint32_t *flags2p,
1018         __out_opt       uint32_t *tso2ncp)
1019 {
1020         efx_mcdi_req_t req;
1021         uint8_t payload[MAX(MC_CMD_GET_CAPABILITIES_IN_LEN,
1022                             MC_CMD_GET_CAPABILITIES_V2_OUT_LEN)];
1023         boolean_t v2_capable;
1024         efx_rc_t rc;
1025
1026         (void) memset(payload, 0, sizeof (payload));
1027         req.emr_cmd = MC_CMD_GET_CAPABILITIES;
1028         req.emr_in_buf = payload;
1029         req.emr_in_length = MC_CMD_GET_CAPABILITIES_IN_LEN;
1030         req.emr_out_buf = payload;
1031         req.emr_out_length = MC_CMD_GET_CAPABILITIES_V2_OUT_LEN;
1032
1033         efx_mcdi_execute_quiet(enp, &req);
1034
1035         if (req.emr_rc != 0) {
1036                 rc = req.emr_rc;
1037                 goto fail1;
1038         }
1039
1040         if (req.emr_out_length_used < MC_CMD_GET_CAPABILITIES_OUT_LEN) {
1041                 rc = EMSGSIZE;
1042                 goto fail2;
1043         }
1044
1045         if (flagsp != NULL)
1046                 *flagsp = MCDI_OUT_DWORD(req, GET_CAPABILITIES_OUT_FLAGS1);
1047
1048         if (rx_dpcpu_fw_idp != NULL)
1049                 *rx_dpcpu_fw_idp = MCDI_OUT_WORD(req,
1050                                         GET_CAPABILITIES_OUT_RX_DPCPU_FW_ID);
1051
1052         if (tx_dpcpu_fw_idp != NULL)
1053                 *tx_dpcpu_fw_idp = MCDI_OUT_WORD(req,
1054                                         GET_CAPABILITIES_OUT_TX_DPCPU_FW_ID);
1055
1056         if (req.emr_out_length_used < MC_CMD_GET_CAPABILITIES_V2_OUT_LEN)
1057                 v2_capable = B_FALSE;
1058         else
1059                 v2_capable = B_TRUE;
1060
1061         if (flags2p != NULL) {
1062                 *flags2p = (v2_capable) ?
1063                         MCDI_OUT_DWORD(req, GET_CAPABILITIES_V2_OUT_FLAGS2) :
1064                         0;
1065         }
1066
1067         if (tso2ncp != NULL) {
1068                 *tso2ncp = (v2_capable) ?
1069                         MCDI_OUT_WORD(req,
1070                                 GET_CAPABILITIES_V2_OUT_TX_TSO_V2_N_CONTEXTS) :
1071                         0;
1072         }
1073
1074         return (0);
1075
1076 fail2:
1077         EFSYS_PROBE(fail2);
1078 fail1:
1079         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1080
1081         return (rc);
1082 }
1083
1084 static  __checkReturn   efx_rc_t
1085 efx_mcdi_do_reboot(
1086         __in            efx_nic_t *enp,
1087         __in            boolean_t after_assertion)
1088 {
1089         uint8_t payload[MAX(MC_CMD_REBOOT_IN_LEN, MC_CMD_REBOOT_OUT_LEN)];
1090         efx_mcdi_req_t req;
1091         efx_rc_t rc;
1092
1093         /*
1094          * We could require the caller to have caused en_mod_flags=0 to
1095          * call this function. This doesn't help the other port though,
1096          * who's about to get the MC ripped out from underneath them.
1097          * Since they have to cope with the subsequent fallout of MCDI
1098          * failures, we should as well.
1099          */
1100         EFSYS_ASSERT3U(enp->en_magic, ==, EFX_NIC_MAGIC);
1101
1102         (void) memset(payload, 0, sizeof (payload));
1103         req.emr_cmd = MC_CMD_REBOOT;
1104         req.emr_in_buf = payload;
1105         req.emr_in_length = MC_CMD_REBOOT_IN_LEN;
1106         req.emr_out_buf = payload;
1107         req.emr_out_length = MC_CMD_REBOOT_OUT_LEN;
1108
1109         MCDI_IN_SET_DWORD(req, REBOOT_IN_FLAGS,
1110             (after_assertion ? MC_CMD_REBOOT_FLAGS_AFTER_ASSERTION : 0));
1111
1112         efx_mcdi_execute_quiet(enp, &req);
1113
1114         if (req.emr_rc == EACCES) {
1115                 /* Unprivileged functions cannot reboot the MC. */
1116                 goto out;
1117         }
1118
1119         /* A successful reboot request returns EIO. */
1120         if (req.emr_rc != 0 && req.emr_rc != EIO) {
1121                 rc = req.emr_rc;
1122                 goto fail1;
1123         }
1124
1125 out:
1126         return (0);
1127
1128 fail1:
1129         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1130
1131         return (rc);
1132 }
1133
1134         __checkReturn   efx_rc_t
1135 efx_mcdi_reboot(
1136         __in            efx_nic_t *enp)
1137 {
1138         return (efx_mcdi_do_reboot(enp, B_FALSE));
1139 }
1140
1141         __checkReturn   efx_rc_t
1142 efx_mcdi_exit_assertion_handler(
1143         __in            efx_nic_t *enp)
1144 {
1145         return (efx_mcdi_do_reboot(enp, B_TRUE));
1146 }
1147
1148         __checkReturn   efx_rc_t
1149 efx_mcdi_read_assertion(
1150         __in            efx_nic_t *enp)
1151 {
1152         efx_mcdi_req_t req;
1153         uint8_t payload[MAX(MC_CMD_GET_ASSERTS_IN_LEN,
1154                             MC_CMD_GET_ASSERTS_OUT_LEN)];
1155         const char *reason;
1156         unsigned int flags;
1157         unsigned int index;
1158         unsigned int ofst;
1159         int retry;
1160         efx_rc_t rc;
1161
1162         /*
1163          * Before we attempt to chat to the MC, we should verify that the MC
1164          * isn't in it's assertion handler, either due to a previous reboot,
1165          * or because we're reinitializing due to an eec_exception().
1166          *
1167          * Use GET_ASSERTS to read any assertion state that may be present.
1168          * Retry this command twice. Once because a boot-time assertion failure
1169          * might cause the 1st MCDI request to fail. And once again because
1170          * we might race with efx_mcdi_exit_assertion_handler() running on
1171          * partner port(s) on the same NIC.
1172          */
1173         retry = 2;
1174         do {
1175                 (void) memset(payload, 0, sizeof (payload));
1176                 req.emr_cmd = MC_CMD_GET_ASSERTS;
1177                 req.emr_in_buf = payload;
1178                 req.emr_in_length = MC_CMD_GET_ASSERTS_IN_LEN;
1179                 req.emr_out_buf = payload;
1180                 req.emr_out_length = MC_CMD_GET_ASSERTS_OUT_LEN;
1181
1182                 MCDI_IN_SET_DWORD(req, GET_ASSERTS_IN_CLEAR, 1);
1183                 efx_mcdi_execute_quiet(enp, &req);
1184
1185         } while ((req.emr_rc == EINTR || req.emr_rc == EIO) && retry-- > 0);
1186
1187         if (req.emr_rc != 0) {
1188                 if (req.emr_rc == EACCES) {
1189                         /* Unprivileged functions cannot clear assertions. */
1190                         goto out;
1191                 }
1192                 rc = req.emr_rc;
1193                 goto fail1;
1194         }
1195
1196         if (req.emr_out_length_used < MC_CMD_GET_ASSERTS_OUT_LEN) {
1197                 rc = EMSGSIZE;
1198                 goto fail2;
1199         }
1200
1201         /* Print out any assertion state recorded */
1202         flags = MCDI_OUT_DWORD(req, GET_ASSERTS_OUT_GLOBAL_FLAGS);
1203         if (flags == MC_CMD_GET_ASSERTS_FLAGS_NO_FAILS)
1204                 return (0);
1205
1206         reason = (flags == MC_CMD_GET_ASSERTS_FLAGS_SYS_FAIL)
1207                 ? "system-level assertion"
1208                 : (flags == MC_CMD_GET_ASSERTS_FLAGS_THR_FAIL)
1209                 ? "thread-level assertion"
1210                 : (flags == MC_CMD_GET_ASSERTS_FLAGS_WDOG_FIRED)
1211                 ? "watchdog reset"
1212                 : (flags == MC_CMD_GET_ASSERTS_FLAGS_ADDR_TRAP)
1213                 ? "illegal address trap"
1214                 : "unknown assertion";
1215         EFSYS_PROBE3(mcpu_assertion,
1216             const char *, reason, unsigned int,
1217             MCDI_OUT_DWORD(req, GET_ASSERTS_OUT_SAVED_PC_OFFS),
1218             unsigned int,
1219             MCDI_OUT_DWORD(req, GET_ASSERTS_OUT_THREAD_OFFS));
1220
1221         /* Print out the registers (r1 ... r31) */
1222         ofst = MC_CMD_GET_ASSERTS_OUT_GP_REGS_OFFS_OFST;
1223         for (index = 1;
1224                 index < 1 + MC_CMD_GET_ASSERTS_OUT_GP_REGS_OFFS_NUM;
1225                 index++) {
1226                 EFSYS_PROBE2(mcpu_register, unsigned int, index, unsigned int,
1227                             EFX_DWORD_FIELD(*MCDI_OUT(req, efx_dword_t, ofst),
1228                                             EFX_DWORD_0));
1229                 ofst += sizeof (efx_dword_t);
1230         }
1231         EFSYS_ASSERT(ofst <= MC_CMD_GET_ASSERTS_OUT_LEN);
1232
1233 out:
1234         return (0);
1235
1236 fail2:
1237         EFSYS_PROBE(fail2);
1238 fail1:
1239         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1240
1241         return (rc);
1242 }
1243
1244
1245 /*
1246  * Internal routines for for specific MCDI requests.
1247  */
1248
1249         __checkReturn   efx_rc_t
1250 efx_mcdi_drv_attach(
1251         __in            efx_nic_t *enp,
1252         __in            boolean_t attach)
1253 {
1254         efx_mcdi_req_t req;
1255         uint8_t payload[MAX(MC_CMD_DRV_ATTACH_IN_LEN,
1256                             MC_CMD_DRV_ATTACH_EXT_OUT_LEN)];
1257         efx_rc_t rc;
1258
1259         (void) memset(payload, 0, sizeof (payload));
1260         req.emr_cmd = MC_CMD_DRV_ATTACH;
1261         req.emr_in_buf = payload;
1262         req.emr_in_length = MC_CMD_DRV_ATTACH_IN_LEN;
1263         req.emr_out_buf = payload;
1264         req.emr_out_length = MC_CMD_DRV_ATTACH_EXT_OUT_LEN;
1265
1266         /*
1267          * Use DONT_CARE for the datapath firmware type to ensure that the
1268          * driver can attach to an unprivileged function. The datapath firmware
1269          * type to use is controlled by the 'sfboot' utility.
1270          */
1271         MCDI_IN_SET_DWORD(req, DRV_ATTACH_IN_NEW_STATE, attach ? 1 : 0);
1272         MCDI_IN_SET_DWORD(req, DRV_ATTACH_IN_UPDATE, 1);
1273         MCDI_IN_SET_DWORD(req, DRV_ATTACH_IN_FIRMWARE_ID, MC_CMD_FW_DONT_CARE);
1274
1275         efx_mcdi_execute(enp, &req);
1276
1277         if (req.emr_rc != 0) {
1278                 rc = req.emr_rc;
1279                 goto fail1;
1280         }
1281
1282         if (req.emr_out_length_used < MC_CMD_DRV_ATTACH_OUT_LEN) {
1283                 rc = EMSGSIZE;
1284                 goto fail2;
1285         }
1286
1287         return (0);
1288
1289 fail2:
1290         EFSYS_PROBE(fail2);
1291 fail1:
1292         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1293
1294         return (rc);
1295 }
1296
1297         __checkReturn           efx_rc_t
1298 efx_mcdi_get_board_cfg(
1299         __in                    efx_nic_t *enp,
1300         __out_opt               uint32_t *board_typep,
1301         __out_opt               efx_dword_t *capabilitiesp,
1302         __out_ecount_opt(6)     uint8_t mac_addrp[6])
1303 {
1304         efx_mcdi_iface_t *emip = &(enp->en_mcdi.em_emip);
1305         efx_mcdi_req_t req;
1306         uint8_t payload[MAX(MC_CMD_GET_BOARD_CFG_IN_LEN,
1307                             MC_CMD_GET_BOARD_CFG_OUT_LENMIN)];
1308         efx_rc_t rc;
1309
1310         (void) memset(payload, 0, sizeof (payload));
1311         req.emr_cmd = MC_CMD_GET_BOARD_CFG;
1312         req.emr_in_buf = payload;
1313         req.emr_in_length = MC_CMD_GET_BOARD_CFG_IN_LEN;
1314         req.emr_out_buf = payload;
1315         req.emr_out_length = MC_CMD_GET_BOARD_CFG_OUT_LENMIN;
1316
1317         efx_mcdi_execute(enp, &req);
1318
1319         if (req.emr_rc != 0) {
1320                 rc = req.emr_rc;
1321                 goto fail1;
1322         }
1323
1324         if (req.emr_out_length_used < MC_CMD_GET_BOARD_CFG_OUT_LENMIN) {
1325                 rc = EMSGSIZE;
1326                 goto fail2;
1327         }
1328
1329         if (mac_addrp != NULL) {
1330                 uint8_t *addrp;
1331
1332                 if (emip->emi_port == 1) {
1333                         addrp = MCDI_OUT2(req, uint8_t,
1334                             GET_BOARD_CFG_OUT_MAC_ADDR_BASE_PORT0);
1335                 } else if (emip->emi_port == 2) {
1336                         addrp = MCDI_OUT2(req, uint8_t,
1337                             GET_BOARD_CFG_OUT_MAC_ADDR_BASE_PORT1);
1338                 } else {
1339                         rc = EINVAL;
1340                         goto fail3;
1341                 }
1342
1343                 EFX_MAC_ADDR_COPY(mac_addrp, addrp);
1344         }
1345
1346         if (capabilitiesp != NULL) {
1347                 if (emip->emi_port == 1) {
1348                         *capabilitiesp = *MCDI_OUT2(req, efx_dword_t,
1349                             GET_BOARD_CFG_OUT_CAPABILITIES_PORT0);
1350                 } else if (emip->emi_port == 2) {
1351                         *capabilitiesp = *MCDI_OUT2(req, efx_dword_t,
1352                             GET_BOARD_CFG_OUT_CAPABILITIES_PORT1);
1353                 } else {
1354                         rc = EINVAL;
1355                         goto fail4;
1356                 }
1357         }
1358
1359         if (board_typep != NULL) {
1360                 *board_typep = MCDI_OUT_DWORD(req,
1361                     GET_BOARD_CFG_OUT_BOARD_TYPE);
1362         }
1363
1364         return (0);
1365
1366 fail4:
1367         EFSYS_PROBE(fail4);
1368 fail3:
1369         EFSYS_PROBE(fail3);
1370 fail2:
1371         EFSYS_PROBE(fail2);
1372 fail1:
1373         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1374
1375         return (rc);
1376 }
1377
1378         __checkReturn   efx_rc_t
1379 efx_mcdi_get_resource_limits(
1380         __in            efx_nic_t *enp,
1381         __out_opt       uint32_t *nevqp,
1382         __out_opt       uint32_t *nrxqp,
1383         __out_opt       uint32_t *ntxqp)
1384 {
1385         efx_mcdi_req_t req;
1386         uint8_t payload[MAX(MC_CMD_GET_RESOURCE_LIMITS_IN_LEN,
1387                             MC_CMD_GET_RESOURCE_LIMITS_OUT_LEN)];
1388         efx_rc_t rc;
1389
1390         (void) memset(payload, 0, sizeof (payload));
1391         req.emr_cmd = MC_CMD_GET_RESOURCE_LIMITS;
1392         req.emr_in_buf = payload;
1393         req.emr_in_length = MC_CMD_GET_RESOURCE_LIMITS_IN_LEN;
1394         req.emr_out_buf = payload;
1395         req.emr_out_length = MC_CMD_GET_RESOURCE_LIMITS_OUT_LEN;
1396
1397         efx_mcdi_execute(enp, &req);
1398
1399         if (req.emr_rc != 0) {
1400                 rc = req.emr_rc;
1401                 goto fail1;
1402         }
1403
1404         if (req.emr_out_length_used < MC_CMD_GET_RESOURCE_LIMITS_OUT_LEN) {
1405                 rc = EMSGSIZE;
1406                 goto fail2;
1407         }
1408
1409         if (nevqp != NULL)
1410                 *nevqp = MCDI_OUT_DWORD(req, GET_RESOURCE_LIMITS_OUT_EVQ);
1411         if (nrxqp != NULL)
1412                 *nrxqp = MCDI_OUT_DWORD(req, GET_RESOURCE_LIMITS_OUT_RXQ);
1413         if (ntxqp != NULL)
1414                 *ntxqp = MCDI_OUT_DWORD(req, GET_RESOURCE_LIMITS_OUT_TXQ);
1415
1416         return (0);
1417
1418 fail2:
1419         EFSYS_PROBE(fail2);
1420 fail1:
1421         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1422
1423         return (rc);
1424 }
1425
1426         __checkReturn   efx_rc_t
1427 efx_mcdi_get_phy_cfg(
1428         __in            efx_nic_t *enp)
1429 {
1430         efx_port_t *epp = &(enp->en_port);
1431         efx_nic_cfg_t *encp = &(enp->en_nic_cfg);
1432         efx_mcdi_req_t req;
1433         uint8_t payload[MAX(MC_CMD_GET_PHY_CFG_IN_LEN,
1434                             MC_CMD_GET_PHY_CFG_OUT_LEN)];
1435 #if EFSYS_OPT_NAMES
1436         const char *namep;
1437         size_t namelen;
1438 #endif
1439         uint32_t phy_media_type;
1440         efx_rc_t rc;
1441
1442         (void) memset(payload, 0, sizeof (payload));
1443         req.emr_cmd = MC_CMD_GET_PHY_CFG;
1444         req.emr_in_buf = payload;
1445         req.emr_in_length = MC_CMD_GET_PHY_CFG_IN_LEN;
1446         req.emr_out_buf = payload;
1447         req.emr_out_length = MC_CMD_GET_PHY_CFG_OUT_LEN;
1448
1449         efx_mcdi_execute(enp, &req);
1450
1451         if (req.emr_rc != 0) {
1452                 rc = req.emr_rc;
1453                 goto fail1;
1454         }
1455
1456         if (req.emr_out_length_used < MC_CMD_GET_PHY_CFG_OUT_LEN) {
1457                 rc = EMSGSIZE;
1458                 goto fail2;
1459         }
1460
1461         encp->enc_phy_type = MCDI_OUT_DWORD(req, GET_PHY_CFG_OUT_TYPE);
1462 #if EFSYS_OPT_NAMES
1463         namep = MCDI_OUT2(req, char, GET_PHY_CFG_OUT_NAME);
1464         namelen = MIN(sizeof (encp->enc_phy_name) - 1,
1465                     strnlen(namep, MC_CMD_GET_PHY_CFG_OUT_NAME_LEN));
1466         (void) memset(encp->enc_phy_name, 0,
1467             sizeof (encp->enc_phy_name));
1468         memcpy(encp->enc_phy_name, namep, namelen);
1469 #endif  /* EFSYS_OPT_NAMES */
1470         (void) memset(encp->enc_phy_revision, 0,
1471             sizeof (encp->enc_phy_revision));
1472         memcpy(encp->enc_phy_revision,
1473                 MCDI_OUT2(req, char, GET_PHY_CFG_OUT_REVISION),
1474                 MIN(sizeof (encp->enc_phy_revision) - 1,
1475                     MC_CMD_GET_PHY_CFG_OUT_REVISION_LEN));
1476 #if EFSYS_OPT_PHY_LED_CONTROL
1477         encp->enc_led_mask = ((1 << EFX_PHY_LED_DEFAULT) |
1478                             (1 << EFX_PHY_LED_OFF) |
1479                             (1 << EFX_PHY_LED_ON));
1480 #endif  /* EFSYS_OPT_PHY_LED_CONTROL */
1481
1482         /* Get the media type of the fixed port, if recognised. */
1483         EFX_STATIC_ASSERT(MC_CMD_MEDIA_XAUI == EFX_PHY_MEDIA_XAUI);
1484         EFX_STATIC_ASSERT(MC_CMD_MEDIA_CX4 == EFX_PHY_MEDIA_CX4);
1485         EFX_STATIC_ASSERT(MC_CMD_MEDIA_KX4 == EFX_PHY_MEDIA_KX4);
1486         EFX_STATIC_ASSERT(MC_CMD_MEDIA_XFP == EFX_PHY_MEDIA_XFP);
1487         EFX_STATIC_ASSERT(MC_CMD_MEDIA_SFP_PLUS == EFX_PHY_MEDIA_SFP_PLUS);
1488         EFX_STATIC_ASSERT(MC_CMD_MEDIA_BASE_T == EFX_PHY_MEDIA_BASE_T);
1489         EFX_STATIC_ASSERT(MC_CMD_MEDIA_QSFP_PLUS == EFX_PHY_MEDIA_QSFP_PLUS);
1490         phy_media_type = MCDI_OUT_DWORD(req, GET_PHY_CFG_OUT_MEDIA_TYPE);
1491         epp->ep_fixed_port_type = (efx_phy_media_type_t)phy_media_type;
1492         if (epp->ep_fixed_port_type >= EFX_PHY_MEDIA_NTYPES)
1493                 epp->ep_fixed_port_type = EFX_PHY_MEDIA_INVALID;
1494
1495         epp->ep_phy_cap_mask =
1496                 MCDI_OUT_DWORD(req, GET_PHY_CFG_OUT_SUPPORTED_CAP);
1497 #if EFSYS_OPT_PHY_FLAGS
1498         encp->enc_phy_flags_mask = MCDI_OUT_DWORD(req, GET_PHY_CFG_OUT_FLAGS);
1499 #endif  /* EFSYS_OPT_PHY_FLAGS */
1500
1501         encp->enc_port = (uint8_t)MCDI_OUT_DWORD(req, GET_PHY_CFG_OUT_PRT);
1502
1503         /* Populate internal state */
1504         encp->enc_mcdi_mdio_channel =
1505                 (uint8_t)MCDI_OUT_DWORD(req, GET_PHY_CFG_OUT_CHANNEL);
1506
1507 #if EFSYS_OPT_PHY_STATS
1508         encp->enc_mcdi_phy_stat_mask =
1509                 MCDI_OUT_DWORD(req, GET_PHY_CFG_OUT_STATS_MASK);
1510 #endif  /* EFSYS_OPT_PHY_STATS */
1511
1512 #if EFSYS_OPT_BIST
1513         encp->enc_bist_mask = 0;
1514         if (MCDI_OUT_DWORD_FIELD(req, GET_PHY_CFG_OUT_FLAGS,
1515             GET_PHY_CFG_OUT_BIST_CABLE_SHORT))
1516                 encp->enc_bist_mask |= (1 << EFX_BIST_TYPE_PHY_CABLE_SHORT);
1517         if (MCDI_OUT_DWORD_FIELD(req, GET_PHY_CFG_OUT_FLAGS,
1518             GET_PHY_CFG_OUT_BIST_CABLE_LONG))
1519                 encp->enc_bist_mask |= (1 << EFX_BIST_TYPE_PHY_CABLE_LONG);
1520         if (MCDI_OUT_DWORD_FIELD(req, GET_PHY_CFG_OUT_FLAGS,
1521             GET_PHY_CFG_OUT_BIST))
1522                 encp->enc_bist_mask |= (1 << EFX_BIST_TYPE_PHY_NORMAL);
1523 #endif  /* EFSYS_OPT_BIST */
1524
1525         return (0);
1526
1527 fail2:
1528         EFSYS_PROBE(fail2);
1529 fail1:
1530         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1531
1532         return (rc);
1533 }
1534
1535         __checkReturn           efx_rc_t
1536 efx_mcdi_firmware_update_supported(
1537         __in                    efx_nic_t *enp,
1538         __out                   boolean_t *supportedp)
1539 {
1540         const efx_mcdi_ops_t *emcop = enp->en_mcdi.em_emcop;
1541         efx_rc_t rc;
1542
1543         if (emcop != NULL) {
1544                 if ((rc = emcop->emco_feature_supported(enp,
1545                             EFX_MCDI_FEATURE_FW_UPDATE, supportedp)) != 0)
1546                         goto fail1;
1547         } else {
1548                 /* Earlier devices always supported updates */
1549                 *supportedp = B_TRUE;
1550         }
1551
1552         return (0);
1553
1554 fail1:
1555         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1556
1557         return (rc);
1558 }
1559
1560         __checkReturn           efx_rc_t
1561 efx_mcdi_macaddr_change_supported(
1562         __in                    efx_nic_t *enp,
1563         __out                   boolean_t *supportedp)
1564 {
1565         const efx_mcdi_ops_t *emcop = enp->en_mcdi.em_emcop;
1566         efx_rc_t rc;
1567
1568         if (emcop != NULL) {
1569                 if ((rc = emcop->emco_feature_supported(enp,
1570                             EFX_MCDI_FEATURE_MACADDR_CHANGE, supportedp)) != 0)
1571                         goto fail1;
1572         } else {
1573                 /* Earlier devices always supported MAC changes */
1574                 *supportedp = B_TRUE;
1575         }
1576
1577         return (0);
1578
1579 fail1:
1580         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1581
1582         return (rc);
1583 }
1584
1585         __checkReturn           efx_rc_t
1586 efx_mcdi_link_control_supported(
1587         __in                    efx_nic_t *enp,
1588         __out                   boolean_t *supportedp)
1589 {
1590         const efx_mcdi_ops_t *emcop = enp->en_mcdi.em_emcop;
1591         efx_rc_t rc;
1592
1593         if (emcop != NULL) {
1594                 if ((rc = emcop->emco_feature_supported(enp,
1595                             EFX_MCDI_FEATURE_LINK_CONTROL, supportedp)) != 0)
1596                         goto fail1;
1597         } else {
1598                 /* Earlier devices always supported link control */
1599                 *supportedp = B_TRUE;
1600         }
1601
1602         return (0);
1603
1604 fail1:
1605         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1606
1607         return (rc);
1608 }
1609
1610         __checkReturn           efx_rc_t
1611 efx_mcdi_mac_spoofing_supported(
1612         __in                    efx_nic_t *enp,
1613         __out                   boolean_t *supportedp)
1614 {
1615         const efx_mcdi_ops_t *emcop = enp->en_mcdi.em_emcop;
1616         efx_rc_t rc;
1617
1618         if (emcop != NULL) {
1619                 if ((rc = emcop->emco_feature_supported(enp,
1620                             EFX_MCDI_FEATURE_MAC_SPOOFING, supportedp)) != 0)
1621                         goto fail1;
1622         } else {
1623                 /* Earlier devices always supported MAC spoofing */
1624                 *supportedp = B_TRUE;
1625         }
1626
1627         return (0);
1628
1629 fail1:
1630         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1631
1632         return (rc);
1633 }
1634
1635 #if EFSYS_OPT_BIST
1636
1637 #if EFSYS_OPT_HUNTINGTON || EFSYS_OPT_MEDFORD || EFSYS_OPT_MEDFORD2
1638 /*
1639  * Enter bist offline mode. This is a fw mode which puts the NIC into a state
1640  * where memory BIST tests can be run and not much else can interfere or happen.
1641  * A reboot is required to exit this mode.
1642  */
1643         __checkReturn           efx_rc_t
1644 efx_mcdi_bist_enable_offline(
1645         __in                    efx_nic_t *enp)
1646 {
1647         efx_mcdi_req_t req;
1648         efx_rc_t rc;
1649
1650         EFX_STATIC_ASSERT(MC_CMD_ENABLE_OFFLINE_BIST_IN_LEN == 0);
1651         EFX_STATIC_ASSERT(MC_CMD_ENABLE_OFFLINE_BIST_OUT_LEN == 0);
1652
1653         req.emr_cmd = MC_CMD_ENABLE_OFFLINE_BIST;
1654         req.emr_in_buf = NULL;
1655         req.emr_in_length = 0;
1656         req.emr_out_buf = NULL;
1657         req.emr_out_length = 0;
1658
1659         efx_mcdi_execute(enp, &req);
1660
1661         if (req.emr_rc != 0) {
1662                 rc = req.emr_rc;
1663                 goto fail1;
1664         }
1665
1666         return (0);
1667
1668 fail1:
1669         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1670
1671         return (rc);
1672 }
1673 #endif /* EFSYS_OPT_HUNTINGTON || EFSYS_OPT_MEDFORD || EFSYS_OPT_MEDFORD2 */
1674
1675         __checkReturn           efx_rc_t
1676 efx_mcdi_bist_start(
1677         __in                    efx_nic_t *enp,
1678         __in                    efx_bist_type_t type)
1679 {
1680         efx_mcdi_req_t req;
1681         uint8_t payload[MAX(MC_CMD_START_BIST_IN_LEN,
1682                             MC_CMD_START_BIST_OUT_LEN)];
1683         efx_rc_t rc;
1684
1685         (void) memset(payload, 0, sizeof (payload));
1686         req.emr_cmd = MC_CMD_START_BIST;
1687         req.emr_in_buf = payload;
1688         req.emr_in_length = MC_CMD_START_BIST_IN_LEN;
1689         req.emr_out_buf = payload;
1690         req.emr_out_length = MC_CMD_START_BIST_OUT_LEN;
1691
1692         switch (type) {
1693         case EFX_BIST_TYPE_PHY_NORMAL:
1694                 MCDI_IN_SET_DWORD(req, START_BIST_IN_TYPE, MC_CMD_PHY_BIST);
1695                 break;
1696         case EFX_BIST_TYPE_PHY_CABLE_SHORT:
1697                 MCDI_IN_SET_DWORD(req, START_BIST_IN_TYPE,
1698                     MC_CMD_PHY_BIST_CABLE_SHORT);
1699                 break;
1700         case EFX_BIST_TYPE_PHY_CABLE_LONG:
1701                 MCDI_IN_SET_DWORD(req, START_BIST_IN_TYPE,
1702                     MC_CMD_PHY_BIST_CABLE_LONG);
1703                 break;
1704         case EFX_BIST_TYPE_MC_MEM:
1705                 MCDI_IN_SET_DWORD(req, START_BIST_IN_TYPE,
1706                     MC_CMD_MC_MEM_BIST);
1707                 break;
1708         case EFX_BIST_TYPE_SAT_MEM:
1709                 MCDI_IN_SET_DWORD(req, START_BIST_IN_TYPE,
1710                     MC_CMD_PORT_MEM_BIST);
1711                 break;
1712         case EFX_BIST_TYPE_REG:
1713                 MCDI_IN_SET_DWORD(req, START_BIST_IN_TYPE,
1714                     MC_CMD_REG_BIST);
1715                 break;
1716         default:
1717                 EFSYS_ASSERT(0);
1718         }
1719
1720         efx_mcdi_execute(enp, &req);
1721
1722         if (req.emr_rc != 0) {
1723                 rc = req.emr_rc;
1724                 goto fail1;
1725         }
1726
1727         return (0);
1728
1729 fail1:
1730         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1731
1732         return (rc);
1733 }
1734
1735 #endif /* EFSYS_OPT_BIST */
1736
1737
1738 /* Enable logging of some events (e.g. link state changes) */
1739         __checkReturn   efx_rc_t
1740 efx_mcdi_log_ctrl(
1741         __in            efx_nic_t *enp)
1742 {
1743         efx_mcdi_req_t req;
1744         uint8_t payload[MAX(MC_CMD_LOG_CTRL_IN_LEN,
1745                             MC_CMD_LOG_CTRL_OUT_LEN)];
1746         efx_rc_t rc;
1747
1748         (void) memset(payload, 0, sizeof (payload));
1749         req.emr_cmd = MC_CMD_LOG_CTRL;
1750         req.emr_in_buf = payload;
1751         req.emr_in_length = MC_CMD_LOG_CTRL_IN_LEN;
1752         req.emr_out_buf = payload;
1753         req.emr_out_length = MC_CMD_LOG_CTRL_OUT_LEN;
1754
1755         MCDI_IN_SET_DWORD(req, LOG_CTRL_IN_LOG_DEST,
1756                     MC_CMD_LOG_CTRL_IN_LOG_DEST_EVQ);
1757         MCDI_IN_SET_DWORD(req, LOG_CTRL_IN_LOG_DEST_EVQ, 0);
1758
1759         efx_mcdi_execute(enp, &req);
1760
1761         if (req.emr_rc != 0) {
1762                 rc = req.emr_rc;
1763                 goto fail1;
1764         }
1765
1766         return (0);
1767
1768 fail1:
1769         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1770
1771         return (rc);
1772 }
1773
1774
1775 #if EFSYS_OPT_MAC_STATS
1776
1777 typedef enum efx_stats_action_e {
1778         EFX_STATS_CLEAR,
1779         EFX_STATS_UPLOAD,
1780         EFX_STATS_ENABLE_NOEVENTS,
1781         EFX_STATS_ENABLE_EVENTS,
1782         EFX_STATS_DISABLE,
1783 } efx_stats_action_t;
1784
1785 static  __checkReturn   efx_rc_t
1786 efx_mcdi_mac_stats(
1787         __in            efx_nic_t *enp,
1788         __in_opt        efsys_mem_t *esmp,
1789         __in            efx_stats_action_t action,
1790         __in            uint16_t period_ms)
1791 {
1792         efx_mcdi_req_t req;
1793         uint8_t payload[MAX(MC_CMD_MAC_STATS_IN_LEN,
1794                             MC_CMD_MAC_STATS_OUT_DMA_LEN)];
1795         int clear = (action == EFX_STATS_CLEAR);
1796         int upload = (action == EFX_STATS_UPLOAD);
1797         int enable = (action == EFX_STATS_ENABLE_NOEVENTS);
1798         int events = (action == EFX_STATS_ENABLE_EVENTS);
1799         int disable = (action == EFX_STATS_DISABLE);
1800         efx_rc_t rc;
1801
1802         (void) memset(payload, 0, sizeof (payload));
1803         req.emr_cmd = MC_CMD_MAC_STATS;
1804         req.emr_in_buf = payload;
1805         req.emr_in_length = MC_CMD_MAC_STATS_IN_LEN;
1806         req.emr_out_buf = payload;
1807         req.emr_out_length = MC_CMD_MAC_STATS_OUT_DMA_LEN;
1808
1809         MCDI_IN_POPULATE_DWORD_6(req, MAC_STATS_IN_CMD,
1810             MAC_STATS_IN_DMA, upload,
1811             MAC_STATS_IN_CLEAR, clear,
1812             MAC_STATS_IN_PERIODIC_CHANGE, enable | events | disable,
1813             MAC_STATS_IN_PERIODIC_ENABLE, enable | events,
1814             MAC_STATS_IN_PERIODIC_NOEVENT, !events,
1815             MAC_STATS_IN_PERIOD_MS, (enable | events) ? period_ms : 0);
1816
1817         if (esmp != NULL) {
1818                 uint32_t bytes = MC_CMD_MAC_NSTATS * sizeof (uint64_t);
1819
1820                 EFX_STATIC_ASSERT(MC_CMD_MAC_NSTATS * sizeof (uint64_t) <=
1821                     EFX_MAC_STATS_SIZE);
1822
1823                 EFSYS_ASSERT3U(bytes, <=, (uint32_t)EFSYS_MEM_SIZE(esmp));
1824
1825                 MCDI_IN_SET_DWORD(req, MAC_STATS_IN_DMA_ADDR_LO,
1826                             EFSYS_MEM_ADDR(esmp) & 0xffffffff);
1827                 MCDI_IN_SET_DWORD(req, MAC_STATS_IN_DMA_ADDR_HI,
1828                             EFSYS_MEM_ADDR(esmp) >> 32);
1829                 MCDI_IN_SET_DWORD(req, MAC_STATS_IN_DMA_LEN, bytes);
1830         } else {
1831                 EFSYS_ASSERT(!upload && !enable && !events);
1832         }
1833
1834         /*
1835          * NOTE: Do not use EVB_PORT_ID_ASSIGNED when disabling periodic stats,
1836          *       as this may fail (and leave periodic DMA enabled) if the
1837          *       vadapter has already been deleted.
1838          */
1839         MCDI_IN_SET_DWORD(req, MAC_STATS_IN_PORT_ID,
1840             (disable ? EVB_PORT_ID_NULL : enp->en_vport_id));
1841
1842         efx_mcdi_execute(enp, &req);
1843
1844         if (req.emr_rc != 0) {
1845                 /* EF10: Expect ENOENT if no DMA queues are initialised */
1846                 if ((req.emr_rc != ENOENT) ||
1847                     (enp->en_rx_qcount + enp->en_tx_qcount != 0)) {
1848                         rc = req.emr_rc;
1849                         goto fail1;
1850                 }
1851         }
1852
1853         return (0);
1854
1855 fail1:
1856         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1857
1858         return (rc);
1859 }
1860
1861         __checkReturn   efx_rc_t
1862 efx_mcdi_mac_stats_clear(
1863         __in            efx_nic_t *enp)
1864 {
1865         efx_rc_t rc;
1866
1867         if ((rc = efx_mcdi_mac_stats(enp, NULL, EFX_STATS_CLEAR, 0)) != 0)
1868                 goto fail1;
1869
1870         return (0);
1871
1872 fail1:
1873         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1874
1875         return (rc);
1876 }
1877
1878         __checkReturn   efx_rc_t
1879 efx_mcdi_mac_stats_upload(
1880         __in            efx_nic_t *enp,
1881         __in            efsys_mem_t *esmp)
1882 {
1883         efx_rc_t rc;
1884
1885         /*
1886          * The MC DMAs aggregate statistics for our convenience, so we can
1887          * avoid having to pull the statistics buffer into the cache to
1888          * maintain cumulative statistics.
1889          */
1890         if ((rc = efx_mcdi_mac_stats(enp, esmp, EFX_STATS_UPLOAD, 0)) != 0)
1891                 goto fail1;
1892
1893         return (0);
1894
1895 fail1:
1896         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1897
1898         return (rc);
1899 }
1900
1901         __checkReturn   efx_rc_t
1902 efx_mcdi_mac_stats_periodic(
1903         __in            efx_nic_t *enp,
1904         __in            efsys_mem_t *esmp,
1905         __in            uint16_t period_ms,
1906         __in            boolean_t events)
1907 {
1908         efx_rc_t rc;
1909
1910         /*
1911          * The MC DMAs aggregate statistics for our convenience, so we can
1912          * avoid having to pull the statistics buffer into the cache to
1913          * maintain cumulative statistics.
1914          * Huntington uses a fixed 1sec period.
1915          * Medford uses a fixed 1sec period before v6.2.1.1033 firmware.
1916          */
1917         if (period_ms == 0)
1918                 rc = efx_mcdi_mac_stats(enp, NULL, EFX_STATS_DISABLE, 0);
1919         else if (events)
1920                 rc = efx_mcdi_mac_stats(enp, esmp, EFX_STATS_ENABLE_EVENTS,
1921                     period_ms);
1922         else
1923                 rc = efx_mcdi_mac_stats(enp, esmp, EFX_STATS_ENABLE_NOEVENTS,
1924                     period_ms);
1925
1926         if (rc != 0)
1927                 goto fail1;
1928
1929         return (0);
1930
1931 fail1:
1932         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1933
1934         return (rc);
1935 }
1936
1937 #endif  /* EFSYS_OPT_MAC_STATS */
1938
1939 #if EFSYS_OPT_HUNTINGTON || EFSYS_OPT_MEDFORD || EFSYS_OPT_MEDFORD2
1940
1941 /*
1942  * This function returns the pf and vf number of a function.  If it is a pf the
1943  * vf number is 0xffff.  The vf number is the index of the vf on that
1944  * function. So if you have 3 vfs on pf 0 the 3 vfs will return (pf=0,vf=0),
1945  * (pf=0,vf=1), (pf=0,vf=2) aand the pf will return (pf=0, vf=0xffff).
1946  */
1947         __checkReturn           efx_rc_t
1948 efx_mcdi_get_function_info(
1949         __in                    efx_nic_t *enp,
1950         __out                   uint32_t *pfp,
1951         __out_opt               uint32_t *vfp)
1952 {
1953         efx_mcdi_req_t req;
1954         uint8_t payload[MAX(MC_CMD_GET_FUNCTION_INFO_IN_LEN,
1955                             MC_CMD_GET_FUNCTION_INFO_OUT_LEN)];
1956         efx_rc_t rc;
1957
1958         (void) memset(payload, 0, sizeof (payload));
1959         req.emr_cmd = MC_CMD_GET_FUNCTION_INFO;
1960         req.emr_in_buf = payload;
1961         req.emr_in_length = MC_CMD_GET_FUNCTION_INFO_IN_LEN;
1962         req.emr_out_buf = payload;
1963         req.emr_out_length = MC_CMD_GET_FUNCTION_INFO_OUT_LEN;
1964
1965         efx_mcdi_execute(enp, &req);
1966
1967         if (req.emr_rc != 0) {
1968                 rc = req.emr_rc;
1969                 goto fail1;
1970         }
1971
1972         if (req.emr_out_length_used < MC_CMD_GET_FUNCTION_INFO_OUT_LEN) {
1973                 rc = EMSGSIZE;
1974                 goto fail2;
1975         }
1976
1977         *pfp = MCDI_OUT_DWORD(req, GET_FUNCTION_INFO_OUT_PF);
1978         if (vfp != NULL)
1979                 *vfp = MCDI_OUT_DWORD(req, GET_FUNCTION_INFO_OUT_VF);
1980
1981         return (0);
1982
1983 fail2:
1984         EFSYS_PROBE(fail2);
1985 fail1:
1986         EFSYS_PROBE1(fail1, efx_rc_t, rc);
1987
1988         return (rc);
1989 }
1990
1991         __checkReturn           efx_rc_t
1992 efx_mcdi_privilege_mask(
1993         __in                    efx_nic_t *enp,
1994         __in                    uint32_t pf,
1995         __in                    uint32_t vf,
1996         __out                   uint32_t *maskp)
1997 {
1998         efx_mcdi_req_t req;
1999         uint8_t payload[MAX(MC_CMD_PRIVILEGE_MASK_IN_LEN,
2000                             MC_CMD_PRIVILEGE_MASK_OUT_LEN)];
2001         efx_rc_t rc;
2002
2003         (void) memset(payload, 0, sizeof (payload));
2004         req.emr_cmd = MC_CMD_PRIVILEGE_MASK;
2005         req.emr_in_buf = payload;
2006         req.emr_in_length = MC_CMD_PRIVILEGE_MASK_IN_LEN;
2007         req.emr_out_buf = payload;
2008         req.emr_out_length = MC_CMD_PRIVILEGE_MASK_OUT_LEN;
2009
2010         MCDI_IN_POPULATE_DWORD_2(req, PRIVILEGE_MASK_IN_FUNCTION,
2011             PRIVILEGE_MASK_IN_FUNCTION_PF, pf,
2012             PRIVILEGE_MASK_IN_FUNCTION_VF, vf);
2013
2014         efx_mcdi_execute(enp, &req);
2015
2016         if (req.emr_rc != 0) {
2017                 rc = req.emr_rc;
2018                 goto fail1;
2019         }
2020
2021         if (req.emr_out_length_used < MC_CMD_PRIVILEGE_MASK_OUT_LEN) {
2022                 rc = EMSGSIZE;
2023                 goto fail2;
2024         }
2025
2026         *maskp = MCDI_OUT_DWORD(req, PRIVILEGE_MASK_OUT_OLD_MASK);
2027
2028         return (0);
2029
2030 fail2:
2031         EFSYS_PROBE(fail2);
2032 fail1:
2033         EFSYS_PROBE1(fail1, efx_rc_t, rc);
2034
2035         return (rc);
2036 }
2037
2038 #endif /* EFSYS_OPT_HUNTINGTON || EFSYS_OPT_MEDFORD || EFSYS_OPT_MEDFORD2 */
2039
2040         __checkReturn           efx_rc_t
2041 efx_mcdi_set_workaround(
2042         __in                    efx_nic_t *enp,
2043         __in                    uint32_t type,
2044         __in                    boolean_t enabled,
2045         __out_opt               uint32_t *flagsp)
2046 {
2047         efx_mcdi_req_t req;
2048         uint8_t payload[MAX(MC_CMD_WORKAROUND_IN_LEN,
2049                             MC_CMD_WORKAROUND_EXT_OUT_LEN)];
2050         efx_rc_t rc;
2051
2052         (void) memset(payload, 0, sizeof (payload));
2053         req.emr_cmd = MC_CMD_WORKAROUND;
2054         req.emr_in_buf = payload;
2055         req.emr_in_length = MC_CMD_WORKAROUND_IN_LEN;
2056         req.emr_out_buf = payload;
2057         req.emr_out_length = MC_CMD_WORKAROUND_OUT_LEN;
2058
2059         MCDI_IN_SET_DWORD(req, WORKAROUND_IN_TYPE, type);
2060         MCDI_IN_SET_DWORD(req, WORKAROUND_IN_ENABLED, enabled ? 1 : 0);
2061
2062         efx_mcdi_execute_quiet(enp, &req);
2063
2064         if (req.emr_rc != 0) {
2065                 rc = req.emr_rc;
2066                 goto fail1;
2067         }
2068
2069         if (flagsp != NULL) {
2070                 if (req.emr_out_length_used >= MC_CMD_WORKAROUND_EXT_OUT_LEN)
2071                         *flagsp = MCDI_OUT_DWORD(req, WORKAROUND_EXT_OUT_FLAGS);
2072                 else
2073                         *flagsp = 0;
2074         }
2075
2076         return (0);
2077
2078 fail1:
2079         EFSYS_PROBE1(fail1, efx_rc_t, rc);
2080
2081         return (rc);
2082 }
2083
2084
2085         __checkReturn           efx_rc_t
2086 efx_mcdi_get_workarounds(
2087         __in                    efx_nic_t *enp,
2088         __out_opt               uint32_t *implementedp,
2089         __out_opt               uint32_t *enabledp)
2090 {
2091         efx_mcdi_req_t req;
2092         uint8_t payload[MC_CMD_GET_WORKAROUNDS_OUT_LEN];
2093         efx_rc_t rc;
2094
2095         (void) memset(payload, 0, sizeof (payload));
2096         req.emr_cmd = MC_CMD_GET_WORKAROUNDS;
2097         req.emr_in_buf = NULL;
2098         req.emr_in_length = 0;
2099         req.emr_out_buf = payload;
2100         req.emr_out_length = MC_CMD_GET_WORKAROUNDS_OUT_LEN;
2101
2102         efx_mcdi_execute(enp, &req);
2103
2104         if (req.emr_rc != 0) {
2105                 rc = req.emr_rc;
2106                 goto fail1;
2107         }
2108
2109         if (implementedp != NULL) {
2110                 *implementedp =
2111                     MCDI_OUT_DWORD(req, GET_WORKAROUNDS_OUT_IMPLEMENTED);
2112         }
2113
2114         if (enabledp != NULL) {
2115                 *enabledp = MCDI_OUT_DWORD(req, GET_WORKAROUNDS_OUT_ENABLED);
2116         }
2117
2118         return (0);
2119
2120 fail1:
2121         EFSYS_PROBE1(fail1, efx_rc_t, rc);
2122
2123         return (rc);
2124 }
2125
2126 /*
2127  * Size of media information page in accordance with SFF-8472 and SFF-8436.
2128  * It is used in MCDI interface as well.
2129  */
2130 #define EFX_PHY_MEDIA_INFO_PAGE_SIZE            0x80
2131
2132 static  __checkReturn           efx_rc_t
2133 efx_mcdi_get_phy_media_info(
2134         __in                    efx_nic_t *enp,
2135         __in                    uint32_t mcdi_page,
2136         __in                    uint8_t offset,
2137         __in                    uint8_t len,
2138         __out_bcount(len)       uint8_t *data)
2139 {
2140         efx_mcdi_req_t req;
2141         uint8_t payload[MAX(MC_CMD_GET_PHY_MEDIA_INFO_IN_LEN,
2142                             MC_CMD_GET_PHY_MEDIA_INFO_OUT_LEN(
2143                                 EFX_PHY_MEDIA_INFO_PAGE_SIZE))];
2144         efx_rc_t rc;
2145
2146         EFSYS_ASSERT((uint32_t)offset + len <= EFX_PHY_MEDIA_INFO_PAGE_SIZE);
2147
2148         (void) memset(payload, 0, sizeof (payload));
2149         req.emr_cmd = MC_CMD_GET_PHY_MEDIA_INFO;
2150         req.emr_in_buf = payload;
2151         req.emr_in_length = MC_CMD_GET_PHY_MEDIA_INFO_IN_LEN;
2152         req.emr_out_buf = payload;
2153         req.emr_out_length =
2154             MC_CMD_GET_PHY_MEDIA_INFO_OUT_LEN(EFX_PHY_MEDIA_INFO_PAGE_SIZE);
2155
2156         MCDI_IN_SET_DWORD(req, GET_PHY_MEDIA_INFO_IN_PAGE, mcdi_page);
2157
2158         efx_mcdi_execute(enp, &req);
2159
2160         if (req.emr_rc != 0) {
2161                 rc = req.emr_rc;
2162                 goto fail1;
2163         }
2164
2165         if (req.emr_out_length_used !=
2166             MC_CMD_GET_PHY_MEDIA_INFO_OUT_LEN(EFX_PHY_MEDIA_INFO_PAGE_SIZE)) {
2167                 rc = EMSGSIZE;
2168                 goto fail2;
2169         }
2170
2171         if (MCDI_OUT_DWORD(req, GET_PHY_MEDIA_INFO_OUT_DATALEN) !=
2172             EFX_PHY_MEDIA_INFO_PAGE_SIZE) {
2173                 rc = EIO;
2174                 goto fail3;
2175         }
2176
2177         memcpy(data,
2178             MCDI_OUT2(req, uint8_t, GET_PHY_MEDIA_INFO_OUT_DATA) + offset,
2179             len);
2180
2181         return (0);
2182
2183 fail3:
2184         EFSYS_PROBE(fail3);
2185 fail2:
2186         EFSYS_PROBE(fail2);
2187 fail1:
2188         EFSYS_PROBE1(fail1, efx_rc_t, rc);
2189
2190         return (rc);
2191 }
2192
2193 /*
2194  * 2-wire device address of the base information in accordance with SFF-8472
2195  * Diagnostic Monitoring Interface for Optical Transceivers section
2196  * 4 Memory Organization.
2197  */
2198 #define EFX_PHY_MEDIA_INFO_DEV_ADDR_SFP_BASE    0xA0
2199
2200 /*
2201  * 2-wire device address of the digital diagnostics monitoring interface
2202  * in accordance with SFF-8472 Diagnostic Monitoring Interface for Optical
2203  * Transceivers section 4 Memory Organization.
2204  */
2205 #define EFX_PHY_MEDIA_INFO_DEV_ADDR_SFP_DDM     0xA2
2206
2207 /*
2208  * Hard wired 2-wire device address for QSFP+ in accordance with SFF-8436
2209  * QSFP+ 10 Gbs 4X PLUGGABLE TRANSCEIVER section 7.4 Device Addressing and
2210  * Operation.
2211  */
2212 #define EFX_PHY_MEDIA_INFO_DEV_ADDR_QSFP        0xA0
2213
2214         __checkReturn           efx_rc_t
2215 efx_mcdi_phy_module_get_info(
2216         __in                    efx_nic_t *enp,
2217         __in                    uint8_t dev_addr,
2218         __in                    uint8_t offset,
2219         __in                    uint8_t len,
2220         __out_bcount(len)       uint8_t *data)
2221 {
2222         efx_port_t *epp = &(enp->en_port);
2223         efx_rc_t rc;
2224         uint32_t mcdi_lower_page;
2225         uint32_t mcdi_upper_page;
2226
2227         EFSYS_ASSERT3U(enp->en_mod_flags, &, EFX_MOD_PROBE);
2228
2229         /*
2230          * Map device address to MC_CMD_GET_PHY_MEDIA_INFO pages.
2231          * Offset plus length interface allows to access page 0 only.
2232          * I.e. non-zero upper pages are not accessible.
2233          * See SFF-8472 section 4 Memory Organization and SFF-8436 section 7.6
2234          * QSFP+ Memory Map for details on how information is structured
2235          * and accessible.
2236          */
2237         switch (epp->ep_fixed_port_type) {
2238         case EFX_PHY_MEDIA_SFP_PLUS:
2239                 /*
2240                  * In accordance with SFF-8472 Diagnostic Monitoring
2241                  * Interface for Optical Transceivers section 4 Memory
2242                  * Organization two 2-wire addresses are defined.
2243                  */
2244                 switch (dev_addr) {
2245                 /* Base information */
2246                 case EFX_PHY_MEDIA_INFO_DEV_ADDR_SFP_BASE:
2247                         /*
2248                          * MCDI page 0 should be used to access lower
2249                          * page 0 (0x00 - 0x7f) at the device address 0xA0.
2250                          */
2251                         mcdi_lower_page = 0;
2252                         /*
2253                          * MCDI page 1 should be used to access  upper
2254                          * page 0 (0x80 - 0xff) at the device address 0xA0.
2255                          */
2256                         mcdi_upper_page = 1;
2257                         break;
2258                 /* Diagnostics */
2259                 case EFX_PHY_MEDIA_INFO_DEV_ADDR_SFP_DDM:
2260                         /*
2261                          * MCDI page 2 should be used to access lower
2262                          * page 0 (0x00 - 0x7f) at the device address 0xA2.
2263                          */
2264                         mcdi_lower_page = 2;
2265                         /*
2266                          * MCDI page 3 should be used to access upper
2267                          * page 0 (0x80 - 0xff) at the device address 0xA2.
2268                          */
2269                         mcdi_upper_page = 3;
2270                         break;
2271                 default:
2272                         rc = ENOTSUP;
2273                         goto fail1;
2274                 }
2275                 break;
2276         case EFX_PHY_MEDIA_QSFP_PLUS:
2277                 switch (dev_addr) {
2278                 case EFX_PHY_MEDIA_INFO_DEV_ADDR_QSFP:
2279                         /*
2280                          * MCDI page -1 should be used to access lower page 0
2281                          * (0x00 - 0x7f).
2282                          */
2283                         mcdi_lower_page = (uint32_t)-1;
2284                         /*
2285                          * MCDI page 0 should be used to access upper page 0
2286                          * (0x80h - 0xff).
2287                          */
2288                         mcdi_upper_page = 0;
2289                         break;
2290                 default:
2291                         rc = ENOTSUP;
2292                         goto fail1;
2293                 }
2294                 break;
2295         default:
2296                 rc = ENOTSUP;
2297                 goto fail1;
2298         }
2299
2300         if (offset < EFX_PHY_MEDIA_INFO_PAGE_SIZE) {
2301                 uint8_t read_len =
2302                     MIN(len, EFX_PHY_MEDIA_INFO_PAGE_SIZE - offset);
2303
2304                 rc = efx_mcdi_get_phy_media_info(enp,
2305                     mcdi_lower_page, offset, read_len, data);
2306                 if (rc != 0)
2307                         goto fail2;
2308
2309                 data += read_len;
2310                 len -= read_len;
2311
2312                 offset = 0;
2313         } else {
2314                 offset -= EFX_PHY_MEDIA_INFO_PAGE_SIZE;
2315         }
2316
2317         if (len > 0) {
2318                 EFSYS_ASSERT3U(len, <=, EFX_PHY_MEDIA_INFO_PAGE_SIZE);
2319                 EFSYS_ASSERT3U(offset, <, EFX_PHY_MEDIA_INFO_PAGE_SIZE);
2320
2321                 rc = efx_mcdi_get_phy_media_info(enp,
2322                     mcdi_upper_page, offset, len, data);
2323                 if (rc != 0)
2324                         goto fail3;
2325         }
2326
2327         return (0);
2328
2329 fail3:
2330         EFSYS_PROBE(fail3);
2331 fail2:
2332         EFSYS_PROBE(fail2);
2333 fail1:
2334         EFSYS_PROBE1(fail1, efx_rc_t, rc);
2335
2336         return (rc);
2337 }
2338
2339 #endif  /* EFSYS_OPT_MCDI */