arch/arm/plat-samsung/include/plat/pm.h

   1 /* arch/arm/plat-samsung/include/plat/pm.h
   2  *
   3  * Copyright (c) 2004 Simtec Electronics
   4  *      http://armlinux.simtec.co.uk/
   5  *      Written by Ben Dooks, <ben@simtec.co.uk>
   6  *
   7  * This program is free software; you can redistribute it and/or modify
   8  * it under the terms of the GNU General Public License version 2 as
   9  * published by the Free Software Foundation.
  10 */
  11
  12 /* s3c_pm_init
  13  *
  14  * called from board at initialisation time to setup the power
  15  * management
  16 */
  17
  18 #include <linux/irq.h>
  19
  20 struct sys_device;
  21
  22 #ifdef CONFIG_PM
  23
  24 extern __init int s3c_pm_init(void);
  25
  26 #else
  27
  28 static inline int s3c_pm_init(void)
  29 {
  30         return 0;
  31 }
  32 #endif
  33
  34 /* configuration for the IRQ mask over sleep */
  35 extern unsigned long s3c_irqwake_intmask;
  36 extern unsigned long s3c_irqwake_eintmask;
  37
  38 /* IRQ masks for IRQs allowed to go to sleep (see irq.c) */
  39 extern unsigned long s3c_irqwake_intallow;
  40 extern unsigned long s3c_irqwake_eintallow;
  41
  42 /* per-cpu sleep functions */
  43
  44 extern void (*pm_cpu_prep)(void);
  45 extern void (*pm_cpu_sleep)(void);
  46
  47 /* Flags for PM Control */
  48
  49 extern unsigned long s3c_pm_flags;
  50
  51 extern unsigned char pm_uart_udivslot;  /* true to save UART UDIVSLOT */
  52
  53 /* from sleep.S */
  54
  55 extern int  s3c_cpu_save(unsigned long *saveblk, long);
  56 extern void s3c_cpu_resume(void);
  57
  58 extern void s3c2410_cpu_suspend(void);
  59
  60 /* sleep save info */
  61
  62 /**
  63  * struct sleep_save - save information for shared peripherals.
  64  * @reg: Pointer to the register to save.
  65  * @val: Holder for the value saved from reg.
  66  *
  67  * This describes a list of registers which is used by the pm core and
  68  * other subsystem to save and restore register values over suspend.
  69  */
  70 struct sleep_save {
  71         void __iomem    *reg;
  72         unsigned long   val;
  73 };
  74
  75 #define SAVE_ITEM(x) \
  76         { .reg = (x) }
  77
  78 /**
  79  * struct pm_uart_save - save block for core UART
  80  * @ulcon: Save value for S3C2410_ULCON
  81  * @ucon: Save value for S3C2410_UCON
  82  * @ufcon: Save value for S3C2410_UFCON
  83  * @umcon: Save value for S3C2410_UMCON
  84  * @ubrdiv: Save value for S3C2410_UBRDIV
  85  *
  86  * Save block for UART registers to be held over sleep and restored if they
  87  * are needed (say by debug).
  88 */
  89 struct pm_uart_save {
  90         u32     ulcon;
  91         u32     ucon;
  92         u32     ufcon;
  93         u32     umcon;
  94         u32     ubrdiv;
  95         u32     udivslot;
  96 };
  97
  98 /* helper functions to save/restore lists of registers. */
  99
 100 extern void s3c_pm_do_save(struct sleep_save *ptr, int count);
 101 extern void s3c_pm_do_restore(struct sleep_save *ptr, int count);
 102 extern void s3c_pm_do_restore_core(struct sleep_save *ptr, int count);
 103
 104 #ifdef CONFIG_PM
 105 extern int s3c_irqext_wake(struct irq_data *data, unsigned int state);
 106 extern int s3c24xx_irq_suspend(void);
 107 extern void s3c24xx_irq_resume(void);
 108 #else
 109 #define s3c_irqext_wake NULL
 110 #define s3c24xx_irq_suspend NULL
 111 #define s3c24xx_irq_resume  NULL
 112 #endif
 113
 114 extern struct syscore_ops s3c24xx_irq_syscore_ops;
 115
 116 /* PM debug functions */
 117
 118 #ifdef CONFIG_SAMSUNG_PM_DEBUG
 119 /**
 120  * s3c_pm_dbg() - low level debug function for use in suspend/resume.
 121  * @msg: The message to print.
 122  *
 123  * This function is used mainly to debug the resume process before the system
 124  * can rely on printk/console output. It uses the low-level debugging output
 125  * routine printascii() to do its work.
 126  */
 127 extern void s3c_pm_dbg(const char *msg, ...);
 128
 129 #define S3C_PMDBG(fmt...) s3c_pm_dbg(fmt)
 130 #else
 131 #define S3C_PMDBG(fmt...) printk(KERN_DEBUG fmt)
 132 #endif
 133
 134 #ifdef CONFIG_S3C_PM_DEBUG_LED_SMDK
 135 /**
 136  * s3c_pm_debug_smdkled() - Debug PM suspend/resume via SMDK Board LEDs
 137  * @set: set bits for the state of the LEDs
 138  * @clear: clear bits for the state of the LEDs.
 139  */
 140 extern void s3c_pm_debug_smdkled(u32 set, u32 clear);
 141
 142 #else
 143 static inline void s3c_pm_debug_smdkled(u32 set, u32 clear) { }
 144 #endif /* CONFIG_S3C_PM_DEBUG_LED_SMDK */
 145
 146 /* suspend memory checking */
 147
 148 #ifdef CONFIG_SAMSUNG_PM_CHECK
 149 extern void s3c_pm_check_prepare(void);
 150 extern void s3c_pm_check_restore(void);
 151 extern void s3c_pm_check_cleanup(void);
 152 extern void s3c_pm_check_store(void);
 153 #else
 154 #define s3c_pm_check_prepare() do { } while(0)
 155 #define s3c_pm_check_restore() do { } while(0)
 156 #define s3c_pm_check_cleanup() do { } while(0)
 157 #define s3c_pm_check_store()   do { } while(0)
 158 #endif
 159
 160 /**
 161  * s3c_pm_configure_extint() - ensure pins are correctly set for IRQ
 162  *
 163  * Setup all the necessary GPIO pins for waking the system on external
 164  * interrupt.
 165  */
 166 extern void s3c_pm_configure_extint(void);
 167
 168 /**
 169  * s3c_pm_restore_gpios() - restore the state of the gpios after sleep.
 170  *
 171  * Restore the state of the GPIO pins after sleep, which may involve ensuring
 172  * that we do not glitch the state of the pins from that the bootloader's
 173  * resume code has done.
 174 */
 175 extern void s3c_pm_restore_gpios(void);
 176
 177 /**
 178  * s3c_pm_save_gpios() - save the state of the GPIOs for restoring after sleep.
 179  *
 180  * Save the GPIO states for resotration on resume. See s3c_pm_restore_gpios().
 181  */
 182 extern void s3c_pm_save_gpios(void);
 183
 184 extern void s3c_pm_save_core(void);
 185 extern void s3c_pm_restore_core(void);