Changes between Version 3 and Version 4 of linux/media

Timestamp:

02/19/2019 09:50:07 PM (5 years ago)

Author:

Tim Harvey

Comment:

added examples and media-ctl pipeline config script

linux/media

@@ -266 +266 @@
 
 Note that to aid in the configuration of and for backward compatibility with V4L2 applications that use controls the capture device interfaces inherit controls from the active entities in the current pipeline thus these controls can be accessed via the entity subdev or from the active capture device interface. For example the FIM controls are available from the ipu_csi subdevs or from the active capture device.
+
+
+==== setup script
+Because the combinations of sensor, cpu, and board are plentiful we have created a way to create an appropriate pipeline configuration script that needs only to know what sensor you wish to use.
+
+Installation:
+{{{#!bash
+wget http://dev.gateworks.com/docs/linux/media/media-ctl-setup
+chmod +x media-ctl-setup
+}}}
+
+Examples:
+ * Analog CVBS capture
+{{{#!bash
+./media-ctl-setup adv7180 > setup
+/bin/sh setup
+}}}
+ * Digital HDMI capture
+{{{#!bash
+./media-ctl-setup tda1997x > setup
+/bin/sh setup
+}}}
+
+
+==== capture and streaming examples
+With the assumption that you have already configured your capture device and set it to the {{{DEVICE}}} env variable the following examples are useful examples for capture and streaming:
+
+Examples:
+ * basic raw frame capture with {{{v4l2-ctl}}}:
+{{{#!bash
+# capture 1 frame
+v4l2-ctl --device /dev/video4 --stream-mmap --stream-to=x.raw --stream-count=1
+# convert with imagemagick (assumes you captured a 480p YUV frame)
+convert -size 720x480 -depth 16 uyvy:x.raw frame.png
+}}}
+ * Display capture source:
+{{{#!bash
+# display kmssink
+gst-launch-1.0 v4l2src device=$DEVICE ! kmssink
+# display fbdevsink
+gst-launch-1.0 v4l2src device=$DEVICE ! v4l2video10convert output-io-mode=dmabuf-import ! fbdevsink
+}}}
+ * Encode to JPEG (software based encode) and stream via RTP/UDP:
+{{{#!bash
+# stream JPEG/RTP/UDP
+gst-launch-1.0 v4l2src device=$DEVICE ! jpegenc ! rtpjpegpay ! udpsink host=$SERVER port=$PORT
+# client on $SERVER:$PORT could be viewing via 'gst-launch-1.0 udpsrc port=5000 ! application/x-rtp,payload=96 ! rtpjpegdepay ! jpegdec ! autovideosink'
+}}}
+ * Encode to H264 (hardware based encode) and stream via RTP/UDP:
+{{{#!bash
+# stream H264/RTP/UDP
+gst-launch-1.0 v4l2src device=$DEVICE ! \
+        v4l2video10convert output-io-mode=dmabuf-import ! \
+        v4l2h264enc output-io-mode=dmabuf-import ! \
+        rtph264pay ! udpsink host=$SERVER port=$PORT
+# client on $SERVER:$PORT could be viewing via 'gst-launch-1.0 udpsrc port=5001 caps=application/x-rtp,payload=96 ! rtph264depay ! decodebin ! autovideosink'
+}}}