2009-03-31 13:57:36 +02:00
|
|
|
/*
|
2009-09-14 15:29:27 +02:00
|
|
|
* Copyright (C) 2009 coresystems GmbH
|
|
|
|
* written by Patrick Georgi <patrick.georgi@coresystems.de>
|
2009-03-31 13:57:36 +02:00
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU General Public License as published by
|
|
|
|
* the Free Software Foundation; version 2 of the License.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU General Public License for more details.
|
|
|
|
*/
|
|
|
|
|
2012-10-30 00:52:36 +01:00
|
|
|
#ifndef __CBFS_H
|
|
|
|
#define __CBFS_H
|
|
|
|
|
2015-10-01 15:54:04 +02:00
|
|
|
#include "common.h"
|
2009-09-14 15:29:27 +02:00
|
|
|
#include <stdint.h>
|
2013-12-30 22:16:18 +01:00
|
|
|
|
2015-10-01 15:54:04 +02:00
|
|
|
#include <vb2_api.h>
|
|
|
|
|
2015-07-15 20:49:00 +02:00
|
|
|
/* cbfstool will fail when trying to build a cbfs_file header that's larger
|
|
|
|
* than MAX_CBFS_FILE_HEADER_BUFFER. 1K should give plenty of room. */
|
|
|
|
#define MAX_CBFS_FILE_HEADER_BUFFER 1024
|
|
|
|
|
2013-12-30 22:16:18 +01:00
|
|
|
/* create a magic number in host-byte order.
|
|
|
|
* b3 is the high order byte.
|
|
|
|
* in the coreboot tools, we go with the 32-bit
|
|
|
|
* magic number convention.
|
|
|
|
* This was an inline func but that breaks anything
|
|
|
|
* that uses it in a case statement.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#define makemagic(b3, b2, b1, b0)\
|
|
|
|
(((b3)<<24) | ((b2) << 16) | ((b1) << 8) | (b0))
|
2009-03-31 13:57:36 +02:00
|
|
|
|
2015-07-04 20:30:59 +02:00
|
|
|
#if defined(__WIN32) || defined(__WIN64)
|
|
|
|
#define __PACKED __attribute__((gcc_struct, packed))
|
|
|
|
#else
|
|
|
|
#define __PACKED __attribute__((packed))
|
|
|
|
#endif
|
|
|
|
|
2015-07-17 21:35:46 +02:00
|
|
|
/* To make CBFS more friendly to ROM, fill -1 (0xFF) instead of zero. */
|
|
|
|
#define CBFS_CONTENT_DEFAULT_VALUE (-1)
|
|
|
|
|
cbfstool: New image format w/ required FMAP and w/o CBFS master header
These new-style firmware images use the FMAP of the root of knowledge
about their layout, which allows them to have sections containing raw
data whose offset and size can easily be determined at runtime or when
modifying or flashing the image. Furthermore, they can even have
multiple CBFSes, each of which occupies a different FMAP region. It is
assumed that the first entry of each CBFS, including the primary one,
will be located right at the start of its region. This means that the
bootblock needs to be moved into its own FMAP region, but makes the
CBFS master header obsolete because, with the exception of the version
and alignment, all its fields are redundant once its CBFS has an entry
in the FMAP. The version code will be addressed in a future commit
before the new format comes into use, while the alignment will just be
defined to 64 bytes in both cbfstool and coreboot itself, since
there's almost no reason to ever change it in practice. The version
code field and all necessary coreboot changes will come separately.
BUG=chromium:470407
TEST=Build panther and nyan_big coreboot.rom and image.bin images with
and without this patch, diff their hexdumps, and note that no
locations differ except for those that do between subsequent builds of
the same codebase. Try working with new-style images: use fmaptool to
produce an FMAP section from an fmd file having raw sections and
multiple CBFSes, pass the resulting file to cbfstool create -M -F,
then try printing its layout and CBFSes' contents, add and remove CBFS
files, and read and write raw sections.
BRANCH=None
Change-Id: I7dd2578d2143d0cedd652fdba5b22221fcc2184a
Signed-off-by: Sol Boucher <solb@chromium.org>
Original-Commit-Id: 8a670322297f83135b929a5b20ff2bd0e7d2abd3
Original-Change-Id: Ib86fb50edc66632f4e6f717909bbe4efb6c874e5
Original-Signed-off-by: Sol Boucher <solb@chromium.org>
Original-Reviewed-on: https://chromium-review.googlesource.com/265863
Original-Reviewed-by: Aaron Durbin <adurbin@chromium.org>
Reviewed-on: http://review.coreboot.org/10135
Tested-by: build bot (Jenkins)
2015-03-18 20:36:27 +01:00
|
|
|
// Alignment (in bytes) to be used when no master header is present
|
|
|
|
#define CBFS_ENTRY_ALIGNMENT 64
|
|
|
|
|
2012-11-16 23:48:22 +01:00
|
|
|
#define CBFS_HEADER_MAGIC 0x4F524243
|
|
|
|
#define CBFS_HEADPTR_ADDR_X86 0xFFFFFFFC
|
2013-01-04 05:33:03 +01:00
|
|
|
#define CBFS_HEADER_VERSION1 0x31313131
|
|
|
|
#define CBFS_HEADER_VERSION2 0x31313132
|
|
|
|
#define CBFS_HEADER_VERSION CBFS_HEADER_VERSION2
|
2012-11-16 23:48:22 +01:00
|
|
|
|
2015-07-14 22:18:23 +02:00
|
|
|
#define CBFS_ALIGNMENT 64
|
|
|
|
|
2009-04-14 02:08:34 +02:00
|
|
|
struct cbfs_header {
|
2009-09-14 15:29:27 +02:00
|
|
|
uint32_t magic;
|
|
|
|
uint32_t version;
|
|
|
|
uint32_t romsize;
|
|
|
|
uint32_t bootblocksize;
|
2015-07-14 22:18:23 +02:00
|
|
|
uint32_t align; /* hard coded to 64 byte */
|
2009-09-14 15:29:27 +02:00
|
|
|
uint32_t offset;
|
2012-11-16 23:48:22 +01:00
|
|
|
uint32_t architecture; /* Version 2 */
|
|
|
|
uint32_t pad[1];
|
2015-07-04 20:30:59 +02:00
|
|
|
} __PACKED;
|
2009-03-31 13:57:36 +02:00
|
|
|
|
2012-11-16 23:48:22 +01:00
|
|
|
#define CBFS_ARCHITECTURE_UNKNOWN 0xFFFFFFFF
|
|
|
|
#define CBFS_ARCHITECTURE_X86 0x00000001
|
ARM: Generalize armv7 as arm.
There are ARM systems which are essentially heterogeneous multicores where
some cores implement a different ARM architecture version than other cores. A
specific example is the tegra124 which boots on an ARMv4 coprocessor while
most code, including most of the firmware, runs on the main ARMv7 core. To
support SOCs like this, the plan is to generalize the ARM architecture so that
all versions are available, and an SOC/CPU can then select what architecture
variant should be used for each component of the firmware; bootblock,
romstage, and ramstage.
Old-Change-Id: I22e048c3bc72bd56371e14200942e436c1e312c2
Signed-off-by: Gabe Black <gabeblack@google.com>
Reviewed-on: https://chromium-review.googlesource.com/171338
Reviewed-by: Gabe Black <gabeblack@chromium.org>
Commit-Queue: Gabe Black <gabeblack@chromium.org>
Tested-by: Gabe Black <gabeblack@chromium.org>
(cherry picked from commit 8423a41529da0ff67fb9873be1e2beb30b09ae2d)
Signed-off-by: Isaac Christensen <isaac.christensen@se-eng.com>
ARM: Split out ARMv7 code and make it possible to have other arch versions.
We don't always want to use ARMv7 code when building for ARM, so we should
separate out the ARMv7 code so it can be excluded, and also make it possible
to include code for some other version of the architecture instead, all per
build component for cases where we need more than one architecture version
at a time.
The tegra124 bootblock will ultimately need to be ARMv4, but until we have
some ARMv4 code to switch over to we can leave it set to ARMv7.
Old-Change-Id: Ia982c91057fac9c252397b7c866224f103761cc7
Reviewed-on: https://chromium-review.googlesource.com/171400
Reviewed-by: Gabe Black <gabeblack@chromium.org>
Tested-by: Gabe Black <gabeblack@chromium.org>
Commit-Queue: Gabe Black <gabeblack@chromium.org>
(cherry picked from commit 799514e6060aa97acdcf081b5c48f965be134483)
Squashed two related patches for splitting ARM support into general
ARM support and ARMv7 specific pieces.
Change-Id: Ic6511507953a2223c87c55f90252c4a4e1dd6010
Signed-off-by: Isaac Christensen <isaac.christensen@se-eng.com>
Reviewed-on: http://review.coreboot.org/6782
Tested-by: build bot (Jenkins)
2013-10-01 08:00:33 +02:00
|
|
|
#define CBFS_ARCHITECTURE_ARM 0x00000010
|
2013-11-12 18:03:33 +01:00
|
|
|
#define CBFS_ARCHITECTURE_AARCH64 0x0000aa64
|
2014-06-14 00:56:45 +02:00
|
|
|
#define CBFS_ARCHITECTURE_MIPS 0x00000100
|
2014-10-16 12:55:39 +02:00
|
|
|
#define CBFS_ARCHITECTURE_RISCV 0xc001d0de
|
2012-11-16 23:48:22 +01:00
|
|
|
|
2013-01-28 18:56:17 +01:00
|
|
|
#define CBFS_FILE_MAGIC "LARCHIVE"
|
|
|
|
|
2009-04-14 02:08:34 +02:00
|
|
|
struct cbfs_file {
|
2011-10-21 23:24:57 +02:00
|
|
|
uint8_t magic[8];
|
2015-07-15 16:40:44 +02:00
|
|
|
/* length of file data */
|
2009-09-14 15:29:27 +02:00
|
|
|
uint32_t len;
|
|
|
|
uint32_t type;
|
2015-07-15 20:49:00 +02:00
|
|
|
/* offset to struct cbfs_file_attribute or 0 */
|
2015-07-15 18:28:23 +02:00
|
|
|
uint32_t attributes_offset;
|
2015-07-15 16:40:44 +02:00
|
|
|
/* length of header incl. variable data */
|
2009-09-14 15:29:27 +02:00
|
|
|
uint32_t offset;
|
2015-07-15 16:42:38 +02:00
|
|
|
char filename[];
|
2015-07-04 20:30:59 +02:00
|
|
|
} __PACKED;
|
2009-03-31 13:57:36 +02:00
|
|
|
|
2015-09-01 18:20:20 +02:00
|
|
|
#if defined __GNUC__ && (__GNUC__ * 100 + __GNUC_MINOR__) >= 406
|
2015-07-15 16:40:44 +02:00
|
|
|
_Static_assert(sizeof(struct cbfs_file) == 24, "cbfs_file size mismatch");
|
2015-09-01 12:37:41 +02:00
|
|
|
#endif
|
2015-07-15 16:40:44 +02:00
|
|
|
|
2015-07-22 21:32:03 +02:00
|
|
|
/* The common fields of extended cbfs file attributes.
|
|
|
|
Attributes are expected to start with tag/len, then append their
|
|
|
|
specific fields. */
|
|
|
|
struct cbfs_file_attribute {
|
|
|
|
uint32_t tag;
|
|
|
|
/* len covers the whole structure, incl. tag and len */
|
|
|
|
uint32_t len;
|
|
|
|
uint8_t data[0];
|
|
|
|
} __PACKED;
|
|
|
|
|
2015-07-15 20:49:00 +02:00
|
|
|
/* Depending on how the header was initialized, it may be backed with 0x00 or
|
|
|
|
* 0xff. Support both. */
|
|
|
|
#define CBFS_FILE_ATTR_TAG_UNUSED 0
|
|
|
|
#define CBFS_FILE_ATTR_TAG_UNUSED2 0xffffffff
|
cbfstool: allow compression at file header level
Currently, compression is only allowed at subheader level (e.g. cbfs_stage,
cbfs_payload_segment). This change adds compression field to each file's
header so that any cbfs file can be compressed.
With the necessary additions in coreboot and libpayload, the following sample
code can load a compressed file:
const char *name = "foo.bmp";
struct cbfs_file *file = cbfs_get_file(media, name);
void *dst = malloc(ntohl(file->uncompressed_size));
dst = cbfs_get_file_content(media, name, type, file, dst);
cbfs_stage and cbfs_payload_segment continue to support compression at
subheader level because stages and payloads have to be decompressed to the load
address, which is stored in the subheader. For these, file level compression
should be turned off.
Change-Id: I9a00ec99dfc68ffb2771bb4a3cc5ba6ba8a326f4
Signed-off-by: Daisuke Nojiri <dnojiri@chromium.org>
Signed-off-by: Patrick Georgi <pgeorgi@chromium.org>
Reviewed-on: http://review.coreboot.org/10935
Tested-by: build bot (Jenkins)
Reviewed-by: Aaron Durbin <adurbin@chromium.org>
2015-07-10 00:07:45 +02:00
|
|
|
#define CBFS_FILE_ATTR_TAG_COMPRESSION 0x42435a4c
|
2015-10-01 15:54:04 +02:00
|
|
|
#define CBFS_FILE_ATTR_TAG_HASH 0x68736148
|
cbfstool: allow compression at file header level
Currently, compression is only allowed at subheader level (e.g. cbfs_stage,
cbfs_payload_segment). This change adds compression field to each file's
header so that any cbfs file can be compressed.
With the necessary additions in coreboot and libpayload, the following sample
code can load a compressed file:
const char *name = "foo.bmp";
struct cbfs_file *file = cbfs_get_file(media, name);
void *dst = malloc(ntohl(file->uncompressed_size));
dst = cbfs_get_file_content(media, name, type, file, dst);
cbfs_stage and cbfs_payload_segment continue to support compression at
subheader level because stages and payloads have to be decompressed to the load
address, which is stored in the subheader. For these, file level compression
should be turned off.
Change-Id: I9a00ec99dfc68ffb2771bb4a3cc5ba6ba8a326f4
Signed-off-by: Daisuke Nojiri <dnojiri@chromium.org>
Signed-off-by: Patrick Georgi <pgeorgi@chromium.org>
Reviewed-on: http://review.coreboot.org/10935
Tested-by: build bot (Jenkins)
Reviewed-by: Aaron Durbin <adurbin@chromium.org>
2015-07-10 00:07:45 +02:00
|
|
|
|
|
|
|
struct cbfs_file_attr_compression {
|
|
|
|
uint32_t tag;
|
|
|
|
uint32_t len;
|
|
|
|
/* whole file compression format. 0 if no compression. */
|
|
|
|
uint32_t compression;
|
|
|
|
uint32_t decompressed_size;
|
|
|
|
} __PACKED;
|
2015-07-15 20:49:00 +02:00
|
|
|
|
2015-10-01 15:54:04 +02:00
|
|
|
struct cbfs_file_attr_hash {
|
|
|
|
uint32_t tag;
|
|
|
|
uint32_t len;
|
|
|
|
uint32_t hash_type;
|
|
|
|
/* hash_data is len - sizeof(struct) bytes */
|
|
|
|
uint8_t hash_data[];
|
|
|
|
} __PACKED;
|
|
|
|
|
2009-04-14 02:08:34 +02:00
|
|
|
struct cbfs_stage {
|
2011-10-21 23:24:57 +02:00
|
|
|
uint32_t compression;
|
|
|
|
uint64_t entry;
|
|
|
|
uint64_t load;
|
|
|
|
uint32_t len;
|
|
|
|
uint32_t memlen;
|
2015-07-04 20:30:59 +02:00
|
|
|
} __PACKED;
|
2009-03-31 13:57:36 +02:00
|
|
|
|
2013-12-30 22:16:18 +01:00
|
|
|
#define PAYLOAD_SEGMENT_CODE makemagic('C', 'O', 'D', 'E')
|
|
|
|
#define PAYLOAD_SEGMENT_DATA makemagic('D', 'A', 'T', 'A')
|
2014-04-17 07:52:59 +02:00
|
|
|
#define PAYLOAD_SEGMENT_BSS makemagic('B', 'S', 'S', ' ')
|
2013-12-30 22:16:18 +01:00
|
|
|
#define PAYLOAD_SEGMENT_PARAMS makemagic('P', 'A', 'R', 'A')
|
|
|
|
#define PAYLOAD_SEGMENT_ENTRY makemagic('E', 'N', 'T', 'R')
|
2009-03-31 13:57:36 +02:00
|
|
|
|
2009-04-14 02:08:34 +02:00
|
|
|
struct cbfs_payload_segment {
|
2011-10-21 23:24:57 +02:00
|
|
|
uint32_t type;
|
|
|
|
uint32_t compression;
|
|
|
|
uint32_t offset;
|
|
|
|
uint64_t load_addr;
|
|
|
|
uint32_t len;
|
|
|
|
uint32_t mem_len;
|
2015-07-04 20:30:59 +02:00
|
|
|
} __PACKED;
|
2009-03-31 13:57:36 +02:00
|
|
|
|
2009-04-14 02:08:34 +02:00
|
|
|
struct cbfs_payload {
|
|
|
|
struct cbfs_payload_segment segments;
|
2015-07-04 20:30:59 +02:00
|
|
|
} __PACKED;
|
2009-09-14 15:29:27 +02:00
|
|
|
|
|
|
|
/** These are standard component types for well known
|
|
|
|
components (i.e - those that coreboot needs to consume.
|
|
|
|
Users are welcome to use any other value for their
|
|
|
|
components */
|
2009-03-31 13:57:36 +02:00
|
|
|
|
2015-09-09 20:11:26 +02:00
|
|
|
#define CBFS_COMPONENT_BOOTBLOCK 0x01
|
|
|
|
#define CBFS_COMPONENT_CBFSHEADER 0x02
|
2010-03-01 09:34:19 +01:00
|
|
|
#define CBFS_COMPONENT_STAGE 0x10
|
|
|
|
#define CBFS_COMPONENT_PAYLOAD 0x20
|
|
|
|
#define CBFS_COMPONENT_OPTIONROM 0x30
|
|
|
|
#define CBFS_COMPONENT_BOOTSPLASH 0x40
|
|
|
|
#define CBFS_COMPONENT_RAW 0x50
|
|
|
|
#define CBFS_COMPONENT_VSA 0x51
|
|
|
|
#define CBFS_COMPONENT_MBI 0x52
|
|
|
|
#define CBFS_COMPONENT_MICROCODE 0x53
|
2015-03-24 22:54:20 +01:00
|
|
|
#define CBFS_COMPONENT_FSP 0x60
|
|
|
|
#define CBFS_COMPONENT_MRC 0x61
|
2011-01-14 08:40:24 +01:00
|
|
|
#define CBFS_COMPONENT_CMOS_DEFAULT 0xaa
|
2015-03-24 22:54:20 +01:00
|
|
|
#define CBFS_COMPONENT_SPD 0xab
|
|
|
|
#define CBFS_COMPONENT_MRC_CACHE 0xac
|
2011-01-18 14:56:36 +01:00
|
|
|
#define CBFS_COMPONENT_CMOS_LAYOUT 0x01aa
|
2009-03-31 13:57:36 +02:00
|
|
|
|
2009-09-14 15:29:27 +02:00
|
|
|
/* The deleted type is chosen to be a value
|
|
|
|
* that can be written in a FLASH from all other
|
2010-04-27 08:56:47 +02:00
|
|
|
* values.
|
2009-09-14 15:29:27 +02:00
|
|
|
*/
|
|
|
|
#define CBFS_COMPONENT_DELETED 0
|
|
|
|
|
2010-04-27 08:56:47 +02:00
|
|
|
/* for all known FLASH, this value can be changed
|
|
|
|
* to all other values. This allows NULL files to be
|
2009-09-14 15:29:27 +02:00
|
|
|
* changed without a block erase
|
|
|
|
*/
|
|
|
|
#define CBFS_COMPONENT_NULL 0xFFFFFFFF
|
2009-03-31 13:57:36 +02:00
|
|
|
|
2015-09-09 16:46:00 +02:00
|
|
|
struct typedesc_t {
|
|
|
|
uint32_t type;
|
|
|
|
const char *name;
|
|
|
|
};
|
|
|
|
|
|
|
|
static struct typedesc_t filetypes[] unused = {
|
2015-09-09 20:11:26 +02:00
|
|
|
{CBFS_COMPONENT_BOOTBLOCK, "bootblock"},
|
|
|
|
{CBFS_COMPONENT_CBFSHEADER, "cbfs header"},
|
2015-09-09 16:46:00 +02:00
|
|
|
{CBFS_COMPONENT_STAGE, "stage"},
|
|
|
|
{CBFS_COMPONENT_PAYLOAD, "payload"},
|
|
|
|
{CBFS_COMPONENT_OPTIONROM, "optionrom"},
|
|
|
|
{CBFS_COMPONENT_BOOTSPLASH, "bootsplash"},
|
|
|
|
{CBFS_COMPONENT_RAW, "raw"},
|
|
|
|
{CBFS_COMPONENT_VSA, "vsa"},
|
|
|
|
{CBFS_COMPONENT_MBI, "mbi"},
|
|
|
|
{CBFS_COMPONENT_MICROCODE, "microcode"},
|
|
|
|
{CBFS_COMPONENT_FSP, "fsp"},
|
|
|
|
{CBFS_COMPONENT_MRC, "mrc"},
|
|
|
|
{CBFS_COMPONENT_CMOS_DEFAULT, "cmos_default"},
|
|
|
|
{CBFS_COMPONENT_CMOS_LAYOUT, "cmos_layout"},
|
|
|
|
{CBFS_COMPONENT_SPD, "spd"},
|
|
|
|
{CBFS_COMPONENT_MRC_CACHE, "mrc_cache"},
|
|
|
|
{CBFS_COMPONENT_DELETED, "deleted"},
|
|
|
|
{CBFS_COMPONENT_NULL, "null"}
|
|
|
|
};
|
|
|
|
|
2015-10-01 15:54:04 +02:00
|
|
|
static const struct typedesc_t types_cbfs_hash[] unused = {
|
|
|
|
{VB2_HASH_INVALID, "none"},
|
|
|
|
{VB2_HASH_SHA1, "sha1"},
|
|
|
|
{VB2_HASH_SHA256, "sha256"},
|
|
|
|
{VB2_HASH_SHA512, "sha512"},
|
|
|
|
{0, NULL}
|
|
|
|
};
|
|
|
|
|
|
|
|
static size_t widths_cbfs_hash[] unused = {
|
|
|
|
[VB2_HASH_INVALID] = 0,
|
|
|
|
[VB2_HASH_SHA1] = 20,
|
|
|
|
[VB2_HASH_SHA256] = 32,
|
|
|
|
[VB2_HASH_SHA512] = 64,
|
|
|
|
};
|
|
|
|
|
|
|
|
#define CBFS_NUM_SUPPORTED_HASHES ARRAY_SIZE(widths_cbfs_hash)
|
|
|
|
|
2013-01-19 00:53:22 +01:00
|
|
|
#define CBFS_SUBHEADER(_p) ( (void *) ((((uint8_t *) (_p)) + ntohl((_p)->offset))) )
|
2015-07-15 20:49:00 +02:00
|
|
|
|
2013-12-30 22:16:18 +01:00
|
|
|
/* cbfs_image.c */
|
|
|
|
uint32_t get_cbfs_entry_type(const char *name, uint32_t default_value);
|
|
|
|
uint32_t get_cbfs_compression(const char *name, uint32_t unknown);
|
|
|
|
|
2014-02-05 02:35:44 +01:00
|
|
|
/* common.c */
|
|
|
|
void cbfs_file_get_header(struct buffer *buf, struct cbfs_file *file);
|
|
|
|
|
2014-02-04 17:29:35 +01:00
|
|
|
/* cbfs-mkpayload.c */
|
|
|
|
void xdr_segs(struct buffer *output,
|
|
|
|
struct cbfs_payload_segment *segs, int nseg);
|
2014-08-05 17:48:20 +02:00
|
|
|
void xdr_get_seg(struct cbfs_payload_segment *out,
|
|
|
|
struct cbfs_payload_segment *in);
|
2014-02-04 17:29:35 +01:00
|
|
|
|
2012-10-30 00:52:36 +01:00
|
|
|
#endif
|