dt-bindings: pinctrl: mt2712: add binding document
[linux-2.6-block.git] / drivers / pinctrl / pinconf.c
CommitLineData
ae6b4d85
LW
1/*
2 * Core driver for the pin config portions of the pin control subsystem
3 *
4 * Copyright (C) 2011 ST-Ericsson SA
5 * Written on behalf of Linaro for ST-Ericsson
6 *
7 * Author: Linus Walleij <linus.walleij@linaro.org>
8 *
9 * License terms: GNU General Public License (GPL) version 2
10 */
11#define pr_fmt(fmt) "pinconfig core: " fmt
12
13#include <linux/kernel.h>
14#include <linux/module.h>
15#include <linux/init.h>
16#include <linux/device.h>
17#include <linux/slab.h>
18#include <linux/debugfs.h>
19#include <linux/seq_file.h>
f07512e6 20#include <linux/uaccess.h>
ae6b4d85
LW
21#include <linux/pinctrl/machine.h>
22#include <linux/pinctrl/pinctrl.h>
23#include <linux/pinctrl/pinconf.h>
24#include "core.h"
25#include "pinconf.h"
26
2b694250
SW
27int pinconf_check_ops(struct pinctrl_dev *pctldev)
28{
29 const struct pinconf_ops *ops = pctldev->desc->confops;
30
2b694250 31 /* We have to be able to config the pins in SOME way */
ad6e1107
JC
32 if (!ops->pin_config_set && !ops->pin_config_group_set) {
33 dev_err(pctldev->dev,
34 "pinconf has to be able to set a pins config\n");
2b694250 35 return -EINVAL;
ad6e1107 36 }
2b694250
SW
37 return 0;
38}
39
1e2082b5
SW
40int pinconf_validate_map(struct pinctrl_map const *map, int i)
41{
42 if (!map->data.configs.group_or_pin) {
43 pr_err("failed to register map %s (%d): no group/pin given\n",
44 map->name, i);
45 return -EINVAL;
46 }
47
c95df2db 48 if (!map->data.configs.num_configs ||
1e2082b5 49 !map->data.configs.configs) {
c95df2db 50 pr_err("failed to register map %s (%d): no configs given\n",
1e2082b5
SW
51 map->name, i);
52 return -EINVAL;
53 }
54
55 return 0;
56}
57
394349f7 58int pin_config_get_for_pin(struct pinctrl_dev *pctldev, unsigned pin,
ae6b4d85
LW
59 unsigned long *config)
60{
61 const struct pinconf_ops *ops = pctldev->desc->confops;
62
63 if (!ops || !ops->pin_config_get) {
ca67f10f
MY
64 dev_dbg(pctldev->dev,
65 "cannot get pin configuration, .pin_config_get missing in driver\n");
c420619d 66 return -ENOTSUPP;
ae6b4d85
LW
67 }
68
69 return ops->pin_config_get(pctldev, pin, config);
70}
71
43699dea 72int pin_config_group_get(const char *dev_name, const char *pin_group,
ae6b4d85
LW
73 unsigned long *config)
74{
43699dea
SW
75 struct pinctrl_dev *pctldev;
76 const struct pinconf_ops *ops;
57b676f9
SW
77 int selector, ret;
78
9dfac4fd 79 pctldev = get_pinctrl_dev_from_devname(dev_name);
57b676f9
SW
80 if (!pctldev) {
81 ret = -EINVAL;
42fed7ba 82 return ret;
57b676f9 83 }
42fed7ba
PC
84
85 mutex_lock(&pctldev->mutex);
86
43699dea
SW
87 ops = pctldev->desc->confops;
88
ae6b4d85 89 if (!ops || !ops->pin_config_group_get) {
e4d03050
ME
90 dev_dbg(pctldev->dev,
91 "cannot get configuration for pin group, missing group config get function in driver\n");
c420619d 92 ret = -ENOTSUPP;
57b676f9 93 goto unlock;
ae6b4d85
LW
94 }
95
96 selector = pinctrl_get_group_selector(pctldev, pin_group);
57b676f9
SW
97 if (selector < 0) {
98 ret = selector;
99 goto unlock;
100 }
ae6b4d85 101
57b676f9
SW
102 ret = ops->pin_config_group_get(pctldev, selector, config);
103
104unlock:
42fed7ba 105 mutex_unlock(&pctldev->mutex);
57b676f9 106 return ret;
ae6b4d85 107}
ae6b4d85 108
1e2082b5
SW
109int pinconf_map_to_setting(struct pinctrl_map const *map,
110 struct pinctrl_setting *setting)
111{
112 struct pinctrl_dev *pctldev = setting->pctldev;
70b36378 113 int pin;
1e2082b5
SW
114
115 switch (setting->type) {
116 case PIN_MAP_TYPE_CONFIGS_PIN:
70b36378
LW
117 pin = pin_get_from_name(pctldev,
118 map->data.configs.group_or_pin);
119 if (pin < 0) {
120 dev_err(pctldev->dev, "could not map pin config for \"%s\"",
121 map->data.configs.group_or_pin);
122 return pin;
123 }
124 setting->data.configs.group_or_pin = pin;
1e2082b5
SW
125 break;
126 case PIN_MAP_TYPE_CONFIGS_GROUP:
70b36378
LW
127 pin = pinctrl_get_group_selector(pctldev,
128 map->data.configs.group_or_pin);
129 if (pin < 0) {
130 dev_err(pctldev->dev, "could not map group config for \"%s\"",
131 map->data.configs.group_or_pin);
132 return pin;
133 }
134 setting->data.configs.group_or_pin = pin;
1e2082b5
SW
135 break;
136 default:
137 return -EINVAL;
138 }
139
140 setting->data.configs.num_configs = map->data.configs.num_configs;
141 setting->data.configs.configs = map->data.configs.configs;
142
143 return 0;
144}
145
146void pinconf_free_setting(struct pinctrl_setting const *setting)
147{
148}
149
150int pinconf_apply_setting(struct pinctrl_setting const *setting)
151{
152 struct pinctrl_dev *pctldev = setting->pctldev;
153 const struct pinconf_ops *ops = pctldev->desc->confops;
03b054e9 154 int ret;
1e2082b5
SW
155
156 if (!ops) {
157 dev_err(pctldev->dev, "missing confops\n");
158 return -EINVAL;
159 }
160
161 switch (setting->type) {
162 case PIN_MAP_TYPE_CONFIGS_PIN:
163 if (!ops->pin_config_set) {
164 dev_err(pctldev->dev, "missing pin_config_set op\n");
165 return -EINVAL;
166 }
03b054e9
SY
167 ret = ops->pin_config_set(pctldev,
168 setting->data.configs.group_or_pin,
169 setting->data.configs.configs,
170 setting->data.configs.num_configs);
171 if (ret < 0) {
172 dev_err(pctldev->dev,
173 "pin_config_set op failed for pin %d\n",
174 setting->data.configs.group_or_pin);
175 return ret;
1e2082b5
SW
176 }
177 break;
178 case PIN_MAP_TYPE_CONFIGS_GROUP:
179 if (!ops->pin_config_group_set) {
180 dev_err(pctldev->dev,
181 "missing pin_config_group_set op\n");
182 return -EINVAL;
183 }
03b054e9
SY
184 ret = ops->pin_config_group_set(pctldev,
185 setting->data.configs.group_or_pin,
186 setting->data.configs.configs,
187 setting->data.configs.num_configs);
188 if (ret < 0) {
189 dev_err(pctldev->dev,
190 "pin_config_group_set op failed for group %d\n",
191 setting->data.configs.group_or_pin);
192 return ret;
1e2082b5
SW
193 }
194 break;
195 default:
196 return -EINVAL;
197 }
198
199 return 0;
200}
201
15381bc7
MW
202int pinconf_set_config(struct pinctrl_dev *pctldev, unsigned pin,
203 unsigned long *configs, size_t nconfigs)
204{
205 const struct pinconf_ops *ops;
206
207 ops = pctldev->desc->confops;
208 if (!ops)
209 return -ENOTSUPP;
210
211 return ops->pin_config_set(pctldev, pin, configs, nconfigs);
212}
213
ae6b4d85
LW
214#ifdef CONFIG_DEBUG_FS
215
6de52c15 216static void pinconf_show_config(struct seq_file *s, struct pinctrl_dev *pctldev,
d96310ae 217 unsigned long *configs, unsigned num_configs)
1e2082b5 218{
6cb41587 219 const struct pinconf_ops *confops;
1e2082b5
SW
220 int i;
221
6cb41587
SW
222 if (pctldev)
223 confops = pctldev->desc->confops;
224 else
225 confops = NULL;
226
d96310ae
JH
227 for (i = 0; i < num_configs; i++) {
228 seq_puts(s, "config ");
229 if (confops && confops->pin_config_config_dbg_show)
230 confops->pin_config_config_dbg_show(pctldev, s,
231 configs[i]);
232 else
233 seq_printf(s, "%08lx", configs[i]);
47352a63 234 seq_putc(s, '\n');
d96310ae
JH
235 }
236}
237
238void pinconf_show_map(struct seq_file *s, struct pinctrl_map const *map)
239{
240 struct pinctrl_dev *pctldev;
241
242 pctldev = get_pinctrl_dev_from_devname(map->ctrl_dev_name);
243
1e2082b5
SW
244 switch (map->type) {
245 case PIN_MAP_TYPE_CONFIGS_PIN:
de2eae26 246 seq_puts(s, "pin ");
1e2082b5
SW
247 break;
248 case PIN_MAP_TYPE_CONFIGS_GROUP:
de2eae26 249 seq_puts(s, "group ");
1e2082b5
SW
250 break;
251 default:
252 break;
253 }
254
255 seq_printf(s, "%s\n", map->data.configs.group_or_pin);
256
d96310ae
JH
257 pinconf_show_config(s, pctldev, map->data.configs.configs,
258 map->data.configs.num_configs);
1e2082b5
SW
259}
260
261void pinconf_show_setting(struct seq_file *s,
262 struct pinctrl_setting const *setting)
263{
264 struct pinctrl_dev *pctldev = setting->pctldev;
265 const struct pinctrl_ops *pctlops = pctldev->desc->pctlops;
266 struct pin_desc *desc;
1e2082b5
SW
267
268 switch (setting->type) {
269 case PIN_MAP_TYPE_CONFIGS_PIN:
270 desc = pin_desc_get(setting->pctldev,
271 setting->data.configs.group_or_pin);
cf9d994d 272 seq_printf(s, "pin %s (%d)", desc->name,
1e2082b5
SW
273 setting->data.configs.group_or_pin);
274 break;
275 case PIN_MAP_TYPE_CONFIGS_GROUP:
276 seq_printf(s, "group %s (%d)",
277 pctlops->get_group_name(pctldev,
278 setting->data.configs.group_or_pin),
279 setting->data.configs.group_or_pin);
280 break;
281 default:
282 break;
283 }
284
285 /*
3ec440e3 286 * FIXME: We should really get the pin controller to dump the config
1e2082b5
SW
287 * values, so they can be decoded to something meaningful.
288 */
d96310ae
JH
289 pinconf_show_config(s, pctldev, setting->data.configs.configs,
290 setting->data.configs.num_configs);
1e2082b5
SW
291}
292
ae6b4d85
LW
293static void pinconf_dump_pin(struct pinctrl_dev *pctldev,
294 struct seq_file *s, int pin)
295{
296 const struct pinconf_ops *ops = pctldev->desc->confops;
297
394349f7 298 /* no-op when not using generic pin config */
dd4d01f7 299 pinconf_generic_dump_pins(pctldev, s, NULL, pin);
ae6b4d85
LW
300 if (ops && ops->pin_config_dbg_show)
301 ops->pin_config_dbg_show(pctldev, s, pin);
302}
303
304static int pinconf_pins_show(struct seq_file *s, void *what)
305{
306 struct pinctrl_dev *pctldev = s->private;
706e8520 307 unsigned i, pin;
ae6b4d85
LW
308
309 seq_puts(s, "Pin config settings per pin\n");
2aeefe02 310 seq_puts(s, "Format: pin (name): configs\n");
ae6b4d85 311
42fed7ba 312 mutex_lock(&pctldev->mutex);
57b676f9 313
706e8520 314 /* The pin number can be retrived from the pin controller descriptor */
546edd83 315 for (i = 0; i < pctldev->desc->npins; i++) {
ae6b4d85
LW
316 struct pin_desc *desc;
317
706e8520 318 pin = pctldev->desc->pins[i].number;
ae6b4d85 319 desc = pin_desc_get(pctldev, pin);
706e8520 320 /* Skip if we cannot search the pin */
76ce37f0 321 if (!desc)
ae6b4d85
LW
322 continue;
323
a672eb5e 324 seq_printf(s, "pin %d (%s): ", pin, desc->name);
ae6b4d85
LW
325
326 pinconf_dump_pin(pctldev, s, pin);
47352a63 327 seq_putc(s, '\n');
ae6b4d85
LW
328 }
329
42fed7ba 330 mutex_unlock(&pctldev->mutex);
57b676f9 331
ae6b4d85
LW
332 return 0;
333}
334
335static void pinconf_dump_group(struct pinctrl_dev *pctldev,
336 struct seq_file *s, unsigned selector,
337 const char *gname)
338{
339 const struct pinconf_ops *ops = pctldev->desc->confops;
340
394349f7 341 /* no-op when not using generic pin config */
dd4d01f7 342 pinconf_generic_dump_pins(pctldev, s, gname, 0);
ae6b4d85
LW
343 if (ops && ops->pin_config_group_dbg_show)
344 ops->pin_config_group_dbg_show(pctldev, s, selector);
345}
346
347static int pinconf_groups_show(struct seq_file *s, void *what)
348{
349 struct pinctrl_dev *pctldev = s->private;
350 const struct pinctrl_ops *pctlops = pctldev->desc->pctlops;
d1e90e9e 351 unsigned ngroups = pctlops->get_groups_count(pctldev);
ae6b4d85
LW
352 unsigned selector = 0;
353
ae6b4d85 354 seq_puts(s, "Pin config settings per pin group\n");
2aeefe02 355 seq_puts(s, "Format: group (name): configs\n");
ae6b4d85 356
d1e90e9e 357 while (selector < ngroups) {
ae6b4d85
LW
358 const char *gname = pctlops->get_group_name(pctldev, selector);
359
a672eb5e 360 seq_printf(s, "%u (%s): ", selector, gname);
ae6b4d85 361 pinconf_dump_group(pctldev, s, selector, gname);
47352a63 362 seq_putc(s, '\n');
ae6b4d85
LW
363 selector++;
364 }
365
366 return 0;
367}
368
369static int pinconf_pins_open(struct inode *inode, struct file *file)
370{
371 return single_open(file, pinconf_pins_show, inode->i_private);
372}
373
374static int pinconf_groups_open(struct inode *inode, struct file *file)
375{
376 return single_open(file, pinconf_groups_show, inode->i_private);
377}
378
379static const struct file_operations pinconf_pins_ops = {
380 .open = pinconf_pins_open,
381 .read = seq_read,
382 .llseek = seq_lseek,
383 .release = single_release,
384};
385
386static const struct file_operations pinconf_groups_ops = {
387 .open = pinconf_groups_open,
388 .read = seq_read,
389 .llseek = seq_lseek,
390 .release = single_release,
391};
392
f07512e6
LM
393#define MAX_NAME_LEN 15
394
395struct dbg_cfg {
396 enum pinctrl_map_type map_type;
e8c5d759
ME
397 char dev_name[MAX_NAME_LEN + 1];
398 char state_name[MAX_NAME_LEN + 1];
399 char pin_name[MAX_NAME_LEN + 1];
f07512e6
LM
400};
401
402/*
403 * Goal is to keep this structure as global in order to simply read the
404 * pinconf-config file after a write to check config is as expected
405 */
406static struct dbg_cfg pinconf_dbg_conf;
407
408/**
409 * pinconf_dbg_config_print() - display the pinctrl config from the pinctrl
410 * map, of the dev/pin/state that was last written to pinconf-config file.
411 * @s: string filled in with config description
412 * @d: not used
413 */
414static int pinconf_dbg_config_print(struct seq_file *s, void *d)
415{
416 struct pinctrl_maps *maps_node;
417 const struct pinctrl_map *map;
8a9dcc3f
RKAL
418 const struct pinctrl_map *found = NULL;
419 struct pinctrl_dev *pctldev;
f07512e6 420 struct dbg_cfg *dbg = &pinconf_dbg_conf;
d99c8053 421 int i;
f07512e6 422
a386267a 423 mutex_lock(&pinctrl_maps_mutex);
f07512e6
LM
424
425 /* Parse the pinctrl map and look for the elected pin/state */
426 for_each_maps(maps_node, i, map) {
427 if (map->type != dbg->map_type)
428 continue;
429 if (strcmp(map->dev_name, dbg->dev_name))
430 continue;
431 if (strcmp(map->name, dbg->state_name))
432 continue;
433
d99c8053
LM
434 if (!strcmp(map->data.configs.group_or_pin, dbg->pin_name)) {
435 /* We found the right pin */
436 found = map;
437 break;
f07512e6
LM
438 }
439 }
440
441 if (!found) {
442 seq_printf(s, "No config found for dev/state/pin, expected:\n");
443 seq_printf(s, "Searched dev:%s\n", dbg->dev_name);
444 seq_printf(s, "Searched state:%s\n", dbg->state_name);
445 seq_printf(s, "Searched pin:%s\n", dbg->pin_name);
446 seq_printf(s, "Use: modify config_pin <devname> "\
447 "<state> <pinname> <value>\n");
448 goto exit;
449 }
450
8a9dcc3f 451 pctldev = get_pinctrl_dev_from_devname(found->ctrl_dev_name);
d96310ae
JH
452 seq_printf(s, "Dev %s has config of %s in state %s:\n",
453 dbg->dev_name, dbg->pin_name, dbg->state_name);
454 pinconf_show_config(s, pctldev, found->data.configs.configs,
455 found->data.configs.num_configs);
f07512e6
LM
456
457exit:
a386267a 458 mutex_unlock(&pinctrl_maps_mutex);
f07512e6
LM
459
460 return 0;
461}
462
463/**
464 * pinconf_dbg_config_write() - modify the pinctrl config in the pinctrl
465 * map, of a dev/pin/state entry based on user entries to pinconf-config
466 * @user_buf: contains the modification request with expected format:
75629981 467 * modify <config> <devicename> <state> <name> <newvalue>
f07512e6 468 * modify is literal string, alternatives like add/delete not supported yet
75629981
JH
469 * <config> is the configuration to be changed. Supported configs are
470 * "config_pin" or "config_group", alternatives like config_mux are not
471 * supported yet.
472 * <devicename> <state> <name> are values that should match the pinctrl-maps
3ec440e3 473 * <newvalue> reflects the new config and is driver dependent
f07512e6 474 */
3b59e432 475static ssize_t pinconf_dbg_config_write(struct file *file,
f07512e6
LM
476 const char __user *user_buf, size_t count, loff_t *ppos)
477{
478 struct pinctrl_maps *maps_node;
479 const struct pinctrl_map *map;
8a9dcc3f
RKAL
480 const struct pinctrl_map *found = NULL;
481 struct pinctrl_dev *pctldev;
f07512e6
LM
482 const struct pinconf_ops *confops = NULL;
483 struct dbg_cfg *dbg = &pinconf_dbg_conf;
484 const struct pinctrl_map_configs *configs;
e8c5d759 485 char config[MAX_NAME_LEN + 1];
f07512e6
LM
486 char buf[128];
487 char *b = &buf[0];
488 int buf_size;
489 char *token;
490 int i;
491
492 /* Get userspace string and assure termination */
81d36c4f 493 buf_size = min(count, sizeof(buf) - 1);
f07512e6
LM
494 if (copy_from_user(buf, user_buf, buf_size))
495 return -EFAULT;
496 buf[buf_size] = 0;
497
498 /*
499 * need to parse entry and extract parameters:
500 * modify configs_pin devicename state pinname newvalue
501 */
502
503 /* Get arg: 'modify' */
504 token = strsep(&b, " ");
505 if (!token)
506 return -EINVAL;
507 if (strcmp(token, "modify"))
508 return -EINVAL;
509
75629981
JH
510 /*
511 * Get arg type: "config_pin" and "config_group"
512 * types are supported so far
513 */
f07512e6
LM
514 token = strsep(&b, " ");
515 if (!token)
516 return -EINVAL;
75629981
JH
517 if (!strcmp(token, "config_pin"))
518 dbg->map_type = PIN_MAP_TYPE_CONFIGS_PIN;
519 else if (!strcmp(token, "config_group"))
520 dbg->map_type = PIN_MAP_TYPE_CONFIGS_GROUP;
521 else
f07512e6 522 return -EINVAL;
f07512e6
LM
523
524 /* get arg 'device_name' */
525 token = strsep(&b, " ");
76ce37f0 526 if (!token)
f07512e6
LM
527 return -EINVAL;
528 if (strlen(token) >= MAX_NAME_LEN)
529 return -EINVAL;
530 strncpy(dbg->dev_name, token, MAX_NAME_LEN);
531
532 /* get arg 'state_name' */
533 token = strsep(&b, " ");
76ce37f0 534 if (!token)
f07512e6
LM
535 return -EINVAL;
536 if (strlen(token) >= MAX_NAME_LEN)
537 return -EINVAL;
538 strncpy(dbg->state_name, token, MAX_NAME_LEN);
539
540 /* get arg 'pin_name' */
541 token = strsep(&b, " ");
76ce37f0 542 if (!token)
f07512e6
LM
543 return -EINVAL;
544 if (strlen(token) >= MAX_NAME_LEN)
545 return -EINVAL;
546 strncpy(dbg->pin_name, token, MAX_NAME_LEN);
547
548 /* get new_value of config' */
549 token = strsep(&b, " ");
76ce37f0 550 if (!token)
f07512e6
LM
551 return -EINVAL;
552 if (strlen(token) >= MAX_NAME_LEN)
553 return -EINVAL;
554 strncpy(config, token, MAX_NAME_LEN);
555
42fed7ba 556 mutex_lock(&pinctrl_maps_mutex);
f07512e6
LM
557
558 /* Parse the pinctrl map and look for the selected dev/state/pin */
559 for_each_maps(maps_node, i, map) {
560 if (strcmp(map->dev_name, dbg->dev_name))
561 continue;
562 if (map->type != dbg->map_type)
563 continue;
564 if (strcmp(map->name, dbg->state_name))
565 continue;
566
567 /* we found the right pin / state, so overwrite config */
568 if (!strcmp(map->data.configs.group_or_pin, dbg->pin_name)) {
8a9dcc3f 569 found = map;
f07512e6
LM
570 break;
571 }
572 }
573
574 if (!found) {
f07512e6 575 count = -EINVAL;
cb6d315d 576 goto exit;
f07512e6
LM
577 }
578
8a9dcc3f 579 pctldev = get_pinctrl_dev_from_devname(found->ctrl_dev_name);
f07512e6
LM
580 if (pctldev)
581 confops = pctldev->desc->confops;
582
583 if (confops && confops->pin_config_dbg_parse_modify) {
8a9dcc3f 584 configs = &found->data.configs;
f07512e6
LM
585 for (i = 0; i < configs->num_configs; i++) {
586 confops->pin_config_dbg_parse_modify(pctldev,
587 config,
588 &configs->configs[i]);
589 }
590 }
591
592exit:
42fed7ba 593 mutex_unlock(&pinctrl_maps_mutex);
f07512e6
LM
594
595 return count;
596}
597
598static int pinconf_dbg_config_open(struct inode *inode, struct file *file)
599{
600 return single_open(file, pinconf_dbg_config_print, inode->i_private);
601}
602
603static const struct file_operations pinconf_dbg_pinconfig_fops = {
604 .open = pinconf_dbg_config_open,
605 .write = pinconf_dbg_config_write,
606 .read = seq_read,
607 .llseek = seq_lseek,
608 .release = single_release,
609 .owner = THIS_MODULE,
610};
611
ae6b4d85
LW
612void pinconf_init_device_debugfs(struct dentry *devroot,
613 struct pinctrl_dev *pctldev)
614{
615 debugfs_create_file("pinconf-pins", S_IFREG | S_IRUGO,
616 devroot, pctldev, &pinconf_pins_ops);
617 debugfs_create_file("pinconf-groups", S_IFREG | S_IRUGO,
618 devroot, pctldev, &pinconf_groups_ops);
f07512e6
LM
619 debugfs_create_file("pinconf-config", (S_IRUGO | S_IWUSR | S_IWGRP),
620 devroot, pctldev, &pinconf_dbg_pinconfig_fops);
ae6b4d85
LW
621}
622
623#endif