.. include:: /keyword.rst

==========
|i350-EVK|
==========

.. contents:: General
    :local:
    :depth: 1

--------------------------------

This chapter describes platform-dependent information and instructions. For example, you
will get different benchmark results on different platforms.

For general usage of Ethernet, such as command to configure DHCP or static IP and so on,
please refer to :doc:`Ethernet </sw/yocto/app-dev/ethernet/ethernet-common>` chapter.

.. note::
    Command operations and test results presented in this chapter are based on the IoT Yocto v22.1 and |i350-EVK-REF-BOARD|.

--------------------------------


.. important::

    **i350 EVKs are not shipped with pre-allocated MAC addresses.**
    
    Instead, a random MAC address is generated and stored after flashing the image.
    Please do not use it for production purposes.
    

.. contents:: Sections
    :local:
    :depth: 2

Ethernet Port on Genio 350-EVK
==============================

The Ethernet PHY interface is **mutually exclusive** to DPI display interface on Genio 350-EVK:

.. figure:: /_asset/sw_yocto_app-dev_eth_port_i350-evk.png
    :width: 80%
    :align: center

    Ethernet Port on Genio 350-EVK


Enable Ethernet Port on Genio 350-EVK
=====================================

The default configuration for `rity-demo-image` disables Ethernet port.

To enable Ethernet port and disable the HDMI port, please follow these steps:

1. Set the boot switch (``SW2101``) to **Off=LAN**, as shown below:

   .. figure:: /_asset/sw_yocto_app-dev_display_boot-switch-eth.jpg
       :width: 55%

1. Remove the HDMI jumpers (``J2324``, ``J2325``, ``J2326`` and ``J2327``):

   .. figure:: /_asset/sw_yocto_app-dev_display_jumpers.jpg
       :width: 55%

   .. important::

       The boot switch and the HDMI jumpers must adjust together.
       Returning the DIP switch to the HDMI setting without replacing the jumpers may result in the HDMI signal having incorrect voltage levels.

1. Flash `rity-demo-image` with the overlay ``net-ethernet.dtbo``:

   .. prompt:: bash

       genio-flash --load-dtbo net-ethernet.dtbo rity-demo-image

   .. important::

       HDMI port gets disabled once ``net-ethernet.dtbo`` is loaded. You might want to :ref:`enable DSI LCM <dsi-lcm-setup>` in addition. 

1. Connect the Ethernet **LAN** port to your local area network. 
1. After flashing and rebooting the device, please :doc:`login to the console </sw/yocto/get-started/connect>`.
1. If your local area network have DHCP setup properly, you should be able to check the allocated IP address for i350 EVK with:
   
   .. prompt:: bash

       ip a

   and the interface ``eth0`` should have IP addresses registered, for example:

   .. code:: text

        1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
           link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
           inet 127.0.0.1/8 scope host lo
              valid_lft forever preferred_lft forever
           inet6 ::1/128 scope host
              valid_lft forever preferred_lft forever
        2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000
           link/ether b6:ae:9c:a0:3e:4d brd ff:ff:ff:ff:ff:ff
           inet 10.1.4.172/16 brd 10.1.255.255 scope global dynamic eth0
              valid_lft 7173sec preferred_lft 7173sec
           inet 10/1/3/182/16 brd 10.1.255.255 scope global secondary dynamic noprefixroute eth0
              valid_lft 7178sec preferred_lft 6278sec
           inet6 fe80::acd6:8ec1:21e6:f5f1/64 scope link noprefixroute
              valid_lft forever preferred_lft forever