Head to the Xilinx website archive section.

Click the 2018.2 tab to expand it (2017.2 for Zynq).

Select the All OS installer to begin download, then run the installer. The tool that will be used for development is Xilinx SDK 2018.2 (2017.2 for Zynq), which is included in the Vivado Design Suite installation.

Head to the Xilinx website archive section.

Click the 2023.2 tab to expand it.

Select the Windows Self Extracting Web Installer to begin download, then run the installer. The tool that will be used for development is Vitis Classic 2023.2, which is included in the Xilinx unified installation.

Open the root folder of the SSK in the terminal.

Run the following command with the necessary flags to generate the build folder in the specified location:
cmake [flags] -B [build_folder] --toolchain ./cmake/linux-x86-64.cmake
          a. To generate a Release or Debug build, add the flag:
               -DCMAKE_BUILD_TYPE=[Release|Debug]
          b. To generate shared object (.so) or archive (.a) libraries, add the flag:
               -DBUILD_SHARED_LIBS=[ON|OFF]

Run the following command to compile the build:
cmake --build [build_folder] -j

All compiled binaries and libraries will be found in [build_folder]/bin and [build_folder]/lib, respectively.

Run cd ~/nai/ssk/ to navigate to the root folder of the SSK.

To generate the build folder “build_debug_a” for a static, debug build, use the command:
cmake -DBUILD_SHARED_LIBS=OFF -DCMAKE_BUILD_TYPE=Debug -B build_debug_a --toolchain ./cmake/linux-x86-64.cmake

To compile this configuration, run the command:
cmake --build build_debug_a -j

All compiled binaries and libraries will be found in build_debug_a/bin and build_debug_a/lib, respectively.
          a. Truncated outputs of ls -l build_debug_a/bin and ls -l build_debug_a/lib

Run Xilinx SDK 2018.2 and select the following folder from the NAI library package as your workspace:

If there are already projects when you load the workspace, select them all, right click, and Delete them. Do NOT select "Delete project contents on disk".

Import NAI projects by selecting File→Import→Existing Projects into Workspace from the Xilinx SDK toolbar:

Select Next and then select the workspace directory as the root directory:

Select finish to add NAI libraries and sample code projects to the workspace.

Navigate to Project at the top of Xilinx and make sure Build automatically is unchecked.

Select Window→Preferences from the Xilinx toolbar and set the Indexer to "Use active build configuration" and select OK.

Select all of the projects, right click, click Build Configurations, Set Active, Debug-UltraScale/Zynq- (pick the configuration (Zynq/UltraScale) and the board you have, ex. NIU3A).

Select all of the library projects (nai_bsp projects, nai_libs projects, naiapp_common) and right click Clean Project then right click Build Project.

Select a module sample project to Clean then Build which will generate an elf executable that can be run on the processor board.

Navigate to File→New→Application Project to get to the New Project wizard and select Xilinx→Application Project.

Provide a name for the project, select linux as the OS Platform and select psu_cortexa53 as the processor type. Language should default to C and Compiler should default to 64-bit. Press next when complete.

Select the type of application template you’d like to start with and click Finish when complete.

A project with the name entered will appear in the project explorer, right click the project and build to generate the executable ELF file.

If you wish to create projects from scratch (starting from a blank slate, creating projects, and linking the source code manually) then navigate to File→Switch Workpsace and set the path to 'SSK_Template_FromScratch/Template-petalinux-2018-2/petalinux-appsrc'.

Navigate to File→New…​→Project. Select Library Project under the Xilinx dropdown.

Create a project named nai_bsp-naibsp. Uncheck 'Use default location' and change the location to 'SSK_Template_FromScratch/Template-petalinux-2018-2\petalinux-appsrc\nai_bsp\naibsp'. Select the settings as shown in the screenshot and click Finish when done.

Click the arrow to expand the project, then right click on the src folder and click Delete. Press OK after it asks to confirm the deletion.

Right click the project and click Build Configurations→Manage…​

Click New…​

Add Debug-UltraScale-68ARM2 as the Name with the Existing configuration based on Debug then press OK.

Click on this new configuration and click Set Active.

Right click on the project and select 'Properties'. Now, select 'Path and Symbols' and select the 'Includes' page. Click Add…​ and add the following directories. Press OK when done. If the program asks to rebuild then say no.

Right-click on the project and select New→Folder.

Click Advanced to show more options then click 'Link to alternate location (Linked Folder)'. Write WORKSPACE_LOC\..\..\base\nai_bsp\naibsp as the folder location. Click Finish.

Add another folder with New→Folder. For the path write WORKSPACE_LOC\..\..\base\nai_bsp\naibsp_config_68arm2_petalinux as the folder location. Click Finish.

Right click the project to Clean Project and then Build Project. The project should build and the progress will be displayed in the 'Console' tab. When finished, there will be a newly created 'Debug-Zynq/UltraScale-XXXXXX' folder with an archive file (static library) named 'libnai_bsp-naibsp.a'.

Navigate to File→New→Application Project to get to the New Project wizard and select Xilinx→Application Project, then click Next.

Set the project name; in this example, we use naiapp_mod_ad_basic_ops.

Uncheck the use default location check box, and set the location to C:\SSK_Template_FromScratch\Template-petalinux-2018-2\petalinux-appsrc\nai_sample_apps\naiapp_src\board_modules\ad\ad_basic_ops

Change the OS Platform to linux and select psu_cortexa53 as the processor type. Language should default to C and Compiler should default to 64-bit. Press Next when complete.

Under "Available Templates", select the Linux Empty Application and click the Finish button.

The project "naiapp_mod_ad_basic_ops" should now be added to the Workspace and listed under the Project Explorer. Expand the "naiapp_mod_ad_basic_ops" project and "src" folder and right click the readme.txt file. Select Delete to remove the readme.txt file from the project. Press OK on the confirmation prompt.

Right click on the "naiapp_mod_ad_basic_ops" folder and select properties. Select C/C++ General Paths and Symbols and click the Manage Configurations button.

Click the New button to create a new Configuration.

Enter the name as "Debug-UltraScale-68ARM2" or "Debug-Zynq-68ARM2" with the Existing configuration set to Debug and click the OK button. Replace 68ARM2 with the board you want to use.

Select Debug-Zynq/UltraScale-XXXXX and click on the Set Active button to make it the active configuration and click OK to close the window.

In the Configuration drop down box, select the Debug-Zynq/UltraScale-XXXXX configuration if it’s not already selected.

If not already in the Properties window, right click the project and click Properties→C/C++ General→Paths and Symbols. Under the includes tab, add the following paths:

Under the Libraries tab click Add…​ and add the following (ORDER MATTERS):

Under the Library Paths tab click Add…​, add the following and check "Is a workspace path" (ORDER MATTERS):

Click OK on the Properties window to save the settings.

In the Project Explorer, right click on the "naiapp_mod_ad_basic_ops" project and select Build Configurations→Set Active→Debug-Zynq/UltraScale-XXXXX.

To add the source file to the project, right click on the "src" folder inside the "naiapp_mod_ad_basic_ops" project folder, and select New File. Click the Advanced button followed by the Link to file in the file system check box.

Click the browse button and add the file path SSK_Template_FromScratch\base\nai_sample_apps\naiapp_src\board_modules\ad\ad_basic_ops\src\ad_basic_ops.c. Change the path to WORKSPACE_LOC\..\..\base\nai_sample_apps\naiapp_src\board_modules\ad\ad_basic_ops\src\ad_basic_ops.c if you want the path to be relative to the workspace location. Click the finish button to add the file to the project.

The project is now ready to build by right clicking the project and clicking Clean Project then right clicking and clicking Build Project. Once the build completes, an naiapp_mod_ad_basic_ops.elf file will be created in the Debug-UltraScale folder.

Run Vitis Classic 2023.2 and select the following folder from the NAI library package as your workspace:

If there are already projects when you load the workspace, select them all, right click, and select "Delete". Do NOT select "Delete project contents on disk".

Navigate to “Window”→”Preferences”. In the Preferences window, navigate to the “Additional”→”C/C++”→"Build"→“Environment” tab.

Create an environment variable named “BOARD” and set the value to the name of the board configuration you wish to build for (e.g. “CIU3”, “NIU3C”, etc.). Then select “Apply and Close”.

Import NAI projects by selecting “File” → “Import” → “Eclipse workspace or zip file” from the toolbar:

Select "Next" and then select the workspace directory as the root directory:

Select "Finish" to add NAI libraries and sample code projects to the workspace.

Select "Window"→"Preferences" from the Vitis toolbar and set the Indexer to "Use active build configuration" and select "OK".

Select "Window"→"Open Perspective" in the Vitis toolbar, and select "C/C++".

Select the projects that you wish to build, right click, click "Build Configurations"→"Set Active"→"Debug/Release" depending on the desired build type.

Select all the library projects (nai_bsp projects, nai_libs projects, naiapp_common), right click, and select "Clean Project". Then right click and select "Build Project".

Select a module sample project to Clean then Build which will generate an elf executable that can be run on the processor board.

Navigate to "File"→"New"→"Other" to get to the New Project wizard and select "C/C++"→"C Project".

Provide a name for the project, select "Vitis ARM v8 Linux Executable" under "Project type:" and "Vitis ARM v8 GNU/Linux/Toolchain" under "Toolchains". Then click "Finish" when complete.

A project with the name entered will appear in the project explorer, right click the project and select New→New Folder. Create a folder named "src" in the resulting window.

Right click the newly created folder, which should appear under the "helloworld" project. Select New→Source File. In the resulting window, select "Default C source template" and name the file "main.c".

Open the newly created source file from the project explorer. Inside the source file, add the following lines of code:

Right click the project and select build to generate the executable ELF file.

If not done already, set an environment variable named BOARD to the name of the desired board configuration. Navigate to “Window”→”Preferences”. In the Preferences window, navigate to the “Additional”→”C/C++”→"Build"→“Environment” tab.

Create an environment variable named “BOARD” and set the value to the name of the board configuration you wish to build for (e.g. “CIU3”, “NIU3C”, etc.). Then select “Apply and Close”.

Navigate to File→New…​→Other. Select C Project under the C/C++ dropdown.

Select Vitis ARM v8 Linux Executable under Project type. Name the project "nai_bsp-naibsp". Uncheck 'Use default location' and change the location to 'SSK_Template_FromScratch/Template-petalinux-2023-2\petalinux-appsrc\nai_bsp\naibsp'. Select the settings as shown in the screenshot and click Finish.

Your workspace in the IDE should now have a project named "nai_bsp-naibsp".

Right click on the project and select 'Properties'. Now, select 'Paths and Symbols' and select the 'Includes' page. Click Add…​ and add the following directories. Press OK when done. If the program asks to rebuild then say no.

Right click on the project and select New→Folder.

Click Advanced to show more options then click "Link to alternate location (Linked Folder)". Write "WORKSPACE_LOC\..\..\base\nai_bsp\naibsp" as the folder location. Click Finish.

Right click the project to Clean Project and then Build Project. The project should build, and the progress will be displayed in the 'Console' tab. When finished, there will be a newly created 'Debug' folder with an archive (static library) named 'libnai_bsp-naibsp.a'.

Navigate to File→New→Other to get to the New Project wizard and select C/C++→C Project, then click Next.

Set the project name. In this example we use "naiapp_mod_ad_basic_ops".

Uncheck the "use default location" check box, and set the location to C:\SSK_Template_FromScratch\Template-petalinux-2023-2\petalinux-appsrc\nai_sample_apps\naiapp_src\board_modules\ad\ad_basic_ops.

Under "Project type", select "Vitis ARM v8 Linux Executable" and under "Toolchains", select "Vitis ARM v8 GNU/Linux Toolchain". Press "Finish" when complete.

Right click the project and click "Properties"→"C/C++ General"→"Paths and Symbols". Under the "Includes" tab, add the following paths:

Under the "Libraries" tab click "Add…​" and add the following (ORDER MATTERS):

Under the "Library Paths" tab click "Add…​", then check "Is a workspace path", and add the following (ORDER MATTERS):

Click "Apply" on the "Properties" window to save the settings.

In the Project Explorer, right click on the "naiapp_mod_ad_basic_ops" project and select "Build Configurations"→"Set Active"→"Debug".

To add the source files to the project, right click on the "naiapp_mod_ad_basic_ops" project folder and select "New"→"Folder". Click the "Advanced" button followed by the "Link to alternate location (Linked Folder)" check box.

Click the browse button and add the following folder path:

Click the "Finish" button to add the file to the project.

Select "New Folder" again, and once again select "Advanced", followed by "Link to alternate location (Linked Folder)", and add the following foler path:

Click the "Finish" button to add the file to the project.

The project is now ready to build. Right click the project and click Clean Project. Then right click the project again and select Build Project. Once the build is complete, a file named "naiapp_mod_ad_basic_ops.elf" will be created under the Debug folder.

Go to the "Remote System Explorer" perspective in the top right. If you don’t have this then in the top tab click "Window"→"Perspective"→"Open Perspective"→"Other" and double click "Remote System Explorer".

Right click the blank area and click "New"→"Connection…​". There are several modes of connection. In this case, "SSH Only" with the IP address of the board is being used.

Navigate to Root/home/root. Enter the username "root" and the password "root". Right click the root and click "Export from Project".

In the "Remote file system" page, navigate to the sample app you want. On the left side click the dropdown arrow to expand it, then click the "Debug" folder. Then on the right, check the .elf file. When you are done, click Finish.

Run the sample app on Teraterm to make sure the app is working and to give execute permissions to it. You can also just use Teraterm as a simple way to use the program.

Navigate to /home/root/ on the terminal:

# cd /home/root/

Give Execute permission to the application:

# chmod 777 <Sample Application>

Execute program from Linux shell terminal:

# ./<Sample Application>

In Vitis with the sample app selected in the "Project Explorer", navigate to "Debug As"→"Debug Configurations…​".

In the "Debug Configurations" window, double click "Target Communication Framework", select the new configuration, uncheck "Use local host as the target", click on the TCF Agent and click Apply.

Navigate to the "Application" tab. The local file path should be entered as "Debug/<sample_app>.elf". The remote file path should be filled in as "home/root/<sample_app.elf>". Click Debug when finished.

Launch OpenArbor

Select the deos/deos_kismet/nai-ultrascale directory in the location of the SSK

Go to the platform project nai-ultrascale and navigate to Deos Component -> Dependencies. Right-click and select Add Dependency

Select the application you would like to integrate with the nai-ultrascale BSP

Build all projects

In the Target Manager add a connection for the nai-ultrascale platform project

Launch the Status Monitor or the Video Stream

Right-click the Status Monitor or Video Stream and click Update Target Load. Make sure End up in registry is set to platreg if that is where application dependency is. Make sure Force Cold Start is checked

Change the IP address in u-boot via the ipaddr environment variable. Make sure to save the environment via the saveenv command:

setenv ipaddr 192.168.1.16
setenv serverip 192.168.1.100
saveenv

Navigate to the platform project nai-ultrascale -> config -> lwip.config

Change the IP address on the following line:

interface=xilinx-gem:0 192.168.1.16 255.255.255.0

Open OpenArbor and build all NAI libraries

Open a Windows PowerShell instance and run the script named release-me.ps1 with the following arguments

./release-me.ps1 -copyBinaries:$true

In OpenArbor navigate to Window -> Preferences -> DDC-I -> Deos Search Path

Click 'Add'. Change Preference Scope to This Workspace Only and browse to the path that the Power Shell script created: /SSK/deos/deos_kismet/$NAI_Board_Name/built-binaries/desk

Hit OK