include/linux/acpi.h

   1 /*
   2  * acpi.h - ACPI Interface
   3  *
   4  * Copyright (C) 2001 Paul Diefenbaugh <paul.s.diefenbaugh@intel.com>
   5  *
   6  * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with this program; if not, write to the Free Software
  20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  21  *
  22  * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  23  */
  24
  25 #ifndef _LINUX_ACPI_H
  26 #define _LINUX_ACPI_H
  27
  28 #include <linux/ioport.h>       /* for struct resource */
  29
  30 #ifdef  CONFIG_ACPI
  31
  32 #ifndef _LINUX
  33 #define _LINUX
  34 #endif
  35
  36 #include <linux/list.h>
  37 #include <linux/mod_devicetable.h>
  38
  39 #include <acpi/acpi.h>
  40 #include <acpi/acpi_bus.h>
  41 #include <acpi/acpi_drivers.h>
  42 #include <acpi/acpi_numa.h>
  43 #include <asm/acpi.h>
  44 #include <linux/dmi.h>
  45
  46
  47 enum acpi_irq_model_id {
  48         ACPI_IRQ_MODEL_PIC = 0,
  49         ACPI_IRQ_MODEL_IOAPIC,
  50         ACPI_IRQ_MODEL_IOSAPIC,
  51         ACPI_IRQ_MODEL_PLATFORM,
  52         ACPI_IRQ_MODEL_COUNT
  53 };
  54
  55 extern enum acpi_irq_model_id   acpi_irq_model;
  56
  57 enum acpi_interrupt_id {
  58         ACPI_INTERRUPT_PMI      = 1,
  59         ACPI_INTERRUPT_INIT,
  60         ACPI_INTERRUPT_CPEI,
  61         ACPI_INTERRUPT_COUNT
  62 };
  63
  64 #define ACPI_SPACE_MEM          0
  65
  66 enum acpi_address_range_id {
  67         ACPI_ADDRESS_RANGE_MEMORY = 1,
  68         ACPI_ADDRESS_RANGE_RESERVED = 2,
  69         ACPI_ADDRESS_RANGE_ACPI = 3,
  70         ACPI_ADDRESS_RANGE_NVS  = 4,
  71         ACPI_ADDRESS_RANGE_COUNT
  72 };
  73
  74
  75 /* Table Handlers */
  76
  77 typedef int (*acpi_table_handler) (struct acpi_table_header *table);
  78
  79 typedef int (*acpi_table_entry_handler) (struct acpi_subtable_header *header, const unsigned long end);
  80
  81 char * __acpi_map_table (unsigned long phys_addr, unsigned long size);
  82 void __acpi_unmap_table(char *map, unsigned long size);
  83 int early_acpi_boot_init(void);
  84 int acpi_boot_init (void);
  85 int acpi_boot_table_init (void);
  86 int acpi_mps_check (void);
  87 int acpi_numa_init (void);
  88
  89 int acpi_table_init (void);
  90 int acpi_table_parse (char *id, acpi_table_handler handler);
  91 int __init acpi_table_parse_entries(char *id, unsigned long table_size,
  92         int entry_id, acpi_table_entry_handler handler, unsigned int max_entries);
  93 int acpi_table_parse_madt (enum acpi_madt_type id, acpi_table_entry_handler handler, unsigned int max_entries);
  94 int acpi_parse_mcfg (struct acpi_table_header *header);
  95 void acpi_table_print_madt_entry (struct acpi_subtable_header *madt);
  96
  97 /* the following four functions are architecture-dependent */
  98 void acpi_numa_slit_init (struct acpi_table_slit *slit);
  99 void acpi_numa_processor_affinity_init (struct acpi_srat_cpu_affinity *pa);
 100 void acpi_numa_x2apic_affinity_init(struct acpi_srat_x2apic_cpu_affinity *pa);
 101 void acpi_numa_memory_affinity_init (struct acpi_srat_mem_affinity *ma);
 102 void acpi_numa_arch_fixup(void);
 103
 104 #ifdef CONFIG_ACPI_HOTPLUG_CPU
 105 /* Arch dependent functions for cpu hotplug support */
 106 int acpi_map_lsapic(acpi_handle handle, int *pcpu);
 107 int acpi_unmap_lsapic(int cpu);
 108 #endif /* CONFIG_ACPI_HOTPLUG_CPU */
 109
 110 int acpi_register_ioapic(acpi_handle handle, u64 phys_addr, u32 gsi_base);
 111 int acpi_unregister_ioapic(acpi_handle handle, u32 gsi_base);
 112 void acpi_irq_stats_init(void);
 113 extern u32 acpi_irq_handled;
 114 extern u32 acpi_irq_not_handled;
 115
 116 extern struct acpi_mcfg_allocation *pci_mmcfg_config;
 117 extern int pci_mmcfg_config_num;
 118
 119 extern int sbf_port;
 120 extern unsigned long acpi_realmode_flags;
 121
 122 int acpi_register_gsi (u32 gsi, int triggering, int polarity);
 123 int acpi_gsi_to_irq (u32 gsi, unsigned int *irq);
 124
 125 #ifdef CONFIG_X86_IO_APIC
 126 extern int acpi_get_override_irq(int bus_irq, int *trigger, int *polarity);
 127 #else
 128 #define acpi_get_override_irq(bus, trigger, polarity) (-1)
 129 #endif
 130 /*
 131  * This function undoes the effect of one call to acpi_register_gsi().
 132  * If this matches the last registration, any IRQ resources for gsi
 133  * are freed.
 134  */
 135 void acpi_unregister_gsi (u32 gsi);
 136
 137 struct pci_dev;
 138
 139 int acpi_pci_irq_enable (struct pci_dev *dev);
 140 void acpi_penalize_isa_irq(int irq, int active);
 141
 142 void acpi_pci_irq_disable (struct pci_dev *dev);
 143
 144 struct acpi_pci_driver {
 145         struct acpi_pci_driver *next;
 146         int (*add)(acpi_handle handle);
 147         void (*remove)(acpi_handle handle);
 148 };
 149
 150 int acpi_pci_register_driver(struct acpi_pci_driver *driver);
 151 void acpi_pci_unregister_driver(struct acpi_pci_driver *driver);
 152
 153 extern int ec_read(u8 addr, u8 *val);
 154 extern int ec_write(u8 addr, u8 val);
 155 extern int ec_transaction(u8 command,
 156                           const u8 *wdata, unsigned wdata_len,
 157                           u8 *rdata, unsigned rdata_len,
 158                           int force_poll);
 159
 160 #if defined(CONFIG_ACPI_WMI) || defined(CONFIG_ACPI_WMI_MODULE)
 161
 162 typedef void (*wmi_notify_handler) (u32 value, void *context);
 163
 164 extern acpi_status wmi_evaluate_method(const char *guid, u8 instance,
 165                                         u32 method_id,
 166                                         const struct acpi_buffer *in,
 167                                         struct acpi_buffer *out);
 168 extern acpi_status wmi_query_block(const char *guid, u8 instance,
 169                                         struct acpi_buffer *out);
 170 extern acpi_status wmi_set_block(const char *guid, u8 instance,
 171                                         const struct acpi_buffer *in);
 172 extern acpi_status wmi_install_notify_handler(const char *guid,
 173                                         wmi_notify_handler handler, void *data);
 174 extern acpi_status wmi_remove_notify_handler(const char *guid);
 175 extern acpi_status wmi_get_event_data(u32 event, struct acpi_buffer *out);
 176 extern bool wmi_has_guid(const char *guid);
 177
 178 #endif  /* CONFIG_ACPI_WMI */
 179
 180 #define ACPI_VIDEO_OUTPUT_SWITCHING                     0x0001
 181 #define ACPI_VIDEO_DEVICE_POSTING                       0x0002
 182 #define ACPI_VIDEO_ROM_AVAILABLE                        0x0004
 183 #define ACPI_VIDEO_BACKLIGHT                            0x0008
 184 #define ACPI_VIDEO_BACKLIGHT_FORCE_VENDOR               0x0010
 185 #define ACPI_VIDEO_BACKLIGHT_FORCE_VIDEO                0x0020
 186 #define ACPI_VIDEO_OUTPUT_SWITCHING_FORCE_VENDOR        0x0040
 187 #define ACPI_VIDEO_OUTPUT_SWITCHING_FORCE_VIDEO         0x0080
 188 #define ACPI_VIDEO_BACKLIGHT_DMI_VENDOR                 0x0100
 189 #define ACPI_VIDEO_BACKLIGHT_DMI_VIDEO                  0x0200
 190 #define ACPI_VIDEO_OUTPUT_SWITCHING_DMI_VENDOR          0x0400
 191 #define ACPI_VIDEO_OUTPUT_SWITCHING_DMI_VIDEO           0x0800
 192
 193 #if defined(CONFIG_ACPI_VIDEO) || defined(CONFIG_ACPI_VIDEO_MODULE)
 194
 195 extern long acpi_video_get_capabilities(acpi_handle graphics_dev_handle);
 196 extern long acpi_is_video_device(struct acpi_device *device);
 197 extern int acpi_video_backlight_support(void);
 198 extern int acpi_video_display_switch_support(void);
 199
 200 #else
 201
 202 static inline long acpi_video_get_capabilities(acpi_handle graphics_dev_handle)
 203 {
 204         return 0;
 205 }
 206
 207 static inline long acpi_is_video_device(struct acpi_device *device)
 208 {
 209         return 0;
 210 }
 211
 212 static inline int acpi_video_backlight_support(void)
 213 {
 214         return 0;
 215 }
 216
 217 static inline int acpi_video_display_switch_support(void)
 218 {
 219         return 0;
 220 }
 221
 222 #endif /* defined(CONFIG_ACPI_VIDEO) || defined(CONFIG_ACPI_VIDEO_MODULE) */
 223
 224 extern int acpi_blacklisted(void);
 225 #ifdef CONFIG_DMI
 226 extern void acpi_dmi_osi_linux(int enable, const struct dmi_system_id *d);
 227 extern int acpi_osi_setup(char *str);
 228 #endif
 229
 230 #ifdef CONFIG_ACPI_NUMA
 231 int acpi_get_pxm(acpi_handle handle);
 232 int acpi_get_node(acpi_handle *handle);
 233 #else
 234 static inline int acpi_get_pxm(acpi_handle handle)
 235 {
 236         return 0;
 237 }
 238 static inline int acpi_get_node(acpi_handle *handle)
 239 {
 240         return 0;
 241 }
 242 #endif
 243 extern int acpi_paddr_to_node(u64 start_addr, u64 size);
 244
 245 extern int pnpacpi_disabled;
 246
 247 #define PXM_INVAL       (-1)
 248 #define NID_INVAL       (-1)
 249
 250 int acpi_check_resource_conflict(struct resource *res);
 251
 252 int acpi_check_region(resource_size_t start, resource_size_t n,
 253                       const char *name);
 254 int acpi_check_mem_region(resource_size_t start, resource_size_t n,
 255                       const char *name);
 256
 257 #ifdef CONFIG_PM_SLEEP
 258 void __init acpi_no_s4_hw_signature(void);
 259 void __init acpi_old_suspend_ordering(void);
 260 void __init acpi_s4_no_nvs(void);
 261 #endif /* CONFIG_PM_SLEEP */
 262
 263 #define OSC_QUERY_TYPE                  0
 264 #define OSC_SUPPORT_TYPE                1
 265 #define OSC_CONTROL_TYPE                2
 266 #define OSC_SUPPORT_MASKS               0x1f
 267
 268 /* _OSC DW0 Definition */
 269 #define OSC_QUERY_ENABLE                1
 270 #define OSC_REQUEST_ERROR               2
 271 #define OSC_INVALID_UUID_ERROR          4
 272 #define OSC_INVALID_REVISION_ERROR      8
 273 #define OSC_CAPABILITIES_MASK_ERROR     16
 274
 275 /* _OSC DW1 Definition (OS Support Fields) */
 276 #define OSC_EXT_PCI_CONFIG_SUPPORT              1
 277 #define OSC_ACTIVE_STATE_PWR_SUPPORT            2
 278 #define OSC_CLOCK_PWR_CAPABILITY_SUPPORT        4
 279 #define OSC_PCI_SEGMENT_GROUPS_SUPPORT          8
 280 #define OSC_MSI_SUPPORT                         16
 281
 282 /* _OSC DW1 Definition (OS Control Fields) */
 283 #define OSC_PCI_EXPRESS_NATIVE_HP_CONTROL       1
 284 #define OSC_SHPC_NATIVE_HP_CONTROL              2
 285 #define OSC_PCI_EXPRESS_PME_CONTROL             4
 286 #define OSC_PCI_EXPRESS_AER_CONTROL             8
 287 #define OSC_PCI_EXPRESS_CAP_STRUCTURE_CONTROL   16
 288
 289 #define OSC_CONTROL_MASKS       (OSC_PCI_EXPRESS_NATIVE_HP_CONTROL |    \
 290                                 OSC_SHPC_NATIVE_HP_CONTROL |            \
 291                                 OSC_PCI_EXPRESS_PME_CONTROL |           \
 292                                 OSC_PCI_EXPRESS_AER_CONTROL |           \
 293                                 OSC_PCI_EXPRESS_CAP_STRUCTURE_CONTROL)
 294
 295 extern acpi_status acpi_pci_osc_control_set(acpi_handle handle, u32 flags);
 296 #else   /* CONFIG_ACPI */
 297
 298 static inline int early_acpi_boot_init(void)
 299 {
 300         return 0;
 301 }
 302 static inline int acpi_boot_init(void)
 303 {
 304         return 0;
 305 }
 306
 307 static inline int acpi_boot_table_init(void)
 308 {
 309         return 0;
 310 }
 311
 312 static inline int acpi_mps_check(void)
 313 {
 314         return 0;
 315 }
 316
 317 static inline int acpi_check_resource_conflict(struct resource *res)
 318 {
 319         return 0;
 320 }
 321
 322 static inline int acpi_check_region(resource_size_t start, resource_size_t n,
 323                                     const char *name)
 324 {
 325         return 0;
 326 }
 327
 328 static inline int acpi_check_mem_region(resource_size_t start,
 329                                         resource_size_t n, const char *name)
 330 {
 331         return 0;
 332 }
 333
 334 #endif  /* !CONFIG_ACPI */
 335 #endif  /*_LINUX_ACPI_H*/