sc235hai_driver/CHECKLIST.md

SC235HAI Quick Checklist

One-page, copyable checklist for field use.

Wiring

• Connect camera CSI ribbon to carrier board.
• Connect SDA/SCL (I2C VC) to camera sensor.
• Connect camera GND to Pi GND.
• Ensure control GPIOs (e.g. GPIO4, GPIO40) are connected as required.
• Apply power only after wiring verified.

System prep (on Pi)

apt update
apt install -y git build-essential raspberrypi-kernel-headers device-tree-compiler v4l-utils libcamera-apps ffmpeg curl ca-certificates

Boot & config

• Edit /boot/firmware/config.txt and ensure:

camera_auto_detect=0
dtparam=i2c_vc=on
gpio=4=op,dh
gpio=40=op,dh
dtoverlay=sc235hai

• Reboot: reboot

Driver: obtain & build

• Copy or clone driver to /root/sc235hai_driver.

cd /root/sc235hai_driver
make
dtc -@ -I dts -O dtb -o sc235hai.dtbo sc235hai.dts

Install driver & overlay

cp sc235hai.ko /lib/modules/$(uname -r)/extra/
cp sc235hai.dtbo /boot/firmware/overlays/
depmod -a
modprobe sc235hai

Autoload (optional)

• Add module to /etc/modules-load.d/sc235hai.conf:

echo sc235hai > /etc/modules-load.d/sc235hai.conf
reboot

Verify

lsmod | grep -i sc235hai
dmesg | grep -i sc235
media-ctl -p
ls /dev/video* /dev/media*
libcamera-hello --list-cameras

MediaMTX (stream)

• Copy mediamtx and mediamtx.yml to /root/ if missing.

pkill -f mediamtx 2>/dev/null || true
setsid /root/mediamtx /root/mediamtx.yml >/var/log/mediamtx.log 2>&1 </dev/null &
tail -n 50 /var/log/mediamtx.log

• RTSP URL: rtsp://<board-ip>:8554/cam

Quick troubleshooting

• No module: find /lib/modules/$(uname -r) -name 'sc235hai.ko*'
• Overlay missing: check /boot/firmware/overlays/sc235hai.dtbo
• No camera nodes: re-check wiring and dmesg for errors
• No stream: check /var/log/mediamtx.log and libcamera

Contact

• Keep a copy of dmesg and /var/log/mediamtx.log when asking for help.