xref: /openbmc/linux/arch/arc/include/asm/mach_desc.h (revision f8c760e8)
1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * Copyright (C) 2012 Synopsys, Inc. (www.synopsys.com)
4  *
5  * based on METAG mach/arch.h (which in turn was based on ARM)
6  */
7 
8 #ifndef _ASM_ARC_MACH_DESC_H_
9 #define _ASM_ARC_MACH_DESC_H_
10 
11 /**
12  * struct machine_desc - Board specific callbacks, called from ARC common code
13  *	Provided by each ARC board using MACHINE_START()/MACHINE_END(), so
14  *	a multi-platform kernel builds with array of such descriptors.
15  *	We extend the early DT scan to also match the DT's "compatible" string
16  *	against the @dt_compat of all such descriptors, and one with highest
17  *	"DT score" is selected as global @machine_desc.
18  *
19  * @name:		Board/SoC name
20  * @dt_compat:		Array of device tree 'compatible' strings
21  * 			(XXX: although only 1st entry is looked at)
22  * @init_early:		Very early callback [called from setup_arch()]
23  * @init_per_cpu:	for each CPU as it is coming up (SMP as well as UP)
24  * 			[(M):init_IRQ(), (o):start_kernel_secondary()]
25  * @init_machine:	arch initcall level callback (e.g. populate static
26  * 			platform devices or parse Devicetree)
27  * @init_late:		Late initcall level callback
28  *
29  */
30 struct machine_desc {
31 	const char		*name;
32 	const char		**dt_compat;
33 	void			(*init_early)(void);
34 	void			(*init_per_cpu)(unsigned int);
35 	void			(*init_machine)(void);
36 	void			(*init_late)(void);
37 
38 };
39 
40 /*
41  * Current machine - only accessible during boot.
42  */
43 extern const struct machine_desc *machine_desc;
44 
45 /*
46  * Machine type table - also only accessible during boot
47  */
48 extern const struct machine_desc __arch_info_begin[], __arch_info_end[];
49 
50 /*
51  * Set of macros to define architecture features.
52  * This is built into a table by the linker.
53  */
54 #define MACHINE_START(_type, _name)			\
55 static const struct machine_desc __mach_desc_##_type	\
56 __used __section(".arch.info.init") = {			\
57 	.name		= _name,
58 
59 #define MACHINE_END				\
60 };
61 
62 extern const struct machine_desc *setup_machine_fdt(void *dt);
63 
64 #endif
65