View source for Gstreamer pipelines for Jetson TX1

{{#seo:
|title=Gstreamer pipelines for Jetson TX1
|title_mode=replace
|description={{{description|Get example pipelines used on Tegra X1 for the Jetson board with RidgeRun Developer Connection. Learn more about GStreamer pipelines for Tegra X1 now.}}}
}}

{{NVIDIA Pref Partner logo and RR Contact}}
<br>
{{GStreamer debug}}
== Introduction ==

On this page you are going to find a set of pipelines used on Jetson TX1, specifically used with the Jetson board. The wiki page tries to describe some of the multimedia features of the platform like the NVIDIA model to handle the ISP through its custom (and close) plugin called nvcamerasrc. It also includes a brief description of the sample application called nvgstcapture-1.0 and ways to measure the ARM load when encoding/decoding using NVENC, NVDEC, NVJPG, etc. The goal is to provide you some example pipelines and introduction to the board. It is work in progress.

The camera sensor used for tests is the ov5693. These steps were run on Jetson TX1.

== Jetson TX1 GStreamer pipelines ==

Recall that this board is a quad core A57 with some hardware units dedicated to encode/decode. Plugins accelerated by Hardware available:

<pre>
 gst-inspect-1.0 | grep omx
omx:  omxmpeg4videodec: OpenMAX MPEG4 Video Decoder
omx:  omxh264dec: OpenMAX H.264 Video Decoder
omx:  omxh265dec: OpenMAX H.265 Video Decoder
omx:  omxvp8dec: OpenMAX VP8 Video Decoder
omx:  omxvp9dec: OpenMAX VP9 Video Decoder
omx:  omxmpeg2videodec: OpenMAX MPEG2 Video Decoder
omx:  omxwmvdec: OpenMAX WMV Video Decoder
omx:  omxaacdec: OpenMax AAC decoder
omx:  omxmpegaudiodec: OpenMax MP3/MP2 decoder
omx:  omxh264enc: OpenMAX H.264 Video Encoder
omx:  omxh265enc: OpenMAX H.265 Video Encoder
omx:  omxvp8enc: OpenMAX VP8 Video Encoder
omx:  nvhdmioverlaysink: OpenMax HDMI Video Sink
omx:  nvoverlaysink: OpenMax Video Sink
</pre>

Nvidia plugins:

<pre>
gst-inspect-1.0 | grep nv
nvcamera:  nvcamerasrc: Nvidia Camera Source
nvcamera:  nvtee: NvTee
omx:  nvhdmioverlaysink: OpenMax HDMI Video Sink
omx:  nvoverlaysink: OpenMax Video Sink
nvjpeg:  nvjpegenc: JPEG image encoder
nvjpeg:  nvjpegdec: JPEG image decoder
nvvideosink:  nvvideosink: nVidia Video Sink
nvvidconv:  nvvidconv: NvVidConv Plugin
eglglessink:  nveglglessink: EGL/GLES vout Sink
nveglstreamsrc:  nveglstreamsrc: nVidia EGL Stream
</pre>

=== Measure ARM load ===

There is a tool to measure the ARM load created by NVIDIA for the Jetson TX1. This tool seems to give better statistics of the ARM cores than top. In the remaining sections of this wiki the ARM load reported by top is included for reference to the reader but tegrastats should contain the real load.

Run it with sudo to get more information.
<pre>
ubuntu@tegra-ubuntu:~$ ./tegrastats 
RAM 162/3854MB (lfb 845x4MB) SWAP 0/0MB (cached 0MB) cpu [0%,0%,0%,0%]@-1 VDE 0 EDP limit 0
RAM 162/3854MB (lfb 845x4MB) SWAP 0/0MB (cached 0MB) cpu [0%,0%,0%,0%]@-1 VDE 0 EDP limit 0
RAM 162/3854MB (lfb 845x4MB) SWAP 0/0MB (cached 0MB) cpu [0%,1%,0%,0%]@-1 VDE 0 EDP limit 0
RAM 162/3854MB (lfb 845x4MB) SWAP 0/0MB (cached 0MB) cpu [4%,2%,1%,0%]@-1 VDE 0 EDP limit 0
RAM 162/3854MB (lfb 845x4MB) SWAP 0/0MB (cached 0MB) cpu [1%,1%,1%,0%]@-1 VDE 0 EDP limit 0

EMC – memory controller 
AVP – audio/video processor
VDE – video decoder engine
GR3D – GPU
</pre>

==== Jetson TX1 ARM load ====

This table tries to summarize the ARM load of different uses cases of the Jetson TX1 using gstreamer and the capture plugin. The second column has the ARM load of the pipeline measured in one instant, using that value and the known value for the capture process the third column estimates the load of the encoding or display process (subtract the capture load). The load represent a global load of the system (4 ARMs) just to give an idea to the reader of the system capabilities.

{| width="500" border="1" cellpadding="1" cellspacing="1"
|+ ARM load measured with tegrastats for Capture and encoding capabilities 
|-style="background: gray; color: white"
! scope="col" | Feature 
! scope="col" | Pipeline load (%)
! scope="col" | Feature load (%)
|-
| Capture
| 11.25
| 11.25
|-
| Capture-Display
| 18
| 6.75
|-
| H264 Encoding
| 20
| 8.75
|-
| VP8 Encoding
| 19.25
| 8
|-
| H265 Encoding
| 13.75
| 2.75
|-
| <...>
| 
| 
|}

=== NVMM memory ===

In order to get the best performance from the gstreamer elements that use the HW accelerators they have to receive something called NVMM memory, which we could imagine is contiguous and aligned memory ('nvbuffer', 'nv_buffer', 'nvmm'). At this point it is not clear what that memory is.

<pre>
https://devtalk.nvidia.com/default/topic/903438/jetson-tx1/hw-accelerated-jpeg-encoding-/?offset=13#4839080
https://devtalk.nvidia.com/default/topic/901337/post/4747186/#4747186
</pre>

There is a plugin to convert video/x-raw to video/x-raw(memory:NVMM)

<pre>
https://devtalk.nvidia.com/default/topic/911535/jetson-tx1/gstreamer-nvvidconv-plugin-not-working/
</pre>

=== VLC on Jetson TX1/TX2 ===

In order to test some of the videos or incoming streams produced by the pipelines below you might need VLC installed in your Jetson module, there is a known issue with VLC version 2.2 and you need to download and install VLC 2.4 or newer, in order to do it please follow these steps:
<pre>
sudo apt-get build-dep vlc && sudo apt-get install libtool build-essential
wget http://download.videolan.org/pub/videolan/vlc/2.2.6/vlc-2.2.6.tar.xz   
tar -xf vlc-2.2.6.tar.xz   
cd vlc-2.2.6
./configure --disable-qt 
make
#you can also try: make install 
</pre>

It takes around 10min to build. Once you have built the new vlc, you can run this to open a plain UDP stream for instance

 ./vlc -vv --demux h264 --h264-fps 60 udp://@:5000

this issue has been reported on [https://devtalk.nvidia.com/default/topic/990198/?comment=5079474 NVIDIA's forum]

=== Capture ===

In order to capture there are two ways: Using v4l2 or using nvcamerasrc.

==== nvcamerasrc ====

This plugin was created by nvidia and it has access to the ISP that helps converting from bayer to yuv suitable for the video encoders. However, it seems that its usage is limited to the ov5693 sensor until NVIDIA releases its source code or until it adds support to v4l2 to use the ISP.

<pre>
gst-launch-1.0 nvcamerasrc fpsRange="30.0 30.0" ! 'video/x-raw(memory:NVMM), width=(int)1920, height=(int)1080, format=(string)I420, framerate=(fraction)30/1' ! \
nvvidconv flip-method=2 ! 'video/x-raw(memory:NVMM), format=(string)I420' ! fakesink silent=false -v
</pre>

When the pipeline is launched a daemon appears on top nvcamera-daemon, one question about the daemon was posted on the [https://devtalk.nvidia.com/default/topic/926578/jetson-tx1/nvcamera-daemon/ Nvidia Embedded Computing Forum]

ARM consumption: 45% of one core (4 cores available 400% - this means something like 11.25% of total)

<pre>
RAM 1295/3854MB (lfb 426x4MB) SWAP 0/0MB (cached 0MB) cpu [0%,0%,0%,0%]@-1 VDE 0 EDP limit 0
RAM 1296/3854MB (lfb 426x4MB) SWAP 0/0MB (cached 0MB) cpu [2%,10%,5%,4%]@-1 VDE 0 EDP limit 0
RAM 1296/3854MB (lfb 426x4MB) SWAP 0/0MB (cached 0MB) cpu [6%,7%,7%,5%]@-1 VDE 0 EDP limit 0
RAM 1311/3854MB (lfb 426x4MB) SWAP 0/0MB (cached 0MB) cpu [21%,9%,41%,6%]@-1 VDE 0 EDP limit 0 ->Start
RAM 1311/3854MB (lfb 426x4MB) SWAP 0/0MB (cached 0MB) cpu [14%,11%,12%,7%]@-1 VDE 0 EDP limit 0
RAM 1311/3854MB (lfb 426x4MB) SWAP 0/0MB (cached 0MB) cpu [14%,16%,9%,14%]@-1 VDE 0 EDP limit 0
RAM 1311/3854MB (lfb 426x4MB) SWAP 0/0MB (cached 0MB) cpu [18%,12%,15%,12%]@-1 VDE 0 EDP limit 0
RAM 1311/3854MB (lfb 426x4MB) SWAP 0/0MB (cached 0MB) cpu [11%,16%,12%,9%]@-1 VDE 0 EDP limit 0
RAM 1312/3854MB (lfb 426x4MB) SWAP 0/0MB (cached 0MB) cpu [21%,12%,11%,16%]@-1 VDE 0 EDP limit 0
RAM 1312/3854MB (lfb 426x4MB) SWAP 0/0MB (cached 0MB) cpu [11%,11%,11%,10%]@-1 VDE 0 EDP limit 0
RAM 1312/3854MB (lfb 426x4MB) SWAP 0/0MB (cached 0MB) cpu [14%,11%,8%,16%]@-1 VDE 0 EDP limit 0
RAM 1312/3854MB (lfb 426x4MB) SWAP 0/0MB (cached 0MB) cpu [15%,14%,11%,12%]@-1 VDE 0 EDP limit 0
RAM 1312/3854MB (lfb 426x4MB) SWAP 0/0MB (cached 0MB) cpu [15%,12%,7%,11%]@-1 VDE 0 EDP limit 0
RAM 1312/3854MB (lfb 426x4MB) SWAP 0/0MB (cached 0MB) cpu [11%,11%,12%,8%]@-1 VDE 0 EDP limit 0
RAM 1312/3854MB (lfb 426x4MB) SWAP 0/0MB (cached 0MB) cpu [15%,9%,14%,18%]@-1 VDE 0 EDP limit 0
RAM 1312/3854MB (lfb 426x4MB) SWAP 0/0MB (cached 0MB) cpu [16%,14%,14%,10%]@-1 VDE 0 EDP limit 0
RAM 1312/3854MB (lfb 426x4MB) SWAP 0/0MB (cached 0MB) cpu [15%,11%,12%,10%]@-1 VDE 0 EDP limit 0
RAM 1312/3854MB (lfb 426x4MB) SWAP 0/0MB (cached 0MB) cpu [14%,8%,13%,14%]@-1 VDE 0 EDP limit 0
RAM 1302/3854MB (lfb 426x4MB) SWAP 0/0MB (cached 0MB) cpu [8%,6%,17%,12%]@-1 VDE 0 EDP limit 0
</pre>

<pre>
 589 root      20   0 1007120 104416  24048 S  47.2  2.6   4:02.80 nvcamera-daemon                                                             
 5557 ubuntu    20   0  157448   4228   2688 S   2.9  0.1   0:00.45 gst-launch-1.0    
</pre>

The nvvidconv is required normally to convert the memory type, however, on this case it is used to flip the image. Removing the flip from the pipeline saves like 5% of ARM load.

nvcamerasrc exposes several properties to control the ISP

<pre>
  wbmode              : White balance affects the color temperature of the photo
                        flags: readable, writable
                        Enum "GstNvCamWBMode" Default: 1, "auto"
                           (0): off              - GST_NVCAM_WB_MODE_OFF
                           (1): auto             - GST_NVCAM_WB_MODE_AUTO
                           (2): incandescent     - GST_NVCAM_WB_MODE_INCANDESCENT
                           (3): fluorescent      - GST_NVCAM_WB_MODE_FLUORESCENT
                           (4): warm-fluorescent - GST_NVCAM_WB_MODE_WARM_FLUORESCENT
                           (5): daylight         - GST_NVCAM_WB_MODE_DAYLIGHT
                           (6): cloudy-daylight  - GST_NVCAM_WB_MODE_CLOUDY_DAYLIGHT
                           (7): twilight         - GST_NVCAM_WB_MODE_TWILIGHT
                           (8): shade            - GST_NVCAM_WB_MODE_SHADE
                           (9): manual           - GST_NVCAM_WB_MODE_MANUAL
  scene-mode          : property to set scene mode
                        flags: readable, writable
                        Enum "GstNvCamSceneMode" Default: 0, "face-priority"
                           (0): face-priority    - GST_NVCAM_SCENE_MODE_FACE_PRIORITY
                           (1): action           - GST_NVCAM_SCENE_MODE_ACTION
                           (2): portrait         - GST_NVCAM_SCENE_MODE_PORTRAIT
                           (3): landscape        - GST_NVCAM_SCENE_MODE_LANDSCAPE
                           (4): night            - GST_NVCAM_SCENE_MODE_NIGHT
                           (5): night-portrait   - GST_NVCAM_SCENE_MODE_NIGHT_PORTRAIT
                           (6): theatre          - GST_NVCAM_SCENE_MODE_THEATRE
                           (7): beach            - GST_NVCAM_SCENE_MODE_BEACH
                           (8): snow             - GST_NVCAM_SCENE_MODE_SNOW
                           (9): sunset           - GST_NVCAM_SCENE_MODE_SUNSET
                           (10): steady-photo     - GST_NVCAM_SCENE_MODE_STEADYSHOT
                           (11): fireworks        - GST_NVCAM_SCENE_MODE_FIREWORKS
                           (12): sports           - GST_NVCAM_SCENE_MODE_SPORTS
                           (13): party            - GST_NVCAM_SCENE_MODE_PARTY
                           (14): candle-light     - GST_NVCAM_SCENE_MODE_CANDLE_LIGHT
                           (15): barcode          - GST_NVCAM_SCENE_MODE_BARCODE
  color-effect        : property to set color effect
                        flags: readable, writable
                        Enum "GstNvCamColorEffectMode" Default: 1, "off"
                           (1): off              - GST_NVCAM_COLOR_EFFECT_OFF
                           (2): mono             - GST_NVCAM_COLOR_EFFECT_MONO
                           (3): negative         - GST_NVCAM_COLOR_EFFECT_NEGATIVE
                           (4): solarize         - GST_NVCAM_COLOR_EFFECT_SOLARIZE
                           (5): sepia            - GST_NVCAM_COLOR_EFFECT_SEPIA
                           (6): posterize        - GST_NVCAM_COLOR_EFFECT_POSTERIZE
                           (7): aqua             - GST_NVCAM_COLOR_EFFECT_AQUA
  auto-exposure       : property to set auto exposure mode
                        flags: readable, writable
                        Enum "GstNvCamAutoExposureMode" Default: 2, "on"
                           (1): off              - GST_NVCAM_AUTO_EXPOSURE_OFF
                           (2): on               - GST_NVCAM_AUTO_EXPOSURE_ON
                           (3): OnAutoFlash      - GST_NVCAM_AUTO_EXPOSURE_AUTOFLASH
                           (4): OnAlwaysFlash    - GST_NVCAM_AUTO_EXPOSURE_ALWAYSFLASH
                           (5): OnFlashRedEye    - GST_NVCAM_AUTO_EXPOSURE_AUTO_RED_EYE
  flash               : property to set flash mode
                        flags: readable, writable
                        Enum "GstNvCamFlashMode" Default: 0, "off"
                           (0): off              - GST_NVCAM_FLASH_OFF
                           (1): on               - GST_NVCAM_FLASH_ON
                           (2): torch            - GST_NVCAM_FLASH_TORCH
                           (3): auto             - GST_NVCAM_FLASH_AUTO
  flicker             : property to select flicker detection and avoidance mode
                        flags: readable, writable
                        Enum "GstNvCamFlickerMode" Default: 3, "auto"
                           (0): off              - GST_NVCAM_FLICKER_OFF
                           (1): 50Hz             - GST_NVCAM_FLICKER_50HZ
                           (2): 60Hz             - GST_NVCAM_FLICKER_60HZ
                           (3): auto             - GST_NVCAM_FLICKER_AUTO
  contrast            : property to adjust contrast value
                        flags: readable, writable
                        Float. Range:               0 -               1 Default:               0 
  saturation          : property to adjust saturation value
                        flags: readable, writable
                        Float. Range:               0 -               2 Default:               1 
  tnr-strength        : property to adjust temporal noise reduction strength
                        flags: readable, writable
                        Float. Range:               0 -               1 Default:               0 
  tnr-mode            : property to select temporal noise reduction mode
                        flags: readable, writable
                        Enum "GstNvCamTNRMode" Default: 0, "NoiseReduction_Off"
                           (0): NoiseReduction_Off - GST_NVCAM_NR_OFF
                           (1): NoiseReduction_Fast - GST_NVCAM_NR_FAST
                           (2): NoiseReduction_HighQuality - GST_NVCAM_NR_HIGHQUALITY
  edge-enhancement    : property to adjust edge enhnacement value
                        flags: readable, writable
                        Float. Range:               0 -               1 Default:              -1 
  trigger             : property to fire pre capture trigger
                        flags: readable, writable
                        Enum "GstNvCamCaptureTrigger" Default: 0, ""
                           (1): idle             - GST_NVCAM_TRIGGER_IDLE
                           (2): start            - GST_NVCAM_TRIGGER_START
  intent              : property to select capture intent
                        flags: readable, writable
                        Enum "GstNvCamCaptureIntent" Default: 1, "preview"
                           (1): preview          - GST_NVCAM_INTENT_PREVIEW
                           (2): still            - GST_NVCAM_INTENT_STILL
                           (3): video            - GST_NVCAM_INTENT_VIDEO
                           (4): video-snapshot   - GST_NVCAM_INTENT_VIDEO_SNAPSHOT
                           (5): zsl              - GST_NVCAM_INTENT_ZSL
  sensor-id           : Set the id of camera sensor to use. Default 0.)
                        flags: readable, writable
                        Integer. Range: 0 - 255 Default: 0 
  enable-exif         : Return Exif data with captured frame
                        flags: readable, writable
                        Boolean. Default: false
  enable-meta         : Return Sensor meta data with captured frame
                        flags: readable, writable
                        Boolean. Default: false
  aeRegion            : Property to set region of interest for auto exposure.
			 Use GArray, with values of ROI coordinates (top,left,bottom,right)
			 and weight in that order, to set the property.
                        flags: readable, writable
                        Boxed pointer of type "GArray"
  wbRegion            : Property to set region of interest for white balance.
			 Use GArray, with values of ROI coordinates (top,left,bottom,right)
			 and weight in that order, to set the property.
                        flags: readable, writable
                        Boxed pointer of type "GArray"
  fpsRange            : Property to set FPS range.
			 Use string with values of FPS Range (low, high)
			 in that order, to set the property.
                        flags: readable, writable
                        String. Default: null
  exposure-time       : Property to adjust exposure time.
			 This property will have effect only when Exposure mode is Off.
                        flags: readable, writable
                        Float. Range:               0 -    3.402823e+38 Default:           0.033 
  wbManualMode        : Property to set manual mode of White balance.
			 This property will have effect only when wbMode is manual.
                        flags: readable, writable
                        Enum "GstNvCamWBManualMode" Default: 0, "off"
                           (0): off              - GST_NVCAM_WB_MANUAL_OFF
                           (1): reset            - GST_NVCAM_WB_MANUAL_RESET
                           (2): restore          - GST_NVCAM_WB_MANUAL_RESTORE
                           (3): external-gains   - GST_NVCAM_WB_MANUAL_EXTGAINS
  wbGains             : Property to set external white balance Gains.
			 Use GArray, with values of WB gains (R, GR, GB, B)
			 in that order, to set the property.
			 This will have effect only when wbMode is manual.
                        flags: readable, writable
                        Boxed pointer of type "GArray"
  stitchConfig        : Property to set stitching windows.
			 Use GArray, with values of sensor id and
			 window coordinates (sensor-id,top,left,bottom,right)

                        flags: readable, writable
                        Boxed pointer of type "GArray"
  callback            : Property to set user callback. It is required if user wants 
			 to change capture settings per frame. Provide address 
			 of GstNvCamSrcCallbacks type struct as value. 

                        flags: writable
                        Pointer. Write only
  dump-bayer          : Dump raw bayer data in still capture mode.
                        flags: readable, writable
                        Boolean. Default: false
  num-sensors         : Property to get number of sensors.
			 Returns GArray containing number of sensors {usb,csi}

                        flags: readable
                        Boxed pointer of type "GArray"
  orientation         : Sensor orientation value. This must be accessed in READY state.
                        flags: readable
                        Integer. Range: 0 - 360 Default: -1 
</pre>


'''References'''
<pre>
https://devtalk.nvidia.com/default/topic/920253/jetson-tx1/how-to-add-another-csi-camera-/
https://devtalk.nvidia.com/default/topic/918966/jetson-tx1/nvcamerasrc-source-code-request-to-support-a-sensor-other-than-the-ov5693-/
</pre>

==== v4l2src ====

Starting on L4T R23.2 there is a /dev/video0 node to capture, however, this node will give you frames in bayer which are NOT suitable to encode because it grabs frames directly from the [https://www.ovt.com/sensors/OV5693 ov5693 camera] without using the ISP.

<pre>
https://devtalk.nvidia.com/default/topic/923984/ov5693-through-v4l2-interface-not-working-in-23-2/
https://devtalk.nvidia.com/default/topic/914042/jetson-tx1/camera-name-in-dev-folder/
https://devtalk.nvidia.com/default/topic/904169/jetson-tx1/live-camera-h264enc-does-not-work/
https://devtalk.nvidia.com/default/topic/927971/jetson-tx1/isp-apis-on-tx1/
https://devtalk.nvidia.com/default/topic/934354/jetson-tx1/typical-approaches-to-test-camera-be-only-applicable-for-l4t-r23-2-jetson-tx1-release-/
</pre>

It works also with the UVC driver. David suggested the creation of a [https://devtalk.nvidia.com/default/topic/898129/jetson-tx1/enabling-camera-on-jetson-tx1-board/2/?offset=22#4838539 nvisp element to convert bayer to yuv]

=== Capture and Display ===

==== nvcamerasrc ====

<pre>
gst-launch-1.0 nvcamerasrc fpsRange="30.0 30.0" ! 'video/x-raw(memory:NVMM), width=(int)1920, height=(int)1080, format=(string)I420, framerate=(fraction)30/1' ! \
nvvidconv flip-method=2 ! 'video/x-raw(memory:NVMM), format=(string)I420' ! nvoverlaysink -e
</pre>

ARM consumption: 72% of one core (4 cores available 400% - this means something like 18% of total). However, only the capture is 11.25% so the display consumes '''6.75%'''.  For other camera you can find in our wiki latency numbers for [https://developer.ridgerun.com/wiki/index.php?title=Jetson_glass_to_glass_latency#Introduction  glass to glass measurements]

<pre>
RAM 1146/3854MB (lfb 470x4MB) SWAP 0/0MB (cached 0MB) cpu [2%,4%,5%,0%]@-1 VDE 0 EDP limit 0
RAM 1146/3854MB (lfb 470x4MB) SWAP 0/0MB (cached 0MB) cpu [3%,3%,5%,0%]@-1 VDE 0 EDP limit 0
RAM 1169/3854MB (lfb 469x4MB) SWAP 0/0MB (cached 0MB) cpu [25%,32%,21%,25%]@-1 VDE 0 EDP limit 0 ->Start capture
RAM 1170/3854MB (lfb 469x4MB) SWAP 0/0MB (cached 0MB) cpu [17%,15%,14%,12%]@-1 VDE 0 EDP limit 0
RAM 1170/3854MB (lfb 469x4MB) SWAP 0/0MB (cached 0MB) cpu [20%,16%,13%,18%]@-1 VDE 0 EDP limit 0
RAM 1170/3854MB (lfb 469x4MB) SWAP 0/0MB (cached 0MB) cpu [18%,15%,18%,16%]@-1 VDE 0 EDP limit 0
RAM 1170/3854MB (lfb 469x4MB) SWAP 0/0MB (cached 0MB) cpu [22%,18%,21%,16%]@-1 VDE 0 EDP limit 0
RAM 1170/3854MB (lfb 469x4MB) SWAP 0/0MB (cached 0MB) cpu [19%,20%,20%,11%]@-1 VDE 0 EDP limit 0
RAM 1170/3854MB (lfb 469x4MB) SWAP 0/0MB (cached 0MB) cpu [23%,20%,20%,16%]@-1 VDE 0 EDP limit 0
RAM 1170/3854MB (lfb 469x4MB) SWAP 0/0MB (cached 0MB) cpu [12%,10%,16%,11%]@-1 VDE 0 EDP limit 0
RAM 1170/3854MB (lfb 469x4MB) SWAP 0/0MB (cached 0MB) cpu [19%,20%,25%,15%]@-1 VDE 0 EDP limit 0
RAM 1170/3854MB (lfb 469x4MB) SWAP 0/0MB (cached 0MB) cpu [20%,14%,18%,20%]@-1 VDE 0 EDP limit 0
RAM 1170/3854MB (lfb 469x4MB) SWAP 0/0MB (cached 0MB) cpu [16%,15%,19%,12%]@-1 VDE 0 EDP limit 0
RAM 1170/3854MB (lfb 469x4MB) SWAP 0/0MB (cached 0MB) cpu [22%,21%,21%,19%]@-1 VDE 0 EDP limit 0
RAM 1170/3854MB (lfb 469x4MB) SWAP 0/0MB (cached 0MB) cpu [18%,14%,14%,15%]@-1 VDE 0 EDP limit 0
RAM 1150/3854MB (lfb 469x4MB) SWAP 0/0MB (cached 0MB) cpu [6%,2%,4%,7%]@-1 VDE 0 EDP limit 0 ->Stop capture
RAM 1150/3854MB (lfb 469x4MB) SWAP 0/0MB (cached 0MB) cpu [0%,0%,6%,0%]@-1 VDE 0 EDP limit 0
</pre>

<pre>
  PID USER      PR  NI    VIRT    RES    SHR S  %CPU %MEM     TIME+ COMMAND                                        
  589 root      20   0  797332  93308  22672 S  52.7  2.4   1:35.02 nvcamera-daemon                                
 4520 ubuntu    20   0  184444   5812   3712 S   2.9  0.1   0:00.46 gst-launch-1.0  
</pre>

=== H264 encoding ===

==== videotestsrc ====

ARM load: 175% but only videotestsrc consumes 100%. According to the NVIDIA forum when using videotestsrc the system is also doing memory copies to feed the encoder with NVMM memory buffers so that loads more the ARM.

<pre>
gst-launch-1.0 videotestsrc num-buffers=150 ! 'video/x-raw, format=(string)I420,width=(int)640, height=(int)480' ! omxh264enc ! 'video/x-h264, stream-format=(string)byte-stream' ! filesink location=test.h264 -e
</pre>

VLC can play the file correctly at 30fps and reports as codec: H264-MPEG-4 AVC (part 10) (h264). The fan on top of the SoC didn't turn on.

==== nvcamerasrc ====

<pre>
gst-launch-1.0 -e nvcamerasrc fpsRange="30.0 30.0" ! 'video/x-raw(memory:NVMM), width=(int)1920, height=(int)1080, format=(string)I420, framerate=(fraction)30/1' ! \
nvvidconv flip-method=2 ! 'video/x-raw(memory:NVMM), format=(string)I420' ! omxh264enc bitrate=8000000 \
! 'video/x-h264, stream-format=(string)byte-stream' ! filesink location=test.h264 -e
</pre>

Codecvisa reports bitrate on 7.96Mbps when variable mode is selected on the encoder.

ARM consumption ~80% of one core (4 cores available 400% - this means something like 20% of total). However, only the capture is 11.25% so the h264 consumes '''8.75%'''

<pre>
RAM 1243/3854MB (lfb 442x4MB) SWAP 0/0MB (cached 0MB) cpu [4%,7%,4%,5%]@-1 VDE 0 EDP limit 0
RAM 1247/3854MB (lfb 442x4MB) SWAP 0/0MB (cached 0MB) cpu [6%,1%,5%,8%]@-1 VDE 0 EDP limit 0
RAM 1272/3854MB (lfb 442x4MB) SWAP 0/0MB (cached 0MB) cpu [33%,24%,16%,34%]@-1 VDE 0 EDP limit 0
RAM 1273/3854MB (lfb 442x4MB) SWAP 0/0MB (cached 0MB) cpu [17%,12%,13%,13%]@-1 VDE 0 EDP limit 0
RAM 1273/3854MB (lfb 442x4MB) SWAP 0/0MB (cached 0MB) cpu [15%,12%,5%,13%]@-1 VDE 0 EDP limit 0
RAM 1273/3854MB (lfb 442x4MB) SWAP 0/0MB (cached 0MB) cpu [23%,15%,16%,11%]@-1 VDE 0 EDP limit 0
RAM 1273/3854MB (lfb 442x4MB) SWAP 0/0MB (cached 0MB) cpu [23%,16%,11%,22%]@-1 VDE 0 EDP limit 0
RAM 1273/3854MB (lfb 442x4MB) SWAP 0/0MB (cached 0MB) cpu [13%,8%,11%,16%]@-1 VDE 0 EDP limit 0
RAM 1277/3854MB (lfb 442x4MB) SWAP 0/0MB (cached 0MB) cpu [24%,24%,20%,22%]@-1 VDE 0 EDP limit 0
RAM 1277/3854MB (lfb 442x4MB) SWAP 0/0MB (cached 0MB) cpu [21%,19%,19%,21%]@-1 VDE 0 EDP limit 0
RAM 1278/3854MB (lfb 442x4MB) SWAP 0/0MB (cached 0MB) cpu [21%,16%,16%,19%]@-1 VDE 0 EDP limit 0
RAM 1278/3854MB (lfb 441x4MB) SWAP 0/0MB (cached 0MB) cpu [18%,13%,17%,20%]@-1 VDE 0 EDP limit 0
RAM 1279/3854MB (lfb 441x4MB) SWAP 0/0MB (cached 0MB) cpu [19%,23%,15%,20%]@-1 VDE 0 EDP limit 0
RAM 1279/3854MB (lfb 440x4MB) SWAP 0/0MB (cached 0MB) cpu [22%,22%,18%,14%]@-1 VDE 0 EDP limit 0
RAM 1279/3854MB (lfb 440x4MB) SWAP 0/0MB (cached 0MB) cpu [16%,16%,17%,13%]@-1 VDE 0 EDP limit 0
RAM 1279/3854MB (lfb 440x4MB) SWAP 0/0MB (cached 0MB) cpu [22%,18%,24%,23%]@-1 VDE 0 EDP limit 0
RAM 1279/3854MB (lfb 440x4MB) SWAP 0/0MB (cached 0MB) cpu [15%,13%,7%,16%]@-1 VDE 0 EDP limit 0
RAM 1279/3854MB (lfb 439x4MB) SWAP 0/0MB (cached 0MB) cpu [25%,20%,26%,21%]@-1 VDE 0 EDP limit 0
RAM 1280/3854MB (lfb 439x4MB) SWAP 0/0MB (cached 0MB) cpu [15%,15%,11%,13%]@-1 VDE 0 EDP limit 0
RAM 1277/3854MB (lfb 439x4MB) SWAP 0/0MB (cached 0MB) cpu [14%,12%,9%,23%]@-1 VDE 0 EDP limit 0
RAM 1255/3854MB (lfb 439x4MB) SWAP 0/0MB (cached 0MB) cpu [13%,7%,3%,4%]@-1 VDE 0 EDP limit 0
RAM 1255/3854MB (lfb 439x4MB) SWAP 0/0MB (cached 0MB) cpu [4%,4%,6%,0%]@-1 VDE 0 EDP limit 0
RAM 1255/3854MB (lfb 439x4MB) SWAP 0/0MB (cached 0MB) cpu [10%,0%,3%,0%]@-1 VDE 0 EDP limit 0
</pre>

<pre>
  589 root      20   0  869160 101880  23112 S  45.0  2.6   2:37.29 nvcamera-daemon                                
 4854 ubuntu    20   0  264964   6932   4028 S   6.8  0.2   0:01.05 gst-launch-1.0            
</pre>

The encoder exposes the following parameters

<pre>
  control-rate        : Bitrate control method
                        flags: readable, writable, changeable only in NULL or READY state
                        Enum "GstOMXVideoEncControlRate" Default: 1, "variable"
                           (0): disable          - Disable
                           (1): variable         - Variable
                           (2): constant         - Constant
                           (3): variable-skip-frames - Variable Skip Frames
                           (4): constant-skip-frames - Constant Skip Frames
  bitrate             : Target bitrate
                        flags: readable, writable, changeable in NULL, READY, PAUSED or PLAYING state
                        Unsigned Integer. Range: 0 - 4294967295 Default: 4000000 
  quant-i-frames      : Quantization parameter for I-frames (0xffffffff=component default)
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 4294967295 Default: 4294967295 
  quant-p-frames      : Quantization parameter for P-frames (0xffffffff=component default)
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 4294967295 Default: 4294967295 
  quant-b-frames      : Quantization parameter for B-frames (0xffffffff=component default)
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 4294967295 Default: 4294967295 
  iframeinterval      : Encoding Intra Frame occurance frequency
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 4294967295 Default: 0 
  quality-level       : Encoding quality-level
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 2 Default: 0 
  low-latency         : Whether or not set low latency attribute of encoder
                        flags: readable, writable, changeable only in NULL or READY state
                        Boolean. Default: false
  SliceIntraRefreshEnable: Enable Slice Intra Refresh while encoding
                        flags: readable, writable, changeable only in NULL or READY state
                        Boolean. Default: false
  SliceIntraRefreshInterval: Set SliceIntraRefreshInterval
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 4294967295 Default: 60 
  bit-packetization   : Whether or not Packet size is based upon Number Of bits
                        flags: readable, writable, changeable only in NULL or READY state
                        Boolean. Default: false
  vbv-size            : virtual buffer size = vbv-size * (bitrate/fps)
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 30 Default: 10 
  temporal-tradeoff   : Temporal Tradeoff value for encoder
                        flags: readable, writable, changeable only in NULL or READY state
                        Enum "GstOmxVideoEncTemporalTradeoffType" Default: 0, "Do not drop frames"
                           (0): Do not drop frames - GST_OMX_VIDENC_DROP_NO_FRAMES
                           (1): Drop 1 in 5 frames - GST_OMX_VIDENC_DROP_1_IN_5_FRAMES
                           (2): Drop 1 in 3 frames - GST_OMX_VIDENC_DROP_1_IN_3_FRAMES
                           (3): Drop 1 in 2 frames - GST_OMX_VIDENC_DROP_1_IN_2_FRAMES
                           (4): Drop 2 in 3 frames - GST_OMX_VIDENC_DROP_2_IN_3_FRAMES
  insert-sps-pps      : Insert H.264 SPS, PPS at every IDR frame
                        flags: readable, writable
                        Boolean. Default: false
  no-B-Frames         : Do not use B Frames while encoding
                        flags: readable, writable, changeable only in NULL or READY state
                        Boolean. Default: false
  slice-header-spacing: Slice Header Spacing number of macroblocks/bits in one packet
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Long. Range: 0 - 4294967295 Default: 0 
  profile             : Set profile for encode
                        flags: readable, writable, changeable only in NULL or READY state
                        Enum "GstOmxVideoEncProfileType" Default: 1, "baseline"
                           (1): baseline         - GST_OMX_VIDENC_BASELINE_PROFILE
                           (2): main             - GST_OMX_VIDENC_MAIN_PROFILE
                           (8): high             - GST_OMX_VIDENC_HIGH_PROFILE

</pre>

=== Dual H264 encoding ===

<pre>
gst-launch-1.0 -e nvcamerasrc fpsRange="30.0 30.0" ! 'video/x-raw(memory:NVMM), width=(int)1920, height=(int)1080, format=(string)I420, framerate=(fraction)30/1' ! \
nvvidconv flip-method=2 ! 'video/x-raw(memory:NVMM), format=(string)I420' ! tee name=streams \
streams. ! omxh264enc bitrate=8000000 ! 'video/x-h264, stream-format=(string)byte-stream' ! filesink location=testA.h264 \
streams. ! omxh264enc bitrate=8000000 ! 'video/x-h264, stream-format=(string)byte-stream' ! filesink location=testB.h264
</pre>


ARM consumption ~81% of one core (4 cores available 400% - this means something like 20.25% of total). However, only the capture is 11.25% so the dual h264 consumes '''9%'''

<pre>
RAM 948/3854MB (lfb 539x4MB) SWAP 0/0MB (cached 0MB) cpu [2%,0%,0%,4%]@102 EMC 7%@408 AVP 57%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 952/3854MB (lfb 539x4MB) SWAP 0/0MB (cached 0MB) cpu [9%,9%,0%,5%]@1734 EMC 2%@1600 AVP 56%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 969/3854MB (lfb 539x4MB) SWAP 0/0MB (cached 0MB) cpu [24%,24%,35%,27%]@1224 EMC 15%@1065 AVP 41%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 970/3854MB (lfb 539x4MB) SWAP 0/0MB (cached 0MB) cpu [22%,19%,19%,19%]@307 EMC 29%@665 AVP 63%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 970/3854MB (lfb 539x4MB) SWAP 0/0MB (cached 0MB) cpu [23%,18%,14%,14%]@1224 EMC 19%@1065 AVP 69%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 970/3854MB (lfb 538x4MB) SWAP 0/0MB (cached 0MB) cpu [19%,19%,19%,17%]@403 EMC 32%@665 AVP 69%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 971/3854MB (lfb 538x4MB) SWAP 0/0MB (cached 0MB) cpu [25%,16%,24%,18%]@1224 EMC 19%@1065 AVP 62%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 971/3854MB (lfb 537x4MB) SWAP 0/0MB (cached 0MB) cpu [24%,19%,19%,21%]@307 EMC 32%@665 AVP 69%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 971/3854MB (lfb 537x4MB) SWAP 0/0MB (cached 0MB) cpu [25%,21%,20%,18%]@307 EMC 19%@1065 AVP 69%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 971/3854MB (lfb 536x4MB) SWAP 0/0MB (cached 0MB) cpu [22%,24%,28%,25%]@1224 EMC 19%@1065 AVP 62%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 971/3854MB (lfb 536x4MB) SWAP 0/0MB (cached 0MB) cpu [19%,19%,21%,18%]@518 EMC 32%@665 AVP 62%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 971/3854MB (lfb 535x4MB) SWAP 0/0MB (cached 0MB) cpu [23%,22%,24%,22%]@518 EMC 32%@665 AVP 69%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 971/3854MB (lfb 535x4MB) SWAP 0/0MB (cached 0MB) cpu [24%,25%,22%,19%]@403 EMC 32%@665 AVP 69%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 971/3854MB (lfb 534x4MB) SWAP 0/0MB (cached 0MB) cpu [22%,17%,17%,25%]@1224 EMC 19%@1065 AVP 62%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 971/3854MB (lfb 534x4MB) SWAP 0/0MB (cached 0MB) cpu [18%,23%,21%,18%]@614 EMC 32%@665 AVP 62%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 971/3854MB (lfb 533x4MB) SWAP 0/0MB (cached 0MB) cpu [19%,22%,21%,21%]@1224 EMC 19%@1065 AVP 55%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 971/3854MB (lfb 533x4MB) SWAP 0/0MB (cached 0MB) cpu [18%,21%,19%,21%]@1224 EMC 19%@1065 AVP 70%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 971/3854MB (lfb 533x4MB) SWAP 0/0MB (cached 0MB) cpu [17%,21%,16%,22%]@1224 EMC 19%@1065 AVP 63%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 971/3854MB (lfb 532x4MB) SWAP 0/0MB (cached 0MB) cpu [22%,21%,14%,27%]@307 EMC 32%@665 AVP 63%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 971/3854MB (lfb 532x4MB) SWAP 0/0MB (cached 0MB) cpu [16%,17%,20%,17%]@307 EMC 32%@665 AVP 71%@12 VDE 0 GR3D 0%
</pre>

=== H264 UDP Streaming ===

server:
<pre>
CLIENT_IP=<IP_ADDRESS>
gst-launch-1.0 nvcamerasrc fpsRange="30 30" intent=3 ! nvvidconv flip-method=6 \
! 'video/x-raw(memory:NVMM), width=(int)1920, height=(int)1080, format=(string)I420, framerate=(fraction)30/1' ! \
omxh264enc low-latency=1 control-rate=2 bitrate=4000000 ! 'video/x-h264, stream-format=(string)byte-stream' ! \
h264parse ! rtph264pay mtu=1400 ! udpsink host=$CLIENT_IP port=5000 sync=false async=false
</pre>

PC client:
<pre>
gst-launch-1.0 udpsrc port=5000 ! application/x-rtp,encoding-name=H264,payload=96 ! rtph264depay ! h264parse ! queue ! avdec_h264 ! xvimagesink sync=false async=false -e
</pre>
 
=== h264 parse missing===
In case gstreamer complains when running the pipeline for missing the h264parse plugin, run the following command to install it: 
<pre>
sudo apt-get install gstreamer1.0-plugins-bad
</pre>

==== Latency ====

*1080p30
*H264
*Bitrate 4Mbps
*Latency=172ms

=== VP8 encoding ===

==== videotestsrc ====

ARM load: 156% but only videotestsrc consumes 100%. According to the NVIDIA forum when using videotestsrc the system is also doing memory copies to feed the encoder with NVMM memory buffers so that loads more the ARM.

<pre>
gst-launch-1.0 videotestsrc num-buffers=150 ! 'video/x-raw, format=(string)I420,width=(int)640, height=(int)480' ! omxvp8enc ! qtmux ! filesink location=test.mp4 -e
</pre>

VLC can play the file correctly at 30fps and reports as codec: Google/On2's VP8 Video (VP80). The fan on top of the SoC didn't turn on.

==== nvcamerasrc ====

<pre>

gst-launch-1.0 -e nvcamerasrc fpsRange="30.0 30.0" ! 'video/x-raw(memory:NVMM), width=(int)1920, height=(int)1080, format=(string)I420, framerate=(fraction)30/1' ! \
nvvidconv flip-method=2 ! 'video/x-raw(memory:NVMM), format=(string)I420' ! omxvp8enc bitrate=8000000 ! qtmux ! filesink location=test.mp4 -e

</pre>

VLC reports bitrate on ~8Mbps.

ARM consumption ~77% of one core (4 cores available 400% - this means something like 19.25% of total). However, only the capture is 11.25% so the VP8 consumes '''8%'''

<pre>
RAM 1288/3854MB (lfb 430x4MB) SWAP 0/0MB (cached 0MB) cpu [11%,1%,7%,2%]@-1 VDE 0 EDP limit 0
RAM 1292/3854MB (lfb 430x4MB) SWAP 0/0MB (cached 0MB) cpu [11%,23%,4%,4%]@-1 VDE 0 EDP limit 0
RAM 1314/3854MB (lfb 430x4MB) SWAP 0/0MB (cached 0MB) cpu [33%,20%,45%,19%]@-1 VDE 0 EDP limit 0
RAM 1314/3854MB (lfb 430x4MB) SWAP 0/0MB (cached 0MB) cpu [29%,24%,16%,22%]@-1 VDE 0 EDP limit 0
RAM 1314/3854MB (lfb 430x4MB) SWAP 0/0MB (cached 0MB) cpu [24%,20%,25%,21%]@-1 VDE 0 EDP limit 0
RAM 1314/3854MB (lfb 430x4MB) SWAP 0/0MB (cached 0MB) cpu [29%,26%,26%,21%]@-1 VDE 0 EDP limit 0
RAM 1314/3854MB (lfb 430x4MB) SWAP 0/0MB (cached 0MB) cpu [30%,25%,24%,26%]@-1 VDE 0 EDP limit 0
RAM 1314/3854MB (lfb 429x4MB) SWAP 0/0MB (cached 0MB) cpu [24%,23%,25%,21%]@-1 VDE 0 EDP limit 0
RAM 1314/3854MB (lfb 429x4MB) SWAP 0/0MB (cached 0MB) cpu [17%,18%,26%,17%]@-1 VDE 0 EDP limit 0
RAM 1314/3854MB (lfb 429x4MB) SWAP 0/0MB (cached 0MB) cpu [19%,18%,20%,20%]@-1 VDE 0 EDP limit 0
RAM 1314/3854MB (lfb 429x4MB) SWAP 0/0MB (cached 0MB) cpu [14%,16%,14%,16%]@-1 VDE 0 EDP limit 0
RAM 1314/3854MB (lfb 428x4MB) SWAP 0/0MB (cached 0MB) cpu [20%,16%,17%,19%]@-1 VDE 0 EDP limit 0
RAM 1314/3854MB (lfb 428x4MB) SWAP 0/0MB (cached 0MB) cpu [19%,9%,14%,19%]@-1 VDE 0 EDP limit 0
RAM 1314/3854MB (lfb 428x4MB) SWAP 0/0MB (cached 0MB) cpu [14%,12%,14%,17%]@-1 VDE 0 EDP limit 0
RAM 1314/3854MB (lfb 428x4MB) SWAP 0/0MB (cached 0MB) cpu [17%,15%,16%,18%]@-1 VDE 0 EDP limit 0
RAM 1314/3854MB (lfb 427x4MB) SWAP 0/0MB (cached 0MB) cpu [23%,18%,23%,15%]@-1 VDE 0 EDP limit 0
RAM 1314/3854MB (lfb 427x4MB) SWAP 0/0MB (cached 0MB) cpu [12%,18%,18%,17%]@-1 VDE 0 EDP limit 0
RAM 1314/3854MB (lfb 427x4MB) SWAP 0/0MB (cached 0MB) cpu [14%,18%,10%,14%]@-1 VDE 0 EDP limit 0
RAM 1292/3854MB (lfb 427x4MB) SWAP 0/0MB (cached 0MB) cpu [12%,10%,11%,9%]@-1 VDE 0 EDP limit 0
</pre>

<pre>
  589 root      20   0  948716 106776  23616 S  52.7  2.7   3:38.42 nvcamera-daemon                                
 5258 ubuntu    20   0  264572   7300   4188 S   8.8  0.2   0:01.44 gst-launch-1.0       
</pre>

The encoder exposes the following parameters

<pre>
  bitrate             : Target bitrate
                        flags: readable, writable, changeable in NULL, READY, PAUSED or PLAYING state
                        Unsigned Integer. Range: 0 - 4294967295 Default: 4000000 
  quant-i-frames      : Quantization parameter for I-frames (0xffffffff=component default)
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 4294967295 Default: 4294967295 
  quant-p-frames      : Quantization parameter for P-frames (0xffffffff=component default)
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 4294967295 Default: 4294967295 
  quant-b-frames      : Quantization parameter for B-frames (0xffffffff=component default)
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 4294967295 Default: 4294967295 
  iframeinterval      : Encoding Intra Frame occurance frequency
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 4294967295 Default: 0 
  quality-level       : Encoding quality-level
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 2 Default: 0 
  low-latency         : Whether or not set low latency attribute of encoder
                        flags: readable, writable, changeable only in NULL or READY state
                        Boolean. Default: false
  SliceIntraRefreshEnable: Enable Slice Intra Refresh while encoding
                        flags: readable, writable, changeable only in NULL or READY state
                        Boolean. Default: false
  SliceIntraRefreshInterval: Set SliceIntraRefreshInterval
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 4294967295 Default: 60 
  bit-packetization   : Whether or not Packet size is based upon Number Of bits
                        flags: readable, writable, changeable only in NULL or READY state
                        Boolean. Default: false
  vbv-size            : virtual buffer size = vbv-size * (bitrate/fps)
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 30 Default: 10 
  temporal-tradeoff   : Temporal Tradeoff value for encoder
                        flags: readable, writable, changeable only in NULL or READY state
                        Enum "GstOmxVideoEncTemporalTradeoffType" Default: 0, "Do not drop frames"
                           (0): Do not drop frames - GST_OMX_VIDENC_DROP_NO_FRAMES
                           (1): Drop 1 in 5 frames - GST_OMX_VIDENC_DROP_1_IN_5_FRAMES
                           (2): Drop 1 in 3 frames - GST_OMX_VIDENC_DROP_1_IN_3_FRAMES
                           (3): Drop 1 in 2 frames - GST_OMX_VIDENC_DROP_1_IN_2_FRAMES
                           (4): Drop 2 in 3 frames - GST_OMX_VIDENC_DROP_2_IN_3_FRAMES
</pre>

=== H265 encoding ===

==== VLC with H265 support ====

In order to support h265 you need VLC 2.2 in your computer to play the videos

<pre>
sudo add-apt-repository ppa:mc3man/trusty-media
sudo apt-get update
sudo apt-get install vlc vlc-plugin-*
</pre>

==== videotestsrc ====

ARM load: 156% but only videotestsrc consumes 100%. According to the NVIDIA forum when using videotestsrc the system is also doing memory copies to feed the encoder with NVMM memory buffers so that loads more the ARM.

<pre>
gst-launch-1.0 videotestsrc num-buffers=150 ! 'video/x-raw, format=(string)I420,width=(int)640, height=(int)480' ! omxh265enc ! filesink location=test.h265 -e
</pre>

VLC can play the file correctly at 30fps and reports as codec: MPEG-H Part2/HEVC (H.265)(hevc). The fan on top of the SoC didn't turn on.

==== nvcamerasrc ====

<pre>
gst-launch-1.0 -e nvcamerasrc fpsRange="30.0 30.0" ! 'video/x-raw(memory:NVMM), width=(int)1920, height=(int)1080, format=(string)I420, framerate=(fraction)30/1' ! \
nvvidconv flip-method=2 ! 'video/x-raw(memory:NVMM), format=(string)I420' ! omxh265enc ! filesink location=test.h265 -e
</pre>

Codecvisa reports bitrate on 7.96Mbps when variable mode is selected on the encoder.

ARM consumption ~55% of one core (4 cores available 400% - this means something like 13.75% of total). However, only the capture is 11.25% so the h264 consumes '''2.75%'''

<pre>
RAM 1329/3854MB (lfb 418x4MB) SWAP 0/0MB (cached 0MB) cpu [5%,7%,4%,8%]@-1 VDE 0 EDP limit 0
RAM 1329/3854MB (lfb 418x4MB) SWAP 0/0MB (cached 0MB) cpu [4%,5%,3%,2%]@-1 VDE 0 EDP limit 0
RAM 1342/3854MB (lfb 418x4MB) SWAP 0/0MB (cached 0MB) cpu [35%,19%,7%,8%]@-1 VDE 0 EDP limit 0
RAM 1350/3854MB (lfb 417x4MB) SWAP 0/0MB (cached 0MB) cpu [21%,19%,25%,35%]@-1 VDE 0 EDP limit 0
RAM 1350/3854MB (lfb 417x4MB) SWAP 0/0MB (cached 0MB) cpu [22%,25%,18%,20%]@-1 VDE 0 EDP limit 0
RAM 1350/3854MB (lfb 417x4MB) SWAP 0/0MB (cached 0MB) cpu [17%,18%,18%,17%]@-1 VDE 0 EDP limit 0
RAM 1351/3854MB (lfb 417x4MB) SWAP 0/0MB (cached 0MB) cpu [21%,23%,26%,22%]@-1 VDE 0 EDP limit 0
RAM 1351/3854MB (lfb 416x4MB) SWAP 0/0MB (cached 0MB) cpu [19%,24%,11%,13%]@-1 VDE 0 EDP limit 0
RAM 1350/3854MB (lfb 416x4MB) SWAP 0/0MB (cached 0MB) cpu [22%,24%,16%,16%]@-1 VDE 0 EDP limit 0
RAM 1350/3854MB (lfb 416x4MB) SWAP 0/0MB (cached 0MB) cpu [20%,22%,14%,17%]@-1 VDE 0 EDP limit 0
RAM 1350/3854MB (lfb 416x4MB) SWAP 0/0MB (cached 0MB) cpu [14%,14%,15%,17%]@-1 VDE 0 EDP limit 0
RAM 1350/3854MB (lfb 416x4MB) SWAP 0/0MB (cached 0MB) cpu [14%,19%,19%,12%]@-1 VDE 0 EDP limit 0
RAM 1350/3854MB (lfb 416x4MB) SWAP 0/0MB (cached 0MB) cpu [28%,21%,17%,16%]@-1 VDE 0 EDP limit 0
RAM 1350/3854MB (lfb 416x4MB) SWAP 0/0MB (cached 0MB) cpu [19%,13%,21%,17%]@-1 VDE 0 EDP limit 0
RAM 1350/3854MB (lfb 416x4MB) SWAP 0/0MB (cached 0MB) cpu [25%,12%,13%,23%]@-1 VDE 0 EDP limit 0
RAM 1350/3854MB (lfb 416x4MB) SWAP 0/0MB (cached 0MB) cpu [20%,21%,17%,21%]@-1 VDE 0 EDP limit 0
RAM 1350/3854MB (lfb 415x4MB) SWAP 0/0MB (cached 0MB) cpu [18%,16%,18%,17%]@-1 VDE 0 EDP limit 0
RAM 1350/3854MB (lfb 415x4MB) SWAP 0/0MB (cached 0MB) cpu [18%,16%,18%,17%]@-1 VDE 0 EDP limit 0
RAM 1350/3854MB (lfb 415x4MB) SWAP 0/0MB (cached 0MB) cpu [15%,12%,9%,16%]@-1 VDE 0 EDP limit 0
RAM 1350/3854MB (lfb 415x4MB) SWAP 0/0MB (cached 0MB) cpu [16%,13%,16%,13%]@-1 VDE 0 EDP limit 0
RAM 1351/3854MB (lfb 415x4MB) SWAP 0/0MB (cached 0MB) cpu [18%,12%,10%,15%]@-1 VDE 0 EDP limit 0
RAM 1351/3854MB (lfb 415x4MB) SWAP 0/0MB (cached 0MB) cpu [11%,18%,18%,14%]@-1 VDE 0 EDP limit 0
RAM 1351/3854MB (lfb 415x4MB) SWAP 0/0MB (cached 0MB) cpu [19%,11%,16%,14%]@-1 VDE 0 EDP limit 0
RAM 1350/3854MB (lfb 415x4MB) SWAP 0/0MB (cached 0MB) cpu [13%,16%,11%,9%]@-1 VDE 0 EDP limit 0
RAM 1334/3854MB (lfb 415x4MB) SWAP 0/0MB (cached 0MB) cpu [6%,6%,14%,3%]@-1 VDE 0 EDP limit 0
RAM 1334/3854MB (lfb 415x4MB) SWAP 0/0MB (cached 0MB) cpu [3%,0%,2%,6%]@-1 VDE 0 EDP limit 0
RAM 1334/3854MB (lfb 415x4MB) SWAP 0/0MB (cached 0MB) cpu [8%,4%,7%,0%]@-1 VDE 0 EDP limit 0
</pre>

<pre>
  589 root      20   0 1043228 110648  24268 S  46.4  2.8   4:22.56 nvcamera-daemon                                
 5715 ubuntu    20   0  274224   7420   4212 S   7.7  0.2   0:01.72 gst-launch-1.0                       
</pre>

The encoder exposes the following parameters

<pre>
  control-rate        : Bitrate control method
                        flags: readable, writable, changeable only in NULL or READY state
                        Enum "GstOMXVideoEncControlRate" Default: 1, "variable"
                           (0): disable          - Disable
                           (1): variable         - Variable
                           (2): constant         - Constant
                           (3): variable-skip-frames - Variable Skip Frames
                           (4): constant-skip-frames - Constant Skip Frames
  bitrate             : Target bitrate
                        flags: readable, writable, changeable in NULL, READY, PAUSED or PLAYING state
                        Unsigned Integer. Range: 0 - 4294967295 Default: 4000000 
  quant-i-frames      : Quantization parameter for I-frames (0xffffffff=component default)
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 4294967295 Default: 4294967295 
  quant-p-frames      : Quantization parameter for P-frames (0xffffffff=component default)
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 4294967295 Default: 4294967295 
  quant-b-frames      : Quantization parameter for B-frames (0xffffffff=component default)
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 4294967295 Default: 4294967295 
  iframeinterval      : Encoding Intra Frame occurance frequency
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 4294967295 Default: 0 
  quality-level       : Encoding quality-level
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 2 Default: 0 
  low-latency         : Whether or not set low latency attribute of encoder
                        flags: readable, writable, changeable only in NULL or READY state
                        Boolean. Default: false
  SliceIntraRefreshEnable: Enable Slice Intra Refresh while encoding
                        flags: readable, writable, changeable only in NULL or READY state
                        Boolean. Default: false
  SliceIntraRefreshInterval: Set SliceIntraRefreshInterval
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 4294967295 Default: 60 
  bit-packetization   : Whether or not Packet size is based upon Number Of bits
                        flags: readable, writable, changeable only in NULL or READY state
                        Boolean. Default: false
  vbv-size            : virtual buffer size = vbv-size * (bitrate/fps)
                        flags: readable, writable, changeable only in NULL or READY state
                        Unsigned Integer. Range: 0 - 30 Default: 10 
  temporal-tradeoff   : Temporal Tradeoff value for encoder
                        flags: readable, writable, changeable only in NULL or READY state
                        Enum "GstOmxVideoEncTemporalTradeoffType" Default: 0, "Do not drop frames"
                           (0): Do not drop frames - GST_OMX_VIDENC_DROP_NO_FRAMES
                           (1): Drop 1 in 5 frames - GST_OMX_VIDENC_DROP_1_IN_5_FRAMES
                           (2): Drop 1 in 3 frames - GST_OMX_VIDENC_DROP_1_IN_3_FRAMES
                           (3): Drop 1 in 2 frames - GST_OMX_VIDENC_DROP_1_IN_2_FRAMES
                           (4): Drop 2 in 3 frames - GST_OMX_VIDENC_DROP_2_IN_3_FRAMES
</pre>

=== Dual H265 encoding ===

<pre>
gst-launch-1.0 -e nvcamerasrc fpsRange="30.0 30.0" ! 'video/x-raw(memory:NVMM), width=(int)1920, height=(int)1080, format=(string)I420, framerate=(fraction)30/1' ! \
nvvidconv flip-method=2 ! 'video/x-raw(memory:NVMM), format=(string)I420' ! tee name=streams \
streams. ! omxh264enc bitrate=8000000 ! 'video/x-h264, stream-format=(string)byte-stream' ! filesink location=testA.h264 \
streams. ! omxh264enc bitrate=8000000 ! 'video/x-h264, stream-format=(string)byte-stream' ! filesink location=testB.h264
</pre>

<pre>
gst-launch-1.0 -e nvcamerasrc fpsRange="30.0 30.0" ! 'video/x-raw(memory:NVMM), width=(int)1920, height=(int)1080, format=(string)I420, framerate=(fraction)30/1' ! \
nvvidconv flip-method=2 ! 'video/x-raw(memory:NVMM), format=(string)I420' ! tee name=streams \
streams. ! omxh265enc bitrate=8000000 ! 'video/x-h265, stream-format=(string)byte-stream' ! filesink location=testA.h265 \
streams. ! omxh265enc bitrate=8000000 ! 'video/x-h265, stream-format=(string)byte-stream' ! filesink location=testB.h265
</pre>

ARM consumption ~61% of one core (4 cores available 400% - this means something like 15.25% of total). However, only the capture is 11.25% so the dual h265 consumes '''4%'''

<pre>
RAM 950/3854MB (lfb 525x4MB) SWAP 0/0MB (cached 0MB) cpu [0%,0%,0%,0%]@1224 EMC 3%@1065 AVP 64%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 950/3854MB (lfb 525x4MB) SWAP 0/0MB (cached 0MB) cpu [2%,0%,0%,0%]@102 EMC 9%@408 AVP 64%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 951/3854MB (lfb 525x4MB) SWAP 0/0MB (cached 0MB) cpu [0%,6%,0%,1%]@102 EMC 3%@1065 AVP 64%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 954/3854MB (lfb 525x4MB) SWAP 0/0MB (cached 0MB) cpu [9%,7%,4%,14%]@102 EMC 3%@1065 AVP 56%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 968/3854MB (lfb 525x4MB) SWAP 0/0MB (cached 0MB) cpu [32%,10%,40%,9%]@614 EMC 20%@665 AVP 44%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 968/3854MB (lfb 525x4MB) SWAP 0/0MB (cached 0MB) cpu [26%,14%,20%,18%]@1224 EMC 16%@1065 AVP 58%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 969/3854MB (lfb 525x4MB) SWAP 0/0MB (cached 0MB) cpu [21%,18%,19%,17%]@1224 EMC 18%@1065 AVP 58%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 969/3854MB (lfb 525x4MB) SWAP 0/0MB (cached 0MB) cpu [20%,17%,14%,7%]@403 EMC 29%@665 AVP 72%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 969/3854MB (lfb 525x4MB) SWAP 0/0MB (cached 0MB) cpu [21%,10%,12%,11%]@1224 EMC 18%@1065 AVP 72%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 969/3854MB (lfb 525x4MB) SWAP 0/0MB (cached 0MB) cpu [20%,16%,14%,11%]@1224 EMC 18%@1065 AVP 65%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 969/3854MB (lfb 525x4MB) SWAP 0/0MB (cached 0MB) cpu [18%,6%,14%,13%]@1224 EMC 18%@1065 AVP 7%@115 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 970/3854MB (lfb 525x4MB) SWAP 0/0MB (cached 0MB) cpu [36%,15%,12%,14%]@1224 EMC 19%@1065 AVP 65%@12 VDE 0 GR3D 0%@76 EDP limit 1734
RAM 952/3854MB (lfb 525x4MB) SWAP 0/0MB (cached 0MB) cpu [10%,14%,11%,10%]@102 EMC 10%@1065 AVP 58%@12 VDE 0 GR3D 0%@76 EDP limit 1734
</pre>

=== H265 UDP Streaming ===

In order to start streaming H265 you need the h265 payloader, to do this you need to compile the latest version of gstreamer in your Jetson TX1. Please follow the [http://developer.ridgerun.com/wiki/index.php?title=Compile_gstreamer_on_tegra_X1 instructions to do it]. Same instructions can be run in your PC if you want to update the gstreamer version in your host. (in case of the host I had to recompile the good plugins to get the rtph265pay).

Currently it is not possible to receive the stream using the PC because there is not a h265 decoder available on gstreamer. In order to evaluate the performance let's receive the stream on the Jetson module as well.

<pre>
export PKG_CONFIG_PATH=/home/$USER/gst_$VERSION/out/lib/pkgconfig
VERSION=1.8.0
export LD_LIBRARY_PATH=/home/$USER/gst_$VERSION/out/lib/
</pre>


server:
<pre>
CLIENT_IP=<IP_ADDRESS>
gst-launch-1.0 nvcamerasrc fpsRange="30 30" intent=3 ! nvvidconv flip-method=6 \
! 'video/x-raw(memory:NVMM), width=(int)1920, height=(int)1080, format=(string)I420, framerate=(fraction)30/1' ! \
omxh265enc low-latency=1 control-rate=2 bitrate=4000000 ! 'video/x-h265, stream-format=(string)byte-stream' ! \
h265parse ! rtph265pay mtu=1400 ! udpsink host=$CLIENT_IP port=5000 sync=false async=false
</pre>

client:
<pre>
gst-launch-1.0 udpsrc port=5000 ! application/x-rtp,encoding-name=H265,payload=96 ! rtph265depay \
! h265parse ! queue ! omxh265dec ! nvoverlaysink sync=false async=false -e
</pre>

==== Latency ====

*1080p30
*H265
*Bitrate 4Mbps
*Latency=258ms

'''See also'''

 https://devtalk.nvidia.com/default/topic/902541/jetson-tx1/low-latency-video-streaming-with-h-265/
 https://devtalk.nvidia.com/default/topic/901967/jetson-tx1/gstreamer-rtp-h-265-elements-missing/


=== MPEG 2 decoding ===

==== GStreamer ====
Software based encoding:
<pre>
gst-launch-1.0 -e nvcamerasrc fpsRange="30.0 30.0" ! 'video/x-raw(memory:NVMM), width=(int)1920, height=(int)1080, format=(string)I420, framerate=(fraction)30/1' ! nvvidconv ! avenc_mpeg2video bitrate=4000000  ! filesink location=file.mpeg2
</pre>

HW based decoding:
<pre>
gst-launch-1.0 -e filesrc location=file.mpeg2 ! mpegvideoparse ! omxmpeg2videodec ! nvoverlaysink
</pre>

==== VLC Playback ====
<pre>
./vlc --demux mpgv file.mpeg2
</pre>

=== MPEG 2 UDP streaming ===

==== GStreamer ====
Software based sender:
<pre>
gst-launch-1.0 nvcamerasrc fpsRange="30 30" intent=3 ! 'video/x-raw(memory:NVMM), width=(int)1920, height=(int)1080, format=(string)I420, framerate=(fraction)30/1' ! nvvidconv ! avenc_mpeg2video bitrate=4000000 ! queue ! mpegvideoparse ! udpsink host=127.0.0.1 port=12345 sync=false async=false
</pre>

Hardware based receiver:
<pre>
gst-launch-1.0 udpsrc port=12345 ! mpegvideoparse ! omxmpeg2videodec ! nvoverlaysink
</pre>

==== VLC ====
VLC receiver:
<pre>
./vlc --demux mpgv udp://@127.0.0.1:12345
</pre>

== nvgstcapture-1.0 ==

This is an application based on gstreamer and omx to capture, encode and save video to the filesystem. It has a lot of options. The source code is not released by NVIDIA yet but they are planning to release in future versions of Linx 4 Tegra (L4T), you can read about it at [https://devtalk.nvidia.com/default/topic/898129/jetson-tx1/enabling-camera-on-jetson-tx1-board/ Nvidia Embedded Computing Forum]

<pre>

nvidia@tegra-ubuntu:~$ nvgstcapture-1.0 --help
Encoder null, cannot set bitrate!
Encoder Profile = Baseline
Usage:
  nvgstcapture-1.0 [OPTION...] Nvidia GStreamer Camera Model Test

Help Options:
  -h, --help                         Show help options
  --help-all                         Show all help options
  --help-gst                         Show GStreamer Options

Application Options:
  --prev-res                         Preview width & height. USB Range: 0 to 12 (5632x4224) and CSI Range: 2 to 12 (5632x4224) e.g., --prev-res=3
  --cus-prev-res                     Custom Preview width & height [for CSI only] e.g., --cus-prev-res=1920x1080
  --image-res                        Image width & height. Range: 0 to 12 (5632x4224) e.g., --image-res=3
  --video-res                        Video width & height. Range: 0 to 9 (3896x2192) e.g., --video-res=3
  -m, --mode                         Capture mode value (1=still 2=video)
  -v, --video-enc                    Video encoder type (0=h264[HW] 1=vp8[HW] 2=h265[HW] 3=vp9[HW])
  -b, --enc-bitrate                  Video encoding Bit-rate(in bytes) e.g., --enc-bitrate=4000000
  --enc-profile                      Video encoder profile (Only for H.264) (0=Baseline, 1=Main, 2=High)
  -J, --image-enc                    Image encoder type (0=jpeg_SW[jpegenc] 1=jpeg_HW[nvjpegenc])
  -k, --file-type                    Container file type (0=mp4 1=3gp 2=mkv)
  --cap-dev-node                     Video capture device node (0=/dev/video0[default], 1=/dev/video1, 2=/dev/video2) e.g., --cap-dev-node=0
  --svs                              [For USB] (=) chain for video Preview. [For CSI only] use "nvoverlaysink"
  --file-name                        Captured file name. nvcamtest is used by default
  --camsrc                           Camera Source to use (0=v4l2, 1=csi[default], 2=videotest, 3=eglstream)
  --orientation                      [For CSI only] Camera sensor orientation value
  -w, --whitebalance                 [For CSI only] Capture whitebalance value
  -s, --scene-mode                   [For CSI only] Camera Scene-Mode value
  -c, --color-effect                 [For CSI only] Camera Color Effect value
  --auto-exposure                    [For CSI only] Camera Auto-Exposure value
  --flash                            [For CSI only] Camera Flash value
  --flicker                          [For CSI only] Camera Flicker Detection and Avoidance Mode value
  --contrast                         [For CSI only] Camera Contrast value
  --saturation                       [For CSI only] Camera Saturation value
  --edge-enhancement                 [For CSI only] Camera Edge Enhancement value
  --tnr-strength                     [For CSI only] Camera TNR-Strength value
  --tnr-mode                         [For CSI only] Camera TNR Mode value
  --sensor-id                        [For CSI only] Camera Sensor ID value
  --eglstream-id                     [For CSI EGLStream Consumer] Select EGLStream Producer ID value. Default value 0
  --display-id                       [For nvoverlaysink only] Display ID value
  --aeRegion                         [For CSI Only] ROI for AE coordinates(top,left,bottom,right) and weight in that order.e.g., --aeRegion="30 40 200 200 1.2"
  --wbRegion                         [For CSI Only] ROI for AWB coordinates(top,left,bottom,right) and weight in that order.e.g., --wbRegion="30 40 200 200 1.2"
  --fpsRange                         [For CSI Only] FPS range values (low, high) e.g., --fpsRange="15 30"
  --exposure-time                    [For CSI only] Capture exposure time value. e.g., --exposure-time=0.033
  --wbGains                          [For CSI Only] WB gains values (R, GR, GB, B) in that order. e.g., --wbGains="1.2 1.4 0.8 1.6"
  --overlayConfig                    Overlay Configuration Options index and coordinates in (index, x_pos, y_pos, width, height) order  e.g. --overlayConfig="0, 0, 0, 1280, 720"
  --enable-exif                      Enable Exif data
  --dump-bayer                       Dump bayer data in addition to image capture.
  --eglConfig                        EGL window Coordinates (x_pos y_pos) in that order  e.g., --eglConfig="50 100"
  --aeLock                           [For CSI only] Enable auto exposure lock e.g., --aeLock
  --enable-meta                      Enable Sensor MetaData reporting
  --nvvideosink-create-eglstream     [For nvvideosink EGLStream Producer] Enable nvvideosink EGLStream Producer
  --callback                         Enable User callback to set capture settings per frame
  --app-profile                      Enable KPI profiling
  --kpi-numbers                      Enable KPI measurement
  -A, --automate                     Run application in automation mode
  -S, --start-time                   Start capture after specified time in seconds. Default = 5 sec (use with --automate or -A only)
  -Q, --quit-after                   Quit application once automation is done after specified time in seconds. Default = 0 sec (use with --automate or -A only)
  -C, --count                        Number of iterations of automation testcase. Default = 1 (use with --automate or -A only)
  --capture-gap                      Number of milliseconds between successive image/video capture. Default = 250 msec (use with --automate and --capture-auto only)
  --capture-time                     Capture video for specified time in seconds. Default = 10 sec (use with --automate and --capture-auto only)
  --toggle-mode                      Toggle between still and video capture modes for count number of times (use with --automate or -A only)
  --toggle-sensor                    Toggle between sensor-id 0 and 1 (use with --automate or -A only)
  --capture-auto                     Do image/video capture in automation mode for count number of times(use with --automate or -A only)
  --enum-wb                          Enumerate all white-balance modes for count number of times (use with --automate or -A only)
  --enum-scm                         Enumerate all scene modes for count number of times (use with --automate or -A only)
  --enum-ce                          Enumerate all color-effect modes for count number of times (use with --automate or -A only)
  --enum-ae                          Enumerate all auto-exposure modes for count number of times (use with --automate or -A only)
  --enum-f                           Enumerate all flash modes for count number of times (use with --automate or -A only)
  --enum-fl                          Enumerate all flicker detection and avoidance modes for count number of times (use with --automate or -A only)
  --enum-ct                          Enumerate contrast value through 0 to 1 by a step of 0.1 for count number of times (use with --automate or -A only)
  --enum-st                          Enumerate saturation value through 0 to 2 by a step of 0.1 for count number of times (use with --automate or -A only)
  --enum-ee                          Enumerate edge-enhancement value through 0 to 1 by a step of 0.1 for count number of times (use with --automate or -A only)
  --enum-ts                          Enumerate TNR strength value through 0 to 1 by a step of 0.1 for count number of times (use with --automate or -A only)
  --enum-tnr                         Enumerate all TNR modes for count number of times (use with --automate or -A only)
  --streaming-mode                   [For CSI Only] Enable streaming mode (1=stream only, 2=stream+record)
  --streaming-file                   File to stream instead of camera input

Supported resolutions in case of CSI Camera
  (2) : 640x480
  (3) : 1280x720
  (4) : 1920x1080
  (5) : 2104x1560
  (6) : 2592x1944
  (7) : 2616x1472
  (8) : 3840x2160
  (9) : 3896x2192
  (10): 4208x3120
  (11): 5632x3168
  (12): 5632x4224

Runtime CSI Camera Commands:

  Help : 'h'
  Quit : 'q'
  Set Capture Mode:
      mo:<val>
          (1): image
          (2): video
  Get Capture Mode:
      gmo
  Set Sensor Id (0 to 10):
      sid:<val> e.g., sid:2 
  Get Sensor Id:
      gsid
  Set sensor orientation:
      so:<val>
          (0): none
          (1): Rotate counter-clockwise 90 degrees
          (2): Rotate 180 degrees
          (3): Rotate clockwise 90 degrees
  Get sensor orientation:
      gso
  Set Whitebalance Mode:
      wb:<val>
          (0): off
          (1): auto
          (2): incandescent
          (3): fluorescent
          (4): warm-fluorescent
          (5): daylight
          (6): cloudy-daylight
          (7): twilight
          (8): shade
          (9): manual
  Get Whitebalance Mode:
      gwb
  Set Scene-Mode:
      scm:<val>
          (0): face-priority
          (1): action
          (2): portrait
          (3): landscape
          (4): night
          (5): night-portrait
          (6): theatre
          (7): beach
          (8): snow
          (9): sunset
          (10): steady-photo
          (11): fireworks
          (12): sports
          (13): party
          (14): candle-light
          (15): barcode
  Get Scene-Mode:
      gscm
  Set Color Effect Mode:
      ce:<val>
          (1): off
          (2): mono
          (3): negative
          (4): solarize
          (5): sepia
          (6): posterize
          (7): aqua
  Get Color Effect Mode:
      gce
  Set Auto-Exposure Mode:
      ae:<val>
          (1): off
          (2): on
          (3): OnAutoFlash
          (4): OnAlwaysFlash
          (5): OnFlashRedEye
  Get Auto-Exposure Mode:
      gae
  Set Flash Mode:
      f:<val>
          (0): off
          (1): on
          (2): torch
          (3): auto
  Get Flash Mode:
      gf
  Set Flicker Detection and Avoidance Mode:
      fl:<val>
          (0): off
          (1): 50Hz
          (2): 60Hz
          (3): auto
  Get Flicker Detection and Avoidance Mode:
      gfl
  Set Contrast (0 to 1):
      ct:<val> e.g., ct:0.75
  Get Contrast:
      gct
  Set Saturation (0 to 2):
      st:<val> e.g., st:1.25
  Get Saturation:
      gst
  Set Exposure Time in seconds:
      ext:<val> e.g., ext:0.033
  Get Exposure Time:
      gext
  Set Auto Exposure Lock(0/1):
      ael:<val> e.g., ael:1
  Get Auto Exposure Lock:
      gael
  Set Edge Enhancement (0 to 1):
      ee:<val> e.g., ee:0.75
  Get Edge Enhancement:
      gee
  Set ROI for AE:
      It needs five values, ROI coordinates(top,left,bottom,right)
      and weight in that order
      aer:<val> e.g., aer:20 20 400 400 1.2
  Get ROI for AE:
      gaer
  Set ROI for AWB:
      It needs five values, ROI coordinates(top,left,bottom,right)
      and weight in that order
      wbr:<val> e.g., wbr:20 20 400 400 1.2
  Get ROI for AWB:
      gwbr
  Set FPS range:
      It needs two values, FPS Range (low, high) in that order
      fpsr:<val> e.g., fpsr:15 30
  Get FPS range:
      gfpsr
  Set WB Gains:
      It needs four values (R, GR, GB, B) in that order
      wbg:<val> e.g., wbg:1.2 2.2 0.8 1.6
  Get WB Gains:
      gwbg
  Set TNR Strength (0 to 1):
      ts:<val> e.g., ts:0.75
  Get TNR Strength:
      gts
  Set TNR Mode:
      tnr:<val>
          (0): NoiseReduction_Off
          (1): NoiseReduction_Fast
          (2): NoiseReduction_HighQuality
  Get TNR Mode:
      gtnr
  Capture: enter 'j' OR
           followed by a timer (e.g., jx5000, capture after 5 seconds) OR
           followed by multishot count (e.g., j:6, capture 6 images)
           timer/multihot values are optional, capture defaults to single shot with timer=0s
  Start Recording : enter '1'
  Stop Recording  : enter '0'
  Video snapshot  : enter '2' (While recording video)
  Set Preview Resolution:
      pcr:<val> e.g., pcr:3
          (2) : 640x480
          (3) : 1280x720
          (4) : 1920x1080
          (5) : 2104x1560
          (6) : 2592x1944
          (7) : 2616x1472
          (8) : 3840x2160
          (9) : 3896x2192
          (10): 4208x3120
          (11): 5632x3168
          (12): 5632x4224
  Note - For preview resolutions 4208x3120 and more use option --svs=nveglglessink
  Get Preview Resolution:
      gpcr
  Set Image Resolution:
      icr:<val> e.g., icr:3
          (2) : 640x480
          (3) : 1280x720
          (4) : 1920x1080
          (5) : 2104x1560
          (6) : 2592x1944
          (7) : 2616x1472
          (8) : 3840x2160
          (9) : 3896x2192
          (10): 4208x3120
          (11): 5632x3168
          (12): 5632x4224
  Get Image Capture Resolution:
      gicr
  Set Video Resolution:
      vcr:<val> e.g., vcr:3
          (2) : 640x480
          (3) : 1280x720
          (4) : 1920x1080
          (5) : 2104x1560
          (6) : 2592x1944
          (7) : 2616x1472
          (8) : 3840x2160
          (9) : 3896x2192
  Get Video Capture Resolution:
      gvcr

Runtime USB Camera Commands:

  Help : 'h'
  Quit : 'q'
  Set Capture Mode:
      mo:<val>
          (1): image
          (2): video
  Get Capture Mode:
      gmo
  Capture: enter 'j' OR
           followed by a timer (e.g., jx5000, capture after 5 seconds) OR
           followed by multishot count (e.g., j:6, capture 6 images)
           timer/multihot values are optional, capture defaults to single shot with timer=0s
  Start Recording : enter '1'
  Stop Recording  : enter '0'
  Set Preview Resolution:
      pcr:<val> e.g., pcr:2
          (0) : 176x144
          (1) : 320x240
          (2) : 640x480
          (3) : 1280x720
          (4) : 1920x1080
  NOTE: Preview/Encode resolution will be same as Capture resolution for USB-Camera
  Get Preview Resolution:
      gpcr
  Get Image Capture Resolution:
      gicr
  Get Video Capture Resolution:
      gvcr
  Set Capture Device Node:
      cdn:<val> e.g., cdn:0
          (0): /dev/video0
          (1): /dev/video1
          (2): /dev/video2
  Get Capture Device Node:
      gcdn

Runtime encoder configuration options:

  Set Encoding Bit-rate(in bytes):
      br:<val> e.g., br:4000000
  Get Encoding Bit-rate(in bytes):
      gbr
  Set Encoding Profile(only for H.264):
      ep:<val> e.g., ep:1
          (0): Baseline
          (1): Main
          (2): High
  Get Encoding Profile(only for H.264):
      gep
  Force IDR Frame on video Encoder(only for H.264):
      Enter 'f' 
</pre>

=== Capture snapshots ===

Sometimes when the board has been just flashed you need to run reboot in order to run nvgstcapture-1.0 successfully. To take snapshots:

<pre>
nvgstcapture-1.0
#then press j to take an snapshot
q 
</pre>

Resolutions available to create snapshot:
<pre>
  (2) : 640x480
  (3) : 1280x720
  (4) : 1920x1080
  (5) : 2104x1560
  (6) : 2592x1944
  (7) : 2616x1472
  (8) : 3840x2160
  (9) : 3896x2192
  (10): 4208x3120
</pre>

<pre>
 nvgstcapture-1.0 -m 1 --image-res=10
</pre>

In general the application is consuming 70% of one core. It is always displaying video this could affect.

=== Capture and record video ===

<pre>
nvgstcapture-1.0 -m 2 # set the mode in video
1 # start video recording
2 # take a snapshot
0 # stop video recording

</pre>

In case of video it should support:
<pre>
          (2) : 640x480
          (3) : 1280x720
          (4) : 1920x1080
          (5) : 2104x1560
          (6) : 2592x1944
          (7) : 2616x1472
          (8) : 3840x2160
          (9) : 3896x2192
</pre>

However, it is not possible to set other value than 2,3,4,5 up to 9.

<pre>
nvgstcapture-1.0 -m 2 --video-res=5
</pre>

'''top'''
<pre>
top - 21:50:33 up  1:56,  6 users,  load average: 0.99, 0.65, 0.54
Tasks: 219 total,   1 running, 218 sleeping,   0 stopped,   0 zombie
%Cpu(s): 10.7 us, 12.9 sy,  0.0 ni, 76.2 id,  0.0 wa,  0.0 hi,  0.2 si,  0.0 st
KiB Mem:   3946312 total,  2341908 used,  1604404 free,    20932 buffers
KiB Swap:        0 total,        0 used,        0 free.   378484 cached Mem

  PID USER      PR  NI    VIRT    RES    SHR S  %CPU %MEM     TIME+ COMMAND                                                                                       
  757 root      20   0  830496  84904  21504 S  61.0  2.2   8:13.76 nvcamera-daemon                                                                               
 4380 ubuntu    20   0  191340  10256   5004 S  12.6  0.3   0:02.83 nvgstcapture-1. 
</pre>

There is a daemon and a pipeline. Interesting...

While recording the pipeline (nvgstcapture) increases the ARM load to 10% and then it goes down again, even with the highest resolution. It will be interesting to understand what is the daemon doing.

== Power ==

 https://devtalk.nvidia.com/default/topic/916735/jetson-tx1/jetson-tx1-power-requirements-and-power-management/

== Price ==

<pre>
https://devtalk.nvidia.com/default/topic/912064/jetson-tx1/are-there-plans-to-sell-tx1-processor-without-the-full-module/
</pre>

== Products==

*NVIDIA Shield TV

<pre>
https://shield.nvidia.com/blog/tegra-x1-processor-and-shield
https://shield.nvidia.com/android-tv#intro-video
http://www.amazon.com/NVIDIA-SHIELD-Pro/dp/B00XO7AK1U?ascsubtag=s1458504729867wrusa52378&tag=52378_iceleadscom-20
</pre>

== See also ==

:[[Tegra X1]]
:[[Compile gstreamer on tegra X1]] 
:[[Compiling Tegra X1 source code]] 

==Contact Us==
{{ContactUs}}

[[Category:Jetson]][[Category:GStreamer]]