Pin Map Editor (TSM)

NI TestStand 2017 Semiconductor Module Help

Edition Date: July 2018

Part Number: 373892H-01

»View Product Info
Download Help (Windows Only)

Use the Pin Map Editor to view, create, modify, and save pin map files instead of editing the XML files directly. Use the Pin Map panel in the Test Program Editor to specify a pin map file for a test program. The pin map file also serves as the channel map file.

Select Semiconductor Module»Edit Pin Map File or click the Edit Pin Map File button on the TSM toolbar to launch the Pin Map Editor. Alternatively, you can select Semiconductor Module»Edit Test Program and then select Pin Map in the Test Program Editor to launch the Pin Map panel. Click the Open file for edit Edit Pin Map button to launch the Pin Map Editor.

The Pin Map Editor uses a red error icon in the Errors and Warnings window to indicate that the file does not conform to the Pin Map schema. Click the error icon or double-click the error message to highlight the error on the XML tab. The Errors and Warnings window displays a warning in orange text when the file conforms to the Pin Map schema but will generate an error at run time.

When you close the editor with the Cancel button and the pin map file has been edited since you opened it in the editor, a dialog box prompts you to discard changes or return to the editor. When you close the editor with the OK button, the file is updated on disk with the changes you made in the editor.

Configuring Pin Map Files

The Pin Map Editor includes the following options and tabs:

  • Pin Map File—Specifies the pin map file to load. You can manually enter a relative file path.
  • Undo—Removes the last edit made.
  • Redo—Reinstates the last edit removed.
  • Open—Launches the Select Pin Map File dialog box, in which you can browse to the pin map file to load.
  • Save—Displays a context menu that includes a Save option to save the file to the current path and a Save As option to launch as Save As dialog box. The Save button is disabled when errors exist in the pin map file.
  • New—Creates a new pin map file. If the file currently open in the editor has unsaved changes, a dialog box prompts you to discard the changes or return to the editor to save or cancel the changes to the file before creating a new file.
  • Pin Map tab—Displays an editable, hierarchical view of the <Instruments>, <Pins>, <PinGroups>, <Relays>, <RelayGroups>, <Sites>, and <Connections> elements in the pin map file. You can edit attributes of the selected element, insert new elements, or insert comments in the file. Right-click the item you want to edit and use the context menu to complete common tasks. Once you create a pin or relay group, you can drag items from the <Pins> or <Relays> list into the pin or relay group. You can also use the individual checkboxes or the Select All checkboxes on the DUT Pins, System Pins, Pin Groups, Site Relays, System Relays, or Relay Groups tabs to add or remove pins or relays from the pin or relay group.
    Note Note  Pin, pin group, relay, and relay group names are case sensitive, must begin with a letter or underscore (_), and are limited to A-Z, a-z, 0-9, or _ characters.


    After you create entries for the <Instruments>, <Pins>, <PinGroups>, <Relays>, <RelayGroups>, and <Sites> elements, select the top-level <Connections> element to display the Connections table, which includes a row for every possible connection that can be made with the available pins, relays, and sites. Use the View Connections for control to filter the view by categories, such as by all pins and relays, DUT pins and site relays by site, and system pins and relays. The Connections table includes the following sortable columns:
    • Pin—Specifies the name of a device pin to connect to an instrument channel or the name of a relay to connect to a control line on a relay driver module.
    • Site—Indicates the test site to which the connection for a particular row applies.
    • Instrument—Specifies the name of the instrument or relay driver module to connect. Select <Disconnect> to remove the association between the pin and the instrument or the relay and the relay driver module.
      Note Note  Consider using the following instrument naming convention for semiconductor test programs: InstrumentType_ModelNumber_PXIChassisLocation_SlotLocation, for example, HSD_657x_C2_S03, where InstrumentType is an ASCII description of the instrument, ModelNumber is the model number as defined on ni.com, PXIChassisLocation uses a single digit to identify the PXI chassis (Cx), and SlotLocation uses double digits to identify the slot location (Sxx).


      For VST and RFPM instruments, the file paths for custom FPGA files and calibration files are relative to the path of the pin map file by default. You can manually specify an absolute file path on the Pin Map tab or the XML tab of the pin map editor or directly in the pin map XML file.
    • Channel—Specifies an instrument channel number to assign to the pin or a control line on a relay driver module to assign to the relay.
    • Multiplexer—If applicable, specifies the multiplexer required to create the route.
    • Route—If applicable, specifies the multiplexer route required to connect the pin and site to the instrument and channel.
  • XML tab—Displays the pin map file in a text format that you can edit.
  • Errors and Warnings window—Displays issues to resolve. Click the Goto Error in XML error icon to highlight the error on the XML tab.

See Also

Common XML Validation Error Messages

Pin Map Schema

WAS THIS ARTICLE HELPFUL?

Not Helpful