RPCTOOL.EXE - Manipulate RTCU Project Containers

Top  Previous  Next

The RTCU Project Container files (.RPC files) are image files containing the application and additional data for NX32 and NX32L projects.

It is the .RPC files that are transferred to the RTCU device or executed by the RTCU Emulator.

 

This tool can be used to create, extract and modify .RPC files containing the data for the Intellisync Project Drive. NX32L .RPC files also has support for files on the internal drive and for RTCU Platform Extensions.

 

The path to the .RPC file must be provided as the last entry on the command line for all options except -h.
 

The following basic options are available:

-h

:

Show the help message with information on all the supported options.

-e <folder>

:

Extract the project drive from the container to the specified folder. If the folder does not exist, it is created.

-c <folder>

:

Creates a container with a project drive based on the contents of the provided folder.

Has support for using the wild-card * to limit the files to include. Directories are only included when -nxl is used. Hidden files will not be included.

-n

:

Create a new container instead of modifying an existing container. Can only be used in combination with the modification actions found in the tables below.

-i

:

Show the contents of the container.

-nxl

:

This will make the container use the NX32L format. It must be provided when modifying an NX32L container.

-fnxl

:

This will convert the container to the NX32L format, It also activates the -nxl flag.

-sn

:

Set the name of the container. It will be shown when printing the info about the container. Max 20 characters. This would typically be the application name.

-sv

:

Set the version of the container. It must be and integer between 1 and 30000. It will typically be scaled by 100, i.e. a version of 123 could be shown as 1.23. This would typically be the application version.

 

 

The following options are used to modify the container. They can be used multiple times and can be combined on the same command line.

 

Project drive

Options for both NX32 and NX32L containers:

-a <file> <name>

:

Add the provided file to the project drive, using the specified name as the file name on the project drive.

-d <name>

:

Delete the file with the provided name from the project drive

-u <file> <name>

:

Replace the file with the specified name on the project drive with the provided file.

 

Options for NX32L containers:

-af <name>

:

Creates a folder with the specified name inside the project drive.

-df <name>

:

Deletes the folder with the provided name from the project drive

 

Internal drive

NX32L containers makes it possible to add and remove files and folders on the internal drive.

It is done by creating actions that will be performed on the device, such as adding or deleting a file.

Files that do not have any actions will not be modified.

 

Options for NX32L containers:

-ai <file> <name>

:

Creates an action to add the file at the specified path to the internal drive, using the specified name as the file name on the internal drive.

The installation will fail if the file already exists, so it is normally better to use -ui.

-di <name>

:

Creates an action to delete the specified file from the internal drive.

-ui <file> <name>

:

Creates an action to replace the file with the specified name on the internal drive with the provided file.

-ri <name>

:

Removes all actions to modify the file with the specified name on the internal drive.

-aif <name>

:

Creates an action to create a folder with the specified name on the internal drive.

-dif <name>

:

Creates an action to remove the folder with the specified name from the internal drive.

Note that only empty folders can be deleted.

-rif <name>

:

Removes all actions to modify the specified folder on the internal drive.

 

RTCU Platform extensions

The RTCU platform extensions installed on a device can be controlled using NX32L containers by creating actions to install and uninstall the extensions.

 

Options for NX32L containers:

-ae <name>

:

Creates an action to install the RTCU Platform extension with the specified name. The file name of the given file will be used as the name on the device.

-de <name>

:

Creates an action to uninstall the RTCU Platform extension with the specified name.

-re <name>

:

Removes all actions to modify the specified RTCU Platform extension.

 

 

 

By default the rpctool targets the NX32 architecture.