drivers/net/sfc/base/efx_mcdi.c

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