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