mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
8d43859b6a
Implements support for system level traces compatible with SEGGER SystemView tool on top of ESP32 application tracing module. That kind of traces can help to analyse program's behaviour. SystemView can show timeline of tasks/ISRs execution, context switches, statistics related to the CPUs' load distribution etc. Also this commit adds useful feature to ESP32 application tracing module: - Trace data buffering is implemented to handle temporary peaks of events load
299 lines
18 KiB
C
299 lines
18 KiB
C
/*********************************************************************
|
|
* SEGGER Microcontroller GmbH & Co. KG *
|
|
* The Embedded Experts *
|
|
**********************************************************************
|
|
* *
|
|
* (c) 2015 - 2017 SEGGER Microcontroller GmbH & Co. KG *
|
|
* *
|
|
* www.segger.com Support: support@segger.com *
|
|
* *
|
|
**********************************************************************
|
|
* *
|
|
* SEGGER SystemView * Real-time application analysis *
|
|
* *
|
|
**********************************************************************
|
|
* *
|
|
* All rights reserved. *
|
|
* *
|
|
* SEGGER strongly recommends to not make any changes *
|
|
* to or modify the source code of this software in order to stay *
|
|
* compatible with the RTT protocol and J-Link. *
|
|
* *
|
|
* Redistribution and use in source and binary forms, with or *
|
|
* without modification, are permitted provided that the following *
|
|
* conditions are met: *
|
|
* *
|
|
* o Redistributions of source code must retain the above copyright *
|
|
* notice, this list of conditions and the following disclaimer. *
|
|
* *
|
|
* o Redistributions in binary form must reproduce the above *
|
|
* copyright notice, this list of conditions and the following *
|
|
* disclaimer in the documentation and/or other materials provided *
|
|
* with the distribution. *
|
|
* *
|
|
* o Neither the name of SEGGER Microcontroller GmbH & Co. KG *
|
|
* nor the names of its contributors may be used to endorse or *
|
|
* promote products derived from this software without specific *
|
|
* prior written permission. *
|
|
* *
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND *
|
|
* CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, *
|
|
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF *
|
|
* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE *
|
|
* DISCLAIMED. IN NO EVENT SHALL SEGGER Microcontroller BE LIABLE FOR *
|
|
* ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR *
|
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT *
|
|
* OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; *
|
|
* OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF *
|
|
* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT *
|
|
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE *
|
|
* USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH *
|
|
* DAMAGE. *
|
|
* *
|
|
**********************************************************************
|
|
* *
|
|
* SystemView version: V2.42 *
|
|
* *
|
|
**********************************************************************
|
|
---------------------------END-OF-HEADER------------------------------
|
|
File : SEGGER_RTT_Conf.h
|
|
Purpose : Implementation of SEGGER real-time transfer (RTT) which
|
|
allows real-time communication on targets which support
|
|
debugger memory accesses while the CPU is running.
|
|
Revision: $Rev: 5626 $
|
|
|
|
*/
|
|
|
|
#ifndef SEGGER_RTT_CONF_H
|
|
#define SEGGER_RTT_CONF_H
|
|
|
|
#ifdef __IAR_SYSTEMS_ICC__
|
|
#include <intrinsics.h>
|
|
#endif
|
|
|
|
/*********************************************************************
|
|
*
|
|
* Defines, configurable
|
|
*
|
|
**********************************************************************
|
|
*/
|
|
|
|
#define SEGGER_RTT_MAX_NUM_UP_BUFFERS (3) // Max. number of up-buffers (T->H) available on this target (Default: 3)
|
|
#define SEGGER_RTT_MAX_NUM_DOWN_BUFFERS (3) // Max. number of down-buffers (H->T) available on this target (Default: 3)
|
|
|
|
#define BUFFER_SIZE_UP (1024) // Size of the buffer for terminal output of target, up to host (Default: 1k)
|
|
#define BUFFER_SIZE_DOWN (16) // Size of the buffer for terminal input to target from host (Usually keyboard input) (Default: 16)
|
|
|
|
#define SEGGER_RTT_PRINTF_BUFFER_SIZE (64u) // Size of buffer for RTT printf to bulk-send chars via RTT (Default: 64)
|
|
|
|
#define SEGGER_RTT_MODE_DEFAULT SEGGER_RTT_MODE_NO_BLOCK_SKIP // Mode for pre-initialized terminal channel (buffer 0)
|
|
|
|
//
|
|
// Target is not allowed to perform other RTT operations while string still has not been stored completely.
|
|
// Otherwise we would probably end up with a mixed string in the buffer.
|
|
// If using RTT from within interrupts, multiple tasks or multi processors, define the SEGGER_RTT_LOCK() and SEGGER_RTT_UNLOCK() function here.
|
|
//
|
|
// SEGGER_RTT_MAX_INTERRUPT_PRIORITY can be used in the sample lock routines on Cortex-M3/4.
|
|
// Make sure to mask all interrupts which can send RTT data, i.e. generate SystemView events, or cause task switches.
|
|
// When high-priority interrupts must not be masked while sending RTT data, SEGGER_RTT_MAX_INTERRUPT_PRIORITY needs to be adjusted accordingly.
|
|
// (Higher priority = lower priority number)
|
|
// Default value for embOS: 128u
|
|
// Default configuration in FreeRTOS: configMAX_SYSCALL_INTERRUPT_PRIORITY: ( configLIBRARY_MAX_SYSCALL_INTERRUPT_PRIORITY << (8 - configPRIO_BITS) )
|
|
// In case of doubt mask all interrupts: 1 << (8 - BASEPRI_PRIO_BITS) i.e. 1 << 5 when 3 bits are implemented in NVIC
|
|
// or define SEGGER_RTT_LOCK() to completely disable interrupts.
|
|
//
|
|
|
|
#define SEGGER_RTT_MAX_INTERRUPT_PRIORITY (0x20) // Interrupt priority to lock on SEGGER_RTT_LOCK on Cortex-M3/4 (Default: 0x20)
|
|
|
|
/*********************************************************************
|
|
*
|
|
* RTT lock configuration for SEGGER Embedded Studio,
|
|
* Rowley CrossStudio and GCC
|
|
*/
|
|
#if (defined __SES_ARM) || (defined __CROSSWORKS_ARM) || (defined __GNUC__)
|
|
#ifdef __ARM_ARCH_6M__
|
|
#define SEGGER_RTT_LOCK() { \
|
|
unsigned int LockState; \
|
|
__asm volatile ("mrs %0, primask \n\t" \
|
|
"mov r1, $1 \n\t" \
|
|
"msr primask, r1 \n\t" \
|
|
: "=r" (LockState) \
|
|
: \
|
|
: "r1" \
|
|
);
|
|
|
|
#define SEGGER_RTT_UNLOCK() __asm volatile ("msr primask, %0 \n\t" \
|
|
: \
|
|
: "r" (LockState) \
|
|
: \
|
|
); \
|
|
}
|
|
|
|
#elif (defined(__ARM_ARCH_7M__) || defined(__ARM_ARCH_7EM__))
|
|
#ifndef SEGGER_RTT_MAX_INTERRUPT_PRIORITY
|
|
#define SEGGER_RTT_MAX_INTERRUPT_PRIORITY (0x20)
|
|
#endif
|
|
#define SEGGER_RTT_LOCK() { \
|
|
unsigned int LockState; \
|
|
__asm volatile ("mrs %0, basepri \n\t" \
|
|
"mov r1, %1 \n\t" \
|
|
"msr basepri, r1 \n\t" \
|
|
: "=r" (LockState) \
|
|
: "i"(SEGGER_RTT_MAX_INTERRUPT_PRIORITY) \
|
|
: "r1" \
|
|
);
|
|
|
|
#define SEGGER_RTT_UNLOCK() __asm volatile ("msr basepri, %0 \n\t" \
|
|
: \
|
|
: "r" (LockState) \
|
|
: \
|
|
); \
|
|
}
|
|
|
|
#elif defined(__ARM_ARCH_7A__)
|
|
#define SEGGER_RTT_LOCK() { \
|
|
unsigned int LockState; \
|
|
__asm volatile ("mrs r1, CPSR \n\t" \
|
|
"mov %0, r1 \n\t" \
|
|
"orr r1, r1, #0xC0 \n\t" \
|
|
"msr CPSR_c, r1 \n\t" \
|
|
: "=r" (LockState) \
|
|
: \
|
|
: "r1" \
|
|
);
|
|
|
|
#define SEGGER_RTT_UNLOCK() __asm volatile ("mov r0, %0 \n\t" \
|
|
"mrs r1, CPSR \n\t" \
|
|
"bic r1, r1, #0xC0 \n\t" \
|
|
"and r0, r0, #0xC0 \n\t" \
|
|
"orr r1, r1, r0 \n\t" \
|
|
"msr CPSR_c, r1 \n\t" \
|
|
: \
|
|
: "r" (LockState) \
|
|
: "r0", "r1" \
|
|
); \
|
|
}
|
|
#else
|
|
#define SEGGER_RTT_LOCK()
|
|
#define SEGGER_RTT_UNLOCK()
|
|
#endif
|
|
#endif
|
|
|
|
/*********************************************************************
|
|
*
|
|
* RTT lock configuration for IAR EWARM
|
|
*/
|
|
#ifdef __ICCARM__
|
|
#if (defined (__ARM6M__) && (__CORE__ == __ARM6M__))
|
|
#define SEGGER_RTT_LOCK() { \
|
|
unsigned int LockState; \
|
|
LockState = __get_PRIMASK(); \
|
|
__set_PRIMASK(1);
|
|
|
|
#define SEGGER_RTT_UNLOCK() __set_PRIMASK(LockState); \
|
|
}
|
|
#elif ((defined (__ARM7EM__) && (__CORE__ == __ARM7EM__)) || (defined (__ARM7M__) && (__CORE__ == __ARM7M__)))
|
|
#ifndef SEGGER_RTT_MAX_INTERRUPT_PRIORITY
|
|
#define SEGGER_RTT_MAX_INTERRUPT_PRIORITY (0x20)
|
|
#endif
|
|
#define SEGGER_RTT_LOCK() { \
|
|
unsigned int LockState; \
|
|
LockState = __get_BASEPRI(); \
|
|
__set_BASEPRI(SEGGER_RTT_MAX_INTERRUPT_PRIORITY);
|
|
|
|
#define SEGGER_RTT_UNLOCK() __set_BASEPRI(LockState); \
|
|
}
|
|
#endif
|
|
#endif
|
|
|
|
/*********************************************************************
|
|
*
|
|
* RTT lock configuration for IAR RX
|
|
*/
|
|
#ifdef __ICCRX__
|
|
#define SEGGER_RTT_LOCK() { \
|
|
unsigned long LockState; \
|
|
LockState = __get_interrupt_state(); \
|
|
__disable_interrupt();
|
|
|
|
#define SEGGER_RTT_UNLOCK() __set_interrupt_state(LockState); \
|
|
}
|
|
#endif
|
|
|
|
/*********************************************************************
|
|
*
|
|
* RTT lock configuration for KEIL ARM
|
|
*/
|
|
#ifdef __CC_ARM
|
|
#if (defined __TARGET_ARCH_6S_M)
|
|
#define SEGGER_RTT_LOCK() { \
|
|
unsigned int LockState; \
|
|
register unsigned char PRIMASK __asm( "primask"); \
|
|
LockState = PRIMASK; \
|
|
PRIMASK = 1u; \
|
|
__schedule_barrier();
|
|
|
|
#define SEGGER_RTT_UNLOCK() PRIMASK = LockState; \
|
|
__schedule_barrier(); \
|
|
}
|
|
#elif (defined(__TARGET_ARCH_7_M) || defined(__TARGET_ARCH_7E_M))
|
|
#ifndef SEGGER_RTT_MAX_INTERRUPT_PRIORITY
|
|
#define SEGGER_RTT_MAX_INTERRUPT_PRIORITY (0x20)
|
|
#endif
|
|
#define SEGGER_RTT_LOCK() { \
|
|
unsigned int LockState; \
|
|
register unsigned char BASEPRI __asm( "basepri"); \
|
|
LockState = BASEPRI; \
|
|
BASEPRI = SEGGER_RTT_MAX_INTERRUPT_PRIORITY; \
|
|
__schedule_barrier();
|
|
|
|
#define SEGGER_RTT_UNLOCK() BASEPRI = LockState; \
|
|
__schedule_barrier(); \
|
|
}
|
|
#endif
|
|
#endif
|
|
|
|
/*********************************************************************
|
|
*
|
|
* RTT lock configuration for TI ARM
|
|
*/
|
|
#ifdef __TI_ARM__
|
|
#if defined (__TI_ARM_V6M0__)
|
|
#define SEGGER_RTT_LOCK() { \
|
|
unsigned int LockState; \
|
|
LockState = __get_PRIMASK(); \
|
|
__set_PRIMASK(1);
|
|
|
|
#define SEGGER_RTT_UNLOCK() __set_PRIMASK(LockState); \
|
|
}
|
|
#elif (defined (__TI_ARM_V7M3__) || defined (__TI_ARM_V7M4__))
|
|
#ifndef SEGGER_RTT_MAX_INTERRUPT_PRIORITY
|
|
#define SEGGER_RTT_MAX_INTERRUPT_PRIORITY (0x20)
|
|
#endif
|
|
#define SEGGER_RTT_LOCK() { \
|
|
unsigned int LockState; \
|
|
LockState = OS_GetBASEPRI(); \
|
|
OS_SetBASEPRI(SEGGER_RTT_MAX_INTERRUPT_PRIORITY);
|
|
|
|
#define SEGGER_RTT_UNLOCK() OS_SetBASEPRI(LockState); \
|
|
}
|
|
#endif
|
|
#endif
|
|
|
|
/*********************************************************************
|
|
*
|
|
* RTT lock configuration fallback
|
|
*/
|
|
#ifndef SEGGER_RTT_LOCK
|
|
void SEGGER_SYSVIEW_X_RTT_Lock();
|
|
#define SEGGER_RTT_LOCK() SEGGER_SYSVIEW_X_RTT_Lock() // Lock RTT (nestable) (i.e. disable interrupts)
|
|
#endif
|
|
|
|
#ifndef SEGGER_RTT_UNLOCK
|
|
void SEGGER_SYSVIEW_X_RTT_Unlock();
|
|
#define SEGGER_RTT_UNLOCK() SEGGER_SYSVIEW_X_RTT_Unlock() // Unlock RTT (nestable) (i.e. enable previous interrupt lock state)
|
|
#endif
|
|
|
|
#endif
|
|
/*************************** End of file ****************************/
|