1 // SPDX-License-Identifier: GPL-2.0
3 * Copyright (C) Maxime Coquelin 2015
4 * Copyright (C) STMicroelectronics 2017
5 * Author: Maxime Coquelin <mcoquelin.stm32@gmail.com>
7 * Heavily based on Mediatek's pinctrl driver
10 #include <linux/gpio/driver.h>
11 #include <linux/hwspinlock.h>
13 #include <linux/irq.h>
14 #include <linux/mfd/syscon.h>
15 #include <linux/module.h>
17 #include <linux/of_address.h>
18 #include <linux/of_device.h>
19 #include <linux/of_irq.h>
20 #include <linux/pinctrl/consumer.h>
21 #include <linux/pinctrl/machine.h>
22 #include <linux/pinctrl/pinconf.h>
23 #include <linux/pinctrl/pinconf-generic.h>
24 #include <linux/pinctrl/pinctrl.h>
25 #include <linux/pinctrl/pinmux.h>
26 #include <linux/platform_device.h>
27 #include <linux/property.h>
28 #include <linux/regmap.h>
29 #include <linux/reset.h>
30 #include <linux/slab.h>
33 #include "../pinconf.h"
34 #include "../pinctrl-utils.h"
35 #include "pinctrl-stm32.h"
37 #define STM32_GPIO_MODER 0x00
38 #define STM32_GPIO_TYPER 0x04
39 #define STM32_GPIO_SPEEDR 0x08
40 #define STM32_GPIO_PUPDR 0x0c
41 #define STM32_GPIO_IDR 0x10
42 #define STM32_GPIO_ODR 0x14
43 #define STM32_GPIO_BSRR 0x18
44 #define STM32_GPIO_LCKR 0x1c
45 #define STM32_GPIO_AFRL 0x20
46 #define STM32_GPIO_AFRH 0x24
48 /* custom bitfield to backup pin status */
49 #define STM32_GPIO_BKP_MODE_SHIFT 0
50 #define STM32_GPIO_BKP_MODE_MASK GENMASK(1, 0)
51 #define STM32_GPIO_BKP_ALT_SHIFT 2
52 #define STM32_GPIO_BKP_ALT_MASK GENMASK(5, 2)
53 #define STM32_GPIO_BKP_SPEED_SHIFT 6
54 #define STM32_GPIO_BKP_SPEED_MASK GENMASK(7, 6)
55 #define STM32_GPIO_BKP_PUPD_SHIFT 8
56 #define STM32_GPIO_BKP_PUPD_MASK GENMASK(9, 8)
57 #define STM32_GPIO_BKP_TYPE 10
58 #define STM32_GPIO_BKP_VAL 11
60 #define STM32_GPIO_PINS_PER_BANK 16
61 #define STM32_GPIO_IRQ_LINE 16
63 #define SYSCFG_IRQMUX_MASK GENMASK(3, 0)
65 #define gpio_range_to_bank(chip) \
66 container_of(chip, struct stm32_gpio_bank, range)
68 #define HWSPNLCK_TIMEOUT 1000 /* usec */
70 static const char * const stm32_gpio_functions[] = {
75 "af11", "af12", "af13",
76 "af14", "af15", "analog",
79 struct stm32_pinctrl_group {
85 struct stm32_gpio_bank {
88 struct reset_control *rstc;
90 struct gpio_chip gpio_chip;
91 struct pinctrl_gpio_range range;
92 struct fwnode_handle *fwnode;
93 struct irq_domain *domain;
96 u32 pin_backup[STM32_GPIO_PINS_PER_BANK];
97 u8 irq_type[STM32_GPIO_PINS_PER_BANK];
100 struct stm32_pinctrl {
102 struct pinctrl_dev *pctl_dev;
103 struct pinctrl_desc pctl_desc;
104 struct stm32_pinctrl_group *groups;
106 const char **grp_names;
107 struct stm32_gpio_bank *banks;
109 const struct stm32_pinctrl_match_data *match_data;
110 struct irq_domain *domain;
111 struct regmap *regmap;
112 struct regmap_field *irqmux[STM32_GPIO_PINS_PER_BANK];
113 struct hwspinlock *hwlock;
114 struct stm32_desc_pin *pins;
118 spinlock_t irqmux_lock;
121 static inline int stm32_gpio_pin(int gpio)
123 return gpio % STM32_GPIO_PINS_PER_BANK;
126 static inline u32 stm32_gpio_get_mode(u32 function)
131 case STM32_PIN_AF(0) ... STM32_PIN_AF(15):
133 case STM32_PIN_ANALOG:
140 static inline u32 stm32_gpio_get_alt(u32 function)
145 case STM32_PIN_AF(0) ... STM32_PIN_AF(15):
147 case STM32_PIN_ANALOG:
154 static void stm32_gpio_backup_value(struct stm32_gpio_bank *bank,
155 u32 offset, u32 value)
157 bank->pin_backup[offset] &= ~BIT(STM32_GPIO_BKP_VAL);
158 bank->pin_backup[offset] |= value << STM32_GPIO_BKP_VAL;
161 static void stm32_gpio_backup_mode(struct stm32_gpio_bank *bank, u32 offset,
164 bank->pin_backup[offset] &= ~(STM32_GPIO_BKP_MODE_MASK |
165 STM32_GPIO_BKP_ALT_MASK);
166 bank->pin_backup[offset] |= mode << STM32_GPIO_BKP_MODE_SHIFT;
167 bank->pin_backup[offset] |= alt << STM32_GPIO_BKP_ALT_SHIFT;
170 static void stm32_gpio_backup_driving(struct stm32_gpio_bank *bank, u32 offset,
173 bank->pin_backup[offset] &= ~BIT(STM32_GPIO_BKP_TYPE);
174 bank->pin_backup[offset] |= drive << STM32_GPIO_BKP_TYPE;
177 static void stm32_gpio_backup_speed(struct stm32_gpio_bank *bank, u32 offset,
180 bank->pin_backup[offset] &= ~STM32_GPIO_BKP_SPEED_MASK;
181 bank->pin_backup[offset] |= speed << STM32_GPIO_BKP_SPEED_SHIFT;
184 static void stm32_gpio_backup_bias(struct stm32_gpio_bank *bank, u32 offset,
187 bank->pin_backup[offset] &= ~STM32_GPIO_BKP_PUPD_MASK;
188 bank->pin_backup[offset] |= bias << STM32_GPIO_BKP_PUPD_SHIFT;
193 static inline void __stm32_gpio_set(struct stm32_gpio_bank *bank,
194 unsigned offset, int value)
196 stm32_gpio_backup_value(bank, offset, value);
199 offset += STM32_GPIO_PINS_PER_BANK;
201 clk_enable(bank->clk);
203 writel_relaxed(BIT(offset), bank->base + STM32_GPIO_BSRR);
205 clk_disable(bank->clk);
208 static int stm32_gpio_request(struct gpio_chip *chip, unsigned offset)
210 struct stm32_gpio_bank *bank = gpiochip_get_data(chip);
211 struct stm32_pinctrl *pctl = dev_get_drvdata(bank->gpio_chip.parent);
212 struct pinctrl_gpio_range *range;
213 int pin = offset + (bank->bank_nr * STM32_GPIO_PINS_PER_BANK);
215 range = pinctrl_find_gpio_range_from_pin_nolock(pctl->pctl_dev, pin);
217 dev_err(pctl->dev, "pin %d not in range.\n", pin);
221 return pinctrl_gpio_request(chip->base + offset);
224 static void stm32_gpio_free(struct gpio_chip *chip, unsigned offset)
226 pinctrl_gpio_free(chip->base + offset);
229 static int stm32_gpio_get_noclk(struct gpio_chip *chip, unsigned int offset)
231 struct stm32_gpio_bank *bank = gpiochip_get_data(chip);
233 return !!(readl_relaxed(bank->base + STM32_GPIO_IDR) & BIT(offset));
236 static int stm32_gpio_get(struct gpio_chip *chip, unsigned offset)
238 struct stm32_gpio_bank *bank = gpiochip_get_data(chip);
241 clk_enable(bank->clk);
243 ret = stm32_gpio_get_noclk(chip, offset);
245 clk_disable(bank->clk);
250 static void stm32_gpio_set(struct gpio_chip *chip, unsigned offset, int value)
252 struct stm32_gpio_bank *bank = gpiochip_get_data(chip);
254 __stm32_gpio_set(bank, offset, value);
257 static int stm32_gpio_direction_input(struct gpio_chip *chip, unsigned offset)
259 return pinctrl_gpio_direction_input(chip->base + offset);
262 static int stm32_gpio_direction_output(struct gpio_chip *chip,
263 unsigned offset, int value)
265 struct stm32_gpio_bank *bank = gpiochip_get_data(chip);
267 __stm32_gpio_set(bank, offset, value);
268 pinctrl_gpio_direction_output(chip->base + offset);
274 static int stm32_gpio_to_irq(struct gpio_chip *chip, unsigned int offset)
276 struct stm32_gpio_bank *bank = gpiochip_get_data(chip);
277 struct irq_fwspec fwspec;
279 fwspec.fwnode = bank->fwnode;
280 fwspec.param_count = 2;
281 fwspec.param[0] = offset;
282 fwspec.param[1] = IRQ_TYPE_NONE;
284 return irq_create_fwspec_mapping(&fwspec);
287 static int stm32_gpio_get_direction(struct gpio_chip *chip, unsigned int offset)
289 struct stm32_gpio_bank *bank = gpiochip_get_data(chip);
290 int pin = stm32_gpio_pin(offset);
294 stm32_pmx_get_mode(bank, pin, &mode, &alt);
295 if ((alt == 0) && (mode == 0))
296 ret = GPIO_LINE_DIRECTION_IN;
297 else if ((alt == 0) && (mode == 1))
298 ret = GPIO_LINE_DIRECTION_OUT;
305 static const struct gpio_chip stm32_gpio_template = {
306 .request = stm32_gpio_request,
307 .free = stm32_gpio_free,
308 .get = stm32_gpio_get,
309 .set = stm32_gpio_set,
310 .direction_input = stm32_gpio_direction_input,
311 .direction_output = stm32_gpio_direction_output,
312 .to_irq = stm32_gpio_to_irq,
313 .get_direction = stm32_gpio_get_direction,
314 .set_config = gpiochip_generic_config,
317 static void stm32_gpio_irq_trigger(struct irq_data *d)
319 struct stm32_gpio_bank *bank = d->domain->host_data;
322 /* Do not access the GPIO if this is not LEVEL triggered IRQ. */
323 if (!(bank->irq_type[d->hwirq] & IRQ_TYPE_LEVEL_MASK))
326 /* If level interrupt type then retrig */
327 level = stm32_gpio_get_noclk(&bank->gpio_chip, d->hwirq);
328 if ((level == 0 && bank->irq_type[d->hwirq] == IRQ_TYPE_LEVEL_LOW) ||
329 (level == 1 && bank->irq_type[d->hwirq] == IRQ_TYPE_LEVEL_HIGH))
330 irq_chip_retrigger_hierarchy(d);
333 static void stm32_gpio_irq_eoi(struct irq_data *d)
335 irq_chip_eoi_parent(d);
336 stm32_gpio_irq_trigger(d);
339 static int stm32_gpio_set_type(struct irq_data *d, unsigned int type)
341 struct stm32_gpio_bank *bank = d->domain->host_data;
345 case IRQ_TYPE_EDGE_RISING:
346 case IRQ_TYPE_EDGE_FALLING:
347 case IRQ_TYPE_EDGE_BOTH:
350 case IRQ_TYPE_LEVEL_HIGH:
351 parent_type = IRQ_TYPE_EDGE_RISING;
353 case IRQ_TYPE_LEVEL_LOW:
354 parent_type = IRQ_TYPE_EDGE_FALLING;
360 bank->irq_type[d->hwirq] = type;
362 return irq_chip_set_type_parent(d, parent_type);
365 static int stm32_gpio_irq_request_resources(struct irq_data *irq_data)
367 struct stm32_gpio_bank *bank = irq_data->domain->host_data;
368 struct stm32_pinctrl *pctl = dev_get_drvdata(bank->gpio_chip.parent);
372 ret = stm32_gpio_direction_input(&bank->gpio_chip, irq_data->hwirq);
376 ret = gpiochip_lock_as_irq(&bank->gpio_chip, irq_data->hwirq);
378 dev_err(pctl->dev, "unable to lock HW IRQ %lu for IRQ\n",
383 flags = irqd_get_trigger_type(irq_data);
384 if (flags & IRQ_TYPE_LEVEL_MASK)
385 clk_enable(bank->clk);
390 static void stm32_gpio_irq_release_resources(struct irq_data *irq_data)
392 struct stm32_gpio_bank *bank = irq_data->domain->host_data;
394 if (bank->irq_type[irq_data->hwirq] & IRQ_TYPE_LEVEL_MASK)
395 clk_disable(bank->clk);
397 gpiochip_unlock_as_irq(&bank->gpio_chip, irq_data->hwirq);
400 static void stm32_gpio_irq_unmask(struct irq_data *d)
402 irq_chip_unmask_parent(d);
403 stm32_gpio_irq_trigger(d);
406 static struct irq_chip stm32_gpio_irq_chip = {
408 .irq_eoi = stm32_gpio_irq_eoi,
409 .irq_ack = irq_chip_ack_parent,
410 .irq_mask = irq_chip_mask_parent,
411 .irq_unmask = stm32_gpio_irq_unmask,
412 .irq_set_type = stm32_gpio_set_type,
413 .irq_set_wake = irq_chip_set_wake_parent,
414 .irq_request_resources = stm32_gpio_irq_request_resources,
415 .irq_release_resources = stm32_gpio_irq_release_resources,
418 static int stm32_gpio_domain_translate(struct irq_domain *d,
419 struct irq_fwspec *fwspec,
420 unsigned long *hwirq,
423 if ((fwspec->param_count != 2) ||
424 (fwspec->param[0] >= STM32_GPIO_IRQ_LINE))
427 *hwirq = fwspec->param[0];
428 *type = fwspec->param[1];
432 static int stm32_gpio_domain_activate(struct irq_domain *d,
433 struct irq_data *irq_data, bool reserve)
435 struct stm32_gpio_bank *bank = d->host_data;
436 struct stm32_pinctrl *pctl = dev_get_drvdata(bank->gpio_chip.parent);
440 ret = hwspin_lock_timeout_in_atomic(pctl->hwlock,
443 dev_err(pctl->dev, "Can't get hwspinlock\n");
448 regmap_field_write(pctl->irqmux[irq_data->hwirq], bank->bank_ioport_nr);
451 hwspin_unlock_in_atomic(pctl->hwlock);
456 static int stm32_gpio_domain_alloc(struct irq_domain *d,
458 unsigned int nr_irqs, void *data)
460 struct stm32_gpio_bank *bank = d->host_data;
461 struct irq_fwspec *fwspec = data;
462 struct irq_fwspec parent_fwspec;
463 struct stm32_pinctrl *pctl = dev_get_drvdata(bank->gpio_chip.parent);
464 irq_hw_number_t hwirq = fwspec->param[0];
469 * Check first that the IRQ MUX of that line is free.
470 * gpio irq mux is shared between several banks, protect with a lock
472 spin_lock_irqsave(&pctl->irqmux_lock, flags);
474 if (pctl->irqmux_map & BIT(hwirq)) {
475 dev_err(pctl->dev, "irq line %ld already requested.\n", hwirq);
478 pctl->irqmux_map |= BIT(hwirq);
481 spin_unlock_irqrestore(&pctl->irqmux_lock, flags);
485 parent_fwspec.fwnode = d->parent->fwnode;
486 parent_fwspec.param_count = 2;
487 parent_fwspec.param[0] = fwspec->param[0];
488 parent_fwspec.param[1] = fwspec->param[1];
490 irq_domain_set_hwirq_and_chip(d, virq, hwirq, &stm32_gpio_irq_chip,
493 return irq_domain_alloc_irqs_parent(d, virq, nr_irqs, &parent_fwspec);
496 static void stm32_gpio_domain_free(struct irq_domain *d, unsigned int virq,
497 unsigned int nr_irqs)
499 struct stm32_gpio_bank *bank = d->host_data;
500 struct stm32_pinctrl *pctl = dev_get_drvdata(bank->gpio_chip.parent);
501 struct irq_data *irq_data = irq_domain_get_irq_data(d, virq);
502 unsigned long flags, hwirq = irq_data->hwirq;
504 irq_domain_free_irqs_common(d, virq, nr_irqs);
506 spin_lock_irqsave(&pctl->irqmux_lock, flags);
507 pctl->irqmux_map &= ~BIT(hwirq);
508 spin_unlock_irqrestore(&pctl->irqmux_lock, flags);
511 static const struct irq_domain_ops stm32_gpio_domain_ops = {
512 .translate = stm32_gpio_domain_translate,
513 .alloc = stm32_gpio_domain_alloc,
514 .free = stm32_gpio_domain_free,
515 .activate = stm32_gpio_domain_activate,
518 /* Pinctrl functions */
519 static struct stm32_pinctrl_group *
520 stm32_pctrl_find_group_by_pin(struct stm32_pinctrl *pctl, u32 pin)
524 for (i = 0; i < pctl->ngroups; i++) {
525 struct stm32_pinctrl_group *grp = pctl->groups + i;
534 static bool stm32_pctrl_is_function_valid(struct stm32_pinctrl *pctl,
535 u32 pin_num, u32 fnum)
539 for (i = 0; i < pctl->npins; i++) {
540 const struct stm32_desc_pin *pin = pctl->pins + i;
541 const struct stm32_desc_function *func = pin->functions;
543 if (pin->pin.number != pin_num)
546 while (func && func->name) {
547 if (func->num == fnum)
555 dev_err(pctl->dev, "invalid function %d on pin %d .\n", fnum, pin_num);
560 static int stm32_pctrl_dt_node_to_map_func(struct stm32_pinctrl *pctl,
561 u32 pin, u32 fnum, struct stm32_pinctrl_group *grp,
562 struct pinctrl_map **map, unsigned *reserved_maps,
565 if (*num_maps == *reserved_maps)
568 (*map)[*num_maps].type = PIN_MAP_TYPE_MUX_GROUP;
569 (*map)[*num_maps].data.mux.group = grp->name;
571 if (!stm32_pctrl_is_function_valid(pctl, pin, fnum))
574 (*map)[*num_maps].data.mux.function = stm32_gpio_functions[fnum];
580 static int stm32_pctrl_dt_subnode_to_map(struct pinctrl_dev *pctldev,
581 struct device_node *node,
582 struct pinctrl_map **map,
583 unsigned *reserved_maps,
586 struct stm32_pinctrl *pctl;
587 struct stm32_pinctrl_group *grp;
588 struct property *pins;
589 u32 pinfunc, pin, func;
590 unsigned long *configs;
591 unsigned int num_configs;
593 unsigned reserve = 0;
594 int num_pins, num_funcs, maps_per_pin, i, err = 0;
596 pctl = pinctrl_dev_get_drvdata(pctldev);
598 pins = of_find_property(node, "pinmux", NULL);
600 dev_err(pctl->dev, "missing pins property in node %pOFn .\n",
605 err = pinconf_generic_parse_dt_config(node, pctldev, &configs,
613 num_pins = pins->length / sizeof(u32);
614 num_funcs = num_pins;
618 if (has_config && num_pins >= 1)
621 if (!num_pins || !maps_per_pin) {
626 reserve = num_pins * maps_per_pin;
628 err = pinctrl_utils_reserve_map(pctldev, map,
629 reserved_maps, num_maps, reserve);
633 for (i = 0; i < num_pins; i++) {
634 err = of_property_read_u32_index(node, "pinmux",
639 pin = STM32_GET_PIN_NO(pinfunc);
640 func = STM32_GET_PIN_FUNC(pinfunc);
642 if (!stm32_pctrl_is_function_valid(pctl, pin, func)) {
647 grp = stm32_pctrl_find_group_by_pin(pctl, pin);
649 dev_err(pctl->dev, "unable to match pin %d to group\n",
655 err = stm32_pctrl_dt_node_to_map_func(pctl, pin, func, grp, map,
656 reserved_maps, num_maps);
661 err = pinctrl_utils_add_map_configs(pctldev, map,
662 reserved_maps, num_maps, grp->name,
663 configs, num_configs,
664 PIN_MAP_TYPE_CONFIGS_GROUP);
675 static int stm32_pctrl_dt_node_to_map(struct pinctrl_dev *pctldev,
676 struct device_node *np_config,
677 struct pinctrl_map **map, unsigned *num_maps)
679 struct device_node *np;
680 unsigned reserved_maps;
687 for_each_child_of_node(np_config, np) {
688 ret = stm32_pctrl_dt_subnode_to_map(pctldev, np, map,
689 &reserved_maps, num_maps);
691 pinctrl_utils_free_map(pctldev, *map, *num_maps);
700 static int stm32_pctrl_get_groups_count(struct pinctrl_dev *pctldev)
702 struct stm32_pinctrl *pctl = pinctrl_dev_get_drvdata(pctldev);
704 return pctl->ngroups;
707 static const char *stm32_pctrl_get_group_name(struct pinctrl_dev *pctldev,
710 struct stm32_pinctrl *pctl = pinctrl_dev_get_drvdata(pctldev);
712 return pctl->groups[group].name;
715 static int stm32_pctrl_get_group_pins(struct pinctrl_dev *pctldev,
717 const unsigned **pins,
720 struct stm32_pinctrl *pctl = pinctrl_dev_get_drvdata(pctldev);
722 *pins = (unsigned *)&pctl->groups[group].pin;
728 static const struct pinctrl_ops stm32_pctrl_ops = {
729 .dt_node_to_map = stm32_pctrl_dt_node_to_map,
730 .dt_free_map = pinctrl_utils_free_map,
731 .get_groups_count = stm32_pctrl_get_groups_count,
732 .get_group_name = stm32_pctrl_get_group_name,
733 .get_group_pins = stm32_pctrl_get_group_pins,
737 /* Pinmux functions */
739 static int stm32_pmx_get_funcs_cnt(struct pinctrl_dev *pctldev)
741 return ARRAY_SIZE(stm32_gpio_functions);
744 static const char *stm32_pmx_get_func_name(struct pinctrl_dev *pctldev,
747 return stm32_gpio_functions[selector];
750 static int stm32_pmx_get_func_groups(struct pinctrl_dev *pctldev,
752 const char * const **groups,
753 unsigned * const num_groups)
755 struct stm32_pinctrl *pctl = pinctrl_dev_get_drvdata(pctldev);
757 *groups = pctl->grp_names;
758 *num_groups = pctl->ngroups;
763 static int stm32_pmx_set_mode(struct stm32_gpio_bank *bank,
764 int pin, u32 mode, u32 alt)
766 struct stm32_pinctrl *pctl = dev_get_drvdata(bank->gpio_chip.parent);
768 int alt_shift = (pin % 8) * 4;
769 int alt_offset = STM32_GPIO_AFRL + (pin / 8) * 4;
773 clk_enable(bank->clk);
774 spin_lock_irqsave(&bank->lock, flags);
777 err = hwspin_lock_timeout_in_atomic(pctl->hwlock,
780 dev_err(pctl->dev, "Can't get hwspinlock\n");
785 val = readl_relaxed(bank->base + alt_offset);
786 val &= ~GENMASK(alt_shift + 3, alt_shift);
787 val |= (alt << alt_shift);
788 writel_relaxed(val, bank->base + alt_offset);
790 val = readl_relaxed(bank->base + STM32_GPIO_MODER);
791 val &= ~GENMASK(pin * 2 + 1, pin * 2);
792 val |= mode << (pin * 2);
793 writel_relaxed(val, bank->base + STM32_GPIO_MODER);
796 hwspin_unlock_in_atomic(pctl->hwlock);
798 stm32_gpio_backup_mode(bank, pin, mode, alt);
801 spin_unlock_irqrestore(&bank->lock, flags);
802 clk_disable(bank->clk);
807 void stm32_pmx_get_mode(struct stm32_gpio_bank *bank, int pin, u32 *mode,
811 int alt_shift = (pin % 8) * 4;
812 int alt_offset = STM32_GPIO_AFRL + (pin / 8) * 4;
815 clk_enable(bank->clk);
816 spin_lock_irqsave(&bank->lock, flags);
818 val = readl_relaxed(bank->base + alt_offset);
819 val &= GENMASK(alt_shift + 3, alt_shift);
820 *alt = val >> alt_shift;
822 val = readl_relaxed(bank->base + STM32_GPIO_MODER);
823 val &= GENMASK(pin * 2 + 1, pin * 2);
824 *mode = val >> (pin * 2);
826 spin_unlock_irqrestore(&bank->lock, flags);
827 clk_disable(bank->clk);
830 static int stm32_pmx_set_mux(struct pinctrl_dev *pctldev,
835 struct stm32_pinctrl *pctl = pinctrl_dev_get_drvdata(pctldev);
836 struct stm32_pinctrl_group *g = pctl->groups + group;
837 struct pinctrl_gpio_range *range;
838 struct stm32_gpio_bank *bank;
842 ret = stm32_pctrl_is_function_valid(pctl, g->pin, function);
846 range = pinctrl_find_gpio_range_from_pin(pctldev, g->pin);
848 dev_err(pctl->dev, "No gpio range defined.\n");
852 bank = gpiochip_get_data(range->gc);
853 pin = stm32_gpio_pin(g->pin);
855 mode = stm32_gpio_get_mode(function);
856 alt = stm32_gpio_get_alt(function);
858 return stm32_pmx_set_mode(bank, pin, mode, alt);
861 static int stm32_pmx_gpio_set_direction(struct pinctrl_dev *pctldev,
862 struct pinctrl_gpio_range *range, unsigned gpio,
865 struct stm32_gpio_bank *bank = gpiochip_get_data(range->gc);
866 int pin = stm32_gpio_pin(gpio);
868 return stm32_pmx_set_mode(bank, pin, !input, 0);
871 static const struct pinmux_ops stm32_pmx_ops = {
872 .get_functions_count = stm32_pmx_get_funcs_cnt,
873 .get_function_name = stm32_pmx_get_func_name,
874 .get_function_groups = stm32_pmx_get_func_groups,
875 .set_mux = stm32_pmx_set_mux,
876 .gpio_set_direction = stm32_pmx_gpio_set_direction,
880 /* Pinconf functions */
882 static int stm32_pconf_set_driving(struct stm32_gpio_bank *bank,
883 unsigned offset, u32 drive)
885 struct stm32_pinctrl *pctl = dev_get_drvdata(bank->gpio_chip.parent);
890 clk_enable(bank->clk);
891 spin_lock_irqsave(&bank->lock, flags);
894 err = hwspin_lock_timeout_in_atomic(pctl->hwlock,
897 dev_err(pctl->dev, "Can't get hwspinlock\n");
902 val = readl_relaxed(bank->base + STM32_GPIO_TYPER);
904 val |= drive << offset;
905 writel_relaxed(val, bank->base + STM32_GPIO_TYPER);
908 hwspin_unlock_in_atomic(pctl->hwlock);
910 stm32_gpio_backup_driving(bank, offset, drive);
913 spin_unlock_irqrestore(&bank->lock, flags);
914 clk_disable(bank->clk);
919 static u32 stm32_pconf_get_driving(struct stm32_gpio_bank *bank,
925 clk_enable(bank->clk);
926 spin_lock_irqsave(&bank->lock, flags);
928 val = readl_relaxed(bank->base + STM32_GPIO_TYPER);
931 spin_unlock_irqrestore(&bank->lock, flags);
932 clk_disable(bank->clk);
934 return (val >> offset);
937 static int stm32_pconf_set_speed(struct stm32_gpio_bank *bank,
938 unsigned offset, u32 speed)
940 struct stm32_pinctrl *pctl = dev_get_drvdata(bank->gpio_chip.parent);
945 clk_enable(bank->clk);
946 spin_lock_irqsave(&bank->lock, flags);
949 err = hwspin_lock_timeout_in_atomic(pctl->hwlock,
952 dev_err(pctl->dev, "Can't get hwspinlock\n");
957 val = readl_relaxed(bank->base + STM32_GPIO_SPEEDR);
958 val &= ~GENMASK(offset * 2 + 1, offset * 2);
959 val |= speed << (offset * 2);
960 writel_relaxed(val, bank->base + STM32_GPIO_SPEEDR);
963 hwspin_unlock_in_atomic(pctl->hwlock);
965 stm32_gpio_backup_speed(bank, offset, speed);
968 spin_unlock_irqrestore(&bank->lock, flags);
969 clk_disable(bank->clk);
974 static u32 stm32_pconf_get_speed(struct stm32_gpio_bank *bank,
980 clk_enable(bank->clk);
981 spin_lock_irqsave(&bank->lock, flags);
983 val = readl_relaxed(bank->base + STM32_GPIO_SPEEDR);
984 val &= GENMASK(offset * 2 + 1, offset * 2);
986 spin_unlock_irqrestore(&bank->lock, flags);
987 clk_disable(bank->clk);
989 return (val >> (offset * 2));
992 static int stm32_pconf_set_bias(struct stm32_gpio_bank *bank,
993 unsigned offset, u32 bias)
995 struct stm32_pinctrl *pctl = dev_get_drvdata(bank->gpio_chip.parent);
1000 clk_enable(bank->clk);
1001 spin_lock_irqsave(&bank->lock, flags);
1004 err = hwspin_lock_timeout_in_atomic(pctl->hwlock,
1007 dev_err(pctl->dev, "Can't get hwspinlock\n");
1012 val = readl_relaxed(bank->base + STM32_GPIO_PUPDR);
1013 val &= ~GENMASK(offset * 2 + 1, offset * 2);
1014 val |= bias << (offset * 2);
1015 writel_relaxed(val, bank->base + STM32_GPIO_PUPDR);
1018 hwspin_unlock_in_atomic(pctl->hwlock);
1020 stm32_gpio_backup_bias(bank, offset, bias);
1023 spin_unlock_irqrestore(&bank->lock, flags);
1024 clk_disable(bank->clk);
1029 static u32 stm32_pconf_get_bias(struct stm32_gpio_bank *bank,
1030 unsigned int offset)
1032 unsigned long flags;
1035 clk_enable(bank->clk);
1036 spin_lock_irqsave(&bank->lock, flags);
1038 val = readl_relaxed(bank->base + STM32_GPIO_PUPDR);
1039 val &= GENMASK(offset * 2 + 1, offset * 2);
1041 spin_unlock_irqrestore(&bank->lock, flags);
1042 clk_disable(bank->clk);
1044 return (val >> (offset * 2));
1047 static bool stm32_pconf_get(struct stm32_gpio_bank *bank,
1048 unsigned int offset, bool dir)
1050 unsigned long flags;
1053 clk_enable(bank->clk);
1054 spin_lock_irqsave(&bank->lock, flags);
1057 val = !!(readl_relaxed(bank->base + STM32_GPIO_IDR) &
1060 val = !!(readl_relaxed(bank->base + STM32_GPIO_ODR) &
1063 spin_unlock_irqrestore(&bank->lock, flags);
1064 clk_disable(bank->clk);
1069 static int stm32_pconf_parse_conf(struct pinctrl_dev *pctldev,
1070 unsigned int pin, enum pin_config_param param,
1071 enum pin_config_param arg)
1073 struct stm32_pinctrl *pctl = pinctrl_dev_get_drvdata(pctldev);
1074 struct pinctrl_gpio_range *range;
1075 struct stm32_gpio_bank *bank;
1076 int offset, ret = 0;
1078 range = pinctrl_find_gpio_range_from_pin_nolock(pctldev, pin);
1080 dev_err(pctl->dev, "No gpio range defined.\n");
1084 bank = gpiochip_get_data(range->gc);
1085 offset = stm32_gpio_pin(pin);
1088 case PIN_CONFIG_DRIVE_PUSH_PULL:
1089 ret = stm32_pconf_set_driving(bank, offset, 0);
1091 case PIN_CONFIG_DRIVE_OPEN_DRAIN:
1092 ret = stm32_pconf_set_driving(bank, offset, 1);
1094 case PIN_CONFIG_SLEW_RATE:
1095 ret = stm32_pconf_set_speed(bank, offset, arg);
1097 case PIN_CONFIG_BIAS_DISABLE:
1098 ret = stm32_pconf_set_bias(bank, offset, 0);
1100 case PIN_CONFIG_BIAS_PULL_UP:
1101 ret = stm32_pconf_set_bias(bank, offset, 1);
1103 case PIN_CONFIG_BIAS_PULL_DOWN:
1104 ret = stm32_pconf_set_bias(bank, offset, 2);
1106 case PIN_CONFIG_OUTPUT:
1107 __stm32_gpio_set(bank, offset, arg);
1108 ret = stm32_pmx_gpio_set_direction(pctldev, range, pin, false);
1117 static int stm32_pconf_group_get(struct pinctrl_dev *pctldev,
1119 unsigned long *config)
1121 struct stm32_pinctrl *pctl = pinctrl_dev_get_drvdata(pctldev);
1123 *config = pctl->groups[group].config;
1128 static int stm32_pconf_group_set(struct pinctrl_dev *pctldev, unsigned group,
1129 unsigned long *configs, unsigned num_configs)
1131 struct stm32_pinctrl *pctl = pinctrl_dev_get_drvdata(pctldev);
1132 struct stm32_pinctrl_group *g = &pctl->groups[group];
1135 for (i = 0; i < num_configs; i++) {
1136 mutex_lock(&pctldev->mutex);
1137 ret = stm32_pconf_parse_conf(pctldev, g->pin,
1138 pinconf_to_config_param(configs[i]),
1139 pinconf_to_config_argument(configs[i]));
1140 mutex_unlock(&pctldev->mutex);
1144 g->config = configs[i];
1150 static int stm32_pconf_set(struct pinctrl_dev *pctldev, unsigned int pin,
1151 unsigned long *configs, unsigned int num_configs)
1155 for (i = 0; i < num_configs; i++) {
1156 ret = stm32_pconf_parse_conf(pctldev, pin,
1157 pinconf_to_config_param(configs[i]),
1158 pinconf_to_config_argument(configs[i]));
1166 static void stm32_pconf_dbg_show(struct pinctrl_dev *pctldev,
1170 struct pinctrl_gpio_range *range;
1171 struct stm32_gpio_bank *bank;
1173 u32 mode, alt, drive, speed, bias;
1174 static const char * const modes[] = {
1175 "input", "output", "alternate", "analog" };
1176 static const char * const speeds[] = {
1177 "low", "medium", "high", "very high" };
1178 static const char * const biasing[] = {
1179 "floating", "pull up", "pull down", "" };
1182 range = pinctrl_find_gpio_range_from_pin_nolock(pctldev, pin);
1186 bank = gpiochip_get_data(range->gc);
1187 offset = stm32_gpio_pin(pin);
1189 stm32_pmx_get_mode(bank, offset, &mode, &alt);
1190 bias = stm32_pconf_get_bias(bank, offset);
1192 seq_printf(s, "%s ", modes[mode]);
1197 val = stm32_pconf_get(bank, offset, true);
1198 seq_printf(s, "- %s - %s",
1199 val ? "high" : "low",
1205 drive = stm32_pconf_get_driving(bank, offset);
1206 speed = stm32_pconf_get_speed(bank, offset);
1207 val = stm32_pconf_get(bank, offset, false);
1208 seq_printf(s, "- %s - %s - %s - %s %s",
1209 val ? "high" : "low",
1210 drive ? "open drain" : "push pull",
1212 speeds[speed], "speed");
1217 drive = stm32_pconf_get_driving(bank, offset);
1218 speed = stm32_pconf_get_speed(bank, offset);
1219 seq_printf(s, "%d - %s - %s - %s %s", alt,
1220 drive ? "open drain" : "push pull",
1222 speeds[speed], "speed");
1231 static const struct pinconf_ops stm32_pconf_ops = {
1232 .pin_config_group_get = stm32_pconf_group_get,
1233 .pin_config_group_set = stm32_pconf_group_set,
1234 .pin_config_set = stm32_pconf_set,
1235 .pin_config_dbg_show = stm32_pconf_dbg_show,
1238 static int stm32_gpiolib_register_bank(struct stm32_pinctrl *pctl, struct fwnode_handle *fwnode)
1240 struct stm32_gpio_bank *bank = &pctl->banks[pctl->nbanks];
1242 struct pinctrl_gpio_range *range = &bank->range;
1243 struct fwnode_reference_args args;
1244 struct device *dev = pctl->dev;
1245 struct resource res;
1246 int npins = STM32_GPIO_PINS_PER_BANK;
1247 int bank_nr, err, i = 0;
1249 if (!IS_ERR(bank->rstc))
1250 reset_control_deassert(bank->rstc);
1252 if (of_address_to_resource(to_of_node(fwnode), 0, &res))
1255 bank->base = devm_ioremap_resource(dev, &res);
1256 if (IS_ERR(bank->base))
1257 return PTR_ERR(bank->base);
1259 err = clk_prepare(bank->clk);
1261 dev_err(dev, "failed to prepare clk (%d)\n", err);
1265 bank->gpio_chip = stm32_gpio_template;
1267 fwnode_property_read_string(fwnode, "st,bank-name", &bank->gpio_chip.label);
1269 if (!fwnode_property_get_reference_args(fwnode, "gpio-ranges", NULL, 3, i, &args)) {
1270 bank_nr = args.args[1] / STM32_GPIO_PINS_PER_BANK;
1271 bank->gpio_chip.base = args.args[1];
1273 /* get the last defined gpio line (offset + nb of pins) */
1274 npins = args.args[0] + args.args[2];
1275 while (!fwnode_property_get_reference_args(fwnode, "gpio-ranges", NULL, 3, ++i, &args))
1276 npins = max(npins, (int)(args.args[0] + args.args[2]));
1278 bank_nr = pctl->nbanks;
1279 bank->gpio_chip.base = bank_nr * STM32_GPIO_PINS_PER_BANK;
1280 range->name = bank->gpio_chip.label;
1281 range->id = bank_nr;
1282 range->pin_base = range->id * STM32_GPIO_PINS_PER_BANK;
1283 range->base = range->id * STM32_GPIO_PINS_PER_BANK;
1284 range->npins = npins;
1285 range->gc = &bank->gpio_chip;
1286 pinctrl_add_gpio_range(pctl->pctl_dev,
1287 &pctl->banks[bank_nr].range);
1290 if (fwnode_property_read_u32(fwnode, "st,bank-ioport", &bank_ioport_nr))
1291 bank_ioport_nr = bank_nr;
1293 bank->gpio_chip.base = bank_nr * STM32_GPIO_PINS_PER_BANK;
1295 bank->gpio_chip.ngpio = npins;
1296 bank->gpio_chip.fwnode = fwnode;
1297 bank->gpio_chip.parent = dev;
1298 bank->bank_nr = bank_nr;
1299 bank->bank_ioport_nr = bank_ioport_nr;
1300 spin_lock_init(&bank->lock);
1302 /* create irq hierarchical domain */
1303 bank->fwnode = fwnode;
1305 bank->domain = irq_domain_create_hierarchy(pctl->domain, 0,
1306 STM32_GPIO_IRQ_LINE, bank->fwnode,
1307 &stm32_gpio_domain_ops, bank);
1312 err = gpiochip_add_data(&bank->gpio_chip, bank);
1314 dev_err(dev, "Failed to add gpiochip(%d)!\n", bank_nr);
1318 dev_info(dev, "%s bank added\n", bank->gpio_chip.label);
1322 static struct irq_domain *stm32_pctrl_get_irq_domain(struct device_node *np)
1324 struct device_node *parent;
1325 struct irq_domain *domain;
1327 if (!of_find_property(np, "interrupt-parent", NULL))
1330 parent = of_irq_find_parent(np);
1332 return ERR_PTR(-ENXIO);
1334 domain = irq_find_host(parent);
1336 /* domain not registered yet */
1337 return ERR_PTR(-EPROBE_DEFER);
1342 static int stm32_pctrl_dt_setup_irq(struct platform_device *pdev,
1343 struct stm32_pinctrl *pctl)
1345 struct device_node *np = pdev->dev.of_node;
1346 struct device *dev = &pdev->dev;
1349 int mask, mask_width;
1351 pctl->regmap = syscon_regmap_lookup_by_phandle(np, "st,syscfg");
1352 if (IS_ERR(pctl->regmap))
1353 return PTR_ERR(pctl->regmap);
1357 ret = of_property_read_u32_index(np, "st,syscfg", 1, &offset);
1361 ret = of_property_read_u32_index(np, "st,syscfg", 2, &mask);
1363 mask = SYSCFG_IRQMUX_MASK;
1365 mask_width = fls(mask);
1367 for (i = 0; i < STM32_GPIO_PINS_PER_BANK; i++) {
1368 struct reg_field mux;
1370 mux.reg = offset + (i / 4) * 4;
1371 mux.lsb = (i % 4) * mask_width;
1372 mux.msb = mux.lsb + mask_width - 1;
1374 dev_dbg(dev, "irqmux%d: reg:%#x, lsb:%d, msb:%d\n",
1375 i, mux.reg, mux.lsb, mux.msb);
1377 pctl->irqmux[i] = devm_regmap_field_alloc(dev, rm, mux);
1378 if (IS_ERR(pctl->irqmux[i]))
1379 return PTR_ERR(pctl->irqmux[i]);
1385 static int stm32_pctrl_build_state(struct platform_device *pdev)
1387 struct stm32_pinctrl *pctl = platform_get_drvdata(pdev);
1390 pctl->ngroups = pctl->npins;
1392 /* Allocate groups */
1393 pctl->groups = devm_kcalloc(&pdev->dev, pctl->ngroups,
1394 sizeof(*pctl->groups), GFP_KERNEL);
1398 /* We assume that one pin is one group, use pin name as group name. */
1399 pctl->grp_names = devm_kcalloc(&pdev->dev, pctl->ngroups,
1400 sizeof(*pctl->grp_names), GFP_KERNEL);
1401 if (!pctl->grp_names)
1404 for (i = 0; i < pctl->npins; i++) {
1405 const struct stm32_desc_pin *pin = pctl->pins + i;
1406 struct stm32_pinctrl_group *group = pctl->groups + i;
1408 group->name = pin->pin.name;
1409 group->pin = pin->pin.number;
1410 pctl->grp_names[i] = pin->pin.name;
1416 static int stm32_pctrl_create_pins_tab(struct stm32_pinctrl *pctl,
1417 struct stm32_desc_pin *pins)
1419 const struct stm32_desc_pin *p;
1420 int i, nb_pins_available = 0;
1422 for (i = 0; i < pctl->match_data->npins; i++) {
1423 p = pctl->match_data->pins + i;
1424 if (pctl->pkg && !(pctl->pkg & p->pkg))
1427 pins->functions = p->functions;
1429 nb_pins_available++;
1432 pctl->npins = nb_pins_available;
1437 int stm32_pctl_probe(struct platform_device *pdev)
1439 struct device_node *np = pdev->dev.of_node;
1440 struct fwnode_handle *child;
1441 const struct of_device_id *match;
1442 struct device *dev = &pdev->dev;
1443 struct stm32_pinctrl *pctl;
1444 struct pinctrl_pin_desc *pins;
1445 int i, ret, hwlock_id;
1451 match = of_match_device(dev->driver->of_match_table, dev);
1452 if (!match || !match->data)
1455 if (!of_find_property(np, "pins-are-numbered", NULL)) {
1456 dev_err(dev, "only support pins-are-numbered format\n");
1460 pctl = devm_kzalloc(dev, sizeof(*pctl), GFP_KERNEL);
1464 platform_set_drvdata(pdev, pctl);
1466 /* check for IRQ controller (may require deferred probe) */
1467 pctl->domain = stm32_pctrl_get_irq_domain(np);
1468 if (IS_ERR(pctl->domain))
1469 return PTR_ERR(pctl->domain);
1471 /* hwspinlock is optional */
1472 hwlock_id = of_hwspin_lock_get_id(pdev->dev.of_node, 0);
1473 if (hwlock_id < 0) {
1474 if (hwlock_id == -EPROBE_DEFER)
1477 pctl->hwlock = hwspin_lock_request_specific(hwlock_id);
1480 spin_lock_init(&pctl->irqmux_lock);
1483 pctl->match_data = match->data;
1485 /* get optional package information */
1486 if (!of_property_read_u32(np, "st,package", &pctl->pkg))
1487 dev_dbg(pctl->dev, "package detected: %x\n", pctl->pkg);
1489 pctl->pins = devm_kcalloc(pctl->dev, pctl->match_data->npins,
1490 sizeof(*pctl->pins), GFP_KERNEL);
1494 ret = stm32_pctrl_create_pins_tab(pctl, pctl->pins);
1498 ret = stm32_pctrl_build_state(pdev);
1500 dev_err(dev, "build state failed: %d\n", ret);
1505 ret = stm32_pctrl_dt_setup_irq(pdev, pctl);
1510 pins = devm_kcalloc(&pdev->dev, pctl->npins, sizeof(*pins),
1515 for (i = 0; i < pctl->npins; i++)
1516 pins[i] = pctl->pins[i].pin;
1518 pctl->pctl_desc.name = dev_name(&pdev->dev);
1519 pctl->pctl_desc.owner = THIS_MODULE;
1520 pctl->pctl_desc.pins = pins;
1521 pctl->pctl_desc.npins = pctl->npins;
1522 pctl->pctl_desc.link_consumers = true;
1523 pctl->pctl_desc.confops = &stm32_pconf_ops;
1524 pctl->pctl_desc.pctlops = &stm32_pctrl_ops;
1525 pctl->pctl_desc.pmxops = &stm32_pmx_ops;
1526 pctl->dev = &pdev->dev;
1528 pctl->pctl_dev = devm_pinctrl_register(&pdev->dev, &pctl->pctl_desc,
1531 if (IS_ERR(pctl->pctl_dev)) {
1532 dev_err(&pdev->dev, "Failed pinctrl registration\n");
1533 return PTR_ERR(pctl->pctl_dev);
1536 banks = gpiochip_node_count(dev);
1538 dev_err(dev, "at least one GPIO bank is required\n");
1541 pctl->banks = devm_kcalloc(dev, banks, sizeof(*pctl->banks),
1547 for_each_gpiochip_node(dev, child) {
1548 struct stm32_gpio_bank *bank = &pctl->banks[i];
1549 struct device_node *np = to_of_node(child);
1551 bank->rstc = of_reset_control_get_exclusive(np, NULL);
1552 if (PTR_ERR(bank->rstc) == -EPROBE_DEFER) {
1553 fwnode_handle_put(child);
1554 return -EPROBE_DEFER;
1557 bank->clk = of_clk_get_by_name(np, NULL);
1558 if (IS_ERR(bank->clk)) {
1559 if (PTR_ERR(bank->clk) != -EPROBE_DEFER)
1560 dev_err(dev, "failed to get clk (%ld)\n", PTR_ERR(bank->clk));
1561 fwnode_handle_put(child);
1562 return PTR_ERR(bank->clk);
1567 for_each_gpiochip_node(dev, child) {
1568 ret = stm32_gpiolib_register_bank(pctl, child);
1570 fwnode_handle_put(child);
1577 dev_info(dev, "Pinctrl STM32 initialized\n");
1582 static int __maybe_unused stm32_pinctrl_restore_gpio_regs(
1583 struct stm32_pinctrl *pctl, u32 pin)
1585 const struct pin_desc *desc = pin_desc_get(pctl->pctl_dev, pin);
1586 u32 val, alt, mode, offset = stm32_gpio_pin(pin);
1587 struct pinctrl_gpio_range *range;
1588 struct stm32_gpio_bank *bank;
1592 range = pinctrl_find_gpio_range_from_pin(pctl->pctl_dev, pin);
1596 pin_is_irq = gpiochip_line_is_irq(range->gc, offset);
1598 if (!desc || (!pin_is_irq && !desc->gpio_owner))
1601 bank = gpiochip_get_data(range->gc);
1603 alt = bank->pin_backup[offset] & STM32_GPIO_BKP_ALT_MASK;
1604 alt >>= STM32_GPIO_BKP_ALT_SHIFT;
1605 mode = bank->pin_backup[offset] & STM32_GPIO_BKP_MODE_MASK;
1606 mode >>= STM32_GPIO_BKP_MODE_SHIFT;
1608 ret = stm32_pmx_set_mode(bank, offset, mode, alt);
1613 val = bank->pin_backup[offset] & BIT(STM32_GPIO_BKP_VAL);
1614 val = val >> STM32_GPIO_BKP_VAL;
1615 __stm32_gpio_set(bank, offset, val);
1618 val = bank->pin_backup[offset] & BIT(STM32_GPIO_BKP_TYPE);
1619 val >>= STM32_GPIO_BKP_TYPE;
1620 ret = stm32_pconf_set_driving(bank, offset, val);
1624 val = bank->pin_backup[offset] & STM32_GPIO_BKP_SPEED_MASK;
1625 val >>= STM32_GPIO_BKP_SPEED_SHIFT;
1626 ret = stm32_pconf_set_speed(bank, offset, val);
1630 val = bank->pin_backup[offset] & STM32_GPIO_BKP_PUPD_MASK;
1631 val >>= STM32_GPIO_BKP_PUPD_SHIFT;
1632 ret = stm32_pconf_set_bias(bank, offset, val);
1637 regmap_field_write(pctl->irqmux[offset], bank->bank_ioport_nr);
1642 int __maybe_unused stm32_pinctrl_resume(struct device *dev)
1644 struct stm32_pinctrl *pctl = dev_get_drvdata(dev);
1645 struct stm32_pinctrl_group *g = pctl->groups;
1648 for (i = 0; i < pctl->ngroups; i++, g++)
1649 stm32_pinctrl_restore_gpio_regs(pctl, g->pin);