介紹

Raspberry Pi 5 是一款功能強大的單板電腦，非常適合進行計算機視覺相關的應用。本教學將介紹如何在 Raspberry Pi 5 上安裝 OpenCV，涵蓋三種安裝方法以及使用安裝腳本的詳細步驟。

方法一：使用 APT 套件管理器安裝

這是最簡單且快速的安裝方式，適合不需要最新版本 OpenCV 的使用者。

步驟：

1. 更新系統套件清單：

   sudo apt update
               

2. 安裝 OpenCV 及相關套件：

   sudo apt install libopencv-dev python3-opencv
               

3. 驗證安裝：

   python3 -c "import cv2; print(cv2.__version__)"
               

   若成功顯示 OpenCV 的版本號，表示安裝成功。

優點：

• 安裝快速且簡單。

缺點：

• APT 套件庫中的 OpenCV 版本可能較舊，無法使用最新功能。

方法二：使用 PIP 在虛擬環境中安裝

此方法可安裝較新的 OpenCV 版本，並避免與系統其他套件產生衝突。

步驟：

1. 安裝 Python3 及虛擬環境工具：

   sudo apt update
   sudo apt install python3-venv python3-pip
               

2. 建立虛擬環境：

   python3 -m venv opencv-env
               

3. 啟動虛擬環境：

   source opencv-env/bin/activate
               

4. 在虛擬環境中安裝 OpenCV：

   pip install opencv-python opencv-python-headless
               

5. 驗證安裝：

   python -c "import cv2; print(cv2.__version__)"
               

   若成功顯示 OpenCV 的版本號，表示安裝成功。
6. 退出虛擬環境：

   deactivate
               

優點：

• 可安裝較新的 OpenCV 版本。
• 避免與系統其他套件產生衝突。

缺點：

• 需要管理虛擬環境，對新手可能稍具挑戰性。

方法三：從原始碼編譯安裝

此方法可自訂安裝選項，並確保獲取最新版本的 OpenCV，但過程較為複雜且耗時。

步驟：

1. 更新系統套件清單並安裝必要的依賴項：

   sudo apt update
   sudo apt upgrade -y
   sudo apt install build-essential cmake git pkg-config libjpeg-dev libtiff-dev libpng-dev
   sudo apt install libavcodec-dev libavformat-dev libswscale-dev libv4l-dev
   sudo apt install libxvidcore-dev libx264-dev
   sudo apt install libgtk2.0-dev libgtk-3-dev
   sudo apt install libatlas-base-dev gfortran
   sudo apt install python3-dev python3-numpy
               

2. 下載 OpenCV 及其擴充模組的原始碼：

   cd ~
   git clone https://github.com/opencv/opencv.git
   git clone https://github.com/opencv/opencv_contrib.git
               

3. 建立編譯目錄並配置 CMake：

   cd ~/opencv
   mkdir build
   cd build
   cmake -D CMAKE_BUILD_TYPE=RELEASE \
         -D CMAKE_INSTALL_PREFIX=/usr/local \
         -D OPENCV_EXTRA_MODULES_PATH=~/opencv_contrib/modules \
         -D ENABLE_NEON=ON \
         -D ENABLE_VFPV3=ON \
         -D BUILD_TESTS=OFF \
         -D INSTALL_PYTHON_EXAMPLES=OFF \
         -D BUILD_EXAMPLES=OFF ..
               

4. 編譯 OpenCV：

   make -j$(nproc)
               

5. 安裝 OpenCV：

   sudo make install
   sudo ldconfig
               

6. 驗證安裝：

   python3 -c "import cv2; print(cv2.__version__)"
               

   若成功顯示 OpenCV 的版本號，表示安裝成功。

優點：

• 可獲取最新版本的 OpenCV。
• 可自訂編譯選項以符合特定需求。

缺點：

• 過程複雜且耗時。
• 需要更多的系統資源。

使用安裝腳本

Q-engineering 提供了一個安裝腳本，簡化安裝流程。以下是使用腳本的步驟：

1. 檢查可用記憶體：

   free -m
               

2. 下載腳本：

   wget https://github.com/Qengineering/Install-OpenCV-Raspberry-Pi-64-bits/raw/main/OpenCV-4-10-0.sh
               

3. 設定腳本執行權限：

   sudo chmod 755 ./OpenCV-4-10-0.sh
               

4. 執行腳本：

   ./OpenCV-4-10-0.sh