hil.7 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

hil(7) hil(7)

NAME

hil - HP-HIL device driver

SYNOPSIS

#include <sys/hilioctl.h>

DESCRIPTION

HP-HIL, the Hewlett-Packard Human Interface Link, is the Hewlett-Packard standard for interfacing a

personal computer, terminal, or workstation to its input devices.

hil supports devices such as key-

boards, mice, control knobs, ID modules, button boxes, digitizers, quadrature devices, bar code readers,

and touchscreens.

On systems with a single link, HP-HIL device ﬁle names use the following format:

/dev/hiln

where n represents a single digit that speciﬁes the physical HP-HIL device address, which ranges from 1

to 7. For example,

/dev/hil3

is used to access the third HP-HIL device.

On systems with more than one link, HP-HIL device ﬁle names use the following format:

/dev/hil_m.n

where m represents the instance number, and n represents the physical HP-HIL device address. For

example,

/dev/hil_0.2 would be used to access the second device on the link which has an instance

number of zero. Likewise, /dev/hil_12.7

references the seventh device on the link with instance

number twelve.

Note that HP-HIL device addresses are determined only by the order in which devices are attached to the

link. The ﬁrst device attached to the link becomes device one, the second device attached becomes device

two, etc.

HP-HIL devices are classiﬁed as "slow" devices. This means that system calls to

hil can be interrupted

by caught signals (see signal (5)).

hil can only read HP-HIL keyboards in raw keycode mode. Raw keycode mode means that all keyboard

input is read unﬁltered. HP-HIL keyboards return keycodes that represent key press and key release

events.

Use hilkbd (7) to read mapped keycodes from HP-HIL keyboards. Use the Internal Terminal Emulator

(

ITE) described in termio (7) to read ASCII characters from HP-HIL keyboards.

System Calls

open(2) gives exclusive access to the speciﬁed HP-HIL device. Any previously queued input from the dev-

ice is discarded. If the device is a keyboard, it is opened in raw keycode mode. A side effect of opening a

keyboard in raw keycode mode is that the ITE (see termio (7)) and mapped keyboard driver (see

hilkbd (7)) lose input from that keyboard until it is closed. Only device implemented auto-repeat func-

tionality is available while in raw keycode mode (see HILER1 and HILER2).

The ﬁle status ﬂag, O_NDELAY, can be set to enable non-blocking reads (see open (2)).

close (2) returns an HP-HIL keyboard to mapped keycode mode, making its input available to the ITE or

mapped keyboard driver (see hilkbd (7)).

read(2) returns data from the speciﬁed HP-HIL device, in time-stamped packets:

unsigned char packet_length;

unsigned char time_stamp[4];

unsigned char poll_record_header;

unsigned char data[ packet_length-6];

packet_length speciﬁes the number of bytes in the packet including itself, and can range from six to

twenty bytes. time_stamp , when re-packed into an integer, speciﬁes the time, in tens of milliseconds,

that the system has been running since the last system boot. The most signiﬁcant byte of the time stamp

is time_stamp [0]. poll_record_header indicates the type and quantity of information to follow, and

reports simple device status information. The number of data bytes is device dependent. Refer to the

text listed in SEE ALSO for descriptions of the poll_record_header and device-speciﬁc data.

Usually two system calls are required to read each data packet, the ﬁrst system call reads the data packet

length; the second system call reads the actual data packet. Some devices always return the same

amount of data in each packet, in which case the count and the packet can both be read in the same

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
hil(7) hil(7) NAME hil - HP-HIL device driver SYNOPSIS #include DESCRIPTION HP-HIL, the Hewlett-Packard Human Interface Link, is the Hewlett-Packard standard for interfacing a personal computer, terminal, or workstation to its input devices. hil supports devices such as keyboards, mice, control knobs, ID modules, button boxes, digitizers, quadrature devices, bar code readers, and touchscreens.
PAGE 2
hil(7) hil(7) system call. If the file status flag, O_NDELAY, is set and no data is available, read (2) returns 0 instead of blocking. write (2) is not supported by hil. select (2) can be used to poll for available input from HP-HIL devices. select (2) for write or for exception conditions always returns a false indication in the file descriptor bit masks. ioctl (2) is used to perform special operations on HP-HIL devices.
PAGE 3
hil(7) HILED hil(7) Extended Describe The Extended Describe request returns the Extended Describe Record in the character array to which arg points. The Extended Describe Record may contain up to fifteen bytes of additional device information. The first byte is the Extended Describe Header, which indicates whether a device supports the Report Status, Report Name, Read Register, or Write Register requests. If the device implements the Read Register request, the maximum readable register is specified.
PAGE 4
hil(7) hil(7) [EFAULT] A bad address was detected while attempting to use an argument to a system call. [EINTR] A signal interrupted an open (2), read (2), or ioctl (2) system call. [EINVAL] An invalid parameter was detected by ioctl (2). [ENXIO] No device is present at the specified address; see WARNINGS, below. [EIO] A hardware or software error occurred while executing an ioctl (2) system call. [ENODEV] write (2) is not implemented for HP-HIL devices.