xref: /qemu/include/hw/riscv/boot.h (revision d3592955af2a015be1d7138643b4a010eee0ff0c)
10ac24d56SAlistair Francis /*
20ac24d56SAlistair Francis  * QEMU RISC-V Boot Helper
30ac24d56SAlistair Francis  *
40ac24d56SAlistair Francis  * Copyright (c) 2017 SiFive, Inc.
50ac24d56SAlistair Francis  * Copyright (c) 2019 Alistair Francis <alistair.francis@wdc.com>
60ac24d56SAlistair Francis  *
70ac24d56SAlistair Francis  * This program is free software; you can redistribute it and/or modify it
80ac24d56SAlistair Francis  * under the terms and conditions of the GNU General Public License,
90ac24d56SAlistair Francis  * version 2 or later, as published by the Free Software Foundation.
100ac24d56SAlistair Francis  *
110ac24d56SAlistair Francis  * This program is distributed in the hope it will be useful, but WITHOUT
120ac24d56SAlistair Francis  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
130ac24d56SAlistair Francis  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
140ac24d56SAlistair Francis  * more details.
150ac24d56SAlistair Francis  *
160ac24d56SAlistair Francis  * You should have received a copy of the GNU General Public License along with
170ac24d56SAlistair Francis  * this program.  If not, see <http://www.gnu.org/licenses/>.
180ac24d56SAlistair Francis  */
190ac24d56SAlistair Francis 
200ac24d56SAlistair Francis #ifndef RISCV_BOOT_H
210ac24d56SAlistair Francis #define RISCV_BOOT_H
220ac24d56SAlistair Francis 
23ec150c7eSMarkus Armbruster #include "exec/cpu-defs.h"
24757e99b1SAlistair Francis #include "hw/loader.h"
253ed2b8acSAlistair Francis #include "hw/riscv/riscv_hart.h"
26ec150c7eSMarkus Armbruster 
27a0acd0a1SBin Meng #define RISCV32_BIOS_BIN    "opensbi-riscv32-generic-fw_dynamic.bin"
28a0acd0a1SBin Meng #define RISCV64_BIOS_BIN    "opensbi-riscv64-generic-fw_dynamic.bin"
29a0acd0a1SBin Meng 
30*d3592955SJim Shu typedef struct RISCVBootInfo {
31*d3592955SJim Shu     ssize_t kernel_size;
32*d3592955SJim Shu     hwaddr image_low_addr;
33*d3592955SJim Shu     hwaddr image_high_addr;
34*d3592955SJim Shu 
35*d3592955SJim Shu     bool is_32bit;
36*d3592955SJim Shu } RISCVBootInfo;
37*d3592955SJim Shu 
38a8259b53SAlistair Francis bool riscv_is_32bit(RISCVHartArrayState *harts);
39c4077842SAlistair Francis 
40bf357e1dSAlistair Francis char *riscv_plic_hart_config_string(int hart_count);
41bf357e1dSAlistair Francis 
42*d3592955SJim Shu void riscv_boot_info_init(RISCVBootInfo *info, RISCVHartArrayState *harts);
43*d3592955SJim Shu target_ulong riscv_calc_kernel_start_addr(RISCVBootInfo *info,
4438bc4e34SAlistair Francis                                           target_ulong firmware_end_addr);
45e66c531eSAlistair Francis target_ulong riscv_find_and_load_firmware(MachineState *machine,
46fdd1bda4SAlistair Francis                                           const char *default_machine_firmware,
4755c13659SSamuel Holland                                           hwaddr *firmware_load_addr,
4802777ac3SAnup Patel                                           symbol_fn_t sym_cb);
499d3f7108SDaniel Henrique Barboza const char *riscv_default_firmware_name(RISCVHartArrayState *harts);
508f619626SBin Meng char *riscv_find_firmware(const char *firmware_filename,
518f619626SBin Meng                           const char *default_machine_firmware);
52b3042223SAlistair Francis target_ulong riscv_load_firmware(const char *firmware_filename,
5355c13659SSamuel Holland                                  hwaddr *firmware_load_addr,
5402777ac3SAnup Patel                                  symbol_fn_t sym_cb);
55*d3592955SJim Shu void riscv_load_kernel(MachineState *machine,
56*d3592955SJim Shu                        RISCVBootInfo *info,
57*d3592955SJim Shu                        target_ulong kernel_start_addr,
58487d73fcSDaniel Henrique Barboza                        bool load_initrd,
596478dd74SZhuang, Siwei (Data61, Kensington NSW)                        symbol_fn_t sym_cb);
60*d3592955SJim Shu uint64_t riscv_compute_fdt_addr(hwaddr dram_base, hwaddr dram_size,
61*d3592955SJim Shu                                 MachineState *ms, RISCVBootInfo *info);
62bc2c0153SDaniel Henrique Barboza void riscv_load_fdt(hwaddr fdt_addr, void *fdt);
63a8259b53SAlistair Francis void riscv_setup_rom_reset_vec(MachineState *machine, RISCVHartArrayState *harts,
643ed2b8acSAlistair Francis                                hwaddr saddr,
6578936771SAlistair Francis                                hwaddr rom_base, hwaddr rom_size,
6678936771SAlistair Francis                                uint64_t kernel_entry,
676934f15bSDaniel Henrique Barboza                                uint64_t fdt_load_addr);
6865838488STANG Tiancheng void riscv_rom_copy_firmware_info(MachineState *machine,
6965838488STANG Tiancheng                                   RISCVHartArrayState *harts,
7065838488STANG Tiancheng                                   hwaddr rom_base,
7178936771SAlistair Francis                                   hwaddr rom_size,
72dc144fe1SAtish Patra                                   uint32_t reset_vec_size,
73dc144fe1SAtish Patra                                   uint64_t kernel_entry);
74ad40be27SYifei Jiang void riscv_setup_direct_kernel(hwaddr kernel_addr, hwaddr fdt_addr);
75a5b0249dSSunil V L void riscv_setup_firmware_boot(MachineState *machine);
760ac24d56SAlistair Francis 
770ac24d56SAlistair Francis #endif /* RISCV_BOOT_H */
78