Stamping RTSS Applications and RTDLLs

RTSS or RTDLL binaries created with the wRTOS Application or RTDLL templates are automatically stamped with StampTool as a post-build event. All applications not built by the templates must be manually stamped using StampTool.

Note: If you do not have a valid SDK license for the version of wRTOS included in your Visual Studio project settings the RtssRelease and RtssDebug configuration builds will fail. (The RTSS binary is still generated, but it will not be loadable and runnable).

To manually stamp an RTSS/RTDLL:

  1. Open a Command Prompt as Administrator.
  2. Type stamptool followed by the path to the RTSS or RTDLL binary.

Example:

stamptool "C:\Users\Administrator\Documents\Visual Studio Version\Projects\wRTOSApp2\RTSSDebug\wrtosapp2.rtss"

Optionally, you can type the switch /info before the file path to display information about the binary without stamping it. This information includes whether the file has been stamped.

Example:

stamptool /info "C:\Users\Administrator\Documents\Visual Studio Version\Projects\wRTOSApp2\RTSSDebug\wrtosapp2.rtss"

Note: The path can be a relative or absolute path name, but it must reference an RTSS or RTDLL binary. If the path name contains whitespace, it must be enclosed in double quotes, as shown in the example above.

To set the StampTool as a post-build event in Visual Studio:

For all applications not built by the wRTOS Application or RTDLL template, you can create a post-build event in the project properties to automatically stamp the RTSS/RTDLL when the application is subsequently built.

  1. In the Solution Explorer window, right-click on the project and then click Properties.
  2. In the Property Pages dialog, click Configuration Properties.
  3. Click Build Events, and then click Post-Build Event.
  4. In the Command Line field, type: "%wRTOSCommon%\bin\StampTool.exe" "$(TargetPath)"
  5. Set Use In Build to Yes.
  6. Click OK.

Changing the Target Name

If you need to change the Target Name configuration property of an RTSS or RTDLL project in Visual Studio, you must also make an additional change to the project settings.

For instance, the default value of the Target Name property is “$(ProjectName)”. If you were to change it to “NewTargetName”, the wRTOS StampTool utility will fail to find the generated binary. You must also change the Output File property in the General section of the Linker properties to specify NewTargetName in the name of the binary.

Once these changes are made to the project settings, the project will build.

Note: This must be done in both the RTSSDebug and RTSSRelease Solution Configuration of the project.

Flags for Handling Multiple SDK Licenses

The following flags allow you to ensure that the correct SDK license is used during binary stamping when multiple licenses are present on your system:

/sdkver=<#>

Forces StampTool to use only the SDK licenses that match the specified SDK major version. For example, /sdkver=1 specifies SDK version 1.x, where the major version is 1.

/cid=<####>

Forces StampTool to use only the SDK licenses that match the specified Customer ID (CID). For example: /cid=1234.

Note: All flags, including /devinfo, must be provided before the binary path name.

Related topics: