• Windows NT 4.0

• UnixWare 2.1.x or UnixWare 7

• Solaris 2.6 or Solaris 7

• 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.

• 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 (www.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: If you do not have CT Access 2.1 or greater installed, you must use MVIP-90 raw driver commands to set up switch connections to and from the board (as shown in the rawdrvr demonstration program). Refer to Section 7.2.3 for more information.

• 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.

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 setup program will prompt you for these addresses.

1. Log on as a member of the Administrators group.

2. 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.

3. 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.

   In addition, you will need to supply the following information for each AG Connect board in your system:

   - A board number.

   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.

   - The base I/O address of the AG Connect board.

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

   - 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).

   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.

4. When the installation is complete, reboot your system.

   Note: Make sure to reboot your system after installation, as directed by the setup program. The driver will not be available until you reboot.

1. Start setup.exe again, as described in step 2 of Section 3.2.

   The setup program starts, and displays its welcome screen.

2. Click Next.

   The Selected Components dialog box appears.

3. Click on Modify Board Configuration, and click Next.

   The AG Connect Card Driver Board Installation dialog box appears.

4. Add, edit, or delete card entries as needed, using Add Board, Edit Board or Delete Board.

5. Click Next, and answer the remaining prompts as they appear.

   Note: Make sure to reboot your system, if you are directed to do so by the setup program.

• 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.

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. 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.

1. If you are installing over earlier versions of AG Connect or 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.

2. Access a command prompt, and log in as root.

3. If you are installing from the Natural Access CD-ROM:
   1. Insert the Natural Access CD-ROM into the CD-ROM drive.

   2. Start a new terminal session.

   3. If the CD-ROM does not have a mount point directory, create this directory.

   4. Make sure you are not in the mount point directory. Then enter the following to mount the CD-ROM:
      mount -f CD-ROMfs -r /dev/CD-ROM/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 CD-ROMfs -r /dev/CD-ROM/c1b0t3l0 /CD-ROM_1

      For UnixWare 7, you might enter:

      mount -f CD-ROMfs -r /dev/CD-ROM/CD-ROM1 /CD-ROM_1

4. Enter this command to invoke the pkgadd utility:

   pkgadd -d mountpoint

   pkgadd starts up, and displays a list of software packages available for installation.

5. Select the agcx software package, and press Enter.

   pkgadd installs the driver software on your system.

6. 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 install or skip the files in question. Typically, you should NOT overwrite newer files.

7. After the files are copied, 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 installation 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 specified this information, pkgadd rebuilds the kernel. When the kernel rebuild is complete, the following message appears:

   Installation of AG Connect for UnixWare 2.1 (agcx) was successful.

8. Type q to quit.

9. Shut down your system, and reboot.

   The driver will not be available until you reboot.

1. Access a command prompt, and log in as root.

2. 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)
   
   

3. 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:
   
   

4. Enter c.

   confdrvr displays a menu of base I/O addresses.

5. Mark the base I/O addresses of ALL boards in your system, just as you did during the initial install procedure. (See Section 3.3 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.

6. When you have selected the addresses of all of your boards, enter 0.

7. Follow the prompts to select a coding scheme, rebuild the kernel and reboot the system.

• 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.

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.

1. Log in as root at your shell's command prompt by entering:

   su -

2. Set the environment variable NONABI_SCRIPTS to TRUE.

3. Start a new terminal session.

4. 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.

5. Within the terminal session, invoke the pkgadd utility by entering a command of the form:

   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 software packages available for installation.

6. Select the agcx package, and press Enter.

   pkgadd copies the driver software from the disk onto your system.

7. After the files are copied, 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 installation 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 specified this information, pkgadd displays this message:

   Do you want to install the drivers now? (y/n)

8. Enter y.

   pkgadd installs the drivers.

9. Exit the root shell by entering:

   exit

1. Log in as root by entering:

   su -

2. Set the environment variable NONABI_SCRIPTS to TRUE.

3. 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:
   
   

4. Enter c.

   confdrvr displays a menu of base I/O addresses.

5. 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.

6. When you have selected the addresses of all of your boards, enter 0.

7. Follow the prompts to select a coding scheme and reinstall the drivers.