I tested the an official raspberry pi v2 module and it worked without any issues. I did have to build a raspberry pi 4 image as there where no raspberry pi 4 version under releases?
|3 weeks ago|
|.github/workflows||1 month ago|
|board||1 month ago|
|configs||1 month ago|
|package||1 month ago|
|patches/linux-custom||5 months ago|
|rootfs||4 months ago|
|.gitignore||4 months ago|
|Config.in||5 months ago|
|LICENSE||9 months ago|
|README.md||3 weeks ago|
|build-showmewebcam.sh||1 month ago|
|camera.txt.example||6 months ago|
|external.desc||9 months ago|
|external.mk||9 months ago|
|smwc-expect||5 months ago|
This firmware transforms your Raspberry Pi into a high quality webcam. It works reliably, boots quickly, and gets out of your way.
Show-me webcam is proudly powered by peterbay's uvc-gadget.
|Raspberry Pi \ Camera version||v1 5MP||v2 8MP||High Quality 12MP|
|Pi Zero v1.3 (without Wifi)||✓||✓||✓|
|Pi Zero W (with Wifi)||✓||✓||✓|
ddto write the image to the Micro SD card
We release new versions of this firmware regularly at the release tab: https://github.com/showmewebcam/showmewebcam/releases
After booting, the built-in LED will blink three times quickly to show you it's ready.
When the camera is in use the LED will be lit. In addition,
GPIO 21 pin is set to
HIGH, so an
external LED or another payload can be triggered with this pin to indicate that
the camera is in use.
For debugging, a 115200 baud serial interface is provided as a
smwc-expectscript to connect to it
Also, there is a serial interface on the 40-pin header: https://pinout.xyz/pinout/uart
$ ls -l /dev/ttyACM* crw-rw---- 1 root dialout 166, 0 sep 25 14:03 /dev/ttyACM0 $ sudo screen /dev/ttyACM0 115200
Mac OS example:
$ ls -l /dev/tty.* crw-rw-rw- 1 root wheel 9, 18 Dec 7 13:14 /dev/tty.usbmodem13103 $ screen /dev/tty.usbmodem13103 115200
If the terminal is blank try pressing enter to see the login prompt. To exit
the session, use
Ctrl-A \ (screen) or
Ctrl-A X (minicom & picocom).
Warning: This serial debug interface is automatically enabled and is controlled
by the file called
enable-serial-debug in the
/boot folder. This is a potential
security issue. For now, you should strongly consider disabling this feature by
removing the file after you have finished customizing the webcam.
From version 1.80, on Linux, you can see what happens by watching
before you plug in the webcam:
$ sudo dmesg -w
If you only see the
ttyACM device show up, but not the webcam, it's likely you
have not plugged in the camera cable correctly, or the camera cable has gone bad.
If you see nothing, maybe your USB cable is bad, or you have plugged in the cable to the wrong port.
Log in to the debug interface and execute:
This tool will allow you to show and tweak all available camera parameters.
Additionally it will save your settings to
/boot/camera.txt if you choose to
do so. This will handle remounting
Log in to the debug interface. Then list all tweakable parameters:
/usr/bin/v4l2-ctl -L | less
Then you can apply parameters on the fly, e.g.
/usr/bin/v4l2-ctl -c auto_exposure_bias=15 /usr/bin/v4l2-ctl -c contrast=3
Mount the SD card on your computer, edit a file called
/boot and put all parameters you want overridden, e.g:
# Tweak the auto exposure bias auto_exposure_bias=15 # Tweak the contrast contrast=3
You can edit
camera.txt on-target by remounting
mount -o remount,rw /boot
Clone or download this repository. Then inside it:
./build-showmewebcam.sh raspberrypi0wto build Raspberry Pi Zero W (with Wifi) image.
./build-showmewebcam.sh raspberrypi0to build Raspberry Pi Zero (without Wifi) image.
./build-showmewebcam.sh raspberrypi4to build Raspberry Pi 4 image.
buildrootor if you put it somewhere else you need to set the Buildroot path manually, e.g.
BUILDROOT_DIR=../buildroot ./build-showmewebcam.sh raspberrypi0
sdcard.imgwill be in the
camera.txtfile to the root of this repository, the contents will be automatically added to