Exercise Sample Linux Applications

Excercise Sample Linux Applications on Stratix 10 SoC

Overview

The GSRD includes a number of sample Linux applications that help demonstrate some of the features of the platform:

• Display Hello World message
• Control LEDs
• Detect interrupts from push buttons and DIP switches

The sample applications can be used as a starting point for users to write their own applications that interact with software IP through Linux drivers.

Prerequisites

1. Boot Linux on the target board as described in Boot Linux With Precompiled Binaries. You will not need to use the serial terminal if you plan on using ssh connection.

2. Connect to the board using one of the following options:

• Connect using serial console, as described in Boot Linux With Precompiled Binaries
• Connect using ssh, as described in SSH Connection

3. In serial console, or ssh client console, change current folder to be /home/root/intelFPGA- this is where the application binaries are stored.

 # cd /home/root/intelFPGA

Display Hello World Message

1. Run the following command to display the Hello World message on the console:

# ./hello 

hello

Exercise Soft PIO Driver for LED Control

1. If you want to control the FPGA LED from the HPS, you must first enable the scrolling service

# /www/pages/cgi-bin/scroll_server & 

2. The Stratix 10 SoC board should now continuously light on/off FPGA LED 0-2.

The following LEDs are exercised:

LED Number	Corresponding Board LED
0	D26
1	D25
2	D28

3. To stop scrolling, type the following command:

# ./scroll_client -1 

The FPGA LED can now be controlled using other application, such as blink and toggle.

4. In order to blink an LED in a loop, with a specified delay in ms, run the following command:

# ./blink <led_number> <delay_ms> 

• The led_number specifies the desired LED, and is a value between 0 and 3.
• The delay_ms is a number that specifies the desired delay in ms between turning the LED on and off.

Note: Blink application doesn't work with 19.1 precompiled binaries from https://rocketboards.org/foswiki/Documentation/GSRD191ReleaseNotes#Release_Contents, please follow instructions in https://rocketboards.org/foswiki/Documentation/GSRDCompilingLinux_S10 to re-compile 19.1 binaries.

5. In order to turn an individual LED on or off, run the following command:

# ./toggle <led_number>  

• The led_number specifies the desired LED, and is a value between 0 and 3.
• The state needs to be 0 to turn the LED off, and 1 to turn the LED off.

6. In order to scroll the FPGA LEDs with a specified delay, please run the following command:

# ./scroll_client <delay> 

The delay parameter is a numbed the specifies the desired scrolling behavior:

• delay > 0 - specify new scrolling delay in ms, and start scrolling
• delay < 0 - stop scrolling
• delay = 0 - display current scroll delay

Register Interrupt and Call Interrupt Service Routine

In order to register an interrupt handler to a specific GPIO, you will first need to determine the GPIO numbers used.

1. Determine which of the GPIO entries from /sys/class/gpio/ matches the offsets by searching for the address in the label entry.

2. For DIP switches, run:

# grep -r "gpio@1070" /sys/class/gpio/gpiochip*/label 

The output will be something similar with:

/sys/class/gpio/gpiochip416/label:/soc/gpio@1070

There are four DIP switches ranging from 416 to 419.

3. For push buttons run:

# grep -r "gpio@1060" /sys/class/gpio/gpiochip*/label

The output will be something similar with:

/sys/class/gpio/gpiochip448/label:/soc/gpio@1060

This means that the GPIOs 448, 449 are allocated to the push buttons (there are two of them).

4. In order to register an interrupt handler to a GPIO interrupt, run the following command:

# modprobe gpio_interrupt gpio_number=<gpio_number>

Where gpio_number is one of the numbers determined at the previous steps.

For example run:

# modprobe gpio_interrupt gpio_number=416 intr_type=3

User will need to do "rmmod gpio_interrupt" prior in order to change gpio_number by calling "modprobe gpio_interrupt gpio_number=<gpio_number>" again

5. Press FPGA push button 0 (s3).

If you are on the serial console, you will see the following message displayed on the console:

Interrupt happened at gpio:416

If you are on the ssh console, you will need to run the program dmesg after pressing the button in order to see the messages:

# dmesg 

System Check Application

System checking application provides a glance of system status of basic peripherals such as:

• USB USB device driver
• Network IP (IPv4) : Network IP address
• HPS LEDs : HPS LED state
• FPGA LEDs : FPGA LED state

# ./syschk 

                                            ALTERA SYSTEM CHECK

IPv4 Address  : 192.168.10.112 usb1             : DWC OTG Controller

fpga_led2     : OFF            serial1@ffc02100   : disabled
hps_led2      : OFF            serial0@ffc02000   : okay
fpga_led0     : OFF
hps_led0      : OFF
fpga_led3     : OFF
fpga_led1     : OFF
hps_led1      : OFF

Note: System check application works better when viewed via SSH to the target. USB-UART refreshes slower hence the user interface might flicker.

To quit the application, press "q"