.. 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 350-EVK Yocto Demo ======================== 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 - Both AP1302 :abbr:`ISP (Image Signal Processor)` Camera Boards and Appletec AR0430 Camera Modules enabled - AP1302 :abbr:`ISP (Image Signal Processor)` Camera Board configured to use the On-Semiconductor AP1302CSSL00SMGA0-DR ISP - External HDMI Monitor (not the included TFT :abbr:`LCD (Liquid Crystal Display)` Module) - Ethernet interface disabled Additional Items Needed for Quick Start Guide Demo ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ To support the demo, the following additional items are needed. - External Monitor supporting HDMI - HDMI Cable - Two USB Cables (USB-2.0-A to Micro-B) - External PC for loading flash and interacting via command prompt .. figure:: /_asset/i350-qsg/Genio_350-EVK_Camera_system_image.jpg :align: center :width: 600 Genio 350-EVK Yocto Demo System Image .. include:: sections/env_setup.rst ========================= Kit Hardware Installation ========================= - Insert AzureWave Wireless Module and two corresponding jumper wires as shown in :ref:`azure_wave`. The jumper wires connect the module to the on board PCB antennas. - Insert Mini-:abbr:`SAS (Serial Attached SCSI)` Cable into the corresponding connectors of the Genio 350 EVK mainboard and Camera board. - Connector locations can be referred to the marks in the picture as below. .. figure:: /_asset/i350-qsg/camera-board-installation.png :align: center :width: 350px Camera Board Installation .. Note:: You should hear a “click" sound to confirm when the Mini-:abbr:`SAS (Serial Attached SCSI)` cables have been correctly inserted into the connectors. - Insert the screws into the screw holes on the front of the Genio 350EVK mainboard and screw the plastic standoffs from the back. .. container:: twocol .. container:: leftside .. figure:: /_asset/i350-qsg/Bracing-frame-installation.png Standoff assembly .. container:: rightside .. figure:: /_asset/i350-qsg/Bracing-Frame-assembled.jpg Standoff assembly finished - Connect a USB cable to connector labeled **UART0** as shown in: :ref:`main_motherboard`. 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** 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. Further details regarding both USB drivers can be found in the :ref:`flash trouble-shooting section `. - Plug AC/DC power adapter into the connector. .. figure:: /_asset/i350-qsg/power-adapter-installation.png :align: center :width: 350px Power Adapter Installation .. Note:: After the EVK power is turned on, confirm that the four LED indicators illuminate. .. 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 |i350-EVK-REF-BOARD|. The flashing process is performed through the USB0 connection on the |i350-EVK-REF-BOARD|. 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 board image ` to your local PC. - 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/yocto/get-started/flash` instructions for further details or troubleshooting. - 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 camera-ap1302-ar0430-dual.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 **volume up** button 2. Press and release the **reset** button 3. Release the **volume up** button .. figure:: /_asset/sw_rity_get-started_flash_download-mode.gif :align: center Reset the board to enter download mode .. note:: On most Genio evaluation boards, the **volume up** button is connected to the ``KPCOL0`` pin of the chip. If you have trouble finding the correct button, refer to the user guide or schematics of your board. You should see flashing process started after releasing the volume up button. A typical successful log looks like this: .. code:: AIoT Tools: v1.3.3 Yocto Image: name: Rity Demo Image (rity-demo-image) distro: Rity Demo Layer 21.3-dev (rity-demo) codename: dunfell machine: i350-evk overlays: [] Looking for MediaTek SoC matching USB device 0e8d:0003 Opening COM11 using baudate=115200 Connected to MediaTek MT8365 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: 0x3a6800000, real erase len: 0x0 OKAY [ 0.233s] *... (shortened for brevity)* .. code:: Rebooting OKAY [ 0.002s] Finished. Total time: 0.003s - 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 screen appears as shown above in the image *Genio 350-EVK Yocto Demo System Image* - Log into board through UART0 interface. Once board has fully booted, a login prompt is sent across UART0 similar to that shown below. .. code:: i350-evk login: Type *root*, then enter, to login. .. include:: demos/camera.rst Further details about hardware operation, background theory, or troubleshooting can be found in the :doc:`BSP User Guide - Camera section `. .. include:: demos/gpu.rst Further details about the GPU, background theory, or troubleshooting can be found in the :doc:`BSP User Guide - GPU section `.