.. 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 1200 EVK Demo Requirements ================================================ This demonstration kit is very flexible and can be setup in various configurations, with software support for Yocto or Android. However for the purpose of this Quick Start Guide, a specific configuration is chosen with the following conditions: - |IOT-YOCTO| software build - D2 Camera Board enabled Additional Items Needed for Quick Start Guide Demo ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ To support the demo, the following additional items are needed. - One USB Cable (USB-A to Micro-B) - One USB Cable (USB-A to USB-C) - External PC for loading flash and interacting via command prompt .. include:: sections/env_setup.rst ========================= Kit Hardware Installation ========================= - Insert the D2 Camera Board to CSI0 on the main motherboard. The image below shows the smaller D2 board on the left and the larger D6 board on the right. At this time only D2 is supported in the Yocto demos shown in this quick start guide. .. figure:: /_asset/1200-qsg/Genio_1200_EVK_with_dtb.jpg :align: center :width: 500px Camera Board Insertion .. figure:: /_asset/1200-qsg/IoT-CAM-DTB-D1V2-D2.jpg :align: center :width: 500px Camera Board D2 - Connect a USB cable to connector labeled **USB Type-C Connector** Flash download port as shown in the image **USB Port Locations** below: 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*. - Connect a second USB cable to connector labeled **UART0 Debug Connector** Debug console port as shown in the image **USB Port Locations** below: This requires installation of the FTDI :abbr:`VCP (Virtual COM Port)` USB driver as outlined in the Setup PC Environment section. If using Windows, open Device Manager and confirm that the driver appears under *Ports (COM & LPT) \\ USB Serial Port (COMx)*, where x is the port assigned by your system. .. figure:: /_asset/1200-qsg/hw_evk_g1200-evk_download_ports.jpg :align: center :width: 500px USB Port Locations Further details regarding both USB drivers can be found in the :ref:`flash trouble-shooting section `. - Plug AC/DC power adapter into the connector. .. 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 USB Type-C Connector flash download port. 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 - Flash the image using the overlay which enables both cameras. which enables Before flashing the board, check if there are certain board features you'd like to enable: .. prompt:: bash > auto > genio-flash --load-dtbo gpu-mali.dtbo --load-dtbo apusys.dtbo --load-dtbo video.dtbo --load-dtbo camera-imx214-csi0.dtbo - 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/sw_yocto_flash_g1200_dl-buttons.jpg :align: center :width: 60% 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-block:: text Looking for MediaTek SoC matching USB device 0e8d:0003 Opening COM33 using baudate=115200 Connected to MediaTek MT8195 SoC 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: 0xe8f800000, real erase len: 0x0 OKAY [ 9.627s] Finished. Total time: 9.655s erasing mmc0boot0 Erasing 'mmc0boot0' (bootloader) request sz: 0x800000, real erase len: 0x800000 OKAY [ 0.013s] Finished. Total time: 0.018s erasing mmc0boot1 Erasing 'mmc0boot1' (bootloader) request sz: 0x800000, real erase len: 0x800000 OKAY [ 0.004s] Finished. Total time: 0.010s flashing mmc0=rity-demo-image-genio-1200-evk.wic.img Sending sparse 'mmc0' 1/9 (262140 KB) OKAY [ 6.440s] Writing 'mmc0' OKAY [ 9.393s] Sending sparse 'mmc0' 2/9 (262140 KB) OKAY [ 6.332s] Writing 'mmc0' OKAY [ 10.185s] Sending sparse 'mmc0' 3/9 (230376 KB) OKAY [ 5.607s] Writing 'mmc0' OKAY [ 8.196s] Sending sparse 'mmc0' 4/9 (262140 KB) OKAY [ 6.362s] Writing 'mmc0' OKAY [ 9.354s] Sending sparse 'mmc0' 5/9 (262140 KB) OKAY [ 6.401s] Writing 'mmc0' OKAY [ 10.089s] Sending sparse 'mmc0' 6/9 (262140 KB) OKAY [ 6.413s] Writing 'mmc0' OKAY [ 9.291s] Sending sparse 'mmc0' 7/9 (242392 KB) OKAY [ 5.924s] Writing 'mmc0' OKAY [ 8.585s] Sending sparse 'mmc0' 8/9 (262140 KB) OKAY [ 6.417s] Writing 'mmc0' OKAY [ 9.288s] Sending sparse 'mmc0' 9/9 (129780 KB) OKAY [ 3.159s] Writing 'mmc0' OKAY [ 4.605s] Finished. Total time: 132.157s flashing mmc0boot0=bl2.img Sending 'mmc0boot0' (205 KB) OKAY [ 0.007s] Writing 'mmc0boot0' OKAY [ 0.026s] Finished. Total time: 0.054s flashing mmc0boot1=u-boot-env.bin Sending 'mmc0boot1' (4 KB) OKAY [ 0.002s] Writing 'mmc0boot1' OKAY [ 0.015s] Finished. Total time: 0.028s Rebooting OKAY [ 0.002s] Finished. Total time: 0.002s .. 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/yocto/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 “Yocto” 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/700-qsg/yocto_boot_screen_low_res.jpg :width: 350px - Log into board through UART0 interface. Once board has fully booted, a login prompt is sent across UART0 similar to that shown below. .. code:: genio-1200-evk login: Type ``root``, then enter, to log in. .. include:: demos/nnstreamer.rst .. include:: demos/opengles.rst Further details about the GPU, background theory, or troubleshooting can be found in the :doc:`BSP User Guide - GPU section `.