Home Assistant integration for Unfolde Circle Remote Two.
There are two main ways to install this custom component within your Home Assistant instance:
Using HACS (see https://hacs.xyz/ for installation instructions if you do not already have it installed):
Or
Restart your Home Assistant instance and then proceed to the Configuration section below.
Manual Installation:
While the manual installation above seems like less steps, it's important to note that you will not be able to see updates to this custom component unless you are subscribed to the watch list. You will then have to repeat each step in the process. By using HACS, you'll be able to see that an update is available and easily update the custom component. Trust me, HACS is the worth the small upfront investment to get it setup.
There is a config flow for this integration. After installing the custom component and restarting:
Alternatively, if you do not have zeroconf discovery enabled, or your remote was not automatically discovered:
After the device is configured, the integration will expose 22 entities plus the number of activities you have defined on your remote. These are grouped by device. Four of these entities will be disabled by default. These are all diagnostic in nature and report the device stats and if polling of the remote is enabled. (This is only true if any of the three device stat entities are enabled.)
Number
** Disabled by default to avoid polling the remote every thirty seconds to read data. If one of these sensors is enabled, polling only for that specific data will also be enabled.
Dock support has now been added. If you have an existing remote configured, you will be prompted with a repair for each dock associated with your remote. You can also add docks via a configuration flow when adding a remote. Each Dock exposes 4 entities:
Buttons
Number
During a config flow, if you are unsure of your password, you can skip adding that dock for the moment by submitting the form without a password supplied. This will cause a repair to be created so you can set it at your leasure.
If you are unsure of the password you set, you can change it via the web configurator. Click on the Integrations and Dock menu and then select the dock you need to change the password for. Once changed, come back to the repair and let home assistant know what you set it to.
How to interact with the Remote Service: The remote entity supports sending IR commands using the remote.send_command service.
service: remote.send_command
data:
device: Receiver
command: Power
target:
entity_id: remote.remote_two_remote
[!TIP] > device: will match the case-sensitive name of your remote defined in the web configurator on the remote page. command will match the case-senstitive name of the pre-defined (custom or codeset) command defined for that remote. num_repeats is optional.
There is now an action to update defined activities. This will be initially released with the option to enable/disable the 'prevent sleep' option within the selected activity.
service: unfoldedcircle.update_activity
target:
entity_id: switch.remote_two_control_projector
data:
prevent_sleep: true
BETA: This will be available in the wide release soon
You can now rapidly learn IR commands through your dock. To get started, go to your developer tools and then to the services tab and recreate the example below with your data. Start by providing a remote entity of the dock you want to learn through. Then add information about the remote to be created in the Unfolded Circle Software (name, icon, and description). Follow that with your IR dataset. Give it a name and a list of commands you would like to learn.
service: unfoldedcircle.learn_ir_command
target:
entity_id: remote.remote_dock_remote
data:
remote:
name: Sony TV
icon: uc:tv
description: My Sony TV Remote
ir_dataset:
name: Sony A95L
command:
- direction_up
- direction_right
- direction_down
- direction_left
- menu
- back
- home
Finally, run this by clicking call service. This will start the dock listening for your commands. If you check your home assistant notifications, you'll get feedback on which step you are on. Continue by clicking the button on your remote that is shown in the notification while pointing at your dock.
If you run the above you will end up with the following in your Unfolded Circle Remote's web configurator that you can then assign to virtual or physical buttons:
Additional options have been added to the intergration for further customization:
Your Remote Two will now be automatically discovered on the network. Zeroconf handling has been significantly improved and should now properly detect when a device has already been configured.
I am not associated with Unfolded Circle, and provide this custom component purely for your own enjoyment and home automation needs. Those guys are awesome though!