iwlwifi/fw/error-dump.h

14  * it under the terms of version 2 of the GNU General Public License as
18  * WITHOUT ANY WARRANTY; without even the implied warranty of
41  *  * Redistributions of source code must retain the above copyright
42  *    notice, this list of conditions and the following disclaimer.
44  *    notice, this list of conditions and the following disclaimer in
47  *  * Neither the name Intel Corporation nor the names of its
53  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
57  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
59  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
60  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
61  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
74  * enum iwl_fw_error_dump_type - types of data in the dump file
82  * @IWL_FW_ERROR_DUMP_PRPH: range of periphery registers - there can be several
84  * @IWL_FW_ERROR_DUMP_FH_REGS: range of FH registers
85  * @IWL_FW_ERROR_DUMP_MEM: chunk of memory
86  * @IWL_FW_ERROR_DUMP_ERROR_INFO: description of what triggered this dump.
88  * @IWL_FW_ERROR_DUMP_RB: the content of an RB structured as
96  * @IWL_FW_ERROR_DUMP_MEM_CFG: the addresses and sizes of fifos in the smem,
136  * struct iwl_fw_error_dump_file - the layout of the header of the file
138  * @file_len: the length of all the file starting from %barker
139  * @data: array of &struct iwl_fw_error_dump_data
149  * @cmdlen: original length of command
150  * @caplen: captured length of command (may be less)
161  * @fifo_num: number of FIFO (starting from 0)
162  * @available_bytes: num of bytes available in FIFO (may be less than FIFO size)
163  * @wr_ptr: position of write pointer
164  * @rd_ptr: position of read pointer
165  * @fence_ptr: position of fence pointer
166  * @fence_mode: the current mode of the fence (before locking) -
168  * @data: all of the FIFO's data
189  * @hw_type: the type of the device
190  * @hw_step: the step of the device
192  * @dev_human_readable: name of the device
193  * @bus_human_readable: name of the bus used
194  * @num_of_lmacs: the number of lmacs
213  * @fw_mon_wr_ptr: the position of the write pointer in the cyclic buffer
214  * @fw_mon_base_ptr: base pointer of the data
215  * @fw_mon_cycle_cnt: number of wraparounds
237  * @num_lmacs: number of lmacs
238  * @num_txfifo_entries: number of tx fifos
239  * @lmac: sizes of lmacs txfifos and rxfifo1
240  * @rxfifo2_size: size of rxfifo2
241  * @internal_txfifo_addr: address of internal tx fifo
242  * @internal_txfifo_size: size of internal tx fifo
257  * @prph_start: address of the first register in this chunk
258  * @data: the content of the registers
272  * struct iwl_fw_error_dump_mem - chunk of memory
275  * @data: the content of the memory
293  * @list: list of dump entries
294  * @size: size of the data
304  * struct iwl_fw_error_dump_file - header of dump file
306  * @file_len: the length of all the file including the header
315  * @fifo_num: the fifo number. In case of umac rx fifo, set BIT(31) to
317  * @num_of_registers: num of registers to dump, dword size each
325  * struct iwl_fw_ini_error_dump_range - range of memory
326  * @range_data_size: the size of this range, in bytes
327  * @internal_base_addr: base address of internal memory range
328  * @dram_base_addr: base address of dram monitor range
329  * @page_num: page number of memory range
330  * @fifo_hdr: fifo header of memory range
331  * @fw_pkt: FW packet header of memory range
349  * @region_id: id of the region
350  * @num_of_ranges: number of ranges in this region
351  * @name_len: number of bytes allocated to the name string of this region
352  * @name: name of the region
364  * @header: the header of this region
365  * @ranges: the memory ranges of this region
377  * @addr: address of the register
378  * @data: data of the register
388  * @cfg_name_len: length of the configuration name
389  * @cfg_name: name of the configuraiton
399 /* How many bits to roll when adding to the HW type of AX210 HW */
409  * @trigger_reason: reason of the trigger
424  * @regions_mask: bitmap mask of regions ids in the dump
425  * @build_tag_len: length of the build tag
427  * @num_of_cfg_names: number of configuration name structs
457  * @header: header of the region
459  * @ranges: the memory ranges of this this region
468  * struct iwl_fw_error_dump_rb - content of an Receive Buffer
469  * @index: the index of the Receive Buffer in the Rx queue
472  * @data: the content of the Receive Buffer
483  * @header: header of the region
487  * @ranges: the memory ranges of this this region
499  * @header: header of the region
500  * @type: type of special memory
502  * @ranges: the memory ranges of this this region
512  * struct iwl_fw_error_dump_paging - content of the UMAC's image page
514  * @index: the index of the page block
516  * @data: the content of the page block
550  * @FW_DBG_TRIGGER_RSSI: trigger log collection when the rssi of the beacon