
OS4APIC.PSD  V0.2.0 Beta 
======================


1. Requirements
---------------

   1) OS/4 Kernel with SVN revision 4058 or higher
   2) PC BIOS that is MPS 1.4 compliant (check that the BIOS default value 
      is not set to MPS 1.1)

   Due to some HW having broken MPtable a acpi4.bpd will be necessary to work
   in /APIC mode.

2. Driver command line parameter 
--------------------------------

  /APIC - to route IRQ through IOAPIC. Use the /APIC option switch 
          only when PRELOAD is set in the os2ldr.ini file. If this switch
          is not used then the PIC mode is set and the IRQ will be routed 
          through PIC.

  /MPT  - use MP Table even if ACPI service is available

  /HT   - start Hyper Threading cores

3. New features
---------------

  1) fixed broken DosTmrQueryTime function

  With OS4APIC.PSD there is no need to SET NSPR_OS2_NO_HIRES_TIMER=1 on 
  SMP system in IOAPIC mode  - DosTmrQueryTime will work properly from now 
  on and will not trouble Mozilla browsers and other applications which call 
  it. The timer test can be found on the following URL:
  http://gus.biysk.ru/os4/test/timerTest.html

  2) high irq routing numbers
  
  Unlike IBMs os2apic.psd the new os4apic.psd supports high routing irq numbers
  higher than 15.
  
  3) OS4APIC.PSD from ver 0.2.0 Beta can use ACPI for getting the needed info


4. Known Issues
---------------

  OS4APIC.PSD hangs IBM kernel because of lack of service and some other 
  reasons. Unfortunately there is no way to avoid it due to the bug in the 
  IBM kernel.

  If somebody decides to use IBM kernel and os4krnl on the same PC, one would 
  need two separate config.sys files: one with os4apic.psd - another without it. 
  This can be easily done with the OS/4 loader ini file os2ldr.ini.


5. Reporting bugs
-----------------

  Post your reports to either irc://efnet/os2russian or to the os2world.com 
  forum. To solve issues its required to have a com port log available and
  the output from MPtable.exe, download: 
  http://moveton.ho.ua/files/mptable-2.0.12.zip


6. History
-----------------

0.1a  initial

0.1b  proper hi irq serving

0.1.1 added bldlevel

0.2.0 ACPI support



OS/4 Team
