.. _getting_started_qsmp:

QSMP
====

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

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

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

      .. toctree::
         :maxdepth: 1

         ../qsbase1/quickstart-qsbase1
         ../qsbase4/quickstart-qsbase4

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

      Download and unpack `qsmp-1570-debian-bookworm.zip <https://www.karo-electronics.com/fileadmin/download/debian_images/qsmp-1570-debian-bookworm.zip>`_ as an example

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

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

         Refer to :ref:`wsl` -> Connect USB devices
         
         Windows uuu.exe fails. Use WSL and attach the USB device to it.
         
         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:

         sudo ./uuu -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

         ../quickguides/qsmp-1570
         ../quickguides/qsmp-1530