| /* Copyright 2020 The Chromium OS Authors. All rights reserved. |
| * 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. |
| * |
| * @param image The parameter that contains the programmer, buffer and |
| * size to use in the read operation. |
| * @param region The name of the fmap region 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 *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 region The name of the fmap region to write, or NULL to |
| * write the entire flash chip. |
| * |
| * @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 *region, |
| const struct firmware_image *diff_image, |
| int do_verify, int verbosity); |