Changeset 178 for trunk/src/os2ahci/README
- Timestamp:
- Nov 29, 2016, 5:30:22 AM (9 years ago)
- File:
-
- 1 edited
-
trunk/src/os2ahci/README (modified) (14 diffs)
Legend:
- Unmodified
- Added
- Removed
-
trunk/src/os2ahci/README
r177 r178 1 AHCI Driver for OS/2 v1.32 1 AHCI Driver for OS/2 v2.01 2 3 WARNING: This is a alpha level build of this driver. Use 4 in a production environment is not recommended. 2 5 3 6 … … 17 20 Copyright (c) 2011 thi.guten Software Development 18 21 Copyright (c) 2011 Mensys B.V. 19 Copyright (c) 2013-201 5David Azarewicz22 Copyright (c) 2013-2016 David Azarewicz 20 23 21 24 Authors: Christian Mueller, Markus Thielen … … 70 73 Option Description 71 74 ------------------------------------------------------------------------------ 72 / b:<baud> Initialize the COM port to the specified baud rate. Allowable75 /B:<baud> Initialize the COM port to the specified baud rate. Allowable 73 76 baud values are: 300, 600, 1200, 2400, 4800, 9600, 19200, 74 38400, 57600, and 115200. / b has no effect if /cis not also75 specified. If / bis not specified, the COM port is not77 38400, 57600, and 115200. /B has no effect if /C is not also 78 specified. If /B is not specified, the COM port is not 76 79 initialized. For example, if you are using the kernel debugger, 77 80 the kernel debugger initializes the COM port so you should not 78 81 use this switch. 79 82 80 / c:<n> Set debug COM port base address. Values for n can be:83 /C:<n> Set debug COM port base address. Values for n can be: 81 84 1 = COM1 82 85 2 = COM2 … … 84 87 The default is 0. If set to 0 then no output goes to the COM port. 85 88 86 / d[:n] Debug output to COM port/tracebuffer. Values for n can be:89 /D[:n] Debug output to COM port/debug buffer. Values for n can be: 87 90 1 = requests 88 91 2 = detailed 89 3 = verbose , including MMIO operations92 3 = verbose 90 93 If :n is not specified the debug level is incremented for 91 each / dspecified.92 93 / w Allows the tracebuffer to wrap when full.94 95 / v[:n] Display informational messages during boot. Values for n can be:94 each /D specified. 95 96 /W Allows the debug buffer to wrap when full. 97 98 /V[:n] Display informational messages during boot. Values for n can be: 96 99 1 = Display sign on banner 97 100 2 = Display adapter information 98 101 If :n is not specified the verbosity level is incremented for 99 each / vspecified.100 101 / g:<vendor>:<device> Add generic PCI ID to list of supported AHCI adapters102 (e.g. / g:8086:2829)103 104 / tPerform thorough PCI ID scan; default = on, can be105 turned off with /! tto perform only a PCI class scan106 107 / fForce the use of the HW write cache when using NCQ102 each /V specified. 103 104 /G:<vendor>:<device> Add generic PCI ID to list of supported AHCI adapters 105 (e.g. /G:8086:2829) 106 107 /T Perform thorough PCI ID scan; default = on, can be 108 turned off with /!T to perform only a PCI class scan 109 110 /F Force the use of the HW write cache when using NCQ 108 111 commands; see "Native Command Queuing" below for 109 112 further explanation (default = off) 110 113 111 / rReset ports during initialization (default = on)112 Can be turned off with /! r, however, when the114 /R Reset ports during initialization (default = on) 115 Can be turned off with /!R, however, when the 113 116 [Intel] AHCI controller was found to be 114 117 initialized by the BIOS in SATA mode, ports will 115 always be reset even when /! rwas specified116 117 / a:n Set adapter to n for adapter-specific options118 always be reset even when /!R was specified 119 120 /A:n Set adapter to n for adapter-specific options 118 121 (default = -1, all adapters) 119 122 120 / p:n Set port to n for port-specific options123 /P:n Set port to n for port-specific options 121 124 (default = -1, all ports) 122 125 123 / iIgnore current adapter if no port has been specified.126 /I Ignore current adapter if no port has been specified. 124 127 Otherwise, ignore the current port on the current adapter. 125 128 … … 128 131 Option Description 129 132 ------------------------------------------------------------------------------ 130 / sEnable SCSI emulation for ATAPI units (default = on)133 /S Enable SCSI emulation for ATAPI units (default = on) 131 134 SCSI emulation is required for tools like cdrecord. 132 135 133 / nEnable NCQ (Native Command Queuing) for hard disks136 /N Enable NCQ (Native Command Queuing) for hard disks 134 137 (default = off) 135 138 136 / lsSet link speed (default = 0):139 /LS Set link speed (default = 0): 137 140 0 = maximum, 138 141 1 = limit to generation 1 … … 140 143 3 = limit to generation 3 141 144 142 / lpSet link power management (default = 0):145 /LP Set link power management (default = 0): 143 146 0 = full power management, 144 147 1 = transitions to "partial slumber state" disabled, … … 151 154 152 155 Port-specific options depend on the currently active adapter 153 and port selector (/ a and /p). Those selectors are -1 per default156 and port selector (/A and /P). Those selectors are -1 per default 154 157 which means "all" adapters/ports. The scope can be reduced by limiting 155 it to an adapter (/ a) or an adapter and a port (/a and /p). The scope158 it to an adapter (/A) or an adapter and a port (/A and /P). The scope 156 159 can be reset by setting the corresponding option back to -1. 157 160 158 161 For example: 159 162 160 BASEDEV=OS2AHCI.ADD / n /a:0 /p:5 /!n /a:1 /p:-1 /!n163 BASEDEV=OS2AHCI.ADD /N /A:0 /P:5 /!N /A:1 /P:-1 /!N 161 164 162 165 This has the following effect: … … 183 186 disks, it's currently turned off by default until we have more feedback 184 187 from OS/2 users. In order to turn on NCQ, just add the command line 185 option "/ n" to OS2AHCI.ADD.188 option "/N" to OS2AHCI.ADD. 186 189 187 190 NCQ and HW Caches … … 195 198 performance loss. In order to prevent OS2AHCI from disabling the HW 196 199 cache when so requested by upstream code, please use the command line 197 option "/ f".200 option "/F". 198 201 199 202 This may, of course, result in data loss in case of power failures but … … 210 213 211 214 - When suspending, rebooting or shutting down, OS2AHCI always flushes 212 the HW disk cache regardless of the "/ f" or "/n" command line options.215 the HW disk cache regardless of the "/F" or "/N" command line options. 213 216 214 217 … … 218 221 There are three kinds of IDE/ATA/SATA controllers: 219 222 220 1. Legacycontrollers (IDE or SATA) without AHCI support223 1. Older controllers (IDE or SATA) without AHCI support 221 224 This kind of controller will only be recognized by IDE drivers 222 225 (IBM1S506.ADD or DANIS506.ADD). 223 226 224 2. AHCI-capable controllers which supports IDE/SATA legacyinterfaces227 2. AHCI-capable controllers which supports IDE/SATA interfaces 225 228 This kind of controller will work with IDE or AHCI drivers and it's 226 229 up to the user to decide which driver to use. … … 252 255 Assume a DELL D630 or a Thinkpad T60. The hard disk is attached to the 253 256 SATA/AHCI controller of the ICH-7 hub while the CDROM is attached to the 254 legacyPATA IDE controller. This allows two different configurations:257 PATA IDE controller. This allows two different configurations: 255 258 256 259 1. Drive HDD and CDROM via DANIS506.ADD 257 260 2. Drive HDD via OS2AHCI.ADD and CDROM via DANIS506.ADD 258 261 259 OS2AHCI.ADD can't drive the CDROM because it's attached to a legacyPATA262 OS2AHCI.ADD can't drive the CDROM because it's attached to a PATA 260 263 IDE controller which doesn't support AHCI. 261 264 … … 384 387 ========== 385 388 389 v.2.01 01-Oct-2016 - David Azarewicz 390 Major reorganization of the entire driver. 391 Enhanced debugging support. 392 386 393 v.1.32 09-Nov-2013 - David Azarewicz 387 394 Fix for some hardware that reports incorrect status … … 416 423 Added LVM aware disk geometry reporting. 417 424 Begin to add disk information report - not finished yet. 418 Removed undocumented / qswitch and made the driver quiet by default.425 Removed undocumented /Q switch and made the driver quiet by default. 419 426 Debug output improvements. 420 Added / bswitch for setting debug baud rate.427 Added /B switch for setting debug baud rate. 421 428 Fixed up time delay functions 422 429
Note:
See TracChangeset
for help on using the changeset viewer.
