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

Commit 5d21ab2c authored by Yu-Han Yang's avatar Yu-Han Yang
Browse files

Update doc in Gnss Hal v1.1 

Bug: 74949950
Fixes: 74949950
Test: N/A
Change-Id: I863445417d785c0b346ec96383adfd2366dbd71b
parent 6483c7cb

current.txt

+2 −2
Original line number Diff line number Diff line
@@ -315,10 +315,10 @@ a3ff916784dce87a56c757ab5c86433f0cdf562280999a5f978a6e8a0f3f19e7 android.hardwar 
7877ff8e4c1e48b825e6e5e66d050288e5656ed535c61cc7830a92ed4a9e1990 android.hardware.drm@1.1::IDrmFactory

fef2f0ebde7704548fb203df46673ceb342272fc4fa9d0af25a980d2584a36e7 android.hardware.drm@1.1::IDrmPlugin

5047a346ecce239404b9020959f60dd467318e9c17b290a6386bc3894df62c3c android.hardware.drm@1.1::types

be794f5df97f134d6dcabb866b250d1305100e7ae07fb253b7841df890b931bb android.hardware.gnss@1.1::IGnss

a830336ac8627d6432cfafb1b884343ad9f885dee0a5323e380e6d3c519156b8 android.hardware.gnss@1.1::IGnss

8ad55bc35bb3a83e65c018bdfde7ae5ebc749ff2bf6b79412ded0bc6c89b97d8 android.hardware.gnss@1.1::IGnssCallback

3c5183d7506010be57e0f748e3640fc2ded1ba955784b6256ba427f4c399591c android.hardware.gnss@1.1::IGnssConfiguration

b054af24fbb70d54cde1fb5cba126809e7c4e863e8f9115dc492321dfbcbc993 android.hardware.gnss@1.1::IGnssMeasurement

1a07d1383e847c3deb696ec7a2c9e33b9683772945660448a010b18063da67a4 android.hardware.gnss@1.1::IGnssMeasurement

83e7a10ff3702147bd7ffa04567b20d407a3b16bbb7705644af44d919afe9103 android.hardware.gnss@1.1::IGnssMeasurementCallback

82da7e7624f72ff1927f48738913e20bee3a513adfe5dc7c4f888176e20376e6 android.hardware.graphics.common@1.1::types

d9b40a5b09962a5a0780b10fe33a4e607e69e2e088fc83de88a584115b7cb1c0 android.hardware.graphics.composer@2.2::IComposer

gnss/1.1/IGnss.hal

+11 −9
Original line number Diff line number Diff line
@@ -46,15 +46,17 @@ interface IGnss extends @1.0::IGnss { 
     * @param minIntervalMs Represents the time between fixes in milliseconds.

     * @param preferredAccuracyMeters Represents the requested fix accuracy in meters.

     * @param preferredTimeMs Represents the requested time to first fix in milliseconds.

     * @param lowPowerMode When true, HAL must make strong tradeoffs to substantially restrict power

     *     use. Specifically, in the case of a several second long minIntervalMs, the GNSS chipset

     *     must not, on average, run power hungry operations like RF and signal searches for more

     *     than one second per interval, and must make exactly one call to gnssSvStatusCb(), and

     *     either zero or one call to GnssLocationCb() at each interval. When false, HAL must

     *     operate in the nominal mode (similar to V1.0 where this flag wasn't present) and is

     *     expected to make power and performance tradoffs such as duty-cycling when signal

     *     conditions are good and more active searches to reacquire GNSS signals when no signals

     *     are present.

     * @param lowPowerMode When true, and IGnss.hal is the only client to the GNSS hardware, the

     *     GNSS hardware must make strong tradeoffs to substantially restrict power use.

     *     Specifically, in the case of a several second long minIntervalMs, the GNSS hardware must

     *     not, on average, run power hungry operations like RF and signal searches for more than

     *     one second per interval, and must make exactly one call to gnssSvStatusCb(), and either

     *     zero or one call to GnssLocationCb() at each interval. When false, HAL must operate in

     *     the nominal mode (similar to V1.0 where this flag wasn't present) and is expected to make

     *     power and performance tradoffs such as duty-cycling when signal conditions are good and

     *     more active searches to reacquire GNSS signals when no signals are present.

     *     When there are additional clients using the GNSS hardware other than IGnss.hal, the GNSS

     *     hardware may operate in a higher power mode, on behalf of those clients.

     *

     * @return success Returns true if successful.

     */

gnss/1.1/IGnssMeasurement.hal

+5 −4
Original line number Diff line number Diff line
@@ -33,10 +33,11 @@ interface IGnssMeasurement extends @1.0::IGnssMeasurement { 
     * @param callback Handle to GnssMeasurement callback interface.

     * @param enableFullTracking If true, GNSS chipset must switch off duty cycling. In such mode

     *     no clock discontinuities are expected and, when supported, carrier phase should be

     *     continuous in good signal conditions. All constellations and frequency bands that the

     *     chipset supports must be reported in this mode. The GNSS chipset is allowed to consume

     *     more power in this mode. If false, API must behave as in HAL V1_0, optimizing power via

     *     duty cycling, constellations and frequency limits, etc.

     *     continuous in good signal conditions. All non-blacklisted, healthy constellations,

     *     satellites and frequency bands that the chipset supports must be reported in this mode.

     *     The GNSS chipset is allowed to consume more power in this mode. If false, API must behave

     *     as in HAL V1_0, optimizing power via duty cycling, constellations and frequency limits,

     *     etc.

     *

     * @return initRet Returns SUCCESS if successful. Returns ERROR_ALREADY_INIT if a callback has

     *     already been registered without a corresponding call to 'close'. Returns ERROR_GENERIC