source: atk2-sc3-1.4.0-ntisr/kernel/osap.h@ 172

/*
 *  TOPPERS ATK2
 *      Toyohashi Open Platform for Embedded Real-Time Systems
 *      Automotive Kernel Version 2
 *
 *  Copyright (C) 2004-2015 by Center for Embedded Computing Systems
 *              Graduate School of Information Science, Nagoya Univ., JAPAN
 *  Copyright (C) 2011-2015 by FUJI SOFT INCORPORATED, JAPAN
 *  Copyright (C) 2011-2013 by Spansion LLC, USA
 *  Copyright (C) 2011-2015 by NEC Communication Systems, Ltd., JAPAN
 *  Copyright (C) 2011-2015 by Panasonic Advanced Technology Development Co., Ltd., JAPAN
 *  Copyright (C) 2011-2014 by Renesas Electronics Corporation, JAPAN
 *  Copyright (C) 2011-2015 by Sunny Giken Inc., JAPAN
 *  Copyright (C) 2011-2015 by TOSHIBA CORPORATION, JAPAN
 *  Copyright (C) 2011-2015 by Witz Corporation
 *  Copyright (C) 2014-2015 by AISIN COMCRUISE Co., Ltd., JAPAN
 *  Copyright (C) 2014-2015 by eSOL Co.,Ltd., JAPAN
 *  Copyright (C) 2014-2015 by SCSK Corporation, JAPAN
 *  Copyright (C) 2015 by SUZUKI MOTOR CORPORATION
 *
 *  上記著作権者
は，以下の(1)〜(4)ã®æ¡ä»¶ã‚’æº€ãŸã™å ´åˆã«é™ã‚Šï¼Œæœ¬ã‚½ãƒ•ãƒˆã‚¦ã‚§
 *  ア（本ソフトウェアを改変したものを含む．以下同じ）を使用・複製・改
 *  変・再é…
å¸ƒï¼ˆä»¥ä¸‹ï¼Œåˆ©ç”¨ã¨å‘¼ã¶ï¼‰ã™ã‚‹ã“とを無償で許諾する．
 *  (1) æœ¬ã‚½ãƒ•ãƒˆã‚¦ã‚§ã‚¢ã‚’ã‚½ãƒ¼ã‚¹ã‚³ãƒ¼ãƒ‰ã®å½¢ã§åˆ©ç”¨ã™ã‚‹å ´åˆã«ã¯ï¼Œä¸Šè¨˜ã®è‘—ä½œ
 *      権表示，この利用条件および下記の無保証規定が，そのままの形でソー
 *      スコード中に含まれていること．
 *  (2) 本ソフトウェアを，ライブラリ形式など，他のソフトウェア開発に使
 *      用できる形で再é…
å¸ƒã™ã‚‹å ´åˆã«ã¯ï¼Œå†é…
å¸ƒã«ä¼´ã†ãƒ‰ã‚­ãƒ¥ãƒ¡ãƒ³ãƒˆï¼ˆåˆ©ç”¨
 *      者
マニュアルなど）に，上記の著作権表示，この利用条件および下記
 *      の無保証規定を掲載すること．
 *  (3) 本ソフトウェアを，機器に組み込むなど，他のソフトウェア開発に使
 *      用できない形で再é…
å¸ƒã™ã‚‹å ´åˆã«ã¯ï¼Œæ¬¡ã®ã„ずれかの条件を満たすこ
 *      と．
 *    (a) 再é…
å¸ƒã«ä¼´ã†ãƒ‰ã‚­ãƒ¥ãƒ¡ãƒ³ãƒˆï¼ˆåˆ©ç”¨è€…
マニュアルなど）に，上記の著
 *        作権表示，この利用条件および下記の無保証規定を掲載すること．
 *    (b) 再é…
å¸ƒã®å½¢æ…
‹ã‚’，別に定める方法によって，TOPPERSプロジェクトに
 *        å ±å‘Šã™ã‚‹ã“ã¨ï¼Ž
 *  (4) 本ソフトウェアの利用により直接的または間接的に生じるいかなる損
 *      害からも，上記著作権者
およびTOPPERSプロジェクトをå…
è²¬ã™ã‚‹ã“と．
 *      また，本ソフトウェアのユーザまたはエンドユーザからのいかなる理
 *      由に基づく請求からも，上記著作権者
およびTOPPERSプロジェクトを
 *      å…
è²¬ã™ã‚‹ã“と．
 *
 *  本ソフトウェアは，AUTOSAR（AUTomotive Open System ARchitecture）仕
 *  様に基づいている．上記の許諾は，AUTOSARの知的財産権を許諾するもので
 *  はない．AUTOSARは，AUTOSAR仕様に基づいたソフトウェアを商用目的で利
 *  用する者
に対して，AUTOSARパートナーになることを求めている．
 *
 *  本ソフトウェアは，無保証で提供されているものである．上記著作権者
お
 *  よびTOPPERSプロジェクトは，本ソフトウェアに関して，特定の使用目的
 *  に対する適合性も含めて，いかなる保証も行わない．また，本ソフトウェ
 *  アの利用により直接的または間接的に生じたいかなる損害に関しても，そ
 *  ã®è²¬ä»»ã‚’è² ã‚ãªã„ï¼Ž
 *
 *  $Id: osap.h 425 2015-12-07 08:06:19Z witz-itoyo $
 */

/*
 *              OSアプリケーション管理機能
 */

#ifndef TOPPERS_OSAP_H
#define TOPPERS_OSAP_H

/*
 *  OSアプリケーションの属性
 */
#define TA_NONTRUSTED                   (FALSE)
#define TA_TRUSTED                              (TRUE)

/*
 *  OSアプリケーションIDからOSAPINIBを取り出すためのマクロ
 */
#define get_osapinib(osapid)    (&(osapinib_table[(osapid)]))

/*
 *  OSAPIDからOSAPCBを取り出すためのマクロ
 */
#define get_osapcb(osapid)              (&(osapcb_table[(osapid)]))

/*
 *  OSAPCBからOSアプリケーションIDを取り出すためのマクロ
 */
#define OSAPID(p_osapcb)        ((ApplicationType) ((p_osapcb) - osapcb_table))

#ifndef TOPPERS_MACRO_ONLY

typedef struct os_application_control_block OSAPCB;
#include "task.h"

/*
 *  OSアプリケーション初期化ブロック
 *
 *  OSアプリケーションに関する情
å ±ã‚’ï¼ŒOSアプリケーション制御ブロックと
 *  して定義する
 *  他のオブジェクトは，ROMに置く初期化ブロックとRAMに置く制御ブロック
 *  で構成されているが，OSアプリケーションに関する情
å ±ã¯å®Ÿè¡Œæ™‚ã«å¤‰æ›´ã•
 *  れることがないため，初期化ブロックを制御ブロックとして使用する
 *
 *  ATK2-SC3では，メモリプロテクション機能のための情
å ±ã‚’æŒãŸã›ã‚‹ãŒï¼Œ
 *  メモリプロテクション実装
はCPUに依存するため，メモリプロテクション
 *  情
å ±ã®æœ¬ä½“ã¯æ©Ÿç¨®ä¾å­˜éƒ¨ã«æŒãŸã›ã‚‹
 */
typedef struct os_application_initialization_block {
        TCB             *p_restart_tcb;                             /* OSAPのリスタートタスク管理ブロックへのポインタ */
        boolean osap_trusted;                               /* OSアプリケーションの属性 */
        uint32  btptn;                                      /* éžä¿¡é ¼OSアプリケーションのビットパターン */
#ifndef OMIT_OSAPMPUINFOB
        OSAPMPUINFOB osap_mpu;                              /* OSアプリケーションのMPU情
å ± */
#endif

} OSAPINIB;

/*
 *  OSアプリケーション管理ブロック
 */
struct os_application_control_block {
        const OSAPINIB                  *p_osapinib;                /* 初期化ブロックへのポインタ */
        ApplicationStateType    osap_stat;                  /* OSAP状æ…
‹ */
};

/*
 *  OSアプリケーション数を保持する変数の宣言（Os_Lcfg.c）
 */
extern const ApplicationType                    tnum_osap;      /* OSアプリケーションの数 */

extern const TrustedFunctionIndexType   tnum_tfn;       /* ä¿¡é ¼é–¢æ•°ã®æ•° */

typedef StatusType (*TrustedFunctionRefType)(TrustedFunctionIndexType FunctionIndex,
                                                                                         TrustedFunctionParameterRefType FunctionParams);

/*
 *  ä¿¡é ¼é–¢æ•°åˆæœŸåŒ–ãƒ–ãƒ­ãƒƒã‚¯
 */
typedef struct trusted_function_initialization_block {
        TrustedFunctionRefType  trs_func;   /* ä¿¡é ¼é–¢æ•°ã®èµ·å‹•ç•ªåœ° */
        MemorySizeType                  tf_stksz;   /* スタックサイズ */
} TFINIB;

/*
 *  OSAPCBのエリア（Os_Lcfg.c）
 */
extern OSAPCB                   osapcb_table[];

/*
 *  実行中のOSアプリケーション
 */
extern OSAPCB                   *p_runosap;

/*
 *  OSAPINIBの外部参ç…
§ï¼ˆkernel_mem.c）
 */
extern const OSAPINIB   osapinib_table[];

/*
 *  TFINIBの外部参ç…
§ï¼ˆOs_Lcfg.c）
 */
extern const TFINIB             tfinib_table[];

/*
 *  指定OSAPを終了/再起動する関数(プロテクションフックからも呼ばれる)
 */
extern void force_term_osap(OSAPCB *p_osapcb, RestartType RestartOption);

/*
 *  OSアプリケーション管理モジュールの初期化
 */
extern void osap_initialize(void);

#endif /* TOPPERS_MACRO_ONLY */

#endif /* TOPPERS_OSAP_H_ */