README

SWV (Single Wire Viewer) collection tools
Copyright 2016 Alexandre Bailon

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

itm.py
Provides an abstract class to decode ITM trace.
It suports both hardware and software trace.

swo_viewer.py
Display ITM traces in readable format:
 - Decode and display HW traces
 - print characters comming from stimulus 0
 - print traces stimulus number and value for traces comming from other stimulus
Usage: swo_viewer.py -i itm_trace_file

gprof.py
Post process ITM traces that contain a pc address and convert them into
a gprof file.

arc format:
-------------------------------------------------------------------------------
|Packet number | Stimulus | Payload size | Desc                               |
-------------------------------------------------------------------------------
| 1            | 3        |   4 bytes    | PC address of the caller           |
-------------------------------------------------------------------------------
| 2            | 2        |   4 bytes    | PC address of the callee           |
-------------------------------------------------------------------------------

pc sample format:
-------------------------------------------------------------------------------
|Packet number | Stimulus | Payload size | Desc                               |
-------------------------------------------------------------------------------
| 1            | 2        |   4 bytes    | Current PC address                 |
-------------------------------------------------------------------------------
Note that the PC sample can be generated by the DWT PC sampler.

Usage: gprof.py -i <swo_trace_file> [-o <gmon_file>]