[APP][Pro] Broadlink App

[Sharkys]

Use Homey together with supported Broadlink devices.

App Store – Production:
https://homey.app/a/com.broadlink

App Store – Test:
https://homey.app/a/com.broadlink/test

Supported devices

Universal remote controls

• RM3 Mini – IR

• RM3 Mini Red Bean edition – IR

• RM Pro – IR

• RM Pro Plus – IR and RF

• RM4 Mini – IR

• RM4 Pro – IR and RF

• RM5 Plus – use the RM5 Plus pairing instructions and tips

• RM Max, device type 0xAF8B – pair using the RM4 Pro driver

Sensors, sockets and other devices

• A1 – environment sensor

• SP1 – power socket

• SP2 – power socket with nightlight and power meter

• SP3S – power socket with power meter

• MP1 – four-way power socket

• Hysen / Beok – compatible OEM thermostats

• Dooya – compatible motorized curtains

Support may depend on the exact hardware revision, device type and installed firmware. Devices with the same commercial name can contain different hardware.

Before pairing an RM device

RM-series devices must be unlocked for local network communication before Homey can control them.

In the Broadlink mobile app:

1. Open the RM device.

2. Open its device settings or properties.

3. Find the Lock device or Device lock setting.

4. Make sure the device is unlocked.

5. Return to Homey and start pairing.

The exact menu name can differ between versions of the Broadlink mobile app.

It is also strongly recommended to assign the Broadlink device a fixed IP address or DHCP reservation.

If Homey still cannot find or authenticate the device:

1. Reset the Broadlink device.

2. Add it again using the official Broadlink mobile app.

3. Confirm that it works in the Broadlink app.

4. Unlock it for local network communication.

5. Add it to Homey again.

Learning an IR command

1. Open the Broadlink device in Homey.

2. Start Learn IR command.

3. Point the original remote control towards the Broadlink device.

4. Keep the remote approximately 10–20 cm from the Broadlink device.

5. Press the required button on the remote.

6. Wait for Homey to confirm that the command was learned successfully.

7. Give the command a clear and unique name.

Learning an RF command

The RM Pro, RM Pro Plus and RM4 Pro first need to detect and lock onto the remote control’s RF frequency. This initial stage is called RF sweeping.

Homey does not ask you to select the RF frequency manually. The Broadlink device searches for the transmitted frequency during the sweeping stage but for RM4 Pro, you can device the frequency also manually.

To learn an RF command:

1. Keep the original remote approximately 10–20 cm from the Broadlink device.

2. In Homey, start Learn RF command.

3. Press and continuously hold the required button on the original remote.

4. Keep holding the button until the LED on the Broadlink device changes or switches off. This indicates that the frequency sweep has detected and locked onto the signal.

5. Release the remote button.

6. Wait for the Broadlink LED to switch on again or for Homey to request the actual command.

7. Briefly press the same remote button once more.

8. Wait for Homey to confirm that the RF command was stored successfully.

If learning fails, repeat the procedure while keeping the remote close to the Broadlink device. Do not use only short button presses during the frequency-sweeping stage.

Most ordinary fixed-code RF remotes can be learned. Rolling-code or frequency-hopping remotes generally cannot be copied reliably. This commonly affects garage doors, gates, alarm systems and some security-related products.

RM4 Pro firmware compatibility

Some RM4 Pro users have reported that firmware 62093 prevents local integrations from communicating with the device. Similar behaviour has also been reported by users of other local-control integrations.

Before changing the firmware, first verify that:

• The RM4 Pro is unlocked in the Broadlink mobile app.

• Homey and the RM4 Pro are connected to the same local network.

• Client isolation or guest-network isolation is disabled.

• The device has been reset, configured again and unlocked.

• The latest test version of the Homey app has been tried.

• A diagnostic report has been submitted after a failed pairing or learning attempt.

If all normal troubleshooting fails and the RM4 Pro uses an affected firmware version, firmware 62092 has been reported by the community as a possible workaround:

http://124.71.130.238/RMBL4-62092-8720-BL-FC-3389.upd.bin

Background information:

Important: This firmware file and downgrade procedure are not provided or officially supported by the Homey app developer. Installing or downgrading firmware can make the device unusable, introduce security risks or void its warranty. Use it only as a last resort and entirely at your own risk. Never interrupt the device’s power supply during a firmware update.

Troubleshooting and support

For normal support, pairing questions and configuration help, please use this Homey Community topic.

When reporting a problem, include:

• The exact Broadlink product name

• The device type or model ID, if available

• The installed Broadlink firmware version

• The installed Homey app version

• Your Homey model and firmware version

• Whether the device is unlocked

• Whether it works in the official Broadlink app

• A precise description of what happens

• Any displayed error message

Please also send a diagnostic report from the Broadlink app on Homey immediately after reproducing the problem and include its diagnostic report ID in your post.

For RF-learning problems, submit the diagnostic report while or immediately after performing the complete RF-learning procedure, including the frequency-sweeping stage.

GitHub is intended for confirmed application bugs and development-related requests, not as the primary support channel:

Issues · shaarkys/com.broadlink

Before opening a new issue, please check whether the same problem has already been reported.

Credits

This app builds on the work of several open-source projects and contributors. The current application has also been developed with assistance from ChatGPT.

Special thanks to the previous developer, Remko, for his work on the original application.

References and related projects:

• GitHub - mjg59/python-broadlink: Python module for controlling Broadlink RM2/3 (Pro) remote controls, A1 sensor platforms and SP2/3 smartplugs · GitHub

• GitHub - davorf/BlackBeanControl: BlackBeanControl - Broadlink RM 3 Mini (aka Black Bean) control script · GitHub

• GitHub - iobroker-community-adapters/ioBroker.broadlink2: ioBroker adapter for broadlink devices like the RM remote or SP switches · GitHub

• homebridge-broadlink-rm/helpers at master · lprhodes/homebridge-broadlink-rm · GitHub

• http://peter.windridge.org.uk/playing-with-cheap-iot-devices

• https://blog.ipsumdomus.com/broadlink-smart-home-devices-complete-protocol-hack-bc0b4b397af1

Support the development

Community apps and appreciation

These Homey Community apps are developed and maintained in my spare time.

Did you know? In my experience maintaining community Homey apps, only a very small proportion of users choose to support their development financially—even when a new device integration or specific feature has been implemented at their request.

Contributions are never required, but they are a meaningful way to recognise the time invested in development, testing, compatibility updates and ongoing user support. If one of my apps has been useful to you, you can optionally show your appreciation here:

Send an optional thank-you via PayPal

A contribution does not unlock additional features or affect the support you receive. It is simply a way to say thank you.

My Homey apps

Smart Presence Wi-Fi presence detection	Xiaomi Mi Home Xiaomi Mi Home devices	Broadlink IR, RF and smart devices
TP-Link KASA LAN Local Kasa control	Yeelights LAN Local Yeelight control	Xiaomi Miija Temperature and humidity sensors
Octoprint Monitor your 3D printer	Virtual Radar ADS-B aircraft tracking	enigma2 Control Enigma2 receivers

View all my Homey apps →

[Willybits]

Hi there!

Will you be supporting the Hysen floor thermostats as well?
It is currently recognised as a Hysen product by your app.

[Remko]

Hello,
I know what to do to get a Hysen thermostat working, so adding it to the app is not the probloem. But as I do not own one, I have no way of testing if anything works. I can even not guarantee the app won’t crash if you try anything with the thermostat.

So, somewhere in spring this year, I am planning to add support for Hysen, and put the app in the app-store as ‘beta’. Once some people have confirmed it actually works, it can be made a ‘stable’ release.

Regards, Remko

[Remko]

Please note: for Homey V2.0, you’ll need to install Broadlink app 2.0.1 which is currently available as ‘beta’.

Regards,
    Remko

[Frans_Keeman]

is there a short installation help somewhere for this. I have the RM3 Pro plus now but can’t figure out how to use it in Homey. Have installed 4 remotes but want to connect them now in Homey. Can anyone help me out here?

greetz Frans

Sorry guys just RTF
Once a RM3-Mini,RM-Pro or RM-ProPlus is paired, it can start learning commands. This is done by pressing the ‘learn’ button (for IR or RF) in the mobile card of the paired device. On the device, a LED will turn on indicating it is in learning mode, and you can press a button on a IR/RF Remote control. The command will be added to the device settings in Homey. In the device settings menu, you can give the command a more logical name, or delete it. Currently 20 to 30 commands are supported in the settings page of each device. It is not possible at this moment to change the order of the commands in the settings page

[Corvum]

Hi, thanks for your work! I have a question: how can I add Broadlink TC2 wall switch? Is it supported? If no, are you going to add it?

[henry.lin]

I can’t add Broadlink RM pro+ from Homey.
Please refer to the figure below.

Thanks.

[David_K]

I have the same issue with rm3 mini. I’m unable to add it…

[Corvum]

Hi, I am not able to learn RF comands with 2.0.2 version

[Remko]

Learning RF commands with RM Pro Plus

Once the RM-Pro-plus device is installed in Homey, it can learn RF commands.
Note that the RF must operate on 433 MHz, as this is the only band the RM-Pro-plus can understand.
Check your RF remote/device if this is the case.

Homey will talk you through the learing process, so be somewhere close to it.
As learing can be rather tricky, it is highly advisable to have the RF-device you want to control
available also.

Learning is done as follows:

1. make sure the volume of the speaker in Homey is set to a clearly audible level.
   => open the app
   -> more
   -> Settings
   -> Sound
   -> Volume (set to a level)

2. Open the device page
   => open the app
   -> Devices
   -> RM Pro Plus (or the name you gave it)

3. Get hold of your RF-remote

4. Press the ‘Learn RF button’

5. Homey will tell you to continuously press the button on your remote.
   So, press the button, and keep it pressed.

6. Homey will then tell you to press the button repeatedly.
   So, press the button, release it, press it, release it (but not too fast).

   As it is important that the RM-Pro-plus understands the button presses,
   it is best you verify you are pressing the button at the correct speed.
   You can do this as follows:

   • switch on the device you want to control with your RF-remote
   • press the button on the RF-remote, and observe your device responding to it.
   • release the button.
   • keep on repeating the press/release steps.
   • your device should respond to each button press.

7. Homey will tell you to stop pressing the button.
   The RM-Pro-plus now has learned the command.

You can now repeat the learning process for another button, or you can give
the command just learned a meaningfull name

8. Give the command a meaningfull name
   -> Settings (the icon top-right on your screen)
   -> Advanced Settings

   a. Rename the command (tap on the name, edit it, save it)
   b. Remove the command (tap on the name, clear the name, save it)

Using learned commands

Both InfraRed and RF commands can now be used in an identical way.
All commands the RM-Pro-plus has learned, are available only in flows.
When creating a flow, you can use the command (or any command) as a trigger
to start the flow.
In the ‘then’ part, you can select your RM-Pro-plus device, and select the
command from the list of available commands.

If you like to use a button to send a command, you can create a Virtual Device,
which will trigger a flow (as described above).

[Corvum]

Hi, could you please add support of broadlink tc2 (tc2-1, tc2-2, tc2-3) wall switches? It should not be so time expensive… I guess.

[Remko]

According to the Broadlink website http://www.ibroadlink.com/tc2/, these devices are controlled using a RM Pro plus device. So they are not accessible via Wifi, but only via 433MHz.
In order to use those devices in Homey, you’ll have to get a RM Pro plus device (30-40 euro).

[Corvum]

Hi, thanks for the response, actually, I think Homey has 433 module, doesn’t it? Fortunately, I have RM Pro plus, but I am not able to add TC2 wall switches via Homey Broadlink app, because here is no tc2 in devices list… what I am doing wrong?

[Frans_Keeman]

In my broadlink app i do see those switches

Edit, you wrote homey broadlink app.

[henry.lin]

I have add a Broadlink RM pro+.
My Broadlink APP have two IR button.
But,I can’t find any button at Homey APP.

Please refer to the figure below.

Please help,
Many thanks.

[Corvum]

Could you please share that app?

[Frans_Keeman]

That’s ihc for EU app you can find it in the playstore

[henry.lin]

I can’t learn IR code on the Homey APP.

[Corvum]

it’s funny, and how have you connected that with homey?

[Frans_Keeman]

I wrote “In my broadlink app i do see those switches”. Never said i connected one