
Tracealyzer Trace Recorder Library
-------------------------------------
Percepio AB
www.percepio.com

This directory contains the a generic trace recorder library for Tracealyzer v2.5. 

For information on how to upload the trace data from your target system RAM to 
Tracealyzer, see "debugger trace upload.txt"

Files included
--------------
- trcConfig.h               - The recorder's configuration file, check this!
- trcUser.c / trcUser.h     - The main API towards the application (trcUser.h in the only include necessary).
- trcKernel.c / trcKernel.h - Internal routines for storing kernel events.
- trcBase.c / trcBase.h     - Internal routines for manipulating the data structures and calculating timestamps.
- trcHardwarePort.c / trcHardwarePort.h     - The port layer, abstracting the hardware (mainly the timer used for timestamping).
- trcKernelHooks.h				- The interface between the Kernel and the recorder, containing trace macro defintions.
- trcKernelPort.h				- Kernel specific implementations of macros and data.
- trcTypes.h				- Type definitions used.

Hardware Timer Ports
--------------------
This release contains hardware timer ports for the following hardware architectures:

- ARM Cortex M3/M4 (all brands, such as Atmel SAM3/SAM4, NXP 17xx, 18xx, 43xx, STM32, Freescale Kinetis, ...)
- Atmel AT91SAM7x
- Atmel AT32UC3 (AVR32)
- Renesas RX600 (e.g., RX62N)
- Microchip dsPIC/PIC24

These are defined in trcPort.h. This also contains several "unofficial" ports, provided by external contributors.
By unofficial, it means that they are not yet verified by Percepio AB. Please refer to trcPort.h for detailed information. 
If you use an unofficial port and beleive it is incorrect, please let us know!

In case your MCU is not yet supported directly, developing a new port is quite easy, just a matter of defining a few macros
according to your specific MCU. See trcPort.h for further information.

In case you have any questions, do not hesitate to contact support@percepio.com

Percepio AB
Köpmangatan 1A
72215 Västerås
Sweden

www.percepio.com