Event Logging IPI Command - 2023.2 English

Versal Adaptive SoC System Software Developers Guide (UG1304)

Document ID
UG1304
Release Date
2023-10-18
Version
2023.2 English
Table 1. Event Logging Command
Structure
Reserved[31:25]=0 Security Flag[24] Length[23:16]=4 PLM=1 CMD_EVENT_LOGGING=19
Sub Command
Argument 1
Argument 2
Argument 3

The PLM supports logging PLM Terminal Prints and Trace Events to separate buffers. This command configures the buffers for logging, and also retrieves buffer information.

The subcommands are as follows:

1U
Configures the log level of the PLM terminal during runtime. This log level can be less than or equal to the log level set at compile time.
Argument 1
Log Level. This argument can be one or a combination of the following entities:
0x1U
Unconditional messages (DEBUG_PRINT_ALWAYS)
0x2U
General debug messages (DEBUG_GENERAL)
0x3U
More debug information (DEBUG_INFO)
0x4U
Detailed debug information (DEBUG_DETAILED)
2U
Configures the debug log buffer memory. By default, this memory is configured to PMC RAM. You can change this memory as per your need.
Argument 1
High Address where PLM terminal prints are logged
Argument 2
Low Address where PLM terminal prints are logged
Argument 3
Length of Debug log buffer
3U
Copies the logged PLM prints from the debug log buffer to where you need them.
Argument 1
High Address to which the log buffer data is copied
Argument 2
Low Address to which the log buffer data is copied
4U
Retrieves the debug log buffer memory details where the PLM prints are logged. The response is as follows:
Payload 0
Command status
Payload 1
Debug log buffer High Address where the logging occurs
Payload 2
Debug log buffer Low Address where the logging occurs
Payload 3
Debug log buffer offset till where the logging occurs
Payload 4
Debug log buffer length
Payload 5
Indicates whether the debug log buffer is full
5U
Configures the trace log buffer memory. By default, this memory is configured to PMC RAM but you can change this memory if required.
Argument 1
High Address where Trace events are logged
Argument 2
Low Address where Trace events are logged. Length of the Trace log buffer.
6U
Copies the logged trace events from the Trace log buffer to a desired location.
Argument 1
High Address to which you want to copy the trace log buffer data
Argument 2
Low Address to which you want to copy the trace log buffer data
7U
Retrieves the details of the trace log buffer memory where the trace events are logged. The response is as follows.
Payload 0
Command status
Payload 1
Trace log buffer High Address where the logging occurs
Payload 2
Trace log buffer Low Address where the logging occurs
Payload 3
Trace log buffer offset till where the logging occurred
Payload 4
Trace log buffer length
Payload 5
Indicates whether the trace log buffer is full