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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
/* Copyright 2020 The ChromiumOS Authors
* Use of this source code is governed by a BSD-style license that can be
* found in the LICENSE file.
*
* Host utilites to execute flashrom command.
*/
#include <stdint.h>
#include "2return_codes.h"
#include "fmap.h"
#define FLASHROM_PROGRAMMER_INTERNAL_AP "host"
#define FLASHROM_PROGRAMMER_INTERNAL_EC "ec"
/* Utilities for firmware images and (FMAP) sections */
struct firmware_image {
/**
* programmer The name of the programmer to use. Use either
* FLASHROM_PROGRAMMER_INTERNAL_AP or,
* FLASHROM_PROGRAMMER_INTERNAL_EC
* for the AP and EC respectively.
*/
const char *programmer;
uint32_t size; /* buffer size. */
uint8_t *data; /* data allocated buffer to read/write with. */
char *file_name;
char *ro_version, *rw_version_a, *rw_version_b;
FmapHeader *fmap_header;
};
/**
* Read using flashrom into an allocated buffer.
*
* flashrom_read subprocesses the flashrom binary and returns a buffer truncated
* to the region.
*
* flashrom_read_image reads the returns a full sized buffer with only the
* regions filled with data.
*
* flashrom_read_region returns the buffer truncated to the region.
*
* @param image The parameter that contains the programmer, buffer and
* size to use in the read operation.
* @param regions A list of the names of the fmap regions to read, or NULL
* to read the entire flash chip.
*
* @return VB2_SUCCESS on success, or a relevant error.
*/
vb2_error_t flashrom_read(struct firmware_image *image, const char *region);
int flashrom_read_image(struct firmware_image *image,
const char * const regions[],
int verbosity);
int flashrom_read_region(struct firmware_image *image, const char *region,
int verbosity);
/**
* Write using flashrom from a buffer.
*
* @param image The parameter that contains the programmer, buffer and
* size to use in the write operation.
* @param regions A list of the names of the fmap regions to write, or
* NULL to write the entire flash chip. The list must be
* ended with a NULL pointer.
*
* @return VB2_SUCCESS on success, or a relevant error.
*/
vb2_error_t flashrom_write(struct firmware_image *image, const char *region);
int flashrom_write_image(const struct firmware_image *image,
const char * const regions[],
const struct firmware_image *diff_image,
int do_verify, int verbosity);
/**
* Get wp state using flashrom.
*
* @param programmer The name of the programmer to use for reading the
* writeprotect state.
* @param wp_mode Pointer to a bool to store the WP mode. Will be set to
* false if WP is disabled, true if WP is enabled.
* NULL can be passed if not needed.
* @param wp_start Pointer to a uint32_t to store the WP start addr.
* NULL can be passed if not needed.
* @param wp_len Pointer to a uint32_t to store the WP region length.
* NULL can be passed if not needed.
*
* @return 0 on success, or a relevant error.
*/
int flashrom_get_wp(const char *programmer, bool *wp_mode,
uint32_t *wp_start, uint32_t *wp_len, int verbosity);
/**
* Set wp state using flashrom.
*
* @param programmer The name of the programmer to use for writing the
* writeprotect state.
* @param wp_mode WP mode to set. true to enable, false disable WP.
* @param wp_start WP start addr to set
* @param wp_len WP region length set
*
* @return 0 on success, or a relevant error.
*/
int flashrom_set_wp(const char *programmer, bool wp_mode,
uint32_t wp_start, uint32_t wp_len, int verbosity);
/**
* Get flash info using flashrom.
*
* @param programmer The name of the programmer to use.
* @param vendor The chip vendor name, non-NULLable.
* @param name The chip product name, non-NULLable.
* @param vid The chip vendor id, non-NULLable.
* @param pid The chip product id, non-NULLable.
* @param flash_len Pointer to a uint32_t to store chip length, non-NULLable.
*
* @return 0 on success, or a relevant error.
*/
int flashrom_get_info(const char *prog_with_params,
char **vendor, char **name,
uint32_t *vid, uint32_t *pid,
uint32_t *flash_len, int verbosity);
/**
* Get flash size using flashrom.
*
* @param programmer The name of the programmer to use.
* @param flash_len Pointer to a uint32_t to store chip length.
*
* @return 0 on success, or a relevant error.
*/
int flashrom_get_size(const char *programmer, uint32_t *flash_len,
int verbosity);
|
