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