2 * Misc ARM declarations
4 * Copyright (c) 2006 CodeSourcery.
5 * Written by Paul Brook
7 * This code is licensed under the LGPL.
14 #include "exec/memory.h"
15 #include "target/arm/cpu-qom.h"
17 #include "qemu/notify.h"
20 ARM_ENDIANNESS_UNKNOWN
= 0,
27 DeviceState
*armv7m_init(MemoryRegion
*system_memory
, int mem_size
, int num_irq
,
28 const char *kernel_filename
, const char *cpu_model
);
31 * struct used as a parameter of the arm_load_kernel machine init
35 Notifier notifier
; /* actual notifier */
36 ARMCPU
*cpu
; /* handle to the first cpu object */
37 } ArmLoadKernelNotifier
;
40 struct arm_boot_info
{
42 const char *kernel_filename
;
43 const char *kernel_cmdline
;
44 const char *initrd_filename
;
45 const char *dtb_filename
;
47 /* multicore boards that use the default secondary core boot functions
48 * need to put the address of the secondary boot code, the boot reg,
49 * and the GIC address in the next 3 values, respectively. boards that
50 * have their own boot functions can use these values as they want.
52 hwaddr smp_loader_start
;
53 hwaddr smp_bootreg_addr
;
54 hwaddr gic_cpu_if_addr
;
57 /* ARM machines that support the ARM Security Extensions use this field to
58 * control whether Linux is booted as secure(true) or non-secure(false).
61 int (*atag_board
)(const struct arm_boot_info
*info
, void *p
);
62 /* multicore boards that use the default secondary core boot functions
63 * can ignore these two function calls. If the default functions won't
64 * work, then write_secondary_boot() should write a suitable blob of
65 * code mimicking the secondary CPU startup process used by the board's
66 * boot loader/boot ROM code, and secondary_cpu_reset_hook() should
67 * perform any necessary CPU reset handling and set the PC for the
68 * secondary CPUs to point at this boot blob.
70 void (*write_secondary_boot
)(ARMCPU
*cpu
,
71 const struct arm_boot_info
*info
);
72 void (*secondary_cpu_reset_hook
)(ARMCPU
*cpu
,
73 const struct arm_boot_info
*info
);
74 /* if a board is able to create a dtb without a dtb file then it
75 * sets get_dtb. This will only be used if no dtb file is provided
76 * by the user. On success, sets *size to the length of the created
77 * dtb, and returns a pointer to it. (The caller must free this memory
78 * with g_free() when it has finished with it.) On failure, returns NULL.
80 void *(*get_dtb
)(const struct arm_boot_info
*info
, int *size
);
81 /* if a board needs to be able to modify a device tree provided by
82 * the user it should implement this hook.
84 void (*modify_dtb
)(const struct arm_boot_info
*info
, void *fdt
);
85 /* machine init done notifier executing arm_load_dtb */
86 ArmLoadKernelNotifier load_kernel_notifier
;
87 /* Used internally by arm_boot.c */
93 /* Boot firmware has been loaded, typically at address 0, with -bios or
94 * -pflash. It also implies that fw_cfg_find() will succeed.
98 /* Address at which board specific loader/setup code exists. If enabled,
99 * this code-blob will run before anything else. It must return to the
100 * caller via the link register. There is no stack set up. Enabled by
101 * defining write_board_setup, which is responsible for loading the blob
102 * to the specified address.
104 hwaddr board_setup_addr
;
105 void (*write_board_setup
)(ARMCPU
*cpu
,
106 const struct arm_boot_info
*info
);
108 /* If set, the board specific loader/setup blob will be run from secure
109 * mode, regardless of secure_boot. The blob becomes responsible for
110 * changing to non-secure state if implementing a non-secure boot
112 bool secure_board_setup
;
114 arm_endianness endianness
;
118 * arm_load_kernel - Loads memory with everything needed to boot
120 * @cpu: handle to the first CPU object
121 * @info: handle to the boot info struct
122 * Registers a machine init done notifier that copies to memory
123 * everything needed to boot, depending on machine and user options:
124 * kernel image, boot loaders, initrd, dtb. Also registers the CPU
127 * In case the machine file supports the platform bus device and its
128 * dynamically instantiable sysbus devices, this function must be called
129 * before sysbus-fdt arm_register_platform_bus_fdt_creator. Indeed the
130 * machine init done notifiers are called in registration reverse order.
132 void arm_load_kernel(ARMCPU
*cpu
, struct arm_boot_info
*info
);
134 /* Write a secure board setup routine with a dummy handler for SMCs */
135 void arm_write_secure_board_setup_dummy_smc(ARMCPU
*cpu
,
136 const struct arm_boot_info
*info
,
139 /* Multiplication factor to convert from system clock ticks to qemu timer
141 extern int system_clock_scale
;
143 #endif /* HW_ARM_H */