Adding VxWorks-7 Boost C++ Library Support

by | Oct 5, 2020 | VxWorks

1 Introduction

The Boost project provides a comprehensive set of peer-reviewed, portable C++ source libraries that work well with the C++ Standard Library.

VxWorks is a Real Time Operating System built by Wind River.

VxWorks supports a subset of the Boost C++ library. The supported libraries are:

Date Time
Program Options
Type Erasure

This blog describes how to configure VxWorks with Boost and then how to validate that the Math library is functional using a dynamic test script
which validates target operation using the Boost b2 utility on the workstation.

Because we will run a test suite that was initially targeted for Linux workstations rather than Windows, it is recommended
you have Git bash installed on your Windows workstation. This is installed along with Git for Windows.


2 Prerequisites

These instructions assume that you are using:

A Windows workstation with the following installed on it:
Wind River VxWorks 7, SR0620
Git for Windows


3 Related Documentation

For more information on these topics, refer to:

Wind River documentation:
VxWorks Support for Third-Party Software

Non-Wind River documentation:


4 Prepare the Boost Enabled VxWorks Projects

4.1 Create and Build the Boost VxWorks Source Build (VSB) Project Including the Math Library

Open a Windows command shell, configure the build environment, and then add the Boost Math library to a newly created VxWorks source build (VSB) project:

cd <WIND_HOME>                  // your installation directory
wrenv -p vxworks-7
cd <YOUR_WORKSPACE>             // your workspace
vxprj vsb create boostvsb -bsp vxsim_windows -force -S
cd boostvsb                     // your VSB directory
vxprj vsb add BOOST             // add the Boost layer to the VSB
                                // enable only the Boost math library
vxprj vsb config -s -add "_WRS_CONFIG_BOOST_MATH=y"
                                // set a default filepath mapping
vxprj vsb config -s -add "_WRS_CONFIG_BOOST_HOST_FILEPATH_MAPPING_PREFIX=wruserfedora:"
make -j 32                      // build the VSB

If you wish to enable other Boost libraries, you can enable these individually in the VSB configuration as required.

The VSB build time will extend significantly when Boost libraries are included.

4.2 Create and Build the Boost VxWorks Image Project (VIP) Including the Boost Test Infrastructure

Create the VxWorks image project (VIP) as follows:

cd ..
vxprj create vxsim_windows boostvip -vsb boostvsb
cd boostvip
vxprj vip component add INCLUDE_IPTELNETS
                                // enable the VxWorks time slicing scheduler to allow fair-scheduling Boost tests to pass
vxprj vip component add INCLUDE_PX_SCHED_DEF_POLICIES
vxprj vip component add INCLUDE_POSIX_PIPES
vxprj vip component add INCLUDE_IPDHCPC
vxprj vip parameter set DHCPC_REQ_OPTS "\"3"\"
vxprj component add 
vxprj build

5 Setup Boost Test Environment

5.1 Launch the VxSim Network Daemon and the VxWorks Simulator Target

Open a new Windows command shell:

cd <WIND_HOME>                  // your installation directory
wrenv -p vxworks-7
cd <YOUR_WORKSPACE>             // your workspace
vxsimnetd -sv                   // launch the simulator network daemon
                                // launch the VxWorks simulator
vxsim -netif simnet0= -f boostvip\default\vxWorks

The VxWorks simulator kernel shell will appear in a new window.

5.2 Launch the Boost Math Library Test Environment

From the same Windows command shell:

cd boostvsb\3pp\BOOST\boost_1_72_0
build_run_tests.sh --limit-tests=math

The build_run_tests.sh boost test script uses the b2 utility, running on the Windows workstation, to run boost API tests on the VxWorks simulator.
Tests are run dynamically on the VxWorks simulator target and test output will appear in a separate bash shell window.
Expect warnings to be generated.

Download Our VxWorks Cheat Sheet

Download our VxWorks Cheat Sheet; a handy little tool to improve your workflow.

Got A Project In Mind?

Our levels of professionalism and commitment to our clients results in a long waiting list for projects. Let us know in advance if you might need us.