User's guide

Steve A.

User guide for version 0.24

Command line options:

Usage: prudebug [-a pruss-address] [-u] [-m] [-p processor]
-a - pruss-address is the memory address of the PRU in ARM memory space
-u - force the use of UIO to map PRU memory space
-m - force the use of /dev/mem to map PRU memory space
if neither the -u or -m options are used then it will try the UIO first
-p - select processor to use (sets the PRU memory locations)
AM1707 - AM1707
AM335X - AM335x

Command set for debugger

<B>Command help</B>

Commands are case insensitive
Address and numeric values can be dec (ex 12), hex (ex 0xC), or octal (ex 014)
Memory addresses can be wa=32-bit word address, ba=byte address. Suffix of i=instruction or d=data memory
Return without a command will rerun a previous d, dd, or di command while displaying the next block

<B>BR [breakpoint_number [address]]</B>

View or set an instruction breakpoint
'br' by itself will display current breakpoints
breakpoint_number is the breakpoint reference and ranges from 0 to 4
address is the instruction word address that the processor should stop at (instruction is not executed)
if no address is provided, then the breakpoint is cleared

<B>D memory_location_wa [length]</B>

Raw dump of PRU data memory (32-bit word offset from beginning of full PRU memory block - all PRUs)

<B>DD memory_location_wa [length]</B>

Dump data memory (32-bit word offset from beginning of PRU data memory)

<B>DI memory_location_wa [length]</B>

Dump instruction memory (32-bit word offset from beginning of PRU instruction memory)

<B>DIS memory_location_wa [length]</B>

Disassemble instruction memory (32-bit word offset from beginning of PRU instruction memory)

<B>G</B>

Start processor execution of instructions (at current IP)

<B>GSS</B>

Start processor execution using automatic single stepping - this allows running a program with breakpoints

<B>HALT</B>

Halt the processor

<B>L memory_location_iwa file_name</B>

Load program file into instruction memory at 32-bit word address provided (offset from beginning of instruction memory

<B>PRU pru_number</B>

Set the active PRU where pru_number ranges from 0 to 1
Some debugger commands do action on active PRU (such as halt and reset)

<B>Q</B>

Quit the debugger and return to shell prompt.

<B>R</B>

Display the current PRU registers.

<B>RESET</B>

Reset the current PRU

<B>SS</B>

Single step the current instruction.

<B>WA [watch_num [address [value]]]</B>

Clear or set a watch point
format 1: wa - print watch point list
format 2: wa watch_num - clear watch point watch_num
format 3: wa watch_num address - set a watch point (watch_num) so any change at that word address
in data memory will be printed during program execution with gss command
format 4: wa watch_num address value - set a watch point (watch_num) so that the program (run with gss) will be halted when the memory location equals the value
NOTE: for watchpoints to work, you must use gss command to run the program

<B>WR memory_location_wa value1 [value2 [value3 ...]]</B>

Write a 32-bit value to a raw (offset from beginning of full PRU memory block - all PRUs)
memory_location is a 32-bit word index from the beginning of the PRU subsystem memory block

<B>WRD memory_location_wa value1 [value2 [value3 ...]]</B>

Write a 32-bit value to PRU data memory (32-bit word offset from beginning of PRU data memory)

<B>WRI memory_location_wa value1 [value2 [value3 ...]]</B>

Write a 32-bit value to PRU instruction memory (32-bit word offset from beginning of PRU instruction memory)


Related

Wiki: Home

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:





No, thanks