ACC SHELL

Path : /usr/share/doc/packages/gpm/
File Upload :
Current File : //usr/share/doc/packages/gpm/README.silitek

This README describes the support for the Silitek SM-1000 IR commander
(also called Netshooter).

This IR commander can be used with two types of mouse driver:

    * Type `silicom' supports the IR receiver which is shipped the
      SM-1000 and plugged into a serial connector.

    * Type `silips2' supports the IR receiver which is shipped
      with the Silitek IR keyboard SK-7100 (also called Airboard).
      The mouse connector of this IR receiver should be plugged
      into the PS/2 mouse connector (not to a serial connector).
      You may need an adapter (9 pin serial to PS/2) to do this.

Both types of mouse driver uses the system wide configuration file

      /etc/gpm/silitek.conf

which defines the return values of any key not being mouse button
or mouse stick.  For this keys the drag mouse button works as a
modifier: pressed once, the last column in /etc/gpm/silitek.conf
is used. To switch back to the normal return values, the drag mouse
button has to be pressed again.  It is allowed to use escaped
sequences as return values.  Characters other than printable can
be coded by using the backslash, e.g. `\033' for the octal number
of the special character ESC (Escape) of `\x0D' for the hexadecimal
number of the special character CR (Carriage Return), for more
codings see the manual page ascii(7).

The default key mapping for the SM-1000 IR commander is on the
virtual console is:

    SM-1000 Key  normal        drag active
    -------------------------------------
    key 1        1             1
    key 2        2             2
    key 3        3             3
    key 4        4             4
    key 5        5             5
    key 6        6             6
    key 7        7             7
    key 8        8             8
    key 9        9             9
    key 0        0             0
    key *        *             *
    key #        #             #
    key >        Ctrl Q        Ctrl Q
    key ||       Ctrl S        Ctrl S
    key []       Crtl C        Crtl C
    key >>|      End           End
    key |<<      Home          Home
    key Mute     Delete        Delete
    key Vol+     Cursor Up     Cursor Up
    key Vol-     Cursor Down   Cursor Down
    key Display  Insert        Insert
    key PgUp     Page Up       Page Up
    key PgDn     Page Down     Page Down
    key Back     Cursor Left   Cursor Left
    key Forward  Cursor Right  Cursor Right
    key CD       F1            F1
    key ShowWiz  F2            F2
    key WWW      F3            F3
    key Close    F4            F4

Usage with the IR receiver of the Silitek Keyboard SK-7100:

In comparison of the IR receiver of shipped with the SM-1000
this IR receiver has the advantage that both mouse interface
of the IR keyboard and the IR Netshooter can be used in parallel.
One advantage more is that only one IR receiver is required to
use both the IR keyboard and the IR Netshooter.  Next point is
that the IR receiver of the IR keyboard seems to more insensitive
for other IR commanders like those from TV sets.

The Multimedia keys of the IR keyboard SK-7100 can be configured
by using setkeycodes(8) and loadkeys(8) to be usable in parallel
to those of the IR commander SM-1000.

Notice: The key 7 of the IR commander SM-1000 generates the keyboard
scancode for KP_ENTER if the SK-7100 keyboard is used in parallel.
This happens even if the mouse type `silicom' is used in conjunction
with the IR receiver of the SM-1000. This because if both IR receiver
are used, the SM-1000 and the SK-7100, both receives signals from the
SM-1000.  Therefore this key should be disabled (note that the SK-7100
does not have a KP_ENTER):

--------------------------------------------------------------------
loadkeys <<-EOF
keycode  96 = F39
string  F39 = ""
EOF
--------------------------------------------------------------------

With `showkeys -s' on the virtual console and `xev' under X11 the
the other Multimedia keys of the SK-7100 causes the following
scancodes/keycodes:

     SK-7100 Key   console  X11
     --------------------------
     Close         e017     151
     CD            e025     165
     Video         e018     152
     WWW           e032     178
     U/P           e01e     158
     |<<           e010     144
     ||            e012     146
     >             e022     162
     []            e024     164
     >>|           e019     153
     Vol-          e02e     174
     Vol+          e030     176
     Mute          e020     160
     Display       e026     166

If we map for e.g. the keys

     Video      Switch to vc 8 where the Video Recoder Program runs (Console_8)
     |<<        Cursor Left (keycode 105)
     >>|        Cursor Right (keycode 106)
     Display    Win Menu key (keycode 127)

(Compares this with `dumpkeys | less' on a virtual console).

With the following command sequence (called in a script during boot):

--------------------------------------------------------------------
setkeycodes \
	e017	85  \
	e025	89  \
	e018	90  \
	e032	91  \
	e01e	92  \
	e010	105 \
	e012	94  \
	e022	95  \
	e024	120 \
	e019	106 \
	e02e	122 \
	e030	123 \
	e020	124 \
	e026	127
loadkeys <<-EOF
	keycode  85 = F50
	keycode  89 = F51
	keycode  90 = Console_8
	keycode  91 = F53
	keycode  92 = F54
	keycode  94 = F56
	keycode  95 = F57
	keycode 120 = F58
	keycode 122 = F60
	keycode 123 = F61
	keycode 124 = F62
	keycode 127 = F63
	keycode  96 = F39
	string  F50 = "\033[[Z"
	string  F51 = "\033[[Y"
	string  F53 = "\033[[W"
	string  F54 = "\033[[U"
	string  F56 = "\033[[H"
	string  F57 = "\033[[T"
	string  F58 = "\033[[F"
	string  F60 = "\033[[L"
	string  F61 = "\033[[M"
	string  F62 = "\033[[X"
	string  F63 = "\033[[R"
	string  F39 = ""
EOF
--------------------------------------------------------------------

the Multimedia keys on IR Keyboard SK-7100 are usable (for ncurses
based programs see below).  After editing /etc/gpm/silitek.conf
to get the similar named keys to work similar, both the IR Keyboard
SK-7100 and the IR commander SM-1000 are usable in parallel.

For ncurses based programs the added keys have to be extended
by dumping the current terminfo entry for the virtual consoles
for TERM=linux:

    infocmp -1 linux > linux.tic

and editing the file linux.tic which means adding the function
keys kf50, kf51, kf52, kf53, kf54, kf56, kf57, kf58, kf60, kf61,
kf62, kf63, and kf39.  After that the command

    tic linux.tic

installs the edited terminfo entry for TERM=linux.

ACC SHELL 2018