/* * APM (Advanced Power Management) BIOS Device Driver * * Copyright (c) 1994 UKAI, Fumitoshi. * Copyright (c) 1994-1995 by HOSOKAWA, Tatsumi * Copyright (c) 1996 Nate Williams * Copyright (c) 1997 Poul-Henning Kamp * * This software may be used, modified, copied, and distributed, in * both source and binary form provided that the above copyright and * these terms are retained. Under no circumstances is the author * responsible for the proper functioning of this software, nor does * the author assume any responsibility for damages incurred with its * use. * * Sep, 1994 Implemented on FreeBSD 1.1.5.1R (Toshiba AVS001WD) * * $Id: apm.c,v 1.64 1997/11/10 14:38:08 nate Exp $ */ #include #include #include #ifdef DEVFS #include #endif /*DEVFS*/ #include #include #include #include #include #include #include #include #include #include #include static int apm_display __P((int newstate)); static int apm_int __P((u_long *eax, u_long *ebx, u_long *ecx, u_long *edx)); static void apm_resume __P((void)); /* static data */ struct apm_softc { int initialized, active; int always_halt_cpu, slow_idle_cpu; int disabled, disengaged; u_int minorversion, majorversion; u_int cs32_base, cs16_base, ds_base; u_int cs_limit, ds_limit; u_int cs_entry; u_int intversion; struct apmhook sc_suspend; struct apmhook sc_resume; #ifdef DEVFS void *sc_devfs_token; #endif }; static struct apm_softc apm_softc; static struct apmhook *hook[NAPM_HOOK]; /* XXX */ #define is_enabled(foo) ((foo) ? "enabled" : "disabled") /* Map version number to integer (keeps ordering of version numbers) */ #define INTVERSION(major, minor) ((major)*100 + (minor)) static struct callout_handle apm_timeout_ch = CALLOUT_HANDLE_INITIALIZER(&apm_timeout_ch); static timeout_t apm_timeout; static d_open_t apmopen; static d_close_t apmclose; static d_ioctl_t apmioctl; #define CDEV_MAJOR 39 static struct cdevsw apm_cdevsw = { apmopen, apmclose, noread, nowrite, /*39*/ apmioctl, nostop, nullreset, nodevtotty,/* APM */ seltrue, nommap, NULL , "apm" ,NULL, -1}; /* setup APM GDT discriptors */ static void setup_apm_gdt(u_int code32_base, u_int code16_base, u_int data_base, u_int code_limit, u_int data_limit) { /* setup 32bit code segment */ gdt_segs[GAPMCODE32_SEL].ssd_base = code32_base; gdt_segs[GAPMCODE32_SEL].ssd_limit = code_limit; /* setup 16bit code segment */ gdt_segs[GAPMCODE16_SEL].ssd_base = code16_base; gdt_segs[GAPMCODE16_SEL].ssd_limit = code_limit; /* setup data segment */ gdt_segs[GAPMDATA_SEL ].ssd_base = data_base; gdt_segs[GAPMDATA_SEL ].ssd_limit = data_limit; /* reflect these changes on physical GDT */ ssdtosd(gdt_segs + GAPMCODE32_SEL, &gdt[GAPMCODE32_SEL].sd); ssdtosd(gdt_segs + GAPMCODE16_SEL, &gdt[GAPMCODE16_SEL].sd); ssdtosd(gdt_segs + GAPMDATA_SEL , &gdt[GAPMDATA_SEL ].sd); } /* 48bit far pointer */ struct addr48 { u_long offset; u_short segment; } apm_addr; static int apm_errno; static int apm_int(u_long *eax, u_long *ebx, u_long *ecx, u_long *edx) { struct apm_bios_arg apa; int cf; apa.eax = *eax; apa.ebx = *ebx; apa.ecx = *ecx; apa.edx = *edx; cf = apm_bios_call(&apa); *eax = apa.eax; *ebx = apa.ebx; *ecx = apa.ecx; *edx = apa.edx; apm_errno = ((*eax) >> 8) & 0xff; return cf; } /* enable/disable power management */ static int apm_enable_disable_pm(int enable) { struct apm_softc *sc = &apm_softc; u_long eax, ebx, ecx, edx; eax = (APM_BIOS << 8) | APM_ENABLEDISABLEPM; if (sc->intversion >= INTVERSION(1, 1)) ebx = PMDV_ALLDEV; else ebx = 0xffff; /* APM version 1.0 only */ ecx = enable; return apm_int(&eax, &ebx, &ecx, &edx); } static void apm_driver_version(int version) { u_long eax, ebx, ecx, edx; /* First try APM 1.2 */ eax = (APM_BIOS << 8) | APM_DRVVERSION; ebx = 0x0; ecx = version; if(!apm_int(&eax, &ebx, &ecx, &edx)) apm_version = eax & 0xffff; } /* engage/disengage power management (APM 1.1 or later) */ static int apm_engage_disengage_pm(int engage) { u_long eax, ebx, ecx, edx; eax = (APM_BIOS << 8) | APM_ENGAGEDISENGAGEPM; ebx = PMDV_ALLDEV; ecx = engage; return(apm_int(&eax, &ebx, &ecx, &edx)); } /* get PM event */ static u_int apm_getevent(void) { u_long eax, ebx, ecx, edx; eax = (APM_BIOS << 8) | APM_GETPMEVENT; ebx = 0; ecx = 0; if (apm_int(&eax, &ebx, &ecx, &edx)) return PMEV_NOEVENT; return ebx & 0xffff; } /* suspend entire system */ static int apm_suspend_system(void) { u_long eax, ebx, ecx, edx; eax = (APM_BIOS << 8) | APM_SETPWSTATE; ebx = PMDV_ALLDEV; ecx = PMST_SUSPEND; if (apm_int(&eax, &ebx, &ecx, &edx)) { printf("Entire system suspend failure: errcode = %ld\n", 0xff & (eax >> 8)); return 1; } return 0; } /* Display control */ /* * Experimental implementation: My laptop machine can't handle this function * If your laptop can control the display via APM, please inform me. * HOSOKAWA, Tatsumi */ static int apm_display(int newstate) { u_long eax, ebx, ecx, edx; eax = (APM_BIOS << 8) | APM_SETPWSTATE; ebx = PMDV_DISP0; ecx = newstate ? PMST_APMENABLED:PMST_SUSPEND; if (apm_int(&eax, &ebx, &ecx, &edx)) { printf("Display off failure: errcode = %ld\n", 0xff & (eax >> 8)); return 1; } return 0; } /* * Turn off the entire system. */ void apm_power_off(void) { u_long eax, ebx, ecx, edx; if (!apm_softc.active) return; eax = (APM_BIOS << 8) | APM_SETPWSTATE; ebx = PMDV_ALLDEV; ecx = PMST_OFF; apm_int(&eax, &ebx, &ecx, &edx); } /* APM Battery low handler */ static void apm_battery_low(void) { printf("\007\007 * * * BATTERY IS LOW * * * \007\007"); } /* APM hook manager */ static struct apmhook * apm_add_hook(struct apmhook **list, struct apmhook *ah) { int s; struct apmhook *p, *prev; #ifdef APM_DEBUG printf("Add hook \"%s\"\n", ah->ah_name); #endif s = splhigh(); if (ah == NULL) panic("illegal apm_hook!"); prev = NULL; for (p = *list; p != NULL; prev = p, p = p->ah_next) if (p->ah_order > ah->ah_order) break; if (prev == NULL) { ah->ah_next = *list; *list = ah; } else { ah->ah_next = prev->ah_next; prev->ah_next = ah; } splx(s); return ah; } static void apm_del_hook(struct apmhook **list, struct apmhook *ah) { int s; struct apmhook *p, *prev; s = splhigh(); prev = NULL; for (p = *list; p != NULL; prev = p, p = p->ah_next) if (p == ah) goto deleteit; panic("Tried to delete unregistered apm_hook."); goto nosuchnode; deleteit: if (prev != NULL) prev->ah_next = p->ah_next; else *list = p->ah_next; nosuchnode: splx(s); } /* APM driver calls some functions automatically */ static void apm_execute_hook(struct apmhook *list) { struct apmhook *p; for (p = list; p != NULL; p = p->ah_next) { #ifdef APM_DEBUG printf("Execute APM hook \"%s.\"\n", p->ah_name); #endif if ((*(p->ah_fun))(p->ah_arg)) printf("Warning: APM hook \"%s\" failed", p->ah_name); } } /* establish an apm hook */ struct apmhook * apm_hook_establish(int apmh, struct apmhook *ah) { if (apmh < 0 || apmh >= NAPM_HOOK) return NULL; return apm_add_hook(&hook[apmh], ah); } /* disestablish an apm hook */ void apm_hook_disestablish(int apmh, struct apmhook *ah) { if (apmh < 0 || apmh >= NAPM_HOOK) return; apm_del_hook(&hook[apmh], ah); } static struct timeval suspend_time; static struct timeval diff_time; static int apm_default_resume(void *arg) { int pl; u_int second, minute, hour; struct timeval resume_time, tmp_time; /* modified for adjkerntz */ pl = splsoftclock(); inittodr(0); /* adjust time to RTC */ microtime(&resume_time); tmp_time = time; /* because 'time' is volatile */ timevaladd(&tmp_time, &diff_time); time = tmp_time; splx(pl); second = resume_time.tv_sec - suspend_time.tv_sec; hour = second / 3600; second %= 3600; minute = second / 60; second %= 60; log(LOG_NOTICE, "resumed from suspended mode (slept %02d:%02d:%02d)\n", hour, minute, second); return 0; } static int apm_default_suspend(void *arg) { int pl; pl = splsoftclock(); microtime(&diff_time); inittodr(0); microtime(&suspend_time); timevalsub(&diff_time, &suspend_time); splx(pl); return 0; } static void apm_processevent(void); /* * Public interface to the suspend/resume: * * Execute suspend and resume hook before and after sleep, respectively. * */ void apm_suspend(void) { struct apm_softc *sc = &apm_softc; if (!sc) return; if (sc->initialized) { apm_execute_hook(hook[APM_HOOK_SUSPEND]); if (apm_suspend_system() == 0) apm_processevent(); else /* Failure, 'resume' the system again */ apm_execute_hook(hook[APM_HOOK_RESUME]); } } void apm_resume(void) { struct apm_softc *sc = &apm_softc; if (!sc) return; if (sc->initialized) apm_execute_hook(hook[APM_HOOK_RESUME]); } /* get APM information */ static int apm_get_info(apm_info_t aip) { struct apm_softc *sc = &apm_softc; u_long eax, ebx, ecx, edx; eax = (APM_BIOS << 8) | APM_GETPWSTATUS; ebx = PMDV_ALLDEV; ecx = 0; if (apm_int(&eax, &ebx, &ecx, &edx)) return 1; aip->ai_infoversion = 0; aip->ai_acline = (ebx >> 8) & 0xff; aip->ai_batt_stat = ebx & 0xff; aip->ai_batt_life = ecx & 0xff; aip->ai_major = (u_int)sc->majorversion; aip->ai_minor = (u_int)sc->minorversion; aip->ai_status = (u_int)sc->active; edx &= 0xffff; if (edx == 0xffff) /* Time is unknown */ aip->ai_batt_time = -1; else if (edx & 0x8000) /* Time is in minutes */ aip->ai_batt_time = (edx & 0x7fff) * 60; else /* Time is in seconds */ aip->ai_batt_time = edx; bzero(aip->ai_spare, sizeof aip->ai_spare); return 0; } /* inform APM BIOS that CPU is idle */ void apm_cpu_idle(void) { struct apm_softc *sc = &apm_softc; if (sc->active) { u_long eax, ebx, ecx, edx; eax = (APM_BIOS <<8) | APM_CPUIDLE; ecx = ebx = 0; apm_int(&eax, &ebx, &ecx, &edx); } /* * Some APM implementation halts CPU in BIOS, whenever * "CPU-idle" function are invoked, but swtch() of * FreeBSD halts CPU, therefore, CPU is halted twice * in the sched loop. It makes the interrupt latency * terribly long and be able to cause a serious problem * in interrupt processing. We prevent it by removing * "hlt" operation from swtch() and managed it under * APM driver. */ if (!sc->active || sc->always_halt_cpu) __asm("hlt"); /* wait for interrupt */ } /* inform APM BIOS that CPU is busy */ void apm_cpu_busy(void) { struct apm_softc *sc = &apm_softc; /* * The APM specification says this is only necessary if your BIOS * slows down the processor in the idle task, otherwise it's not * necessary. */ if (sc->slow_idle_cpu && sc->active) { u_long eax, ebx, ecx, edx; eax = (APM_BIOS <<8) | APM_CPUBUSY; ecx = ebx = 0; apm_int(&eax, &ebx, &ecx, &edx); } } /* * APM timeout routine: * * This routine is automatically called by timer once per second. */ static void apm_timeout(void *dummy) { struct apm_softc *sc = &apm_softc; apm_processevent(); if (sc->active == 1) /* Run slightly more oftan than 1 Hz */ apm_timeout_ch = timeout(apm_timeout, NULL, hz - 1 ); } /* enable APM BIOS */ static void apm_event_enable(void) { struct apm_softc *sc = &apm_softc; #ifdef APM_DEBUG printf("called apm_event_enable()\n"); #endif if (sc->initialized) { sc->active = 1; apm_timeout(sc); } } /* disable APM BIOS */ static void apm_event_disable(void) { struct apm_softc *sc = &apm_softc; #ifdef APM_DEBUG printf("called apm_event_disable()\n"); #endif if (sc->initialized) { untimeout(apm_timeout, NULL, apm_timeout_ch); sc->active = 0; } } /* halt CPU in scheduling loop */ static void apm_halt_cpu(void) { struct apm_softc *sc = &apm_softc; if (sc->initialized) sc->always_halt_cpu = 1; } /* don't halt CPU in scheduling loop */ static void apm_not_halt_cpu(void) { struct apm_softc *sc = &apm_softc; if (sc->initialized) sc->always_halt_cpu = 0; } /* device driver definitions */ static int apmprobe (struct isa_device *); static int apmattach(struct isa_device *); struct isa_driver apmdriver = { apmprobe, apmattach, "apm" }; /* * probe APM (dummy): * * APM probing routine is placed on locore.s and apm_init.S because * this process forces the CPU to turn to real mode or V86 mode. * Current version uses real mode, but in a future version, we want * to use V86 mode in APM initialization. */ static int apmprobe(struct isa_device *dvp) { bzero(&apm_softc, sizeof(apm_softc)); if ( dvp->id_unit > 0 ) { printf("apm: Only one APM driver supported.\n"); return 0; } switch (apm_version) { case APMINI_CANTFIND: /* silent */ return 0; case APMINI_NOT32BIT: printf("apm: 32bit connection is not supported.\n"); return 0; case APMINI_CONNECTERR: printf("apm: 32-bit connection error.\n"); return 0; } if (dvp->id_flags & 0x20) statclock_disable = 1; return -1; } /* Process APM event */ static void apm_processevent(void) { int apm_event; #ifdef APM_DEBUG # define OPMEV_DEBUGMESSAGE(symbol) case symbol: \ printf("Received APM Event: " #symbol "\n"); #else # define OPMEV_DEBUGMESSAGE(symbol) case symbol: #endif do { apm_event = apm_getevent(); switch (apm_event) { OPMEV_DEBUGMESSAGE(PMEV_STANDBYREQ); apm_suspend(); break; OPMEV_DEBUGMESSAGE(PMEV_SUSPENDREQ); apm_suspend(); break; OPMEV_DEBUGMESSAGE(PMEV_USERSUSPENDREQ); apm_suspend(); break; OPMEV_DEBUGMESSAGE(PMEV_CRITSUSPEND); apm_suspend(); break; OPMEV_DEBUGMESSAGE(PMEV_NORMRESUME); apm_resume(); break; OPMEV_DEBUGMESSAGE(PMEV_CRITRESUME); apm_resume(); break; OPMEV_DEBUGMESSAGE(PMEV_STANDBYRESUME); apm_resume(); break; OPMEV_DEBUGMESSAGE(PMEV_BATTERYLOW); apm_battery_low(); apm_suspend(); break; OPMEV_DEBUGMESSAGE(PMEV_POWERSTATECHANGE); break; OPMEV_DEBUGMESSAGE(PMEV_UPDATETIME); inittodr(0); /* adjust time to RTC */ break; case PMEV_NOEVENT: break; default: printf("Unknown Original APM Event 0x%x\n", apm_event); break; } } while (apm_event != PMEV_NOEVENT); } /* * Attach APM: * * Initialize APM driver (APM BIOS itself has been initialized in locore.s) */ static int apmattach(struct isa_device *dvp) { #define APM_KERNBASE KERNBASE struct apm_softc *sc = &apm_softc; sc->initialized = 0; /* Must be externally enabled */ sc->active = 0; /* setup APM parameters */ sc->cs16_base = (apm_cs16_base << 4) + APM_KERNBASE; sc->cs32_base = (apm_cs32_base << 4) + APM_KERNBASE; sc->ds_base = (apm_ds_base << 4) + APM_KERNBASE; sc->cs_limit = apm_cs_limit; sc->ds_limit = apm_ds_limit; sc->cs_entry = apm_cs_entry; /* Always call HLT in idle loop */ sc->always_halt_cpu = 1; sc->slow_idle_cpu = ((apm_flags & APM_CPUIDLE_SLOW) != 0); sc->disabled = ((apm_flags & APM_DISABLED) != 0); sc->disengaged = ((apm_flags & APM_DISENGAGED) != 0); /* print bootstrap messages */ #ifdef APM_DEBUG printf("apm: APM BIOS version %04x\n", apm_version); printf("apm: Code32 0x%08x, Code16 0x%08x, Data 0x%08x\n", sc->cs32_base, sc->cs16_base, sc->ds_base); printf("apm: Code entry 0x%08x, Idling CPU %s, Management %s\n", sc->cs_entry, is_enabled(sc->slow_idle_cpu), is_enabled(!sc->disabled)); printf("apm: CS_limit=0x%x, DS_limit=0x%x\n", sc->cs_limit, sc->ds_limit); #endif /* APM_DEBUG */ #if 0 /* Workaround for some buggy APM BIOS implementations */ sc->cs_limit = 0xffff; sc->ds_limit = 0xffff; #endif /* setup GDT */ setup_apm_gdt(sc->cs32_base, sc->cs16_base, sc->ds_base, sc->cs_limit, sc->ds_limit); /* setup entry point 48bit pointer */ apm_addr.segment = GSEL(GAPMCODE32_SEL, SEL_KPL); apm_addr.offset = sc->cs_entry; if ((dvp->id_flags & 0x10)) { if ((dvp->id_flags & 0xf) >= 0x2) { apm_driver_version(0x102); } if (!apm_version && (dvp->id_flags & 0xf) >= 0x1) { apm_driver_version(0x101); } } else { apm_driver_version(0x102); if (!apm_version) apm_driver_version(0x101); } if (!apm_version) apm_version = 0x100; sc->minorversion = ((apm_version & 0x00f0) >> 4) * 10 + ((apm_version & 0x000f) >> 0); sc->majorversion = ((apm_version & 0xf000) >> 12) * 10 + ((apm_version & 0x0f00) >> 8); sc->intversion = INTVERSION(sc->majorversion, sc->minorversion); #ifdef APM_DEBUG if (sc->intversion >= INTVERSION(1, 1)) printf("apm: Engaged control %s\n", is_enabled(!sc->disengaged)); #endif printf("apm: found APM BIOS version %d.%d\n", sc->majorversion, sc->minorversion); #ifdef APM_DEBUG printf("apm: Slow Idling CPU %s\n", is_enabled(sc->slow_idle_cpu)); #endif /* enable power management */ if (sc->disabled) { if (apm_enable_disable_pm(1)) { #ifdef APM_DEBUG printf("apm: *Warning* enable function failed! [%x]\n", apm_errno); #endif } } /* engage power managment (APM 1.1 or later) */ if (sc->intversion >= INTVERSION(1, 1) && sc->disengaged) { if (apm_engage_disengage_pm(1)) { #ifdef APM_DEBUG printf("apm: *Warning* engage function failed err=[%x]", apm_errno); printf(" (Docked or using external power?).\n"); #endif } } /* default suspend hook */ sc->sc_suspend.ah_fun = apm_default_suspend; sc->sc_suspend.ah_arg = sc; sc->sc_suspend.ah_name = "default suspend"; sc->sc_suspend.ah_order = APM_MAX_ORDER; /* default resume hook */ sc->sc_resume.ah_fun = apm_default_resume; sc->sc_resume.ah_arg = sc; sc->sc_resume.ah_name = "default resume"; sc->sc_resume.ah_order = APM_MIN_ORDER; apm_hook_establish(APM_HOOK_SUSPEND, &sc->sc_suspend); apm_hook_establish(APM_HOOK_RESUME , &sc->sc_resume); apm_event_enable(); sc->initialized = 1; #ifdef DEVFS sc->sc_devfs_token = devfs_add_devswf(&apm_cdevsw, 0, DV_CHR, 0, 0, 0600, "apm"); #endif return 0; } static int apmopen(dev_t dev, int flag, int fmt, struct proc *p) { struct apm_softc *sc = &apm_softc; if (minor(dev) != 0 || !sc->initialized) return (ENXIO); return 0; } static int apmclose(dev_t dev, int flag, int fmt, struct proc *p) { return 0; } static int apmioctl(dev_t dev, int cmd, caddr_t addr, int flag, struct proc *p) { struct apm_softc *sc = &apm_softc; int error = 0; int newstate; if (minor(dev) != 0 || !sc->initialized) return (ENXIO); #ifdef APM_DEBUG printf("APM ioctl: cmd = 0x%x\n", cmd); #endif switch (cmd) { case APMIO_SUSPEND: if ( sc->active) apm_suspend(); else error = EINVAL; break; case APMIO_GETINFO_OLD: { struct apm_info info; apm_info_old_t aiop; if (apm_get_info(&info)) error = ENXIO; aiop = (apm_info_old_t)addr; aiop->ai_major = info.ai_major; aiop->ai_minor = info.ai_minor; aiop->ai_acline = info.ai_acline; aiop->ai_batt_stat = info.ai_batt_stat; aiop->ai_batt_life = info.ai_batt_life; aiop->ai_status = info.ai_status; } break; case APMIO_GETINFO: if (apm_get_info((apm_info_t)addr)) error = ENXIO; break; case APMIO_ENABLE: apm_event_enable(); break; case APMIO_DISABLE: apm_event_disable(); break; case APMIO_HALTCPU: apm_halt_cpu(); break; case APMIO_NOTHALTCPU: apm_not_halt_cpu(); break; case APMIO_DISPLAY: newstate = *(int *)addr; if (apm_display(newstate)) error = ENXIO; break; case APMIO_BIOS: if (apm_bios_call((struct apm_bios_arg*)addr)) error = EIO; break; default: error = EINVAL; break; } return error; } static apm_devsw_installed = 0; static void apm_drvinit(void *unused) { dev_t dev; if( ! apm_devsw_installed ) { dev = makedev(CDEV_MAJOR,0); cdevsw_add(&dev,&apm_cdevsw,NULL); apm_devsw_installed = 1; } } SYSINIT(apmdev,SI_SUB_DRIVERS,SI_ORDER_MIDDLE+CDEV_MAJOR,apm_drvinit,NULL)