IPI commands to Versal PMC

The following is a list of ipi commands:

plm

PLM logging

Syntax

plm <sub-command> [options]
Configure PLM log-level/log-memory, or copy/retrieve PLM log, based on <sub-command> specified. Following sub-commands are supported.
  • copy-debug-log - Copy PLM debug log to user memory.
  • set-debug-log - Configure memory for PLM debug log.
  • set-log-level - Configure PLM log level.
  • log - Retrieve PLM debug log. Type "help" followed by "plm sub-command", or "plm sub-command" followed by "-help" for more details.

Options

None

Returns

Depends on the sub-command. Refer to the sub-command help for details.

Example(s)

Refer to the sub-command help for examples.

plm copy-debug-log

Copy PLM debug log

Syntax

plm copy-debug-log <addr>

Copy PLM debug log from debug log buffer to user memory specified by <addr>.

Returns

Nothing, if successful. Error, otherwise.

Example(s)

plm copy-debug-log 0x0

Copy PLM debug log from the default log buffer to address 0x0.

plm set-debug-log

Configure PLM debug log memory

Syntax

plm set-debug-log <addr> <size>

Specify the address and size of the memory which should be used for PLM debug log. By default, PMC RAM is used for PLM debug log.

Returns

Nothing, if successful. Error, otherwise.

Example(s)

plm set-debug-log 0x0 0x4000

Use the memory 0x0 - 0x3fff for PLM debug log.

plm set-log-level

Configure PLM log level

Syntax

plm set-log-level <level>

Configure the PLM log level. This can be less than or equal to the level set during the compile time. The following levels are supported. 0x1 - Unconditional messages (DEBUG_PRINT_ALWAYS) 0x2 - General debug messages (DEBUG_GENERAL) 0x3 - More debug information (DEBUG_INFO) 0x4 - Detailed debug information (DEBUG_DETAILED)

Returns

Nothing, if successful. Error, otherwise.

Example(s)

plm set-log-level 0x1

Configure the log level to 1.

plm log

Retrieve the PLM log

Syntax

plm log [options]

Retrieve the PLM log, and print it on the console, or a channel.

Options

Option Description
-handle <handle> Specify the file handle to which the data should be redirected. If no file handle is given, data is printed on stdout.
-log-mem-addr <addr> Specify the memory address from which the PLM log should be retrieved. By default, the address and log size are obtained by triggerring IPI commands to PLM. If PLM doesn't respond to IPI commands, default address 0xf2019000 is used. This option can be used to change default address. If either memory address or log size is specified, then the address and size are not retrieved from PLM. If only one of address or size options is specified, default value is used for the other option. See below for description about log size.
-log-size <size in bytes> Specify the log buffer size. If this option is not specified, then the default size of 1024 bytes is used, only when the log memory information cannot be retrieved from PLM.

Returns

Nothing, if successful. Error, otherwise.

Example(s)

set fp [open test.log r] 

plm log -handle $fp

Retrieve PLM debug log and write it to test.log.