:orphan:

.. _qsbase3-quickstart:

Quickstart Guide
================

.. figure:: images/QSXM-QSBASE3.png
   :scale: 50 %
   :align: right
   :figwidth: 50%

This guide will help new users to quickly set up our QSBASE3 Linux Development Kit.

Detailed information about the QS solder-in module itself is available on `our website <https://www.karo-electronics.com/product-selection/>`_.

Unboxing
--------

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

.. list-table::
   :header-rows: 0
   :widths: 20 20 20

   * - 1. The evaluation board "QSBASE3".
     
     - 2. An USB cable which is used for power-connection and flashing.
       3. A TTL to USB Serial Converter cable.
     
     - 4. Our catalog.

   * - .. figure:: images/packaging/Verp_2.jpg
          :align: center
          :figwidth: 100%
       
     - .. figure:: images/packaging/Verp_1.jpg
          :align: center
          :figwidth: 100%
     
     - .. figure:: images/packaging/Verp_3.jpg
          :align: center
          :figwidth: 100%


Wiring
------

Connect the QSBASE3 board as shown in the image below.

.. list-table::
   :header-rows: 0
   :widths: 20 20 20

   * - 1. Connect the TTL to USB Serial Converter cable to the **DEBUG UART** port on the board, notice the **black wire on Pin 1**. The other side is connected to your computer.
     - 2. Connect the **USB** to the board. The other side is also connected with your host computer.
     - 3. Verify the Bootmode-jumper is not in Download-Mode. For help see :ref:`enabling-bootmode`.

   * - .. figure:: images/qsxm-uart-wiring.png
         :align: left
         :figwidth: 100%

     - .. figure:: images/qsxm-usb-wiring.png
         :align: left
         :figwidth: 100%

     - .. figure:: images/qsxm-bootmode.png
         :align: left
         :figwidth: 100%


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

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


Booting
-------

After connecting the micro USB your board will boot.

.. literalinclude::log/qsxm-boot.log
   :language: text

Your module is pre-programmed with our *karo-image-minimal* headless Linux. 


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 QSBASE3 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`.

   * - Display support
     - The **QSBASE3** Development Kit supports the official Raspberry Pi 7inch Touch Display. The QSBASE3 can be mounted directly to the display.

       .. tip:: The official Product Site of the Raspberry Pi 7inch Touch Display: https://www.raspberrypi.org/products/raspberry-pi-touch-display/

       The sources supporting the Display are integrated our Yocto Layer. Refer to our :ref:`yocto-guide-index`.

       We also provide a Ready To Use weston image to flash your QS module in our `Download Area <https://www.karo-electronics.com/downloads>`_.

       .. figure:: images/display/draufsicht.png
          :scale: 50 %
          :align: left
          :figwidth: 100%

       .. figure:: images/display/display.png
          :scale: 50 %
          :align: left
          :figwidth: 100%


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 -> QSXM -> :ref:`tx8-bsp`
     
   * - WiFi Guide
     - To enable WiFi support.

       Go to: Software Documentation -> :ref:`wifi-guide`
     
   * - Camera Guide
     - To enable camera support.

       Go to: Software Documentation -> QSXM -> :ref:`tx8-bsp-camera`

   * - Google Coral Edge TPU
     - How to use Google Coral PCIe ML accelerator.

       Go to: Software Documentation -> QSXP -> :ref:`tx8-bsp-coral`

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

   * - Electron Development
     - Develop an Electron app for your customers.
     
       Go to: Software Documentation -> QSXP -> :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
     
   * - QSBASE3 Pinouts
     - Connector pinouts can be found in the Hardware Documentation.

       Go to: Hardware Documentation -> Pinouts -> :ref:`qsbase3-pinouts`
     
   * - QS Developers Guide
     - QS-Standard pinout, description and layout guidelines.

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