Integrator Resources

• The official home for NAI Support

Not sure where to start? Try Quick Start Guide or ask a question below!

Toggle Components with Visual Button
JavaScript Form Processing

SSK 1.X Linux (Makefile) Target

Edit this on GitLab

NAI ARM Linux (Using Vivado Windows with SDK)

Version 1.7

Overview

This Quick Start Guide describes how to run an NAI sample application on a NAI ARM Linux target board. Setting up the NAI SSK in a development environment will also be described.

Note

This manual assumes that the target board has been configured with an RS-232 Debug connection and an Ethernet port 1, all accessible to the programmer.

Prerequisites

Item

Description

Host PC:

Windows 7 or later

RS-232 Serial Cable:

Used for accessing the Linux shell terminal on the ARM target board

Ethernet Cable:

Used for Telnet to download/upload files into the ARM target board and remote GDB debugging

Adapter Board:

Converts the HDMI connector on the ARM board to serial and Ethernet protocols

Putty:

SSH client for connecting to target board via Ethernet

naibrd_SSK_Linux_ARM_Rev1.60 Library:

NAI Board Software Support Kit for application development

Tera Term:

Serial Console used to interface with the Linux OS on the ARM target board

Putty - http://www.putty.org/

Tera Term - https://en.osdn.jp/projects/ttssh2/releases/

Naibrd_SSK_Linux_ARM_Rev1.60 Library – https://www.naii.com/Downloads/

ARM Board – Getting Started

Remote Connection

The serial connection and Ethernet port are accessed through the HDMI connector on ARM target boards. For ruggedized ARM enclosures, both ports are routed to a MIL connector. You may need an external adapter board (see below) to convert the HDMI connector to a serial and Ethernet port.

CAUTION

Ensure that target board is powered off, until directed to power it on.

nai_arm_linux_windows_pics/media/image3 nai_arm_linux_windows_pics/media/image4

HDMI Connector

MIL Connector

Note

The USB-A connector on the adapter board is not supported by the ARM target board.

nai_arm_linux_windows_pics/media/image5

Adapter Board

Serial Port

Note

The following procedures refer to NAI target board and are also applicable to the target board contained in the ruggedized enclosure.

  1. Open serial console on Host PC (e.g. Tera Term, Mimicom) and do the following:

    1. In Tera Term, select Setup→Serial Port…​

nai_arm_linux_windows_pics/media/image6

  1. Set Baud Rate to 115200.

  2. Set Parity Bit to None.

  3. Set flow control to “None”.

nai_arm_linux_windows_pics/media/image7

  1. Power up the target board.

  2. The default user name on the target Linux is “root” and password is “root”.

Ethernet Port

  1. Connect the Ethernet port from target board and Host PC to a local network.

  2. Open putty on host PC.

nai_arm_linux_windows_pics/media/image9

Note

The default IP address of the target board is available on the label or it can be obtained by running the ifconfig command from shell terminal.

  1. Power up the target board.

  2. The default user name on the target Linux is “root” and password is “root”.

Changing the Ethernet IP Addresses

The target board contains 2 Ethernet Interfaces. Each Ethernet Interface is assigned a unique MAC address and static IP address. The MAC addresses and static IP addresses are stored on the motherboard EEPROM. The static IP address can be changed using an EEPROM update utility provided with the unit. The MAC addresses should not be changed.

To access the EEPROM utility from the Linux shell terminal, proceed as follows:

  1. Log in as a root user as described in the previous sections.

  2. Display the contents of the motherboard EEPROM by typing:

mbeeprom_util display

  1. The following or something similar (your model may vary) displays:

root@nai-niu1a:~# mbeeprom_util display

NAI ARM-SOC Motherboard EEPROM Utility (mbeeprom_util)

Target Processor: Xilinx ARM

Target OS: PetaLinux

Build Revision: 3.32.3

Build Date: Oct 29 2014 08:26:22 UTC

Displaying Motherboard EEPROM - Start

00000000: 4E 4F 4E 45 :NONE:

00000004: 32 33 31 34 :2314:

00000008: 42 4F 4F 31 :BOO1:

0000000C: 00 00 00 00 ::

00000010: 04 00 00 00 ::

00000014: 00 00 00 00 ::

00000018: 4E 49 55 00 :NIU:

0000001C: 31 41 00 00 :1A:

00000020: 01 00 02 00 ::

00000024: 01 00 02 00 ::

00000028: AA BB CC DD :ª»ÌÝ:

0000002C: EE FF 00 00 :îÿ:

00000030: 65 74 68 30 :eth0:

00000034: 00 00 00 00 ::

00000038: C0 A8 01 10 :ˬ:

0000003C: FF FF FF 00 :ÿÿÿ:

00000040: C0 A8 01 01 :ˬ:

00000044: 20 02 C0 A8 : ˬ:

00000048: 01 01 00 00 ::

0000004C: 7C 99 D1 18 :\|Ñ:

00000050: 90 58 12 35 :X5:

00000054: 40 00 00 00 :@:

00000058: 11 22 33 44 :"3D:

0000005C: 55 66 00 00 :Uf:

00000060: 65 74 68 31 :eth1:

00000064: 00 00 00 00 ::

00000068: C0 A8 02 10 :ˬ:

0000006C: FF FF FF 00 :ÿÿÿ:

00000070: C0 A8 02 01 :ˬ:

00000074: 20 02 C0 A8 : ˬ:

00000078: 01 02 00 00 ::

0000007C: 7C 99 D1 18 :\|Ñ:

00000080: 90 58 12 35 :X5:

00000084: 30 00 00 00 :0:

00000088: 00 0F 00 00 ::

0000008C: 00 00 00 00 ::

00000090: 00 00 00 00 ::

00000094: 41 CE 42 CE :AÎBÎ:

00000098: 41 CE 42 CE :AÎBÎ:

0000009C: E6 CD E7 CD :æÍçÍ:

000000A0: F0 CD F1 CD :ðÍñÍ:

000000A4: 00 00 00 00 ::

000000A8: 00 00 00 00 ::

000000AC: 00 00 00 00 ::

000000B0: 00 00 00 00 ::

000000B4: 00 00 00 00 ::

000000B8: 00 00 00 00 ::

000000BC: 00 00 00 00 ::

000000C0: 00 00 00 00 ::

000000C4: 00 00 00 00 ::

000000C8: 00 00 00 00 ::

000000CC: 00 00 00 00 ::

000000D0: 00 00 00 00 ::

000000D4: 00 00 00 00 ::

000000D8: 00 00 00 00 ::

000000DC: 00 00 00 00 ::

000000E0: 00 00 00 00 ::

000000E4: 00 00 00 00 ::

000000E8: 00 00 00 00 ::

000000EC: 00 00 00 00 ::

000000F0: 00 00 00 00 ::

000000F4: 00 00 00 00 ::

000000F8: 00 00 00 00 ::

000000FC: 00 00 00 00 ::

Displaying Motherboard EEPROM – Start

The Eth-0 IP Address is stored at EEPROM address 00000038: C0 A8 01 10 (192.168.1.16)

The Eth-1 IP Address is stored at EEPROM address 00000068: C0 A8 02 10 (192.168.2.16)

To update the static IP addresses, enter the following commands (substitute your desired IP addresses):

root@nai-niu1a:~/NAII# mbeeprom_util set EthA_IPv4Address 192.168.1.16

root@nai-niu1a:~/NAII# mbeeprom_util set EthA_IPv4SubnetMask 255.255.255.0

root@nai-niu1a:~/NAII# mbeeprom_util set EthB_IPv4Address 192.168.2.16

root@nai-niu1a:~/NAII# mbeeprom_util set EthB_IPv4SubnetMask 255.255.255.0

The updated IP addresses will take effect on the next system reset.

CAUTION

The mbeeprom_util program will allow you to erase the entire contents of the EEPROM. DO NOT do this as it will erase important system parameters including the Ether Interface MAC addresses. The ARM board will not function without these settings.

DO NOT alter any of the other EEPROM fields as the ARM board will not function without the correct settings.

Development Environment Setup

Host PC

The recommended development platform is a PC with minimum 2GB RAM and 30GB hard drive space, and with Windows 7 or later.

Cross-Compiler

The ARM Linux Cross-Compiler package is available on Xilinx’s website. Download the software as follows:

  1. If you have not done so already, create a Xilinx account and make sure you are signed into it for the duration of the installation (you will need to be signed in to complete some parts of the installation).

  2. Navigate to:

  3. https://www.xilinx.com/support/download/index.html/content/xilinx/en/downloadNav/vivado-design-tools/archive.htmlLocate release 2014.2 and download “Vivado 2014.2 Full Image for Windows with SDK”.

nai_arm_linux_windows_pics/media/image10

  1. On the “Download Center” page that comes up, fill out all of the required fields and then press “Next”.

nai_arm_linux_windows_pics/media/image12

  1. In the window that pops up, select “Save File” and then click “OK” to save the file to the “Downloads” directory on your PC.

nai_arm_linux_windows_pics/media/image13

  1. Unzip the “Xilinx_Vivado_SDK_Win_2014.2_0612_1.tar.gz” file, which should now be found in the “Downloads” directory on your PC.

  2. Run xsetup.exe from the unzipped file folder.

nai_arm_linux_windows_pics/media/image14

  1. Click “Yes” when the User Account Control window pops up.

Note

The Vivado 2014.2 Installation menu will prompt you to install a newer version of Vivado SDK.

DO NOT upgrade to the newer version of the SDK.

  1. If a window pops up that says it is checking for the latest version, click “Ignore”. If a window labelled “A Newer Version Is Available” pops up, click “Continue”.

nai_arm_linux_windows_pics/media/image15

  1. In the “Vivado 2014.2 Installer – Welcome” window, click “Next >”.

nai_arm_linux_windows_pics/media/image16

  1. In the “Accept License Agreements” window that pops up, check all of the “I Agree” check boxes and then click “Next >”.

nai_arm_linux_windows_pics/media/image17

  1. Select “Software Development Kit (Standalone)” edition to install. This package includes the Cross-Compiler and debugger for application development. Then click “Next >”.

nai_arm_linux_windows_pics/media/image18

  1. In the 1st and 2nd window, click “Next >”. In the 3rd window, click “Install”.

nai_arm_linux_windows_pics/media/image19

nai_arm_linux_windows_pics/media/image20

nai_arm_linux_windows_pics/media/image21

  1. After the installation is complete, if you do not already have a license file for the SDK on your computer, select “Get Free Licenses – Vivado WebPACK, SDK, free IP and more”. Then, click “Connect Now”.

Note

You don’t need to purchase a license for the Software Development Kit (Standalone).

nai_arm_linux_windows_pics/media/image22

  1. When you click “Connect Now”, you will be taken to the Xilinx website. If you are not signed in to your Xilinx account, sign in. If the Xilinx website asks you to fill out some personal information, fill it out. Then, you will be taken to the “Product Licensing” page. Select “Vivado Design Suite: HL WebPACK 2015 and Earlier License”, and then click “Generate Node-Locked License”.

nai_arm_linux_windows_pics/media/image23

  1. Click “Next”.

nai_arm_linux_windows_pics/media/image24

  1. Click “Next” again. The license file will now be emailed to the email account you specified when creating your Xilinx account. Copy the license file to your PC so that it can be detected when you run the SDK.

nai_arm_linux_windows_pics/media/image25

  1. Open Xilinx. You will be prompted to choose a workspace location. This will be where all the projects you create will be placed. There is no certain place where the workspace needs to be made; in this case, the workspace, called “Workspace,” is made in the C drive.

nai_arm_linux_windows_pics/media/image26

  1. Exit the “Welcome” tab that shows up by default.

nai_arm_linux_windows_pics/media/image27

Access files on Target Board

This can be done within the Xilinx SDK by setting up a new SSH remote system from the Remote System Explorer.

  1. Navigate to File→New→Other

nai_arm_linux_windows_pics/media/image28

  1. In “Select a wizard” window, navigate to Remote System Explorer→Connection and double-click “Connection”.

nai_arm_linux_windows_pics/media/image29

  1. In “Select Remote System Type” window, double-click “SSH Only”.

nai_arm_linux_windows_pics/media/image30

  1. In “Remote SSH Only System Connection” window, enter the IP Address of the target board in both the “Host name:” and “Connection name:” fields. In the “Description:” field, enter “Host name = IP of remote target”. Then click “Finish”.

nai_arm_linux_windows_pics/media/image31

  1. Navigate to Window→Open Perspective→Other…​

nai_arm_linux_windows_pics/media/image32

  1. In “Open Perspective” window, double-click “Remote System Explorer”. The SSH remote system that we will use should be set up, and the Remote System Explorer should be open.

nai_arm_linux_windows_pics/media/image33

  1. In the Remote System Explorer (i.e. the “Remote Systems” tab), expand the <IP Address of target board> node and navigate to <IP Address of target board>/Sftp Files/Root///home/root. If you are prompted for credentials to access the “Root” directory, the User ID and Password are both “root”. Then, right-click “root” (<IP Address of target board>/Sftp Files/Root//home/root). This is the location on the board that we will copy executables to in order to run them on the board.

nai_arm_linux_windows_pics/media/image34

nai_arm_linux_windows_pics/media/image35

Building the “Hello World” Application

Create simple HelloWorld.c file on the Host PC as follows:

  1. Navigate to File→New→Project→C/C++.

nai_arm_linux_windows_pics/media/image36

nai_arm_linux_windows_pics/media/image37

  1. Select “C Project” and click “Next >”.

nai_arm_linux_windows_pics/media/image38

  1. Select “Xilinx ARM Linux Executable” under “Project type:” and make sure “Xilinx ARM GNU/Linux Toolchain” is selected under “Toolchains:”. Also, set “Project name:” to “HelloWorld”. Then, click “Next >”.

nai_arm_linux_windows_pics/media/image39

  1. You will be asked to select project configurations. Selecting Debug means debugging and symbolic information is included. Selecting Release means the compiler will optimize the executable and strip it of debugging information. By default, both Debug and Release configurations are selected. You can leave the defaults and select <Finish>.

nai_arm_linux_windows_pics/media/image40

  1. Add the HelloWorld src file by right clicking on the HelloWorld project in the project explorer and then selecting New→File. This will cause the “New File” window to come up.

nai_arm_linux_windows_pics/media/image41

  1. Make sure that HelloWorld is selected as the parent folder. Then, enter HelloWorld.c as the File Name and click the “Finish” button. nai_arm_linux_windows_pics/media/image42

  2. Type some code to execute in the HelloWorld.c file. Then, save the project and build it by clicking the hammer icon.

nai_arm_linux_windows_pics/media/image43

Running “Hello World” on the Target Board

An executable .elf file may be run from the board using either a Serial Console (Tera Term) or the Xilinx SDK.

  1. Copy the HelloWorld.elf executable file from your PC to the /home/root directory of the target board.

    1. In the Xilinx SDK, in the “Remote Systems” tab in the “Remote System Explorer” perspective, right-click “root” (<IP Address of target board>/Sftp Files/Root///home/root) and click “Export From Project…​”

nai_arm_linux_windows_pics/media/image44

  1. In the “Remote file system” window, in the left box, navigate to and select HelloWorld/Debug (but do not check either the “HelloWorld” or “Debug” folders, as this will copy over the entire folder). In the box on the right, select and check the check box next to “HelloWorld.elf”. Then, click “Finish”.

nai_arm_linux_windows_pics/media/image45

  1. Run HelloWorld.elf using either the Serial Console or the Xilinx SDK.

Running “Hello World” Via the Serial Console (Tera Term used in this example)

  1. Navigate to the /home/root directory of the target board using the serial console (Tera Term).

nai_arm_linux_windows_pics/media/image46

  1. While in this directory, type chmod 777 HelloWorld.elf to change the permission mode of HelloWorld.elf to executable.

  2. Stay in the /home/root directory and type ./HelloWorld.elf to run the program via the serial console.

nai_arm_linux_windows_pics/media/image47

Running “Hello World” via the Xilinx SDK

  1. In the Xilinx SDK, with “HelloWorld” selected in the Project Explorer, go to Run→Run Configurations…​

nai_arm_linux_windows_pics/media/image48

  1. In the “Run Configurations” window, double-click “Target Communication Framework”. This will create a new TCF run configuration for the HelloWorld project, called “HelloWorld Debug” by default.

nai_arm_linux_windows_pics/media/image49

  1. With the “HelloWorld Debug” configuration selected, under the “Target” tab, uncheck the check box labelled “Use local host as the target”. Then, in the “Available Targets:” list view, select the row saying “TCF Agent” in the “Name” column and lists the target board’s IP Address in the “Host” column. Then, verify that it says “TCP:<IP Address of target board>:<port number>” in the “Target ID:” text box. In this case, the IP Address is 192.168.1.16, and the port is 1534.

nai_arm_linux_windows_pics/media/image50

  1. Click the “Apply” button.

nai_arm_linux_windows_pics/media/image51

  1. Navigate to the “Application” tab.

nai_arm_linux_windows_pics/media/image52

  1. Fill in the text boxes highlighted in the picture. For the “Project Name:” text box, you can click the “Browse…​” button and select “HelloWorld” from the list of projects. Then, in the “Application” group box, next to the “Local File Path:” text box, you can click the “Search…​” button and select “HelloWorld.elf” from the pop up menu. Then, type “/home/root/HelloWorld.elf” into the “Remote File Path:” field.

nai_arm_linux_windows_pics/media/image53

  1. Click “Apply” to save all the changes you just made, and then click “Run” to run “HelloWorld” using the “HelloWorld Debug” run configuration.

nai_arm_linux_windows_pics/media/image54

Debugging “Hello World” via the Xilinx SDK

The process of Debugging a program via the Xilinx SDK is very similar to the process of Running a program via the Xilinx SDK.

  1. If it has not been done already, copy the HelloWorld.elf executable file from your PC to the /home/root directory of the target board. This can be done via the Xilinx SDK. See step 1 of “file:///C:\Users\apexlab\AppData\Local\Microsoft\Windows\Temporary%20Internet%20Files\Content.IE5\BG0WV69L\Hello_World#Running[Running “Hello World” on the Target Board]” for more details.

  2. If you have not done so already, create a run configuration for the HelloWorld project (see “file:///C:\Users\apexlab\AppData\Local\Microsoft\Windows\Temporary%20Internet%20Files\Content.IE5\BG0WV69L\Hello_World#Running[Running “Hello World” via the Xilinx SDK]”).

Note:

The run configuration you just made for the HelloWorld project can also be used as a debug configuration.

  1. Navigate to Run→Debug Configurations…​

nai_arm_linux_windows_pics/media/image55

  1. In the “Debug Configurations” window, under “Target Communication Framework”, select “HelloWorld Debug” (the run configuration we created). The configuration properties you set up in Running “Hello World” via the Xilinx SDK should still be there.

nai_arm_linux_windows_pics/media/image56

nai_arm_linux_windows_pics/media/image57

  1. Click “Debug” to start debugging the HelloWorld project.

nai_arm_linux_windows_pics/media/image58

Building naibrd_SSK_Linux_ARM_Rev1.60 Library

NAI provides a pre-built library and source code. You can also rebuild the library on your Host PC.

Note

Cross-Compiler and PATH must be configured on Host PC. Refer to Step 18 of subsection Cross-Compiler of section Development Environment Setup for details.

Note

The latest version of Linux Library for ARM Processor SSK can be found at: http://www.naii.com/Downloads.

  1. Copy NAI SSK Library and Sample Application package to Host PC.

  2. Build NAI SSK Library on Host PC to generate a (libnaibrd.so) file as follows:

    1. Import <directory of naibrd_SSK_Linux_ARM_Rev1.60 on host PC>\Libraries\naibrd as a project.

  1. Click File→Import…​

nai_arm_linux_windows_pics/media/image59

  1. On the Import pop-up page, select the option “Existing Code as Makefile Project” under “C/C++” and then click the “Next >” button.

nai_arm_linux_windows_pics/media/image60

  1. Click “Browse…​” and navigate to <directory of naibrd_SSK_Linux_ARM_Rev1.60>\Libraries\naibrd. Once you navigate to this folder and click OK, the text box labelled “Project Name” will fill itself out with the name of the naibrd folder (which is “naibrd”).

  2. Select “Xilinx ARM GNU/Linux Toolchain” under “Toolchain for Indexer Settings”, and then click “Finish”.

nai_arm_linux_windows_pics/media/image61

  1. With naibrd Project selected in the Project Explorer, select Project→Properties→C/C++ Build→Environment, and click the “Add…​” button.

nai_arm_linux_windows_pics/media/image62

nai_arm_linux_windows_pics/media/image63

  1. Enter a new environment variable with Name = NAI_TARGET_BOARD_TYPE and Value = arm, and click “OK” button.

nai_arm_linux_windows_pics/media/image64

  1. Click Apply Button

nai_arm_linux_windows_pics/media/image65

  1. To Clean and Build the naibrd project, right-click on “naibrd” in the Project Explorer and click “Clean Project”. Then, with “naibrd” selected in the Project Explorer, either click the hammer icon at the top of the page or right-click on “naibrd” in the Project Explorer and click “Build Project”.

nai_arm_linux_windows_pics/media/image66

  1. Copy NAI library (libnaibrd.so) from <directory of naibrd_SSK_Linux_ARM_Rev1.60 on host PC>/Libraries/naibrd to <directory of naibrd_SSK_Linux_ARM_Rev1.60 on host PC >/Lib/Linux_ARM.

Copy from here

nai_arm_linux_windows_pics/media/image68

Copy to here

nai_arm_linux_windows_pics/media/image70

Note

NAI sample application MakeFile will link with the library (.so) file in /Lib/Linux_ARM folder. Ensure the latest library file is in that folder.

  1. Build NAI SSK Library on Host PC to generate a (libnaiapp_common.so) file as follows:

    1. Import <directory of naibrd_SSK_Linux_ARM_Rev1.60 on host PC>\AppSrc\naiapp_common as a project.

  1. Click File→Import…​

nai_arm_linux_windows_pics/media/image59

  1. On the Import pop-up page, select the option “Existing Code as Makefile Project” under “C/C++” and then click the “Next >” button.

nai_arm_linux_windows_pics/media/image60

  1. Click “Browse…​” and navigate to <directory of naibrd_SSK_Linux_ARM_Rev1.60>\AppSrc\ naiapp_common. Once you navigate to this folder and click OK, the text box labelled “Project Name” will fill itself out with the name of the naiapp_common folder (which is “naiapp_common”).

  2. Select “Xilinx ARM GNU/Linux Toolchain” under “Toolchain for Indexer Settings”, and then click “Finish”.

nai_arm_linux_windows_pics/media/image71

  1. With naiapp_common Project selected in the Project Explorer, select Project→Properties→C/C++ Build→Environment, and click the “Add…​” button.

nai_arm_linux_windows_pics/media/image72

nai_arm_linux_windows_pics/media/image73

  1. Enter a new environment variable with Name = NAI_TARGET_BOARD_TYPE and Value = arm, and click “OK” button.

nai_arm_linux_windows_pics/media/image74

  1. Click Apply Button

nai_arm_linux_windows_pics/media/image75

  1. To Clean and Build the naiapp_common project, right-click on “naiapp_common” in the Project Explorer and click “Clean Project”. Then, with “naiapp_common” selected in the Project Explorer, either click the hammer icon at the top of the page or right-click on “naiapp_common” in the Project Explorer and click “Build Project”.

nai_arm_linux_windows_pics/media/image76

  1. Copy NAI library (libnaiapp_common.so) from <directory of naibrd_SSK_Linux_ARM_Rev1.60 on host PC>/AppSrc/naiapp_common to <directory of naibrd_SSK_Linux_ARM_Rev1.60 on host PC >/Lib/Linux_ARM.

Copy from here

nai_arm_linux_windows_pics/media/image77

Copy to here

nai_arm_linux_windows_pics/media/image78

Building an NAI Sample Application

NAI provides prebuilt sample applications and source code. You can also rebuild the sample applications on your host PC.

Note

Cross-Compiler and PATH must be configured on Host PC. Refer to Step 18 of subsection Cross-Compiler of section Development Environment Setup for details.

Prerequisite: Pre-built naibrd_SSK_Linux_ARM_Rev1.60 Library including the following:

  • <directory of naibrd_SSK_Linux_ARM_Rev1.60 on host PC>\Lib\Linux_ARM

  • <directory of naibrd_SSK_Linux_ARM_Rev1.60 on host PC>\include

  1. Copy naibrd_SSK_Linux_ARM_Rev1.60 Library and Sample Application package to Host PC.

  2. Import <directory of naibrd_SSK_Linux_ARM_Rev1.60 on host PC>\AppSrc into the Xilinx SDK.

    1. Click File→Import…​

nai_arm_linux_windows_pics/media/image79

  1. On the Import pop-up page, select the option “Existing Code as Makefile Project” under “C/C++” and then click the “Next >” button.

nai_arm_linux_windows_pics/media/image80

  1. Click “Browse…​” and navigate to <directory of naibrd_SSK_Linux_ARM_Rev1.60>\AppSrc. Once you navigate to this folder and click OK, the text box labelled “Project Name” will fill itself out with the name of the AppSrc folder (which is “AppSrc”).

  2. Select “Xilinx ARM GNU/Linux Toolchain” under “Toolchain for Indexer Settings”, and then click “Finish”.

nai_arm_linux_windows_pics/media/image81

  1. With AppSrc Project selected in the Project Explorer, select Project→Properties→C/C++ Build→Environment, and click the “Add…​” button.

nai_arm_linux_windows_pics/media/image82

nai_arm_linux_windows_pics/media/image83

  1. Enter a new environment variable with Name = NAI_TARGET_BOARD_TYPE and Value = arm, and then click “OK”.

nai_arm_linux_windows_pics/media/image84

  1. Hit “Apply” button

nai_arm_linux_windows_pics/media/image85

  1. To Clean and Build the “AppSrc” project, right-click on “AppSrc” in the Project Explorer and click “Clean Project”. Then, with the “AppSrc” project selected in the Project Explorer, either click the hammer icon at the top of the page or right-click on “AppSrc” in the Project Explorer and click “Build Project”.

nai_arm_linux_windows_pics/media/image86

Running NAI Sample Application on Target Board

  1. Copy naibrd_SSK_Linux_ARM_Rev1.60 to host pc if you have not done so already.

  2. Upload the NAI Library (libnaibrd.so) to /usr/lib on the target board from Host PC.

Note

You can do this in the Xilinx SDK. The libnaibrd.so file should be in <directory of naibrd_SSK_Linux_ARM_Rev1.60 on host PC>\Lib\Linux_ARM, and also in <directory of naibrd_SSK_Linux_ARM_Rev1.60 on host PC>\Libraries\naibrd.

  1. Go to the “Remote Systems” tab in the “Remote System Explorer” perspective, right-click “lib” (<IP Address of target board>/Sftp Files/Root///usr/lib), and click “Export From Project…​”.

nai_arm_linux_windows_pics/media/image88

  2. In the “Remote file system” tab, select the “naibrd” folder (but do not check it). Then, within that folder, select “libnaibrd.so” and check the check box next to it. Then, click “Finish nai_arm_linux_windows_pics/media/image89

  1. Upload the NAI Common Library (libnaiapp_common.so) to /usr/lib on the target board from Host PC.

Note

You can do this in the Xilinx SDK. The libnaiapp_common.so file should be in <directory of naibrd_SSK_Linux_ARM_Rev1.60 on host PC>\Lib\Linux_ARM, and also in <directory of naibrd_SSK_Linux_ARM_Rev1.60 on host PC>\AppSrc\naiapp_common.

  1. Go to the “Remote Systems” tab in the “Remote System Explorer” perspective, right-click “lib” (<IP Address of target board>/Sftp Files/Root///usr/lib), and click “Export From Project…​”.

nai_arm_linux_windows_pics/media/image88

  1. In the “Remote file system” tab, select the “naiapp_common” folder (but do not check it). Then, within that folder, select “libnaiapp_common.so” and check the check box next to it. Then, click “Finish”.

nai_arm_linux_windows_pics/media/image91

  1. Choose an executable ELF from <directory of naibrd_SSK_Linux_ARM_Rev1.60 on host PC>\AppSrc and upload it to /home/root/ on the target board.

  1. In the “Remote Systems” tab, right-click “root” (<IP Address of target board>/Sftp Files/Root///home/root) and click “Export From Project…​”

nai_arm_linux_windows_pics/media/image93

  1. In the “Remote file system” window, select “AppSrc” in the left box (but do not check it), and then select and check the check box next to the project you want to run from the board (in this case, “TTL_BasicOps”). Then, click “Finish”.

nai_arm_linux_windows_pics/media/image95

  1. Run the sample application executable ELF file using either the Serial Console or the Xilinx SDK.

Running NAI Sample Application on Target Board Using Serial Console (Tera Term)

  1. Navigate to /home/root/ on the Linux shell terminal. (See picture below Step 3)

# cd /home/root/

  1. Give Execute permission to application: (See picture below Step 3)

# chmod 777 <Sample Application> (e.g. chmod 777 TTL_BasicOps)

  1. Execute program from Linux shell terminal (See picture)

# ./<Sample Application> (e.g. # ./TTL_BasicOps )

nai_arm_linux_windows_pics/media/image96

Running NAI Sample Application on Target Board Using Xilinx SDK

  1. We must create a Run Configuration for the sample program we just copied to the board. With the AppSrc project selected in the Project Explorer, go to Run→Run Configurations…​

nai_arm_linux_windows_pics/media/image97

  1. In the “Run Configurations” window, double-click “Target Communication Framework”. This will create a new Run Configuration for the AppSrc project, called “AppSrc Default” by default.

nai_arm_linux_windows_pics/media/image98

  1. With the “AppSrc Default” configuration selected, under the “Target” tab, uncheck the check box labelled “Use local host as the target”. Then, in the “Available Targets:” list view, select the selection that says “TCF Agent” in the “Name” column and lists the target board’s IP Address in the “Host” column. Then, verify that it says “TCP:<IP Address of target board>:<port number>” in the “Target ID:” text box. In this case, the IP Address is 192.168.1.16, and the port is 1534.

nai_arm_linux_windows_pics/media/image99

  1. Click the “Apply” button.

nai_arm_linux_windows_pics/media/image100

  1. Navigate to the “Application” tab.

nai_arm_linux_windows_pics/media/image101

  1. Fill in the text boxes highlighted in the picture. For the “Project Name:” text box, you can click the “Browse…​” button and select “AppSrc” from the list of projects. Then, in the “Application” group box, next to the “Local File Path:” text box, you can click the “Search…​” button and select the sample application you want to run from the pop up menu (in this case, TTL_BasicOps). Then, type “/home/root/<name of sample application you want to run>” into the “Remote File Path:” field.

nai_arm_linux_windows_pics/media/image102

  1. In the Serial Console (Tera Term), navigate to the /home/root directory of the target board and type “chmod 777 <name of sample application in /home/root to run>” (ex. chmod 777 TTL_BasicOps) to give the sample application permission to run.

nai_arm_linux_windows_pics/media/image103

  1. Click “Apply” to save all the changes you just made, and then click “Run” to run the program on the target board using the SDK.

nai_arm_linux_windows_pics/media/image104

Debugging NAI Sample Application on Target Board Using Xilinx SDK

The process of Debugging a program via the Xilinx SDK is very similar to the process of Running a program via the Xilinx SDK.

  1. If it has not been done already, copy the naibrd library and naiapp library .so files (libnaibrd.so & libnaiapp_common.so) from your PC to the /usr/lib directory of the target board. This can be done via the Xilinx SDK. See step 2 of “Running NAI Sample Application on Target Board” for more details.

  2. If it has not been done already, copy the sample program executable ELF file you want to run on the board from your PC to the /home/root directory of the target board. This can be done via the Xilinx SDK. See step 3 of “Running NAI Sample Application on Target Board” for more details.

  3. If you have not done so already, create a run configuration for the sample application you want to run on the board, and use the serial console to get permission to run the sample application executable file you copied from your PC to the /home/root directory of the target board (see ”Running NAI Sample Application on Target Board Using Xilinx SDK”).

Note:

The run configuration you just made for the HelloWorld project can also be used as a debug configuration.

  1. With “AppSrc” selected in the Project Explorer, navigate to Run→Debug Configurations…​

nai_arm_linux_windows_pics/media/image105

  1. In the “Debug Configurations” window, under “Target Communication Framework”, select “AppSrc Default” (the run configuration we created). The configuration properties you set for “AppSrc Default” in “Running NAI Sample Application on Target Board Using Xilinx SDK” should still be there.

nai_arm_linux_windows_pics/media/image106

nai_arm_linux_windows_pics/media/image107

  1. Click “Debug” to start debugging the sample application.

nai_arm_linux_windows_pics/media/image108

NAI Cares

North Atlantic Industries (NAI) is a leading independent supplier of Embedded I/O Boards, Single Board Computers, Rugged Power Supplies, Embedded Systems and Motion Simulation and Measurement Instruments for the Military, Aerospace and Industrial Industries. We accelerate our clients' time-to-mission with a unique approach based on a Custom-on-Standard Architecture™ (COSA™) that delivers the best of both worlds: custom solutions from standard COTS components.

We have built a reputation by listening to our customers, understanding their needs, and designing, testing and delivering board and system-level products for their most demanding air, land and sea requirements. If you are experiencing any problems with our products, we urge you to contact us as soon as possible.

Please visit us at: www.naii.com or select one of the following for immediate assistance:

FAQ

http://www.naii.com/faq/

Application Notes

http://www.naii.com/appNotes/

Calibration and Repairs

http://www.naii.com/calibration/

Call Us

(631) 567-1100

nai_arm_linux_windows_pics/media/image109

© 2015 North Atlantic Industries, Inc. All rights reserved. All other brands or names are property of their respective holders.

This document has been produced for the customers of North Atlantic Industries, Inc. (NAI) with the intent and purpose of providing specific product operation information for systems integration. Unauthorized use or intent is prohibited without written permission from NAI. NAI reserves the right to revise this document to include product updates, corrections, and clarifications and may not conform in every aspect to former issues. The information provided in this document is believed to be accurate and is provided “as is” with no representations or warranties of any kind whether expressed or implied, including, but not limited to, warranties of design, merchantability or fitness for a particular purpose.  North Atlantic Industries does not assume any responsibility for its use and shall not be responsible for any liability resulting from reliance upon any information contained herein.  No licenses or rights are granted by implication or otherwise in connection therewith.

Help Bot

X