1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * linux/include/linux/edd.h
4  *  Copyright (C) 2002, 2003, 2004 Dell Inc.
5  *  by Matt Domsch <Matt_Domsch@dell.com>
6  *
7  * structures and definitions for the int 13h, ax={41,48}h
8  * BIOS Enhanced Disk Drive Services
9  * This is based on the T13 group document D1572 Revision 0 (August 14 2002)
10  * available at http://www.t13.org/docs2002/d1572r0.pdf.  It is
11  * very similar to D1484 Revision 3 http://www.t13.org/docs2002/d1484r3.pdf
12  *
13  * In a nutshell, arch/{i386,x86_64}/boot/setup.S populates a scratch
14  * table in the boot_params that contains a list of BIOS-enumerated
15  * boot devices.
16  * In arch/{i386,x86_64}/kernel/setup.c, this information is
17  * transferred into the edd structure, and in drivers/firmware/edd.c, that
18  * information is used to identify BIOS boot disk.  The code in setup.S
19  * is very sensitive to the size of these structures.
20  */
21 #ifndef _LINUX_EDD_H
22 #define _LINUX_EDD_H
23 
24 #include <linux/types.h>
25 
26 #define EDDNR 0x1e9		/* addr of number of edd_info structs at EDDBUF
27 				   in boot_params - treat this as 1 byte  */
28 #define EDDBUF	0xd00		/* addr of edd_info structs in boot_params */
29 #define EDDMAXNR 6		/* number of edd_info structs starting at EDDBUF  */
30 #define EDDEXTSIZE 8		/* change these if you muck with the structures */
31 #define EDDPARMSIZE 74
32 #define CHECKEXTENSIONSPRESENT 0x41
33 #define GETDEVICEPARAMETERS 0x48
34 #define LEGACYGETDEVICEPARAMETERS 0x08
35 #define EDDMAGIC1 0x55AA
36 #define EDDMAGIC2 0xAA55
37 
38 #define READ_SECTORS 0x02         /* int13 AH=0x02 is READ_SECTORS command */
39 #define EDD_MBR_SIG_OFFSET 0x1B8  /* offset of signature in the MBR */
40 #define EDD_MBR_SIG_BUF    0x290  /* addr in boot params */
41 #define EDD_MBR_SIG_MAX 16        /* max number of signatures to store */
42 #define EDD_MBR_SIG_NR_BUF 0x1ea  /* addr of number of MBR signtaures at EDD_MBR_SIG_BUF
43 				     in boot_params - treat this as 1 byte  */
44 
45 #ifndef __ASSEMBLY__
46 
47 #define EDD_EXT_FIXED_DISK_ACCESS           (1 << 0)
48 #define EDD_EXT_DEVICE_LOCKING_AND_EJECTING (1 << 1)
49 #define EDD_EXT_ENHANCED_DISK_DRIVE_SUPPORT (1 << 2)
50 #define EDD_EXT_64BIT_EXTENSIONS            (1 << 3)
51 
52 #define EDD_INFO_DMA_BOUNDARY_ERROR_TRANSPARENT (1 << 0)
53 #define EDD_INFO_GEOMETRY_VALID                (1 << 1)
54 #define EDD_INFO_REMOVABLE                     (1 << 2)
55 #define EDD_INFO_WRITE_VERIFY                  (1 << 3)
56 #define EDD_INFO_MEDIA_CHANGE_NOTIFICATION     (1 << 4)
57 #define EDD_INFO_LOCKABLE                      (1 << 5)
58 #define EDD_INFO_NO_MEDIA_PRESENT              (1 << 6)
59 #define EDD_INFO_USE_INT13_FN50                (1 << 7)
60 
61 struct edd_device_params {
62 	__u16 length;
63 	__u16 info_flags;
64 	__u32 num_default_cylinders;
65 	__u32 num_default_heads;
66 	__u32 sectors_per_track;
67 	__u64 number_of_sectors;
68 	__u16 bytes_per_sector;
69 	__u32 dpte_ptr;		/* 0xFFFFFFFF for our purposes */
70 	__u16 key;		/* = 0xBEDD */
71 	__u8 device_path_info_length;	/* = 44 */
72 	__u8 reserved2;
73 	__u16 reserved3;
74 	__u8 host_bus_type[4];
75 	__u8 interface_type[8];
76 	union {
77 		struct {
78 			__u16 base_address;
79 			__u16 reserved1;
80 			__u32 reserved2;
81 		} __attribute__ ((packed)) isa;
82 		struct {
83 			__u8 bus;
84 			__u8 slot;
85 			__u8 function;
86 			__u8 channel;
87 			__u32 reserved;
88 		} __attribute__ ((packed)) pci;
89 		/* pcix is same as pci */
90 		struct {
91 			__u64 reserved;
92 		} __attribute__ ((packed)) ibnd;
93 		struct {
94 			__u64 reserved;
95 		} __attribute__ ((packed)) xprs;
96 		struct {
97 			__u64 reserved;
98 		} __attribute__ ((packed)) htpt;
99 		struct {
100 			__u64 reserved;
101 		} __attribute__ ((packed)) unknown;
102 	} interface_path;
103 	union {
104 		struct {
105 			__u8 device;
106 			__u8 reserved1;
107 			__u16 reserved2;
108 			__u32 reserved3;
109 			__u64 reserved4;
110 		} __attribute__ ((packed)) ata;
111 		struct {
112 			__u8 device;
113 			__u8 lun;
114 			__u8 reserved1;
115 			__u8 reserved2;
116 			__u32 reserved3;
117 			__u64 reserved4;
118 		} __attribute__ ((packed)) atapi;
119 		struct {
120 			__u16 id;
121 			__u64 lun;
122 			__u16 reserved1;
123 			__u32 reserved2;
124 		} __attribute__ ((packed)) scsi;
125 		struct {
126 			__u64 serial_number;
127 			__u64 reserved;
128 		} __attribute__ ((packed)) usb;
129 		struct {
130 			__u64 eui;
131 			__u64 reserved;
132 		} __attribute__ ((packed)) i1394;
133 		struct {
134 			__u64 wwid;
135 			__u64 lun;
136 		} __attribute__ ((packed)) fibre;
137 		struct {
138 			__u64 identity_tag;
139 			__u64 reserved;
140 		} __attribute__ ((packed)) i2o;
141 		struct {
142 			__u32 array_number;
143 			__u32 reserved1;
144 			__u64 reserved2;
145 		} __attribute__ ((packed)) raid;
146 		struct {
147 			__u8 device;
148 			__u8 reserved1;
149 			__u16 reserved2;
150 			__u32 reserved3;
151 			__u64 reserved4;
152 		} __attribute__ ((packed)) sata;
153 		struct {
154 			__u64 reserved1;
155 			__u64 reserved2;
156 		} __attribute__ ((packed)) unknown;
157 	} device_path;
158 	__u8 reserved4;
159 	__u8 checksum;
160 } __attribute__ ((packed));
161 
162 struct edd_info {
163 	__u8 device;
164 	__u8 version;
165 	__u16 interface_support;
166 	__u16 legacy_max_cylinder;
167 	__u8 legacy_max_head;
168 	__u8 legacy_sectors_per_track;
169 	struct edd_device_params params;
170 } __attribute__ ((packed));
171 
172 struct edd {
173 	unsigned int mbr_signature[EDD_MBR_SIG_MAX];
174 	struct edd_info edd_info[EDDMAXNR];
175 	unsigned char mbr_signature_nr;
176 	unsigned char edd_info_nr;
177 };
178 
179 #ifdef __KERNEL__
180 extern struct edd edd;
181 #endif /* __KERNEL__ */
182 #endif				/*!__ASSEMBLY__ */
183 
184 #endif				/* _LINUX_EDD_H */
185