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 
17 package android.car.hardware;
18 
19 import android.car.hardware.CarSensorEvent;
20 import android.car.hardware.ICarSensorEventListener;
21 
22 /** @hide */
23 interface ICarSensor {
24 
getSupportedSensors()25     int[] getSupportedSensors() = 0;
26 
27     /**
28      * register a callback or update registration if already updated.
29      * @param sensorType sensor to listen with this callback.
30      * @param rate sensor rate.
31      * @return false if requested sensors cannot be subscribed / started.
32      */
registerOrUpdateSensorListener(int sensorType, int rate, in ICarSensorEventListener callback)33     boolean registerOrUpdateSensorListener(int sensorType, int rate,
34             in ICarSensorEventListener callback) = 1;
35 
36     /**
37      * get latest sensor event for the type. If there was no update after car connection, it will
38      * return null immediately.
39      */
getLatestSensorEvent(int sensorType)40     CarSensorEvent getLatestSensorEvent(int sensorType) = 2;
41 
42     /**
43      * Stop listening for the given sensor type. All other sensors registered before will not
44      * be affected.
45      */
unregisterSensorListener(int sensorType, in ICarSensorEventListener callback)46     void unregisterSensorListener(int sensorType, in ICarSensorEventListener callback) = 3;
47 }
48