Portal Installation and Setup


Before any applications can control and communicate with the Portal I/O cards installed in your computer, the Portal driver and library must be installed. The driver and library only need to be installed once in order to allow control of any number of I/O cards that are installed. The installation procedure is simple and easy, but it is different depending on the operating system you use.

Jump to detailed instructions:
Windows XP
Windows 2000
Windows Me
Windows 98
Windows 95
Windows NT
Linux

Windows

The driver/library installation procedure is very similar on all versions of Windows except Windows NT (see below). The driver is installed using the "Add Hardware" option of the Control Panel. Since there is no hardware that will be detected automatically by Windows, the Portal driver will need to be installed by manually selecting a driver, using the "Have Disk" button to point Windows to the "win\driver" directory. More detailed instructions are available below:

Windows XP

  1. Open the Control Panel.
  2. Open the "Add Hardware" wizard. If you are using Windows XP's default "Category View" for the Control Panel, this is done by clicking on "Printers and Other Hardware" and under "See Also" on the left, click "Add Hardware".
  3. The wizard typically displays a screen explaining what it is used for. Click Next to continue.
    Add Hardware Wizard

  4. The wizard may automatically scan for new hardware. The scanning will not detect any Portal I/O cards.
  5. You may be asked "Have you already connected this hardware to your computer?" Regardless of whether you have installed any cards yet, click Yes.
  6. You will be shown a list of the hardware already installed in your computer. Scroll all the way down and select "Add a new hardware device"
    Add a new hardware device

  7. You will be asked whether Windows should search for the new hardware. Select "Install the hardware that I manually select from a list"
  8. A list of hardware categories will be shown. Select "Show All Devices" (On some versions of Windows this may be called "Other")
  9. Click the "Have Disk" button and point Windows to the "win\driver" directory of the Portal distribution (if you downloaded the distribution, the full path you specify will vary depending on where you extracted the files.)
    Have Disk
     
    Install From Disk

  10. A list of drivers found in the directory you specified will be shown. Select the "Portal I/O Cards" item and click Next.
    Select the device driver

  11. Click Next again to "start installing your new hardware."
  12. The files will be copied and installed. Click Finish to complete. You do not need to restart your computer.

Windows 2000

  1. Open the Control Panel.
  2. Open the "Add/Remove Hardware" wizard.
  3. The wizard typically displays a screen explaining what it is used for. Click Next to continue.
  4. You will be asked whether to Add or Uninstall a device. Select "Add/Troubleshoot a device" and click Next.
  5. The wizard may automatically scan for new hardware. The scanning will not detect any Portal I/O cards.
  6. You will be shown a list of the hardware already installed in your computer. Select "Add a new device" and click Next.
  7. You will be asked whether Windows should search for the new hardware. Select "No, I want to select the hardware from a list"
  8. A list of hardware categories will be shown. Select "Other devices"
  9. Click the "Have Disk" button and point Windows to the "win\driver" directory of the Portal distribution.
  10. A list of drivers found in the directory you specified will be shown. Select the "Portal I/O Cards" item and click Next.
  11. You will be informed that "Windows will use default settings to install the software for this hardware device." Simply click Next to begin installation.
  12. The files will be copied and installed. Click Finish to complete. You do not need to restart your computer.

Windows Me

  1. Open the Control Panel.
  2. Open the "Add New Hardware" wizard. (You may have to click "view all Control Panel options" for this to be displayed.)
  3. The wizard typically displays a screen explaining what it is used for. Click Next to continue.
  4. You will be told that the wizard will scan for new Plug and Play devices. Click Next to continue. The scan will not find any Portal I/O cards. If the wizard displays a list of devices that were found, select "No, the device isn't in the list".
  5. You will be asked if Windows should search for non Plug and Play hardware. Select "No, I want to select the hardware from a list".
  6. A list of hardware categories will be shown. Select "Other devices" and click Next.
  7. Click the "Have Disk" button and point Windows to the "win\driver" directory of the Portal distribution.
  8. A list of drivers found in the directory you specified will be shown. Select the "Portal I/O Cards" item and click Next.
  9. One last page will be shown stating "Windows can continue installing your hardware now." Simply click Finish to perform the installation. You do not need to restart your computer.

Windows 98

  1. Open the Control Panel.
  2. Open the "Add New Hardware" wizard.
  3. The wizard typically displays a screen explaining what it is used for. Click Next to continue.
  4. You will be told that the wizard will scan for new Plug and Play devices. Click Next to continue. The scan will not find any Portal I/O cards. If the wizard displays a list of devices that were found, select "No, the device isn't in the list".
  5. You will be asked if Windows should search for non Plug and Play hardware. Select "No, I want to select the hardware from a list".
  6. A list of hardware categories will be shown. Select "Other devices" and click Next.
  7. Click the "Have Disk" button and point Windows to the "win\driver" directory of the Portal distribution.
  8. A list of drivers found in the directory you specified will be shown. Select the "Portal I/O Cards" item and click Next.
  9. One last page will be shown stating "Windows can continue installing your hardware now." Simply click Finish to perform the installation. You do not need to restart your computer.

Windows 95

  1. Open the Control Panel
  2. Open the "Add New Hardware" wizard
  3. The wizard typically displays a screen explaining what it is used for. Click Next to continue.
  4. You will be asked if Windows should search for your new hardware. Select "No".
  5. A list of hardware categories will be shown. Select "Other devices"
  6. Click the "Have Disk" button and point Windows to the "win\driver" directory of the Portal distribution.
  7. A list of drivers found in the directory you specified will be shown. Select the "Portal I/O Cards" item and click Next.
  8. One last page will be shown stating "Windows can continue installing your hardware now." Simply click Finish to perform the installation. You do not need to restart your computer.

Windows NT

  1. Run the NTinstall.exe program, located in the "win\driver" directory
  2. A message box will be shown explaining that the driver will be installed. Click Yes to continue.
  3. A message box will be shown confirming that the driver was installed. Click OK to complete. You do not need to restart your computer.

Removal

On all Windows operating systems except Windows NT, the driver is displayed in the system Device Manager / Device Tree (along with your Serial Ports, Sound Cards, etc.). The driver will be shown under the category of "Winford Engineering I/O Devices". The driver can be uninstalled right from the device tree, typically by selecting the driver and hitting the Delete key or by right-clicking and selecting Uninstall. On Windows NT, use the NTuninstall.exe program in the "win\driver" directory to uninstall the driver service.

Linux

The Linux version of the Portal API uses the device file /dev/port to perform port I/O and communicate with the I/O cards. Therefore, no driver installation is necessary. The only thing you must do is ensure that your applications are executed with root-level privileges. This is due to the fact that port I/O is a privileged operation and is not available to non-root users. Other than that, just be sure to link your program with wecrd.a as described in the programming language help page.


Copyright 2004 Winford Engineering.