Updated: Now also compatible with the newlib nohost library.
As part of its SWO Trace functionality, LPCXpresso IDE v8.0.0 introduced the ability to make use of the ITM : The Instrumentation Trace Macrocell (ITM) block provides a mechanism for sending data from your target to the debugger via the SWO trade stream. This communication is achieved though a memory-mapped register interface. Data written to any of 32 stimulus registers is forwarded to the SWO stream. Unlike other SWO functionality, using the ITM stimulus ports requires changes to your code and so should not be considered non-intrusive.
Note LPCXpresso IDE v8.0.0 only supports ITM via stimulus port 0.
Scanf functionality is achieved via a special global variable, which allows the debugger to send characters from the console to the target (using the trace interface). The debugger writes data to the global variable named ITM_RxBuffer to be picked up by scanf.
To use this functionality with an LPC Open project you need to:
Include the attached file (retarget_itm.c) in your project.
Ensure you are using the redlib semihost or redlib or newlib nohost library.
Then simply add calls to printf and scanf to your code.
If you just linking against the LPCOpen Chip library, then this is all you need to do. However if you are also linking against an LPCOpen board library then you will likely see build errors of the form:
../src/retarget.h:224: multiple definition of `__sys_write'
../src/retarget.h:240: multiple definition of `__sys_readc'
Data written to the ITM stimulus port 0 is presented in this view (as below) . The view shows the ITM console for the active debug session. Text entered into this console is sent to the target if a suitable receiving buffer exists (specifically the global int32_t ITM_RxBuffer).
Note that once the target is terminated the view is cleared.
Within this view, there are the standard start and stop buttons.
When ITM trace is started, and data sent from the target will be displayed in this view.
When ITM trace is stopped, any data sent from the target will not be captured.
Note choosing to display ITM trace data has no impact on the performance of code running on the target MCU.
In addition to the standalone ITM Console view, the ITM console is also displayed as part of the standard console viewer . It can be displayed by selecting the “Display Selected Console” button and choosing the console named "<your project> ITM Console". This view persists after the target is terminated, unlike the standalone ITM console view.
Note the standard console viewer switches automatically between consoles to show consoles that are being written to. This switching can be confusing as the ITM console is easily lost among the other consoles displayed there. It is easier to keep track of the standalone ITM console.
ITM printf and semihosting printf may seem to offer similar features however there are significant differences between these two schemes.
For further information please see the following FAQs:
Original Attachment has been moved to: retarget_itm.c.zip