This is a two-way driver to control Media drivers inclucing AppleTV 3, 4 & 5, Android TV, FireTV, Kalediascape, DirecTV and many more from Elan.  This driver requires the Magic Cube:  https://innovo.net/magic

The Elan controller is capable of controlling the transport functions of all media devices.  Some device have meta tag feedback and channel / app launch

• This Driver supports the devices below
• Elan HR40, HR30, HHR and HR10 Remotes
• All Apple TV’s on the network can be powered on during setup and driver installation
• Direct Channel Access from Elan
• Setting Favorites with Favorite Icons
• Now Playing title and time
• Slider based seek functions for fast forward and rewind functionality

• The Driver uses a static IP address. Please assign a static IP address or using DHCP Static Reservation from your Router to guarantee that the ATV Device will always have the same IP Address.

This is a new driver with a new name.  You cannot upgrade an existing ATVOS driver.

• Open Media, Communication Devices, Add New Communication Device
• In V2, click Import and choose MagicCubeMediaPro Driver, In V1 Navigate to the folder where the driver is located and choose the MagicCubeMediaPro, then click OK.
• If you receive a warning that this is not a Native Elan driver, click OK
• The Driver will automatically go into trial mode for 30 days. Wait for about 10 seconds and the Status will turn Green.
• Add the Innovo Activation Code received in the email.
• Starting with Magic Cube Aura and V5 Patch 3, you no longer need to add the token.  The token is added using the Magic Cube Admin Interface.  See Magic Cube User Manual
• Click Apply

• Click Discover, the driver will discover and populate the IP address of the Magic Cube device on the network.  If the device is not discovered or you have more than one, enter the IP address manual.
• From the Platform dropdown, choose the brand of TV you would like to install. 
• NOTE: You must have the brand/platform preconfigured in the Magic Cube First.  See Magic Cube Manual.
• NOTE: If the platform you want to install is not shown on the dropdown, contact support@innovo.net to get the exact name of the platform you want. After you get the exact name, go and choose Other from the platform dropdown, enter the name that you have in the Other Platform Field, click Apply, and install.
• NOTE: To continue installing platforms from the dropdown you should have the Other Platform field empty.
• Click Install Devices.  The Driver will automatically discover all the TVs connected to the Magic Cube and install them under Sources as sub-drivers based on manufacturer.

NOTE: Once the driver Discovers and installs the sub-drivers, it will automatically fill the Remote entity, Media Player entity, or both.

USING THE DRIVER – Apple TV

• The Power button should be highlighted blue so that the driver can control the ATV.  If the Power button is dimmed, click it and wait 5 seconds
• The Top Menu button will bring up the Sleep and options screen in ATV. 
• If the ATV goes to sleep it will require up to 15 seconds to wake up after clicking any button.  Please be patient till the ATV comes back online and displays the screen after sleep.

The Channels page is dynamically loaded from the Apple TV

• The driver has metadata that shows the title, time, and type of media. 
• The driver has a seek slider that the user can use to advance or rewind media.
• The time stamp shown in the viewer may not match exactly what’s is shown on the ATV.  There could be a difference of up to 10 seconds.  When an episode / movie ends and the next one begins, the delay can be up to 30 seconds.  This is normal behavior of the driver.

The Driver uses a static IP address. Please assign a static IP address or using DHCP Static Reservation from your Router to guarantee that the media Device will always have the same IP Address.

Device Configuration – Apple TV

You must first setup the Magic Cube device and Pair Magic Cube with the Apple TV.

Apple TV Setup:

Disable All Airplay Passwords in the Apple TV.  The driver doesn’t support Airplay passwords.

Set Airplay to accept all connections from Local Network

Set Sleep to Never

Make sure Home Sharing is turned on.

Restart Apple TV before starting to pair.

Note for the ATV 3.  Only transport functions work.  Channel and Feedback controls need to be removed from the interface.

• Plug in the Home Assistant (HA) device into the power and network
• Access the HA Page directly or using the Magic Cube Console.  See Magic Cube Documentation using the link below
• https://wiki.innovo.net/aura/access-ha/

Setup the Apple TV on Magic Cube

• HA will automatically discover all Apple TV’s on the network:
• Make sure your Apple TV is running TVOS 15 or higher
• IF A PIN CODE IS REQUESTED, BUT NONE IS SHOWN ON THE SCREEN
  • This can happen when pairing the AirPlay protocol in case the access settings are wrong. On your Apple TV, navigate to Settings, find the AirPlay menu and make sure that the access setting is set to “Everyone on the same network” and try again.

If HA didn’t discover the AppleTV

Manual configuration steps

If there wasn’t any discovered automatically, don’t worry! You can set up a manual integration entry:

• Browse to your Magic Cube instance.
• In the sidebar click on Devices & Integrations.
• In the bottom right, click on the Add Integration button.
• From the list, search and select “Apple TV”.
• Follow the instruction on screen to complete the set up.

Go To Configuration —-> Devices and Services:

Pair the Apple TV with Magic Cube

• Pair your ATV with HA involves three pairing codes.  Each code will pair a specific protocol that is needed to control and read meta data from the ATV.

• When HA finds your ATV, click on Configure.  You will be then presnted with a screen.  Click Sumbit

• The first pairing code for AirPlay will appear on your ATV.  Enter this code into this window and click Submit

• The second pairing code for Companion will appear on your ATV.  Enter this code into this window and click Submit

• The third pairing code for RAOP will appear on your ATV.  Enter this code into this window and click Submit

• If successful, you will get the successful screen.  If the pairing was not successful start the process again.
• Then Add the ATV to a room.  The room choice doesn’t really matter.  This will give us the addressing we need.

Device Configuration – Fire TV

Disable Screensaver Time out and Sleep Timer

Enable ADB Debugging on Your Fire TV Stick

Before you move on to one of the 2 methods below, you need to follow these steps first on your Fire Stick.

• On your Fire TV device, navigate to Settings > My Fire TV > Developer Options and turn ON both options (Apps from Unknown Sources and ADB Debugging).
• When connecting from ADB for the first time, the Fire TV Stick shows a secure connection screen and you have to check a box to confirm that it’s OK to connect to your PC.  There’s also a box to remember this choice.
• Find and take note of your Fire Stick’s IP address by going to Settings > System > About > Network.
• Download and Install ADBLink
• adbLink (jocala.com)
• Open adbLink on your computer.
• Click the New button
• In Description, give your Fire TV Stick a name.
• In Address, type the IP address of your Fire TV Stick that you took note of earlier.
• Click the Save button.
• Click the Connect button
• You should see your Fire TV Stick’s IP or name show in the Connected Devices box, and you should see the text “IP connection” in the Connection Status box.
• If so, you’re ready to go.
• NOTE: If you’re having trouble connecting when you’ve done this before, try toggling ADB Debugging off and on again following the steps from the previous section.

Change Sleep/Screensaver Settings via adbLink Utility

Method 1 – Preferred

Once you have your adbLink connected to your Fire Stick, select the “Utility” menu at the top and then click on “Set timers”

Device Configuration – Android TV (Shows up as Android TV Remote)

• Access the HA Page directly or using the Magic Cube Console.  See Magic Cube Documentation using the link below
• https://wiki.innovo.net/aura/access-ha/
• HA will automatically discover all Android TVs on the network. If an instance was found, it will be shown as Discovered. You can then set it up right away.

In ADB 5.5, there is Button called Edit Timers rather than a Utility Menu Item.  Use that Button.

A new window will pop up that looks like this…

SET SLEEP OFF

If you select “never” from the Fire TV’s screensaver settings, the Sleep Off current value becomes 0.      

DO NOT SET SCREENSAVER Current Value to 0.  

If you select “Screensaver Off” from the Fire TV’s screensaver settings, the screensaver timer gets set to 2147460000, which is about 24 days. Setting a value of 0 does not disable the screensaver.   

All you need to do is select “Sleep Off” and optionally “Screensaver off” and click the “OK” button.   

Method 2  – Change Sleep/Screensaver Settings via adbLink Command Line Shell

If method #1A didn’t work  Once your adbLink is connected to your Fire TV Stick (from the previous section), then click the “ADB Shell” button to open a command line shell.

Tip: If you are using a Mac and happen to get the error that says “Error Creating Command File”, the solution is to close adbLink, move the program file to your desktop and open it there.  Then, you should be able to open the ADB shell without the error.

How to Run ADB Shell Commands

Copy the commands below, and then simply right-click in the ADB Shell window to paste.  Or, you can just type it in.  Hit the enter key to run the command.

Get Current Screensaver and Sleep Timeout Settings

settings get system screen off timeout

•     The default screensaver value is 300000, which is 5 minutes.  If the screensaver setting in FireOS settings was set to “Never”, so this setting value was set to 2147460000, which is about 24 days.

settings get secure sleep_timeout

• The default sleep value is 1200000, which is 20 minutes.   This is the setting that you can’t change in FireOS settings.  But, you can here!  

Save New Settings for Screensaver and Sleep Timeout

settings put system screen_off_timeout 2147460000

•     Running this command will disable your screensaver if it isn’t already.  You could also do this in the FireOS settings, but this also gives you the ability to select an amount of time which is not available in the settings drop-down.

settings put secure sleep_timeout 0

•     Running this command will stop your Fire TV Stick from going to sleep by itself.  The value “0” here actually disables the sleep timeout feature.

When you’re done, you can run the “get” commands from above once again to make sure the setting took properly.

Device Configuration – GenericTV

• Access the HA Page directly or using the Magic Cube Console.  See Magic Cube Documentation using the link below
• https://wiki.innovo.net/aura/access-ha/
• HA will automatically discover all the TVs that are Generic on the network.

Manual configuration steps

If there wasn’t any discovered automatically, don’t worry! You can set up a manual integration entry:

• Browse to your Magic Cube instance.
• In the sidebar click on Devices & Integrations
• In the bottom right, click on the Add Integration button.
• From the list, search and select the TV.
• Follow the instructions on the screen to complete the setup.

There is currently a bug in the ATV Netflix.  When binge watching, Netflix doesn’t update the ATV properly and the timing / title / seek may not work properly.

• HA doesn’t find Apple TV:  Give the HA 10 – 15 minutes after first setup to discover devices
• HA doesn’t pair:  Restart Magic Cube / Restart ATV
• PIN CODE IS REQUESTED, BUT NONE IS SHOWN ON THE SCREEN
  • This can happen when pairing the AirPlay protocol in case the access settings are wrong. On your Apple TV, navigate to Settings, find the AirPlay menu and make sure that the access setting is set to “Everyone on the same network” and try again.

• Driver breaks:  Update Magic Cube to the latest release.  From HA web interface go to settings.  If there is an updated version ready, it will be on top.  Update accordingly.
• NOTE:  If you’re using the Magic Cube, the device will auto update every week.  If you need an update sooner, contact support@innovo.net