1 /*- 2 * Copyright (c) 2009-2015 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 * $FreeBSD$ 31 */ 32 33 #ifndef _SYS_EFX_MCDI_H 34 #define _SYS_EFX_MCDI_H 35 36 #include "efx.h" 37 #include "efx_regs.h" 38 #include "efx_regs_mcdi.h" 39 40 #ifdef __cplusplus 41 extern "C" { 42 #endif 43 44 /* 45 * A reboot/assertion causes the MCDI status word to be set after the 46 * command word is set or a REBOOT event is sent. If we notice a reboot 47 * via these mechanisms then wait 10ms for the status word to be set. 48 */ 49 #define EFX_MCDI_STATUS_SLEEP_US 10000 50 51 struct efx_mcdi_req_s { 52 boolean_t emr_quiet; 53 /* Inputs: Command #, input buffer and length */ 54 unsigned int emr_cmd; 55 uint8_t *emr_in_buf; 56 size_t emr_in_length; 57 /* Outputs: retcode, buffer, length, and length used*/ 58 int emr_rc; 59 uint8_t *emr_out_buf; 60 size_t emr_out_length; 61 size_t emr_out_length_used; 62 }; 63 64 typedef struct efx_mcdi_iface_s { 65 unsigned int emi_port; 66 unsigned int emi_seq; 67 efx_mcdi_req_t *emi_pending_req; 68 boolean_t emi_ev_cpl; 69 boolean_t emi_new_epoch; 70 int emi_aborted; 71 uint32_t emi_poll_cnt; 72 uint32_t emi_mc_reboot_status; 73 } efx_mcdi_iface_t; 74 75 extern void 76 efx_mcdi_execute( 77 __in efx_nic_t *enp, 78 __inout efx_mcdi_req_t *emrp); 79 80 extern void 81 efx_mcdi_execute_quiet( 82 __in efx_nic_t *enp, 83 __inout efx_mcdi_req_t *emrp); 84 85 extern void 86 efx_mcdi_ev_cpl( 87 __in efx_nic_t *enp, 88 __in unsigned int seq, 89 __in unsigned int outlen, 90 __in int errcode); 91 92 extern void 93 efx_mcdi_ev_death( 94 __in efx_nic_t *enp, 95 __in int rc); 96 97 extern __checkReturn efx_rc_t 98 efx_mcdi_request_errcode( 99 __in unsigned int err); 100 101 extern void 102 efx_mcdi_raise_exception( 103 __in efx_nic_t *enp, 104 __in_opt efx_mcdi_req_t *emrp, 105 __in int rc); 106 107 typedef enum efx_mcdi_boot_e { 108 EFX_MCDI_BOOT_PRIMARY, 109 EFX_MCDI_BOOT_SECONDARY, 110 EFX_MCDI_BOOT_ROM, 111 } efx_mcdi_boot_t; 112 113 extern __checkReturn efx_rc_t 114 efx_mcdi_version( 115 __in efx_nic_t *enp, 116 __out_ecount_opt(4) uint16_t versionp[4], 117 __out_opt uint32_t *buildp, 118 __out_opt efx_mcdi_boot_t *statusp); 119 120 extern __checkReturn efx_rc_t 121 efx_mcdi_read_assertion( 122 __in efx_nic_t *enp); 123 124 extern __checkReturn efx_rc_t 125 efx_mcdi_exit_assertion_handler( 126 __in efx_nic_t *enp); 127 128 extern __checkReturn efx_rc_t 129 efx_mcdi_drv_attach( 130 __in efx_nic_t *enp, 131 __in boolean_t attach); 132 133 extern __checkReturn efx_rc_t 134 efx_mcdi_get_board_cfg( 135 __in efx_nic_t *enp, 136 __out_opt uint32_t *board_typep, 137 __out_opt efx_dword_t *capabilitiesp, 138 __out_ecount_opt(6) uint8_t mac_addrp[6]); 139 140 extern __checkReturn efx_rc_t 141 efx_mcdi_get_phy_cfg( 142 __in efx_nic_t *enp); 143 144 extern __checkReturn efx_rc_t 145 efx_mcdi_firmware_update_supported( 146 __in efx_nic_t *enp, 147 __out boolean_t *supportedp); 148 149 extern __checkReturn efx_rc_t 150 efx_mcdi_macaddr_change_supported( 151 __in efx_nic_t *enp, 152 __out boolean_t *supportedp); 153 154 extern __checkReturn efx_rc_t 155 efx_mcdi_link_control_supported( 156 __in efx_nic_t *enp, 157 __out boolean_t *supportedp); 158 159 #if EFSYS_OPT_BIST 160 #if EFSYS_OPT_HUNTINGTON 161 extern __checkReturn efx_rc_t 162 efx_mcdi_bist_enable_offline( 163 __in efx_nic_t *enp); 164 #endif /* EFSYS_OPT_HUNTINGTON */ 165 extern __checkReturn efx_rc_t 166 efx_mcdi_bist_start( 167 __in efx_nic_t *enp, 168 __in efx_bist_type_t type); 169 #endif /* EFSYS_OPT_BIST */ 170 171 extern __checkReturn efx_rc_t 172 efx_mcdi_get_resource_limits( 173 __in efx_nic_t *enp, 174 __out_opt uint32_t *nevqp, 175 __out_opt uint32_t *nrxqp, 176 __out_opt uint32_t *ntxqp); 177 178 extern __checkReturn efx_rc_t 179 efx_mcdi_log_ctrl( 180 __in efx_nic_t *enp); 181 182 extern __checkReturn efx_rc_t 183 efx_mcdi_mac_stats_clear( 184 __in efx_nic_t *enp); 185 186 extern __checkReturn efx_rc_t 187 efx_mcdi_mac_stats_upload( 188 __in efx_nic_t *enp, 189 __in efsys_mem_t *esmp); 190 191 extern __checkReturn efx_rc_t 192 efx_mcdi_mac_stats_periodic( 193 __in efx_nic_t *enp, 194 __in efsys_mem_t *esmp, 195 __in uint16_t period, 196 __in boolean_t events); 197 198 199 #if EFSYS_OPT_LOOPBACK 200 extern __checkReturn efx_rc_t 201 efx_mcdi_get_loopback_modes( 202 __in efx_nic_t *enp); 203 #endif /* EFSYS_OPT_LOOPBACK */ 204 205 #define MCDI_IN(_emr, _type, _ofst) \ 206 ((_type *)((_emr).emr_in_buf + (_ofst))) 207 208 #define MCDI_IN2(_emr, _type, _ofst) \ 209 MCDI_IN(_emr, _type, MC_CMD_ ## _ofst ## _OFST) 210 211 #define MCDI_IN_SET_BYTE(_emr, _ofst, _value) \ 212 EFX_POPULATE_BYTE_1(*MCDI_IN2(_emr, efx_byte_t, _ofst), \ 213 EFX_BYTE_0, _value) 214 215 #define MCDI_IN_SET_WORD(_emr, _ofst, _value) \ 216 EFX_POPULATE_WORD_1(*MCDI_IN2(_emr, efx_word_t, _ofst), \ 217 EFX_WORD_0, _value) 218 219 #define MCDI_IN_SET_DWORD(_emr, _ofst, _value) \ 220 EFX_POPULATE_DWORD_1(*MCDI_IN2(_emr, efx_dword_t, _ofst), \ 221 EFX_DWORD_0, _value) 222 223 #define MCDI_IN_SET_DWORD_FIELD(_emr, _ofst, _field, _value) \ 224 EFX_SET_DWORD_FIELD(*MCDI_IN2(_emr, efx_dword_t, _ofst), \ 225 MC_CMD_ ## _field, _value) 226 227 #define MCDI_IN_POPULATE_DWORD_1(_emr, _ofst, _field1, _value1) \ 228 EFX_POPULATE_DWORD_1(*MCDI_IN2(_emr, efx_dword_t, _ofst), \ 229 MC_CMD_ ## _field1, _value1) 230 231 #define MCDI_IN_POPULATE_DWORD_2(_emr, _ofst, _field1, _value1, \ 232 _field2, _value2) \ 233 EFX_POPULATE_DWORD_2(*MCDI_IN2(_emr, efx_dword_t, _ofst), \ 234 MC_CMD_ ## _field1, _value1, \ 235 MC_CMD_ ## _field2, _value2) 236 237 #define MCDI_IN_POPULATE_DWORD_3(_emr, _ofst, _field1, _value1, \ 238 _field2, _value2, _field3, _value3) \ 239 EFX_POPULATE_DWORD_3(*MCDI_IN2(_emr, efx_dword_t, _ofst), \ 240 MC_CMD_ ## _field1, _value1, \ 241 MC_CMD_ ## _field2, _value2, \ 242 MC_CMD_ ## _field3, _value3) 243 244 #define MCDI_IN_POPULATE_DWORD_4(_emr, _ofst, _field1, _value1, \ 245 _field2, _value2, _field3, _value3, _field4, _value4) \ 246 EFX_POPULATE_DWORD_4(*MCDI_IN2(_emr, efx_dword_t, _ofst), \ 247 MC_CMD_ ## _field1, _value1, \ 248 MC_CMD_ ## _field2, _value2, \ 249 MC_CMD_ ## _field3, _value3, \ 250 MC_CMD_ ## _field4, _value4) 251 252 #define MCDI_IN_POPULATE_DWORD_5(_emr, _ofst, _field1, _value1, \ 253 _field2, _value2, _field3, _value3, _field4, _value4, \ 254 _field5, _value5) \ 255 EFX_POPULATE_DWORD_5(*MCDI_IN2(_emr, efx_dword_t, _ofst), \ 256 MC_CMD_ ## _field1, _value1, \ 257 MC_CMD_ ## _field2, _value2, \ 258 MC_CMD_ ## _field3, _value3, \ 259 MC_CMD_ ## _field4, _value4, \ 260 MC_CMD_ ## _field5, _value5) 261 262 #define MCDI_IN_POPULATE_DWORD_6(_emr, _ofst, _field1, _value1, \ 263 _field2, _value2, _field3, _value3, _field4, _value4, \ 264 _field5, _value5, _field6, _value6) \ 265 EFX_POPULATE_DWORD_6(*MCDI_IN2(_emr, efx_dword_t, _ofst), \ 266 MC_CMD_ ## _field1, _value1, \ 267 MC_CMD_ ## _field2, _value2, \ 268 MC_CMD_ ## _field3, _value3, \ 269 MC_CMD_ ## _field4, _value4, \ 270 MC_CMD_ ## _field5, _value5, \ 271 MC_CMD_ ## _field6, _value6) 272 273 #define MCDI_IN_POPULATE_DWORD_7(_emr, _ofst, _field1, _value1, \ 274 _field2, _value2, _field3, _value3, _field4, _value4, \ 275 _field5, _value5, _field6, _value6, _field7, _value7) \ 276 EFX_POPULATE_DWORD_7(*MCDI_IN2(_emr, efx_dword_t, _ofst), \ 277 MC_CMD_ ## _field1, _value1, \ 278 MC_CMD_ ## _field2, _value2, \ 279 MC_CMD_ ## _field3, _value3, \ 280 MC_CMD_ ## _field4, _value4, \ 281 MC_CMD_ ## _field5, _value5, \ 282 MC_CMD_ ## _field6, _value6, \ 283 MC_CMD_ ## _field7, _value7) 284 285 #define MCDI_IN_POPULATE_DWORD_8(_emr, _ofst, _field1, _value1, \ 286 _field2, _value2, _field3, _value3, _field4, _value4, \ 287 _field5, _value5, _field6, _value6, _field7, _value7, \ 288 _field8, _value8) \ 289 EFX_POPULATE_DWORD_8(*MCDI_IN2(_emr, efx_dword_t, _ofst), \ 290 MC_CMD_ ## _field1, _value1, \ 291 MC_CMD_ ## _field2, _value2, \ 292 MC_CMD_ ## _field3, _value3, \ 293 MC_CMD_ ## _field4, _value4, \ 294 MC_CMD_ ## _field5, _value5, \ 295 MC_CMD_ ## _field6, _value6, \ 296 MC_CMD_ ## _field7, _value7, \ 297 MC_CMD_ ## _field8, _value8) 298 299 #define MCDI_IN_POPULATE_DWORD_9(_emr, _ofst, _field1, _value1, \ 300 _field2, _value2, _field3, _value3, _field4, _value4, \ 301 _field5, _value5, _field6, _value6, _field7, _value7, \ 302 _field8, _value8, _field9, _value9) \ 303 EFX_POPULATE_DWORD_9(*MCDI_IN2(_emr, efx_dword_t, _ofst), \ 304 MC_CMD_ ## _field1, _value1, \ 305 MC_CMD_ ## _field2, _value2, \ 306 MC_CMD_ ## _field3, _value3, \ 307 MC_CMD_ ## _field4, _value4, \ 308 MC_CMD_ ## _field5, _value5, \ 309 MC_CMD_ ## _field6, _value6, \ 310 MC_CMD_ ## _field7, _value7, \ 311 MC_CMD_ ## _field8, _value8, \ 312 MC_CMD_ ## _field9, _value9) 313 314 #define MCDI_IN_POPULATE_DWORD_10(_emr, _ofst, _field1, _value1, \ 315 _field2, _value2, _field3, _value3, _field4, _value4, \ 316 _field5, _value5, _field6, _value6, _field7, _value7, \ 317 _field8, _value8, _field9, _value9, _field10, _value10) \ 318 EFX_POPULATE_DWORD_10(*MCDI_IN2(_emr, efx_dword_t, _ofst), \ 319 MC_CMD_ ## _field1, _value1, \ 320 MC_CMD_ ## _field2, _value2, \ 321 MC_CMD_ ## _field3, _value3, \ 322 MC_CMD_ ## _field4, _value4, \ 323 MC_CMD_ ## _field5, _value5, \ 324 MC_CMD_ ## _field6, _value6, \ 325 MC_CMD_ ## _field7, _value7, \ 326 MC_CMD_ ## _field8, _value8, \ 327 MC_CMD_ ## _field9, _value9, \ 328 MC_CMD_ ## _field10, _value10) 329 330 #define MCDI_OUT(_emr, _type, _ofst) \ 331 ((_type *)((_emr).emr_out_buf + (_ofst))) 332 333 #define MCDI_OUT2(_emr, _type, _ofst) \ 334 MCDI_OUT(_emr, _type, MC_CMD_ ## _ofst ## _OFST) 335 336 #define MCDI_OUT_BYTE(_emr, _ofst) \ 337 EFX_BYTE_FIELD(*MCDI_OUT2(_emr, efx_byte_t, _ofst), \ 338 EFX_BYTE_0) 339 340 #define MCDI_OUT_WORD(_emr, _ofst) \ 341 EFX_WORD_FIELD(*MCDI_OUT2(_emr, efx_word_t, _ofst), \ 342 EFX_WORD_0) 343 344 #define MCDI_OUT_DWORD(_emr, _ofst) \ 345 EFX_DWORD_FIELD(*MCDI_OUT2(_emr, efx_dword_t, _ofst), \ 346 EFX_DWORD_0) 347 348 #define MCDI_OUT_DWORD_FIELD(_emr, _ofst, _field) \ 349 EFX_DWORD_FIELD(*MCDI_OUT2(_emr, efx_dword_t, _ofst), \ 350 MC_CMD_ ## _field) 351 352 #define MCDI_EV_FIELD(_eqp, _field) \ 353 EFX_QWORD_FIELD(*_eqp, MCDI_EVENT_ ## _field) 354 355 #define MCDI_CMD_DWORD_FIELD(_edp, _field) \ 356 EFX_DWORD_FIELD(*_edp, MC_CMD_ ## _field) 357 358 #ifdef __cplusplus 359 } 360 #endif 361 362 #endif /* _SYS_EFX_MCDI_H */ 363