1 /*- 2 * APM (Advanced Power Management) BIOS Device Driver 3 * 4 * Copyright (c) 1994-1995 by HOSOKAWA, Tatsumi <hosokawa@mt.cs.keio.ac.jp> 5 * 6 * This software may be used, modified, copied, and distributed, in 7 * both source and binary form provided that the above copyright and 8 * these terms are retained. Under no circumstances is the author 9 * responsible for the proper functioning of this software, nor does 10 * the author assume any responsibility for damages incurred with its 11 * use. 12 * 13 * Aug, 1994 Implemented on FreeBSD 1.1.5.1R (Toshiba AVS001WD) 14 * 15 * $FreeBSD$ 16 */ 17 18 #ifndef _X86_APM_BIOS_H_ 19 #define _X86_APM_BIOS_H_ 20 21 #ifndef _KERNEL 22 #include <sys/types.h> 23 #endif 24 #include <sys/ioccom.h> 25 26 /* BIOS id */ 27 #define APM_BIOS 0x53 28 #define APM_INT 0x15 29 30 /* APM flags */ 31 #define APM_16BIT_SUPPORT 0x01 32 #define APM_32BIT_SUPPORT 0x02 33 #define APM_CPUIDLE_SLOW 0x04 34 #define APM_DISABLED 0x08 35 #define APM_DISENGAGED 0x10 36 37 /* APM initializer physical address */ 38 #define APM_OURADDR 0x00080000 39 40 /* APM functions */ 41 #define APM_INSTCHECK 0x00 42 #define APM_REALCONNECT 0x01 43 #define APM_PROT16CONNECT 0x02 44 #define APM_PROT32CONNECT 0x03 45 #define APM_DISCONNECT 0x04 46 #define APM_CPUIDLE 0x05 47 #define APM_CPUBUSY 0x06 48 #define APM_SETPWSTATE 0x07 49 #define APM_ENABLEDISABLEPM 0x08 50 #define APM_RESTOREDEFAULT 0x09 51 #define APM_GETPWSTATUS 0x0a 52 #define APM_GETPMEVENT 0x0b 53 #define APM_GETPWSTATE 0x0c 54 #define APM_ENABLEDISABLEDPM 0x0d 55 #define APM_DRVVERSION 0x0e 56 #define APM_ENGAGEDISENGAGEPM 0x0f 57 #define APM_GETCAPABILITIES 0x10 58 #define APM_RESUMETIMER 0x11 59 #define APM_RESUMEONRING 0x12 60 #define APM_TIMERREQUESTS 0x13 61 #define APM_OEMFUNC 0x80 62 63 /* error code */ 64 #define APME_OK 0x00 65 #define APME_PMDISABLED 0x01 66 #define APME_REALESTABLISHED 0x02 67 #define APME_NOTCONNECTED 0x03 68 #define APME_PROT16ESTABLISHED 0x05 69 #define APME_PROT16NOTSUPPORTED 0x06 70 #define APME_PROT32ESTABLISHED 0x07 71 #define APME_PROT32NOTDUPPORTED 0x08 72 #define APME_UNKNOWNDEVICEID 0x09 73 #define APME_OUTOFRANGE 0x0a 74 #define APME_NOTENGAGED 0x0b 75 #define APME_CANTENTERSTATE 0x60 76 #define APME_NOPMEVENT 0x80 77 #define APME_NOAPMPRESENT 0x86 78 79 /* device code */ 80 #define PMDV_APMBIOS 0x0000 81 #define PMDV_ALLDEV 0x0001 82 #define PMDV_DISP0 0x0100 83 #define PMDV_DISP1 0x0101 84 #define PMDV_DISPALL 0x01ff 85 #define PMDV_2NDSTORAGE0 0x0200 86 #define PMDV_2NDSTORAGE1 0x0201 87 #define PMDV_2NDSTORAGE2 0x0202 88 #define PMDV_2NDSTORAGE3 0x0203 89 #define PMDV_PARALLEL0 0x0300 90 #define PMDV_PARALLEL1 0x0301 91 #define PMDV_SERIAL0 0x0400 92 #define PMDV_SERIAL1 0x0401 93 #define PMDV_SERIAL2 0x0402 94 #define PMDV_SERIAL3 0x0403 95 #define PMDV_SERIAL4 0x0404 96 #define PMDV_SERIAL5 0x0405 97 #define PMDV_SERIAL6 0x0406 98 #define PMDV_SERIAL7 0x0407 99 #define PMDV_NET0 0x0500 100 #define PMDV_NET1 0x0501 101 #define PMDV_NET2 0x0502 102 #define PMDV_NET3 0x0503 103 #define PMDV_PCMCIA0 0x0600 104 #define PMDV_PCMCIA1 0x0601 105 #define PMDV_PCMCIA2 0x0602 106 #define PMDV_PCMCIA3 0x0603 107 /* 0x0700 - 0x7fff Reserved */ 108 #define PMDV_BATT_BASE 0x8000 109 #define PMDV_BATT0 0x8001 110 #define PMDV_BATT1 0x8002 111 #define PMDV_BATT_ALL 0x80ff 112 /* 0x8100 - 0xdfff Reserved */ 113 /* 0xe000 - 0xefff OEM-defined power device IDs */ 114 /* 0xf000 - 0xffff Reserved */ 115 116 /* Power state */ 117 #define PMST_APMENABLED 0x0000 118 #define PMST_STANDBY 0x0001 119 #define PMST_SUSPEND 0x0002 120 #define PMST_OFF 0x0003 121 #define PMST_LASTREQNOTIFY 0x0004 122 #define PMST_LASTREQREJECT 0x0005 123 /* 0x0006 - 0x001f Reserved system states */ 124 /* 0x0020 - 0x003f OEM-defined system states */ 125 /* 0x0040 - 0x007f OEM-defined device states */ 126 /* 0x0080 - 0xffff Reserved device states */ 127 128 #if !defined(ASSEMBLER) && !defined(INITIALIZER) 129 130 /* C definitions */ 131 struct apmhook { 132 struct apmhook *ah_next; 133 int (*ah_fun)(void *ah_arg); 134 void *ah_arg; 135 const char *ah_name; 136 int ah_order; 137 }; 138 #define APM_HOOK_NONE (-1) 139 #define APM_HOOK_SUSPEND 0 140 #define APM_HOOK_RESUME 1 141 #define NAPM_HOOK 2 142 143 #ifdef _KERNEL 144 145 void apm_suspend(int state); 146 struct apmhook *apm_hook_establish (int apmh, struct apmhook *); 147 void apm_hook_disestablish (int apmh, struct apmhook *); 148 void apm_cpu_idle(void); 149 void apm_cpu_busy(void); 150 151 #endif 152 153 #endif /* !ASSEMBLER && !INITIALIZER */ 154 155 #define APM_MIN_ORDER 0x00 156 #define APM_MID_ORDER 0x80 157 #define APM_MAX_ORDER 0xff 158 159 /* power management event code */ 160 #define PMEV_NOEVENT 0x0000 161 #define PMEV_STANDBYREQ 0x0001 162 #define PMEV_SUSPENDREQ 0x0002 163 #define PMEV_NORMRESUME 0x0003 164 #define PMEV_CRITRESUME 0x0004 165 #define PMEV_BATTERYLOW 0x0005 166 #define PMEV_POWERSTATECHANGE 0x0006 167 #define PMEV_UPDATETIME 0x0007 168 #define PMEV_CRITSUSPEND 0x0008 169 #define PMEV_USERSTANDBYREQ 0x0009 170 #define PMEV_USERSUSPENDREQ 0x000a 171 #define PMEV_STANDBYRESUME 0x000b 172 #define PMEV_CAPABILITIESCHANGE 0x000c 173 /* 0x000d - 0x00ff Reserved system events */ 174 /* 0x0100 - 0x01ff Reserved device events */ 175 /* 0x0200 - 0x02ff OEM-defined APM events */ 176 /* 0x0300 - 0xffff Reserved */ 177 #define PMEV_DEFAULT 0xffffffff /* used for customization */ 178 179 #if !defined(ASSEMBLER) && !defined(INITIALIZER) 180 181 /* 182 * Old apm_info structure, returned by the APMIO_GETINFO_OLD ioctl. This 183 * is for backward compatibility with old executables. 184 */ 185 typedef struct apm_info_old { 186 u_int ai_major; /* APM major version */ 187 u_int ai_minor; /* APM minor version */ 188 u_int ai_acline; /* AC line status */ 189 u_int ai_batt_stat; /* Battery status */ 190 u_int ai_batt_life; /* Remaining battery life */ 191 u_int ai_status; /* Status of APM support (enabled/disabled) */ 192 } *apm_info_old_t; 193 194 /* 195 * Structure returned by the APMIO_GETINFO ioctl. 196 * 197 * In the comments below, the parenthesized numbers indicate the minimum 198 * value of ai_infoversion for which each field is valid. 199 */ 200 typedef struct apm_info { 201 u_int ai_infoversion; /* Indicates which fields are valid */ 202 u_int ai_major; /* APM major version (0) */ 203 u_int ai_minor; /* APM minor version (0) */ 204 u_int ai_acline; /* AC line status (0) */ 205 u_int ai_batt_stat; /* Battery status (0) */ 206 u_int ai_batt_life; /* Remaining battery life in percent (0) */ 207 int ai_batt_time; /* Remaining battery time in seconds (0) */ 208 u_int ai_status; /* True if enabled (0) */ 209 u_int ai_batteries; /* Number of batteries (1) */ 210 u_int ai_capabilities;/* APM Capabilities (1) */ 211 u_int ai_spare[6]; /* For future expansion */ 212 } *apm_info_t; 213 214 /* Battery flag */ 215 #define APM_BATT_HIGH 0x01 216 #define APM_BATT_LOW 0x02 217 #define APM_BATT_CRITICAL 0x04 218 #define APM_BATT_CHARGING 0x08 219 #define APM_BATT_NOT_PRESENT 0x10 220 #define APM_BATT_NO_SYSTEM 0x80 221 222 typedef struct apm_pwstatus { 223 u_int ap_device; /* Device code of battery */ 224 u_int ap_acline; /* AC line status (0) */ 225 u_int ap_batt_stat; /* Battery status (0) */ 226 u_int ap_batt_flag; /* Battery flag (0) */ 227 u_int ap_batt_life; /* Remaining battery life in percent (0) */ 228 int ap_batt_time; /* Remaining battery time in seconds (0) */ 229 } *apm_pwstatus_t; 230 231 struct apm_bios_arg { 232 uint32_t eax; 233 uint32_t ebx; 234 uint32_t ecx; 235 uint32_t edx; 236 uint32_t esi; 237 uint32_t edi; 238 }; 239 240 struct apm_event_info { 241 u_int type; 242 u_int index; 243 u_int spare[8]; 244 }; 245 246 #define APMIO_SUSPEND _IO('P', 1) 247 #define APMIO_GETINFO_OLD _IOR('P', 2, struct apm_info_old) 248 #define APMIO_ENABLE _IO('P', 5) 249 #define APMIO_DISABLE _IO('P', 6) 250 #define APMIO_HALTCPU _IO('P', 7) 251 #define APMIO_NOTHALTCPU _IO('P', 8) 252 #define APMIO_DISPLAY _IOW('P', 9, int) 253 #define APMIO_BIOS _IOWR('P', 10, struct apm_bios_arg) 254 #define APMIO_GETINFO _IOR('P', 11, struct apm_info) 255 #define APMIO_STANDBY _IO('P', 12) 256 #define APMIO_GETPWSTATUS _IOWR('P', 13, struct apm_pwstatus) 257 /* for /dev/apmctl */ 258 #define APMIO_NEXTEVENT _IOR('A', 100, struct apm_event_info) 259 #define APMIO_REJECTLASTREQ _IO('P', 101) 260 261 #endif /* !ASSEMBLER && !INITIALIZER */ 262 263 #endif /* !_X86_APM_BIOS_H_ */ 264