| 1 |
/* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */ |
| 2 |
/* |
| 3 |
* Copyright (C) 2014, 2018-2025 Intel Corporation |
| 4 |
* Copyright (C) 2014-2015 Intel Mobile Communications GmbH |
| 5 |
* Copyright (C) 2016-2017 Intel Deutschland GmbH |
| 6 |
*/ |
| 7 |
#ifndef __fw_error_dump_h__ |
| 8 |
#define __fw_error_dump_h__ |
| 9 |
|
| 10 |
#include <linux/types.h> |
| 11 |
#include "fw/api/cmdhdr.h" |
| 12 |
|
| 13 |
#define IWL_FW_ERROR_DUMP_BARKER 0x14789632 |
| 14 |
#define IWL_FW_INI_ERROR_DUMP_BARKER 0x14789633 |
| 15 |
|
| 16 |
/** |
| 17 |
* enum iwl_fw_error_dump_type - types of data in the dump file |
| 18 |
* @IWL_FW_ERROR_DUMP_CSR: Control Status Registers - from offset 0 |
| 19 |
* @IWL_FW_ERROR_DUMP_RXF: RX FIFO contents |
| 20 |
* @IWL_FW_ERROR_DUMP_TXCMD: last TX command data, structured as |
| 21 |
* &struct iwl_fw_error_dump_txcmd packets |
| 22 |
* @IWL_FW_ERROR_DUMP_DEV_FW_INFO: struct %iwl_fw_error_dump_info |
| 23 |
* info on the device / firmware. |
| 24 |
* @IWL_FW_ERROR_DUMP_FW_MONITOR: firmware monitor |
| 25 |
* @IWL_FW_ERROR_DUMP_PRPH: range of periphery registers - there can be several |
| 26 |
* sections like this in a single file. |
| 27 |
* @IWL_FW_ERROR_DUMP_TXF: TX FIFO contents |
| 28 |
* @IWL_FW_ERROR_DUMP_FH_REGS: range of FH registers |
| 29 |
* @IWL_FW_ERROR_DUMP_MEM: chunk of memory |
| 30 |
* @IWL_FW_ERROR_DUMP_ERROR_INFO: description of what triggered this dump. |
| 31 |
* Structured as &struct iwl_fw_error_dump_trigger_desc. |
| 32 |
* @IWL_FW_ERROR_DUMP_RB: the content of an RB structured as |
| 33 |
* &struct iwl_fw_error_dump_rb |
| 34 |
* @IWL_FW_ERROR_DUMP_PAGING: UMAC's image memory segments which were |
| 35 |
* paged to the DRAM. |
| 36 |
* @IWL_FW_ERROR_DUMP_RADIO_REG: Dump the radio registers. |
| 37 |
* @IWL_FW_ERROR_DUMP_INTERNAL_TXF: internal TX FIFO data |
| 38 |
* @IWL_FW_ERROR_DUMP_EXTERNAL: used only by external code utilities, and |
| 39 |
* for that reason is not in use in any other place in the Linux Wi-Fi |
| 40 |
* stack. |
| 41 |
* @IWL_FW_ERROR_DUMP_MEM_CFG: the addresses and sizes of fifos in the smem, |
| 42 |
* which we get from the fw after ALIVE. The content is structured as |
| 43 |
* &struct iwl_fw_error_dump_smem_cfg. |
| 44 |
* @IWL_FW_ERROR_DUMP_D3_DEBUG_DATA: D3 debug data |
| 45 |
*/ |
| 46 |
enum iwl_fw_error_dump_type { |
| 47 |
/* 0 is deprecated */ |
| 48 |
IWL_FW_ERROR_DUMP_CSR = 1, |
| 49 |
IWL_FW_ERROR_DUMP_RXF = 2, |
| 50 |
IWL_FW_ERROR_DUMP_TXCMD = 3, |
| 51 |
IWL_FW_ERROR_DUMP_DEV_FW_INFO = 4, |
| 52 |
IWL_FW_ERROR_DUMP_FW_MONITOR = 5, |
| 53 |
IWL_FW_ERROR_DUMP_PRPH = 6, |
| 54 |
IWL_FW_ERROR_DUMP_TXF = 7, |
| 55 |
IWL_FW_ERROR_DUMP_FH_REGS = 8, |
| 56 |
IWL_FW_ERROR_DUMP_MEM = 9, |
| 57 |
IWL_FW_ERROR_DUMP_ERROR_INFO = 10, |
| 58 |
IWL_FW_ERROR_DUMP_RB = 11, |
| 59 |
IWL_FW_ERROR_DUMP_PAGING = 12, |
| 60 |
IWL_FW_ERROR_DUMP_RADIO_REG = 13, |
| 61 |
IWL_FW_ERROR_DUMP_INTERNAL_TXF = 14, |
| 62 |
IWL_FW_ERROR_DUMP_EXTERNAL = 15, /* Do not move */ |
| 63 |
IWL_FW_ERROR_DUMP_MEM_CFG = 16, |
| 64 |
IWL_FW_ERROR_DUMP_D3_DEBUG_DATA = 17, |
| 65 |
}; |
| 66 |
|
| 67 |
/** |
| 68 |
* struct iwl_fw_error_dump_data - data for one type |
| 69 |
* @type: &enum iwl_fw_error_dump_type |
| 70 |
* @len: the length starting from %data |
| 71 |
* @data: the data itself |
| 72 |
*/ |
| 73 |
struct iwl_fw_error_dump_data { |
| 74 |
__le32 type; |
| 75 |
__le32 len; |
| 76 |
__u8 data[]; |
| 77 |
} __packed; |
| 78 |
|
| 79 |
/** |
| 80 |
* struct iwl_dump_file_name_info - data for dump file name addition |
| 81 |
* @type: region type with reserved bits |
| 82 |
* @len: the length of file name string to be added to dump file |
| 83 |
* @data: the string need to be added to dump file |
| 84 |
*/ |
| 85 |
struct iwl_dump_file_name_info { |
| 86 |
__le32 type; |
| 87 |
__le32 len; |
| 88 |
__u8 data[]; |
| 89 |
} __packed; |
| 90 |
|
| 91 |
/** |
| 92 |
* struct iwl_fw_error_dump_file - the layout of the header of the file |
| 93 |
* @barker: must be %IWL_FW_ERROR_DUMP_BARKER |
| 94 |
* @file_len: the length of all the file starting from %barker |
| 95 |
* @data: array of &struct iwl_fw_error_dump_data |
| 96 |
*/ |
| 97 |
struct iwl_fw_error_dump_file { |
| 98 |
__le32 barker; |
| 99 |
__le32 file_len; |
| 100 |
u8 data[]; |
| 101 |
} __packed; |
| 102 |
|
| 103 |
/** |
| 104 |
* struct iwl_fw_error_dump_txcmd - TX command data |
| 105 |
* @cmdlen: original length of command |
| 106 |
* @caplen: captured length of command (may be less) |
| 107 |
* @data: captured command data, @caplen bytes |
| 108 |
*/ |
| 109 |
struct iwl_fw_error_dump_txcmd { |
| 110 |
__le32 cmdlen; |
| 111 |
__le32 caplen; |
| 112 |
u8 data[]; |
| 113 |
} __packed; |
| 114 |
|
| 115 |
/** |
| 116 |
* struct iwl_fw_error_dump_fifo - RX/TX FIFO data |
| 117 |
* @fifo_num: number of FIFO (starting from 0) |
| 118 |
* @available_bytes: num of bytes available in FIFO (may be less than FIFO size) |
| 119 |
* @wr_ptr: position of write pointer |
| 120 |
* @rd_ptr: position of read pointer |
| 121 |
* @fence_ptr: position of fence pointer |
| 122 |
* @fence_mode: the current mode of the fence (before locking) - |
| 123 |
* 0=follow RD pointer ; 1 = freeze |
| 124 |
* @data: all of the FIFO's data |
| 125 |
*/ |
| 126 |
struct iwl_fw_error_dump_fifo { |
| 127 |
__le32 fifo_num; |
| 128 |
__le32 available_bytes; |
| 129 |
__le32 wr_ptr; |
| 130 |
__le32 rd_ptr; |
| 131 |
__le32 fence_ptr; |
| 132 |
__le32 fence_mode; |
| 133 |
u8 data[]; |
| 134 |
} __packed; |
| 135 |
|
| 136 |
enum iwl_fw_error_dump_family { |
| 137 |
IWL_FW_ERROR_DUMP_FAMILY_7 = 7, |
| 138 |
IWL_FW_ERROR_DUMP_FAMILY_8 = 8, |
| 139 |
}; |
| 140 |
|
| 141 |
#define MAX_NUM_LMAC 2 |
| 142 |
|
| 143 |
/** |
| 144 |
* struct iwl_fw_error_dump_info - info on the device / firmware |
| 145 |
* @hw_type: the type of the device |
| 146 |
* @hw_step: the step of the device |
| 147 |
* @fw_human_readable: human readable FW version |
| 148 |
* @dev_human_readable: name of the device |
| 149 |
* @bus_human_readable: name of the bus used |
| 150 |
* @num_of_lmacs: the number of lmacs |
| 151 |
* @lmac_err_id: the lmac 0/1 error_id/rt_status that triggered the latest dump |
| 152 |
* if the dump collection was not initiated by an assert, the value is 0 |
| 153 |
* @umac_err_id: the umac error_id/rt_status that triggered the latest dump |
| 154 |
* if the dump collection was not initiated by an assert, the value is 0 |
| 155 |
*/ |
| 156 |
struct iwl_fw_error_dump_info { |
| 157 |
__le32 hw_type; |
| 158 |
__le32 hw_step; |
| 159 |
u8 fw_human_readable[FW_VER_HUMAN_READABLE_SZ]; |
| 160 |
u8 dev_human_readable[64]; |
| 161 |
u8 bus_human_readable[8]; |
| 162 |
u8 num_of_lmacs; |
| 163 |
__le32 umac_err_id; |
| 164 |
__le32 lmac_err_id[MAX_NUM_LMAC]; |
| 165 |
} __packed; |
| 166 |
|
| 167 |
/** |
| 168 |
* struct iwl_fw_error_dump_fw_mon - FW monitor data |
| 169 |
* @fw_mon_wr_ptr: the position of the write pointer in the cyclic buffer |
| 170 |
* @fw_mon_base_ptr: base pointer of the data |
| 171 |
* @fw_mon_cycle_cnt: number of wraparounds |
| 172 |
* @fw_mon_base_high_ptr: used in AX210 devices, the base address is 64 bit |
| 173 |
* so fw_mon_base_ptr holds LSB 32 bits and fw_mon_base_high_ptr hold |
| 174 |
* MSB 32 bits |
| 175 |
* @reserved: for future use |
| 176 |
* @data: captured data |
| 177 |
*/ |
| 178 |
struct iwl_fw_error_dump_fw_mon { |
| 179 |
__le32 fw_mon_wr_ptr; |
| 180 |
__le32 fw_mon_base_ptr; |
| 181 |
__le32 fw_mon_cycle_cnt; |
| 182 |
__le32 fw_mon_base_high_ptr; |
| 183 |
__le32 reserved[2]; |
| 184 |
u8 data[]; |
| 185 |
} __packed; |
| 186 |
|
| 187 |
#define MAX_NUM_LMAC 2 |
| 188 |
#define TX_FIFO_INTERNAL_MAX_NUM 6 |
| 189 |
#define TX_FIFO_MAX_NUM 15 |
| 190 |
/** |
| 191 |
* struct iwl_fw_error_dump_smem_cfg - Dump SMEM configuration |
| 192 |
* This must follow &struct iwl_fwrt_shared_mem_cfg. |
| 193 |
* @num_lmacs: number of lmacs |
| 194 |
* @num_txfifo_entries: number of tx fifos |
| 195 |
* @lmac: sizes of lmacs txfifos and rxfifo1 |
| 196 |
* @rxfifo2_size: size of rxfifo2 |
| 197 |
* @internal_txfifo_addr: address of internal tx fifo |
| 198 |
* @internal_txfifo_size: size of internal tx fifo |
| 199 |
*/ |
| 200 |
struct iwl_fw_error_dump_smem_cfg { |
| 201 |
__le32 num_lmacs; |
| 202 |
__le32 num_txfifo_entries; |
| 203 |
struct { |
| 204 |
__le32 txfifo_size[TX_FIFO_MAX_NUM]; |
| 205 |
__le32 rxfifo1_size; |
| 206 |
} lmac[MAX_NUM_LMAC]; |
| 207 |
__le32 rxfifo2_size; |
| 208 |
__le32 internal_txfifo_addr; |
| 209 |
__le32 internal_txfifo_size[TX_FIFO_INTERNAL_MAX_NUM]; |
| 210 |
} __packed; |
| 211 |
/** |
| 212 |
* struct iwl_fw_error_dump_prph - periphery registers data |
| 213 |
* @prph_start: address of the first register in this chunk |
| 214 |
* @data: the content of the registers |
| 215 |
*/ |
| 216 |
struct iwl_fw_error_dump_prph { |
| 217 |
__le32 prph_start; |
| 218 |
__le32 data[]; |
| 219 |
}; |
| 220 |
|
| 221 |
enum iwl_fw_error_dump_mem_type { |
| 222 |
IWL_FW_ERROR_DUMP_MEM_SRAM, |
| 223 |
IWL_FW_ERROR_DUMP_MEM_SMEM, |
| 224 |
IWL_FW_ERROR_DUMP_MEM_NAMED_MEM = 10, |
| 225 |
}; |
| 226 |
|
| 227 |
/** |
| 228 |
* struct iwl_fw_error_dump_mem - chunk of memory |
| 229 |
* @type: &enum iwl_fw_error_dump_mem_type |
| 230 |
* @offset: the offset from which the memory was read |
| 231 |
* @data: the content of the memory |
| 232 |
*/ |
| 233 |
struct iwl_fw_error_dump_mem { |
| 234 |
__le32 type; |
| 235 |
__le32 offset; |
| 236 |
u8 data[]; |
| 237 |
}; |
| 238 |
|
| 239 |
/* Dump version, used by the dump parser to differentiate between |
| 240 |
* different dump formats |
| 241 |
*/ |
| 242 |
#define IWL_INI_DUMP_VER 1 |
| 243 |
|
| 244 |
/* Use bit 31 as dump info type to avoid colliding with region types */ |
| 245 |
#define IWL_INI_DUMP_INFO_TYPE BIT(31) |
| 246 |
|
| 247 |
/* Use bit 31 and bit 24 as dump name type to avoid colliding with region types */ |
| 248 |
#define IWL_INI_DUMP_NAME_TYPE (BIT(31) | BIT(24)) |
| 249 |
|
| 250 |
/** |
| 251 |
* struct iwl_fw_ini_error_dump_data - data for one type |
| 252 |
* @type: &enum iwl_fw_ini_region_type |
| 253 |
* @sub_type: sub type id |
| 254 |
* @sub_type_ver: sub type version |
| 255 |
* @reserved: not in use |
| 256 |
* @len: the length starting from %data |
| 257 |
* @data: the data itself |
| 258 |
*/ |
| 259 |
struct iwl_fw_ini_error_dump_data { |
| 260 |
u8 type; |
| 261 |
u8 sub_type; |
| 262 |
u8 sub_type_ver; |
| 263 |
u8 reserved; |
| 264 |
__le32 len; |
| 265 |
__u8 data[]; |
| 266 |
} __packed; |
| 267 |
|
| 268 |
/** |
| 269 |
* struct iwl_fw_ini_dump_entry - dump entry descriptor |
| 270 |
* @list: list of dump entries |
| 271 |
* @size: size of the data |
| 272 |
* @data: entry data |
| 273 |
*/ |
| 274 |
struct iwl_fw_ini_dump_entry { |
| 275 |
struct list_head list; |
| 276 |
u32 size; |
| 277 |
u8 data[]; |
| 278 |
} __packed; |
| 279 |
|
| 280 |
/** |
| 281 |
* struct iwl_fw_ini_dump_file_hdr - header of dump file |
| 282 |
* @barker: must be %IWL_FW_INI_ERROR_DUMP_BARKER |
| 283 |
* @file_len: the length of all the file including the header |
| 284 |
*/ |
| 285 |
struct iwl_fw_ini_dump_file_hdr { |
| 286 |
__le32 barker; |
| 287 |
__le32 file_len; |
| 288 |
} __packed; |
| 289 |
|
| 290 |
/** |
| 291 |
* struct iwl_fw_ini_fifo_hdr - fifo range header |
| 292 |
* @fifo_num: the fifo number. In case of umac rx fifo, set BIT(31) to |
| 293 |
* distinguish between lmac and umac rx fifos |
| 294 |
* @num_of_registers: num of registers to dump, dword size each |
| 295 |
*/ |
| 296 |
struct iwl_fw_ini_fifo_hdr { |
| 297 |
__le32 fifo_num; |
| 298 |
__le32 num_of_registers; |
| 299 |
} __packed; |
| 300 |
|
| 301 |
/** |
| 302 |
* struct iwl_fw_ini_error_dump_range - range of memory |
| 303 |
* @range_data_size: the size of this range, in bytes |
| 304 |
* @internal_base_addr: base address of internal memory range |
| 305 |
* @dram_base_addr: base address of dram monitor range |
| 306 |
* @page_num: page number of memory range |
| 307 |
* @fifo_hdr: fifo header of memory range |
| 308 |
* @fw_pkt_hdr: FW packet header of memory range |
| 309 |
* @data: the actual memory |
| 310 |
*/ |
| 311 |
struct iwl_fw_ini_error_dump_range { |
| 312 |
__le32 range_data_size; |
| 313 |
union { |
| 314 |
__le32 internal_base_addr __packed; |
| 315 |
__le64 dram_base_addr __packed; |
| 316 |
__le32 page_num __packed; |
| 317 |
struct iwl_fw_ini_fifo_hdr fifo_hdr; |
| 318 |
struct iwl_cmd_header fw_pkt_hdr; |
| 319 |
}; |
| 320 |
__le32 data[]; |
| 321 |
} __packed; |
| 322 |
|
| 323 |
/** |
| 324 |
* struct iwl_fw_ini_error_dump_header - ini region dump header |
| 325 |
* @version: dump version |
| 326 |
* @region_id: id of the region |
| 327 |
* @num_of_ranges: number of ranges in this region |
| 328 |
* @name_len: number of bytes allocated to the name string of this region |
| 329 |
* @name: name of the region |
| 330 |
*/ |
| 331 |
struct iwl_fw_ini_error_dump_header { |
| 332 |
__le32 version; |
| 333 |
__le32 region_id; |
| 334 |
__le32 num_of_ranges; |
| 335 |
__le32 name_len; |
| 336 |
u8 name[IWL_FW_INI_MAX_NAME]; |
| 337 |
}; |
| 338 |
|
| 339 |
/** |
| 340 |
* struct iwl_fw_ini_error_dump - ini region dump |
| 341 |
* @header: the header of this region |
| 342 |
* @data: data of memory ranges in this region, |
| 343 |
* see &struct iwl_fw_ini_error_dump_range |
| 344 |
*/ |
| 345 |
struct iwl_fw_ini_error_dump { |
| 346 |
struct iwl_fw_ini_error_dump_header header; |
| 347 |
u8 data[]; |
| 348 |
} __packed; |
| 349 |
|
| 350 |
/* This bit is used to differentiate between lmac and umac rxf */ |
| 351 |
#define IWL_RXF_UMAC_BIT BIT(31) |
| 352 |
|
| 353 |
/** |
| 354 |
* struct iwl_fw_ini_error_dump_register - ini register dump |
| 355 |
* @addr: address of the register |
| 356 |
* @data: data of the register |
| 357 |
*/ |
| 358 |
struct iwl_fw_ini_error_dump_register { |
| 359 |
__le32 addr; |
| 360 |
__le32 data; |
| 361 |
} __packed; |
| 362 |
|
| 363 |
/** |
| 364 |
* struct iwl_fw_ini_dump_cfg_name - configuration name |
| 365 |
* @image_type: image type the configuration is related to |
| 366 |
* @cfg_name_len: length of the configuration name |
| 367 |
* @cfg_name: name of the configuraiton |
| 368 |
*/ |
| 369 |
struct iwl_fw_ini_dump_cfg_name { |
| 370 |
__le32 image_type; |
| 371 |
__le32 cfg_name_len; |
| 372 |
u8 cfg_name[IWL_FW_INI_MAX_CFG_NAME]; |
| 373 |
} __packed; |
| 374 |
|
| 375 |
#define IWL_CDB_MASK(val) val << 13 |
| 376 |
|
| 377 |
|
| 378 |
/* struct iwl_fw_ini_dump_info - ini dump information |
| 379 |
* @version: dump version |
| 380 |
* @time_point: time point that caused the dump collection |
| 381 |
* @trigger_reason: reason of the trigger |
| 382 |
* @external_cfg_state: &enum iwl_ini_cfg_state |
| 383 |
* @ver_type: FW version type |
| 384 |
* @ver_subtype: FW version subype |
| 385 |
* @hw_step: HW step |
| 386 |
* @hw_type: HW type |
| 387 |
* @rf_id_flavor: HW RF id flavor |
| 388 |
* @rf_id_dash: HW RF id dash |
| 389 |
* @rf_id_step: HW RF id step |
| 390 |
* @rf_id_type: HW RF id type |
| 391 |
* @lmac_major: lmac major version |
| 392 |
* @lmac_minor: lmac minor version |
| 393 |
* @umac_major: umac major version |
| 394 |
* @umac_minor: umac minor version |
| 395 |
* @fw_mon_mode: FW monitor mode &enum iwl_fw_ini_buffer_location |
| 396 |
* @regions_mask: bitmap mask of regions ids in the dump |
| 397 |
* @build_tag_len: length of the build tag |
| 398 |
* @build_tag: build tag string |
| 399 |
* @num_of_cfg_names: number of configuration name structs |
| 400 |
* @cfg_names: configuration names |
| 401 |
*/ |
| 402 |
struct iwl_fw_ini_dump_info { |
| 403 |
__le32 version; |
| 404 |
__le32 time_point; |
| 405 |
__le32 trigger_reason; |
| 406 |
__le32 external_cfg_state; |
| 407 |
__le32 ver_type; |
| 408 |
__le32 ver_subtype; |
| 409 |
__le32 hw_step; |
| 410 |
__le32 hw_type; |
| 411 |
__le32 rf_id_flavor; |
| 412 |
__le32 rf_id_dash; |
| 413 |
__le32 rf_id_step; |
| 414 |
__le32 rf_id_type; |
| 415 |
__le32 lmac_major; |
| 416 |
__le32 lmac_minor; |
| 417 |
__le32 umac_major; |
| 418 |
__le32 umac_minor; |
| 419 |
__le32 fw_mon_mode; |
| 420 |
__le64 regions_mask; |
| 421 |
__le32 build_tag_len; |
| 422 |
u8 build_tag[FW_VER_HUMAN_READABLE_SZ]; |
| 423 |
__le32 num_of_cfg_names; |
| 424 |
struct iwl_fw_ini_dump_cfg_name cfg_names[]; |
| 425 |
} __packed; |
| 426 |
|
| 427 |
/** |
| 428 |
* struct iwl_fw_ini_err_table_dump - ini error table dump |
| 429 |
* @header: header of the region |
| 430 |
* @version: error table version |
| 431 |
* @data: data of memory ranges in this region, |
| 432 |
* see &struct iwl_fw_ini_error_dump_range |
| 433 |
*/ |
| 434 |
struct iwl_fw_ini_err_table_dump { |
| 435 |
struct iwl_fw_ini_error_dump_header header; |
| 436 |
__le32 version; |
| 437 |
u8 data[]; |
| 438 |
} __packed; |
| 439 |
|
| 440 |
/** |
| 441 |
* struct iwl_fw_error_dump_rb - content of an Receive Buffer |
| 442 |
* @index: the index of the Receive Buffer in the Rx queue |
| 443 |
* @rxq: the RB's Rx queue |
| 444 |
* @reserved: reserved |
| 445 |
* @data: the content of the Receive Buffer |
| 446 |
*/ |
| 447 |
struct iwl_fw_error_dump_rb { |
| 448 |
__le32 index; |
| 449 |
__le32 rxq; |
| 450 |
__le32 reserved; |
| 451 |
u8 data[]; |
| 452 |
}; |
| 453 |
|
| 454 |
/** |
| 455 |
* struct iwl_fw_ini_monitor_dump - ini monitor dump |
| 456 |
* @header: header of the region |
| 457 |
* @write_ptr: write pointer position in the buffer |
| 458 |
* @cycle_cnt: cycles count |
| 459 |
* @cur_frag: current fragment in use |
| 460 |
* @data: data of memory ranges in this region, |
| 461 |
* see &struct iwl_fw_ini_error_dump_range |
| 462 |
*/ |
| 463 |
struct iwl_fw_ini_monitor_dump { |
| 464 |
struct iwl_fw_ini_error_dump_header header; |
| 465 |
__le32 write_ptr; |
| 466 |
__le32 cycle_cnt; |
| 467 |
__le32 cur_frag; |
| 468 |
u8 data[]; |
| 469 |
} __packed; |
| 470 |
|
| 471 |
/** |
| 472 |
* struct iwl_fw_ini_special_device_memory - special device memory |
| 473 |
* @header: header of the region |
| 474 |
* @type: type of special memory |
| 475 |
* @version: struct special memory version |
| 476 |
* @data: data of memory ranges in this region, |
| 477 |
* see &struct iwl_fw_ini_error_dump_range |
| 478 |
*/ |
| 479 |
struct iwl_fw_ini_special_device_memory { |
| 480 |
struct iwl_fw_ini_error_dump_header header; |
| 481 |
__le16 type; |
| 482 |
__le16 version; |
| 483 |
u8 data[]; |
| 484 |
} __packed; |
| 485 |
|
| 486 |
/** |
| 487 |
* struct iwl_fw_error_dump_paging - content of the UMAC's image page |
| 488 |
* block on DRAM |
| 489 |
* @index: the index of the page block |
| 490 |
* @reserved: reserved |
| 491 |
* @data: the content of the page block |
| 492 |
*/ |
| 493 |
struct iwl_fw_error_dump_paging { |
| 494 |
__le32 index; |
| 495 |
__le32 reserved; |
| 496 |
u8 data[]; |
| 497 |
}; |
| 498 |
|
| 499 |
/** |
| 500 |
* iwl_fw_error_next_data - advance fw error dump data pointer |
| 501 |
* @data: previous data block |
| 502 |
* Returns: next data block |
| 503 |
*/ |
| 504 |
static inline struct iwl_fw_error_dump_data * |
| 505 |
iwl_fw_error_next_data(struct iwl_fw_error_dump_data *data) |
| 506 |
{ |
| 507 |
return (void *)(data->data + le32_to_cpu(data->len)); |
| 508 |
} |
| 509 |
|
| 510 |
/** |
| 511 |
* enum iwl_fw_dbg_trigger - triggers available |
| 512 |
* |
| 513 |
* @FW_DBG_TRIGGER_INVALID: invalid trigger value |
| 514 |
* @FW_DBG_TRIGGER_USER: trigger log collection by user |
| 515 |
* This should not be defined as a trigger to the driver, but a value the |
| 516 |
* driver should set to indicate that the trigger was initiated by the |
| 517 |
* user. |
| 518 |
* @FW_DBG_TRIGGER_FW_ASSERT: trigger log collection when the firmware asserts |
| 519 |
* @FW_DBG_TRIGGER_MISSED_BEACONS: trigger log collection when beacons are |
| 520 |
* missed. |
| 521 |
* @FW_DBG_TRIGGER_CHANNEL_SWITCH: trigger log collection upon channel switch. |
| 522 |
* @FW_DBG_TRIGGER_FW_NOTIF: trigger log collection when the firmware sends a |
| 523 |
* command response or a notification. |
| 524 |
* @FW_DBG_TRIGGER_MLME: trigger log collection upon MLME event. |
| 525 |
* @FW_DBG_TRIGGER_STATS: trigger log collection upon statistics threshold. |
| 526 |
* @FW_DBG_TRIGGER_RSSI: trigger log collection when the rssi of the beacon |
| 527 |
* goes below a threshold. |
| 528 |
* @FW_DBG_TRIGGER_TXQ_TIMERS: configures the timers for the Tx queue hang |
| 529 |
* detection. |
| 530 |
* @FW_DBG_TRIGGER_TIME_EVENT: trigger log collection upon time events related |
| 531 |
* events. |
| 532 |
* @FW_DBG_TRIGGER_BA: trigger log collection upon BlockAck related events. |
| 533 |
* @FW_DBG_TRIGGER_TX_LATENCY: trigger log collection when the tx latency |
| 534 |
* goes above a threshold. |
| 535 |
* @FW_DBG_TRIGGER_TDLS: trigger log collection upon TDLS related events. |
| 536 |
* @FW_DBG_TRIGGER_TX_STATUS: trigger log collection upon tx status when |
| 537 |
* the firmware sends a tx reply. |
| 538 |
* @FW_DBG_TRIGGER_ALIVE_TIMEOUT: trigger log collection if alive flow timeouts |
| 539 |
* @FW_DBG_TRIGGER_DRIVER: trigger log collection upon a flow failure |
| 540 |
* in the driver. |
| 541 |
* @FW_DBG_TRIGGER_MAX: beyond triggers, number for sizing arrays etc. |
| 542 |
*/ |
| 543 |
enum iwl_fw_dbg_trigger { |
| 544 |
FW_DBG_TRIGGER_INVALID = 0, |
| 545 |
FW_DBG_TRIGGER_USER, |
| 546 |
FW_DBG_TRIGGER_FW_ASSERT, |
| 547 |
FW_DBG_TRIGGER_MISSED_BEACONS, |
| 548 |
FW_DBG_TRIGGER_CHANNEL_SWITCH, |
| 549 |
FW_DBG_TRIGGER_FW_NOTIF, |
| 550 |
FW_DBG_TRIGGER_MLME, |
| 551 |
FW_DBG_TRIGGER_STATS, |
| 552 |
FW_DBG_TRIGGER_RSSI, |
| 553 |
FW_DBG_TRIGGER_TXQ_TIMERS, |
| 554 |
FW_DBG_TRIGGER_TIME_EVENT, |
| 555 |
FW_DBG_TRIGGER_BA, |
| 556 |
FW_DBG_TRIGGER_TX_LATENCY, |
| 557 |
FW_DBG_TRIGGER_TDLS, |
| 558 |
FW_DBG_TRIGGER_TX_STATUS, |
| 559 |
FW_DBG_TRIGGER_ALIVE_TIMEOUT, |
| 560 |
FW_DBG_TRIGGER_DRIVER, |
| 561 |
|
| 562 |
/* must be last */ |
| 563 |
FW_DBG_TRIGGER_MAX, |
| 564 |
}; |
| 565 |
|
| 566 |
/** |
| 567 |
* struct iwl_fw_error_dump_trigger_desc - describes the trigger condition |
| 568 |
* @type: &enum iwl_fw_dbg_trigger |
| 569 |
* @data: raw data about what happened |
| 570 |
*/ |
| 571 |
struct iwl_fw_error_dump_trigger_desc { |
| 572 |
__le32 type; |
| 573 |
u8 data[]; |
| 574 |
}; |
| 575 |
|
| 576 |
#endif /* __fw_error_dump_h__ */ |