4 releases
0.1.3 | Apr 28, 2024 |
---|---|
0.1.2 | Feb 7, 2023 |
0.1.1 | Dec 10, 2022 |
0.1.0 | May 21, 2022 |
#1 in #infrared
300KB
7.5K
SLoC
cir - a new implementation of linux infrared tools
For Linux, there are tools to interact with any infrared hardware:
ir-ctl
and ir-keytable
. These tools can load simple infrared keymaps
and load decoders, and transmit simple IR. The IR decoders are hardcoded
and a small hardcoded set is included with the kernel.
There is also the lirc daemon and its tools, which supports many more IR
protocols but certainly not all.
This tool replaces all those tools, but with major new features:
- Pronto hex codes
- IRP support
- lircd.conf remote definition support
- daemon-less (using BPF)
Pronto hex codes are a fairly straightforward way of encoding raw IR, NEC, RC-5 and a few others.
IRP is a DSL language which can express any IR protocol. The aim is parse IRP and compile a decoder to BPF. So, any protocol can be supported directly.
Listing IR devices (cir config)
This is the cir equivalent of both ir-keytable
with no arguments and ir-ctl -f
.
$ cir config
rc0:
Device Name : Media Center Ed. eHome Infrared Remote Transceiver (1784:0008)
Driver : mceusb
Default Keymap : rc-rc6-mce
Input Device : /dev/input/event10
Bus : USB
Vendor/product : 1784:0008 version 0x0101
Repeat : delay 500 ms, period 125 ms
LIRC Device : /dev/lirc0
LIRC Receiver : raw receiver
LIRC Resolution : 50 microseconds
LIRC Timeout : 125000 microseconds
LIRC Timeout Range : 50 to 1250000 microseconds
LIRC Wideband Receiver : yes
LIRC Measure Carrier : yes
LIRC Transmitter : yes
LIRC Set Tx Carrier : yes
LIRC Set Tx Duty Cycle : no
LIRC Transmitters : 2
BPF protocols :
Supported Protocols : rc-5 nec rc-6 jvc sony rc-5-sz sanyo sharp mce_kbd xmp imon rc-mm
Enabled Protocols :
Transmit/Send (cir transmit)
If you have a .lircd.conf
file or .toml
keymap, you can send with the following
command:
cir transmit keymap foo.lircd.conf KEY_CHANNELUP
Alternatively, you can send raw IR directly like so:
cir transmit rawir '+9000 -4500 +560'
You can also files or linux kernel scancodes, exactly like the ir-ctl
tool. This supports
mode2 files or raw IR files.
cir transmit rawir -s input-file -S nec:0xcafe
You can send pronto codes:
cir transmit pronto '5000 0073 0000 0001 0001 0001'
Lastly you use IRP notation and set the parameters. This is great for experimenting with IRP; use the --dry-run
(-n
)
to avoid sending.
cir transmit irp -n -fF=2 '{40k,600}<1,-1|2,-1>(4,-1,F:8,^45m)[F:0..255]'
Decoding (cir decode)
Use this if have a .lircd.conf
file or .toml
keymap, and want to decode the IR, without changing
any configation.
cir decode keymap foo.lircd.conf
This will infrared from the first lirc device. You can also decode IR on the command line or a file.
cir decode keymap foo.lircd.conf -r '+9000 -4500 +560'
or
cir decode keymap foo.lircd.conf -f input-file
If you wish to decode using IRP Notation that is possible too:
cir decode irp '{40k,600}<1,-1|2,-1>(4,-1,F:8,^45m)[F:0..255]'
Like above the input can be from a lirc device (optionally specify the device with
-d /dev/lirc1
or -s rc
), on the command line (-r '+100 -200 +100'
) or a file (-f filename
).
Configuration (cir config -w)
This is the cir equivalent of ir-keytable -w
.
cir config -s rc0 -w foo.lircd.conf
This will generate a BPF decoder for foo.lircd.conf
and load it.
On startup, ir-keytable -a -s rc0
read the correct keymap from /etc/rc_maps.cfg
.
cir auto -s rc0
Test configuration (cir test)
This is the cir equivalent of ir-keytable -t
cir test
Status
All the functionality is in place to load keymaps. More tests are needed, and more polish. The aim is to have this done by the end of 2024.
Building
On Linux, cir depends on llvm for BPF code generation. On Fedora you
need the llvm-devel
package install and llvm-dev
on Ubuntu.
cargo install --git https://github.com/seanyoung/cir cir
Dependencies
~7–20MB
~262K SLoC