1_Booting.md

Back to the startpage

Booting rsYocto on your Board

This guide shows how to install rsYocto on a SD Card and boot it on a Terasic FPGA development Board.

Create a bootable SD-Card

1. Download the newest Image for your Board

   • The final Images are located inside the "release part" of this Github repository

     

     

   • Suffix decoding for the Image-Names:

     File Suffix	FPGA	supported Board name
     _DE10STD	Intel Cyclone V	Terasic DE10-Standard
     _D10NANO	Intel Cyclone V	Terasic DE10-Nano
     _HAN	Intel Arria 10	Terasic HAN Pilot Platform

     Note: rsyocto_SD ... is the associated SD-Card folder for the release (see Part 5)

2. Insert a Micro SD Card (1GB or greater) into your computer

3. Use a "Bootable SD Card Creation Tool" to create a bootable image on the SD card

   • For example use the tool Rufus
   • Rufus can also use the ZIP-archive directly (that is even faster)
   • Ignore all warning message boxes

   

Prepare your Board and open the console COM-Port

1. Eject the SD Card from your Computer and insert it into the SD -Reader of your FPGA Board
2. Change the MSEL-Bit switch to following setting:
3. Connect your FPGA-Board with a Ethernet cable to your network
   • Be sure that a iPv4-DHCP is active on this network
4. Connect a USB Cable between the FTDI Virtual COM-Port (USB CDC) and your Computer
5. Open the COM-Port
   • You can use the tool MobaXterm for example
   • Use following settings: 115200N8 (ASCII) with CR/LF

Boot rsYocto on your FPGA-Board

1. Power up your FPGA Board
2. Now rsYocto boots through following stages:

No	Stage	Description	Task
1	Primary Bootloader	Pre-configuration of the FPGA configuration (Arria 10 SX only)	Connecting HPS to FPGA SDRAM-Controller
2	Primary Bootloader	Booting of primary bootloader	Hardware check and startup (SDRAM,...)
3	Secondary Bootloader	Booting of u-boot	Loading and execution of the bootloader script
4	Bootloader script	Secondary bootloader script execution	Writing the FPGA configuration and loading of the Linux Kernel
5	Secondary Bootloader	Booting of u-boot	Loading and execution of the bootloader script
6	Linux Kernel	Start of booting the Linux Kernel
7	Linux Kernel	Reading the Device Tree	The Kernel reads the device tree and loads the drivers
8	Linux Kernel	Execution of the startup scripts from the rootFs starts
9	startup-script	Execution of by the user configurable startup script
10	Network Interface	Activation of the Network interface	Waiting for an DHCP reception with an iPv4-Address
11	OpenSSH	OpenSSH SSH Server	Starting
12	Apache	Apache Web Server	Starting
13	run-script	Execution of by the user configurable startup script	Time synchronization via HTTP
14	BusyBox	BusyBox Linux console interface
15	User Command input after password authentication

During the boot must be an ON and OFF FPGA LED pattern be shown on the board!

• The secondary u-bootloader writes 0x55 via the Lightweight HPS to FPGA bridge to a Soft-IP PIO controller connected to the FPGA LEDs
• Note: If this is not the case is the MSEL switch not in the proper position and the FPGA configuration could not be written properly!

The Linux requests an iPv4-Address by a DHCP-server

After the system has booted properly and a network connection is established -> HPS LED and only FPGA LED 0 turns ON

• Note: If rs Yocto goes in a bootloop after requesting the current date the MSEL switch is not in the proper position and the FPGA configuration could not be written properly! This problem could occur because the boot-up shell script (shown here at the end) tries to write to the closed LW HPS2FPGA Bridge or to an unreachable address.

For users with non supported boards: Please go to this guide and use rsYocto with your custom FPGA configuration and boot scripts.

rsYocto is booting on an Arria 10 SX

Login

• Default device name: cyclone5 or arria10
• Login: root
• Passwort: eit
• Default MAC: d6:7d:ae:b3:0e:ba

Find the iPv4 Address of your Board

• Use following Linux Command to get the iPv4 Address of your Board

   ifconfig

• the IP Address is also shown during the boot

Connect to rsYocto with SSH

1. Open Linux or Windows Command Prompt (Windows 10) and insert this command to connect to your Board:

   ssh root@<Boards iPv4-address>
   

2. Use following the Passwort: eit

• No other authentications are required
• The default SSH-Port (22) is used

3. Now rsYocto Splash screen appears

Continue with the next level: Use of Hard IP, FPGA-IP and configuration of the FPGA fabric