HdmiControlManager.java revision 9302a733b01c3ab4abd7911a286baf4833847d56
191120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim/* 291120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * Copyright (C) 2014 The Android Open Source Project 391120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * 491120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * Licensed under the Apache License, Version 2.0 (the "License"); 591120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * you may not use this file except in compliance with the License. 691120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * You may obtain a copy of the License at 791120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * 891120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * http://www.apache.org/licenses/LICENSE-2.0 991120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * 1091120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * Unless required by applicable law or agreed to in writing, software 1191120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * distributed under the License is distributed on an "AS IS" BASIS, 1291120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 1391120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * See the License for the specific language governing permissions and 1491120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * limitations under the License. 1591120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim */ 1691120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim 1791120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kimpackage android.hardware.hdmi; 1891120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim 1991120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kimimport android.annotation.Nullable; 2078d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kimimport android.os.RemoteException; 2178d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim 2291120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim/** 2391120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * The {@link HdmiControlManager} class is used to send HDMI control messages 2491120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * to attached CEC devices. 2591120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * 2691120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * <p>Provides various HDMI client instances that represent HDMI-CEC logical devices 2791120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * hosted in the system. {@link #getTvClient()}, for instance will return an 2891120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * {@link HdmiTvClient} object if the system is configured to host one. Android system 2991120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * can host more than one logical CEC devices. If multiple types are configured they 3091120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * all work as if they were independent logical devices running in the system. 3191120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim */ 3291120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kimpublic final class HdmiControlManager { 3391120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim @Nullable private final IHdmiControlService mService; 3491120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim 3578d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim // True if we have a logical device of type playback hosted in the system. 3678d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim private final boolean mHasPlaybackDevice; 3778d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim // True if we have a logical device of type TV hosted in the system. 3878d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim private final boolean mHasTvDevice; 3978d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim 4091120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim /** 4191120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * @hide - hide this constructor because it has a parameter of type 4291120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * IHdmiControlService, which is a system private class. The right way 4391120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * to create an instance of this class is using the factory 4491120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * Context.getSystemService. 4591120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim */ 4691120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim public HdmiControlManager(IHdmiControlService service) { 4791120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim mService = service; 4878d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim int[] types = null; 4978d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim if (mService != null) { 5078d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim try { 5178d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim types = mService.getSupportedTypes(); 5278d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } catch (RemoteException e) { 5378d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim // Do nothing. 5478d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 5578d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 5678d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim mHasTvDevice = hasDeviceType(types, HdmiCec.DEVICE_TV); 5778d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim mHasPlaybackDevice = hasDeviceType(types, HdmiCec.DEVICE_PLAYBACK); 5878d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 5978d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim 6078d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim private static boolean hasDeviceType(int[] types, int type) { 6178d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim if (types == null) { 6278d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim return false; 6378d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 6478d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim for (int t : types) { 6578d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim if (t == type) { 6678d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim return true; 6778d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 6878d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 6978d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim return false; 7091120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim } 7191120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim 7291120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim /** 7391120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * Gets an object that represents a HDMI-CEC logical device of type playback on the system. 7491120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * 7591120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * <p>Used to send HDMI control messages to other devices like TV or audio amplifier through 7691120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * HDMI bus. It is also possible to communicate with other logical devices hosted in the same 7791120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * system if the system is configured to host more than one type of HDMI-CEC logical devices. 7891120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * 7991120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * @return {@link HdmiPlaybackClient} instance. {@code null} on failure. 8091120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim */ 8191120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim @Nullable 8291120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim public HdmiPlaybackClient getPlaybackClient() { 8378d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim if (mService == null || !mHasPlaybackDevice) { 8491120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim return null; 8591120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim } 8691120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim return new HdmiPlaybackClient(mService); 8791120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim } 8891120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim 8991120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim /** 9091120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * Gets an object that represents a HDMI-CEC logical device of type TV on the system. 9191120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * 9291120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * <p>Used to send HDMI control messages to other devices and manage them through 9391120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * HDMI bus. It is also possible to communicate with other logical devices hosted in the same 9491120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * system if the system is configured to host more than one type of HDMI-CEC logical devices. 9591120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * 9691120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim * @return {@link HdmiTvClient} instance. {@code null} on failure. 9791120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim */ 9891120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim @Nullable 9991120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim public HdmiTvClient getTvClient() { 10078d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim if (mService == null || !mHasTvDevice) { 10178d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim return null; 10291120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim } 10391120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim return new HdmiTvClient(mService); 10491120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim } 10578d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim 10678d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim /** 10778d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim * Listener used to get hotplug event from HDMI port. 10878d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim */ 10978d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim public interface HotplugEventListener { 11078d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim void onReceived(HdmiHotplugEvent event); 11178d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 11278d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim 11378d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim /** 11478d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim * Adds a listener to get informed of {@link HdmiHotplugEvent}. 11578d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim * 11678d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim * <p>To stop getting the notification, 1179302a733b01c3ab4abd7911a286baf4833847d56Jinsuk Kim * use {@link #removeHotplugEventListener(HotplugEventListener)}. 11878d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim * 11978d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim * @param listener {@link HotplugEventListener} instance 1209302a733b01c3ab4abd7911a286baf4833847d56Jinsuk Kim * @see HdmiControlManager#removeHotplugEventListener(HotplugEventListener) 12178d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim */ 12278d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim public void addHotplugEventListener(HotplugEventListener listener) { 12378d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim if (mService == null) { 12478d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim return; 12578d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 12678d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim try { 12778d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim mService.addHotplugEventListener(getHotplugEventListenerWrapper(listener)); 12878d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } catch (RemoteException e) { 12978d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim // Do nothing. 13078d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 13178d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 13278d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim 13378d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim /** 13478d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim * Removes a listener to stop getting informed of {@link HdmiHotplugEvent}. 13578d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim * 13678d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim * @param listener {@link HotplugEventListener} instance to be removed 13778d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim */ 1389302a733b01c3ab4abd7911a286baf4833847d56Jinsuk Kim public void removeHotplugEventListener(HotplugEventListener listener) { 13978d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim if (mService == null) { 14078d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim return; 14178d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 14278d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim try { 14378d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim mService.removeHotplugEventListener(getHotplugEventListenerWrapper(listener)); 14478d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } catch (RemoteException e) { 14578d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim // Do nothing. 14678d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 14778d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 14878d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim 14978d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim private IHdmiHotplugEventListener getHotplugEventListenerWrapper( 15078d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim final HotplugEventListener listener) { 15178d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim return new IHdmiHotplugEventListener.Stub() { 15278d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim public void onReceived(HdmiHotplugEvent event) { 15378d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim listener.onReceived(event);; 15478d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 15578d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim }; 15678d695d8ba532214b02e7f18e0ccf89cf099163dJinsuk Kim } 15791120c541ac0c8c5e256b75759c884b4d6d664fcJinsuk Kim} 158