Commit f028d524 authored by Rafael J. Wysocki's avatar Rafael J. Wysocki
Browse files

ACPI / GPIO: Driver GPIO mappings for ACPI GPIOs 



Provide a way for device drivers using GPIOs described by ACPI
GpioIo resources in _CRS to tell the GPIO subsystem what names
(connection IDs) to associate with specific GPIO pins defined
in there.

To do that, a driver needs to define a mapping table as a
NULL-terminated array of struct acpi_gpio_mapping objects
that each contain a name, a pointer to an array of line data
(struct acpi_gpio_params) objects and the size of that array.

Each struct acpi_gpio_params object consists of three fields,
crs_entry_index, line_index, active_low, representing the index of
the target GpioIo()/GpioInt() resource in _CRS starting from zero,
the index of the target line in that resource starting from zero,
and the active-low flag for that line, respectively.

Next, the mapping table needs to be passed as the second
argument to acpi_dev_add_driver_gpios() that will register it with
the ACPI device object pointed to by its first argument.  That
should be done in the driver's .probe() routine.

On removal, the driver should unregister its GPIO mapping table
by calling acpi_dev_remove_driver_gpios() on the ACPI device
object where that table was previously registered.

Included are fixes from Mika Westerberg.

Acked-by: default avatarAlexandre Courbot <acourbot@nvidia.com>
Reviewed-by: default avatarLinus Walleij <linus.walleij@linaro.org>
Signed-off-by: default avatarRafael J. Wysocki <rafael.j.wysocki@intel.com>
parent b26d4e22

drivers/gpio/gpiolib-acpi.c

+41 −2
Original line number Original line Diff line number Diff line
@@ -287,6 +287,41 @@ void acpi_gpiochip_free_interrupts(struct gpio_chip *chip) 
	}

	}

}

}





int acpi_dev_add_driver_gpios(struct acpi_device *adev,

			      const struct acpi_gpio_mapping *gpios)

{

	if (adev && gpios) {

		adev->driver_gpios = gpios;

		return 0;

	}

	return -EINVAL;

}

EXPORT_SYMBOL_GPL(acpi_dev_add_driver_gpios);



static bool acpi_get_driver_gpio_data(struct acpi_device *adev,

				      const char *name, int index,

				      struct acpi_reference_args *args)

{

	const struct acpi_gpio_mapping *gm;



	if (!adev->driver_gpios)

		return false;



	for (gm = adev->driver_gpios; gm->name; gm++)

		if (!strcmp(name, gm->name) && gm->data && index < gm->size) {

			const struct acpi_gpio_params *par = gm->data + index;



			args->adev = adev;

			args->args[0] = par->crs_entry_index;

			args->args[1] = par->line_index;

			args->args[2] = par->active_low;

			args->nargs = 3;

			return true;

		}



	return false;

}



struct acpi_gpio_lookup {

struct acpi_gpio_lookup {

	struct acpi_gpio_info info;

	struct acpi_gpio_info info;

	int index;

	int index;
@@ -372,8 +407,12 @@ struct gpio_desc *acpi_get_gpiod_by_index(struct acpi_device *adev, 
		memset(&args, 0, sizeof(args));

		memset(&args, 0, sizeof(args));

		ret = acpi_dev_get_property_reference(adev, propname, NULL,

		ret = acpi_dev_get_property_reference(adev, propname, NULL,

						      index, &args);

						      index, &args);

		if (ret)

		if (ret) {

			bool found = acpi_get_driver_gpio_data(adev, propname,

							       index, &args);

			if (!found)

				return ERR_PTR(ret);

				return ERR_PTR(ret);

		}





		/*

		/*

		 * The property was found and resolved so need to

		 * The property was found and resolved so need to

include/acpi/acpi_bus.h

+3 −0
Original line number Original line Diff line number Diff line
@@ -345,6 +345,8 @@ struct acpi_device_data { 
	const union acpi_object *of_compatible;

	const union acpi_object *of_compatible;

};

};





struct acpi_gpio_mapping;



/* Device */

/* Device */

struct acpi_device {

struct acpi_device {

	int device_type;

	int device_type;
@@ -366,6 +368,7 @@ struct acpi_device { 
	struct acpi_scan_handler *handler;

	struct acpi_scan_handler *handler;

	struct acpi_hotplug_context *hp;

	struct acpi_hotplug_context *hp;

	struct acpi_driver *driver;

	struct acpi_driver *driver;

	const struct acpi_gpio_mapping *driver_gpios;

	void *driver_data;

	void *driver_data;

	struct device dev;

	struct device dev;

	unsigned int physical_node_count;

	unsigned int physical_node_count;

include/linux/acpi.h

+30 −0
Original line number Original line Diff line number Diff line
@@ -673,6 +673,36 @@ do { \ 
#endif

#endif

#endif

#endif





struct acpi_gpio_params {

	unsigned int crs_entry_index;

	unsigned int line_index;

	bool active_low;

};



struct acpi_gpio_mapping {

	const char *name;

	const struct acpi_gpio_params *data;

	unsigned int size;

};



#if defined(CONFIG_ACPI) && defined(CONFIG_GPIOLIB)

int acpi_dev_add_driver_gpios(struct acpi_device *adev,

			      const struct acpi_gpio_mapping *gpios);



static inline void acpi_dev_remove_driver_gpios(struct acpi_device *adev)

{

	if (adev)

		adev->driver_gpios = NULL;

}

#else

static inline int acpi_dev_add_driver_gpios(struct acpi_device *adev,

			      const struct acpi_gpio_mapping *gpios)

{

	return -ENXIO;

}

static inline void acpi_dev_remove_driver_gpios(struct acpi_device *adev) {}

#endif



/* Device properties */

/* Device properties */





#define MAX_ACPI_REFERENCE_ARGS	8

#define MAX_ACPI_REFERENCE_ARGS	8

CRA Git | Maintained and supported by SUSTech CRA and CCSE