
	TOPPRES/A-WDGIF サンプルプログラム実行手順

本ドキュメントは，TOPPRES/A-WDGIFの動作確認のためのサンプルプログラムを
TOPPERS/ATK2で実行する手順を示す．

----------------------------------------------------------------------
TOPPERS/A-WDGIF
    Automotive Watchdog Interface

Copyright (C) 2014-2015 by Center for Embedded Computing Systems
                           Graduate School of Information Science, Nagoya Univ., JAPAN
Copyright (C) 2014-2015 by AISIN COMCRUISE Co., Ltd., JAPAN
Copyright (C) 2014-2015 by FUJI SOFT INCORPORATED, JAPAN
Copyright (C) 2014-2015 by NEC Communication Systems, Ltd., JAPAN
Copyright (C) 2014-2015 by Panasonic Advanced Technology Development Co., Ltd., JAPAN
Copyright (C) 2014-2015 by SCSK Corporation, JAPAN
Copyright (C) 2014-2015 by Sunny Giken Inc., JAPAN
Copyright (C) 2014-2015 by TOSHIBA CORPORATION, JAPAN
Copyright (C) 2014-2015 by Witz Corporation

上記著作権者は，以下の (1)〜(3)の条件を満たす場合に限り，本ドキュメ
ント（本ドキュメントを改変したものを含む．以下同じ）を使用・複製・改
変・再配布（以下，利用と呼ぶ）することを無償で許諾する．
(1) 本ドキュメントを利用する場合には，上記の著作権表示，この利用条件
    および下記の無保証規定が，そのままの形でドキュメント中に含まれて
    いること．
(2) 本ドキュメントを改変する場合には，ドキュメントを改変した旨の記述
    を，改変後のドキュメント中に含めること．ただし，改変後のドキュメ
    ントが，TOPPERSプロジェクト指定の開発成果物である場合には，この限
    りではない．
(3) 本ドキュメントの利用により直接的または間接的に生じるいかなる損害
    からも，上記著作権者およびTOPPERSプロジェクトを免責すること．また，
    本ドキュメントのユーザまたはエンドユーザからのいかなる理由に基づ
    く請求からも，上記著作権者およびTOPPERSプロジェクトを免責すること．

本ドキュメントは，AUTOSAR（AUTomotive Open System ARchitecture）仕様
に基づいている．上記の許諾は，AUTOSARの知的財産権を許諾するものではな
い．AUTOSARは，AUTOSAR仕様に基づいたソフトウェアを商用目的で利用する
者に対して，AUTOSARパートナーになることを求めている．

本ドキュメントは，無保証で提供されているものである．上記著作権者およ
びTOPPERSプロジェクトは，本ドキュメントに関して，特定の使用目的に対す
る適合性も含めて，いかなる保証も行わない．また，本ドキュメントの利用
により直接的または間接的に生じたいかなる損害に関しても，その責任を負
わない．

$Id: readme.txt 3492 2017-03-14 05:45:23Z suzuki-kawaguchi $
----------------------------------------------------------------------

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
(1) TOPPERS/ATK2動作環境の用意
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
TOPPERS/ATK2を入手し，付属のサンプルプログラムが動作する環境を構築する．

※以下，TOPPERS/ATK2-SC1を使用した場合の手順を示す

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
(2) WDGスタックの用意
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
atk2-sc1フォルダを相対パスで指定可能な位置へ，a-wdgstackフォルダを配置
する．

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
(3) パスの設定
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Makefileを開き，atk2-sc1フォルダへの相対パスを，環境変数SRCDIRへ設定す
る．デフォルトでは，以下のフォルダ構成を想定した状態となっている．

atk2-sc1  /cfg/cfg/cfg.exe
            :
a-wdgstack/wdgif/sample/Makefile -> SRCDIR="../../../atk2-sc1"

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
(4) WDGIFコンフィギュレーション
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
AUTOSAR仕様に従って，WDGIFのコンフィギュレーション情報をwdgif.arxmlとし
て作成する．
A-WDGIF付属のXML生成ツールを用いると，YAMLフォーマットで記述した
コンフィギュレーション情報(wdgif.yaml)をarxmlフォーマットへ変換すること
ができる．

■実行ファイル
  a-wdgstack/utils/abrex/abrex.rb

■マニュアル
  a-wdgtack/utils/abrex/readme.txt

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
(5) WDGIFジェネレーション
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
以下のコマンドにより，wdgif.arxmlからコンフィギュレーションに従ったファイ
ル群を生成する．

$ cd a-wdgstack/wdgif/sample
$ make wdgif

以下のファイルが出力されていればジェネレーションは成功となる．
  ・WdgIf_Cfg.h

※wdgif.arxmlとは別のarxmlからジェネレーションを実行したい場合，
  MakefileのWDGIF_CFGNAMEを変更する
※ジェネレーションしたファイルを削除する場合は以下を実行する
  $ make wdgifclean

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
(6) サンプルプログラム
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
———————————————————————————————————
(6.1) サンプルプログラム概要
———————————————————————————————————

本サンプルプログラムは，A-WDGIFの基本的な動作を確認するためのものであり，
以下の処理を順に実行する．

・モード設定               : WdgIf_SetMode
・トリガコンディション設定 : WdgIf_SetTriggerCondition
・バージョン情報取得       : WdgIf_GetVersionInfo

———————————————————————————————————
(6.2) ビルド＆実行
———————————————————————————————————
$ cd a-wdgstack/wdgif/sample
$ make depend
$ make
$ make run

以上．
