io.h File Reference

#include <uacpi/types.h>

Include dependency graph for io.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Typedefs
typedef struct uacpi_mapped_gas	uacpi_mapped_gas

Functions
uacpi_status	uacpi_gas_read (const struct acpi_gas *gas, uacpi_u64 *value)
uacpi_status	uacpi_gas_write (const struct acpi_gas *gas, uacpi_u64 value)
uacpi_status	uacpi_map_gas (const struct acpi_gas *gas, uacpi_mapped_gas **out_mapped)
void	uacpi_unmap_gas (uacpi_mapped_gas *)
uacpi_status	uacpi_gas_read_mapped (const uacpi_mapped_gas *gas, uacpi_u64 *value)
uacpi_status	uacpi_gas_write_mapped (const uacpi_mapped_gas *gas, uacpi_u64 value)

Typedef Documentation

uacpi_mapped_gas

typedef struct uacpi_mapped_gas uacpi_mapped_gas

Definition at line 17 of file io.h.

Function Documentation

uacpi_gas_read()

uacpi_status uacpi_gas_read	(	const struct acpi_gas *	gas,
		uacpi_u64 *	value
	)

Definition at line 1060 of file io.c.

{
    uacpi_status ret;
    uacpi_mapped_gas mapping;
 
    ret = uacpi_map_gas_noalloc(gas, &mapping);
    if (uacpi_unlikely_error(ret))
        return ret;
 
    ret = uacpi_gas_read_mapped(&mapping, out_value);
    uacpi_unmap_gas_nofree(&mapping);
 
    return ret;
}

uacpi_gas_read_mapped()

uacpi_status uacpi_gas_read_mapped	(	const uacpi_mapped_gas *	gas,
		uacpi_u64 *	value
	)

Same as uacpi_gas_{read,write} but operates on a pre-mapped handle for faster access and/or ability to use in critical sections/irq contexts.

Definition at line 911 of file io.c.

{
    uacpi_status ret;
    uacpi_u8 access_byte_width;
    uacpi_u8 bit_offset, bits_left, index = 0;
    uacpi_u64 data, mask = 0xFFFFFFFFFFFFFFFF;
    uacpi_size offset = 0;
 
    bit_offset = gas->bit_offset;
    bits_left = gas->total_bit_width;
 
    access_byte_width = gas->access_bit_width / 8;
 
    if (access_byte_width < 8)
        mask = ~(mask << gas->access_bit_width);
 
    *out_value = 0;
 
    while (bits_left) {
        if (bit_offset >= gas->access_bit_width) {
            data = 0;
            bit_offset -= gas->access_bit_width;
        } else {
            ret = gas->read(gas->mapping, offset, access_byte_width, &data);
            if (uacpi_unlikely_error(ret))
                return ret;
        }
 
        *out_value |= (data & mask) << (index * gas->access_bit_width);
        bits_left -= UACPI_MIN(bits_left, gas->access_bit_width);
        ++index;
        offset += access_byte_width;
    }
 
    return UACPI_STATUS_OK;
}

Referenced by detect_gpes(), do_read_one(), gpe_try_claim(), maybe_dispatch_gpe(), set_gpe_state_unlocked(), uacpi_gas_read(), and uacpi_gpe_info().

uacpi_gas_write()

uacpi_status uacpi_gas_write	(	const struct acpi_gas *	gas,
		uacpi_u64	value
	)

Definition at line 1075 of file io.c.

{
    uacpi_status ret;
    uacpi_mapped_gas mapping;
 
    ret = uacpi_map_gas_noalloc(gas, &mapping);
    if (uacpi_unlikely_error(ret))
        return ret;
 
    ret = uacpi_gas_write_mapped(&mapping, in_value);
    uacpi_unmap_gas_nofree(&mapping);
 
    return ret;
}

uacpi_gas_write_mapped()

uacpi_status uacpi_gas_write_mapped	(	const uacpi_mapped_gas *	gas,
		uacpi_u64	value
	)

Definition at line 950 of file io.c.

{
    uacpi_status ret;
    uacpi_u8 access_byte_width;
    uacpi_u8 bit_offset, bits_left, index = 0;
    uacpi_u64 data, mask = 0xFFFFFFFFFFFFFFFF;
    uacpi_size offset = 0;
 
    bit_offset = gas->bit_offset;
    bits_left = gas->total_bit_width;
    access_byte_width = gas->access_bit_width / 8;
 
    if (access_byte_width < 8)
        mask = ~(mask << gas->access_bit_width);
 
    while (bits_left) {
        data = (in_value >> (index * gas->access_bit_width)) & mask;
 
        if (bit_offset >= gas->access_bit_width) {
            bit_offset -= gas->access_bit_width;
        } else {
            ret = gas->write(gas->mapping, offset, access_byte_width, data);
            if (uacpi_unlikely_error(ret))
                return ret;
        }
 
        bits_left -= UACPI_MIN(bits_left, gas->access_bit_width);
        ++index;
        offset += access_byte_width;
    }
 
    return UACPI_STATUS_OK;
}

Referenced by clear_gpe(), create_gpe_block(), do_write_one(), gpe_block_apply_action(), gpe_try_claim(), set_gpe_state_unlocked(), uacpi_gas_write(), and uninstall_gpe_block().

uacpi_map_gas()

uacpi_status uacpi_map_gas	(	const struct acpi_gas *	gas,
		uacpi_mapped_gas **	out_mapped
	)

Map a GAS for faster access in the future. The handle returned via 'out_mapped' must be freed & unmapped using uacpi_unmap_gas() when no longer needed.

Definition at line 1028 of file io.c.

{
    uacpi_status ret;
    uacpi_mapped_gas *mapping;
 
    mapping = uacpi_kernel_alloc(sizeof(*mapping));
    if (uacpi_unlikely(mapping == UACPI_NULL))
        return UACPI_STATUS_OUT_OF_MEMORY;
 
    ret = uacpi_map_gas_noalloc(gas, mapping);
    if (uacpi_unlikely_error(ret)) {
        uacpi_free(mapping, sizeof(*mapping));
        return ret;
    }
 
    *out_mapped = mapping;
    return ret;
}

uacpi_unmap_gas()

void uacpi_unmap_gas

(

uacpi_mapped_gas *

gas

)

Definition at line 1054 of file io.c.

{
    uacpi_unmap_gas_nofree(gas);
    uacpi_free(gas, sizeof(*gas));
}