現在2026年4月です。

RaspberryPi Zero2WでIMX585を使えるようにする方法は
双峰エンタプライズ株式会社のダウンロードページにあるのですが、
自分的にはわかりにくかったので、試行錯誤してうまくいく手順を残しておこうと思います。

  1. 準備

    2. https://github.com/will127534/libcamera
    https://github.com/will127534/libcamera/blob/master/src/ipa/rpi/cam_helper/cam_helper_imx585.cpp
    https://github.com/will127534/libcamera/tree/master/src/ipa/rpi/pisp/data
    https://github.com/will127534/libcamera/tree/master/src/ipa/rpi/vc4/data
    辺りに書いてある部分から以下の部分をこのパスで取っておきます。
    imx585_setup_unified_cli.zip に入れました。
    src
└─ipa
    └─rpi
        ├─cam_helper
        │      cam_helper_imx585.cpp
        │
        ├─pisp
        │  └─data
        │          imx585.json
        │          imx585_mono.json
        │
        └─vc4
            └─data
                    imx585.json
                    imx585_mono.json
    新規にmicroSDカードを rpi-imager.exe で作成します。
    デバイス：RaspberryPi Zero2W
    OS:Raspberry Pi OS (64-bit) (bookworm)
    ストレージは、セットアップ後に6.2GBになるので、16GB以上必須です。
    私のように試行錯誤をするなら、できるだけ書込み速度の速いものを使ってください。

  2. 展開

    3. 新しいmicroSDカードで起動したら、ホームにコピーして展開してください。
    何回もやるので、共有フォルダからコピーしやすい様のzipにまとめてダウンロードに置きました。
    imx585_setup_unified_cli.zip
    imx585_setup
│  setup.sh           ・・・・・・・・・OS環境更新設定用
│  imx585_setup_1.sh  ・・・・・・・・・ドライバビルド用
│  imx585_setup_2.sh  ・・・・・・・・・libcameraとrpicam-apps作成用
│  cmdline.txt        ・・・・・・・・・うちの10インチディスプレイ用設定
│  config.txt         ・・・・・・・・・画が出たときのもの
│
└─src
    └─ipa
        └─rpi
            ├─cam_helper
            │      cam_helper_imx585.cpp
            │
            ├─pisp
            │  └─data
            │          imx585.json
            │          imx585_mono.json
            │
            └─vc4
                └─data
                        imx585.json
                        imx585_mono.json

  3. setup.sh

    4. 最初にnanoが開きます。
    Screen Configuration で解像度変更ができないときの対策です。
    解像度に満足なら Ctrl+x で編集せずに抜けてください。
    解像度は cmdline.txt の1行目末あたりを参考にしてください。
    #!/bin/sh
# 初期設定 (共通)
set -eu
sudo nano /boot/firmware/cmdline.txt
sudo apt update
sudo apt upgrade -y
#sudo localectl set-locale LANG=ja_JP.UTF-8
sudo apt install -y fbterm uim-fep uim-mozc unifont
echo "初期設定が完了しました。再起動します。"
sudo reboot

  4. imx585_setup_1.sh

    5. #!/bin/sh
# ドライバ
#
sudo apt install -y dkms
wget https://soho-enterprise.com/wp/wp-content/uploads/2025/06/imx585-v4l2-driver_6_12_y-binning-fix.tgz
tar zxvf imx585-v4l2-driver_6_12_y-binning-fix.tgz
cd imx585-v4l2-driver_6_12_y-binning-fix/
./setup.sh 
reboot

  5. imx585_setup_2.sh

    6. 最後にもnanoが開きます。
    #!/bin/sh
# libcamera / rpicam-apps 作成 (Pi5 / Zero2W 統合・簡潔版)
set -eu

SCRIPT_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
WORK_DIR="$SCRIPT_DIR"
PROFILE=${IMX585_PROFILE:-auto}
TOTAL_MEM=$(free -m | awk '/^Mem:/{print $2}')
MODEL=""
SWAP_CHANGED=0
USE_DPHYS_SWAP=0

if [ -r /proc/device-tree/model ]; then
    MODEL=$(tr -d '\000' < /proc/device-tree/model)
fi

if command -v dphys-swapfile >/dev/null 2>&1 && [ -f /etc/dphys-swapfile ]; then
    USE_DPHYS_SWAP=1
fi

# 実行プロファイルを決定する。
if [ "$PROFILE" = "auto" ]; then
    case "$MODEL" in
        *"Raspberry Pi Zero 2"*) PROFILE="zero2w" ;;
        *"Raspberry Pi 5"*) PROFILE="pi5" ;;
        *)
            if [ "$TOTAL_MEM" -le 1024 ]; then
                PROFILE="zero2w"
            else
                PROFILE="pi5"
            fi
            ;;
    esac
fi

# プロファイル別の設定。
if [ "$PROFILE" = "zero2w" ]; then
    BUILD_JOBS=1
    ENABLE_SWAP_BOOST=1
else
    BUILD_JOBS=$(nproc)
    ENABLE_SWAP_BOOST=0
fi

restore_swap() {
    if [ "$SWAP_CHANGED" -ne 1 ] || [ "$USE_DPHYS_SWAP" -ne 1 ]; then
        return
    fi

    echo "swap 設定を復元します..."
    sudo dphys-swapfile swapoff || true
    sudo sed -i "s/^#*CONF_SWAPSIZE=.*/CONF_SWAPSIZE=${ORIG_SWAPSIZE}/" /etc/dphys-swapfile
    if [ -n "${ORIG_MAXSWAP:-}" ]; then
        sudo sed -i "s/^#*CONF_MAXSWAP=.*/CONF_MAXSWAP=${ORIG_MAXSWAP}/" /etc/dphys-swapfile
    fi
    sudo dphys-swapfile setup || true
    sudo dphys-swapfile swapon || true
}
trap restore_swap EXIT

# Zero2W ではビルド前に swap を一時拡張する。
if [ "$ENABLE_SWAP_BOOST" -eq 1 ] && [ "$USE_DPHYS_SWAP" -eq 1 ]; then
    ORIG_SWAPSIZE=$(sudo awk -F= '/^#*CONF_SWAPSIZE=/{print $2; exit}' /etc/dphys-swapfile)
    ORIG_MAXSWAP=$(sudo awk -F= '/^#*CONF_MAXSWAP=/{print $2; exit}' /etc/dphys-swapfile || true)
    if [ -z "${ORIG_SWAPSIZE:-}" ]; then
        ORIG_SWAPSIZE=100
    fi

    echo "低メモリ向けに swap を一時的に 2048MB へ拡張します..."
    sudo dphys-swapfile swapoff || true
    sudo sed -i 's/^#*CONF_SWAPSIZE=.*/CONF_SWAPSIZE=2048/' /etc/dphys-swapfile
    if sudo grep -q '^#*CONF_MAXSWAP=' /etc/dphys-swapfile; then
        sudo sed -i 's/^#*CONF_MAXSWAP=.*/CONF_MAXSWAP=2048/' /etc/dphys-swapfile
    fi
    sudo dphys-swapfile setup
    sudo dphys-swapfile swapon
    SWAP_CHANGED=1
elif [ "$ENABLE_SWAP_BOOST" -eq 1 ]; then
    echo "dphys-swapfile 設定が無いため、swap 一時拡張をスキップします (zram 運用)。"
fi

echo "Detected model: ${MODEL:-unknown}"
echo "Selected profile: $PROFILE"
echo "Build jobs: $BUILD_JOBS"

sudo apt update
sudo apt install -y \
    cmake dkms dphys-swapfile git meson ninja-build python3-yaml python3-ply \
    libcamera-dev libjpeg-dev libtiff5-dev libpng-dev \
    libavcodec-dev libavdevice-dev libavformat-dev libswresample-dev \
    libopencv-dev libboost-dev libboost-program-options-dev libdrm-dev libexif-dev \
    libgnutls28-dev openssl pybind11-dev \
    libglib2.0-dev libgstreamer-plugins-base1.0-dev

cd "$WORK_DIR"
if [ -d libcamera ]; then
    rm -rf libcamera
fi
git clone https://github.com/raspberrypi/libcamera.git
cd libcamera

# IPA ルートはよく使われる 2 パターンだけを扱う。
IPA_ROOT=""
if [ -d src/ipa/rpi ]; then
    IPA_ROOT="src/ipa/rpi"
elif [ -d ipa/rpi ]; then
    IPA_ROOT="ipa/rpi"
fi

if [ -n "$IPA_ROOT" ] && [ -d "$SCRIPT_DIR/src/ipa/rpi" ]; then
    cp -f "$SCRIPT_DIR/src/ipa/rpi/cam_helper/cam_helper_imx585.cpp" "$IPA_ROOT/cam_helper/" 2>/dev/null || true
    cp -f "$SCRIPT_DIR/src/ipa/rpi/vc4/data/imx585.json" "$IPA_ROOT/vc4/data/" 2>/dev/null || true
    cp -f "$SCRIPT_DIR/src/ipa/rpi/vc4/data/imx585_mono.json" "$IPA_ROOT/vc4/data/" 2>/dev/null || true
    cp -f "$SCRIPT_DIR/src/ipa/rpi/pisp/data/imx585.json" "$IPA_ROOT/pisp/data/" 2>/dev/null || true
    cp -f "$SCRIPT_DIR/src/ipa/rpi/pisp/data/imx585_mono.json" "$IPA_ROOT/pisp/data/" 2>/dev/null || true

    if [ -f "$IPA_ROOT/cam_helper/meson.build" ] && ! grep -Fq "'cam_helper_imx585.cpp'," "$IPA_ROOT/cam_helper/meson.build"; then
        sed -i.bak "14i\\
    'cam_helper_imx585.cpp'," "$IPA_ROOT/cam_helper/meson.build"
    fi

    if [ -f "$IPA_ROOT/vc4/data/meson.build" ] && ! grep -Fq "'imx585.json'," "$IPA_ROOT/vc4/data/meson.build"; then
        sed -i.bak "18i\\
    'imx585.json',\\
    'imx585_mono.json'," "$IPA_ROOT/vc4/data/meson.build"
    fi

    if [ -f "$IPA_ROOT/pisp/data/meson.build" ] && ! grep -Fq "'imx585.json'," "$IPA_ROOT/pisp/data/meson.build"; then
        sed -i.bak "18i\\
    'imx585.json',\\
    'imx585_mono.json'," "$IPA_ROOT/pisp/data/meson.build"
    fi
else
    echo "警告: libcamera の rpi IPA パスが見つからないため、imx585 追加パッチはスキップします。"
fi

MESON_ARGS="--buildtype=release -Dpipelines=rpi/vc4,rpi/pisp -Dipas=rpi/vc4,rpi/pisp -Dv4l2=true -Dgstreamer=enabled -Dtest=false -Dlc-compliance=disabled -Dcam=disabled -Dqcam=disabled -Ddocumentation=disabled -Dpycamera=enabled"
if [ -d build ]; then
    meson setup build --reconfigure $MESON_ARGS
else
    meson setup build $MESON_ARGS
fi
meson compile -C build -j "$BUILD_JOBS"
sudo meson install -C build

cd "$WORK_DIR"
if [ -d rpicam-apps ]; then
    rm -rf rpicam-apps
fi
git clone https://github.com/raspberrypi/rpicam-apps.git
cd rpicam-apps

if [ -d build ]; then
    meson setup build --reconfigure -Denable_libav=enabled -Denable_drm=enabled -Denable_egl=disabled -Denable_qt=disabled -Denable_opencv=enabled -Denable_tflite=disabled -Denable_hailo=disabled
else
    meson setup build -Denable_libav=enabled -Denable_drm=enabled -Denable_egl=disabled -Denable_qt=disabled -Denable_opencv=enabled -Denable_tflite=disabled -Denable_hailo=disabled
fi
meson compile -C build -j "$BUILD_JOBS"
sudo meson install -C build
sudo ldconfig

# config.txt は機種別ブロックで管理する。
BOOT_CONFIG="/boot/firmware/config.txt"
BEGIN_MARK="# IMX585_UNIFIED_BEGIN"
END_MARK="# IMX585_UNIFIED_END"

if sudo grep -q '^#*camera_auto_detect=' "$BOOT_CONFIG"; then
    sudo sed -i 's/^#*camera_auto_detect=.*/camera_auto_detect=0/' "$BOOT_CONFIG"
else
    echo "camera_auto_detect=0" | sudo tee -a "$BOOT_CONFIG" >/dev/null
fi

sudo sed -i 's/^dtoverlay=imx585/#dtoverlay=imx585/' "$BOOT_CONFIG"

TMP_CFG=$(mktemp)
sudo cat "$BOOT_CONFIG" | awk -v begin="$BEGIN_MARK" -v end="$END_MARK" '
    $0 == begin { skip=1; next }
    $0 == end { skip=0; next }
    skip != 1 { print }
' > "$TMP_CFG"

cat <<'EOF' >> "$TMP_CFG"

# IMX585_UNIFIED_BEGIN
# Managed by imx585_setup_unified/imx585_setup_2.sh
[pi5]
### Cam0 ###
dtoverlay=imx585,link-frequency=891000000,cam0
### Cam1 ###
dtoverlay=imx585,link-frequency=891000000

[pi02]
dtoverlay=imx585,2lane,link-frequency=297000000

[all]
# IMX585_UNIFIED_END
EOF

sudo cp "$TMP_CFG" "$BOOT_CONFIG"
rm -f "$TMP_CFG"

cd "$WORK_DIR"
rm -f imx585-v4l2-driver_6_12_y-binning-fix.tgz
rm -rf libcamera
rm -rf rpicam-apps

echo "セットアップが完了しました。再起動します。"
sudo reboot
    cp -r ../src . の部分は git で取って来れるようにしたかったのですがうまくいきませんでした。
    うまくいく方法を知ってる方は教えてください。

  6. 確認

    7. rpicam-hello を実行して画が出ることを確認します。

    rpicam-hello を実行して画が出ることを確認します。
    PiZero2W 
    rpicam-vid -t 0 -n --inline --width 1280 --height 720 --framerate 30 --codec h264 --listen -o tcp://0.0.0.0:8888
    画面を小さくしたほうがいいかもしれません。
    rpicam-vid -t 0 -n --inline --width 640 --height 400 --framerate 30 --codec h264 --listen -o tcp://0.0.0.0:8888
    PCのVLC 
    tcp/h264://192.168.1.18:8888