.. 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 700 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 - D2 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 D2 Camera Board to CS10 on the main motherboard. .. figure:: /_asset/700-qsg/hw_evk_g700-evk_with_D6.jpg :align: center :width: 500px Camera Board Insertion .. figure:: /_asset/700-qsg/IoT-CAM-DTB-D1V2-D2.jpg :align: center :width: 500px Camera Board D2 - Connect a USB cable to connector labeled **UART0** 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 **USB0** 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/700-qsg/USB_ports.png :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 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:: enio Tools: v1.6a3 Raw Image: name: eMMC 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[0x8188] 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.123s] *... (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/700-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.