EZ-FPGA Controller 'ezfc' Version 1.01 説明書 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− 改訂履歴 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− 2006.3.2 　jtagspi転送後、USERタップを閉じるように変更 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− 　プログラム概要 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− 　EZ-FPGA用の総合制御ソフトです。 　EZ-FPGA上のFPGAのコンフィグレーション、コンフィグ後のJTAG通信、 及びコンフィグレーションROMの書き込み動作を制御できます。 　EZFCON.EXEはWin32ベースのCUIプログラムです。 ２．対応ハードウェア 　１．EZ-FPGA + mini EZ-USB 　　EZ-USB用のデバイスドライバがインストールされている必要があります。 　２．EZ-FPGA + XilinxParalellCableIII またはその互換ケーブル 　　I/Oポートを直接操作に、giveio.sysドライバのインストールされて 　いる必要があります。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− 　コマンドライン −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− 起動方法１：コマンドプロンプトから、"ezfc [スクリプトファイル名]"と入力する。 起動方法２：Windowsエスプローラから、スクリプトファイルをezfc.exe 　　　　　　のアイコンにドラッグ＆ドロップする。 起動方法３：予めスクリプトファイルの拡張子(".ezf")をezfc.exeに関連 　　　　　　ずけておき、スクリプトファイルをダブルクリックする。 　コマンドラインで指定する[スクリプトファイル名]は、callスクリプト コマンドとして、実行されます。 　予めテキストファイルにスクリプト命令を書いておき、そのファイル名 を起動パラメーターとして指定します。 　スクリプト命令の実行中にエラーが発生すると、そこで実行を中断します。 　スクリプトファイル内から他のスクリプトファイルを呼び出している場合でも、 エラーが発生した時点で実行は中断されます。 　エクスプローラから起動した場合にはプログラムの終了と同時にウィンドウが 閉じるため、デフォルトではプログラム終了時にキー入力待ちをするようになっ ています。 　コマンドプロンプトから起動する場合は、スクリプト命令"pause off"を実行 しておくことで、プログラム終了時のキー入力待ちをキャンセルできます。 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− 　スクリプト命令 −−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−−− −−−−−−−−−−−−−−−−−−− 制御関連コマンド −−−−−−−−−−−−−−−−−−− 　１）コメント 　　構文:# コメント 　　スクリプト命令中行の、'#'以降はすべて無視されます。 　２）エコーメッセージ 　　構文:echo メッセージ 　　コンソールにメッセージを表示します。 　３）JTAGプローブ指定＆初期化 　　構文：jinit ポート番号 　　JATAGプローブを指定したポートで初期化します。 　　ポート番号１６進数で指定し、上位４桁がデバイス番号、 　　下位４桁がマイナー番号です。 　　　ポート番号に０を指定すると、下記の順番で自動検索します。 　　　　１．EZ-USB No.0 (ポート番号＝00010000) 　　　　２．XilinxPAralellCableIII LPT1(ポート番号=00020378) 　　デバイス番号 0001xxxx : mini EZ-USB(AN2131SC/2135SC EEPROM無し） 　　　　　　 　下位４桁は、EZ-USBの通し番号 0002xxxx : XilinxPAralellCableIII(LPTポート） 　　　　　　 　下位４桁は、パラレルポートのI/Oベースアドレス 　　JTAG関連の操作を行う前に、まずこのコマンドを実行してプローブ 　を初期化する必要があります。 　　例１：jinit 0 #EZ-USB No.0かLPT1(0x378)を指定 　　例１：jinit 00010002 #EZ-USB No.2をJTAGプローブ指定 　　例２：jinit 00020278 #XilinxPAralellCableIII 0x278で初期化 　４）カレントディレクトリの変更 　　構文：cd パス load,saveなどファイル関連命令のカレントディレクトリになります。 　５）一時停止 　　構文：wait time_msec 　　time_msec x 1msecの間、処理を停止します。 　６）ポーズ指定 　　構文１：pause 　　構文２：pause on 　　構文３：pause off 　　構文１は、その場で任意のキー入力を待ちます。 　　構文２は、プログラム終了時にキー入力待ちするように指定し、構文３は 　それを解除します。デフォルトは"pause on"になっています。 　７）スクリプトファイル実行 　　構文１：call filename 　　構文２：filename 　　filenameで指定したスクリプトファイルを実行します。 　　filenameで指定したスクリプトファイルを実行し終わると、以下の命令に 　処理が戻ります。 　　call命令は、ネストすることが出来ます。 　　構文２の場合は、filenameがスクリプトコマンドと重複してはいけません。 　　filenameがフルパス(文字':'及び'\'を含む場合）で指定された場合、スクリプト 　ファイル実行時に、カレントディレクトリがfilenameのディレクトリに変更され、 　スクリプトファイル実行後、実行前のカレントディレクトリに戻ります。 −−−−−−−−−−−−−−−−−−− ワークメモリ関連コマンド −−−−−−−−−−−−−−−−−−− 　８）ワークメモリの割り当てと初期化 　　構文：fill start,size,data 　　ワークメモリのstartか[sizeまでをdataで初期化します。 　　指定範囲が、現在のワークメモリ空間を超える場合、指定された範囲 　　でワークメモリ空間を再確保されます。 　　ワークメモリを使用する前に、fill命令でワークメモリ空間を確保する 　必要があります。 　　ワークメモリ空間は、プログラム終了時に自動的に解放されます。 　９）ワークメモリの表示 　　構文：dump start,size 　　ワークメモリのstartからsizeまでの内容をダンプ表示します。 １０）ワークメモリ間のコピー 　　構文： copy src,size,dst 　　ワークメモリのsrcからsizeバイトを、ワークメモリのdstへ 　コピーします。 １１）ワークメモリ間のコンペア 　　構文： cmp src1,size,src2 　　ワークメモリのsrc1とsrc2からsizeだけ、両者を比較します。 　　両者が完全に一致しない場合、エラーを発生してスクリプトの 　実行を中断します。 １２）ワークメモリの書き込み 　　構文：mw address,data[,data,...] 　　ワークメモリのaddressに、dataをバイト単位で書き込みます。 　　dataは最大１５個連続して指定することができます。 １３）ファイルをワークメモリにロードする。 　　構文：load filename,buf_dst [,size] 　　filenameのファイルをワークメモリのbuf_dstのアドレスから、 　sizeバイトだけロードします。 　　filenameは拡張子によってロードするフォーマットが異なります。 拡張子とフォーマットの一覧 　　.bit : FPGAコンフィグデータとして、ヘッダ部を削除してロード その他:バイナリファイルとしてロード １４）ワークメモリをファイルにセーブする。 　　構文：save filename,buf_dst [,size] 　　ワークメモリのbuf_dstからsizeだけ、filenameにセーブします。 　　出力フォーマットはバイナリフォーマット固定です。 −−−−−−−−−−−−−−−−−−− FPGA関連コマンド −−−−−−−−−−−−−−−−−−− １５）FPGA(Spartan2)をコンフィグレーションする。 　　構文：config buf_start[,buf_size] 　　ワークメモリのbuf_startアドレスから、buf_sizeバイトで、 　FPGAをコンフィグレーションします。 　　buf_sizeを省略すると、loadコマンドで最後に読み込まれた 　拡張子.bitのデータ長が指定されます。 １６）FPGA(Spartan2)をシャットダウンします。 　　構文：shutdown : FPGA shutdown １７）JTAG_SPI()モジュールと通信を行います。 　　構文１：xc2s_user1 src,size [,dst] : JTAG USER1 TX/RX 　　構文２：xc2s_user2 src,size [,dst] : JTAG USER2 TX/RX 　　ワークメモリのsrcからsizeバイトのデータをJTAG_SPIの 　プロトコルでFPGAに送信し、ワークメモリのdstに受信データ 　を書き込みます。 　　dstの指定がない場合は、送信のみ行います。 　　構文１はUSER1タップ、構文２はUSER2タップです。 　　xcf_load()モジュールにデータを送信する場合は、XCFxxS用の全データを 　USER2タップへ送信します。 １８）ワークメモリからJTAG_MEM()モジュールへ書き込みます。 　　構文：jmwr buf_src,size [,jmem_dst] : JTAG-Memory Write １９）JTAG_MEM()モジュールからワークメモリへ読み込みます。 　　構文：jmrd jmem_src,size [,buf_dst] : JTAG-Memory Read −−−−−−−−−−−−−−−−−−− コンフィグROM(XCF02S)関連コマンド −−−−−−−−−−−−−−−−−−− ２０）コンフィグROMを選択します。 　　構文：xcfsel chain_number 　　TDI側から見て、chain_number番目のXCFxxSを対象とします。 　　EZ-FPGAではchain_numberには０を指定します。 ２１）コンフィグＲＯＭ内のデータを消去します。 　　構文：xcf_erase 　　正常に消去されたかどうかの確認は行われません。 ２２）ワークメモリからコンフィグＲＯＭにデータを書き込みます。 　　構文：xcf_pgm start,end 　　ワークメモリのstartアドレスからendアドレスの範囲をセクター 　単位に拡張して、XCFxxSに書き込みます。 　　書き込み後、ベリファイを行い一致しない場合はエラーを発生して 　中断します。 　　サイズ指定は、メモリ制御コマンドのsizeではなくendアドレス 　で指定します。 ２３）コンフィグＲＯＭからワークメモリにデータを読み込みます。 　　構文：xcf_read start,end 　　ワークメモリのstartアドレスからendアドレスの範囲をセクター 　単位に拡張して、XCFxxSから読み込みます。 　　サイズ指定は、メモリ制御コマンドのsizeではなくendアドレス 　で指定します。