Usage

Using tiscamera

To list the cameras attached via CSI or FPD-Link:

tcam-ctrl -l

Output will be in the style of:

Model: DFM 37CX390-ML Serial: 45020098 Type: pimipi

To show a live-stream with this camera a simple example command is:

gst-launch-1.0 tcambin ! ximagesink

This starts the tcampimipisrc with the first camera connected and displays a simple live-stream.

See https://www.theimagingsource.com/support/downloads-for-linux/install/tiscameraarm6432/ for a download link.

Using tiscamera-dutils

The Imaging Source provides a module that implemnents many highly optimized transformations and additional properties.

See https://www.theimagingsource.com/support/downloads-for-linux/install/tiscameradutilsarmhfpi/ for a download link.

Directly using the tcampimipisrc gstreamer element

The tcampimipisrc package contains 2 gstreamer elements

  • tcampimipisrc, as the actual gstreamer source filter
  • tcamby1xtransform, as a helper filter to convert the packed raw bayer data to video/x-bayer data

When you start a pipeline, you have to convert the input format the sensor delivers via tcamby1xtransform and then bayer2rgb.

A live video window can be started like this:

gst-launch-1.0 tcampimipisrc ! tcamby1xtransform ! bayer2rgb ! ximagesink

GStreamer object properties

The tcampimipisrc object has the following gstreamer properties:

  • serial
    • Specifies/fetches the serial number of the current device.
    • In state ==  GST_STATE_NULL it can be written, to set the device to open when changing to GST_STATE_READY.
    • In state >=  GST_STATE_READY this is read-only.
    • When empty, the first available device is opened and then reading in GST_STATE_READY returns the actual serial of thr first device found.
  • max-queued-gst-buffers
    • Specifies the count of buffers to queue in gstreamer before dropping additional buffers.
  • do-timestamp
    • Apply current stream time to buffers (Internally this sets gst_base_src_set_do_timestamp)
  • drop-incomplete-buffer
    • Enable/disable incomplete buffer dropping. If this is enabled, incomplete buffers can be delivered.
  • show-overlay
    • Debug property that enables a overlay with information about the current image stream.