pinconf.c 9.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379
  1. // SPDX-License-Identifier: GPL-2.0-only
  2. /*
  3. * Core driver for the pin config portions of the pin control subsystem
  4. *
  5. * Copyright (C) 2011 ST-Ericsson SA
  6. * Written on behalf of Linaro for ST-Ericsson
  7. *
  8. * Author: Linus Walleij <linus.walleij@linaro.org>
  9. */
  10. #define pr_fmt(fmt) "pinconfig core: " fmt
  11. #include <linux/kernel.h>
  12. #include <linux/module.h>
  13. #include <linux/init.h>
  14. #include <linux/device.h>
  15. #include <linux/slab.h>
  16. #include <linux/debugfs.h>
  17. #include <linux/seq_file.h>
  18. #include <linux/pinctrl/machine.h>
  19. #include <linux/pinctrl/pinctrl.h>
  20. #include <linux/pinctrl/pinconf.h>
  21. #include "core.h"
  22. #include "pinconf.h"
  23. int pinconf_check_ops(struct pinctrl_dev *pctldev)
  24. {
  25. const struct pinconf_ops *ops = pctldev->desc->confops;
  26. /* We have to be able to config the pins in SOME way */
  27. if (!ops->pin_config_set && !ops->pin_config_group_set) {
  28. dev_err(pctldev->dev,
  29. "pinconf has to be able to set a pins config\n");
  30. return -EINVAL;
  31. }
  32. return 0;
  33. }
  34. int pinconf_validate_map(const struct pinctrl_map *map, int i)
  35. {
  36. if (!map->data.configs.group_or_pin) {
  37. pr_err("failed to register map %s (%d): no group/pin given\n",
  38. map->name, i);
  39. return -EINVAL;
  40. }
  41. if (!map->data.configs.num_configs ||
  42. !map->data.configs.configs) {
  43. pr_err("failed to register map %s (%d): no configs given\n",
  44. map->name, i);
  45. return -EINVAL;
  46. }
  47. return 0;
  48. }
  49. int pin_config_get_for_pin(struct pinctrl_dev *pctldev, unsigned pin,
  50. unsigned long *config)
  51. {
  52. const struct pinconf_ops *ops = pctldev->desc->confops;
  53. if (!ops || !ops->pin_config_get) {
  54. dev_dbg(pctldev->dev,
  55. "cannot get pin configuration, .pin_config_get missing in driver\n");
  56. return -ENOTSUPP;
  57. }
  58. return ops->pin_config_get(pctldev, pin, config);
  59. }
  60. int pin_config_group_get(const char *dev_name, const char *pin_group,
  61. unsigned long *config)
  62. {
  63. struct pinctrl_dev *pctldev;
  64. const struct pinconf_ops *ops;
  65. int selector, ret;
  66. pctldev = get_pinctrl_dev_from_devname(dev_name);
  67. if (!pctldev) {
  68. ret = -EINVAL;
  69. return ret;
  70. }
  71. mutex_lock(&pctldev->mutex);
  72. ops = pctldev->desc->confops;
  73. if (!ops || !ops->pin_config_group_get) {
  74. dev_dbg(pctldev->dev,
  75. "cannot get configuration for pin group, missing group config get function in driver\n");
  76. ret = -ENOTSUPP;
  77. goto unlock;
  78. }
  79. selector = pinctrl_get_group_selector(pctldev, pin_group);
  80. if (selector < 0) {
  81. ret = selector;
  82. goto unlock;
  83. }
  84. ret = ops->pin_config_group_get(pctldev, selector, config);
  85. unlock:
  86. mutex_unlock(&pctldev->mutex);
  87. return ret;
  88. }
  89. int pinconf_map_to_setting(const struct pinctrl_map *map,
  90. struct pinctrl_setting *setting)
  91. {
  92. struct pinctrl_dev *pctldev = setting->pctldev;
  93. int pin;
  94. switch (setting->type) {
  95. case PIN_MAP_TYPE_CONFIGS_PIN:
  96. pin = pin_get_from_name(pctldev,
  97. map->data.configs.group_or_pin);
  98. if (pin < 0) {
  99. dev_err(pctldev->dev, "could not map pin config for \"%s\"",
  100. map->data.configs.group_or_pin);
  101. return pin;
  102. }
  103. setting->data.configs.group_or_pin = pin;
  104. break;
  105. case PIN_MAP_TYPE_CONFIGS_GROUP:
  106. pin = pinctrl_get_group_selector(pctldev,
  107. map->data.configs.group_or_pin);
  108. if (pin < 0) {
  109. dev_err(pctldev->dev, "could not map group config for \"%s\"",
  110. map->data.configs.group_or_pin);
  111. return pin;
  112. }
  113. setting->data.configs.group_or_pin = pin;
  114. break;
  115. default:
  116. return -EINVAL;
  117. }
  118. setting->data.configs.num_configs = map->data.configs.num_configs;
  119. setting->data.configs.configs = map->data.configs.configs;
  120. return 0;
  121. }
  122. void pinconf_free_setting(const struct pinctrl_setting *setting)
  123. {
  124. }
  125. int pinconf_apply_setting(const struct pinctrl_setting *setting)
  126. {
  127. struct pinctrl_dev *pctldev = setting->pctldev;
  128. const struct pinconf_ops *ops = pctldev->desc->confops;
  129. int ret;
  130. if (!ops) {
  131. dev_err(pctldev->dev, "missing confops\n");
  132. return -EINVAL;
  133. }
  134. switch (setting->type) {
  135. case PIN_MAP_TYPE_CONFIGS_PIN:
  136. if (!ops->pin_config_set) {
  137. dev_err(pctldev->dev, "missing pin_config_set op\n");
  138. return -EINVAL;
  139. }
  140. ret = ops->pin_config_set(pctldev,
  141. setting->data.configs.group_or_pin,
  142. setting->data.configs.configs,
  143. setting->data.configs.num_configs);
  144. if (ret < 0) {
  145. dev_err(pctldev->dev,
  146. "pin_config_set op failed for pin %d\n",
  147. setting->data.configs.group_or_pin);
  148. return ret;
  149. }
  150. break;
  151. case PIN_MAP_TYPE_CONFIGS_GROUP:
  152. if (!ops->pin_config_group_set) {
  153. dev_err(pctldev->dev,
  154. "missing pin_config_group_set op\n");
  155. return -EINVAL;
  156. }
  157. ret = ops->pin_config_group_set(pctldev,
  158. setting->data.configs.group_or_pin,
  159. setting->data.configs.configs,
  160. setting->data.configs.num_configs);
  161. if (ret < 0) {
  162. dev_err(pctldev->dev,
  163. "pin_config_group_set op failed for group %d\n",
  164. setting->data.configs.group_or_pin);
  165. return ret;
  166. }
  167. break;
  168. default:
  169. return -EINVAL;
  170. }
  171. return 0;
  172. }
  173. int pinconf_set_config(struct pinctrl_dev *pctldev, unsigned pin,
  174. unsigned long *configs, size_t nconfigs)
  175. {
  176. const struct pinconf_ops *ops;
  177. ops = pctldev->desc->confops;
  178. if (!ops || !ops->pin_config_set)
  179. return -ENOTSUPP;
  180. return ops->pin_config_set(pctldev, pin, configs, nconfigs);
  181. }
  182. #ifdef CONFIG_DEBUG_FS
  183. static void pinconf_show_config(struct seq_file *s, struct pinctrl_dev *pctldev,
  184. unsigned long *configs, unsigned num_configs)
  185. {
  186. const struct pinconf_ops *confops;
  187. int i;
  188. if (pctldev)
  189. confops = pctldev->desc->confops;
  190. else
  191. confops = NULL;
  192. for (i = 0; i < num_configs; i++) {
  193. seq_puts(s, "config ");
  194. if (confops && confops->pin_config_config_dbg_show)
  195. confops->pin_config_config_dbg_show(pctldev, s,
  196. configs[i]);
  197. else
  198. seq_printf(s, "%08lx", configs[i]);
  199. seq_putc(s, '\n');
  200. }
  201. }
  202. void pinconf_show_map(struct seq_file *s, const struct pinctrl_map *map)
  203. {
  204. struct pinctrl_dev *pctldev;
  205. pctldev = get_pinctrl_dev_from_devname(map->ctrl_dev_name);
  206. switch (map->type) {
  207. case PIN_MAP_TYPE_CONFIGS_PIN:
  208. seq_puts(s, "pin ");
  209. break;
  210. case PIN_MAP_TYPE_CONFIGS_GROUP:
  211. seq_puts(s, "group ");
  212. break;
  213. default:
  214. break;
  215. }
  216. seq_printf(s, "%s\n", map->data.configs.group_or_pin);
  217. pinconf_show_config(s, pctldev, map->data.configs.configs,
  218. map->data.configs.num_configs);
  219. }
  220. void pinconf_show_setting(struct seq_file *s,
  221. const struct pinctrl_setting *setting)
  222. {
  223. struct pinctrl_dev *pctldev = setting->pctldev;
  224. const struct pinctrl_ops *pctlops = pctldev->desc->pctlops;
  225. struct pin_desc *desc;
  226. switch (setting->type) {
  227. case PIN_MAP_TYPE_CONFIGS_PIN:
  228. desc = pin_desc_get(setting->pctldev,
  229. setting->data.configs.group_or_pin);
  230. seq_printf(s, "pin %s (%d)", desc->name,
  231. setting->data.configs.group_or_pin);
  232. break;
  233. case PIN_MAP_TYPE_CONFIGS_GROUP:
  234. seq_printf(s, "group %s (%d)",
  235. pctlops->get_group_name(pctldev,
  236. setting->data.configs.group_or_pin),
  237. setting->data.configs.group_or_pin);
  238. break;
  239. default:
  240. break;
  241. }
  242. /*
  243. * FIXME: We should really get the pin controller to dump the config
  244. * values, so they can be decoded to something meaningful.
  245. */
  246. pinconf_show_config(s, pctldev, setting->data.configs.configs,
  247. setting->data.configs.num_configs);
  248. }
  249. static void pinconf_dump_pin(struct pinctrl_dev *pctldev,
  250. struct seq_file *s, int pin)
  251. {
  252. const struct pinconf_ops *ops = pctldev->desc->confops;
  253. /* no-op when not using generic pin config */
  254. pinconf_generic_dump_pins(pctldev, s, NULL, pin);
  255. if (ops && ops->pin_config_dbg_show)
  256. ops->pin_config_dbg_show(pctldev, s, pin);
  257. }
  258. static int pinconf_pins_show(struct seq_file *s, void *what)
  259. {
  260. struct pinctrl_dev *pctldev = s->private;
  261. unsigned i, pin;
  262. seq_puts(s, "Pin config settings per pin\n");
  263. seq_puts(s, "Format: pin (name): configs\n");
  264. mutex_lock(&pctldev->mutex);
  265. /* The pin number can be retrived from the pin controller descriptor */
  266. for (i = 0; i < pctldev->desc->npins; i++) {
  267. struct pin_desc *desc;
  268. pin = pctldev->desc->pins[i].number;
  269. desc = pin_desc_get(pctldev, pin);
  270. /* Skip if we cannot search the pin */
  271. if (!desc)
  272. continue;
  273. seq_printf(s, "pin %d (%s): ", pin, desc->name);
  274. pinconf_dump_pin(pctldev, s, pin);
  275. seq_putc(s, '\n');
  276. }
  277. mutex_unlock(&pctldev->mutex);
  278. return 0;
  279. }
  280. static void pinconf_dump_group(struct pinctrl_dev *pctldev,
  281. struct seq_file *s, unsigned selector,
  282. const char *gname)
  283. {
  284. const struct pinconf_ops *ops = pctldev->desc->confops;
  285. /* no-op when not using generic pin config */
  286. pinconf_generic_dump_pins(pctldev, s, gname, 0);
  287. if (ops && ops->pin_config_group_dbg_show)
  288. ops->pin_config_group_dbg_show(pctldev, s, selector);
  289. }
  290. static int pinconf_groups_show(struct seq_file *s, void *what)
  291. {
  292. struct pinctrl_dev *pctldev = s->private;
  293. const struct pinctrl_ops *pctlops = pctldev->desc->pctlops;
  294. unsigned ngroups = pctlops->get_groups_count(pctldev);
  295. unsigned selector = 0;
  296. seq_puts(s, "Pin config settings per pin group\n");
  297. seq_puts(s, "Format: group (name): configs\n");
  298. while (selector < ngroups) {
  299. const char *gname = pctlops->get_group_name(pctldev, selector);
  300. seq_printf(s, "%u (%s): ", selector, gname);
  301. pinconf_dump_group(pctldev, s, selector, gname);
  302. seq_putc(s, '\n');
  303. selector++;
  304. }
  305. return 0;
  306. }
  307. DEFINE_SHOW_ATTRIBUTE(pinconf_pins);
  308. DEFINE_SHOW_ATTRIBUTE(pinconf_groups);
  309. void pinconf_init_device_debugfs(struct dentry *devroot,
  310. struct pinctrl_dev *pctldev)
  311. {
  312. debugfs_create_file("pinconf-pins", S_IFREG | S_IRUGO,
  313. devroot, pctldev, &pinconf_pins_fops);
  314. debugfs_create_file("pinconf-groups", S_IFREG | S_IRUGO,
  315. devroot, pctldev, &pinconf_groups_fops);
  316. }
  317. #endif