1 /**************************************************************************** 2 * Driver for Solarflare Solarstorm network controllers and boards 3 * Copyright 2008-2010 Solarflare Communications Inc. 4 * 5 * This program is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 as published 7 * by the Free Software Foundation, incorporated herein by reference. 8 */ 9 10 #ifndef EFX_MCDI_H 11 #define EFX_MCDI_H 12 13 /** 14 * enum efx_mcdi_state 15 * @MCDI_STATE_QUIESCENT: No pending MCDI requests. If the caller holds the 16 * mcdi_lock then they are able to move to MCDI_STATE_RUNNING 17 * @MCDI_STATE_RUNNING: There is an MCDI request pending. Only the thread that 18 * moved into this state is allowed to move out of it. 19 * @MCDI_STATE_COMPLETED: An MCDI request has completed, but the owning thread 20 * has not yet consumed the result. For all other threads, equivalent to 21 * MCDI_STATE_RUNNING. 22 */ 23 enum efx_mcdi_state { 24 MCDI_STATE_QUIESCENT, 25 MCDI_STATE_RUNNING, 26 MCDI_STATE_COMPLETED, 27 }; 28 29 enum efx_mcdi_mode { 30 MCDI_MODE_POLL, 31 MCDI_MODE_EVENTS, 32 }; 33 34 /** 35 * struct efx_mcdi_iface 36 * @state: Interface state. Waited for by mcdi_wq. 37 * @wq: Wait queue for threads waiting for state != STATE_RUNNING 38 * @iface_lock: Protects @credits, @seqno, @resprc, @resplen 39 * @mode: Poll for mcdi completion, or wait for an mcdi_event. 40 * Serialised by @lock 41 * @seqno: The next sequence number to use for mcdi requests. 42 * Serialised by @lock 43 * @credits: Number of spurious MCDI completion events allowed before we 44 * trigger a fatal error. Protected by @lock 45 * @resprc: Returned MCDI completion 46 * @resplen: Returned payload length 47 */ 48 struct efx_mcdi_iface { 49 atomic_t state; 50 wait_queue_head_t wq; 51 spinlock_t iface_lock; 52 enum efx_mcdi_mode mode; 53 unsigned int credits; 54 unsigned int seqno; 55 unsigned int resprc; 56 size_t resplen; 57 }; 58 59 struct efx_mcdi_mon { 60 struct efx_buffer dma_buf; 61 struct mutex update_lock; 62 unsigned long last_update; 63 struct device *device; 64 struct efx_mcdi_mon_attribute *attrs; 65 unsigned int n_attrs; 66 }; 67 68 extern void efx_mcdi_init(struct efx_nic *efx); 69 70 extern int efx_mcdi_rpc(struct efx_nic *efx, unsigned cmd, const u8 *inbuf, 71 size_t inlen, u8 *outbuf, size_t outlen, 72 size_t *outlen_actual); 73 74 extern int efx_mcdi_poll_reboot(struct efx_nic *efx); 75 extern void efx_mcdi_mode_poll(struct efx_nic *efx); 76 extern void efx_mcdi_mode_event(struct efx_nic *efx); 77 78 extern void efx_mcdi_process_event(struct efx_channel *channel, 79 efx_qword_t *event); 80 extern void efx_mcdi_sensor_event(struct efx_nic *efx, efx_qword_t *ev); 81 82 #define MCDI_PTR2(_buf, _ofst) \ 83 (((u8 *)_buf) + _ofst) 84 #define MCDI_SET_DWORD2(_buf, _ofst, _value) \ 85 EFX_POPULATE_DWORD_1(*((efx_dword_t *)MCDI_PTR2(_buf, _ofst)), \ 86 EFX_DWORD_0, _value) 87 #define MCDI_DWORD2(_buf, _ofst) \ 88 EFX_DWORD_FIELD(*((efx_dword_t *)MCDI_PTR2(_buf, _ofst)), \ 89 EFX_DWORD_0) 90 #define MCDI_QWORD2(_buf, _ofst) \ 91 EFX_QWORD_FIELD64(*((efx_qword_t *)MCDI_PTR2(_buf, _ofst)), \ 92 EFX_QWORD_0) 93 94 #define MCDI_PTR(_buf, _ofst) \ 95 MCDI_PTR2(_buf, MC_CMD_ ## _ofst ## _OFST) 96 #define MCDI_ARRAY_PTR(_buf, _field, _type, _index) \ 97 MCDI_PTR2(_buf, \ 98 MC_CMD_ ## _field ## _OFST + \ 99 (_index) * MC_CMD_ ## _type ## _TYPEDEF_LEN) 100 #define MCDI_SET_DWORD(_buf, _ofst, _value) \ 101 MCDI_SET_DWORD2(_buf, MC_CMD_ ## _ofst ## _OFST, _value) 102 #define MCDI_DWORD(_buf, _ofst) \ 103 MCDI_DWORD2(_buf, MC_CMD_ ## _ofst ## _OFST) 104 #define MCDI_QWORD(_buf, _ofst) \ 105 MCDI_QWORD2(_buf, MC_CMD_ ## _ofst ## _OFST) 106 107 #define MCDI_EVENT_FIELD(_ev, _field) \ 108 EFX_QWORD_FIELD(_ev, MCDI_EVENT_ ## _field) 109 #define MCDI_ARRAY_FIELD(_buf, _field1, _type, _index, _field2) \ 110 EFX_DWORD_FIELD( \ 111 *((efx_dword_t *) \ 112 (MCDI_ARRAY_PTR(_buf, _field1, _type, _index) + \ 113 (MC_CMD_ ## _type ## _TYPEDEF_ ## _field2 ## _OFST & ~3))), \ 114 MC_CMD_ ## _type ## _TYPEDEF_ ## _field2) 115 116 extern void efx_mcdi_print_fwver(struct efx_nic *efx, char *buf, size_t len); 117 extern int efx_mcdi_drv_attach(struct efx_nic *efx, bool driver_operating, 118 bool *was_attached_out); 119 extern int efx_mcdi_get_board_cfg(struct efx_nic *efx, u8 *mac_address, 120 u16 *fw_subtype_list, u32 *capabilities); 121 extern int efx_mcdi_log_ctrl(struct efx_nic *efx, bool evq, bool uart, 122 u32 dest_evq); 123 extern int efx_mcdi_nvram_types(struct efx_nic *efx, u32 *nvram_types_out); 124 extern int efx_mcdi_nvram_info(struct efx_nic *efx, unsigned int type, 125 size_t *size_out, size_t *erase_size_out, 126 bool *protected_out); 127 extern int efx_mcdi_nvram_update_start(struct efx_nic *efx, 128 unsigned int type); 129 extern int efx_mcdi_nvram_read(struct efx_nic *efx, unsigned int type, 130 loff_t offset, u8 *buffer, size_t length); 131 extern int efx_mcdi_nvram_write(struct efx_nic *efx, unsigned int type, 132 loff_t offset, const u8 *buffer, 133 size_t length); 134 #define EFX_MCDI_NVRAM_LEN_MAX 128 135 extern int efx_mcdi_nvram_erase(struct efx_nic *efx, unsigned int type, 136 loff_t offset, size_t length); 137 extern int efx_mcdi_nvram_update_finish(struct efx_nic *efx, 138 unsigned int type); 139 extern int efx_mcdi_nvram_test_all(struct efx_nic *efx); 140 extern int efx_mcdi_handle_assertion(struct efx_nic *efx); 141 extern void efx_mcdi_set_id_led(struct efx_nic *efx, enum efx_led_mode mode); 142 extern int efx_mcdi_reset_port(struct efx_nic *efx); 143 extern int efx_mcdi_reset_mc(struct efx_nic *efx); 144 extern int efx_mcdi_wol_filter_set_magic(struct efx_nic *efx, 145 const u8 *mac, int *id_out); 146 extern int efx_mcdi_wol_filter_get_magic(struct efx_nic *efx, int *id_out); 147 extern int efx_mcdi_wol_filter_remove(struct efx_nic *efx, int id); 148 extern int efx_mcdi_wol_filter_reset(struct efx_nic *efx); 149 extern int efx_mcdi_flush_rxqs(struct efx_nic *efx); 150 extern int efx_mcdi_set_mac(struct efx_nic *efx); 151 extern int efx_mcdi_mac_stats(struct efx_nic *efx, dma_addr_t dma_addr, 152 u32 dma_len, int enable, int clear); 153 extern int efx_mcdi_mac_reconfigure(struct efx_nic *efx); 154 extern bool efx_mcdi_mac_check_fault(struct efx_nic *efx); 155 156 #ifdef CONFIG_SFC_MCDI_MON 157 extern int efx_mcdi_mon_probe(struct efx_nic *efx); 158 extern void efx_mcdi_mon_remove(struct efx_nic *efx); 159 #else 160 static inline int efx_mcdi_mon_probe(struct efx_nic *efx) { return 0; } 161 static inline void efx_mcdi_mon_remove(struct efx_nic *efx) {} 162 #endif 163 164 #endif /* EFX_MCDI_H */ 165