Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | /* |
| 2 | * Backlight Lowlevel Control Abstraction |
| 3 | * |
| 4 | * Copyright (C) 2003,2004 Hewlett-Packard Company |
| 5 | * |
| 6 | */ |
| 7 | |
Jingoo Han | 35f9616 | 2012-05-29 15:07:16 -0700 | [diff] [blame] | 8 | #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt |
| 9 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 10 | #include <linux/module.h> |
| 11 | #include <linux/init.h> |
| 12 | #include <linux/device.h> |
| 13 | #include <linux/backlight.h> |
| 14 | #include <linux/notifier.h> |
| 15 | #include <linux/ctype.h> |
| 16 | #include <linux/err.h> |
| 17 | #include <linux/fb.h> |
Tejun Heo | 5a0e3ad | 2010-03-24 17:04:11 +0900 | [diff] [blame] | 18 | #include <linux/slab.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 19 | |
Richard Purdie | 321709c | 2007-02-10 15:04:08 +0000 | [diff] [blame] | 20 | #ifdef CONFIG_PMAC_BACKLIGHT |
| 21 | #include <asm/backlight.h> |
| 22 | #endif |
James Simmons | 3d5eead | 2006-12-08 02:40:47 -0800 | [diff] [blame] | 23 | |
Bart Van Assche | c338bfb | 2011-09-10 20:13:01 +0200 | [diff] [blame] | 24 | static const char *const backlight_types[] = { |
Matthew Garrett | bb7ca74 | 2011-03-22 16:30:21 -0700 | [diff] [blame] | 25 | [BACKLIGHT_RAW] = "raw", |
| 26 | [BACKLIGHT_PLATFORM] = "platform", |
| 27 | [BACKLIGHT_FIRMWARE] = "firmware", |
| 28 | }; |
| 29 | |
James Simmons | 3d5eead | 2006-12-08 02:40:47 -0800 | [diff] [blame] | 30 | #if defined(CONFIG_FB) || (defined(CONFIG_FB_MODULE) && \ |
| 31 | defined(CONFIG_BACKLIGHT_CLASS_DEVICE_MODULE)) |
| 32 | /* This callback gets called when something important happens inside a |
| 33 | * framebuffer driver. We're looking if that important event is blanking, |
| 34 | * and if it is, we're switching backlight power as well ... |
| 35 | */ |
| 36 | static int fb_notifier_callback(struct notifier_block *self, |
| 37 | unsigned long event, void *data) |
| 38 | { |
| 39 | struct backlight_device *bd; |
| 40 | struct fb_event *evdata = data; |
| 41 | |
| 42 | /* If we aren't interested in this event, skip it immediately ... */ |
Richard Purdie | 994efac | 2007-02-09 09:46:45 +0000 | [diff] [blame] | 43 | if (event != FB_EVENT_BLANK && event != FB_EVENT_CONBLANK) |
James Simmons | 3d5eead | 2006-12-08 02:40:47 -0800 | [diff] [blame] | 44 | return 0; |
| 45 | |
| 46 | bd = container_of(self, struct backlight_device, fb_notif); |
Richard Purdie | 599a52d | 2007-02-10 23:07:48 +0000 | [diff] [blame] | 47 | mutex_lock(&bd->ops_lock); |
| 48 | if (bd->ops) |
| 49 | if (!bd->ops->check_fb || |
Bruno Prémont | 57e148b | 2010-02-21 00:20:01 +0100 | [diff] [blame] | 50 | bd->ops->check_fb(bd, evdata->info)) { |
Richard Purdie | 599a52d | 2007-02-10 23:07:48 +0000 | [diff] [blame] | 51 | bd->props.fb_blank = *(int *)evdata->data; |
Richard Purdie | c835ee7 | 2009-01-06 21:00:19 +0000 | [diff] [blame] | 52 | if (bd->props.fb_blank == FB_BLANK_UNBLANK) |
| 53 | bd->props.state &= ~BL_CORE_FBBLANK; |
| 54 | else |
| 55 | bd->props.state |= BL_CORE_FBBLANK; |
Richard Purdie | 28ee086 | 2007-02-08 22:25:09 +0000 | [diff] [blame] | 56 | backlight_update_status(bd); |
James Simmons | 3d5eead | 2006-12-08 02:40:47 -0800 | [diff] [blame] | 57 | } |
Richard Purdie | 599a52d | 2007-02-10 23:07:48 +0000 | [diff] [blame] | 58 | mutex_unlock(&bd->ops_lock); |
James Simmons | 3d5eead | 2006-12-08 02:40:47 -0800 | [diff] [blame] | 59 | return 0; |
| 60 | } |
| 61 | |
| 62 | static int backlight_register_fb(struct backlight_device *bd) |
| 63 | { |
| 64 | memset(&bd->fb_notif, 0, sizeof(bd->fb_notif)); |
| 65 | bd->fb_notif.notifier_call = fb_notifier_callback; |
| 66 | |
| 67 | return fb_register_client(&bd->fb_notif); |
| 68 | } |
| 69 | |
| 70 | static void backlight_unregister_fb(struct backlight_device *bd) |
| 71 | { |
| 72 | fb_unregister_client(&bd->fb_notif); |
| 73 | } |
| 74 | #else |
| 75 | static inline int backlight_register_fb(struct backlight_device *bd) |
| 76 | { |
| 77 | return 0; |
| 78 | } |
| 79 | |
| 80 | static inline void backlight_unregister_fb(struct backlight_device *bd) |
| 81 | { |
| 82 | } |
| 83 | #endif /* CONFIG_FB */ |
| 84 | |
Matthew Garrett | 325253a | 2009-07-14 17:06:02 +0100 | [diff] [blame] | 85 | static void backlight_generate_event(struct backlight_device *bd, |
| 86 | enum backlight_update_reason reason) |
| 87 | { |
| 88 | char *envp[2]; |
| 89 | |
| 90 | switch (reason) { |
| 91 | case BACKLIGHT_UPDATE_SYSFS: |
| 92 | envp[0] = "SOURCE=sysfs"; |
| 93 | break; |
| 94 | case BACKLIGHT_UPDATE_HOTKEY: |
| 95 | envp[0] = "SOURCE=hotkey"; |
| 96 | break; |
| 97 | default: |
| 98 | envp[0] = "SOURCE=unknown"; |
| 99 | break; |
| 100 | } |
| 101 | envp[1] = NULL; |
| 102 | kobject_uevent_env(&bd->dev.kobj, KOBJ_CHANGE, envp); |
Henrique de Moraes Holschuh | 89dfc28 | 2009-09-20 14:44:47 -0300 | [diff] [blame] | 103 | sysfs_notify(&bd->dev.kobj, NULL, "actual_brightness"); |
Matthew Garrett | 325253a | 2009-07-14 17:06:02 +0100 | [diff] [blame] | 104 | } |
| 105 | |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 106 | static ssize_t backlight_show_power(struct device *dev, |
Jingoo Han | 6665576 | 2012-01-10 15:09:19 -0800 | [diff] [blame] | 107 | struct device_attribute *attr, char *buf) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 108 | { |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 109 | struct backlight_device *bd = to_backlight_device(dev); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 110 | |
Richard Purdie | 599a52d | 2007-02-10 23:07:48 +0000 | [diff] [blame] | 111 | return sprintf(buf, "%d\n", bd->props.power); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 112 | } |
| 113 | |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 114 | static ssize_t backlight_store_power(struct device *dev, |
| 115 | struct device_attribute *attr, const char *buf, size_t count) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 116 | { |
Pavel Machek | 9a2c61a | 2008-12-03 08:43:48 +0000 | [diff] [blame] | 117 | int rc; |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 118 | struct backlight_device *bd = to_backlight_device(dev); |
Pavel Machek | 9a2c61a | 2008-12-03 08:43:48 +0000 | [diff] [blame] | 119 | unsigned long power; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 120 | |
Jingoo Han | 6665576 | 2012-01-10 15:09:19 -0800 | [diff] [blame] | 121 | rc = kstrtoul(buf, 0, &power); |
Pavel Machek | 9a2c61a | 2008-12-03 08:43:48 +0000 | [diff] [blame] | 122 | if (rc) |
| 123 | return rc; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 124 | |
Pavel Machek | 9a2c61a | 2008-12-03 08:43:48 +0000 | [diff] [blame] | 125 | rc = -ENXIO; |
Richard Purdie | 599a52d | 2007-02-10 23:07:48 +0000 | [diff] [blame] | 126 | mutex_lock(&bd->ops_lock); |
| 127 | if (bd->ops) { |
Jingoo Han | 35f9616 | 2012-05-29 15:07:16 -0700 | [diff] [blame] | 128 | pr_debug("set power to %lu\n", power); |
Helge Deller | 5155245 | 2008-01-13 23:01:13 +0000 | [diff] [blame] | 129 | if (bd->props.power != power) { |
| 130 | bd->props.power = power; |
| 131 | backlight_update_status(bd); |
| 132 | } |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 133 | rc = count; |
Richard Purdie | 6ca0176 | 2006-03-31 02:31:49 -0800 | [diff] [blame] | 134 | } |
Richard Purdie | 599a52d | 2007-02-10 23:07:48 +0000 | [diff] [blame] | 135 | mutex_unlock(&bd->ops_lock); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 136 | |
| 137 | return rc; |
| 138 | } |
| 139 | |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 140 | static ssize_t backlight_show_brightness(struct device *dev, |
| 141 | struct device_attribute *attr, char *buf) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 142 | { |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 143 | struct backlight_device *bd = to_backlight_device(dev); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 144 | |
Richard Purdie | 599a52d | 2007-02-10 23:07:48 +0000 | [diff] [blame] | 145 | return sprintf(buf, "%d\n", bd->props.brightness); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 146 | } |
| 147 | |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 148 | static ssize_t backlight_store_brightness(struct device *dev, |
| 149 | struct device_attribute *attr, const char *buf, size_t count) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 150 | { |
Pavel Machek | 9a2c61a | 2008-12-03 08:43:48 +0000 | [diff] [blame] | 151 | int rc; |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 152 | struct backlight_device *bd = to_backlight_device(dev); |
Pavel Machek | 9a2c61a | 2008-12-03 08:43:48 +0000 | [diff] [blame] | 153 | unsigned long brightness; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 154 | |
Jingoo Han | 6665576 | 2012-01-10 15:09:19 -0800 | [diff] [blame] | 155 | rc = kstrtoul(buf, 0, &brightness); |
Pavel Machek | 9a2c61a | 2008-12-03 08:43:48 +0000 | [diff] [blame] | 156 | if (rc) |
| 157 | return rc; |
| 158 | |
| 159 | rc = -ENXIO; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 160 | |
Richard Purdie | 599a52d | 2007-02-10 23:07:48 +0000 | [diff] [blame] | 161 | mutex_lock(&bd->ops_lock); |
| 162 | if (bd->ops) { |
| 163 | if (brightness > bd->props.max_brightness) |
Richard Purdie | 6ca0176 | 2006-03-31 02:31:49 -0800 | [diff] [blame] | 164 | rc = -EINVAL; |
| 165 | else { |
Jingoo Han | 35f9616 | 2012-05-29 15:07:16 -0700 | [diff] [blame] | 166 | pr_debug("set brightness to %lu\n", brightness); |
Zhang Rui | 9be1df9 | 2009-01-08 14:11:30 +0000 | [diff] [blame] | 167 | bd->props.brightness = brightness; |
| 168 | backlight_update_status(bd); |
Richard Purdie | 6ca0176 | 2006-03-31 02:31:49 -0800 | [diff] [blame] | 169 | rc = count; |
| 170 | } |
| 171 | } |
Richard Purdie | 599a52d | 2007-02-10 23:07:48 +0000 | [diff] [blame] | 172 | mutex_unlock(&bd->ops_lock); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 173 | |
Matthew Garrett | 325253a | 2009-07-14 17:06:02 +0100 | [diff] [blame] | 174 | backlight_generate_event(bd, BACKLIGHT_UPDATE_SYSFS); |
| 175 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 176 | return rc; |
| 177 | } |
| 178 | |
Matthew Garrett | bb7ca74 | 2011-03-22 16:30:21 -0700 | [diff] [blame] | 179 | static ssize_t backlight_show_type(struct device *dev, |
| 180 | struct device_attribute *attr, char *buf) |
| 181 | { |
| 182 | struct backlight_device *bd = to_backlight_device(dev); |
| 183 | |
| 184 | return sprintf(buf, "%s\n", backlight_types[bd->props.type]); |
| 185 | } |
| 186 | |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 187 | static ssize_t backlight_show_max_brightness(struct device *dev, |
| 188 | struct device_attribute *attr, char *buf) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 189 | { |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 190 | struct backlight_device *bd = to_backlight_device(dev); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 191 | |
Richard Purdie | 599a52d | 2007-02-10 23:07:48 +0000 | [diff] [blame] | 192 | return sprintf(buf, "%d\n", bd->props.max_brightness); |
Richard Purdie | 6ca0176 | 2006-03-31 02:31:49 -0800 | [diff] [blame] | 193 | } |
| 194 | |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 195 | static ssize_t backlight_show_actual_brightness(struct device *dev, |
| 196 | struct device_attribute *attr, char *buf) |
Richard Purdie | 6ca0176 | 2006-03-31 02:31:49 -0800 | [diff] [blame] | 197 | { |
| 198 | int rc = -ENXIO; |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 199 | struct backlight_device *bd = to_backlight_device(dev); |
Richard Purdie | 6ca0176 | 2006-03-31 02:31:49 -0800 | [diff] [blame] | 200 | |
Richard Purdie | 599a52d | 2007-02-10 23:07:48 +0000 | [diff] [blame] | 201 | mutex_lock(&bd->ops_lock); |
| 202 | if (bd->ops && bd->ops->get_brightness) |
| 203 | rc = sprintf(buf, "%d\n", bd->ops->get_brightness(bd)); |
| 204 | mutex_unlock(&bd->ops_lock); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 205 | |
| 206 | return rc; |
| 207 | } |
| 208 | |
Adrian Bunk | 0ad90ef | 2007-08-11 10:27:19 +0100 | [diff] [blame] | 209 | static struct class *backlight_class; |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 210 | |
Shuah Khan | 3601792 | 2013-07-03 15:05:16 -0700 | [diff] [blame^] | 211 | #ifdef CONFIG_PM_SLEEP |
| 212 | static int backlight_suspend(struct device *dev) |
Richard Purdie | c835ee7 | 2009-01-06 21:00:19 +0000 | [diff] [blame] | 213 | { |
| 214 | struct backlight_device *bd = to_backlight_device(dev); |
| 215 | |
Uwe Kleine-König | d1d7357 | 2010-11-24 12:57:14 -0800 | [diff] [blame] | 216 | mutex_lock(&bd->ops_lock); |
| 217 | if (bd->ops && bd->ops->options & BL_CORE_SUSPENDRESUME) { |
Richard Purdie | c835ee7 | 2009-01-06 21:00:19 +0000 | [diff] [blame] | 218 | bd->props.state |= BL_CORE_SUSPENDED; |
| 219 | backlight_update_status(bd); |
Richard Purdie | c835ee7 | 2009-01-06 21:00:19 +0000 | [diff] [blame] | 220 | } |
Uwe Kleine-König | d1d7357 | 2010-11-24 12:57:14 -0800 | [diff] [blame] | 221 | mutex_unlock(&bd->ops_lock); |
Richard Purdie | c835ee7 | 2009-01-06 21:00:19 +0000 | [diff] [blame] | 222 | |
| 223 | return 0; |
| 224 | } |
| 225 | |
| 226 | static int backlight_resume(struct device *dev) |
| 227 | { |
| 228 | struct backlight_device *bd = to_backlight_device(dev); |
| 229 | |
Uwe Kleine-König | d1d7357 | 2010-11-24 12:57:14 -0800 | [diff] [blame] | 230 | mutex_lock(&bd->ops_lock); |
| 231 | if (bd->ops && bd->ops->options & BL_CORE_SUSPENDRESUME) { |
Richard Purdie | c835ee7 | 2009-01-06 21:00:19 +0000 | [diff] [blame] | 232 | bd->props.state &= ~BL_CORE_SUSPENDED; |
| 233 | backlight_update_status(bd); |
Richard Purdie | c835ee7 | 2009-01-06 21:00:19 +0000 | [diff] [blame] | 234 | } |
Uwe Kleine-König | d1d7357 | 2010-11-24 12:57:14 -0800 | [diff] [blame] | 235 | mutex_unlock(&bd->ops_lock); |
Richard Purdie | c835ee7 | 2009-01-06 21:00:19 +0000 | [diff] [blame] | 236 | |
| 237 | return 0; |
| 238 | } |
Shuah Khan | 3601792 | 2013-07-03 15:05:16 -0700 | [diff] [blame^] | 239 | #endif |
| 240 | |
| 241 | static SIMPLE_DEV_PM_OPS(backlight_class_dev_pm_ops, backlight_suspend, |
| 242 | backlight_resume); |
Richard Purdie | c835ee7 | 2009-01-06 21:00:19 +0000 | [diff] [blame] | 243 | |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 244 | static void bl_device_release(struct device *dev) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 245 | { |
| 246 | struct backlight_device *bd = to_backlight_device(dev); |
| 247 | kfree(bd); |
| 248 | } |
| 249 | |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 250 | static struct device_attribute bl_device_attributes[] = { |
| 251 | __ATTR(bl_power, 0644, backlight_show_power, backlight_store_power), |
| 252 | __ATTR(brightness, 0644, backlight_show_brightness, |
Richard Purdie | 6ca0176 | 2006-03-31 02:31:49 -0800 | [diff] [blame] | 253 | backlight_store_brightness), |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 254 | __ATTR(actual_brightness, 0444, backlight_show_actual_brightness, |
Richard Purdie | 6ca0176 | 2006-03-31 02:31:49 -0800 | [diff] [blame] | 255 | NULL), |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 256 | __ATTR(max_brightness, 0444, backlight_show_max_brightness, NULL), |
Matthew Garrett | bb7ca74 | 2011-03-22 16:30:21 -0700 | [diff] [blame] | 257 | __ATTR(type, 0444, backlight_show_type, NULL), |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 258 | __ATTR_NULL, |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 259 | }; |
| 260 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 261 | /** |
Matthew Garrett | 325253a | 2009-07-14 17:06:02 +0100 | [diff] [blame] | 262 | * backlight_force_update - tell the backlight subsystem that hardware state |
| 263 | * has changed |
| 264 | * @bd: the backlight device to update |
| 265 | * |
| 266 | * Updates the internal state of the backlight in response to a hardware event, |
| 267 | * and generate a uevent to notify userspace |
| 268 | */ |
| 269 | void backlight_force_update(struct backlight_device *bd, |
| 270 | enum backlight_update_reason reason) |
| 271 | { |
| 272 | mutex_lock(&bd->ops_lock); |
| 273 | if (bd->ops && bd->ops->get_brightness) |
| 274 | bd->props.brightness = bd->ops->get_brightness(bd); |
| 275 | mutex_unlock(&bd->ops_lock); |
| 276 | backlight_generate_event(bd, reason); |
| 277 | } |
| 278 | EXPORT_SYMBOL(backlight_force_update); |
| 279 | |
| 280 | /** |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 281 | * backlight_device_register - create and register a new object of |
| 282 | * backlight_device class. |
| 283 | * @name: the name of the new object(must be the same as the name of the |
| 284 | * respective framebuffer device). |
Sebastian Siewior | f6ec2d9 | 2008-07-16 23:05:49 +0100 | [diff] [blame] | 285 | * @parent: a pointer to the parent device |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 286 | * @devdata: an optional pointer to be stored for private driver use. The |
| 287 | * methods may retrieve it by using bl_get_data(bd). |
Richard Purdie | 599a52d | 2007-02-10 23:07:48 +0000 | [diff] [blame] | 288 | * @ops: the backlight operations structure. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 289 | * |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 290 | * Creates and registers new backlight device. Returns either an |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 291 | * ERR_PTR() or a pointer to the newly allocated device. |
| 292 | */ |
Yu Luming | 519ab5f | 2006-12-19 12:56:15 -0800 | [diff] [blame] | 293 | struct backlight_device *backlight_device_register(const char *name, |
Matthew Garrett | a19a6ee | 2010-02-17 16:39:44 -0500 | [diff] [blame] | 294 | struct device *parent, void *devdata, const struct backlight_ops *ops, |
| 295 | const struct backlight_properties *props) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 296 | { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 297 | struct backlight_device *new_bd; |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 298 | int rc; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 299 | |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 300 | pr_debug("backlight_device_register: name=%s\n", name); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 301 | |
Richard Purdie | 599a52d | 2007-02-10 23:07:48 +0000 | [diff] [blame] | 302 | new_bd = kzalloc(sizeof(struct backlight_device), GFP_KERNEL); |
Dmitry Torokhov | 90968e8 | 2007-02-08 00:12:28 +0000 | [diff] [blame] | 303 | if (!new_bd) |
Jean Delvare | 10ad1b7 | 2006-03-09 17:33:36 -0800 | [diff] [blame] | 304 | return ERR_PTR(-ENOMEM); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 305 | |
Richard Purdie | 28ee086 | 2007-02-08 22:25:09 +0000 | [diff] [blame] | 306 | mutex_init(&new_bd->update_lock); |
Richard Purdie | 599a52d | 2007-02-10 23:07:48 +0000 | [diff] [blame] | 307 | mutex_init(&new_bd->ops_lock); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 308 | |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 309 | new_bd->dev.class = backlight_class; |
| 310 | new_bd->dev.parent = parent; |
| 311 | new_bd->dev.release = bl_device_release; |
Kees Cook | 02aa2a3 | 2013-07-03 15:04:56 -0700 | [diff] [blame] | 312 | dev_set_name(&new_bd->dev, "%s", name); |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 313 | dev_set_drvdata(&new_bd->dev, devdata); |
| 314 | |
Matthew Garrett | a19a6ee | 2010-02-17 16:39:44 -0500 | [diff] [blame] | 315 | /* Set default properties */ |
Matthew Garrett | bb7ca74 | 2011-03-22 16:30:21 -0700 | [diff] [blame] | 316 | if (props) { |
Matthew Garrett | a19a6ee | 2010-02-17 16:39:44 -0500 | [diff] [blame] | 317 | memcpy(&new_bd->props, props, |
| 318 | sizeof(struct backlight_properties)); |
Matthew Garrett | bb7ca74 | 2011-03-22 16:30:21 -0700 | [diff] [blame] | 319 | if (props->type <= 0 || props->type >= BACKLIGHT_TYPE_MAX) { |
| 320 | WARN(1, "%s: invalid backlight type", name); |
| 321 | new_bd->props.type = BACKLIGHT_RAW; |
| 322 | } |
| 323 | } else { |
| 324 | new_bd->props.type = BACKLIGHT_RAW; |
| 325 | } |
Matthew Garrett | a19a6ee | 2010-02-17 16:39:44 -0500 | [diff] [blame] | 326 | |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 327 | rc = device_register(&new_bd->dev); |
Dmitry Torokhov | 90968e8 | 2007-02-08 00:12:28 +0000 | [diff] [blame] | 328 | if (rc) { |
Dmitry Torokhov | 2fd5a15 | 2007-02-07 22:25:50 +0000 | [diff] [blame] | 329 | kfree(new_bd); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 330 | return ERR_PTR(rc); |
| 331 | } |
| 332 | |
James Simmons | 3d5eead | 2006-12-08 02:40:47 -0800 | [diff] [blame] | 333 | rc = backlight_register_fb(new_bd); |
Dmitry Torokhov | 2fd5a15 | 2007-02-07 22:25:50 +0000 | [diff] [blame] | 334 | if (rc) { |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 335 | device_unregister(&new_bd->dev); |
Dmitry Torokhov | 2fd5a15 | 2007-02-07 22:25:50 +0000 | [diff] [blame] | 336 | return ERR_PTR(rc); |
| 337 | } |
| 338 | |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 339 | new_bd->ops = ops; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 340 | |
Richard Purdie | 321709c | 2007-02-10 15:04:08 +0000 | [diff] [blame] | 341 | #ifdef CONFIG_PMAC_BACKLIGHT |
| 342 | mutex_lock(&pmac_backlight_mutex); |
| 343 | if (!pmac_backlight) |
| 344 | pmac_backlight = new_bd; |
| 345 | mutex_unlock(&pmac_backlight_mutex); |
| 346 | #endif |
| 347 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 348 | return new_bd; |
| 349 | } |
| 350 | EXPORT_SYMBOL(backlight_device_register); |
| 351 | |
| 352 | /** |
| 353 | * backlight_device_unregister - unregisters a backlight device object. |
| 354 | * @bd: the backlight device object to be unregistered and freed. |
| 355 | * |
| 356 | * Unregisters a previously registered via backlight_device_register object. |
| 357 | */ |
| 358 | void backlight_device_unregister(struct backlight_device *bd) |
| 359 | { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 360 | if (!bd) |
| 361 | return; |
| 362 | |
Richard Purdie | 321709c | 2007-02-10 15:04:08 +0000 | [diff] [blame] | 363 | #ifdef CONFIG_PMAC_BACKLIGHT |
| 364 | mutex_lock(&pmac_backlight_mutex); |
| 365 | if (pmac_backlight == bd) |
| 366 | pmac_backlight = NULL; |
| 367 | mutex_unlock(&pmac_backlight_mutex); |
| 368 | #endif |
Richard Purdie | 599a52d | 2007-02-10 23:07:48 +0000 | [diff] [blame] | 369 | mutex_lock(&bd->ops_lock); |
| 370 | bd->ops = NULL; |
| 371 | mutex_unlock(&bd->ops_lock); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 372 | |
James Simmons | 3d5eead | 2006-12-08 02:40:47 -0800 | [diff] [blame] | 373 | backlight_unregister_fb(bd); |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 374 | device_unregister(&bd->dev); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 375 | } |
| 376 | EXPORT_SYMBOL(backlight_device_unregister); |
| 377 | |
Jingoo Han | 8318fde4 | 2013-07-03 15:05:13 -0700 | [diff] [blame] | 378 | static void devm_backlight_device_release(struct device *dev, void *res) |
| 379 | { |
| 380 | struct backlight_device *backlight = *(struct backlight_device **)res; |
| 381 | |
| 382 | backlight_device_unregister(backlight); |
| 383 | } |
| 384 | |
| 385 | static int devm_backlight_device_match(struct device *dev, void *res, |
| 386 | void *data) |
| 387 | { |
| 388 | struct backlight_device **r = res; |
| 389 | |
| 390 | return *r == data; |
| 391 | } |
| 392 | |
| 393 | /** |
| 394 | * devm_backlight_device_register - resource managed backlight_device_register() |
| 395 | * @dev: the device to register |
| 396 | * @name: the name of the device |
| 397 | * @parent: a pointer to the parent device |
| 398 | * @devdata: an optional pointer to be stored for private driver use |
| 399 | * @ops: the backlight operations structure |
| 400 | * @props: the backlight properties |
| 401 | * |
| 402 | * @return a struct backlight on success, or an ERR_PTR on error |
| 403 | * |
| 404 | * Managed backlight_device_register(). The backlight_device returned |
| 405 | * from this function are automatically freed on driver detach. |
| 406 | * See backlight_device_register() for more information. |
| 407 | */ |
| 408 | struct backlight_device *devm_backlight_device_register(struct device *dev, |
| 409 | const char *name, struct device *parent, void *devdata, |
| 410 | const struct backlight_ops *ops, |
| 411 | const struct backlight_properties *props) |
| 412 | { |
| 413 | struct backlight_device **ptr, *backlight; |
| 414 | |
| 415 | ptr = devres_alloc(devm_backlight_device_release, sizeof(*ptr), |
| 416 | GFP_KERNEL); |
| 417 | if (!ptr) |
| 418 | return ERR_PTR(-ENOMEM); |
| 419 | |
| 420 | backlight = backlight_device_register(name, parent, devdata, ops, |
| 421 | props); |
| 422 | if (!IS_ERR(backlight)) { |
| 423 | *ptr = backlight; |
| 424 | devres_add(dev, ptr); |
| 425 | } else { |
| 426 | devres_free(ptr); |
| 427 | } |
| 428 | |
| 429 | return backlight; |
| 430 | } |
| 431 | EXPORT_SYMBOL(devm_backlight_device_register); |
| 432 | |
| 433 | /** |
| 434 | * devm_backlight_device_unregister - resource managed backlight_device_unregister() |
| 435 | * @dev: the device to unregister |
| 436 | * @bd: the backlight device to unregister |
| 437 | * |
| 438 | * Deallocated a backlight allocated with devm_backlight_device_register(). |
| 439 | * Normally this function will not need to be called and the resource management |
| 440 | * code will ensure that the resource is freed. |
| 441 | */ |
| 442 | void devm_backlight_device_unregister(struct device *dev, |
| 443 | struct backlight_device *bd) |
| 444 | { |
| 445 | int rc; |
| 446 | |
| 447 | rc = devres_release(dev, devm_backlight_device_release, |
| 448 | devm_backlight_device_match, bd); |
| 449 | WARN_ON(rc); |
| 450 | } |
| 451 | EXPORT_SYMBOL(devm_backlight_device_unregister); |
| 452 | |
Thierry Reding | 762a936 | 2012-12-17 16:01:06 -0800 | [diff] [blame] | 453 | #ifdef CONFIG_OF |
Greg Kroah-Hartman | 3213f63 | 2013-02-06 16:43:02 -0800 | [diff] [blame] | 454 | static int of_parent_match(struct device *dev, const void *data) |
Thierry Reding | 762a936 | 2012-12-17 16:01:06 -0800 | [diff] [blame] | 455 | { |
| 456 | return dev->parent && dev->parent->of_node == data; |
| 457 | } |
| 458 | |
| 459 | /** |
| 460 | * of_find_backlight_by_node() - find backlight device by device-tree node |
| 461 | * @node: device-tree node of the backlight device |
| 462 | * |
| 463 | * Returns a pointer to the backlight device corresponding to the given DT |
| 464 | * node or NULL if no such backlight device exists or if the device hasn't |
| 465 | * been probed yet. |
| 466 | * |
| 467 | * This function obtains a reference on the backlight device and it is the |
| 468 | * caller's responsibility to drop the reference by calling put_device() on |
| 469 | * the backlight device's .dev field. |
| 470 | */ |
| 471 | struct backlight_device *of_find_backlight_by_node(struct device_node *node) |
| 472 | { |
| 473 | struct device *dev; |
| 474 | |
| 475 | dev = class_find_device(backlight_class, NULL, node, of_parent_match); |
| 476 | |
| 477 | return dev ? to_backlight_device(dev) : NULL; |
| 478 | } |
| 479 | EXPORT_SYMBOL(of_find_backlight_by_node); |
| 480 | #endif |
| 481 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 482 | static void __exit backlight_class_exit(void) |
| 483 | { |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 484 | class_destroy(backlight_class); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 485 | } |
| 486 | |
| 487 | static int __init backlight_class_init(void) |
| 488 | { |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 489 | backlight_class = class_create(THIS_MODULE, "backlight"); |
| 490 | if (IS_ERR(backlight_class)) { |
Jingoo Han | 35f9616 | 2012-05-29 15:07:16 -0700 | [diff] [blame] | 491 | pr_warn("Unable to create backlight class; errno = %ld\n", |
| 492 | PTR_ERR(backlight_class)); |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 493 | return PTR_ERR(backlight_class); |
| 494 | } |
| 495 | |
| 496 | backlight_class->dev_attrs = bl_device_attributes; |
Shuah Khan | 3601792 | 2013-07-03 15:05:16 -0700 | [diff] [blame^] | 497 | backlight_class->pm = &backlight_class_dev_pm_ops; |
Richard Purdie | 655bfd7 | 2007-07-09 12:17:24 +0100 | [diff] [blame] | 498 | return 0; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 499 | } |
| 500 | |
| 501 | /* |
| 502 | * if this is compiled into the kernel, we need to ensure that the |
| 503 | * class is registered before users of the class try to register lcd's |
| 504 | */ |
| 505 | postcore_initcall(backlight_class_init); |
| 506 | module_exit(backlight_class_exit); |
| 507 | |
| 508 | MODULE_LICENSE("GPL"); |
| 509 | MODULE_AUTHOR("Jamey Hicks <jamey.hicks@hp.com>, Andrew Zabolotny <zap@homelink.ru>"); |
| 510 | MODULE_DESCRIPTION("Backlight Lowlevel Control Abstraction"); |