diff options
author | Anup Patel <anup.patel@wdc.com> | 2019-04-29 09:25:19 +0300 |
---|---|---|
committer | Anup Patel <anup@brainfault.org> | 2019-05-10 09:56:22 +0300 |
commit | bae54f764570f3fa5c592f313b45352d9f6f1d8a (patch) | |
tree | cca8ebe4dd67ceb9e4ffa5c1e32e6027241a41dc /include | |
parent | 25472de89ee3b98cd466f69d1f419f943dcbcb0f (diff) | |
download | opensbi-bae54f764570f3fa5c592f313b45352d9f6f1d8a.tar.xz |
firmware: Add fw_dynamic firmware
This patch provides first-cut implementation of fw_dynamic firmware.
As compared to fw_jump and fw_payload, the fw_dynamic obtains next
address, next mode and OpenSBI options from struct fw_dynamic_info.
The previous booting stage can create struct fw_dynamic_info in memory
and pass address of struct fw_dynamic_info in 'a2' register. Also, the
struct fw_dynamic_info has versioning as well so changes to the struct
fw_dynamic_info can be done in a backward compatible manner.
Signed-off-by: Anup Patel <anup.patel@wdc.com>
Reviewed-by: Atish Patra <atish.patra@wdc.com>
Diffstat (limited to 'include')
-rw-r--r-- | include/sbi/fw_dynamic.h | 61 |
1 files changed, 61 insertions, 0 deletions
diff --git a/include/sbi/fw_dynamic.h b/include/sbi/fw_dynamic.h new file mode 100644 index 0000000..695dc29 --- /dev/null +++ b/include/sbi/fw_dynamic.h @@ -0,0 +1,61 @@ +/* + * SPDX-License-Identifier: BSD-2-Clause + * + * Copyright (c) 2019 Western Digital Corporation or its affiliates. + * + * Authors: + * Anup Patel <anup.patel@wdc.com> + */ + +#ifndef __FW_DYNAMIC_H__ +#define __FW_DYNAMIC_H__ + +#include <sbi/riscv_asm.h> + +/* clang-format off */ + +/** Offset of magic member in fw_dynamic_info */ +#define FW_DYNAMIC_INFO_MAGIC_OFFSET (0 * __SIZEOF_POINTER__) +/** Offset of version member in fw_dynamic_info */ +#define FW_DYNAMIC_INFO_VERSION_OFFSET (1 * __SIZEOF_POINTER__) +/** Offset of next_addr member in fw_dynamic_info */ +#define FW_DYNAMIC_INFO_NEXT_ADDR_OFFSET (2 * __SIZEOF_POINTER__) +/** Offset of next_mode member in fw_dynamic_info */ +#define FW_DYNAMIC_INFO_NEXT_MODE_OFFSET (3 * __SIZEOF_POINTER__) +/** Offset of options member in fw_dynamic_info */ +#define FW_DYNAMIC_INFO_OPTIONS_OFFSET (4 * __SIZEOF_POINTER__) + +/** Expected value of info magic ('OSBI' ascii string in hex) */ +#define FW_DYNAMIC_INFO_MAGIC_VALUE 0x4942534f + +/** Maximum supported info version */ +#define FW_DYNAMIC_INFO_VERSION_MAX 0x1 + +/** Possible next mode values */ +#define FW_DYNAMIC_INFO_NEXT_MODE_U 0x0 +#define FW_DYNAMIC_INFO_NEXT_MODE_S 0x1 +#define FW_DYNAMIC_INFO_NEXT_MODE_M 0x3 + +/* clang-format on */ + +#ifndef __ASSEMBLY__ + +#include <sbi/sbi_types.h> + +/** Representation dynamic info passed by previous booting stage */ +struct fw_dynamic_info { + /** Info magic */ + unsigned long magic; + /** Info version */ + unsigned long version; + /** Next booting stage address */ + unsigned long next_addr; + /** Next booting stage mode */ + unsigned long next_mode; + /** Options for OpenSBI library */ + unsigned long options; +} __packed; + +#endif + +#endif |