Merge "Clarify when IGnss.hal cleanup() and setCallback() methods are called" into qt-dev (4eaf8410) · Commits · e / os / android_hardware_interfaces

current.txt

+2 −0

Original line number	Diff line number	Diff line
		@@ -393,8 +393,10 @@ f8a19622cb0cc890913b1ef3e32b675ffb26089a09e02fef4056ebad324d2b5d android.hardwar
		23780340c686ee86986aa5a9755c2d8566224fed177bbb22a5ebf06be574b60c android.hardware.camera.metadata@3.3::types
		05d1ee760d81cdd2dc7a70ce0241af9fa830edae33b4be83d9bf5fffe05ddc6f android.hardware.camera.provider@2.4::ICameraProvider
		da33234403ff5d60f3473711917b9948e6484a4260b5247acdafb111193a9de2 android.hardware.configstore@1.0::ISurfaceFlingerConfigs
		ede69710c3a95c2cbe818e6c8bb72c7816823face5fc21c17731b26f41d94d65 android.hardware.gnss@1.0::IGnss
		21165b8e30c4b2d52980e4728f661420adc16e38bbe73476c06b2085be908f4c android.hardware.gnss@1.0::IGnssCallback
		d702fb01dc2a0733aa820b7eb65435ee3334f75632ef880bafd2fb8803a20a58 android.hardware.gnss@1.0::IGnssMeasurementCallback
		b5f1f4c1bd6de71a8e71d70f57cdab904ac024a12f3dee3e2173770a4583bcc2 android.hardware.gnss@1.1::IGnss
		7c7721c0f773fcf422b71a4f558545e9e36acc973e58ca51e5bd53905cf46bc0 android.hardware.graphics.bufferqueue@1.0::IGraphicBufferProducer
		d4fea995378bb4f421b4e24ccf68cad2734ab07fe4f874a126ba558b99df5766 android.hardware.graphics.composer@2.1::IComposerClient
		f7d7cb747dc01a9fdb2d39a80003b4d8df9be733d65f5842198802eb6209db69 android.hardware.graphics.mapper@2.0::IMapper

gnss/1.0/IGnss.hal

+20 −3

Original line number	Diff line number	Diff line
		@@ -75,8 +75,13 @@ interface IGnss {
		};

		/**
		* Opens the interface and provides the callback routines
		* to the implementation of this interface.
		* Opens the interface and provides the callback routines to the implementation of this
		* interface.
		*
		* The framework calls this method to instruct the GPS engine to prepare for serving requests
		* from the framework. The GNSS HAL implementation must respond to all GNSS requests from the
		* framework upon successful return from this method until cleanup() method is called to
		* close this interface.
		*
		* @param callback Callback interface for IGnss.
		*
		@@ -105,6 +110,18 @@ interface IGnss {

		/**
		* Closes the interface.
		*
		* The cleanup() method is called by the framework to tell the GNSS HAL implementation to
		* not expect any GNSS requests in the immediate future - e.g. this may be called when
		* location is disabled by a user setting or low battery conditions. The GNSS HAL
		* implementation must immediately stop responding to any existing requests until the
		* setCallback() method is called again and the requests are re-initiated by the framework.
		*
		* After this method is called, the GNSS HAL implementation may choose to modify GNSS hardware
		* states to save power. It is expected that when setCallback() method is called again to
		* reopen this interface, to serve requests, there may be some minor delays in GNSS response
		* requests as hardware readiness states are restored, not to exceed those that occur on normal
		* device boot up.
		*/
		cleanup();

		@@ -153,7 +170,7 @@ interface IGnss {
		* @param mode Parameter must be one of MS_BASED or STANDALONE.
		* It is allowed by the platform (and it is recommended) to fallback to
		* MS_BASED if MS_ASSISTED is passed in, and MS_BASED is supported.
		* @recurrence GNSS postion recurrence value, either periodic or single.
		* @recurrence GNSS position recurrence value, either periodic or single.
		* @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.

gnss/1.1/IGnss.hal

+6 −1

Original line number	Diff line number	Diff line
		@@ -29,6 +29,11 @@ interface IGnss extends @1.0::IGnss {
		* Opens the interface and provides the callback routines to the implementation of this
		* interface.
		*
		* The framework calls this method to instruct the GPS engine to prepare for serving requests
		* from the framework. The GNSS HAL implementation must respond to all GNSS requests from the
		* framework upon successful return from this method until cleanup() method is called to
		* close this interface.
		*
		* @param callback Callback interface for IGnss.
		*
		* @return success Returns true on success.
		@@ -42,7 +47,7 @@ interface IGnss extends @1.0::IGnss {
		* @param mode Parameter must be one of MS_BASED or STANDALONE. It is allowed by the platform
		* (and it is recommended) to fallback to MS_BASED if MS_ASSISTED is passed in, and MS_BASED
		* is supported.
		* @param recurrence GNSS postion recurrence value, either periodic or single.
		* @param recurrence GNSS position recurrence value, either periodic or single.
		* @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.