48 - C H A P T E R -

C H A P T E R 48

Internal I2C Smartcard Reader Test (sc2test)

The sc2test verifies the proper functioning and integrity of the internal I2C Smartcard reader by testing the scmi2c(7d) driver.

sc2test Subtests

The sc2test consists of the following subtests:

Register subtests:

Register read subtest

The Register read subtest performs read access to selected scmi2c reader registers via ioctl().

Walking 1s subtest

The Walking 1s subtest performs walking 1s to selected scmi2c reader registers; registers under test are saved and restored.
AnswerToReset (ATR) subtest

The sc2test initializes the card reader. It will power manage and reset the card. After reset, the test attempts multiple tries to read the ATRs from the insertcard to verify against a list of recognized ATRs. The cards supported are the Cyberflex and Payflex cards.
APDU unique-ID subtest

Based on the result of the ATR, the Application Protocol Data Unit (APDU) uniqure-ID subtest exchanges selected ISO 7816 APDUs between the card and the reader to retreive the card's unique ID.

Caution - The sc2test cannot run when the ocfserv Smartcard server application is running, because the ocfserv will have exclusive open on /dev/scmi2c0. The sc2test detects the ocfserv process running and prompts the user to kill ocfserv. Also, the sc2test cannot run if any other third party Smartcard host application has exclusive open on /dev/scmi2c0 device.

Caution - The file /opt/SUNWvts/bin/sc2test.atr consists of an ATR list for the Cyberflex or Payflex cards supported. You can use an editor program to update the file to include the new ATR.

sc2test Options

To reach the dialog box below, right-click on the test name in the System Map and select Test Parameter Options. If you do not see this test in the System Map, you might need to expand the collapsed groups, or your system may not include the device appropriate to this test. Refer to the SunVTS User's Guide for more details.

FIGURE 48-1 sc2test Test Parameter Options Dialog Box

Screenshot of the sc2test Test Parameter Options dialog box.

TABLE 48-1 `sc2test` Options
`sc2test` Options	Description
Register Test	Enables or Disables the Register subtests; the default is Enable
AnswerToReset Test	Enables or Disables the AnswerToReset subtest; the default is Disable
APDU Test	Enables or Disables the APDU subtest; the default is Disable

sc2test Test Modes

TABLE 48-2 `sc2test` Supported Test Modes
Test Mode	Description
Connection	Performs the Register read and Walking 1s subtests
Functional (Offline)	Performs the Register subtests, AnswerToReset subtest, and the APDU unique-ID subtest

sc2test Command-Line Syntax

/opt/SUNWvts/bin/sc2test standard_arguments -o [
[ dev=device_logical_name ][ regs=enable|disable ][ atr=enable|disable ][ apdu=enable|disable ] ]

TABLE 48-3 `sc2test` Command-Line Syntax
Argument	Description
`dev=`device_name	`device_name` is the logical device name to be tested, for example, `dev=scmi2c0`
`reg=`enable\|disable	Enables or disables the Register tests; the default is enable
`atr=`enable\|disable	Enables or disables the ATR test; the default is disable
`apdu=`enable\|disable	Enables or disables the APDU unique-id test; the default is disable

Note - 64-bit tests are located in the sparcv9 subdirectory: /opt/SUNWvts/bin/sparcv9/testname. If a test is not present in this directory, then it may only be available as a 32-bit test. For more information refer to 32-Bit and 64-Bit Tests.