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) 2017 Intel Deutschland GmbH
9 * Copyright(c) 2018 - 2019 Intel Corporation
10 *
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of version 2 of the GNU General Public License as
13 * published by the Free Software Foundation.
14 *
15 * This program is distributed in the hope that it will be useful, but
16 * WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 * General Public License for more details.
19 *
20 * The full GNU General Public License is included in this distribution
21 * in the file called COPYING.
22 *
23 * Contact Information:
24 * Intel Linux Wireless <linuxwifi@intel.com>
25 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
26 *
27 * BSD LICENSE
28 *
29 * Copyright(c) 2017 Intel Deutschland GmbH
30 * Copyright(c) 2018 - 2019 Intel Corporation
31 * All rights reserved.
32 *
33 * Redistribution and use in source and binary forms, with or without
34 * modification, are permitted provided that the following conditions
35 * are met:
36 *
37 * * Redistributions of source code must retain the above copyright
38 * notice, this list of conditions and the following disclaimer.
39 * * Redistributions in binary form must reproduce the above copyright
40 * notice, this list of conditions and the following disclaimer in
41 * the documentation and/or other materials provided with the
42 * distribution.
43 * * Neither the name Intel Corporation nor the names of its
44 * contributors may be used to endorse or promote products derived
45 * from this software without specific prior written permission.
46 *
47 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
48 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
49 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
50 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
51 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
52 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
53 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
54 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
55 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
56 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
57 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
58 *
59 *****************************************************************************/
60 #ifndef __iwl_fw_acpi__
61 #define __iwl_fw_acpi__
62
63 #include <linux/acpi.h>
64
65 #define ACPI_WRDS_METHOD "WRDS"
66 #define ACPI_EWRD_METHOD "EWRD"
67 #define ACPI_WGDS_METHOD "WGDS"
68 #define ACPI_WRDD_METHOD "WRDD"
69 #define ACPI_SPLC_METHOD "SPLC"
70 #define ACPI_ECKV_METHOD "ECKV"
71 #define ACPI_PPAG_METHOD "PPAG"
72
73 #define ACPI_WIFI_DOMAIN (0x07)
74
75 #define ACPI_SAR_TABLE_SIZE 10
76 #define ACPI_SAR_PROFILE_NUM 4
77
78 #define ACPI_GEO_TABLE_SIZE 6
79 #define ACPI_NUM_GEO_PROFILES 3
80 #define ACPI_GEO_PER_CHAIN_SIZE 3
81
82 #define ACPI_SAR_NUM_CHAIN_LIMITS 2
83 #define ACPI_SAR_NUM_SUB_BANDS 5
84
85 #define ACPI_WRDS_WIFI_DATA_SIZE (ACPI_SAR_TABLE_SIZE + 2)
86 #define ACPI_EWRD_WIFI_DATA_SIZE ((ACPI_SAR_PROFILE_NUM - 1) * \
87 ACPI_SAR_TABLE_SIZE + 3)
88 #define ACPI_WGDS_WIFI_DATA_SIZE 19
89 #define ACPI_WRDD_WIFI_DATA_SIZE 2
90 #define ACPI_SPLC_WIFI_DATA_SIZE 2
91 #define ACPI_ECKV_WIFI_DATA_SIZE 2
92
93 #define ACPI_WGDS_NUM_BANDS 2
94 #define ACPI_WGDS_TABLE_SIZE 3
95
96 #define ACPI_PPAG_NUM_CHAINS 2
97 #define ACPI_PPAG_NUM_SUB_BANDS 5
98 #define ACPI_PPAG_WIFI_DATA_SIZE ((ACPI_PPAG_NUM_CHAINS * \
99 ACPI_PPAG_NUM_SUB_BANDS) + 3)
100
101 /* PPAG gain value bounds in 1/8 dBm */
102 #define ACPI_PPAG_MIN_LB -16
103 #define ACPI_PPAG_MAX_LB 24
104 #define ACPI_PPAG_MIN_HB -16
105 #define ACPI_PPAG_MAX_HB 40
106
107 #ifdef CONFIG_ACPI
108
109 void *iwl_acpi_get_object(struct device *dev, acpi_string method);
110 union acpi_object *iwl_acpi_get_wifi_pkg(struct device *dev,
111 union acpi_object *data,
112 int data_size, int *tbl_rev);
113
114 /**
115 * iwl_acpi_get_mcc - read MCC from ACPI, if available
116 *
117 * @dev: the struct device
118 * @mcc: output buffer (3 bytes) that will get the MCC
119 *
120 * This function tries to read the current MCC from ACPI if available.
121 */
122 int iwl_acpi_get_mcc(struct device *dev, char *mcc);
123
124 u64 iwl_acpi_get_pwr_limit(struct device *dev);
125
126 /*
127 * iwl_acpi_get_eckv - read external clock validation from ACPI, if available
128 *
129 * @dev: the struct device
130 * @extl_clk: output var (2 bytes) that will get the clk indication.
131 *
132 * This function tries to read the external clock indication
133 * from ACPI if available.
134 */
135 int iwl_acpi_get_eckv(struct device *dev, u32 *extl_clk);
136
137 #else /* CONFIG_ACPI */
138
139 static inline void *iwl_acpi_get_object(struct device *dev, acpi_string method)
140 {
141 return ERR_PTR(-ENOENT);
142 }
143
144 static inline union acpi_object *iwl_acpi_get_wifi_pkg(struct device *dev,
145 union acpi_object *data,
146 int data_size,
147 int *tbl_rev)
148 {
149 return ERR_PTR(-ENOENT);
150 }
151
152 static inline int iwl_acpi_get_mcc(struct device *dev, char *mcc)
153 {
154 return -ENOENT;
155 }
156
157 static inline u64 iwl_acpi_get_pwr_limit(struct device *dev)
158 {
159 return 0;
160 }
161
162 static inline int iwl_acpi_get_eckv(struct device *dev, u32 *extl_clk)
163 {
164 return -ENOENT;
165 }
166
167 #endif /* CONFIG_ACPI */
168 #endif /* __iwl_fw_acpi__ */