Changeset 156 for trunk/src/os2ahci/README

Timestamp:

May 6, 2013, 7:57:39 PM (12 years ago)

Author:

David Azarewicz

Message:

debugging updates

File:

• trunk/src/os2ahci/README (modified) (6 diffs)

trunk/src/os2ahci/README

@@ -93 +93 @@
 ============
 
-- Copy the driver file, OS2AHCI.ADD, to C:\OS2\BOOT
+- Run the included update.cmd,
+  or copy the driver file, OS2AHCI.ADD, to \OS2\BOOT on your boot disk.
 
 - Add the following line to CONFIG.SYS:
@@ -106 +107 @@
 Option                 Description
 ------------------------------------------------------------------------------
-/c:<addr>              Set debug COM port base address in hex (default = 0);
-                       if used, this option should come before any /d options.
-                       If <addr> is set to 0, the COM port is turned off and
-                       all output is directed to an internal trace ring buffer
-                       that can be dumped on an OS/2 command prompt with the
-                       command "type os2ahci$"; see the OS2AHCI project page
-                       at http://svn.ecomstation.nl/ahci/wiki/AhciTrace
-                       for more info. COM0=3f8, COM1=2f8
-/d                     Debug output on COM port/trace buffer; multiple "/d"
-                       options will increase verbosity:
+/b:<baud>              Initialize the COM port to the specified baud rate. Allowable
+                       baud values are: 300, 600, 1200, 2400, 4800, 9600, 19200,
+                       38400, 57600, and 115200. /b has no effect if /c is not also
+                       specified. If /b is not specified, the COM port is not
+                       initialized. For example, if you are using the kernel debugger,
+                       the kernel debugger initializes the COM port so you should not
+                       use this switch.
+
+/c:<n>                 Set debug COM port base address. Values for n can be:
+                         1 = COM1
+                         2 = COM2
+                         a hex value (COM port base address) COM1=3f8, COM2=2f8
+                       The default is 0. If set to 0 then no output goes to the COM port.
+
+/d[:n]                 Debug output to COM port/trace buffer. Values for n can be:
                          1 = requests
                          2 = detailed
                          3 = verbose, including MMIO operations
-/v                     display adapter info during boot
+                       If :n is not specified the debug level is incremented for
+                       each /d specified.
+
+/w                     Allows the trace buffer to wrap when full.
+
+/v[:n]                 Display informational messages during boot. Values for n can be:
+                         1 = Display sign on banner
+                         2 = Display adapter information
+                       If :n is not specified the verbosity level is incremented for
+                       each /v specified.
+
 /g:<vendor>:<device>   Add generic PCI ID to list of supported AHCI adapters
                        (e.g. /g:8086:2829)
+
 /t                     Perform thorough PCI ID scan; default = on, can be
                        turned off with /!t to perform only a PCI class scan
+
 /f                     Force the use of the HW write cache when using NCQ
                        commands; see "Native Command Queuing" below for
                        further explanation (default = off)
+
 /r                     Reset ports during initialization (default = on)
                        Can be turned off with /!r, however, when the
@@ -132 +151 @@
                        initialized by the BIOS in SATA mode, ports will
                        always be reset even when /!r was specified
-/a                     Set adapter for adapter-specific options
+
+/a:n                   Set adapter to n for adapter-specific options
                        (default = -1, all adapters)
-/p                     Set port for port-specific options
+
+/p:n                   Set port to n for port-specific options
                        (default = -1, all ports)
 
@@ -149 +170 @@
 /s                     Enable SCSI emulation for ATAPI units (default = off)
                        SCSI emulation is required for tools like cdrecord.
+
 /n                     Enable NCQ (Native Command Queuing) for hard disks
                        (default = off)
+
 /ls                    Set link speed (default = 0):
                          0 = maximum,
@@ -156 +179 @@
                          2 = limit to generation 2
                          3 = limit to generation 3
+
 /lp                    Set link power management (default = 0):
                          0 = full power management,
                          1 = transitions to "partial slumber state" disabled,
                          2 = transitions to "slumber state" disabled,
-                         3 = transitions to both partial and slumber states
-                             disabled
+                         3 = transitions to both partial and slumber states disabled
+
 /4                     Force track size to be 56 sectors regardless of the
                        reported disk geometry to optimize partition boundaries
@@ -371 +395 @@
    DSKSP_GEN_GET_COUNTERS IOCTL request.
 
+
+Change Log
+==========
+
+v.1.27 23-Apr-2013 - David Azarewicz
+  Added LVM aware disk geometry reporting.
+  Begin to add disk information report - not finished yet.
+  Removed undocumented /q switch and made the driver quiet by default.
+  Debug output improvements.
+  Added /b switch for setting debug baud rate.
+
+v.1.26 26-Mar-2013 - David Azarewicz
+  Fix spin-up / power-up issue on some hardware
+  Reorganized and improved debug output.
+
+v.1.26 21-Feb-2013 - rousseau
+  Virtual box fix
+  Some SMP fixes
+  Changed default for port reset to always
+
+v.1.25 02-Oct-2012 - markus.thi
+  Added support for trap dumps
+
+v.1.24 21-May-2012 - markus.thi
+  Fixed JFS long format hang (ticket 16)
+
+V.1.23 16-May-2012 - markus.thi
+  added IDC entry point to allow switching back to BIOS mode
+
+v.1.22 17-Oct-2011 - markus.thi
+  Added "IBMS506" header to accomodate broken SMART tools.