From 064c4deb61e7e8e1a561c02e256e18d46043ac7b Mon Sep 17 00:00:00 2001 From: Stephan Wendel Date: Sun, 12 Dec 2021 13:06:56 +0100 Subject: [PATCH] Updated README.md for V4L2 Control Feature. * Detailed Informations about V4L2 Control Feature * Added Credit section. Signed-off-by: Stephan Wendel --- README.md | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 59 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index d388383..4d96dc9 100644 --- a/README.md +++ b/README.md @@ -173,7 +173,7 @@ Now the more interessting part. This section should be pretty much self explantory. - streamer: mjpg + streamer: ustreamer means your choosen streamservice will be mjpg_streamer.\ You can choose: @@ -234,7 +234,54 @@ As a pointer in the right direction: [ustreamer's manpage](./ustreamer_manpage.md) - v4l2rtspserver - - Please visit [v4l2rtspserver Usage](https://github.com/mpromonet/v4l2rtspserver#usage) + - Please visit [v4l2rtspserver Usage](https://github.com/mpromonet/v4l2rtspserver#usage)\ + +--- + +### Feature V4L2 Control: + + v4l2ctl: + +This optional parameter allows you to setup your Cam due v4l2-ctl options. +Unfortunatly this is a complex topic. But I try to explain it, as good I can. + +### As an Example + +You own a Logitech C920 Camera, these camera needs some tweaks to get a sharp picture.\ +A solution was to use a cronjob (timed actions due scripts) that runs a script with some v4l2-ctl commands. + + v4l2-ctl -d /dev/video0 -c focus_auto=0 + v4l2-ctl -d /dev/video0 -c focus_absolute=30 + +That script gets executed when th Pi boots up.\ +Not a comfortable solution. + +alexz from the mainsail-crew mentioned it would be a good move when \ +this could happen by crowsnest, hassle free for the user. + +So, here we go. +Simply add + + v4l2ctl: focus_auto=0,focus_absolute=30 + +to your camera setup section. \ +Restart webcamd via mainsail (or your used UI) and you're good to go. + +To determine which options or better said parameters your Webcam provides, \ +login to your Pi via ssh and type + + v4l2-ctl -d -L + +_Note: Replace \ with the according string. ex.:_ + + v4l2-ctl -d /dev/video0 -L + +This will show you a list with available options. + +You have to "play around" with those settings if it matches your needs. +simply repeat the commands as mentioned earlier in your ssh connection. + +If you have discoverd your setup write that to your webcam.conf as described. --- @@ -246,6 +293,16 @@ further Informations. --- +## Credits + +I want to give a huge shoutout to _lixxbox_ and _alexz_ from the mainsail-crew.\ +Without these guys it simply were not possible to get that done. + +They both mentioned improvements and tested a heck out of there machines to get this all functioning well.\ +Thank you, mates :) Proud to be a part of. + +--- + ![Mainsail Logo](https://raw.githubusercontent.com/meteyou/mainsail/master/docs/assets/img/logo.png) **So, with all that said, get your position seaman! Prepare to get wet feets on your Journey.**