2 * Generic device tree based pinctrl driver for one register per pin
3 * type pinmux controllers
5 * Copyright (C) 2012 Texas Instruments, Inc.
7 * This file is licensed under the terms of the GNU General Public
8 * License version 2. This program is licensed "as is" without any
9 * warranty of any kind, whether express or implied.
12 #include <linux/init.h>
13 #include <linux/module.h>
15 #include <linux/slab.h>
16 #include <linux/err.h>
17 #include <linux/list.h>
20 #include <linux/of_device.h>
21 #include <linux/of_address.h>
23 #include <linux/pinctrl/pinctrl.h>
24 #include <linux/pinctrl/pinmux.h>
25 #include <linux/pinctrl/pinconf-generic.h>
30 #define DRIVER_NAME "pinctrl-single"
31 #define PCS_MUX_PINS_NAME "pinctrl-single,pins"
32 #define PCS_MUX_BITS_NAME "pinctrl-single,bits"
33 #define PCS_REG_NAME_LEN ((sizeof(unsigned long) * 2) + 3)
34 #define PCS_OFF_DISABLED ~0U
37 * struct pcs_pingroup - pingroups for a function
38 * @np: pingroup device node pointer
39 * @name: pingroup name
40 * @gpins: array of the pins in the group
41 * @ngpins: number of pins in the group
45 struct device_node *np;
49 struct list_head node;
53 * struct pcs_func_vals - mux function register offset and value pair
54 * @reg: register virtual address
55 * @val: register value
57 struct pcs_func_vals {
64 * struct pcs_conf_vals - pinconf parameter, pinconf register offset
65 * and value, enable, disable, mask
66 * @param: config parameter
67 * @val: user input bits in the pinconf register
68 * @enable: enable bits in the pinconf register
69 * @disable: disable bits in the pinconf register
70 * @mask: mask bits in the register value
72 struct pcs_conf_vals {
73 enum pin_config_param param;
81 * struct pcs_conf_type - pinconf property name, pinconf param pair
82 * @name: property name in DTS file
83 * @param: config parameter
85 struct pcs_conf_type {
87 enum pin_config_param param;
91 * struct pcs_function - pinctrl function
92 * @name: pinctrl function name
93 * @vals: register and vals array
94 * @nvals: number of entries in vals array
95 * @pgnames: array of pingroup names the function uses
96 * @npgnames: number of pingroup names the function uses
101 struct pcs_func_vals *vals;
103 const char **pgnames;
105 struct pcs_conf_vals *conf;
107 struct list_head node;
111 * struct pcs_gpiofunc_range - pin ranges with same mux value of gpio function
112 * @offset: offset base of pins
113 * @npins: number pins with the same mux value of gpio function
114 * @gpiofunc: mux value of gpio function
117 struct pcs_gpiofunc_range {
121 struct list_head node;
125 * struct pcs_data - wrapper for data needed by pinctrl framework
127 * @cur: index to current element
129 * REVISIT: We should be able to drop this eventually by adding
130 * support for registering pins individually in the pinctrl
131 * framework for those drivers that don't need a static array.
134 struct pinctrl_pin_desc *pa;
139 * struct pcs_name - register name for a pin
140 * @name: name of the pinctrl register
142 * REVISIT: We may want to make names optional in the pinctrl
143 * framework as some drivers may not care about pin names to
144 * avoid kernel bloat. The pin names can be deciphered by user
145 * space tools using debugfs based on the register address and
146 * SoC packaging information.
149 char name[PCS_REG_NAME_LEN];
153 * struct pcs_device - pinctrl device instance
155 * @base: virtual address of the controller
156 * @size: size of the ioremapped area
158 * @pctl: pin controller device
159 * @mutex: mutex protecting the lists
160 * @width: bits per mux register
161 * @fmask: function register mask
162 * @fshift: function register shift
163 * @foff: value to turn mux off
164 * @fmax: max number of functions in fmask
165 * @is_pinconf: whether supports pinconf
166 * @bits_per_pin:number of bits per pin
167 * @names: array of register names for pins
168 * @pins: physical pins on the SoC
169 * @pgtree: pingroup index radix tree
170 * @ftree: function index radix tree
171 * @pingroups: list of pingroups
172 * @functions: list of functions
173 * @gpiofuncs: list of gpio functions
174 * @ngroups: number of pingroups
175 * @nfuncs: number of functions
176 * @desc: pin controller descriptor
177 * @read: register read function to use
178 * @write: register write function to use
181 struct resource *res;
185 struct pinctrl_dev *pctl;
194 unsigned bits_per_pin;
195 struct pcs_name *names;
196 struct pcs_data pins;
197 struct radix_tree_root pgtree;
198 struct radix_tree_root ftree;
199 struct list_head pingroups;
200 struct list_head functions;
201 struct list_head gpiofuncs;
204 struct pinctrl_desc desc;
205 unsigned (*read)(void __iomem *reg);
206 void (*write)(unsigned val, void __iomem *reg);
209 static int pcs_pinconf_get(struct pinctrl_dev *pctldev, unsigned pin,
210 unsigned long *config);
211 static int pcs_pinconf_set(struct pinctrl_dev *pctldev, unsigned pin,
212 unsigned long *configs, unsigned num_configs);
214 static enum pin_config_param pcs_bias[] = {
215 PIN_CONFIG_BIAS_PULL_DOWN,
216 PIN_CONFIG_BIAS_PULL_UP,
220 * REVISIT: Reads and writes could eventually use regmap or something
221 * generic. But at least on omaps, some mux registers are performance
222 * critical as they may need to be remuxed every time before and after
223 * idle. Adding tests for register access width for every read and
224 * write like regmap is doing is not desired, and caching the registers
225 * does not help in this case.
228 static unsigned __maybe_unused pcs_readb(void __iomem *reg)
233 static unsigned __maybe_unused pcs_readw(void __iomem *reg)
238 static unsigned __maybe_unused pcs_readl(void __iomem *reg)
243 static void __maybe_unused pcs_writeb(unsigned val, void __iomem *reg)
248 static void __maybe_unused pcs_writew(unsigned val, void __iomem *reg)
253 static void __maybe_unused pcs_writel(unsigned val, void __iomem *reg)
258 static int pcs_get_groups_count(struct pinctrl_dev *pctldev)
260 struct pcs_device *pcs;
262 pcs = pinctrl_dev_get_drvdata(pctldev);
267 static const char *pcs_get_group_name(struct pinctrl_dev *pctldev,
270 struct pcs_device *pcs;
271 struct pcs_pingroup *group;
273 pcs = pinctrl_dev_get_drvdata(pctldev);
274 group = radix_tree_lookup(&pcs->pgtree, gselector);
276 dev_err(pcs->dev, "%s could not find pingroup%i\n",
277 __func__, gselector);
284 static int pcs_get_group_pins(struct pinctrl_dev *pctldev,
286 const unsigned **pins,
289 struct pcs_device *pcs;
290 struct pcs_pingroup *group;
292 pcs = pinctrl_dev_get_drvdata(pctldev);
293 group = radix_tree_lookup(&pcs->pgtree, gselector);
295 dev_err(pcs->dev, "%s could not find pingroup%i\n",
296 __func__, gselector);
300 *pins = group->gpins;
301 *npins = group->ngpins;
306 static void pcs_pin_dbg_show(struct pinctrl_dev *pctldev,
310 struct pcs_device *pcs;
311 unsigned val, mux_bytes;
313 pcs = pinctrl_dev_get_drvdata(pctldev);
315 mux_bytes = pcs->width / BITS_PER_BYTE;
316 val = pcs->read(pcs->base + pin * mux_bytes);
318 seq_printf(s, "%08x %s " , val, DRIVER_NAME);
321 static void pcs_dt_free_map(struct pinctrl_dev *pctldev,
322 struct pinctrl_map *map, unsigned num_maps)
324 struct pcs_device *pcs;
326 pcs = pinctrl_dev_get_drvdata(pctldev);
327 devm_kfree(pcs->dev, map);
330 static int pcs_dt_node_to_map(struct pinctrl_dev *pctldev,
331 struct device_node *np_config,
332 struct pinctrl_map **map, unsigned *num_maps);
334 static const struct pinctrl_ops pcs_pinctrl_ops = {
335 .get_groups_count = pcs_get_groups_count,
336 .get_group_name = pcs_get_group_name,
337 .get_group_pins = pcs_get_group_pins,
338 .pin_dbg_show = pcs_pin_dbg_show,
339 .dt_node_to_map = pcs_dt_node_to_map,
340 .dt_free_map = pcs_dt_free_map,
343 static int pcs_get_functions_count(struct pinctrl_dev *pctldev)
345 struct pcs_device *pcs;
347 pcs = pinctrl_dev_get_drvdata(pctldev);
352 static const char *pcs_get_function_name(struct pinctrl_dev *pctldev,
355 struct pcs_device *pcs;
356 struct pcs_function *func;
358 pcs = pinctrl_dev_get_drvdata(pctldev);
359 func = radix_tree_lookup(&pcs->ftree, fselector);
361 dev_err(pcs->dev, "%s could not find function%i\n",
362 __func__, fselector);
369 static int pcs_get_function_groups(struct pinctrl_dev *pctldev,
371 const char * const **groups,
372 unsigned * const ngroups)
374 struct pcs_device *pcs;
375 struct pcs_function *func;
377 pcs = pinctrl_dev_get_drvdata(pctldev);
378 func = radix_tree_lookup(&pcs->ftree, fselector);
380 dev_err(pcs->dev, "%s could not find function%i\n",
381 __func__, fselector);
384 *groups = func->pgnames;
385 *ngroups = func->npgnames;
390 static int pcs_get_function(struct pinctrl_dev *pctldev, unsigned pin,
391 struct pcs_function **func)
393 struct pcs_device *pcs = pinctrl_dev_get_drvdata(pctldev);
394 struct pin_desc *pdesc = pin_desc_get(pctldev, pin);
395 const struct pinctrl_setting_mux *setting;
398 /* If pin is not described in DTS & enabled, mux_setting is NULL. */
399 setting = pdesc->mux_setting;
402 fselector = setting->func;
403 *func = radix_tree_lookup(&pcs->ftree, fselector);
405 dev_err(pcs->dev, "%s could not find function%i\n",
406 __func__, fselector);
412 static int pcs_enable(struct pinctrl_dev *pctldev, unsigned fselector,
415 struct pcs_device *pcs;
416 struct pcs_function *func;
419 pcs = pinctrl_dev_get_drvdata(pctldev);
420 /* If function mask is null, needn't enable it. */
423 func = radix_tree_lookup(&pcs->ftree, fselector);
427 dev_dbg(pcs->dev, "enabling %s function%i\n",
428 func->name, fselector);
430 for (i = 0; i < func->nvals; i++) {
431 struct pcs_func_vals *vals;
434 vals = &func->vals[i];
435 val = pcs->read(vals->reg);
437 if (pcs->bits_per_mux)
443 val |= (vals->val & mask);
444 pcs->write(val, vals->reg);
450 static void pcs_disable(struct pinctrl_dev *pctldev, unsigned fselector,
453 struct pcs_device *pcs;
454 struct pcs_function *func;
457 pcs = pinctrl_dev_get_drvdata(pctldev);
458 /* If function mask is null, needn't disable it. */
462 func = radix_tree_lookup(&pcs->ftree, fselector);
464 dev_err(pcs->dev, "%s could not find function%i\n",
465 __func__, fselector);
470 * Ignore disable if function-off is not specified. Some hardware
471 * does not have clearly defined disable function. For pin specific
472 * off modes, you can use alternate named states as described in
473 * pinctrl-bindings.txt.
475 if (pcs->foff == PCS_OFF_DISABLED) {
476 dev_dbg(pcs->dev, "ignoring disable for %s function%i\n",
477 func->name, fselector);
481 dev_dbg(pcs->dev, "disabling function%i %s\n",
482 fselector, func->name);
484 for (i = 0; i < func->nvals; i++) {
485 struct pcs_func_vals *vals;
488 vals = &func->vals[i];
489 val = pcs->read(vals->reg);
491 val |= pcs->foff << pcs->fshift;
492 pcs->write(val, vals->reg);
496 static int pcs_request_gpio(struct pinctrl_dev *pctldev,
497 struct pinctrl_gpio_range *range, unsigned pin)
499 struct pcs_device *pcs = pinctrl_dev_get_drvdata(pctldev);
500 struct pcs_gpiofunc_range *frange = NULL;
501 struct list_head *pos, *tmp;
505 /* If function mask is null, return directly. */
509 list_for_each_safe(pos, tmp, &pcs->gpiofuncs) {
510 frange = list_entry(pos, struct pcs_gpiofunc_range, node);
511 if (pin >= frange->offset + frange->npins
512 || pin < frange->offset)
514 mux_bytes = pcs->width / BITS_PER_BYTE;
515 data = pcs->read(pcs->base + pin * mux_bytes) & ~pcs->fmask;
516 data |= frange->gpiofunc;
517 pcs->write(data, pcs->base + pin * mux_bytes);
523 static const struct pinmux_ops pcs_pinmux_ops = {
524 .get_functions_count = pcs_get_functions_count,
525 .get_function_name = pcs_get_function_name,
526 .get_function_groups = pcs_get_function_groups,
527 .enable = pcs_enable,
528 .disable = pcs_disable,
529 .gpio_request_enable = pcs_request_gpio,
532 /* Clear BIAS value */
533 static void pcs_pinconf_clear_bias(struct pinctrl_dev *pctldev, unsigned pin)
535 unsigned long config;
537 for (i = 0; i < ARRAY_SIZE(pcs_bias); i++) {
538 config = pinconf_to_config_packed(pcs_bias[i], 0);
539 pcs_pinconf_set(pctldev, pin, &config, 1);
544 * Check whether PIN_CONFIG_BIAS_DISABLE is valid.
545 * It's depend on that PULL_DOWN & PULL_UP configs are all invalid.
547 static bool pcs_pinconf_bias_disable(struct pinctrl_dev *pctldev, unsigned pin)
549 unsigned long config;
552 for (i = 0; i < ARRAY_SIZE(pcs_bias); i++) {
553 config = pinconf_to_config_packed(pcs_bias[i], 0);
554 if (!pcs_pinconf_get(pctldev, pin, &config))
562 static int pcs_pinconf_get(struct pinctrl_dev *pctldev,
563 unsigned pin, unsigned long *config)
565 struct pcs_device *pcs = pinctrl_dev_get_drvdata(pctldev);
566 struct pcs_function *func;
567 enum pin_config_param param;
568 unsigned offset = 0, data = 0, i, j, ret;
570 ret = pcs_get_function(pctldev, pin, &func);
574 for (i = 0; i < func->nconfs; i++) {
575 param = pinconf_to_config_param(*config);
576 if (param == PIN_CONFIG_BIAS_DISABLE) {
577 if (pcs_pinconf_bias_disable(pctldev, pin)) {
583 } else if (param != func->conf[i].param) {
587 offset = pin * (pcs->width / BITS_PER_BYTE);
588 data = pcs->read(pcs->base + offset) & func->conf[i].mask;
589 switch (func->conf[i].param) {
591 case PIN_CONFIG_BIAS_PULL_DOWN:
592 case PIN_CONFIG_BIAS_PULL_UP:
593 case PIN_CONFIG_INPUT_SCHMITT_ENABLE:
594 if ((data != func->conf[i].enable) ||
595 (data == func->conf[i].disable))
600 case PIN_CONFIG_INPUT_SCHMITT:
601 for (j = 0; j < func->nconfs; j++) {
602 switch (func->conf[j].param) {
603 case PIN_CONFIG_INPUT_SCHMITT_ENABLE:
604 if (data != func->conf[j].enable)
613 case PIN_CONFIG_DRIVE_STRENGTH:
614 case PIN_CONFIG_SLEW_RATE:
624 static int pcs_pinconf_set(struct pinctrl_dev *pctldev,
625 unsigned pin, unsigned long *configs,
626 unsigned num_configs)
628 struct pcs_device *pcs = pinctrl_dev_get_drvdata(pctldev);
629 struct pcs_function *func;
630 unsigned offset = 0, shift = 0, i, data, ret;
634 ret = pcs_get_function(pctldev, pin, &func);
638 for (j = 0; j < num_configs; j++) {
639 for (i = 0; i < func->nconfs; i++) {
640 if (pinconf_to_config_param(configs[j])
641 != func->conf[i].param)
644 offset = pin * (pcs->width / BITS_PER_BYTE);
645 data = pcs->read(pcs->base + offset);
646 arg = pinconf_to_config_argument(configs[j]);
647 switch (func->conf[i].param) {
649 case PIN_CONFIG_INPUT_SCHMITT:
650 case PIN_CONFIG_DRIVE_STRENGTH:
651 case PIN_CONFIG_SLEW_RATE:
652 shift = ffs(func->conf[i].mask) - 1;
653 data &= ~func->conf[i].mask;
654 data |= (arg << shift) & func->conf[i].mask;
657 case PIN_CONFIG_BIAS_DISABLE:
658 pcs_pinconf_clear_bias(pctldev, pin);
660 case PIN_CONFIG_BIAS_PULL_DOWN:
661 case PIN_CONFIG_BIAS_PULL_UP:
663 pcs_pinconf_clear_bias(pctldev, pin);
665 case PIN_CONFIG_INPUT_SCHMITT_ENABLE:
666 data &= ~func->conf[i].mask;
668 data |= func->conf[i].enable;
670 data |= func->conf[i].disable;
675 pcs->write(data, pcs->base + offset);
679 if (i >= func->nconfs)
681 } /* for each config */
686 static int pcs_pinconf_group_get(struct pinctrl_dev *pctldev,
687 unsigned group, unsigned long *config)
689 const unsigned *pins;
690 unsigned npins, old = 0;
693 ret = pcs_get_group_pins(pctldev, group, &pins, &npins);
696 for (i = 0; i < npins; i++) {
697 if (pcs_pinconf_get(pctldev, pins[i], config))
699 /* configs do not match between two pins */
700 if (i && (old != *config))
707 static int pcs_pinconf_group_set(struct pinctrl_dev *pctldev,
708 unsigned group, unsigned long *configs,
709 unsigned num_configs)
711 const unsigned *pins;
715 ret = pcs_get_group_pins(pctldev, group, &pins, &npins);
718 for (i = 0; i < npins; i++) {
719 if (pcs_pinconf_set(pctldev, pins[i], configs, num_configs))
725 static void pcs_pinconf_dbg_show(struct pinctrl_dev *pctldev,
726 struct seq_file *s, unsigned pin)
730 static void pcs_pinconf_group_dbg_show(struct pinctrl_dev *pctldev,
731 struct seq_file *s, unsigned selector)
735 static void pcs_pinconf_config_dbg_show(struct pinctrl_dev *pctldev,
737 unsigned long config)
739 pinconf_generic_dump_config(pctldev, s, config);
742 static const struct pinconf_ops pcs_pinconf_ops = {
743 .pin_config_get = pcs_pinconf_get,
744 .pin_config_set = pcs_pinconf_set,
745 .pin_config_group_get = pcs_pinconf_group_get,
746 .pin_config_group_set = pcs_pinconf_group_set,
747 .pin_config_dbg_show = pcs_pinconf_dbg_show,
748 .pin_config_group_dbg_show = pcs_pinconf_group_dbg_show,
749 .pin_config_config_dbg_show = pcs_pinconf_config_dbg_show,
754 * pcs_add_pin() - add a pin to the static per controller pin array
755 * @pcs: pcs driver instance
756 * @offset: register offset from base
758 static int pcs_add_pin(struct pcs_device *pcs, unsigned offset,
761 struct pinctrl_pin_desc *pin;
766 if (i >= pcs->desc.npins) {
767 dev_err(pcs->dev, "too many pins, max %i\n",
772 pin = &pcs->pins.pa[i];
774 sprintf(pn->name, "%lx.%d",
775 (unsigned long)pcs->res->start + offset, pin_pos);
776 pin->name = pn->name;
784 * pcs_allocate_pin_table() - adds all the pins for the pinctrl driver
785 * @pcs: pcs driver instance
787 * In case of errors, resources are freed in pcs_free_resources.
789 * If your hardware needs holes in the address space, then just set
790 * up multiple driver instances.
792 static int pcs_allocate_pin_table(struct pcs_device *pcs)
794 int mux_bytes, nr_pins, i;
795 int num_pins_in_register = 0;
797 mux_bytes = pcs->width / BITS_PER_BYTE;
799 if (pcs->bits_per_mux) {
800 pcs->bits_per_pin = fls(pcs->fmask);
801 nr_pins = (pcs->size * BITS_PER_BYTE) / pcs->bits_per_pin;
802 num_pins_in_register = pcs->width / pcs->bits_per_pin;
804 nr_pins = pcs->size / mux_bytes;
807 dev_dbg(pcs->dev, "allocating %i pins\n", nr_pins);
808 pcs->pins.pa = devm_kzalloc(pcs->dev,
809 sizeof(*pcs->pins.pa) * nr_pins,
814 pcs->names = devm_kzalloc(pcs->dev,
815 sizeof(struct pcs_name) * nr_pins,
820 pcs->desc.pins = pcs->pins.pa;
821 pcs->desc.npins = nr_pins;
823 for (i = 0; i < pcs->desc.npins; i++) {
829 if (pcs->bits_per_mux) {
830 byte_num = (pcs->bits_per_pin * i) / BITS_PER_BYTE;
831 offset = (byte_num / mux_bytes) * mux_bytes;
832 pin_pos = i % num_pins_in_register;
834 offset = i * mux_bytes;
836 res = pcs_add_pin(pcs, offset, pin_pos);
838 dev_err(pcs->dev, "error adding pins: %i\n", res);
847 * pcs_add_function() - adds a new function to the function list
848 * @pcs: pcs driver instance
849 * @np: device node of the mux entry
850 * @name: name of the function
851 * @vals: array of mux register value pairs used by the function
852 * @nvals: number of mux register value pairs
853 * @pgnames: array of pingroup names for the function
854 * @npgnames: number of pingroup names
856 static struct pcs_function *pcs_add_function(struct pcs_device *pcs,
857 struct device_node *np,
859 struct pcs_func_vals *vals,
861 const char **pgnames,
864 struct pcs_function *function;
866 function = devm_kzalloc(pcs->dev, sizeof(*function), GFP_KERNEL);
870 function->name = name;
871 function->vals = vals;
872 function->nvals = nvals;
873 function->pgnames = pgnames;
874 function->npgnames = npgnames;
876 mutex_lock(&pcs->mutex);
877 list_add_tail(&function->node, &pcs->functions);
878 radix_tree_insert(&pcs->ftree, pcs->nfuncs, function);
880 mutex_unlock(&pcs->mutex);
885 static void pcs_remove_function(struct pcs_device *pcs,
886 struct pcs_function *function)
890 mutex_lock(&pcs->mutex);
891 for (i = 0; i < pcs->nfuncs; i++) {
892 struct pcs_function *found;
894 found = radix_tree_lookup(&pcs->ftree, i);
895 if (found == function)
896 radix_tree_delete(&pcs->ftree, i);
898 list_del(&function->node);
899 mutex_unlock(&pcs->mutex);
903 * pcs_add_pingroup() - add a pingroup to the pingroup list
904 * @pcs: pcs driver instance
905 * @np: device node of the mux entry
906 * @name: name of the pingroup
907 * @gpins: array of the pins that belong to the group
908 * @ngpins: number of pins in the group
910 static int pcs_add_pingroup(struct pcs_device *pcs,
911 struct device_node *np,
916 struct pcs_pingroup *pingroup;
918 pingroup = devm_kzalloc(pcs->dev, sizeof(*pingroup), GFP_KERNEL);
922 pingroup->name = name;
924 pingroup->gpins = gpins;
925 pingroup->ngpins = ngpins;
927 mutex_lock(&pcs->mutex);
928 list_add_tail(&pingroup->node, &pcs->pingroups);
929 radix_tree_insert(&pcs->pgtree, pcs->ngroups, pingroup);
931 mutex_unlock(&pcs->mutex);
937 * pcs_get_pin_by_offset() - get a pin index based on the register offset
938 * @pcs: pcs driver instance
939 * @offset: register offset from the base
941 * Note that this is OK as long as the pins are in a static array.
943 static int pcs_get_pin_by_offset(struct pcs_device *pcs, unsigned offset)
947 if (offset >= pcs->size) {
948 dev_err(pcs->dev, "mux offset out of range: 0x%x (0x%x)\n",
953 if (pcs->bits_per_mux)
954 index = (offset * BITS_PER_BYTE) / pcs->bits_per_pin;
956 index = offset / (pcs->width / BITS_PER_BYTE);
962 * check whether data matches enable bits or disable bits
963 * Return value: 1 for matching enable bits, 0 for matching disable bits,
964 * and negative value for matching failure.
966 static int pcs_config_match(unsigned data, unsigned enable, unsigned disable)
972 else if (data == disable)
977 static void add_config(struct pcs_conf_vals **conf, enum pin_config_param param,
978 unsigned value, unsigned enable, unsigned disable,
981 (*conf)->param = param;
982 (*conf)->val = value;
983 (*conf)->enable = enable;
984 (*conf)->disable = disable;
985 (*conf)->mask = mask;
989 static void add_setting(unsigned long **setting, enum pin_config_param param,
992 **setting = pinconf_to_config_packed(param, arg);
996 /* add pinconf setting with 2 parameters */
997 static void pcs_add_conf2(struct pcs_device *pcs, struct device_node *np,
998 const char *name, enum pin_config_param param,
999 struct pcs_conf_vals **conf, unsigned long **settings)
1001 unsigned value[2], shift;
1004 ret = of_property_read_u32_array(np, name, value, 2);
1007 /* set value & mask */
1008 value[0] &= value[1];
1009 shift = ffs(value[1]) - 1;
1010 /* skip enable & disable */
1011 add_config(conf, param, value[0], 0, 0, value[1]);
1012 add_setting(settings, param, value[0] >> shift);
1015 /* add pinconf setting with 4 parameters */
1016 static void pcs_add_conf4(struct pcs_device *pcs, struct device_node *np,
1017 const char *name, enum pin_config_param param,
1018 struct pcs_conf_vals **conf, unsigned long **settings)
1023 /* value to set, enable, disable, mask */
1024 ret = of_property_read_u32_array(np, name, value, 4);
1028 dev_err(pcs->dev, "mask field of the property can't be 0\n");
1031 value[0] &= value[3];
1032 value[1] &= value[3];
1033 value[2] &= value[3];
1034 ret = pcs_config_match(value[0], value[1], value[2]);
1036 dev_dbg(pcs->dev, "failed to match enable or disable bits\n");
1037 add_config(conf, param, value[0], value[1], value[2], value[3]);
1038 add_setting(settings, param, ret);
1041 static int pcs_parse_pinconf(struct pcs_device *pcs, struct device_node *np,
1042 struct pcs_function *func,
1043 struct pinctrl_map **map)
1046 struct pinctrl_map *m = *map;
1047 int i = 0, nconfs = 0;
1048 unsigned long *settings = NULL, *s = NULL;
1049 struct pcs_conf_vals *conf = NULL;
1050 struct pcs_conf_type prop2[] = {
1051 { "pinctrl-single,drive-strength", PIN_CONFIG_DRIVE_STRENGTH, },
1052 { "pinctrl-single,slew-rate", PIN_CONFIG_SLEW_RATE, },
1053 { "pinctrl-single,input-schmitt", PIN_CONFIG_INPUT_SCHMITT, },
1055 struct pcs_conf_type prop4[] = {
1056 { "pinctrl-single,bias-pullup", PIN_CONFIG_BIAS_PULL_UP, },
1057 { "pinctrl-single,bias-pulldown", PIN_CONFIG_BIAS_PULL_DOWN, },
1058 { "pinctrl-single,input-schmitt-enable",
1059 PIN_CONFIG_INPUT_SCHMITT_ENABLE, },
1062 /* If pinconf isn't supported, don't parse properties in below. */
1063 if (!pcs->is_pinconf)
1066 /* cacluate how much properties are supported in current node */
1067 for (i = 0; i < ARRAY_SIZE(prop2); i++) {
1068 if (of_find_property(np, prop2[i].name, NULL))
1071 for (i = 0; i < ARRAY_SIZE(prop4); i++) {
1072 if (of_find_property(np, prop4[i].name, NULL))
1078 func->conf = devm_kzalloc(pcs->dev,
1079 sizeof(struct pcs_conf_vals) * nconfs,
1083 func->nconfs = nconfs;
1084 conf = &(func->conf[0]);
1086 settings = devm_kzalloc(pcs->dev, sizeof(unsigned long) * nconfs,
1092 for (i = 0; i < ARRAY_SIZE(prop2); i++)
1093 pcs_add_conf2(pcs, np, prop2[i].name, prop2[i].param,
1095 for (i = 0; i < ARRAY_SIZE(prop4); i++)
1096 pcs_add_conf4(pcs, np, prop4[i].name, prop4[i].param,
1098 m->type = PIN_MAP_TYPE_CONFIGS_GROUP;
1099 m->data.configs.group_or_pin = np->name;
1100 m->data.configs.configs = settings;
1101 m->data.configs.num_configs = nconfs;
1105 static void pcs_free_pingroups(struct pcs_device *pcs);
1108 * smux_parse_one_pinctrl_entry() - parses a device tree mux entry
1109 * @pcs: pinctrl driver instance
1110 * @np: device node of the mux entry
1112 * @num_maps: number of map
1113 * @pgnames: pingroup names
1115 * Note that this binding currently supports only sets of one register + value.
1117 * Also note that this driver tries to avoid understanding pin and function
1118 * names because of the extra bloat they would cause especially in the case of
1119 * a large number of pins. This driver just sets what is specified for the board
1120 * in the .dts file. Further user space debugging tools can be developed to
1121 * decipher the pin and function names using debugfs.
1123 * If you are concerned about the boot time, set up the static pins in
1124 * the bootloader, and only set up selected pins as device tree entries.
1126 static int pcs_parse_one_pinctrl_entry(struct pcs_device *pcs,
1127 struct device_node *np,
1128 struct pinctrl_map **map,
1130 const char **pgnames)
1132 struct pcs_func_vals *vals;
1134 int size, rows, *pins, index = 0, found = 0, res = -ENOMEM;
1135 struct pcs_function *function;
1137 mux = of_get_property(np, PCS_MUX_PINS_NAME, &size);
1138 if ((!mux) || (size < sizeof(*mux) * 2)) {
1139 dev_err(pcs->dev, "bad data for mux %s\n",
1144 size /= sizeof(*mux); /* Number of elements in array */
1147 vals = devm_kzalloc(pcs->dev, sizeof(*vals) * rows, GFP_KERNEL);
1151 pins = devm_kzalloc(pcs->dev, sizeof(*pins) * rows, GFP_KERNEL);
1155 while (index < size) {
1156 unsigned offset, val;
1159 offset = be32_to_cpup(mux + index++);
1160 val = be32_to_cpup(mux + index++);
1161 vals[found].reg = pcs->base + offset;
1162 vals[found].val = val;
1164 pin = pcs_get_pin_by_offset(pcs, offset);
1167 "could not add functions for %s %ux\n",
1171 pins[found++] = pin;
1174 pgnames[0] = np->name;
1175 function = pcs_add_function(pcs, np, np->name, vals, found, pgnames, 1);
1179 res = pcs_add_pingroup(pcs, np, np->name, pins, found);
1183 (*map)->type = PIN_MAP_TYPE_MUX_GROUP;
1184 (*map)->data.mux.group = np->name;
1185 (*map)->data.mux.function = np->name;
1187 if (pcs->is_pinconf) {
1188 res = pcs_parse_pinconf(pcs, np, function, map);
1190 goto free_pingroups;
1198 pcs_free_pingroups(pcs);
1201 pcs_remove_function(pcs, function);
1204 devm_kfree(pcs->dev, pins);
1207 devm_kfree(pcs->dev, vals);
1212 #define PARAMS_FOR_BITS_PER_MUX 3
1214 static int pcs_parse_bits_in_pinctrl_entry(struct pcs_device *pcs,
1215 struct device_node *np,
1216 struct pinctrl_map **map,
1218 const char **pgnames)
1220 struct pcs_func_vals *vals;
1222 int size, rows, *pins, index = 0, found = 0, res = -ENOMEM;
1224 struct pcs_function *function;
1226 mux = of_get_property(np, PCS_MUX_BITS_NAME, &size);
1229 dev_err(pcs->dev, "no valid property for %s\n", np->name);
1233 if (size < (sizeof(*mux) * PARAMS_FOR_BITS_PER_MUX)) {
1234 dev_err(pcs->dev, "bad data for %s\n", np->name);
1238 /* Number of elements in array */
1239 size /= sizeof(*mux);
1241 rows = size / PARAMS_FOR_BITS_PER_MUX;
1242 npins_in_row = pcs->width / pcs->bits_per_pin;
1244 vals = devm_kzalloc(pcs->dev, sizeof(*vals) * rows * npins_in_row,
1249 pins = devm_kzalloc(pcs->dev, sizeof(*pins) * rows * npins_in_row,
1254 while (index < size) {
1255 unsigned offset, val;
1256 unsigned mask, bit_pos, val_pos, mask_pos, submask;
1257 unsigned pin_num_from_lsb;
1260 offset = be32_to_cpup(mux + index++);
1261 val = be32_to_cpup(mux + index++);
1262 mask = be32_to_cpup(mux + index++);
1264 /* Parse pins in each row from LSB */
1266 bit_pos = ffs(mask);
1267 pin_num_from_lsb = bit_pos / pcs->bits_per_pin;
1268 mask_pos = ((pcs->fmask) << (bit_pos - 1));
1269 val_pos = val & mask_pos;
1270 submask = mask & mask_pos;
1273 if (submask != mask_pos) {
1275 "Invalid submask 0x%x for %s at 0x%x\n",
1276 submask, np->name, offset);
1280 vals[found].mask = submask;
1281 vals[found].reg = pcs->base + offset;
1282 vals[found].val = val_pos;
1284 pin = pcs_get_pin_by_offset(pcs, offset);
1287 "could not add functions for %s %ux\n",
1291 pins[found++] = pin + pin_num_from_lsb;
1295 pgnames[0] = np->name;
1296 function = pcs_add_function(pcs, np, np->name, vals, found, pgnames, 1);
1300 res = pcs_add_pingroup(pcs, np, np->name, pins, found);
1304 (*map)->type = PIN_MAP_TYPE_MUX_GROUP;
1305 (*map)->data.mux.group = np->name;
1306 (*map)->data.mux.function = np->name;
1308 if (pcs->is_pinconf) {
1309 dev_err(pcs->dev, "pinconf not supported\n");
1310 goto free_pingroups;
1317 pcs_free_pingroups(pcs);
1320 pcs_remove_function(pcs, function);
1323 devm_kfree(pcs->dev, pins);
1326 devm_kfree(pcs->dev, vals);
1331 * pcs_dt_node_to_map() - allocates and parses pinctrl maps
1332 * @pctldev: pinctrl instance
1333 * @np_config: device tree pinmux entry
1334 * @map: array of map entries
1335 * @num_maps: number of maps
1337 static int pcs_dt_node_to_map(struct pinctrl_dev *pctldev,
1338 struct device_node *np_config,
1339 struct pinctrl_map **map, unsigned *num_maps)
1341 struct pcs_device *pcs;
1342 const char **pgnames;
1345 pcs = pinctrl_dev_get_drvdata(pctldev);
1347 /* create 2 maps. One is for pinmux, and the other is for pinconf. */
1348 *map = devm_kzalloc(pcs->dev, sizeof(**map) * 2, GFP_KERNEL);
1354 pgnames = devm_kzalloc(pcs->dev, sizeof(*pgnames), GFP_KERNEL);
1360 if (pcs->bits_per_mux) {
1361 ret = pcs_parse_bits_in_pinctrl_entry(pcs, np_config, map,
1364 dev_err(pcs->dev, "no pins entries for %s\n",
1369 ret = pcs_parse_one_pinctrl_entry(pcs, np_config, map,
1372 dev_err(pcs->dev, "no pins entries for %s\n",
1381 devm_kfree(pcs->dev, pgnames);
1383 devm_kfree(pcs->dev, *map);
1389 * pcs_free_funcs() - free memory used by functions
1390 * @pcs: pcs driver instance
1392 static void pcs_free_funcs(struct pcs_device *pcs)
1394 struct list_head *pos, *tmp;
1397 mutex_lock(&pcs->mutex);
1398 for (i = 0; i < pcs->nfuncs; i++) {
1399 struct pcs_function *func;
1401 func = radix_tree_lookup(&pcs->ftree, i);
1404 radix_tree_delete(&pcs->ftree, i);
1406 list_for_each_safe(pos, tmp, &pcs->functions) {
1407 struct pcs_function *function;
1409 function = list_entry(pos, struct pcs_function, node);
1410 list_del(&function->node);
1412 mutex_unlock(&pcs->mutex);
1416 * pcs_free_pingroups() - free memory used by pingroups
1417 * @pcs: pcs driver instance
1419 static void pcs_free_pingroups(struct pcs_device *pcs)
1421 struct list_head *pos, *tmp;
1424 mutex_lock(&pcs->mutex);
1425 for (i = 0; i < pcs->ngroups; i++) {
1426 struct pcs_pingroup *pingroup;
1428 pingroup = radix_tree_lookup(&pcs->pgtree, i);
1431 radix_tree_delete(&pcs->pgtree, i);
1433 list_for_each_safe(pos, tmp, &pcs->pingroups) {
1434 struct pcs_pingroup *pingroup;
1436 pingroup = list_entry(pos, struct pcs_pingroup, node);
1437 list_del(&pingroup->node);
1439 mutex_unlock(&pcs->mutex);
1443 * pcs_free_resources() - free memory used by this driver
1444 * @pcs: pcs driver instance
1446 static void pcs_free_resources(struct pcs_device *pcs)
1449 pinctrl_unregister(pcs->pctl);
1451 pcs_free_funcs(pcs);
1452 pcs_free_pingroups(pcs);
1455 #define PCS_GET_PROP_U32(name, reg, err) \
1457 ret = of_property_read_u32(np, name, reg); \
1459 dev_err(pcs->dev, err); \
1464 static struct of_device_id pcs_of_match[];
1466 static int pcs_add_gpio_func(struct device_node *node, struct pcs_device *pcs)
1468 const char *propname = "pinctrl-single,gpio-range";
1469 const char *cellname = "#pinctrl-single,gpio-range-cells";
1470 struct of_phandle_args gpiospec;
1471 struct pcs_gpiofunc_range *range;
1474 for (i = 0; ; i++) {
1475 ret = of_parse_phandle_with_args(node, propname, cellname,
1477 /* Do not treat it as error. Only treat it as end condition. */
1482 range = devm_kzalloc(pcs->dev, sizeof(*range), GFP_KERNEL);
1487 range->offset = gpiospec.args[0];
1488 range->npins = gpiospec.args[1];
1489 range->gpiofunc = gpiospec.args[2];
1490 mutex_lock(&pcs->mutex);
1491 list_add_tail(&range->node, &pcs->gpiofuncs);
1492 mutex_unlock(&pcs->mutex);
1497 static int pinctrl_single_suspend(struct platform_device *pdev,
1500 struct pcs_device *pcs;
1502 pcs = platform_get_drvdata(pdev);
1506 return pinctrl_force_sleep(pcs->pctl);
1509 static int pinctrl_single_resume(struct platform_device *pdev)
1511 struct pcs_device *pcs;
1513 pcs = platform_get_drvdata(pdev);
1517 return pinctrl_force_default(pcs->pctl);
1520 static int pcs_probe(struct platform_device *pdev)
1522 struct device_node *np = pdev->dev.of_node;
1523 const struct of_device_id *match;
1524 struct resource *res;
1525 struct pcs_device *pcs;
1528 match = of_match_device(pcs_of_match, &pdev->dev);
1532 pcs = devm_kzalloc(&pdev->dev, sizeof(*pcs), GFP_KERNEL);
1534 dev_err(&pdev->dev, "could not allocate\n");
1537 pcs->dev = &pdev->dev;
1538 mutex_init(&pcs->mutex);
1539 INIT_LIST_HEAD(&pcs->pingroups);
1540 INIT_LIST_HEAD(&pcs->functions);
1541 INIT_LIST_HEAD(&pcs->gpiofuncs);
1542 pcs->is_pinconf = match->data;
1544 PCS_GET_PROP_U32("pinctrl-single,register-width", &pcs->width,
1545 "register width not specified\n");
1547 ret = of_property_read_u32(np, "pinctrl-single,function-mask",
1550 pcs->fshift = ffs(pcs->fmask) - 1;
1551 pcs->fmax = pcs->fmask >> pcs->fshift;
1553 /* If mask property doesn't exist, function mux is invalid. */
1559 ret = of_property_read_u32(np, "pinctrl-single,function-off",
1562 pcs->foff = PCS_OFF_DISABLED;
1564 pcs->bits_per_mux = of_property_read_bool(np,
1565 "pinctrl-single,bit-per-mux");
1567 res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
1569 dev_err(pcs->dev, "could not get resource\n");
1573 pcs->res = devm_request_mem_region(pcs->dev, res->start,
1574 resource_size(res), DRIVER_NAME);
1576 dev_err(pcs->dev, "could not get mem_region\n");
1580 pcs->size = resource_size(pcs->res);
1581 pcs->base = devm_ioremap(pcs->dev, pcs->res->start, pcs->size);
1583 dev_err(pcs->dev, "could not ioremap\n");
1587 INIT_RADIX_TREE(&pcs->pgtree, GFP_KERNEL);
1588 INIT_RADIX_TREE(&pcs->ftree, GFP_KERNEL);
1589 platform_set_drvdata(pdev, pcs);
1591 switch (pcs->width) {
1593 pcs->read = pcs_readb;
1594 pcs->write = pcs_writeb;
1597 pcs->read = pcs_readw;
1598 pcs->write = pcs_writew;
1601 pcs->read = pcs_readl;
1602 pcs->write = pcs_writel;
1608 pcs->desc.name = DRIVER_NAME;
1609 pcs->desc.pctlops = &pcs_pinctrl_ops;
1610 pcs->desc.pmxops = &pcs_pinmux_ops;
1611 if (pcs->is_pinconf)
1612 pcs->desc.confops = &pcs_pinconf_ops;
1613 pcs->desc.owner = THIS_MODULE;
1615 ret = pcs_allocate_pin_table(pcs);
1619 pcs->pctl = pinctrl_register(&pcs->desc, pcs->dev, pcs);
1621 dev_err(pcs->dev, "could not register single pinctrl driver\n");
1626 ret = pcs_add_gpio_func(np, pcs);
1630 dev_info(pcs->dev, "%i pins at pa %p size %u\n",
1631 pcs->desc.npins, pcs->base, pcs->size);
1636 pcs_free_resources(pcs);
1641 static int pcs_remove(struct platform_device *pdev)
1643 struct pcs_device *pcs = platform_get_drvdata(pdev);
1648 pcs_free_resources(pcs);
1653 static struct of_device_id pcs_of_match[] = {
1654 { .compatible = "pinctrl-single", .data = (void *)false },
1655 { .compatible = "pinconf-single", .data = (void *)true },
1658 MODULE_DEVICE_TABLE(of, pcs_of_match);
1660 static struct platform_driver pcs_driver = {
1662 .remove = pcs_remove,
1664 .owner = THIS_MODULE,
1665 .name = DRIVER_NAME,
1666 .of_match_table = pcs_of_match,
1669 .suspend = pinctrl_single_suspend,
1670 .resume = pinctrl_single_resume,
1674 module_platform_driver(pcs_driver);
1676 MODULE_AUTHOR("Tony Lindgren <tony@atomide.com>");
1677 MODULE_DESCRIPTION("One-register-per-pin type device tree based pinctrl driver");
1678 MODULE_LICENSE("GPL v2");