1 /* 2 * Copyright (C) 2015 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 package android.os; 17 18 import android.annotation.IntDef; 19 import android.annotation.NonNull; 20 import android.annotation.SystemService; 21 import android.content.Context; 22 import android.hardware.thermal.V1_0.Constants; 23 import android.util.Log; 24 25 import java.lang.annotation.Retention; 26 import java.lang.annotation.RetentionPolicy; 27 28 /** 29 * The HardwarePropertiesManager class provides a mechanism of accessing hardware state of a 30 * device: CPU, GPU and battery temperatures, CPU usage per core, fan speed, etc. 31 */ 32 @SystemService(Context.HARDWARE_PROPERTIES_SERVICE) 33 public class HardwarePropertiesManager { 34 35 private static final String TAG = HardwarePropertiesManager.class.getSimpleName(); 36 37 private final IHardwarePropertiesManager mService; 38 39 /** 40 * @hide 41 */ 42 @Retention(RetentionPolicy.SOURCE) 43 @IntDef({ 44 DEVICE_TEMPERATURE_CPU, DEVICE_TEMPERATURE_GPU, DEVICE_TEMPERATURE_BATTERY, 45 DEVICE_TEMPERATURE_SKIN 46 }) 47 public @interface DeviceTemperatureType {} 48 49 /** 50 * @hide 51 */ 52 @Retention(RetentionPolicy.SOURCE) 53 @IntDef({ 54 TEMPERATURE_CURRENT, TEMPERATURE_THROTTLING, TEMPERATURE_SHUTDOWN, 55 TEMPERATURE_THROTTLING_BELOW_VR_MIN 56 }) 57 public @interface TemperatureSource {} 58 59 /** 60 * Device temperature types. 61 */ 62 /** Temperature of CPUs in Celsius. */ 63 public static final int DEVICE_TEMPERATURE_CPU = Constants.TemperatureType.CPU; 64 65 /** Temperature of GPUs in Celsius. */ 66 public static final int DEVICE_TEMPERATURE_GPU = Constants.TemperatureType.GPU; 67 68 /** Temperature of battery in Celsius. */ 69 public static final int DEVICE_TEMPERATURE_BATTERY = Constants.TemperatureType.BATTERY; 70 71 /** Temperature of device skin in Celsius. */ 72 public static final int DEVICE_TEMPERATURE_SKIN = Constants.TemperatureType.SKIN; 73 74 /** Get current temperature. */ 75 public static final int TEMPERATURE_CURRENT = 0; 76 77 /** Get throttling temperature threshold. */ 78 public static final int TEMPERATURE_THROTTLING = 1; 79 80 /** Get shutdown temperature threshold. */ 81 public static final int TEMPERATURE_SHUTDOWN = 2; 82 83 /** 84 * Get throttling temperature threshold above which minimum clockrates for VR mode will not be 85 * met. 86 */ 87 public static final int TEMPERATURE_THROTTLING_BELOW_VR_MIN = 3; 88 89 /** Undefined temperature constant. */ 90 public static final float UNDEFINED_TEMPERATURE = -Float.MAX_VALUE; 91 92 /** Calling app context. */ 93 private final Context mContext; 94 95 /** @hide */ HardwarePropertiesManager(Context context, IHardwarePropertiesManager service)96 public HardwarePropertiesManager(Context context, IHardwarePropertiesManager service) { 97 mContext = context; 98 mService = service; 99 } 100 101 /** 102 * Return an array of device temperatures in Celsius. 103 * 104 * @param type type of requested device temperature, one of {@link #DEVICE_TEMPERATURE_CPU}, 105 * {@link #DEVICE_TEMPERATURE_GPU}, {@link #DEVICE_TEMPERATURE_BATTERY} or {@link 106 * #DEVICE_TEMPERATURE_SKIN}. 107 * @param source source of requested device temperature, one of {@link #TEMPERATURE_CURRENT}, 108 * {@link #TEMPERATURE_THROTTLING}, {@link #TEMPERATURE_THROTTLING_BELOW_VR_MIN} or 109 * {@link #TEMPERATURE_SHUTDOWN}. 110 * @return an array of requested float device temperatures. Temperature equals to 111 * {@link #UNDEFINED_TEMPERATURE} if undefined. 112 * Empty if platform doesn't provide the queried temperature. 113 * 114 * @throws SecurityException if something other than the device owner or the current VR service 115 * tries to retrieve information provided by this service. 116 */ getDeviceTemperatures(@eviceTemperatureType int type, @TemperatureSource int source)117 public @NonNull float[] getDeviceTemperatures(@DeviceTemperatureType int type, 118 @TemperatureSource int source) { 119 switch (type) { 120 case DEVICE_TEMPERATURE_CPU: 121 case DEVICE_TEMPERATURE_GPU: 122 case DEVICE_TEMPERATURE_BATTERY: 123 case DEVICE_TEMPERATURE_SKIN: 124 switch (source) { 125 case TEMPERATURE_CURRENT: 126 case TEMPERATURE_THROTTLING: 127 case TEMPERATURE_SHUTDOWN: 128 case TEMPERATURE_THROTTLING_BELOW_VR_MIN: 129 try { 130 return mService.getDeviceTemperatures(mContext.getOpPackageName(), type, 131 source); 132 } catch (RemoteException e) { 133 throw e.rethrowFromSystemServer(); 134 } 135 default: 136 Log.w(TAG, "Unknown device temperature source."); 137 return new float[0]; 138 } 139 default: 140 Log.w(TAG, "Unknown device temperature type."); 141 return new float[0]; 142 } 143 } 144 145 /** 146 * Return an array of CPU usage info for each core. 147 * 148 * @return an array of {@link android.os.CpuUsageInfo} for each core. Return {@code null} for 149 * each unplugged core. 150 * Empty if CPU usage is not supported on this system. 151 * 152 * @throws SecurityException if something other than the device owner or the current VR service 153 * tries to retrieve information provided by this service. 154 */ getCpuUsages()155 public @NonNull CpuUsageInfo[] getCpuUsages() { 156 try { 157 return mService.getCpuUsages(mContext.getOpPackageName()); 158 } catch (RemoteException e) { 159 throw e.rethrowFromSystemServer(); 160 } 161 } 162 163 /** 164 * Return an array of fan speeds in RPM. 165 * 166 * @return an array of float fan speeds in RPM. Empty if there are no fans or fan speed is not 167 * supported on this system. 168 * 169 * @throws SecurityException if something other than the device owner or the current VR service 170 * tries to retrieve information provided by this service. 171 */ getFanSpeeds()172 public @NonNull float[] getFanSpeeds() { 173 try { 174 return mService.getFanSpeeds(mContext.getOpPackageName()); 175 } catch (RemoteException e) { 176 throw e.rethrowFromSystemServer(); 177 } 178 } 179 } 180