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 
39 #define READ_SECTORS 0x02         /* int13 AH=0x02 is READ_SECTORS command */
40 #define EDD_MBR_SIG_OFFSET 0x1B8  /* offset of signature in the MBR */
41 #define EDD_MBR_SIG_BUF    0x290  /* addr in boot params */
42 #define EDD_MBR_SIG_MAX 16        /* max number of signatures to store */
43 #define EDD_MBR_SIG_NR_BUF 0x1ea  /* addr of number of MBR signtaures at EDD_MBR_SIG_BUF
44 				     in boot_params - treat this as 1 byte  */
45 
46 #ifndef __ASSEMBLY__
47 
48 #define EDD_EXT_FIXED_DISK_ACCESS           (1 << 0)
49 #define EDD_EXT_DEVICE_LOCKING_AND_EJECTING (1 << 1)
50 #define EDD_EXT_ENHANCED_DISK_DRIVE_SUPPORT (1 << 2)
51 #define EDD_EXT_64BIT_EXTENSIONS            (1 << 3)
52 
53 #define EDD_INFO_DMA_BOUNDARY_ERROR_TRANSPARENT (1 << 0)
54 #define EDD_INFO_GEOMETRY_VALID                (1 << 1)
55 #define EDD_INFO_REMOVABLE                     (1 << 2)
56 #define EDD_INFO_WRITE_VERIFY                  (1 << 3)
57 #define EDD_INFO_MEDIA_CHANGE_NOTIFICATION     (1 << 4)
58 #define EDD_INFO_LOCKABLE                      (1 << 5)
59 #define EDD_INFO_NO_MEDIA_PRESENT              (1 << 6)
60 #define EDD_INFO_USE_INT13_FN50                (1 << 7)
61 
62 struct edd_device_params {
63 	__u16 length;
64 	__u16 info_flags;
65 	__u32 num_default_cylinders;
66 	__u32 num_default_heads;
67 	__u32 sectors_per_track;
68 	__u64 number_of_sectors;
69 	__u16 bytes_per_sector;
70 	__u32 dpte_ptr;		/* 0xFFFFFFFF for our purposes */
71 	__u16 key;		/* = 0xBEDD */
72 	__u8 device_path_info_length;	/* = 44 */
73 	__u8 reserved2;
74 	__u16 reserved3;
75 	__u8 host_bus_type[4];
76 	__u8 interface_type[8];
77 	union {
78 		struct {
79 			__u16 base_address;
80 			__u16 reserved1;
81 			__u32 reserved2;
82 		} __attribute__ ((packed)) isa;
83 		struct {
84 			__u8 bus;
85 			__u8 slot;
86 			__u8 function;
87 			__u8 channel;
88 			__u32 reserved;
89 		} __attribute__ ((packed)) pci;
90 		/* pcix is same as pci */
91 		struct {
92 			__u64 reserved;
93 		} __attribute__ ((packed)) ibnd;
94 		struct {
95 			__u64 reserved;
96 		} __attribute__ ((packed)) xprs;
97 		struct {
98 			__u64 reserved;
99 		} __attribute__ ((packed)) htpt;
100 		struct {
101 			__u64 reserved;
102 		} __attribute__ ((packed)) unknown;
103 	} interface_path;
104 	union {
105 		struct {
106 			__u8 device;
107 			__u8 reserved1;
108 			__u16 reserved2;
109 			__u32 reserved3;
110 			__u64 reserved4;
111 		} __attribute__ ((packed)) ata;
112 		struct {
113 			__u8 device;
114 			__u8 lun;
115 			__u8 reserved1;
116 			__u8 reserved2;
117 			__u32 reserved3;
118 			__u64 reserved4;
119 		} __attribute__ ((packed)) atapi;
120 		struct {
121 			__u16 id;
122 			__u64 lun;
123 			__u16 reserved1;
124 			__u32 reserved2;
125 		} __attribute__ ((packed)) scsi;
126 		struct {
127 			__u64 serial_number;
128 			__u64 reserved;
129 		} __attribute__ ((packed)) usb;
130 		struct {
131 			__u64 eui;
132 			__u64 reserved;
133 		} __attribute__ ((packed)) i1394;
134 		struct {
135 			__u64 wwid;
136 			__u64 lun;
137 		} __attribute__ ((packed)) fibre;
138 		struct {
139 			__u64 identity_tag;
140 			__u64 reserved;
141 		} __attribute__ ((packed)) i2o;
142 		struct {
143 			__u32 array_number;
144 			__u32 reserved1;
145 			__u64 reserved2;
146 		} __attribute__ ((packed)) raid;
147 		struct {
148 			__u8 device;
149 			__u8 reserved1;
150 			__u16 reserved2;
151 			__u32 reserved3;
152 			__u64 reserved4;
153 		} __attribute__ ((packed)) sata;
154 		struct {
155 			__u64 reserved1;
156 			__u64 reserved2;
157 		} __attribute__ ((packed)) unknown;
158 	} device_path;
159 	__u8 reserved4;
160 	__u8 checksum;
161 } __attribute__ ((packed));
162 
163 struct edd_info {
164 	__u8 device;
165 	__u8 version;
166 	__u16 interface_support;
167 	__u16 legacy_max_cylinder;
168 	__u8 legacy_max_head;
169 	__u8 legacy_sectors_per_track;
170 	struct edd_device_params params;
171 } __attribute__ ((packed));
172 
173 struct edd {
174 	unsigned int mbr_signature[EDD_MBR_SIG_MAX];
175 	struct edd_info edd_info[EDDMAXNR];
176 	unsigned char mbr_signature_nr;
177 	unsigned char edd_info_nr;
178 };
179 
180 #ifdef __KERNEL__
181 extern struct edd edd;
182 #endif /* __KERNEL__ */
183 #endif				/*!__ASSEMBLY__ */
184 
185 #endif				/* _LINUX_EDD_H */
186