Zum Inhalt springen

WSAL16507 – IMX219-170 Camera/en

Aus JW Tech Wiki

Documentation notice: This technical documentation was independently rewritten from an archived supplier source. Check technical details and commands against the product version and manufacturer documentation before use.

Summary

The IMX219-170 is an 8-megapixel camera with a 170° diagonal field of view. It is designed for the Jetson Nano and connects via the CSI interface. The page covers hardware connection, test commands (nvgstcapture), OpenCV usage, and the libcamera command family for Raspberry Pi.

Related products at JW Tech

Technical overview

  • Sensor chip: Sony IMX219; resolution 3280 × 2464 pixels
  • CMOS size: 1/4 inch; aperture F2.4; focal length 2.2 mm
  • Diagonal field of view: 170°; distortion under 22%
  • Housing dimensions: approx. 25 mm × 24 mm; four screw holes in fixed positions
  • External power supply at 3.3 V is supported
  • Jetson Nano connection: insert the camera cable with the metal side facing the heatsink into the camera port
  • Terminal test command: DISPLAY=:0.0 nvgstcapture-1.0
  • Dual-camera test: select sensor with --sensor-id=0 or --sensor-id=1
  • If the image appears reddish: copy the provided camera override file to /var/nvidia/nvcam/settings/ and set permissions
  • Raspberry Pi libcamera commands: libcamera-hello, libcamera-jpeg, libcamera-still, libcamera-vid, libcamera-raw

Commands and examples – verify before use: 

DISPLAY=:0.0 nvgstcapture-1.0
DISPLAY=:0.0 nvgstcapture-1.0 --sensor-id=0
DISPLAY=:0.0 nvgstcapture-1.0 --sensor-id=1
wget https://files.waveshare.com/upload/e/eb/Camera_overrides.tar.gz
tar zxvf Camera_overrides.tar.gz
sudo cp camera_overrides.isp /var/nvidia/nvcam/settings/
sudo chmod 664 /var/nvidia/nvcam/settings/camera_overrides.isp
sudo chown root:root /var/nvidia/nvcam/settings/camera_overrides.isp
libcamera-hello
libcamera-hello -t 0
libcamera-hello --tuning-file /usr/share/libcamera/ipa/raspberrypi/imx219_noir.json
libcamera-hello --info-text "focus %focus"
libcamera-jpeg -o test.jpg
libcamera-jpeg -o test.jpg -t 2000 --width 640 --height 480
libcamera-jpeg -o test.jpg -t 2000 --shutter 20000 --gain 1.5
libcamera-jpeg --ev -0.5 -o darker.jpg
libcamera-jpeg --ev 0 -o normal.jpg
libcamera-jpeg --ev 0.5 -o brighter.jpg
libcamera-still -o test.jpg
libcamera-still -e png -o test.png

Notes and version constraints

  • The source contains placeholders such as {{{name2}}} through {{{name6}}}; these values are unavailable and were omitted.
  • The exact firmware version of the Jetson Nano or Raspberry Pi is not specified; some steps may be version-sensitive.
  • The 'camera_overrides.isp' file must be downloaded from Waveshare; without this step, the reddish image issue will persist.
  • Using OpenCV requires additional scripts (Simple_camera.zip); compatibility with older OpenCV versions is not guaranteed.
  • The operating temperature range (0–60 °C) comes from the FAQ section and should be verified before deployment in extreme environments.

Source and revision record