1 // SPDX-License-Identifier: GPL-2.0
3 * Provides ACPI support for IDE drives.
5 * Copyright (C) 2005 Intel Corp.
6 * Copyright (C) 2005 Randy Dunlap
7 * Copyright (C) 2006 SUSE Linux Products GmbH
8 * Copyright (C) 2006 Hannes Reinecke
11 #include <linux/acpi.h>
12 #include <linux/ata.h>
13 #include <linux/delay.h>
14 #include <linux/device.h>
15 #include <linux/errno.h>
16 #include <linux/kernel.h>
17 #include <linux/slab.h>
18 #include <linux/ide.h>
19 #include <linux/pci.h>
20 #include <linux/dmi.h>
21 #include <linux/module.h>
23 #define REGS_PER_GTF 7
33 struct ide_acpi_drive_link
{
34 acpi_handle obj_handle
;
38 struct ide_acpi_hwif_link
{
40 acpi_handle obj_handle
;
41 struct GTM_buffer gtm
;
42 struct ide_acpi_drive_link master
;
43 struct ide_acpi_drive_link slave
;
47 /* note: adds function name and KERN_DEBUG */
49 #define DEBPRINT(fmt, args...) \
50 printk(KERN_DEBUG "%s: " fmt, __func__, ## args)
52 #define DEBPRINT(fmt, args...) do {} while (0)
53 #endif /* DEBUGGING */
55 static bool ide_noacpi
;
56 module_param_named(noacpi
, ide_noacpi
, bool, 0);
57 MODULE_PARM_DESC(noacpi
, "disable IDE ACPI support");
59 static bool ide_acpigtf
;
60 module_param_named(acpigtf
, ide_acpigtf
, bool, 0);
61 MODULE_PARM_DESC(acpigtf
, "enable IDE ACPI _GTF support");
63 static bool ide_acpionboot
;
64 module_param_named(acpionboot
, ide_acpionboot
, bool, 0);
65 MODULE_PARM_DESC(acpionboot
, "call IDE ACPI methods on boot");
67 static bool ide_noacpi_psx
;
68 static int no_acpi_psx(const struct dmi_system_id
*id
)
70 ide_noacpi_psx
= true;
71 printk(KERN_NOTICE
"%s detected - disable ACPI _PSx.\n", id
->ident
);
75 static const struct dmi_system_id ide_acpi_dmi_table
[] = {
77 /* We should check if this is because ACPI NVS isn't save/restored. */
79 .callback
= no_acpi_psx
,
82 DMI_MATCH(DMI_BIOS_VENDOR
, "Phoenix Technologies Ltd."),
83 DMI_MATCH(DMI_BIOS_VERSION
, "KAM1.60")
87 { } /* terminate list */
90 int ide_acpi_init(void)
92 dmi_check_system(ide_acpi_dmi_table
);
96 bool ide_port_acpi(ide_hwif_t
*hwif
)
98 return ide_noacpi
== 0 && hwif
->acpidata
;
101 static acpi_handle
acpi_get_child(acpi_handle handle
, u64 addr
)
103 struct acpi_device
*adev
;
105 if (!handle
|| acpi_bus_get_device(handle
, &adev
))
108 adev
= acpi_find_child_device(adev
, addr
, false);
109 return adev
? adev
->handle
: NULL
;
113 * ide_get_dev_handle - finds acpi_handle and PCI device.function
114 * @dev: device to locate
115 * @handle: returned acpi_handle for @dev
116 * @pcidevfn: return PCI device.func for @dev
118 * Returns the ACPI object handle to the corresponding PCI device.
120 * Returns 0 on success, <0 on error.
122 static int ide_get_dev_handle(struct device
*dev
, acpi_handle
*handle
,
125 struct pci_dev
*pdev
= to_pci_dev(dev
);
126 unsigned int bus
, devnum
, func
;
128 acpi_handle dev_handle
;
130 struct acpi_device_info
*dinfo
= NULL
;
133 bus
= pdev
->bus
->number
;
134 devnum
= PCI_SLOT(pdev
->devfn
);
135 func
= PCI_FUNC(pdev
->devfn
);
136 /* ACPI _ADR encoding for PCI bus: */
137 addr
= (u64
)(devnum
<< 16 | func
);
139 DEBPRINT("ENTER: pci %02x:%02x.%01x\n", bus
, devnum
, func
);
141 dev_handle
= ACPI_HANDLE(dev
);
143 DEBPRINT("no acpi handle for device\n");
147 status
= acpi_get_object_info(dev_handle
, &dinfo
);
148 if (ACPI_FAILURE(status
)) {
149 DEBPRINT("get_object_info for device failed\n");
152 if (dinfo
&& (dinfo
->valid
& ACPI_VALID_ADR
) &&
153 dinfo
->address
== addr
) {
155 *handle
= dev_handle
;
157 DEBPRINT("get_object_info for device has wrong "
158 " address: %llu, should be %u\n",
159 dinfo
? (unsigned long long)dinfo
->address
: -1ULL,
164 DEBPRINT("for dev=0x%x.%x, addr=0x%llx, *handle=0x%p\n",
165 devnum
, func
, (unsigned long long)addr
, *handle
);
173 * ide_acpi_hwif_get_handle - Get ACPI object handle for a given hwif
174 * @hwif: device to locate
176 * Retrieves the object handle for a given hwif.
178 * Returns handle on success, 0 on error.
180 static acpi_handle
ide_acpi_hwif_get_handle(ide_hwif_t
*hwif
)
182 struct device
*dev
= hwif
->gendev
.parent
;
183 acpi_handle
uninitialized_var(dev_handle
);
185 acpi_handle chan_handle
;
188 DEBPRINT("ENTER: device %s\n", hwif
->name
);
191 DEBPRINT("no PCI device for %s\n", hwif
->name
);
195 err
= ide_get_dev_handle(dev
, &dev_handle
, &pcidevfn
);
197 DEBPRINT("ide_get_dev_handle failed (%d)\n", err
);
201 /* get child objects of dev_handle == channel objects,
202 * + _their_ children == drive objects */
203 /* channel is hwif->channel */
204 chan_handle
= acpi_get_child(dev_handle
, hwif
->channel
);
205 DEBPRINT("chan adr=%d: handle=0x%p\n",
206 hwif
->channel
, chan_handle
);
212 * do_drive_get_GTF - get the drive bootup default taskfile settings
213 * @drive: the drive for which the taskfile settings should be retrieved
214 * @gtf_length: number of bytes of _GTF data returned at @gtf_address
215 * @gtf_address: buffer containing _GTF taskfile arrays
217 * The _GTF method has no input parameters.
218 * It returns a variable number of register set values (registers
219 * hex 1F1..1F7, taskfiles).
220 * The <variable number> is not known in advance, so have ACPI-CA
221 * allocate the buffer as needed and return it, then free it later.
223 * The returned @gtf_length and @gtf_address are only valid if the
224 * function return value is 0.
226 static int do_drive_get_GTF(ide_drive_t
*drive
,
227 unsigned int *gtf_length
, unsigned long *gtf_address
,
228 unsigned long *obj_loc
)
231 struct acpi_buffer output
;
232 union acpi_object
*out_obj
;
239 if (!drive
->acpidata
->obj_handle
) {
240 DEBPRINT("No ACPI object found for %s\n", drive
->name
);
244 /* Setting up output buffer */
245 output
.length
= ACPI_ALLOCATE_BUFFER
;
246 output
.pointer
= NULL
; /* ACPI-CA sets this; save/free it later */
248 /* _GTF has no input parameters */
250 status
= acpi_evaluate_object(drive
->acpidata
->obj_handle
, "_GTF",
252 if (ACPI_FAILURE(status
)) {
254 "%s: Run _GTF error: status = 0x%x\n",
259 if (!output
.length
|| !output
.pointer
) {
260 DEBPRINT("Run _GTF: "
261 "length or ptr is NULL (0x%llx, 0x%p)\n",
262 (unsigned long long)output
.length
,
267 out_obj
= output
.pointer
;
268 if (out_obj
->type
!= ACPI_TYPE_BUFFER
) {
269 DEBPRINT("Run _GTF: error: "
270 "expected object type of ACPI_TYPE_BUFFER, "
271 "got 0x%x\n", out_obj
->type
);
273 kfree(output
.pointer
);
277 if (!out_obj
->buffer
.length
|| !out_obj
->buffer
.pointer
||
278 out_obj
->buffer
.length
% REGS_PER_GTF
) {
280 "%s: unexpected GTF length (%d) or addr (0x%p)\n",
281 __func__
, out_obj
->buffer
.length
,
282 out_obj
->buffer
.pointer
);
284 kfree(output
.pointer
);
288 *gtf_length
= out_obj
->buffer
.length
;
289 *gtf_address
= (unsigned long)out_obj
->buffer
.pointer
;
290 *obj_loc
= (unsigned long)out_obj
;
291 DEBPRINT("returning gtf_length=%d, gtf_address=0x%lx, obj_loc=0x%lx\n",
292 *gtf_length
, *gtf_address
, *obj_loc
);
299 * do_drive_set_taskfiles - write the drive taskfile settings from _GTF
300 * @drive: the drive to which the taskfile command should be sent
301 * @gtf_length: total number of bytes of _GTF taskfiles
302 * @gtf_address: location of _GTF taskfile arrays
304 * Write {gtf_address, length gtf_length} in groups of
305 * REGS_PER_GTF bytes.
307 static int do_drive_set_taskfiles(ide_drive_t
*drive
,
308 unsigned int gtf_length
,
309 unsigned long gtf_address
)
312 int gtf_count
= gtf_length
/ REGS_PER_GTF
;
315 DEBPRINT("total GTF bytes=%u (0x%x), gtf_count=%d, addr=0x%lx\n",
316 gtf_length
, gtf_length
, gtf_count
, gtf_address
);
318 /* send all taskfile registers (0x1f1-0x1f7) *in*that*order* */
319 for (ix
= 0; ix
< gtf_count
; ix
++) {
320 u8
*gtf
= (u8
*)(gtf_address
+ ix
* REGS_PER_GTF
);
323 DEBPRINT("(0x1f1-1f7): "
324 "hex: %02x %02x %02x %02x %02x %02x %02x\n",
325 gtf
[0], gtf
[1], gtf
[2],
326 gtf
[3], gtf
[4], gtf
[5], gtf
[6]);
329 DEBPRINT("_GTF execution disabled\n");
333 /* convert GTF to taskfile */
334 memset(&cmd
, 0, sizeof(cmd
));
335 memcpy(&cmd
.tf
.feature
, gtf
, REGS_PER_GTF
);
336 cmd
.valid
.out
.tf
= IDE_VALID_OUT_TF
| IDE_VALID_DEVICE
;
337 cmd
.valid
.in
.tf
= IDE_VALID_IN_TF
| IDE_VALID_DEVICE
;
339 err
= ide_no_data_taskfile(drive
, &cmd
);
341 printk(KERN_ERR
"%s: ide_no_data_taskfile failed: %u\n",
351 * ide_acpi_exec_tfs - get then write drive taskfile settings
352 * @drive: the drive for which the taskfile settings should be
355 * According to the ACPI spec this should be called after _STM
356 * has been evaluated for the interface. Some ACPI vendors interpret
357 * that as a hard requirement and modify the taskfile according
358 * to the Identify Drive information passed down with _STM.
359 * So one should really make sure to call this only after _STM has
362 int ide_acpi_exec_tfs(ide_drive_t
*drive
)
365 unsigned int gtf_length
;
366 unsigned long gtf_address
;
367 unsigned long obj_loc
;
369 DEBPRINT("call get_GTF, drive=%s port=%d\n", drive
->name
, drive
->dn
);
371 ret
= do_drive_get_GTF(drive
, >f_length
, >f_address
, &obj_loc
);
373 DEBPRINT("get_GTF error (%d)\n", ret
);
377 DEBPRINT("call set_taskfiles, drive=%s\n", drive
->name
);
379 ret
= do_drive_set_taskfiles(drive
, gtf_length
, gtf_address
);
380 kfree((void *)obj_loc
);
382 DEBPRINT("set_taskfiles error (%d)\n", ret
);
385 DEBPRINT("ret=%d\n", ret
);
391 * ide_acpi_get_timing - get the channel (controller) timings
392 * @hwif: target IDE interface (channel)
394 * This function executes the _GTM ACPI method for the target channel.
397 void ide_acpi_get_timing(ide_hwif_t
*hwif
)
400 struct acpi_buffer output
;
401 union acpi_object
*out_obj
;
403 /* Setting up output buffer for _GTM */
404 output
.length
= ACPI_ALLOCATE_BUFFER
;
405 output
.pointer
= NULL
; /* ACPI-CA sets this; save/free it later */
407 /* _GTM has no input parameters */
408 status
= acpi_evaluate_object(hwif
->acpidata
->obj_handle
, "_GTM",
411 DEBPRINT("_GTM status: %d, outptr: 0x%p, outlen: 0x%llx\n",
412 status
, output
.pointer
,
413 (unsigned long long)output
.length
);
415 if (ACPI_FAILURE(status
)) {
416 DEBPRINT("Run _GTM error: status = 0x%x\n", status
);
420 if (!output
.length
|| !output
.pointer
) {
421 DEBPRINT("Run _GTM: length or ptr is NULL (0x%llx, 0x%p)\n",
422 (unsigned long long)output
.length
,
424 kfree(output
.pointer
);
428 out_obj
= output
.pointer
;
429 if (out_obj
->type
!= ACPI_TYPE_BUFFER
) {
430 DEBPRINT("Run _GTM: error: "
431 "expected object type of ACPI_TYPE_BUFFER, "
432 "got 0x%x\n", out_obj
->type
);
433 kfree(output
.pointer
);
437 if (!out_obj
->buffer
.length
|| !out_obj
->buffer
.pointer
||
438 out_obj
->buffer
.length
!= sizeof(struct GTM_buffer
)) {
440 "%s: unexpected _GTM length (0x%x)[should be 0x%zx] or "
442 __func__
, out_obj
->buffer
.length
,
443 sizeof(struct GTM_buffer
), out_obj
->buffer
.pointer
);
444 kfree(output
.pointer
);
448 memcpy(&hwif
->acpidata
->gtm
, out_obj
->buffer
.pointer
,
449 sizeof(struct GTM_buffer
));
451 DEBPRINT("_GTM info: ptr: 0x%p, len: 0x%x, exp.len: 0x%zx\n",
452 out_obj
->buffer
.pointer
, out_obj
->buffer
.length
,
453 sizeof(struct GTM_buffer
));
455 DEBPRINT("_GTM fields: 0x%x, 0x%x, 0x%x, 0x%x, 0x%x\n",
456 hwif
->acpidata
->gtm
.PIO_speed0
,
457 hwif
->acpidata
->gtm
.DMA_speed0
,
458 hwif
->acpidata
->gtm
.PIO_speed1
,
459 hwif
->acpidata
->gtm
.DMA_speed1
,
460 hwif
->acpidata
->gtm
.GTM_flags
);
462 kfree(output
.pointer
);
466 * ide_acpi_push_timing - set the channel (controller) timings
467 * @hwif: target IDE interface (channel)
469 * This function executes the _STM ACPI method for the target channel.
471 * _STM requires Identify Drive data, which has to passed as an argument.
472 * Unfortunately drive->id is a mangled version which we can't readily
473 * use; hence we'll get the information afresh.
475 void ide_acpi_push_timing(ide_hwif_t
*hwif
)
478 struct acpi_object_list input
;
479 union acpi_object in_params
[3];
480 struct ide_acpi_drive_link
*master
= &hwif
->acpidata
->master
;
481 struct ide_acpi_drive_link
*slave
= &hwif
->acpidata
->slave
;
483 /* Give the GTM buffer + drive Identify data to the channel via the
485 /* setup input parameters buffer for _STM */
487 input
.pointer
= in_params
;
488 in_params
[0].type
= ACPI_TYPE_BUFFER
;
489 in_params
[0].buffer
.length
= sizeof(struct GTM_buffer
);
490 in_params
[0].buffer
.pointer
= (u8
*)&hwif
->acpidata
->gtm
;
491 in_params
[1].type
= ACPI_TYPE_BUFFER
;
492 in_params
[1].buffer
.length
= ATA_ID_WORDS
* 2;
493 in_params
[1].buffer
.pointer
= (u8
*)&master
->idbuff
;
494 in_params
[2].type
= ACPI_TYPE_BUFFER
;
495 in_params
[2].buffer
.length
= ATA_ID_WORDS
* 2;
496 in_params
[2].buffer
.pointer
= (u8
*)&slave
->idbuff
;
497 /* Output buffer: _STM has no output */
499 status
= acpi_evaluate_object(hwif
->acpidata
->obj_handle
, "_STM",
502 if (ACPI_FAILURE(status
)) {
503 DEBPRINT("Run _STM error: status = 0x%x\n", status
);
505 DEBPRINT("_STM status: %d\n", status
);
509 * ide_acpi_set_state - set the channel power state
510 * @hwif: target IDE interface
513 * This function executes the _PS0/_PS3 ACPI method to set the power state.
514 * ACPI spec requires _PS0 when IDE power on and _PS3 when power off
516 void ide_acpi_set_state(ide_hwif_t
*hwif
, int on
)
524 DEBPRINT("ENTER:\n");
526 /* channel first and then drives for power on and verse versa for power off */
528 acpi_bus_set_power(hwif
->acpidata
->obj_handle
, ACPI_STATE_D0
);
530 ide_port_for_each_present_dev(i
, drive
, hwif
) {
531 if (drive
->acpidata
->obj_handle
)
532 acpi_bus_set_power(drive
->acpidata
->obj_handle
,
533 on
? ACPI_STATE_D0
: ACPI_STATE_D3_COLD
);
537 acpi_bus_set_power(hwif
->acpidata
->obj_handle
,
542 * ide_acpi_init_port - initialize the ACPI link for an IDE interface
543 * @hwif: target IDE interface (channel)
545 * The ACPI spec is not quite clear when the drive identify buffer
546 * should be obtained. Calling IDENTIFY DEVICE during shutdown
547 * is not the best of ideas as the drive might already being put to
548 * sleep. And obviously we can't call it during resume.
549 * So we get the information during startup; but this means that
550 * any changes during run-time will be lost after resume.
552 void ide_acpi_init_port(ide_hwif_t
*hwif
)
554 hwif
->acpidata
= kzalloc(sizeof(struct ide_acpi_hwif_link
), GFP_KERNEL
);
558 hwif
->acpidata
->obj_handle
= ide_acpi_hwif_get_handle(hwif
);
559 if (!hwif
->acpidata
->obj_handle
) {
560 DEBPRINT("no ACPI object for %s found\n", hwif
->name
);
561 kfree(hwif
->acpidata
);
562 hwif
->acpidata
= NULL
;
566 void ide_acpi_port_init_devices(ide_hwif_t
*hwif
)
571 if (hwif
->acpidata
== NULL
)
575 * The ACPI spec mandates that we send information
576 * for both drives, regardless whether they are connected
579 hwif
->devices
[0]->acpidata
= &hwif
->acpidata
->master
;
580 hwif
->devices
[1]->acpidata
= &hwif
->acpidata
->slave
;
582 /* get _ADR info for each device */
583 ide_port_for_each_present_dev(i
, drive
, hwif
) {
584 acpi_handle dev_handle
;
586 DEBPRINT("ENTER: %s at channel#: %d port#: %d\n",
587 drive
->name
, hwif
->channel
, drive
->dn
& 1);
589 /* TBD: could also check ACPI object VALID bits */
590 dev_handle
= acpi_get_child(hwif
->acpidata
->obj_handle
,
593 DEBPRINT("drive %s handle 0x%p\n", drive
->name
, dev_handle
);
595 drive
->acpidata
->obj_handle
= dev_handle
;
598 /* send IDENTIFY for each device */
599 ide_port_for_each_present_dev(i
, drive
, hwif
) {
600 err
= taskfile_lib_get_identify(drive
, drive
->acpidata
->idbuff
);
602 DEBPRINT("identify device %s failed (%d)\n",
606 if (ide_noacpi
|| ide_acpionboot
== 0) {
607 DEBPRINT("ACPI methods disabled on boot\n");
611 /* ACPI _PS0 before _STM */
612 ide_acpi_set_state(hwif
, 1);
614 * ACPI requires us to call _STM on startup
616 ide_acpi_get_timing(hwif
);
617 ide_acpi_push_timing(hwif
);
619 ide_port_for_each_present_dev(i
, drive
, hwif
) {
620 ide_acpi_exec_tfs(drive
);