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"
16 #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 int32_t atag_revision
;
63 /* multicore boards that use the default secondary core boot functions
64 * can ignore these two function calls. If the default functions won't
65 * work, then write_secondary_boot() should write a suitable blob of
66 * code mimicking the secondary CPU startup process used by the board's
67 * boot loader/boot ROM code, and secondary_cpu_reset_hook() should
68 * perform any necessary CPU reset handling and set the PC for the
69 * secondary CPUs to point at this boot blob.
71 void (*write_secondary_boot
)(ARMCPU
*cpu
,
72 const struct arm_boot_info
*info
);
73 void (*secondary_cpu_reset_hook
)(ARMCPU
*cpu
,
74 const struct arm_boot_info
*info
);
75 /* if a board is able to create a dtb without a dtb file then it
76 * sets get_dtb. This will only be used if no dtb file is provided
77 * by the user. On success, sets *size to the length of the created
78 * dtb, and returns a pointer to it. (The caller must free this memory
79 * with g_free() when it has finished with it.) On failure, returns NULL.
81 void *(*get_dtb
)(const struct arm_boot_info
*info
, int *size
);
82 /* if a board needs to be able to modify a device tree provided by
83 * the user it should implement this hook.
85 void (*modify_dtb
)(const struct arm_boot_info
*info
, void *fdt
);
86 /* machine init done notifier executing arm_load_dtb */
87 ArmLoadKernelNotifier load_kernel_notifier
;
88 /* Used internally by arm_boot.c */
94 /* Boot firmware has been loaded, typically at address 0, with -bios or
95 * -pflash. It also implies that fw_cfg_find() will succeed.
99 /* Address at which board specific loader/setup code exists. If enabled,
100 * this code-blob will run before anything else. It must return to the
101 * caller via the link register. There is no stack set up. Enabled by
102 * defining write_board_setup, which is responsible for loading the blob
103 * to the specified address.
105 hwaddr board_setup_addr
;
106 void (*write_board_setup
)(ARMCPU
*cpu
,
107 const struct arm_boot_info
*info
);
109 /* If set, the board specific loader/setup blob will be run from secure
110 * mode, regardless of secure_boot. The blob becomes responsible for
111 * changing to non-secure state if implementing a non-secure boot
113 bool secure_board_setup
;
115 arm_endianness endianness
;
119 * arm_load_kernel - Loads memory with everything needed to boot
121 * @cpu: handle to the first CPU object
122 * @info: handle to the boot info struct
123 * Registers a machine init done notifier that copies to memory
124 * everything needed to boot, depending on machine and user options:
125 * kernel image, boot loaders, initrd, dtb. Also registers the CPU
128 * In case the machine file supports the platform bus device and its
129 * dynamically instantiable sysbus devices, this function must be called
130 * before sysbus-fdt arm_register_platform_bus_fdt_creator. Indeed the
131 * machine init done notifiers are called in registration reverse order.
133 void arm_load_kernel(ARMCPU
*cpu
, struct arm_boot_info
*info
);
135 /* Write a secure board setup routine with a dummy handler for SMCs */
136 void arm_write_secure_board_setup_dummy_smc(ARMCPU
*cpu
,
137 const struct arm_boot_info
*info
,
140 /* Multiplication factor to convert from system clock ticks to qemu timer
142 extern int system_clock_scale
;
144 #endif /* !ARM_MISC_H */