adspシリーズ adsp324－00a1 1 付属ソフトウェア概要...

ＡＤＳＰシリーズ

ＡＤＳＰ３２４－００Ａ

ソフトウェア・ユーザーズ・マニュアル

目次

１付属ソフトウェア概要................................................................. 1

１．１付属ディスクの詳細 ............................................................ 2

２モニタ .............................................................................. 5

２．１概要 .......................................................................... 5

２．２機能一覧 ...................................................................... 5

２．３供給形態 ...................................................................... 5

２．４メモリマップ .................................................................. 5

２．５コマンド番号一覧表 ............................................................ 6

３付属コマンド ........................................................................ 6

３．１概要 .......................................................................... 6

３．２コマンド詳細 .................................................................. 7

３．２．１ LOAD324.EXE：プログラムダウンローダー...................................... 7

３．２．２ RESET324.EXE：リセットコマンド............................................. 7

３．２．３ HOLD324.EXE：ホールドコマンド.............................................. 8

３．２．４ RUN324.EXE：ブートコマンド................................................. 8

３．２．５ DUMP324.EXE：メモリダンプ.................................................. 9

３．２．６ EDIT324.EXE：メモリエディット.............................................. 9

３．２．７ ROM324.EXE：ＲＯＭ書き込み................................................ 10

３．２．８ CSTM324.EXE：ユーティリティーカスタマイザ................................. 11

３．２．９ STGEN324.EXE：Ｃ３０用スタートアップモジュールジェネレータ ................ 12

４付属ライブラリ ..................................................................... 13

４．１概要 ......................................................................... 13

４．２ライブラリの使用方法 ......................................................... 13

４．３ライブラリ使用上の注意 ....................................................... 14

４．４ライブラリ関数一覧 ........................................................... 15

４．５関数使用可能状態一覧表 ....................................................... 17

４．６関数詳細 ..................................................................... 18

５ＢＩＯＳ ........................................................................... 52

５．１概要 ......................................................................... 52

５．２機能概略 ..................................................................... 52

５．３使用方法 ..................................................................... 52

５．４ＢＩＯＳ機能一覧 ............................................................. 52

５．５ＢＩＯＳ詳細 ................................................................... 56

５．５．１詳細のフォーマット凡例.................................................... 56

５．５．２ＢＩＯＳの詳細 ........................................................... 57

６プログラム開発手順 ................................................................. 70

６．１プログラム構成 ............................................................... 70

６．２開発言語 ..................................................................... 70

６．３プログラミング ............................................................... 70

６．４ダウンロード ................................................................. 71

６．５デバッグと実行 ............................................................... 71

６．６運用 ......................................................................... 71

７プログラム開発と実行例 ............................................................. 72

７．１概要......................................................................... 72

７．２開発環境と実行環境 ........................................................... 72

７．２．１コンパイラのインストール ................................................. 72

７．２．２付属コマンドのインストール ............................................... 73

７．２．３付属ライブラリのインストール ............................................. 73

７．２．４ＢＩＯＳのインストール ................................................... 73

７．３プログラミング............................................................... 74

７．３．１ホストプログラムの記述 ................................................... 74

７．３．２ＤＳＰプログラムの記述 ................................................... 74

７．３．３サンプルプログラムの説明 ................................................. 74

７．４ＤＳＰプログラムのコンパイル ................................................. 75

７．５ＤＳＰプログラムのアセンブル ................................................. 75

７．６ＤＳＰプログラムのリンク ..................................................... 76

７．７ホストプログラムのコンパイル ................................................. 77

７．８ホストプログラムのリンク ..................................................... 77

７．９プログラムの実行............................................................. 77

８Ｑ＆Ａ............................................................................. 78

Ｑ：付属コマンドを使用したら“ボードが異常です”と表示されたのですが…。.............. 78

Ｑ：ボードが実装してあるのに“ボードが未実装です”と表示されたのですが….............. 78

Ｑ：プログラムが走っているかどうか見る方法はありませんか？............................ 79

Ｑ：スモールモデルだとプログラムが動かないのですが….................................. 80

Ｑ：付属ライブラリが動作しないのですが… ............................................. 82

Ｑ：ボードにプログラムをロードするにはどうすればいいのですか？........................ 82

Ｑ：ＭＳ－ＤＯＳのバッチコマンドでボードを起動できますか？............................ 83

Ｑ：プログラムをＲＯＭ化してボード単体で動作させたいのですが…........................ 83

Ｑ：ボードを単体で使用する場合、電源はどのように供給するのですか？.................... 83

Ｑ：モニタは何にどうやって使うのですか？ ............................................. 84

Ｑ：メモリは全てＲＡＭ！では、ＤＳＰはどうやって走るのですか？........................ 84

Ｑ：Ｃで書いたプログラムはどうやって実行されるのですか？.............................. 85

Ｑ：処理速度に不満があり、さらに高速化をしたいのですが….............................. 86

Ｑ：プログラムをオンチップＲＡＭに載せる方法はありますか？............................ 87

Ｑ：データをオンチップＲＡＭに載せる方法はありますか？................................ 88

Ｑ：オンチップＲＡＭには何を載せたらよいのですか？.................................... 90

Ｑ：キャッシュを効果的に利用する方法はありますか？.................................... 91

Ｑ：Ｃ言語とアセンブラ言語の混在はできますか？........................................ 92

1

１付属ソフトウェア概要

ＡＤＳＰ３２４－００Ａに付属しているサポートソフトウェアは次の通りです。

①モニタ

付属ライブラリとペアでユーザプログラムの起動をするほか、オプションのソフト「ＡＤＳ

Ｐ３２４－２０（ソースレベルデバッガ）」とペアでユーザプログラムの実行やユーザーのレジ

スタの管理を行います。

②付属コマンド

ＡＤＳＰ３２４付属コマンドはＭＳ－ＤＯＳのコマンドモードからＡＤＳＰ３２４をコント

ロールするＤＯＳコマンドです。ＤＳＰボードにプログラムをダウンロードしたり、ＤＳＰの

実行をコントロールするなどのコマンドが用意されています。キーボードより直接行ったり、

バッチコマンドに組み込むなどの使い方ができます。

③付属ライブラリ

付属ライブラリはホスト上で動作するユーザプログラムからＡＤＳＰ３２４ボードをコント

ロール（又はアクセス）したり、ＤＳＰの実行をコントロールするなどの各種機能を実現する

関数が用意されています。

④ＢＩＯＳ

ＡＤＳＰ３２４ボード上で動作するユーザプログラムから使用するサブルーチン群です。Ｄ

ＳＰボード用のアセンブラまたはＣ言語によるプログラムから呼び出して使用します。ＩＯの

制御、ホストとの通信などのＩＯに関するハンドリングのほか、浮動小数点フォーマットのＩ

ＥＥＥとＤＳＰ間の変換の機能もサポートしています。

以上のサポートソフトウェアは、付属のディスクに次のようなディレクトリに分けて格納されて

います。

\

Uty

Bios ＢＩＯＳプログラム

Fftlib ＦＦＴライブラリ

Lib Ｃ言語用ライブラリ他

Mon モニタプログラム

Sample サンプルプログラム

Umbchk ＵＭＢセットアッププログラム

Uty ユーティリティプログラム

2

１．１付属ディスクの詳細

ファイルの詳細は次の通りです。（注：サポートソフトウェアのバージョンにより、ファイルの内

容・明細などが異なる場合があります。その場合には、ルートディレクトリにドキュメントファイ

ルが格納されていますので、そちらを参照して下さい。）

サポートソフトウェアバージョン１．００．００

\

UTY

LOAD324.EXE

RESET324.EXE

HOLD324.EXE

RUN324.EXE

DUMP324.EXE

EDIT324.EXE

CSTM324.EXE

STGEN324.EXE

ROM324.EXE

SAMPLE

SIN.C

SIN.LNK

SIN.MAP

USER.CMD

READ.DOC

BIOS

CBIOS324.H

CBIOS324.LIB

USER.CMD

USERB.CMD

SAMPLE

INT3.C

SIO.C

TIM.C

SMPL.C

SMPL.LNK

SMPL.DOC

GEN.BAT

MON

MON324.MAP

MON324.OUT

SOURCE

MON324.ASM

HNDL.INC

BREAK.INC

次ページへ続く

前ページの続き

3

HOST.INC

MACRO.INC

REG.INC

USHNDL.INC

WORK.INC

MON324.LNK

MON324.CMD

LIB

LIB324L.LIB

LIB324.H

LIB.DOC

READ.DOC

SOURCE

LIB324.C

LIB324.H

LIBGEN.BAT

SAMPLE

ALONE.C

ALONE.OBJ

ALONE.EXE

LIB324.H

HOST.C

HOST.LNK

HOST.OBJ

HOST.EXE

DSP.C

DSP.LNK

DSP.OBJ

DSP.MAP

DSP.OUT

MON324.OUT

USER.CMD

HOSTGEN.BAT

DSPGEN.BAT

SAMPLE.DOC

FFTLIB

RFFT.ASM

CFFT.ASM

IFFT.ASM

RWIN.ASM

CWIN.ASM

WINSETUP.ASM

POWER.ASM

次ページへ続く

前ページの続き

4

POWER2.ASM

FFT2SUB.ASM

SINTBL.ASM

GLOBAL.ASM

SINGEN.C

MAIN1D.MK

MAIN1D.LNK

MAIN2D.MK

MAIN2D.C

MAIN2D.LNK

FFTLIB.LIB

FFTLIB.H

FFTLIB.DOC

WINDOWS

LIB32X.CPP

LIB32X.H

LIB32X.LIB

UTY32X.EXE

UBMCHK

UMBCHK.DOC

UMBCHK.EXE

5

２モニタ

２．１概要

ＡＤＳＰ３２４モニタはＤＳＰ用のＩＰＬ（イニシャル・プログラム・ロダー）を兼ねた基本モ

ニタプログラムです。オプションソフト「ＡＤＳＰ３２４－２０ソースレベルデバッガ」とペア

でユーザプログラムの実行やユーザレジスタの管理をします。

モニタを単体で使用することはありませんが、モニタを用いればユーザーのプログラムからモニ

タ経由でオンチップＲＡＭをアクセスできます。

また、RUN324.EXEとペアでユーザプログラムの実行を開始するのにも使用します。

２．２機能一覧

モニタには次の機能があります。

① モニタのリセットとボードの初期化

② ユーザプログラムの実行

③ ユーザプログラムのステップ実行

④ ＢＩＯＳの実行

⑤ メモリの読み出し

⑥ メモリの書き込み

⑦ メモリのクリア

⑧ メモリの転送

２．３供給形態

ＣＯＦＦファイルフォーマットの実行形式ファイルで供給されます。LOAD324.EXE またはデバッ

ガでロードして使用します。ファイル名はMON32x.OUTです。

２．４メモリマップ

ＡＤＳＰ３２４モニタの使用しているメモリ領域は次のとおりです。ユーザプログラムをリンク

する際にモニタとアドレスが重複しないように注意してください。

アドレス用途

００００００ｈ～００００３Ｆｈ割り込みベクタとトラップベクタ

００００４０ｈ～０００ＦＦＦｈモニタプログラム領域

２０００００ｈ～２００１ＦＦｈモニタ作業領域

２００２００ｈ～２００７ＦＦｈホストとの通信領域（ＢＩＯＳ使用時）

または、ユーザー使用可能領域

但し、モニタをロード後は０ｈ番地（リセットベクタ）と２０ｈ番地（ＴＲＡＰ０）以外の割り

込み・トラップベクタは書き換えても差し支えありません。

以上のメモリ配置を決定するリンカーコマンドファイルUSER?.CMDが付属ディスク内にあります

のでリンク時にはこれを使用して下さい。

6

２．５コマンド番号一覧表

番号機能名パラメータリザルト

０ NOP なし RS1：バージョン番号

１ RESET なしなし

２ GO なしなし

３ STEP なしなし

４（予約）

５ BIOS CALL なしなし

６ RESET STEP なしなし

７ RESET BREAK なしなし

８ READ MEMORY OP1：アドレス RS1：メモリ値

９（予約）

１０ WRITE MEMORY OP1：アドレス

OP2：書き込み値

なし

１１（予約）

１２ FILL MEMORY OP1：先頭アドレス

OP2：長さ

OP3：書き込み値

なし

１３ MOVE MEMORY OP1：先頭アドレス

OP2：長さ

OP3：転送先アドレス

なし

１４（予約）

１５（予約）

３付属コマンド

３．１概要

ＡＤＳＰ３２４付属コマンドはＭＳ－ＤＯＳのコマンドモードからＡＤＳＰ３２４をコントロー

ルするＤＯＳコマンドです。ＤＳＰボードにプログラムをダウンロードしたり、ＤＳＰの実行をコ

ントロールするなどのコマンドが用意されています。（キーボードから直接実行したり、バッチコマ

ンドに組み込むなどの使い方が出来ます。）

以下に用意されているコマンドの一覧を示します。

LOAD324.EXE プログラムのダウンロードをします。

RESET324.EXE ボードをリセットします。

HOLD324.EXE ボードをホールドします。

RUN324.EXE ＤＳＰの実行を開始します。

DUMP324.EXE ＤＳＰのメモリをダンプ（アップロード）します。

EDIT324.EXE ＤＳＰメモリの表示修正をします。

CSTM324.EXE 付属コマンドをカスタマイズします。

ROM324.EXE オプションのＲＯＭボードへプログラムを書き込みます。

STGEN324.EXE ブートモジュールを生成します。

7

３．２コマンド詳細

３．２．１ LOAD324.EXE：プログラムダウンローダー

*オブジェクトファイルをＡＤＳＰ３２４にダウンロードします。

書式：A＞LOAD324 ＜file name1＞＜file_name2 ．．．＞＜switch＞

ロードできるオブジェクトファイルはＣＯＦＦまたはＨＥＸファイルです。ファイル名は大１

６個まで同時に指定できます。

ファイル名の拡張子は不要です。.OUTまたは.B0～.B3を付加したファイル名を自動的に生成しま

す。

スイッチを次に示します。

/0～/15 ：ボード番号を指定します。（デフォルトは０）

/g ：ロード後、実行を開始します。（デフォルトは停止のままです。）

/b ：ロード後、ブートベクタをセットします。

/o ：ロードアドレス重複チェックを禁止します。

/r ：ロード前にＤＳＰをリセットします。

/c ：セグメント、Ｉ／Ｏアドレスのデフォルトをカスタマイズします。

/s：XXXX ：セグメントアドレス指定（出荷時のデフォルトはE000）

/i：XXXX ：Ｉ／Ｏアドレス指定（出荷時のデフォルトは0300）

３．２．２ RESET324.EXE：リセットコマンド

*ＡＤＳＰ３２４をリセットします。

書式：A＞RESET324 ＜switch＞



/a ：全ボード番号（０～１５のうち実装されているもの）を指定。

/h ：リセット後、ホールド（実行待機）状態にします。

/r ：実装メモリの０クリアを行います。




8

３．２．３ HOLD324.EXE：ホールドコマンド

*ＡＤＳＰ３２４の実行状態を表示／制御します。

書式：A＞HOLD324 ＜switch＞


HOLD ：ボードを停止状態（ＨＯＬＤ）にします。

RUN ：ボードを実行状態にします。

RUN/HOLDいずれの指定もない場合は、現在の状態を表示します。


/a ：全ボード番号（０～１５のうち実装されているもの）を指定します。




３．２．４ RUN324.EXE：ブートコマンド

*ＡＤＳＰ３２４を任意のアドレスから実行開始します。（このコマンドの実行にはユーザプログラ

ムのほか、ＡＤＳＰモニタのロードが必要です。）

書式：A＞RUN324 address ＜switch＞

addressは実行開始番地を１６進数で指定します。



/a ：全ボード番号（０～１５のうち実装されているもの）を指定します。




9

３．２．５ DUMP324.EXE：メモリダンプ

*ＡＤＳＰ３２４のメモリ内容を表示（アップロード）します。

書式：A＞DUMP324 top_address data_length ＜switch＞

top_addressは、１６進数・１０進数・ラベルが使用できます。

data_lengthは、１６進数または１０進数で指定します。



/h ：インテル・ヘキサ・フォーマットで表示します。

/h：name ：インテル・ヘキサ・フォーマットでファイル化します。

/t：name ：拡張Ｔｅｋ・ヘキサ・フォーマットでファイル化します。

ファイル名に拡張子は不要です。自動的に.B0～.B3を付加します。

/e ：データをＩＥＥＥ単精度浮動小数形式で表示します。

/f ：データをＴＩ単精度浮動小数形式で表示します。

/b ：データをバイト単位で表示します。

/d ：データを１０進数で表示します。

/@：file ：ラベルを検索するマップファイル（.map）を指定します。




３．２．６ EDIT324.EXE：メモリエディット

*ＡＤＳＰ３２４のメモリを表示、手入力による編集をします。

書式：A＞EDIT324 ＜address＞＜switch＞

addressは１６進数で指定します。省略も可能です。






10

３．２．７ ROM324.EXE：ＲＯＭ書き込み

*ユーザプログラムをＲＯＭへ書き込みます。

書式１：A＞ROM324 xxx.out ＜switch＞

書式２：A＞ROM324 @resp_file

xxx.out ．．．ＣＯＦＦファイル

resp_file ．．．レスポンスファイル

ＣＯＦＦファイルの拡張子は省略可能です。省略した場合は.outになります。レスポンスファイ

ルは引き数とスイッチをファイルから与えることができます。ＣＯＦＦファイル名の拡張子部分

が.romのファイルを作業ファイルとして使用しますのでxxx.romがカレントにある場合は注意して

下さい。



/k ：作業ファイルとして作成されるxxx.romファイルを保存します。

/l ：作業ファイルxxx.romをＲＯＭに書き込みます。

この時、入力ＣＯＦＦファイルの指定は無視されます。

.romファイルはＲＯＭ書き込みイメージそのものなので、処理時間が短

縮されます。

/cn ：キャッシュの制御を行います。（n=0で無効、n=1で有効です。）

デフォルトは/c1（有効）です。

/s：ssss ：スタック領域をエントリします。デフォルトは809800hです。

/d：ssss ：ＤＩＮＴ処理ルーチンをエントリします。

/x：ssss ：ＳＩＯ送信ルーチンをエントリします。

/r：ssss ：ＳＩＯ受信ルーチンをエントリします。

/pn：ssss ：トラップ（０～３１）処理ルーチンをエントリします。

/tn：ssss ：タイマ０／１割り込み処理ルーチンをエントリします。

/in：ssss ：外部割り込み（０～３）処理ルーチンをエントリします。

/ct ：セグメント、Ｉ／Ｏアドレスのデフォルトをカスタマイズします。

/se：XXXX ：セグメントアドレス指定（出荷時のデフォルトはE000）

/io：XXXX ：Ｉ／Ｏアドレス指定（出荷時のデフォルトは0300）

xxxxは１６進数４桁で指定して下さい。ssssは１６進数または処理ルーチンのラベルです。

全ての割り込みエントリのデフォルトは、スタートアップのダミーベクタを示しています。（内部

は空）

11

３．２．８ CSTM324.EXE：ユーティリティーカスタマイザ

*ＡＤＳＰ３２４ユーティリティをカスタマイズします。カスタマイズする目的はＡＤＳＰ３２４－

００ボードのＩ／Ｏアドレスとメモリ・ベースアドレスの設定を変更した場合、各コマンドのデ

フォルトをこれに合わせて変更します。

書式：A＞CSTM324 uty_name ＜switch＞

uty_name 特定の付属コマンドをカスタマイズする場合はこの引き数を指定します。

全コマンドをカスタマイズする場合にはこの引き数は省略し、次の/aスイッチを指定

します。


/a ：ＡＤＳＰ３２４付属ユーティリティをカスタマイズします。

/k ：セグメント、Ｉ／Ｏアドレスのキー入力による指定。

/s：XXXX ：セグメントアドレスのスイッチによる指定。

/i：XXXX ：Ｉ／Ｏアドレスのスイッチによる指定。

但し、/kと/s，/iは同時に指定できません。

12

３．２．９ STGEN324.EXE：Ｃ３０用スタートアップモジュールジェネレータ

*リンカーの出力したマップファイルの情報を基にロードモジュール用のスタートアップモジュー

ル（ＣＯＦＦファイル）を出力します。

書式１：A＞STGEN324 xxx.MAP ooo ＜switch＞

書式２：A＞STGEN324 @resp_file

xxx.MAP．．．リンカーマップファイル

ooo ．．．ＣＯＦＦファイル（省略可能）

resp_file ．．．レスポンスファイル

マップファイルの拡張子は省略可能です。省略時は上記拡張子が採用されます。

ＣＯＦＦファイルの拡張子は不要です。自動的に.OUTが付加されます。

ＣＯＦＦファイル名省略時のファイル名は、START.OUTが採用されます。

レスポンスファイルは引数とスイッチをファイルから与えることができます。書式１の方法と併

用が可能です。


/cn ：キャッシュの制御を行います。（n=0で無効、n=1で有効です。）

デフォルトは/c1（有効）です。

/s：nnnn ：確保するスタック領域をエントリします。デフォルトは809800hです。

/d：nnnn ：ＤＩＮＴ処理ルーチンをエントリします。

/x：nnnn ：ＳＩＯ送信ルーチンをエントリします。

/r：nnnn ：ＳＩＯ受信ルーチンをエントリします。

/pn：nnnn ：トラップ（０～３１）処理ルーチンをエントリします。

/tn：nnnn ：タイマ０／１割り込み処理ルーチンをエントリします。

/in：nnnn ：外部割り込み（０～３）処理ルーチンをエントリします。

nnnnは１６進数または処理ルーチンのラベルです。

全ての割り込みエントリのデフォルトは、スタートアップのダミーベクタを示しています。（内部

は空）

13

４付属ライブラリ

４．１概要

付属ライブラリはホスト上で動作するユーザプログラムからＡＤＳＰ３２４ボードをコントロー

ルしたり、アクセスしたい場合に使用する関数ライブラリです。ＤＳＰボードにプログラムをダウ

ンロードしたり、ＤＳＰの実行をコントロールする機能など各種機能の関数が用意されています。

○ 初期化関数

○ ボード関連関数

○ ボード制御関数

○ ダウン／アップロード関数

○ 特殊制御関数

○ 通信関数

○ オフライン関数

付属ライブラリはＣ言語（ＭＳ－Ｃ）によるバージョンが用意されています。

４．２ライブラリの使用方法

付属ライブラリは次の要素から構成されています。

○ インクルードファイル

○ ライブラリ・モジュール

○ ソースファイル（Ｃ）

インクルードファイルはユーザプログラムにてインクルードして下さい。関数のプロトタイプ宣

言のほか、データの構造体、定義定数などが宣言されています。

ライブラリ・モジュールはラージモデルで作成されています。リンカーでリンクする際に一緒に

リンクして下さい。

ソールファイルは改変してユーザプログラムの一部として使用頂いて結構です。（但し、改変され

た関数については動作の保証は致しかねます。）

14

４．３ライブラリ使用上の注意

ライブラリをより効果的かつ的確に使用して頂くためには注意すべき点がいくつかあります。以

下に記しますので、プログラミングの際のご参考にして下さい。

【１】このライブラリには、ライブラリの初期化関数があります。（A324_libinit( )）ほかのどの関

数の実行よりも先にこの初期化関数を実行する必要があります。これを行わないとライブラリ

が正しく動作しないほか、思わぬ動作をする場合がありますので注意して下さい。

【２】ＡＤＳＰ３２４ボードはホストから見た場合、マルチボード構成になります。従ってライブラ

リもそれに対応しています。

ホストからボードをアクセスする場合の基本的な手順は、①アクセスする対象のボードを選択

する ②ボードをアクセスするといった手順になります。

ところが、ボードを１枚しか使用しない場合には対象ボードの選択は初めに１回のみ行えばよ

く、毎回行う必要はありません。

そこで、ライブラリの使いやすさとオーバーヘッドの低減を考慮し、ボードをアクセスする関

数にはＡ：対象ボードを選択してからアクセスするタイプ、Ｂ：対象ボードを選択せず（現在

選択されているボードに対して）アクセスするタイプの２種類があります。また、対象ボード

の台数・アクセスするボードを切り換えるタイミングなどユーザプログラムの構造に応じて、

適当なタイプを選択して使用して下さい。

○ボードが１台の場合

初期化時に対象ボード番号を選択し、以後上記Ｂタイプの関数を使用する。

○ボードが複数の場合で、全ボードを平均的にアクセスする場合

初期化後、上記Ａタイプの関数を使用する。

○ボードが複数で、特定のボードにアクセスが集中する場合

ボードごとの手続きを関数化し、関数の初めに対象ボードを選択します。関数内ではＢタイ

プの関数を使用します。

*なおＡ／Ｂの関数の名称は、ほぼ同名でＡタイプの関数名の先頭に _ を付けた名称がＢタイ

プの関数の名称となります。

【３】ボードの状態には停止（ホールド）状態と実行（ラン）状態があります。ライブラリにはこの

状態について、①停止状態でのみ実行可能なもの ②実効状態でのみ実行可能なもの ③どち

らでも実行可能なものの３種類があります。各関数の説明または使用可能状態一覧表を参照

の上、注意して使用して下さい。ボードの２つの状態はコントロールする関数がありますので、

状態を適時コントロールしながら使用します。

15

４．４ライブラリ関数一覧

○初期化関数

int A324_libinit（UI,UI）；関数ライブラリの初期化

○ボード関連関数

int A324_valid（UI）；ボード実装確認

void A324_bdsel（UI）；ボード選択

void A324_bdinit（UI）；ボード初期化

void A324_bnksel（UI,UL）；メモリバンク選択

○ボード制御関数

int A324_hold（UI）；ボード停止

int A324_run（UI）；ボード実行開始

int A324_start（UI,UL）；ユーザプログラム実行開始

int A324_startm（UI,C *）；ユーザプログラム実行開始

int A324_boot（UI,UL）；実行開始番地設定

void A324_reset（UI）；ボードリセット

void A324_holdstus（UI）；実行停止確認

○ダウン／アップロード関数

int A324_putmem（UI,UL,UL）；メモリからのダウンロード

void A324_getmem（UI,UL,UL）；メモリへのアップロード

int A324_loadc（UI,C *）；ＣＯＦＦファイルのダウンロード

int A324_loadm（UI,UL,UL,UL *）；メモリからのダウンロード

int A324_savec（UI,UL,UL,UL,C *）；ＣＯＦＦファイルへのアップロード

int A324_savem（UI,UL,UL,UL *）；メモリへのアップロード

○特殊制御関数

int A324_ini0（UI）；ＤＳＰボードへの割り込み発生

int A324_moniter（UI,A324_mon_prm *）；モニタコマンド実行

int A324_bios（UI,A324_bios_prm *）；ＤＳＰ－ＢＩＯＳ実行

○通信関数

void A324_hinit（UI）；関数初期化

int A324_htxst（UI）；送信ステータス確認

int A324_htfr（UI,UL）；コード送信

int A324_htfrdt（UI,UL,UI,C *）；データ送信

int A324_hwit（UI）；送信相手完了確認

int A324_hrxst（UI）；受信ステータス確認

int A324_hrcv（UI,UL *）；コード受信

int A324_hrcvdt（UI,UL *,UI *,C *）；データ受信

void A324_hrdy（UI,I）；受信完了報告

16

○オフライン関数

int A324_symbolm（C *,C *,UL *）；マップからのシンボル取り出し

int A324_symbolc（C *,C *,UL *）；ＣＯＦＦからのシンボル取り出し

int A324_entrym（C *,C *,UL *）；マップからのエントリ取り出し

int A324_entryc（C *,UL *）；ＣＯＦＦからのエントリ取り出し

C ： char

I ： int

UI ： unsigned int

UL ： unsigned long

17

４．５関数使用可能状態一覧表

【凡例】 ○：使用可能

×：使用不可能

→◎：使用可能かつ実行後この状態に移行する。

△：実行可能だが、本来はこの状態で実行すべき関数ではありません。

関数名関数の機能停止状態実行状態

A324_bdinit( ) ボード初期化 ○ ○

A324_bdsel( ) ボード選択 ○ ○

A324_bios( ) ＤＳＰ－ＢＩＯＳ実行 × ○

A324_bnksel( ) メモリバンク選択 ○ △

A324_boot( ) 実行開始番地設定 ○ ×

A324_entryc( ) ＣＯＦＦからのエントリ取り出し ○ ○

A324_entrym( ) マップからのエントリ取り出し ○ ○

A324_getmem( ) メモリへのアップロード ○ △

A324_hinit( ) 関数初期化 ○ ○

A324_hold( ) ホールド停止 →◎ ○

A324_holdstus( ) 実行停止確認 ○ ○

A324_hrxst( ) 受信ステータス確認 × ○

A324_hrcv( ) コード受信 × ○

A324_hrcvdt( ) データ受信 × ○

A324_hrdy( ) 受信完了報告 × ○

A324_htfr( ) コード送信 × ○

A324_htfrdt( ) データ送信 × ○

A324_htxst( ) 送信ステータス確認 × ○

A324_hwit( ) 送信相手完了確認 × ○

A324_int0( ) ＤＳＰボードへ割り込み発生 ○ ○

A324_libinit( ) 関数ライブラリの初期化 ○ ○

A324_loadc( ) ＣＯＦＦファイルのダウンロード ○ ×

A324_loadm( ) メモリからのダウンロード ○ ×

A324_moniter( ) モニタコマンド実行 × ○

A324_putmem( ) メモリからのダウンロード ○ △

A324_reset( ) ボードリセット ○ ○

A324_run( ) ボード実行開始 ○ →◎

A324_savec( ) ＣＯＦＦファイルへアップロード ○ ×

A324_savem( ) メモリへのアップロード ○ ×

A324_start( ) ユーザプログラム実行開始 × ○

A324_startm( ) ユーザプログラム実行開始 × ○

A324_symbolc( ) ＣＯＦＦからのシンボル取り出し ○ ○

A324_symbolm( ) マップからのシンボル取り出し ○ ○

A324_valid( ) ボード実装確認 ○ ○

18

４．６関数詳細

関数名ボード初期化

記述 void A324_bdinit（board）； /* 任意ボード */

void _A324_bdinit（）； /* 現在ボード */

引数 unsigned int board； /* ボード番号 */

説明ＡＤＳＰ３２４ボードをリセットし、初期化状態に保持します。

ボードリセット関数 A324_reset（）との違いは、リセット関数はリセット後ボードは実行を

開始するのに対し、初期化関数はリセット後、停止したままの状態を保持しています。電源の

投入後、まだ一度もプログラムをロードしていない場合、ＤＳＰのメモリは不定になっていま

す。この状態でボードを実行させるとＤＳＰの暴走により以後ボードのコントロール（ホール

ドなど）が出来なくなる場合があります。電源投入後、初めてボードをアクセスする場合には、

まずこの関数を実行します。

戻り値ありません。

参考 A324_reset（），A324_hold（）

使用例 A324_bdinit（）； /* 初期化 */

A324_hold（）； /* ホールドします。 */

19

関数名ボード選択

記述 void A324_bdsel(board); /* 任意ボード */

void _A324_bdsel( ); /* 現在ボード */

引数 unsigned int board; /* ボード番号 */

説明アクセスの対象となるボードを選択します。

ボード指定機能の付いていない関数を使用するのに先立ち、対象ボードを決定します。


使用例ボード番号０～３に同じプログラムをロードして起動する例です。

(注：エラー処理は省略してあります。)

関数 func_1( ) と func_2( ) は同じ処理をしますが、func_2( )のほうがオーバーヘッドが

小さく、また、func_2( )のほうが直感的で分りやすいでしょう。

func_1( )

{

unsigned int bn; /* ボード番号 */

for( bn = 0 ; bn < 4 ; ++bn){

{

A324_bdsel(bn); /* ボードを選択する */

_A324_hold( ); /* 現在のボードに対して */

_A324_loadc(“TEST”);

_A324_reset( );

_A324_run( );

}

}

func_2( )

{

unsigned int bn; /* ボード番号 */

for( bn = 0 ; bn < 4 ; ++bn){

{

A324_hold(bn); /* 各関数毎に指定 */

A324_loadc(bn,”TEST”);

A324_reset(bn);

A324_run(bn);

}

}

20

関数名ＤＳＰ－ＢＩＯＳの実行

記述 void A324_bios(board,prms); /* 任意ボード */

void _A324_bios(prms); /* 現在ボード */

引数 unsigned int board; /* ボード番号 */

A324_bios_prm *prms; /* BIOS引数と戻り値 */

説明ＡＤＳＰ３２４のモニタに組み込まれたＢＩＯＳとモニタ経由でホストから実行します。

ＢＩＯＳへ渡す機能番号と引数は構造体で渡します。

構造体はインクルードファイルに定義されています。モニタを使用してＢＩＯＳを実行

しますので、この関数を実行する時にはＡＤＳＰ３２４は次の状態にセットアップします。

１）ＢＩＯＳの組み込まれているモニタをロードする。

２）ボードをリセットする。

３）ボードを実行状態にする。

戻り値 0 (NO_ERROR) 実行完了しました。

1 (ERROR) モニタをハンドリングができません。

参考 A324_monitor( )

使用例

#define BNO 0 /* ボード番号 */

#include “lib324.h”

A324_bios_prm prms;

/* まずここでモニタをロードします。 */

/* 詳細は A324_loadc( ) を参照してください。 */

A324_reset(BNO);

A324_run(BNO); /* エラー処理省略 */

/* パラメータセットアップ */

prms.RO = 75 /* IEEEからTI浮動小数へ */

prms.R2 = 0x2004001; /* アドレス */

prms.R3 = 100; /* 長さ */

if（A324_bios（BNO,&prms））

printf（“BIOS（monitor） exec error\n”）;

else

printf（“function complete\n”）;

21

関数名メモリバンク選択

記述 void A324_bnksel（board,address）；/* 任意ボード */

void _A324_bnksel（address）； /* 現在ボード */


unsigned long address； /* メモリアドレス */

説明停止モードで、ＤＳＰの外部メモリをアクセスする場合のアドレスをボードに対して設定しま

す。ＤＳＰを停止した状態で使用してください。


使用例ＤＳＰの外部メモリをホストが直接アクセスします。

#include ＜dos.h＞

#include ＜stdio.h＞

#define A324_offset（ad）（ad & 0xfff）

unsigned long ＿far *ptr；

unsigned long Address,offset,data；

ptr =（long ＿far *）（（unsigned long）ADSP_SEG * 0x10000L）；

Address = 0x12345； /* メモリアドレス */

A324_bdsel（BN0）； /* 対象ボードを選択する */

_A324_hold（）； /* 停止モードにする */

_A324_bnksel（Address）； /* メモリバンクを選択 */

offset = A324_offset（Address） /* オフセットを計算 */

data = *（ptr ＋ offset）； /* データを取得 */

22

関数名実行開始番地設定

記述 int A324_boot（board,address）； /* 任意ボード */

int _A324_boot（address）； /* 現在ボード */


unsigned long address； /* メモリアドレス */

説明ＤＳＰボードのリセットベクタを設定し、実行を開始します。次回からはリセットのみで再起

動できます。

この関数を用いてＤＳＰを任意の番地から実行させることができます。実行させるのにモニタ

を使用しないでリセットと同時に実行を開始します。但し、ＤＳＰの初期化などをユーザプロ

グラムが行う必要があり、とくにプライマリ・バス制御レジスタの初期化はメモリアクセスの

ウェイト数を決定する重要なレジスタで、必ず初期化が必要です。従って、その点を考慮した

プログラムに対してのみ使用してください。Ｃで記述したプログラムの場合にはmain（）の

初の部分でその初期化をすることも可能です。

戻り値０（NO_ERROR）正常に終了しました。

－１（ERROR）異常が発生しました。原因は次のいずれかです。

１）ボードの停止実行状態の切り替えができない。

２）ボードのメモリにデータが書き込めない。

使用例

#define BN0 0

unsigned long adrs；

adrs = BOOT_ADRS；

A324_boot（BN0,adrs）；

23

関数名ＣＯＦＦファイルからのエントリ取り出し

記述 int A324_entryc（name,entry）；

引数 char *name； /* ＣＯＦＦファイル名 */

unsigned long entry； /* エントリ番地 */

説明ＣＯＦＦフォーマットのオブジェクトファイルから起動番地を取得します。ＣＯＦＦファイル

にはオブジェクトコードの他にプログラムの実行開始番地情報も格納されています。これを取

り出し、モニタに与えることによりＣＯＦＦファイルを正確に起動できます。

マップファイルからも同様にエントリ番地が取り出せます。


－１（ERROR）異常終了しました。原因は次のいずれかです。

１）ファイルが見つからない。

２）ファイルが異常である。

３）ファイルはＣＯＦＦファイルではない。

参考 A324_entrym（）

使用例

char *name；


name = ”TEST.OUT”；

if（A324_entryc（name,&adrs））

printf（”entry get error\n”）；

else

printf（”entry address is %08lX\n”,adrs）；

24

関数名マップからのエントリ取り出し

記述 int A324_entrym（file_name,entry_name,entry）；

引数 char *file_name； /* ファイル名 */

char *entry_name； /* エントリシンボル名 */

unsigned long entry； /* エントリ番地 */

説明ＤＳＰプログラムのマップファイルから起動番地を取得します。ＳＤＰのプログラム開発時に

リンカーが出力したマップファイルを取り込み、エントリポイントのシンボルとアドレスを取

得します。

ＣＯＦＦファイルからも同様にエントリ番地が取り出せます。





３）ファイルはマップファイルではない。

参考 A324_entryc（）

使用例

char *file_name； /* ファイル名 */

char entry_name［120］； /* エントリシンボル名 */

unsigned long adrs； /* エントリアドレス */

file_name = ”TEST.MAP”；

if（A324_entrym（file_name,entry_name,&adrs））

printf（”entry get error\n”）；

else{

printf（”entry symbol［%s］\n”,entry_name）；

printf（”entry address %08lX\n”,adrs）；

｝

25

関数名ＤＳＰメモリからアップロード

記述 void A324_getmem（board,adrs,buff）； /* 任意ボード */

void _A324_getmem（adrs,buff）； /* 現在ボード */


unsigned long adrs； /* メモリのアドレス */

unsigned long *buff； /* メモリバッファ */

説明ＤＳＰの外部メモリからホストへのメモリへデータをアップロードします。データ長は１ワー

ドです。


参考 A324_putmem（）

使用例

#include ＜malloc.h＞

#define BN0 0

#define LEN 100

unsigned long *buff,*ptr；


int c；

if（buff = （unsigned long *）malloc（sizeof（long）*LEN））= = NULL）{

printf（”no more memory.\n”）；

exit（1）；

A324_bdsel（BN0）；

for（ptr = buff,c = 0；c < LEN；++c）

_A324_getmem（adrs++,ptr++）；

26

関数名関数初期化

記述 void A324_hinit（board）； /* 任意ボード */

void _A324_hinit（）； /* 現在ボード */


説明対ＤＳＰ通信関数の初期化をします。

ＤＳＰプログラムとオンラインで通信をする場合、初にこの関数にて初期化する必要があり

ます。


参考 A324_hrv（），A324_hrcvdt（），A324_htfr（），A324_htfrdt（）

使用例

#define BN0 0

A324_hinit（BN0）；

27

関数名ボード停止

記述 int A324_hold（board）； /* 任意ボード */

int _A324_hold（）； /* 現在ボード */


説明ＤＳＰボードを停止状態にします。

ＤＳＰの外部メモリを直接ホストからアクセスする場合にこの機能を使用します。ＤＳＰ自体

はホールド機能により一旦停止されるのみで、後に実行状態にすることにより実行を継続でき

ます。


－１（ERROR）ボードが異常です。

参考 A324_run（），A324_holdstus（）

使用例

if（A324_hold（BN0））

printf（”board hold error.\n”）；

else

printf（”board hold.\n”）；

28

関数名実行停止確認

記述 int A324_holdstus（board）； /* 任意ボード */

int _A324_holdstus（）； /* 現在ボード */


説明ボードの停止状態を取得します。

ボードがホールドしているか、または実行しているかをテストし結果を返します。A324_run

（）、A324_hold（）により正しく制御された後にこの関数を実行した場合はそれぞれ停止・

実行状態が回答されます。

停止・実行状態が A324_run（）、A324_hold（）関数または同等の機能の関数を使用せず、

ＤＳＰが勝手に状態を遷移することはありません。従って、シーケンシャルなプログラムの場

合には特にこの関数を使用する必要はありません。この関数の用途は未知のボード状態を取得

したい時などです。

戻り値１（TRUE）停止しています。

０（FALSE）実行しています。

参考 A324_hold（），A324_run（）

使用例

#define BN0 0

unsigned int bn；

if（A324_holdstus（bn））

printf（”board number %d is HOLDing\n”，bn）；

else

printf（”board number %d is RUNing\n”，bn）；

29

関数名受信ステータス確認

記述 int A324_hrxst（board）； /* 任意ボード */

int _A324_hrxst（）； /* 現在ボード */


説明ＤＳＰがホストへのデータ送信を開始しているかを確認します。

ホストとＤＳＰ間のハンドリングはＣＰＵでソフト的に行っています。ホスト側が受信関数を

実行しない場合、ＤＳＰ側の送信処理は完了しません。ランダムなタイミングでＤＳＰからホ

ストへデータの送信が行われる場合、この関数でＤＳＰの送信開始をしていた場合は受信処理

を実行し、そうでない場合は別の処理を行ってもかまいません。

戻り値０ＤＳＰは送信を開始していません。

０以外ＤＳＰは送信を開始しています。

参考 A324_hrcv（），A324_hrcvdt（）

使用例

#define BN0 0

A324_hinit（BN0）；

if（A324_hrcv（BN0））

A324_hrcv（BN0,code）；

else

｛

/*…*/

｝

30

関数名コード受信

記述 int A324_hrcv（board,code）； /* 任意ボード */

int _A324_hrcv（code）； /* 現在ボード */


説明ＤＳＰから１ワードのコードを受信します。

ＤＳＰからホストへ渡すデータが１ワードの場合、この関数を使用します。機能的には

A324_hrcvdt（）関数のデータ長が０の場合と同じですが、あらかじめデータ長が０とわかっ

ている場合にはこの関数の方がオーバーヘッドが小さくなります。

受信処理中にソフトタイマでタイムアップを監視する機能とＣＴＲＬ＋Ｃによる中断を検出

する機能があります。ソース上に定数になっていて任意による変更が可能です。それぞれ次の

定数定義を変更してください。

CTRL_C_LOOP １でＣＴＲＬ＋Ｃの検出をします。

出荷時には１になっています。

ENDLESS_LOOP １でハンドリングを完了するまで関数を終了しません。

出荷時には０になっています。

戻り値０（NO_ERROR）正常に受信しました。

－１（ERROR）受信中にタイムアップしました。

ＤＳＰが送信を開始していないか、または停止しています。

参考 A324_hrcvdt（）

使用例

unsigned long code；

if（A324_hrcv（BN0,&code））

printf（”recieve error\n”）；

else

printf（”receive %08lx\n”,code）；

31

関数名データ受信

記述 int A324_hrcvdt（board,code,len,data）； /* 任意ボード */

int _A324_hrcvdt（code,len,data）； /* 現在ボード */


unsigned long *code； /* コード受取り */

unsigned int *len； /* データ長受取り */

unsigned long *data； /* データ受取バッファ */

説明ＤＳＰから１ワードのコードと任意の長さのデータを受信します。

ＤＳＰからホストへ渡すデータが複数ワードの場合この関数を使用します。データは１ワード

４バイトのデータ、すなわちｌｏｎｇまたはｆｌｏａｔに限られます。ＤＳＰのワード幅が４

バイトであり、ＤＳＰのワード数が転送データ長の単位になります。

データ長はＤＳＰ側が送信をする時点で指定します。データ長はＭＡＸ１７００ワードです。

データ受取バッファは予め充分な長さを確保しておく必要があります。

受信処理中にソフトタイマでタイムアップを監視する機能とＣＴＲＬ＋Ｃによる中断を検出

する機能があります。ソース上に定数になっていて、任意に変更が可能です。それぞれ次の定

数定義を変更してください。

CTRL_C_DETECT １でCTRL＋Cの検出をします。




戻り値０（NO_ERROR）正常に受信しました。

－１（ERROR）受信中にタイムアップしました。

ＤＳＰが送信を開始していないか、または停止しています。

参考 A324_hrcv（）

使用例


unsigned int len；

float data［1700］；

if（A324_hrcvdt（BN0,&code,&len,（unsigned long*）data））

printf（”recieve error\n”）；

else

｛

printf（”receive code %08lx\n”,code）；

printf（”receive %d datas\n”,len）；

｝

32

関数名受信完了報告

記述 void A324_hrdy（board,stus）； /* 任意ボード */

void _A324_hrdy（stus）； /* 現在ボード */


int stus；

説明ＤＳＰからデータ（またはコード）を受信したら、次にこの完了報告をします。これによりＤ

ＳＰはホストが処理を完了したことを検出できます。


参考 A324_hrxst（），A324_hrcv（），A324_hrcvdt（）

使用例

#define BN0 0


int st；

A324_hrcv（BN0,&code）；

A324_hrdy（BN0）

33

関数名コード送信

記述 int A324_htfr（board,code）； /* 任意ボード */

int _A324_htfr（code）； /* 現在ボード */


unsigned long code； /* 送信コード */

説明ＤＳＰへ１ワードのコードを送信します。

ホストからＤＳＰへ渡すデータが１ワードの場合この関数を使用します。機能的には

A324_tfrvdt（）関数のデータ長が０の場合と同じですが、予めデータ長が０とわかっている

場合にはこの関数の方がオーバーヘッドが小さくなります。

送信処理中にソフトタイマでタイムアップを監視する機能とＣＴＲＬ＋Ｃによる中断を検出

する機能があります。ソース上に定数になっており任意に変更が可能です。それぞれ次の定数

定義を変更してください。





戻り値０（NO_ERROR）正常に送信しました。

－１（ERROR）送信中にタイムアップしました。

ＤＳＰが受信を開始してなないかまたは停止しています。

参考 A324_htfrdt（）

使用例

#define BN0 0


code = 0x1234l；

if（A324_htfr（BN0,code））

printf（”transfer error\n”）；

else

printf（”transfer complete\n”）；

34

関数名データ送信

記述 int A324_htfrdt（board,code,len,data）； /* 任意ボード */

int _A324_htfrdt（code,len,data）； /* 現在ボード */


unsigned long code； /* 送信コード */

unsigned int len； /* 送信データ長 */

unsigned long *data； /* 送信データーバッファ */

説明ＤＳＰへ１ワードのコードと任意の長さのデータを送信します。

ホストからＤＳＰへ渡すデータが複数ワードの場合この関数を使用します。データは１ワード

４バイトのデータ、即ちｌｏｎｇまたはｆｌｏａｔに限られます。ＤＳＰのワード幅が４バイ

トであり、ＤＳＰのワード数が転送データ長の単位になります。データ長はホスト側が送信を

する時点で指定します。データ長はＭＡＸ１７００ワードです。ＤＳＰ側のデータ受取バッフ

ァは充分な長さが必要です。

送信処理中にソフトタイマでタイムアップを監視する機能とＣＴＲＬ＋Ｃによる中断を検出

する機能があります。ソース上に定数になっており、任意に変更が可能です。それぞれ次の定

数定義を変更してください。





戻り値０（NO_ERROR）正常に送信しました。

－１（ERROR）送信中にタイムアップしました。

ＤＳＰが受信を開始してなないかまたは停止しています。

参考 A324_htfr（）

使用例

#define BN0 0


unsigned long data［1700］；

unsigned int len；

len = 100；

for（c = 0；c ＜ 100；++c）

data［c］= c；

code = 0x1234l；

if（A324_htfrdt（BN0,code,len,data））

printf（”transfer error\n”）；

else

printf（”transfer complete\n”）；

35

関数名送信ステータス確認

記述 int A324_htxst（board）； /* 任意ボード */

int _A324_htxst（）； /* 現在ボード */


説明ＤＳＰへのデータ送信のステータスを取得します。

ＤＳＰとのデータ授受は双方向性の同一領域を介して行っています。先に送ったデータをまだ

ＤＳＰが取り出しを完了していない場合は、ホストは次のデータの送信を開始することはでき

ません。そのため送信に先だって、この関数を使用して通信バッファが空であることを確認し

ます。

戻り値０ＤＳＰへの送信を開始できます。

（ＤＳＰが受信完了報告を行った場合、または次のデータの受

信を開始している場合。）

０以外ＤＳＰへの送信を開始できません。

参考 A324_htfr（），A324_htfrdt（）

使用例

36

関数名送信相手完了確認

記述 int A324_hwit（board）； /* 任意ボード */

int _A324_hwit（）； /* 現在ボード */


説明ＤＳＰへのデータの送信後、ＤＳＰが受信の後処理を完了したかどうかのタイミングを同期す

る目的で使用します。例えば、ＤＳＰ側がデータ受信後、なんらかの処理を行いホストはその

完了を待機してから次の処理を開始する場合などに使用します。

この関数はシーケンシャルにデータを送信するだけの場合には特に実行する必要はありませ

ん。

戻り値０ＤＳＰは送信処理を完了しました。

(ＤＳＰが受信完了報告を行った場合、または次のデータの受信

を開始している場合。)

０以外ＤＳＰは送信後の処理中です。

参考 A324_htfr（），A324_tfrdt（）

使用例

#define BN0 0


unsigned long data［1700］；

unsigned int len；

if（A324_htfrdt（BN0,code,len,data））

exit（1）；

for（；；）

｛

if（ !A324_hwit（BN0））break；

｝

printf（”DSP”s receive porccess complete\n”）；

37

関数名ＤＳＰボードへ割り込み発生

記述 int A324_int0（board）； /* 任意ボード */

int _A324_int0（）； /* 現在ボード */


説明ホストからＤＳＰに対して割り込みを発生します。ホストからＤＳＰへの同期に利用できます。

ハード的なINT0割り込みです。

ＡＤＳＰ３２４－２０（デバッガ）はこの機能を使用していますので、この関数を使用する場

合のユーザプログラムのデバッグは行えません。ホストとＤＳＰ間の同期が、リアルタイムで

かつ速度が要求される場合を除いて極力A324_hxxxx関数を使用してください。

戻り値０（NO_ERROR）常に０

使用例

#define BN0 0

A324_int0（BN0）

38

関数名関数ライブラリ初期化

記述 int A324_libinit（seg,io）；

引数 unsigned int seg； /* メモリアドレス */

unsigned int io； /* ＩＯポートアドレス */

説明ライブラリの初期化とボードの実装確認をします。

本ライブラリを使用するのに先だって、必ず実行してください。

メモリアドレスとＩＯポートアドレスはボードのディップスイッチの設定により変更できま

す。ハードウェア・ユーザーズマニュアルを参照のうえ、ボードの設定と同一にしてください。

ｉｏ：ＤＳＷ１０２，１０３の設定

ｓｅｇ：ＤＳＷ１０１の設定

ｓｅｇに与えるアドレスはアドレス値の際、下位１４ビットを除いた１０ビット分を与えます。

ボードの工場出荷時設定の場合ＤＳＷの設定は０Ｅ００００ｈに設定されていますから、ｓｅ

ｇには０Ｅ０００ｈを与えます。

戻り値０（NO_ERROR）正常終了しました。

－１（ERROR）異常終了しました。有効なボードが１枚も検出できませんでし

た。（注１）

使用例

#define seg 0xe000 /* メモリアドレス */

#define IO 0xe300 /* ＩＯドレス */

if（A324_libinit（SEG,IO））

printf（”no avtive board detect\n”）；

exit（1）；

｝

else

｛ printf（”init complete\n”）；｝

（注１）異常終了する原因として次のような事が考えられます。

① ボードのIOアドレス設定（DSW102，DSW103）と引数ｉｏが一致していない。

② ボードのメモリベース設定（DSW101）と引数ｓｅｇが一致していない。

③ ボードのIOまたはメモリとほかのボードとが重複している。

④ ＩＯ拡張ラックに接続した場合に、ラックのメモリ領域に関するディップスイッチの設定

が正しくなされていない。

39

関数名ＣＯＦＦファイルのダウンロード

記述 int A324_loadc（board,name）； /* 任意ボード */

int _A324_loadc（name）； /* 現在ボード */


char name； /* ファイル名 */

説明ＣＯＦＦフォーマットのオブジェクトファイルをＤＳＰの外部メモリにダウンロードします。

ロード可能なファイルはリンカーが出力した実行形式のモジュールです。ロード可能な領域は

ＤＳＰの外部メモリ（０番地からメモリの実装されている範囲）です。

但し、既にロードされている領域への重複したロードの検出は行いません。モニタがすでにロ

ードされている場合など、ロードするアドレスには充分注意してください。

戻り値０（NO_ERROR）正常にロードが完了しました。

－１（ERROR）ロード異常です。原因は次のいずれかです。


２）ファイルはＣＯＦＦファイルではない。

３）ファイルが異常。

４）メモリ書き込みの異常。

参考 A324_loadm（），A324_savec（）

使用例

#define BN0 0

char *coff_name；

coff_name = ”TEST.OUT；”

if（A324_loadc（BN0,coff_name））

printf（”load error\n”）；

exit（1）；

else

printf（”load complete\n”）；

40

関数名メモリからのダウンロード

記述 int A324_loadm（board,adrs,len,code）； /* 任意ボード */

int _A324_loadm（adrs,len,code）； /* 現在ボード */


unsigned long adrs； /* ロードアドレス */

unsigned long len； /* データ長 */

unsigned long *code； /* データーバッファ */

説明ホストのメモリに蓄えられたデータなどをＤＳＰの外部メモリにダウンロードします。ロード

するデータ長はＤＳＰから見たワード数を指定します。ロードするデータの型はｆｌｏａｔま

たはｌｏｎｇです。

ロード可能な領域はＤＳＰの外部メモリ（０番地からメモリの実装されている範囲）です。但

し、すでにロードされている領域への重複したロードの検出は行いません。モニタがすでにロ

ードされている場合など、ロードするアドレスには充分注意してください。

戻り値０（NO_ERROR）正常にロードが完了しました。

－１（ERROR）ロード異常です。メモリに正しく書き込めません。

参考 A324_loadc（）

使用例

#define BN0 0

#define LEN 1024


unsigned long len；

float data［LEN］；

len = LEN；

adrs = 0x2000；

if（A324_loadm（BN0,adrs,len,（unsigned long*）data））

｛

printf（”load error\n”）；

exit（1）；

｝

else

printf（”load complete\n”）；

41

関数名モニタコマンド実行

記述 int A324_moniter（board,prms）； /* 任意ボード */

int _A324_moniter（prms）； /* 現在ボード */


A324_mon_prm *prms； /* モニタ引数・戻り値 */

説明モニタとハンドリングをし、モニタコマンドを実行します。

モニタを使用したユーザプログラムの起動はこの処理を使用しています。

モニタチップメモリのアクセスはこの関数を使用します。

モニタへの引数・戻り値は構造体で与えます。引数構造体はヘッダファイルに定義してありま

す。コマンド番号も同じく構造体に定義されています。


－１（ERROR）異常終了しました。モニタとのハンドリングができません。

原因は次のいずれかです。

１）モニタがロードしていない。

２）モニタが破壊されている。

３）ボードが停止している。

使用例オンチップメモリの読み出しをします。

#include ”lib324.h”

#define BN0 0


unsigned long value；

A324_mon_prm prms； /* モニタ引数・戻り値 */

prms.code = MC_READ； /* メモリ読みだし */

prms．prm1 = 0x809800； /* アドレス */

if（A324_moniter（BN0,&prms）

｛

printf（”moniter error\n”）；

exit（1）；

｝

printf（”address ： %81x\n”,prms.prm1）；

printf（”data ： %81x\n”,prms.res1）；/* 読みだした値 /*

42

関数名ＤＳＰメモリへのダウンロード

記述 int A324_putmem（board,adrs,data）； /* 任意ボード */

int _A324_putmem（adrs,data）； /* 現在ボード */


unsigned long adrs； /* メモリのアドレス */

unsigned long data； /* メモリデータ */

説明ホストのメモリからＤＳＰの外部メモリへデータをダウンロードします。データ長は１ワード

です。


－１（ERROR）ベリファイエラーです。

参考 A324_getmem（）

使用例

#define BN0 0

#define LEN 100

unsigned long buff［LEN］,*ptr；


int c；


for（ptr = buff,c = 0；c ＜ LEN；++c）

_A324_putmem（adrs++,*ptr++）；

43

関数名ボードリセット

記述 void A324_reset（board）； /* 任意ボード */

void _A324_reset（）； /* 現在ボード */


説明ＡＤＳＰ３２４をリセットします。

ホールドの制御は行っていません。停止状態でリセットした場合はリセット後も停止状態を保

持しています。また、実行状態でリセットされた場合にはリセットベクタ（０番地）の指標す

るアドレスから実行を開始します。

リセットされたかどうかの確認は直接的には行えません。


使用例

#define BN0 0

A324_reset（BN0）；

44

関数名ボード実行開始

記述 int A324_run（board）； /* 任意ボード */

int _A324_run（）； /* 現在ボード */


説明ＤＳＰボードを実行状態にします。

戻り値０（NO_ERROR）実行開始しました。

－１（ERROR）ボードの異常です。

参考 A324_hold，A324_holdstus（）

使用例

#define BN0 0

if（A324_run（BN0））

printf（”board error\n”）；

else

printf（”board running\n”）；

45

関数名ＣＯＦＦファイルへのアップロード

記述 int A324_savec（bd,ad,size,entry,name）； /* 任意ボード */

int _A324_savec（ad,size,entry,name）； /* 現在ボード */

引数 unsigned int bd； /* ボード番号 */

unsigned long ad； /* 先頭番地 */

unsigned long size； /* ワードサイズ */

unsigned long entry； /* スタート番地 */

char *name； /* ファイル名 */

説明ＤＳＰの外部メモリをＣＯＦＦファイルに格納します。

格納時に必要に応じてプログラムのスタート番地を指示できます。プログラムだけでなく、デ

ータ領域もセーブできます。

格納したファイルはダウンロード関数A324_loadc（）などでロードできます。



１）ファイル名不正でファイルがオープンできない。

２）同名ファイルがあり、かつリードオンリーでファイルが

オープンできない。

３）ディスクの空き領域が不足している。

参考 A324_savem（），A324_loadc（）

使用例

#define BN0 0

unsigned long adrs； /* 先頭番地 */

unsigned long size； /* ワードサイズ */

unsigned long entry； /* スタート番地 */


adrs = 0x400；

size = 0x200；

entry = 0； /* 不要なら０を指定 */

name = ”RESULT.OUT”；

if（A324_savec（BN0,adrs,size,entry,name））

printf（”COFF file write error\n”）；

else

printf（”COFF file write complete\n”）；

46

関数名メモリへのアップロード

記述 int A324_savem（board,adrs,size,buff）； /* 任意ボード */

int _A324_savem（adrs,size,buff）； /* 現在ボード */


unsigned long adrs； /* 先頭番地 */

unsigned int size； /* ワードサイズ */

unsigned long *buff； /* データーバッファ */

説明ＤＳＰの外部メモリのデータなどをホストのメモリにアップロードします。

アップロードするデータ長はＤＳＰから見たワード数を指定します。

アップするデータ型はｆｌｏａｔまたはｌｏｎｇです。

アップロード可能な領域はＤＳＰの外部メモリ（０番地からメモリの実装されている範囲）で

す。

戻り値０（NO_ERROR）常に０。

参考 A324_loadm（），A324_savec（）

使用例

#define BN0 0

#define LEN 100


unsigned long buff［LEN］；

unsigned int len；

len = LEN；

adrs = 0x2000；

A324_savem（BN0,adrs,len,buff）；

47

関数名ユーザプログラム実行開始（＃１）

記述 int A324_start（board,adrs）； /* 任意ボード */

int _A324_start（adrs）； /* 現在ボード */



説明ＤＳＰボードのモニタとハンドリングをしてユーザプログラムを起動します。

ユーザプログラムのほか、モニタがロードしてあり、ボードが実行状態でないと起動できませ

ん。



１）ボードが停止している。

２）モニタがロードしていない。

３）ボードの異常。

参考 A324_entryc（）

使用例

#define BN0 0

unsigned long entry；

char *user；

user = ”USER.OUT”；


_A324_bdinit（）；

_A324_hold（）；

_A324_loadc（”MON324.OUT”）； /* モニタは必要 */

_A324_loadc（user）；

_A324_reset（）；

_A324_run（）； /* ここではモニタが走る */

A324_entryc（user,&entry）；

if（_A324_start（entry））

printf（”start error\n”）；

else

printf（”start user program\n”）；

48

関数名ユーザプログラム実行開始（＃２）

記述 int A324_startm（board,name）； /* 任意ボード */

int _A324_startm（name）； /* 現在ボード */



説明ＤＳＰプログラムのリンカーが出力したマップファイルから、プログラムの起動番地の取得と

ユーザプログラムの実行を一括して行います。

この関数はA324_entrym（）とA324_start（）を実行しています。

本関数は、ＡＤＳＰ３２０－００のライブラリとの互換を保つために用意されたものです。同

様の機能がA324_entryc（）とA324_start（）で行えます。ロードするプログラムは通常Ｃ

ＯＦＦファイルですし、ＣＯＦＦファイルには実行開始番地が含まれています。一方、マップ

ファイルは必ずしもＣＯＦＦファイルとペアになっているという保証はありません。したがっ

て、安全の為に出来ればA324_entryc（）を使用してください。



１）ボードが停止している。

２）モニタがロードしていない。

３）ボードの異常。

４）マップファイルが見つからない。

５）マップファイルの異常。

参考 A324_entrym（），A324_start（）

使用例

#define BN0 0

unsigned long entry；


_A324_bdinit（）；

_A324_hold（）；

_A324_loadc（”MON324.OUT”）； /* モニタは必要 */

_A324_loadc（”USER.OUT”）；

_A324_reset（）；

_A324_run（）； /* ここではモニタが走る */

if（_A324_startm（”USER.MAP”））

printf（”start error\n”）；

else

printf（”start user program\n”）；

49

関数名ＣＯＦＦからのシンボル取り出し

記述 int A324_symbolc（file_name,sym_name,value）；

引数 char *file_name； /* ＣＯＦＦファイル名 */

char *sym_name； /* シンボル名 */

unsigned long *value； /* 取得した値 */

説明ＤＳＰプログラムのＣＯＦＦファイルから変数などのアドレス情報を取得します。ＤＳＰプロ

グラムの開発時にリンカーが出力したＣＯＦＦファイルを取り込み、変数名を指標にしてアド

レス情報を取得します。プログラム開発時などでアドレスが流動的な場合に有用です。

取り出しの可能なシンボルはグローバル宣言のある変数、関数に限ります。

Ｃ言語の場合は大域変数でクラスがstaticでないものおよび、staticでない関数です。

Ｃ言語のシンボルはソースで定義した名称の先頭に _ が付いたシンボルになります。

戻り値０（NO_ERROR）正常に検出しました。




３）ファイルはＣＯＦＦファイルではない。

参考 A324_symbolm（），A324_entryc，A324_entrym（）

使用例

#define BN0 0

unsigned long value； /* 値バッファ */

unsigned long adrs； /* アドレス */


char *coff_name； /* ＣＯＦＦファイル名 */

coff_name = ”TEST.OUT”；

sym_name = ”_value”；

if（A324_symbolc（coff_name,sym_name,&adrs））

｛

printf（”symbol get error\n”）；

exit（1）；

｝

A324_getmem（BN0,adrs,&value）

printf（”symbol %s\n”,sym_name）；

printf（”address %81x\n”,adrs）；

printf（”value %81x\n”,value）；

50

関数名マップからのシンボル取り出し

記述 int A324_symbolm（file_name,sym_name,value）；

引数 char *file_name； /* マップファイル名 */


unsigned long *value； /* 取得した値 */

説明ＤＳＰプログラムのマップファイルから変数などのアドレス情報を取得します。ＤＳＰプログ

ラムの開発時にリンカーが出力したマップファイルを取り込み、変数名を指標にしてアドレス

情報を取得します。プログラム開発時などでアドレスが流動的な場合に有用です。

取り出しの可能なシンボルはグローバル宣言のある変数、関数に限ります。

Ｃ言語の場合は大域変数でクラスがstaticでないものおよび、staticでない関数です。

Ｃ言語のシンボルはソースで定義した名称の先頭に _ が付いたシンボルになります。

戻り値０（NO_ERROR）正常に検出しました。




３）ファイルはマップファイルではない。

参考 A324_symbolc（），A324_entryc，A324_entrym（）

使用例

#define BN0 0

unsigned long value； /* 値バッファ */

unsigned long adrs； /* アドレス */


char *map_name； /* マップファイル名 */

map_name = ”TEST.MAP”；

sym_name = ”_value”；

if（A324_symbolm（map_name,sym_name,&adrs））

｛

printf（”symbol get error\n”）；

exit（1）；

｝

A324_getmem（BN0,adrs,&value）

printf（”symbol %s\n”,sym_name）；

printf（”address %81x\n”,adrs）；

printf（”value %81x\n”,value）；

51

関数名ボード実装確認

記述 int A324_valid（board）；


説明指定されたボード番号のボードが実装されているかどうかを取得します。ボードが実装されて

いるかどうかはライブラリ初期化関数が確認をし、変数に保存されています。この関数はその

変数の値を返します。

戻り値１（TRUE）ボードは実装されています。

０（FALSE）ボードは実装されていません。

使用例実装されているボードを全てリセットします。

#define BD_MAX 16 /* ボードＭＡＸ */

int bn；

for（bn = 0；bn ＜ BD_MAX；++bn）

if（A324_valid（bn））

A324_reset（bn）；

52

５ＢＩＯＳ

５．１概要

ＡＤＳＰ３２４ボード上で動作するユーザプログラムから使用するサブルーチン群です。ＤＳＰ

ボード用のアセンブラまたはＣ言語によるプログラムから呼び出して使用します。

ＩＯの制御、ホストとの通信、ＤＳＰボード間での通信、ＡＤとＤＡの制御などＩＯに関するハ

ンドリングのほか、浮動小数点フォーマットのＩＥＥＥとＤＳＰ間の変換の機能もサポートしてい

ます。

５．２機能概略

ＢＩＯＳには大別して次のような機能が用意されています。

① タイマー割り込み管理

② 外部割り込み管理

③ ボード間シリアル通信

④ 対ホスト間パラレル通信

⑤ 浮動小数フォーマット変換（ＩＥＥＥとＤＳＰ間）

５．３使用方法

（１）コーリングシーケンス

アセンブラからの呼び出し例

LDI 10,R0 ；機能番号

LDI 5,R1 ；引き数

CALL _BIOS ；BIOS呼び出し

Ｃ言語からの呼び出し例

#include ”cbios324.h”

unsigned CREGS inregs,outregs；

inregs.i.R0 = 10； /* 機能番号 */

inregs.i.R1 = 5； /* 引き数 */

cbios（&inregs,&outregs）；

（２）リンクの方法

リンクはリンカーコマンドファイルに次の行を追加します。

cbios324.lib

｛例｝ｔｓｔ．ｃとリンクする場合

-c

tst.obj

cbios324.lib

５．４ＢＩＯＳ機能一覧

53

① ＢＩＯＳ初期化

機能番号機能名

０ＢＩＯＳバージョン番号取得

１ＢＩＯＳ初期化

② ＩＯポート入出力


２～６システム予約

③ シリアル入出力


７ＳＩＯ初期化

８入力開始

９入力ステータス取得

１０データ入力

１１入力データーバッファ設定

１２入力データーバッファクリア

１３（未使用）

１４出力開始

１５出力ステータス取得

１６（未使用）

１７出力データーバッファ設定

１８出力データーバッファクリア

④ タイマー割り込み


１９タイマー初期化

２０（未使用）

２１タイマー割り込みエントリ番地設定

２２タイマー割り込み制御

⑤ 外部割り込み


２３外部割り込みエントリ番地設定

２４外部割り込み制御

⑥ 対ホスト間割り込み


54

２５システム予約

⑦ Ａ／Ｄ入力


２６～３４システム予約

⑧ Ｄ／Ａ出力


３５～４０システム予約

⑨ Ａ／Ｄ＋Ｄ／Ａ


４１～４７システム予約

⑩ 対ホスト間通信


４８通信初期化

４９通信ステータスの取得

５０１ワードコードの送信

５１複数データの送信

５２相手処理完了待機

５３受信ステータスの取得

５４１ワードコードの受信

５５複数データの受信

５６受信処理完了報告

⑪ 対前段ＤＳＰ間通信


５７～６５システム予約

⑫ 対後段ＤＳＰ間通信


６６～７４システム予約

⑬ 浮動小数フォーマット変換


７５ＩＥＥＥからＴＩへ変換

55

７６ＴＩからＩＥＥＥへ変換

56

５．５ＢＩＯＳ詳細

５．５．１詳細のフォーマット凡例

機能番号 ** 機能名称：詳細フォーマット凡例

ここではＢＩＯＳ詳細説明の一般的な入出力仕様とコーリングシーケン

スについて説明しています。

入力パラメータ

Ｒ０：機能番号を設定します。

Ｒ１：必要に応じて引数を設定します。

Ｒ２：必要に応じて引数を設定します。

Ｒ３：必要に応じて引数を設定します。

出力パラメータ

Ｒ０：保存されます。

Ｒ１：結果を返す場合以外は保存されます。

Ｒ２：結果を返す場合以外は保存されます。

Ｒ３：結果を返す場合以外は保存されます。

備考１）特に指定しない限りレジスタは全て保存されます。

２）引数は基本的には次の要領でＢＩＯＳに渡します。

①３ワード以内であればレジスタＲ１～Ｒ３で渡す。

②それより多い場合は引数構造体にセットしそのアドレスをレジス

タで渡す。

③R0には必ず機能番号を設定します。冗長さを避けるため、かく説明

ではレジスタ”Ｒ０”については逐一表示してありません。

57

５．５．２ＢＩＯＳの詳細

機能番号０機能名称：ＢＩＯＳバージョン番号の取得

機能説明ＢＩＯＳのバージョン番号の取得とＢＩＯＳの常駐の確認をします。バー

ション番号は１６進数４桁で、Ｖ．ＭＭ．Ｅを示しています。Ｖはバージ

ョン番号、ＭＭは同一バージョン内でのモディファイ番号、Ｅは同一モデ

ィファイ内のリリース番号です。

入力パラメータＲ１：－

Ｒ２：－

Ｒ３：－

出力パラメータＲ１：バージョン番号（V.MM.E）

Ｒ２：－

Ｒ３：－

－－－－－ * －－－－－ * －－－－－ * －－－－－* －－－－－

機能番号１機能名称：ＢＩＯＳ初期化

機能説明ＢＩＯＳが使用している作業領域を初期化します。


Ｒ２：－

Ｒ３：－

出力パラメータＲ１：－

Ｒ２：－

Ｒ３：－

－－－－－ * －－－－－ * －－－－－ * －－－－－* －－－－－

機能番号２～６機能名称：システム予約

機能説明ＢＩＯＳ１．０２．０ではシステム予約になっています。

58

機能番号７機能名称：ＳＩＯ初期化

機能説明ＳＩＯによる通信の為の初期化をします。

入力パラメータＲ１：ＳＩＯの通信モード（０／１）

Ｒ２：ＳＩＯの通信速度コード（０～１３）

Ｒ３：－


Ｒ２：－

Ｒ３：－

備考ＳＩＯの通信モード

０：未定義（動作は保証されません。）

１：固定長バッファを用いる。

ＳＩＯの通信速度コード表

コード速度（ＢＰＳ）

０１０Ｍ（禁止）

１５Ｍ

２２．５Ｍ

３１Ｍ

４６２５Ｋ

５５００Ｋ

６２００Ｋ

７１００Ｋ

８５０Ｋ

９２０Ｋ

１０１０Ｋ

１１５Ｋ

１２２Ｋ

１３１Ｋ

59

機能番号８機能名称：入力開始

機能説明ＳＩＯの入力を開始します。

機能番号７の設定条件による受信が開始します。

入力パラメータＲ１：ＳＩＯチャンネル（０／１）［０に固定］

Ｒ２：－

Ｒ３：－


Ｒ２：－

Ｒ３：－

備考入力開始処理はデータの受信バッファのクリアと受信割り込みの許可処

理がまず行われます。その後、ＳＩＯのハードウェアにより１ワード受信

が完了するごとに割り込みが発生し、この割り込みにて残るデータを１ワ

ードずつ次々と受信します。従って、メインルーチンで割り込みを禁止（Ｓ

ＴのＧＩＥ＝０）にすると受信ができません。

－－－－－ * －－－－－ * －－－－－ * －－－－－* －－－－－

機能番号９機能名称：入力ステータス取得

機能説明ＳＩＯの入力のステータスを取得します。

ＳＩＯによりデータが受信完了したかどうかが、これにより確認できます。


Ｒ２：－

Ｒ３：－

出力パラメータＲ１：０＝受信は完了していない

０以外＝受信したワード数

Ｒ２：－

Ｒ３：－

60

機能番号１０機能名称：データ入力

機能説明受信したデータのバッファからデータを取り出します。ユーザー設定のバ

ッファを使用している場合は、この機能を使用せず、直接その領域をアク

セスしてもかまいません。


Ｒ２：データ読み出しバッファ

Ｒ３：－

出力パラメータＲ１：有効なデータ数

Ｒ２：－

Ｒ３：－

－－－－－ * －－－－－ * －－－－－ * －－－－－* －－－－－

機能番号１１機能名称：入力データーバッファ設定

機能説明ユーザー設定のデーターバッファを設定します。


Ｒ２：データーバッファアドレス

Ｒ３：バッファの長さ（ワード数）


Ｒ２：－

Ｒ３：－

－－－－－ * －－－－－ * －－－－－ * －－－－－* －－－－－

機能番号１２機能名称：入力データーバッファクリア

機能説明エラーの発生などでＳＩＯのデータを途中でクリアする場合に使用しま

す。


Ｒ２：－

Ｒ３：－


Ｒ２：－

Ｒ３：－

－－－－－ * －－－－－ * －－－－－ * －－－－－* －－－－－

機能番号１３機能名称：（未使用）

機能説明

機能番号１４機能名称：出力開始

61

機能説明データを通信バッファにセットし送信を開始します。

この機能を実行する前に機能番号７のＳＩＯの初期化が必要です。また、

データを繰り返し送る場合は機能番号１５を使用して、先に送信したデー

タの送信が完了しているかどうかを確認しなければいけません。


Ｒ２：送信データアドレス

Ｒ３：有効データ長


Ｒ２：－

Ｒ３：－

備考出力開始処理はデータの送信バッファへのセットと先頭の１ワードの送

信がまず行われます。その後、ＳＩＯのハードウェアにより１ワード送信

が完了するごとに割り込みが発生し、この割り込みにて残るデータを１ワ

ードずつ次々と送信します。従って、メインルーチンで割り込みを禁止（Ｓ

ＴのＧＩＥ＝０）にすると送信ができません。

－－－－－ * －－－－－ * －－－－－ * －－－－－* －－－－－

機能番号１５機能名称：出力ステータス取得

機能説明機能番号１４で開始した送信が完了したかどうかをこの機能で確認しま

す。

送信が完了していない間は次の送信は起動してはいけません。


Ｒ２：－

Ｒ３：－

出力パラメータＲ１：０＝送信は完了している。

０以外＝送信は完了していない。

Ｒ２：－

Ｒ３：－

－－－－－ * －－－－－ * －－－－－ * －－－－－* －－－－－

機能番号１６機能名称：（未使用）

機能説明

62

機能番号１７機能名称：出力データーバッファ

機能説明ユーザーが確保した出力データーバッファを今後データ出力バッファと

して使用します。ＢＩＯＳの持つバッファは１２８ワードですからそれ以

上長いバッファを使用したい場合この機能でバッファを変更します。


Ｒ２：バッファアドレス

Ｒ３：バッファの長さ


Ｒ２：－

Ｒ３：－

－－－－－ * －－－－－ * －－－－－ * －－－－－* －－－－－

機能番号１８機能名称：出力データーバッファクリア

機能説明ＳＩＯの送信を中断してバッファをクリアします。

通信相手がダウンしている場合以外、通常はこの機能を使用することはあ

りません。


Ｒ２：－

Ｒ３：－


Ｒ２：－

Ｒ３：－

－－－－－ * －－－－－ * －－－－－ * －－－－－* －－－－－

機能番号１９機能名称：タイマー初期化

機能説明オンチップタイマーを使用して一定周期ごとにある処理を行いたい場合

のタイマーの初期化をします。


Ｒ２：－

Ｒ３：－


Ｒ２：－

Ｒ３：－

－－－－－ * －－－－－ * －－－－－ * －－－－－* －－－－－

機能番号２０機能名称：（未使用）

機能説明

63

機能番号２１機能名称：タイマー割り込みエントリ番地設定

機能説明タイマー割り込みエントリ番地を設定します。

入力パラメータＲ１：タイマー番号（０／１）

Ｒ２：処理手続きアドレス

Ｒ３：インターバル時間［μｓｅｃ］


Ｒ２：－

Ｒ３：－

備考タイマーのチャンネルのうち、＃０（ＴＩＭ０）はＡ／Ｄの自動取り込み

に使用します。Ａ／Ｄとの共用はできません。Ａ／Ｄを接続しない場合に

のみ、ＴＩＭ０、ＴＩＭ１供に使用できます。

処理手続きは割り込み処理ですので、次の事項を守って記述してください。

①手続きの終了はRETI命令で終了してください。

②手続き開始時点の全てのレジスタの値を保存してください。

Ｃ言語の場合は関数名を、特殊な予約名c_intnn（）とすることでこの条

件に合うコードが生成されます。（nnは０１から９９）

－－－－－＊－－－－－＊－－－－－＊－－－－－＊－－－－－

機能番号２２機能名称：タイマー割り込み制御

機能説明タイマーの割り込みを禁止・許可します。

入力パラメータＲ１：タイマー番号（０／１）

Ｒ２：０＝割り込み禁止

１＝割り込み許可

Ｒ３：－


Ｒ２：－

Ｒ３：－

備考タイマーのチャンネルのうち、＃０（ＴＩＭ０）はＡ／Ｄの自動取り込み

に使用します。Ａ／Ｄとの共用はできません。

Ａ／Ｄを接続している場合に、ＴＩＭ０を停止するとＡ／Ｄの自動取り込

みが停止してしまいます。

64

機能番号２３機能名称：外部割り込みエントリ番地設定

機能説明外部割り込み（ＩＮＴ３）が発生した時の処理を設定します。


Ｒ２：割り込み処理手続きアドレス

Ｒ３：－


Ｒ２：－

Ｒ３：－

備考外部割り込みＩＮＴ３はＡ／Ｄ＋Ｄ／Ａボードではトリガーの検出に使

用します。

処理手続きは割り込み処理ですので、次の事項を守って記述してください。

①手続きの終了はRETI命令で終了してください。

②手続き開始時点の全てのレジスタの値を保存してください。

Ｃ言語の場合は関数名を、特殊な予約名c_intnn（）とすることでこの条

件に合うコードが生成されます。（nnは０１から９９）

－－－－－＊－－－－－＊－－－－－＊－－－－－＊－－－－－

機能番号２４機能名称：外部割り込み制御

機能説明外部割り込みを禁止・許可します。


Ｒ２：０＝割り込み禁止

１＝割り込み許可

Ｒ３：－


Ｒ２：－

Ｒ３：－

－－－－－＊－－－－－＊－－－－－＊－－－－－＊－－－－－

機能番号２５機能名称：システム予約


－－－－－＊－－－－－＊－－－－－＊－－－－－＊－－－－－

機能番号２６～４７機能名称：システム予約


65

機能番号４８機能名称：通信初期化（対ホスト）

機能説明対ホスト通信の初期化をします。


Ｒ２：－

Ｒ３：－


Ｒ２：－

Ｒ３：－

－－－－－＊－－－－－＊－－－－－＊－－－－－＊－－－－－

機能番号４９機能名称：通信のステータスの取得（対ホスト）

機能説明対ホスト通信のステータスを取得します。これで送信・受信両方の状態が

取得できます。


Ｒ２：－

Ｒ３：－

出力パラメータＲ１：０＝通信領域は空

１＝送信データをまだ相手が読みだしていない。

２＝通信領域には有効な受信データが入っている。

Ｒ２：－

Ｒ３：－

－－－－－＊－－－－－＊－－－－－＊－－－－－＊－－－－－

機能番号５０機能名称：１ワードコードの送信（対ホスト）

機能説明対ホスト通信を使って１ワードのコードをホストに送信します。

送信を開始する前に機能番号４９で通信領域が空であることの確認を必

ず行ってください。

入力パラメータＲ１：送信コード

Ｒ２：－

Ｒ３：－


Ｒ２：－

Ｒ３：－

66

機能番号５１機能名称：複数データの送信（対ホスト）

機能説明対ホスト通信を使って１ワードのコードと複数のデータをホストに送信

します。送信を開始する前に機能番号４９で通信領域が空であることの確

認を必ず行ってください。

送信データは１次元配列に格納されているものとし、その先頭番地を与え

ます。

１度に通信可能なデータ長は大１７００ワードです。

入力パラメータＲ１：送信コード

Ｒ２：送信データアドレス

Ｒ３：送信データ長


Ｒ２：－

Ｒ３：－

－－－－－＊－－－－－＊－－－－－＊－－－－－＊－－－－－

機能番号５２機能名称：相手処理完了待機（対ホスト）

機能説明対ホスト通信を使ってデータをホストに送信した後、ホスト側の引き続き

行われる処理の完了を待機する必要がある場合はこの機能を使用します。

この機能は相手側が「完了報告」を行ったかどうかを検出するものです。

相手が「完了報告」を行うまでこの機能は終了しません。

相手がデータを読みだしたかどうかを知るには「通信ステータスの取得」

を使用します。


Ｒ２：－

Ｒ３：－


Ｒ２：－

Ｒ３：－

67

機能番号５３機能名称：受信ステータスの取得（対ホスト）

機能説明この機能は機能番号４９と同じです。ＡＤＳＰ３２０のＢＩＯＳと互換を

とるため用意されているものです。


Ｒ２：－

Ｒ３：－

出力パラメータＲ１：０＝通信領域は空

１＝送信データをまだ相手が読みだしていない。

２＝通信領域には有効な受信データが入っている。

－－－－－＊－－－－－＊－－－－－＊－－－－－＊－－－－－

機能番号５４機能名称：１ワードコードの受信（対ホスト）

機能説明対ホスト通信から１ワードのコードをホストから受信します。

受信を開始する前に機能番号４９（５３）で通信領域に有効データがある

ことを確認してから行ってください。


Ｒ２：－

Ｒ３：－

出力パラメータＲ１：受信コード

Ｒ２：－

Ｒ３：０

－－－－－＊－－－－－＊－－－－－＊－－－－－＊－－－－－

機能番号５５機能名称：複数データの受信（対ホスト）

機能説明対ホスト通信から１ワードのコード及び複数データをホストから受信し

ます。データ受取領域は充分な長さのものを予め用意し、そのアドレスを

与えます。有効なデータ数はレジスタＲ３に返ってきます。

受信を開始する前に機能番号４９（５３）で通信領域に有効データがある

ことを確認してから行ってください。

１度に通信可能なデータ長は大１７００ワードです。


Ｒ２：データ受取アドレス

Ｒ３：－

出力パラメータＲ１：受信コード

Ｒ２：－

Ｒ３：受信データ長

機能番号５６機能名称：受信処理完了報告（対ホスト）

機能説明対ホスト通信を使ってデータをホストから受信した後、引き続く処理の完

68

了をホストに通知したい場合にこの機能を使用します。

この機能は相手側が「相手終了待機」を行っている場合に待機を完了させ

ます。


Ｒ２：－

Ｒ３：－


Ｒ２：－

Ｒ３：－

－－－－－＊－－－－－＊－－－－－＊－－－－－＊－－－－－

機能番号５７～７４機能名称：システム予約


－－－－－＊－－－－－＊－－－－－＊－－－－－＊－－－－－

機能番号７５機能名称：ＩＥＥＥからＴＩへ変換

機能説明ＩＥＥＥ７５４フォーマットの単精度浮動小数をＴＩフォーマットの単

精度浮動小数に変換します。ホストからデータをもらってＤＳＰで計算す

る場合に必要です。

データは１次元の配列に格納されているものとし、そのアドレスと長さを

指定します。


Ｒ２：ＴＩ浮動小数のデータアドレス

Ｒ３：データ配列の長さ（ワード数）


Ｒ２：－

Ｒ３：－

69

機能番号７６機能名称：ＴＩからＩＥＥＥへ変換

機能説明ＴＩフォーマットの単精度浮動小数をＩＥＥＥ７５４フォーマットの単

精度浮動小数に変換します。ＤＳＰで計算した結果をホストへ渡す場合に

必要です。

データは１次元の配列に格納されているものとし、そのアドレスと長さを

指定します。


Ｒ２：ＴＩ浮動小数のデータアドレス

Ｒ３：データ配列の長さ（ワード数）


Ｒ２：－

Ｒ３：－

70

６プログラム開発手順

６．１プログラム構成

ＡＤＳＰ３２４－００の利用方法として次の２通りの方法が考えられます。

①ＤＳＰボード単体で動作する高速プロセッサ的な使用。

②ホストの処理の一部をＤＳＰボードで代行するアクセラレータ的な使用。

①…例えばＤＳＰに直接接続されたＡＤからデータを取り込み、ＤＳＰ内部で演算を行った後ＤＡ

から出力する、といった使用方法でデジタルフィルタ、デジタル制御などのアプリケーション

に相当します。

②…マンマシン・インタフェースやディスク・ドライブとのインタフェースをホストが処理し、時

間のかかる計算量の多い処理をＤＳＰが代行するといった使用方法でニューラルネットワー

クシミュレーター、振動解析、グラフィック処理などのアプリケーションに相当します。

まず、これらのうちのどの使い方をするかにより、ユーザーの記述すべきプログラムが明確にな

ります。

①ではＤＳＰボード用の単一なプログラムを作成します。

②ではホストとＤＳＰの両方のプログラムを作成します。

６．２開発言語

ホスト側プログラムが必要な場合はホスト用のＣコンパイラが必要です。付属ライブラリは１９

９８年６月現在ＭＳ－ＣＶｅｒ．７、ＭＳ－ＶＣＶｅｒ１．０、ＭＳ－ＶＣＶｅｒ４．２、

Ｖｅｒ５．ｘ及びＭＳ－ＶＢＶｅｒ４．ｘ、５．ｘに対応していますが、ライブラリのソー

スコードが添付されていますので他のコンパイラへの移植は可能です。

本マニュアルで説明しているライブラリについてはＭＳ－ＣＶｅｒ７．０のライブラリに

対して説明されています。ＭＳ－ＶＣＶｅｒ１．０のライブラリについては関数名が A324 から

A32Xに変わるのみの違いです。

またＭＳ－ＶＣＶｅｒ４．ｘ以降及び、ＭＳ－ＶＢのライブラリについては３２ビットボー

ドコントロールライブラリを参照してください。

ＤＳＰ側プログラムはＴＩ社からＣコンパイラ（ＡＮＳＩ準拠）及びアセンブラが供給されてい

ます。

６．３プログラミング

プログラミングは通常のプログラム同様、汎用のエディタでソースコードを記述し、ＤＳＰ用の

言語ツールで実行ファイルを作成します。

ＤＳＰ側プログラムはクロス環境で作成されます。即ち、ＤＳＰ用の言語ツールはホストのＭＳ

－ＤＯＳ上で動作し、ディスク上のソースコードに対して処理をし、オブジェクトコードを同じく

ディスク上に出力します。

リンカーの出力した実行形式のオブジェクトも同様です。このオブジェクトはもちろんＭＳ－Ｄ

ＯＳでは実行できません。従ってファイルの拡張子もＭＳ－ＤＯＳの実行ファイルとは異なってい

ます。

71

６．４ダウンロード

ディスク上に作成されたＤＳＰ用実行ファイルは次のいずれかの方法でＤＳＰボードにダウンロ

ードします。

①付属コマンドのダウンロードコマンドを使用し、ディスクからボードにロードする。

②ダウンロードの機能関数をホスト側のユーザ・ユーティリティに組み込み、ユーザーのユーティ

リティを実行することによりダウンロードする。

③弊社製デバッガＡＤＳＰ３２４－２０を起動し、ＬＯＡＤコマンドでロードする。

④オプションＲＯＭボードにＲＯＭ３２４を使用してＲＯＭに書き込み、ＤＳＰをＲＯＭモードで

使用する。

６．５デバッグと実行

ＤＳＰ側プログラムのデバッグには別売ソフトＡＤＳＰ３２４－２０が必要です。プログラムの

途中経過やその時のレジスタの閲覧、ステップ実行などのデバッグ作業はこのデバッガを用いて行

います。この時、３．４で説明したプログラムのダウンロード方法は、１～３のいずれかです。

デバッガを用いたデバッグはＲＯＭモードでは行えませんので、ＲＡＭ上でデバッグし、デバッ

グ完了後ＲＯＭ化することになります。

６．６運用

デバッガでデバッグの完了したプログラムは６．４の①②④のいずれかの方法でダウンロードす

るわけですが、この時、付属コマンドのブートモジュール・ジェネレーターを使用して、起動用モ

ジュール（スタートアップルーチン）を作成し、これと一緒にロードします。これはデバッガを使

用中にモニタが行っているＤＳＰ自身の初期化とユーザプログラムの開始を起動用モジュールに行

わせる為です。デバッグ完了後の運用時にはユーザプログラムとその起動用モジュールをペアでロ

ードするわけです。ロード後はボードのリセットにより自動的に実行を開始します。

ＲＯＭモードの場合にはパワオンと同時にユーザプログラムを実行します。

72

７プログラム開発と実行例

７．１概要

この章ではＡＤＳＰ３２４－００Ａを実際に使用し、サンプルプログラムを用いてプログラムの

開発から実行までを具体的に説明します。

デバッグの作業については説明いたしませんが、デバッガを使用せずに行える簡単な動作確認の

方法とデバッガを使用する場合に利用できるアセンブルリストの作成方法について説明します。使

用言語はＣ言語でＴＩ社製のコンパイラを使用します。今回使用したバージョンはＡＮＣＩ標準の

Ｖｅｒｓｉｏｎ４．５です。

アセンブラでの開発については特に触れませんが、アセンブルの方法の説明がしてあります。ま

た、アセンブルを完了し、リンク以後の操作はＣコンパイラドライバを使用せず直接リンカーを起

動した場合と同じですから参考にしてください。

ＤＳＰの初期化からプログラムの実行の方法は色々な方法が用意されていますが、この説明では

ホスト上のユーザプログラムと実行をする場合についてのみ説明しています。そのほかの方法はＱ

＆Ａなどを参考にしてください。

７．２開発環境と実行環境

７．２．１コンパイラのインストール

Ｃコンパイラのインストールは次の要領で行います。

CL30.EXEなどの実行ファイルはディレクトリに収納し、環境変数PATHを通します。

例えばＣ：￥Ｃ３０￥ＴＩＣというディレクトリを作成してその中に収納し、次のように

PATHを設定します。（注１）

PATH＝C:\C30\TIC

また、ライブラリファイルを検索するための環境変数であるC_DIRも同様に設定する必要がありま

す。

SET C_DIR＝C:\C30\TIC

Ｃ＿ＤＩＲという環境変数はコンパイラがインクルードファイルを捜す場合のデフォルトディレク

トリと、リンカーがライブラリを捜す場合のデフォルトディレクトリになります。

例えば、プログラムで#include＜math.h＞とした場合、math.hはC_DIRが指標するディレクトリ

内の C:\C30\TIC\MATH.H が取り込まれます。またリンカーコマンドファイルの－１スイッチで

-1rts.libと指定するとC:\C30\TIC\RTS.LIBをライブラリとしてリンクします。

（注１） PATH 変数の設定の詳細はお手持ちのＭＳ－ＤＯＳのマニュアルを参照の上、必要な PATH

は全て設定してください。

73

７．２．２付属コマンドのインストール

付属ディスク“Support Soft Ware”のUTYに収納されているユーティリティはＭＳ－ＤＯＳから

ＡＤＳＰ３２４－００Ａボードをコントロールするツール類です。ボードの実行開始や状態の表示

などに使用します。これらはいつでも使用できるようにPATHの通ったディレクトリに収納します。

例えばC:\C30\UTYに収納し、次のようにPATHを設定します。（注１）

PATH＝C:\C30\UTY\UTY

（注１）PATH 変数の設定の詳細はお手持ちのＭＳ－ＤＯＳのマニュアルを参照の上、必要な PATH

は全て設定してください。

７．２．３付属ライブラリのインストール

付属ライブラリはＭＳ－Ｃでホストプログラムにリンクします。適当なディレクトリに格納し、

リンク時に参照可能にします。

ここではC:\C700\LIB\に格納し、リンカー・レスポンスファイルで指定する方法を採用していま

す。

７．２．４ＢＩＯＳのインストール

付属ディスク“Support Soft Ware”のＢＩＯＳに収納されているＢＩＯＳはＣコンパイラの付属

ライブラリ（RTS.LIBなど）と同じディレクトリに収納してください。

ここではDIR＝C:\C30\UTY\BIOSに収納します。ＢＩＯＳのリンクはリンカーコマンドファイルに

‐L で指定を追加するかまたはオブジェクトファイルのリストを記述したレスポンスファイルに指

定を追加します。ここではレスポンスファイルで指定しています。

74

７．３プログラミング

７．３．１ホストプログラムの記述

ホストのプログラムとしては、ソースプログラムのほかリンク時に使用するリンカー・レスポン

スファイルを作成します。付属ディスクの\SAMPLE の中に収納されていますので参考にしてくださ

い。

●ソースプログラムＨＯＳＴ．Ｃ

●リンカー・レスポンスファイルＨＯＳＴ．ＬＮＫ

７．３．２ＤＳＰプログラムの記述

ＤＳＰのプログラムとしてはソースプログラムのほかにリンクに使用するリンカー・レスポンス

ファイルとリンカーコマンドファイルが必要です。レスポンスファイルとコマンドファイルはいず

れもリンカーに対して種々の指示をファイルから与えるものです。この２つのファイルを１つにま

とめる事も出来ますが、２つ用意する意義はレスポンスファイルで各プログラム毎に内容が異なる

オブジェクトファイル名などを指定し、コマンドファイルでプログラムに依存しない項目、ライブ

ラリの指定などをする、といった使い分けをするとよいでしょう。付属のディスクの\SAMPLE の中

に収納されていますので参考にしてください。

●ソースプログラムＤＳＰ．Ｃ

●コマンドファイルＵＳＥＲ．ＣＭＤ

●レスポンスファイルＤＳＰ．ＬＮＫ

７．３．３サンプルプログラムの説明

サンプルプログラムは次の処理を行います。

１．ＤＳＰアクセスのためのライブラリ初期化とＤＳＰの初期化をします。

２．ＭＯＮ３２４．ＯＵＴとＤＳＰ．ＯＵＴをロードし、ＭＯＮ３２４を使用してＤＳＰ．ＯＵ

Ｔを実行開始します。

３．テストデータの作成のため、データ配列の長さＬと初期値をコンソールから読み込みます。

４．２個の長さＬの１次元配列を初期値でクリアします。

５．時間測定のため、システム時間を取得します。

６．この２個のデータをＤＳＰプログラムとのハンドリングによりＤＳＰに渡します。

７．ＤＳＰはこの２個の配列を１次元ベクトルと見てベクトルの内積を求め、結果をホストに返

却します。

８．ホストはシステム時間を取得し、先の時間との差から所要時間を求め表示します。

９．ＤＳＰから受け取った値を表示します。

実際のプログラムは３項から９項がループになっています。また、計算そのものは速すぎてシス

テム時間では測定が出来ませんので、同じ計算を指定回数繰り返し計算し、そのトータル時間を表

示するようにしています。

75

７．４ＤＳＰプログラムのコンパイル

ＤＳＰのプログラムのコンパイルには２通りの方法があります。１つはコンパイラ・ドライバ

CL30.EXEを使用する方法です。この方法は一般的で、ＵＮＩＸライクな方法ですし、ホストのＭＳ

－Ｃなどの処理系と同様な使い方ができます。２つめはコンパイラ・ドライバを使用せず、バッチ

ファイルを使用します。コンパイラは幾つかのフェーズ別に実行プログラムが分かれていますので

バッチファイルで自動的に実行します。

コンパイルは次のように行います。

まず、ソースファイルの入っているディレクトリに移動します。DSP.C ではインクルードファイ

ルCBIOS324.Hを取り込みますのでDIRコマンドでインクルードファイルCBIOS324.Hがあるか確認

してください。もしも無い場合は付属ディスクの\BIOS からコピーします。次にコンパイラを起動

します。

CL30 DSP.C

とすると、コンパイラのプロンプトに続いて処理された関数が順次表示されます。エラーメッセー

ジが無ければ完了です。コンパイラ・ドライバは終的にアセンブラまで起動し、その結果カレン

トディレクトリにオブジェクトファイルDSP.OBJが残ります。

DSP.OBJ の基となるアセンブラソース DSP.ASM が途中で生成されていますが、ドライバにより消

去されます。これをディスクに残すには次のいずれかの方法で起動します。

CL30 – K DSP.C

CL30 – S DSP.C

前者は単にアセンブラソースファイルを残します。

後者はさらにＣのソースプログラムとの対応をコメントとして挿入します。

７．５ＤＳＰプログラムのアセンブル

コンパイラ・ドライバCL30でコンパイルした場合はアセンブル作業まで自動的に行われ、ユーザ

ーが特にアセンブラを起動する必要はありません。しかし、アセンブラソースによるプログラムと

混在する場合、アセンブラプログラムはユーザーがアセンブルしなければなりません。また、後ペ

ージで説明するデバッグ用の情報としてアセンブルリストを作成する場合にも必要です。

アセンブラの起動は次のように行います。

ASM30 DSP

ASM30 DSP – L

いずれもオブジェクトファイルDSP.OBJをディスク上に残します。

前者は単にDSP.ASMというプログラムのアセンブルのみを行います。

後者はアセンブル後にアセンブルリストを出力します。

76

７．６ＤＳＰプログラムのリンク

プログラムのリンクの仕方にはリンカーLNK30.EXE を起動してリンクする方法と、コンパイラ・

ドライバCL30.EXEにスイッチ指定でリンクまでさせる方法の２通りあります。ここでは前者の方法

を説明します。後者はコンパイラのマニュアルを参照してください。

リンカーには２種類の動作モードがあり、オブジェクトファイルやコマンドファイルをリンカー

の出力するプロンプトに対して入力してゆく方法と、それらを一旦ファイルにしておき（レスポン

スファイル）、起動時にそのファイル名を指定する方法とがあります。ここでは、レスポンスファイ

ルによる方法を説明します。

リンカーに与えるファイルとして、２つのファイルを用意します。レスポンスファイル（DSP.LNK）

と、コマンドファイル（USER.CMD）です。レスポンス・ファイルにはユーザプログラムのファイル

名や必要に応じてリンクするライブラリの名称などを記述します。サンプルのDSP.LNKは次の内容

になっています。

（／*…*／の部分はＣと同じくコメントです。）

-o dsp.out

-m dsp.map

dsp.obj

c:\c30\uty\bios\sbios324.lib

user.cmd

意味は２行目より順に、

２．実行ファイルの名称をdsp.outとする。

３．マップファイルをdsp.mapという名称で出力する。

４．オブジェクトはdsp.objをリンクする。

５．b:\biosにあるcbios324.libを結合する。

６．コマンドファイルはuser.cmdを使用する。

となります。この例ではオブジェクトは１個だけですが、複数の場合には４の項目を１行に１個ず

つ、必要なだけファイル名を列挙します。

コマンドファイルはユーザプログラムをリンクする際のメモリマップなどの緒元を定義してあり

ます。これは標準的なものが付属ディスクのディレクトリ\BIOS の中にあるので、コピーして使用

してください。ファイルの用意ができたら、リンカーを次の様に起動します。

LNK30 DSP.LNK

まず、これにより起動されたリンカーは DSP.LNK の内容とその中で指示されたコマンドファイル

USER.CMDの指示に従ってリンクを行い、その結果、ディスクにDSP.OUTとDSP.MAPを出力します。

DSP.OUT はＣＯＦＦ（コッフ）ファイルと呼ばれ、実行可能なファイルです。ただし、実行可能

とは言っても、ＭＳ－ＤＯＳで実行可能では無いため、拡張子を.OUTとしています。

DSP.MAP はリンクした結果、スタート番地やラベルなどがメモリのどこに結合されたか出力され

ます。エディタでその内容を確認できます。このファイルは付属コマンドのSTGEN324.EXEや付属ラ

イブラリ中の一部の関数で利用するほか、プログラムの高速化の作業などをする場合に参照します

ので、常に作成するように心がけてください。

77

７．７ホストプログラムのコンパイル

ホストのプログラムではインクルードファイル LIB324.H を取り組んでいますのでカレントディ

レクトリにあるか確認します。無い場合には付属ディスクのディレクトリ\LIBからコピーします。

コンパイルは次の様にします。

cl – c – AL host.c

これによりhost.cはラージモデルでコンパイル作業のみを行います。ユーザプログラムによって、

オプションスイッチは必要に応じて付加してください。

７．８ホストプログラムのリンク

ホストプログラムのリンクはレスポンスファイルを使用して行います。ホスト用のレスポンスフ

ァイルはhost.lnkです。この中でライブラリc:\c30\uty\lib\lib324l.libをリンクするように指

示されていますから、ライブラリがあるか確認します。もし無い場合は、２．３でインストールし

たライブラリ名をフルパスで指定するようレスポンスファイルの内容を変更します。

[email protected]

これによりカレントディレクトリにhost.exeが作成されます。

７．９プログラムの実行

実行の前にカレントディレクトリにmon324.outがあるか確認をしてください。無ければ付属ディ

スクのディレクトリ\MON からコピーします。これは host.exe がプログラムの中で dsp.out と

mon324.outをロードしているからです。

プログラムの起動と操作は次の様にします。下線部分を入力します。

A:\>host

ベクトルの内積を求める。

0 : Do proc other : EXIT to DOS (0/1) ? 0

data length (1 ˉ 1700) ? 1024

loop times? 10000

first value ? 1

recieve status = 0

recieve 1 data ( s )

rslt [ 0 ] = 1024.000000

3秒

0 : add other : EXIT to DOS (0/1) ? 1

A : \ > dsp

78

８Ｑ＆Ａ

ここでは「ＡＤＳＰ３２４－００Ａ」ボード、並びにオプションボードなどについてユーザーが

持つ疑問や、陥りやすいトラブルなどのうちのいくつかをＱ＆Ａ形式にまとめました。

Ｑ：付属コマンドを使用したら“ボードが異常です”と表示されたのですが…。

Ａ：ＡＤＳＰ３２４－００Ａボードは場合により一見して異常状態におちいる場合がありますが、本質

的な異常ではありません。簡単に復旧できます。

ＡＤＳＰ３２４－００ＡボードにはＤＳＰをホールドしてＤＳＰの外部メモリをＨＯＳＴから直接

アクセス可能にする“ホールドモード”と呼ばれるモードがあり、これはＨＯＳＴからＩ／Ｏへ信

号をＯＵＴすることにより行います。ボードへのプログラムのダウンロードはこの機能を使用して

います。

一方、ＡＤＳＰ３２４－００Ａが搭載しているＤＳＰの「ＴＭＳ３２０Ｃ３１」には自身のホール

ドをコントロールする機能があります。プライマリ・バス・コントロール（ＰＢＣ）レジスタと呼

ばれるレジスタにある値を書くことによりホールドを禁止することができます。この機能は本来Ｄ

ＳＰが優先度の高い、ある処理をリアルタイムに行っている際に外部からのホールドにより処理を

妨げられるのを防ぐための機能です。

ここで、もしＤＳＰが暴走などにより誤ってホールド禁止状態になっているとＨＯＳＴからコント

ロールできませんので“ボードが異常”となります。付属コマンドではホールドがコントロールで

きない場合にボード異常としているからです。

この場合ＲＥＳＥＴ３２４コマンドでＤＳＰをリセットすることよりＤＳＰのコントロールを取り

戻すことができます。もし電源を入れたままの状態で今まで一度もプログラムをロードしていない

とか、ロードしたプログラムは実行させると暴走する可能性のある場合はコマンドはＲＥＳＥＴ３

２４／ＨとしてＡＤＳＰ３２４－００Ａボードを停止状態のままにしてください。

Ｑ：ボードが実装してあるのに“ボードが未実装です”と表示されたのですが…

Ａ：ボードの実装が正しく認識されていません。設定を正しく行って下さい。

付属コマンドはボードの実装確認を１６台のボードを切り替え、それぞれに対しユニークな値を書

き込み、再度ボードを切り替えて書き込んだ値が読めるかどうか、ボードが切り替えできたかどう

かでボードの実装を判断しています。

従って次のような場合にはボードの実装が正しく認識できません。

① Ｉ／Ｏボードベースアドレスの設定がボードと付属コマンドで違う。

② メモリ・ベースアドレスの設定がボードと付属コマンドで違う。

③ ＤＳＰのメモリ領域に別のメモリが実装され、領域が重複している。

④ ＤＳＰのメモリが読み書きできない。

①と②の場合はボードのディップスイッチ（DSW101,102,103など）の設定を変更し、付属ソフトを

そのまま使用した場合などに発生します。付属コマンドの設定をディップスイッチの設定に合わせ

て変更してください。変更はCSTM324.EXEを使用します。

③の場合は例えばＥＭＳメモリやグラフィック関係のイメージメモリボードなどと共存している場

合に発生します。ＡＤＳＰ３２４以外のボードを一旦全て取り外して起動してみてください。もし

重複している場合はどちらかを設定変更するか、同時には使用しないようにします。

④の場合は具体的にはＡＤＳＰ３２４－００ＡボードをＩＯ増設ラックに実装し、ＩＯ増設ラック

の電源を投入していないとか、ＩＯ増設ラックに実装するメモリの領域を設定するディップスイッ

チが正しく設定していないなどの場合にもこの症状が現れる場合があります。

79

Ｑ：プログラムが走っているかどうか見る方法はありませんか？

Ａ：デュアルポートメモリを利用すればリアルタイムで確認できます。

ＨＯＳＴとＡＤＳＰ３２４の間はデュアルポートメモリで接続されています。ラン・モードではこ

の領域をＨＯＳＴとＤＳＰの両方から同時にアクセスができます。

この領域を使用して任意の時期に任意の値を授受できます。

次のプログラム例をご覧下さい。ＤＳＰがデュアルポートメモリの値を次々と更新し、ＨＯＳＴで

はそれをコンソールに次々と表示します。（ＨＯＳＴのプログラムはラージモデルでコンパイルし

てください。）

/* PC9801 program */

#define SEG 0xe000

#define OFF 0x400

#define PTR （SEG*0x100001+OFF*4）

main（）

｛

long *ptr；

ptr ＝（long*）PTR；

for（；；）

｛ printf（”%081x\r”，*ptr）；｝

｝

/* DSP program */

#define BASE 0x200000

#define OFF 0x400

#define ADRS （BASE+OFF）

main（）

｛

long *ptr；

ptr ＝（long*）ADRS；

for（；；）

｛ *ptr += 1；｝

｝

このことを利用し、プログラムのメインループの中で必ず通る所で値を更新したり、プログラムの

流れに従って１，２，３・・などのようにあらかじめ定めた値を設定するなど色々と応用してくだ

さい。

但し、この領域はＢＩＯＳと付属のライブラリのデータ送受信の機能で使用しています。送受信機

能を使用する場合にはこの使い方はできません。

80

Ｑ：スモールモデルだとプログラムが動かないのですが…

Ａ：ビッグモデルでは動作したプログラムがスモールモデルでは動作しない場合があります。

スモールモデルだと動かない原因の殆どはプログラムのデータ領域が６４Ｋワードを超過している

か、超過していなくても６４Ｋワードのページ境界をまたいで配置されている場合です。ＴＭＳ３

２０Ｃ３０用Ｃコンパイラのスモールモデルでプログラムを正しく動作させるには次の項目を確認

して下さい。（まず準備として、リンカーでプログラムをリンクする際にマップファイルを出力して

おきます。）

①セクション・アロケーション・マップ（SECTION ALLOCATION MAP）を参照し、.bss セクション

がどこに配置されているかを見る。

②.bssセクションの長さが６４Ｋワード以下で、かつページ境界（６４Ｋワード境界）をまたいで

いないか確認します。いずれもＯＫなら問題ありません。

次の例は６４Ｋワード以下ですが、ページ境界をまたいでいます。

section page origin length input sections

.bss 0 0000FF00 00000283 UNINITIALIZED

③.bssセクションが６４Ｋワード以上の場合はスモールモデルでは（ごく一部の特殊な場合を除い

て）正しく動作しません。ビッグモデルでコンパイルしてください。

なお、この時リンクするランタイムライブラリもビックモデル用ライブラリを使用します。但し

ＡＤＳＰ３２４のＢＩＯＳはビックモデルに対応していますから変更の必要はありません。

④.bss セクションが６４Ｋワード未満でもページ境界をまたいでいる場合は上記③の様にビッグ

モデルにする方法以外に配置を移動して1ページ内に納める方法が考えられます。

配置の移動はリンカーのコマンドファイルを変更します。変更の要点は2点で、メモリマップを

決定するMEMORYを変更してちょうどページ境界からで、メモリ領域を定義することと、セクショ

ンのメモリへの配置を決定する SECTIONS を変更して.bss セクションをそこにリンクするように

変更しました。この状態でリンクを行えば、プログラム変更などで、もし.bssセクションが６４

Ｋワードを超過すると、リンカーがエラーを出しますからスモールモデルでの限界に対してのチ

ェックも兼ねています。

（注：変更前のＲＡＭ領域が０ｘＦＦ００番地から始まっているのは説明のため、わざと中途半

端な番地に配置したものです。）

81

《変更前》

/* SPECIFY THE SYSTEM MEMORY MAP */

‐C

‐lrts30.lib

MEMORY

{

VECS : org = 0x000000 len = 0x00040 /* vector area */

MON : org = 0x000040 len = 0x003c0 /* monitor area */

RAM : org = 0x00ff00 len = 0x20100 /* user RAM area */

RAM0 : org = 0x809800 len = 0x400 /* on‐chip RAM BLOCK 0 */

RAM1 : org = 0x809c00 len = 0x400 /* on‐chip RAM BLOCK 1 */

}

/* SPECIFY THE SECTIONS ALLOCATION INTO MEMORY */

SECTIONS

{

.text : { } > RAM /* CODE */

.cinit : { } > RAM /* INITIALIZATION TABLES */

.const : { } > RAM /* CONSTANT DATAS */

.rtse : { } > RAM /* EXTENDED RUN‐TIME SUPPORT LIBRARY */

.stack : { } > RAM /* SYSTEM STACK */

.bss : { } > RAM /* GLOBAL & STATIC VARS */

.data : { } > RAM /* DEFAULT DATA SECTION */

.sysmem : { } > RAM /* DYNAMIC MEMORY‐DELETE IF NOT USED */

}

《変更後》

/* SPECIFY THE SYSTEM MEMORY MAP */

MEMORY

{


MON : org = 0x000040 len = 0x003c0 /* monitor area */

RAM : org = 0x001000 len = 0xf000 /* user RAM area */


RAM1 : org = 0x809c00 len = 0x400 /* on‐chip RAM BLOCK 1 */

}

/* SPECIFY THE SECTIONS ALLOCATION INTO MEMORY */

SECTIONS

{

:

}

82

Ｑ：付属ライブラリが動作しないのですが…

Ａ：付属ライブラリが正しく動作しない原因としてはさまざまな場合があります。次にいくつかのケー

スを示します。原因となり得る全ての要因は網羅していませんが、デバッグを行う上での重要な参

考になると思われます。

● ライブラリのメモリモデルとメインプログラムのメモリモデルが異なっていませんか。

● ライブラリの初期化関数に与える引数ｓｅｇとｉｏがボードの設定と違っていませんか。

● ボードのＩＯかメモリが、ＨＯＳＴ本体または他の増設ボードのＩＯもしくはメモリと重複し

ていませんか。

● ボードの状態（ノーマル／ホールドモード）が、そのライブラリ関数の使用可能な状態に設定

されていますか。（→４．５関数使用可能状態一覧表を参照）

● ＤＳＰで扱うメモリのデータは全て３２ビットです。ホストから見た場合４バイトまたはｌｏ

ｎｇで1ワードとなります。データ長、ほかアドレスの計算は間違っていませんか。

● ＤＳＰで扱う浮動小数はホストのデータとフォーマットが違います。ホストとＤＳＰ間で浮動

小数データを渡す場合は変換が必要です。また、ＤＳＰでは float も double も同じ３２ビッ

ト浮動小数（つまりfloat）として扱われます。

Ｑ：ボードにプログラムをロードするにはどうすればいいのですか？

Ａ：ボードにプログラムをロードする方法は、大別して次の２通りあります。

①付属コマンドのＬＯＡＤ３２４を使用する。

ＬＯＡＤ３２４はリンカーの出力したＣＯＦＦ実行ファイルまたはＨＥＸファイルをＡＤＳＰ３２

４－００Ａボードにロードします。ＭＳ－ＤＯＳのコマンドですのでバッチコマンドに組み込んだ

り、ユーザプログラムからチャイルド起動したりできます。

②付属ライブラリのダウンロード関数を利用する。

付属ライブラリにはダウンロード関数が用意されています。ＨＯＳＴ側のプログラムに組み込んで

使用します。ダウンロードできるファイルはリンカーの出力したＣＯＦＦファイル、またはＨＥＸ

ファイルです。ファイル名を指定し、ディスクファイルからＡＤＳＰ３２４に直接ダウンロードを

します。

83

Ｑ：ＭＳ－ＤＯＳのバッチコマンドでボードを起動できますか？

Ａ：ＡＤＳＰ３２４－００ＡにはＭＳ－ＤＯＳから直接ボードをコントロールしたりする専用のコマン

ドが付属しています。それをバッチコマンドに組み込めば良いのです。

ボードのリセット、プログラムのダウンロード、実行、など基本的なコマンドが揃っています。詳

しくは「Ｑ：ボードにプログラムをロードするにはどうすればいいのですか？」を参照してくださ

い。

Ｑ：プログラムをＲＯＭ化してボード単体で動作させたいのですが…

Ａ：プログラムをＲＯＭ化するには次の点に注意が必要です。

①付属コマンドのＲＯＭ３２４を使用してＲＯＭ化してください。

②ＲＯＭ化可能な領域は１０００ｈ番地から６０Ｋワードです。

６０Ｋワードを越える場合はＲＯＭ化ができません。マップファイルを参照して.text と.cinit

の両領域のほか、０番地のベクタとスタートアップモジュールのワード数の合計が６０Ｋワード

に入るかどうか確認します。ｆｆ００ｈ番地からｆｆｆｆ番地にはスタートアップ・プログラム

が入りますから、ユーザプログラムが１０００ｈ番地からｆｅｆｆｈ番地に入ればよいことにな

ります。

③ＲＯＭ化動作中ＤＳＰは、マイクロコンピュータ・モードで動作します。割り込みベクタやトラ

ップベクタはＲＡＭ１ブロックの後尾に位置しますので注意してください。

④データ・テーブルなどは外部から与えることができませんので、.text などの領域（ＲＯＭ化さ

れる領域）にリンクするか、またはプログラム自身で計算して作成するなどの方法をとる必要が

あります。（注１）

ただし、Ｃで記述した初期化つきの変数はＣのスタートアップルーチンが初期化しますのでユー

ザプログラムで特に改めて初期化する必要はありません。

⑤デバッガを使用してのデバッグ作業はＲＯＭに変更すると行えなくなります。

この場合は完全にデバッグが完了するまではＲＡＭのままで動作させておき、その後ＲＯＭに変

更してください。

注１）リンカーのコマンドファイルには、ボード付属のＲＯＭ．ＣＭＤを使用してください。

Ｑ：ボードを単体で使用する場合、電源はどのように供給するのですか？

Ａ：ＡＤＳＰ３２４－００ＡボードはＨＯＳＴのＩＯ拡張スロットから５Ｖ電源の供給を受けています。

従ってＨＯＳＴから切り放して使用する場合にはＨＯＳＴに代わって５Ｖ電源を供給する必要があ

ります。できれば、ＩＯ拡張ラックなどの電源を実装したラック形状のものに実装したまま、ラッ

クごとＨＯＳＴからの切り放しをしてください。

どうしてもボードのみで（裸の状態で）使用したい場合には、電源の供給は基板エッジコネクタか

ら直接行います。このコネクタはボードには付属していませんから、ユーザサイドで別途手配をし

てください。

84

Ｑ：モニタは何にどうやって使うのですか？

Ａ：ＡＤＳＰ３２４－００Ａのモニタではユーザーによる利用は、

① メモリの書き込み

② メモリの読み出し

③ メモリフィル

④ メモリ転送

⑤ プログラムの実行

などが比較的簡単に利用できます。

①～④項のメモリの読み書きはオンチップメモリに対しても利用できます。ホールドモードを利用

したメモリの読み書きではＤＳＰの外部メモリしかアクセスできませんが、モニタを利用すればオ

ンチップメモリもアクセスできる事になります。

⑤のプログラム実行はＧＯコマンドのみが比較的簡単に利用できます。

ユーザプログラムの実行開始番地をレジスタ構造体のＰＣに設定し実行開始をしますが、この手順

は付属ライブラリの A324_start（）と同じですから、ライブラリ関数を利用した方が便利で、モ

ニタの実行機能をユーザーが直接使用する必要はないと思われます。

それ以外の機能でSTEPのBREAKに関するものは、機能を利用するうえで該当するアドレスのプログ

ラムを逆にアセンブルする必要があり、利用はかなり大変ですからマニュアルには機能として記載

はしてありますが、利用をするのは難しいと思われます。

ステップ実行、ブレイクポイントなどは別売りのデバッガをご利用ください。

Ｑ：メモリは全てＲＡＭ！では、ＤＳＰはどうやって走るのですか？

Ａ：ＡＤＳＰ３２４にはＲＯＭ化されたＩＰＬはありません。

出荷時にはリセットベクタを含むメモリ領域が全てＲＡＭになっています。

この領域は電源投入直後にはＲＡＭの内容が不定ですから、ＤＳＰを実行させると暴走をする可能

性がありますので、リセットコマンドを使用してＤＳＰをリセットすると同時に停止状態に設定し

ます。

次にモニタまたはスタートアップモジュールとユーザプログラムをロードコマンドでロードします。

つまり、ＭＳ－ＤＯＳ上のロードコマンド（または付属ライブラリのロード関数）がＩＰＬの代行

をする訳です。ＡＤＳＰ３２４－００ＡはＤＳＰを停止状態にすることにより、ＤＳＰの外部メモ

リをＨＯＳＴから直接アクセス出来る機構を備えており、それを利用してプログラムをロードしま

す。ここまではＤＳＰは全く走りません。

ロードが完了するとＤＳＰは実行可能ですので、ロードコマンドのスイッチ／ｇ、またはホールド

コマンドでＤＳＰの停止状態を解除します。ＤＳＰは先にリセットされていますから停止状態の解

除と供にリセットベクタの指標する番地から実行を開始します。

85

Ｑ：Ｃで書いたプログラムはどうやって実行されるのですか？

Ａ：Ｃで記述したプログラムの実行開始は通常コンパイラに付属のランタイムライブラリの中にあるス

タートアップルーチン_c_int00 から開始するようにコードが生成されます。（リンカーコマンドフ

ァイルに－ｃを指定）

その実際の番地はプログラム領域の先頭ではありません。

一方、ＤＳＰはリセットされると０番地のベクタ情報が指標する番地に分岐します。そこで０番地

（リセットベクタ）は_c_int00へ分岐するように書かれていなければいけません。

ＡＤＳＰ３２４では実際には０番地から_c_int00 へ至るまでの間にＤＳＰのバスの初期化やレジ

スタの初期化の処理が必要です。これらの処理は、デバッガを使用している場合はモニタが、その

以外の場合はＳＴＧＥＮ３２４が生成したスタートアップモジュールが行っています。要約すると

次のフローの順でmainに到達します。

リセット

リセットベクタリセット時の実行開始番地

モニタまたはスタートアップモジュールＤＳＰのバスとレジスタ初期化

_c_int00 Ｃの変数・静定数の初期化と

スタックなどの設定

main ユーザプログラム実行開始

86

Ｑ：処理速度に不満があり、さらに高速化をしたいのですが…

Ａ：プログラムの根本的な改造をする事なく、簡単に高速化する方法があります。ここでその方法をい

くつかご紹介します。

① プログラムをオンチップＲＡＭに載せる。

② データをオンチップＲＡＭに載せる。

③ アライン命令でキャッシュを効果的に機能させる。

④ プログラムをアセンブラで記述する。

①と②の方法はプログラムを改造することなく高速化する一番簡単な方法です。

オンチップＲＡＭはノーウェイトでアクセスできるうえ、２つの領域に分かれていてその両方また

は片方と外部メモリを同時にアクセスできる機構（ハーバード・アーキテクチャー）を備えていま

す。この機構と、ＤＳＰ自身の持つパイプライン処理機能により、プログラムとデータを同時にア

クセスが可能となり、プログラムをオンチップメモリに載せればウェイトの面でもプログラムとデ

ータの同時アクセスの面でも高速化が望めます。

プログラムとデータの両方を外部メモリに配置した場合と比較して約１．２倍～１．５倍の速度が

得られます。

③のアライン命令はキャッシュをより効果的に利用する方法で、アセンブラソースの時点で.ALIGN

という疑似命令を用い、プログラムの配置を操作してキャッシュのヒット率を意図的に向上させる

ものです。Ｃ言語でプログラムした場合でも利用できます。

プログラムの動作が３２ワードまたは６４ワード以下の短い範囲で局所的なループを幾つも構成し

ているような構造の場合に効果的な反面、アライン命令によりアドレスを調整するためにＮＯＰ命

令や分岐命令が強制的に挿入されるため、プログラムの全領域を広く、くまなく平均的に実行する

場合には逆効果が現れる場合もあります。

長いルーチンには適用せず、サブルーチン単位で実施するか、繰り返し回数の多い部分にのみ適用

するとよいでしょう。

④のプログラムをアセンブラで記述する方法はＤＳＰに限らず一般に高級言語が有する特性です。

この方法は決して簡単な方法とは言えませんが、確実でかつ効率的な方法です。その効果はコンパ

イラの効率、アセンブラの持つ命令体型、プログラムしようとしている処理の内容などにより、ア

センブラと高級言語との差はまちまちですが、ＴＭＳ３２０Ｃ３０の一般的な場合、Ｃとアセンブ

ラの速度比は２倍～５倍程度です。

特殊な場合として、３２０Ｃ３０の特殊な命令群（パラレル命令や特殊なアドレッシングなど）を

効果的に使用し、も適化した場合で約１０倍です。

ＴＩ社製のＣではＣのプログラムとアセンブラプログラムのリンクが可能なほか、Ｃのソース上に

アセンブラを直接記述するインライン・アセンブラが可能です。引数、戻り値、及びレジスタの保

存に関する約束さえ守れば同一ファイルにＣとアセンブラを混在させることができます。

以上の各方法の具体的詳細は次のＱ以降で説明します。

87

Ｑ：プログラムをオンチップＲＡＭに載せる方法はありますか？

Ａ：プログラムをオンチップＲＡＭに載せることができます。この方法の実施手順はプログラムが小さ

い場合とそうでない場合の２つのケースに分かれます。

まず１番目はプログラムが比較的小さく、１Ｋワード（または２Ｋワード）に入ってしまう場合で

す。この場合にはリンカーコマンドファイルのSECTIONSを変更し、.text（＝プログラム領域）の

配置先を変更します。

次の例は.textをオンチップＲＡＭ１に、スタック領域.stackをオンチップＲＡＭ０にそれぞれ配

置した例です。

MEMORY

{


MON : org = 0x000040 len = 0x00fc0 /* monitor area */

RAM : org = 0x01000 len = 0x3f00 /* user RAM area */


RAM1 : org = 0x809x00 len = 0x400 /* on‐chip RAM BLOCK 1 */

}

SECTIONS

{

.text : { } > RAM1 /* CODE */

.cinit : { } > RAM /* INITIALIZATION tables */

.stack : { } > RAM0 /* SYSTEM STACK */

.bss : { } > RAM /* GLOBAL & STATIC VARS */

sysmem { } > RAM /* DYNAMIC MEMORY‐DELETE IF NOT USED */

}

２番目のケースはプログラムが大きくて１Ｋワードを超過している場合です。

この場合には、少し厄介ですがプログラムを分割する必要があります。

分割と配置の変更は次の手順で行います。

ａ）プログラムのソースを分割します。分割の指針はも実行頻度の高い処理関数を独立したソー

スファイルにします。このファイル内の関数を終的にオンチップＲＡＭに落としますから、

目算でプログラムの長さが１Ｋワード以下になるようにします。もとのソースの行数とマップ

ファイルの.textの長さから算定するとよいでしょう。

ｂ）このファイルの先頭に次の行を追加したうえで通常通りコンパイルします。

asm（” .sect RAM_TEXT”）；

これはこのファイル内のプログラムコードを通常の.textセクションでなく、RAM_TEXTという

セクションに収納することを指示する役割を果たします。ここでRAM_TEXTとは適当に決めた名

称です。

ｃ）リンカーコマンドファイルを次の様に変更したうえでリンクします。

次の例の場合.text セクションをＲＯＭという領域にリンクし、RAM_TEXT セクションを RAM1

という領域にリンクします。RAM_TEXTセクションとは、言うまでもなく上記ｂ）で定義したセ

クション名です。

88

配置変更はこれで完了ですが、一応念のためリンカーが出力したマップファイルを参照し、セクシ

ョン配置情報（SECTION ALLOCATION MAP）や、シンボル情報（GLOBAL SYMBOLS）を確認して配置

がオンチップＲＡＭに正しく結合できたか確認します。

Ｑ：データをオンチップＲＡＭに載せる方法はありますか？

Ａ：データをオンチップＲＡＭに載せることができます。この方法の実施手順にはいくつかの場合があ

ります。

まず、データ領域である.bss領域が小さく、１Ｋワード以下の場合です。この場合が一番簡単です。

この場合にはリンカーコマンドファイルの SECTIONS を変更して、.bss の領域をＲＡＭ０かＲＡＭ

１に結合します。領域の容量の確認方法と結合領域の変更方法はプログラムの場合と同じですから

「Ｑ：プログラムをオンチップＲＡＭに載せる方法はありますか？」を参考にしてください。

次に.bss領域が大きく、１Ｋワードを超過する場合には少し厄介です。

データ領域はプログラム領域の場合のように簡単にはセクションの分割ができません。コンパイラ

が割り付ける変数領域は全て明示的に.bss に割り付けられることによります。（プログラムの場合

にはコンパイラが出力するプログラム領域.text への割り付けがデフォルト・セクションであり明

示されていない事を利用し、先頭に.sect 命令を挿入することによりファイル内の全コードを目的

とするセクションに割り付けられました。）

ひとつの方法としてはＣ言語のソース上でその変数を外部参照（ｅｘｔｅｒｎ）に変更することに

より領域の確保はコンパイラに任せず、実際の領域確保をユーザーがアセンブラ命令を用いて行う

事とし、この時に.bssとは別のセクション内に確保する方法です。次の例を見てみましょう。変数

bb［100］をOCRAM_DTというセクションを設けてその中に確保しています。

89

0001 int aa[100] ;

0002 externint bb[100] ;

0003

0004 asm( “_bb .usect OCRAM_DT,100” ) ;

0005 asm( “ .global _bb” ) ;

0006

0007 main( )

0008 {

0009 int c ;

0010 for ( c = 0 ; c < 100 ; c++ ){

0012 aa[ c ] = bb[ c ] ;

0013 }

0014 {

１行目のaa［100］はコンパイラにより.bssに割り付けられる通常の変数です。

２行目のbb［100］はコンパイラにとっては変数名の定義のみとなります。

このｂｂという変数の実体は４行目で定義されており、意味は［OCRAM_DTという名称のセクション

内に_bbとういう名称で、１００ワードの領域を確保しなさい］ということです。

これで.bssとは異なるセクションに領域が割り当てられました。

５行目は別のＣプログラムからも参照できるよう、この変数に大域変数の宣言をします。これで後

はプログラムをオンチップＲＡＭに割り付けた場合と同様リンカーコマンドファイルで OCRAM_DT

セクションをオンチップ領域に割り当てます。

この方法の問題点・注意点として、次のことがあげられます。

① アセンブラ中の変数名はＣの変数名の前に′′を付ける。

② 確保するワード数などにＣの定数（＃ｄｅｆｉｎｅなど）が使用できない。

③ 初期化付きの変数の場合は別の方法を用いなければいけない。

後に、.bss領域が大きく１Ｋワードを超過する場合のもう一つの方法として、ソースレベルでの

改造が必要ですが小細工を必要としない方法として、ポインターを使用してオンチップＲＡＭ領域

を使用する方法です。

そのひとつは．ｓｙｓｍｅｍセクションをオンチップＲＡＭに配置しておき、malloc関数で領域を

確保する場合と、もうひとつはユーザーが直接ポインターを設定する場合です。

この方法は、ポインターを使用し間接参照をする性質上、単一の変数や大域変数配列の任意の要素

を直接アクセスする場合などは効果がありません。

そのほか、それぞれの特徴としてはmalloc関数の場合は移植性が高く、ある事情で.sysmemセクシ

ョンを外部メモリに配置変更が生じても変更は簡単で、リンカーコマンドファイルを変更するだけ

で良い反面、メモリ管理のオーバーヘッドのためオンチップＲＡＭ領域をユーザーがフルに使用す

ることができません。また、ユーザーが直接ポインターを設定する場合には、変数の番地に任意の

番地を割り付けられる反面、リンカーコマンドファイルも含めて、ほかの変数やプログラムなどの

領域と重複しないように充分注意する必要があります。

90

Ｑ：オンチップＲＡＭには何を載せたらよいのですか？

Ａ：一義的に決めることはできません。アプリケーションやプログラミングの内容により、適宜使い分

ける必要があります。

オンチップＲＡＭの領域は１Ｋワード×２ブロックと、アプリケーションによっては決して広いと

は言えない場合があります。プログラム領域もデータ領域も載せたいし、スタックも、動的領域

（mallocによる領域）も… と、あれもこれもでは全ての希望が叶うようにはゆきません。そこで

いずれかを選択しますが、その時の指針として何を優先するかが問題となります。これといった決

定的な指針はありませんが、基本的な考え方としては「もアクセス頻度の高い領域を優先する」

ことになります。アクセス頻度の判定をするためのいくつかのヒントを次に挙げますので参考にし

てください。

①Ｃ言語のプログラムでは局所変数、関数呼び出し、引数の受渡しにスタック領域を使用します。

従って多くの局所変数を使用していたり、多くの引数を伴った関数呼び出しを頻繁に行うような

場合はスタック領域（.stackセクション）を優先します。

②malloc関数により動的に割り付けた領域は、.sysmemセクションに割り付けられます。malloc関

数により確保した領域を頻繁にアクセスする場合は.sysmemセクションを優先します。

③大域変数とｓｔａｔｉｃな局所変数は.bssセクションに割り付けられます。これらの領域を頻繁

にアクセスする場合は.bssセクションを優先します。

④プログラムのループが長く（６４ワードより長く）、キャッシュの効果が期待できない場合は上記

（①～③）のうちいずれか１つに次いで、プログラム領域（.textセクション）を優先します。

⑤プログラムに対してキャッシュが効果的に機能するように対策した場合など、アセンブラでＲＰ

ＴＳ命令を多用している場合は上記（①～③）を優先し、プログラム領域（.text セクション）

は外部メモリに配置します。

91

Ｑ：キャッシュを効果的に利用する方法はありますか？

Ａ：キャッシュは使用していても必ず充分な効果を発揮しているとは限りません。充分な効果を確実に

引き出すにはユーザーによる手助けが必要な場合があります。

ＡＤＳＰ３２４－００Ａのモニタまたはブートモジュールはユーザプログラムを起動する際にキャ

ッシュをイネーブルにしています。従って条件さえ整えばキャッシュは機能します。

しかし、ＴＭＳ３２０Ｃ３０のキャッシュにはその構造上、プログラムの条件により効果的に機能

する場合とそうでない場合があります。いわゆるキャッシュのヒット率という問題です。キャ

ッシュがヒットしなければキャッシュの効果は現れません。

このヒット率を向上させるためには次の２点の条件が必要です。（注１）

① プログラムのループの長さが６４または３２ワード以上であること。

② ループの位置が３２ワード境界から始まっていること。

この②の条件を満たすため、アセンブラには専用の疑似命令が用意されています。.align疑似命令

です。この疑似命令のすぐ後に続く命令はリンカーが配置を決定する時点で、３２ワード境界の先

頭に配置されることが保証されています。直前の命令が境界の途中の場合には、リンカーが自動的

にＮＯＰ（無実行）命令またはＢＵ（無条件分岐）命令を挿入しアドレスの補正が行われます。

次の例は、この命令を利用しＣプログラムのループをキャッシュが有効に機能するようにしたもの

です。

fill（ dt,len,cnst ）

int *dt；

int len,cnst；

｛

asm（” ．slign”）；

while（ len--）｛ *dt++ = cnst；｝

｝

ループを構成する文の直前にインライン・アセンブラ機能を使用して.align疑似命令を挿入しまし

た。この例はあくまで方法を説明する為に簡単な例を挙げたもので、この例ではループが充分短い

（３２ワード以下）為、.align命令無しでもキャッシュは効果的に機能しています。

参考までに関数呼び出しの無い単純なループの場合のループを構成する命令のワード数（注２）と

キャッシュの機能との関係は次の通りとなります。

３２ワード以下：必ず機能します。

３２～６３ワード：上記方法で必ず機能します。それ以外では機能しない場合があります。

６４ワード以上：キャッシュはミスを繰り返し、効果を発揮しません。

（注１）ＴＭＳ３２０Ｃ３０にはキャッシュをフリーズする機能があるため、この２条件が絶対的な

ものではありません。しかし一般的なプログラムで特にキャッシュを意識せずに記述したプ

ログラムの場合には必要な条件です。

（注２）パイプラインによる命令の先取りも含めたワード数

92

Ｑ：Ｃ言語とアセンブラ言語の混在はできますか？

Ａ：ＴＩ社製のＣコンパイラでは次の２通りの混在が可能です。

① アセンブラによるソースファイルを作成し、リンカーで結合する。

② Ｃのソース上にインライン・アセンブラ命令でアセンブラソースを記述する。

インライン・アセンブラによる記述は小規模なアセンブラルーチンを記述するには大変重宝する方

法で、例えばＳＴレジスタのＧＩＥをアクティブにするほか、割込み制御レジスタを操作するなど

のちょっとした処理には有効です。

次の例はインライン・アセンブラを使用したマクロの例です。

#defineeint（） asm（” or02000h,st”）/*GIE enable */

#defineeint（） asm（” and 02000h,st”）/*GIE enable */

#definealign（） asm（” .align”）/* .ALIGN */

こういったマクロを用いれば殆どＣ言語の感覚でコーディングができます。

もう少し大きい規模のアセンブラルーチンを記述するには、Ｃで記述したある関数の中身をすっか

りアセンブラで記述します。Ｃコンパイラが生成したプログラムのレジスタの使い方が予測しづら

いなどの理由から、Ｃとアセンブラのステートメントを完全に混在させるのには限界があるからで

す。

次の例は、ＩＦレジスタをクリアすると供に、クリア直前の値を返す関数の例です。

getIFreg（）

｛

asm（” ldi if,r0”）；

asm（” ldi 0,if”）；

｝

Ｃのソースとは別にアセンブラソースを記述する方法はアセンブラステートメントの規模が大きい

場合に適当です。

Ｃのインライン・アセンブラはアセンブラより記述性が低く、大きなプログラムを記述するには適

しません。その場合には直接アセンブラソースファイルを記述します。Ｃプログラムの関数及び大

域変数と、アセンブラのサブルーチン及び大域変数とは、Ｃで記述した名称の先頭に ’_’ が付

いた名称がアセンブラの名称に対応する事を除けば、全く同じものとして取り扱えます。

関数呼び出しの場合には引数の受け渡し規則と、レジスタの保存に関する約束がありますのでそれ

に従ってサブルーチンを記述します。同様にＣの関数で保存されないレジスタをわきまえていれば

アセンブラからＣ関数の呼び出しもできます。

大域変数は ’_’ の有無だけ注意すればＣとアセンブラの間で同一の変数を参照できます。

注意点は ①アセンブラ側で定義した関数と大域変数には.global宣言を付加すること。

②変数領域はＣとアセンブラのどちらで定義するかを明確にすること。

です。Ｃで定義した場合にはアセンブラ側は.refで参照し、アセンブラで定義した場合にはＣ側は

externとなります。

リンクはＣとアセンブラのオブジェクトは全く区別なくリンクが可能です。

中部電機株式会社〒440-0004 愛知県豊橋市忠興３丁目２－８

TEL <0532>61-9566

FAX <0532>63-1081

URL : 0H1Hhttp://www.chubu-el.co.jp

E-mail : [email protected]

ADSP324-00A

ｿﾌﾄｳｪｱ・ﾕｰｻﾞｰｽﾞ・ﾏﾆｭｱﾙ

2004. 1 第5版発行

・本マニュアルの内容は製品の改良のため予告無しに

変更される事がありますので、ご了承下さい。

adspシリーズ adsp324－00a1 1 付属ソフトウェア概要...

Documents