/********************************************************************* | |
* SEGGER MICROCONTROLLER GmbH & Co. KG * | |
* Solutions for real time microcontroller applications * | |
********************************************************************** | |
* * | |
* (c) 2014 - 2016 SEGGER Microcontroller GmbH & Co. KG * | |
* * | |
* www.segger.com Support: support@segger.com * | |
* * | |
********************************************************************** | |
* * | |
* SEGGER RTT * Real Time Transfer for embedded targets * | |
* * | |
********************************************************************** | |
* * | |
* All rights reserved. * | |
* * | |
* * This software may in its unmodified form be freely redistributed * | |
* in source, linkable, or executable form. * | |
* * The source code may be modified, provided the source code * | |
* retains the above copyright notice, this list of conditions and * | |
* the following disclaimer. * | |
* * Modified versions of this software in source, executable, or * | |
* linkable form may not be distributed without prior consent of * | |
* SEGGER. * | |
* * This software may only be used for communication with SEGGER * | |
* J-Link debug probes. * | |
* * | |
* 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. * | |
* * | |
********************************************************************** | |
* * | |
* RTT version: 6.00e * | |
* * | |
********************************************************************** | |
---------------------------------------------------------------------- | |
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: 3892 $ | |
---------------------------END-OF-HEADER------------------------------ | |
*/ | |
#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 (64) // 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 fallback | |
*/ | |
#ifndef SEGGER_RTT_LOCK | |
#define SEGGER_RTT_LOCK() // Lock RTT (nestable) (i.e. disable interrupts) | |
#endif | |
#ifndef SEGGER_RTT_UNLOCK | |
#define SEGGER_RTT_UNLOCK() // Unlock RTT (nestable) (i.e. enable previous interrupt lock state) | |
#endif | |
#endif | |
/*************************** End of file ****************************/ |