/*""FILE COMMENT""*************************************************************
*
*       System Name : SH7262 FRK Porting Kit V1.0
*       File Name   : readme.txt
*       Contents    : SH7262 FRK Porting Kit sample program
*
*       note        :
*
*                     <注意事項>
*                     本サンプルプログラムはすべて参考資料であり、その
*                     動作を保証するものではありません。
*                     本サンプルプログラムはお客様のソフトウエア開発時
*                     の技術参考資料としてご利用ください。
*
*       The information described here may contain technical
*       inaccuracies or typographical errors. Renesas Electronics
*       Corporation assume no responsibility for any damage, liability, 
*       or other loss rising from these inaccuracies or errors.
*
*       Copyright (C) 2010 Renesas Electronics Corporation. All Rights Reserved
*
*""FILE COMMENT END""*********************************************************/

1. 概要

1.1 サポートドライバ
 タッチパネル付ディスプレイドライバ(LCD)
 ファイルシステム用USB Hostドライバ
 ファイルシステム用SDドライバ
 シリアルフラッシュドライバ
 デバッグシリアルドライバ（SDIF3)

1.2 サポートプロジェクト
　TinyCLR、NativeSample
　　TinyCLR:
            .NET Micro Frameworkオブジェクトです。
　　　　　　本プロジェクトで生成されたオブジェクトをフラッシュメモリに
　　　　　　ダウンロードすれば、以降、Visual Studioアプリケーションでの
　　　　　　アプリケーション開発が可能です。
　　　　　　また、TinyCLR自体にアプリケーションを含むことも可能です。
　　NativeSample:
	   .NET Micro Frameworkに依存することなく、ドライバの
	   デバッグを行うためのプロジェクトです。
           NaticeSample.cppにドライバをデバッグするためのコードを自由
           に書くことができます。


2. ビルド環境セットアップ

2.1 コンパイラ
  Renesas C/C++ Compiler Package for SuperH RISC engine family V.9.02 Release 00かそれ以降
　のバージョンのSHCコンパイラをインストールしてください。
　
　以下、SHCコンパイラが以下フォルダにインストールされたと仮定します。
　c:\Program Files\Renesas\Hew\Tools\Renesas\Shx_y_z*

     注：*x_y_z はSHCコンパイラのバージョンです。

2.2 環境設定
　Porting Kitのビルドにはコマンドプロンプトを使用します。
　コマンドプロンプトからPorting Kitをビルドできるようにするための
　環境設定方法は以下です。
  1) コマンドプロンプトを開いてください
　2) 以下のようにカレントフォルダを変更してください
　　C:\MicroFrameworkPK_v4_1
  3) 以下を入力してください。
    setenv_shc "c:\Program Files\Renesas\Hew\Tools\Renesas\Sh\x_y_z*"

     注：*x_y_z はSHCコンパイラのバージョンです。SHC V.9.02をご使用の場合は
　　　　 9_2_0と入力してください。

3 ビルド
　1) コマンドプロンプトから以下のように入力し、カレントフォルダを変更してください。
　　cd solutions\SH7262_FRK_SH2A

　2)ビルド用コマンドを入力してください。

　コマンドラインシンタックスは以下です。
   Msbuild dotnetmf.proj /t:build /p:flavor=debug
      Flavor: <debug|release|rtm>

　debug:Visual StudioによるアプリケーションのDeploymentやデバッグが可能です。
　　　　Porting Kit自体をE10A-USB等ICEでデバッグすることも可能です。
　release:Visual StudioによるアプリケーションのDeploymentやデバッグが可能です。
　　　  Porting KitをE10A-USB等ICEでデバッグすることはできません。
　rtm: 最終形式のビルドです。生成モジュールはアプリケーションを含むことができます。
　　　 デバッグリソースが切り離され、メモリ容量を小さくできます。
　　　 Visual StudioによるアプリケーションのDeploymentやデバッグはできません。 

　　ビルドしたファイルは以下のフォルダに格納されています。
　　　C:\MicroFrameworkPK_v4_1\BuildOutput\SH2A\SHC9.2\Be\FLASH\debug\SH7262_FRK_SH2A\bin
　　rtmオプションでビルドを行った場合、上記パス内の"debug"の部分が"rtm"となります。
　　このフォルダ内に以下のファイルが生成されていることを確認してください。
　　　-NativeSample用オブジェクトファイル
　　　　NativeSample.abs, NativeSample.hex
　　　-TinyCLR用オブジェクトファイル
　　　　TinyCLR.abs, TinyCLR.hex, tinyclr.dat

4.　フラッシュ書き込み用ロードモジュールUSERROM.BIN作成
　USERROM.BIN作成には、Hewのシミュレータ機能を使います。 

  1) C:\MicroFrameworkPK_v4_1\Solutions\SH7262_FRK_SH2A\doc フォルダ内の
　　　henkan.zipを解凍してください。

  2) henkan.hwsをダブルクリックしてHewを起動してください。

　3) 「周辺機能シミュレーションの設定」ダイアログボックスが表示
　　された場合、キャンセルを押してください。

　4) Hewの「基本設定」メニューから「シミュレータ」->「メモリリソース」
　　を選択してください。
　　「シミュレータシステム」ダイアログボックスの「メモリ」タブを参照
　　してください。右側のウインドウ内に0x00000000-0x0033FFFFの領域が
　　リードライト属性で設定されていることを確認してください。
　　されていない場合、メモリリソースを追加してください。

　5) ワークスペースフォルダ内に"files"フォルダがあります。
　　このフォルダ内に、先ほどビルドしたファイルをコピーします。
    TinyCLRプロジェクトで生成されたファイルをフラッシュメモリにダウンロード
　　する場合、TinyCLR.hex, tinyclr.datをコピーしてください。
    NativeSampleプロジェクトで生成されたファイルをフラッシュメモリにダウンロード
　　する場合、NativeSample.hexをコピーしてください。

　6) Hewのコマンドラインウインドウから、バッチファイルを実行します。
　　大抵の場合、コマンドラインウインドウはHew画面の左下に表示されています。
　　コマンドラインウインドウ上で右クリックし、「バッチファイル指定」を選択
　　してください。
　　「バッチファイルを指定」ダイアログボックスが表示されますので、
　　　-TinyCLRの場合：$(PROJDIR)\batchfile.hdc
　　　-NativeSampleの場合：$(PROJDIR)\batchfile_nativesample.hdc
　　を選択し、「実行」ボタンを押してください。
　　バッチファイルの実行が正常終了すると、filesフォルダ内にUSERROM.BINが
　　生成されます。

  7) Hewを終了し閉じてください。
 

5.　USERROM.BINをフラッシュメモリに書き込む
　　CQ出版殿より提供されている、フラッシュメモリ書き込み用Hewワークスペース
　　sh7264_sflash_loader_LCDboardExBus.zipを使用します。

　　1) sh7264_sflash_loader_LCDboardExBus.zipを解凍してください。

　　2) SPIwriterUser.hwsをダブルクリックし、Hewを起動してください。

　　3) SPIwriterUser.hwsと同じフォルダ内に、先ほど作成したUSERROM.BIN
　　　を上書きコピーしてください。

　　4) Hewから、SPIwriterUser.absとUSERROM.BINをダウンロードしてください。
　　　その際、「ファイルを開く」ダイアログボックスが数回表示されることが
　　　ありますが、キャンセルを押してください。
　
　　5) Hewのメニューから「デバッグ」->「実行」を選択してください。
　　　 フラッシュメモリへの書き込みが開始されます。
　　　 書き込みが終了するまで数分かかります。

　　6) 書き込みが正常終了すると、SH7262 CPUボード上のLEDがゆっくりと点滅します。 
　　　STOPボタンを押した後、Hewを終了してください。

6 動作確認
　以上でフラッシュメモリにTinyCLRやNativeSampleを書き込む手順は終了です。
　以下の手順で、正常に書き込めたかどうかをチェックできます。

　1) 実機上のSCIF3コネクタとPCを、シリアルクロスケーブルで接続してください。
　
　2) PC上で、teraterm等のシリアルCOMターミナルを開いてください。

　3) シリアルCOMターミナルの設定を以下ようにしてください。
　　　ボーレート：115200 bps
      データ：8 bit
      パリティ：なし
　　　ストップビット：1ビット
　　　フロー制御：なし

　4) 実機の電源を入れてください。
　　-TinyCLRの場合、シリアルCOMターミナルにTinyCLRが起動したことを
　　  示すログが表示されます。

　　　TinyCLRビルド生成時にアプリケーションをインクルードしていない場合
　　　（通常の場合）、Waiting for debug commands...と表示されます。
　　　途中、MSdbgV1z...のような、文字化けのような文字列が表示されますが
　　　これはVisual Studoとの通信文字列であるため問題ありません。
　　　これでVisual Studio経由でアプリケーション開発が可能となります。

　　　TinyCLRビルド生成時にアプリケーションをインクルードしている場合は
　　　そのアプリケーションが動作します。

　　-NativeSampleの場合、シリアルCOMターミナルに以下のように表示されます。
　　　>SH7262 FRK .NET Micro Framework
　　　>
　　 ここで、
　　　dt <rtn>
     と入力すると、テストが開始されます。

以上
