[people/ms/u-boot.git] / lib / fdtdec.c

/*
 * Copyright (c) 2011 The Chromium OS Authors.
 * SPDX-License-Identifier:	GPL-2.0+
 */

#include <common.h>
#include <serial.h>
#include <libfdt.h>
#include <fdtdec.h>

#include <asm/gpio.h>

DECLARE_GLOBAL_DATA_PTR;

/*
 * Here are the type we know about. One day we might allow drivers to
 * register. For now we just put them here. The COMPAT macro allows us to
 * turn this into a sparse list later, and keeps the ID with the name.
 */
#define COMPAT(id, name) name
static const char * const compat_names[COMPAT_COUNT] = {
	COMPAT(UNKNOWN, "<none>"),
	COMPAT(NVIDIA_TEGRA20_USB, "nvidia,tegra20-ehci"),
	COMPAT(NVIDIA_TEGRA30_USB, "nvidia,tegra30-ehci"),
	COMPAT(NVIDIA_TEGRA114_USB, "nvidia,tegra114-ehci"),
	COMPAT(NVIDIA_TEGRA114_I2C, "nvidia,tegra114-i2c"),
	COMPAT(NVIDIA_TEGRA20_I2C, "nvidia,tegra20-i2c"),
	COMPAT(NVIDIA_TEGRA20_DVC, "nvidia,tegra20-i2c-dvc"),
	COMPAT(NVIDIA_TEGRA20_EMC, "nvidia,tegra20-emc"),
	COMPAT(NVIDIA_TEGRA20_EMC_TABLE, "nvidia,tegra20-emc-table"),
	COMPAT(NVIDIA_TEGRA20_KBC, "nvidia,tegra20-kbc"),
	COMPAT(NVIDIA_TEGRA20_NAND, "nvidia,tegra20-nand"),
	COMPAT(NVIDIA_TEGRA20_PWM, "nvidia,tegra20-pwm"),
	COMPAT(NVIDIA_TEGRA20_DC, "nvidia,tegra20-dc"),
	COMPAT(NVIDIA_TEGRA124_SDMMC, "nvidia,tegra124-sdhci"),
	COMPAT(NVIDIA_TEGRA30_SDMMC, "nvidia,tegra30-sdhci"),
	COMPAT(NVIDIA_TEGRA20_SDMMC, "nvidia,tegra20-sdhci"),
	COMPAT(NVIDIA_TEGRA20_SFLASH, "nvidia,tegra20-sflash"),
	COMPAT(NVIDIA_TEGRA20_SLINK, "nvidia,tegra20-slink"),
	COMPAT(NVIDIA_TEGRA114_SPI, "nvidia,tegra114-spi"),
	COMPAT(SMSC_LAN9215, "smsc,lan9215"),
	COMPAT(SAMSUNG_EXYNOS5_SROMC, "samsung,exynos-sromc"),
	COMPAT(SAMSUNG_S3C2440_I2C, "samsung,s3c2440-i2c"),
	COMPAT(SAMSUNG_EXYNOS5_SOUND, "samsung,exynos-sound"),
	COMPAT(WOLFSON_WM8994_CODEC, "wolfson,wm8994-codec"),
	COMPAT(SAMSUNG_EXYNOS_SPI, "samsung,exynos-spi"),
	COMPAT(GOOGLE_CROS_EC, "google,cros-ec"),
	COMPAT(GOOGLE_CROS_EC_KEYB, "google,cros-ec-keyb"),
	COMPAT(SAMSUNG_EXYNOS_EHCI, "samsung,exynos-ehci"),
	COMPAT(SAMSUNG_EXYNOS5_XHCI, "samsung,exynos5250-xhci"),
	COMPAT(SAMSUNG_EXYNOS_USB_PHY, "samsung,exynos-usb-phy"),
	COMPAT(SAMSUNG_EXYNOS5_USB3_PHY, "samsung,exynos5250-usb3-phy"),
	COMPAT(SAMSUNG_EXYNOS_TMU, "samsung,exynos-tmu"),
	COMPAT(SAMSUNG_EXYNOS_FIMD, "samsung,exynos-fimd"),
	COMPAT(SAMSUNG_EXYNOS5_DP, "samsung,exynos5-dp"),
	COMPAT(SAMSUNG_EXYNOS5_DWMMC, "samsung,exynos5250-dwmmc"),
	COMPAT(SAMSUNG_EXYNOS_SERIAL, "samsung,exynos4210-uart"),
	COMPAT(MAXIM_MAX77686_PMIC, "maxim,max77686_pmic"),
	COMPAT(GENERIC_SPI_FLASH, "spi-flash"),
	COMPAT(MAXIM_98095_CODEC, "maxim,max98095-codec"),
	COMPAT(INFINEON_SLB9635_TPM, "infineon,slb9635-tpm"),
	COMPAT(INFINEON_SLB9645_TPM, "infineon,slb9645-tpm"),
	COMPAT(SAMSUNG_EXYNOS5_I2C, "samsung,exynos5-hsi2c"),
	COMPAT(SANDBOX_HOST_EMULATION, "sandbox,host-emulation"),
	COMPAT(SANDBOX_LCD_SDL, "sandbox,lcd-sdl"),
};

const char *fdtdec_get_compatible(enum fdt_compat_id id)
{
	/* We allow reading of the 'unknown' ID for testing purposes */
	assert(id >= 0 && id < COMPAT_COUNT);
	return compat_names[id];
}

fdt_addr_t fdtdec_get_addr_size(const void *blob, int node,
		const char *prop_name, fdt_size_t *sizep)
{
	const fdt_addr_t *cell;
	int len;

	debug("%s: %s: ", __func__, prop_name);
	cell = fdt_getprop(blob, node, prop_name, &len);
	if (cell && ((!sizep && len == sizeof(fdt_addr_t)) ||
		     len == sizeof(fdt_addr_t) * 2)) {
		fdt_addr_t addr = fdt_addr_to_cpu(*cell);
		if (sizep) {
			const fdt_size_t *size;

			size = (fdt_size_t *)((char *)cell +
					sizeof(fdt_addr_t));
			*sizep = fdt_size_to_cpu(*size);
			debug("addr=%08lx, size=%08x\n",
			      (ulong)addr, *sizep);
		} else {
			debug("%08lx\n", (ulong)addr);
		}
		return addr;
	}
	debug("(not found)\n");
	return FDT_ADDR_T_NONE;
}

fdt_addr_t fdtdec_get_addr(const void *blob, int node,
		const char *prop_name)
{
	return fdtdec_get_addr_size(blob, node, prop_name, NULL);
}

s32 fdtdec_get_int(const void *blob, int node, const char *prop_name,
		s32 default_val)
{
	const s32 *cell;
	int len;

	debug("%s: %s: ", __func__, prop_name);
	cell = fdt_getprop(blob, node, prop_name, &len);
	if (cell && len >= sizeof(s32)) {
		s32 val = fdt32_to_cpu(cell[0]);

		debug("%#x (%d)\n", val, val);
		return val;
	}
	debug("(not found)\n");
	return default_val;
}

uint64_t fdtdec_get_uint64(const void *blob, int node, const char *prop_name,
		uint64_t default_val)
{
	const uint64_t *cell64;
	int length;

	cell64 = fdt_getprop(blob, node, prop_name, &length);
	if (!cell64 || length < sizeof(*cell64))
		return default_val;

	return fdt64_to_cpu(*cell64);
}

int fdtdec_get_is_enabled(const void *blob, int node)
{
	const char *cell;

	/*
	 * It should say "okay", so only allow that. Some fdts use "ok" but
	 * this is a bug. Please fix your device tree source file. See here
	 * for discussion:
	 *
	 * http://www.mail-archive.com/u-boot@lists.denx.de/msg71598.html
	 */
	cell = fdt_getprop(blob, node, "status", NULL);
	if (cell)
		return 0 == strcmp(cell, "okay");
	return 1;
}

enum fdt_compat_id fdtdec_lookup(const void *blob, int node)
{
	enum fdt_compat_id id;

	/* Search our drivers */
	for (id = COMPAT_UNKNOWN; id < COMPAT_COUNT; id++)
		if (0 == fdt_node_check_compatible(blob, node,
				compat_names[id]))
			return id;
	return COMPAT_UNKNOWN;
}

int fdtdec_next_compatible(const void *blob, int node,
		enum fdt_compat_id id)
{
	return fdt_node_offset_by_compatible(blob, node, compat_names[id]);
}

int fdtdec_next_compatible_subnode(const void *blob, int node,
		enum fdt_compat_id id, int *depthp)
{
	do {
		node = fdt_next_node(blob, node, depthp);
	} while (*depthp > 1);

	/* If this is a direct subnode, and compatible, return it */
	if (*depthp == 1 && 0 == fdt_node_check_compatible(
						blob, node, compat_names[id]))
		return node;

	return -FDT_ERR_NOTFOUND;
}

int fdtdec_next_alias(const void *blob, const char *name,
		enum fdt_compat_id id, int *upto)
{
#define MAX_STR_LEN 20
	char str[MAX_STR_LEN + 20];
	int node, err;

	/* snprintf() is not available */
	assert(strlen(name) < MAX_STR_LEN);
	sprintf(str, "%.*s%d", MAX_STR_LEN, name, *upto);
	node = fdt_path_offset(blob, str);
	if (node < 0)
		return node;
	err = fdt_node_check_compatible(blob, node, compat_names[id]);
	if (err < 0)
		return err;
	if (err)
		return -FDT_ERR_NOTFOUND;
	(*upto)++;
	return node;
}

int fdtdec_find_aliases_for_id(const void *blob, const char *name,
			enum fdt_compat_id id, int *node_list, int maxcount)
{
	memset(node_list, '\0', sizeof(*node_list) * maxcount);

	return fdtdec_add_aliases_for_id(blob, name, id, node_list, maxcount);
}

/* TODO: Can we tighten this code up a little? */
int fdtdec_add_aliases_for_id(const void *blob, const char *name,
			enum fdt_compat_id id, int *node_list, int maxcount)
{
	int name_len = strlen(name);
	int nodes[maxcount];
	int num_found = 0;
	int offset, node;
	int alias_node;
	int count;
	int i, j;

	/* find the alias node if present */
	alias_node = fdt_path_offset(blob, "/aliases");

	/*
	 * start with nothing, and we can assume that the root node can't
	 * match
	 */
	memset(nodes, '\0', sizeof(nodes));

	/* First find all the compatible nodes */
	for (node = count = 0; node >= 0 && count < maxcount;) {
		node = fdtdec_next_compatible(blob, node, id);
		if (node >= 0)
			nodes[count++] = node;
	}
	if (node >= 0)
		debug("%s: warning: maxcount exceeded with alias '%s'\n",
		       __func__, name);

	/* Now find all the aliases */
	for (offset = fdt_first_property_offset(blob, alias_node);
			offset > 0;
			offset = fdt_next_property_offset(blob, offset)) {
		const struct fdt_property *prop;
		const char *path;
		int number;
		int found;

		node = 0;
		prop = fdt_get_property_by_offset(blob, offset, NULL);
		path = fdt_string(blob, fdt32_to_cpu(prop->nameoff));
		if (prop->len && 0 == strncmp(path, name, name_len))
			node = fdt_path_offset(blob, prop->data);
		if (node <= 0)
			continue;

		/* Get the alias number */
		number = simple_strtoul(path + name_len, NULL, 10);
		if (number < 0 || number >= maxcount) {
			debug("%s: warning: alias '%s' is out of range\n",
			       __func__, path);
			continue;
		}

		/* Make sure the node we found is actually in our list! */
		found = -1;
		for (j = 0; j < count; j++)
			if (nodes[j] == node) {
				found = j;
				break;
			}

		if (found == -1) {
			debug("%s: warning: alias '%s' points to a node "
				"'%s' that is missing or is not compatible "
				" with '%s'\n", __func__, path,
				fdt_get_name(blob, node, NULL),
			       compat_names[id]);
			continue;
		}

		/*
		 * Add this node to our list in the right place, and mark
		 * it as done.
		 */
		if (fdtdec_get_is_enabled(blob, node)) {
			if (node_list[number]) {
				debug("%s: warning: alias '%s' requires that "
				      "a node be placed in the list in a "
				      "position which is already filled by "
				      "node '%s'\n", __func__, path,
				      fdt_get_name(blob, node, NULL));
				continue;
			}
			node_list[number] = node;
			if (number >= num_found)
				num_found = number + 1;
		}
		nodes[found] = 0;
	}

	/* Add any nodes not mentioned by an alias */
	for (i = j = 0; i < maxcount; i++) {
		if (!node_list[i]) {
			for (; j < maxcount; j++)
				if (nodes[j] &&
					fdtdec_get_is_enabled(blob, nodes[j]))
					break;

			/* Have we run out of nodes to add? */
			if (j == maxcount)
				break;

			assert(!node_list[i]);
			node_list[i] = nodes[j++];
			if (i >= num_found)
				num_found = i + 1;
		}
	}

	return num_found;
}

int fdtdec_check_fdt(void)
{
	/*
	 * We must have an FDT, but we cannot panic() yet since the console
	 * is not ready. So for now, just assert(). Boards which need an early
	 * FDT (prior to console ready) will need to make their own
	 * arrangements and do their own checks.
	 */
	assert(!fdtdec_prepare_fdt());
	return 0;
}

/*
 * This function is a little odd in that it accesses global data. At some
 * point if the architecture board.c files merge this will make more sense.
 * Even now, it is common code.
 */
int fdtdec_prepare_fdt(void)
{
	if (!gd->fdt_blob || ((uintptr_t)gd->fdt_blob & 3) ||
	    fdt_check_header(gd->fdt_blob)) {
		printf("No valid FDT found - please append one to U-Boot "
			"binary, use u-boot-dtb.bin or define "
			"CONFIG_OF_EMBED. For sandbox, use -d <file.dtb>\n");
		return -1;
	}
	return 0;
}

int fdtdec_lookup_phandle(const void *blob, int node, const char *prop_name)
{
	const u32 *phandle;
	int lookup;

	debug("%s: %s\n", __func__, prop_name);
	phandle = fdt_getprop(blob, node, prop_name, NULL);
	if (!phandle)
		return -FDT_ERR_NOTFOUND;

	lookup = fdt_node_offset_by_phandle(blob, fdt32_to_cpu(*phandle));
	return lookup;
}

/**
 * Look up a property in a node and check that it has a minimum length.
 *
 * @param blob		FDT blob
 * @param node		node to examine
 * @param prop_name	name of property to find
 * @param min_len	minimum property length in bytes
 * @param err		0 if ok, or -FDT_ERR_NOTFOUND if the property is not
			found, or -FDT_ERR_BADLAYOUT if not enough data
 * @return pointer to cell, which is only valid if err == 0
 */
static const void *get_prop_check_min_len(const void *blob, int node,
		const char *prop_name, int min_len, int *err)
{
	const void *cell;
	int len;

	debug("%s: %s\n", __func__, prop_name);
	cell = fdt_getprop(blob, node, prop_name, &len);
	if (!cell)
		*err = -FDT_ERR_NOTFOUND;
	else if (len < min_len)
		*err = -FDT_ERR_BADLAYOUT;
	else
		*err = 0;
	return cell;
}

int fdtdec_get_int_array(const void *blob, int node, const char *prop_name,
		u32 *array, int count)
{
	const u32 *cell;
	int i, err = 0;

	debug("%s: %s\n", __func__, prop_name);
	cell = get_prop_check_min_len(blob, node, prop_name,
				      sizeof(u32) * count, &err);
	if (!err) {
		for (i = 0; i < count; i++)
			array[i] = fdt32_to_cpu(cell[i]);
	}
	return err;
}

const u32 *fdtdec_locate_array(const void *blob, int node,
			       const char *prop_name, int count)
{
	const u32 *cell;
	int err;

	cell = get_prop_check_min_len(blob, node, prop_name,
				      sizeof(u32) * count, &err);
	return err ? NULL : cell;
}

int fdtdec_get_bool(const void *blob, int node, const char *prop_name)
{
	const s32 *cell;
	int len;

	debug("%s: %s\n", __func__, prop_name);
	cell = fdt_getprop(blob, node, prop_name, &len);
	return cell != NULL;
}

/**
 * Decode a list of GPIOs from an FDT. This creates a list of GPIOs with no
 * terminating item.
 *
 * @param blob		FDT blob to use
 * @param node		Node to look at
 * @param prop_name	Node property name
 * @param gpio		Array of gpio elements to fill from FDT. This will be
 *			untouched if either 0 or an error is returned
 * @param max_count	Maximum number of elements allowed
 * @return number of GPIOs read if ok, -FDT_ERR_BADLAYOUT if max_count would
 * be exceeded, or -FDT_ERR_NOTFOUND if the property is missing.
 */
int fdtdec_decode_gpios(const void *blob, int node, const char *prop_name,
		struct fdt_gpio_state *gpio, int max_count)
{
	const struct fdt_property *prop;
	const u32 *cell;
	const char *name;
	int len, i;

	debug("%s: %s\n", __func__, prop_name);
	assert(max_count > 0);
	prop = fdt_get_property(blob, node, prop_name, &len);
	if (!prop) {
		debug("%s: property '%s' missing\n", __func__, prop_name);
		return -FDT_ERR_NOTFOUND;
	}

	/* We will use the name to tag the GPIO */
	name = fdt_string(blob, fdt32_to_cpu(prop->nameoff));
	cell = (u32 *)prop->data;
	len /= sizeof(u32) * 3;		/* 3 cells per GPIO record */
	if (len > max_count) {
		debug(" %s: too many GPIOs / cells for "
			"property '%s'\n", __func__, prop_name);
		return -FDT_ERR_BADLAYOUT;
	}

	/* Read out the GPIO data from the cells */
	for (i = 0; i < len; i++, cell += 3) {
		gpio[i].gpio = fdt32_to_cpu(cell[1]);
		gpio[i].flags = fdt32_to_cpu(cell[2]);
		gpio[i].name = name;
	}

	return len;
}

int fdtdec_decode_gpio(const void *blob, int node, const char *prop_name,
		struct fdt_gpio_state *gpio)
{
	int err;

	debug("%s: %s\n", __func__, prop_name);
	gpio->gpio = FDT_GPIO_NONE;
	gpio->name = NULL;
	err = fdtdec_decode_gpios(blob, node, prop_name, gpio, 1);
	return err == 1 ? 0 : err;
}

int fdtdec_get_gpio(struct fdt_gpio_state *gpio)
{
	int val;

	if (!fdt_gpio_isvalid(gpio))
		return -1;

	val = gpio_get_value(gpio->gpio);
	return gpio->flags & FDT_GPIO_ACTIVE_LOW ? val ^ 1 : val;
}

int fdtdec_set_gpio(struct fdt_gpio_state *gpio, int val)
{
	if (!fdt_gpio_isvalid(gpio))
		return -1;

	val = gpio->flags & FDT_GPIO_ACTIVE_LOW ? val ^ 1 : val;
	return gpio_set_value(gpio->gpio, val);
}

int fdtdec_setup_gpio(struct fdt_gpio_state *gpio)
{
	/*
	 * Return success if there is no GPIO defined. This is used for
	 * optional GPIOs)
	 */
	if (!fdt_gpio_isvalid(gpio))
		return 0;

	if (gpio_request(gpio->gpio, gpio->name))
		return -1;
	return 0;
}

int fdtdec_get_byte_array(const void *blob, int node, const char *prop_name,
		u8 *array, int count)
{
	const u8 *cell;
	int err;

	cell = get_prop_check_min_len(blob, node, prop_name, count, &err);
	if (!err)
		memcpy(array, cell, count);
	return err;
}

const u8 *fdtdec_locate_byte_array(const void *blob, int node,
			     const char *prop_name, int count)
{
	const u8 *cell;
	int err;

	cell = get_prop_check_min_len(blob, node, prop_name, count, &err);
	if (err)
		return NULL;
	return cell;
}

int fdtdec_get_config_int(const void *blob, const char *prop_name,
		int default_val)
{
	int config_node;

	debug("%s: %s\n", __func__, prop_name);
	config_node = fdt_path_offset(blob, "/config");
	if (config_node < 0)
		return default_val;
	return fdtdec_get_int(blob, config_node, prop_name, default_val);
}

int fdtdec_get_config_bool(const void *blob, const char *prop_name)
{
	int config_node;
	const void *prop;

	debug("%s: %s\n", __func__, prop_name);
	config_node = fdt_path_offset(blob, "/config");
	if (config_node < 0)
		return 0;
	prop = fdt_get_property(blob, config_node, prop_name, NULL);

	return prop != NULL;
}

char *fdtdec_get_config_string(const void *blob, const char *prop_name)
{
	const char *nodep;
	int nodeoffset;
	int len;

	debug("%s: %s\n", __func__, prop_name);
	nodeoffset = fdt_path_offset(blob, "/config");
	if (nodeoffset < 0)
		return NULL;

	nodep = fdt_getprop(blob, nodeoffset, prop_name, &len);
	if (!nodep)
		return NULL;

	return (char *)nodep;
}

int fdtdec_decode_region(const void *blob, int node,
		const char *prop_name, void **ptrp, size_t *size)
{
	const fdt_addr_t *cell;
	int len;

	debug("%s: %s\n", __func__, prop_name);
	cell = fdt_getprop(blob, node, prop_name, &len);
	if (!cell || (len != sizeof(fdt_addr_t) * 2))
		return -1;

	*ptrp = map_sysmem(fdt_addr_to_cpu(*cell), *size);
	*size = fdt_size_to_cpu(cell[1]);
	debug("%s: size=%zx\n", __func__, *size);
	return 0;
}

/**
 * Read a flash entry from the fdt
 *
 * @param blob		FDT blob
 * @param node		Offset of node to read
 * @param name		Name of node being read
 * @param entry		Place to put offset and size of this node
 * @return 0 if ok, -ve on error
 */
int fdtdec_read_fmap_entry(const void *blob, int node, const char *name,
			   struct fmap_entry *entry)
{
	u32 reg[2];

	if (fdtdec_get_int_array(blob, node, "reg", reg, 2)) {
		debug("Node '%s' has bad/missing 'reg' property\n", name);
		return -FDT_ERR_NOTFOUND;
	}
	entry->offset = reg[0];
	entry->length = reg[1];

	return 0;
}
Commit	Line	Data
b5220bc6 SG	1	/*
b5220bc6 SG	2	* Copyright (c) 2011 The Chromium OS Authors.
1a459660	3	* SPDX-License-Identifier: GPL-2.0+
b5220bc6 SG	4	*/
	5
	6	#include <common.h>
	7	#include <serial.h>
	8	#include <libfdt.h>
	9	#include <fdtdec.h>
	10
e46431e1	11	#include <asm/gpio.h>
ed3ee5cd	12
b5220bc6 SG	13	DECLARE_GLOBAL_DATA_PTR;
	14
	15	/*
	16	* Here are the type we know about. One day we might allow drivers to
	17	* register. For now we just put them here. The COMPAT macro allows us to
	18	* turn this into a sparse list later, and keeps the ID with the name.
	19	*/
	20	#define COMPAT(id, name) name
	21	static const char * const compat_names[COMPAT_COUNT] = {
f88fe2de	22	COMPAT(UNKNOWN, "<none>"),
87f938c9	23	COMPAT(NVIDIA_TEGRA20_USB, "nvidia,tegra20-ehci"),
7e44d932 JL	24	COMPAT(NVIDIA_TEGRA30_USB, "nvidia,tegra30-ehci"),
7e44d932 JL	25	COMPAT(NVIDIA_TEGRA114_USB, "nvidia,tegra114-ehci"),
e32624ef	26	COMPAT(NVIDIA_TEGRA114_I2C, "nvidia,tegra114-i2c"),
96a78ac0 YL	27	COMPAT(NVIDIA_TEGRA20_I2C, "nvidia,tegra20-i2c"),
96a78ac0 YL	28	COMPAT(NVIDIA_TEGRA20_DVC, "nvidia,tegra20-i2c-dvc"),
0e35ad05 JZ	29	COMPAT(NVIDIA_TEGRA20_EMC, "nvidia,tegra20-emc"),
0e35ad05 JZ	30	COMPAT(NVIDIA_TEGRA20_EMC_TABLE, "nvidia,tegra20-emc-table"),
6642a681	31	COMPAT(NVIDIA_TEGRA20_KBC, "nvidia,tegra20-kbc"),
312693c3	32	COMPAT(NVIDIA_TEGRA20_NAND, "nvidia,tegra20-nand"),
e1ae0d1f	33	COMPAT(NVIDIA_TEGRA20_PWM, "nvidia,tegra20-pwm"),
87540de3	34	COMPAT(NVIDIA_TEGRA20_DC, "nvidia,tegra20-dc"),
a73ca478	35	COMPAT(NVIDIA_TEGRA124_SDMMC, "nvidia,tegra124-sdhci"),
f4e4e0b0	36	COMPAT(NVIDIA_TEGRA30_SDMMC, "nvidia,tegra30-sdhci"),
c9aa831e	37	COMPAT(NVIDIA_TEGRA20_SDMMC, "nvidia,tegra20-sdhci"),
8f1b46b1	38	COMPAT(NVIDIA_TEGRA20_SFLASH, "nvidia,tegra20-sflash"),
b19f5749	39	COMPAT(NVIDIA_TEGRA20_SLINK, "nvidia,tegra20-slink"),
c3bb3c8b	40	COMPAT(NVIDIA_TEGRA114_SPI, "nvidia,tegra114-spi"),
cc9fe33a HR	41	COMPAT(SMSC_LAN9215, "smsc,lan9215"),
cc9fe33a HR	42	COMPAT(SAMSUNG_EXYNOS5_SROMC, "samsung,exynos-sromc"),
c34253d1	43	COMPAT(SAMSUNG_S3C2440_I2C, "samsung,s3c2440-i2c"),
72dbff12 RS	44	COMPAT(SAMSUNG_EXYNOS5_SOUND, "samsung,exynos-sound"),
72dbff12 RS	45	COMPAT(WOLFSON_WM8994_CODEC, "wolfson,wm8994-codec"),
5d50659d	46	COMPAT(SAMSUNG_EXYNOS_SPI, "samsung,exynos-spi"),
88364387	47	COMPAT(GOOGLE_CROS_EC, "google,cros-ec"),
713cb680	48	COMPAT(GOOGLE_CROS_EC_KEYB, "google,cros-ec-keyb"),
6abd1620	49	COMPAT(SAMSUNG_EXYNOS_EHCI, "samsung,exynos-ehci"),
108b85be	50	COMPAT(SAMSUNG_EXYNOS5_XHCI, "samsung,exynos5250-xhci"),
6abd1620	51	COMPAT(SAMSUNG_EXYNOS_USB_PHY, "samsung,exynos-usb-phy"),
108b85be	52	COMPAT(SAMSUNG_EXYNOS5_USB3_PHY, "samsung,exynos5250-usb3-phy"),
618766c0	53	COMPAT(SAMSUNG_EXYNOS_TMU, "samsung,exynos-tmu"),
d7377b51	54	COMPAT(SAMSUNG_EXYNOS_FIMD, "samsung,exynos-fimd"),
1e4706a7	55	COMPAT(SAMSUNG_EXYNOS5_DP, "samsung,exynos5-dp"),
45a4d4d3	56	COMPAT(SAMSUNG_EXYNOS5_DWMMC, "samsung,exynos5250-dwmmc"),
ee1e3c2f	57	COMPAT(SAMSUNG_EXYNOS_SERIAL, "samsung,exynos4210-uart"),
cd577e2b	58	COMPAT(MAXIM_MAX77686_PMIC, "maxim,max77686_pmic"),
bb8215f4	59	COMPAT(GENERIC_SPI_FLASH, "spi-flash"),
7772bb78	60	COMPAT(MAXIM_98095_CODEC, "maxim,max98095-codec"),
f6267998	61	COMPAT(INFINEON_SLB9635_TPM, "infineon,slb9635-tpm"),
ec34fa5e	62	COMPAT(INFINEON_SLB9645_TPM, "infineon,slb9645-tpm"),
ecbd7e1e	63	COMPAT(SAMSUNG_EXYNOS5_I2C, "samsung,exynos5-hsi2c"),
df93d90a	64	COMPAT(SANDBOX_HOST_EMULATION, "sandbox,host-emulation"),
7d95f2a3	65	COMPAT(SANDBOX_LCD_SDL, "sandbox,lcd-sdl"),
b5220bc6 SG	66	};
b5220bc6 SG	67
a53f4a29 SG	68	const char *fdtdec_get_compatible(enum fdt_compat_id id)
	69	{
	70	/* We allow reading of the 'unknown' ID for testing purposes */
	71	assert(id >= 0 && id < COMPAT_COUNT);
	72	return compat_names[id];
	73	}
	74
4397a2a8 SG	75	fdt_addr_t fdtdec_get_addr_size(const void *blob, int node,
4397a2a8 SG	76	const char prop_name, fdt_size_t sizep)
b5220bc6 SG	77	{
	78	const fdt_addr_t *cell;
	79	int len;
	80
1cb2323b	81	debug("%s: %s: ", __func__, prop_name);
b5220bc6	82	cell = fdt_getprop(blob, node, prop_name, &len);
4397a2a8 SG	83	if (cell && ((!sizep && len == sizeof(fdt_addr_t)) \|\|
4397a2a8 SG	84	len == sizeof(fdt_addr_t) * 2)) {
1cb2323b	85	fdt_addr_t addr = fdt_addr_to_cpu(*cell);
4397a2a8 SG	86	if (sizep) {
4397a2a8 SG	87	const fdt_size_t *size;
1cb2323b	88
4397a2a8 SG	89	size = (fdt_size_t )((char )cell +
	90	sizeof(fdt_addr_t));
	91	sizep = fdt_size_to_cpu(size);
370b6c5c SG	92	debug("addr=%08lx, size=%08x\n",
370b6c5c SG	93	(ulong)addr, *sizep);
4397a2a8	94	} else {
370b6c5c	95	debug("%08lx\n", (ulong)addr);
4397a2a8	96	}
1cb2323b SG	97	return addr;
	98	}
	99	debug("(not found)\n");
b5220bc6 SG	100	return FDT_ADDR_T_NONE;
	101	}
	102
4397a2a8 SG	103	fdt_addr_t fdtdec_get_addr(const void *blob, int node,
	104	const char *prop_name)
	105	{
	106	return fdtdec_get_addr_size(blob, node, prop_name, NULL);
	107	}
	108
b5220bc6 SG	109	s32 fdtdec_get_int(const void blob, int node, const char prop_name,
	110	s32 default_val)
	111	{
	112	const s32 *cell;
	113	int len;
	114
1cb2323b	115	debug("%s: %s: ", __func__, prop_name);
b5220bc6	116	cell = fdt_getprop(blob, node, prop_name, &len);
1cb2323b SG	117	if (cell && len >= sizeof(s32)) {
	118	s32 val = fdt32_to_cpu(cell[0]);
	119
	120	debug("%#x (%d)\n", val, val);
	121	return val;
	122	}
	123	debug("(not found)\n");
b5220bc6 SG	124	return default_val;
	125	}
	126
aadef0a1 CLC	127	uint64_t fdtdec_get_uint64(const void blob, int node, const char prop_name,
	128	uint64_t default_val)
	129	{
	130	const uint64_t *cell64;
	131	int length;
	132
	133	cell64 = fdt_getprop(blob, node, prop_name, &length);
	134	if (!cell64 \|\| length < sizeof(*cell64))
	135	return default_val;
	136
	137	return fdt64_to_cpu(*cell64);
	138	}
	139
f88fe2de	140	int fdtdec_get_is_enabled(const void *blob, int node)
b5220bc6 SG	141	{
	142	const char *cell;
	143
f88fe2de SG	144	/*
	145	* It should say "okay", so only allow that. Some fdts use "ok" but
	146	* this is a bug. Please fix your device tree source file. See here
	147	* for discussion:
	148	*
	149	* http://www.mail-archive.com/u-boot@lists.denx.de/msg71598.html
	150	*/
b5220bc6 SG	151	cell = fdt_getprop(blob, node, "status", NULL);
b5220bc6 SG	152	if (cell)
f88fe2de SG	153	return 0 == strcmp(cell, "okay");
f88fe2de SG	154	return 1;
b5220bc6 SG	155	}
b5220bc6 SG	156
7cde397b	157	enum fdt_compat_id fdtdec_lookup(const void *blob, int node)
b5220bc6 SG	158	{
	159	enum fdt_compat_id id;
	160
	161	/* Search our drivers */
	162	for (id = COMPAT_UNKNOWN; id < COMPAT_COUNT; id++)
	163	if (0 == fdt_node_check_compatible(blob, node,
	164	compat_names[id]))
	165	return id;
	166	return COMPAT_UNKNOWN;
	167	}
	168
	169	int fdtdec_next_compatible(const void *blob, int node,
	170	enum fdt_compat_id id)
	171	{
	172	return fdt_node_offset_by_compatible(blob, node, compat_names[id]);
	173	}
	174
3ddecfc7 SG	175	int fdtdec_next_compatible_subnode(const void *blob, int node,
	176	enum fdt_compat_id id, int *depthp)
	177	{
	178	do {
	179	node = fdt_next_node(blob, node, depthp);
	180	} while (*depthp > 1);
	181
	182	/* If this is a direct subnode, and compatible, return it */
	183	if (*depthp == 1 && 0 == fdt_node_check_compatible(
	184	blob, node, compat_names[id]))
	185	return node;
	186
	187	return -FDT_ERR_NOTFOUND;
	188	}
	189
b5220bc6 SG	190	int fdtdec_next_alias(const void blob, const char name,
	191	enum fdt_compat_id id, int *upto)
	192	{
	193	#define MAX_STR_LEN 20
	194	char str[MAX_STR_LEN + 20];
	195	int node, err;
	196
	197	/* snprintf() is not available */
	198	assert(strlen(name) < MAX_STR_LEN);
	199	sprintf(str, "%.s%d", MAX_STR_LEN, name, upto);
00878476	200	node = fdt_path_offset(blob, str);
b5220bc6 SG	201	if (node < 0)
	202	return node;
	203	err = fdt_node_check_compatible(blob, node, compat_names[id]);
	204	if (err < 0)
	205	return err;
f88fe2de SG	206	if (err)
	207	return -FDT_ERR_NOTFOUND;
	208	(*upto)++;
	209	return node;
b5220bc6 SG	210	}
b5220bc6 SG	211
a53f4a29 SG	212	int fdtdec_find_aliases_for_id(const void blob, const char name,
a53f4a29 SG	213	enum fdt_compat_id id, int *node_list, int maxcount)
c6782270 SG	214	{
	215	memset(node_list, '\0', sizeof(node_list) maxcount);
	216
	217	return fdtdec_add_aliases_for_id(blob, name, id, node_list, maxcount);
	218	}
	219
	220	/* TODO: Can we tighten this code up a little? */
	221	int fdtdec_add_aliases_for_id(const void blob, const char name,
	222	enum fdt_compat_id id, int *node_list, int maxcount)
a53f4a29 SG	223	{
	224	int name_len = strlen(name);
	225	int nodes[maxcount];
	226	int num_found = 0;
	227	int offset, node;
	228	int alias_node;
	229	int count;
	230	int i, j;
	231
	232	/* find the alias node if present */
	233	alias_node = fdt_path_offset(blob, "/aliases");
	234
	235	/*
	236	* start with nothing, and we can assume that the root node can't
	237	* match
	238	*/
	239	memset(nodes, '\0', sizeof(nodes));
	240
	241	/* First find all the compatible nodes */
	242	for (node = count = 0; node >= 0 && count < maxcount;) {
	243	node = fdtdec_next_compatible(blob, node, id);
	244	if (node >= 0)
	245	nodes[count++] = node;
	246	}
	247	if (node >= 0)
	248	debug("%s: warning: maxcount exceeded with alias '%s'\n",
	249	__func__, name);
	250
	251	/* Now find all the aliases */
a53f4a29 SG	252	for (offset = fdt_first_property_offset(blob, alias_node);
	253	offset > 0;
	254	offset = fdt_next_property_offset(blob, offset)) {
	255	const struct fdt_property *prop;
	256	const char *path;
	257	int number;
	258	int found;
	259
	260	node = 0;
	261	prop = fdt_get_property_by_offset(blob, offset, NULL);
	262	path = fdt_string(blob, fdt32_to_cpu(prop->nameoff));
	263	if (prop->len && 0 == strncmp(path, name, name_len))
	264	node = fdt_path_offset(blob, prop->data);
	265	if (node <= 0)
	266	continue;
	267
	268	/* Get the alias number */
	269	number = simple_strtoul(path + name_len, NULL, 10);
	270	if (number < 0 \|\| number >= maxcount) {
	271	debug("%s: warning: alias '%s' is out of range\n",
	272	__func__, path);
	273	continue;
	274	}
	275
	276	/* Make sure the node we found is actually in our list! */
	277	found = -1;
	278	for (j = 0; j < count; j++)
	279	if (nodes[j] == node) {
	280	found = j;
	281	break;
	282	}
	283
	284	if (found == -1) {
	285	debug("%s: warning: alias '%s' points to a node "
	286	"'%s' that is missing or is not compatible "
	287	" with '%s'\n", __func__, path,
	288	fdt_get_name(blob, node, NULL),
	289	compat_names[id]);
	290	continue;
	291	}
	292
	293	/*
	294	* Add this node to our list in the right place, and mark
	295	* it as done.
	296	*/
	297	if (fdtdec_get_is_enabled(blob, node)) {
c6782270 SG	298	if (node_list[number]) {
	299	debug("%s: warning: alias '%s' requires that "
	300	"a node be placed in the list in a "
	301	"position which is already filled by "
	302	"node '%s'\n", __func__, path,
	303	fdt_get_name(blob, node, NULL));
	304	continue;
	305	}
a53f4a29 SG	306	node_list[number] = node;
	307	if (number >= num_found)
	308	num_found = number + 1;
	309	}
c6782270	310	nodes[found] = 0;
a53f4a29 SG	311	}
	312
	313	/* Add any nodes not mentioned by an alias */
	314	for (i = j = 0; i < maxcount; i++) {
	315	if (!node_list[i]) {
	316	for (; j < maxcount; j++)
	317	if (nodes[j] &&
	318	fdtdec_get_is_enabled(blob, nodes[j]))
	319	break;
	320
	321	/* Have we run out of nodes to add? */
	322	if (j == maxcount)
	323	break;
	324
	325	assert(!node_list[i]);
	326	node_list[i] = nodes[j++];
	327	if (i >= num_found)
	328	num_found = i + 1;
	329	}
	330	}
	331
	332	return num_found;
	333	}
	334
9a263e55 SG	335	int fdtdec_check_fdt(void)
	336	{
	337	/*
	338	* We must have an FDT, but we cannot panic() yet since the console
	339	* is not ready. So for now, just assert(). Boards which need an early
	340	* FDT (prior to console ready) will need to make their own
	341	* arrangements and do their own checks.
	342	*/
	343	assert(!fdtdec_prepare_fdt());
	344	return 0;
	345	}
	346
b5220bc6 SG	347	/*
	348	* This function is a little odd in that it accesses global data. At some
	349	* point if the architecture board.c files merge this will make more sense.
	350	* Even now, it is common code.
	351	*/
9a263e55	352	int fdtdec_prepare_fdt(void)
b5220bc6	353	{
c309c2da SG	354	if (!gd->fdt_blob \|\| ((uintptr_t)gd->fdt_blob & 3) \|\|
c309c2da SG	355	fdt_check_header(gd->fdt_blob)) {
9a263e55 SG	356	printf("No valid FDT found - please append one to U-Boot "
9a263e55 SG	357	"binary, use u-boot-dtb.bin or define "
a733b06b	358	"CONFIG_OF_EMBED. For sandbox, use -d <file.dtb>\n");
9a263e55 SG	359	return -1;
9a263e55 SG	360	}
b5220bc6 SG	361	return 0;
b5220bc6 SG	362	}
d17da655 SG	363
	364	int fdtdec_lookup_phandle(const void blob, int node, const char prop_name)
	365	{
	366	const u32 *phandle;
	367	int lookup;
	368
1cb2323b	369	debug("%s: %s\n", __func__, prop_name);
d17da655 SG	370	phandle = fdt_getprop(blob, node, prop_name, NULL);
	371	if (!phandle)
	372	return -FDT_ERR_NOTFOUND;
	373
	374	lookup = fdt_node_offset_by_phandle(blob, fdt32_to_cpu(*phandle));
	375	return lookup;
	376	}
	377
	378	/**
	379	* Look up a property in a node and check that it has a minimum length.
	380	*
	381	* @param blob FDT blob
	382	* @param node node to examine
	383	* @param prop_name name of property to find
	384	* @param min_len minimum property length in bytes
	385	* @param err 0 if ok, or -FDT_ERR_NOTFOUND if the property is not
	386	found, or -FDT_ERR_BADLAYOUT if not enough data
	387	* @return pointer to cell, which is only valid if err == 0
	388	*/
	389	static const void get_prop_check_min_len(const void blob, int node,
	390	const char prop_name, int min_len, int err)
	391	{
	392	const void *cell;
	393	int len;
	394
	395	debug("%s: %s\n", __func__, prop_name);
	396	cell = fdt_getprop(blob, node, prop_name, &len);
	397	if (!cell)
	398	*err = -FDT_ERR_NOTFOUND;
	399	else if (len < min_len)
	400	*err = -FDT_ERR_BADLAYOUT;
	401	else
	402	*err = 0;
	403	return cell;
	404	}
	405
	406	int fdtdec_get_int_array(const void blob, int node, const char prop_name,
	407	u32 *array, int count)
	408	{
	409	const u32 *cell;
	410	int i, err = 0;
	411
	412	debug("%s: %s\n", __func__, prop_name);
	413	cell = get_prop_check_min_len(blob, node, prop_name,
	414	sizeof(u32) * count, &err);
	415	if (!err) {
	416	for (i = 0; i < count; i++)
	417	array[i] = fdt32_to_cpu(cell[i]);
	418	}
	419	return err;
	420	}
	421
96875e7d SG	422	const u32 fdtdec_locate_array(const void blob, int node,
	423	const char *prop_name, int count)
	424	{
	425	const u32 *cell;
	426	int err;
	427
	428	cell = get_prop_check_min_len(blob, node, prop_name,
	429	sizeof(u32) * count, &err);
	430	return err ? NULL : cell;
	431	}
	432
d17da655 SG	433	int fdtdec_get_bool(const void blob, int node, const char prop_name)
	434	{
	435	const s32 *cell;
	436	int len;
	437
	438	debug("%s: %s\n", __func__, prop_name);
	439	cell = fdt_getprop(blob, node, prop_name, &len);
	440	return cell != NULL;
	441	}
ed3ee5cd SG	442
	443	/**
	444	* Decode a list of GPIOs from an FDT. This creates a list of GPIOs with no
	445	* terminating item.
	446	*
	447	* @param blob FDT blob to use
	448	* @param node Node to look at
	449	* @param prop_name Node property name
	450	* @param gpio Array of gpio elements to fill from FDT. This will be
	451	* untouched if either 0 or an error is returned
	452	* @param max_count Maximum number of elements allowed
	453	* @return number of GPIOs read if ok, -FDT_ERR_BADLAYOUT if max_count would
	454	* be exceeded, or -FDT_ERR_NOTFOUND if the property is missing.
	455	*/
5921f6a2 AK	456	int fdtdec_decode_gpios(const void blob, int node, const char prop_name,
5921f6a2 AK	457	struct fdt_gpio_state *gpio, int max_count)
ed3ee5cd SG	458	{
	459	const struct fdt_property *prop;
	460	const u32 *cell;
	461	const char *name;
	462	int len, i;
	463
	464	debug("%s: %s\n", __func__, prop_name);
	465	assert(max_count > 0);
	466	prop = fdt_get_property(blob, node, prop_name, &len);
	467	if (!prop) {
1cb2323b	468	debug("%s: property '%s' missing\n", __func__, prop_name);
ed3ee5cd SG	469	return -FDT_ERR_NOTFOUND;
	470	}
	471
	472	/* We will use the name to tag the GPIO */
	473	name = fdt_string(blob, fdt32_to_cpu(prop->nameoff));
	474	cell = (u32 *)prop->data;
	475	len /= sizeof(u32) * 3; /* 3 cells per GPIO record */
	476	if (len > max_count) {
1cb2323b	477	debug(" %s: too many GPIOs / cells for "
ed3ee5cd SG	478	"property '%s'\n", __func__, prop_name);
	479	return -FDT_ERR_BADLAYOUT;
	480	}
	481
	482	/* Read out the GPIO data from the cells */
	483	for (i = 0; i < len; i++, cell += 3) {
	484	gpio[i].gpio = fdt32_to_cpu(cell[1]);
	485	gpio[i].flags = fdt32_to_cpu(cell[2]);
	486	gpio[i].name = name;
	487	}
	488
	489	return len;
	490	}
	491
	492	int fdtdec_decode_gpio(const void blob, int node, const char prop_name,
	493	struct fdt_gpio_state *gpio)
	494	{
	495	int err;
	496
	497	debug("%s: %s\n", __func__, prop_name);
	498	gpio->gpio = FDT_GPIO_NONE;
	499	gpio->name = NULL;
	500	err = fdtdec_decode_gpios(blob, node, prop_name, gpio, 1);
	501	return err == 1 ? 0 : err;
	502	}
	503
202ff753 SP	504	int fdtdec_get_gpio(struct fdt_gpio_state *gpio)
	505	{
	506	int val;
	507
	508	if (!fdt_gpio_isvalid(gpio))
	509	return -1;
	510
	511	val = gpio_get_value(gpio->gpio);
	512	return gpio->flags & FDT_GPIO_ACTIVE_LOW ? val ^ 1 : val;
	513	}
	514
	515	int fdtdec_set_gpio(struct fdt_gpio_state *gpio, int val)
	516	{
	517	if (!fdt_gpio_isvalid(gpio))
	518	return -1;
	519
	520	val = gpio->flags & FDT_GPIO_ACTIVE_LOW ? val ^ 1 : val;
	521	return gpio_set_value(gpio->gpio, val);
	522	}
	523
ed3ee5cd SG	524	int fdtdec_setup_gpio(struct fdt_gpio_state *gpio)
	525	{
	526	/*
	527	* Return success if there is no GPIO defined. This is used for
	528	* optional GPIOs)
	529	*/
	530	if (!fdt_gpio_isvalid(gpio))
	531	return 0;
	532
	533	if (gpio_request(gpio->gpio, gpio->name))
	534	return -1;
	535	return 0;
	536	}
bed4d892 AS	537
	538	int fdtdec_get_byte_array(const void blob, int node, const char prop_name,
	539	u8 *array, int count)
	540	{
	541	const u8 *cell;
	542	int err;
	543
	544	cell = get_prop_check_min_len(blob, node, prop_name, count, &err);
	545	if (!err)
	546	memcpy(array, cell, count);
	547	return err;
	548	}
	549
	550	const u8 fdtdec_locate_byte_array(const void blob, int node,
	551	const char *prop_name, int count)
	552	{
	553	const u8 *cell;
	554	int err;
	555
	556	cell = get_prop_check_min_len(blob, node, prop_name, count, &err);
	557	if (err)
	558	return NULL;
	559	return cell;
	560	}
09258f1e	561
09258f1e AK	562	int fdtdec_get_config_int(const void blob, const char prop_name,
	563	int default_val)
	564	{
	565	int config_node;
	566
	567	debug("%s: %s\n", __func__, prop_name);
	568	config_node = fdt_path_offset(blob, "/config");
	569	if (config_node < 0)
	570	return default_val;
	571	return fdtdec_get_int(blob, config_node, prop_name, default_val);
	572	}
332ab0d5	573
79289c0b GB	574	int fdtdec_get_config_bool(const void blob, const char prop_name)
	575	{
	576	int config_node;
	577	const void *prop;
	578
	579	debug("%s: %s\n", __func__, prop_name);
	580	config_node = fdt_path_offset(blob, "/config");
	581	if (config_node < 0)
	582	return 0;
	583	prop = fdt_get_property(blob, config_node, prop_name, NULL);
	584
	585	return prop != NULL;
	586	}
	587
332ab0d5 SG	588	char fdtdec_get_config_string(const void blob, const char *prop_name)
	589	{
	590	const char *nodep;
	591	int nodeoffset;
	592	int len;
	593
	594	debug("%s: %s\n", __func__, prop_name);
	595	nodeoffset = fdt_path_offset(blob, "/config");
	596	if (nodeoffset < 0)
	597	return NULL;
	598
	599	nodep = fdt_getprop(blob, nodeoffset, prop_name, &len);
	600	if (!nodep)
	601	return NULL;
	602
	603	return (char *)nodep;
	604	}
f20c4619 SG	605
	606	int fdtdec_decode_region(const void *blob, int node,
	607	const char prop_name, void ptrp, size_t size)
	608	{
	609	const fdt_addr_t *cell;
	610	int len;
	611
	612	debug("%s: %s\n", __func__, prop_name);
	613	cell = fdt_getprop(blob, node, prop_name, &len);
	614	if (!cell \|\| (len != sizeof(fdt_addr_t) * 2))
	615	return -1;
	616
370b6c5c	617	ptrp = map_sysmem(fdt_addr_to_cpu(cell), *size);
f20c4619 SG	618	*size = fdt_size_to_cpu(cell[1]);
	619	debug("%s: size=%zx\n", __func__, *size);
	620	return 0;
	621	}
006e73b9 SG	622
	623	/**
	624	* Read a flash entry from the fdt
	625	*
	626	* @param blob FDT blob
	627	* @param node Offset of node to read
	628	* @param name Name of node being read
	629	* @param entry Place to put offset and size of this node
	630	* @return 0 if ok, -ve on error
	631	*/
	632	int fdtdec_read_fmap_entry(const void blob, int node, const char name,
	633	struct fmap_entry *entry)
	634	{
	635	u32 reg[2];
	636
	637	if (fdtdec_get_int_array(blob, node, "reg", reg, 2)) {
	638	debug("Node '%s' has bad/missing 'reg' property\n", name);
	639	return -FDT_ERR_NOTFOUND;
	640	}
	641	entry->offset = reg[0];
	642	entry->length = reg[1];
	643
	644	return 0;
	645	}