StarlightEye Quick Start Guide
This quick start guide will help you set up and start using your OneInchEye camera board for Raspberry Pi. Please follow the steps outlined below to set up and start using your camera board.
The following guide is assuming your are running Raspberry Pi OS based on bookworm.
Make sure you are using either RPI5 board or your Raspberry Pi Compute Module 4 board has a 22-pin FPC connector with the same pinout as the Raspberry Pi Compute Module 4 IO Board's CAM1 port.
2.a Attach the StarlightEye camera board to the Raspberry Pi board using the 22-pin FPC connector to CAM1 connector. The FPC contact should face up rather then down. Check FPC Guide here
2.b Ensure that the camera board is securely connected and that the pins are properly aligned.
2.d Connect a 5V power to the StarlightEye.
2.e The result should look like the following:
3.a Download and flash the latest 64bit Raspberry Pi OS for your board. 3.b Insert the microSD card (with the flashed OS) into your Raspberry Pi board.
Connect your Raspberry Pi Compute Module 4 board to a power source and boot up the operating system.
We need to recompile Libcamera and Libcamera-apps/rpicam-apps so that they recognize the IMX585 sensor. The following steps are similar to the Libcamera Compile Guide, but the repository is changed to a forked version that supports IMX585 (https://github.com/will127534/libcamera).
sudo apt install -y libboost-dev libgnutls28-dev openssl libtiff5-dev pybind11-dev qtbase5-dev libqt5core5a libqt5gui5 libqt5widgets5 meson cmake python3-yaml python3-ply
cd ~
git clone https://github.com/will127534/libcamera.git
cd libcamera
meson setup build --buildtype=release -Dpipelines=rpi/vc4,rpi/pisp -Dipas=rpi/vc4,rpi/pisp -Dv4l2=true -Dgstreamer=disabled -Dtest=false -Dlc-compliance=disabled -Dcam=disabled -Dqcam=disabled -Ddocumentation=disabled -Dpycamera=enabled
ninja -C build
sudo ninja -C build install
sudo apt install -y cmake libboost-program-options-dev libdrm-dev libexif-dev libjpeg-dev libtiff5-dev libpng-dev libepoxy-dev
sudo apt install -y meson ninja-build
cd ~
git clone https://github.com/will127534/rpicam-apps.git
cd rpicam-apps
For Raspberry Pi OS:
meson setup build -Denable_libav=true -Denable_drm=true -Denable_egl=true -Denable_qt=true -Denable_opencv=false -Denable_tflite=false
For Raspberry Pi OS Lite:
meson setup build -Denable_libav=false -Denable_drm=true -Denable_egl=false -Denable_qt=false -Denable_opencv=false -Denable_tflite=false
Continuing with
meson compile -C build
sudo meson install -C build
sudo ldconfig
First, install the necessary tools (linux-headers, dkms, and git):
sudo apt install linux-headers dkms gitClone the repository to your local pi and navigate to the cloned directory:
git clone https://github.com/will127534/imx585-v4l2-driver.git
cd imx585-v4l2-driver/To compile and install the kernel driver, execute the provided installation script:
sudo ./setup.shEdit the boot configuration file using the following command:
sudo nano /boot/config.txtIn the opened editor, locate the line containing camera_auto_detect and change its value to 0. Then, add the line dtoverlay=imx585. So, it will look like this:
camera_auto_detect=0
dtoverlay=imx585
Side note is that if you want to use Cam/Disp port 0 (Only for RPI5), you can do dtoverlay=imx585,cam0
After making these changes, save the file and exit the editor.
Run the following command to reboot the Raspberry Pi:
sudo reboot
Once the Raspberry Pi has rebooted, open a terminal window and run the following command to test the camera:
rpicam-still -r -o test.jpg -f -t 0
If you want to run it through SSH terminal and see the preview on a HDMI monitor like me, you can use:
export DISPLAY=:0; rpicam-still -r -o test.jpg -f -t 0
Check the following page for IR filter control script: https://github.com/will127534/StarlightEye/blob/main/software/README.md