1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
|
README file for libirman v0.4.2
by Tom Wheeley <tomw@tsys.demon.co.uk>
E-mail before September 1999 is best sent to
<tom.wheeley@src.bae.co.uk>
Copyright and Licensing
libirman v0.4.2, Copyright (C) 1998,1999 Tom Wheeley <tomw@tsys.demon.co.uk>
The files which make up the library are covered under the GNU Library
General Public License, which is in the file COPYING.lib.
The files which make up the test programs and the documentation are covered
under the GNU General Public License, which is in the file COPYING.
Introduction
libirman is a library for accessing the IRMAN hardware from Linux
and other Unix systems.
Currently the package is mainly for advanced users and developers; this
does not mean that less experienced users will not be able to use it, but
that there are not a lot of applications for libirman at the moment, and
that if you run into problems you may have difficulty fixing things.
Read the file TECHNICAL to see how libirman works, and how to use it in your
applications.
Use with LIRC
For general applications programming, the preferred interface for infra-red
control is `lirc', as lirc supports multiple programs sharing the same
infra-red receiver. It does this by providing a socket based interface to
which several programs can connect.
lirc uses libirman to interface with the Irman hardware, so in single use
applications directly using libirman is simpler and uses less system
resources. Currently, lirc only works on Linux systems, so programs written
using libirman directly are more portable.
To use libirman v0.4.2 with lirc you will need v0.5.5 of lirc or greater.
Versions 0.4.1, 0.4.1a and 0.4.1b can be used with earlier versions of lirc.
The reason for this is that the Irman lirc driver daemon, lirmand, has been
moved from the libirman package to the lirc package, and the version
distributed with libirman 0.4.1 is not compatible with libirman v0.4.2.
Other Information
my homepage
http://www.tsys.demon.co.uk
libirman homepage
http://www.evation.com/libirman/
Irman hompage
http://www.evation.com/irman/
LIRC Corner
http://fsinfo.cs.uni-sb.de/~columbus/lirc/
Infra red remotes (technical information)
http://falcon.arts.cornell.edu/~dnegro/IR/IR.html
Universal Infra Red Receiver (build your own Irman)
http://www.geocities.com/SiliconValley/Sector/3863/infrared.html
Installation
To build libirman, run
./configure
make
make install
You may well like to check the available options to configure by typing
./configure --help
the most important are: --prefix and --with-swtest
This will create the following important files:
libirman.a The library which talks to the irman and manages the results
test_io Test program for the low level functions in libirman
test_func Test program for the mid-level functions in libirman
test_name test program for the name functions.
workmanir Program to control workman via infra red
By default they are installed in /usr/local. If you do not use the --prefix
option to `configure' then you will need to be root to run `make install'.
Using libirman
Firstly, you should test that the system works. Run `test_io' with the
hardware plugged in and see if code numbers appear on the screen when you
press buttons on your remote control.
Once the basic hardware works, you should run `test_func' to help you set up
libirman for your remote control. Make sure you have available virtual
consoles, or are running either `screen' or `X' or some other similar
multi-tasking aid.
The file `irman.conf' should be copied to /usr/local/etc/irman.conf. You may
want to copy this to `~/.irmanrc'. libirman searches first for ~/.irmanrc,
and if that is not found reads /usr/local/etc/irman.conf.
Press each button on your remote control, and note down the number printed -
you need to add a `bind' line to your irmanrc file, noting the naming
convention used:
bind manufacturer-device-button code
once you have entered in the data for your remote control, you should change
the workman-* alias lines to point to your remote control's entries.
You may also like to specify the default port in the config file.
Once you have entered in names into your irman config file, try running
`test_name' to see if the bindings have worked. (You should see the names
you gave on the `bind' lines appear as you press the buttons).
To see if `workmanir' works, make sure you are already running `workman', then
start `workmanir' and try pressing buttons. Make sure you have changed the
`alias' lines in your irman.conf.
Testing
If you want to test libirman without using the irman hardware, you can run:
`make swtest'
or
`./configure --with-swtest; make'
which will create libirman_sw.a and programs *_sw (except test_io). These
will ask you to enter a twelve digit hex code to represent a code instead of
querying the hardware.
If you compile libirman with the define -DDEBUG_COMM then every byte
read/written from the serial port is printed to stdout.
(to do this run: CPPFLAGS=-DDEBUG_COMM ./configure; make clean; make)
Credits
Thankyou to the following:
Christoph Bartelmus <columbus@hit.handshake.de>
maintainer of LIRC project.
Bill Ryder <bryder@sgi.com>
fix to make it work on SGI Indy's (and other Unix boxes)
MiniDisc, http://www.minidisc.org
for being just so damn cool.
|
