2 * dock.c - ACPI dock station driver
4 * Copyright (C) 2006, 2014, Intel Corp.
5 * Author: Kristen Carlson Accardi <kristen.c.accardi@intel.com>
6 * Rafael J. Wysocki <rafael.j.wysocki@intel.com>
8 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or (at
13 * your option) any later version.
15 * This program is distributed in the hope that it will be useful, but
16 * WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 * General Public License for more details.
20 * ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
23 #include <linux/kernel.h>
24 #include <linux/module.h>
25 #include <linux/slab.h>
26 #include <linux/init.h>
27 #include <linux/types.h>
28 #include <linux/notifier.h>
29 #include <linux/platform_device.h>
30 #include <linux/jiffies.h>
31 #include <linux/stddef.h>
32 #include <linux/acpi.h>
36 #define ACPI_DOCK_DRIVER_DESCRIPTION "ACPI Dock Station Driver"
38 ACPI_MODULE_NAME("dock");
39 MODULE_AUTHOR("Kristen Carlson Accardi");
40 MODULE_DESCRIPTION(ACPI_DOCK_DRIVER_DESCRIPTION
);
41 MODULE_LICENSE("GPL");
43 static bool immediate_undock
= 1;
44 module_param(immediate_undock
, bool, 0644);
45 MODULE_PARM_DESC(immediate_undock
, "1 (default) will cause the driver to "
46 "undock immediately when the undock button is pressed, 0 will cause"
47 " the driver to wait for userspace to write the undock sysfs file "
52 unsigned long last_dock_time
;
54 struct list_head dependent_devices
;
56 struct list_head sibling
;
57 struct platform_device
*dock_device
;
59 static LIST_HEAD(dock_stations
);
60 static int dock_station_count
;
62 struct dock_dependent_device
{
63 struct list_head list
;
64 struct acpi_device
*adev
;
67 #define DOCK_DOCKING 0x00000001
68 #define DOCK_UNDOCKING 0x00000002
69 #define DOCK_IS_DOCK 0x00000010
70 #define DOCK_IS_ATA 0x00000020
71 #define DOCK_IS_BAT 0x00000040
73 #define UNDOCK_EVENT 2
75 enum dock_callback_type
{
81 /*****************************************************************************
82 * Dock Dependent device functions *
83 *****************************************************************************/
85 * add_dock_dependent_device - associate a device with the dock station
87 * @adev: Dependent ACPI device object.
89 * Add the dependent device to the dock's dependent device list.
91 static int add_dock_dependent_device(struct dock_station
*ds
,
92 struct acpi_device
*adev
)
94 struct dock_dependent_device
*dd
;
96 dd
= kzalloc(sizeof(*dd
), GFP_KERNEL
);
101 INIT_LIST_HEAD(&dd
->list
);
102 list_add_tail(&dd
->list
, &ds
->dependent_devices
);
107 static void dock_hotplug_event(struct dock_dependent_device
*dd
, u32 event
,
108 enum dock_callback_type cb_type
)
110 struct acpi_device
*adev
= dd
->adev
;
112 acpi_lock_hp_context();
117 if (cb_type
== DOCK_CALL_FIXUP
) {
118 void (*fixup
)(struct acpi_device
*);
120 fixup
= adev
->hp
->fixup
;
122 acpi_unlock_hp_context();
126 } else if (cb_type
== DOCK_CALL_UEVENT
) {
127 void (*uevent
)(struct acpi_device
*, u32
);
129 uevent
= adev
->hp
->uevent
;
131 acpi_unlock_hp_context();
136 int (*notify
)(struct acpi_device
*, u32
);
138 notify
= adev
->hp
->notify
;
140 acpi_unlock_hp_context();
147 acpi_unlock_hp_context();
150 static struct dock_station
*find_dock_station(acpi_handle handle
)
152 struct dock_station
*ds
;
154 list_for_each_entry(ds
, &dock_stations
, sibling
)
155 if (ds
->handle
== handle
)
162 * find_dock_dependent_device - get a device dependent on this dock
163 * @ds: the dock station
164 * @adev: ACPI device object to find.
166 * iterate over the dependent device list for this dock. If the
167 * dependent device matches the handle, return.
169 static struct dock_dependent_device
*
170 find_dock_dependent_device(struct dock_station
*ds
, struct acpi_device
*adev
)
172 struct dock_dependent_device
*dd
;
174 list_for_each_entry(dd
, &ds
->dependent_devices
, list
)
175 if (adev
== dd
->adev
)
181 void register_dock_dependent_device(struct acpi_device
*adev
,
182 acpi_handle dshandle
)
184 struct dock_station
*ds
= find_dock_station(dshandle
);
186 if (ds
&& !find_dock_dependent_device(ds
, adev
))
187 add_dock_dependent_device(ds
, adev
);
190 /*****************************************************************************
192 *****************************************************************************/
195 * is_dock_device - see if a device is on a dock station
196 * @adev: ACPI device object to check.
198 * If this device is either the dock station itself,
199 * or is a device dependent on the dock station, then it
202 int is_dock_device(struct acpi_device
*adev
)
204 struct dock_station
*dock_station
;
206 if (!dock_station_count
)
209 if (acpi_dock_match(adev
->handle
))
212 list_for_each_entry(dock_station
, &dock_stations
, sibling
)
213 if (find_dock_dependent_device(dock_station
, adev
))
218 EXPORT_SYMBOL_GPL(is_dock_device
);
221 * dock_present - see if the dock station is present.
222 * @ds: the dock station
224 * execute the _STA method. note that present does not
225 * imply that we are docked.
227 static int dock_present(struct dock_station
*ds
)
229 unsigned long long sta
;
233 status
= acpi_evaluate_integer(ds
->handle
, "_STA", NULL
, &sta
);
234 if (ACPI_SUCCESS(status
) && sta
)
241 * hot_remove_dock_devices - Remove dock station devices.
244 static void hot_remove_dock_devices(struct dock_station
*ds
)
246 struct dock_dependent_device
*dd
;
249 * Walk the list in reverse order so that devices that have been added
250 * last are removed first (in case there are some indirect dependencies
253 list_for_each_entry_reverse(dd
, &ds
->dependent_devices
, list
)
254 dock_hotplug_event(dd
, ACPI_NOTIFY_EJECT_REQUEST
, false);
256 list_for_each_entry_reverse(dd
, &ds
->dependent_devices
, list
)
257 acpi_bus_trim(dd
->adev
);
261 * hotplug_dock_devices - Insert devices on a dock station.
262 * @ds: the dock station
263 * @event: either bus check or device check request
265 * Some devices on the dock station need to have drivers called
266 * to perform hotplug operations after a dock event has occurred.
267 * Traverse the list of dock devices that have registered a
268 * hotplug handler, and call the handler.
270 static void hotplug_dock_devices(struct dock_station
*ds
, u32 event
)
272 struct dock_dependent_device
*dd
;
274 /* Call driver specific post-dock fixups. */
275 list_for_each_entry(dd
, &ds
->dependent_devices
, list
)
276 dock_hotplug_event(dd
, event
, DOCK_CALL_FIXUP
);
278 /* Call driver specific hotplug functions. */
279 list_for_each_entry(dd
, &ds
->dependent_devices
, list
)
280 dock_hotplug_event(dd
, event
, DOCK_CALL_HANDLER
);
283 * Check if all devices have been enumerated already. If not, run
284 * acpi_bus_scan() for them and that will cause scan handlers to be
285 * attached to device objects or acpi_drivers to be stopped/started if
288 list_for_each_entry(dd
, &ds
->dependent_devices
, list
) {
289 struct acpi_device
*adev
= dd
->adev
;
291 if (!acpi_device_enumerated(adev
)) {
292 int ret
= acpi_bus_scan(adev
->handle
);
294 dev_dbg(&adev
->dev
, "scan error %d\n", -ret
);
299 static void dock_event(struct dock_station
*ds
, u32 event
, int num
)
301 struct device
*dev
= &ds
->dock_device
->dev
;
302 char event_string
[13];
303 char *envp
[] = { event_string
, NULL
};
304 struct dock_dependent_device
*dd
;
306 if (num
== UNDOCK_EVENT
)
307 sprintf(event_string
, "EVENT=undock");
309 sprintf(event_string
, "EVENT=dock");
312 * Indicate that the status of the dock station has
315 if (num
== DOCK_EVENT
)
316 kobject_uevent_env(&dev
->kobj
, KOBJ_CHANGE
, envp
);
318 list_for_each_entry(dd
, &ds
->dependent_devices
, list
)
319 dock_hotplug_event(dd
, event
, DOCK_CALL_UEVENT
);
321 if (num
!= DOCK_EVENT
)
322 kobject_uevent_env(&dev
->kobj
, KOBJ_CHANGE
, envp
);
326 * handle_dock - handle a dock event
327 * @ds: the dock station
328 * @dock: to dock, or undock - that is the question
330 * Execute the _DCK method in response to an acpi event
332 static void handle_dock(struct dock_station
*ds
, int dock
)
335 struct acpi_object_list arg_list
;
336 union acpi_object arg
;
337 unsigned long long value
;
339 acpi_handle_info(ds
->handle
, "%s\n", dock
? "docking" : "undocking");
341 /* _DCK method has one argument */
343 arg_list
.pointer
= &arg
;
344 arg
.type
= ACPI_TYPE_INTEGER
;
345 arg
.integer
.value
= dock
;
346 status
= acpi_evaluate_integer(ds
->handle
, "_DCK", &arg_list
, &value
);
347 if (ACPI_FAILURE(status
) && status
!= AE_NOT_FOUND
)
348 acpi_handle_err(ds
->handle
, "Failed to execute _DCK (0x%x)\n",
352 static inline void dock(struct dock_station
*ds
)
357 static inline void undock(struct dock_station
*ds
)
362 static inline void begin_dock(struct dock_station
*ds
)
364 ds
->flags
|= DOCK_DOCKING
;
367 static inline void complete_dock(struct dock_station
*ds
)
369 ds
->flags
&= ~(DOCK_DOCKING
);
370 ds
->last_dock_time
= jiffies
;
373 static inline void begin_undock(struct dock_station
*ds
)
375 ds
->flags
|= DOCK_UNDOCKING
;
378 static inline void complete_undock(struct dock_station
*ds
)
380 ds
->flags
&= ~(DOCK_UNDOCKING
);
384 * dock_in_progress - see if we are in the middle of handling a dock event
385 * @ds: the dock station
387 * Sometimes while docking, false dock events can be sent to the driver
388 * because good connections aren't made or some other reason. Ignore these
389 * if we are in the middle of doing something.
391 static int dock_in_progress(struct dock_station
*ds
)
393 if ((ds
->flags
& DOCK_DOCKING
) ||
394 time_before(jiffies
, (ds
->last_dock_time
+ HZ
)))
400 * handle_eject_request - handle an undock request checking for error conditions
402 * Check to make sure the dock device is still present, then undock and
403 * hotremove all the devices that may need removing.
405 static int handle_eject_request(struct dock_station
*ds
, u32 event
)
407 if (dock_in_progress(ds
))
411 * here we need to generate the undock
412 * event prior to actually doing the undock
413 * so that the device struct still exists.
414 * Also, even send the dock event if the
415 * device is not present anymore
417 dock_event(ds
, event
, UNDOCK_EVENT
);
419 hot_remove_dock_devices(ds
);
421 acpi_evaluate_lck(ds
->handle
, 0);
422 acpi_evaluate_ej0(ds
->handle
);
423 if (dock_present(ds
)) {
424 acpi_handle_err(ds
->handle
, "Unable to undock!\n");
432 * dock_notify - Handle ACPI dock notification.
433 * @adev: Dock station's ACPI device object.
434 * @event: Event code.
436 * If we are notified to dock, then check to see if the dock is
437 * present and then dock. Notify all drivers of the dock event,
438 * and then hotplug and devices that may need hotplugging.
440 int dock_notify(struct acpi_device
*adev
, u32 event
)
442 acpi_handle handle
= adev
->handle
;
443 struct dock_station
*ds
= find_dock_station(handle
);
444 int surprise_removal
= 0;
450 * According to acpi spec 3.0a, if a DEVICE_CHECK notification
451 * is sent and _DCK is present, it is assumed to mean an undock
454 if ((ds
->flags
& DOCK_IS_DOCK
) && event
== ACPI_NOTIFY_DEVICE_CHECK
)
455 event
= ACPI_NOTIFY_EJECT_REQUEST
;
458 * dock station: BUS_CHECK - docked or surprise removal
459 * DEVICE_CHECK - undocked
460 * other device: BUS_CHECK/DEVICE_CHECK - added or surprise removal
462 * To simplify event handling, dock dependent device handler always
463 * get ACPI_NOTIFY_BUS_CHECK/ACPI_NOTIFY_DEVICE_CHECK for add and
464 * ACPI_NOTIFY_EJECT_REQUEST for removal
467 case ACPI_NOTIFY_BUS_CHECK
:
468 case ACPI_NOTIFY_DEVICE_CHECK
:
469 if (!dock_in_progress(ds
) && !acpi_device_enumerated(adev
)) {
472 if (!dock_present(ds
)) {
473 acpi_handle_err(handle
, "Unable to dock!\n");
477 hotplug_dock_devices(ds
, event
);
479 dock_event(ds
, event
, DOCK_EVENT
);
480 acpi_evaluate_lck(ds
->handle
, 1);
481 acpi_update_all_gpes();
484 if (dock_present(ds
) || dock_in_progress(ds
))
486 /* This is a surprise removal */
487 surprise_removal
= 1;
488 event
= ACPI_NOTIFY_EJECT_REQUEST
;
490 case ACPI_NOTIFY_EJECT_REQUEST
:
492 if ((immediate_undock
&& !(ds
->flags
& DOCK_IS_ATA
))
494 handle_eject_request(ds
, event
);
496 dock_event(ds
, event
, UNDOCK_EVENT
);
503 * show_docked - read method for "docked" file in sysfs
505 static ssize_t
show_docked(struct device
*dev
,
506 struct device_attribute
*attr
, char *buf
)
508 struct dock_station
*dock_station
= dev
->platform_data
;
509 struct acpi_device
*adev
= NULL
;
511 acpi_bus_get_device(dock_station
->handle
, &adev
);
512 return snprintf(buf
, PAGE_SIZE
, "%u\n", acpi_device_enumerated(adev
));
514 static DEVICE_ATTR(docked
, S_IRUGO
, show_docked
, NULL
);
517 * show_flags - read method for flags file in sysfs
519 static ssize_t
show_flags(struct device
*dev
,
520 struct device_attribute
*attr
, char *buf
)
522 struct dock_station
*dock_station
= dev
->platform_data
;
523 return snprintf(buf
, PAGE_SIZE
, "%d\n", dock_station
->flags
);
526 static DEVICE_ATTR(flags
, S_IRUGO
, show_flags
, NULL
);
529 * write_undock - write method for "undock" file in sysfs
531 static ssize_t
write_undock(struct device
*dev
, struct device_attribute
*attr
,
532 const char *buf
, size_t count
)
535 struct dock_station
*dock_station
= dev
->platform_data
;
540 acpi_scan_lock_acquire();
541 begin_undock(dock_station
);
542 ret
= handle_eject_request(dock_station
, ACPI_NOTIFY_EJECT_REQUEST
);
543 acpi_scan_lock_release();
544 return ret
? ret
: count
;
546 static DEVICE_ATTR(undock
, S_IWUSR
, NULL
, write_undock
);
549 * show_dock_uid - read method for "uid" file in sysfs
551 static ssize_t
show_dock_uid(struct device
*dev
,
552 struct device_attribute
*attr
, char *buf
)
554 unsigned long long lbuf
;
555 struct dock_station
*dock_station
= dev
->platform_data
;
556 acpi_status status
= acpi_evaluate_integer(dock_station
->handle
,
557 "_UID", NULL
, &lbuf
);
558 if (ACPI_FAILURE(status
))
561 return snprintf(buf
, PAGE_SIZE
, "%llx\n", lbuf
);
563 static DEVICE_ATTR(uid
, S_IRUGO
, show_dock_uid
, NULL
);
565 static ssize_t
show_dock_type(struct device
*dev
,
566 struct device_attribute
*attr
, char *buf
)
568 struct dock_station
*dock_station
= dev
->platform_data
;
571 if (dock_station
->flags
& DOCK_IS_DOCK
)
572 type
= "dock_station";
573 else if (dock_station
->flags
& DOCK_IS_ATA
)
575 else if (dock_station
->flags
& DOCK_IS_BAT
)
576 type
= "battery_bay";
580 return snprintf(buf
, PAGE_SIZE
, "%s\n", type
);
582 static DEVICE_ATTR(type
, S_IRUGO
, show_dock_type
, NULL
);
584 static struct attribute
*dock_attributes
[] = {
585 &dev_attr_docked
.attr
,
586 &dev_attr_flags
.attr
,
587 &dev_attr_undock
.attr
,
593 static struct attribute_group dock_attribute_group
= {
594 .attrs
= dock_attributes
598 * acpi_dock_add - Add a new dock station
599 * @adev: Dock station ACPI device object.
601 * allocated and initialize a new dock station device.
603 void acpi_dock_add(struct acpi_device
*adev
)
605 struct dock_station
*dock_station
, ds
= { NULL
, };
606 struct platform_device_info pdevinfo
;
607 acpi_handle handle
= adev
->handle
;
608 struct platform_device
*dd
;
611 memset(&pdevinfo
, 0, sizeof(pdevinfo
));
612 pdevinfo
.name
= "dock";
613 pdevinfo
.id
= dock_station_count
;
614 pdevinfo
.fwnode
= acpi_fwnode_handle(adev
);
616 pdevinfo
.size_data
= sizeof(ds
);
617 dd
= platform_device_register_full(&pdevinfo
);
621 dock_station
= dd
->dev
.platform_data
;
623 dock_station
->handle
= handle
;
624 dock_station
->dock_device
= dd
;
625 dock_station
->last_dock_time
= jiffies
- HZ
;
627 INIT_LIST_HEAD(&dock_station
->sibling
);
628 INIT_LIST_HEAD(&dock_station
->dependent_devices
);
630 /* we want the dock device to send uevents */
631 dev_set_uevent_suppress(&dd
->dev
, 0);
633 if (acpi_dock_match(handle
))
634 dock_station
->flags
|= DOCK_IS_DOCK
;
635 if (acpi_ata_match(handle
))
636 dock_station
->flags
|= DOCK_IS_ATA
;
637 if (acpi_device_is_battery(adev
))
638 dock_station
->flags
|= DOCK_IS_BAT
;
640 ret
= sysfs_create_group(&dd
->dev
.kobj
, &dock_attribute_group
);
644 /* add the dock station as a device dependent on itself */
645 ret
= add_dock_dependent_device(dock_station
, adev
);
649 dock_station_count
++;
650 list_add(&dock_station
->sibling
, &dock_stations
);
651 adev
->flags
.is_dock_station
= true;
652 dev_info(&adev
->dev
, "ACPI dock station (docks/bays count: %d)\n",
657 sysfs_remove_group(&dd
->dev
.kobj
, &dock_attribute_group
);
660 platform_device_unregister(dd
);
661 acpi_handle_err(handle
, "%s encountered error %d\n", __func__
, ret
);