.. _qsbase93-quickstart:

QSBASE93
================

.. figure:: images/qs93-qsbase93.png
   :scale: 80 %
   :align: right
   :figwidth: 50%

This guide will help new users to quickly setup our QSBASE93 Linux Development Kit.

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


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 "QSBASE93".
     
     - 2. An USB-C cable which is used for power-connection and flashing.
       3. An Micro USB-B cable which is used for debugging.
     
     - 4. Our catalog.

   * - .. figure:: images/packaging/Verpack2.JPG
          :align: center
          :figwidth: 100%
       
     - .. figure:: images/packaging/Verpack1.JPG
          :align: center
          :figwidth: 100%
     
     - .. figure:: images/packaging/Verpack3.JPG
          :align: center
          :figwidth: 100%


Wiring
------

Connect the QSBASE93 board as shown in the image below.

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

   * - 1. Connect the **USB-C** 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 Micro USB cable to the **DEBUG** port on the board. The other side is also connected with your host computer.

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

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

     - .. figure:: images/qsbase93-debug-wiring.png
         :align: left
         :figwidth: 100%


USB-UART driver
---------------

Download and Install USB to UART Bridge Virtual COM Port (VCP) drivers


   `<https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers>`_


Booting
-------

After connecting the micro USB your board will boot.

.. literalinclude:: ./log/qs93-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 QS93 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 **QSBASE93** Development Kit supports different LVDS displays.

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


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`
     
   * - Machine Learning
     - Using NPU and starting ML Demos.

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

   * - QT6 Development
     - Develop a QT6 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
     
   * - QSBASE93 Pinouts
     - Connector pinouts can be found in the Hardware Documentation.

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

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