\n\n

ダウンロード


IMX585/IMX662/IMX678 STARVIS2 image sensor driver DKMS script for all the Raspberrypi boards

配布版(IMX662更新:2026年8月15日)
Raspberry Pi 5で実機検証したIMX585 / IMX662 / IMX678用DKMS配布版です。LCG/HCG自動切替時の明滅を抑えるため、露光時間・アナログゲイン・変換ゲインを同一フレーム境界で反映します。最大1000倍ゲイン対応のlibcamera cam_helper、vc4/pispチューニングJSON、およびインストールマニュアルを同梱しています。

Customer release packages (IMX662 updated 15 August 2026)
These DKMS driver packages for IMX585, IMX662, and IMX678 have been verified on Raspberry Pi 5. Exposure, analogue gain, and LCG/HCG conversion gain are applied at the same frame boundary to suppress brightness flashes during conversion-gain switching. Each package includes the libcamera cam_helper, vc4/pisp tuning JSON files supporting gains up to 1000×, and an installation manual.

IMX662 Bayer/Mono scaling policy (revised 15 August 2026)
Mono版IMX662-AAMRでは隣接画素を加算する2×2 binningを利用できます。Bayer版IMX662-AAQRにも別のセンサーbinning設定がありますが、センサー側でのBayer binningは斜め線や細部にジャギーが目立つ場合があります。本リリースでは画質を優先し、Bayerは1936×1100で読み出して960×540等へPiSPで縮小します。
The monochrome IMX662-AAMR uses 2×2 adjacent-pixel addition. The Bayer IMX662-AAQR has a different sensor-binning configuration, but Bayer sensor binning can make diagonal edges and fine detail appear jagged. To prioritise image quality, this release reads Bayer at 1936×1100 and uses PiSP to scale outputs such as 960×540.

IMX290 / IMX327 / IMX462 custom DKMS driver

IMX290系の共通カスタムDKMSドライバーです。IMX290カラー/モノクロ、IMX327カラー、IMX462カラー/モノクロをoverlayパラメーターで選択できます。LCG/HCG自動切替、切替時のゲイン補償、露光・ゲイン・変換ゲインの同一フレーム反映、最大1000倍ゲイン対応のcam_helperおよびvc4/pisp用JSONを収録しています。r4では、DKMSとoverlayの導入後に、動作確認済みのlibcameraとrpicam-appsをソースからビルドして/usr/localへインストールするスクリプトを追加しました。

This is a shared custom DKMS driver package for the IMX290 sensor family. The Device Tree overlay supports IMX290 color/mono, IMX327 color, and IMX462 color/mono. It includes automatic LCG/HCG switching, gain compensation at the switching point, synchronized exposure/gain/conversion-gain updates, a libcamera cam_helper, and vc4/pisp tuning JSON files supporting gains up to 1000×. Release r4 also builds and installs the validated libcamera and rpicam-apps userspace under /usr/local after the DKMS and overlay installation.

Download: IMX290 / IMX327 / IMX462 custom HCG/LCG DKMS package

簡単な使い方 / Quick start

  1. TGZをRaspberry Piへコピーし、tar xzf imx290-imx327-imx462-hcg-dkms-customer-20260820-r4.tgzで展開します。
  2. cd imx290-hcg-dkms && chmod +x setup.sh build_libcamera.sh uninstall.sh && sudo ./setup.shを実行します。ネットワーク接続が必要で、DKMS、libcamera、rpicam-appsを順に導入します。
  3. /boot/firmware/config.txtcamera_auto_detect=0を設定し、使用センサーと接続ポートに合うoverlayを、cam0用とcam1用に個別の行で指定します。
  4. 再起動後、rpicam-hello --list-camerasで認識を確認します。Raspberry Pi 5は同梱pisp JSON、Raspberry Pi 4はvc4 JSONを使用してください。詳細はTGZ内のINSTALL_MANUAL_JA.mdを参照してください。

IMX462 MONOの10-bit/12-bit表示について
rpicam-hello --list-camerasの見出しに10-bit MONOと表示される場合がありますが、これはrpicam-appsの代表表示上の制限です。Modes欄にR10_CSI2PR12_CSI2Pの両方が表示されていれば、10bit/12bitの両モードを利用できます。12bitを明示する場合は、rpicam-hello --camera 1 -t 0 --viewfinder-mode 1920:1080:12:Pのように指定し、実行ログのSelected sensor format: 1920x1080-Y12_1X12を確認してください。見出し表示の不一致を直すrpicam-appsパッチは、12bit取得機能そのものには不要です。なお、プレビューはISP処理後のYUV画像であり、12bit RAWそのものではありません。

IMX462 MONO 10-bit/12-bit display note
The camera summary may show 10-bit MONO because of a limitation in the representative bit-depth display in rpicam-apps. If both R10_CSI2P and R12_CSI2P appear under Modes, both 10-bit and 12-bit sensor modes are available. To request 12-bit explicitly, use a mode such as --viewfinder-mode 1920:1080:12:P and confirm Selected sensor format: 1920x1080-Y12_1X12 in the runtime log. Patching the summary label is not required for actual 12-bit capture. The displayed preview is ISP-processed YUV, not the 12-bit RAW stream itself.

Raspberry Pi OS Trixie利用時の注意
現行TrixieではOS標準のlibcamera 0.7.1、libpisp 1.5.0、rpicam-apps 1.12.0の組み合わせを使用してください。旧libcamera/libpispを/usr/localへ上書きすると、IMX462 MONOの12bit形式を正しく扱えない場合があります。表示上の10-bit表記だけを変更するパッチは配布版に必須ではありませんが、r4の旧ユーザー空間ビルド処理は現行OS向けに改訂予定です。改訂版公開までは、現行TrixieでDKMSのみを導入する場合、sudo IMX290_SKIP_LIBCAMERA=1 ./setup.shを使用してください。

1000倍ゲイン用JSONの指定 / Selecting the gain-1000 tuning file
本配布版のDKMSドライバーと1000倍対応JSONを組み合わせて使用します。Pi 5では同梱のimx290_gain1000_pisp.json、Pi 4ではimx290_gain1000_vc4.jsonを使用します。標準のIPAディレクトリへimx327.jsonまたはimx462.jsonとして配置すると自動選択されます。明示指定する場合(Pi 5)は、カメラ番号を確認して次のように実行します。
Use the included DKMS driver together with the gain-1000 JSON. Use the pisp file on Pi 5 and the vc4 file on Pi 4. Install it under the detected sensor name for automatic selection, or specify it explicitly as shown below.

rpicam-hello --list-cameras
rpicam-hello --camera 0 -t 0 --tuning-file ~/imx290-hcg-dkms/libcamera-imx290/imx290_gain1000_pisp.json
# Manual 1000x test:
rpicam-hello --camera 0 -t 0 --gain 1000 --tuning-file ~/imx290-hcg-dkms/libcamera-imx290/imx290_gain1000_pisp.json
# IMX290 color (default)
dtoverlay=imx290-hcg
# IMX290 mono
dtoverlay=imx290-hcg,mono
# IMX327 color
dtoverlay=imx290-hcg,imx327
# IMX462 color / mono
dtoverlay=imx290-hcg,imx462
dtoverlay=imx290-hcg,imx462-mono

# Add cam0 and/or 4lane as required, for example:
dtoverlay=imx290-hcg,imx462,4lane,cam0

2025年5月5日現在のIMX585のカメラドライバーおよびlibcamera関連コードは下記に公開されています。

Please download the latest codes as of 25 June, 2025 from the following sites.

v4l2 driver:

https://github.com/will127534/imx585-v4l2-driver/tree/main

libcamera:

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

cam_helper_imx585.cpp, それぞれの.jsonファイルの追加およびmeson.buildファイルへの追記を行ってください。cam_helper_imxXYZ.cppはIMX585からコピー、編集、meson.buidに追記してください。We added cam_helper_imx585.cpp, the corresponding .json files, and updated the meson.build file accordingly.
The cam_helper_imxXYZ.cpp file was created by copying and editing the one for IMX585, and it has also been added to meson.build.

インストール手順概略(How to Install)

(1)Raspberry Pi ImagerなどでSDカードにBookworm 64 bit OSを書き込みます。Raspi Zero W用には32bit Lite OSを使用します。(Prepare the fresh SD card of Bookworm 64bit OS. 32bit Lite OS is used for Raspi Zero W.)

(2)本サイトより上記のDKMSスクリプトをdownloadし、Raspiのホームディレクトリにコピー、解凍します。(Download “DKMS scripts” above , copy to /home/pi directory and execute “tar zxvf” command .)

(3)imx585-v4l2-driver_*** directoryに移動し、$./setup.shを実行します。( execute “$ cd imx585-v4l2-driver_***”, “$ ./setup.sh” .)

$ ls -ltr /boot/firmware/overaysでimx585.dtboが生成されていることを確認する。(Check wether imx585.dtbo is generated in /boot/firmware/overlays by “$ ls -ltr /boot/firmware/overlays” .)

(4)下記のように/boot/firmware/config.txtを変更してください。(modify /boot/firmware/config.txt as below.)

camera_auto_detect=0

dtoverlay=imx585(Rpi4: dtoverlay=imx585,2lane)

(5)https://www.raspberrypi.com/documentation/computers/camera_software.html#build-libcamera-and-rpicam-appshttps://github.com/will127534/libcameraを参考にlibcamera, rpicam-appsに新しいセンサーを追加、再コンパイルとロードを実行します。(Re-build and load “libcamera and rpicam-apps” according to above links for the operation.)

(6)再起動してカメラ動作を確認 (Reboot the Raspi and verify the camera works.)



タチカメマニュアル/Tachicame manual

tachicame.pdf


過去のダウンロードはこちらに移動しました。