irtestcase(1)

NAME

irtestcase - Create or check decoding testcases.

SYNOPSIS

irtestcase [-l lircrc-file -p prog] <socket>

irtestcase [-l lircrc-file -p prog] -t testdata <socket>

irtestcase [-v|-h]

DESCRIPTION

irtestcase is a tool which can record keypresses from a remote together with the decoded values. Given output from another session, it can also verify that the decoding still works as expected.

In the first form irtestcase will wait for input and create log files for it. Doing so, it also echoes received buttons on stdout. There is no way to stop the program in a clean way, just use ctrl-C when completed.

In the second form it will feed the data from the testdata file to lircd and log the the decoded data as usually. Thus, this makes it possible to test the output from the remote which generated the testdata. In this form lircd must be running with the "file" driver.

The optional socket is the lircd output socket (lircd must be running). It defaults to LIRC_SOCKET_PATH in environment, falling back to a hardcoded default value (/var/run/lirc/lircd).

OPTIONS

-l, --lircrc  <lircrc config file>
    Log also applications strings (as ircat(1)) using lircrc type config file.

-p, --prog <program id>
    When using -l/--lircrc, the program name matching the PROG = entries in lircrc

-t, --testdata
    Use data i file instead of "live" input from the remote. This can be the durations.log file from a previous run, see FILES. It can also be logged output from mode2(1).

-v , --version
    Print version and exit.

-h , --help
    Print help message.

ENVIRONMENT
irtestcase respects LIRC_SOCKET_PATH which if defined holds the path to the lircd output socket to listen to.

FILES

/tmp/irtestcase
    irtestcase creates files in /tmp/irtestcase (hardcoded, sorry). After a successful run here is:

    durations.log
        Printable space/pulse durations in the same format as mode2(1). This file is usable as -t/--testdata input.

    codes.log
        The decoded buttons, in same format as irw(1).

    app_strings.log
        The application strings, as presented by ircat(1).

~/.cache/irtestcase.log
    Debug log. Setting the XDG_CACHE_HOME environment variable relocates this file to $XDG_CACHE_HOME/irtestcase.log. The amount of logging respects the LIRC_LOGLEVEL environment variable, defaulting to the debug value in the [lircd] section of lirc_options.conf.

SEE ALSO

The documentation for lirc is maintained as html pages. They are located under html/ in the documentation directory.