1 /******************************************************************************
3 * Module Name: osunixxf - UNIX OSL interfaces
5 *****************************************************************************/
8 * Copyright (C) 2000 - 2015, Intel Corp.
11 * Redistribution and use in source and binary forms, with or without
12 * modification, are permitted provided that the following conditions
14 * 1. Redistributions of source code must retain the above copyright
15 * notice, this list of conditions, and the following disclaimer,
16 * without modification.
17 * 2. Redistributions in binary form must reproduce at minimum a disclaimer
18 * substantially similar to the "NO WARRANTY" disclaimer below
19 * ("Disclaimer") and any redistribution must be conditioned upon
20 * including a substantially similar Disclaimer requirement for further
21 * binary redistribution.
22 * 3. Neither the names of the above-listed copyright holders nor the names
23 * of any contributors may be used to endorse or promote products derived
24 * from this software without specific prior written permission.
26 * Alternatively, this software may be distributed under the terms of the
27 * GNU General Public License ("GPL") version 2 as published by the Free
28 * Software Foundation.
31 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
32 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
33 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR
34 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
35 * HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
36 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
37 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
38 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
39 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
40 * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
41 * POSSIBILITY OF SUCH DAMAGES.
45 * These interfaces are required in order to compile the ASL compiler and the
46 * various ACPICA tools under Linux or other Unix-like system.
48 #include <acpi/acpi.h>
59 #include <semaphore.h>
63 #define _COMPONENT ACPI_OS_SERVICES
64 ACPI_MODULE_NAME("osunixxf")
66 u8 acpi_gbl_debug_timeout
= FALSE
;
68 /* Upcalls to acpi_exec */
71 ae_table_override(struct acpi_table_header
*existing_table
,
72 struct acpi_table_header
**new_table
);
74 typedef void *(*PTHREAD_CALLBACK
) (void *);
76 /* Buffer used by acpi_os_vprintf */
78 #define ACPI_VPRINTF_BUFFER_SIZE 512
79 #define _ASCII_NEWLINE '\n'
81 /* Terminal support for acpi_exec only */
86 struct termios original_term_attributes
;
87 int term_attributes_were_set
= 0;
89 acpi_status
acpi_ut_read_line(char *buffer
, u32 buffer_length
, u32
*bytes_read
);
91 static void os_enter_line_edit_mode(void);
93 static void os_exit_line_edit_mode(void);
95 /******************************************************************************
97 * FUNCTION: os_enter_line_edit_mode, os_exit_line_edit_mode
103 * DESCRIPTION: Enter/Exit the raw character input mode for the terminal.
105 * Interactive line-editing support for the AML debugger. Used with the
106 * common/acgetline module.
108 * readline() is not used because of non-portability. It is not available
109 * on all systems, and if it is, often the package must be manually installed.
111 * Therefore, we use the POSIX tcgetattr/tcsetattr and do the minimal line
112 * editing that we need in acpi_os_get_line.
114 * If the POSIX tcgetattr/tcsetattr interfaces are unavailable, these
115 * calls will also work:
116 * For os_enter_line_edit_mode: system ("stty cbreak -echo")
117 * For os_exit_line_edit_mode: system ("stty cooked echo")
119 *****************************************************************************/
121 static void os_enter_line_edit_mode(void)
123 struct termios local_term_attributes
;
125 term_attributes_were_set
= 0;
127 /* STDIN must be a terminal */
129 if (!isatty(STDIN_FILENO
)) {
133 /* Get and keep the original attributes */
135 if (tcgetattr(STDIN_FILENO
, &original_term_attributes
)) {
136 fprintf(stderr
, "Could not get terminal attributes!\n");
140 /* Set the new attributes to enable raw character input */
142 memcpy(&local_term_attributes
, &original_term_attributes
,
143 sizeof(struct termios
));
145 local_term_attributes
.c_lflag
&= ~(ICANON
| ECHO
);
146 local_term_attributes
.c_cc
[VMIN
] = 1;
147 local_term_attributes
.c_cc
[VTIME
] = 0;
149 if (tcsetattr(STDIN_FILENO
, TCSANOW
, &local_term_attributes
)) {
150 fprintf(stderr
, "Could not set terminal attributes!\n");
154 term_attributes_were_set
= 1;
157 static void os_exit_line_edit_mode(void)
160 if (!term_attributes_were_set
) {
164 /* Set terminal attributes back to the original values */
166 if (tcsetattr(STDIN_FILENO
, TCSANOW
, &original_term_attributes
)) {
167 fprintf(stderr
, "Could not restore terminal attributes!\n");
173 /* These functions are not needed for other ACPICA utilities */
175 #define os_enter_line_edit_mode()
176 #define os_exit_line_edit_mode()
179 /******************************************************************************
181 * FUNCTION: acpi_os_initialize, acpi_os_terminate
187 * DESCRIPTION: Initialize and terminate this module.
189 *****************************************************************************/
191 acpi_status
acpi_os_initialize(void)
195 acpi_gbl_output_file
= stdout
;
197 os_enter_line_edit_mode();
199 status
= acpi_os_create_lock(&acpi_gbl_print_lock
);
200 if (ACPI_FAILURE(status
)) {
207 acpi_status
acpi_os_terminate(void)
210 os_exit_line_edit_mode();
214 #ifndef ACPI_USE_NATIVE_RSDP_POINTER
215 /******************************************************************************
217 * FUNCTION: acpi_os_get_root_pointer
221 * RETURN: RSDP physical address
223 * DESCRIPTION: Gets the ACPI root pointer (RSDP)
225 *****************************************************************************/
227 acpi_physical_address
acpi_os_get_root_pointer(void)
234 /******************************************************************************
236 * FUNCTION: acpi_os_predefined_override
238 * PARAMETERS: init_val - Initial value of the predefined object
239 * new_val - The new value for the object
241 * RETURN: Status, pointer to value. Null pointer returned if not
244 * DESCRIPTION: Allow the OS to override predefined names
246 *****************************************************************************/
249 acpi_os_predefined_override(const struct acpi_predefined_names
* init_val
,
250 acpi_string
* new_val
)
253 if (!init_val
|| !new_val
) {
254 return (AE_BAD_PARAMETER
);
261 /******************************************************************************
263 * FUNCTION: acpi_os_table_override
265 * PARAMETERS: existing_table - Header of current table (probably
267 * new_table - Where an entire new table is returned.
269 * RETURN: Status, pointer to new table. Null pointer returned if no
270 * table is available to override
272 * DESCRIPTION: Return a different version of a table if one is available
274 *****************************************************************************/
277 acpi_os_table_override(struct acpi_table_header
* existing_table
,
278 struct acpi_table_header
** new_table
)
281 if (!existing_table
|| !new_table
) {
282 return (AE_BAD_PARAMETER
);
289 ae_table_override(existing_table
, new_table
);
293 return (AE_NO_ACPI_TABLES
);
297 /******************************************************************************
299 * FUNCTION: acpi_os_physical_table_override
301 * PARAMETERS: existing_table - Header of current table (probably firmware)
302 * new_address - Where new table address is returned
304 * new_table_length - Where new table length is returned
306 * RETURN: Status, address/length of new table. Null pointer returned
307 * if no table is available to override.
309 * DESCRIPTION: Returns AE_SUPPORT, function not used in user space.
311 *****************************************************************************/
314 acpi_os_physical_table_override(struct acpi_table_header
* existing_table
,
315 acpi_physical_address
* new_address
,
316 u32
*new_table_length
)
322 /******************************************************************************
324 * FUNCTION: acpi_os_redirect_output
326 * PARAMETERS: destination - An open file handle/pointer
330 * DESCRIPTION: Causes redirect of acpi_os_printf and acpi_os_vprintf
332 *****************************************************************************/
334 void acpi_os_redirect_output(void *destination
)
337 acpi_gbl_output_file
= destination
;
340 /******************************************************************************
342 * FUNCTION: acpi_os_printf
344 * PARAMETERS: fmt, ... - Standard printf format
348 * DESCRIPTION: Formatted output. Note: very similar to acpi_os_vprintf
349 * (performance), changes should be tracked in both functions.
351 *****************************************************************************/
353 void ACPI_INTERNAL_VAR_XFACE
acpi_os_printf(const char *fmt
, ...)
358 flags
= acpi_gbl_db_output_flags
;
359 if (flags
& ACPI_DB_REDIRECTABLE_OUTPUT
) {
361 /* Output is directable to either a file (if open) or the console */
363 if (acpi_gbl_debug_file
) {
365 /* Output file is open, send the output there */
368 vfprintf(acpi_gbl_debug_file
, fmt
, args
);
371 /* No redirection, send output to console (once only!) */
373 flags
|= ACPI_DB_CONSOLE_OUTPUT
;
377 if (flags
& ACPI_DB_CONSOLE_OUTPUT
) {
379 vfprintf(acpi_gbl_output_file
, fmt
, args
);
384 /******************************************************************************
386 * FUNCTION: acpi_os_vprintf
388 * PARAMETERS: fmt - Standard printf format
389 * args - Argument list
393 * DESCRIPTION: Formatted output with argument list pointer. Note: very
394 * similar to acpi_os_printf, changes should be tracked in both
397 *****************************************************************************/
399 void acpi_os_vprintf(const char *fmt
, va_list args
)
402 char buffer
[ACPI_VPRINTF_BUFFER_SIZE
];
405 * We build the output string in a local buffer because we may be
406 * outputting the buffer twice. Using vfprintf is problematic because
407 * some implementations modify the args pointer/structure during
408 * execution. Thus, we use the local buffer for portability.
410 * Note: Since this module is intended for use by the various ACPICA
411 * utilities/applications, we can safely declare the buffer on the stack.
412 * Also, This function is used for relatively small error messages only.
414 vsnprintf(buffer
, ACPI_VPRINTF_BUFFER_SIZE
, fmt
, args
);
416 flags
= acpi_gbl_db_output_flags
;
417 if (flags
& ACPI_DB_REDIRECTABLE_OUTPUT
) {
419 /* Output is directable to either a file (if open) or the console */
421 if (acpi_gbl_debug_file
) {
423 /* Output file is open, send the output there */
425 fputs(buffer
, acpi_gbl_debug_file
);
427 /* No redirection, send output to console (once only!) */
429 flags
|= ACPI_DB_CONSOLE_OUTPUT
;
433 if (flags
& ACPI_DB_CONSOLE_OUTPUT
) {
434 fputs(buffer
, acpi_gbl_output_file
);
438 #ifndef ACPI_EXEC_APP
439 /******************************************************************************
441 * FUNCTION: acpi_os_get_line
443 * PARAMETERS: buffer - Where to return the command line
444 * buffer_length - Maximum length of Buffer
445 * bytes_read - Where the actual byte count is returned
447 * RETURN: Status and actual bytes read
449 * DESCRIPTION: Get the next input line from the terminal. NOTE: For the
450 * acpi_exec utility, we use the acgetline module instead to
451 * provide line-editing and history support.
453 *****************************************************************************/
455 acpi_status
acpi_os_get_line(char *buffer
, u32 buffer_length
, u32
*bytes_read
)
460 /* Standard acpi_os_get_line for all utilities except acpi_exec */
462 for (end_of_line
= 0;; end_of_line
++) {
463 if (end_of_line
>= buffer_length
) {
464 return (AE_BUFFER_OVERFLOW
);
467 if ((input_char
= getchar()) == EOF
) {
471 if (!input_char
|| input_char
== _ASCII_NEWLINE
) {
475 buffer
[end_of_line
] = (char)input_char
;
478 /* Null terminate the buffer */
480 buffer
[end_of_line
] = 0;
482 /* Return the number of bytes in the string */
485 *bytes_read
= end_of_line
;
492 #ifndef ACPI_USE_NATIVE_MEMORY_MAPPING
493 /******************************************************************************
495 * FUNCTION: acpi_os_map_memory
497 * PARAMETERS: where - Physical address of memory to be mapped
498 * length - How much memory to map
500 * RETURN: Pointer to mapped memory. Null on error.
502 * DESCRIPTION: Map physical memory into caller's address space
504 *****************************************************************************/
506 void *acpi_os_map_memory(acpi_physical_address where
, acpi_size length
)
509 return (ACPI_TO_POINTER((acpi_size
) where
));
512 /******************************************************************************
514 * FUNCTION: acpi_os_unmap_memory
516 * PARAMETERS: where - Logical address of memory to be unmapped
517 * length - How much memory to unmap
521 * DESCRIPTION: Delete a previously created mapping. Where and Length must
522 * correspond to a previous mapping exactly.
524 *****************************************************************************/
526 void acpi_os_unmap_memory(void *where
, acpi_size length
)
533 /******************************************************************************
535 * FUNCTION: acpi_os_allocate
537 * PARAMETERS: size - Amount to allocate, in bytes
539 * RETURN: Pointer to the new allocation. Null on error.
541 * DESCRIPTION: Allocate memory. Algorithm is dependent on the OS.
543 *****************************************************************************/
545 void *acpi_os_allocate(acpi_size size
)
549 mem
= (void *)malloc((size_t) size
);
553 #ifdef USE_NATIVE_ALLOCATE_ZEROED
554 /******************************************************************************
556 * FUNCTION: acpi_os_allocate_zeroed
558 * PARAMETERS: size - Amount to allocate, in bytes
560 * RETURN: Pointer to the new allocation. Null on error.
562 * DESCRIPTION: Allocate and zero memory. Algorithm is dependent on the OS.
564 *****************************************************************************/
566 void *acpi_os_allocate_zeroed(acpi_size size
)
570 mem
= (void *)calloc(1, (size_t) size
);
575 /******************************************************************************
577 * FUNCTION: acpi_os_free
579 * PARAMETERS: mem - Pointer to previously allocated memory
583 * DESCRIPTION: Free memory allocated via acpi_os_allocate
585 *****************************************************************************/
587 void acpi_os_free(void *mem
)
593 #ifdef ACPI_SINGLE_THREADED
594 /******************************************************************************
596 * FUNCTION: Semaphore stub functions
598 * DESCRIPTION: Stub functions used for single-thread applications that do
599 * not require semaphore synchronization. Full implementations
600 * of these functions appear after the stubs.
602 *****************************************************************************/
605 acpi_os_create_semaphore(u32 max_units
,
606 u32 initial_units
, acpi_handle
* out_handle
)
608 *out_handle
= (acpi_handle
) 1;
612 acpi_status
acpi_os_delete_semaphore(acpi_handle handle
)
617 acpi_status
acpi_os_wait_semaphore(acpi_handle handle
, u32 units
, u16 timeout
)
622 acpi_status
acpi_os_signal_semaphore(acpi_handle handle
, u32 units
)
628 /******************************************************************************
630 * FUNCTION: acpi_os_create_semaphore
632 * PARAMETERS: initial_units - Units to be assigned to the new semaphore
633 * out_handle - Where a handle will be returned
637 * DESCRIPTION: Create an OS semaphore
639 *****************************************************************************/
642 acpi_os_create_semaphore(u32 max_units
,
643 u32 initial_units
, acpi_handle
* out_handle
)
648 return (AE_BAD_PARAMETER
);
652 char *semaphore_name
= tmpnam(NULL
);
655 sem_open(semaphore_name
, O_EXCL
| O_CREAT
, 0755,
658 return (AE_NO_MEMORY
);
660 sem_unlink(semaphore_name
); /* This just deletes the name */
664 sem
= acpi_os_allocate(sizeof(sem_t
));
666 return (AE_NO_MEMORY
);
669 if (sem_init(sem
, 0, initial_units
) == -1) {
671 return (AE_BAD_PARAMETER
);
675 *out_handle
= (acpi_handle
) sem
;
679 /******************************************************************************
681 * FUNCTION: acpi_os_delete_semaphore
683 * PARAMETERS: handle - Handle returned by acpi_os_create_semaphore
687 * DESCRIPTION: Delete an OS semaphore
689 *****************************************************************************/
691 acpi_status
acpi_os_delete_semaphore(acpi_handle handle
)
693 sem_t
*sem
= (sem_t
*) handle
;
696 return (AE_BAD_PARAMETER
);
699 if (sem_destroy(sem
) == -1) {
700 return (AE_BAD_PARAMETER
);
706 /******************************************************************************
708 * FUNCTION: acpi_os_wait_semaphore
710 * PARAMETERS: handle - Handle returned by acpi_os_create_semaphore
711 * units - How many units to wait for
712 * msec_timeout - How long to wait (milliseconds)
716 * DESCRIPTION: Wait for units
718 *****************************************************************************/
721 acpi_os_wait_semaphore(acpi_handle handle
, u32 units
, u16 msec_timeout
)
723 acpi_status status
= AE_OK
;
724 sem_t
*sem
= (sem_t
*) handle
;
725 #ifndef ACPI_USE_ALTERNATE_TIMEOUT
726 struct timespec time
;
731 return (AE_BAD_PARAMETER
);
734 switch (msec_timeout
) {
738 * A zero timeout value indicates that we shouldn't wait - just
739 * acquire the semaphore if available otherwise return AE_TIME
740 * (a.k.a. 'would block').
744 if (sem_trywait(sem
) == -1) {
749 /* Wait Indefinitely */
751 case ACPI_WAIT_FOREVER
:
758 /* Wait with msec_timeout */
762 #ifdef ACPI_USE_ALTERNATE_TIMEOUT
764 * Alternate timeout mechanism for environments where
765 * sem_timedwait is not available or does not work properly.
767 while (msec_timeout
) {
768 if (sem_trywait(sem
) == 0) {
770 /* Got the semaphore */
774 if (msec_timeout
>= 10) {
776 usleep(10 * ACPI_USEC_PER_MSEC
); /* ten milliseconds */
779 usleep(ACPI_USEC_PER_MSEC
); /* one millisecond */
785 * The interface to sem_timedwait is an absolute time, so we need to
786 * get the current time, then add in the millisecond Timeout value.
788 if (clock_gettime(CLOCK_REALTIME
, &time
) == -1) {
789 perror("clock_gettime");
793 time
.tv_sec
+= (msec_timeout
/ ACPI_MSEC_PER_SEC
);
795 ((msec_timeout
% ACPI_MSEC_PER_SEC
) * ACPI_NSEC_PER_MSEC
);
797 /* Handle nanosecond overflow (field must be less than one second) */
799 if (time
.tv_nsec
>= ACPI_NSEC_PER_SEC
) {
800 time
.tv_sec
+= (time
.tv_nsec
/ ACPI_NSEC_PER_SEC
);
801 time
.tv_nsec
= (time
.tv_nsec
% ACPI_NSEC_PER_SEC
);
804 while (((ret_val
= sem_timedwait(sem
, &time
)) == -1)
805 && (errno
== EINTR
)) {
810 if (errno
!= ETIMEDOUT
) {
811 perror("sem_timedwait");
822 /******************************************************************************
824 * FUNCTION: acpi_os_signal_semaphore
826 * PARAMETERS: handle - Handle returned by acpi_os_create_semaphore
827 * units - Number of units to send
831 * DESCRIPTION: Send units
833 *****************************************************************************/
835 acpi_status
acpi_os_signal_semaphore(acpi_handle handle
, u32 units
)
837 sem_t
*sem
= (sem_t
*) handle
;
840 return (AE_BAD_PARAMETER
);
843 if (sem_post(sem
) == -1) {
850 #endif /* ACPI_SINGLE_THREADED */
852 /******************************************************************************
854 * FUNCTION: Spinlock interfaces
856 * DESCRIPTION: Map these interfaces to semaphore interfaces
858 *****************************************************************************/
860 acpi_status
acpi_os_create_lock(acpi_spinlock
* out_handle
)
863 return (acpi_os_create_semaphore(1, 1, out_handle
));
866 void acpi_os_delete_lock(acpi_spinlock handle
)
868 acpi_os_delete_semaphore(handle
);
871 acpi_cpu_flags
acpi_os_acquire_lock(acpi_handle handle
)
873 acpi_os_wait_semaphore(handle
, 1, 0xFFFF);
877 void acpi_os_release_lock(acpi_spinlock handle
, acpi_cpu_flags flags
)
879 acpi_os_signal_semaphore(handle
, 1);
882 /******************************************************************************
884 * FUNCTION: acpi_os_install_interrupt_handler
886 * PARAMETERS: interrupt_number - Level handler should respond to.
887 * isr - Address of the ACPI interrupt handler
888 * except_ptr - Where status is returned
890 * RETURN: Handle to the newly installed handler.
892 * DESCRIPTION: Install an interrupt handler. Used to install the ACPI
893 * OS-independent handler.
895 *****************************************************************************/
898 acpi_os_install_interrupt_handler(u32 interrupt_number
,
899 acpi_osd_handler service_routine
,
906 /******************************************************************************
908 * FUNCTION: acpi_os_remove_interrupt_handler
910 * PARAMETERS: handle - Returned when handler was installed
914 * DESCRIPTION: Uninstalls an interrupt handler.
916 *****************************************************************************/
919 acpi_os_remove_interrupt_handler(u32 interrupt_number
,
920 acpi_osd_handler service_routine
)
926 /******************************************************************************
928 * FUNCTION: acpi_os_stall
930 * PARAMETERS: microseconds - Time to sleep
932 * RETURN: Blocks until sleep is completed.
934 * DESCRIPTION: Sleep at microsecond granularity
936 *****************************************************************************/
938 void acpi_os_stall(u32 microseconds
)
942 usleep(microseconds
);
946 /******************************************************************************
948 * FUNCTION: acpi_os_sleep
950 * PARAMETERS: milliseconds - Time to sleep
952 * RETURN: Blocks until sleep is completed.
954 * DESCRIPTION: Sleep at millisecond granularity
956 *****************************************************************************/
958 void acpi_os_sleep(u64 milliseconds
)
961 /* Sleep for whole seconds */
963 sleep(milliseconds
/ ACPI_MSEC_PER_SEC
);
966 * Sleep for remaining microseconds.
967 * Arg to usleep() is in usecs and must be less than 1,000,000 (1 second).
969 usleep((milliseconds
% ACPI_MSEC_PER_SEC
) * ACPI_USEC_PER_MSEC
);
972 /******************************************************************************
974 * FUNCTION: acpi_os_get_timer
978 * RETURN: Current time in 100 nanosecond units
980 * DESCRIPTION: Get the current system time
982 *****************************************************************************/
984 u64
acpi_os_get_timer(void)
988 /* This timer has sufficient resolution for user-space application code */
990 gettimeofday(&time
, NULL
);
992 /* (Seconds * 10^7 = 100ns(10^-7)) + (Microseconds(10^-6) * 10^1 = 100ns) */
994 return (((u64
)time
.tv_sec
* ACPI_100NSEC_PER_SEC
) +
995 ((u64
)time
.tv_usec
* ACPI_100NSEC_PER_USEC
));
998 /******************************************************************************
1000 * FUNCTION: acpi_os_read_pci_configuration
1002 * PARAMETERS: pci_id - Seg/Bus/Dev
1003 * pci_register - Device Register
1004 * value - Buffer where value is placed
1005 * width - Number of bits
1009 * DESCRIPTION: Read data from PCI configuration space
1011 *****************************************************************************/
1014 acpi_os_read_pci_configuration(struct acpi_pci_id
*pci_id
,
1015 u32 pci_register
, u64
*value
, u32 width
)
1022 /******************************************************************************
1024 * FUNCTION: acpi_os_write_pci_configuration
1026 * PARAMETERS: pci_id - Seg/Bus/Dev
1027 * pci_register - Device Register
1028 * value - Value to be written
1029 * width - Number of bits
1033 * DESCRIPTION: Write data to PCI configuration space
1035 *****************************************************************************/
1038 acpi_os_write_pci_configuration(struct acpi_pci_id
* pci_id
,
1039 u32 pci_register
, u64 value
, u32 width
)
1045 /******************************************************************************
1047 * FUNCTION: acpi_os_read_port
1049 * PARAMETERS: address - Address of I/O port/register to read
1050 * value - Where value is placed
1051 * width - Number of bits
1053 * RETURN: Value read from port
1055 * DESCRIPTION: Read data from an I/O port or register
1057 *****************************************************************************/
1059 acpi_status
acpi_os_read_port(acpi_io_address address
, u32
*value
, u32 width
)
1075 *value
= 0xFFFFFFFF;
1080 return (AE_BAD_PARAMETER
);
1086 /******************************************************************************
1088 * FUNCTION: acpi_os_write_port
1090 * PARAMETERS: address - Address of I/O port/register to write
1091 * value - Value to write
1092 * width - Number of bits
1096 * DESCRIPTION: Write data to an I/O port or register
1098 *****************************************************************************/
1100 acpi_status
acpi_os_write_port(acpi_io_address address
, u32 value
, u32 width
)
1106 /******************************************************************************
1108 * FUNCTION: acpi_os_read_memory
1110 * PARAMETERS: address - Physical Memory Address to read
1111 * value - Where value is placed
1112 * width - Number of bits (8,16,32, or 64)
1114 * RETURN: Value read from physical memory address. Always returned
1115 * as a 64-bit integer, regardless of the read width.
1117 * DESCRIPTION: Read data from a physical memory address
1119 *****************************************************************************/
1122 acpi_os_read_memory(acpi_physical_address address
, u64
*value
, u32 width
)
1136 return (AE_BAD_PARAMETER
);
1141 /******************************************************************************
1143 * FUNCTION: acpi_os_write_memory
1145 * PARAMETERS: address - Physical Memory Address to write
1146 * value - Value to write
1147 * width - Number of bits (8,16,32, or 64)
1151 * DESCRIPTION: Write data to a physical memory address
1153 *****************************************************************************/
1156 acpi_os_write_memory(acpi_physical_address address
, u64 value
, u32 width
)
1162 /******************************************************************************
1164 * FUNCTION: acpi_os_readable
1166 * PARAMETERS: pointer - Area to be verified
1167 * length - Size of area
1169 * RETURN: TRUE if readable for entire length
1171 * DESCRIPTION: Verify that a pointer is valid for reading
1173 *****************************************************************************/
1175 u8
acpi_os_readable(void *pointer
, acpi_size length
)
1181 /******************************************************************************
1183 * FUNCTION: acpi_os_writable
1185 * PARAMETERS: pointer - Area to be verified
1186 * length - Size of area
1188 * RETURN: TRUE if writable for entire length
1190 * DESCRIPTION: Verify that a pointer is valid for writing
1192 *****************************************************************************/
1194 u8
acpi_os_writable(void *pointer
, acpi_size length
)
1200 /******************************************************************************
1202 * FUNCTION: acpi_os_signal
1204 * PARAMETERS: function - ACPI A signal function code
1205 * info - Pointer to function-dependent structure
1209 * DESCRIPTION: Miscellaneous functions. Example implementation only.
1211 *****************************************************************************/
1213 acpi_status
acpi_os_signal(u32 function
, void *info
)
1217 case ACPI_SIGNAL_FATAL
:
1221 case ACPI_SIGNAL_BREAKPOINT
:
1233 /* Optional multi-thread support */
1235 #ifndef ACPI_SINGLE_THREADED
1236 /******************************************************************************
1238 * FUNCTION: acpi_os_get_thread_id
1242 * RETURN: Id of the running thread
1244 * DESCRIPTION: Get the ID of the current (running) thread
1246 *****************************************************************************/
1248 acpi_thread_id
acpi_os_get_thread_id(void)
1252 thread
= pthread_self();
1253 return (ACPI_CAST_PTHREAD_T(thread
));
1256 /******************************************************************************
1258 * FUNCTION: acpi_os_execute
1260 * PARAMETERS: type - Type of execution
1261 * function - Address of the function to execute
1262 * context - Passed as a parameter to the function
1266 * DESCRIPTION: Execute a new thread
1268 *****************************************************************************/
1271 acpi_os_execute(acpi_execute_type type
,
1272 acpi_osd_exec_callback function
, void *context
)
1278 pthread_create(&thread
, NULL
, (PTHREAD_CALLBACK
) function
, context
);
1280 acpi_os_printf("Create thread failed");
1285 #else /* ACPI_SINGLE_THREADED */
1286 acpi_thread_id
acpi_os_get_thread_id(void)
1292 acpi_os_execute(acpi_execute_type type
,
1293 acpi_osd_exec_callback function
, void *context
)
1301 #endif /* ACPI_SINGLE_THREADED */
1303 /******************************************************************************
1305 * FUNCTION: acpi_os_wait_events_complete
1311 * DESCRIPTION: Wait for all asynchronous events to complete. This
1312 * implementation does nothing.
1314 *****************************************************************************/
1316 void acpi_os_wait_events_complete(void)