Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

x_dialtest(6) [osx man page]

x_dialtest(6)							  Games and Demos						     x_dialtest(6)

NAME
x_dialtest - Xview demonstration and test program for SunDials SYNOPSIS
/usr/demo/DIALBOX/x_dialtest DESCRIPTION
x_dialtest is an Xview application that displays a window with eight dials, corresponding to the dials on the SunDials dialbox. To deter- mine if the dialbox has been set up correctly, turn a dial on the dialbox. If the dialbox is functional and correctly interfaced, turning a dial by hand will make the corresponding dial in the window turn a similar amount. The dials do not have any notion of absolute angular position. It is changes in current angular position that are sent to the host applica- tion. Thus there is no notion of resetting the position of the dials on the dialbox hardware. The Diagnostic button on the panel is a demo mode of the x_dialtest program. The pointer of each of the dials in the window is rotated one full circle and then disappears in turn. When all eight dials have been rotated, the display dial pointers are reset to their previous rotational positions. The only diagnostic done on the dialbox is a firmware self check. If this self check passes, then "OK." is sent to the standard output of the demo program. The Ram Dump button on the panel arranges to place some firmware data into the file ram_dump.dat in the current directory. It is intended for factory diagnostics use and is not publicly documented further. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Architecture |SPARC | +-----------------------------+-----------------------------+ SEE ALSO
bdconfig(1M), attributes(5), x_buttontest(6), bd(7M), streamio(7I) SunOS 5.10 1 Jan 1997 x_dialtest(6)

Check Out this Related Man Page

bd(7M)								  STREAMS Modules							    bd(7M)

NAME
bd - SunButtons and SunDials STREAMS module SYNOPSIS
open("/dev/bd", O_RDWR) DESCRIPTION
The bd STREAMS module processes the byte streams generated by the SunButtons buttonbox and SunDials dialbox. The buttonbox generates a stream of bytes that encode the identity and state transition of the buttons. The dialbox generates a stream of bytes that encode the iden- tity of the dials and the amount by which they are turned. Both of these streams are merged together when a host has both a buttonbox and a dialbox in use at the same time. SunButtons reports the button number and up/down status encoded into a one byte message. Byte values from 0xc0 to 0xdf indicate a transi- tion to button down. To obtain the button number, subtract 0xc0 from the byte value. Byte values from 0xe0 to 0xff indicate a transition to button up. To obtain the button number, subtract 0xe0 from the byte value. Each dial sample in the byte stream consists of three bytes. The first byte identifies which dial was turned and the next two bytes return the delta in signed binary format. When bound to an application using the window system, Virtual User Input Device ("VUID") events are generated. An event from a dial is constrained to lie between 0x80 and 0x87. A stream with the bd pushed streams module configured in it can emit firm_events as specified by the protocol of a VUID. bd understands the VUIDSFORMAT and VUIDGFORMAT ioctls (see reference below), as defined in /usr/include/sys/bdio.h and $OPENWIN- HOME/include/xview/win_event.h. All other ioctl() requests are passed downstream. The bd streams module sets the parameters of the serial port when it is first opened. No termio(7I) ioctl () requests should be performed on a bd STREAMS module, as bd expects the device parameters to remain as it set them. IOCTLS
VUIDSFORMAT These are standard VUID ioctls. VUIDGFORMAT BDIOBUTLITE The bd streams module implements this ioctl to enable processes to manipulate the lights on the buttonbox. The BDIOBUTLITE ioctl must be carried by an I_STR ioctl to the bd module. For an explanation of I_STR see streamio(7I). The data for the BDIOBUTLITE ioctl is an unsigned integer in which each bit represents the lamp on one button. The macro LED_MAP in <sys/bdio.h> maps button numbers to appropriate bits. Source code for the demo program x_buttontest is provided with the buttons and dials package, and may be found in the directory /usr/demo/BUTTONBOX. Look at x_buttontest.c for an example of how to manipulate the lights on the buttonbox. FILES
/usr/include/sys/bdio.h /usr/include/sys/stropts.h $OPENWINHOME/share/include/xview/win_event.h SEE ALSO
bdconfig(1M), ioctl(2), x_buttontest(6), x_dialtest(6), streamio(7I), termio(7I) SunButtons Installation and Programmers Guide SunDials Installation and Programmers Guide WARNINGS
The SunDials dial box must be used with a serial port. SunOS 5.10 19 Feb 1992 bd(7M)
Man Page