From ed8ec838138f6659d5e8bee00b4e330a546e6ad4 Mon Sep 17 00:00:00 2001 From: Jayant Chowdhary Date: Wed, 10 Jun 2020 20:07:05 -0700 Subject: [PATCH] Add some updates to documentation regarding concurrent camera operation. - Add documentation about giving hints to camera HAL about concurrent operation before configuring sessions - Limitations on ZOOM_RATIO_RANGE during concurrent operation. Bug: 151891611 Test: builds Change-Id: I79d0bd8be1ed9aa29a1ba080d01833f16eff580c Signed-off-by: Jayant Chowdhary --- camera/provider/2.6/ICameraProvider.hal | 16 ++++++++++------ current.txt | 2 +- 2 files changed, 11 insertions(+), 7 deletions(-) diff --git a/camera/provider/2.6/ICameraProvider.hal b/camera/provider/2.6/ICameraProvider.hal index ed1d31dd57..b8873a6261 100644 --- a/camera/provider/2.6/ICameraProvider.hal +++ b/camera/provider/2.6/ICameraProvider.hal @@ -76,12 +76,16 @@ interface ICameraProvider extends @2.5::ICameraProvider { * configuration settings exposed through camera metadata), should the sum * of resource costs for the combination be <= 100. * - * The lists of camera id combinations returned by this method may contain - * hidden physical camera ids. If a combination does contain hidden physical - * camera ids, the camera framework must be able to open any logical cameras - * that contain these hidden physical camera ids in their - * ANDROID_LOGICAL_MULTI_CAMERA_PHYSICAL_IDS list, in addition to the other - * camera ids advertised in the combination, for concurrent operation. + * For guaranteed concurrent camera operation, the camera framework must call + * ICameraDevice.open() on all devices (intended for concurrent operation), before configuring + * any streams on them. This gives the camera HAL process an opportunity to potentially + * distribute hardware resources better before stream configuration. + * + * Due to potential hardware constraints around internal switching of physical camera devices, + * a device's complete ZOOM_RATIO_RANGE(if supported), may not apply during concurrent + * operation. If ZOOM_RATIO is supported, camera HALs must ensure ZOOM_RATIO_RANGE of + * [1.0, ANDROID_SCALER_AVAILABLE_MAX_DIGITAL_ZOOM] is supported by that device, during + * concurrent operation. * * @return status Status code for the operation * @return cameraIds a list of camera id combinations that support diff --git a/current.txt b/current.txt index e2d14083cc..97df2c24bf 100644 --- a/current.txt +++ b/current.txt @@ -676,7 +676,7 @@ eb90c4d366f05a025d1d1a3672f8b4c3e33e420fa387f73f21b264645bfdf845 android.hardwar a718c8a3acaa938de5a57923e8c4625ed7ca051e05a1d930ba6998557d7b57c8 android.hardware.camera.device@3.6::ICameraOfflineSession a35d5151b48505f06a775b38c0e2e265f80a845d92802324c643565807f81c53 android.hardware.camera.device@3.6::types 02bdf82dba7dce273a554b4474468a8fb1fb4f61ab65da95eb16e080df63fff6 android.hardware.camera.metadata@3.5::types -21086e1c7a2acc0ebe0ff8561b11f3c2009be687a92d79b608a5f00b16c5f598 android.hardware.camera.provider@2.6::ICameraProvider +7d6b362681f4a4fd0be95535d8913d8de9a26f0765c1bdda4bd837dea8c25db6 android.hardware.camera.provider@2.6::ICameraProvider 8f8d9463508ff9cae88eb35c429fd0e2dbca0ca8f5de7fdf836cc0c4370becb6 android.hardware.camera.provider@2.6::ICameraProviderCallback 1edf7aef68ef3bd577a1175b1462fb82e3e39f01c6915dda61fba121028df283 android.hardware.camera.provider@2.6::types c1aa508d00b66ed5feefea398fd5edf28fa651ac89773adad7dfda4e0a73a952 android.hardware.cas@1.2::ICas