.. _getting_started_qsmp2:

QSMP2
=====

First Steps
-----------

.. admonition:: Unpack, connect, power up and boot
   :class: tip

   .. admonition:: Select the baseboard
      :class: note

      - :doc:`QSBASE1 </hardware-documentation/baseboards/qsbase1/quickstart>`
      - :doc:`QSBASE4 </hardware-documentation/baseboards/qsbase4/quickstart>`
      - :doc:`QSBASE5 </hardware-documentation/baseboards/qsbase5/quickstart>`

Install Quick Guide
-------------------

.. admonition:: How to flash a system image to the module
   :class: tip
   
   More details: :ref:`stm-fast-flashing` and :ref:`uuu`

   .. admonition:: 1. Get a system image
      :class: note

      Pre-compiled image files are located in our `Download Area <https://www.karo-electronics.com/downloads>`_. 

   .. admonition:: 2. Start fastboot
      :class: note

      (Re-)boot the board and **"Hit any key to stop autoboot"** to get to the U-Boot command line interface
      
      .. prompt::
         :prompts: U-BOOT>
         :substitutions:

         fastboot usb 0

   .. admonition:: 3. Flash it!
      :class: note

      Use either a Linux PC or :ref:`wsl`

      .. admonition:: Only for :ref:`wsl`
         :class: tip

         Refer to :ref:`wsl` -> Connect USB devices
         
         Open a Windows command shell with administrator permissions. Get the {busid} of the download gadget and attach it.

         .. prompt::
            :prompts: CMD>

            usbipd list
            usbipd bind --busid {busid}
            usbipd attach --wsl --busid {busid}
         
      Change to the unpacked image directory and run uuu.

      .. prompt::
         :prompts: $
         :substitutions:

         wget https://github.com/nxp-imx/mfgtools/releases/download/uuu_1.5.141/uuu
         chmod a+x uuu
         sudouuu -v

Yocto Quick Guide 
-----------------

.. admonition:: Build and flash Yocto images in 10 minutes
   :class: tip

   .. admonition:: Select the QSMP version
      :class: note

      .. toctree::
         :maxdepth: 1

         qsmp-2350
         qsmp-2550