1cc61c387b68795f3bbd8a1383791a8ecb0fbca8
[platform/kernel/u-boot.git] / include / pci_rom.h
1 /* SPDX-License-Identifier: GPL-2.0+ */
2 /*
3  * From coreboot file of same name
4  */
5
6 #ifndef _PCI_ROM_H
7 #define _PCI_ROM_H
8
9 #define PCI_ROM_HDR                     0xaa55
10
11 struct pci_rom_header {
12         uint16_t signature;
13         uint8_t size;
14         uint8_t init[3];
15         uint8_t reserved[0x12];
16         uint16_t data;
17 };
18
19 struct pci_rom_data {
20         uint32_t signature;
21         uint16_t vendor;
22         uint16_t device;
23         uint16_t reserved_1;
24         uint16_t dlen;
25         uint8_t drevision;
26         uint8_t class_lo;
27         uint16_t class_hi;
28         uint16_t ilen;
29         uint16_t irevision;
30         uint8_t type;
31         uint8_t indicator;
32         uint16_t reserved_2;
33 };
34
35 /*
36  * Determines which execution method is used and whether we allow falling back
37  * to the other if the requested method is not available.
38  */
39 enum pci_rom_emul {
40         PCI_ROM_EMULATE         = 0 << 0,
41         PCI_ROM_USE_NATIVE      = 1 << 0,
42         PCI_ROM_ALLOW_FALLBACK  = 1 << 1,
43 };
44
45  /**
46  * dm_pci_run_vga_bios() - Run the VGA BIOS in an x86 PC
47  *
48  * @dev:        Video device containing the BIOS
49  * @int15_handler:      Function to call to handle int 0x15
50  * @exec_method:        flags from enum pci_rom_emul
51  */
52 int dm_pci_run_vga_bios(struct udevice *dev, int (*int15_handler)(void),
53                         int exec_method);
54
55 /**
56  * board_map_oprom_vendev() - map several PCI IDs to the one the ROM expects
57  *
58  * Some VGA option roms are used for several chipsets but they only have one
59  * PCI ID in their header. If we encounter such an option rom, we need to do
60  * the mapping ourselves.
61  *
62  * @vendev:     Vendor and device for the video device
63  * Return: standard vendor and device expected by the ROM
64  */
65 uint32_t board_map_oprom_vendev(uint32_t vendev);
66
67 #endif