Lines Matching +full:device +full:- +full:level
3 .\" Kazutaka YOKOTA <yokota@zodiac.mech.utsunomiya-u.ac.jp>
32 .Nd PS/2 mouse style pointing device driver
38 .Cd "device psm"
41 .Pa /boot/device.hints :
47 driver provides support for the PS/2 mouse style pointing device.
50 device node in the system.
60 Basic PS/2 style pointing device has two or three buttons.
62 .Ss Device Resolution
63 The PS/2 style pointing device usually has several grades of resolution,
82 Frequency, or report rate, at which the device sends movement
84 The PS/2 style pointing device typically supports 10, 20, 40, 60, 80, 100
88 the device will not send anything to the host system.
94 The current operation level can be set via an ioctl call.
96 At the level zero the basic support is provided; the device driver will report
97 horizontal and vertical movement of the attached device
99 The movement and status are encoded in a series of fixed-length data packets
102 This is the default level of operation and the driver is initially
103 at this level when opened by the user program.
105 The operation level one, the `extended' level, supports a roller (or wheel),
108 8 byte data packets are sent to the user program at this level.
110 At the operation level two, data from the pointing device is passed to the
113 to the pointing device as is and the user program is responsible for
117 intimate knowledge about the format from a particular device when operating
118 the driver at this level.
119 This level is called `native' level.
123 driver are formatted differently at each operation level.
125 A data packet from the PS/2 mouse style pointing device
126 is three bytes long at the operation level zero:
128 .Bl -tag -width Byte_1 -compact
130 .Bl -tag -width bit_7 -compact
155 -256 through 255.
159 -256 through 255.
163 At the level one, a data packet is encoded
169 At the level two, native level, there is no standard on the size and format
174 driver can somewhat `accelerate' the movement of the pointing device.
175 The faster you move the device, the further the pointer
189 .Bl -tag -width MOUSE
193 driver will attempt to reset the pointing device during the boot process.
194 It sometimes takes a long while before the device will respond after
204 device, you may want to increase these values.
212 Sets the debug level to
214 The default debug level is zero.
224 .Pa /boot/device.hints
228 .Bl -tag -width MOUSE
230 This flag specifies the resolution of the pointing device.
233 is, the finer resolution the device will select.
235 of the device.
238 .Bl -tag -width 0_(medium_high)__ -compact
250 device (whatever it is).
266 If you think your pointing device is not functioning as expected,
268 .Bd -literal -offset indent
276 driver will not try to identify the model of the pointing device and
277 will not carry out model-specific initialization.
278 The device should always act like a standard PS/2 mouse without such
287 driver will not reset the pointing device when initializing the device.
291 is started after another OS has run, the pointing device will inherit
295 driver to know the settings, the device and the driver may not
300 when the user `taps' the surface of the device (see
304 driver assume that the device behaves this way.
313 The built-in PS/2 pointing device of some laptop computers is somehow
318 stimulating the device by performing I/O will help
319 waking up the device quickly.
324 device.
329 driver to reset and re-initialize the pointing device
337 at boot-time.
348 at boot-time.
354 at boot-time.
367 at boot-time.
383 .Bl -tag -width MOUSE -compact
384 .It Dv MOUSE_GETLEVEL Ar int *level
385 .It Dv MOUSE_SETLEVEL Ar int *level
386 These commands manipulate the operation level of the
391 Returns the hardware information of the attached device in the following
393 .Bd -literal
405 field holds the number of buttons on the device.
422 tells the device type:
431 the device type.
437 at the operation level 0.
449 is the ID value returned by the device.
452 .Bl -tag -width 0__ -compact
463 Only available when a supported device has been detected.
464 .Bd -literal
495 .Bd -literal
498 int rate; /* report rate (per sec), -1 if unknown */
499 int resolution; /* MOUSE_RES_XXX, -1 if unknown */
501 int level; /* driver operation level */
511 at the operation level zero and two.
513 at the operation level one.
517 is the status report rate (reports/sec) at which the device will send
524 of the pointing device must be one of
534 .Bl -tag -width MOUSE_RES_MEDIUMHIGH__ -compact
557 operation level and the model of the pointing device.
559 .Bl -tag -width level_0__ -compact
560 .It Em level 0
562 .It Em level 1
564 .It Em level 2
565 Depends on the model of the device
587 .Dv level
594 If you do not want to change the current setting of a field, put -1
603 .\" The command reads the raw data from the device.
604 .\" .Bd -literal
617 .\" The command reads the hardware settings from the device.
624 .\" .Bl -tag -width Byte_1 -compact
626 .\" .Bl -tag -width bit_6 -compact
630 .\" 0 - stream mode, 1 - remote mode.
631 .\" In the stream mode, the pointing device sends the device status
636 .\" driver puts the device in the stream mode.
638 .\" Set if the pointing device is currently enabled. Otherwise zero.
640 .\" 0 - 1:1 scaling, 1 - 2:1 scaling.
652 .\" .Bl -tag -width bit_6_0 -compact
657 .\" the resolution code varies from one device to another.
660 .\" The status report rate (reports/sec) at which the device will send
673 .Bl -tag -width /dev/npsm0 -compact
675 `non-blocking' device node
677 `blocking' device node
684 .Dl "device atkbdc"
685 .Dl "device psm"
688 .Pa /boot/device.hints .
696 .Pa /boot/device.hints ,
700 you will add the optional code to stimulate the pointing device
705 The above line will set the device resolution high (4)
708 At debug level 0, little information is logged except for the following
710 .Bd -literal -offset indent
711 psm0: device ID X
716 the device ID code returned by the found pointing device.
721 At debug level 1 more information will be logged
723 Messages are logged with the LOG_KERN facility at the LOG_DEBUG level
726 .Bd -literal -offset indent
735 psm0: model AAAA, device ID X, N buttons
743 initialized the keyboard controller upon power-up.
750 The third through fifth lines show the reset status of the pointing device.
751 The functioning device should return the sequence of FA AA <ID>.
760 .Bl -tag -width Byte_1 -compact
762 .Bl -tag -width bit_6 -compact
766 0 - stream mode, 1 - remote mode.
767 In the stream mode, the pointing device sends the device status
773 driver puts the device in the stream mode.
775 Set if the pointing device is currently enabled.
778 0 - 1:1 scaling, 1 - 2:1 scaling.
790 .Bl -tag -width bit_6_0 -compact
796 the resolution code varies from one device to another.
799 The status report rate (reports/sec) at which the device will send
803 Note that the pointing device will not be enabled until the
807 The rest of the lines show the device ID code, the number of detected
810 At debug level 2, much more detailed information is logged.
825 .An -nosplit
861 There is not a guaranteed way to re-synchronize with the first byte