UniKey/Activator Parallel Device Driver Installation Program

VERSION   2.52

1. Description

2. Command line mode

      Action/Error codes

3. Interactive mode

     Custom Installation

     Driver parameters

                 Copyright  (c) 1997    Software Security, Inc.

                                                     6  Thorndal Circle

                                                     Darien, CT 06820-5421

                                                     Tel:       1-800-841-1316

                                                     Fax:       203-656-3932

                                                     E-mail:  softsec@softsec.com


Program Description

This program controls UniKey/Activator  parallel port device driver installation, removal, and parameter  changing procedures.

The following drivers are available:

SSIACT.386   -  Activator/UniKey device driver for Windows 3.X and Windows 95.

Supported parameters:

·	SSI_ACT=<k,l,m>       - Activator/UniKey timing variables;

·	SSI_MEM=OLD          - Activator key flag;

·	SSI_PS2EPP=YES       - needed on some IBM computers with PS/2 compatible parallel port;

·	SSI_DOSX=YES         - needed for some protected mode (DOS extender) Aegis-shelled programs;

·	SSI_VPORT=<hhhh>  - virtual port address (Hex);

·	SSI_LPT=<n>              - (n = 1, 2, 3) LPT number;

·	SSI_PORTADDRESS=<hhh>  - (Hex  -  378, 278 or 3BC) physical LPT port address;

SSIPDDP.SYS   -   Windows NT Activator/UniKey device kernel driver.

       Supported parameters:

·	SSI_ACT=<k,l,m>        - Activator/UniKey timing variables;

·	SSI_MEM=OLD           - Activator flag;

·	Vport=<hhhh>              - virtual port address (Hex);

·	LPTPort=<n>                - (n = 1, 2, 3) LPT number;

·	PortAddress=<hhh>      - (Hex  -  378, 278 or 3BC) physical LPT port address;

SSIVDDP.DLL   -   Windows NT virtual device driver;

SSIDDDP.SYS   -   Windows NT DOS device driver.

Parameter variables are placed in the file SYSTEM.INI (for Windows 3.X) or the Windows registry (for Windows 95 and NT).  This program does not change environment variables.

The driver parameters described above can be added, changed, or deleted.

 Parameters SSI_ACT and SSI_LPT affect the driver immediately.  For other parameters to be effective under Windows NT,  the program stops and starts the kernel driver.  For Windows 3.X and Windows 95, you must restart the computer.  If a computer check requests to set correct SSI_ACT values, the program executes the measuring procedure and uses its results.

The install program performs uninstallation of Activator/UniKey device drivers by cleaning the registry (NT, 95), SYSTEM.INI file (Windows 3.X), config.nt (config.wow) file(s) (NT) and stops SSIPDDP service (NT).  The driver files are not actually deleted from the Windows directories, however.  Windows 3.X and Windows 95 should be rebooted after uninstallation.

Before modification, files system.ini, config.nt, config.wow are saved with extention .x00, .x01 etc. (x=first letter of old extension).


Command Line Mode

If the install program is started with any parameters it runs in command line mode. Command line parameters are separated by spaces.  A parameter file can be used for some or all parameters .

Command line mode parameters description:

·	@filename  - load parameters from file filename.  Parameter file has the same syntax as the command line, except that a new line can be used as a parameter separator;

Commands:

·	INSTALL      - driver installation request.  Installation is performed with default parameters if

                          they are not defined on the command line;

·	REMOVE      - uninstall drivers.

·	CHECK         - check the version and settings of installed drivers, check and return a list of

                          available parallel ports   (LOGLEVEL parameter is ignored, default (3) level is 	used).

·	HELP  (or incorrect parameter)   - display brief help screen.

Log file control:

·	LOGFILE=<LogFileName>         -  defines log file name  (SSIDINST.LOG is the default),

 parameter is ignored if LOGLEVEL=0;

·	LOGLEVEL=n    (n = 0, 1, 2, 3);  -  log file informative level  (3 - default).

·	Level 0  -   no log records;

·	Level 1  -   silent mode. The program does not show any screen output. The log file will be overwritten and contains success/error codes only.  Code 0 means success;

·	Level 2  -   action number:success/error code  One line per action, log file is appended.

·	Level 3  -   detailed  text  information  includes date/time, request/action, parameters, program output (driver/port information in command mode), result codes and error descriptions.

Installation options:

·	FORCE         - replaces existing drivers even with an older version;

·	NOVDD        - do not install 16-bit virtual and DOS device drivers.  This parameter is valid for Windows NT only.  By default, the program installs 32-bit kernel, 16-bit virtual and 16-bit DOS drivers under NT.  This parameter is ignored if 16-bit drivers are already installed in the system.

·	SOURCE=<Source_files_path> - changes default source files (drivers) DRIVE/DIRECTORY ;

·	DESTINATION=<Destination_files_path> - changes default DRIVE/DIRECTORY for SSIACT.386 or SSIPDDP.SYS/ SSIDDDP.SYS files.

Driver Settings:

These lines can be used with the installation command or without any command  (current setting change):

·	SSI_ACT=<k,l,m>     - change or set  SSI_ACT variable;

·	SSI_ACT=CHECK   - check the computer and change or set SSI_ACT;

·	SSI_MEM=OLD        - Activator/M flag;

·	SSI_PS2EPP=YES     - PS/2 compatible port  (Windows 3..X/95 only);

·	SSI_DOSX=YES        - DOS extender  (Windows 3..X/95 only);

·	SSI_VPORT=hhhh    - set virtual port address;

·	SSI_LPT=n                 - (n = 1, 2, 3) set/change LPT number

·	SSI_PORTADDRESS=hhh  - (hhh =378, 278, 3BC) set LPT port address;

Note: to remove any parameter and use the default value, the expression SSI_XXX=     can be used.


Interactive mode

If the install program is started without parameters it runs in interactive mode.

Choices available are:

Express Installation     -   installation with default parameters of:

·	do not install (overwrite) older version driver if newer is installed;

·	under NT install SSIPDDP.SYS, SSIVDDP.DLL and SSIDDDP.SYS;

·	SSI_LPT=1;

·	SSI_VPORT=3078;

·	source device driver files are placed in current directory or (if not found) start directory, destination driver file directory is WindowsDir\SYSTEM for SSIACT.386, WindowsDir\SYSTEM32\DRIVERS for SSIPDDP.SYS and SSIDDDP.SYS or directory where current driver is installed;

Custom Installation      -   installation with user defined parameters:

·	user can change source and destination path;

·	user can replace newer drivers with older ones;

·	user can reject SSIVDDP.DLL/SSIDDDP.SYS installation (NT);

·	user can set/change parameters with or without new software installation (Parameters button):

·	select physical and virtual port addresses;

·	set other SSI_XXXX parameters;

·	check computer and set SSI_ACT value  (Driver parameters);

Uninstall            -   remove drivers;

Exit                      -  terminate the program.


 Custom Installation

Source path    -    drive/directory where source driver file(s) are located.  Default source path is set to current or start (where DDINSTAL.EXE was started from) directory, depending where driver files are found.

Destination path   -   installation directory for files SSIACT.386 (3.X/95), SSIPDDP.SYS, SSIDDDP.SYS (NT).  Virtual device driver SSIVDDP.DLL (NT) will be installed to Windows System32 subdirectory.   Default destination path is set to Windows\SYSTEM (SYSTEM32\DRIVERS for NT) or  to directory where current SSI driver is installed.  To change source or destination path, enter new path in the edit window or push button for browsing.

Installation modes:

 Change driver parameters only   -   select this option if you do not want to replace driver files but need current driver setting change only.  See Driver parameters.

 Replace by newer version only  -  in this mode the program does not allow the installation of older drivers if newer ones are installed.  It is the default mode.

 Replace always  -  select this mode only if you want to replace current driver(s) with older ones (FORCE mode).

Driver parameters button   -   enter dialog for current or new driver parameter setting/changing.

OK button               -  perform installation/parameters change.

CANCEL button   -  return to main window.

FOR WINDOWS NT ONLY

 32 bit driver only   -  under Windows NT it is possible to install only kernel driver SSIPDDP.SYS if you do not intend to use 16-bit protected applications. This option is disabled if 16-bit drivers are already installed on the system.

 32/16 bit drivers   -   default mode for NT - install all - kernel, virtual and DOS drivers.


Driver Parameters

This screen allows you  to set/change SSI driver parameters.  The right part of the screen contains current values as they are defined in the SYSTEM.INI file (3.X/95) or registry (95/NT).  See Description for more information about driver parameters.  To set any parameter,  mark the check box on the left of the parameter name and enter/select the correct value if it is needed.  To remove a parameter and force a driver to use the default value, remove the mark.

SSI_ACT   -   enter timing variables into edit windows (1..9999). For most cases default values (2, 2, 2) are optimal. But if you have problems with Key access, it is possible to check your computer and use the measurement results.  The Check NOW button starts the measurement procedure. This option is disabled if SSI device driver is not running.   Another way to set the SSI_ACT values is to mark  Check  checkbox (this checkbox is disabled for Windows 3.X/95 if SSI device driver is not started).  In this case, the measuring utility will be started after the NT kernel driver installation.  To set correct SSI_ACT values under Windows 3.X/95 you should restart the system after first installation.  The measuring procedure started by Check NOW button or Check checkbox will take some time (several minutes), so be patient.

For SSI_MEM=OLD,  SSI_PS2EPP=YES,  SSI_DOSX=YES parameters, mark the checkbox to set the parameter, remove mark to delete it.

SSI_VPORT  - enter new virtual port address in HEX.  Value must be > 1000 and rounded to a factor of 4.

SSI_LPT and  SSI_PORTADDRES - select from a list of available ports (numbers or addresses).


Action/Error codes

LOG file action codes (for loglevel=2)

  0          Parameters change

  1          Driver installation

  2          Driver remove

  3          Driver/ports information request

Command line mode error codes (loglevel = 1 or 2)

   0          Success

  -1          File open error    (incorrect name, access denied, device failure)

  -2          File close error

  -3          File read error

  -4          File write error  (disk is full, device failure)

  -5          Unable to create *.x01..*.x99 file (disk is full, 100 old copies exist)

  -6          File (system.ini, config.nt, config.wow) rename error (system error)

  -7          Source driver file not found

  -8          Incorrect (or corrupted) driver file

  -9          Memory allocation error (system problem)

 -10         Incorrect command line command/option/parameter

 -11         Duplicated/conflicting command(s)

 -12         Duplicated/conflicting installation options

 -13         Duplicated/conflicting driver parameters

 -30         UniKey device driver is not installed

 -31         Source driver file not found

 -33         Registry access error

 -34         Invalid source path  (incorrect or does not exist)

 -35         Invalid destination path

 -37         The Key measuring error (port/key failure)

 -38         UniKey/Activator not found (for measuring)