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 Parametes 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/edd30/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, .owner = THIS_MODULE }, \
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 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 p += scnprintf(p, left,
156 "\t%02x:%02x.%d channel: %u\n",
157 info->params.interface_path.pci.bus,
158 info->params.interface_path.pci.slot,
159 info->params.interface_path.pci.function,
160 info->params.interface_path.pci.channel);
161 } else if (!strncmp(info->params.host_bus_type, "IBND", 4) ||
162 !strncmp(info->params.host_bus_type, "XPRS", 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;
534 int i, nonzero_path = 0;
539 info = edd_dev_get_info(edev);
543 if (!(info->params.key == 0xBEDD || info->params.key == 0xDDBE)) {
547 for (i = 30; i <= 73; i++) {
548 c = *(((uint8_t *) info) + i + 4);
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 ktype_edd = {
629 .release = edd_release,
630 .sysfs_ops = &edd_attr_ops,
631 .default_attrs = def_attrs,
634 static decl_subsys(edd,&ktype_edd,NULL);
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")) {
672 return pci_find_slot(info->params.interface_path.pci.bus,
673 PCI_DEVFN(info->params.interface_path.pci.slot,
674 info->params.interface_path.pci.
681 edd_create_symlink_to_pcidev(struct edd_device *edev)
684 struct pci_dev *pci_dev = edd_get_pci_dev(edev);
687 return sysfs_create_link(&edev->kobj,&pci_dev->dev.kobj,"pci_dev");
691 edd_device_unregister(struct edd_device *edev)
693 kobject_unregister(&edev->kobj);
696 static void edd_populate_dir(struct edd_device * edev)
698 struct edd_attribute * attr;
702 for (i = 0; (attr = edd_attrs[i]) && !error; i++) {
704 (attr->test && attr->test(edev)))
705 error = sysfs_create_file(&edev->kobj,&attr->attr);
709 edd_create_symlink_to_pcidev(edev);
714 edd_device_register(struct edd_device *edev, int i)
720 edd_dev_set_info(edev, i);
721 kobject_set_name(&edev->kobj, "int13_dev%02x",
723 kobj_set_kset_s(edev,edd_subsys);
724 error = kobject_register(&edev->kobj);
726 edd_populate_dir(edev);
730 static inline int edd_num_devices(void)
732 return max_t(unsigned char,
733 min_t(unsigned char, EDD_MBR_SIG_MAX, edd.mbr_signature_nr),
734 min_t(unsigned char, EDDMAXNR, edd.edd_info_nr));
738 * edd_init() - creates sysfs tree of EDD data
745 struct edd_device *edev;
747 printk(KERN_INFO "BIOS EDD facility v%s %s, %d devices found\n",
748 EDD_VERSION, EDD_DATE, edd_num_devices());
750 if (!edd_num_devices()) {
751 printk(KERN_INFO "EDD information not available.\n");
755 rc = firmware_register(&edd_subsys);
759 for (i = 0; i < edd_num_devices() && !rc; i++) {
760 edev = kzalloc(sizeof (*edev), GFP_KERNEL);
764 rc = edd_device_register(edev, i);
769 edd_devices[i] = edev;
773 firmware_unregister(&edd_subsys);
781 struct edd_device *edev;
783 for (i = 0; i < edd_num_devices(); i++) {
784 if ((edev = edd_devices[i]))
785 edd_device_unregister(edev);
787 firmware_unregister(&edd_subsys);
790 late_initcall(edd_init);
791 module_exit(edd_exit);