SystemLink Tags

Tags in SystemLink receive and store slow-moving measurement data.

Use the SystemLinkTags module to configure PAtools variables to publish as SystemLink tags. The SystemLinkTags module consists of a configuration folder and a system folder. You can customize the content of the configuration folder. The system folder contains the function of the module.

• Configure the SystemLinkTags module at the application level to publish PAtools variables that are only in the application. You can also configure the SystemLinkTags module for variables that are common across all test procedures that you might run with this application. For example, you might configure the test run time at the application level if the run time is common across all test procedures. Another example is configuring the state of charge of the DUT if the state of charge is common across all test procedures.
• Configure the SystemLinkTags module for individual test procedures to publish PAtools variables that are unique to that test procedure.

As seen in the following image, the configuration folder consists of the following groups:

• SystemLinkTags—An initialization of the variables group. In this group, you can enable the SystemLink tag feature and set the log level. The initialization of the variables group is only for variables configured at the application level.
• SystemlinkTags_Configuration—Defines which PAtools variables are published, the SystemLink path the variables are using, and the update rate. SystemlinkTags_Configuration is only for variables configured at the application level. You can add as many variables as necessary.
  • PAtools Variables Table—The name of a SystemLinkTags_Variables group table.
  • SystemLink Path—A system path string that takes the following structure: <Minion ID>.<SystemLink Path>.<Display Name>.
    • Display Name—A variable in the SystemLinkTags_Variables table.
    • Minion ID—The ID configured for the SystemLink Client on the machine running the test.
  • Path Modifier—A string or PAtools variable whose value populates the % in the SystemLink Path string.
    Note This value can include a % modifier that is defined using the Path Modifier value. For instance, you may use DUT% with a Path Modifier of dut_number if have a SystemLink Path that includes the DUT number.
  • Update Rate [s]—The rate that variable values should be published to SystemLink.
• SystemLinkTags_Variables—Defines the PAtools variables. Use SystemLinkTags_Variables to configure variables at the application level and for individual test procedures. SystemLinkTags_Variables consists of a table that contains the following information:
  • PAtools Variables—Defines what variables should publish to SystemLink as tags. PAtools supports publishing Integer, Float, and String type variables.
    Note SystemLink Server has an accumulated limit of 1000 tags per second that may be published to SystemLink from all systems.
    Note When you select variables to post as tags to SystemLink Enterprise, select only the variables that you want to monitor live. Review all other variables in data log files and data tables.
  • Retention Mode—Specifies the retention as Duration, Count, Permanent, or None.
    Note Unless the variable requires access to recent historical data in SystemLink, set the Retention Mode to None. Setting the retention mode to None conserves energy. PAtools discourages setting the Retention Mode to Permanent.
  • Retention Days/Count—Defines the retention period when Retention Mode is set to Duration or Count.
  • Display Name—Defines how the tag is named in SystemLink. PAtools builds a tag path for each variable. The Display Name appends to the end of the tag path. Find the tag path in the SystemLink Tags pane. Use the tag path when selecting tag names to show in a SystemLink Grafana Dashboard.