:orphan:

.. _qsbase2-quickstart:

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

.. figure:: images/qsbase2.png
   :scale: 80 %
   :align: right
   :figwidth: 50%

This guide will help new users to quickly setup our QSBASE2 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 "QSBASE2".
     
     - 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/Verpack3.JPG
          :align: center
          :figwidth: 100%
       
     - .. figure:: images/packaging/Verpack2.JPG
          :align: center
          :figwidth: 100%
     
     - .. figure:: images/packaging/Verpack1.JPG
          :align: center
          :figwidth: 100%


Wiring
------

Connect the QSBASE2 board as shown in the image below.

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

   * - 1. Connect the **USB** to the board. The other side is also connected with your host computer.
     - 2. Verify the Bootmode-jumper is not in Download-Mode. You can also remove it. For help see :ref:`enabling-bootmode`.
     - 3. 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.

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

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

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


Booting
-------

After connecting the micro USB your board will boot.

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

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

Next Steps Usage
----------------

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

   * - Topic
     - Description
     
   * - Re-installing the OS
     - * The pre-compiled image files to flash the QSBASE2 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 **QSBASE2** Development Kit supports the official Raspberry Pi 7inch Touch Display. The QSBASE2 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 Steps Software
-------------------

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

   * - Topic
     - Description
     
   * - Linux Guide
     - Go to: Software Documentation
     
   * - WiFi Guide
     - To enable WiFi support.

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

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

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

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

   * - Machine Learning
     - Using NPU and starting ML Demos.

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

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

   * - Electron Development
     - Develop an Electron app for your customers.
     
       Go to: Software Documentation -> :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 Steps Hardware
-------------------

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

   * - Topic
     - Description
     
   * - QSBASE2 Pinouts
     - Connector pinouts can be found in the Hardware Documentation.

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

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