pinctrl: qcom: add support for sparse GPIOs
Subsystems (5)
v11 cover pinctrl: qcom: add support for sparse GPIOs
A series of patches that add support for GPIO maps that have holes in them. That is, even though a client driver has N consecutive GPIOs, some are just unavailable for whatever reason, and the hardware should not be accessed for those GPIOs.
Patch 1 reverts an old patch that triggers a get_direction of every pin upon init, without attempting to request the pins first. The direction is already being queried when the pin is requested.
Patch 2 adds support to pinctrl-msm for "unavailable" GPIOs.
Patch 3 extends that support to pinctrl-qdf2xxx. A recent ACPI change on QDF2400 platforms blocks access to most pins, so the driver can only register a subset.
This version drops the availability check in gpiolib, because it's no necessary. Instead, just having pinctrl-msm return -EACCES is enough to block all unavailable GPIOs. Patch 1 removes the only instance where an unrequested GPIO is being accessed.
v11:
Drop support for QCOM8001
Timur Tabi (3):
[v2] Revert "gpio: set up initial state from .get_direction()" [v8] pinctrl: qcom: disable GPIO groups with no pins [v7] pinctrl: qcom: qdf2xxx: add support for new ACPI HID QCOM8002
drivers/gpio/gpiolib.c | 31 +++-------- drivers/pinctrl/qcom/pinctrl-msm.c | 28 ++++++++-- drivers/pinctrl/qcom/pinctrl-qdf2xxx.c | 96 ++++++++++++++++++++++------------ 3 files changed, 94 insertions(+), 61 deletions(-)
Signature · 3 lines
Qualcomm Datacenter Technologies, Inc. as an affiliate of Qualcomm Technologies, Inc. Qualcomm Technologies, Inc. is a member of the Code Aurora Forum, a Linux Foundation Collaborative Project.
PATCH v2 1/3 Revert "gpio: set up initial state from .get_direction()"
This reverts commit 72d3200061776264941be1b5a9bb8e926b3b30a5.
We cannot blindly query the direction of all GPIOs when the pins are first registered. The get_direction callback normally triggers a read/write to hardware, but we shouldn't be touching the hardware for an individual GPIO until after it's been properly claimed.
--- drivers/gpio/gpiolib.c | 31 +++++++------------------------ 1 file changed, 7 insertions(+), 24 deletions(-)
drivers/gpio/gpiolib.c +7 -24
@@ -1207,31 +1207,14 @@ int gpiochip_add_data_with_key(struct gpio_chip *chip, void *data,struct gpio_desc *desc = &gdev->descs[i]; desc->gdev = gdev; -/* -* REVISIT: most hardware initializes GPIOs as inputs -* (often with pullups enabled) so power usage is -* minimized. Linux code should set the gpio direction -* first thing; but until it does, and in case -* chip->get_direction is not set, we may expose the -* wrong direction in sysfs. -*/ - -if (chip->get_direction) { -/* -* If we have .get_direction, set up the initial -* direction flag from the hardware. -*/ -int dir = chip->get_direction (chip, i); -if (!dir) -set_bit (FLAG_IS_OUT , &desc->flags); - }else if (!chip->direction_input) { -/* -* If the chip lacks the .direction_input callback -* we logically assume all lines are outputs. -*/ -set_bit (FLAG_IS_OUT , &desc->flags); - } +/* REVISIT: most hardware initializes GPIOs as inputs (often +* with pullups enabled) so power usage is minimized. Linux +* code should set the gpio direction first thing; but until +* it does, and in case chip->get_direction is not set, we may +* expose the wrong direction in sysfs. +*/ + desc->flags = !chip->direction_input ? (1 <<FLAG_IS_OUT ) :0 ; }#ifdef CONFIG_PINCTRL
Signature · 3 lines
Qualcomm Datacenter Technologies, Inc. as an affiliate of Qualcomm Technologies, Inc. Qualcomm Technologies, Inc. is a member of the Code Aurora Forum, a Linux Foundation Collaborative Project.
PATCH v8 2/3 pinctrl: qcom: disable GPIO groups with no pins
In reply to Timur Tabipinctrl-msm only accepts an array of GPIOs from 0 to n-1, and it expects each group to support have only one pin (npins == 1).
We can support "sparse" GPIO maps if we allow for some groups to have zero pins (npins == 0). These pins are "hidden" from the rest of the driver and gpiolib.
Access to unavailable GPIOs is blocked via a request callback. If the requested GPIO is unavailable, -EACCES is returned, which prevents further access to that GPIO.
--- drivers/pinctrl/qcom/pinctrl-msm.c | 28 +++++++++++++++++++++++----- 1 file changed, 23 insertions(+), 5 deletions(-)
drivers/pinctrl/qcom/pinctrl-msm.c +23 -5
@@ -507,6 +507,11 @@ static void msm_gpio_dbg_show_one(struct seq_file *s, }; g = &pctrl->soc->groups[offset]; + +/* If the GPIO group has no pins, then don't show it. */ +if (!g->npins) +return ; + ctl_reg =readl (pctrl->regs + g->ctl_reg); is_out = !!(ctl_reg &BIT (g->oe_bit));
@@ -516,7 +521,7 @@ static void msm_gpio_dbg_show_one(struct seq_file *s,seq_printf (s," %-8s: %-3s %d" , g->name, is_out ?"out" :"in" , func);seq_printf (s," %dmA" ,msm_regval_to_drive (drive)); -seq_printf (s," %s" , pulls[pull]); +seq_printf (s," %s\n" , pulls[pull]); }static void msm_gpio_dbg_show (struct seq_file *s,struct gpio_chip *chip)
@@ -524,23 +529,36 @@ static void msm_gpio_dbg_show(struct seq_file *s, struct gpio_chip *chip)unsigned gpio = chip->base;unsigned i; -for (i =0 ; i < chip->ngpio; i++, gpio++) { +for (i =0 ; i < chip->ngpio; i++, gpio++) msm_gpio_dbg_show_one(s, NULL, chip, i, gpio); -seq_puts (s,"\n" ); - } }#else #define msm_gpio_dbg_show NULL#endif +/* +* If the requested GPIO has no pins, then treat it as unavailable. +* Otherwise, call the standard request function. +*/ +static int msm_gpio_request (struct gpio_chip *chip,unsigned int offset) +{ +struct msm_pinctrl *pctrl =gpiochip_get_data (chip); +const struct msm_pingroup *g = &pctrl->soc->groups[offset]; + +if (!g->npins) +return -EACCES ; + +return gpiochip_generic_request (chip, offset); +} +static const struct gpio_chip msm_gpio_template = { .direction_input = msm_gpio_direction_input, .direction_output = msm_gpio_direction_output, .get_direction = msm_gpio_get_direction, .get = msm_gpio_get, .set = msm_gpio_set, - .request = gpiochip_generic_request, + .request = msm_gpio_request, .free = gpiochip_generic_free, .dbg_show = msm_gpio_dbg_show, };
Signature · 3 lines
Qualcomm Datacenter Technologies, Inc. as an affiliate of Qualcomm Technologies, Inc. Qualcomm Technologies, Inc. is a member of the Code Aurora Forum, a Linux Foundation Collaborative Project.
PATCH v7 3/3 pinctrl: qcom: qdf2xxx: add support for new ACPI HID QCOM8002
In reply to Timur TabiNewer versions of the firmware for the Qualcomm Datacenter Technologies QDF2400 restricts access to a subset of the GPIOs on the TLMM. To prevent older kernels from accidentally accessing the restricted GPIOs, we change the ACPI HID for the TLMM block from QCOM8001 to QCOM8002, and introduce a new property "gpios". This property is an array of specific GPIOs that are accessible. When an older kernel boots on newer (restricted) firmware, it will fail to probe.
To implement the sparse GPIO map, we register all of the GPIOs, but set the pin count for the unavailable GPIOs to zero. The pinctrl-msm driver will block those unavailable GPIOs from being accessed.
Support for QCOM8001 is removed as there is no longer any firmware that implements it.
--- drivers/pinctrl/qcom/pinctrl-qdf2xxx.c | 96 ++++++++++++++++++++++------------ 1 file changed, 64 insertions(+), 32 deletions(-)
drivers/pinctrl/qcom/pinctrl-qdf2xxx.c +64 -32
@@ -32,7 +32,7 @@static struct msm_pinctrl_soc_data qdf2xxx_pinctrl; -/* A reasonable limit to the number of GPIOS */ +/* A maximum of 256 allows us to use a u8 array to hold the GPIO numbers */ #define MAX_GPIOS 256/* maximum size of each gpio name (enough room for "gpioXXX" + null) */
@@ -45,59 +45,91 @@ static int qdf2xxx_pinctrl_probe(struct platform_device *pdev)char (*names)[NAME_SIZE ];unsigned int i;u32 num_gpios; +unsigned int avail_gpios;/* The number of GPIOs we support */ +u8 gpios[MAX_GPIOS ];/* An array of supported GPIOs */ int ret;/* Query the number of GPIOs from ACPI */ ret =device_property_read_u32 (&pdev->dev,"num-gpios" , &num_gpios);if (ret <0 ) { -dev_warn (&pdev->dev,"missing num-gpios property\n" ); +dev_err (&pdev->dev,"missing 'num-gpios' property\n" );return ret; } -if (!num_gpios || num_gpios >MAX_GPIOS ) { -dev_warn (&pdev->dev,"invalid num-gpios property\n" ); +dev_err (&pdev->dev,"invalid 'num-gpios' property\n" ); +return -ENODEV ; + } + +/* The number of GPIOs in the approved list */ + ret =device_property_read_u8_array (&pdev->dev,"gpios" ,NULL ,0 ); +if (ret <0 ) { +dev_err (&pdev->dev,"missing 'gpios' property\n" ); +return ret; + } +/* +* The number of available GPIOs should be non-zero, and no +* more than the total number of GPIOS. +*/ +if (!ret || ret > num_gpios) { +dev_err (&pdev->dev,"invalid 'gpios' property\n" );return -ENODEV ; } + avail_gpios = ret; + + ret =device_property_read_u8_array (&pdev->dev,"gpios" , gpios, + avail_gpios); +if (ret <0 ) { +dev_err (&pdev->dev,"could not read list of GPIOs\n" ); +return ret; + } pins =devm_kcalloc (&pdev->dev, num_gpios,sizeof (struct pinctrl_pin_desc ),GFP_KERNEL ); groups =devm_kcalloc (&pdev->dev, num_gpios,sizeof (struct msm_pingroup ),GFP_KERNEL ); - names =devm_kcalloc (&pdev->dev, num_gpios,NAME_SIZE ,GFP_KERNEL ); + names =devm_kcalloc (&pdev->dev, avail_gpios,NAME_SIZE ,GFP_KERNEL );if (!pins || !groups || !names)return -ENOMEM ; +/* +* Initialize the array. GPIOs not listed in the 'gpios' array +* still need a number, but nothing else. +*/ for (i =0 ; i < num_gpios; i++) { -snprintf (names[i],NAME_SIZE ,"gpio%u" , i); - pins[i].number = i; - pins[i].name = names[i]; - - groups[i].npins =1 ; - groups[i].name = names[i]; groups[i].pins = &pins[i].number; + } - groups[i].ctl_reg =0x10000 * i; - groups[i].io_reg =0x04 +0x10000 * i; - groups[i].intr_cfg_reg =0x08 +0x10000 * i; - groups[i].intr_status_reg =0x0c +0x10000 * i; - groups[i].intr_target_reg =0x08 +0x10000 * i; - - groups[i].mux_bit =2 ; - groups[i].pull_bit =0 ; - groups[i].drv_bit =6 ; - groups[i].oe_bit =9 ; - groups[i].in_bit =0 ; - groups[i].out_bit =1 ; - groups[i].intr_enable_bit =0 ; - groups[i].intr_status_bit =0 ; - groups[i].intr_target_bit =5 ; - groups[i].intr_target_kpss_val =1 ; - groups[i].intr_raw_status_bit =4 ; - groups[i].intr_polarity_bit =1 ; - groups[i].intr_detection_bit =2 ; - groups[i].intr_detection_width =2 ; +/* Populate the entries that are meant to be exposed as GPIOs. */ +for (i =0 ; i < avail_gpios; i++) { +unsigned int gpio = gpios[i]; + + groups[gpio].npins =1 ; +snprintf (names[i],NAME_SIZE ,"gpio%u" , gpio); + pins[gpio].name = names[i]; + groups[gpio].name = names[i]; + + groups[gpio].ctl_reg =0x10000 * gpio; + groups[gpio].io_reg =0x04 +0x10000 * gpio; + groups[gpio].intr_cfg_reg =0x08 +0x10000 * gpio; + groups[gpio].intr_status_reg =0x0c +0x10000 * gpio; + groups[gpio].intr_target_reg =0x08 +0x10000 * gpio; + + groups[gpio].mux_bit =2 ; + groups[gpio].pull_bit =0 ; + groups[gpio].drv_bit =6 ; + groups[gpio].oe_bit =9 ; + groups[gpio].in_bit =0 ; + groups[gpio].out_bit =1 ; + groups[gpio].intr_enable_bit =0 ; + groups[gpio].intr_status_bit =0 ; + groups[gpio].intr_target_bit =5 ; + groups[gpio].intr_target_kpss_val =1 ; + groups[gpio].intr_raw_status_bit =4 ; + groups[gpio].intr_polarity_bit =1 ; + groups[gpio].intr_detection_bit =2 ; + groups[gpio].intr_detection_width =2 ; } qdf2xxx_pinctrl.pins = pins;
@@ -110,7 +142,7 @@ static int qdf2xxx_pinctrl_probe(struct platform_device *pdev) }static const struct acpi_device_id qdf2xxx_acpi_ids[] = { - {"QCOM8001" }, + {"QCOM8002" }, {}, };MODULE_DEVICE_TABLE (acpi, qdf2xxx_acpi_ids);
Signature · 3 lines
Qualcomm Datacenter Technologies, Inc. as an affiliate of Qualcomm Technologies, Inc. Qualcomm Technologies, Inc. is a member of the Code Aurora Forum, a Linux Foundation Collaborative Project.
v11 cover pinctrl: qcom: add support for sparse GPIOs
In reply to Timur TabiHi Timur,
thank you for your perseverance. I am sorry that I am sometimes not fast to respond :(
Quoted 5 lines · Timur Tabi
Patch 1 reverts an old patch that triggers a
get_directionof every pin upon init, without attempting to request the pins first. The direction is already being queried when the pin is requested.Patch 2 adds support to pinctrl-msm for "unavailable" GPIOs.
I have applied both of these to the pinctrl "devel" branch so we can see if all is fine.
They have Stephen's ACK so I am happy with them, I am just still slightly worried about possible regressions because of patch 1.
Quoted 3 lines
Patch 3 extends that support to pinctrl-qdf2xxx. A recent ACPI change on QDF2400 platforms blocks access to most pins, so the driver can only register a subset.
I see this one is still under discussion.
If nothing drastic happens with patch 1/2 in linux-next it should be fine if you just resend this single patch in subsequent submissions.
I think it may be worthwhile to keep Andrew Cooks in the loop for future submissions as he's trying to solve similar problems for AMD.
Yours,
Linus Walleij
v11 cover pinctrl: qcom: add support for sparse GPIOs
Quoted 24 lines · Linus Walleij
Hi Timur,
thank you for your perseverance. I am sorry that I am sometimes not fast to respond :(
Quoted 5 lines · Timur Tabi
Patch 1 reverts an old patch that triggers a
get_directionof every pin upon init, without attempting to request the pins first. The direction is already being queried when the pin is requested.Patch 2 adds support to pinctrl-msm for "unavailable" GPIOs.
I have applied both of these to the pinctrl "devel" branch so we can see if all is fine.
They have Stephen's ACK so I am happy with them, I am just still slightly worried about possible regressions because of patch 1.
Quoted 3 lines
Patch 3 extends that support to pinctrl-qdf2xxx. A recent ACPI change on QDF2400 platforms blocks access to most pins, so the driver can only register a subset.
Quoted 6 lines
I see this one is still under discussion.
If nothing drastic happens with patch 1/2 in linux-next it should be fine if you just resend this single patch in subsequent submissions.
If we go with my suggestion, patch 2 is not necessary and should be dropped. The different approaches come down to expressing which pins are available through the gpio valid mask, or through the npins field of the msm pinctrl driver. Also, my approach covers more than just GPIOs, it covers irqs and adjusts the pinctrl pin request function so that pinctrl can't request unavailable pins.
Signature · 2 lines
Qualcomm Innovation Center, Inc. is a member of Code Aurora Forum, a Linux Foundation Collaborative Project
v11 cover pinctrl: qcom: add support for sparse GPIOs
Quoted 27 lines · Stephen Boyd
Quoted 26 lines · Linus Walleij
Hi Timur,
thank you for your perseverance. I am sorry that I am sometimes not fast to respond :(
Quoted 5 lines · Timur Tabi
Patch 1 reverts an old patch that triggers a
get_directionof every pin upon init, without attempting to request the pins first. The direction is already being queried when the pin is requested.Patch 2 adds support to pinctrl-msm for "unavailable" GPIOs.
I have applied both of these to the pinctrl "devel" branch so we can see if all is fine.
They have Stephen's ACK so I am happy with them, I am just still slightly worried about possible regressions because of patch 1.
Quoted 3 lines
Patch 3 extends that support to pinctrl-qdf2xxx. A recent ACPI change on QDF2400 platforms blocks access to most pins, so the driver can only register a subset.
I see this one is still under discussion.
Quoted 7 lines
Quoted 4 lines
If nothing drastic happens with patch 1/2 in linux-next it should be fine if you just resend this single patch in subsequent submissions.
If we go with my suggestion, patch 2 is not necessary and should be dropped.
OK I have reverted it.
Quoted 6 lines
The different approaches come down to expressing
which pins are available through the gpio valid mask, or through the npins field of the msm pinctrl driver. Also, my approach covers more than just GPIOs, it covers irqs and adjusts the pinctrl pin request function so that pinctrl can't request unavailable pins.
I agree, this is better.
Would even patch 1 be needed after this? Maybe I should revert that too. Leaving that code in has the upside of showing the actual initial directions of GPIO lines even if they have not been requested, in e.g. debugfs.
Yours,
Linus Walleij
v11 cover pinctrl: qcom: add support for sparse GPIOs
Quoted 10 lines · Linus Walleij
Quoted 6 lines · Stephen Boyd
The different approaches come down to expressing
which pins are available through the gpio valid mask, or through the npins field of the msm pinctrl driver. Also, my approach covers more than just GPIOs, it covers irqs and adjusts the pinctrl pin request function so that pinctrl can't request unavailable pins.I agree, this is better.
Thanks for the feedback. I'll update and resend my patch to the list.
Quoted 6 lines
Would even patch 1 be needed after this? Maybe I should revert that too. Leaving that code in has the upside of showing the actual initial directions of GPIO lines even if they have not been requested, in e.g. debugfs.
Patch 1 is still needed. Without that patch, we'll be poking each GPIO to figure out the direction at boot without checking any valid mask or calling the request APIs. I don't see the part in debugfs where we show the direction of a GPIO if it hasn't been requested. Don't we skip over the unrequested GPIOs because of this code in gpiolib_dbg_show()?
if (!test_bit(FLAG_REQUESTED, &gdesc->flags)) {
...
continue;
}Signature · 2 lines
Qualcomm Innovation Center, Inc. is a member of Code Aurora Forum, a Linux Foundation Collaborative Project
v11 cover pinctrl: qcom: add support for sparse GPIOs
Quoted 3 lines · Stephen Boyd
Patch 1 is still needed. Without that patch, we'll be poking each GPIO to figure out the direction at boot without checking any valid mask or calling the request APIs.
Aha, I just thought you'd augment that code to take valid GPIOs into account.
Anyways, I left the patch in, so no worries.
Quoted 9 lines
I don't see the part in
debugfs where we show the direction of a GPIO if it hasn't been requested. Don't we skip over the unrequested GPIOs because of this code ingpiolib_dbg_show()?if (!test_bit(FLAG_REQUESTED, &gdesc->flags)) { ... continue; }
Yes you're right. This is more for lsgpio and the chardev side of things for inspecting lines really.
Yours,
Linus Walleij