                   Ŀ
                    COM-Watch 2000 PC Card Tester 
                   

Goal


This utility is used to test PCMCIA compatibility for COM-Watch 2000. It
registers as a client for Socket and Card Services and allocates the
card(s) resources. After the tests, PCCTEST de-allocates its resources,
de-registers the client and removes from memory.

THIS UTILITY IS NOT PART OF ANY COM-WATCH PRODUCT. IT IS PROVIDED AS-IS;
YOU CANNOT CLAIM RIGHTS OR WARRANTY OF ANY KIND ON ITS PROPER OPERATION.

NOTE  This utility can only configure the PC Cards shipped with the
----  RS-232c and RS-422/RS-485 portable options.

Syntax


COM-Watch 2000 PC Card driver test V1.1 (c) 1999 CER International bv

Usage: PCCTEST [-s:n] [-v] [-t] [-d] [-c]

-s:n specify socket n (between 0 and 3); default is all (-1)
-v   show verbose information
-t   extend time-out while registering client
-d   shell to DOS when card is configured
-c   continue testing after non-fatal errors
-?   shows this help

TIP: The output can be written to a file using the usual DOS redirection.
     Example: "PCCTEST -v > file.out" to write the output to FILE.OUT


Usage


-s:n Specify socket

     By default PCCTEST checks all available sockets for PC Cards. You
     can restrict testing to one specific socket by using the "-s"
     parameter. Note that PCCTEST calls the first socket "0", not "1" as
     you might have expected.

     Example: "PCCTEST -s:0" to test socket 0 only

-v   Show verbose information

     To reduce screen output, some information is suppressed during
     normal operation. If you want to see all information, add parameter
     "-v" to the command line. Amongst others, this will show full
     resource allocation details which is very useful if you experience
     errors [12] or [13].

     Example: "PCCTEST -v" to show verbose information

-t   Extend time-out while registering client

     Normally, PCCTEST registers the client taking a time-out of 100ms
     into account. If you experience time-out error [19], you can use
     the "-t" switch to extend the delay to 1 second.

     Example: "PCCTEST -t" to extend the time-out to 1 second

-d   Shell to DOS when card is configured

     After registration, allocation and configuration of the PC Card,
     PCCTEST automatically de-allocates the resources and removes itself
     from memory. This is okay for its test purposes, but in certain
     situations you may want test the PC Cards in configured state. By
     adding the "-d" command line switch, PCCTEST shells to DOS when the
     PC Card(s) is/are configured. When you type EXIT, PCCTEST resumes
     and de-allocates the resources and removes itself from memory.

     Example: "PCCTEST -d" to spawn DOS when card(s) is/are configured

-c   Continue testing after non-fatal errors

     Typically, PCCTEST will stop its test process when it encounters an
     error. You can manually force PCCTEST to continue running by adding
     the "-c" switch. Note that fatal errors will still cause PCCTEST to
     quit.

     Example: "PCCTEST -c" to continue testing after an error

Troubleshooting


[01] Socket nn is not available

     You indicated a specific socket number as parameter but this socket
     is not available on your system. Note that PCCTEST calls the first
     slot, socket 0 (not 1 as you might expect).

[02] CardServices not available

     In order to access the PC Card (aka PCMCIA) in your system, you
     need to load PCMCIA Socket- and CardServices drivers. This error
     messages appears when these drivers are not found on your machine.
     Read "Installing PCMCIA Socket and Card Services" for details.

[03] Failed to determine CardServices information
[04] Failed to determine CardServices vendor information

     The Card Services drivers in your system appear not to comply with
     the PCMCIA specifications. Please install fully compliant drivers.

[05] CS publication version must be 2.10 or higher

     COM-Watch 2000 PCMCIA support require Card Services compliant to
     PCMCIA publication level V2.1 or later. Please update your drivers.

[06] Failed to register as a client enabler

     Possibly the Card Services is locked by another client or is out of
     handles. Unload other clients/enablers and try again.

[07] Card nn has one or more broken tuples

     This error indicate that the PC Cards internal information tables
     cannot be read, or are corrupt. PCCTEST can't continue its tests.

     Reread the information under "Installing PCMCIA Socket and Card
     Services" and check if the resource manager is loaded and that the
     memory manager is configured correctly to exclude

     When these are verified to be correct and this message still
     occurs, either the Card Services driver does not comply with the
     PCMCIA specification or the PC Card is broken.

[08] Card nn doesn't return first configuration tuple
[09] Card nn doesn't return next configuration tuple

     These errors indicate that either the PC Card has corrupt internal
     information tables or the Card Services does not comply with the
     PCMCIA specifications.

[10] Card nn does not have serial ports

     A card is detected but it does not provide serial ports. PCCTEST
     can only perform tests on the PC Card(s) supported by COM-Watch
     2000 RS-232c and RS-422/RS-485 options.

[11] Card nn is configured by another client at I/O nnn/nnn, IRQ nn

     A card is found but it appears to be configured by an another
     client/enabler. Possibly the Card Services configurator or
     operating system allocated the card. PCCTEST can not perform
     further tests.

     Note that COM-Watch 2000 can use this card at the given I/O address
     and IRQ line but you cannot modify these properties from within the
     application. It is recommended to let COM-Watch 2000 configure the
     card, so unload or remove the 3rd party client/enabler.

[12] No free I/O port address ranges found

     All I/O port address combinations supported by the PC Card are
     either in use or excluded from the resource list. Run PCCTEST with
     the -v [verbose] switch to determine the exact addresses. Read
     "Resource allocation" for details.

[13] No free IRQ lines found

     All IRQ lines supported by the PC Card are either in use or
     excluded from the resource list. Run PCCTEST with the -v [verbose]
     switch to determine the exact addresses. Read "Resource allocation"
     for details.

[14] Error configuring I/O!
[15] Error configuring IRQ!
[16] Error requesting configuration!

     An error occurred while requesting previously available resources.
     Please reboot your system and try again. If one of these errors
     persist, the Card Services allocator appears not to comply with the
     PCMCIA specifications.

[17] No card inserted in socket nn

     You indicated a specific socket number as parameter but this socket
     does not hold a (valid) PC Card. Note that PCCTEST calls the first
     slot, socket 0 (not 1 as you might expect). To test COM-Watch 2000
     PCMCIA compatibility, you should insert a PC Card in the socket.

[18] No card(s) inserted

     None of the available sockets hold a (valid) PC Card. To fully test
     COM-Watch 2000 PCMCIA compatibility you should insert a PC Card.
     When this error occurs when a PC Card is inserted, the Card
     Services appear not to comply with PCMCIA specifications.

[19] Client with handle nnnn not registered properly

     PCCTEST failed to register as a client/enabler when the callback
     process timed out. The Card Services driver appears not to be
     compatible with COM-Watch 2000 PCMCIA support. Run PCCTEST with the
     -t [time-out] switch to test callback delay.


Release history


1.1 Fixed bug when configuring I/O address range
    Changed several messages

1.0 Initial release

// end of document
