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