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};