1/*
2 * Copyright (C) 2019 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.gnss@2.0;
18
19import @1.0::IGnssBatching;
20import IGnssBatchingCallback;
21
22/**
23 * Extended interface for GNSS Batching support.
24 *
25 * If this interface is supported, this batching request must be able to run in
26 * parallel with, or without, non-batched location requested by the
27 * IGnss start() & stop() - i.e. both requests must be handled independently,
28 * and not interfere with each other.
29 *
30 * For example, if a 1Hz continuous output is underway on the IGnssCallback,
31 * due to an IGnss start() operation,
32 * and then a IGnssBatching start() is called for a location every 10
33 * seconds, the newly added batching request must not disrupt the 1Hz
34 * continuous location output on the IGnssCallback.
35 *
36 * As with GNSS Location outputs, source of location must be GNSS satellite
37 * measurements, optionally using interial and baro sensors to improve
38 * relative motion filtering. No additional absolute positioning information,
39 * such as WiFi derived location, may be mixed with the GNSS information.
40 */
41interface IGnssBatching extends @1.0::IGnssBatching {
42    /**
43     * Opens the interface and provides the callback routines
44     * to the implementation of this interface.
45     *
46     * @param callback Callback interface for IGnssBatching.
47     *
48     * @return success Returns true on success.
49     */
50    init_2_0(IGnssBatchingCallback callback) generates (bool success);
51};