diff options
Diffstat (limited to 'include/sbi/fw_dynamic.h')
-rw-r--r-- | include/sbi/fw_dynamic.h | 26 |
1 files changed, 22 insertions, 4 deletions
diff --git a/include/sbi/fw_dynamic.h b/include/sbi/fw_dynamic.h index 695dc29..3c08831 100644 --- a/include/sbi/fw_dynamic.h +++ b/include/sbi/fw_dynamic.h @@ -18,18 +18,20 @@ #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 */ +/** Offset of next_addr member in fw_dynamic_info (version >= 1) */ #define FW_DYNAMIC_INFO_NEXT_ADDR_OFFSET (2 * __SIZEOF_POINTER__) -/** Offset of next_mode member in fw_dynamic_info */ +/** Offset of next_mode member in fw_dynamic_info (version >= 1) */ #define FW_DYNAMIC_INFO_NEXT_MODE_OFFSET (3 * __SIZEOF_POINTER__) -/** Offset of options member in fw_dynamic_info */ +/** Offset of options member in fw_dynamic_info (version >= 1) */ #define FW_DYNAMIC_INFO_OPTIONS_OFFSET (4 * __SIZEOF_POINTER__) +/** Offset of boot_hart member in fw_dynamic_info (version >= 2) */ +#define FW_DYNAMIC_INFO_BOOT_HART_OFFSET (5 * __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 +#define FW_DYNAMIC_INFO_VERSION_MAX 0x2 /** Possible next mode values */ #define FW_DYNAMIC_INFO_NEXT_MODE_U 0x0 @@ -54,6 +56,22 @@ struct fw_dynamic_info { unsigned long next_mode; /** Options for OpenSBI library */ unsigned long options; + /** + * Preferred boot HART id + * + * It is possible that the previous booting stage uses same link + * address as the FW_DYNAMIC firmware. In this case, the relocation + * lottery mechanism can potentially overwrite the previous booting + * stage while other HARTs are still running in the previous booting + * stage leading to boot-time crash. To avoid this boot-time crash, + * the previous booting stage can specify last HART that will jump + * to the FW_DYNAMIC firmware as the preferred boot HART. + * + * To avoid specifying a preferred boot HART, the previous booting + * stage can set it to -1UL which will force the FW_DYNAMIC firmware + * to use the relocation lottery mechanism. + */ + unsigned long boot_hart; } __packed; #endif |