.. |br| raw:: html
.. _tx8-bsp-camera:
Camera Guide
============
.. note:: To enable camera support when building Yocto images see:
- QS8M with Raspi camera: :ref:`local.conf` section in NXP Yocto BSP.
- Basler cameras: :ref:`basler-camera-yocto` in NXP Yocto BSP.
Camera Enablement
-----------------
+--------------------------------+---------------------------------+----------------------------------------+------------------------+
| Module | Camera | Precompiled Image | Yocto Enablement |
+================================+=================================+========================================+========================+
| QS8M-MQ00 | `RaspberryPi Camera`_ | n.a. | :ref:`Raspi Camera` |
+--------------------------------+---------------------------------+----------------------------------------+------------------------+
| QSXM-MM60 | `Basler daA2500-60mci`_ | *qsxm-mm60-basler* in `Download Area`_ | :ref:`Basler Camera` |
+--------------------------------+---------------------------------+----------------------------------------+------------------------+
| QSXP-ML81 | `Basler daA3840-30mc`_ | *qsxp-ml81-basler* in `Download Area`_ | :ref:`Basler Camera` |
+--------------------------------+---------------------------------+----------------------------------------+------------------------+
Camera DTB
----------
When your Yocto build has finished you will get different dtbs in deploy directory.
The following table gives an overview.
.. table::
:widths: 25 25 50
+---------------------------------------+--------------------------------------------+-------------------------------------------------+
| Module | Camera Supported | .dtb Files |
+=======================================+============================================+=================================================+
| qs8m-mq00 on qsbase2 | `RaspberryPi Camera`_ | imx8mm-qs8m-mq00-qsbase2-dsi83-cam.dtb |br| |
| | | imx8mm-qs8m-mq00-qsbase2-raspi-display-cam.dtb |
+---------------------------------------+--------------------------------------------+-------------------------------------------------+
| qsxm-mm60 on qsbase3 | `Basler daA2500-60mci`_ | imx8mm-qsxm-mm60-qsbase3-basler.dtb |
+---------------------------------------+--------------------------------------------+-------------------------------------------------+
| qsxp-ml81 on qsbase3 | `Basler daA3840-30mc`_ | imx8mp-qsxp-ml81-qsbase3-basler.dtb |
+---------------------------------------+--------------------------------------------+-------------------------------------------------+
Use the specific dtb file when booting Linux.
.. note:: You can change the ``baseboard`` variable in U-Boot to get the specific dtb loaded from eMMC. |br| |br|
**EXAMPLE**
.. code-block:: text
QS8M U-Boot > setenv baseboard qsbase2-raspi-display-cam
Notice: 'fdt_file' changed from 'imx8mm-qs8m-mq00-qsbase2.dtb' to 'imx8mm-qs8m-mq00-qsbase2-raspi-display-cam.dtb'
Stream Camera
-------------
To stream a camera live video on your weston desktop follow the instructions written below.
+----------------------------------------+------------------------------------------------------------------------------------------------------------+
| Module | Camera Stream |
+========================================+============================================================================================================+
| qs8m-mq00 | .. code-block:: text |
| | |
| | gst-launch-1.0 -v v4l2src ! "video/x-bayer,format=rggb,width=640,height=480,framerate=30/1" ! \ |
| | bayer2rgb ! videoconvert ! autovideosink sync=false |
+----------------------------------------+------------------------------------------------------------------------------------------------------------+
| qsxm-mm60 | Start pylon viewer from serial Terminal: |
| | |
| | .. code-block:: text |
| | |
| | export DISPLAY=:0; pylon |
| | |
| | Enable the camera and click on the camera icon to stream a live video. |
+----------------------------------------+------------------------------------------------------------------------------------------------------------+
| qsxp-ml81 | .. code-block:: text |
| | |
| | gst-launch-1.0 -v v4l2src device=/dev/video0 ! "video/x-raw,format=YUY2,width=1920,height=1080" ! \ |
| | queue ! imxvideoconvert_g2d ! waylandsink |
| | |
| | Alternatively start pylon viewer from serial Terminal: |
| | |
| | .. code-block:: text |
| | |
| | export DISPLAY=:0; pylon |
| | |
| | Enable the camera and click on the camera icon to stream a live video. |
+----------------------------------------+------------------------------------------------------------------------------------------------------------+
.. _`RaspberryPi Camera`: https://www.raspberrypi.org/products/camera-module-v2/
.. _`Download Area`: https://www.karo-electronics.com/downloads
.. _`Basler daA2500-60mci`: https://www.baslerweb.com/en/products/cameras/area-scan-cameras/dart/daa2500-60mci-s-mount/
.. _`Basler daA3840-30mc`: https://www.baslerweb.com/en/products/cameras/area-scan-cameras/dart/daa3840-30mc-s-mount/