ci(runner): Save image from camera

espzav · espzav · commit 2e85b52ee933 · 2025-06-10T14:29:54.000+02:00
diff --git a/.github/ci/runner_camera.py b/.github/ci/runner_camera.py
@@ -0,0 +1,21 @@
+# SPDX-FileCopyrightText: 2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-License-Identifier: Apache-2.0
+
+import cv2
+
+# This will return video from the first webcam on your computer.
+cap = cv2.VideoCapture(0)
+
+# reads frames from a camera
+# ret checks return at each frame
+ret, frame = cap.read()
+if ret:
+    # Save image
+    image_path = "snapshot.jpg"
+    cv2.imwrite(image_path, frame)
+    print(f"Image saved {image_path}")
+else:
+    print("Cannot save image.")
+
+# Close the window / Release webcam
+cap.release()
diff --git a/.github/workflows/build-run-applications.yml b/.github/workflows/build-run-applications.yml
@@ -1,4 +1,4 @@
-name: Build ESP-BSP apps
+name: Build and Run ESP-BSP apps
 
 # This job builds all examples and test_applications in this repo
 # Applications are selected for build based on changes files and dependencies defined in .build-test-rules.yml
@@ -47,30 +47,30 @@ jobs:
           - idf_ver: "latest"
             parallel_count: 5
             parallel_index: 5
-          - idf_ver: "release-v5.1"
-            parallel_count: 2
-            parallel_index: 1
-          - idf_ver: "release-v5.1"
-            parallel_count: 2
-            parallel_index: 2
-          - idf_ver: "release-v5.2"
-            parallel_count: 2
-            parallel_index: 1
-          - idf_ver: "release-v5.2"
-            parallel_count: 2
-            parallel_index: 2
-          - idf_ver: "release-v5.3"
-            parallel_count: 2
-            parallel_index: 1
-          - idf_ver: "release-v5.3"
-            parallel_count: 2
-            parallel_index: 2
-          - idf_ver: "release-v5.4"
-            parallel_count: 2
-            parallel_index: 1
-          - idf_ver: "release-v5.4"
-            parallel_count: 2
-            parallel_index: 2
+          #- idf_ver: "release-v5.1"
+          #  parallel_count: 2
+          #  parallel_index: 1
+          #- idf_ver: "release-v5.1"
+          #  parallel_count: 2
+          #  parallel_index: 2
+          #- idf_ver: "release-v5.2"
+          #  parallel_count: 2
+          #  parallel_index: 1
+          #- idf_ver: "release-v5.2"
+          #  parallel_count: 2
+          #  parallel_index: 2
+          #- idf_ver: "release-v5.3"
+          #  parallel_count: 2
+          #  parallel_index: 1
+          #- idf_ver: "release-v5.3"
+          #  parallel_count: 2
+          #  parallel_index: 2
+          #- idf_ver: "release-v5.4"
+          #  parallel_count: 2
+          #  parallel_index: 1
+          #- idf_ver: "release-v5.4"
+          #  parallel_count: 2
+          #  parallel_index: 2
     runs-on: ubuntu-latest
     container: espressif/idf:${{ matrix.idf_ver }}
     steps:
@@ -124,60 +124,60 @@ jobs:
           - runs-on: "esp-box-3"
             marker: "esp_box_3"
             target: "esp32s3"
-          - runs-on: "esp32_c3_lcdkit"
-            marker: "esp32_c3_lcdkit"
-            target: "esp32c3"
-          - runs-on: "esp32_p4_box"
-            marker: "esp32_p4_box"
-            target: "esp32p4"
-          - runs-on: "esp32_p4_function_ev_board"
-            marker: "esp32_p4_function_ev_board"
-            target: "esp32p4"
-          - runs-on: "esp32_s3_eye"
-            marker: "esp32_s3_eye"
-            target: "esp32s3"
-          - runs-on: "esp32_s3_lcd_ev_board"
-            marker: "esp32_s3_lcd_ev_board"
-            target: "esp32s3"
-          - runs-on: "esp32_s3_lcd_ev_board"
-            marker: "esp32_s3_lcd_ev_board_2"
-            target: "esp32s3"
-          - runs-on: "esp32_s3_usb_otg"
-            marker: "esp32_s3_usb_otg"
-            target: "esp32s3"
-          - runs-on: "esp_wrover_kit"
-            marker: "esp_wrover_kit"
-            target: "esp32"
-          - runs-on: "m5dial"
-            marker: "m5dial"
-            target: "esp32s3"
-          - runs-on: "m5stack_core"
-            marker: "m5stack_core"
-            target: "esp32"
-          - runs-on: "m5stack_core_2"
-            marker: "m5stack_core_2"
-            target: "esp32"
-          - runs-on: "m5stack_core_s3"
-            marker: "m5stack_core_s3"
-            target: "esp32s3"
-          - runs-on: "m5stack_core_s3"
-            marker: "m5stack_core_s3_se"
-            target: "esp32s3"
-          - runs-on: "esp32_azure_iot_kit"
-            marker: "esp32_azure_iot_kit"
-            target: "esp32"
-          - runs-on: "esp_bsp_devkit"
-            marker: "esp_bsp_devkit"
-            target: "esp32s3"
-          - runs-on: "esp_bsp_generic"
-            marker: "esp_bsp_generic"
-            target: "esp32s3"
-          - runs-on: "esp32_s3_korvo_2"
-            marker: "esp32_s3_korvo_2"
-            target: "esp32s3"
-          - runs-on: "m5_atom_s3"
-            marker: "m5_atom_s3"
-            target: "esp32s3"
+          #- runs-on: "esp32_c3_lcdkit"
+          #  marker: "esp32_c3_lcdkit"
+          #  target: "esp32c3"
+          #- runs-on: "esp32_p4_box"
+          #  marker: "esp32_p4_box"
+          #  target: "esp32p4"
+          #- runs-on: "esp32_p4_function_ev_board"
+          #  marker: "esp32_p4_function_ev_board"
+          #  target: "esp32p4"
+          #- runs-on: "esp32_s3_eye"
+          #  marker: "esp32_s3_eye"
+          #  target: "esp32s3"
+          #- runs-on: "esp32_s3_lcd_ev_board"
+          #  marker: "esp32_s3_lcd_ev_board"
+          #  target: "esp32s3"
+          #- runs-on: "esp32_s3_lcd_ev_board"
+          #  marker: "esp32_s3_lcd_ev_board_2"
+          #  target: "esp32s3"
+          #- runs-on: "esp32_s3_usb_otg"
+          #  marker: "esp32_s3_usb_otg"
+          #  target: "esp32s3"
+          #- runs-on: "esp_wrover_kit"
+          #  marker: "esp_wrover_kit"
+          #  target: "esp32"
+          #- runs-on: "m5dial"
+          #  marker: "m5dial"
+          #  target: "esp32s3"
+          #- runs-on: "m5stack_core"
+          #  marker: "m5stack_core"
+          #  target: "esp32"
+          #- runs-on: "m5stack_core_2"
+          #  marker: "m5stack_core_2"
+          #  target: "esp32"
+          #- runs-on: "m5stack_core_s3"
+          #  marker: "m5stack_core_s3"
+          #  target: "esp32s3"
+          #- runs-on: "m5stack_core_s3"
+          #  marker: "m5stack_core_s3_se"
+          #  target: "esp32s3"
+          #- runs-on: "esp32_azure_iot_kit"
+          #  marker: "esp32_azure_iot_kit"
+          #  target: "esp32"
+          #- runs-on: "esp_bsp_devkit"
+          #  marker: "esp_bsp_devkit"
+          #  target: "esp32s3"
+          #- runs-on: "esp_bsp_generic"
+          #  marker: "esp_bsp_generic"
+          #  target: "esp32s3"
+          #- runs-on: "esp32_s3_korvo_2"
+          #  marker: "esp32_s3_korvo_2"
+          #  target: "esp32s3"
+          #- runs-on: "m5_atom_s3"
+          #  marker: "m5_atom_s3"
+          #  target: "esp32s3"
     env:
       TEST_RESULT_NAME: test_results_${{ matrix.runner.target }}_${{ matrix.runner.marker }}_${{ matrix.idf_ver }}
       BENCHMARK_RESULT_NAME: benchmark_${{ matrix.runner.target }}_${{ matrix.runner.marker }}_${{ matrix.idf_ver }}
@@ -197,7 +197,8 @@ jobs:
         env:
           PIP_EXTRA_INDEX_URL: "https://dl.espressif.com/pypi/"
         run: |
-          pip install --prefer-binary cryptography pytest-embedded pytest-embedded-serial-esp pytest-embedded-idf pytest-custom_exit_code
+          pip install --prefer-binary cryptography pytest-embedded pytest-embedded-serial-esp pytest-embedded-idf pytest-custom_exit_code opencv-python numpy
+          apt-get update && apt-get install -y libgl1
       - name: Download latest results
         uses: actions/download-artifact@v4
         with:
@@ -216,6 +217,7 @@ jobs:
             benchmark_*.md
             benchmark_*.json
             benchmark.json
+            *.jpg
       - name: Check if benchmark files exist
         id: check_files
         run: |
diff --git a/conftest.py b/conftest.py
@@ -1,6 +1,8 @@
-# SPDX-FileCopyrightText: 2024 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2024-2025 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: Apache-2.0
 import pytest
+import cv2
+from pathlib import Path
 
 
 def pytest_generate_tests(metafunc):
@@ -38,3 +40,45 @@ def pytest_collection_modifyitems(config, items):
         marker_option = "[" + config.getoption("-m") + "]"
         if marker_option not in item.nodeid:
             item.add_marker(pytest.mark.skip(reason="Not for selected params"))
+
+
+def bsp_capture_image(image_path, board):
+    # Return video from the first webcam on your computer.
+    cap = cv2.VideoCapture(0)
+    # Set FullHD resolution (1920x1080)
+    cap.set(cv2.CAP_PROP_FRAME_WIDTH, 1920)
+    cap.set(cv2.CAP_PROP_FRAME_HEIGHT, 1080)
+
+    # TODO: Camera calibration
+
+    # reads frames from a camera
+    # ret checks return at each frame
+    ret, frame = cap.read()
+    if ret:
+        # TODO: Camera calibration / Perspective transform
+        # TODO: Change size image
+        # TODO: Crop image for {board}
+
+        # Save image
+        cv2.imwrite(image_path, frame)
+        print(f"Image saved {image_path}")
+    else:
+        print("Cannot save image.")
+
+    # Close the window / Release webcam
+    cap.release()
+
+
+def bsp_test_image(board, example, expectation):
+    image_file = f"snapshot_{board}_{example}.jpg"
+    bsp_capture_image(image_file, board)
+
+
+@pytest.fixture(autouse=True)
+def bsp_test(request):
+    board = request.node.callspec.id
+    path = Path(str(request.node.fspath))
+    test_name = path.parent.name
+    yield
+    print(f"Capturing image for: {board}")
+    bsp_test_image(board, test_name, "")
diff --git a/examples/display/pytest_display.py b/examples/display/pytest_display.py
@@ -1,4 +1,4 @@
-# SPDX-FileCopyrightText: 2023-2024 Espressif Systems (Shanghai) CO LTD
+# SPDX-FileCopyrightText: 2023-2025 Espressif Systems (Shanghai) CO LTD
 # SPDX-License-Identifier: CC0-1.0
 
 import pytest
diff --git a/examples/pytest_helpers.py b/examples/pytest_helpers.py
@@ -0,0 +1,28 @@
+# SPDX-FileCopyrightText: 2025 Espressif Systems (Shanghai) CO LTD
+# SPDX-License-Identifier: Apache-2.0
+import cv2
+
+
+def bsp_capture_image(image_path):
+    # Return video from the first webcam on your computer.
+    cap = cv2.VideoCapture(0)
+    # reads frames from a camera
+    # ret checks return at each frame
+    ret, frame = cap.read()
+    if ret:
+        # TODO: Change size image
+        # TODO: Crop image
+
+        # Save image
+        cv2.imwrite(image_path, frame)
+        print(f"Image saved {image_path}")
+    else:
+        print("Cannot save image.")
+
+    # Close the window / Release webcam
+    cap.release()
+
+
+def bsp_test_image(board, example, expectation):
+    image_file = f"snapshot_{example}_{board}.jpg"
+    bsp_capture_image(image_file)

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# SPDX-FileCopyrightText: 2023-2024 Espressif Systems (Shanghai) CO LTD`
	`1`	`+# SPDX-FileCopyrightText: 2023-2025 Espressif Systems (Shanghai) CO LTD`
`2`	`2`	`# SPDX-License-Identifier: CC0-1.0`
`3`	`3`
`4`	`4`	`import pytest`