Merge "Update Documentation for EPOCH_TIME." into sc-qpr1-dev

This commit is contained in:
TreeHugger Robot
2021-08-20 19:29:27 +00:00
committed by Android (Google) Code Review
3 changed files with 22 additions and 9 deletions

View File

@@ -1025,7 +1025,7 @@ const ConfigDeclaration kVehicleProperties[]{
.config = .config =
{ {
.prop = toInt(VehicleProperty::EPOCH_TIME), .prop = toInt(VehicleProperty::EPOCH_TIME),
.access = VehiclePropertyAccess::READ_WRITE, .access = VehiclePropertyAccess::WRITE,
.changeMode = VehiclePropertyChangeMode::ON_CHANGE, .changeMode = VehiclePropertyChangeMode::ON_CHANGE,
}, },
}, },

View File

@@ -1433,17 +1433,29 @@ enum VehicleProperty : int32_t {
* This value denotes the number of milliseconds seconds that have * This value denotes the number of milliseconds seconds that have
* elapsed since 1/1/1970 UTC. * elapsed since 1/1/1970 UTC.
* *
* Reading this value will give you the systems time. This can be * AAOS will write to this value to give VHAL the Android system's time,
* useful to synchronize other vehicle systems (dash clock etc). * if the VHAL supports this property. This can be useful to synchronize
* other vehicle systems (dash clock etc) with Android's time.
* *
* Writing this value will update the ExternalTimeSuggestion * AAOS writes to this property once during boot, and
* value (if enabled). This value may be consumed by the “Time * will thereafter write only when some time-source changes are propagated.
* Detector Service”, if other sources do not have a higher * AAOS will fill in VehiclePropValue.timestamp correctly.
* priority. For information on how to adjust time source * Note that AAOS will not send updates for natural elapse of time.
* priorities see Time Detector Service documentation. * int64Values[0] = provided Unix time (in milliseconds)
*
* Note that the property may take >0 ms to get propagated through the stack
* and, having a timestamped property helps reduce any time drift. So,
* for all writes to the property, the timestamp can be used to negate this
* drift:
* drift = currentTimeMillis - PropValue.timestamp
* effectiveTime = PropValue.value.int64Values[0] + diff
*
* Aside, this property could have been better named ANDROID_EPOCH_TIME, but it
* continues to be called EPOCH_TIME for legacy reasons. We will try to fix
* this naming discrepancy when we migrate to AIDL.
* *
* @change_mode VehiclePropertyChangeMode:ON_CHANGE * @change_mode VehiclePropertyChangeMode:ON_CHANGE
* @access VehiclePropertyAccess:READ_WRITE * @access VehiclePropertyAccess:WRITE_ONLY
* @unit VehicleUnit:MILLI_SECS * @unit VehicleUnit:MILLI_SECS
*/ */
EPOCH_TIME = ( EPOCH_TIME = (

View File

@@ -898,5 +898,6 @@ ea465970e96d9605ee6f6706b3b512726c66d2644738added9128c739f8f8b0c android.hardwar
c8a57364f6ad20842be14f4db284df5304f7521ca8eac6bcc1fa6c5b466fb8a6 android.hardware.wifi.supplicant@1.4::ISupplicantStaNetwork c8a57364f6ad20842be14f4db284df5304f7521ca8eac6bcc1fa6c5b466fb8a6 android.hardware.wifi.supplicant@1.4::ISupplicantStaNetwork
2123482b69f3b531c88023aa2a007110e130efbf4ed68ac9ce0bc55d5e82bc8b android.hardware.wifi.supplicant@1.4::ISupplicantStaNetworkCallback 2123482b69f3b531c88023aa2a007110e130efbf4ed68ac9ce0bc55d5e82bc8b android.hardware.wifi.supplicant@1.4::ISupplicantStaNetworkCallback
0821f516e4d428bc15251969f7e19411c94d8f2ccbd99e1fc8168d8e49e38b0f android.hardware.wifi.supplicant@1.4::types 0821f516e4d428bc15251969f7e19411c94d8f2ccbd99e1fc8168d8e49e38b0f android.hardware.wifi.supplicant@1.4::types
4a087a308608d146b022ebc15633de989f5f4dfe1491a83fa41763290a82e40d android.hardware.automotive.vehicle@2.0::types
# There should be no more HIDL HALs - please use AIDL instead. # There should be no more HIDL HALs - please use AIDL instead.