xref: /openbmc/linux/arch/mips/include/asm/yamon-dt.h (revision e3d786a3)
1 /*
2  * Copyright (C) 2016 Imagination Technologies
3  * Author: Paul Burton <paul.burton@mips.com>
4  *
5  * This program is free software; you can redistribute it and/or modify it
6  * under the terms of the GNU General Public License as published by the
7  * Free Software Foundation;  either version 2 of the  License, or (at your
8  * option) any later version.
9  */
10 
11 #ifndef __MIPS_ASM_YAMON_DT_H__
12 #define __MIPS_ASM_YAMON_DT_H__
13 
14 #include <linux/types.h>
15 
16 /**
17  * struct yamon_mem_region - Represents a contiguous range of physical RAM.
18  * @start:	Start physical address.
19  * @size:	Maximum size of region.
20  * @discard:	Length of additional memory to discard after the region.
21  */
22 struct yamon_mem_region {
23 	phys_addr_t	start;
24 	phys_addr_t	size;
25 	phys_addr_t	discard;
26 };
27 
28 /**
29  * yamon_dt_append_cmdline() - Append YAMON-provided command line to /chosen
30  * @fdt: the FDT blob
31  *
32  * Write the YAMON-provided command line to the bootargs property of the
33  * /chosen node in @fdt.
34  *
35  * Return: 0 on success, else -errno
36  */
37 extern __init int yamon_dt_append_cmdline(void *fdt);
38 
39 /**
40  * yamon_dt_append_memory() - Append YAMON-provided memory info to /memory
41  * @fdt:	the FDT blob
42  * @regions:	zero size terminated array of physical memory regions
43  *
44  * Generate a /memory node in @fdt based upon memory size information provided
45  * by YAMON in its environment and the @regions array.
46  *
47  * Return: 0 on success, else -errno
48  */
49 extern __init int yamon_dt_append_memory(void *fdt,
50 					const struct yamon_mem_region *regions);
51 
52 /**
53  * yamon_dt_serial_config() - Append YAMON-provided serial config to /chosen
54  * @fdt: the FDT blob
55  *
56  * Generate a stdout-path property in the /chosen node of @fdt, based upon
57  * information provided in the YAMON environment about the UART configuration
58  * of the system.
59  *
60  * Return: 0 on success, else -errno
61  */
62 extern __init int yamon_dt_serial_config(void *fdt);
63 
64 #endif /* __MIPS_ASM_YAMON_DT_H__ */
65