IPC Users Guide/Rebuilding IPC

IPC User's Guide

Optimizing IPC Applications

Using IPC on Concerto Devices

This page describes how to rebuild the IPC source code.

The IPC product includes source files and build scripts that allow you to modify the IPC sources and rebuild its libraries. You can do this in order to modify, update, or add functionality. If you edit the IPC source code and/or corresponding build scripts, you must also rebuild IPC in order to create new libraries containing these modifications.

Note that you can cause the BIOS-side IPC (and BIOS) libraries to be rebuilt as part of the application build - this is called a 'Custom Build'. The custom-built libraries will be stored with other output from executing your config script, and will contain only modules and APIs that your application needs to access. You can cause such a Custom Build to occur using the BIOS.libType config param as follows.

<syntaxhighlight lang='javascript'> var BIOS = xdc.useModule('ti.sysbios.BIOS'); BIOS.libType = BIOS.LibType_Custom; </syntaxhighlight>

CAUTION This page provides details about rebuilding the IPC source code. We strongly recommend that you copy the IPC installation to a directory with a different name and rebuild that copy, rather than rebuilding the original installation.

Build Procedure

The various IPC Install Guides describe the mechanics of rebuilding IPC libraries. Please consult the Install Guide appropriate for your environment.

• IPC Install Guide BIOS - for all-BIOS environments
• IPC Install Guide Linux - for environments with a combination of Linux and BIOS
• IPC Install Guide QNX - for environments with a combination of QNX and BIOS
• IPC Install Guide Android - for environments with a combination of Android and BIOS

Pointing a CCS Project at a Rebuilt IPC

To build your application using the version of IPC you have rebuilt, you must point your project to this rebuilt version by following these steps:

1. Open CCS and select the application project you want to rebuild.
2. Right-click on your project and choose Build Properties. If you have a configuration project that is separate from your application project, open the build properties for the configuration project.
3. In the CCS Build category of the Properties dialog, choose the RTSC tab.
4. Under the Products and Repositories tab, uncheck all the boxes for IPC. This ensures that no version is selected.

   

5. Click the Add button next to the Products and Repositories tab.
6. Choose Select repository from file-system, and browse to the "packages" directory of the location where you copied and rebuilt IPC. For example, the location may be C:\myIpcBuilds\custom_ipc_1_22_##-##\packages.

   

7. Click OK to apply these changes to the project.
8. You may now rebuild your project using the re-built version of IPC.

IPC User's Guide

Optimizing IPC Applications

Using IPC on Concerto Devices