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
62struct 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
163struct 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
173struct 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__
181extern struct edd edd;
182#endif /* __KERNEL__ */
183#endif				/*!__ASSEMBLY__ */
184
185#endif				/* _LINUX_EDD_H */
186