.. _setup_serial_cfg:

Configure Serial Connection
---------------------------

In a standalone setup, regardless of how the DevKit obtains an IP address, it is essential for the developer 
to establish a connection via the **serial interface**. This ensures continuous access to the DevKit, allowing 
the developer to perform necessary tasks even if the network connection is lost. 

Depends on the operating system of the developer's computer, there are different ways to connect to the DevKit via the serial interface.

.. tabs::

   .. tab:: Hardware Setup

      .. raw:: html

         <style>
         .img-panel-container {
            display: flex;
            justify-content: center;
            gap: 2rem;
            flex-wrap: wrap;
            margin-top: 1rem;
         }

         .img-panel {
            flex: 1 1 400px;
            max-width: 500px;
            text-align: center;
            cursor: pointer;
         }

         .img-panel img {
            width: 100%;
            height: 250px;
            object-fit: cover;
            border-radius: 10px;
            box-shadow: 0 0 10px rgba(0,0,0,0.2);
         }

         .img-caption {
            margin-top: 0.5rem;
            font-weight: bold;
            font-family:"Roboto";
         }

         .modal-overlay {
            display: none;
            position: fixed;
            top: 0;
            left: 0;
            width: 100vw;
            height: 100vh;
            background: rgba(0,0,0,0.8);
            z-index: 9999;
            justify-content: center;
            align-items: center;
         }

         .modal-overlay.active {
            display: flex;
         }

         .modal-content {
            position: relative;
            max-width: 90vw;
            max-height: 90vh;
         }

         .modal-content img {
            width: 100%;
            height: auto;
            border-radius: 8px;
         }

         .modal-close {
            position: absolute;
            top: -1.5rem;
            right: -1.5rem;
            background: #fff;
            color: #000;
            border: none;
            font-size: 1.2rem;
            border-radius: 50%;
            cursor: pointer;
            width: 2rem;
            height: 2rem;
            display: flex;
            align-items: center;
            justify-content: center;
            box-shadow: 0 0 6px rgba(0, 0, 0, 0.5);
            line-height: 1; /* ensure the X doesn't overflow vertically */
            padding: 0;
         }
         </style>

         <div class="img-panel-container">
         <div class="img-panel" onclick="showImageModal('../../../_images/devkit-interfaces.png')">
            <img src="../../../_images/devkit-interfaces.png" alt="MLSOC">
            <div class="img-caption">MLSoC Connectors</div>
         </div>
         <div class="img-panel" onclick="showImageModal('../../../_images/modalix-ea-kit-interfaces.png')">
            <img src="../../../_images/modalix-ea-kit-interfaces.png" alt="Modalix Early Access Kit">
            <div class="img-caption">Modalix Early Access Kit Connectors</div>
         </div>
         <div class="img-panel" onclick="showImageModal('../../../_images/modalix-devkit.png')">
            <img src="../../../_images/modalix-devkit.png" alt="Modalix DevKit">
            <div class="img-caption">Modalix DevKit Connectors</div>
         </div>
         </div>

         <div class="modal-overlay" id="imageModal">
         <div class="modal-content">
            <button class="modal-close" onclick="closeImageModal()">×</button>
            <img id="modalImage" src="" alt="Full size">
         </div>
         </div>
         <br/>

         <script>
         function showImageModal(src) {
            document.getElementById('modalImage').src = src;
            document.getElementById('imageModal').classList.add('active');
         }

         function closeImageModal() {
            document.getElementById('imageModal').classList.remove('active');
            document.getElementById('modalImage').src = '';
         }
         </script>


      On the MLSoC DevKit, Make sure the Operation Mode Switch, Run/Program Switch are set according to the diagram above then power on the DevKit. 

      Use the included serial cable to connect the DevKit to your computer:
   
      - One end connects to the DevKit's serial port. 

         - On the MLSoC DevKit, ensure the triangle mark on the flat connector aligns with the leftmost pin on the DevKit.  
         - On the Modalix Early Access Kit, ensure the triangle mark on the flat connector aligns with the rightmost pin on the DevKit.  
         - On the Modalix DevKit, use the provided USB-A to USB-C cable to connect to the DevKit’s **UART** port, as labeled on the enclosure.

      - The other end connects to the computer's **USB Type-A** port, use a USB Hub if necessary.

   
   .. tab:: Windows

      To connect to the DevKit via a serial terminal on **Windows**, follow these steps:

      1. Identify the COM Port:
         
         - Open **Device Manager** → Expand **Ports (COM & LPT)**.
         - Look for an entry like **USB Serial Port (COMx)**.

      2. **Install and Open a Serial Terminal**:
         
         - Use `PuTTY <https://www.putty.org/>`_ or **Tera Term**.
         - Set the connection type to **Serial**.
         - Enter the correct **COM Port** (e.g., ``COM3``).
         - Set **Baud Rate** to ``115200``.

      3. Click **Open** to start the connection.

   .. tab:: MacOS & Linux Desktop

      .. include:: ../blocks/install_sima_cli.rst

      .. code-block:: console
         
         sima-cli serial

      This command will install necessary dependencies on your computer to access serial port. To exit the serial terminal, press Ctrl + A then Ctrl + X.
      
      On some earlier firmware versions, the system may use a different baud rate for the serial console. If you see garbled output in the terminal, it's likely due to a mismatched baud rate. Try specifying a higher rate:

      .. code-block:: console
         
         sima-cli serial -b 921600


Once prompted to log in to the serial port console, use the default **username** ``sima`` and **password** ``edgeai``.