Irsend (1) Linux Manual Page

irsend – basic LIRC program to send infra-red commands

Synopsis

irsend [options] DIRECTIVE REMOTE CODE [CODE…]

Description

Asks the lircd daemon to send one or more CIR (Consumer Infra-Red) commands. This is intended for remote control of electronic devices such as TV boxes, HiFi sets, etc.

DIRECTIVE can be:


SEND_ONCE – send CODE [CODE …] once

SEND_START – start repeating CODE

SEND_STOP – stop repeating CODE

LIST – list configured remote items

SET_TRANSMITTERS – set transmitters NUM [NUM …]

SIMULATE – simulate IR event

REMOTE is the name of a remote, as described in the lircd configuration file.

CODE is the name of a remote control key of REMOTE, as it appears in the lircd configuration file.

NUM is the transmitter number of the hardware device.

For the LIST DIRECTIVE, REMOTE and/or CODE can be empty:


LIST "" "" – list all configured remote names

LIST REMOTE "" – list all codes of REMOTE

LIST REMOTE CODE – list only CODE of REMOTE

The SIMULATE command only works if it has been explicitly enabled in lircd.

Options

-h –help

display usage summary

-v –version

display version

-d –device

use given lircd socket [/var/run/lirc/lircd]

-a –address=host[:port]

connect to lircd at this address

-# –count=n

send command n times

Environment

LIRC_SOCKET_PATH: The lircd socket to connect to, defaults to a hardcoded default value usually /var/run/lirc/lircd

Files

/etc/lirc/lircd.conf

Default lircd configuration file. It should contain all the remotes, their infra-red codes and the corresponding timing and waveform details.

Diagnostics

If lircd is not running (or /var/run/lirc/lircd lacks write permissions) irsend aborts with the following diagnostics:

"irsend: could not connect to socket"

"irsend: Connection refused" (or "Permission denied").

Examples


irsend LIST DenonTuner ""

irsend SEND_ONCE DenonTuner PROG-SCAN

irsend SEND_ONCE OnkyoAmpli VOL-UP VOL-UP VOL-UP VOL-UP

irsend SEND_START OnkyoAmpli VOL-DOWN ; sleep 3

irsend SEND_STOP OnkyoAmpli VOL-DOWN

irsend SET_TRANSMITTERS 1

irsend SET_TRANSMITTERS 1 3 4

irsend SIMULATE "0000000000000476 00 OK TECHNISAT_ST3004S"

Driver Loading

Drivers are loaded dynamically. The directory used for this is determined by (falling priority):

–: The ‘plugindir’ entry in the [lircd] section of the lirc_options.conf file.
–: The environment variable LIRC_PLUGINDIR.
–: A hardcoded default (usually /usr/lib[64]/lirc/plugins).

irsend (1) Linux Manual Page