/******************************************************************************* | |
* Trace Recorder Library for Tracealyzer v3.1.2 | |
* Percepio AB, www.percepio.com | |
* | |
* trcConfig.h | |
* | |
* Main configuration parameters for the trace recorder library. | |
* More settings can be found in trcStreamingConfig.h and trcSnapshotConfig.h. | |
* | |
* Read more at http://percepio.com/2016/10/05/rtos-tracing/ | |
* | |
* Terms of Use | |
* This file is part of the trace recorder library (RECORDER), which is the | |
* intellectual property of Percepio AB (PERCEPIO) and provided under a | |
* license as follows. | |
* The RECORDER may be used free of charge for the purpose of recording data | |
* intended for analysis in PERCEPIO products. It may not be used or modified | |
* for other purposes without explicit permission from PERCEPIO. | |
* You may distribute the RECORDER in its original source code form, assuming | |
* this text (terms of use, disclaimer, copyright notice) is unchanged. You are | |
* allowed to distribute the RECORDER with minor modifications intended for | |
* configuration or porting of the RECORDER, e.g., to allow using it on a | |
* specific processor, processor family or with a specific communication | |
* interface. Any such modifications should be documented directly below | |
* this comment block. | |
* | |
* Disclaimer | |
* The RECORDER is being delivered to you AS IS and PERCEPIO makes no warranty | |
* as to its use or performance. PERCEPIO does not and cannot warrant the | |
* performance or results you may obtain by using the RECORDER or documentation. | |
* PERCEPIO make no warranties, express or implied, as to noninfringement of | |
* third party rights, merchantability, or fitness for any particular purpose. | |
* In no event will PERCEPIO, its technology partners, or distributors be liable | |
* to you for any consequential, incidental or special damages, including any | |
* lost profits or lost savings, even if a representative of PERCEPIO has been | |
* advised of the possibility of such damages, or for any claim by any third | |
* party. Some jurisdictions do not allow the exclusion or limitation of | |
* incidental, consequential or special damages, or the exclusion of implied | |
* warranties or limitations on how long an implied warranty may last, so the | |
* above limitations may not apply to you. | |
* | |
* Tabs are used for indent in this file (1 tab = 4 spaces) | |
* | |
* Copyright Percepio AB, 2016. | |
* www.percepio.com | |
******************************************************************************/ | |
#ifndef TRC_CONFIG_H | |
#define TRC_CONFIG_H | |
#ifdef __cplusplus | |
extern "C" { | |
#endif | |
#include "trcPortDefines.h" | |
/****************************************************************************** | |
* Include of processor header file | |
* | |
* Here you may need to include the header file for your processor. This is | |
* required at least for the ARM Cortex-M port, that uses the ARM CMSIS API. | |
* Try that in case of build problems. Otherwise, remove the #error line below. | |
*****************************************************************************/ | |
//#error "Trace Recorder: Please include your processor's header file here and remove this line." | |
/******************************************************************************* | |
* Configuration Macro: TRC_CFG_HARDWARE_PORT | |
* | |
* Specify what hardware port to use (i.e., the "timestamping driver"). | |
* | |
* All ARM Cortex-M MCUs are supported by "TRC_HARDWARE_PORT_ARM_Cortex_M". | |
* This port uses the DWT cycle counter for Cortex-M3/M4/M7 devices, which is | |
* available on most such devices. In case your device don't have DWT support, | |
* you will get an error message opening the trace. In that case, you may | |
* force the recorder to use SysTick timestamping instead, using this define: | |
* | |
* #define TRC_CFG_ARM_CM_USE_SYSTICK | |
* | |
* For ARM Cortex-M0/M0+ devices, SysTick mode is used automatically. | |
* | |
* See trcHardwarePort.h for available ports and information on how to | |
* define your own port, if not already present. | |
******************************************************************************/ | |
#define TRC_CFG_HARDWARE_PORT TRC_HARDWARE_PORT_Win32 | |
/******************************************************************************* | |
* Configuration Macro: TRC_CFG_RECORDER_MODE | |
* | |
* Specify what recording mode to use. Snapshot means that the data is saved in | |
* an internal RAM buffer, for later upload. Streaming means that the data is | |
* transferred continuously to the host PC. | |
* | |
* For more information, see http://percepio.com/2016/10/05/rtos-tracing/ | |
* and the Tracealyzer User Manual. | |
* | |
* Values: | |
* TRC_RECORDER_MODE_SNAPSHOT | |
* TRC_RECORDER_MODE_STREAMING | |
******************************************************************************/ | |
#define TRC_CFG_RECORDER_MODE TRC_RECORDER_MODE_SNAPSHOT | |
/******************************************************************************* | |
* Configuration Macro: TRC_CFG_RECORDER_BUFFER_ALLOCATION | |
* | |
* Specifies how the recorder buffer is allocated (also in case of streaming, in | |
* port using the recorder's internal temporary buffer) | |
* | |
* Values: | |
* TRC_RECORDER_BUFFER_ALLOCATION_STATIC - Static allocation (internal) | |
* TRC_RECORDER_BUFFER_ALLOCATION_DYNAMIC - Malloc in vTraceEnable | |
* TRC_RECORDER_BUFFER_ALLOCATION_CUSTOM - Use vTraceSetRecorderDataBuffer | |
* | |
* Static and dynamic mode does the allocation for you, either in compile time | |
* (static) or in runtime (malloc). | |
* The custom mode allows you to control how and where the allocation is made, | |
* for details see TRC_ALLOC_CUSTOM_BUFFER and vTraceSetRecorderDataBuffer(). | |
******************************************************************************/ | |
#define TRC_CFG_RECORDER_BUFFER_ALLOCATION TRC_RECORDER_BUFFER_ALLOCATION_STATIC | |
/****************************************************************************** | |
* TRC_CFG_FREERTOS_VERSION | |
* | |
* Specify what version of FreeRTOS that is used (don't change unless using the | |
* trace recorder library with an older version of FreeRTOS). | |
* | |
* TRC_FREERTOS_VERSION_7_3_OR_7_4 If using FreeRTOS v7.3.0 - v7.4.2 | |
* TRC_FREERTOS_VERSION_7_5_OR_7_6 If using FreeRTOS v7.5.0 - v7.6.0 | |
* TRC_FREERTOS_VERSION_8_X If using FreeRTOS v8.X.X | |
* TRC_FREERTOS_VERSION_9_X If using FreeRTOS v9.X.X | |
*****************************************************************************/ | |
#define TRC_CFG_FREERTOS_VERSION TRC_FREERTOS_VERSION_9_X | |
/****************************************************************************** | |
* TRC_CFG_MAX_ISR_NESTING | |
* | |
* Defines how many levels of interrupt nesting the recorder can handle, in | |
* case multiple ISRs are traced and ISR nesting is possible. If this | |
* is exceeded, the particular ISR will not be traced and the recorder then | |
* logs an error message. This setting is used to allocate an internal stack | |
* for keeping track of the previous execution context (4 byte per entry). | |
* | |
* This value must be a non-zero positive constant, at least 1. | |
* | |
* Default value: 8 | |
*****************************************************************************/ | |
#define TRC_CFG_MAX_ISR_NESTING 8 | |
/* Specific configuration, depending on Streaming/Snapshot mode */ | |
#if (TRC_CFG_RECORDER_MODE == TRC_RECORDER_MODE_SNAPSHOT) | |
#include "trcSnapshotConfig.h" | |
#elif (TRC_CFG_RECORDER_MODE == TRC_RECORDER_MODE_STREAMING) | |
#include "trcStreamingConfig.h" | |
#endif | |
#ifdef __cplusplus | |
} | |
#endif | |
#endif /* _TRC_CONFIG_H */ |