Update doc in Gnss Hal v1.1

Bug: 74949950
Fixes: 74949950
Test: N/A
Change-Id: I863445417d785c0b346ec96383adfd2366dbd71b
This commit is contained in:
Yu-Han Yang
2018-03-14 19:19:11 -07:00
parent 6483c7cbc9
commit 5d21ab2cc1
3 changed files with 18 additions and 15 deletions

View File

@@ -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

View File

@@ -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.
*/

View File

@@ -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