xref: /openbmc/linux/arch/powerpc/boot/ops.h (revision 4f2c0a4acffbec01079c28f839422e64ddeff004)
1*e01432baSMichael Ellerman /* SPDX-License-Identifier: GPL-2.0 */
2b2c5f619SMark A. Greer /*
3b2c5f619SMark A. Greer  * Global definition of all the bootwrapper operations.
4b2c5f619SMark A. Greer  *
5b2c5f619SMark A. Greer  * Author: Mark A. Greer <mgreer@mvista.com>
6b2c5f619SMark A. Greer  *
7*e01432baSMichael Ellerman  * 2006 (c) MontaVista Software, Inc.
8b2c5f619SMark A. Greer  */
9b2c5f619SMark A. Greer #ifndef _PPC_BOOT_OPS_H_
10b2c5f619SMark A. Greer #define _PPC_BOOT_OPS_H_
11b2c5f619SMark A. Greer 
12ce3edb30SScott Wood #include <stddef.h>
13b2c5f619SMark A. Greer #include "types.h"
14a07940baSScott Wood #include "string.h"
15b2c5f619SMark A. Greer 
16579a53caSAnton Blanchard #define	BOOT_COMMAND_LINE_SIZE	2048
17b2c5f619SMark A. Greer #define	MAX_PATH_LEN		256
18b2c5f619SMark A. Greer #define	MAX_PROP_LEN		256 /* What should this be? */
19b2c5f619SMark A. Greer 
2062cf6a9dSGeoff Levand typedef void (*kernel_entry_t)(unsigned long r3, unsigned long r4, void *r5);
2162cf6a9dSGeoff Levand 
22b2c5f619SMark A. Greer /* Platform specific operations */
23b2c5f619SMark A. Greer struct platform_ops {
24b2c5f619SMark A. Greer 	void	(*fixups)(void);
25b2c5f619SMark A. Greer 	void	(*image_hdr)(const void *);
264ca478e6SGeert Uytterhoeven 	void *	(*malloc)(unsigned long size);
27c888554bSMark A. Greer 	void	(*free)(void *ptr);
28c888554bSMark A. Greer 	void *	(*realloc)(void *ptr, unsigned long size);
29b2c5f619SMark A. Greer 	void	(*exit)(void);
3079c85419SDavid Gibson 	void *	(*vmlinux_alloc)(unsigned long size);
31a1ff5741SOliver O'Halloran 	void  	(*kentry)(unsigned long fdt_addr, void *vmlinux_addr);
32b2c5f619SMark A. Greer };
33b2c5f619SMark A. Greer extern struct platform_ops platform_ops;
34b2c5f619SMark A. Greer 
35b2c5f619SMark A. Greer /* Device Tree operations */
36b2c5f619SMark A. Greer struct dt_ops {
37b2c5f619SMark A. Greer 	void *	(*finddevice)(const char *name);
38c888554bSMark A. Greer 	int	(*getprop)(const void *phandle, const char *name, void *buf,
39b2c5f619SMark A. Greer 			const int buflen);
40c888554bSMark A. Greer 	int	(*setprop)(const void *phandle, const char *name,
41b2c5f619SMark A. Greer 			const void *buf, const int buflen);
4271773f03SMike Ditto 	int (*del_node)(const void *phandle);
43a07940baSScott Wood 	void *(*get_parent)(const void *phandle);
44a07940baSScott Wood 	/* The node must not already exist. */
45a07940baSScott Wood 	void *(*create_node)(const void *parent, const char *name);
46a07940baSScott Wood 	void *(*find_node_by_prop_value)(const void *prev,
47a07940baSScott Wood 	                                 const char *propname,
48a07940baSScott Wood 	                                 const char *propval, int proplen);
49b3bea15dSKumar Gala 	void *(*find_node_by_compatible)(const void *prev,
50b3bea15dSKumar Gala 	                                 const char *compat);
5135af89ebSDavid Gibson 	unsigned long (*finalize)(void);
5221f3fe2fSScott Wood 	char *(*get_path)(const void *phandle, char *buf, int len);
53b2c5f619SMark A. Greer };
54b2c5f619SMark A. Greer extern struct dt_ops dt_ops;
55b2c5f619SMark A. Greer 
56b2c5f619SMark A. Greer /* Console operations */
57b2c5f619SMark A. Greer struct console_ops {
58b2c5f619SMark A. Greer 	int	(*open)(void);
59b96fbb6eSGeoff Levand 	void	(*write)(const char *buf, int len);
604b4b13d5SSimon Kagstrom 	void	(*edit_cmdline)(char *buf, int len, unsigned int getline_timeout);
61b2c5f619SMark A. Greer 	void	(*close)(void);
62b2c5f619SMark A. Greer 	void	*data;
63b2c5f619SMark A. Greer };
64b2c5f619SMark A. Greer extern struct console_ops console_ops;
65b2c5f619SMark A. Greer 
66b2c5f619SMark A. Greer /* Serial console operations */
67b2c5f619SMark A. Greer struct serial_console_data {
68b2c5f619SMark A. Greer 	int		(*open)(void);
69b2c5f619SMark A. Greer 	void		(*putc)(unsigned char c);
70b2c5f619SMark A. Greer 	unsigned char	(*getc)(void);
71b2c5f619SMark A. Greer 	u8		(*tstc)(void);
72b2c5f619SMark A. Greer 	void		(*close)(void);
73b2c5f619SMark A. Greer };
74b2c5f619SMark A. Greer 
75cd197ffcSDavid Gibson struct loader_info {
76cd197ffcSDavid Gibson 	void *promptr;
77cd197ffcSDavid Gibson 	unsigned long initrd_addr, initrd_size;
783af82a8bSDavid Gibson 	char *cmdline;
793af82a8bSDavid Gibson 	int cmdline_len;
80cd197ffcSDavid Gibson };
81cd197ffcSDavid Gibson extern struct loader_info loader_info;
82cd197ffcSDavid Gibson 
83e5a2072bSDavid Gibson void start(void);
842f0dfeaaSDavid Gibson void fdt_init(void *blob);
85c888554bSMark A. Greer int serial_console_init(void);
86c888554bSMark A. Greer int ns16550_console_init(void *devp, struct serial_console_data *scdp);
87d0f53fafSScott Wood int cpm_console_init(void *devp, struct serial_console_data *scdp);
8885498ae8SGrant Likely int mpc5200_psc_console_init(void *devp, struct serial_console_data *scdp);
89656ad58eSOliver O'Halloran int opal_console_init(void *devp, struct serial_console_data *scdp);
904ca478e6SGeert Uytterhoeven void *simple_alloc_init(char *base, unsigned long heap_size,
914ca478e6SGeert Uytterhoeven 			unsigned long granularity, unsigned long max_allocs);
920e680673SMilton Miller extern void flush_cache(void *, unsigned long);
938895ea48SMark A. Greer int dt_xlate_reg(void *node, int res, unsigned long *addr, unsigned long *size);
948895ea48SMark A. Greer int dt_xlate_addr(void *node, u32 *buf, int buflen, unsigned long *xlated_addr);
95a73ac50cSScott Wood int dt_is_compatible(void *node, const char *compat);
96e5d8d54dSScott Wood void dt_get_reg_format(void *node, u32 *naddr, u32 *nsize);
97da0a5f0cSLaurent Pinchart int dt_get_virtual_reg(void *node, void **addr, int nres);
98b2c5f619SMark A. Greer 
finddevice(const char * name)99b2c5f619SMark A. Greer static inline void *finddevice(const char *name)
100b2c5f619SMark A. Greer {
101b2c5f619SMark A. Greer 	return (dt_ops.finddevice) ? dt_ops.finddevice(name) : NULL;
102b2c5f619SMark A. Greer }
103b2c5f619SMark A. Greer 
getprop(void * devp,const char * name,void * buf,int buflen)104b2c5f619SMark A. Greer static inline int getprop(void *devp, const char *name, void *buf, int buflen)
105b2c5f619SMark A. Greer {
106b2c5f619SMark A. Greer 	return (dt_ops.getprop) ? dt_ops.getprop(devp, name, buf, buflen) : -1;
107b2c5f619SMark A. Greer }
108b2c5f619SMark A. Greer 
setprop(void * devp,const char * name,const void * buf,int buflen)109f61e7cd2SScott Wood static inline int setprop(void *devp, const char *name,
110f61e7cd2SScott Wood                           const void *buf, int buflen)
111b2c5f619SMark A. Greer {
112b2c5f619SMark A. Greer 	return (dt_ops.setprop) ? dt_ops.setprop(devp, name, buf, buflen) : -1;
113b2c5f619SMark A. Greer }
11427fbaa97SDavid Gibson #define setprop_val(devp, name, val) \
11527fbaa97SDavid Gibson 	do { \
11627fbaa97SDavid Gibson 		typeof(val) x = (val); \
11727fbaa97SDavid Gibson 		setprop((devp), (name), &x, sizeof(x)); \
11827fbaa97SDavid Gibson 	} while (0)
119b2c5f619SMark A. Greer 
setprop_str(void * devp,const char * name,const char * buf)120a07940baSScott Wood static inline int setprop_str(void *devp, const char *name, const char *buf)
121a07940baSScott Wood {
122a07940baSScott Wood 	if (dt_ops.setprop)
123a07940baSScott Wood 		return dt_ops.setprop(devp, name, buf, strlen(buf) + 1);
124a07940baSScott Wood 
125a07940baSScott Wood 	return -1;
126a07940baSScott Wood }
127a07940baSScott Wood 
del_node(const void * devp)12871773f03SMike Ditto static inline int del_node(const void *devp)
12971773f03SMike Ditto {
13071773f03SMike Ditto 	return dt_ops.del_node ? dt_ops.del_node(devp) : -1;
13171773f03SMike Ditto }
13271773f03SMike Ditto 
get_parent(const char * devp)133a07940baSScott Wood static inline void *get_parent(const char *devp)
134a07940baSScott Wood {
135a07940baSScott Wood 	return dt_ops.get_parent ? dt_ops.get_parent(devp) : NULL;
136a07940baSScott Wood }
137a07940baSScott Wood 
create_node(const void * parent,const char * name)138a07940baSScott Wood static inline void *create_node(const void *parent, const char *name)
139a07940baSScott Wood {
140a07940baSScott Wood 	return dt_ops.create_node ? dt_ops.create_node(parent, name) : NULL;
141a07940baSScott Wood }
142a07940baSScott Wood 
143a07940baSScott Wood 
find_node_by_prop_value(const void * prev,const char * propname,const char * propval,int proplen)144a07940baSScott Wood static inline void *find_node_by_prop_value(const void *prev,
145a07940baSScott Wood                                             const char *propname,
146a07940baSScott Wood                                             const char *propval, int proplen)
147a07940baSScott Wood {
148a07940baSScott Wood 	if (dt_ops.find_node_by_prop_value)
149a07940baSScott Wood 		return dt_ops.find_node_by_prop_value(prev, propname,
150a07940baSScott Wood 		                                      propval, proplen);
151a07940baSScott Wood 
152a07940baSScott Wood 	return NULL;
153a07940baSScott Wood }
154a07940baSScott Wood 
find_node_by_prop_value_str(const void * prev,const char * propname,const char * propval)155a07940baSScott Wood static inline void *find_node_by_prop_value_str(const void *prev,
156a07940baSScott Wood                                                 const char *propname,
157a07940baSScott Wood                                                 const char *propval)
158a07940baSScott Wood {
159a07940baSScott Wood 	return find_node_by_prop_value(prev, propname, propval,
160a07940baSScott Wood 	                               strlen(propval) + 1);
161a07940baSScott Wood }
162a07940baSScott Wood 
find_node_by_devtype(const void * prev,const char * type)163a07940baSScott Wood static inline void *find_node_by_devtype(const void *prev,
164a07940baSScott Wood                                          const char *type)
165a07940baSScott Wood {
166a07940baSScott Wood 	return find_node_by_prop_value_str(prev, "device_type", type);
167a07940baSScott Wood }
168a07940baSScott Wood 
find_node_by_alias(const char * alias)169ad160681SKumar Gala static inline void *find_node_by_alias(const char *alias)
170ad160681SKumar Gala {
171ad160681SKumar Gala 	void *devp = finddevice("/aliases");
172ad160681SKumar Gala 
173ad160681SKumar Gala 	if (devp) {
174ad160681SKumar Gala 		char path[MAX_PATH_LEN];
175ad160681SKumar Gala 		if (getprop(devp, alias, path, MAX_PATH_LEN) > 0)
176ad160681SKumar Gala 			return finddevice(path);
177ad160681SKumar Gala 	}
178ad160681SKumar Gala 
179ad160681SKumar Gala 	return NULL;
180ad160681SKumar Gala }
181ad160681SKumar Gala 
find_node_by_compatible(const void * prev,const char * compat)182b3bea15dSKumar Gala static inline void *find_node_by_compatible(const void *prev,
183b3bea15dSKumar Gala                                             const char *compat)
184b3bea15dSKumar Gala {
185b3bea15dSKumar Gala 	if (dt_ops.find_node_by_compatible)
186b3bea15dSKumar Gala 		return dt_ops.find_node_by_compatible(prev, compat);
187b3bea15dSKumar Gala 
188b3bea15dSKumar Gala 	return NULL;
189b3bea15dSKumar Gala }
190b3bea15dSKumar Gala 
19127fbaa97SDavid Gibson void dt_fixup_memory(u64 start, u64 size);
19227fbaa97SDavid Gibson void dt_fixup_cpu_clocks(u32 cpufreq, u32 tbfreq, u32 busfreq);
19327fbaa97SDavid Gibson void dt_fixup_clock(const char *path, u32 freq);
194ad160681SKumar Gala void dt_fixup_mac_address_by_alias(const char *alias, const u8 *addr);
19527ff35d9SScott Wood void dt_fixup_mac_address(u32 index, const u8 *addr);
19627fbaa97SDavid Gibson void __dt_fixup_mac_addresses(u32 startindex, ...);
19727fbaa97SDavid Gibson #define dt_fixup_mac_addresses(...) \
19827fbaa97SDavid Gibson 	__dt_fixup_mac_addresses(0, __VA_ARGS__, NULL)
19927fbaa97SDavid Gibson 
20027fbaa97SDavid Gibson 
get_path(const void * phandle,char * buf,int len)20121f3fe2fSScott Wood static inline char *get_path(const void *phandle, char *buf, int len)
20221f3fe2fSScott Wood {
20321f3fe2fSScott Wood 	if (dt_ops.get_path)
20421f3fe2fSScott Wood 		return dt_ops.get_path(phandle, buf, len);
20521f3fe2fSScott Wood 
20621f3fe2fSScott Wood 	return NULL;
20721f3fe2fSScott Wood }
20821f3fe2fSScott Wood 
malloc(unsigned long size)2094ca478e6SGeert Uytterhoeven static inline void *malloc(unsigned long size)
210b2c5f619SMark A. Greer {
211b2c5f619SMark A. Greer 	return (platform_ops.malloc) ? platform_ops.malloc(size) : NULL;
212b2c5f619SMark A. Greer }
213b2c5f619SMark A. Greer 
free(void * ptr)214c888554bSMark A. Greer static inline void free(void *ptr)
215b2c5f619SMark A. Greer {
216b2c5f619SMark A. Greer 	if (platform_ops.free)
217c888554bSMark A. Greer 		platform_ops.free(ptr);
218b2c5f619SMark A. Greer }
219b2c5f619SMark A. Greer 
exit(void)220b2c5f619SMark A. Greer static inline void exit(void)
221b2c5f619SMark A. Greer {
222b2c5f619SMark A. Greer 	if (platform_ops.exit)
223b2c5f619SMark A. Greer 		platform_ops.exit();
224b2c5f619SMark A. Greer 	for(;;);
225b2c5f619SMark A. Greer }
2266a923216SMilton Miller #define fatal(args...) { printf(args); exit(); }
2276a923216SMilton Miller 
228b2c5f619SMark A. Greer 
229cd197ffcSDavid Gibson #define BSS_STACK(size) \
230cd197ffcSDavid Gibson 	static char _bss_stack[size]; \
231cd197ffcSDavid Gibson 	void *_platform_stack_top = _bss_stack + sizeof(_bss_stack);
232cd197ffcSDavid Gibson 
233643d3c13SScott Wood extern unsigned long timebase_period_ns;
2343ee9b7abSScott Wood void udelay(long delay);
235643d3c13SScott Wood 
2362f1d4899SScott Wood extern char _start[];
2372f1d4899SScott Wood extern char __bss_start[];
2382f1d4899SScott Wood extern char _end[];
2392f1d4899SScott Wood extern char _vmlinux_start[];
2402f1d4899SScott Wood extern char _vmlinux_end[];
2412f1d4899SScott Wood extern char _initrd_start[];
2422f1d4899SScott Wood extern char _initrd_end[];
2432f1d4899SScott Wood extern char _dtb_start[];
2442f1d4899SScott Wood extern char _dtb_end[];
245528229d2SBenjamin Herrenschmidt extern char _esm_blob_start[];
246528229d2SBenjamin Herrenschmidt extern char _esm_blob_end[];
2472f1d4899SScott Wood 
248e5d8d54dSScott Wood static inline __attribute__((const))
__ilog2_u32(u32 n)249e5d8d54dSScott Wood int __ilog2_u32(u32 n)
250e5d8d54dSScott Wood {
251e5d8d54dSScott Wood 	int bit;
252e5d8d54dSScott Wood 	asm ("cntlzw %0,%1" : "=r" (bit) : "r" (n));
253e5d8d54dSScott Wood 	return 31 - bit;
254e5d8d54dSScott Wood }
255e5d8d54dSScott Wood 
2561b7898eeSOliver O'Halloran long partial_decompress(void *inbuf, unsigned long input_size, void *outbuf,
2571b7898eeSOliver O'Halloran 	unsigned long output_size, unsigned long skip);
2581b7898eeSOliver O'Halloran 
259b2c5f619SMark A. Greer #endif /* _PPC_BOOT_OPS_H_ */
260