diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 62 |
1 files changed, 56 insertions, 6 deletions
@@ -1,7 +1,57 @@ -camera-gstreamer ----------------- +- [how to run camera-gstreamer app](#how-to-run-camera-gstreamer-app) + - [With PipeWire](#with-pipewire) + - [With V4L2](#with-v4l2) + - [Without a physical camera device](#without-a-physical-camera-device) + - [Other Details](#other-details) + - [cmd examples](#cmd-examples) + +how to run camera-gstreamer app +=============================== + +With PipeWire +------------- +- PipeWire is the default path +- attach camera + - attach a camera to Hardware. + - make sure it is enumerated properly with `wpctl status` cmd + - make the desired device node the default node with `wpctl set-default + <camera-node-id>` cmd +- run + - start camera-gstreamer from the UI. + - The app can also be run from cmd prompt, make sure you login with `agl-driver` usr name. + +With V4L2 +--------- +- login with `agl-driver` and start the app with `ENABLE_V4L2_PATH=true camera-gstreamer` cmd +- V4L2 path cannot be taken when the app is run from the UI. + +Without a physical camera device +--------------------------------- + +The Virtual Video Test Driver (vivid) can be used for this purpose. + +- run `modprobe vivid allocators=0x1` cmd +- check dmesg to know the capture device created. +- with PipeWire this device has to be made a default device, check [above](#with-pipewire) on how + to do it. +- with V4L2 use DEFAULT_V4L2_DEVICE to pass this new device + +Other Details +------------- +- For V4L2 path assumes that /dev/video0 is present and is set as a capture device. + - Use DEFAULT_V4L2_DEVICE environmental variable to change it. +- use DEFAULT_DEVICE_WIDTH and DEFAULT_DEVICE_HEIGHT environmental variable to +override the default dimensions. + +cmd examples +------------ +run app with V4L2 path and on `/dev/video24` + +``` +DEFAULT_V4L2_DEVICE=/dev/video24 ENABLE_V4L2_PATH=true camera-gstreamer +``` +run app with default path(PipeWire) with a video frame of height 480 +``` +DEFAULT_DEVICE_HEIGHT=480 camera-gstreamer +``` -Assumes that /dev/video0 is present and is set as a capture device. Use -DEFAULT_V4L2_DEVICE environmental variable to change it. -DEFAULT_V4L2_DEVICE_WIDTH and DEFAULT_V4L2_DEVICE_HEIGHT to specify the -dimensions. |