NVME Storage Driver

NVME Driver for OS/2 Introduction ============ NVME.ADD is a NVMe driver for OS/2. This is a new driver. Although it has been tested and found to work correctly and reliably, there may still be unexpected problems and it may not perform as expected. It is the responsibility of the user to determine the suitability of the driver for everyday use especially on production systems. The driver supports NVME hardware version 1.2 and later. It will probably work on older adapters, but this has not been tested. The driver can handle up to 8 adapters and up to 16 namespaces on each adapter. The driver will map namespaces to OS/2 drive units whether they are usable or not. To be usable a namespace must be formatted with an OS/2 compatible block size and format. Note that there are currently no OS/2 tools for managing the namespaces. This driver requires advanced interrupts as provided by the PSD running in advanced interrupt mode (mode 2). This means that it requires the SMP kernel and the PSD running in the default mode. This driver may not work with the W4 kernel, without the PSD, or when using the /VW or /PIC switches. Copyrights and License ====================== Copyright (c) 2020-2022 David Azarewicz <david@88watts.net> All rights reserved. Copyright (C) 1992, 2000-2001 IBM Corporation. All rights reserved. The NVME.ADD Driver Software is a derivative work of the IBM DDK. Binary programs and documentation for the NVME.ADD Driver Software are licensed to and distributed by Arca Noae, LLC. Important! By downloading or using this software, you acknowledge that you have read and consent to the license agreement contained in the separate License.txt file, that you understand it, and that you agree to be bound by its terms. Driver Command Line Options =========================== Global Options Option Description --------------------------------------------------------------------- /A:n Set adapter to n for adapter specific options /N:n Set namespace to n for namespace specific options /I Ignore the current namespace if a namespaces has been specified. Otherwise, ignore the current adapter. /U Make the current namespace available to OS/2 (Usable) regardless of disk type. The /U switch applies to the specific namespace if a namespace has been specified. Otherwise it applies to all namespaces on the current adapter. Normally all namespaces are checked and only made available to OS/2 for normal operations if they have an MBR or are wiped. The /U switch disables the MBR check and makes the namespace available to OS/2 for normal operations regardless of the type of disk. /V Displays informational messages when booting. Silent otherwise. /COM:<n> Set debug COM port base address for debug output. Values for n can be: 1 = COM1 2 = COM2 a hex value (COM port base address) COM1=0x3f8, COM2=0x2f8 The default is 0. If set to 0 then no debug output goes to the COM port. /W Allows the debug buffer to wrap when full. /BAUD:<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. /BAUD has no effect if /COM is not also specified. If /BAUD 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. Debug options may only be available in debug builds. Namespace specific options operate on the adapter currently selected with the /A switch and the namespace currently selected with the /N switch. Examples: BASEDEV=NVME.ADD /A:0 /N:1 /I Means ignore (don't initialize) namespace 1 on adapter 0. BASEDEV=NVME.ADD /A:0 /N:0 /U Means don't do the MBR check on namespace 0 on adapter 0. BASEDEV=NVME.ADD /A:0 /I A:1 /U Means ignore (don't initialize) adapter 0, and don't do the MBR check on any namespaces on adapter 1. Getting Support and Reporting Problems ====================================== For more information and to report problems please visit: https://www.arcanoae.com and click on SUPPORT. Or go directly to the NVME support wiki at: https://www.arcanoae.com/wiki/nvme/ Installation ============ Run the provided Warpin installer. Or to manually install the driver, copy the driver file, NVME.ADD, to \OS2\BOOT on your boot disk and add the following line to CONFIG.SYS before any other disk driver: BASEDEV=NVME.ADD Change Log ========== v.1.02 05-Aug-2022 - David Azarewicz Updated system library Added transaction timeouts. v.1.01 07-Apr-2021 - David Azarewicz Initial release.