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) 2018 - 2019 Intel Corporation
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.
21  *
22  * The full GNU General Public License is included in this distribution
23  * in the file called COPYING.
24  *
25  * Contact Information:
26  *  Intel Linux Wireless <linuxwifi@intel.com>
27  * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
28  *
29  * BSD LICENSE
30  *
31  * Copyright (C) 2018 - 2019 Intel Corporation
32  * All rights reserved.
33  *
34  * Redistribution and use in source and binary forms, with or without
35  * modification, are permitted provided that the following conditions
36  * are met:
37  *
38  *  * Redistributions of source code must retain the above copyright
39  *    notice, this list of conditions and the following disclaimer.
40  *  * Redistributions in binary form must reproduce the above copyright
41  *    notice, this list of conditions and the following disclaimer in
42  *    the documentation and/or other materials provided with the
43  *    distribution.
44  *  * Neither the name Intel Corporation nor the names of its
45  *    contributors may be used to endorse or promote products derived
46  *    from this software without specific prior written permission.
47  *
48  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
49  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
50  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
51  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
52  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
53  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
54  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
55  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
56  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
57  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
58  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
59  *
60  *****************************************************************************/
61 #ifndef __iwl_dbg_tlv_h__
62 #define __iwl_dbg_tlv_h__
63 
64 #include <linux/device.h>
65 #include <linux/types.h>
66 
67 /**
68  * struct iwl_dbg_tlv_node - debug TLV node
69  * @list: list of &struct iwl_dbg_tlv_node
70  * @tlv: debug TLV
71  */
72 struct iwl_dbg_tlv_node {
73 	struct list_head list;
74 	struct iwl_ucode_tlv tlv;
75 };
76 
77 /**
78  * union iwl_dbg_tlv_tp_data - data that is given in a time point
79  * @fw_pkt: a packet received from the FW
80  */
81 union iwl_dbg_tlv_tp_data {
82 	struct iwl_rx_packet *fw_pkt;
83 };
84 
85 /**
86  * struct iwl_dbg_tlv_time_point_data
87  * @trig_list: list of triggers
88  * @active_trig_list: list of active triggers
89  * @hcmd_list: list of host commands
90  */
91 struct iwl_dbg_tlv_time_point_data {
92 	struct list_head trig_list;
93 	struct list_head active_trig_list;
94 	struct list_head hcmd_list;
95 };
96 
97 struct iwl_trans;
98 struct iwl_fw_runtime;
99 
100 void iwl_dbg_tlv_load_bin(struct device *dev, struct iwl_trans *trans);
101 void iwl_dbg_tlv_free(struct iwl_trans *trans);
102 void iwl_dbg_tlv_alloc(struct iwl_trans *trans, struct iwl_ucode_tlv *tlv,
103 		       bool ext);
104 void iwl_dbg_tlv_init(struct iwl_trans *trans);
105 void iwl_dbg_tlv_time_point(struct iwl_fw_runtime *fwrt,
106 			    enum iwl_fw_ini_time_point tp_id,
107 			    union iwl_dbg_tlv_tp_data *tp_data);
108 void iwl_dbg_tlv_del_timers(struct iwl_trans *trans);
109 
110 #endif /* __iwl_dbg_tlv_h__*/
111