ECP 1284 Parallel Port Printer Test (ecpptest)

The ecpptest verifies the functionality of the ecpp(7) IEEE 1284 parallel printer port device.

The ecpp(7) device is an exclusive use device. Only one application can interface with it at a time. This test is not scalable.

Printer Test Hardware and Software Requirements

The ecpp(7) driver is installed with the OS if the system being tested supports the ecpp(7) device. To run the optional printer subtest, a Centronics or ECP-mode printer must be attached to the printer port. To run the optional external loopback test, a passive loopback connector must be installed on the printer port.

---

Note - The external loopback test is intended for Sun internal manufacturing use only. It requires a custom loopback connector not available to an external customer.

---

ecpptest Subtests

Internal Test Fifo loopback This verifies DMA and PIO accesses to the ecpp device. It utilizes an internal test fifo on the ecpp device. There are no printer or loopback connectors required. This test is always executed.

External Passive Loopback This verifies the Parallel Port I/O connections to the back panel connector. This test requires a passive loopback connector (Sun part no. 270-2965-01). This test is disabled by default and must be manually enabled by the user.

---

Note - The external loopback test is intended for Sun internal manufacturing use only. It requires a custom loopback connector not available to an external customer.

---

Printer Test This verifies the parallel port printer operation. It will output a half page of ascii character data. The output mode (ECP, Centronics, etc.) is determined by whatever mode the printer and ecpp driver automatically negotiate. It will not change the current mode. The user must verify that data printed properly. This test is disabled by default and must be manually enabled by the user.

If this test passes successfully, you know that the SBus DMA circuitry, the printer, and the device driver are functioning properly.

ecpptest Options

Figure 8-1 ecpptest

• External Loopback enables or disables the external loopback test. This test requires a special loopback plug.
• Printer enables or disables the printer test. This test requires a printer to be attached to the parallel port.

ecpptest Test Modes

Connectivity Mode In connectivity mode, a simple open and close of the ecpp(7) device is done. No data is transferred. The test passes if the device can be open and closed successfully. The test also passes if the device cannot be opened because the device is busy with another process.

Online Mode In online mode, the internal loopback test is run. If the device cannot be opened because it is busy, then it is assumed that the device is successfully connected to another process.

Offline Mode In offline mode, the internal loopback test is run and the user can optionally run the External loopback test and Printer test. The test will fail if the device is busy.

ecpptest Command Line Syntax

/opt/SUNWvts/bin/ecpptest standard_arguments -o
[dev=device_name][,ext_loop=Enable|Disable][,printer=Enable|Disable]

Argument Explanation
dev=device_name	Specifies the name of the device. This should be of the form /dev/ecpp#, where # is the minor number of the device. The default device is /dec/ecpp0.
ext_loop=enable|disable	If enabled, the external loopback test is run. The External loopback plug must be attached to the printer port.
printer=enable|disable	If enabled, the printer test is run. A centronics or ECP mode parallel port printer must be attached

ecpptest Error Messages

The ecpptest error messages are listed below with explanations or probable cause.

8000 External loop test and printer test cannot be enabled
at the same time.

Probable_Cause(s):

a. Operator error

Recommended_Action(s):

a. Examine system message files (/var/adm/messages) for other information

8001 <device_name>: Device does not exist or is otherwise
inaccessible

Probable_Cause(s):

a. Correct ecpp driver not installed b. Faulty ecpp device or motherboard hardware

c. System software problem

Recommended_Action(s):

a. Examine system message files (/var/adm/messages) for other information

8002 Must be super user (root) to execute

Probable_Cause(s):

a. Operator error

Recommended_Action(s):

a. Examine system message files (/var/adm/messages) for other information

8003 Failed to open <device_name> (<error_message>)

Probable_Cause(s):

a. Correct ecpp driver not installed b. Faulty ecpp device or motherboard hardware

c. System software problem

Recommended_Action(s):

a. Examine system message files (/var/adm/messages) for other information

8004 Failed ioctl <name>, device = <device_name>, error =
<error_message>

Probable_Cause(s):

a. Correct ecpp driver not installed b. Faulty ecpp device or motherboard hardware

c. System software problem

Recommended_Action(s):

a. Examine system message files (/var/adm/messages) for other information

8005 Device not in correct mode, device = <device_name>,
expected mode = <number>, observed mode = <number>

Probable_Cause(s):

a. Correct ecpp driver not installed b. Faulty ecpp device or motherboard hardware

c. System software problem

Recommended_Action(s):

a. Examine system message files (/var/adm/messages) for other information

8006 <device_name>: Status line miscompare, expected =
<number>, observed = <number>, xor = <number>

Probable_Cause(s):

a. Faulty or missing external loopback connector b. Correct ecpp driver not installed

c. Faulty ecpp device or motherboard hardware d. System software problem

Recommended_Action(s):

a. Examine system message files (/var/adm/messages) for other information

8007 ECPP_nACK in wrong state, expected = <number>,
observed = <number>, xor = <number>

Probable_Cause(s):

a. Faulty or missing external loopback connector b. Correct ecpp driver not installed

c. Faulty ecpp device or motherboard hardware d. System software problem

Recommended_Action(s):

a. Examine system message files (/var/adm/messages) for other information

8008 <subtest_name>: Data miscompare, expected = <number>,
observed = <number>, xor = <number>

Probable_Cause(s):

a. Faulty or missing external loopback connector b. Correct ecpp driver not installed

c. Faulty ecpp device or motherboard hardware d. System software problem

Recommended_Action(s):

a. Examine system message files (/var/adm/messages) for other information

8009 Could not set correct port type, expected = <number>
(<device_name>), observed = <number>, device =
<device_name>

Probable_Cause(s):

a. Correct ecpp driver not installed b. System software problem

c. Faulty ecpp device or motherboard hardware

Recommended_Action(s):

a. Examine system message files (/var/adm/messages) for other information

8010 <subtest_name>: Failed to allocate <number> bytes of
memory, error = <error_message>

Probable_Cause(s):

a. System resources temporarily not available, try again b. Correct ecpp driver not installed

c. Faulty ecpp device or motherboard hardware d. System software problem

Recommended_Action(s):

a. Examine system message files (/var/adm/messages) for other information

8011 <subtest_name>: Write() failed, device =
<device_name>, error = <error_message>

Probable_Cause(s):

a. Correct ecpp driver not installed b. Faulty ecpp device or motherboard hardware

c. System software problem

Recommended_Action(s):

a. Examine system message files (/var/adm/messages) for other information

8012 <subtest_name>: Write count is wrong, expected =
<number>, observed = <number>

Probable_Cause(s):

a. Correct ecpp driver not installed b. Faulty ecpp device or motherboard hardware

c. System software problem

Recommended_Action(s):

a. Examine system message files (/var/adm/messages) for other information

8013 <subtest_name>: Data miscompare, expected = <number>,
observed = <number>, xor = <number>, offset = <number>

Probable_Cause(s):

a. Correct ecpp driver not installed b. Faulty ecpp device or motherboard hardware

c. System software problem

Recommended_Action(s):

a. Examine system message files (/var/adm/messages) for other information

8014 <device_name>: Device busy

Probable_Cause(s):

a. Another process is using the device b. Someone is printing with the device

c. Faulty ecpp device or motherboard hardware d. System software problem

Recommended_Action(s):

a. Make sure no other process is using the device b. Make sure no one is printing to the device

c. Examine system message files (/var/adm/messages) for other information

8015 Bad state for device <name>, expected mode = <number>,
observed mode = <number>.

8016 ecpp device busy: device <name>, expected mode =
<number>, observed mode = <number>.

8017 Paper out: device <name>, expected mode = <number>,
observed mode = <number>.

8018 Printer offline: device <name>, expected mode =
<number>, observed mode = <number>.

8019 Printer error: device <name>, expected mode =
<number>, observed mode = <number>.

8020 Printer unplugged: device <name>, expected mode =
<number>, observed mode = <number>.

8021 Unrecognized printer error: device <name>, expected
mode = <number>, observed mode = <number>.