arch/xtensa/include/asm/platform.h

   1 /*
   2  * Platform specific functions
   3  *
   4  * This file is subject to the terms and conditions of the GNU General
   5  * Public License.  See the file "COPYING" in the main directory of
   6  * this archive for more details.
   7  *
   8  * Copyright (C) 2001 - 2005 Tensilica Inc.
   9  */
  10
  11 #ifndef _XTENSA_PLATFORM_H
  12 #define _XTENSA_PLATFORM_H
  13
  14 #include <linux/types.h>
  15 #include <linux/pci.h>
  16
  17 #include <asm/bootparam.h>
  18
  19 /*
  20  * platform_init is called before the mmu is initialized to give the
  21  * platform a early hook-up. bp_tag_t is a list of configuration tags
  22  * passed from the boot-loader.
  23  */
  24 extern void platform_init(bp_tag_t*);
  25
  26 /*
  27  * platform_setup is called from setup_arch with a pointer to the command-line
  28  * string.
  29  */
  30 extern void platform_setup (char **);
  31
  32 /*
  33  * platform_restart is called to restart the system.
  34  */
  35 extern void platform_restart (void);
  36
  37 /*
  38  * platform_halt is called to stop the system and halt.
  39  */
  40 extern void platform_halt (void);
  41
  42 /*
  43  * platform_power_off is called to stop the system and power it off.
  44  */
  45 extern void platform_power_off (void);
  46
  47 /*
  48  * platform_idle is called from the idle function.
  49  */
  50 extern void platform_idle (void);
  51
  52 /*
  53  * platform_heartbeat is called every HZ
  54  */
  55 extern void platform_heartbeat (void);
  56
  57 /*
  58  * platform_calibrate_ccount calibrates cpu clock freq (CONFIG_XTENSA_CALIBRATE)
  59  */
  60 extern void platform_calibrate_ccount (void);
  61
  62 /*
  63  * Flush and reset the mmu, simulate a processor reset, and
  64  * jump to the reset vector.
  65  */
  66 void cpu_reset(void) __attribute__((noreturn));
  67
  68 /*
  69  * Memory caching is platform-dependent in noMMU xtensa configurations.
  70  * The following set of functions should be implemented in platform code
  71  * in order to enable coherent DMA memory operations when CONFIG_MMU is not
  72  * enabled. Default implementations do nothing and issue a warning.
  73  */
  74
  75 /*
  76  * Check whether p points to a cached memory.
  77  */
  78 bool platform_vaddr_cached(const void *p);
  79
  80 /*
  81  * Check whether p points to an uncached memory.
  82  */
  83 bool platform_vaddr_uncached(const void *p);
  84
  85 /*
  86  * Return pointer to an uncached view of the cached sddress p.
  87  */
  88 void *platform_vaddr_to_uncached(void *p);
  89
  90 /*
  91  * Return pointer to a cached view of the uncached sddress p.
  92  */
  93 void *platform_vaddr_to_cached(void *p);
  94
  95 #endif  /* _XTENSA_PLATFORM_H */