Doc:latest/sdkguide/build - Revision history

Stone: /* Pre-building SAFplus Platform Libraries for a Given Target Platform */

2013-06-28T18:27:02Z

‎Pre-building SAFplus Platform Libraries for a Given Target Platform

Stone: /* Configuring and Building the Model */

2013-06-28T18:26:29Z

‎Configuring and Building the Model

Stone: /* Creating a Project Area */

2013-06-28T18:13:07Z

‎Creating a Project Area

Stone: /* Building SAFplus Platform and SAFplus-based Systems */

2013-06-28T18:12:28Z

‎Building SAFplus Platform and SAFplus-based Systems

Stone: /* Pre-building SAFplus Platform Libraries for a Given Target Platform */

2013-06-28T18:11:02Z

‎Pre-building SAFplus Platform Libraries for a Given Target Platform

Stone at 17:56, 28 June 2013

2013-06-28T17:56:42Z

Bot: 1 revision

2011-10-24T19:04:56Z

1 revision

Senthilk at 03:54, 27 August 2010

2010-08-27T03:54:58Z

New page

==Building SAFplus Platform and SAFplus-based Systems==

This chapter covers new features that are related to building SAFplus Platform and SAFplus-based systems. Key new features include:

#SAFplus Platform and model tree separation
#Pre-built SAFplus Platform library support
#Multi-target build support
#Integration with WindRiver Workbench SDK

Note: In the context of this chapter, a target platform is any blade type or architecture that OpenClovis SAFplus Platform can be built for (e.g. WindRiver PNE-LE 1.4 on dual Xeon-based Intel MPCBL0001 blades, or Yellow Dog Linux on PowerPC based blades). OpenClovis provides a variety of cross build toolchains that can optionally be used with the SDK to build SAFplus Platform for these targets.

Working with the OpenClovis SDK involves the following steps:

#Installing the SDK, which is covered in ''OpenClovis Installation Guide''
#Optionally preparing the SDK for use with the WindRiver Workbench development tools
#Optionally pre-building SAFplus Platform libraries for a given target platform.
#Creating a project area (optionally populated with one or more existing SAFplus Platform models)
#Using the OpenClovis IDE to create a new SAFplus Platform model, generate its code, and modify this code to create desired functionality. This part is covered in ''OpenClovis IDE User Guide''
#Configuring and building the desired model for one or more target platform

===Using OpenClovis SDK with the WindRiver Workbench===

It is possible to use OpenClovis SDK with the WindRiver Workbench development tools. This section describes an optional step that creates a 'virtual' toolchain that allows SAFplus Platform to be built using the WindRiver Workbench development tools for a given WindRiver board support package. This also builds the 3rd party prerequisites using the Workbench tools so that they may be deployed on the specific platform. It requires both WindRiver Workbench (for the development tools) as well as a WindRiver board support package for a specific target platform. Platform specific HPI libraries from Pigeon Point Systems and RadiSys can optionally be built into the virtual toolchains using packages supplied by either vendor. It is possible to create as many virtual toolchains as necessary for a variety of platforms.

This is done by using the cl-create-wrs-toolchain utility (as root, if OpenClovis SDK was installed as root, or as a normal user if not):

# cl-create-wrs-toolchain -w <WindRiver Workbench install dir> \
-b <bsp name> \
[ -l <libhcl_tarball> ] \
[ -p <pps_openhpi_tarball> ] \
<toolchain_name>

The <code>-l</code> option accepts the full path to a RadiSys-provided libhcl package tarball. If specified, it will be built in to the virtual toolchain.
The <code>-p</code> option accepts the full path to a Pigeon Point Systems-provided OpenHPI package tarball. If specified, it will be built into the virtual toolchain instead of the stock OpenHPI package from the OpenClovis-provided 3rd party package tarball.

e.g.:

# cl-create-wrs-toolchain -w /opt/WindRiver \
-b intel_mpcbl0001 wrs_mpcbl0001

This will create a toolchain called <code>wrs_mpcbl0001</code> in your existing SDK buildtools directory that is built using the WindRiver installation at <code>/opt/WindRiver</code> for the <code>intel_mpcbl0001</code> board support package. This toolchain will be visible when using <code>configure --help</code>, as will be noted in a following section.

Note: The virtual toolchain requires the WindRiver Workbench installation to be available when it is used, as it merely provides references to the development tools in the Workbench installation. Should the installation be moved or replaced, the virtual toolchain would need to be built again.

===Pre-building SAFplus Platform Libraries for a Given Target Platform===

This is an optional step that pre-builds SAFplus Platform libraries for use with a given platform (i.e. using a specific toolchain). With these in place, it is no longer necessary to rebuild SAFplus Platform every time in order to build an SAFplus Platform model. (For the purpose of this document, we assume that the SDK is installed at <code>/opt/clovis</code>, by root. Consequently, example steps will be run as root. If the SDK is installed as a normal user at a location available to him, these steps can be run as the normal user itself.)

We first create a special project area for the SAFplus Platform library build, and change to it:

# mkdir asp_build
# cd asp_build

This project area is then initialized with the configure script as:

# /opt/clovis/sdk-3.0/src/SAFplus/configure --with-asp-build \
[--with-cross-build=<toolchain>] \
[--prefix=<alternate SAFplus Platform libs installation dir>]

By default, the libraries will ultimately be installed to the SDK installation directory, in this case: <code>/opt/clovis/sdk-3.0/target/<arch>/<kernel>/lib</code>, and header files will be available at <code>/opt/clovis/sdk-3.0/include</code>.

If --with-cross-build=<toolchain> is unspecified, libraries will be built for the local system.

If --prefix=<prefix> is specified, libraries will be installed to <code><prefix>/<arch>/<kernel>/lib</code>, and header files to <code><prefix>/include</code>

For example:

# /opt/clovis/sdk-3.0/src/SAFplus/configure --with-asp-build \
--with-cross-build=i586-wrl-pnele1.4-2.6.14_mpcbl0001

will cause libraries to be built from the i586-wrl-pnele1.4-2.6.14_mpcbl0001 toolchain and installed to <code>/opt/clovis/sdk-3.0/target/i386/linux-2.6.14/lib</code>, with header files populated at <code>/opt/clovis/sdk-3.0/include</code>, and

# /opt/clovis/sdk-3.0/src/SAFplus/configure --with-asp-build \
--prefix=/opt/asplib

on an Ubuntu 7.04 (feisty fawn) system will cause libraries to be installed to <code>/opt/asplib/i686/linux-2.6.20/lib</code>, and header files to be populated at <code>/opt/asplib/include</code>.

The following steps build and install the libraries as configured above:

# make asp-libs
# make asp-install

===Creating a Project Area===

A new project area with no model code is created by running the <code>cl-create-project-area</code> command:
<code><pre>
$ <install_dir>/sdk-3.0/bin/cl-create-project-area project_area
</pre></code>

This project area is ready for use with OpenClovis IDE to generate model code that will be built in a following step.

Existing models (from model-specific branches) can be copied over into a project area, and re-running <code>configure</code> using <code>--with-model-name</code> with any copied models will configure them for building.

A typical project area is laid out as:

project_area
+- ide_workspace
+- model_1
+- model_2
+- model_1
+- src/
+- target.conf
+- build/
+- target/
+- model_2
+- src/
+- target.conf
+- build/
+- target/

Note: The <code>configure</code> script does not copy models into the project area. The old behavior of copying models out from SAFplus/models is no longer required. The sample evaluation model that was at <code><install_dir>/sdk-3.0/src/SAFplus/models</code> has been moved to its own <code>examples</code> project area adjacent to the SAFplus Platform tree, at <code><install_dir>/sdk-3.0/src/examples</code>. To use it, one would change to the <code>examples</code> directory and issue a <code><path-to>/configure --with-model-name=eval</code>. Alternately, if the <code>examples</code> project area is in a non-user-writeable location (e.g. in the case of a root-installed SDK), it can be copied out to a user-writeable location and used there instead in the same manner.

===Configuring and Building the Model===

In this section, we will configure and build the <model> model in an existing project area.
<ol>
<li>Configure the <model> model for building by running the following:
<code><pre>
$ cd <project_area>
$ <install_dir>/sdk-3.0/src/SAFplus/configure --with-model-name=<model> \
--with-asp-build
</pre></code>

This will configure the <model> model for deployment on the local machine. In order to crossbuild this model for deployment on a non-native target supported by the <crossbuild> toolchain, run:
<code><pre>
$ <install_dir>/sdk-3.0/src/SAFplus/configure --with-model-name=<model> \
--with-asp-build \
--with-cross-build=<crossbuild>
</pre></code>

It is possible to configure the model to be built for multiple targets by issuing as many <code>configure</code> commands as necessary. Each run sets up a target-specific build location at <code><project_area>/<model>/build</code>.

If this model is to be deployed on an ATCA-based system with OpenHPI-based shelf management, enable Chassis Manager with:
<code><pre>
$ <install_dir>/sdk-3.0/src/SAFplus/configure --with-model-name=<model> \
--with-asp-build \
--with-cross-build=<crossbuild> \
--with-cm-build=openhpi
</pre></code>
[[File:OpenClovis_Note.png]] '''Using Chassis Manager requires OpenClovis Platform Support Package, distributed separately from OpenClovis SDK.'''

For a complete list of options to <code>configure</code>, including a list of available crossbuild toolchains, run:
<code><pre>
$ <install_dir>/sdk-3.0/src/SAFplus/configure --help
</pre></code>

If the necessary crossbuild toolchain does not exist, then you must install it by downloading it adjacent to the OpenClovis SDK installer and re-running <i>install.sh</i>.

The configure step prepares the project area to build the <model> model, with the following directory structure:
<code><pre>
<project_area>
|ide_workspace
|+<model>
|+build
| |+local
| | |-Makefile
| |+<crossbuild>
| | |-Makefile
|+src
| |+app
| |+config
| |+doc
| |-target.conf
|+target
|-Makefile
</pre></code>

<li>Build the configured model by issuing <code>make</code> in <code><project_area>/<model></code>:
<code><pre>
$ make
</pre></code>

This will build the <model> model for all the targets it has been configured to build. In order to do a target-specific build, issue <code>make</code> from the target-specific build location. <i>e.g.</i> for a local build:
<code><pre>
$ cd <project_area>/<model>/build/local
$ make
</pre></code>
For a target supported by the <crossbuild> toolchain:
<code><pre>
$ cd <project_area>/<model>/build/<crossbuild>
$ make
</pre></code>

For a complete list of options to <code>make</code>, run:
<code><pre>
$ make help
</pre></code>

The model source is located at <code><project_area>/<model>/src</code>. If any changes are made to this, rebuild the model by issuing another <code>make</code> from either the target-specific build location or the model directory.
</ol>

[[File:OpenClovis_Note.png]] Model building can also be accomplished in IDE. For more information, see ''OpenClovis IDE User Guide''.

@@ Line 30: / Line 30: @@
 Next, this prebuild project area should be initialized with the configure script as:
-  # /opt/clovis/<SAFplus version>/src/SAFplus/configure --with-asp-build [--with-sdk-dir=</opt/clovis>] [--with-cross-build=<toolchain>] [--prefix=<alternate SAFplus Platform libs installation dir>]
+  # /opt/clovis/<SAFplus version>/src/SAFplus/configure --with-asp-build \
 Run ".../configure --help" to see extensive help describing all the available options.

@@ Line 59: / Line 59: @@
 ===Configuring and Building the Model===
-In this section, we will configure and build the <model> model in an existing project area.
+In this section, we will configure and build the <model> model.  To begin, "cd" to the directory just above the model's directory.  This directory is called your "project area", and is often named "workspace" or "ide_workspace" by the OpenClovis IDE.
-<ol>
-<li>Configure the <model> model for building by running the following:
+Configure the <model> model for building by running the following:
 <code><pre>
 $ cd <project_area>
-$ <install_dir>/sdk-3.0/src/SAFplus/configure --with-model-name=<model> \
+$ <install_dir>/sdk-6.0/src/SAFplus/configure --with-model-name=<model> \
                                            --with-asp-build
 </pre></code>
-This will configure the <model> model for deployment on the local machine.  In order to crossbuild this model for deployment on a non-native target supported by the <crossbuild> toolchain, run:
+This will configure the <model> model for deployment on the local machine, linking with the "prebuilt" SAFplus libraries (built during installation).
 <code><pre>
-$ <install_dir>/sdk-3.0/src/SAFplus/configure --with-model-name=<model> \
+$ <install_dir>/sdk-6.0/src/SAFplus/configure --with-model-name=<model> \
                                            --with-asp-build \
-                                           --with-cross-build=<crossbuild>
+                                           --with-cross-build=<toolchain name>
 </pre></code>
@@ Line 79: / Line 87: @@
 If this model is to be deployed on an ATCA-based system with OpenHPI-based shelf management, enable Chassis Manager with:
 <code><pre>
-$ <install_dir>/sdk-3.0/src/SAFplus/configure --with-model-name=<model> \
+$ <install_dir>/sdk-6.0/src/SAFplus/configure --with-model-name=<model> \
                                            --with-asp-build \
                                            --with-cross-build=<crossbuild> \
@@ Line 88: / Line 96: @@
 For a complete list of options to <code>configure</code>, including a list of available crossbuild toolchains, run:
 <code><pre>
-$ <install_dir>/sdk-3.0/src/SAFplus/configure --help
+$ <install_dir>/sdk-6.0/src/SAFplus/configure --help
 </pre></code>
 The configure step prepares the project area to build the <model> model, with the following directory structure:
@@ Line 112: / Line 119: @@
 </pre></code>
-<li>Build the configured model by issuing <code>make</code> in <code><project_area>/<model></code>:
+Build the configured model by issuing <code>make</code> in <code><project_area>/<model></code>:
 <code><pre>
 $ make
@@ Line 134: / Line 141: @@
 The model source is located at <code><project_area>/<model>/src</code>.  If any changes are made to this, rebuild the model by issuing another <code>make</code> from either the target-specific build location or the model directory.
-</ol>
 [[File:OpenClovis_Note.png]] Model building can also be accomplished in IDE. For more information, see ''OpenClovis IDE User Guide''.
 ===Using OpenClovis SDK with the WindRiver Workbench===

@@ Line 56: / Line 56: @@
   # make asp-libs
   # make asp-install
 ===Configuring and Building the Model===

@@ Line 14: / Line 14: @@
 #Configuring and building the desired model for one or more target platform
 ===Pre-building SAFplus Platform Libraries for a Given Target Platform===
@@ Line 190: / Line 167: @@
 [[File:OpenClovis_Note.png]] Model building can also be accomplished in IDE. For more information, see ''OpenClovis IDE User Guide''.

@@ Line 40: / Line 40: @@
 ===Pre-building SAFplus Platform Libraries for a Given Target Platform===
-This is an optional step that pre-builds SAFplus Platform libraries for use with a given platform (i.e. using a specific toolchain).  With these in place, it is no longer necessary to rebuild SAFplus Platform every time in order to build an SAFplus Platform model.  (For the purpose of this document, we assume that the SDK is installed at <code>/opt/clovis</code>, by root.  Consequently, example steps will be run as root.  If the SDK is installed as a normal user at a location available to him, these steps can be run as the normal user itself.)
+This step builds SAFplus Platform libraries for use with a given platform (i.e. using a specific toolchain).  With these in place, it is no longer necessary to rebuild SAFplus Platform every time your application is built.  When new software is downloaded from github or a patch is received from OpenClovis, it is generally not necessary to re-install -- it is only necessary to run this prebuild.
-We first create a special project area for the SAFplus Platform library build, and change to it:
+For the purpose of this document, we assume that the SDK is installed at <code>/opt/clovis</code>, by root.  Consequently, example steps will be run as root.  If the SDK is installed as a normal user, that user can run these steps.
   # mkdir asp_build
   # cd asp_build
-This project area is then initialized with the configure script as:
+Next, this prebuild project area should be initialized with the configure script as:
-  # /opt/clovis/sdk-3.0/src/SAFplus/configure --with-asp-build \
+  # /opt/clovis/<SAFplus version>/src/SAFplus/configure --with-asp-build [--with-sdk-dir=</opt/clovis>] [--with-cross-build=<toolchain>] [--prefix=<alternate SAFplus Platform libs installation dir>]
-                         [--with-cross-build=<toolchain>] \
-         [--prefix=<alternate SAFplus Platform libs installation dir>]
-By default, the libraries will ultimately be installed to the SDK installation directory, in this case: <code>/opt/clovis/sdk-3.0/target/<arch>/<kernel>/lib</code>, and header files will be available at <code>/opt/clovis/sdk-3.0/include</code>.
+Run ".../configure --help" to see extensive help describing all the available options.
 If --with-cross-build=<toolchain> is unspecified, libraries will be built for the local system.
 If --prefix=<prefix> is specified, libraries will be installed to <code><prefix>/<arch>/<kernel>/lib</code>, and header files to <code><prefix>/include</code>
 For example:
-  # /opt/clovis/sdk-3.0/src/SAFplus/configure --with-asp-build \
+  # /opt/clovis/sdk-6.0/src/SAFplus/configure --with-asp-build --with-cross-build=i586-wrl-pnele1.4-2.6.14_mpcbl0001
-   --with-cross-build=i586-wrl-pnele1.4-2.6.14_mpcbl0001
-will cause libraries to be built from the i586-wrl-pnele1.4-2.6.14_mpcbl0001 toolchain and installed to <code>/opt/clovis/sdk-3.0/target/i386/linux-2.6.14/lib</code>, with header files populated at <code>/opt/clovis/sdk-3.0/include</code>, and
+will cause libraries to be built from the i586-wrl-pnele1.4-2.6.14_mpcbl0001 toolchain and installed to <code>/opt/clovis/sdk-6.0/target/i386/linux-2.6.14/lib</code>, with header files populated at <code>/opt/clovis/sdk-6.0/include</code>, and
-  # /opt/clovis/sdk-3.0/src/SAFplus/configure --with-asp-build \
+  # /opt/clovis/sdk-3.0/src/SAFplus/configure --with-asp-build --prefix=/opt/asplib
-                                         --prefix=/opt/asplib
 on an Ubuntu 7.04 (feisty fawn) system will cause libraries to be installed to <code>/opt/asplib/i686/linux-2.6.20/lib</code>, and header files to be populated at <code>/opt/asplib/include</code>.

@@ Line 1: / Line 1: @@
 ==Building SAFplus Platform and SAFplus-based Systems==
-This chapter covers new features that are related to building SAFplus Platform and SAFplus-based systems. Key new features include:
+This chapter covers features that are related to building SAFplus Platform and SAFplus-based systems.
-−
-#SAFplus Platform and model tree separation
-#Pre-built SAFplus Platform library support
-#Multi-target build support
-#Integration with WindRiver Workbench SDK
 Note: In the context of this chapter, a target platform is any blade type or architecture that OpenClovis SAFplus Platform can be built for (e.g. WindRiver PNE-LE 1.4 on dual Xeon-based Intel MPCBL0001 blades, or Yellow Dog Linux on PowerPC based blades).  OpenClovis provides a variety of cross build toolchains that can optionally be used with the SDK to build SAFplus Platform for these targets.