CHAPTER 33

SunButtons Test (sunbuttons)

---

The sunbuttons test verifies that the SunButtons graphics manipulation device is working correctly.

---

Note - Install SunVTS2.1 making sure that the following packages are installed: SUNWdial and SUNWdialh.

---

---

Running the sunbuttons Tests

The following tests verify SunButton functionality:

From a .customtest file in /opt/SUNWvts/bin

Create a .customtest file to verify that each button functions; each button lights up in a round-robin fashion.

Edit the .customtest file to include the following lines:

sunbuttons;sunbuttons; Mode<CYCLE|diag|diag|mode> sundials;sundials; Mode<CYCLE|diag|diag|mode> (For diag mode you may have to execute the xhost + command)

Configure the Port using the bdconfig command

To configure the port, follow the steps below.

1. Run the /usr/sbin/bdconfig command to configure the /dev/term/a or /dev/term/b port and enable it. The following example shows how to check a configured serial port b:

# ls -l /dev/bd* lrwxrwxrwx 1 root other 11 Nov 12 15:39 /dev/bd -> /dev/term/b #

2. Connect the sunbuttons/sundials device to your configured serial port (a or b).

Starting SunVTS

After starting SunVTS, you should see Customtest as one of the available options with sundials and sunbuttons available for selection.

1. Change to the Functional test mode and enable intervention.

2. Enable the sunbuttons and sundials tests.

3. Start testing.

   In diag mode a popup window appears.

4. Select the Diagnostics button.

   Let the test run its course (the Diagnostics button will be selectable again).

5. Quit the popup window.

   The test should register a single pass.

From a shell command line

This is an interactive test. The test displays a screen representation of the buttonbox (see FIGURE 33-1) where you can press each of the buttons and see the corresponding button's display change.

To run the diagnostic test, select the Diagnostics Button on the top of the menu representation. The buttonbox buttons on the screen do not change while the diagnostics test is running.

Be sure that the buttonbox is connected to one of the serial ports, and that the buttonbox has a power transformer.

There is no option menu for this test.

FIGURE 33-1 sunbuttons

---

sunbuttons Command Line Syntax

/opt/SUNWvts/bin/sunbuttons diag standard_arguments

---

sunbuttons Test Modes

Available only in the Functional test mode. In the Functional test mode, the sunbuttons test verifies the functionality of each button, and that each button lights up in sequence.

---

sunbuttons Error Messages

TABLE 33-1 sunbuttons

	Error Message	Probable Cause(s)	Recommended Action
6000	Cannot open device
6001	ioctl(VUIDSFORMAT, VUID_NATIVE)
6002	Writing diag command failed
6003	No response from Buttonbox
6004	Selftest failed
6005	Weird unknown kind of error
6006	Can not open device /dev/db
6007	ioctl(VUIDSFORMAT, VUID_NATIVE) -- you may need to run bdconfig