Why is data logging and trace important in real time control systems?

• Debugging application code during and after development or testing
• Profiling application code
• Creating capture logs of a control system for deep analysis
• Tracing application code flow

There are many applications that require different uses of using data log or trace features on a device. The DLT provides a way to log critical run time content, and then export out by JTAG, UART, or FSI. If there is no JTAG connection available, the DLT can still be used if there is a UART or FSI implementation to export the data. The lines of code controlling what is being logged can be kept in the application code without impact on CPU performance.

The DLT provides data logging and code flow execution through dedicated instructions provided in the C29x user guide. When using the DLT for data logging variables or adding code flow markers in the application there is additional information attached to each log. The additional information is dependent on what mode the DLT is capturing the logs. The two modes for the additional information added to each log are time stamping or program counter information. In time stamping mode, the DLT provides information of when variables or code markers are being logged. In program counter mode, the DLT provides information to know where these logs are happening.

There are dedicated instructions used to log information. The instructions have the following names DLTAG and DLREG. DLTAGs are used as the code flow markers. DLREGs are the instructions that allow users to data log variables. With the leverage of multiple instructions running in parallel using the C29x processor these instructions can run in parallel and provide non-intrusive behavior when data logging or adding code flow markers to the application code. The co-processor interface (CPI) looks for these dedicated instructions from the CPU and provides the packet information to the DLT which gets logged to a dedicated memory address region for each CPU. The CPU or DMA can read out the logs from the DLT internal memory and move the logged information as needed.

Here is a high level view from going to application code to visualizing the data being logged by the DLT on a PC.

This application note explains the steps needed to configure the DLT, data log, and add code markers using the built in compiler intrinsic. The DLT leverages the compiler and SysConfig to provide the fastest way to get started with using this peripheral.

The use-case that is discussed throughout this application report is using the DLT to record a temperature sensor sample and ADC results within ISR.

As mentioned in the abstract, this application note utilizes SysConfig to configure the DLT peripheral along with the other required components such as visualizing the DLT packets. The SysConfig GUI allows users to walk through the configurations needed to set up the DLT to be ready to start logging in the application code.

The first step to configuring the DLT is setting up the start and stop events to log information. There are two main methods of starting or stopping logged information through the code markers (DLTAGs) or using ERAD events. The third method is security focused and prevents logged information to occur based on the enabled LINK filters. The TAG or ERAD filters control when to start or stop data logging. LINK filters are used to filter out sections of code to data log based on what current LINK has access.

The TAG based filtering has a few options such as the Start Tag Reference, Start Tag Mask, and the end tag configurations. These can be used to start or stop the DLT from logging. The mask is and’ed with the code marker that is reached in the application code. If the and’ed output of the current tag value and the tag filter start mask equals the start tag reference and the tag based filtering is enabled, then the DLT starts logging. The same is true to stop the DLT from logging using the end tags. The start/end tag reference can be any 16-bit value.

Below is a flow chart diagram that explains what happens if users have both TAG based and ERAD based conditions to start or stop logging.

Configuring the start or stop end tags can be any 16-bit value. SysConfig offers a helpful GUI to configure these.

The Enable Tag based Filtering option must be selected. The configurations outlined to configure the start tag reference value and end tag reference value. The Start Tag Mask and End Tag Mask get AND'ed with the respective start or end reference values to control when the logs occur. In the above configuration, 0x5 is the start tag reference value being used and the end tag reference value of 0x20. These values are arbitrary and can be configured with any value. The code generated in SysConfig's board.c file is shown below.