Copyright:       : MARX(R) CryptoTech LP
File             : readme.txt
Date:            : February 7, 2022
Project          : Intelligent CRYPTO-BOX USB Setup "CBUSetup.exe"
Version:         : 1.9.22.207
Hardware:        : CRYPTO-BOX SC firmware 2.2 or CRYPTO-BOX XS/Versa 
                   firmware v1.6 and later
Operating System : Windows (Windows XP and higher, Windows Server 2003 
                   and later)


Content:

1. Overview
2. Supported Hardware
3. Supported Operating Systems
4. Key Features
5. Syntax
6. Exit Codes
7. Version History

*************************************************************************
1. Overview
*************************************************************************

This setup performs automatic installation of CRYPTO-BOX SC and 
CRYPTO-BOX XS/Versa drivers and related components depending on the 
operating system. The installer is a self-extracting tool which contains 
all files needed to support the CRYPTO-BOX SC and CRYPTO-BOX XS/Versa
models and is thus self-sufficient.

After the setup completes installation there is *no need* to reboot 
because the drivers are loaded and started right away! 


*************************************************************************
2. Supported Hardware
*************************************************************************

- CRYPTO-BOX SC Rev.1 and Rev.2, Firmware 2.2 and higher
- CRYPTO-BOX XS/Versa Rev.1 and Rev.2, Firmware 1.6 and higher, Smarx OS 
  or MPI formatted


*************************************************************************
3. Supported Operating Systems
*************************************************************************

The following operating systems are supported by CBUSetup: 

- Windows 11/10 ARM 64Bit (Build 21277 or higher)
- Windows 11/10/8.1/8/7 (Intel 64/32bit)
- Windows Server 2016/2012R2/2012/2008R2
- Legacy systems: - Windows Vista and Windows XP (Intel 64/32bit)
                  - Windows Server 2008/2003 (untested with latest driver
                    version)


*************************************************************************
4. Key Features
*************************************************************************

+ Detection of the operating system, installation and registration of 
appropriate device drivers for Windows x86/x64 and ARM64 platforms.

  NOTE: You do not need to restart your PC after device drivers are 
  set up. In case the CRYPTO-BOX is not recognized immediately after
  finishing CBUSetup, re-inserting the CRYPTO-BOX to the USB port will
  solve the issue.

+ Installation of legacy MPI 32Bit library (mpiwin32.dll)

+ Installation of SMRXCOM Smarx OS COM Object (Intel 64/32bit platforms only)

+ "Quiet" installation mode. This feature makes it possible to integrate the 
setup into other proprietary installations.

In both the "quiet" and the normal modes the setup returns exit codes which 
help external setup analyze how the installation went. Please, refer to the 
section titled "Exit Codes" below.


*************************************************************************
5. Syntax
*************************************************************************

Please, use the following syntax when running the setup:

CBUSetup.exe /? - get a help screen

CBUSetup.exe /Q /CRYPTOKEN - run setup in quiet mode and install the
                             CRYPTO-BOX drivers 

CBUSetup.exe /Q /U /CRYPTOKEN - perform "quiet" uninstallation of the 
                                CRYPTO-BOX drivers

CBUSetup.exe /Q /CRYPTOKEN /DRIVERONLY  - install the CRYPTO-BOX drivers 
                                          without any additional files 
										  (the SMRXCOM ActiveX COM object 
										  will not be installed)
										  
 
*************************************************************************
6. Exit Codes
*************************************************************************

As mentioned above, you can run the setup in a "quiet" and a normal mode. 
The "quiet" mode makes it convenient to redistribute the setup and include 
it into proprietary installations. By analyzing the return value of the 
setup, your proprietary installation can find out if CBUSetup.exe was 
installed successfully.

Below is a list of exit codes you may get from CBUSetup.exe:

0          No errors occurred.

-1         The installer could not detect your operating system.

-2         The user aborted installation.

-3         Wrong version of the operating system.

-4         The setup had an internal error. Please, contact your distributor to 
           notify about this problem.

-5         The user has requested the installer  to run in the "quiet" mode but 
           the device was set incorrectly. Run the installer with a help switch 
           (/? or /H) to see the command line syntax. The following command line 
           syntax is acceptable:

            CBUSetup.exe /Q /CRYPTOKEN

-6         The user does not have enough rights. Contact your System 
           Administrator.

-7         The installer could not perform registration of device driver(s).
           Please, run the installer again, and if the problem persists,
           contact your distributor.


Installation sample for IShield script (without exit code check):

function InstDrivers()
	string szPath,szTargetFile; 
begin  
    	szPath=TARGETDIR^"\\Drivers\\CTSetup\\CBUSetup.exe";
    	szTargetFile=WINSYSDIR^"\\CBUSetup.exe";
        CopyFile (szPath, szTargetFile); 
    	LongPathToQuote(szTargetFile,TRUE);
	LaunchAppAndWait (szTargetFile, "/Q /CRYPTOKEN", WAIT);
end;

function UnInstDrivers()
	string szTargetFile
begin                   
        szTargetFile=WINSYSDIR^"\\CBUSetup.exe";
    	LongPathToQuote(szTargetFile,TRUE);  
	LaunchAppAndWait (szTargetFile, "/Q /U /CRYPTOKEN", WAIT);
	DeleteFile(szTargetFile);
end;


**********************************************************************************
7. Version History
**********************************************************************************

CRYPTO-BOX SC drivers:
- Windows 10 ARM Build 21277 and higher (64Bit): v2.0.21.426
- Windows 8/Server 2012 and higher (64bit): v2.0.18.312
- Windows 8 and higher (32bit): v2.0.18.312
- Windows 7/Vista/XP/Server 2008R2 (64bit): v2.0.9.421
- Windows 7/Vista/XP (32bit): v2.0.9.421

CRYPTO-BOX XS and Versa drivers:
- Windows 10 ARM Build 21277 and higher (64Bit): v2.0.21.426
- Windows 8.1/Server 2012R2 and higher (64bit): v2.0.18.219
- Windows 8.1 and higher (32bit): v2.0.18.219
- Windows 8/7/Vista/Server 2012/Server 2008R2 (64bit): v2.0.18.219
- Windows 8/7/Vista/XP (32bit): v2.0.18.219

SmarxOS ActiveX      		v3.6.11.909
MPI library          		v3.2.5.1209

ver 1.9.22.207	AM
- Added CRYPTO-BOX SC and CRYPTO-BOX XS/Versa drivers for Windows ARM platforms:
  Windows 10 ARM Build 21277 and higher (64Bit)
ver 1.8.18.416	AM
- Updated CRYPTO-BOX SC drivers for Windows 8/Server 2012 and higher (32/64bit):
  * Sleep/Wakeup behavior improved
  * Driver now works fine under Windows 10 Enterprise X64 with 
    Secure Boot ON and Device Guard ON (HVCI incompatibility fixed)
  * Driver signed with new EV certificate
- Updated CRYPTO-BOX XS/Versa drivers (32/64bit):
  * Sleep/Wakeup behavior improved
  * Driver now works fine under Windows 10 Enterprise X64 with 
    Secure Boot ON and Device Guard ON (HVCI incompatibility fixed)
  * Driver for Windows 10/8.1 signed with new EV certificate
  * Dual-signed driver (SHA1/SHA256) for Windows 8/7/Vista
ver 1.7.17.804	KU
	CBUSetup manifest with Win 10 support
ver 1.7.13.321	KU
	Updated CBU x86 & x64 drivers (USB3.0 workaround for Win7 chipset drivers not fulfilling USB specs)
ver 1.6.11.926    KU
    SMRXCOM v3.6.11.909 (CBIOS in GUI windowless applications shutdown delay fix)
ver 1.6.10.608    KU
    SMRXCOM rebuilt with the latest CBIOS.LIB (v1.65)
ver 1.5.10.506    KU
    signed with new MARX CryptoTech LP code signing certificate
ver 1.5.10.318    KU
    SMRXCOM rebuilt with the latest CBIOS.LIB - notifications added (network)
ver 1.5.9.1119    KU
    Vista/Win7 style and Win7 compatibility issue
    SMRXCOM rebuilt with the latest RFP lib
ver 1.5.9.1009    KU
    CBU2 support added
ver 1.0.9.0813    KU
    SmarxOS ActiveX updated (RFP)
ver 1.0.8.1022    KU
    SmarxOS ActiveX updated
ver 1.0.8.1001    KU
    Syntax error fixed (in help dialog: ctsetup.exe -> cbusetup.exe)
ver 1.0.8.0716    001AR
    Updated SmarxOS ActiveX v3.2.8.0626
ver 1.0.8.0611    001AR
    Updated SmarxOS ActiveX v3.2.8.0609
    Added MPI library v3.2.5.1209 
ver 1.0.7.1212    001AR
    Updated SmarxOS ActiveX v3.1.7.1212
ver 1.0.7.1023    001AR
    Updated SmarxOS ActiveX v3.0.7.1023
ver 1.0.7.0927    001AR
    Updated SmarxOS ActiveX v3.0.7.0926
ver 1.0.7.0709    001AR
    Updated SmarxOS ActiveX v3.0.7.0625
ver 1.0.7.0620    001AR
    Updated SmarxOS ActiveX v2.2.7.0309
ver 1.0.7.0508    001AR
    Bugfix
ver 1.0.7.0404    001AR
    New command line switch /DRIVERONLY to install driver files only 
    Removed installation of an older driver version (rollback)
ver 1.0.7.0319    001AR
    Updated cbusb_64.sys v2.0.7.0214
ver 1.0.7.0312    001AR
    Updated SmarxOS ActiveX v2.1.7.0309
ver 1.0.7.0301    001AR
    Bugfix
ver 1.0.7.0221    001AR
    Bugfix
    Updated SmarxOS ActiveX v2.1.7.0221
ver 1.0.7.0215    001AR
    Updated cbusb.sys for W9x\2000\XP\Vista v2.0.7.0214
    Updated cbusb_64.sys for Vista v2.0.7.0210
    Updated SmarxOS ActiveX v2.1.7.0205ver 1.0.7.0124    001AR
    Bugfix 
ver 1.0.6.1218    001AR
    Updated SmarxOS ActiveX v2.1.6.1211
ver 1.0.6.1207    001AR
    Beta support for Windows Vista
ver 1.0.6.1107    001AR
    Updated SmarxOS ActiveX v2.0.6.1024
ver 1.0.6.1017    001AR
    Support for Windows XP x64 Edition
    cbusb_64.sys for XP64 v2.0.6.1002
ver 1.0.6.0613    001AR
    Updated cbusb.sys for W9x\2000\XP v2.0.6.511
ver 1.0.5.1216    001AR
    Updated SmarxOS ActiveX v1.1.5.1214
ver 1.0.5.1115    001AR
    Added SmarxOS ActiveX support
ver 1.0.5.0303    001AR
    Bugfix in USB driver setup for not updated Win98
ver 1.0.5.0131    001AR
    Updated cbusb.sys for NT40SP6 v2.0.5.0129
ver 1.0.4.1130    001AR
    Updated cbusb.sys for W9x\2000\XP v2.0.4.0929
ver 1.0.4.1012    001AR
    Problem with CRYPTO-BOX USB driver installation in quiet mode fixed
    Support for Windows XP Service Pack 2
ver 1.0.4.0312    001AR
    Updated cbusb.sys for W9x\2000\XP v1.2.4.114
ver 1.0.3.1113    001AR
    Updated cbusb.sys for W9x\2000\XP v1.2.3.1029
ver 1.0.3.1015    001AR
    Initial version
	
**** Copyright (c) 2002, 2018 MARX(R) Cryptotech LP ****

Windows is a registered trademark of Microsoft Corporation in the United 
States and/or other countries.