drivers/net/wireless/intel/iwlwifi/fw/acpi.h

   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__ */