Create RXF Library

This product expects you to use Rhapsody on Windows, and to build the RXF and generated application on a Linux host system. The deployer will copy the Rhapsody generated files and a generated Makefile to your Linux host system. The RXF sources are installed on your host system during installation time of the Embedded UML Studio in a particular directory structure for make:

This setup allows you to install different versions of the Realtime eXecution Framework next to each other when upgrading without any problem: <product> is the name of your product including its version number, for example SibeliusV5.0r0
The makefile generated to build your Rhapsody application relies on the defined structure on your Linux host:

the path to the RXF include files needed during compilation of your application on Linux is defined during installation when you had to fill this in. It is inserted in the generated Makefile for your application.
the path to the RXF libraries needed during linking your application on Linux is inserted in the generated Makefile for your application. It is the subdirectory Lib inside the Source directory, where the RXF libraries will be created.

Makefile

All RXF files could be build into a library, so the RXF can be linked with the user’s application without linking unused functions. This will significantly decrease its footprint, but if you do not want to use the RXF as a library, please continue at GettingStarted.

For convenience we provided a Makefile to build your libraries. The RXF libraries contain all RXF files except a few files which are compiled and linked with your Rhapsody application. The reason behind this, is that for example the maximum number of timeouts or may vary per Rhapsody model. The CreateRXFLibrary sources already installed in a directory on your Linux host which can be accessed as:

<your path on Linux>/<product>/Samples/Code/CreateRXFLibrary

You can build the libraries using the makefile which is also installed. We inserted references to the sources and include files of the RXF like shown above.

To build the libraries, one for a Debug buildset and one for Release buildset, you must:

open a terminal window on Linux and perform a cd to the path above
perform a make which will build the RXF libraries. The libraries RXFD.so and RXFR.so are created in <your path on Linux/<product>/Source/Lib - these libraries support the two buildsets Debug and Release.

NOTES

The options or constants set via CppCompileSwitches in your buildsets must match the options in your Linux project 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.

Please refer to RXFMigrationGuide.pdf to learn how you can migrate existing WST63 projects to Sibelius.