aboutsummaryrefslogtreecommitdiff
path: root/include/hw/arm/allwinner-h3.h
diff options
context:
space:
mode:
Diffstat (limited to 'include/hw/arm/allwinner-h3.h')
-rw-r--r--include/hw/arm/allwinner-h3.h21
1 files changed, 21 insertions, 0 deletions
diff --git a/include/hw/arm/allwinner-h3.h b/include/hw/arm/allwinner-h3.h
index f9b9a02373..d338003724 100644
--- a/include/hw/arm/allwinner-h3.h
+++ b/include/hw/arm/allwinner-h3.h
@@ -46,6 +46,7 @@
#include "hw/sd/allwinner-sdhost.h"
#include "hw/net/allwinner-sun8i-emac.h"
#include "target/arm/cpu.h"
+#include "sysemu/block-backend.h"
/**
* Allwinner H3 device list
@@ -129,4 +130,24 @@ typedef struct AwH3State {
MemoryRegion sram_c;
} AwH3State;
+/**
+ * Emulate Boot ROM firmware setup functionality.
+ *
+ * A real Allwinner H3 SoC contains a Boot ROM
+ * which is the first code that runs right after
+ * the SoC is powered on. The Boot ROM is responsible
+ * for loading user code (e.g. a bootloader) from any
+ * of the supported external devices and writing the
+ * downloaded code to internal SRAM. After loading the SoC
+ * begins executing the code written to SRAM.
+ *
+ * This function emulates the Boot ROM by copying 32 KiB
+ * of data from the given block device and writes it to
+ * the start of the first internal SRAM memory.
+ *
+ * @s: Allwinner H3 state object pointer
+ * @blk: Block backend device object pointer
+ */
+void allwinner_h3_bootrom_setup(AwH3State *s, BlockBackend *blk);
+
#endif /* HW_ARM_ALLWINNER_H3_H */