ACPI-CA driver README
August 24, 2009
This README contains information about
ACPI-CA driver for eComStation
Version: 3.17
CONTENTS
________
1.0 License
2.0 Description
3.0 Features
4.0 Installation
5.0 Commandline options
6.0 Restrictions
7.0 Acknowledgements
8.0 Copyrights and contact info
1.0 License
___________
ACPI.PSD and ACPI drivers are licensed for use with eComStation 2.0 only.
If you have installed ACPI.PSD then you agree that information about
compatiblity of your computer with eComStation may be published in
the hardware database http://ecomstation.ru/hardware.php
2.0 Description
_______________
* The main purpose of the driver is to provide ACPI interface to
other drivers and applications.
* You need ACPI driver to run HyperThreading/Dual core/ Core Duo/ X2
multi-processor machines. Especially, if you want run computer in APIC mode.
* You need new APM.ADD and ACPI driver to use modern notebooks (sleep/resume)
* ACPI driver allows catch the Power button click
* You need ACPI if some devices of your computer are not initialized on boot
System requirements:
* Modern kernel
* eComStation operating system
* Remove dust from your computer
3.0 Features
____________
Current version allows:
* evaluate any method from ACPI tree
* visualize ACPI tree
* wake up all devices
* catch Power/Sleep button click
* Power Managment timer, 3.6 times per microsecond
* Throttling CPU
* Multi processor/hypertredding/dualcore support
* IRQ control (ACPI snooper)
4.0 Installation
________________
Installation:
1. Please, don't try install ACPI on floppy
eComStation should be installed on JFS or HPFS volume.
2. Check the version of eComStation kernel
x:\OS2KRNL should be 14.104
3. copy acpi.psd to \os2\boot
copy acpi32.dll to \os2\dll
X. copy acpi.cfg to x:\OS2\BOOT
4. Add to config.sys (the 1-st line in config.sys):
psd=acpi.psd
5. Replace RESOURCE.SYS driver to updated (patched) version
6. Remove SHARHIRQ.SYS driver from CONFIG.SYS
7. If using multiprocessor computer then read ACPI-SMP.doc
If using notebook then read ACPI-APM.doc
If using NVidia chipset then read ACPI-FAQ.doc -> Q40
8. Reboot
5.0 Commandline options
_______________________
ACPI.PSD driver has options:
/SMP - activate multi-processor support
(read ACPI-SMP.doc for details)
/Onumber - Output - The number of COM-port used for debug output
(values: 1, 2, address of I/O port)
It is suitable for debug version of acpi.psd
Configure receiver: 115200,8,n HW flow contol
/LS:number - Leave Sleep - after sleep state the computer will be switched
to this state (0 - no switch, 5 - turn off)
/PIC
/APIC - Multiprocessor support can run in 2 modes: PIC or APIC.
PIC is default,
Use /PIC to activate 8259 PIC instead of APIC.
* PIC is good enough
* APIC is better but doesn't work on some computers
and requires extra efforts to setup computer.
/CST:name - name of method responsible for _CST method.
Example: /CST:XCST. You can find the method in the subtree
of CPU. (It's Cx state). It is needed for APM, idle of CPU,etc
/IRQ:x - experimental switch (specially for Acer Ferrari notebook)
Allows replace ACPI IRQ number
/NOD - (Enabled by default)
experimental switch to activate internal OEMHLP$ driver
APIC mode may work bad without this switch.
/!NOD - disable internal OEMHLP$ driver.
Yes, you can boot; But ACPI is semi-functional in this case:
APIC doesn't work, LINK doesn't, REMAP doesn't, etc.
2008/07: this switch is recommended for NVidia chipset,
to run Winos2+dos session and/or SCSI
/R - Use ACPI Reset instead of kernel's reset
It is useful if running SMP kernel only.
Use it if have troubles with system reboot or shutdown.
/FS - "Full Safe" - use this key for Dell notebooks
/B - is absent starting from ACPI.PSD 3.0
/EIS - "Enable Intel Slack", AcpiGbl_EnableInterpreterSlack
The Intel interpreter strictly follows the ACPI specification.
Setting this switch allows the interpreter to ignore certain
errors and/or bad AML constructs.
"This switch is useful for 98% of notebooks with bad
ACPI tables" (q) Intel developers
Use it if ACPI log contains errors messages.
/St:stacksize Size of stack. Default is 32 Kbytes. Useful
if experimenting with bad ACPI tables and /EIS
Example: /St:0x8000
/VBE Init Video BIOS on resume (after sleep)
/OS="name" Define Operating System. "eComStation" by default.. but some
/OSI="name" notebooks need other OS name there
Examples:
* /OS="Microsoft Windows NT"
* /OSI="Windows 2001"
* /OSI="Windows 2001 SP1"
* "eComStation"
/SAP Set startup ACPI options
default value: 0
/SAP:0x0
you can assemble this values:
ACPI_FULL_INITIALIZATION 0x00
ACPI_NO_ADDRESS_SPACE_INIT 0x01
ACPI_NO_HARDWARE_INIT 0x02
ACPI_NO_EVENT_INIT 0x04
ACPI_NO_HANDLER_INIT 0x08
ACPI_NO_ACPI_ENABLE 0x10
ACPI_NO_DEVICE_INIT 0x20
ACPI_NO_OBJECT_INIT 0x40
/MCPU:xx Force the quantity of processors,
The value is checked so you can't select 0
or more than you have.
This switches are useful for APIC mode only:
/CD - "Crazy Device" - use this switch if USB doesn't work.
or if you fail to boot.
Use it only if you have troubles with USB.
/ALS set APIC link on ACPI start. Useful for old NVidias.
(It's like /CD)
Try it if computer hangs after booting of all drivers.
/TMR - Use it if running SMP machine and the motherboard doesn't
follow MPS 1.4 standard.
ONLY for NVidia chipset
/DV:vector - Dummy Vector - hide the vector. The kernel will not process it.
(/DV:0x57 is enabled by default on every PC now)
Notes:
*) All digital values are accepted in hex or decimal form:
0x??? (hex)
0?? (octal)
??? (decimal)
6.0 Restrictions
_________________
read ACPI-restrictions.doc
7.0 Acknowledgements
_____________________
* Daniela Engert
* Ruediger Ihle
* Roderick Klein
* Netlabs.org infrastructure
* Robert Lalla
* Valery Gaynullin
Celebrated testers (living at irc://irc.ecomstation.com/ecolabs):
* Yoda
* froloff
8.0 Copyrights and contact info
________________________________
ACPI-CA driver for eComStation, (c) netlabs.org 2005
ACPI Tools -- http://ecomstation.ru/acpitools
Read more about compatible hardware:
* http://en.ecomstation.ru/hardware.php?action=category§ion=mb
* http://en.ecomstation.ru/hardware.php?action=category§ion=brand
Send bug-reports to: http://svn.netlabs.org/acpi/newticket
Register to Login -- http://www.netlabs.org/site/member/
don't use short name&password, save your password
Contacts: support@ecomstation.ru
|