Managing the Circular Buffer

The diagnostic circular buffer is managed on the tab Circular buffer in the top right area of the main control window.

Manual Interaction Options

If a circular buffer is defined in the application, it is automatically created and handled by the system. For manual operation you may additionally pause, continue, or create a copy of the current buffer.

You can create a copy of the current circular buffer that will not be overwritten by the system. This copy is created in a sub-directory of the results file directory on the PCU.

To create a copy, select one of the Save local copy options described in the following table.

Table 12. Save Local Copy Options
Option Description
all completed blocks The circular buffer contains all files that are completed when you click Save.
last X h The circular buffer contains all files that were created during the last X hours.
section X h - Y h The circular buffer contains all files that were created between X hours and Y hours ago.

A new container is created that contains all files matching the selected options and that are completed when you click Save. Files that are still written at this moment are not part of the copy.

If a connection to the testXplorer is configured, clicking Save also causes an upload of the current circular buffer to the testXplorer.

Note The files of the circular buffer in the default location are saved using PAtools ASCII file format with suffix .erg. In opposite the files of the local copy are converted to MDF4 file format with suffix .mf4.
Important The creation of the local copy may influence the performance of the test. Cycle losses may occur while the files are copied.

Location of the Blocks

The default location for the files of the circular buffer is the sub-directory diagnostic_ring_buffer of the results file directory:

The local copies of the circular buffer are located in a sub-directory with the name of the test bench. This name can be queried in PAcontroller by checking the value of the variable Testbench.

Figure 31. Testbench Variable
1378

If the field comment is left empty, the name of the container is created using the following schema:

yyyymmdd_HHMMSS_diagnostic_ring_buffer

where:

  • yyyy is the current year with four digits
  • mm is the month of the year with two digits
  • dd is the day of the month with two digits
  • HH is the current hour with two digits
  • MM is the current minute with two digits
  • SS is the current second with two digits

If the field comment is filled with a non-empty string, this text is appended to the name of the sub- directory.

Schematic Examples for Different Recording Parameterizations

The following figures are a schematic example of the created file blocks for different recording scenarios.

Figure 32. Default Behavior for Six Files and a One Hour Recording Time
1378
Figure 33. Upload Behavior to testXplorer for a One Hour Recording Time
1378
Figure 34. Behavior with Definition of a Maximum File Size
1378