1 /******************************************************************************
2 *
3 * Name: acpiosxf.h - All interfaces to the OS Services Layer (OSL). These
4 * interfaces must be implemented by OSL to interface the
5 * ACPI components to the host operating system.
6 *
7 *****************************************************************************/
8
9 /*
10 * Copyright (C) 2000 - 2013, Intel Corp.
11 * All rights reserved.
12 *
13 * Redistribution and use in source and binary forms, with or without
14 * modification, are permitted provided that the following conditions
15 * are met:
16 * 1. Redistributions of source code must retain the above copyright
17 * notice, this list of conditions, and the following disclaimer,
18 * without modification.
19 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
20 * substantially similar to the "NO WARRANTY" disclaimer below
21 * ("Disclaimer") and any redistribution must be conditioned upon
22 * including a substantially similar Disclaimer requirement for further
23 * binary redistribution.
24 * 3. Neither the names of the above-listed copyright holders nor the names
25 * of any contributors may be used to endorse or promote products derived
26 * from this software without specific prior written permission.
27 *
28 * Alternatively, this software may be distributed under the terms of the
29 * GNU General Public License ("GPL") version 2 as published by the Free
30 * Software Foundation.
31 *
32 * NO WARRANTY
33 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
34 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
35 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
36 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
37 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
38 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
39 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
40 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
41 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
42 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
43 * POSSIBILITY OF SUCH DAMAGES.
44 */
45
46 #ifndef __ACPIOSXF_H__
47 #define __ACPIOSXF_H__
48
49 #include "platform/acenv.h"
50 #include "actypes.h"
51
52
53 /* Types for AcpiOsExecute */
54
55 typedef enum
56 {
57 OSL_GLOBAL_LOCK_HANDLER,
58 OSL_NOTIFY_HANDLER,
59 OSL_GPE_HANDLER,
60 OSL_DEBUGGER_THREAD,
61 OSL_EC_POLL_HANDLER,
62 OSL_EC_BURST_HANDLER
63
64 } ACPI_EXECUTE_TYPE;
65
66 #define ACPI_NO_UNIT_LIMIT ((UINT32) -1)
67 #define ACPI_MUTEX_SEM 1
68
69
70 /* Functions for AcpiOsSignal */
71
72 #define ACPI_SIGNAL_FATAL 0
73 #define ACPI_SIGNAL_BREAKPOINT 1
74
75 typedef struct acpi_signal_fatal_info
76 {
77 UINT32 Type;
78 UINT32 Code;
79 UINT32 Argument;
80
81 } ACPI_SIGNAL_FATAL_INFO;
82
83
84 /*
85 * OSL Initialization and shutdown primitives
86 */
87 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsInitialize
88 ACPI_STATUS
89 AcpiOsInitialize (
90 void);
91 #endif
92
93 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsTerminate
94 ACPI_STATUS
95 AcpiOsTerminate (
96 void);
97 #endif
98
99
100 /*
101 * ACPI Table interfaces
102 */
103 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsGetRootPointer
104 ACPI_PHYSICAL_ADDRESS
105 AcpiOsGetRootPointer (
106 void);
107 #endif
108
109 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsPredefinedOverride
110 ACPI_STATUS
111 AcpiOsPredefinedOverride (
112 const ACPI_PREDEFINED_NAMES *InitVal,
113 ACPI_STRING *NewVal);
114 #endif
115
116 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsTableOverride
117 ACPI_STATUS
118 AcpiOsTableOverride (
119 ACPI_TABLE_HEADER *ExistingTable,
120 ACPI_TABLE_HEADER **NewTable);
121 #endif
122
123 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsPhysicalTableOverride
124 ACPI_STATUS
125 AcpiOsPhysicalTableOverride (
126 ACPI_TABLE_HEADER *ExistingTable,
127 ACPI_PHYSICAL_ADDRESS *NewAddress,
128 UINT32 *NewTableLength);
129 #endif
130
131
132 /*
133 * Spinlock primitives
134 */
135 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsCreateLock
136 ACPI_STATUS
137 AcpiOsCreateLock (
138 ACPI_SPINLOCK *OutHandle);
139 #endif
140
141 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsDeleteLock
142 void
143 AcpiOsDeleteLock (
144 ACPI_SPINLOCK Handle);
145 #endif
146
147 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsAcquireLock
148 ACPI_CPU_FLAGS
149 AcpiOsAcquireLock (
150 ACPI_SPINLOCK Handle);
151 #endif
152
153 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsReleaseLock
154 void
155 AcpiOsReleaseLock (
156 ACPI_SPINLOCK Handle,
157 ACPI_CPU_FLAGS Flags);
158 #endif
159
160
161 /*
162 * Semaphore primitives
163 */
164 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsCreateSemaphore
165 ACPI_STATUS
166 AcpiOsCreateSemaphore (
167 UINT32 MaxUnits,
168 UINT32 InitialUnits,
169 ACPI_SEMAPHORE *OutHandle);
170 #endif
171
172 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsDeleteSemaphore
173 ACPI_STATUS
174 AcpiOsDeleteSemaphore (
175 ACPI_SEMAPHORE Handle);
176 #endif
177
178 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsWaitSemaphore
179 ACPI_STATUS
180 AcpiOsWaitSemaphore (
181 ACPI_SEMAPHORE Handle,
182 UINT32 Units,
183 UINT16 Timeout);
184 #endif
185
186 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsSignalSemaphore
187 ACPI_STATUS
188 AcpiOsSignalSemaphore (
189 ACPI_SEMAPHORE Handle,
190 UINT32 Units);
191 #endif
192
193
194 /*
195 * Mutex primitives. May be configured to use semaphores instead via
196 * ACPI_MUTEX_TYPE (see platform/acenv.h)
197 */
198 #if (ACPI_MUTEX_TYPE != ACPI_BINARY_SEMAPHORE)
199
200 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsCreateMutex
201 ACPI_STATUS
202 AcpiOsCreateMutex (
203 ACPI_MUTEX *OutHandle);
204 #endif
205
206 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsDeleteMutex
207 void
208 AcpiOsDeleteMutex (
209 ACPI_MUTEX Handle);
210 #endif
211
212 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsAcquireMutex
213 ACPI_STATUS
214 AcpiOsAcquireMutex (
215 ACPI_MUTEX Handle,
216 UINT16 Timeout);
217 #endif
218
219 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsReleaseMutex
220 void
221 AcpiOsReleaseMutex (
222 ACPI_MUTEX Handle);
223 #endif
224
225 #endif
226
227
228 /*
229 * Memory allocation and mapping
230 */
231 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsAllocate
232 void *
233 AcpiOsAllocate (
234 ACPI_SIZE Size);
235 #endif
236
237 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsAllocateZeroed
238 void *
239 AcpiOsAllocateZeroed (
240 ACPI_SIZE Size);
241 #endif
242
243 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsFree
244 void
245 AcpiOsFree (
246 void * Memory);
247 #endif
248
249 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsMapMemory
250 void *
251 AcpiOsMapMemory (
252 ACPI_PHYSICAL_ADDRESS Where,
253 ACPI_SIZE Length);
254 #endif
255
256 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsUnmapMemory
257 void
258 AcpiOsUnmapMemory (
259 void *LogicalAddress,
260 ACPI_SIZE Size);
261 #endif
262
263 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsGetPhysicalAddress
264 ACPI_STATUS
265 AcpiOsGetPhysicalAddress (
266 void *LogicalAddress,
267 ACPI_PHYSICAL_ADDRESS *PhysicalAddress);
268 #endif
269
270
271 /*
272 * Memory/Object Cache
273 */
274 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsCreateCache
275 ACPI_STATUS
276 AcpiOsCreateCache (
277 char *CacheName,
278 UINT16 ObjectSize,
279 UINT16 MaxDepth,
280 ACPI_CACHE_T **ReturnCache);
281 #endif
282
283 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsDeleteCache
284 ACPI_STATUS
285 AcpiOsDeleteCache (
286 ACPI_CACHE_T *Cache);
287 #endif
288
289 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsPurgeCache
290 ACPI_STATUS
291 AcpiOsPurgeCache (
292 ACPI_CACHE_T *Cache);
293 #endif
294
295 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsAcquireObject
296 void *
297 AcpiOsAcquireObject (
298 ACPI_CACHE_T *Cache);
299 #endif
300
301 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsReleaseObject
302 ACPI_STATUS
303 AcpiOsReleaseObject (
304 ACPI_CACHE_T *Cache,
305 void *Object);
306 #endif
307
308
309 /*
310 * Interrupt handlers
311 */
312 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsInstallInterruptHandler
313 ACPI_STATUS
314 AcpiOsInstallInterruptHandler (
315 UINT32 InterruptNumber,
316 ACPI_OSD_HANDLER ServiceRoutine,
317 void *Context);
318 #endif
319
320 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsRemoveInterruptHandler
321 ACPI_STATUS
322 AcpiOsRemoveInterruptHandler (
323 UINT32 InterruptNumber,
324 ACPI_OSD_HANDLER ServiceRoutine);
325 #endif
326
327
328 /*
329 * Threads and Scheduling
330 */
331 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsGetThreadId
332 ACPI_THREAD_ID
333 AcpiOsGetThreadId (
334 void);
335 #endif
336
337 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsExecute
338 ACPI_STATUS
339 AcpiOsExecute (
340 ACPI_EXECUTE_TYPE Type,
341 ACPI_OSD_EXEC_CALLBACK Function,
342 void *Context);
343 #endif
344
345 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsWaitEventsComplete
346 void
347 AcpiOsWaitEventsComplete (
348 void);
349 #endif
350
351 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsSleep
352 void
353 AcpiOsSleep (
354 UINT64 Milliseconds);
355 #endif
356
357 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsStall
358 void
359 AcpiOsStall (
360 UINT32 Microseconds);
361 #endif
362
363
364 /*
365 * Platform and hardware-independent I/O interfaces
366 */
367 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsReadPort
368 ACPI_STATUS
369 AcpiOsReadPort (
370 ACPI_IO_ADDRESS Address,
371 UINT32 *Value,
372 UINT32 Width);
373 #endif
374
375 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsWritePort
376 ACPI_STATUS
377 AcpiOsWritePort (
378 ACPI_IO_ADDRESS Address,
379 UINT32 Value,
380 UINT32 Width);
381 #endif
382
383
384 /*
385 * Platform and hardware-independent physical memory interfaces
386 */
387 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsReadMemory
388 ACPI_STATUS
389 AcpiOsReadMemory (
390 ACPI_PHYSICAL_ADDRESS Address,
391 UINT64 *Value,
392 UINT32 Width);
393 #endif
394
395 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsWriteMemory
396 ACPI_STATUS
397 AcpiOsWriteMemory (
398 ACPI_PHYSICAL_ADDRESS Address,
399 UINT64 Value,
400 UINT32 Width);
401 #endif
402
403
404 /*
405 * Platform and hardware-independent PCI configuration space access
406 * Note: Can't use "Register" as a parameter, changed to "Reg" --
407 * certain compilers complain.
408 */
409 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsReadPciConfiguration
410 ACPI_STATUS
411 AcpiOsReadPciConfiguration (
412 ACPI_PCI_ID *PciId,
413 UINT32 Reg,
414 UINT64 *Value,
415 UINT32 Width);
416 #endif
417
418 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsWritePciConfiguration
419 ACPI_STATUS
420 AcpiOsWritePciConfiguration (
421 ACPI_PCI_ID *PciId,
422 UINT32 Reg,
423 UINT64 Value,
424 UINT32 Width);
425 #endif
426
427
428 /*
429 * Miscellaneous
430 */
431 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsReadable
432 BOOLEAN
433 AcpiOsReadable (
434 void *Pointer,
435 ACPI_SIZE Length);
436 #endif
437
438 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsWritable
439 BOOLEAN
440 AcpiOsWritable (
441 void *Pointer,
442 ACPI_SIZE Length);
443 #endif
444
445 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsGetTimer
446 UINT64
447 AcpiOsGetTimer (
448 void);
449 #endif
450
451 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsSignal
452 ACPI_STATUS
453 AcpiOsSignal (
454 UINT32 Function,
455 void *Info);
456 #endif
457
458
459 /*
460 * Debug print routines
461 */
462 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsPrintf
463 void ACPI_INTERNAL_VAR_XFACE
464 AcpiOsPrintf (
465 const char *Format,
466 ...);
467 #endif
468
469 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsVprintf
470 void
471 AcpiOsVprintf (
472 const char *Format,
473 va_list Args);
474 #endif
475
476 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsRedirectOutput
477 void
478 AcpiOsRedirectOutput (
479 void *Destination);
480 #endif
481
482
483 /*
484 * Debug input
485 */
486 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsGetLine
487 ACPI_STATUS
488 AcpiOsGetLine (
489 char *Buffer,
490 UINT32 BufferLength,
491 UINT32 *BytesRead);
492 #endif
493
494
495 /*
496 * Obtain ACPI table(s)
497 */
498 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsGetTableByName
499 ACPI_STATUS
500 AcpiOsGetTableByName (
501 char *Signature,
502 UINT32 Instance,
503 ACPI_TABLE_HEADER **Table,
504 ACPI_PHYSICAL_ADDRESS *Address);
505 #endif
506
507 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsGetTableByIndex
508 ACPI_STATUS
509 AcpiOsGetTableByIndex (
510 UINT32 Index,
511 ACPI_TABLE_HEADER **Table,
512 UINT32 *Instance,
513 ACPI_PHYSICAL_ADDRESS *Address);
514 #endif
515
516 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsGetTableByAddress
517 ACPI_STATUS
518 AcpiOsGetTableByAddress (
519 ACPI_PHYSICAL_ADDRESS Address,
520 ACPI_TABLE_HEADER **Table);
521 #endif
522
523
524 /*
525 * Directory manipulation
526 */
527 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsOpenDirectory
528 void *
529 AcpiOsOpenDirectory (
530 char *Pathname,
531 char *WildcardSpec,
532 char RequestedFileType);
533 #endif
534
535 /* RequesteFileType values */
536
537 #define REQUEST_FILE_ONLY 0
538 #define REQUEST_DIR_ONLY 1
539
540
541 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsGetNextFilename
542 char *
543 AcpiOsGetNextFilename (
544 void *DirHandle);
545 #endif
546
547 #ifndef ACPI_USE_ALTERNATE_PROTOTYPE_AcpiOsCloseDirectory
548 void
549 AcpiOsCloseDirectory (
550 void *DirHandle);
551 #endif
552
553
554 #endif /* __ACPIOSXF_H__ */