Fix utitiles readiness for ce-oem-mipi-camera tests (Bugfix) (#2361)

* add camera related utilities check

add camera related utilities check, all capture and recording tests will be skipped if camera related utilities are not available.

* fix issues

fix issues

* revised argument

revised argument

* Apply suggestion from @seankingyang

Co-authored-by: Isaac Yang <47034756+seankingyang@users.noreply.github.com>

* Update contrib/checkbox-ce-oem/checkbox-provider-ce-oem/units/camera/jobs.pxu

Co-authored-by: stanley31huang <stanley.huang@canonical.com>

* fix pep8 issue

fix pep8 issue

---------

Co-authored-by: Isaac Yang <47034756+seankingyang@users.noreply.github.com>

Author: stanley31huang

contrib/checkbox-ce-oem/checkbox-provider-ce-oem/bin/camera_test.py

@@ -35,6 +35,9 @@
     list_device_by_v4l2_ctl,
     check_nonzero_files,
     CameraInterface,
+    GST_LAUNCH_BIN,
+    V4L2_CTL_CMD,
+    MEDIA_CTL_CMD,
 )
 
 logging.basicConfig(
@@ -226,6 +229,9 @@ def register_arguments() -> argparse.Namespace:
         help=("Path of the specified test configuration file."),
     )
 
+    # subparser for readiness
+    subparsers.add_parser("readiness")
+
     # Subparser for testing
     parser_testing = subparsers.add_parser(
         "testing",
@@ -457,6 +463,28 @@ def _run_camera_test(args: argparse.Namespace) -> None:
     _cleanup_artifacts_if_needed(args, artifact_store_path)
 
 
+def readiness_test():
+    result = True
+
+    utilities_mapping = {
+        "gst-launch-1.0": GST_LAUNCH_BIN,
+        "media-ctl": MEDIA_CTL_CMD,
+        "v4l2-ctl": V4L2_CTL_CMD,
+    }
+    for util, binary in utilities_mapping.items():
+        if not binary:
+            result = False
+            logging.error("%s is not available", util)
+        if not os.path.exists(binary):
+            result = False
+            logging.error("%s path is not exists", util)
+        else:
+            logging.info("the location of %s is %s", util, binary)
+
+    if not result:
+        raise SystemExit("the test utilities for camera test are not ready")
+
+
 def main() -> None:
     args = register_arguments()
 
@@ -466,6 +494,11 @@ def main() -> None:
 
     if args.action == "testing":
         _run_camera_test(args)
+        return
+
+    if args.action == "readiness":
+        readiness_test()
+        return
 
 
 if __name__ == "__main__":

contrib/checkbox-ce-oem/checkbox-provider-ce-oem/units/camera/jobs.pxu

@@ -8,6 +8,16 @@ environ: MIPI_SCENARIO_DEFINITION_FILE_PATH
 command:
     camera_test.py generate_resource -sf "$MIPI_SCENARIO_DEFINITION_FILE_PATH"
 
+id: ce-oem-mipi-camera/readiness
+_summary: Verify installation of V4L2 and GStreamer tools
+_description: Checks if the system has the necessary binaries installed to proceed with camera testing.
+estimated_duration: 2s
+category_id: com.canonical.plainbox::camera
+plugin: shell
+environ: GST_LAUNCH_BIN MEDIA_CTL_CMD V4L2_CTL_CMD
+command:
+    camera_test.py readiness
+
 unit: template
 template-engine: jinja2
 template-resource: mipi_camera_resource
@@ -23,14 +33,11 @@ plugin: shell
 category_id: com.canonical.plainbox::camera
 estimated_duration: 10s
 flags: also-after-suspend
+depends: ce-oem-mipi-camera/readiness
 imports:
     from com.canonical.certification import executable
     from com.canonical.plainbox import manifest
 requires:
-    executable.name == "v4l2-ctl"
-    executable.name == "media-ctl"
-    executable.name == "gst-launch-1.0"
-    executable.name == "gst-discoverer-1.0"
     manifest.has_vendor_specific_mipi_camera == "True"
 environ: PLATFORM_NAME MIPI_CAMERA_SETUP_CONF_FILE_PATH
 command:
@@ -51,14 +58,11 @@ plugin: shell
 category_id: com.canonical.plainbox::camera
 estimated_duration: 10s
 flags: also-after-suspend
+depends: ce-oem-mipi-camera/readiness
 imports:
     from com.canonical.certification import executable
     from com.canonical.plainbox import manifest
 requires:
-    executable.name == "v4l2-ctl"
-    executable.name == "media-ctl"
-    executable.name == "gst-launch-1.0"
-    executable.name == "gst-discoverer-1.0"
     manifest.has_vendor_specific_mipi_camera == "True"
 environ: PLATFORM_NAME MIPI_CAMERA_SETUP_CONF_FILE_PATH
 command:

contrib/checkbox-ce-oem/checkbox-provider-ce-oem/units/camera/test-plan.pxu

@@ -21,5 +21,6 @@ _description: Automated tests for MIPI Camera in before suspend and post suspend
 bootstrap_include:
     mipi_camera_resource
 include:
+    ce-oem-mipi-camera/readiness
     ce-oem-mipi-camera/capture-image-scenario
     ce-oem-mipi-camera/record-video-scenario