[mirror_ubuntu-jammy-kernel.git] / arch / mips / include / asm / yamon-dt.h

/* SPDX-License-Identifier: GPL-2.0-or-later */
/*
 * Copyright (C) 2016 Imagination Technologies
 * Author: Paul Burton <paul.burton@mips.com>
 */

#ifndef __MIPS_ASM_YAMON_DT_H__
#define __MIPS_ASM_YAMON_DT_H__

#include <linux/types.h>

/**
 * struct yamon_mem_region - Represents a contiguous range of physical RAM.
 * @start:	Start physical address.
 * @size:	Maximum size of region.
 * @discard:	Length of additional memory to discard after the region.
 */
struct yamon_mem_region {
	phys_addr_t	start;
	phys_addr_t	size;
	phys_addr_t	discard;
};

/**
 * yamon_dt_append_cmdline() - Append YAMON-provided command line to /chosen
 * @fdt: the FDT blob
 *
 * Write the YAMON-provided command line to the bootargs property of the
 * /chosen node in @fdt.
 *
 * Return: 0 on success, else -errno
 */
extern __init int yamon_dt_append_cmdline(void *fdt);

/**
 * yamon_dt_append_memory() - Append YAMON-provided memory info to /memory
 * @fdt:	the FDT blob
 * @regions:	zero size terminated array of physical memory regions
 *
 * Generate a /memory node in @fdt based upon memory size information provided
 * by YAMON in its environment and the @regions array.
 *
 * Return: 0 on success, else -errno
 */
extern __init int yamon_dt_append_memory(void *fdt,
					const struct yamon_mem_region *regions);

/**
 * yamon_dt_serial_config() - Append YAMON-provided serial config to /chosen
 * @fdt: the FDT blob
 *
 * Generate a stdout-path property in the /chosen node of @fdt, based upon
 * information provided in the YAMON environment about the UART configuration
 * of the system.
 *
 * Return: 0 on success, else -errno
 */
extern __init int yamon_dt_serial_config(void *fdt);

#endif /* __MIPS_ASM_YAMON_DT_H__ */
Commit	Line	Data
2874c5fd	1	/* SPDX-License-Identifier: GPL-2.0-or-later */
571b7e69 PB	2	/*
571b7e69 PB	3	* Copyright (C) 2016 Imagination Technologies
fb615d61	4	* Author: Paul Burton <paul.burton@mips.com>
571b7e69 PB	5	*/
	6
	7	#ifndef __MIPS_ASM_YAMON_DT_H__
	8	#define __MIPS_ASM_YAMON_DT_H__
	9
f41d2430 PB	10	#include <linux/types.h>
	11
	12	/**
	13	* struct yamon_mem_region - Represents a contiguous range of physical RAM.
	14	* @start: Start physical address.
	15	* @size: Maximum size of region.
	16	* @discard: Length of additional memory to discard after the region.
	17	*/
	18	struct yamon_mem_region {
	19	phys_addr_t start;
	20	phys_addr_t size;
	21	phys_addr_t discard;
	22	};
	23
571b7e69 PB	24	/**
	25	* yamon_dt_append_cmdline() - Append YAMON-provided command line to /chosen
	26	* @fdt: the FDT blob
	27	*
	28	* Write the YAMON-provided command line to the bootargs property of the
	29	* /chosen node in @fdt.
	30	*
	31	* Return: 0 on success, else -errno
	32	*/
	33	extern __init int yamon_dt_append_cmdline(void *fdt);
	34
	35	/**
	36	* yamon_dt_append_memory() - Append YAMON-provided memory info to /memory
f41d2430 PB	37	* @fdt: the FDT blob
f41d2430 PB	38	* @regions: zero size terminated array of physical memory regions
571b7e69 PB	39	*
571b7e69 PB	40	* Generate a /memory node in @fdt based upon memory size information provided
f41d2430	41	* by YAMON in its environment and the @regions array.
571b7e69 PB	42	*
	43	* Return: 0 on success, else -errno
	44	*/
f41d2430 PB	45	extern __init int yamon_dt_append_memory(void *fdt,
f41d2430 PB	46	const struct yamon_mem_region *regions);
571b7e69 PB	47
	48	/**
	49	* yamon_dt_serial_config() - Append YAMON-provided serial config to /chosen
	50	* @fdt: the FDT blob
	51	*
	52	* Generate a stdout-path property in the /chosen node of @fdt, based upon
	53	* information provided in the YAMON environment about the UART configuration
	54	* of the system.
	55	*
	56	* Return: 0 on success, else -errno
	57	*/
	58	extern __init int yamon_dt_serial_config(void *fdt);
	59
	60	#endif /* __MIPS_ASM_YAMON_DT_H__ */