CVML CI Tests

[sreeram-11]

User Actions

Windows

• CMake installed and available on PATH
• Git installed and available on PATH
• Git LFS installed and available on PATH
• OpenCV 4.11 install (https://opencv.org/releases)
• OPENCV_INSTALL_ROOT env variable set to the OpenCV install root
  • Run the following in ADMIN Powershell:
  • [System.Environment]::SetEnvironmentVariable("OPENCV_INSTALL_ROOT", "C:\Users\user\opencv", "Machine")
  • Reboot the machine after running the above command
• OpenCV_DIR env variable set to point to OpenCVConfig.cmake
  • Run the following in ADMIN Powershell:
  • [System.Environment]::SetEnvironmentVariable("OpenCV_DIR", "C:\Users\user\opencv\build\x64\vc16\lib", "Machine") echo $env:OpenCV_DIR
  • Reboot the machine after running the above command
• Ryzen AI NPU driver (Download from https://ryzenai.docs.amd.com/en/latest/inst.html)
• Visual Studio 2022 Desktop Development with C++ workload

Linux

• CMake installed and available on PATH
• Git installed and available on PATH
• Git LFS installed and available on PATH
  • sudo apt install -y git git-lfs
  • Initialize: git lfs install
  • Verify with git lfs version
• OpenCV 4.11 installed
• OPENCV_INSTALL_ROOT env variable set to the OpenCV install root
  • echo 'export OPENCV_INSTALL_ROOT=/opt/opencv' | sudo tee /etc/profile.d/opencv.sh
  • Then, reload it source /etc/profile.d/opencv.sh or reboot/log out and back in
• OpenCV_DIR env variable set to point to OpenCVConfig.cmake
  • echo 'export OpenCV_DIR=/opt/opencv/lib/cmake/opencv4' | sudo tee /etc/profile.d/opencv.sh
  • Then, reload it source /etc/profile.d/opencv.sh or reboot/log out and back in
• Ryzen AI NPU driver
• Vulkan SDK
  • Follow README instructions
  • Verify with vulkaninfo --summary and glslc –version

What CI Tests Validate

1. Ensure prerequisites are installed and present:
   • Git
   • Git LFS
   • CMake
   • OPENCV_INSTALL_ROOT env var set
   • OpenCV_DIR env var set
   • Visual Studio 2022 Desktop Development with C++ workload installed (Windows only)
   • Vulkan SDK tools installed (Linux only)
2. Clone https://github.com/amd/RyzenAI-SW.git
3. Run git lfs pull so large CVML binaries are downloaded
4. Check that Linux CVML runtime files are real binaries, not Git LFS placeholder files after navigating into RyzenAI-SW/Ryzen-AI-CVML-Library
5. Build the CVML sample apps with CMake
6. Confirm these executables exist:
   • cvml-sample-face-detection
   • cvml-sample-depth-estimation
   • cvml-sample-face-mesh
7. Add CVML runtime libraries and XRT libraries to LD_LIBRARY_PATH
8. Use assets/sample_face.jpg from the playbook repo and run face detection with the default model
9. Run face detection again with -m precise
10. Confirm output images were created and are not empty

IMP INFO (README to be updated by author)

1. OpenCV_DIR must be configured as follows:

   • Windows: C:\Users\user\opencv\build\x64\vc16\lib
   • Linux: echo 'export OpenCV_DIR=/opt/opencv/lib/cmake/opencv4' | sudo tee /etc/profile.d/opencv.sh

2. The setup instructions should be updated to include proper configuration of the environment variables:

   • OpenCV_DIR
   • OPENCV_INSTALL_ROOT
     This should match the steps described under User Actions.

3. OpenCV 4.11 installation:

   • Windows: Install using the official OpenCV releases page: https://opencv.org/releases
   • Linux: Installation instructions have been added to dependencies/opencv.md.