irsend (1) Linux Manual Page
NAME
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 namesLISTREMOTE "" - list all codes of REMOTELISTREMOTE 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
lircdconfiguration 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).
SEE ALSO
lircd(8), mode2(1), xmode2(1), irrecord(1), irw(1)
