Please note as of Wednesday, August 15th, 2018 this wiki has been set to read only. If you are a TI Employee and require Edit ability please contact x0211426 from the company directory.
- 1 Introduction
- 2 PRU Applications & Support questions
- 2.1 Q: What is the difference between the PRU subsystem and ICSS?
- 2.2 Q: Is TI providing libraries for the PRU?
- 2.3 Q: Can I develop my own industrial protocols on the PRU-ICSS?
- 2.4 Q: What differences exist between the PRU-ICSS in difference devices?
- 2.5 Q: Where can I find more information about the PRU?
- 2.6 Q: Can the PRU run a High Level Operating System?
- 2.7 Q: My processor has a PRU. Is the PRU supported in the Linux Processor SDK?
- 3 PRU Memory Access questions
- 4 PRU GPI/O questions
- 4.1 PRU GPO direct output mode
- 4.2 PRU GPI 28-bit shift in
- 4.3 PRU GPO shift out
- 4.3.1 Q: Can data be pre-loaded into shadow registers prior to configuring the PRU GPO mode to shift out mode?
- 4.3.2 Q: When does PRU<n>_CLOCKOUT start running?
- 4.3.3 Q: When does the PRU start shifting data in the shadow registers?
- 4.3.4 Q: The shadow registers are loaded by writing to PRU<n>_R30 [0:15]. Does this change the state of the corresponding device-level pins?
- 4.3.5 Q: When the PRU<n>_ENABLE_SHIFT bit is cleared, does the PRU immediately stop shifting PRU<n>_DATAOUT?
- 4.3.6 Q: Does the PRU shift data out LSB or MSB first?
- 4.3.7 Q: What happens to the content stored in R30 when the PRU changes to a different GPO mode?
- 5 PRU INTC and System Event questions
- 6 PRU Debugger questions
- 7 PRU Linux Driver questions
This article serves as a compilation of Frequently Asked Questions regarding the PRU.
PRU Applications & Support questions
Q: What is the difference between the PRU subsystem and ICSS?
PRU subsystem and ICSS both refer to the same hardware (PRU-ICSS), but their distinction lies in the targeted applications. The term "PRU subsystem" is used for broad market (or non-industrial) applications, while the term "ICSS" is used for industrial applications. The ICSS is supported with ICE and IDK boards and Industrial Software Kit.
Q: Is TI providing libraries for the PRU?
TI is not providing libraries for the PRU. Customers will need to develop their own PRU firmware. However, TI does provide the foundation for PRU development through example software and other resources available through the PRU-ICSS wiki page.
One exception is the ICSS firmware supported with the ICE and IDK boards.
Q: Can I develop my own industrial protocols on the PRU-ICSS?
TI only supports the industrial protocols enabled in the IDK (Industrial Development Kit) available on ti.com. Independent development of industrial protocols using the MII_RT and IEP (Industrial Ethernet Peripheral) blocks in not supported or enabled.
Q: What differences exist between the PRU-ICSS in difference devices?
The PRU-ICSS differences between devices are summarized in the PRU-ICSS Feature Comparison wiki article.
Q: Where can I find more information about the PRU?
Q: Can the PRU run a High Level Operating System?
No, the PRU cannot run a HLOS such as Linux or Android.
Q: My processor has a PRU. Is the PRU supported in the Linux Processor SDK?
It depends. OMAP138 PRU is NOT supported in Linux Processor SDKs 4.3 and older, and there are no plans to add support for it. However, Linux Processor SDK 4.3 does support the PRU for AMIC11x, AM335x, AM437x, AM572x / AM571x, and 66AK2G02 (K2G). More processors will be added in future releases.
PRU Memory Access questions
Q: Why does my PRU firmware hang when reading or writing to an address external to the PRU Subsystem?
The OCP master port is in standby and needs to be enabled in the PRU-ICSS CFG register space, SYSCFG[STANDBY_INIT].
Q: In AM437x, why can PRU-ICSS0 not access memories outside of the ARM?
Make sure PRU-ICSS1's OCP master port is enabled. PRU-ICSS0 accesses all external memories through the PRU-ICSS1 OCP master port.
Q: Why can the PRU not edit pinmux settings?
The PRU does not have privileges to edit the pinmux or pad config settings in the device-level Control Module. However, the PRU can read these registers.
PRU GPI/O questions
PRU GPO direct output mode
Q: What is the maximum speed for toggling PRU GPO pins via PRU software?
The max PRU IO speed depends on the PRU software executing on the PRU and is therefore not published.
For example, if the PRU software contained a tight loop that only toggled a PRU GPO pin, then the fastest 50% duty cycle square wave we could achieve would be 50 MHz. This is based on a 4 instruction loop (1. SET output, 2. NOP, 3. CLEAR output, 4. LOOP back to Set instruction) with the PRU running at 200 MHz. However, if the PRU needed to do any processing in addition to toggling the GPO, then that max speed starts decreasing with the number of PRU instructions that are executed between the GPO toggles.
PRU GPI 28-bit shift in
Q: When does the PRU start capturing from the input pins?
The PRU continually captures and shifts the input once the GPI mode is set to 28-bit shift mode.
Q: Can the module be modified so that the GPI start bit is a zero instead of a one?
No, the GPI start bit flag only detects the first 1 captured.
Q: What happens after 28 bit shifts?
The shift register overflows into a bit bucket.
PRU GPO shift out
Q: Can data be pre-loaded into shadow registers prior to configuring the PRU GPO mode to shift out mode?
Yes, data can be loaded into the shadow registers even when the PRU is configured for a different GPO mode by setting PRU<n>_LOAD_GPO_SH0/1. Note for AM335x, PRU<n>_LOAD_GPO_SH0/1 corresponds to pru<n>_r30[29/30]. Please refer to the technical reference manuals for other devices to confirm how PRU<n>_LOAD_GPO_SH0/1 is mapped.
Q: When does PRU<n>_CLOCKOUT start running?
PRU<n>_CLOCKOUT is a free-running clock that begins when the PRU GPO mode is set to shift out mode. It is independent of PRU<n>_ENABLE_SHIFT.
Q: When does the PRU start shifting data in the shadow registers?
The PRU starts shifting data as soon as the PRU<n>_ENABLE_SHIFT bit is set, regardless of the configured GPO mode. The output on PRU<n>_DATAOUT would only be seen if in shift out mode, but the shadow registers would still "drain" when in other GPO modes.
Q: The shadow registers are loaded by writing to PRU<n>_R30 [0:15]. Does this change the state of the corresponding device-level pins?
If any device-level pins mapped to PRU<n>_R30 [2:15] are configured for the PRU<n>_R30 [2:15] pinmux setting, then yes, these pins will reflect the value written to PRU<n>_R30. Any pin configured for a different pinmux setting will not reflect the value written to PRU<n>_R30.
Q: When the PRU<n>_ENABLE_SHIFT bit is cleared, does the PRU immediately stop shifting PRU<n>_DATAOUT?
No, when the shift operation is disabled by clearing the PRU<n>_ENABLE_SHIFT bit, the PRU will continue shifting all the data loaded in the shadow register used for GPO shifting (i.e. GPCFG0/1[PRU0/1_GPO_SH_SEL]).
Q: Does the PRU shift data out LSB or MSB first?
The PRU shifts data out LSB first. PRU<n>_R30 = SH0/1 = LSB = first bit to be shifted out.
Q: What happens to the content stored in R30 when the PRU changes to a different GPO mode?
R30 holds state when changing between GPO modes.
PRU INTC and System Event questions
Q: How can a PRU core interrupt the ARM? How can the ARM interrupt a PRU core?
The PRU can interrupt the ARM by writing to R31 and generating a system event. The PRU INTC should be pre-configured to map this system event to a Host interrupt that is connected to the ARM (ie Host 2-9 on AM335x). The ARM can interrupt a PRU by writing to the PRU INTC SRSRx register and setting a pr<k>_pru_mst_intr<x>_intr_req system event. The PRU INTC should be pre-configured to map this system event to a Host interrupt that is connected to the PRU (ie Host 0-1 on AM335x). The PRU can poll R31 bit 30 or 31 to detect an interrupt on Host 0 or 1, respectively.
Q: On devices with multiple PRU-ICSSs, how can one PRU-ICSS interrupt the other?
Check the PRU-ICSS System Event table in your device-specific reference manual on ti.com. There will be a System event tied to a PRU Host event from the other PRU-ICSS. By generating an interrupt of this Host, one PRU-ICSS can interrupt another PRU-ICSS. The other PRU-ICSS will detect this interrupt as the corresponding System event.
For example, on AM437x, the PRU can generate an interrupt on Host 7. The other PRU-ICSS will receive this as system event 56.
PRU Debugger questions
Q: When using the XDS510 USB emulator, why does the PRU Program Counter not increment correctly when stepping through PRU Disassembly code?
There is a known bug associated with PRU debug in the XDS510 USB class driver, and a different emulator should be used to debug the PRU. Two good alternatives are the XDS200 or the XDS560v2 emulators. Comparative benchmarks for various classes of XDS emulators are available at XDS_Performance_comparison.
Q: Why are no MMRs outside the PRU subsystem visible from the PRU perspective memory browser window in CCS?
The PRU core is capable of writing to the 32 bit memory map (i.e. MMRs outside of the PRU subsystem) but the PRU perspective of the CCS memory browser just cannot show those addresses. To view the full 32 bit memory map in a memory browser in CCS, the ARM core perspective or the DAP (debug access port) perspective should be used.
Note the PRU perspective memory browser includes a drop-down menu for viewing the following memories:
- Program_Memory - Instruction ram for the PRU
- Data_Memory - Data ram for the PRU
- PRU_Device_Memory - The memory map inside the PRU subsystem starting with the base address of the shared memory (0x00010000). Includes PRU shared memory and all submodules inside the PRU subsystem.
PRU Linux Driver questions
Q: How can I load (and run) firmware on AM437x PRUSS0 using the remote_proc linux driver?
As a result of shared reset logic between the two PRU subsystems in the AM437x device, the current implementation of the Linux driver (pruss_remoteproc) can only load one subsystem (two PRUs) with firmware. Since subsystem 1 (PRUSS1) has larger instruction and data rams, as well as a shared ram, the decision was made to support it, instead of PRUSS0. Support for loading both subsystems simultaneously is planned for a future release of the Linux Processor SDK but that support is not currently there.
Refer to this wiki page for instructions on how to load PRUSS0 instead of PRUSS1 while using the 126.96.36.199 version of the Linux Processor SDK for the AM437x device.