pm.h
上传用户:szlgq88
上传日期:2009-04-28
资源大小:48287k
文件大小:7k
源码类别:

嵌入式Linux

开发平台:

Unix_Linux

  1. /*
  2.  *  pm.h - Power management interface
  3.  *
  4.  *  Copyright (C) 2000 Andrew Henroid
  5.  *
  6.  *  This program is free software; you can redistribute it and/or modify
  7.  *  it under the terms of the GNU General Public License as published by
  8.  *  the Free Software Foundation; either version 2 of the License, or
  9.  *  (at your option) any later version.
  10.  *
  11.  *  This program is distributed in the hope that it will be useful,
  12.  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  13.  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14.  *  GNU General Public License for more details.
  15.  *
  16.  *  You should have received a copy of the GNU General Public License
  17.  *  along with this program; if not, write to the Free Software
  18.  *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  19.  */
  20. #ifndef _LINUX_PM_H
  21. #define _LINUX_PM_H
  22. #ifdef __KERNEL__
  23. #include <linux/config.h>
  24. #include <linux/list.h>
  25. #include <asm/atomic.h>
  26. /*
  27.  * Power management requests... these are passed to pm_send_all() and friends.
  28.  *
  29.  * these functions are old and deprecated, see below.
  30.  */
  31. typedef int __bitwise pm_request_t;
  32. #define PM_SUSPEND ((__force pm_request_t) 1) /* enter D1-D3 */
  33. #define PM_RESUME ((__force pm_request_t) 2) /* enter D0 */
  34. /*
  35.  * Device types... these are passed to pm_register
  36.  */
  37. typedef int __bitwise pm_dev_t;
  38. #define PM_UNKNOWN_DEV ((__force pm_dev_t) 0) /* generic */
  39. #define PM_SYS_DEV ((__force pm_dev_t) 1) /* system device (fan, KB controller, ...) */
  40. #define PM_PCI_DEV ((__force pm_dev_t) 2) /* PCI device */
  41. #define PM_USB_DEV ((__force pm_dev_t) 3) /* USB device */
  42. #define PM_SCSI_DEV ((__force pm_dev_t) 4) /* SCSI device */
  43. #define PM_ISA_DEV ((__force pm_dev_t) 5) /* ISA device */
  44. #define PM_MTD_DEV ((__force pm_dev_t) 6) /* Memory Technology Device */
  45. /*
  46.  * System device hardware ID (PnP) values
  47.  */
  48. enum
  49. {
  50. PM_SYS_UNKNOWN = 0x00000000, /* generic */
  51. PM_SYS_KBC =  0x41d00303, /* keyboard controller */
  52. PM_SYS_COM =  0x41d00500, /* serial port */
  53. PM_SYS_IRDA =  0x41d00510, /* IRDA controller */
  54. PM_SYS_FDC =  0x41d00700, /* floppy controller */
  55. PM_SYS_VGA =  0x41d00900, /* VGA controller */
  56. PM_SYS_PCMCIA =  0x41d00e00, /* PCMCIA controller */
  57. };
  58. /*
  59.  * Device identifier
  60.  */
  61. #define PM_PCI_ID(dev) ((dev)->bus->number << 16 | (dev)->devfn)
  62. /*
  63.  * Request handler callback
  64.  */
  65. struct pm_dev;
  66. typedef int (*pm_callback)(struct pm_dev *dev, pm_request_t rqst, void *data);
  67. /*
  68.  * Dynamic device information
  69.  */
  70. struct pm_dev
  71. {
  72. pm_dev_t  type;
  73. unsigned long  id;
  74. pm_callback  callback;
  75. void *data;
  76. unsigned long  flags;
  77. unsigned long  state;
  78. unsigned long  prev_state;
  79. struct list_head entry;
  80. };
  81. #ifdef CONFIG_PM
  82. extern int pm_active;
  83. #define PM_IS_ACTIVE() (pm_active != 0)
  84. /*
  85.  * Register a device with power management
  86.  */
  87. struct pm_dev __deprecated *
  88. pm_register(pm_dev_t type, unsigned long id, pm_callback callback);
  89. /*
  90.  * Unregister a device with power management
  91.  */
  92. void __deprecated pm_unregister(struct pm_dev *dev);
  93. /*
  94.  * Unregister all devices with matching callback
  95.  */
  96. void __deprecated pm_unregister_all(pm_callback callback);
  97. /*
  98.  * Send a request to all devices
  99.  */
  100. int __deprecated pm_send_all(pm_request_t rqst, void *data);
  101. #else /* CONFIG_PM */
  102. #define PM_IS_ACTIVE() 0
  103. static inline struct pm_dev *pm_register(pm_dev_t type,
  104.  unsigned long id,
  105.  pm_callback callback)
  106. {
  107. return NULL;
  108. }
  109. static inline void pm_unregister(struct pm_dev *dev) {}
  110. static inline void pm_unregister_all(pm_callback callback) {}
  111. static inline int pm_send_all(pm_request_t rqst, void *data)
  112. {
  113. return 0;
  114. }
  115. #endif /* CONFIG_PM */
  116. /* Functions above this comment are list-based old-style power
  117.  * managment. Please avoid using them.  */
  118. /*
  119.  * Callbacks for platform drivers to implement.
  120.  */
  121. extern void (*pm_idle)(void);
  122. extern void (*pm_power_off)(void);
  123. typedef int __bitwise suspend_state_t;
  124. #define PM_SUSPEND_ON ((__force suspend_state_t) 0)
  125. #define PM_SUSPEND_STANDBY ((__force suspend_state_t) 1)
  126. #define PM_SUSPEND_MEM ((__force suspend_state_t) 3)
  127. #define PM_SUSPEND_DISK ((__force suspend_state_t) 4)
  128. #define PM_SUSPEND_MAX ((__force suspend_state_t) 5)
  129. typedef int __bitwise suspend_disk_method_t;
  130. #define PM_DISK_FIRMWARE ((__force suspend_disk_method_t) 1)
  131. #define PM_DISK_PLATFORM ((__force suspend_disk_method_t) 2)
  132. #define PM_DISK_SHUTDOWN ((__force suspend_disk_method_t) 3)
  133. #define PM_DISK_REBOOT ((__force suspend_disk_method_t) 4)
  134. #define PM_DISK_MAX ((__force suspend_disk_method_t) 5)
  135. struct pm_ops {
  136. suspend_disk_method_t pm_disk_mode;
  137. int (*prepare)(suspend_state_t state);
  138. int (*enter)(suspend_state_t state);
  139. int (*finish)(suspend_state_t state);
  140. };
  141. extern void pm_set_ops(struct pm_ops *);
  142. extern struct pm_ops *pm_ops;
  143. extern int pm_suspend(suspend_state_t state);
  144. /*
  145.  * Device power management
  146.  */
  147. struct device;
  148. typedef struct pm_message {
  149. int event;
  150. } pm_message_t;
  151. /*
  152.  * There are 4 important states driver can be in:
  153.  * ON     -- driver is working
  154.  * FREEZE -- stop operations and apply whatever policy is applicable to a
  155.  *           suspended driver of that class, freeze queues for block like IDE
  156.  *           does, drop packets for ethernet, etc... stop DMA engine too etc...
  157.  *           so a consistent image can be saved; but do not power any hardware
  158.  *           down.
  159.  * SUSPEND - like FREEZE, but hardware is doing as much powersaving as
  160.  *           possible. Roughly pci D3.
  161.  *
  162.  * Unfortunately, current drivers only recognize numeric values 0 (ON) and 3
  163.  * (SUSPEND).  We'll need to fix the drivers. So yes, putting 3 to all different
  164.  * defines is intentional, and will go away as soon as drivers are fixed.  Also
  165.  * note that typedef is neccessary, we'll probably want to switch to
  166.  *   typedef struct pm_message_t { int event; int flags; } pm_message_t
  167.  * or something similar soon.
  168.  */
  169. #define PM_EVENT_ON 0
  170. #define PM_EVENT_FREEZE 1
  171. #define PM_EVENT_SUSPEND 2
  172. #define PMSG_FREEZE ((struct pm_message){ .event = PM_EVENT_FREEZE, })
  173. #define PMSG_SUSPEND ((struct pm_message){ .event = PM_EVENT_SUSPEND, })
  174. #define PMSG_ON ((struct pm_message){ .event = PM_EVENT_ON, })
  175. struct dev_pm_info {
  176. pm_message_t power_state;
  177. #ifdef CONFIG_PM
  178. pm_message_t prev_state;
  179. void * saved_state;
  180. atomic_t pm_users;
  181. struct device * pm_parent;
  182. struct list_head entry;
  183. #endif
  184. };
  185. extern void device_pm_set_parent(struct device * dev, struct device * parent);
  186. extern int device_power_down(pm_message_t state);
  187. extern void device_power_up(void);
  188. extern void device_resume(void);
  189. #ifdef CONFIG_PM
  190. extern int device_suspend(pm_message_t state);
  191. #else
  192. static inline int device_suspend(pm_message_t state)
  193. {
  194. return 0;
  195. }
  196. #endif
  197. #endif /* __KERNEL__ */
  198. #endif /* _LINUX_PM_H */