r_ospl_debug.c

00001 /*******************************************************************************
00002 * DISCLAIMER
00003 * This software is supplied by Renesas Electronics Corporation and is only
00004 * intended for use with Renesas products. No other uses are authorized. This
00005 * software is owned by Renesas Electronics Corporation and is protected under
00006 * all applicable laws, including copyright laws.
00007 * THIS SOFTWARE IS PROVIDED "AS IS" AND RENESAS MAKES NO WARRANTIES REGARDING
00008 * THIS SOFTWARE, WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
00009 * LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE
00010 * AND NON-INFRINGEMENT. ALL SUCH WARRANTIES ARE EXPRESSLY DISCLAIMED.
00011 * TO THE MAXIMUM EXTENT PERMITTED NOT PROHIBITED BY LAW, NEITHER RENESAS
00012 * ELECTRONICS CORPORATION NOR ANY OF ITS AFFILIATED COMPANIES SHALL BE LIABLE
00013 * FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES FOR
00014 * ANY REASON RELATED TO THIS SOFTWARE, EVEN IF RENESAS OR ITS AFFILIATES HAVE
00015 * BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
00016 * Renesas reserves the right, without notice, to make changes to this software
00017 * and to discontinue the availability of this software. By using this software,
00018 * you agree to the additional terms and conditions found by accessing the
00019 * following link:
00020 * http://www.renesas.com/disclaimer
00021 * Copyright (C) 2012 - 2015 Renesas Electronics Corporation. All rights reserved.
00022 *******************************************************************************/
00023 /**
00024 * @file  r_ospl_debug.c
00025 * @brief   Debug tools provided by OSPL.
00026 *
00027 * $Module: OSPL $ $PublicVersion: 0.90 $ (=R_OSPL_VERSION)
00028 * $Rev: 35 $
00029 * $Date:: 2014-04-15 21:38:18 +0900#$
00030 */
00031 
00032 
00033 /******************************************************************************
00034 Includes   <System Includes> , "Project Includes"
00035 ******************************************************************************/
00036 #include  "r_ospl.h"
00037 #include  "r_ospl_debug.h"
00038 #if R_OSPL_DEBUG_TOOL
00039 #include  <stdio.h>
00040 #endif
00041 
00042 /******************************************************************************
00043 Typedef definitions
00044 ******************************************************************************/
00045 
00046 /**
00047 * @struct  r_ospl_debug_watch4_t
00048 * @brief  Watch context
00049 *
00050 * @par Description
00051 *    Member variables should not be accessed.
00052 */
00053 #if R_OSPL_DEBUG_TOOL
00054 typedef struct st_r_ospl_debug_watch4_t  r_ospl_debug_watch4_t;
00055 struct st_r_ospl_debug_watch4_t {
00056     volatile const uint32_t  *Address;
00057     uint32_t  BreakValue;
00058     bool_t    IsPrintf;
00059 };
00060 static r_ospl_debug_watch4_t  g_r_ospl_debug_watch4[ 10 ];
00061 #endif
00062 
00063 
00064 /******************************************************************************
00065 Macro definitions
00066 ******************************************************************************/
00067 
00068 /******************************************************************************
00069 Imported global variables and functions (from other files)
00070 ******************************************************************************/
00071 
00072 /******************************************************************************
00073 Exported global variables and functions (to be accessed by other files)
00074 ******************************************************************************/
00075 
00076 /******************************************************************************
00077 Private global variables and functions
00078 ******************************************************************************/
00079 
00080 
00081 /***********************************************************************
00082 * Implement: R_D_Add
00083 ************************************************************************/
00084 #if R_OSPL_DEBUG_TOOL
00085 void  R_D_Add( int_fast32_t IndexNum, volatile const void *in_Address, uint32_t BreakValue, bool_t IsPrintf )
00086 {
00087     r_ospl_debug_watch4_t  *self = &g_r_ospl_debug_watch4[ IndexNum ];
00088     int_t                   r;
00089 
00090     R_OSPL_DisableAllInterrupt();
00091 
00092     if ( IS( IsPrintf ) ) {
00093         r= printf( "Debug_add( %d, 0x%08X )\n", IndexNum, (uintptr_t) in_Address );
00094         R_UNREFERENCED_VARIABLE( r ); /* QAC 3200 : This is not error information */
00095     }
00096     self->Address = (uint32_t *) in_Address;
00097     self->BreakValue = BreakValue;
00098     self->IsPrintf = IsPrintf;
00099 
00100     R_OSPL_EnableAllInterrupt();
00101 }
00102 #endif  /* R_OSPL_DEBUG_TOOL */
00103 
00104 
00105 /***********************************************************************
00106 * Implement: R_D_Watch
00107 ************************************************************************/
00108 #if R_OSPL_DEBUG_TOOL
00109 void  R_D_Watch( int_fast32_t in_IndexNum )
00110 {
00111     r_ospl_debug_watch4_t  *self = &g_r_ospl_debug_watch4[ in_IndexNum ];
00112     int_t                   r;
00113 
00114     R_OSPL_DisableAllInterrupt();
00115 
00116     if ( self->Address != NULL ) {
00117         if ( IS( self->IsPrintf ) ) {
00118             r= printf( "Debug_watch( %d ): 0x%08X\n", in_IndexNum, (uintptr_t) *self->Address );
00119             R_UNREFERENCED_VARIABLE( r ); /* QAC 3200 : This is not error information */
00120             /* Cast of "uintptr_t" is for avoiding "format" warning of GNU_ARM */
00121         }
00122         if ( *self->Address == self->BreakValue ) {
00123             R_DEBUG_BREAK();
00124         }
00125     }
00126 
00127     R_OSPL_EnableAllInterrupt();
00128 }
00129 #endif  /* R_OSPL_DEBUG_TOOL */
00130 
00131 
00132 /***********************************************************************
00133 * Implement: R_D_AddToIntLog
00134 ************************************************************************/
00135 #if R_OSPL_DEBUG_TOOL
00136 #define  IntLogBreakID  -1   /* -1=not break */
00137 
00138 volatile uint_fast32_t  g_DebugVar[ g_DebugVarCount ];
00139 volatile int_fast32_t   g_IntLog[ g_IntLogCount ];
00140 volatile int_fast32_t   g_IntLogLength;
00141 
00142 void  R_D_AddToIntLog( int_fast32_t in_Value )  /* Add to g_IntLog, g_IntLogLength */
00143 {
00144     g_IntLog[ (uint_fast32_t) g_IntLogLength % ( sizeof(g_IntLog) / sizeof(*g_IntLog) ) ] = in_Value;
00145     if ( g_IntLogLength == IntLogBreakID ) {
00146         R_DEBUG_BREAK();
00147     }
00148     g_IntLogLength += 1;
00149 }
00150 #endif  /* R_OSPL_DEBUG_TOOL */
00151 
00152 
00153 /***********************************************************************
00154 * Implement: R_D_Counter
00155 ************************************************************************/
00156 #if R_OSPL_DEBUG_TOOL
00157 bool_t  R_D_Counter( int_fast32_t *in_out_Counter, int_fast32_t TargetCount, char_t *in_Label )
00158 {
00159     int_fast32_t  counter;
00160     bool_t        is_stop;
00161     int_t         r;
00162 
00163     counter = *in_out_Counter;
00164     counter += 1;
00165     is_stop = ( counter == TargetCount );
00166     if ( in_Label != NULL ) {
00167         r= printf( "%s %d:\n", in_Label, counter );
00168         R_UNREFERENCED_VARIABLE( r );  /* QAC 3200 : This is not error information */
00169     } else {
00170         if ( counter == 1 ) {
00171             printf( "R_D_Counter address: 0x%08X\n", (uintptr_t) in_out_Counter );
00172         }
00173     }
00174     *in_out_Counter = counter;
00175 
00176     return  is_stop;
00177 }
00178 #endif  /* R_OSPL_DEBUG_TOOL */
00179 
00180