// SPDX-License-Identifier: GPL-2.0-only /* * drivers/acpi/resource.c - ACPI device resources interpretation. * * Copyright (C) 2012, Intel Corp. * Author: Rafael J. Wysocki <[email protected]> * * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ * * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ */ #include <linux/acpi.h> #include <linux/device.h> #include <linux/export.h> #include <linux/ioport.h> #include <linux/slab.h> #include <linux/irq.h> #include <linux/dmi.h> #ifdef CONFIG_X86 #define valid_IRQ(i) … static inline bool acpi_iospace_resource_valid(struct resource *res) { … } #else #define valid_IRQ … /* * ACPI IO descriptors on arches other than X86 contain MMIO CPU physical * addresses mapping IO space in CPU physical address space, IO space * resources can be placed anywhere in the 64-bit physical address space. */ static inline bool acpi_iospace_resource_valid(struct resource *res) { return true; } #endif #if IS_ENABLED(CONFIG_ACPI_GENERIC_GSI) static inline bool is_gsi(struct acpi_resource_extended_irq *ext_irq) { return ext_irq->resource_source.string_length == 0 && ext_irq->producer_consumer == ACPI_CONSUMER; } #else static inline bool is_gsi(struct acpi_resource_extended_irq *ext_irq) { … } #endif static bool acpi_dev_resource_len_valid(u64 start, u64 end, u64 len, bool io) { … } static void acpi_dev_memresource_flags(struct resource *res, u64 len, u8 write_protect) { … } static void acpi_dev_get_memresource(struct resource *res, u64 start, u64 len, u8 write_protect) { … } /** * acpi_dev_resource_memory - Extract ACPI memory resource information. * @ares: Input ACPI resource object. * @res: Output generic resource object. * * Check if the given ACPI resource object represents a memory resource and * if that's the case, use the information in it to populate the generic * resource object pointed to by @res. * * Return: * 1) false with res->flags setting to zero: not the expected resource type * 2) false with IORESOURCE_DISABLED in res->flags: valid unassigned resource * 3) true: valid assigned resource */ bool acpi_dev_resource_memory(struct acpi_resource *ares, struct resource *res) { … } EXPORT_SYMBOL_GPL(…); static void acpi_dev_ioresource_flags(struct resource *res, u64 len, u8 io_decode, u8 translation_type) { … } static void acpi_dev_get_ioresource(struct resource *res, u64 start, u64 len, u8 io_decode) { … } /** * acpi_dev_resource_io - Extract ACPI I/O resource information. * @ares: Input ACPI resource object. * @res: Output generic resource object. * * Check if the given ACPI resource object represents an I/O resource and * if that's the case, use the information in it to populate the generic * resource object pointed to by @res. * * Return: * 1) false with res->flags setting to zero: not the expected resource type * 2) false with IORESOURCE_DISABLED in res->flags: valid unassigned resource * 3) true: valid assigned resource */ bool acpi_dev_resource_io(struct acpi_resource *ares, struct resource *res) { … } EXPORT_SYMBOL_GPL(…); static bool acpi_decode_space(struct resource_win *win, struct acpi_resource_address *addr, struct acpi_address64_attribute *attr) { … } /** * acpi_dev_resource_address_space - Extract ACPI address space information. * @ares: Input ACPI resource object. * @win: Output generic resource object. * * Check if the given ACPI resource object represents an address space resource * and if that's the case, use the information in it to populate the generic * resource object pointed to by @win. * * Return: * 1) false with win->res.flags setting to zero: not the expected resource type * 2) false with IORESOURCE_DISABLED in win->res.flags: valid unassigned * resource * 3) true: valid assigned resource */ bool acpi_dev_resource_address_space(struct acpi_resource *ares, struct resource_win *win) { … } EXPORT_SYMBOL_GPL(…); /** * acpi_dev_resource_ext_address_space - Extract ACPI address space information. * @ares: Input ACPI resource object. * @win: Output generic resource object. * * Check if the given ACPI resource object represents an extended address space * resource and if that's the case, use the information in it to populate the * generic resource object pointed to by @win. * * Return: * 1) false with win->res.flags setting to zero: not the expected resource type * 2) false with IORESOURCE_DISABLED in win->res.flags: valid unassigned * resource * 3) true: valid assigned resource */ bool acpi_dev_resource_ext_address_space(struct acpi_resource *ares, struct resource_win *win) { … } EXPORT_SYMBOL_GPL(…); /** * acpi_dev_irq_flags - Determine IRQ resource flags. * @triggering: Triggering type as provided by ACPI. * @polarity: Interrupt polarity as provided by ACPI. * @shareable: Whether or not the interrupt is shareable. * @wake_capable: Wake capability as provided by ACPI. */ unsigned long acpi_dev_irq_flags(u8 triggering, u8 polarity, u8 shareable, u8 wake_capable) { … } EXPORT_SYMBOL_GPL(…); /** * acpi_dev_get_irq_type - Determine irq type. * @triggering: Triggering type as provided by ACPI. * @polarity: Interrupt polarity as provided by ACPI. */ unsigned int acpi_dev_get_irq_type(int triggering, int polarity) { … } EXPORT_SYMBOL_GPL(…); /* * DMI matches for boards where the DSDT specifies the kbd IRQ as * level active-low and using the override changes this to rising edge, * stopping the keyboard from working. */ static const struct dmi_system_id irq1_level_low_skip_override[] = …; /* * DMI matches for AMD Zen boards where the DSDT specifies the kbd IRQ * as falling edge and this must be overridden to rising edge, * to have a working keyboard. */ static const struct dmi_system_id irq1_edge_low_force_override[] = …; struct irq_override_cmp { … }; static const struct irq_override_cmp override_table[] = …; static bool acpi_dev_irq_override(u32 gsi, u8 triggering, u8 polarity, u8 shareable) { … } static void acpi_dev_get_irqresource(struct resource *res, u32 gsi, u8 triggering, u8 polarity, u8 shareable, u8 wake_capable, bool check_override) { … } /** * acpi_dev_resource_interrupt - Extract ACPI interrupt resource information. * @ares: Input ACPI resource object. * @index: Index into the array of GSIs represented by the resource. * @res: Output generic resource object. * * Check if the given ACPI resource object represents an interrupt resource * and @index does not exceed the resource's interrupt count (true is returned * in that case regardless of the results of the other checks)). If that's the * case, register the GSI corresponding to @index from the array of interrupts * represented by the resource and populate the generic resource object pointed * to by @res accordingly. If the registration of the GSI is not successful, * IORESOURCE_DISABLED will be set it that object's flags. * * Return: * 1) false with res->flags setting to zero: not the expected resource type * 2) false with IORESOURCE_DISABLED in res->flags: valid unassigned resource * 3) true: valid assigned resource */ bool acpi_dev_resource_interrupt(struct acpi_resource *ares, int index, struct resource *res) { … } EXPORT_SYMBOL_GPL(…); /** * acpi_dev_free_resource_list - Free resource from %acpi_dev_get_resources(). * @list: The head of the resource list to free. */ void acpi_dev_free_resource_list(struct list_head *list) { … } EXPORT_SYMBOL_GPL(…); struct res_proc_context { … }; static acpi_status acpi_dev_new_resource_entry(struct resource_win *win, struct res_proc_context *c) { … } static acpi_status acpi_dev_process_resource(struct acpi_resource *ares, void *context) { … } static int __acpi_dev_get_resources(struct acpi_device *adev, struct list_head *list, int (*preproc)(struct acpi_resource *, void *), void *preproc_data, char *method) { … } /** * acpi_dev_get_resources - Get current resources of a device. * @adev: ACPI device node to get the resources for. * @list: Head of the resultant list of resources (must be empty). * @preproc: The caller's preprocessing routine. * @preproc_data: Pointer passed to the caller's preprocessing routine. * * Evaluate the _CRS method for the given device node and process its output by * (1) executing the @preproc() routine provided by the caller, passing the * resource pointer and @preproc_data to it as arguments, for each ACPI resource * returned and (2) converting all of the returned ACPI resources into struct * resource objects if possible. If the return value of @preproc() in step (1) * is different from 0, step (2) is not applied to the given ACPI resource and * if that value is negative, the whole processing is aborted and that value is * returned as the final error code. * * The resultant struct resource objects are put on the list pointed to by * @list, that must be empty initially, as members of struct resource_entry * objects. Callers of this routine should use %acpi_dev_free_resource_list() to * free that list. * * The number of resources in the output list is returned on success, an error * code reflecting the error condition is returned otherwise. */ int acpi_dev_get_resources(struct acpi_device *adev, struct list_head *list, int (*preproc)(struct acpi_resource *, void *), void *preproc_data) { … } EXPORT_SYMBOL_GPL(…); static int is_memory(struct acpi_resource *ares, void *not_used) { … } /** * acpi_dev_get_dma_resources - Get current DMA resources of a device. * @adev: ACPI device node to get the resources for. * @list: Head of the resultant list of resources (must be empty). * * Evaluate the _DMA method for the given device node and process its * output. * * The resultant struct resource objects are put on the list pointed to * by @list, that must be empty initially, as members of struct * resource_entry objects. Callers of this routine should use * %acpi_dev_free_resource_list() to free that list. * * The number of resources in the output list is returned on success, * an error code reflecting the error condition is returned otherwise. */ int acpi_dev_get_dma_resources(struct acpi_device *adev, struct list_head *list) { … } EXPORT_SYMBOL_GPL(…); /** * acpi_dev_get_memory_resources - Get current memory resources of a device. * @adev: ACPI device node to get the resources for. * @list: Head of the resultant list of resources (must be empty). * * This is a helper function that locates all memory type resources of @adev * with acpi_dev_get_resources(). * * The number of resources in the output list is returned on success, an error * code reflecting the error condition is returned otherwise. */ int acpi_dev_get_memory_resources(struct acpi_device *adev, struct list_head *list) { … } EXPORT_SYMBOL_GPL(…); /** * acpi_dev_filter_resource_type - Filter ACPI resource according to resource * types * @ares: Input ACPI resource object. * @types: Valid resource types of IORESOURCE_XXX * * This is a helper function to support acpi_dev_get_resources(), which filters * ACPI resource objects according to resource types. */ int acpi_dev_filter_resource_type(struct acpi_resource *ares, unsigned long types) { … } EXPORT_SYMBOL_GPL(…); static int acpi_dev_consumes_res(struct acpi_device *adev, struct resource *res) { … } static acpi_status acpi_res_consumer_cb(acpi_handle handle, u32 depth, void *context, void **ret) { … } /** * acpi_resource_consumer - Find the ACPI device that consumes @res. * @res: Resource to search for. * * Search the current resource settings (_CRS) of every ACPI device node * for @res. If we find an ACPI device whose _CRS includes @res, return * it. Otherwise, return NULL. */ struct acpi_device *acpi_resource_consumer(struct resource *res) { … }
Codebase Browser
linux