led-class.c 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552
  1. // SPDX-License-Identifier: GPL-2.0-only
  2. /*
  3. * LED Class Core
  4. *
  5. * Copyright (C) 2005 John Lenz <[email protected]>
  6. * Copyright (C) 2005-2007 Richard Purdie <[email protected]>
  7. */
  8. #include <linux/ctype.h>
  9. #include <linux/device.h>
  10. #include <linux/err.h>
  11. #include <linux/init.h>
  12. #include <linux/kernel.h>
  13. #include <linux/leds.h>
  14. #include <linux/list.h>
  15. #include <linux/module.h>
  16. #include <linux/property.h>
  17. #include <linux/slab.h>
  18. #include <linux/spinlock.h>
  19. #include <linux/timer.h>
  20. #include <uapi/linux/uleds.h>
  21. #include <linux/of.h>
  22. #include "leds.h"
  23. static struct class *leds_class;
  24. static ssize_t brightness_show(struct device *dev,
  25. struct device_attribute *attr, char *buf)
  26. {
  27. struct led_classdev *led_cdev = dev_get_drvdata(dev);
  28. /* no lock needed for this */
  29. led_update_brightness(led_cdev);
  30. return sprintf(buf, "%u\n", led_cdev->brightness);
  31. }
  32. static ssize_t brightness_store(struct device *dev,
  33. struct device_attribute *attr, const char *buf, size_t size)
  34. {
  35. struct led_classdev *led_cdev = dev_get_drvdata(dev);
  36. unsigned long state;
  37. ssize_t ret;
  38. mutex_lock(&led_cdev->led_access);
  39. if (led_sysfs_is_disabled(led_cdev)) {
  40. ret = -EBUSY;
  41. goto unlock;
  42. }
  43. ret = kstrtoul(buf, 10, &state);
  44. if (ret)
  45. goto unlock;
  46. if (state == LED_OFF)
  47. led_trigger_remove(led_cdev);
  48. led_set_brightness(led_cdev, state);
  49. flush_work(&led_cdev->set_brightness_work);
  50. ret = size;
  51. unlock:
  52. mutex_unlock(&led_cdev->led_access);
  53. return ret;
  54. }
  55. static DEVICE_ATTR_RW(brightness);
  56. static ssize_t max_brightness_show(struct device *dev,
  57. struct device_attribute *attr, char *buf)
  58. {
  59. struct led_classdev *led_cdev = dev_get_drvdata(dev);
  60. return sprintf(buf, "%u\n", led_cdev->max_brightness);
  61. }
  62. static DEVICE_ATTR_RO(max_brightness);
  63. #ifdef CONFIG_LEDS_TRIGGERS
  64. static BIN_ATTR(trigger, 0644, led_trigger_read, led_trigger_write, 0);
  65. static struct bin_attribute *led_trigger_bin_attrs[] = {
  66. &bin_attr_trigger,
  67. NULL,
  68. };
  69. static const struct attribute_group led_trigger_group = {
  70. .bin_attrs = led_trigger_bin_attrs,
  71. };
  72. #endif
  73. static struct attribute *led_class_attrs[] = {
  74. &dev_attr_brightness.attr,
  75. &dev_attr_max_brightness.attr,
  76. NULL,
  77. };
  78. static const struct attribute_group led_group = {
  79. .attrs = led_class_attrs,
  80. };
  81. static const struct attribute_group *led_groups[] = {
  82. &led_group,
  83. #ifdef CONFIG_LEDS_TRIGGERS
  84. &led_trigger_group,
  85. #endif
  86. NULL,
  87. };
  88. #ifdef CONFIG_LEDS_BRIGHTNESS_HW_CHANGED
  89. static ssize_t brightness_hw_changed_show(struct device *dev,
  90. struct device_attribute *attr, char *buf)
  91. {
  92. struct led_classdev *led_cdev = dev_get_drvdata(dev);
  93. if (led_cdev->brightness_hw_changed == -1)
  94. return -ENODATA;
  95. return sprintf(buf, "%u\n", led_cdev->brightness_hw_changed);
  96. }
  97. static DEVICE_ATTR_RO(brightness_hw_changed);
  98. static int led_add_brightness_hw_changed(struct led_classdev *led_cdev)
  99. {
  100. struct device *dev = led_cdev->dev;
  101. int ret;
  102. ret = device_create_file(dev, &dev_attr_brightness_hw_changed);
  103. if (ret) {
  104. dev_err(dev, "Error creating brightness_hw_changed\n");
  105. return ret;
  106. }
  107. led_cdev->brightness_hw_changed_kn =
  108. sysfs_get_dirent(dev->kobj.sd, "brightness_hw_changed");
  109. if (!led_cdev->brightness_hw_changed_kn) {
  110. dev_err(dev, "Error getting brightness_hw_changed kn\n");
  111. device_remove_file(dev, &dev_attr_brightness_hw_changed);
  112. return -ENXIO;
  113. }
  114. return 0;
  115. }
  116. static void led_remove_brightness_hw_changed(struct led_classdev *led_cdev)
  117. {
  118. sysfs_put(led_cdev->brightness_hw_changed_kn);
  119. device_remove_file(led_cdev->dev, &dev_attr_brightness_hw_changed);
  120. }
  121. void led_classdev_notify_brightness_hw_changed(struct led_classdev *led_cdev, unsigned int brightness)
  122. {
  123. if (WARN_ON(!led_cdev->brightness_hw_changed_kn))
  124. return;
  125. led_cdev->brightness_hw_changed = brightness;
  126. sysfs_notify_dirent(led_cdev->brightness_hw_changed_kn);
  127. }
  128. EXPORT_SYMBOL_GPL(led_classdev_notify_brightness_hw_changed);
  129. #else
  130. static int led_add_brightness_hw_changed(struct led_classdev *led_cdev)
  131. {
  132. return 0;
  133. }
  134. static void led_remove_brightness_hw_changed(struct led_classdev *led_cdev)
  135. {
  136. }
  137. #endif
  138. /**
  139. * led_classdev_suspend - suspend an led_classdev.
  140. * @led_cdev: the led_classdev to suspend.
  141. */
  142. void led_classdev_suspend(struct led_classdev *led_cdev)
  143. {
  144. led_cdev->flags |= LED_SUSPENDED;
  145. led_set_brightness_nopm(led_cdev, 0);
  146. flush_work(&led_cdev->set_brightness_work);
  147. }
  148. EXPORT_SYMBOL_GPL(led_classdev_suspend);
  149. /**
  150. * led_classdev_resume - resume an led_classdev.
  151. * @led_cdev: the led_classdev to resume.
  152. */
  153. void led_classdev_resume(struct led_classdev *led_cdev)
  154. {
  155. led_set_brightness_nopm(led_cdev, led_cdev->brightness);
  156. if (led_cdev->flash_resume)
  157. led_cdev->flash_resume(led_cdev);
  158. led_cdev->flags &= ~LED_SUSPENDED;
  159. }
  160. EXPORT_SYMBOL_GPL(led_classdev_resume);
  161. #ifdef CONFIG_PM_SLEEP
  162. static int led_suspend(struct device *dev)
  163. {
  164. struct led_classdev *led_cdev = dev_get_drvdata(dev);
  165. if (led_cdev->flags & LED_CORE_SUSPENDRESUME)
  166. led_classdev_suspend(led_cdev);
  167. return 0;
  168. }
  169. static int led_resume(struct device *dev)
  170. {
  171. struct led_classdev *led_cdev = dev_get_drvdata(dev);
  172. if (led_cdev->flags & LED_CORE_SUSPENDRESUME)
  173. led_classdev_resume(led_cdev);
  174. return 0;
  175. }
  176. #endif
  177. static SIMPLE_DEV_PM_OPS(leds_class_dev_pm_ops, led_suspend, led_resume);
  178. /**
  179. * of_led_get() - request a LED device via the LED framework
  180. * @np: device node to get the LED device from
  181. * @index: the index of the LED
  182. *
  183. * Returns the LED device parsed from the phandle specified in the "leds"
  184. * property of a device tree node or a negative error-code on failure.
  185. */
  186. struct led_classdev *of_led_get(struct device_node *np, int index)
  187. {
  188. struct device *led_dev;
  189. struct led_classdev *led_cdev;
  190. struct device_node *led_node;
  191. led_node = of_parse_phandle(np, "leds", index);
  192. if (!led_node)
  193. return ERR_PTR(-ENOENT);
  194. led_dev = class_find_device_by_of_node(leds_class, led_node);
  195. of_node_put(led_node);
  196. put_device(led_dev);
  197. if (!led_dev)
  198. return ERR_PTR(-EPROBE_DEFER);
  199. led_cdev = dev_get_drvdata(led_dev);
  200. if (!try_module_get(led_cdev->dev->parent->driver->owner)) {
  201. put_device(led_cdev->dev);
  202. return ERR_PTR(-ENODEV);
  203. }
  204. return led_cdev;
  205. }
  206. EXPORT_SYMBOL_GPL(of_led_get);
  207. /**
  208. * led_put() - release a LED device
  209. * @led_cdev: LED device
  210. */
  211. void led_put(struct led_classdev *led_cdev)
  212. {
  213. module_put(led_cdev->dev->parent->driver->owner);
  214. put_device(led_cdev->dev);
  215. }
  216. EXPORT_SYMBOL_GPL(led_put);
  217. static void devm_led_release(struct device *dev, void *res)
  218. {
  219. struct led_classdev **p = res;
  220. led_put(*p);
  221. }
  222. /**
  223. * devm_of_led_get - Resource-managed request of a LED device
  224. * @dev: LED consumer
  225. * @index: index of the LED to obtain in the consumer
  226. *
  227. * The device node of the device is parse to find the request LED device.
  228. * The LED device returned from this function is automatically released
  229. * on driver detach.
  230. *
  231. * @return a pointer to a LED device or ERR_PTR(errno) on failure.
  232. */
  233. struct led_classdev *__must_check devm_of_led_get(struct device *dev,
  234. int index)
  235. {
  236. struct led_classdev *led;
  237. struct led_classdev **dr;
  238. if (!dev)
  239. return ERR_PTR(-EINVAL);
  240. led = of_led_get(dev->of_node, index);
  241. if (IS_ERR(led))
  242. return led;
  243. dr = devres_alloc(devm_led_release, sizeof(struct led_classdev *),
  244. GFP_KERNEL);
  245. if (!dr) {
  246. led_put(led);
  247. return ERR_PTR(-ENOMEM);
  248. }
  249. *dr = led;
  250. devres_add(dev, dr);
  251. return led;
  252. }
  253. EXPORT_SYMBOL_GPL(devm_of_led_get);
  254. static int led_classdev_next_name(const char *init_name, char *name,
  255. size_t len)
  256. {
  257. unsigned int i = 0;
  258. int ret = 0;
  259. struct device *dev;
  260. strlcpy(name, init_name, len);
  261. while ((ret < len) &&
  262. (dev = class_find_device_by_name(leds_class, name))) {
  263. put_device(dev);
  264. ret = snprintf(name, len, "%s_%u", init_name, ++i);
  265. }
  266. if (ret >= len)
  267. return -ENOMEM;
  268. return i;
  269. }
  270. /**
  271. * led_classdev_register_ext - register a new object of led_classdev class
  272. * with init data.
  273. *
  274. * @parent: parent of LED device
  275. * @led_cdev: the led_classdev structure for this device.
  276. * @init_data: LED class device initialization data
  277. */
  278. int led_classdev_register_ext(struct device *parent,
  279. struct led_classdev *led_cdev,
  280. struct led_init_data *init_data)
  281. {
  282. char composed_name[LED_MAX_NAME_SIZE];
  283. char final_name[LED_MAX_NAME_SIZE];
  284. const char *proposed_name = composed_name;
  285. int ret;
  286. if (init_data) {
  287. if (init_data->devname_mandatory && !init_data->devicename) {
  288. dev_err(parent, "Mandatory device name is missing");
  289. return -EINVAL;
  290. }
  291. ret = led_compose_name(parent, init_data, composed_name);
  292. if (ret < 0)
  293. return ret;
  294. if (init_data->fwnode) {
  295. fwnode_property_read_string(init_data->fwnode,
  296. "linux,default-trigger",
  297. &led_cdev->default_trigger);
  298. if (fwnode_property_present(init_data->fwnode,
  299. "retain-state-shutdown"))
  300. led_cdev->flags |= LED_RETAIN_AT_SHUTDOWN;
  301. }
  302. } else {
  303. proposed_name = led_cdev->name;
  304. }
  305. ret = led_classdev_next_name(proposed_name, final_name, sizeof(final_name));
  306. if (ret < 0)
  307. return ret;
  308. mutex_init(&led_cdev->led_access);
  309. mutex_lock(&led_cdev->led_access);
  310. led_cdev->dev = device_create_with_groups(leds_class, parent, 0,
  311. led_cdev, led_cdev->groups, "%s", final_name);
  312. if (IS_ERR(led_cdev->dev)) {
  313. mutex_unlock(&led_cdev->led_access);
  314. return PTR_ERR(led_cdev->dev);
  315. }
  316. if (init_data && init_data->fwnode)
  317. device_set_node(led_cdev->dev, init_data->fwnode);
  318. if (ret)
  319. dev_warn(parent, "Led %s renamed to %s due to name collision",
  320. proposed_name, dev_name(led_cdev->dev));
  321. if (led_cdev->flags & LED_BRIGHT_HW_CHANGED) {
  322. ret = led_add_brightness_hw_changed(led_cdev);
  323. if (ret) {
  324. device_unregister(led_cdev->dev);
  325. led_cdev->dev = NULL;
  326. mutex_unlock(&led_cdev->led_access);
  327. return ret;
  328. }
  329. }
  330. led_cdev->work_flags = 0;
  331. #ifdef CONFIG_LEDS_TRIGGERS
  332. init_rwsem(&led_cdev->trigger_lock);
  333. #endif
  334. #ifdef CONFIG_LEDS_BRIGHTNESS_HW_CHANGED
  335. led_cdev->brightness_hw_changed = -1;
  336. #endif
  337. /* add to the list of leds */
  338. down_write(&leds_list_lock);
  339. list_add_tail(&led_cdev->node, &leds_list);
  340. up_write(&leds_list_lock);
  341. if (!led_cdev->max_brightness)
  342. led_cdev->max_brightness = LED_FULL;
  343. led_update_brightness(led_cdev);
  344. led_init_core(led_cdev);
  345. #ifdef CONFIG_LEDS_TRIGGERS
  346. led_trigger_set_default(led_cdev);
  347. #endif
  348. mutex_unlock(&led_cdev->led_access);
  349. dev_dbg(parent, "Registered led device: %s\n",
  350. led_cdev->name);
  351. return 0;
  352. }
  353. EXPORT_SYMBOL_GPL(led_classdev_register_ext);
  354. /**
  355. * led_classdev_unregister - unregisters a object of led_properties class.
  356. * @led_cdev: the led device to unregister
  357. *
  358. * Unregisters a previously registered via led_classdev_register object.
  359. */
  360. void led_classdev_unregister(struct led_classdev *led_cdev)
  361. {
  362. if (IS_ERR_OR_NULL(led_cdev->dev))
  363. return;
  364. #ifdef CONFIG_LEDS_TRIGGERS
  365. down_write(&led_cdev->trigger_lock);
  366. if (led_cdev->trigger)
  367. led_trigger_set(led_cdev, NULL);
  368. up_write(&led_cdev->trigger_lock);
  369. #endif
  370. led_cdev->flags |= LED_UNREGISTERING;
  371. /* Stop blinking */
  372. led_stop_software_blink(led_cdev);
  373. if (!(led_cdev->flags & LED_RETAIN_AT_SHUTDOWN))
  374. led_set_brightness(led_cdev, LED_OFF);
  375. flush_work(&led_cdev->set_brightness_work);
  376. if (led_cdev->flags & LED_BRIGHT_HW_CHANGED)
  377. led_remove_brightness_hw_changed(led_cdev);
  378. device_unregister(led_cdev->dev);
  379. down_write(&leds_list_lock);
  380. list_del(&led_cdev->node);
  381. up_write(&leds_list_lock);
  382. mutex_destroy(&led_cdev->led_access);
  383. }
  384. EXPORT_SYMBOL_GPL(led_classdev_unregister);
  385. static void devm_led_classdev_release(struct device *dev, void *res)
  386. {
  387. led_classdev_unregister(*(struct led_classdev **)res);
  388. }
  389. /**
  390. * devm_led_classdev_register_ext - resource managed led_classdev_register_ext()
  391. *
  392. * @parent: parent of LED device
  393. * @led_cdev: the led_classdev structure for this device.
  394. * @init_data: LED class device initialization data
  395. */
  396. int devm_led_classdev_register_ext(struct device *parent,
  397. struct led_classdev *led_cdev,
  398. struct led_init_data *init_data)
  399. {
  400. struct led_classdev **dr;
  401. int rc;
  402. dr = devres_alloc(devm_led_classdev_release, sizeof(*dr), GFP_KERNEL);
  403. if (!dr)
  404. return -ENOMEM;
  405. rc = led_classdev_register_ext(parent, led_cdev, init_data);
  406. if (rc) {
  407. devres_free(dr);
  408. return rc;
  409. }
  410. *dr = led_cdev;
  411. devres_add(parent, dr);
  412. return 0;
  413. }
  414. EXPORT_SYMBOL_GPL(devm_led_classdev_register_ext);
  415. static int devm_led_classdev_match(struct device *dev, void *res, void *data)
  416. {
  417. struct led_classdev **p = res;
  418. if (WARN_ON(!p || !*p))
  419. return 0;
  420. return *p == data;
  421. }
  422. /**
  423. * devm_led_classdev_unregister() - resource managed led_classdev_unregister()
  424. * @dev: The device to unregister.
  425. * @led_cdev: the led_classdev structure for this device.
  426. */
  427. void devm_led_classdev_unregister(struct device *dev,
  428. struct led_classdev *led_cdev)
  429. {
  430. WARN_ON(devres_release(dev,
  431. devm_led_classdev_release,
  432. devm_led_classdev_match, led_cdev));
  433. }
  434. EXPORT_SYMBOL_GPL(devm_led_classdev_unregister);
  435. static int __init leds_init(void)
  436. {
  437. leds_class = class_create(THIS_MODULE, "leds");
  438. if (IS_ERR(leds_class))
  439. return PTR_ERR(leds_class);
  440. leds_class->pm = &leds_class_dev_pm_ops;
  441. leds_class->dev_groups = led_groups;
  442. return 0;
  443. }
  444. static void __exit leds_exit(void)
  445. {
  446. class_destroy(leds_class);
  447. }
  448. subsys_initcall(leds_init);
  449. module_exit(leds_exit);
  450. MODULE_AUTHOR("John Lenz, Richard Purdie");
  451. MODULE_LICENSE("GPL");
  452. MODULE_DESCRIPTION("LED Class Interface");