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
|
/* SPDX-License-Identifier: BSD-3-Clause */
#ifndef __VPD_H__
#define __VPD_H__
#include <types.h>
#define GOOGLE_VPD_2_0_OFFSET 0x600
enum vpd_region {
VPD_RO,
VPD_RW,
VPD_RO_THEN_RW,
VPD_RW_THEN_RO
};
/*
* Reads VPD string value by key.
*
* Reads in at most one less than size characters from VPD and stores them
* into buffer. A terminating null byte ('\0') is stored after the last
* character in the buffer.
*
* Returns NULL if key is not found, otherwise buffer.
*/
char *vpd_gets(const char *key, char *buffer, int size, enum vpd_region region);
/*
* Find VPD value by key.
*
* Searches for a VPD entry in the VPD cache. If found, places the size of the
* entry into '*size' and returns the pointer to the entry data.
*
* This function presumes that VPD is cached in DRAM (which is the case in the
* current implementation) and as such returns the pointer into the cache. The
* user is not supposed to modify the data, and does not have to free the
* memory.
*
* Returns NULL if key is not found.
*/
const void *vpd_find(const char *key, int *size, enum vpd_region region);
/*
* Find value of boolean type vpd key.
*
* During the process, necessary checking is done, such as making
* sure the value length is 1, and value is either '1' or '0'.
*/
bool vpd_get_bool(const char *key, enum vpd_region region,
uint8_t *val);
/*
* Find value of integer type by vpd key.
*
* Expects to find a decimal string, trailing chars are ignored.
* Returns true if the key is found and the value is not too long and
* starts with a decimal digit.
*/
bool vpd_get_int(const char *key, enum vpd_region region, int *val);
/*
* Extracts the "feature_level" from the "feature_device_info" VPD key.
* This key holds a base64-encoded protobuf where "feature_level" is the first entry.
*/
uint8_t vpd_get_feature_level(void);
#endif /* __VPD_H__ */
|
