The Basics
App Store
Upgrade Guides
Infrared
You can create Homey apps that use Infrared signals to control devices. This allows you to automate devices such as TVs and speakers that don't have "smart" capabilities.
Infrared is a
Signal similar to Radio (433Mhz & 868Mhz), this means that adding support for an Infrared device to your Homey App is done in much the same way as adding a 433Mhz device.In order to use Infrared in your app will need the
homey:wireless:irpermission. For more information about permissions read the permissions guide.You can view a working example of a Homey App that uses Infrared at: https://github.com/athombv/com.lg.ir-example
Installation
The
homey-rfdriver implements the basic functionality needed for all infrared apps and implements a higher level interface that you can use to control infrared devices. Install homey-rfdriver with the following command:1
npm install homey-rfdriver
Copied!
Copy the
pair/rf_ir_remote_add.html and pair/rf_ir_remote_learn.html files to the drivers/<driver_id>/pair/ folder of your app.Usage
Now that you have
homey-rfdriver installed and copied the pairing templates, you can add them to your driver's manifest:/drivers/<driver_id>/driver.compose.json
1
{
2
"name": { "en": "TV" },
3
"class": "tv",
4
"capabilities": ["onoff", "channel_up", "channel_down"],
5
"images": {
6
"small": "/drivers/my_driver/assets/images/small.jpg",
7
"large": "/drivers/my_driver/assets/images/large.jpg"
8
},
9
"pair": [
10
{
11
"id": "rf_ir_remote_learn",
12
"navigation": { "next": "rf_ir_remote_add" },
13
"options": {
14
"title": { "en": "Pair your IR remote" },
15
"instruction": { "en": "Press next to pair your remote." }
16
}
17
},
18
{
19
"id": "rf_ir_remote_add"
20
}
21
]
22
}
Copied!
Signal definition
Next you need to add the signals you want to send to your manifest, you can define your signals by creating
.homeycompose/signals/ir/my_signal.json. We will explain the basics next but if you want to know more about creating signal definitions your should read the RF 433Mhz/868Mhz guide.First you need to configure the carrier frequency, number of repetitions for all commands and the signal characteristics. For example:
/.homeycompose/signals/ir/my_signal.json
1
{
2
"carrier": 37900,
3
"sof": [4535, 4465],
4
"eof": [590],
5
"words": [
6
[590, 590],
7
[590, 1690]
8
],
9
"prefixData": [1, 1, 1, 0, 0, 0, 0, 0, 1, 1, 1, 0, 0, 0, 0, 0],
10
"interval": 1000,
11
"sensitivity": 0.5,
12
"repetitions": 5,
13
"minimalLength": 32,
14
"maximalLength": 32,
15
"cmds": {}
16
}
Copied!
The
carrier frequencies for infrared are: min: 30000, default: 38000, max: 45000Now that the signal characteristics are defined you can add commands, for example:
/.homeycompose/signals/ir/my_signal.json
1
"cmds": {
2
"POWER_ON": [1, 0, 0, 1, 1, 0, 0, 1, 0, 1, 1, 0, 0, 1, 1, 0],
3
"POWER_OFF": [0, 0, 0, 1, 1, 0, 0, 1, 1, 1, 1, 0, 0, 1, 1, 0],
4
"CHANNEL_UP": [0, 1, 0, 0, 1, 0, 0, 0, 1, 0, 1, 1, 0, 1, 1, 1],
5
"CHANNEL_DOWN": [0, 0, 0, 0, 1, 0, 0, 0, 1, 1, 1, 1, 0, 1, 1, 1]
6
}
Copied!
Classes
The only things left to do is to define the right classes, starting with the signal which tells
homey-rfdriver what signal to use (and allows you to override the signal functionality):/drivers/<my_driver>/signal.js
1
const { RFSignal } = require('homey-rfdriver');
2
3
class MySignal extends RFSignal {
4
static FREQUENCY = 'ir';
5
static ID = 'my_signal';
6
}
7
8
module.exports = MySignal;
Copied!
Next you need to link create a
Driver that extends RFDriver and the link your RFSignal class to it./drivers/<my_driver>/driver.js
1
const { RFDriver } = require('homey-rfdriver');
2
const MySignal = require('./signal.js');
3
4
class MyDriver extends RFDriver {
5
static SIGNAL = MySignal;
6
}
7
8
module.exports = MyDriver;
Copied!
And lastly you need to create a
Device that extends RFDevice and create a mapping from Homey capabilities to the commands you defined for your signal./drivers/<my_driver>/device.js
1
const { RFDevice } = require('homey-rfdriver');
2
3
class MyDevice extends RFDevice {
4
static CAPABILITIES = {
5
onoff: {
6
'true': 'POWER_ON',
7
'false': 'POWER_OFF',
8
},
9
channel_up: 'CHANNEL_UP',
10
channel_down: 'CHANNEL_DOWN',
11
}
12
}
13
14
module.exports = MyDevice;
Copied!
Prontohex
Homey also supports Prontohex signal definitions for infrared devices.
Properties
The table below shows the encoding properties in the Prontohex signal definition.
Attribute
Description
Remark
cmdsStatic commands
The Prontohex command string definition
typeType of Signal
Set to
prontohex to enable prontohex modeCommands
Sometimes, devices have a static set of commands and do not include any dynamic data such as an address. This is the case for most infrared devices. In these cases, the
cmds attribute can be used to predefine all commands. This property consists of an object that maps commands (specified as identifier string) to a prontohex payload (specified as String). The carrier in the prontohex String overrides the carrier in the signal radio specification./.homeycompose/signals/ir/my_signal.json
1
{
2
"type": "prontohex",
3
"cmds": {
4
"ON": "0000 0073 0000 000D 0020 0020 0040 0020 0020 0020 0020 0020 0020 0020 0020 0020 0020 0040 0020 0020 0020 0020 0020 0020 0020 0020 0020 0020 0020 0CA4",
5
"OFF": "0000 0073 0000 000C 0020 0020 0040 0020 0020 0020 0020 0020 0020 0020 0020 0020 0020 0040 0020 0020 0020 0020 0020 0020 0040 0040 0020 0CA4"
6
}
7
}
Copied!
/app.js
1
const Homey = require('homey');
2
3
class App extends Homey.App {
4
async onInit() {
5
const philipsSignal = this.homey.rf.getSignalInfrared('philips');
6
7
await philipsSignal.cmd('ON');
8
}
9
}
10
11
module.exports = App;
Copied!
Last modified 7mo ago
Copy link