{"id":13163,"url":"https://patchwork.libcamera.org/api/patches/13163/?format=json","web_url":"https://patchwork.libcamera.org/patch/13163/","project":{"id":1,"url":"https://patchwork.libcamera.org/api/projects/1/?format=json","name":"libcamera","link_name":"libcamera","list_id":"libcamera_core","list_email":"libcamera-devel@lists.libcamera.org","web_url":"","scm_url":"","webscm_url":""},"msgid":"<20210730103536.81117-6-paul.elder@ideasonboard.com>","date":"2021-07-30T10:35:32","name":"[libcamera-devel,v7,5/9] android: Add infrastructure for determining capabilities and hardware level","commit_ref":null,"pull_url":null,"state":"accepted","archived":false,"hash":"d786c6c32f1d8f914ca1fe524a41a3f177f2560f","submitter":{"id":17,"url":"https://patchwork.libcamera.org/api/people/17/?format=json","name":"Paul Elder","email":"paul.elder@ideasonboard.com"},"delegate":null,"mbox":"https://patchwork.libcamera.org/patch/13163/mbox/","series":[{"id":2291,"url":"https://patchwork.libcamera.org/api/series/2291/?format=json","web_url":"https://patchwork.libcamera.org/project/libcamera/list/?series=2291","date":"2021-07-30T10:35:27","name":"android: Support capability and hardware level detection","version":6,"mbox":"https://patchwork.libcamera.org/series/2291/mbox/"}],"comments":"https://patchwork.libcamera.org/api/patches/13163/comments/","check":"pending","checks":"https://patchwork.libcamera.org/api/patches/13163/checks/","tags":{},"headers":{"Return-Path":"","X-Original-To":"parsemail@patchwork.libcamera.org","Delivered-To":"parsemail@patchwork.libcamera.org","Received":["from lancelot.ideasonboard.com (lancelot.ideasonboard.com\n\t[92.243.16.209])\n\tby patchwork.libcamera.org (Postfix) with ESMTPS id 6AEE8C322E\n\tfor ;\n\tFri, 30 Jul 2021 10:35:58 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 0B5E8687BF;\n\tFri, 30 Jul 2021 12:35:58 +0200 (CEST)","from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id DA54D687CA\n\tfor ;\n\tFri, 30 Jul 2021 12:35:56 +0200 (CEST)","from pyrite.rasen.tech (unknown\n\t[IPv6:2400:4051:61:600:2c71:1b79:d06d:5032])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id 7945989B;\n\tFri, 30 Jul 2021 12:35:55 +0200 (CEST)"],"Authentication-Results":"lancelot.ideasonboard.com;\n\tdkim=fail reason=\"signature verification failed\" (1024-bit key;\n\tunprotected) header.d=ideasonboard.com header.i=@ideasonboard.com\n\theader.b=\"sHljtk9H\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1627641356;\n\tbh=H0mID5rZOzSMlfaY+POUcSbeqquTRz719E8VxID2t+Y=;\n\th=From:To:Cc:Subject:Date:In-Reply-To:References:From;\n\tb=sHljtk9Hw/wJ4ZBw1aYXW9JMZFIzAPY0NtPCdGLCkJ0/Dy/wcbqEpx+kt4/EHjT50\n\tSgPjMrdmx3fa/VXL16HkR4ZObNLXo2fh1qact4+al3l3w5svptIqpnIGFRVQXH3/tv\n\ttBXmnQfbLK0sBwA3bNcdMUNvZ0Ft3ilpCYcciTgk=","From":"Paul Elder ","To":"libcamera-devel@lists.libcamera.org","Date":"Fri, 30 Jul 2021 19:35:32 +0900","Message-Id":"<20210730103536.81117-6-paul.elder@ideasonboard.com>","X-Mailer":"git-send-email 2.27.0","In-Reply-To":"<20210730103536.81117-1-paul.elder@ideasonboard.com>","References":"<20210730103536.81117-1-paul.elder@ideasonboard.com>","MIME-Version":"1.0","Content-Transfer-Encoding":"8bit","Subject":"[libcamera-devel] [PATCH v7 5/9] android: Add infrastructure for\n\tdetermining capabilities and hardware level","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" "},"content":"Add the infrastructure for checking and reporting capabilities. Use\nthese capabilities to determine the hardware level as well.\n\nBug: https://bugs.libcamera.org/show_bug.cgi?id=55\nSigned-off-by: Paul Elder \n\n---\nChanges in v7:\n- use entryContains for the single-presence checks\n- go back to set\n- use the staticMetadata_ member variable instead of passing it\n- return false in the capaibilities detector, with a todo item\n\nChanges in v6:\n- make all args const\n- convert the caps list from set to vector\n\nChanges in v5:\n- change the whole thing to turn on capabilities after they are all\n confirmed, instead of disabling them as conditions are not met\n\nChanges in v4:\n- rebase on camera capabilities refactoring\n- switch to std::set from std::map\n- make hwlevel similar to capabilities\n\nChanges in v3:\n- fix some compiler errors\n- go ahead and initialize the capabilities to true, update the commit\n message accordingly\n\nChanges in v2:\n- add a flag for FULL, since there are a few requirements that are not\n obtained from capabilities alone\n- add burst capture capability, since that is required for FULL as well\n---\n src/android/camera_capabilities.cpp | 202 +++++++++++++++++++++++++---\n src/android/camera_capabilities.h | 11 ++\n 2 files changed, 198 insertions(+), 15 deletions(-)","diff":"diff --git a/src/android/camera_capabilities.cpp b/src/android/camera_capabilities.cpp\nindex 3596b136..b59a854f 100644\n--- a/src/android/camera_capabilities.cpp\n+++ b/src/android/camera_capabilities.cpp\n@@ -7,8 +7,10 @@\n \n #include \"camera_capabilities.h\"\n \n+#include \n #include \n #include \n+#include \n \n #include \n \n@@ -114,8 +116,180 @@ const std::map camera3FormatsMap = {\n \t},\n };\n \n+const std::map\n+hwLevelStrings = {\n+\t{ ANDROID_INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED, \"LIMITED\" },\n+\t{ ANDROID_INFO_SUPPORTED_HARDWARE_LEVEL_FULL, \"FULL\" },\n+\t{ ANDROID_INFO_SUPPORTED_HARDWARE_LEVEL_LEGACY, \"LEGACY\" },\n+\t{ ANDROID_INFO_SUPPORTED_HARDWARE_LEVEL_3, \"LEVEL_3\" },\n+\t{ ANDROID_INFO_SUPPORTED_HARDWARE_LEVEL_EXTERNAL, \"EXTERNAL\" },\n+};\n+\n } /* namespace */\n \n+bool CameraCapabilities::validateManualSensorCapability()\n+{\n+\tconst char *noMode = \"Manual sensor capability unavailable: \";\n+\n+\tif (!staticMetadata_->entryContains(ANDROID_CONTROL_AE_AVAILABLE_MODES,\n+\t\t\t\t\t\t ANDROID_CONTROL_AE_MODE_OFF)) {\n+\t\tLOG(HAL, Info) << noMode << \"missing AE mode off\";\n+\t\treturn false;\n+\t}\n+\n+\tif (!staticMetadata_->entryContains(ANDROID_CONTROL_AE_LOCK_AVAILABLE,\n+\t\t\t\t\t\t ANDROID_CONTROL_AE_LOCK_AVAILABLE_TRUE)) {\n+\t\tLOG(HAL, Info) << noMode << \"missing AE lock\";\n+\t\treturn false;\n+\t}\n+\n+\t/*\n+\t * \\todo Return true here after we satisfy all the requirements:\n+\t * https://developer.android.com/reference/android/hardware/camera2/CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_MANUAL_SENSOR\n+\t * Manual frame duration control\n+\t * android.sensor.frameDuration\n+\t * android.sensor.info.maxFrameDuration\n+\t * Manual exposure control\n+\t * android.sensor.exposureTime\n+\t * android.sensor.info.exposureTimeRange\n+\t * Manual sensitivity control\n+\t * android.sensor.sensitivity\n+\t * android.sensor.info.sensitivityRange\n+\t * Manual lens control (if the lens is adjustable)\n+\t * android.lens.*\n+\t * Manual flash control (if a flash unit is present)\n+\t * android.flash.*\n+\t * Manual black level locking\n+\t * android.blackLevel.lock\n+\t * Auto exposure lock\n+\t * android.control.aeLock\n+\t */\n+\treturn false;\n+}\n+\n+bool CameraCapabilities::validateManualPostProcessingCapability()\n+{\n+\tconst char *noMode = \"Manual post processing capability unavailable: \";\n+\n+\tif (!staticMetadata_->entryContains(ANDROID_CONTROL_AWB_AVAILABLE_MODES,\n+\t\t\t\t\t\t ANDROID_CONTROL_AWB_MODE_OFF)) {\n+\t\tLOG(HAL, Info) << noMode << \"missing AWB mode off\";\n+\t\treturn false;\n+\t}\n+\n+\tif (!staticMetadata_->entryContains(ANDROID_CONTROL_AWB_LOCK_AVAILABLE,\n+\t\t\t\t\t\t ANDROID_CONTROL_AWB_LOCK_AVAILABLE_TRUE)) {\n+\t\tLOG(HAL, Info) << noMode << \"missing AWB lock\";\n+\t\treturn false;\n+\t}\n+\n+\t/*\n+\t * \\todo return true here after we satisfy all the requirements:\n+\t * https://developer.android.com/reference/android/hardware/camera2/CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_MANUAL_POST_PROCESSING\n+\t * Manual tonemap control\n+\t * android.tonemap.curve\n+\t * android.tonemap.mode\n+\t * android.tonemap.maxCurvePoints\n+\t * android.tonemap.gamma\n+\t * android.tonemap.presetCurve\n+\t * Manual white balance control\n+\t * android.colorCorrection.transform\n+\t * android.colorCorrection.gains\n+\t * Manual lens shading map control\n+\t * android.shading.mode\n+\t * android.statistics.lensShadingMapMode\n+\t * android.statistics.lensShadingMap\n+\t * android.lens.info.shadingMapSize\n+\t * Manual aberration correction control (if aberration correction is supported)\n+\t * android.colorCorrection.aberrationMode\n+\t * android.colorCorrection.availableAberrationModes\n+\t * Auto white balance lock\n+\t * android.control.awbLock\n+\t */\n+\treturn false;\n+}\n+\n+bool CameraCapabilities::validateBurstCaptureCapability()\n+{\n+\tcamera_metadata_ro_entry_t entry;\n+\tbool found;\n+\n+\tconst char *noMode = \"Burst capture capability unavailable: \";\n+\n+\tif (!staticMetadata_->entryContains(ANDROID_CONTROL_AE_LOCK_AVAILABLE,\n+\t\t\t\t\t\t ANDROID_CONTROL_AE_LOCK_AVAILABLE_TRUE)) {\n+\t\tLOG(HAL, Info) << noMode << \"missing AE lock\";\n+\t\treturn false;\n+\t}\n+\n+\tif (!staticMetadata_->entryContains(ANDROID_CONTROL_AWB_LOCK_AVAILABLE,\n+\t\t\t\t\t\t ANDROID_CONTROL_AWB_LOCK_AVAILABLE_TRUE)) {\n+\t\tLOG(HAL, Info) << noMode << \"missing AWB lock\";\n+\t\treturn false;\n+\t}\n+\n+\tfound = staticMetadata_->getEntry(ANDROID_SYNC_MAX_LATENCY, &entry);\n+\tif (!found || *entry.data.i32 < 0 || 4 < *entry.data.i32) {\n+\t\tLOG(HAL, Info)\n+\t\t\t<< noMode << \"max sync latency is \"\n+\t\t\t<< (found ? std::to_string(*entry.data.i32) : \"not present\");\n+\t\treturn false;\n+\t}\n+\n+\t/*\n+\t * \\todo return true here after we satisfy all the requirements\n+\t * https://developer.android.com/reference/android/hardware/camera2/CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_BURST_CAPTURE\n+\t */\n+\treturn false;\n+}\n+\n+std::set\n+CameraCapabilities::computeCapabilities()\n+{\n+\tstd::set\n+\t\tcapabilities;\n+\n+\tcapabilities.insert(ANDROID_REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE);\n+\n+\tif (validateManualSensorCapability())\n+\t\tcapabilities.insert(ANDROID_REQUEST_AVAILABLE_CAPABILITIES_MANUAL_SENSOR);\n+\n+\tif (validateManualPostProcessingCapability())\n+\t\tcapabilities.insert(ANDROID_REQUEST_AVAILABLE_CAPABILITIES_MANUAL_POST_PROCESSING);\n+\n+\tif (validateBurstCaptureCapability())\n+\t\tcapabilities.insert(ANDROID_REQUEST_AVAILABLE_CAPABILITIES_BURST_CAPTURE);\n+\n+\tif (rawStreamAvailable_)\n+\t\tcapabilities.insert(ANDROID_REQUEST_AVAILABLE_CAPABILITIES_RAW);\n+\n+\treturn capabilities;\n+}\n+\n+void CameraCapabilities::computeHwLevel(\n+\tconst std::set &caps)\n+{\n+\tcamera_metadata_ro_entry_t entry;\n+\tbool found;\n+\tcamera_metadata_enum_android_info_supported_hardware_level\n+\t\thwLevel = ANDROID_INFO_SUPPORTED_HARDWARE_LEVEL_FULL;\n+\n+\tif (!caps.count(ANDROID_REQUEST_AVAILABLE_CAPABILITIES_MANUAL_SENSOR))\n+\t\thwLevel = ANDROID_INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED;\n+\n+\tif (!caps.count(ANDROID_REQUEST_AVAILABLE_CAPABILITIES_MANUAL_POST_PROCESSING))\n+\t\thwLevel = ANDROID_INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED;\n+\n+\tif (!caps.count(ANDROID_REQUEST_AVAILABLE_CAPABILITIES_BURST_CAPTURE))\n+\t\thwLevel = ANDROID_INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED;\n+\n+\tfound = staticMetadata_->getEntry(ANDROID_SYNC_MAX_LATENCY, &entry);\n+\tif (!found || *entry.data.i32 != 0)\n+\t\thwLevel = ANDROID_INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED;\n+\n+\thwLevel_ = hwLevel;\n+}\n+\n int CameraCapabilities::initialize(std::shared_ptr camera,\n \t\t\t\t int orientation, int facing)\n {\n@@ -851,11 +1025,6 @@ int CameraCapabilities::initializeStaticMetadata()\n \tuint8_t croppingType = ANDROID_SCALER_CROPPING_TYPE_CENTER_ONLY;\n \tstaticMetadata_->addEntry(ANDROID_SCALER_CROPPING_TYPE, croppingType);\n \n-\t/* Info static metadata. */\n-\tuint8_t supportedHWLevel = ANDROID_INFO_SUPPORTED_HARDWARE_LEVEL_LIMITED;\n-\tstaticMetadata_->addEntry(ANDROID_INFO_SUPPORTED_HARDWARE_LEVEL,\n-\t\t\t\t supportedHWLevel);\n-\n \t/* Request static metadata. */\n \tint32_t partialResultCount = 1;\n \tstaticMetadata_->addEntry(ANDROID_REQUEST_PARTIAL_RESULT_COUNT,\n@@ -876,21 +1045,24 @@ int CameraCapabilities::initializeStaticMetadata()\n \tstaticMetadata_->addEntry(ANDROID_REQUEST_MAX_NUM_INPUT_STREAMS,\n \t\t\t\t maxNumInputStreams);\n \n-\tstd::vector availableCapabilities = {\n-\t\tANDROID_REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE,\n-\t};\n-\n-\t/* Report if camera supports RAW. */\n-\tif (rawStreamAvailable_)\n-\t\tavailableCapabilities.push_back(ANDROID_REQUEST_AVAILABLE_CAPABILITIES_RAW);\n-\n \t/* Number of { RAW, YUV, JPEG } supported output streams */\n \tint32_t numOutStreams[] = { rawStreamAvailable_, 2, 1 };\n \tstaticMetadata_->addEntry(ANDROID_REQUEST_MAX_NUM_OUTPUT_STREAMS,\n \t\t\t\t numOutStreams);\n \n-\tstaticMetadata_->addEntry(ANDROID_REQUEST_AVAILABLE_CAPABILITIES,\n-\t\t\t\t availableCapabilities);\n+\t/* Check capabilities */\n+\tstd::set\n+\t\tcapabilities = computeCapabilities();\n+\tstd::vector\n+\t\tcapsVec(capabilities.begin(), capabilities.end());\n+\tstaticMetadata_->addEntry(ANDROID_REQUEST_AVAILABLE_CAPABILITIES, capsVec);\n+\n+\tcomputeHwLevel(capabilities);\n+\tstaticMetadata_->addEntry(ANDROID_INFO_SUPPORTED_HARDWARE_LEVEL, hwLevel_);\n+\n+\tLOG(HAL, Info)\n+\t\t<< \"Hardware level: \"\n+\t\t<< hwLevelStrings.find(hwLevel_)->second;\n \n \tstd::vector availableCharacteristicsKeys = {\n \t\tANDROID_COLOR_CORRECTION_AVAILABLE_ABERRATION_MODES,\ndiff --git a/src/android/camera_capabilities.h b/src/android/camera_capabilities.h\nindex 42a976d3..c7a966ce 100644\n--- a/src/android/camera_capabilities.h\n+++ b/src/android/camera_capabilities.h\n@@ -42,6 +42,16 @@ private:\n \t\tint androidFormat;\n \t};\n \n+\tbool validateManualSensorCapability();\n+\tbool validateManualPostProcessingCapability();\n+\tbool validateBurstCaptureCapability();\n+\n+\tstd::set\n+\t\tcomputeCapabilities();\n+\n+\tvoid computeHwLevel(\n+\t\tconst std::set &caps);\n+\n \tstd::vector\n \tinitializeYUVResolutions(const libcamera::PixelFormat &pixelFormat,\n \t\t\t\t const std::vector &resolutions);\n@@ -56,6 +66,7 @@ private:\n \tint facing_;\n \tint orientation_;\n \tbool rawStreamAvailable_;\n+\tcamera_metadata_enum_android_info_supported_hardware_level hwLevel_;\n \n \tstd::vector streamConfigurations_;\n \tstd::map formatsMap_;\n","prefixes":["libcamera-devel","v7","5/9"]}