.. _tx8-bsp:

NXP BSP
=======

.. hint:: This guide refers to images built with Yocto **NXP BSP**.


NXP Documentation
-----------------

Since our NXP BSP is just an extension of NXP's BSP, you are able to use the same functionalities on our hardware.

So, in this case we just refer to their software documentation.

* `i.MX Linux Release Notes <https://www.nxp.com/docs/en/release-note/IMX_LINUX_RELEASE_NOTES.pdf>`_
* `i.MX Linux User’s Guide​ <https://www.nxp.com/docs/en/user-guide/IMX_LINUX_USERS_GUIDE.pdf>`_
* `i.MX Linux Reference Manual​ <https://www.nxp.com/docs/en/reference-manual/IMX_REFERENCE_MANUAL.pdf>`_
* `i.MX Porting Guide​ <https://www.nxp.com/docs/en/user-guide/IMX_PORTING_GUIDE.pdf>`_
* `i.MX VPU API Reference Manual​ <https://www.nxp.com/docs/en/reference-manual/IMX_VPU_APPLICATION_PROGRAMMING_INTERFACE_LINUX_REFERENCE_MANUAL.pdf>`_
* `i.MX Graphics User’s Guide <https://www.nxp.com/docs/en/user-guide/IMX_GRAPHICS_USERS_GUIDE.pdf>`_
* `i.MX Machine Learning User's Guide <https://www.nxp.com/docs/en/user-guide/IMX-MACHINE-LEARNING-UG.pdf>`_
* `i.MX 8M Plus Camera and Display Guide <https://www.nxp.com/docs/en/user-guide/iMX8MP_CAMERA_DISPLAY_GUIDE.pdf>`_

All availabe here: 

https://www.nxp.com/design/software/embedded-software/i-mx-software/embedded-linux-for-i-mx-applications-processors:IMXLINUX


General
-------

CPU Temperature
~~~~~~~~~~~~~~~

The i.MX8 provides the SoC's internal temperature.

The accuracy is 1000ths of °C. Therefore you must **divide it by 1000** to obtain °C.

.. prompt::
   :prompts: #

   cat /sys/class/thermal/thermal_zone0/temp


karo-image-weston
-----------------

Test the GPU
~~~~~~~~~~~~

GLmark2 will only run smooth on processors having a GPU.

.. prompt::
   :prompts: #

   glmark2-es2-wayland --fullscreen


Play a Video
~~~~~~~~~~~~

Play the file named *test.mp4*:

.. prompt::
   :prompts: #

   gst-play-1.0 --videosink=waylandsink test.mp4