Home automation

Welcome to the awesome world of home automation! Since Batocera is Wake on LAN (WoL) enabled by default, you can now integrate your Batocera system into most any advanced home automation system.

This tutorial will cover on how you can integrate your Batocera system into Home Assistant (HA) so that you can startup/shutdown Batocera with just one click on your Logitech Harmony remote control. Note that for consistency reasons we will cover two shutdown scenarios here:

1. Scenario 1: You are logged in into Batocera's Kodi integration, meaning you have Kodi up and running on your system's screen while you want to shutdown your system. To keep Kodi's database consistent it would be best to use Kodi's API to shutdown the system so data consistency can be guaranteed.
2. Scenario 2: Your are logged out of Batocera's Kodi integration, meaning you have Kodi not running on your system's screen, instead you have Batocera's Emulation Station up and running on your system's screen while you want to shutdown your system.

Depending on how you are using Batocera (with or without its Kodi implementation), it would obviously make sense to assume that all Batocera users are using both systems, Kodi and Batocera. Therefore we will create a solution which always covers both situations so you don't have to worry about it in any way. In short: In the end we will have a solution which sends a shutdown command by using the Kodi API first (which will be ignored when Kodi is not running), waits 10 seconds, and then sends a shutdown command by sending a simple SSH command to Batocera's underlying Linux system (which will be ignored when the system is not running anymore in case it has already being shut down by the Kodi API shutdown command).

Let's do it!

This tutorial will cover an example on how to turn on/off your Batocera system with just one click on your Logitech Harmony remote control via Home Assistant (HA). For this you will need basically three things:

• A Wake on LAN (WoL) capable/enabled Batocera system having a static IP address or a hostname provided by your DHCP/DNS server (mostly your router)
• A running Logitech Harmony (hub based) remote control setup, with the Logitech Harmony Hub having a static IP address or a hostname provided by your DHCP/DNS server (mostly your router)
• A running HA instance (For automatic device discovery and latency reasons it is strongly recommended to have the HA instance within the same Layer 2 subnet as your Logitech Harmony Hub!)

First of all you want to install three required HA integrations and one required HA add-on. All three installations are set up very quickly, so for the parts not mentioned within the following steps, just follow the instruction steps from the HA GUI, it's all straight forward.

First, add the following three required integrations into HA (you can install them via the HA GUI if you are using at least a supervised HA installation (which is strongly recommended anyway or -even way better(!)- an official HAOS (Home Assistant Operating System) instance):

• Emulated Roku → When installing the integration it asks you to add an Emulated Roku instance automatically. Do so by giving it the name EmulatedRoku and by using the default port setting 8060 and then click on SUBMIT:
  

  

  EmulatedRoku integration
• Logitech Harmony Hub → When installing the integration it asks you to add the informations about your Logitech Harmony Hub. Do so by inserting the according static IP address/hostname of the Logitech Harmony Hub (e.g. 192.168.1.2) and give it the name HarmonyHub and then click on SUBMIT:
  

  

  Logitech Harmony integration
• Kodi → When installing the integration it asks you to add the informations about your Kodi instance. Do so by inserting the according static IP address/hostname of your Kodi instance (= your Batocera system) and by using the default port setting 8080 and then click on SUBMIT:
  

  

  Kodi integration

  
  Remember to also enable the Kodi web interface and to allow remote control within Kodi settings on your Batocera system:
  

  

  

  Kodi remote control settings

In addition you want to install the following HA add-on by using the HA's Add-ons menu:

• Terminal & SSH → Don't forget to enable the add-on after installing it! After installation you will have a new tab called Terminal in the HA sidebar. Click on it and you will be prompted to the command line. Now, for automating purposes you have to make your Batocera system accessible to HA via SSH without a specific user login, instead it will use a secure authentication key for passwordless login. To accomplish this, from the HA command line, execute the following two commands (if you have already created an SSH key for your root user in the past on your HA instance, skip the first command!)…

  ssh-keygen

  Confirm everything without inserting anything and by just hitting the [Enter] key on your keyboard!
  
  Now execute the following command:

  cat /root/.ssh/id_rsa.pub | ssh root@<my_IPaddress/hostname> 'cat >> /userdata/system/.ssh/authorized_keys'

  …where <my_IPaddress/hostname> has to be replaced with the according static IP address/hostname of your Batocera system. Insert the Batocera root user's password (Default password: linux).
  
  Now test the passwordless SSH login from your HA instance to your Batocera system. If it works, go further.

Note: You only have to do all of this just once unless you change the SSH authentication key manually or install Batocera from scratch again.

With the official Logitech Harmony application for Android/iOS add a new device by letting the app search automatically for new devices. It will find the Roku 4 device easily (which we have installed on HA earlier) if you have your Logitech Harmony Hub within the same Layer 2 subnet as your HA instance. If for some reason it does not detect the Roku 4 device automatically, add it manually by using the official “Logitech Harmony Desktop” application for Windows/macOS with the following device values:

Logitech Harmony Roku 4 device configuration

Click on Add and then just follow the instructions on the Logitech Harmony Desktop application, it's all straight forward.

Note that the default configuration of the Roku 4 commands is misconfigured somehow. For example: If you press the Roku 4's Home button on the Logitech Harmony remote, HA recognizes it as Info command and vice versa. While this misconfiguration is only true for a couple of buttons, most of them are recognized normally. Just be sure that for default Power on and Power off settings the according keys are mapped. From the Logitech Harmony Desktop application's main menu you can set those settings by navigating to: Devices → Change device settings → Power settings → Next → I want to turn off this devicce when not in use. → Next → I press two different buttons for on and for off → Next

Power on mapping

Power off mapping

Before going further now, make sure all of your Logitech Harmony remote devices (e.g. your physical Harmony remote control and/or Logitech smartphone app) are synced with the newly added configuration.

You can now already test if your HA instance is able to communicate with your Logitech Harmony's Roku 4 device by navigating from the HA main menu to:
Developer Tools → EVENTS
Within the Event to subsrive to input screen insert the following value:
roku_command
and then click on START LISTENING:

Home Assistant event listener

Now take your preferred Logitech remote control (Harmony remote control or Logitech smartphone app), select the Roku 4 device and press a random key. The received command(s) should now show up in HA.

Example:

If this is not the case then something went wrong and you should go through the steps conscientiously again.

Now comes the interesting part with a little bit of .yaml automation steps in HA.

We will have two main parts here: One for startup and one for shutdown you Batocera system.

Let's do the startup part first:

From the HA main menu, navigate to:
Configuration → Automations & Scenes → Scripts → + ADD SCRIPT
Configure the following values (leave the rest untouched on default settings):

Now click on SAVE SCRIPT.

Now let's do the shutdown part:
From the HA main menu go to the sidebar and click on File editor (if you don't have that option please install the File editor HA add-on first by using the HA's Add-ons menu). Then open the file /config/configuration.yaml and paste the following code:

shell_command:
  batocera_poweroff: ssh -i /config/.ssh/id_rsa -o 'StrictHostKeyChecking=no' root@<your_Baterocera_system's_static_IP_address/hostname> 'batocera-es-swissknife --shutdown' > /dev/null 2>&1 &

Example:

configuration.yaml shell example

Now reload your HA core from within the file editor:

Reload core

Now, from the HA main menu, navigate to:
Configuration → Automations & Scenes → Scripts → + ADD SCRIPT
Configure the following values (leave the rest untouched on default settings):

Now click on ADD ACTION…

Now click on ADD ACTION…

Now click on SAVE SCRIPT.

You can now test if you can launch those scripts manually. If you launch the PowerOnBatocera script manually, the system should start. If you launch the PowerOffBatocera script manually, the system should power off. Test it by clicking on the accoridng PowerOnBatocera and PowerOffBatocera triangle button from the HA Configuration → Automation and Scripts → Scripts menu:

Launch scripts manually

If it does not work, something went wrong and you should go through the steps conscientiously again.

Now we are going to do the real magic: The implementation for real home automation.
Let's do the startup automation first:
From the HA main menu navigate to:
Configuration → Automations & Scenes → Automations → + ADD AUTOMATION → Start with an empty automation
Configure the following values (leave the rest untouched on default settings):

Now click on SAVE.

Now let's do the shutdown automation:
From the HA main menu navigate to:
Configuration → Automations & Scenes → Automations → + ADD AUTOMATION → Start with an empty automation
Configure the following values (leave the rest untouched on default settings):

Now click on SAVE.

That's it! Oh boy, how cool is that? You are now able to power on/off your Batocera system with just one click from your Logitech Harmony remote control. Feel free to integrate the Roku 4 device into your Logitech Harmony activities so you can power on/off all of your devices (e.g. TV, AV receiver, amplifier, HTPC, …) with just one click with a single activity.