Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 273c6d20 authored by Hridya Valsaraju's avatar Hridya Valsaraju
Browse files

Add IGnssConfiguration Interface 

Bug: 31974439
Test: On enabling additional logging on the conventional GNSS HAL,
it could be seen via logs that the config parameters were getting
set correctly.

Change-Id: I2cb35fbd3484035b0b1ffba8675951be400fd40c
parent 97ecaa0a

gnss/1.0/Android.bp

+8 −0
Original line number Diff line number Diff line
@@ -12,6 +12,7 @@ genrule { 
        "IAGnssRilCallback.hal",

        "IGnss.hal",

        "IGnssCallback.hal",

        "IGnssConfiguration.hal",

        "IGnssDebug.hal",

        "IGnssGeofenceCallback.hal",

        "IGnssGeofencing.hal",
@@ -32,6 +33,7 @@ genrule { 
        "android/hardware/gnss/1.0/AGnssRilCallbackAll.cpp",

        "android/hardware/gnss/1.0/GnssAll.cpp",

        "android/hardware/gnss/1.0/GnssCallbackAll.cpp",

        "android/hardware/gnss/1.0/GnssConfigurationAll.cpp",

        "android/hardware/gnss/1.0/GnssDebugAll.cpp",

        "android/hardware/gnss/1.0/GnssGeofenceCallbackAll.cpp",

        "android/hardware/gnss/1.0/GnssGeofencingAll.cpp",
@@ -58,6 +60,7 @@ genrule { 
        "IAGnssRilCallback.hal",

        "IGnss.hal",

        "IGnssCallback.hal",

        "IGnssConfiguration.hal",

        "IGnssDebug.hal",

        "IGnssGeofenceCallback.hal",

        "IGnssGeofencing.hal",
@@ -102,6 +105,11 @@ genrule { 
        "android/hardware/gnss/1.0/BnGnssCallback.h",

        "android/hardware/gnss/1.0/BpGnssCallback.h",

        "android/hardware/gnss/1.0/BsGnssCallback.h",

        "android/hardware/gnss/1.0/IGnssConfiguration.h",

        "android/hardware/gnss/1.0/IHwGnssConfiguration.h",

        "android/hardware/gnss/1.0/BnGnssConfiguration.h",

        "android/hardware/gnss/1.0/BpGnssConfiguration.h",

        "android/hardware/gnss/1.0/BsGnssConfiguration.h",

        "android/hardware/gnss/1.0/IGnssDebug.h",

        "android/hardware/gnss/1.0/IHwGnssDebug.h",

        "android/hardware/gnss/1.0/BnGnssDebug.h",

gnss/1.0/IGnss.hal

+8 −0
Original line number Diff line number Diff line
@@ -19,6 +19,7 @@ package android.hardware.gnss@1.0; 
import IAGnss;

import IAGnssRil;

import IGnssCallback;

import IGnssConfiguration;

import IGnssDebug;

import IGnssMeasurement;

import IGnssNavigationMessage;
@@ -204,6 +205,13 @@ interface IGnss { 
     */

    getExtensionXtra() generates (IGnssXtra xtraIface);



    /*

     * This method returns the IGnssConfiguration interface.

     *

     * @return gnssConfigIface Handle to the IGnssConfiguration interface.

     */

    getExtensionGnssConfiguration() generates (IGnssConfiguration gnssConfigIface);



    /*

     * This method returns the IGnssDebug interface.

     *

gnss/1.0/IGnssConfiguration.hal

0 → 100644
+149 −0
Original line number Diff line number Diff line 
/*

 * Copyright (C) 2016 The Android Open Source Project

 *

 * Licensed under the Apache License, Version 2.0 (the "License");

 * you may not use this file except in compliance with the License.

 * You may obtain a copy of the License at

 *

 *      http://www.apache.org/licenses/LICENSE-2.0

 *

 * Unless required by applicable law or agreed to in writing, software

 * distributed under the License is distributed on an "AS IS" BASIS,

 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

 * See the License for the specific language governing permissions and

 * limitations under the License.

 */



package android.hardware.gnss@1.0;



/*

 * Interface for passing GNSS configuration info from platform to HAL.

 */

interface IGnssConfiguration {

    /*

     * Enum which holds the bit masks for SUPL_MODE configuration parameter.

     */

    enum SuplMode : uint8_t {

        /* Mobile Station Based */

        MSB = 0x01,



        /* Mobile Station Assisted */

        MSA = 0x02

    };



    /*

     * Enum which holds the bit masks for GPS_LOCK configuration parameter.

     */

    enum GpsLock : uint8_t {

        /* Lock Mobile Originated GPS functionalitues. */

        MO    =  0x01,



        /* Lock Network initiated GPS functionalities. */

        NI    =  0x02

    };



    /*

     * Enum that hold the bit masks for various LTE Positioning Profile settings (LPP_PROFILE

     * configuration parameter). If none of the bits in the enum are set, the default setting is

     * Radio Resource Location Protocol(RRLP).

     */

    enum LppProfile : uint8_t {

        /* Enable LTE Positioning Protocol user plane */

        USER_PLANE          = 0x01,



        /* Enable LTE Positioning Protocol Control plane */

        CONTROL_PLANE       = 0x02

    };



    /*

     * Enum which holds the bit masks for A_GLONASS_POS_PROTOCOL_SELECT

     * configuration parameter.

     */

    enum GlonassPosProtocol : uint8_t {

        /* Radio Resource Control(RRC) control-plane. */

        RRC_CPLANE                  = 0x01,



        /* Radio Resource Location user-plane. */

        RRLP_CPLANE                 = 0x02,



        /* LTE Positioning Protocol User plane */

        LPP_UPLANE                  = 0x04

    };



    /*

     * IMPORTANT: GNSS HAL must expect the below methods to be called multiple

     * times. They can be called even when GnssLocationProvider is already

     * constructed and enabled. GNSS HAL must maintain the existing requests

     * for various callbacks regardless the change in configuration data.

     */



     /*

      * This method enables or disables emergency SUPL.

      *

      * @param enabled True if emergency SUPL is to be enabled.

      *

      * @return success True if operation was successful.

      */

     setSuplEs(bool enabled) generates (bool success);



     /*

      * This method sets the SUPL version requested by Carrier. The GNSS HAL

      * must use this version of the SUPL protocol if supported.

      *

      * @param version SUPL version requested by carrier. This is a bit mask

      * with bits 0:7 representing a service indicator field, bits 8:15

      * representing the minor version and bits 16:23 representing the

      * major version.

      *

      * @return success True if operation was successful.

      */

     setSuplVersion(uint32_t version) generates (bool success);



     /*

      * This method sets the SUPL mode.

      *

      * @param mode Bit mask that specifies the SUPL mode which is set with the SuplMode enum.

      *

      * @return success True if operation was successful.

      */

     setSuplMode(uint8_t mode) generates (bool success);



     /*

      * This setting configures how GPS functionalities should be locked when

      * user turns off GPS On setting.

      *

      * @param lock Bitmask that specifies the GPS functionalities to be be

      * locked as per the GpsLock enum.

      *

      * @return success True if operation was successful.

      */

     setGpsLock(uint8_t lock) generates (bool success);



     /*

      * This method sets the LTE Positioning Profile configuration.

      *

      * @param lppProfile Bitmask that specifies the LTE Positioning Profile

      * configuration to be set as per the LppProfile enum.

      *

      * @return success True if operation was successful.

      */

     setLppProfile(uint8_t lppProfile) generates (bool success);



     /*

      * This method selects positioning protocol on A-Glonass system.

      *

      * @param protocol Bitmask that specifies the positioning protocol to be

      * set as per GlonassPositioningProtocol enum.

      *

      * @return success True if operation was successful.

      */

     setGlonassPositioningProtocol(uint8_t protocol) generates (bool success);



     /*

      * This method configures which PDN to use.

      *

      * @param enable Use emergency PDN if true and regular PDN if false.

      * @return success True if operation was successful.

      */

     setEmergencySuplPdn(bool enable) generates (bool success);

};