# IRTrans

# Component Type: Actuator (Subcategory: Home Control)

This component sends transmission commands to an infrared-transmitter. The different commands can be selected by the different events. The commands must be programmed into the IR-transmitter, before this component can be used. Furthermore, commands can also be sent to this component’s input port (“action”).

# IR command by action string

You can send an IR command by sending an action string to the input port action. The string must start with @IRTRANS: and contain the remote control name and the command name. For example, if the IR-Transmitter is programmed with a database called LG-TV and the desired command is called TvOn, the action string to play the IR-code is:

@IRTRANS: snd LG-TV,TvOn.

# Send hex data

HEX data of a stored command can be retrieved within the IrServer software at the menu entry IR Hexcode abrufen. This data then can be sent directly to the action port with the advantage that it works independently of the current IrServer database on the current device.

Important: if the HEX data is something like 4E0100000000222... the correct command to send to the action port would be @IRTRANS: sndhex H4E0100000000222... (note the added H at the beginning of the code).

# IR command by event

You can send an IR command using the event listener port of the plugin. Use the property prestring to set the name of the remote control device containing the IR commands you need. Then you can use the properties send<1-n> to set the name of the IR command.

# Example

  • prestring: snd LG-TV,
  • send1: TvOn

Screenshot: IRTrans plugin

# Requirements

  • IRTrans module (opens new window) (USB, LAN or WiFi version).
  • Install and start IRTrans SW (USB model only):
  • Train the IRTrans database with IR commands, using the IRTrans Server SW or the Web-Interface of the Wifi-based IRTrans module.

IRTrans universal IR remote module

# Input Port Description

  • action[string]: A string, which will be sent to the IRTrans module, must start with “@IRTRANS”.
    For possible commands see official IrTrans protocol guide (opens new window).
    Note: the action string sent to the input port must not contain the prefix “A” like described in the protocol guide. This is because of compatibility reasons with the old UDP protocol.

# Output Port Description

  • output[string]: The IRTrans can also receive IR-Commands. With the IRTrans Configuration tool string commands can be defined for every received IR-Command. Received IR-commands are sent to this port, e.g. \*\*00028 RCV\_COM test,on,0,0 (see protocol guide for format details)
  • outputResult[string]: Receives the result of an action string that was previously sent to action-port.

# Event Listener Description

  • sendprop1: sends the command, stored in the property send1 to the IRTrans (including the prestring).
  • sendprop24: sends the command, stored in the property send24 to the IRTrans (including the prestring).

# Properties

  • hostname[string]: The hostname/IP-address of the IRTrans. Use localhost if you have the IRTrans USB Version (IRTrans server tool must be running), or use the IP address of your IRTrans LAN or WiFi module.
  • port[string]: The port of the IRTrans (default is 21000).
  • prestring[string]: A string, being added before the strings of properties send1 to send24. Typically snd <remote name>, should be used.
  • Send1[string]: This string (including the prestring) will be sent, if the event EventProp1 will be triggered.
  • Send24[string]: This string (including the prestring) will be sent, if the event EventProp24 will be triggered.

Comment: This component is exactly tailored to the IRTrans module and needs expert knowledge to be configured.

# References