Step 3. Booting your Starter Kit (Ubuntu)

When using the KV260 Ubuntu image, in addition to logging in using the traditional way over the serial port, there is also a full GNOME Desktop available. To take advantage of the GNOME Desktop, use the “Instructions for GNOME Desktop” section below.  This will require a keyboard, mouse, and monitor to be connected.

To login into the GNOME Desktop, you must connect a DisplayPort or HDMI monitor as well as a USB Keyboard and Mouse.

Power ON the Starter Kit by connecting the power supply to the AC plug. The power LEDs should illuminate, and after about 10-15 seconds, you should see console output on the connected display.  After about a minute, the desktop login screen should appear as pictured below:

gnome-desktop-1

Please note that the Starter Kit powers up immediately as you connect the AC plug to a wall. (There’s no ON/OFF switch on the board.)

If you see the heartbeat LED is active but there's no output on the monitor, check your monitor to ensure that it’s powered on and the correct input is selected.

The default login credentials are:
username: ubuntu
password: ubuntu

The standard system policy requires you to change the password after the first time you log in with the default credentials.

Note: If you login very quickly the first boot, you may find that the password does not have to be changed. In this case, you will be required to update it the next time you login or use sudo.

Once logged in, you should see the default Ubuntu 22.04 LTS GNOME 42 desktop.

gnome-desktop-2

Open a terminal and verify internet connectivity via “ping” or “DNS lookup.

    ping 8.8.8.8

If you can observe that packet transmit/receive worked and there is no packet loss with the above ping command, this means your Internet connectivity is working and active.

Please note: Without Internet connectivity, you will not be able to perform the ROS 2 Perception Node application steps or install the necessary tools & packages.

Set up the Xilinx Development & Demonstration Environment for Ubuntu 22.04 LTS 

Install the xlnx-config snap that is required for system management:

    sudo snap install xlnx-config --classic --channel=2.x

For more information on using the xlnx-config snap, please refer to the xlnx-config snap page.

Run the xlnx-config.sysinit command to install Kria specific PPAs which will also run apt update and apt upgrade - accept all defaults when prompted:

    sudo xlnx-config.sysinit

For more detailed information regarding setting up the environment, please refer to: Getting Started with Ubuntu 22.04 LTS

Note that in order to launch some Kria Apps, the use of the USB-UART serial port to access the command line interface is required, rather than using the GNOME Desktop to start the applications.  Some applications, such as the Smart Camera Application, will occupy the entire display output area while they are running, but you will regain access to the GNOME Desktop once the application exits.

To login and access the command line interface over the USB-UART serial port, please choose the appropriate host OS section below:

For Windows, use the Device Manager to observe which COM ports appear when you plug the USB cable attached to the KV260 Starter Kit into your computer.

The Starter Kit uses an FTDI USB to COM port device that requires the FTDI virtual COM port driver to be installed on your machine. If the driver is not already installed on your host machine or Windows has not automatically installed it, go to the following link:

https://ftdichip.com/drivers/vcp-drivers/

Four COM ports are enumerated where the second numbered COM port corresponds to the UART.

Configure your terminal program (e.g., TeraTerm, PuTTy) with the settings shown below. If not already available, refer to Tera Term Terminal Emulator Installation Guide (UG1036) for instructions on installing a terminal program on your computer.

  • Baud rate = 115200
  • Data bits = 8
  • Stop bits = 1
  • Flow control = None
  • Parity = None

Power ON the Starter Kit by connecting the power supply to the AC plug. The power LEDs should illuminate and a Linux UART response can be seen on the terminal program interface.

Please note that the Starter Kit powers up immediately as you connect the AC plug to the wall power (There’s no ON/OFF switch on the board.)

If you see the heartbeat LED is active but there is no UART response, verify that your machine has the FTDI driver installed and that the terminal program is connected to the correct COM port.

The Starter Kit QSPI boots the board using SD boot mode and loads the SD contents to boot into Linux. At initial log-in, the platform requires you to set a new password.

The default login credentials are:
username: ubuntu
password: ubuntu

The standard system policy requires you to change the password after the first time you log in with the default credentials.

Note: If you login very quickly during the first boot, you may find that the password does not have to be changed. In this case, you will be required to update it the next time you login or use the sudo command to initiate the password change.

Verify Internet connectivity via “ping” or “DNS lookup.”

    ping 8.8.8.8

If you can observe that packet transmit/receive worked and there is no packet loss with the above ping command, this means your Internet connectivity is working and active.

Please note: Without Internet connectivity, you will not be able to perform the ROS 2 Perception Node application steps or install the necessary tools & packages.

Set up the Xilinx Development & Demonstration Environment for Ubuntu 22.04 LTS 

Install the xlnx-config snap that is required for system management:

    sudo snap install xlnx-config --classic --channel=2.x

For more information on using the xlnx-config snap, please refer to the xlnx-config snap page.

Run the xlnx-config.sysinit command to install Kria specific PPAs which will also run apt update and apt upgrade - accept all defaults when prompted:

    sudo xlnx-config.sysinit

For more detailed information regarding setting up the environment, please refer to: Getting Started with Ubuntu

For macOS, open a terminal by searching for the “Terminal” in your Applications folder. Enter the following command to observe which COM ports appear when you plug in the USB cable attached to the KV260 into your computer.

    $ ls /dev/tty.*

Four COM ports are enumerated where the second numbered COM port corresponds to the UART.

Configure your UART within the same terminal. You can also configure your terminal program with the same settings below. These settings are the same as defined in the Windows set-up.

    $ screen /dev/tty.usbserial-<board serial>1 115200,cs8

Power ON the Starter Kit by connecting the power supply to the AC plug. The power LEDs should illuminate and a Linux UART response can be seen on the terminal program interface.

Please note that the Starter Kit powers up immediately as you connect the AC plug to the wall power (There’s no ON/OFF switch on the board.)

If you see the heartbeat LED is active but there is no UART response, verify that your machine has the FTDI driver installed and that the terminal program is connected to the correct COM port.

The Starter Kit QSPI boots the board using SD boot mode and loads the SD contents to boot into Linux. At initial log-in, the platform requires you to set a new password.

The default login credentials are:
username: ubuntu
password: ubuntu

The standard system policy requires you to change the password after the first time you log in with the default credentials.

Note: If you login very quickly during the first boot, you may find that the password does not have to be changed. In this case, you will be required to update it the next time you login or use the sudo command to initiate the password change.

Verify Internet connectivity via “ping” or “DNS lookup.”

    ping 8.8.8.8

If you can observe that packet transmit/receive worked and there is no packet loss with the above ping command, this means your Internet connectivity is working and active.

Please note: Without Internet connectivity, you will not be able to perform the ROS 2 Perception Node application steps or install the necessary tools & packages.

Set up the Xilinx Development & Demonstration Environment for Ubuntu 22.04 LTS

Install the xlnx-config snap that is required for system management:

    sudo snap install xlnx-config --classic --channel=2.x

For more information on using the xlnx-config snap, please refer to the xlnx-config snap page.

Run the xlnx-config.sysinit command to install Kria specific PPAs which will also run apt update and apt upgrade - accept all defaults when prompted:

    sudo xlnx-config.sysinit

For more detailed information regarding setting up the environment, please refer to: Getting Started with Ubuntu

For Linux, open a terminal by right clicking on the Desktop and selecting “Open In Terminal”, and enter the following command to observe which COM ports appear when you plug in the USB cable attached to the KV260 into your computer.

    $ dmesg | grep tty

Four COM ports should be enumerated. The third numbered COM port corresponds to the UART.​

Configure your UART within the same terminal. You can also configure your terminal program with the same settings below. These settings are the same as defined in the Windows set-up.

    $ sudo putty /dev/ttyUSB2 -serial -sercfg 115200,8,n,1,N

The Starter Kit uses an FTDI USB to COM port device that requires the FTDI virtual COM port driver to be installed on your machine. If the driver is not already installed on your host machine or Linux does not automatically detect it and load the appropriate driver, go to the following link for additional guidance: 

https://ftdichip.com/drivers/vcp-drivers/   ​

Power ON the Starter Kit by connecting the power supply to the AC plug. The power LEDs should illuminate and a Linux UART response can be seen on the terminal program interface.

Please note that the Starter Kit powers up immediately as you connect the AC plug to the wall power (There’s no ON/OFF switch on the board.)

If you see the heartbeat LED is active but there is no UART response, verify that your machine has the FTDI driver installed and that the terminal program is connected to the correct COM port.

The Starter Kit QSPI boots the board using SD boot mode and loads the SD contents to boot into Linux. At initial log-in, the platform requires you to set a new password.

The default login credentials are:
username: ubuntu
password: ubuntu

The standard system policy requires you to change the password after the first time you log in with the default credentials.

Note: If you login very quickly during the first boot, you may find that the password does not have to be changed. In this case, you will be required to update it the next time you login or use the sudo command to initiate the password change.

    ping 8.8.8.8

If you can observe that packet transmit/receive worked and there is no packet loss with the above ping command, this means your Internet connectivity is working and active.

Please note: Without Internet connectivity, you will not be able to perform the ROS 2 Perception Node application steps or install the necessary tools & packages.

Set up the Xilinx Development & Demonstration Environment for Ubuntu 22.04 LTS 

Install the xlnx-config snap that is required for system management:

    sudo snap install xlnx-config --classic --channel=2.x

For more information on using the xlnx-config snap, please refer to the xlnx-config snap page.

Run the xlnx-config.sysinit command to install Kria specific PPAs which will also run apt update and apt upgrade - accept all defaults when prompted:

    sudo xlnx-config.sysinit

For more detailed information regarding setting up the environment, please refer to: Getting Started with Ubuntu

Important: Critical Firmware Update Required

  • To enable complete board functionality, compatibility with latest Operating Systems, and best performance, be sure to install the latest AMD provided boot firmware following the firmware update instructions available on the K26 Wiki