powerpc: Document new FSL I2C bindings and cleanup
[linux-2.6] / 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
115 extern struct acpi_mcfg_allocation *pci_mmcfg_config;
116 extern int pci_mmcfg_config_num;
117
118 extern int sbf_port;
119 extern unsigned long acpi_realmode_flags;
120
121 int acpi_register_gsi (u32 gsi, int triggering, int polarity);
122 int acpi_gsi_to_irq (u32 gsi, unsigned int *irq);
123
124 #ifdef CONFIG_X86_IO_APIC
125 extern int acpi_get_override_irq(int bus_irq, int *trigger, int *polarity);
126 #else
127 #define acpi_get_override_irq(bus, trigger, polarity) (-1)
128 #endif
129 /*
130  * This function undoes the effect of one call to acpi_register_gsi().
131  * If this matches the last registration, any IRQ resources for gsi
132  * are freed.
133  */
134 void acpi_unregister_gsi (u32 gsi);
135
136 struct pci_dev;
137
138 int acpi_pci_irq_enable (struct pci_dev *dev);
139 void acpi_penalize_isa_irq(int irq, int active);
140
141 void acpi_pci_irq_disable (struct pci_dev *dev);
142
143 struct acpi_pci_driver {
144         struct acpi_pci_driver *next;
145         int (*add)(acpi_handle handle);
146         void (*remove)(acpi_handle handle);
147 };
148
149 int acpi_pci_register_driver(struct acpi_pci_driver *driver);
150 void acpi_pci_unregister_driver(struct acpi_pci_driver *driver);
151
152 extern int ec_read(u8 addr, u8 *val);
153 extern int ec_write(u8 addr, u8 val);
154 extern int ec_transaction(u8 command,
155                           const u8 *wdata, unsigned wdata_len,
156                           u8 *rdata, unsigned rdata_len,
157                           int force_poll);
158
159 #if defined(CONFIG_ACPI_WMI) || defined(CONFIG_ACPI_WMI_MODULE)
160
161 typedef void (*wmi_notify_handler) (u32 value, void *context);
162
163 extern acpi_status wmi_evaluate_method(const char *guid, u8 instance,
164                                         u32 method_id,
165                                         const struct acpi_buffer *in,
166                                         struct acpi_buffer *out);
167 extern acpi_status wmi_query_block(const char *guid, u8 instance,
168                                         struct acpi_buffer *out);
169 extern acpi_status wmi_set_block(const char *guid, u8 instance,
170                                         const struct acpi_buffer *in);
171 extern acpi_status wmi_install_notify_handler(const char *guid,
172                                         wmi_notify_handler handler, void *data);
173 extern acpi_status wmi_remove_notify_handler(const char *guid);
174 extern acpi_status wmi_get_event_data(u32 event, struct acpi_buffer *out);
175 extern bool wmi_has_guid(const char *guid);
176
177 #endif  /* CONFIG_ACPI_WMI */
178
179 #define ACPI_VIDEO_OUTPUT_SWITCHING                     0x0001
180 #define ACPI_VIDEO_DEVICE_POSTING                       0x0002
181 #define ACPI_VIDEO_ROM_AVAILABLE                        0x0004
182 #define ACPI_VIDEO_BACKLIGHT                            0x0008
183 #define ACPI_VIDEO_BACKLIGHT_FORCE_VENDOR               0x0010
184 #define ACPI_VIDEO_BACKLIGHT_FORCE_VIDEO                0x0020
185 #define ACPI_VIDEO_OUTPUT_SWITCHING_FORCE_VENDOR        0x0040
186 #define ACPI_VIDEO_OUTPUT_SWITCHING_FORCE_VIDEO         0x0080
187 #define ACPI_VIDEO_BACKLIGHT_DMI_VENDOR                 0x0100
188 #define ACPI_VIDEO_BACKLIGHT_DMI_VIDEO                  0x0200
189 #define ACPI_VIDEO_OUTPUT_SWITCHING_DMI_VENDOR          0x0400
190 #define ACPI_VIDEO_OUTPUT_SWITCHING_DMI_VIDEO           0x0800
191
192 #if defined(CONFIG_ACPI_VIDEO) || defined(CONFIG_ACPI_VIDEO_MODULE)
193
194 extern long acpi_video_get_capabilities(acpi_handle graphics_dev_handle);
195 extern long acpi_is_video_device(struct acpi_device *device);
196 extern int acpi_video_backlight_support(void);
197 extern int acpi_video_display_switch_support(void);
198
199 #else
200
201 static inline long acpi_video_get_capabilities(acpi_handle graphics_dev_handle)
202 {
203         return 0;
204 }
205
206 static inline long acpi_is_video_device(struct acpi_device *device)
207 {
208         return 0;
209 }
210
211 static inline int acpi_video_backlight_support(void)
212 {
213         return 0;
214 }
215
216 static inline int acpi_video_display_switch_support(void)
217 {
218         return 0;
219 }
220
221 #endif /* defined(CONFIG_ACPI_VIDEO) || defined(CONFIG_ACPI_VIDEO_MODULE) */
222
223 extern int acpi_blacklisted(void);
224 #ifdef CONFIG_DMI
225 extern void acpi_dmi_osi_linux(int enable, const struct dmi_system_id *d);
226 extern int acpi_osi_setup(char *str);
227 #endif
228
229 #ifdef CONFIG_ACPI_NUMA
230 int acpi_get_pxm(acpi_handle handle);
231 int acpi_get_node(acpi_handle *handle);
232 #else
233 static inline int acpi_get_pxm(acpi_handle handle)
234 {
235         return 0;
236 }
237 static inline int acpi_get_node(acpi_handle *handle)
238 {
239         return 0;
240 }
241 #endif
242 extern int acpi_paddr_to_node(u64 start_addr, u64 size);
243
244 extern int pnpacpi_disabled;
245
246 #define PXM_INVAL       (-1)
247 #define NID_INVAL       (-1)
248
249 int acpi_check_resource_conflict(struct resource *res);
250
251 int acpi_check_region(resource_size_t start, resource_size_t n,
252                       const char *name);
253 int acpi_check_mem_region(resource_size_t start, resource_size_t n,
254                       const char *name);
255
256 #ifdef CONFIG_PM_SLEEP
257 void __init acpi_no_s4_hw_signature(void);
258 void __init acpi_old_suspend_ordering(void);
259 void __init acpi_s4_no_nvs(void);
260 #endif /* CONFIG_PM_SLEEP */
261
262 #define OSC_QUERY_TYPE                  0
263 #define OSC_SUPPORT_TYPE                1
264 #define OSC_CONTROL_TYPE                2
265 #define OSC_SUPPORT_MASKS               0x1f
266
267 /* _OSC DW0 Definition */
268 #define OSC_QUERY_ENABLE                1
269 #define OSC_REQUEST_ERROR               2
270 #define OSC_INVALID_UUID_ERROR          4
271 #define OSC_INVALID_REVISION_ERROR      8
272 #define OSC_CAPABILITIES_MASK_ERROR     16
273
274 /* _OSC DW1 Definition (OS Support Fields) */
275 #define OSC_EXT_PCI_CONFIG_SUPPORT              1
276 #define OSC_ACTIVE_STATE_PWR_SUPPORT            2
277 #define OSC_CLOCK_PWR_CAPABILITY_SUPPORT        4
278 #define OSC_PCI_SEGMENT_GROUPS_SUPPORT          8
279 #define OSC_MSI_SUPPORT                         16
280
281 /* _OSC DW1 Definition (OS Control Fields) */
282 #define OSC_PCI_EXPRESS_NATIVE_HP_CONTROL       1
283 #define OSC_SHPC_NATIVE_HP_CONTROL              2
284 #define OSC_PCI_EXPRESS_PME_CONTROL             4
285 #define OSC_PCI_EXPRESS_AER_CONTROL             8
286 #define OSC_PCI_EXPRESS_CAP_STRUCTURE_CONTROL   16
287
288 #define OSC_CONTROL_MASKS       (OSC_PCI_EXPRESS_NATIVE_HP_CONTROL |    \
289                                 OSC_SHPC_NATIVE_HP_CONTROL |            \
290                                 OSC_PCI_EXPRESS_PME_CONTROL |           \
291                                 OSC_PCI_EXPRESS_AER_CONTROL |           \
292                                 OSC_PCI_EXPRESS_CAP_STRUCTURE_CONTROL)
293
294 extern acpi_status acpi_pci_osc_control_set(acpi_handle handle, u32 flags);
295 #else   /* CONFIG_ACPI */
296
297 static inline int early_acpi_boot_init(void)
298 {
299         return 0;
300 }
301 static inline int acpi_boot_init(void)
302 {
303         return 0;
304 }
305
306 static inline int acpi_boot_table_init(void)
307 {
308         return 0;
309 }
310
311 static inline int acpi_mps_check(void)
312 {
313         return 0;
314 }
315
316 static inline int acpi_check_resource_conflict(struct resource *res)
317 {
318         return 0;
319 }
320
321 static inline int acpi_check_region(resource_size_t start, resource_size_t n,
322                                     const char *name)
323 {
324         return 0;
325 }
326
327 static inline int acpi_check_mem_region(resource_size_t start,
328                                         resource_size_t n, const char *name)
329 {
330         return 0;
331 }
332
333 #endif  /* !CONFIG_ACPI */
334 #endif  /*_LINUX_ACPI_H*/