Lab2: ZC702_AXIS_IO Platform
In Lab #1, you created a basic ZC702 platform with Linux, Standalone, and FreeRTOS OSes. The lab discussed how to use the SDSoC Platform Utility GUI to configure the platform, save the configuration, and generate the platform. In this tutorial you will create thezc702_axis_io
platform using the platform utility. SeeExample: Direct I/O in an SDSoC Platformfor a more detailed discussion of this platform.
Thezc702_axis_io
platform has a platform-specific include header, and a library that must be linked. It also contains a few sample applications. To begin this exercise, you will make the static library file for the platform.
- Launch an SDx Terminal window:
- From Windows, choose .
- From Linux, source thesettings.sh/cshfile as appropriate for the shell type you’re using.
- From this terminal window you will need to navigate to the include folder for the
zc702_axis_io
platform, andmake
the static library (.a) file for both the Linux and Standalone operating systems:cd
/zc702_axis_io/src/srccd linux make cd ../standalone make cd C:/
With the static library file made, you can now use the SDx Terminal window to define thezc702_axis_io
platform configuration file and generate the platform.
- Launch the SDSoC Platform Utility GUI from the SDx Terminal:
Important:The SDSoC Platform Utility should be launched from the C:/ directory on the Windows OS, or an equivalent root directory, to avoid path name length limitations that can cause problems when generating the platform files on Windows.
- In your terminal or shell type
sdspfm -gui
to launch the GUI.
- In your terminal or shell type
- After the SDSoC Platform Utility GUI opens, enter the following info for the base platform information to match the following figure.
Figure:Specify Hardware Platform
- Platform Name: zc702_axis_io
- Choose an appropriateOutput Directoryfor your system.
- TheVivado ProjectandPlatform Tclfiles can be found in the
/zc702_axis_io/src/vivadodirectory. - Samples Directory:
/zc702_axis_io/src/samples
- Click theAddbutton in the Processor Information pane to add the A9 processor to the platform configuration.
Tip:Only one processor of each type is required for the platform configuration, although your platform will still be able to use all cores.
- In the Boot Information pane you will configure the Linux OS first, but the order you configure OSes is not important.
Figure:Linux Boot Information
- Click theAddbutton in the Boot Information panel to add a new configuration.
- Config ID:
a9_linux
, although this can be any name you want. - OS Type:
Linux
, selected from the drop down menu. - Config Name: This name is automatically generated, but can be edited as needed.
- BIF File:
/zc702_axis_io/src/linux/linux.bif - Readme File:
/zc702_axis_io/src/generic.readme - Boot Directory:
/zc702_axis_io/src/boot - Image Directory:
/zc702_axis_io/src/linux/image
- Add and configure Standalone OS to the platform using the following settings:
Figure:Standalone Configuration
- Click theAddbutton in the Boot Information panel to add a new configuration.
- Config ID:
a9_standalone
. - OS Type:
Standalone
, selected from the drop down menu. - Config Name: Change this name to
Standalone Config 1
. - BIF File:
/zc702_axis_io/src/standalone/standalone.bif - Readme File:
/zc702_axis_io/src/generic.readme - Boot Directory:
/zc702_axis_io/src/boot - Linker Script:
/zc702_axis_io/src/standalone/lscript.ld
- UnderSupported OSes, select the Linux OS,
a9_linux
and configure the Include Paths and Libraries for this configuration:- On theInclude Pathstab, specify the include path as
/zc702_axis_io/src/src/incand clickAddto add it to the list. - On theLibrariestab, in theLibrary Pathfield select the
/zc702_axis_io/src/src/linux/libzc702_axis_io.afile and clickAddto add it to the list.
Figure:Include Paths and Libraries
- On theInclude Pathstab, specify the include path as
- Select the Standalone OS,
a9_standalone
and configure the Include Paths and Libraries for this configuration:- On theInclude Pathstab, specify the include path as
/zc702_axis_io/src/src/incand clickAddto add it to the list. - On theLibrariestab, in theLibrary Pathfield select the
/zc702_axis_io/src/src/standalone/libzc702_axis_io.afile and clickAddto add it to the list.
- On theInclude Pathstab, specify the include path as
- Save the configuration file using the command, and specify a name and location for the platform configuration file.
- Click theGeneratebutton to create your platform. You can see progress updates in the SDx Terminal from where you launched the GUI as your platform is created. When your platform is finished generating, you’ll see a popup message in the GUI with the output from the SDx Terminal if there are any error messages. ClickOkto close this message.
- Exit the SDSoC Platform Utility by using the command.