#ifndef _LINUX_OF_PLATFORM_H
  #define _LINUX_OF_PLATFORM_H
  /*
   *    Copyright (C) 2006 Benjamin Herrenschmidt, IBM Corp.
   *			 <benh@kernel.crashing.org>
   *
   *  This program is free software; you can redistribute it and/or
   *  modify it under the terms of the GNU General Public License
   *  as published by the Free Software Foundation; either version
   *  2 of the License, or (at your option) any later version.
   *
   */

  #include <linux/device.h>
  #include <linux/mod_devicetable.h>
  #include <linux/pm.h>
  #include <linux/of_device.h>

  #include <linux/platform_device.h>

  /**

   * struct of_dev_auxdata - lookup table entry for device names & platform_data
   * @compatible: compatible value of node to match against node
   * @phys_addr: Start address of registers to match against node
   * @name: Name to assign for matching nodes
   * @platform_data: platform_data to assign for matching nodes
   *
   * This lookup table allows the caller of of_platform_populate() to override
   * the names of devices when creating devices from the device tree.  The table
   * should be terminated with an empty entry.  It also allows the platform_data
   * pointer to be set.
   *
   * The reason for this functionality is that some Linux infrastructure uses
   * the device name to look up a specific device, but the Linux-specific names
   * are not encoded into the device tree, so the kernel needs to provide specific
   * values.
   *
   * Note: Using an auxdata lookup table should be considered a last resort when
   * converting a platform to use the DT.  Normally the automatically generated
   * device name will not matter, and drivers should obtain data from the device

   * node instead of from an anonymous platform_data pointer.

   */
  struct of_dev_auxdata {
  	char *compatible;
  	resource_size_t phys_addr;
  	char *name;
  	void *platform_data;
  };
  
  /* Macro to simplify populating a lookup table */
  #define OF_DEV_AUXDATA(_compat,_phys,_name,_pdata) \
  	{ .compatible = _compat, .phys_addr = _phys, .name = _name, \
  	  .platform_data = _pdata }

  extern const struct of_device_id of_default_bus_match_table[];

  /* Platform drivers register/unregister */

  extern struct platform_device *of_device_alloc(struct device_node *np,

  					 const char *bus_id,
  					 struct device *parent);

  extern struct platform_device *of_find_device_by_node(struct device_node *np);

  /* Platform devices and busses creation */

  extern struct platform_device *of_platform_device_create(struct device_node *np,

  						   const char *bus_id,
  						   struct device *parent);

  extern int of_platform_bus_probe(struct device_node *root,
  				 const struct of_device_id *matches,
  				 struct device *parent);

  #ifdef CONFIG_OF_ADDRESS

  extern int of_platform_populate(struct device_node *root,
  				const struct of_device_id *matches,

  				const struct of_dev_auxdata *lookup,

  				struct device *parent);

  extern int of_platform_default_populate(struct device_node *root,
  					const struct of_dev_auxdata *lookup,
  					struct device *parent);

  extern void of_platform_depopulate(struct device *parent);

  #else

  static inline int of_platform_populate(struct device_node *root,
  					const struct of_device_id *matches,
  					const struct of_dev_auxdata *lookup,
  					struct device *parent)
  {
  	return -ENODEV;
  }

  static inline int of_platform_default_populate(struct device_node *root,
  					       const struct of_dev_auxdata *lookup,
  					       struct device *parent)
  {
  	return -ENODEV;
  }

  static inline void of_platform_depopulate(struct device *parent) { }

  #endif

  #if defined(CONFIG_OF_DYNAMIC) && defined(CONFIG_OF_ADDRESS)

  extern void of_platform_register_reconfig_notifier(void);
  #else
  static inline void of_platform_register_reconfig_notifier(void) { }
  #endif

  #endif	/* _LINUX_OF_PLATFORM_H */