hc
2024-08-16 a24a44ff9ca902811b99aa9663d697cf452e08ef
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
/* SPDX-License-Identifier: GPL-2.0-only */
/*
 * coreboot_table.h
 *
 * Internal header for coreboot table access.
 *
 * Copyright 2014 Gerd Hoffmann <kraxel@redhat.com>
 * Copyright 2017 Google Inc.
 * Copyright 2017 Samuel Holland <samuel@sholland.org>
 */
 
#ifndef __COREBOOT_TABLE_H
#define __COREBOOT_TABLE_H
 
#include <linux/device.h>
 
/* Coreboot table header structure */
struct coreboot_table_header {
   char signature[4];
   u32 header_bytes;
   u32 header_checksum;
   u32 table_bytes;
   u32 table_checksum;
   u32 table_entries;
};
 
/* List of coreboot entry structures that is used */
/* Generic */
struct coreboot_table_entry {
   u32 tag;
   u32 size;
};
 
/* Points to a CBMEM entry */
struct lb_cbmem_ref {
   u32 tag;
   u32 size;
 
   u64 cbmem_addr;
};
 
/* Describes framebuffer setup by coreboot */
struct lb_framebuffer {
   u32 tag;
   u32 size;
 
   u64 physical_address;
   u32 x_resolution;
   u32 y_resolution;
   u32 bytes_per_line;
   u8  bits_per_pixel;
   u8  red_mask_pos;
   u8  red_mask_size;
   u8  green_mask_pos;
   u8  green_mask_size;
   u8  blue_mask_pos;
   u8  blue_mask_size;
   u8  reserved_mask_pos;
   u8  reserved_mask_size;
};
 
/* A device, additionally with information from coreboot. */
struct coreboot_device {
   struct device dev;
   union {
       struct coreboot_table_entry entry;
       struct lb_cbmem_ref cbmem_ref;
       struct lb_framebuffer framebuffer;
   };
};
 
/* A driver for handling devices described in coreboot tables. */
struct coreboot_driver {
   int (*probe)(struct coreboot_device *);
   int (*remove)(struct coreboot_device *);
   struct device_driver drv;
   u32 tag;
};
 
/* Register a driver that uses the data from a coreboot table. */
int coreboot_driver_register(struct coreboot_driver *driver);
 
/* Unregister a driver that uses the data from a coreboot table. */
void coreboot_driver_unregister(struct coreboot_driver *driver);
 
/* module_coreboot_driver() - Helper macro for drivers that don't do
 * anything special in module init/exit.  This eliminates a lot of
 * boilerplate.  Each module may only use this macro once, and
 * calling it replaces module_init() and module_exit()
 */
#define module_coreboot_driver(__coreboot_driver) \
   module_driver(__coreboot_driver, coreboot_driver_register, \
           coreboot_driver_unregister)
 
#endif /* __COREBOOT_TABLE_H */