LXR linux/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 */
  24extern 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 */
  30extern void platform_setup (char **);
  31
  32/*
  33 * platform_restart is called to restart the system.
  34 */
  35extern void platform_restart (void);
  36
  37/*
  38 * platform_halt is called to stop the system and halt.
  39 */
  40extern void platform_halt (void);
  41
  42/*
  43 * platform_power_off is called to stop the system and power it off.
  44 */
  45extern void platform_power_off (void);
  46
  47/*
  48 * platform_idle is called from the idle function.
  49 */
  50extern void platform_idle (void);
  51
  52/*
  53 * platform_heartbeat is called every HZ
  54 */
  55extern void platform_heartbeat (void);
  56
  57/*
  58 * platform_calibrate_ccount calibrates cpu clock freq (CONFIG_XTENSA_CALIBRATE)
  59 */
  60extern 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 */
  66void 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 */
  78bool platform_vaddr_cached(const void *p);
  79
  80/*
  81 * Check whether p points to an uncached memory.
  82 */
  83bool platform_vaddr_uncached(const void *p);
  84
  85/*
  86 * Return pointer to an uncached view of the cached sddress p.
  87 */
  88void *platform_vaddr_to_uncached(void *p);
  89
  90/*
  91 * Return pointer to a cached view of the uncached sddress p.
  92 */
  93void *platform_vaddr_to_cached(void *p);
  94
  95#endif  /* _XTENSA_PLATFORM_H */
  96