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 #include "fw/api/commands.h" 65 #include "fw/api/power.h" 66 #include "fw/api/phy.h" 67 #include "fw/img.h" 68 #include "iwl-trans.h" 69 70 71 #define ACPI_WRDS_METHOD "WRDS" 72 #define ACPI_EWRD_METHOD "EWRD" 73 #define ACPI_WGDS_METHOD "WGDS" 74 #define ACPI_WRDD_METHOD "WRDD" 75 #define ACPI_SPLC_METHOD "SPLC" 76 #define ACPI_ECKV_METHOD "ECKV" 77 #define ACPI_PPAG_METHOD "PPAG" 78 79 #define ACPI_WIFI_DOMAIN (0x07) 80 81 #define ACPI_SAR_TABLE_SIZE 10 82 #define ACPI_SAR_PROFILE_NUM 4 83 84 #define ACPI_GEO_TABLE_SIZE 6 85 #define ACPI_NUM_GEO_PROFILES 3 86 #define ACPI_GEO_PER_CHAIN_SIZE 3 87 88 #define ACPI_SAR_NUM_CHAIN_LIMITS 2 89 #define ACPI_SAR_NUM_SUB_BANDS 5 90 91 #define ACPI_WRDS_WIFI_DATA_SIZE (ACPI_SAR_TABLE_SIZE + 2) 92 #define ACPI_EWRD_WIFI_DATA_SIZE ((ACPI_SAR_PROFILE_NUM - 1) * \ 93 ACPI_SAR_TABLE_SIZE + 3) 94 #define ACPI_WGDS_WIFI_DATA_SIZE 19 95 #define ACPI_WRDD_WIFI_DATA_SIZE 2 96 #define ACPI_SPLC_WIFI_DATA_SIZE 2 97 #define ACPI_ECKV_WIFI_DATA_SIZE 2 98 99 #define ACPI_WGDS_NUM_BANDS 2 100 #define ACPI_WGDS_TABLE_SIZE 3 101 102 #define ACPI_PPAG_NUM_CHAINS 2 103 #define ACPI_PPAG_NUM_SUB_BANDS 5 104 #define ACPI_PPAG_WIFI_DATA_SIZE ((ACPI_PPAG_NUM_CHAINS * \ 105 ACPI_PPAG_NUM_SUB_BANDS) + 3) 106 107 /* PPAG gain value bounds in 1/8 dBm */ 108 #define ACPI_PPAG_MIN_LB -16 109 #define ACPI_PPAG_MAX_LB 24 110 #define ACPI_PPAG_MIN_HB -16 111 #define ACPI_PPAG_MAX_HB 40 112 113 struct iwl_sar_profile { 114 bool enabled; 115 u8 table[ACPI_SAR_TABLE_SIZE]; 116 }; 117 118 struct iwl_geo_profile { 119 u8 values[ACPI_GEO_TABLE_SIZE]; 120 }; 121 122 #ifdef CONFIG_ACPI 123 124 struct iwl_fw_runtime; 125 126 void *iwl_acpi_get_object(struct device *dev, acpi_string method); 127 128 union acpi_object *iwl_acpi_get_wifi_pkg(struct device *dev, 129 union acpi_object *data, 130 int data_size, int *tbl_rev); 131 132 /** 133 * iwl_acpi_get_mcc - read MCC from ACPI, if available 134 * 135 * @dev: the struct device 136 * @mcc: output buffer (3 bytes) that will get the MCC 137 * 138 * This function tries to read the current MCC from ACPI if available. 139 */ 140 int iwl_acpi_get_mcc(struct device *dev, char *mcc); 141 142 u64 iwl_acpi_get_pwr_limit(struct device *dev); 143 144 /* 145 * iwl_acpi_get_eckv - read external clock validation from ACPI, if available 146 * 147 * @dev: the struct device 148 * @extl_clk: output var (2 bytes) that will get the clk indication. 149 * 150 * This function tries to read the external clock indication 151 * from ACPI if available. 152 */ 153 int iwl_acpi_get_eckv(struct device *dev, u32 *extl_clk); 154 155 int iwl_sar_set_profile(union acpi_object *table, 156 struct iwl_sar_profile *profile, 157 bool enabled); 158 159 int iwl_sar_select_profile(struct iwl_fw_runtime *fwrt, 160 __le16 per_chain_restriction[][IWL_NUM_SUB_BANDS], 161 int prof_a, int prof_b); 162 163 int iwl_sar_get_wrds_table(struct iwl_fw_runtime *fwrt); 164 165 int iwl_sar_get_ewrd_table(struct iwl_fw_runtime *fwrt); 166 167 int iwl_sar_get_wgds_table(struct iwl_fw_runtime *fwrt); 168 169 bool iwl_sar_geo_support(struct iwl_fw_runtime *fwrt); 170 171 int iwl_validate_sar_geo_profile(struct iwl_fw_runtime *fwrt, 172 struct iwl_host_cmd *cmd); 173 174 void iwl_sar_geo_init(struct iwl_fw_runtime *fwrt, 175 struct iwl_per_chain_offset_group *table); 176 #else /* CONFIG_ACPI */ 177 178 static inline void *iwl_acpi_get_object(struct device *dev, acpi_string method) 179 { 180 return ERR_PTR(-ENOENT); 181 } 182 183 static inline union acpi_object *iwl_acpi_get_wifi_pkg(struct device *dev, 184 union acpi_object *data, 185 int data_size, 186 int *tbl_rev) 187 { 188 return ERR_PTR(-ENOENT); 189 } 190 191 static inline int iwl_acpi_get_mcc(struct device *dev, char *mcc) 192 { 193 return -ENOENT; 194 } 195 196 static inline u64 iwl_acpi_get_pwr_limit(struct device *dev) 197 { 198 return 0; 199 } 200 201 static inline int iwl_acpi_get_eckv(struct device *dev, u32 *extl_clk) 202 { 203 return -ENOENT; 204 } 205 206 static inline int iwl_sar_set_profile(union acpi_object *table, 207 struct iwl_sar_profile *profile, 208 bool enabled) 209 { 210 return -ENOENT; 211 } 212 213 static inline int iwl_sar_select_profile(struct iwl_fw_runtime *fwrt, 214 __le16 per_chain_restriction[][IWL_NUM_SUB_BANDS], 215 int prof_a, int prof_b) 216 { 217 return -ENOENT; 218 } 219 220 static inline int iwl_sar_get_wrds_table(struct iwl_fw_runtime *fwrt) 221 { 222 return -ENOENT; 223 } 224 225 static inline int iwl_sar_get_ewrd_table(struct iwl_fw_runtime *fwrt) 226 { 227 return -ENOENT; 228 } 229 230 static inline int iwl_sar_get_wgds_table(struct iwl_fw_runtime *fwrt) 231 { 232 return -ENOENT; 233 } 234 235 static inline bool iwl_sar_geo_support(struct iwl_fw_runtime *fwrt) 236 { 237 return false; 238 } 239 240 static inline int iwl_validate_sar_geo_profile(struct iwl_fw_runtime *fwrt, 241 struct iwl_host_cmd *cmd) 242 { 243 return -ENOENT; 244 } 245 246 static inline void iwl_sar_geo_init(struct iwl_fw_runtime *fwrt, 247 struct iwl_per_chain_offset_group *table) 248 { 249 } 250 251 #endif /* CONFIG_ACPI */ 252 #endif /* __iwl_fw_acpi__ */ 253