source: EcnlProtoTool/trunk/asp3_dcre/arch/tracelog/trace_log.h@ 270

/*
 *  TOPPERS Software
 *      Toyohashi Open Platform for Embedded Real-Time Systems
 * 
 *  Copyright (C) 2000-2003 by Embedded and Real-Time Systems Laboratory
 *                              Toyohashi Univ. of Technology, JAPAN
 *  Copyright (C) 2004-2016 by Embedded and Real-Time Systems Laboratory
 *              Graduate School of Information Science, Nagoya Univ., JAPAN
 * 
 *  上記著作権者
は，以下の(1)～(4)ã®æ¡ä»¶ã‚’æº€ãŸã™å ´åˆã«é™ã‚Šï¼Œæœ¬ã‚½ãƒ•ãƒˆã‚¦ã‚§
 *  ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改
 *  変・再é…
å¸ƒï¼ˆä»¥ä¸‹ï¼Œåˆ©ç”¨ã¨å‘¼ã¶ï¼‰ã™ã‚‹ã“とを無償で許諾する．
 *  (1) æœ¬ã‚½ãƒ•ãƒˆã‚¦ã‚§ã‚¢ã‚’ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã®å½¢ã§åˆ©ç”¨ã™ã‚‹å ´åˆã«ã¯ï¼Œä¸Šè¨˜ã®è‘—ä½œ
 *      権表示，この利用条件および下記の無保証規定が，そのままの形でソー
 *      スコード中に含まれていること．
 *  (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
 *      用できる形で再é…
å¸ƒã™ã‚‹å ´åˆã«ã¯ï¼Œå†é…
å¸ƒã«ä¼´ã†ãƒ‰ã‚­ãƒ¥ãƒ¡ãƒ³ãƒˆï¼ˆåˆ©ç”¨
 *      者
マニュアルなど）に，上記の著作権表示，この利用条件および下記
 *      の無保証規定を掲載すること．
 *  (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
 *      用できない形で再é…
å¸ƒã™ã‚‹å ´åˆã«ã¯ï¼Œæ¬¡ã®ã„ずれかの条件を満たすこ
 *      と．
 *    (a) 再é…
å¸ƒã«ä¼´ã†ãƒ‰ã‚­ãƒ¥ãƒ¡ãƒ³ãƒˆï¼ˆåˆ©ç”¨è€…
マニュアルなど）に，上記の著
 *        作権表示，この利用条件および下記の無保証規定を掲載すること．
 *    (b) 再é…
å¸ƒã®å½¢æ…
‹ã‚’，別に定める方法によって，TOPPERSプロジェクトに
 *        å ±å‘Šã™ã‚‹ã“ã¨ï¼Ž
 *  (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
 *      害からも，上記著作権者
およびTOPPERSプロジェクトをå…
è²¬ã™ã‚‹ã“と．
 *      また，本ソフトウェアのユーザまたはエンドユーザからのいかなる理
 *      由に基づく請求からも，上記著作権者
およびTOPPERSプロジェクトを
 *      å…
è²¬ã™ã‚‹ã“と．
 * 
 *  本ソフトウェアは，無保証で提供されているものである．上記著作権者
お
 *  よびTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的
 *  に対する適合性も含めて，いかなる保証も行わない．また，本ソフトウェ
 *  アの利用により直接的または間接的に生じたいかなる損害に関しても，そ
 *  ã®è²¬ä»»ã‚’è² ã‚ãªã„ï¼Ž
 * 
 *  $Id: trace_log.h 270 2017-02-09 04:03:47Z coas-nagasima $
 */

/*
 *              トレースログに関する設定
 *
 *  このインクルードファイルは，target_kernel_impl.hおよび
 *  target_syssvc.hのみからインクルードされる．また，トレースログ機能の
 *  初期化や記録の開始／停止，トレースログのダンプを行うプログラムから
 *  インクルードすることを想定している．
 */

#ifndef TOPPERS_TRACE_CONFIG_H
#define TOPPERS_TRACE_CONFIG_H

/*
 *  ãƒˆãƒ¬ãƒ¼ã‚¹ãƒ­ã‚°ã®ãƒ‡ãƒ¼ã‚¿æ§‹é€ 
 *
 *  システムログ機能のログ情
å ±ã®ãƒ‡ãƒ¼ã‚¿æ§‹é€ ã¨åŒã˜ã‚‚ã®ã‚’ç”¨ã„ã‚‹ï¼Ž
 */
#ifndef TOPPERS_MACRO_ONLY

#include <t_syslog.h>
typedef SYSLOG  TRACE;

#endif /* TOPPERS_MACRO_ONLY */

/*
 *  トレースモードの定義
 */
#define TRACE_STOP                      UINT_C(0x00)    /* トレース停止 */
#define TRACE_RINGBUF           UINT_C(0x01)    /* リングバッファモード */
#define TRACE_AUTOSTOP          UINT_C(0x02)    /* 自動停止モード */
#define TRACE_CLEAR                     UINT_C(0x04)    /* トレースログのクリア */

#ifndef TOPPERS_MACRO_ONLY

/*
 *  TECSで記述されたテストプログラム用のサービスを直接呼び出すための定義
 *
 *  C言語で記述されたアプリケーションから，TECSで記述されたトレースログ
 *  機能を呼び出すためには，アダプタを用いるのが正当な方法であるが，ト
 *  レースログ機能がシングルトンであることを利用して直接呼び出す．
 */
extern ER       tTraceLog_eTraceLog_start(MODE mode);
extern ER       tTraceLog_eTraceLog_write(const TRACE *p_trace);
extern ER       tTraceLog_eTraceLog_read(TRACE* p_trace);
extern void     tTraceLog_eTraceLog_dump(void);

/*
 *  トレースログの開始
 *
 *  トレースログの記録を開始／停止する．引数により次の動作を行う．
 *
 *  TRACE_STOP：トレースを停止．
 *  TRACE_RINGBUF：リングバッファモードでトレースを開始．
 *  TRACE_AUTOSTOP：自動停止モードでトレースを開始．
 *  TRACE_CLEAR：トレースログをクリア．
 */
Inline ER
trace_sta_log(MODE mode)
{
        return(tTraceLog_eTraceLog_start(mode));
}

/*
 *  トレースログの書込み
 */
Inline ER
trace_wri_log(TRACE *p_trace)
{
        return(tTraceLog_eTraceLog_write(p_trace));
}

/*
 *  トレースログの読出し
 */
Inline ER
trace_rea_log(TRACE *p_trace)
{
        return(tTraceLog_eTraceLog_read(p_trace));
}

/*
 *  トレースログを出力するためのライブラリ関数
 */

Inline void
trace_write_0(uint_t type)
{
        TRACE   trace;

        trace.logtype = type;
        (void) trace_wri_log(&trace);
}

Inline void
trace_write_1(uint_t type, intptr_t arg1)
{
        TRACE   trace;

        trace.logtype = type;
        trace.logpar[0] = arg1;
        (void) trace_wri_log(&trace);
}

Inline void
trace_write_2(uint_t type, intptr_t arg1, intptr_t arg2)
{
        TRACE   trace;

        trace.logtype = type;
        trace.logpar[0] = arg1;
        trace.logpar[1] = arg2;
        (void) trace_wri_log(&trace);
}

Inline void
trace_write_3(uint_t type, intptr_t arg1, intptr_t arg2, intptr_t arg3)
{
        TRACE   trace;

        trace.logtype = type;
        trace.logpar[0] = arg1;
        trace.logpar[1] = arg2;
        trace.logpar[2] = arg3;
        (void) trace_wri_log(&trace);
}
                                                                                                                
/*
 *  トレースログを出力するためのマクロ
 */

#define trace_0(type) \
                                trace_write_0(type)

#define trace_1(type, arg1) \
                                trace_write_1(type, (intptr_t)(arg1))

#define trace_2(type, arg1, arg2) \
                                trace_write_2(type, (intptr_t)(arg1), (intptr_t)(arg2))

#define trace_3(type, arg1, arg2, arg3) \
                                trace_write_3(type, (intptr_t)(arg1), (intptr_t)(arg2), \
                                                                                                                (intptr_t)(arg3))

/* 
 *  トレースログのダンプ
 *
 *  トレースログをダンプする．終了処理ルーチンとして登録することも想定
 *  している．引数として，ダンプå…
ˆã¨ãªã‚‹æ–‡å­—出力関数へのポインタを渡す．
 *  ã‚¿ãƒ¼ã‚²ãƒƒãƒˆä¾å­˜ã®ä½Žãƒ¬ãƒ™ãƒ«æ–‡å­—å‡ºåŠ›ã‚’åˆ©ç”¨ã™ã‚‹å ´åˆã«ã¯ï¼Œtarget_putcを渡
 *  す．
 */
Inline void
trace_dump(void)
{
        tTraceLog_eTraceLog_dump();
}

#endif /* TOPPERS_MACRO_ONLY */

/*
 *  トレースログ方法の設定
 */
#define LOG_TSKSTAT(p_tcb)              trace_2(LOG_TYPE_TSKSTAT, p_tcb, p_tcb->tstat)

#define LOG_DSP_LEAVE(p_tcb)    trace_1(LOG_TYPE_DSP|LOG_LEAVE, p_tcb)

#define LOG_TSYSLOG_ESYSLOG_WRITE_ENTER(priority, p_syslog) \
                                                                trace_wri_log((TRACE *) p_syslog)

#endif /* TOPPERS_TRACE_CONFIG_H */