Create RXF Library

OO RTX

It is a good idea to use a library for the OO RTX which you can link with your application. This will decrease its footprint, because unused functions will not be allocated by your linker. Our example GettingStarted also relies on using libraries for the OO RTX, and support the two buildsets Debug and Release.

We provided a complete MPLAB IDE project CreateRXFLibrary to build your libraries, which match the Blinky example. If you need a different derivate, you can modify the settings in the projects included in the Workspace as described on the section how to change derivate, but please do so after the demo.

The CreateRXFLibrary Project Workspace is installed in <your Rhapsody>\Share\WST_RXF_V5\<your product>\Samples\Code which Project Workspace you can open in the MPLAB IDE via Project | Open:

Build or rebuild the libraries. We already inserted references to the C sources and include files of the OO RTX which are installed in <your Rhapsody>\Share\WST_RXF_V5\<your product>\Source:

Make the other project active, and rebuild that library too:

You can inspect the settings for each MPLAB Build Configuration via Project | Build Options | Project:

You will notice that only a few things are set:

on the Output Tab, using a relative path we specified that the library must be created in the directory in <your Rhapsody>\Share\WST_RXF_V5\<your product>\Sourc\Lib
on the Output Tab, relative include paths to <your Rhapsody>\Share\WST_RXF_V5\<your product>\Source and current working directory
for the C compiler, a macro _DEBUG (Debug) or NDEBUG (Release) which enables the proper C code in RxfConstants.h The constant OM_NRCS_ID is set to disable allocation of RCS ID's in the Container Classes by IBM Rational

The two MPLAB Build Configurations result in the libraries RXFD.lib and RXFR.lib

NOTE

The options or constants set via CppCompileSwitches in your Buildsets must match the options in your MPLAB IDE project CreateRXFLibrary to create RXF libraries. You should not compile the libraries with for example support for UML ports, or use highwatermarks in a debug version, and use different options to compile your application with.

If you need a different options for code generation or section usage, you can modify the settings on the MPLAB PIC32 C Compiler Tab in for both Build Configurations Debug and Release included in the Project Workspace as described on the section how to change derivate, but please do so after the demo.