(Page 1 of 1 in this chapter) Version

Chapter 3

Installing the Driver Software

3.1 Introduction

3.2 Installing on a Windows NT System

: 3.2.1 Running the AG Connect Setup Program (NT)
: 3.2.2 Running the Board Configuration Program (NT)
: 3.2.3 Changing The Configuration After Installation (NT)

3.3 Installing on an OS/2 System

: 3.3.1 Running the AG Connect Installation Program (OS/2)
: 3.3.2 Editing Your config.sys File (OS/2)
: 3.3.3 Changing The Configuration After Installation (OS/2)

3.4 Installing on a UnixWare System

: 3.4.1 Running the AG Connect Installation Script (UnixWare)
: 3.4.2 Running the Board Configuration Script (UnixWare)
: 3.4.3 Changing the Configuration (UnixWare)

3.5 Installing on a SCO OpenServer 5 System

: 3.5.1 Running the AG Connect Installation Script (SCO)
: 3.5.2 Changing The Configuration After Installation (SCO)

3.6 Installing on a Solaris System

: 3.6.1 Running the AG Connect Installation Script (Solaris)
: 3.6.2 Running the Board Configuration Script (Solaris)
: 3.6.3 Changing The Configuration After Installation (Solaris)

3.1 Introduction

To complete your AG Connect installation, install AG Connect driver software. This chapter explains how to install the AG Connect software for the following operating systems: Windows NT 4.0 OS/2 2.11 or later UnixWare 2.1.x or UnixWare 7 SCO OpenServer 5 Solaris 2.6 or Solaris 7
You can install AG Connect software in any of the following ways: From the Natural Microsystems Natural Access CD-ROM, using the Natural Access setup program. If you are installing the software this way, refer to the booklet that comes with the CD-ROM for installation instructions. Then run the board driver configuration program or script to specify your boards for the driver, as described in the procedures in this chapter. From the Natural Access CD-ROM, using the setup program on the CD-ROM that is specific to the AG Connect software package. If you are installing the software this way, refer to the procedures in this chapter for installation instructions. From a package downloaded from the NMS web site (naturaledge.nmss.com). To install the software this way, follow the instructions on the web site to download and uncompress the package. Then refer to the procedures in this chapter for installation instructions. Note: OS/2 and SCO OpenServer versions of the AG Connect driver software are not packaged with Natural Access. They are available separately on diskette, or they can be downloaded from the NMS web site.

3.2 Installing on a Windows NT System

This procedure describes how to install the AG Connect board driver software for Windows NT 4.0. This procedure is applicable if you wish to install from: An AG Connect package downloaded from the NMS web site, or The Natural MicroSystems Natural Access CD-ROM, using the installation program on the CD-ROM specific to AG Connect.
You can also use the Natural Access setup program to install this package from the CD-ROM. To learn how to install the software this way, refer to the booklet that comes with the CD-ROM for installation instructions.
To install the AG Connect software: Run the AG Connect setup program to install the software on your system. Run the AG Connect board configuration program.

3.2.1 Running the AG Connect Setup Program (NT)

Note: Install your AG Connect boards in your system before installing the software. (See Chapter 2 to learn how to do this.) Make a note of the base I/O addresses at which you installed the boards. You will need this information later when running the board configuration program.

Log on as a member of the Administrators group.
Start the AG Connect setup program:
If you are installing from the CD-ROM using the AG Connect setup program, use the Windows Explorer to navigate to the \agcx\disk1\ directory on the CD-ROM, and start setup.exe.
If you are installing from a package downloaded from the NMS web site, "unzip" the package into a directory. Navigate to the directory, and start setup.exe.
The setup program starts.
Answer the prompts as they appear.
The setup program asks you for the following:
A directory to install the software into.
A program folder to install the software icons into.
System environment variable setting options.
You can let the setup program modify settings, or save the changes to a batch file, or not make any changes at all.
Note: If the program detects previously installed files that are newer than the versions contained in the package, it asks you whether to install or skip the files in question. Typically, you should NOT overwrite newer files.
When the installation is complete, run the board configuration program, as described in Section 3.2.2.

3.2.2 Running the Board Configuration Program (NT)

Use the board configuration program to specify the board numbers, I/O addresses and encoding schemes of the AG Connect boards in your system.
To run the program:

Click on Start, select Programs, and then select Natural MicroSystems AG Connect. Select cfg in the menu that appears.

The AG Connect board configuration program starts up, and displays its main window (shown in Figure 10 below):

Figure 10. AG Connect Board Configuration Program Main Window

Click Add Board.

The Edit Board dialog box appears (see Figure 11):

Figure 11. The Edit Board Dialog Box

In the Board Number list box, select a number for the board.

Each of your AG Connect boards should be given a unique board number. When you create your AG Connect application, you will use these numbers to refer to your boards in software. Boards should be numbered from 0 upward.

In the Encode Law list box, select the encoding scheme the board will use in your application.

The encoding scheme is the algorithm the board will use to compress and expand the dynamic range of input signals. The AG Connect driver supports two encoding schemes: mu-law (the scheme in standard use throughout the United States and Japan) and A-law (the scheme in use in Europe and Latin America).

In the Board Address list box, select the base I/O address of the AG Connect board that you selected using the switches on the board.

For more information on setting the I/O addresses, see Chapter 2.

Click OK.

The AG Connect Board Configuration dialog box reappears. The board information appears in the field in the center of the box (see Figure 12).

Figure 12. Board Information in Configuration Dialog Box

Repeat steps 2 through 6 for each AG Connect board in your system.

When you have added all of your boards, press OK.

3.2.3 Changing The Configuration After Installation (NT)

You may need to modify your driver configuration after you have completed the install process. For example, you may wish to add additional boards to your system, or you may need to change the base I/O address of a board.
Use the AG Connect board configuration program to modify your configuration.
To run the program:

Click on Start, select Programs, and then select Natural Microsystems AG Connect. Select cfg in the menu that appears.

The AG Connect board configuration program starts up, and displays its main window (shown in Figure 10).
To change your driver configuration:

To add another board, click Add Board. Follow the steps for adding boards listed in Section 3.2.2.

To edit the configuration for an existing board, click Edit Board. The Edit Board dialog box appears, where you can specify a different configuration.

To delete a board configuration, select the configuration in the AG Connect Board Configuration dialog box, and press Delete Board.
To exit:

Click OK to save changes, or

Click Cancel to ignore changes.

3.3 Installing on an OS/2 System

This section provides instructions for installing AG Connect driver software on the OS/2 operating system. This procedure is applicable if you wish to install from: An AG Connect package downloaded from the NMS web site, or AG Connect driver software distribution diskettes for OS/2.
To install the AG Connect software: Run the AG Connect setup program to install the software on your system. Edit your config.sys file. Note: Use CT Access 2.0 when running the AG Connect driver on OS/2.

3.3.1 Running the AG Connect Installation Program (OS/2)

Insert the AG Connect software installation disk into your floppy drive.
Open a system prompt window.
Make the drive containing your installation disk the default drive by entering A: or B: at the system prompt.
Enter the following and click OK:
a:\install
The installation program starts up, and displays its welcome and information screens. It then prompts you for a destination drive.
Use the arrow keys to select the drive to install on, and press Enter.
The install program prompts you to enter the number of AG Connect boards you are installing.
Enter the number of boards you are installing, and press Enter.
The program displays a menu containing a list of base I/O addresses.
Use the arrow keys to highlight the address of one of your boards, and press the space bar to select it.
Repeat this step until the addresses of all of your boards are highlighted.
When you have selected the addresses of all of your boards, press Enter.
The install program prompts you to choose an encoding scheme.
Press 1 for mu-law, or 2 for A-law. Then press Enter.
The install program begins copying the files from the installation disk to the NMS subdirectory tree on the specified drive.
If the installation program detects previously installed files that are newer than the versions contained in the package, it asks you whether to overwrite or skip the files in question. Typically, you should NOT overwrite newer files.
When the installation program finishes copying files, it displays a list of changes to make to your config.sys file. It outputs the file config.agx containing these changes. config.agx is stored in the root directory of the drive on which the software is being installed.
Press Enter to exit the install program.

3.3.2 Editing Your config.sys File (OS/2)

Using a text editor, open config.agx and config.sys.
Change your config.sys file as directed in config.agx.
Figure 13 shows a sample config.agx file (for a one-board installation), with the changes to make to the config.sys file underlined. The contents of your config.agx file may be different.
Figure 13. Lines to Change in config.sys
The syntax of the set AGCX= line is as follows:
set AGCX={!}[m|a]:addr,addr,addr,addr
...where:
! (Optional) if included, a status message will appear whenever the driver DLL loads.
m is mu-law, a is a-law (choose one only).
Each addr is the base address of one of your AG Connect boards. The order you list them here determines the board number by which the software will refer to them later: the first board listed will be Board 0, the second will be Board 1, and so on.
Exit the text editor, saving changes.
Reboot your system to make your changes effective.

3.3.3 Changing The Configuration After Installation (OS/2)

You may need to modify your driver configuration after you have completed the install process. For example, you may wish to add additional boards to your system, or you may need to change the base I/O address of a board.
To change your driver configuration, do the following: Modify the set AGCX= statement in config.sys to reflect your changes. The syntax of this line is shown in Section 3.3. Reboot your system to make the changes effective.

3.4 Installing on a UnixWare System

This procedure describes how to install the AG Connect board driver software for UnixWare 2.1.x or UnixWare 7. This procedure is applicable if you wish to install from: An AG Connect software package downloaded from the NMS web site, or The Natural MicroSystems Natural Access CD-ROM, using the installation script on the CD-ROM specific to AG Connect.
You can also use the Natural Access installation script to install this package from the CD-ROM. To learn how to install the software this way, refer to the booklet that comes with the CD-ROM for installation instructions.
To install the AG Connect software: Run the AG Connect installation script to install the software on your system. Run the AG Connect board configuration script. Note: Install your AG Connect boards in your system before installing the software. (See Chapter 2 to learn how to do this.) Make a note of the base I/O addresses at which you installed the boards. The installation script will prompt you for these addresses.

3.4.1 Running the AG Connect Installation Script (UnixWare)

Note: During this installation procedure, pkgadd may warn you that it is about to overwrite newer versions of files on your system with older ones. This warning may appear even if the files you are installing are actually newer than the ones on your system. This is because files installed with earlier versions of the install script were marked with the installation date, not their creation dates. Later versions of the script preserve the creation date.

If you are installing over earlier versions of AG Connect driver software, remove the earlier version and rebuild the kernel before you install the new software.

See Appendix C to learn how to remove driver software from your system.
From a command prompt, log in as root.
If you are installing from the Natural Access CD-ROM:
Insert the Natural Access CD-ROM into the CD-ROM drive.
Start a new terminal session.
If the CD-ROM does not have a mount point directory, create this directory.
Make sure you are not in the mount point directory. Then enter the following to mount the CD-ROM:
mount -f cdfs -r /dev/cdrom/devicename mountpoint
...where devicename is the device name of the CD-ROM, and mountpoint is the mount point directory. For example, for UnixWare 2.1.x, you might enter:
mount -f cdfs -r /dev/cdrom/c1b0t3l0 /CD-ROM_1
For UnixWare 7, you might enter:
mount -f cdfs -r /dev/cdrom/cdrom1 /CD-ROM_1

Enter the following command to invoke the pkgadd utility:

pkgadd -d mountpoint
pkgadd starts up, and displays a list of packages available for installation.
Select the agcx software package, and press Enter.
pkgadd installs the driver software on your system.
Answer the prompts as they appear.
Note: If the program detects previously installed files that are newer than the versions contained in the package, it asks you whether to overwrite or skip the files in question. Typically, you should NOT overwrite newer files. After the files are copied, the following message appears:
Installation of AG Connect for UnixWare 2.1 (agcx) successful.
Type q to quit.
To unmount the CD-ROM, enter: umount mountpoint
Now run the board configuration script, as described in Section 3.4.2.

3.4.2 Running the Board Configuration Script (UnixWare)

Use the board configuration script to specify the board numbers, I/O addresses and encoding schemes of the AG Connect boards in your system.
To run the script:

From a command prompt, log in as root.

Execute the confdrvr shell script by entering this command:

sh /opt/nms/agcx/drv/confdrvr
confdrvr starts up. The following message appears:
You will now provide the base addresses of the agcx
Boards you are installing in your system. When you are prompted for
a base address, a list of possible choices will be given.

If installing more than one board into your system,
the choices already selected during this installation will be
marked, and the device node name that will be used to access the
agcx board is listed.

Enter c to continue or enter q to quit:

Enter c.

Follow the prompts to supply the following information for the AG Connect boards in your system:

The base I/O addresses of the AG Connect boards in your system.

As you select addresses, make a note of the order in which you select them. The configurationits and up must to script assigns device numbers to your boards based on the order in which they are selected. When you create your AG Connect application, you will use these numbers to refer to your boards in software.
For example, if you select address 0x0640 first and then address 0x2140, the board at address 0x0640 is assigned device number 0. The board at address 0x2140 is assigned device number 1.
For more information on setting the I/O addresses, see Chapter 2.

The encoding scheme the boards will use in your application.

The encoding scheme is the algorithm the board will use to compress and expand the dynamic range of input signals. The AG Connect driver supports two encoding schemes: mu-law (the scheme in standard use throughout the United States and Japan) and A-law (the scheme in use in Europe and Latin America).

When you have entered all of this information, confdrvr rebuilds the kernel.

3.4.3 Changing the Configuration (UnixWare)

You may need to modify your driver configuration after you have completed the install process. For example, you may wish to add additional boards to your system, or you may need to change the base I/O address of a board.
To change your driver configuration, do the following: From a command prompt, log in as root. Execute the confdrvr shell script by entering this command: sh /opt/nms/agcx/drv/confdrvr confdrvr starts up. It displays this message: Warning! A version of the Natural MicroSystems agcx device driver is already installed. Do you want to continue? (y/n) Enter y. The following message appears: You will now provide the base addresses of the agcx Boards you are installing in your system. When you are prompted for a base address, a list of possible choices will be given. If installing more than one board into your system, the choices already selected during this installation will be marked, and the device node name that will be used to access the agcx board is listed. Enter c to continue or enter q to quit: Enter c. confdrvr displays a menu of base I/O addresses. Mark the base I/O addresses of ALL boards in your system, just as you did during the initial install procedure. (See Section 3.4 for more information.) Note: Even if you are adding a new board to a system which already includes AG Connect boards, you must specify the base addresses of all boards. Remember the order in which you select the addresses, so you know what device number each board is given. When you have selected the addresses of all of your boards, enter 0. Follow the prompts to select a coding scheme and rebuild the kernel.

3.5 Installing on a SCO OpenServer 5 System

This section provides instructions for installing AG Connect driver software on the SCO OpenServer 5 operating system. This procedure is applicable if you wish to install from: An AG Connect package downloaded from the NMS web site, or AG Connect driver software distribution diskettes for SCO OpenServer 5.
To install the AG Connect software, run the AG Connect installation script to install the software on your system. Note: Use CT Access 2.0 when running the AG Connect driver on SCO OpenServer 5.

3.5.1 Running the AG Connect Installation Script (SCO)

Note: Install your AG Connect boards in your system before installing the software. (See Chapter 2 to learn how to do this.) Make a note of the base I/O addresses at which you installed the boards. The installation program will prompt you for these addresses.

If you are installing over earlier versions of AG Connect driver software, remove the earlier version and rebuild the kernel before you install the new software.

See Appendix C to learn how to remove driver software from your system.
From a command prompt, log in as root.
Insert the AG Connect board installation diskette into your floppy disk drive.
Invoke the pkgadd utility by entering a command of the form:
pkgadd -d devicename
...where devicename is the name of the floppy disk drive from which you are installing. For example:
pkgadd -d /dev/rdsk/f03h
pkgadd starts up, and displays a list of software packages available for installation.
Select the agcx package, and press Enter.
pkgadd copies the driver software from the disk onto your system.

When pkgadd has finished copying files, it displays the following message:

   You will now provide the base addresses of the agcx
   Boards you are installing in your system. When you are prompted for
   a base address, a list of possible choices will be given.

   If installing more than one board into your system,
   the choices already selected during this installation will be
   marked, and the device node name that will be used to access the
   agcx board is listed.

   Enter c to continue or enter q to quit:

Enter c.
pkgadd displays a menu of base I/O addresses.
Mark the addresses of the AG Connect boards in your system.
To select an address, type its number. The menu reappears with the address marked.
As you select addresses, make a note of the order in which you select them. The install program assigns device numbers to your boards based on the order in which they are selected. When you create your AG Connect application, you will use these numbers to refer to your boards in software.
For example, if you mark address 0x0640 first, and then address 0x2140, the board at address 0x0640 is assigned device number 0. The board at address 0x2140 is assigned device number 1.
When you have selected the addresses of all of your boards, enter 0.
pkgadd displays this message:
```
   1.  mu-law
   2.  A-law
   Please select idle code, q to quit.
```
pkgadd is asking you to select an encoding scheme. The encoding law you select applies to every AG Connect board in the system.

Enter 1 or 2 to select the encoding scheme to use.

pkgadd displays this message:

  Rebuild the kernel with the AG Connect Board device driver now? (y/n)

Enter y.
pkgadd prepares to rebuild the kernel. It displays this message:
```
   Do you want this kernel to boot by default? (y/n)
```
Enter y.
pkgadd causes the kernel to be rebuilt.
Note: pkgadd may warn you that it is about to overwrite newer versions of files on your system with older ones. This warning may appear even if the files you are installing are actually newer than the ones on your system. This is because files installed with earlier versions of the install script were marked with the installation date, not their creation dates. Later versions of the script preserve the creation date.
When pkgadd has finished rebuilding the kernel, it displays this message:
```
   Do you want the kernel environment rebuilt? (y/n)
```
Enter y.
pkgadd sets up the new kernel environment.
Shut down your system, and reboot.
The driver will not be available until you reboot.

3.5.2 Changing The Configuration After Installation (SCO)

You may need to modify your driver configuration after you have completed the install process. For example, you may wish to add additional boards to your system, or you may need to change the base I/O address of a board.
To change your driver configuration, do the following: From a command prompt, log in as root. Execute the confdrvr shell script by entering the following command: sh /opt/nms/agcx/drv/confdrvr confdrvr starts up. The following message appears: You will now provide the base addresses of the agcx Boards you are installing in your system. When you are prompted for a base address, a list of possible choices will be given. If installing more than one board into your system, the choices already selected during this installation will be marked, and the device node name that will be used to access the agcx board is listed. Enter c to continue or enter q to quit: Enter c. confdrvr displays a menu of base I/O addresses. Mark the base I/O addresses of ALL boards in your system, just as you did during the initial install procedure. (See Section 3.5 for more information.) Note: Even if you are adding a new board to a system which already includes AG Connect boards, you must specify the base addresses of all boards. Remember the order in which you select the addresses, so you know what device number each board is given. When you have selected the addresses of all of your boards, enter 0. Now follow steps 10 through 15 in Section 3.5 above to select a coding scheme, rebuild the kernel and reboot the system.

3.6 Installing on a Solaris System

This procedure describes how to install the AG Connect board driver software for Solaris 2.6 or Solaris 7. This procedure is applicable if you wish to install from: An AG Connect package downloaded from the NMS web site, or The Natural MicroSystems Natural Access CD-ROM, using the installation script on the CD-ROM specific to AG Connect.
You can also use the Natural Access installation script to install this package from the CD-ROM. To learn how to install the software this way, refer to the booklet that comes with the CD-ROM for installation instructions.
To install the AG Connect software: Run the AG Connect installation script to install the software on your system. Run the AG Connect board configuration script.

3.6.1 Running the AG Connect Installation Script (Solaris)

Note: Install your AG Connect boards in your system before installing the software. (See Chapter 2 to learn how to do this.) Make a note of the base I/O addresses at which you installed the boards. The installation script will prompt you for these addresses.

Log in as root at your shell's command prompt by entering:
su -
Set the environment variable NONABI_SCRIPTS to TRUE.
Start a new terminal session.
If you are installing from the Natural Access CD-ROM, insert the Natural Access CD-ROM into the CD-ROM drive.
If you are currently within the Solaris Common Desktop Environment, the File Manager application appears showing the contents of the CD-ROM.
Within the terminal session, invoke the pkgadd utility by entering:
pkgadd -d mountpoint
...where mountpoint is the mount point of the CD-ROM from which you are installing. For example:
pkgadd -d /dev/CD-ROM_1
pkgadd starts up, and displays a list of packages available for installation.
Select the agcx package, and press Enter.
pkgadd copies the driver software from the disk onto your system.
To unmount the CD-ROM, enter: eject mountpoint
Now run the board driver configuration script, as described in Section 3.6.2.

3.6.2 Running the Board Configuration Script (Solaris)

Use the board configuration script to specify the board numbers, I/O addresses and encoding schemes of the AG Connect boards in your system.
To run the script:

Log in as root by entering:

su -

Set the environment variable NONABI_SCRIPTS to TRUE.

Execute the confdrvr shell script by entering:

sh /opt/nms/agcx/drv/confdrvr
confdrvr starts up. The following message appears:
You will now provide the base addresses of the agcx
Boards you are installing in your system. When you are prompted for
a base address, a list of possible choices will be given.

If installing more than one board into your system,
the choices already selected during this installation will be
marked, and the device node name that will be used to access the
agcx board is listed.

Enter c to continue or enter q to quit:

Enter c.

Follow the prompts to supply the following information for the AG Connect boards in your system:

The base I/O addresses of the AG Connect boards in your system.

As you select addresses, make a note of the order in which you select them. The configuration script assigns device numbers to your boards based on the order in which they are selected. When you create your AG Connect application, you will use these numbers to refer to your boards in software.
For example, if you select address 0x0640 first and then address 0x2140, the board at address 0x0640 is assigned device number 0. The board at address 0x2140 is assigned device number 1.
For more information on setting the I/O addresses, see Chapter 2.

The encoding scheme the boards will use in your application.

The encoding scheme is the algorithm the board will use to compress and expand the dynamic range of input signals. The AG Connect driver supports two encoding schemes: mu-law (the scheme in standard use throughout the United States and Japan) and A-law (the scheme in use in Europe and Latin America).

Exit the root shell by entering:

exit

3.6.3 Changing The Configuration After Installation (Solaris)

You may need to modify your driver configuration after you have completed the install process. For example, you may wish to add additional boards to your system, or you may need to change the base I/O address of a board.
To change your driver configuration, do the following: Log in as root by entering: su - Set the environment variable NONABI_SCRIPTS to TRUE. Execute the confdrvr shell script by entering: sh /opt/nms/agcx/drv/confdrvr confdrvr starts up. It displays this message: Warning! A version of the Natural MicroSystems agcx device driver is already installed. Do you want to continue? (y/n) Enter y. You will now provide the base addresses of the agcx Boards you are installing in your system. When you are prompted for a base address, a list of possible choices will be given. If installing more than one board into your system, the choices already selected during this installation will be marked, and the device node name that will be used to access the agcx board is listed. Enter c to continue or enter q to quit: Enter c. confdrvr displays a menu of base I/O addresses. Mark the base I/O addresses of ALL boards in your system, just as you did during the initial install procedure. (See Section 3.6 for more information.) Note: Even if you are adding a new board to a system which already includes AG Connect boards, you must specify the base addresses of all boards. Remember the order in which you select the addresses, so you know what device number each board is given. When you have selected the addresses of all of your boards, enter 0. Follow the prompts to select a coding scheme and reinstall the drivers.

(Page 1 of 1 in this chapter) Version

tech_support@nmss.com