.. Quick Start Guide 2.0 documentation master file, created by sphinx-quickstart on Wed Jul 20 15:41:53 2022. You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. .. include:: /keyword.rst ================================================ Genio 520 EVK Demo Requirements ================================================ This demonstration kit is very flexible and can be setup in various configurations, with software support for Android. However for the purpose of this Quick Start Guide, a specific configuration is chosen with the following conditions: - |IOT-ANDROID| software build - D8/D9 Camera Board enabled Additional Items Needed for Quick Start Guide Demo ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ To support the demo, the following additional items are needed. - Two USB Cables (USB-2.0-A to Micro-B) - External PC for loading flash and interacting via command prompt .. include:: sections/env_setup.rst ========================= Kit Hardware Installation ========================= - Insert the D8/D9 Camera Board to CAM0/CAM1 on the main motherboard. .. figure:: /_asset/520-qsg/hw_evk_g520-evk_with_D6.jpg :align: center :width: 500px Camera Board Insertion .. figure:: /_asset/520-qsg/D8_Camera_Setup.jpg :align: center :width: 500px Camera Board D8 .. figure:: /_asset/520-qsg/D9_Camera_Setup.jpg :align: center :width: 500px Camera Board D9 - Connect UART0 to the computer via a USB Type-C cable as shown in the image **USB Port Locations** below:(If you want to see the logs). This requires installation of the Google Android USB driver as outlined in the Setup PC Environment section. If using Windows, open Device Manager and confirm that the driver appears under *Android Device \\ Android Bootloader Interface*. .. figure:: /_asset/520-qsg/USB_ports2.png :align: center :width: 500px USB Port Locations - set the jumper on J516, then insert the DC 20V power adapter or USB Type-C PD adapter. .. figure:: /_asset/520-qsg/power_up_evk_520_720.png :align: center :width: 500px Power Up the System - Long press PWR button for more than 3 seconds. You will see the screen is shown on MIPI DSI display and some trace logs coming out from UART0 Further details regarding both USB drivers can be found in the :ref:`flash trouble-shooting section `. .. include:: sections/connect_console.rst ================== Flash the Software ================== This guide shows how to "flash" (write) the demo image into the non-volatile flash memory of the main motherboard. The flashing process is performed through the USB0 connection. In order to write the on-board storage with Genio Tools, you need to set the IoT SoC in **download mode**, which allows Genio Tools to transfer a **download agent** binary to the :abbr:`SRAM (Static random-access memory)` of SoC. The download agent then provides a **fastboot** interface for subsequent image transfer and storage write operations. - Download the :ref:`pre-built private board image ` to your local PC. .. Note:: Be sure to download the **private** image as it is required to run the demos in this quick start guide. - Unzip the image. .. Note:: Avoid having a long path name by installing to a root folder and shortening the file name if necessary, for example ``C:\\evk``. - Open a Windows cmd window (to enter commands) - Change working folder to the image directory before running the ``genio-flash`` commands: .. prompt:: bash > auto > cd C:\evk - View the :doc:`/sw/android/get-started/flash` instructions for further details or troubleshooting. - Once you see the ``Looking for a MediaTek SoC ...`` prompt, start the process to boot the board in flash download mode. 1. Press and keep pressing the ``Download`` button. 2. Press and release the ``RST`` button 3. Hold the ``Download`` button until you see the log ``Erasing 'mmc0'`` message, as shown below: .. figure:: /_asset/700-qsg/g700_download_buttons.gif :align: center Reset the board to enter download mode You should see flashing process started after releasing the volume up button. A typical successful log looks something like this: .. code:: Genio Tools: v1.7.0a2 Raw Image: name: UFS Disk Image (Sparse Image) machine: Unspecified WARNING:root:FTDI D2xx library not found WARNING:root:Unable to find and reset the board. Possible causes are: 1. This is not a Genio 350/700 EVK, nor a Pumpkin board. 2. The board port UART0 is not connected. 3. The UART0 port is being opened by another tool, such as TeraTerm on Windows. You can now manually reset the board into DOWNLOAD mode. INFO:root:Continue flashing... Looking for MediaTek SoC matching USB device 0e8d:0003 Opening COM6 using baudrate=115200 Connected to MediaTek SoC: hw_code[0x8195] Sending bootstrap to address: 0x201000 Jumping to bootstrap at address 0x201000 in AArch64 mode erasing mmc0 < waiting for any device > Erasing 'mmc0' (bootloader) request sz: 0xece000000, real erase len: 0x0 OKAY [ 0.127s] *... (shortened for brevity)* .. code:: Rebooting OKAY [ 0.002s] Finished. Total time: 0.003s .. Note:: The above command should be the only needed to flash the image with the configurations necessary in this Quick Start Guide. Further background and troubleshooting information including different command options are available in :doc:`/sw/android/get-started/flash`. A common problem is that the download does not start and simply keeps waiting for the device. More information is available in :ref:`Missing Android Device Driver `. - Once the kit boots up with the new flash image, debug log messages can be seen through UART0 in the Putty terminal window. .. figure:: /_asset/i350-qsg/Log-Setting.png :width: 450px View of debug log messages appearing from UART0 upon board bootup - Verify the desktop boot screen appears on the display of the kit. .. figure:: /_asset/520-qsg/yocto_boot_screen_low_res.jpg :width: 350px ================= EVK Basic Testing ================= Objective ^^^^^^^^^ To verify the flashed image boots up successfully and board's ability to connect to WiFi, access a web browser, and play audio-visual content. Steps ^^^^^ 1. **Boot the Board:** - Ensure the board is fully powered on and has completed the booting process. 2. **Connect to WiFi:** - Navigate to the 'Settings' menu on the board. - Locate the 'WiFi' option and select it. - Choose the desired WiFi network from the list of available networks. - Enter the necessary credentials (e.g., password) to connect to the WiFi network. - Confirm that the board is successfully connected to the WiFi network. 3. **Open the Browser:** - Launch the web browser application on the board. - In the browser's address bar, type the URL: ``www.youtube.com``. - Press 'Enter' or select the 'Go' button to navigate to the YouTube website. 4. **Play Audio-Visual Content:** - On the YouTube homepage, search for or select any video content. - Click on the video to start playback. - Confirm that the audio and video are playing correctly without interruptions or errors. .. Note:: Ensure that the WiFi network is operational and accessible. .. Note:: 1. **Audio Jack:** Connect a 3.5mm cable from the board to speakers/headphones.