.. include:: /keyword.rst

=============================================
Getting Started with Genio 700 Evaluation Kit
=============================================

The Genio 700 EVK (evaluation kit) is suitable for our technology partners to evaluate the MT8390 processor for IoT solution design and development.
Get started using Ubuntu on this kit by following the steps below.

.. figure:: /_asset/hw_evk_g700-evk_ports.png
    :alt: Ports of |G700-EVK-REF-BOARD| main board
    :align: center
    :width: 65%

    Ports of |G700-EVK-REF-BOARD| main board


.. include:: host-pc-common.rst

You also need:

    * A **micro-USB** cable to connect your host PC to the **UART0** port on the board.
    * Another **micro-USB** cable to write Ubuntu OS images to the onboard eMMC storage via the **USB0** port.
    * A two-pin jumper to short the ``J3001`` jumper pins on the main board.

If you plan to use Ubuntu Desktop, you need to provide the following to take advantage of the desktop environment:

    * a USB-C hub to connect USB mouse and keyboard
    * a USB Keyboard
    * a USB Mouse
    * a HDMI Display and a HDMI cable

.. include:: tool-installation-common.rst

.. include:: genio-700-evk-install.rst

.. include:: image-flashing-common.rst

Locate the push buttons on the board:

.. figure:: /_asset/sw_yocto_flash_g700_dl-buttons.jpg
    :align: center
    :width: 60%

Follow these steps to enter download mode:

1. Press and keep pressing the **Download** button.
2. Press and release the **RST** button.
3. Hold the **Download** button. The tool should output the following logs:

    .. code-block:: text

        Opening COM22 using baudrate=115200
        Connected to MediaTek SoC: hw_code[0x8188]
        Sending bootstrap to address: 0x201000
        Jumping to bootstrap at address 0x201000 in AArch64 mode
        erasing mmc0
        < waiting for any device >

4. Release the **Download** button after the tool outputs ``< waiting for any device >``

.. include:: boot-example-common.rst

Login to UART Console
=====================

If you have connected to the UART console (``ttyS0`` in Ubuntu) in previous steps,
the following prompt should appear in your terminal application.
Use ``ubuntu`` as both the username and password to login:

.. code-block:: text

    Ubuntu 22.04.2 LTS mtk-genio ttyS0

    mtk-genio login: ubuntu
    password: ubuntu

Login to TTY1 Console
=====================

If you are using the Ubuntu Server image, a console ``tty1`` should appear on the built-in display panel:

.. code-block:: text

    Ubuntu 22.04.2 LTS mtk-genio tty1

    mtk-genio login:

To login to this consle:

* Connect a USB-C hub to the ``USB-C PD`` Type-C port on the board.
* Connect a USB keyboard to the USB-C hub.
* Use the USB keyboard to input username and password (both are ``ubuntu`` by default) to login to the ``tty1`` console.

Login to Desktop
================

If you are using the Ubuntu Desktop image, the built-in LCM display shows a Gnome login screen.

To login to the desktop environment:

* Connect a USB-C hub to the ``USB-C PD`` Type-C port on the board.
* Connect a USB keyboard to the USB-C hub.
* Connect a USB mouse to the USB-C hub.

Use the USB mouse and keyboard to input username and password (both are ``ubuntu`` by default) to login to the desktop.

You may also connect a HDMI monitor to the HDMI port and use it as the 2nd display.

.. include:: next-steps-common.rst