2 * linux/drivers/firmware/edd.c
3 * Copyright (C) 2002, 2003, 2004 Dell Inc.
4 * by Matt Domsch <Matt_Domsch@dell.com>
5 * disk signature by Matt Domsch, Andrew Wilks, and Sandeep K. Shandilya
6 * legacy CHS by Patrick J. LoPresti <patl@users.sourceforge.net>
8 * BIOS Enhanced Disk Drive Services (EDD)
9 * conformant to T13 Committee www.t13.org
10 * projects 1572D, 1484D, 1386D, 1226DT
12 * This code takes information provided by BIOS EDD calls
13 * fn41 - Check Extensions Present and
14 * fn48 - Get Device Parameters with EDD extensions
15 * made in setup.S, copied to safe structures in setup.c,
16 * and presents it in sysfs.
18 * Please see http://linux.dell.com/edd/results.html for
19 * the list of BIOSs which have been reported to implement EDD.
21 * This program is free software; you can redistribute it and/or modify
22 * it under the terms of the GNU General Public License v2.0 as published by
23 * the Free Software Foundation
25 * This program is distributed in the hope that it will be useful,
26 * but WITHOUT ANY WARRANTY; without even the implied warranty of
27 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
28 * GNU General Public License for more details.
32 #include <linux/module.h>
33 #include <linux/string.h>
34 #include <linux/types.h>
35 #include <linux/init.h>
36 #include <linux/stat.h>
37 #include <linux/err.h>
38 #include <linux/ctype.h>
39 #include <linux/slab.h>
40 #include <linux/limits.h>
41 #include <linux/device.h>
42 #include <linux/pci.h>
43 #include <linux/blkdev.h>
44 #include <linux/edd.h>
46 #define EDD_VERSION "0.16"
47 #define EDD_DATE "2004-Jun-25"
49 MODULE_AUTHOR("Matt Domsch <Matt_Domsch@Dell.com>");
50 MODULE_DESCRIPTION("sysfs interface to BIOS EDD information");
51 MODULE_LICENSE("GPL");
52 MODULE_VERSION(EDD_VERSION
);
54 #define left (PAGE_SIZE - (p - buf) - 1)
58 unsigned int mbr_signature
;
59 struct edd_info
*info
;
63 struct edd_attribute
{
64 struct attribute attr
;
65 ssize_t(*show
) (struct edd_device
* edev
, char *buf
);
66 int (*test
) (struct edd_device
* edev
);
69 /* forward declarations */
70 static int edd_dev_is_type(struct edd_device
*edev
, const char *type
);
71 static struct pci_dev
*edd_get_pci_dev(struct edd_device
*edev
);
73 static struct edd_device
*edd_devices
[EDD_MBR_SIG_MAX
];
75 #define EDD_DEVICE_ATTR(_name,_mode,_show,_test) \
76 struct edd_attribute edd_attr_##_name = { \
77 .attr = {.name = __stringify(_name), .mode = _mode }, \
83 edd_has_mbr_signature(struct edd_device
*edev
)
85 return edev
->index
< min_t(unsigned char, edd
.mbr_signature_nr
, EDD_MBR_SIG_MAX
);
89 edd_has_edd_info(struct edd_device
*edev
)
91 return edev
->index
< min_t(unsigned char, edd
.edd_info_nr
, EDDMAXNR
);
94 static inline struct edd_info
*
95 edd_dev_get_info(struct edd_device
*edev
)
101 edd_dev_set_info(struct edd_device
*edev
, int i
)
104 if (edd_has_mbr_signature(edev
))
105 edev
->mbr_signature
= edd
.mbr_signature
[i
];
106 if (edd_has_edd_info(edev
))
107 edev
->info
= &edd
.edd_info
[i
];
110 #define to_edd_attr(_attr) container_of(_attr,struct edd_attribute,attr)
111 #define to_edd_device(obj) container_of(obj,struct edd_device,kobj)
114 edd_attr_show(struct kobject
* kobj
, struct attribute
*attr
, char *buf
)
116 struct edd_device
*dev
= to_edd_device(kobj
);
117 struct edd_attribute
*edd_attr
= to_edd_attr(attr
);
121 ret
= edd_attr
->show(dev
, buf
);
125 static const struct sysfs_ops edd_attr_ops
= {
126 .show
= edd_attr_show
,
130 edd_show_host_bus(struct edd_device
*edev
, char *buf
)
132 struct edd_info
*info
;
138 info
= edd_dev_get_info(edev
);
142 for (i
= 0; i
< 4; i
++) {
143 if (isprint(info
->params
.host_bus_type
[i
])) {
144 p
+= scnprintf(p
, left
, "%c", info
->params
.host_bus_type
[i
]);
146 p
+= scnprintf(p
, left
, " ");
150 if (!strncmp(info
->params
.host_bus_type
, "ISA", 3)) {
151 p
+= scnprintf(p
, left
, "\tbase_address: %x\n",
152 info
->params
.interface_path
.isa
.base_address
);
153 } else if (!strncmp(info
->params
.host_bus_type
, "PCIX", 4) ||
154 !strncmp(info
->params
.host_bus_type
, "PCI", 3) ||
155 !strncmp(info
->params
.host_bus_type
, "XPRS", 4)) {
156 p
+= scnprintf(p
, left
,
157 "\t%02x:%02x.%d channel: %u\n",
158 info
->params
.interface_path
.pci
.bus
,
159 info
->params
.interface_path
.pci
.slot
,
160 info
->params
.interface_path
.pci
.function
,
161 info
->params
.interface_path
.pci
.channel
);
162 } else if (!strncmp(info
->params
.host_bus_type
, "IBND", 4) ||
163 !strncmp(info
->params
.host_bus_type
, "HTPT", 4)) {
164 p
+= scnprintf(p
, left
,
166 info
->params
.interface_path
.ibnd
.reserved
);
169 p
+= scnprintf(p
, left
, "\tunknown: %llx\n",
170 info
->params
.interface_path
.unknown
.reserved
);
176 edd_show_interface(struct edd_device
*edev
, char *buf
)
178 struct edd_info
*info
;
184 info
= edd_dev_get_info(edev
);
188 for (i
= 0; i
< 8; i
++) {
189 if (isprint(info
->params
.interface_type
[i
])) {
190 p
+= scnprintf(p
, left
, "%c", info
->params
.interface_type
[i
]);
192 p
+= scnprintf(p
, left
, " ");
195 if (!strncmp(info
->params
.interface_type
, "ATAPI", 5)) {
196 p
+= scnprintf(p
, left
, "\tdevice: %u lun: %u\n",
197 info
->params
.device_path
.atapi
.device
,
198 info
->params
.device_path
.atapi
.lun
);
199 } else if (!strncmp(info
->params
.interface_type
, "ATA", 3)) {
200 p
+= scnprintf(p
, left
, "\tdevice: %u\n",
201 info
->params
.device_path
.ata
.device
);
202 } else if (!strncmp(info
->params
.interface_type
, "SCSI", 4)) {
203 p
+= scnprintf(p
, left
, "\tid: %u lun: %llu\n",
204 info
->params
.device_path
.scsi
.id
,
205 info
->params
.device_path
.scsi
.lun
);
206 } else if (!strncmp(info
->params
.interface_type
, "USB", 3)) {
207 p
+= scnprintf(p
, left
, "\tserial_number: %llx\n",
208 info
->params
.device_path
.usb
.serial_number
);
209 } else if (!strncmp(info
->params
.interface_type
, "1394", 4)) {
210 p
+= scnprintf(p
, left
, "\teui: %llx\n",
211 info
->params
.device_path
.i1394
.eui
);
212 } else if (!strncmp(info
->params
.interface_type
, "FIBRE", 5)) {
213 p
+= scnprintf(p
, left
, "\twwid: %llx lun: %llx\n",
214 info
->params
.device_path
.fibre
.wwid
,
215 info
->params
.device_path
.fibre
.lun
);
216 } else if (!strncmp(info
->params
.interface_type
, "I2O", 3)) {
217 p
+= scnprintf(p
, left
, "\tidentity_tag: %llx\n",
218 info
->params
.device_path
.i2o
.identity_tag
);
219 } else if (!strncmp(info
->params
.interface_type
, "RAID", 4)) {
220 p
+= scnprintf(p
, left
, "\tidentity_tag: %x\n",
221 info
->params
.device_path
.raid
.array_number
);
222 } else if (!strncmp(info
->params
.interface_type
, "SATA", 4)) {
223 p
+= scnprintf(p
, left
, "\tdevice: %u\n",
224 info
->params
.device_path
.sata
.device
);
226 p
+= scnprintf(p
, left
, "\tunknown: %llx %llx\n",
227 info
->params
.device_path
.unknown
.reserved1
,
228 info
->params
.device_path
.unknown
.reserved2
);
235 * edd_show_raw_data() - copies raw data to buffer for userspace to parse
236 * @edev: target edd_device
237 * @buf: output buffer
239 * Returns: number of bytes written, or -EINVAL on failure
242 edd_show_raw_data(struct edd_device
*edev
, char *buf
)
244 struct edd_info
*info
;
245 ssize_t len
= sizeof (info
->params
);
248 info
= edd_dev_get_info(edev
);
252 if (!(info
->params
.key
== 0xBEDD || info
->params
.key
== 0xDDBE))
253 len
= info
->params
.length
;
255 /* In case of buggy BIOSs */
256 if (len
> (sizeof(info
->params
)))
257 len
= sizeof(info
->params
);
259 memcpy(buf
, &info
->params
, len
);
264 edd_show_version(struct edd_device
*edev
, char *buf
)
266 struct edd_info
*info
;
270 info
= edd_dev_get_info(edev
);
274 p
+= scnprintf(p
, left
, "0x%02x\n", info
->version
);
279 edd_show_mbr_signature(struct edd_device
*edev
, char *buf
)
282 p
+= scnprintf(p
, left
, "0x%08x\n", edev
->mbr_signature
);
287 edd_show_extensions(struct edd_device
*edev
, char *buf
)
289 struct edd_info
*info
;
293 info
= edd_dev_get_info(edev
);
297 if (info
->interface_support
& EDD_EXT_FIXED_DISK_ACCESS
) {
298 p
+= scnprintf(p
, left
, "Fixed disk access\n");
300 if (info
->interface_support
& EDD_EXT_DEVICE_LOCKING_AND_EJECTING
) {
301 p
+= scnprintf(p
, left
, "Device locking and ejecting\n");
303 if (info
->interface_support
& EDD_EXT_ENHANCED_DISK_DRIVE_SUPPORT
) {
304 p
+= scnprintf(p
, left
, "Enhanced Disk Drive support\n");
306 if (info
->interface_support
& EDD_EXT_64BIT_EXTENSIONS
) {
307 p
+= scnprintf(p
, left
, "64-bit extensions\n");
313 edd_show_info_flags(struct edd_device
*edev
, char *buf
)
315 struct edd_info
*info
;
319 info
= edd_dev_get_info(edev
);
323 if (info
->params
.info_flags
& EDD_INFO_DMA_BOUNDARY_ERROR_TRANSPARENT
)
324 p
+= scnprintf(p
, left
, "DMA boundary error transparent\n");
325 if (info
->params
.info_flags
& EDD_INFO_GEOMETRY_VALID
)
326 p
+= scnprintf(p
, left
, "geometry valid\n");
327 if (info
->params
.info_flags
& EDD_INFO_REMOVABLE
)
328 p
+= scnprintf(p
, left
, "removable\n");
329 if (info
->params
.info_flags
& EDD_INFO_WRITE_VERIFY
)
330 p
+= scnprintf(p
, left
, "write verify\n");
331 if (info
->params
.info_flags
& EDD_INFO_MEDIA_CHANGE_NOTIFICATION
)
332 p
+= scnprintf(p
, left
, "media change notification\n");
333 if (info
->params
.info_flags
& EDD_INFO_LOCKABLE
)
334 p
+= scnprintf(p
, left
, "lockable\n");
335 if (info
->params
.info_flags
& EDD_INFO_NO_MEDIA_PRESENT
)
336 p
+= scnprintf(p
, left
, "no media present\n");
337 if (info
->params
.info_flags
& EDD_INFO_USE_INT13_FN50
)
338 p
+= scnprintf(p
, left
, "use int13 fn50\n");
343 edd_show_legacy_max_cylinder(struct edd_device
*edev
, char *buf
)
345 struct edd_info
*info
;
349 info
= edd_dev_get_info(edev
);
353 p
+= snprintf(p
, left
, "%u\n", info
->legacy_max_cylinder
);
358 edd_show_legacy_max_head(struct edd_device
*edev
, char *buf
)
360 struct edd_info
*info
;
364 info
= edd_dev_get_info(edev
);
368 p
+= snprintf(p
, left
, "%u\n", info
->legacy_max_head
);
373 edd_show_legacy_sectors_per_track(struct edd_device
*edev
, char *buf
)
375 struct edd_info
*info
;
379 info
= edd_dev_get_info(edev
);
383 p
+= snprintf(p
, left
, "%u\n", info
->legacy_sectors_per_track
);
388 edd_show_default_cylinders(struct edd_device
*edev
, char *buf
)
390 struct edd_info
*info
;
394 info
= edd_dev_get_info(edev
);
398 p
+= scnprintf(p
, left
, "%u\n", info
->params
.num_default_cylinders
);
403 edd_show_default_heads(struct edd_device
*edev
, char *buf
)
405 struct edd_info
*info
;
409 info
= edd_dev_get_info(edev
);
413 p
+= scnprintf(p
, left
, "%u\n", info
->params
.num_default_heads
);
418 edd_show_default_sectors_per_track(struct edd_device
*edev
, char *buf
)
420 struct edd_info
*info
;
424 info
= edd_dev_get_info(edev
);
428 p
+= scnprintf(p
, left
, "%u\n", info
->params
.sectors_per_track
);
433 edd_show_sectors(struct edd_device
*edev
, char *buf
)
435 struct edd_info
*info
;
439 info
= edd_dev_get_info(edev
);
443 p
+= scnprintf(p
, left
, "%llu\n", info
->params
.number_of_sectors
);
449 * Some device instances may not have all the above attributes,
450 * or the attribute values may be meaningless (i.e. if
451 * the device is < EDD 3.0, it won't have host_bus and interface
452 * information), so don't bother making files for them. Likewise
453 * if the default_{cylinders,heads,sectors_per_track} values
454 * are zero, the BIOS doesn't provide sane values, don't bother
455 * creating files for them either.
459 edd_has_legacy_max_cylinder(struct edd_device
*edev
)
461 struct edd_info
*info
;
464 info
= edd_dev_get_info(edev
);
467 return info
->legacy_max_cylinder
> 0;
471 edd_has_legacy_max_head(struct edd_device
*edev
)
473 struct edd_info
*info
;
476 info
= edd_dev_get_info(edev
);
479 return info
->legacy_max_head
> 0;
483 edd_has_legacy_sectors_per_track(struct edd_device
*edev
)
485 struct edd_info
*info
;
488 info
= edd_dev_get_info(edev
);
491 return info
->legacy_sectors_per_track
> 0;
495 edd_has_default_cylinders(struct edd_device
*edev
)
497 struct edd_info
*info
;
500 info
= edd_dev_get_info(edev
);
503 return info
->params
.num_default_cylinders
> 0;
507 edd_has_default_heads(struct edd_device
*edev
)
509 struct edd_info
*info
;
512 info
= edd_dev_get_info(edev
);
515 return info
->params
.num_default_heads
> 0;
519 edd_has_default_sectors_per_track(struct edd_device
*edev
)
521 struct edd_info
*info
;
524 info
= edd_dev_get_info(edev
);
527 return info
->params
.sectors_per_track
> 0;
531 edd_has_edd30(struct edd_device
*edev
)
533 struct edd_info
*info
;
539 info
= edd_dev_get_info(edev
);
543 if (!(info
->params
.key
== 0xBEDD || info
->params
.key
== 0xDDBE)) {
548 /* We support only T13 spec */
549 if (info
->params
.device_path_info_length
!= 44)
552 for (i
= 30; i
< info
->params
.device_path_info_length
+ 30; i
++)
553 csum
+= *(((u8
*)&info
->params
) + i
);
562 static EDD_DEVICE_ATTR(raw_data
, 0444, edd_show_raw_data
, edd_has_edd_info
);
563 static EDD_DEVICE_ATTR(version
, 0444, edd_show_version
, edd_has_edd_info
);
564 static EDD_DEVICE_ATTR(extensions
, 0444, edd_show_extensions
, edd_has_edd_info
);
565 static EDD_DEVICE_ATTR(info_flags
, 0444, edd_show_info_flags
, edd_has_edd_info
);
566 static EDD_DEVICE_ATTR(sectors
, 0444, edd_show_sectors
, edd_has_edd_info
);
567 static EDD_DEVICE_ATTR(legacy_max_cylinder
, 0444,
568 edd_show_legacy_max_cylinder
,
569 edd_has_legacy_max_cylinder
);
570 static EDD_DEVICE_ATTR(legacy_max_head
, 0444, edd_show_legacy_max_head
,
571 edd_has_legacy_max_head
);
572 static EDD_DEVICE_ATTR(legacy_sectors_per_track
, 0444,
573 edd_show_legacy_sectors_per_track
,
574 edd_has_legacy_sectors_per_track
);
575 static EDD_DEVICE_ATTR(default_cylinders
, 0444, edd_show_default_cylinders
,
576 edd_has_default_cylinders
);
577 static EDD_DEVICE_ATTR(default_heads
, 0444, edd_show_default_heads
,
578 edd_has_default_heads
);
579 static EDD_DEVICE_ATTR(default_sectors_per_track
, 0444,
580 edd_show_default_sectors_per_track
,
581 edd_has_default_sectors_per_track
);
582 static EDD_DEVICE_ATTR(interface
, 0444, edd_show_interface
, edd_has_edd30
);
583 static EDD_DEVICE_ATTR(host_bus
, 0444, edd_show_host_bus
, edd_has_edd30
);
584 static EDD_DEVICE_ATTR(mbr_signature
, 0444, edd_show_mbr_signature
, edd_has_mbr_signature
);
587 /* These are default attributes that are added for every edd
588 * device discovered. There are none.
590 static struct attribute
* def_attrs
[] = {
594 /* These attributes are conditional and only added for some devices. */
595 static struct edd_attribute
* edd_attrs
[] = {
598 &edd_attr_extensions
,
599 &edd_attr_info_flags
,
601 &edd_attr_legacy_max_cylinder
,
602 &edd_attr_legacy_max_head
,
603 &edd_attr_legacy_sectors_per_track
,
604 &edd_attr_default_cylinders
,
605 &edd_attr_default_heads
,
606 &edd_attr_default_sectors_per_track
,
609 &edd_attr_mbr_signature
,
614 * edd_release - free edd structure
615 * @kobj: kobject of edd structure
617 * This is called when the refcount of the edd structure
618 * reaches 0. This should happen right after we unregister,
619 * but just in case, we use the release callback anyway.
622 static void edd_release(struct kobject
* kobj
)
624 struct edd_device
* dev
= to_edd_device(kobj
);
628 static struct kobj_type edd_ktype
= {
629 .release
= edd_release
,
630 .sysfs_ops
= &edd_attr_ops
,
631 .default_attrs
= def_attrs
,
634 static struct kset
*edd_kset
;
638 * edd_dev_is_type() - is this EDD device a 'type' device?
639 * @edev: target edd_device
640 * @type: a host bus or interface identifier string per the EDD spec
642 * Returns 1 (TRUE) if it is a 'type' device, 0 otherwise.
645 edd_dev_is_type(struct edd_device
*edev
, const char *type
)
647 struct edd_info
*info
;
650 info
= edd_dev_get_info(edev
);
653 if (!strncmp(info
->params
.host_bus_type
, type
, strlen(type
)) ||
654 !strncmp(info
->params
.interface_type
, type
, strlen(type
)))
661 * edd_get_pci_dev() - finds pci_dev that matches edev
664 * Returns pci_dev if found, or NULL
666 static struct pci_dev
*
667 edd_get_pci_dev(struct edd_device
*edev
)
669 struct edd_info
*info
= edd_dev_get_info(edev
);
671 if (edd_dev_is_type(edev
, "PCI") || edd_dev_is_type(edev
, "XPRS")) {
672 return pci_get_domain_bus_and_slot(0,
673 info
->params
.interface_path
.pci
.bus
,
674 PCI_DEVFN(info
->params
.interface_path
.pci
.slot
,
675 info
->params
.interface_path
.pci
.function
));
681 edd_create_symlink_to_pcidev(struct edd_device
*edev
)
684 struct pci_dev
*pci_dev
= edd_get_pci_dev(edev
);
688 ret
= sysfs_create_link(&edev
->kobj
,&pci_dev
->dev
.kobj
,"pci_dev");
689 pci_dev_put(pci_dev
);
694 edd_device_unregister(struct edd_device
*edev
)
696 kobject_put(&edev
->kobj
);
699 static void edd_populate_dir(struct edd_device
* edev
)
701 struct edd_attribute
* attr
;
705 for (i
= 0; (attr
= edd_attrs
[i
]) && !error
; i
++) {
707 (attr
->test
&& attr
->test(edev
)))
708 error
= sysfs_create_file(&edev
->kobj
,&attr
->attr
);
712 edd_create_symlink_to_pcidev(edev
);
717 edd_device_register(struct edd_device
*edev
, int i
)
723 edd_dev_set_info(edev
, i
);
724 edev
->kobj
.kset
= edd_kset
;
725 error
= kobject_init_and_add(&edev
->kobj
, &edd_ktype
, NULL
,
726 "int13_dev%02x", 0x80 + i
);
728 edd_populate_dir(edev
);
729 kobject_uevent(&edev
->kobj
, KOBJ_ADD
);
734 static inline int edd_num_devices(void)
736 return max_t(unsigned char,
737 min_t(unsigned char, EDD_MBR_SIG_MAX
, edd
.mbr_signature_nr
),
738 min_t(unsigned char, EDDMAXNR
, edd
.edd_info_nr
));
742 * edd_init() - creates sysfs tree of EDD data
749 struct edd_device
*edev
;
751 if (!edd_num_devices())
754 printk(KERN_INFO
"BIOS EDD facility v%s %s, %d devices found\n",
755 EDD_VERSION
, EDD_DATE
, edd_num_devices());
757 edd_kset
= kset_create_and_add("edd", NULL
, firmware_kobj
);
761 for (i
= 0; i
< edd_num_devices(); i
++) {
762 edev
= kzalloc(sizeof (*edev
), GFP_KERNEL
);
768 rc
= edd_device_register(edev
, i
);
773 edd_devices
[i
] = edev
;
780 edd_device_unregister(edd_devices
[i
]);
781 kset_unregister(edd_kset
);
789 struct edd_device
*edev
;
791 for (i
= 0; i
< edd_num_devices(); i
++) {
792 if ((edev
= edd_devices
[i
]))
793 edd_device_unregister(edev
);
795 kset_unregister(edd_kset
);
798 late_initcall(edd_init
);
799 module_exit(edd_exit
);