1/*
2 * Copyright (C) 2016 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
17package android.hardware.automotive.vehicle@2.0;
18
19import IVehicleCallback;
20
21interface IVehicle {
22  /**
23   * Returns a list of all property configurations supported by this vehicle
24   * HAL.
25   */
26  getAllPropConfigs() generates (vec<VehiclePropConfig> propConfigs);
27
28  /**
29   * Returns a list of property configurations for given properties.
30   *
31   * If requested VehicleProperty wasn't found it must return
32   * StatusCode::INVALID_ARG, otherwise a list of vehicle property
33   * configurations with StatusCode::OK
34   */
35  getPropConfigs(vec<int32_t> props)
36          generates (StatusCode status, vec<VehiclePropConfig> propConfigs);
37
38  /**
39   * Get a vehicle property value.
40   *
41   * For VehiclePropertyChangeMode::STATIC properties, this method must always
42   * return the same value always.
43   * For VehiclePropertyChangeMode::ON_CHANGE properties, it must return the
44   * latest available value.
45   *
46   * Some properties like RADIO_PRESET requires to pass additional data in
47   * GET request in VehiclePropValue object.
48   *
49   * If there is no data available yet, which can happen during initial stage,
50   * this call must return immediately with an error code of
51   * StatusCode::TRY_AGAIN.
52   */
53  get(VehiclePropValue requestedPropValue)
54          generates (StatusCode status, VehiclePropValue propValue);
55
56  /**
57   * Set a vehicle property value.
58   *
59   * Timestamp of data must be ignored for set operation.
60   *
61   * Setting some properties require having initial state available. If initial
62   * data is not available yet this call must return StatusCode::TRY_AGAIN.
63   * For a property with separate power control this call must return
64   * StatusCode::NOT_AVAILABLE error if property is not powered on.
65   */
66  set(VehiclePropValue propValue) generates (StatusCode status);
67
68  /**
69   * Subscribes to property events.
70   *
71   * Clients must be able to subscribe to multiple properties at a time
72   * depending on data provided in options argument.
73   *
74   * @param listener This client must be called on appropriate event.
75   * @param options List of options to subscribe. SubscribeOption contains
76   *                information such as property Id, area Id, sample rate, etc.
77   */
78  subscribe(IVehicleCallback callback, vec<SubscribeOptions> options)
79          generates (StatusCode status);
80
81  /**
82   * Unsubscribes from property events.
83   *
84   * If this client wasn't subscribed to the given property, this method
85   * must return StatusCode::INVALID_ARG.
86   */
87  unsubscribe(IVehicleCallback callback, int32_t propId)
88          generates (StatusCode status);
89
90  /**
91   * Print out debugging state for the vehicle hal.
92   *
93   * The text must be in ASCII encoding only.
94   *
95   * Performance requirements:
96   *
97   * The HAL must return from this call in less than 10ms. This call must avoid
98   * deadlocks, as it may be called at any point of operation. Any synchronization
99   * primitives used (such as mutex locks or semaphores) must be acquired
100   * with a timeout.
101   *
102   */
103  debugDump() generates (string s);
104};
105