CHAPTER 9

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

TABLE 9-1 ecpptest

Subtest	Description
Internal Test FIFO Loopback	Verifies DMA and PIO accesses to the ecpp device. It uses 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 that is 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 (for example, ECP and Centronics) 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 9-1 ecpptest

TABLE 9-2 ecpptest

ecpptest Options	Description
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

TABLE 9-3 ecpptest

Test Mode	Description
Connection Test	Opens and closes the ecpp(7) device. 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
Functional Test	Runs the internal loopback test and the user can optionally run the External loopback test and Printer test. The test will fail if the device is busy If you invoke SunVTS through SyMON, the following Functional Test description applies: Runs the internal loopback test. If the device cannot be opened because it is busy, then it is assumed that the device is successfully connected to another process

ecpptest Command Line Syntax

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

TABLE 9-4 ecpptest

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

TABLE 9-5

	Error Message	Probable Cause(s)	Recommended Action
8000	External loop test and printer test cannot be enabled at the same time	Operator error.	Examine system message files (/var/adm/messages) for other information.
8001	device_name: Device does not exist or is otherwise inaccessible	Correct ecpp driver not installed.	Examine system message files (/var/adm/messages) for other information.
		Faulty ecpp device or motherboard hardware.
		System software problem.
8002	Must be super user (root) to execute	Operator error.	Examine system message files (/var/adm/messages) for other information.
8003	Failed to open device_name (error_message)	Correct ecpp driver not installed.	Examine system message files (/var/adm/messages) for other information.
		Faulty ecpp device or motherboard hardware.
		System software problem.
8004	Failed ioctl name, device = device_name, error = error_message	Correct ecpp driver is not installed.	Examine system message files (/var/adm/messages) for other information.
		Faulty ecpp device or motherboard hardware.
		System software problem.
8005	Device not in correct mode, device = device_name, expected	Correct ecpp driver is not installed.	Examine system message files (/var/adm/messages) for other information.
	mode = number, observed mode = number	Faulty ecpp device or motherboard hardware.
		System software problem.

TABLE 9-5 (Continued)

	Error Message	Probable Cause(s)	Recommended Action
8006	device_name: Status line miscompare, expected = number, observed =	Faulty or missing external loopback connector.	Examine system message files (/var/adm/messages) for other information.
	number, xor = number	Correct ecpp driver is not installed.
		Faulty ecpp device or motherboard hardware.
		System software problem.
8007	ECPP_nACK in wrong state, expected = number, observed =	Faulty or missing external loopback connector.	Examine system message files (/var/adm/messages) for other information.
	number, xor = number	Correct ecpp driver not installed.
		Faulty ecpp device or motherboard hardware.
		System software problem.
8008	subtest_name: Data miscompare, expected = number, observed =	Faulty or missing external loopback connector.	Examine system message files (/var/adm/messages) for other information.
	number, xor = number	Correct ecpp driver not installed.
		Faulty ecpp device or motherboard hardware.
		System software problem.
8009	Could not set correct port type, expected = number (device_name),	Correct ecpp driver not installed.	Examine system message files (/var/adm/messages) for other information.
	observed = number, device = device_name	System software problem.
		Faulty ecpp device or motherboard hardware.

TABLE 9-5 (Continued)

	Error Message	Probable Cause(s)	Recommended Action
8010	subtest_name: Failed to allocate number bytes of memory, error =	System resources temporarily not available, try again.	Examine system message files (/var/adm/messages) for other information.
	error_message	Correct ecpp driver not installed.
		Faulty ecpp device or motherboard hardware.
		System software problem.
8011	subtest_name: Write() failed, device = device_name, error =	Correct ecpp driver not installed.	Examine system message files (/var/adm/messages) for other information.
	error_message	Faulty ecpp device or motherboard hardware.
		System software problem.
8012	subtest_name: Write count is wrong, expected = number, observed =	Correct ecpp driver is not installed.	Examine system message files (/var/adm/messages) for other information.
	number	Faulty ecpp device or motherboard hardware.
		System software problem.
8013	subtest_name: Data miscompare, expected = number, observed =	Correct ecpp driver not installed	Examine system message files (/var/adm/messages) for other information.
	number, xor = number, offset = number	Faulty ecpp device or motherboard hardware.
		System software problem.
8014	device_name: Device busy	Another process is using the device.	Make sure no other process is using the device.
		Someone is printing with the device.	Make sure no one is printing to the device.
		Faulty ecpp device or motherboard hardware.	Examine system message files (/var/adm/messages) for other information.
		System software problem.
8015	Bad state for device name, expected mode = number, observed mode = number

TABLE 9-5 (Continued)

	Error Message	Probable Cause(s)	Recommended Action
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