Configuring System Mappings for Channels and Aliases

You can connect channels or aliases to one another by specifying system mappings. If both channels are part of the base system definition file, you can specify the mapping as part of the base file. However, sometimes mapping connections are needed in which one or both channels are not included in the base file or an alias is included. In these cases, you can create a channel mappings text file as part of your test station package. To do so, complete the following steps:
  1. In VeriStand, open your base system definition file in System Explorer and click System Configuration Mappings.
  2. Add mapping connections for those mappings in which both connections are included in the base system definition file.
  3. Save this file.
  4. Create a new channel mappings text file. Add channel or alias source and destination paths to this file in which each line is in the format of source path [tab] destination path. For example, it might look like this: 
    Contoller/Alarms/Cycler Fault/Alarm Status  [tab]   Contoller/User Channels/Test Fixture Fault
    Note To see an example channel mappings formatted file, open System Explorer in VeriStand, and click System Configuration Mappings to generate a system mappings file.
  5. Move this channel mappings file into your test station package next to your test station XML configuration file.
  6. In the test station XML configuration file, include the ChannelMappings attribute with the system mappings file name (for example, ChannelMappings="Mappings.txt"). Refer to Test Station Package XML Conventions for more information.
    Tip To simplify repeated use of socket-specific mappings, consider using %SOCKET%. Refer to Simplify the Application of VeriStand Entities Across Multiple DUTs for more information.
    Note BTS merges the mappings defined in the channel mappings file with the mappings that are defined in your base system definition file. If both the base system definition file and the channel mappings file include a mapping with the same destination path, the mapping defined in the channel mappings file is used.