sc235hai_driver/CHECKLIST.md

78 lines
1.9 KiB
Markdown
Raw Permalink Normal View History

# 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)
```bash
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:
```ini
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`.
```bash
cd /root/sc235hai_driver
make
dtc -@ -I dts -O dtb -o sc235hai.dtbo sc235hai.dts
```
Install driver & overlay
```bash
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`:
```bash
echo sc235hai > /etc/modules-load.d/sc235hai.conf
reboot
```
Verify
```bash
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.
```bash
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.