.. _tx-mipi-lvds-quickstart:

TX MIPI-LVDS StarterKit
=========================

This guide will help new users to quickly set up our TX MIPI-LVDS Linux Development Kit.

Detailed information about the TX modules are available at https://www.karo-electronics.com/products .

Unboxing
--------

When opening the package of the Development Kit you should find the following components inside:

1. Our catalog and the TX datasheet.

.. figure:: images/packaging/Verp_5.JPG
   :scale: 50 %
   :align: left
   :figwidth: 100%

2. A 10.1" or 7" capacitive touch display with 1280x800 resolution.

.. figure:: images/packaging/Verp_4.JPG
   :scale: 50 %
   :align: left
   :figwidth: 100%

3. A micro USB cable for programming.

.. figure:: images/packaging/Verp_3.JPG
   :scale: 50 %
   :align: left
   :figwidth: 100%

4. A small plastic bag with cables for connecting the display and its touchscreen.
5. A TTL to USB Serial Converter cable.

.. figure:: images/packaging/Verp_2.JPG
   :scale: 50 %
   :align: left
   :figwidth: 100%

6. The development board with the TX module already plugged into it.
7. An AC / DC 12V wall adapter power supply.
8. A display stand.

.. figure:: images/packaging/Verp_1.JPG
   :scale: 50 %
   :align: left
   :figwidth: 100%



Assembling and Connecting
-------------------------

Assemble and connect the board to the display as shown in the following pictures. This means:

1. Connect the display powering between board power outlet and displays power input.
2. Connect the touchscreen to USB cable between the displays port and the USB-host port of the board.
3. Carefully connect the display signal cable.
4. Place the display on the stand and place the board in front of it.
5. **As the last step** connect the 12V DC power and plug the AC adapter into your powerline.

.. warning:: Please be careful, it's highly recommended to disconnect the 12V power before (un)plugging the module or other cables.

.. hint:: When you have the **TX8M-ND00** module, you will have to use the micro-USB to USB adapter to connect the touchscreen. The second USB-host is not working with the i.MX8M Nano processor.

.. figure:: images/assemble/TX8M-SV81_Draufsicht_3.png
   :scale: 50 %
   :align: left
   :alt: Top view of cable connection.
   :figwidth: 100%

.. figure:: images/assemble/TX8M-SV81_Seite_l.png
   :scale: 50 %
   :align: left
   :alt: Side view of cable connection.
   :figwidth: 100%


Terminal Connection
-------------------

Use the TTL to USB Serial Converter cable to connect your computer with the board via *1. UART*. The black wire goes to "GND"-Pin.

.. figure:: ./images/ttl_usb.png
   :scale: 50 %
   :alt: serial connection
   :align: left
   :figwidth: 100 %

   UART connection to serial USB cable


To open the terminal connection see our FAQ: :ref:`ttl-converter-connection`.


Booting
-------

After connecting the 12V power your Development Kit will boot a Weston desktop - ready to use.

Next Step Usage
---------------

.. list-table::
   :header-rows: 1
   :widths: 20 80

   * - Topic
     - Description
     
   * - Re-installing the OS
     - * The pre-compiled image files to flash the TX8 Development Kit are located in our `Download Area <https://www.karo-electronics.com/downloads>`_. 
       
       * They contain different environments, e.g. a minimal and a desktop environment.
       
       * Download the images and proceed with the :ref:`uuu`.

   * - CAN support
     - If you want to use a CAN interface via the Raspberry Pi-Connector on the TX-MIPI-LVDS, you have to enable CAN inside the compiled ``.dtb``.

       With using this DTB, the CAN interface via SPI gets activated for you, and you should be able to set up the device as an interface.

       Notice the placing of the CAN interface: For an exact pinout see the **X11 Header** in :ref:`tx-mipi-lvds-pinout` Pinout.
       
       .. figure:: ./images/can-interface.jpg
          :scale: 100 %
          :alt: MCP2515 CAN interface
          :align: left
          :figwidth: 30 %
       
          MCP2515 CAN interface



Next Step Software
------------------

.. list-table::
   :header-rows: 1
   :widths: 20 80

   * - Topic
     - Description
     
   * - Linux Guide
     - This guide refers to the use of images built with Yocto NXP BSP.

       Go to: Software Documentation -> TX8 -> :ref:`tx8-bsp`
     
   * - Machine Learning (TX8P only)
     - Using NPU and starting ML Demos.

       Go to: Software Documentation -> TX8P -> :ref:`machine-learning-guide-index`

   * - QT6 Development
     - Develop a QT6 app for your customers.
     
       Go to: Software Documentation -> TX8 -> :ref:`qt-guide-index`

   * - Electron Development
     - Develop an Electron app for your customers.
     
       Go to: Software Documentation -> TX8 -> :ref:`electron-guide-index`
     
   * - Customizing the BSP
     - If you want to use our Yocto Layer, or want to create your own customized Linux distribution, have a look at our :ref:`yocto-guide-index`.

       Go to: :ref:`yocto-guide-index`
     
     
Next Step Hardware
------------------

.. list-table::
   :header-rows: 1
   :widths: 20 80

   * - Topic
     - Description
     
   * - TX-(MIPI)-LVDS Pinouts
     - Connector pinouts can be found in the Hardware Documentation.

       Go to: Hardware Documentation -> Pinouts -> :ref:`tx-mipi-lvds-pinout`
     
   * - TX Developers Guide
     - TX-Standard pinout, description and layout guidelines.

       Go to: Hardware Documentation -> :ref:`tx-guide`