JPRO (TM) J1708 RP1210A-Compliant API Version 2.5.0.2 ------------------------------------------------------------------------------------ ------------------------------------------------------------------------------------ FEATURE LIST for Version 2.5.0.2 for July 08, 2002 ======================================================= 1 ) API capability with the B&B Electronics J1708D15 device. 2 ) Allison Shawbox support on Windows 2000 and Windows XP 3 ) Windows XP support. HARDWARE / SOFTWARE CONFIGURATION: ================================= - The following operating systems are supported: 1 ) Windows 95 2 ) Windows 98 3 ) Windows ME 4 ) Windows NT 4.0 (Service Packs 3 or 4) 5 ) Windows 2000 6 ) Windows XP !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! WINDOWS XP USERS !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Installing the API on Windows XP, may cause the Operating System to display the following warnings: "Communications Port for J1708...Software has not passed the Windows Logo testing to verify it's compatability with Windows XP" If this warning is displayed, simply click "OK" to continue the installation. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! WINDOWS 2000 and XP USERS !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! When using a Windows 2000-based computer, a J1708 device may be detected as a serial ball mouse once the user has rebooted their PC. As a result, an error will be generated (error code 230) when the user attempts to make an RP1210A connection. This problem can occur because most "pass-through" devices (such as a Kent-Moore or B&B device) constantly send data to the serial port which causes the detection code to incorrectly identify the device as a serial mouse. Microsoft has confirmed this to be a problem in the Microsoft product: Name: Serenum.sys Date: 01/17/2001 Time: 05:48 PM Version: 5.0.2195.3156 Size: 13,936 The easiest workaround is to allow the J1708 device to be detected incorrectly (as a serial mouse). Then, use the Device Manager, found with in the Administrative Tools of the Control Panel to disable the invalid device. Once you have disabled the device, reboot the PC. This operation should prevent Windows 2000 from seeing the J1708 device as a serial mouse or some other invalid device. For additional help, please refer to the Standalone API User's Guide. If the problem persists, please contact Noregon using the information provided in section "SUPPORT/CONTACT INFORMATION" at the end of this file. FILES SHIPPED: ============= - Please refer to the Standalone API User's Guide provided on the installation CD for additional information on the files installed. The Standalone API User's Guide can be found in the directory labeled "Common" on the installation CD. Note: Installation default install directory is: "\Program Files\Noregon Standalone RP1210A API" Windows 9x: File Name Location ------------------- ------------------- NSIRP32.DLL WINDOWS DIRECTORY NSISVR.EXE WINDOWS DIRECTORY NSIRP32.INI WINDOWS DIRECTORY RP121032.INI (see note) WINDOWS DIRECTORY SJ1708.VXD WINDOWS SYSTEM DIRECTORY nsirp32.h Install directory nsirp32.lib Install directory Standalone API User's Guide.doc Install directory\Docs J1708API-Verification via NSI32exe.doc Install directory\Docs Noregon Support Troubleshooting J1708API.dot Install directory\Docs NSI32.exe Install directory\Samples Windows NT 4.0: File Name Location ------------------- ------------------- NSIRP32.DLL WINDOWS DIRECTORY NSISVR.EXE WINDOWS DIRECTORY NSIRP32.INI WINDOWS DIRECTORY RP121032.INI (see note) WINDOWS DIRECTORY NTPortControlService.exe WINDOWS SYSTEM32 DIRECTORY SJ1708nt.sys WINDOWS SYSTEM32\DRIVERS DIRECTORY nsirp32.h Install directory nsirp32.lib Install directory Standalone API User's Guide.doc Install directory\Docs J1708API-Verification via NSI32exe.doc Install directory\Docs Noregon Support Troubleshooting J1708API.dot Install directory\Docs NSI32.exe Install directory\Samples Windows 2000 & XP: File Name Location ------------------- ------------------- NSIRP32.DLL WINDOWS DIRECTORY NSISVR.EXE WINDOWS DIRECTORY NSIRP32.INI WINDOWS DIRECTORY RP121032.INI (see note) WINDOWS DIRECTORY Nserial.sys WINDOWS SYSTEM32\DRIVERS DIRECTORY SJ1708.sys WINDOWS SYSTEM32\DRIVERS DIRECTORY nsirp32.h Install directory nsirp32.lib Install directory Standalone API User's Guide.doc Install directory\Docs J1708API-Verification via NSI32exe.doc Install directory\Docs Noregon Support Troubleshooting J1708API.dot Install directory\Docs NSI32.exe Install directory\Samples NOTE: If RP121032.INI file already exists, the contents of the file will be modified with the addition of the NSIRP32 entry to the [RP1210Support] section. REGISTRY ENTRIES ADDED: ======================= All Platforms --------------------- HKLM=Software\Noregon Systems\Noregon Stanalone RP1210A API\2.5.0.2 HKLM=Software\Noregon Systems\Noregon Stanalone RP1210A API Version=3 'Release Build Version VersionMajor=2,5 'API Release Major Version VersionMinor=0,2 'API Release Minor Version Windows 9x Platforms ------------------------ HKLM=System\CurrentControlSet\Services\VxD\VCOMM EnablePowerManagement=00000000 'disable power management Start=00 'disable power management Windows NT 4.0 Platforms ------------------------ HKLM=SYSTEM\CurrentControlSet\Services\SJ1708NT ERRORCONTROL=1 'Standard error handling TYPE=1 'Kenerel driver GROUP=Extended Base 'Extended group START=2 'System startup HKLM=SYSTEM\CurrentControlSet\Services\PortControlService ERRORCONTROL=1 TYPE=16 GROUP=Extended Base START=2 ObjectName=LocalSystem ImagePath=\NTPortControlService.exe DisplayName=PortController Windows 2000/XP Platforms ------------------------ HKLM=SYSTEM\CurrentControlSet\Services\SJ1708 ERRORCONTROL=1 TYPE=1 GROUP=Extended Base START=2 HKLM=SYSTEM\CurrentControlSet\Services\NSERIAL DisplayName=NSerial port driver ErrorControl=0 ForceFifoEnable=1 Group=Extended base ImagePath=System32\DRIVERS\Nserial.sys LogFifo=0 PermitShare=0 RxFIFO=8 Start=1 Tag=6 TxFIFO=14 Type=1 TEST PROGRAM: ============= - Provided in the \samples folder in the install directory, is a program, NSI32.exe. This program is a test program for the API and can be used to demonstrate its features or to verify a connection with the J1708 interface device. This software is provided "as is", without any guarantee made as to its suitability or fitness for any particular use. It may contain bugs, so use of this tool is at your own risk. We take no responsibility for any damage that may unintentionally be caused through its use. As stated above, the test utility (NSI32.EXE) is located in the directory labeled "Samples" of the user installed directory (default install directory will be \Program Files\Noregon Standalone RP1210A API\). INSTALLATION INSTRUCTIONS: ========================= - Please read the Standalone API User's Guide provided on the installation CD for more information. - CD-ROM Install 1 ) Insert the Standalone API CD-ROM into the target machine. 2 ) The auto-run will begin the installation process. 3 ) The setup program displays a setup progress indicator. 4 ) Click the Next button on the Welcome dialog. The Software License Agreement dialog displays. 5 ) Read the terms of the license and click Yes if you agree to the terms of the license. 6 ) Enter the desired installation directory and click Next. 7 ) Click the Finish button once installation has completed. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! WINDOWS ME INSTALLS !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! Windows ME installations may "lock-up" if the user has a J1708 device connected to a serial port of the PC. To prevent this error, please disconnect any J1708 devices from the PC before running the install for Windows ME. NOTES: ===== - Known defects/limitations: - Windows 9x 1 ) The API may not prevent a connection to a com port that is already in use. Please close any applications that are using the com port to which you will attach your J1708 converter device. - Windows 2000/XP 1 ) The use of a serial mouse is not recommended. When using a serial mouse in com1 and the API on com2, disconnecting the API may disable the serial mouse. - All Operating Systems 1 ) Errors (bad checksums, single byte messages) have been seen at high utilization (40%-50%). 2 ) Queues are cleared when toggling the echo mode (on/off). 3 ) A PC may have both the Noregon DLA and Standalone API installed on the machine; however, simultaneously running the DLA and API may cause deadlock errors in the applications using the respective drivers. SUPPORT/CONTACT INFORMATION: =========================== - support@noregon.com or call 1-336-768-4337 to speak to the help desk.