xref: /freebsd/sys/dev/iwm/if_iwm_config.h (revision e8d8bef961a50d4dc22501cde4fb9fb0be1b2532)
1 /*-
2  * Based on BSD-licensed source modules in the Linux iwlwifi driver,
3  * which were used as the reference documentation for this implementation.
4  *
5  ******************************************************************************
6  *
7  * This file is provided under a dual BSD/GPLv2 license.  When using or
8  * redistributing this file, you may do so under either license.
9  *
10  * GPL LICENSE SUMMARY
11  *
12  * Copyright(c) 2007 - 2014 Intel Corporation. All rights reserved.
13  * Copyright (C) 2016 Intel Deutschland GmbH
14  *
15  * This program is free software; you can redistribute it and/or modify
16  * it under the terms of version 2 of the GNU General Public License as
17  * published by the Free Software Foundation.
18  *
19  * This program is distributed in the hope that it will be useful, but
20  * WITHOUT ANY WARRANTY; without even the implied warranty of
21  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
22  * General Public License for more details.
23  *
24  * You should have received a copy of the GNU General Public License
25  * along with this program; if not, write to the Free Software
26  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110,
27  * USA
28  *
29  * The full GNU General Public License is included in this distribution
30  * in the file called COPYING.
31  *
32  * Contact Information:
33  *  Intel Linux Wireless <linuxwifi@intel.com>
34  * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
35  *
36  * BSD LICENSE
37  *
38  * Copyright(c) 2005 - 2014 Intel Corporation. All rights reserved.
39  * Copyright (C) 2016 Intel Deutschland GmbH
40  * All rights reserved.
41  *
42  * Redistribution and use in source and binary forms, with or without
43  * modification, are permitted provided that the following conditions
44  * are met:
45  *
46  *  * Redistributions of source code must retain the above copyright
47  *    notice, this list of conditions and the following disclaimer.
48  *  * Redistributions in binary form must reproduce the above copyright
49  *    notice, this list of conditions and the following disclaimer in
50  *    the documentation and/or other materials provided with the
51  *    distribution.
52  *  * Neither the name Intel Corporation nor the names of its
53  *    contributors may be used to endorse or promote products derived
54  *    from this software without specific prior written permission.
55  *
56  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
57  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
58  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
59  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
60  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
61  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
62  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
63  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
64  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
65  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
66  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
67  *
68  *****************************************************************************/
69 
70 /*
71  * $FreeBSD$
72  */
73 
74 #ifndef __IWM_CONFIG_H__
75 #define __IWM_CONFIG_H__
76 
77 enum iwm_device_family {
78 	IWM_DEVICE_FAMILY_UNDEFINED,
79 	IWM_DEVICE_FAMILY_7000,
80 	IWM_DEVICE_FAMILY_8000,
81 	IWM_DEVICE_FAMILY_9000,
82 };
83 
84 #define IWM_DEFAULT_MAX_TX_POWER	22
85 
86 /* Antenna presence definitions */
87 #define	IWM_ANT_NONE	0x0
88 #define	IWM_ANT_A	(1 << 0)
89 #define	IWM_ANT_B	(1 << 1)
90 #define IWM_ANT_C	(1 << 2)
91 #define	IWM_ANT_AB	(IWM_ANT_A | IWM_ANT_B)
92 #define	IWM_ANT_AC	(IWM_ANT_A | IWM_ANT_C)
93 #define IWM_ANT_BC	(IWM_ANT_B | IWM_ANT_C)
94 #define IWM_ANT_ABC	(IWM_ANT_A | IWM_ANT_B | IWM_ANT_C)
95 
96 static inline uint8_t num_of_ant(uint8_t mask)
97 {
98 	return  !!((mask) & IWM_ANT_A) +
99 		!!((mask) & IWM_ANT_B) +
100 		!!((mask) & IWM_ANT_C);
101 }
102 
103 /* lower blocks contain EEPROM image and calibration data */
104 #define IWM_OTP_LOW_IMAGE_SIZE_FAMILY_7000	(16 * 512 * sizeof(uint16_t)) /* 16 KB */
105 #define IWM_OTP_LOW_IMAGE_SIZE_FAMILY_8000	(32 * 512 * sizeof(uint16_t)) /* 32 KB */
106 #define IWM_OTP_LOW_IMAGE_SIZE_FAMILY_9000	IWM_OTP_LOW_IMAGE_SIZE_FAMILY_8000
107 
108 
109 /**
110  * enum iwl_nvm_type - nvm formats
111  * @IWM_NVM: the regular format
112  * @IWM_NVM_EXT: extended NVM format
113  * @IWM_NVM_SDP: NVM format used by 3168 series
114  */
115 enum iwm_nvm_type {
116 	IWM_NVM,
117 	IWM_NVM_EXT,
118 	IWM_NVM_SDP,
119 };
120 
121 /**
122  * struct iwm_cfg
123  * @name: Official name of the device
124  * @fw_name: Firmware filename.
125  * @host_interrupt_operation_mode: device needs host interrupt operation
126  *      mode set
127  * @nvm_hw_section_num: the ID of the HW NVM section
128  * @apmg_wake_up_wa: should the MAC access REQ be asserted when a command
129  *      is in flight. This is due to a HW bug in 7260, 3160 and 7265.
130  * @nvm_type: see &enum iwl_nvm_type
131  */
132 struct iwm_cfg {
133 	const char *name;
134 	const char *fw_name;
135 	uint16_t eeprom_size;
136 	enum iwm_device_family device_family;
137 	int host_interrupt_operation_mode;
138 	int mqrx_supported;
139 	int integrated;
140 	uint8_t nvm_hw_section_num;
141 	int apmg_wake_up_wa;
142 	enum iwm_nvm_type nvm_type;
143 };
144 
145 /*
146  * This list declares the config structures for all devices.
147  */
148 extern const struct iwm_cfg iwm7260_cfg;
149 extern const struct iwm_cfg iwm3160_cfg;
150 extern const struct iwm_cfg iwm3165_cfg;
151 extern const struct iwm_cfg iwm3168_cfg;
152 extern const struct iwm_cfg iwm7265_cfg;
153 extern const struct iwm_cfg iwm7265d_cfg;
154 extern const struct iwm_cfg iwm8260_cfg;
155 extern const struct iwm_cfg iwm8265_cfg;
156 extern const struct iwm_cfg iwm9560_cfg;
157 extern const struct iwm_cfg iwm9260_cfg;
158 
159 #endif /* __IWM_CONFIG_H__ */
160