Commit | Line | Data |
---|---|---|
1bd3cbc1 EG |
1 | /****************************************************************************** |
2 | * | |
3 | * This file is provided under a dual BSD/GPLv2 license. When using or | |
4 | * redistributing this file, you may do so under either license. | |
5 | * | |
6 | * GPL LICENSE SUMMARY | |
7 | * | |
8 | * Copyright(c) 2014 Intel Corporation. All rights reserved. | |
9 | * | |
10 | * This program is free software; you can redistribute it and/or modify | |
11 | * it under the terms of version 2 of the GNU General Public License as | |
12 | * published by the Free Software Foundation. | |
13 | * | |
14 | * This program is distributed in the hope that it will be useful, but | |
15 | * WITHOUT ANY WARRANTY; without even the implied warranty of | |
16 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
17 | * General Public License for more details. | |
18 | * | |
19 | * You should have received a copy of the GNU General Public License | |
20 | * along with this program; if not, write to the Free Software | |
21 | * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110, | |
22 | * USA | |
23 | * | |
24 | * The full GNU General Public License is included in this distribution | |
25 | * in the file called COPYING. | |
26 | * | |
27 | * Contact Information: | |
28 | * Intel Linux Wireless <ilw@linux.intel.com> | |
29 | * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497 | |
30 | * | |
31 | * BSD LICENSE | |
32 | * | |
33 | * Copyright(c) 2014 Intel Corporation. All rights reserved. | |
34 | * All rights reserved. | |
35 | * | |
36 | * Redistribution and use in source and binary forms, with or without | |
37 | * modification, are permitted provided that the following conditions | |
38 | * are met: | |
39 | * | |
40 | * * Redistributions of source code must retain the above copyright | |
41 | * notice, this list of conditions and the following disclaimer. | |
42 | * * Redistributions in binary form must reproduce the above copyright | |
43 | * notice, this list of conditions and the following disclaimer in | |
44 | * the documentation and/or other materials provided with the | |
45 | * distribution. | |
46 | * * Neither the name Intel Corporation nor the names of its | |
47 | * contributors may be used to endorse or promote products derived | |
48 | * from this software without specific prior written permission. | |
49 | * | |
50 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS | |
51 | * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT | |
52 | * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR | |
53 | * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT | |
54 | * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, | |
55 | * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT | |
56 | * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | |
57 | * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | |
58 | * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
59 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE | |
60 | * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
61 | *****************************************************************************/ | |
62 | ||
63 | #ifndef __fw_error_dump_h__ | |
64 | #define __fw_error_dump_h__ | |
65 | ||
66 | #include <linux/types.h> | |
67 | ||
68 | #define IWL_FW_ERROR_DUMP_BARKER 0x14789632 | |
69 | ||
70 | /** | |
71 | * enum iwl_fw_error_dump_type - types of data in the dump file | |
72 | * @IWL_FW_ERROR_DUMP_SRAM: | |
73 | * @IWL_FW_ERROR_DUMP_REG: | |
7b445f35 | 74 | * @IWL_FW_ERROR_DUMP_RXF: |
4d075007 JB |
75 | * @IWL_FW_ERROR_DUMP_TXCMD: last TX command data, structured as |
76 | * &struct iwl_fw_error_dump_txcmd packets | |
06ddbf5a EG |
77 | * @IWL_FW_ERROR_DUMP_DEV_FW_INFO: struct %iwl_fw_error_dump_info |
78 | * info on the device / firmware. | |
1bd3cbc1 EG |
79 | */ |
80 | enum iwl_fw_error_dump_type { | |
81 | IWL_FW_ERROR_DUMP_SRAM = 0, | |
82 | IWL_FW_ERROR_DUMP_REG = 1, | |
7b445f35 | 83 | IWL_FW_ERROR_DUMP_RXF = 2, |
4d075007 | 84 | IWL_FW_ERROR_DUMP_TXCMD = 3, |
06ddbf5a | 85 | IWL_FW_ERROR_DUMP_DEV_FW_INFO = 4, |
1bd3cbc1 EG |
86 | |
87 | IWL_FW_ERROR_DUMP_MAX, | |
88 | }; | |
89 | ||
90 | /** | |
91 | * struct iwl_fw_error_dump_data - data for one type | |
92 | * @type: %enum iwl_fw_error_dump_type | |
93 | * @len: the length starting from %data - must be a multiplier of 4. | |
94 | * @data: the data itself padded to be a multiplier of 4. | |
95 | */ | |
96 | struct iwl_fw_error_dump_data { | |
97 | __le32 type; | |
98 | __le32 len; | |
99 | __u8 data[]; | |
7b445f35 | 100 | } __packed; |
1bd3cbc1 EG |
101 | |
102 | /** | |
103 | * struct iwl_fw_error_dump_file - the layout of the header of the file | |
104 | * @barker: must be %IWL_FW_ERROR_DUMP_BARKER | |
105 | * @file_len: the length of all the file starting from %barker | |
106 | * @data: array of %struct iwl_fw_error_dump_data | |
107 | */ | |
108 | struct iwl_fw_error_dump_file { | |
109 | __le32 barker; | |
110 | __le32 file_len; | |
111 | u8 data[0]; | |
7b445f35 | 112 | } __packed; |
1bd3cbc1 | 113 | |
4d075007 JB |
114 | /** |
115 | * struct iwl_fw_error_dump_txcmd - TX command data | |
116 | * @cmdlen: original length of command | |
117 | * @caplen: captured length of command (may be less) | |
118 | * @data: captured command data, @caplen bytes | |
119 | */ | |
120 | struct iwl_fw_error_dump_txcmd { | |
121 | __le32 cmdlen; | |
122 | __le32 caplen; | |
123 | u8 data[]; | |
124 | } __packed; | |
125 | ||
06ddbf5a EG |
126 | enum iwl_fw_error_dump_family { |
127 | IWL_FW_ERROR_DUMP_FAMILY_7 = 7, | |
128 | IWL_FW_ERROR_DUMP_FAMILY_8 = 8, | |
129 | }; | |
130 | ||
131 | /** | |
132 | * struct iwl_fw_error_dump_info - info on the device / firmware | |
133 | * @device_family: the family of the device (7 / 8) | |
134 | * @hw_step: the step of the device | |
135 | * @fw_human_readable: human readable FW version | |
136 | * @dev_human_readable: name of the device | |
137 | * @bus_human_readable: name of the bus used | |
138 | */ | |
139 | struct iwl_fw_error_dump_info { | |
140 | __le32 device_family; | |
141 | __le32 hw_step; | |
142 | u8 fw_human_readable[FW_VER_HUMAN_READABLE_SZ]; | |
143 | u8 dev_human_readable[64]; | |
144 | u8 bus_human_readable[8]; | |
145 | } __packed; | |
146 | ||
4d075007 | 147 | /** |
1fa16056 | 148 | * iwl_fw_error_next_data - advance fw error dump data pointer |
4d075007 JB |
149 | * @data: previous data block |
150 | * Returns: next data block | |
151 | */ | |
152 | static inline struct iwl_fw_error_dump_data * | |
1fa16056 | 153 | iwl_fw_error_next_data(struct iwl_fw_error_dump_data *data) |
4d075007 JB |
154 | { |
155 | return (void *)(data->data + le32_to_cpu(data->len)); | |
156 | } | |
157 | ||
1bd3cbc1 | 158 | #endif /* __fw_error_dump_h__ */ |