Transformer un Raspberry Pi en webcam USB

Vous souhaitez utiliser votre Raspberry Pi comme une webcam USB pour votre ordinateur ? C'est tout à fait possible grâce à un projet appelé "USB Gadget".
Cette fonctionnalité permet de transformer votre Raspberry Pi en un périphérique USB, comme une webcam, un clavier ou une souris.
Voici comment configurer votre Raspberry Pi pour qu'il fonctionne comme une webcam USB.

Il faudra utiliser une version ancienne de Raspberry Pi OS, la version Bullseye (debian 11) est la plus recommandée pour cette fonctionnalité.
Cette version est disponible ici
Version de secour ici

Mise à jour

sudo apt update
sudo apt full-upgrade -y

Configurer le raspberry pi pour qu'il puisse être utilisé en mode OTG (On The Go)
Dans le fichier /boot/config.txt:
Commenter la ligne start_x=1

# start_x=1

Ajouter à la fin du fichier

dtoverlay=dwc2,dr_mode=otg
gpu_mem=128
dtoverlay=ov5647

Pour la caméra version 3 Raspberry Pi, remplcer

dtoverlay=ov5647

Par

dtoverlay=imx708

Installer les programmes nécessaires :

sudo apt install git meson libcamera-dev libjpeg-dev cmake usbutils -y

téléchargez le logiciel du gadget UVC . Celui-ci permet à votre Raspberry Pi de diffuser de la vidéo via USB :

git clone https://gitlab.freedesktop.org/camera/uvc-gadget.git

Ensuite, on compile et on installe le gadget UVC :

cd uvc-gadget
make uvc-gadget
cd build
sudo meson install
sudo ldconfig

créez un script qui s'exécutera à chaque mise sous tension de votre Raspberry Pi afin de tout configurer

sudo nano /usr/local/bin/rpi-uvc-gadget.sh

Ajouter le contenu suivant dans le fichier :

#!/bin/bash

# Variables we need to make things easier later on.

CONFIGFS="/sys/kernel/config"
GADGET="$CONFIGFS/usb_gadget"
# VID="0x0525"
# PID="0xa4a2"

VID="0x1d6b"
PID="0x0102"

SERIAL="0123456789"
MANUF=$(hostname)
PRODUCT="UVC Gadget"
BOARD=$(strings /proc/device-tree/model)
UDC=`ls /sys/class/udc` # will identify the 'first' UDC

# Later on, this function is used to tell the usb subsystem that we want
# to support a particular format, framesize and frameintervals
create_frame() {
	# Example usage:
	# create_frame      

	FUNCTION=$1
	WIDTH=$2
	HEIGHT=$3
	FORMAT=$4
	NAME=$5

	wdir=functions/$FUNCTION/streaming/$FORMAT/$NAME/${HEIGHT}p

	mkdir -p $wdir
	echo $WIDTH > $wdir/wWidth
	echo $HEIGHT > $wdir/wHeight
	echo $(( $WIDTH * $HEIGHT * 2 )) > $wdir/dwMaxVideoFrameBufferSize
	cat < $wdir/dwFrameInterval
$6
EOF
}

# This function sets up the UVC gadget function in configfs and binds us
# to the UVC gadget driver.
create_uvc() {
	CONFIG=$1
	FUNCTION=$2

	echo "	Creating UVC gadget functionality : $FUNCTION"
	mkdir functions/$FUNCTION

	create_frame $FUNCTION 640 480 uncompressed u "333333
416667
500000
666666
1000000
1333333
2000000
"
	create_frame $FUNCTION 1280 720 uncompressed u "1000000
1333333
2000000
"
	create_frame $FUNCTION 1920 1080 uncompressed u "2000000"
	create_frame $FUNCTION 640 480 mjpeg m "333333
416667
500000
666666
1000000
1333333
2000000
"
	create_frame $FUNCTION 1280 720 mjpeg m "333333
416667
500000
666666
1000000
1333333
2000000
"
	create_frame $FUNCTION 1920 1080 mjpeg m "333333
416667
500000
666666
1000000
1333333
2000000
"

	mkdir functions/$FUNCTION/streaming/header/h
	cd functions/$FUNCTION/streaming/header/h
	ln -s ../../uncompressed/u
	ln -s ../../mjpeg/m
	cd ../../class/fs
	ln -s ../../header/h
	cd ../../class/hs
	ln -s ../../header/h
	cd ../../class/ss
	ln -s ../../header/h
	cd ../../../control
	mkdir header/h
	ln -s header/h class/fs
	ln -s header/h class/ss
	cd ../../../

	# This configures the USB endpoint to allow 3x 1024 byte packets per
	# microframe, which gives us the maximum speed for USB 2.0. Other
	# valid values are 1024 and 2048, but these will result in a lower
	# supportable framerate.
	echo 2048 > functions/$FUNCTION/streaming_maxpacket

	ln -s functions/$FUNCTION configs/c.1
}

# This loads the module responsible for allowing USB Gadgets to be
# configured through configfs, without which we can't connect to the
# UVC gadget kernel driver
echo "Loading composite module"
modprobe libcomposite

# This section configures the gadget through configfs. We need to
# create a bunch of files and directories that describe the USB
# device we want to pretend to be.

if
[ ! -d $GADGET/g1 ]; then
	echo "Detecting platform:"
	echo "  board : $BOARD"
	echo "  udc   : $UDC"

	echo "Creating the USB gadget"

	echo "Creating gadget directory g1"
	mkdir -p $GADGET/g1

	cd $GADGET/g1
	if
[ $? -ne 0 ]; then
		echo "Error creating usb gadget in configfs"
		exit 1;
	else
		echo "OK"
	fi

	echo "Setting Vendor and Product ID's"
	echo $VID > idVendor
	echo $PID > idProduct
	echo "OK"

	echo "Setting English strings"
	mkdir -p strings/0x409
	echo $SERIAL > strings/0x409/serialnumber
	echo $MANUF > strings/0x409/manufacturer
	echo $PRODUCT > strings/0x409/product
	echo "OK"

	echo "Creating Config"
	mkdir configs/c.1
	mkdir configs/c.1/strings/0x409

	echo "Creating functions..."

	create_uvc configs/c.1 uvc.0

	echo "OK"

	echo "Binding USB Device Controller"
	echo $UDC > UDC
	echo "OK"
fi

# Run uvc-gadget. The -c flag sets libcamera as a source, arg 0 selects
# the first available camera on the system. All cameras will be listed,
# you can re-run with -c n to select camera n or -c ID to select via
# the camera ID.
uvc-gadget -c 0 uvc.0

Rendre le script exécutable :

sudo chmod +x /usr/local/bin/rpi-uvc-gadget.sh

Exécuter ce script à chaque démarrage

sudo nano /etc/rc.local

Ajouter la ligne suivante avant "exit 0" :

/usr/local/bin/rpi-uvc-gadget.sh &

Enregistrer

Redémarrer le Raspberry Pi :

sudo reboot