Introduction
------------

This brief tutorial is to help Irman users to set up your remote.

The Irman (www.evation.com) is not a remote itself but rather a infrared
receiver, so it is impossible to bring you a pre-configured pair of
configuration files since every user could use a different remote.

You may use any lircrc.xxxxx present in /src/movix/remotes,
but you need build your own lircd.conf file, which is "remote dependent"

This tutorial will guide you through the entire process, which needs 
4 steps. I tried to make it as easy as I could, so that even a window$ user
(like me!) could understand it. :)

1.- Add your remote to remotes.data file
----------------------------------------

To make new remotes work with MoviX, a line must be added to the
src/movix/remotes.data listing the model, the driver name, the device
that lircd uses with it and the kernel modules needed to be loaded.

In the Irman case you need to add the next line to remotes.data:

irman irman /dev/ttyS0 serial

Replace above in accordance with your configuration:
ttyS0 = COM1
ttyS1 = COM2

2.- Train Lirc to recognize YOUR remote.
-----------------------------------------

This is the hard part. You need to generate a valid lircd.conf file
for your remote. Briefly this file contains several features of your
remote (gap, min_repeat,toggle_bit, etc) and MAINLY assign names
to keys of your remote. This names are used afterward in the other
config file "lircrc" to control the differents programs.

To train Lirc you need to boot with the MoviX CD.
Then, go to the console (Alt+F3) and type at the prompt:

irrecord -H irman -d /dev/ttyS0 lircd

once again replace above in accordance with your configuration
(ttyS0=COM1;ttyS1=COM2)

If you receive a error message tell you what lircd is running,
kill it, typing this at the prompt:

killall lircd

Follow the indications of irrecord until the program asking you for
a name for a button.
Here you enter a name (example: play, stop... etc) and then press this
button on your remote.
You could define any name you like, but I suggest define at least this
names:

Rewind
Forward
Vol+
Vol-
Mute
Ch+
Ch-
Ok
Exit
Power
Stop
Pause
0
1
2
3
4
5
6
7
8
9

If your remote has "cursor keys" you could define also:

Up
Down
Right
Left

Try to define so many key names as you could, because you could use
them in a future.

When you finish press ENTER to end the key names part, and again
follow the indications of irrecord to the end.

Well... you have now a file named lircd in the movix directory,
but remember that this directory (and all your files) ARE IN RAM, 
so you need to copy this file to a physical media as a diskette 
or a hard disk partition.
To do a diskete copy, insert a diskette and type at the prompt:

mount /dev/fd0 /dev/floppy

and next:

cp lircd /dev/floppy/lircd.conf.irman

Now you can leave MoviX.

3.- Add your Irman configuration files to the /src/remotes
---------------------------------------------------------

Now in the OS of your choice (Window$ or Linux) you need to copy the file
generated earlier from the diskette (or hard disk partition) to the
/src/movix/remotes directory.
Make sure than this file is named: lircd.conf.irman
If you followed my advice and named the keys as I suggested, then you
can use the file named lircrc.irman with these functions

## MPlayer Keys
##########################

Rewind Rewind
Forward Forward
Vol+ Volume Up
Vol- Volume Down
Mute Mute
Ch+ Menu Up
Ch- Menu Down
Ok Menu Ok
Exit Menu Cancel
1 Contrast Minus
3 Contrast Plus
4 Brightness Minus
6 Brightness Plus
7 Subtitles Position Minus
9 Subtitles Position Plus
Power Quit
Play Play
Stop Stop
Pause Pause

## fbi keys (Picture Viewer)
###########################

Ch+ Previous Image
Ch- Next Image
Rewind Previous Image
Forward Next Image
Exit Quit
Vol+ Zoom In
Vol- Zoom Out
Play Pause
Pause Pause
Stop Quit
Power Quit

## MoviX menu keys
###########################

Vol+ Right
Vol- Down
Ch- Down
Ch+ Up
Ok Return
Play Return
Pause Tab
Power Escape

If you name the keys other way, well... you need to build your own
lircrc.irman . Look at the others lircrc.xxxxx has examples.
The functions of the keys are almost self-explicatory.
You could also append functions if you like. In this form:

begin
prog = ... # Name of the program: mplayer, fbi (picture viewer)
# or irpty (Movix Menu)
button= ... # The name you define in lircd.conf
config= ... # The command for the program.
repeat= ... # 0 = no repeat 1 = repeat (to repeat the function of
end # the button holding it pressed. (Volume is repeat=1)

Consult the mplayer docs to find functions to add to your remote.
I find useful define two keys to control the audio delay, this way:

begin
button = name_button_delay_more
prog = mplayer
config = audio_delay 0.100
repeat = 1
end

begin
button = name_button_delay_minus
prog = mplayer
config = audio_delay -0.100
repeat = 1
end


4.- Define your remote in bootrc, generate and burn the iso.
--------------------------------------------------

Now with your lircrc.irman and lircd.conf.irman in /src/movix/remotes
the only thing left is to define your remote in bootrc file in /src/movix.
You need to add this line at bootrc file:

REMOTE=irman

Now generate the iso image as usual (read the MoviX docs) and burn it.

Boot with the new MoviX CD and enjoy the beauty of Movix without move
yourself of your favorite couch. :)