1.Abstract(概要) This program supports a D-STAR DV adapter [a version of 7M3TJZ] using UT-118 so that a tranceiver [FT-817, FT-897] can be controlled together with the DV adapter among frequency, mode and shift frequency depending on your selection at the dialog window which is shown in the above sample. Download the object, related sample files and souce code: DV_monitor8_2007_12_31.lzh including all files. (社)日本アマチュア無線連盟(JARL)の主導で制定したD-STAR規格に適合した無線機は， ICOM社から販売されており，Kenwood社からも2007年7月には発売された。 JARLハムフェアー2007では，Yaesu FT817ndの附属装置としてICOM社デジタルユニットを外付けし， FT817をD-STAR規格に適合した無線機とする方法の一つを紹介した。この中心の技術的な試行は， 7M3TJZ（安田聖さん）が追求されているもので，ここでは， RLL版のDV附属装置の第1版向けの制御プログラムを主体に紹介する。この制御プログラムは，次の全体構成図の金物群を前提としている。 Hardware configuration expected

Advantages by this program[このプログラムを使うと，次のような利点がある。] Presection of repeaters by call area[呼出地域（又は単信）の指定によるレピータの事前絞込み] 地域指定によって，選択できるレピータ群を表示する。 Ease of selection from repeater list[交信相手のレピータ選択] 全日本のD-STARレピータから選択できる。 Selection of his callsign in histrical data[交信履歴から呼出符号選択] 受信履歴から呼出符号を選択し，呼び返しができる。 Automatic set radio equipment together with DV adapter[無線機の周波数，レピータ偏移周波数，モードの自動設定] DV附属装置の設定と同期して，無線機の送受信周波数，レピータ偏移周波数及び交信モードを自動設定できる。

2.User requirements(DV Adapterの利用者要件の設定) User requirement for this program are as follows[DV附属装置制御プログラムの利用者要件は，次のとおり設定した。] Hardware configuration expected(金物の構成) この制御プログラムは，上の全体構成図の金物群を前提して，computer(計算機)の対話型の応用プログラムとする。 Startup items(起動時設定) 次の情報は，前回使用したパラメタを記憶しておき，次回の起動時に自動設定する。 My callsign(自分呼出符号，QRA)：8文字（機器識別子：1文字を含む） Call area(呼出地域)：最大8文字この地域記号は，単なる番号によらず日本国の2文字による国識別JPを接頭語に付け，例えばJP1とし，外国（例：W2)を含んでも良い仕組みとする。この地域記号は，全レピータ表の記号と文字符号値が一致しなければならない。地域的なレピータに依らない場合の地域記号は，7文字の“Simplex”とする。地域記号がSimplexと一致すると，ＤＶ附属装置にDUPオフ信号を送り，My repeater及びHis repeaterを送らない。逆のSimplex状態以外を選択した後，STARTボタンを押すと，My repeaterとHis repeaterとから，レピータ情報をDV附加装置に送る。 Slash(斜線情報)：最大4文字（例：F817。無線機がFT-817であることを伝えたいとした場合の例。) DV port(DV附属装置を接続する装置番号(JARL登録記号)) Type of Tranceiver(トランシーバ型式)：（初期値：FT-817) TRXport:トランシーバを接続するCOM port番号1桁（初期値：8) My repeater:前回使用した自局レピータのパラメタ。 His repeater:前回使用した相手レピータ群。 My repeater(自分側レピータ設定) 自分側のレピータは，呼出地域(又はSimplex選択)によって，プルダウンメニュで表示され，それから選択( 二重クリックで反映）できる。もし，前回と同じ（My repeaterの最上行に表示）であれば，そのままでよい。 My repeaterは，DV附属装置と接続中に，他のレピータへ切り替えできる。 His repeater(相手側レピータ設定) 相手側のレピータは，CQ又はすべてのレピータ群から選択（二重クリックで変更反映）できる。 His repeaterは，DV附属装置と接続中に，他のレピータへ切り替えできる。 Tranceiver name(トランシーバ型式) FT-817, FT897,Noneから選択できる。 Tranceiver port number(トランシーバ接続口の番号) default=8 START(接続開始ボタン) 自分の希望のレピータ設定及び無線機設定ができたら，STARTボタンを押すと，DV附属装置及び無線機に制御信号群が送られ，STOPボタンに変わる。この状態で送信(PTT)ボタンを押すことによって電波が出る。更に，違う組み合わせに設定したい場合，STOPボタンを押し，選択変更し，STARTボタンを押す。 Repeaters list in Japan(全日本レピータ表) 全レピータ表は，呼出地域，名称（NDC略号），周波数，偏移，呼出符号，ゲートウエーの順とし，カンマ（タブ，行末符号）によって区切る。注釈は，斜線//を2文字前置した行とし，ファイルには注釈行が存在するが操作画面では表示しない。 Receiving and Call back button(受信データ及びCallbackボタン) 受信電文は，交信局の呼出符号，レピータの呼出符号，ゲートウエー局の呼出符号及び日時を表示する。表示できるメッセージ量は，稼動計算機資源のあるだけに任せる。枠からはみ出すと，上下スクロールバーが出現する。しかし，このプログラムを終了すると，履歴データを捨て，データ領域を開放する。受信画面の呼出符号をカーソルを当てて反転させた後，Callbackボタンを押すと，その呼出符号がDV附属装置に送られ，次のPTT操作によって， (JARLサーバを参照し）その局を探して接続する。受信履歴中に出現していない呼出符号は，Receivingにtypeinして反転させ，Callbackボタンを押してもよい。 Sending, TX_msg(送信メッセージ及び送信ボタン) 送信メッセージは，最大20文字とする。 Development System used(開発処理系) 開発処理系は，MS_Visual C++.net2003とする（手持ち品）。Object動作には，MFC71.DLLが必須。 Control method(動作形式) 対話画面からEvent driven(事象駆動形式)とする。 Communication parameters(通信パラメタ) COM番号は，10まで選択可能とし，DV adapterは通信速度：9600bps，8 bit，Non-parity，1 start bit，1 stop bitとする。DT(R),DS(R),RT(S)及びCT(S)はオンするが，信号相互の握手制御を省略する。トランシーバFT-817側は通信速度：9600bps，8 bit，Non-parity，1 start bit，2 stop bitとする。 Text format(文面ファイル形式) 取り扱うファイルは，すべて，文面(text)形式とし，簡単な文面編集系（例：メモ帳，Notepad)によって編集できる。

3.Implementation(プログラムの実装) Operation are shown here or see the help file[(操作)は，次のとおりとする]［Double click to be effect(二重クリックで変更)］。 Restoring of previous parameters(起動時の自動設定) Callsign and device indentifier(呼出符号及びJARL届け出の装置番号)（初期値例：7L1RLL D) Slash information(斜線情報)（初期値例：F817) Previous callarea or Simplex(前回終了時の呼出地域又はSimplex) Previous repeater(前回終了時の相手側レピータ) His repeaters list(相手側として選択できるレピータ群) 知り得た範囲で用意した全日本のD-STARレピータ群がHis repeaterというダウンメニューに設定される。 Callsign(呼出符号設定) My callsignに機器識別子を含めて設定する。設定が終わると，STARTボタンを押すとファイル：D-STAR_callsign.txtに記録される。 Call Area(呼出地域設定)(初期値例：JP1) Call Areaから電波を発射する地域(又はSimplex)を選択する。この選択によって，その地域のレピータ群がMy repeaterというダウンメニューに設定される。 Type of Tranceiver(無線機型式)(初期値例：FT-817) 接続するトランシーバの型式をFT-817,FT897又はNoneから選択する。 Port number for tranceiver(無線機接続口の番号)(初期値例：8) 無線機のCAT cableを接続するCOM番号を入力する。 Call back button(呼出符号指定呼び出しボタン) Receiving window の呼出符号を指定して（反転させて）からこのボタンを押すと，その後で無線機のPTTを押したとき，その呼出符号の局をサーバから探して接続を試みる。

4.Object Program(目的プログラム) The object program shown here shall be placed under a directry 'DV_monitor8' together with the following 6 sample files. The object program expect for running using MFC71.dll under Windows XP home edition(SP2) or Vista home basic. Visual C++のRUN Time DLL( MFC71.DLL )が実行計算機のWindows\system32にあれば，動作させられる目的プログラム及び動作環境設定ファイル見本を次に示す。なお，次のファイル群は，同一名のフォルダ（例：DV_monitor8)に入れると想定している。 DV adapter configulation file(DV附加装置のパラメタ記憶ファイル（見本） D-STAR_DV_config.txt(1Kb) Tranceiver configulation file(トランシーバのパラメタ記憶ファイル（見本） D-STAR_tranceiver_config.txt(1Kb) D-STAR_myRepeater selected(自局利用レピータ（見本) D-STAR_my_repeater.txt(1Kb) D-STAR_his_repeater selected(相手局利用レピータ（見本）) D-STAR_his_repeater.txt(1Kb) D-STAR_Repeaters List in Japan(全日本D-STARレピータ局収録，as of 2007/12/8) D-STAR_repeaters.txt(4Kb) D-STAR_DV_monitor8.exe(送受信の実装例。実行には，MFC71.DLLが必要) DV_monitor8.lzh, Version 2.12 updated December 3rd, 2007(圧縮した目的プログラム, 58Kb) この圧縮ファイルの元に戻す（伸張）すると，DV_monitor8.exe（116Kb)の実行プログラムが得られる。 DV adapter HELP file in English(DV附加装置のHELP） D-STAR_DV_HELP.txt(3Kb)

5.Source Code(原始プログラム） The source program shown here was developed under Visual Studio C++.net. The auther welcome to improving,modofying,transfering by the users with source code. The auther requests for users suggesions on this program. この原始プログラムの原型は，土井，那須，上田共著，“Win32 API 完璧マスタ”，CQ出版を基に， JR1BFJ福田さんが送受信部の原型を作成され，その上に筆者(7L1RLL)がDVアダプタ送信メッセージ組み立て部を上乗せした合作品である。 DV_monitor8.cpp(主プログラム, 31Kb, Version 2.12 updated December 5 2007) Visual Studio C++.netで表現した主プログラム DV_monitor8.cpp 。 EIA/ANSI232-E規格を使うため，20年ほど前の古典的なC言語の関数の使い方をした。利用者界面の操作によって駆動され，メッセージ伝達によって，メッセージを受けた動作部が発火する仕掛けにしてある。 DV_monitor8.h(頭部ファイル, 1Kb) 利用者対計算機間の界面の識別名の定義であって， DV_monitor8.h 主プログラムと資源ファイルとの結び付きの橋渡しをする。 DV_monitor8.rc(資源ファイル, 4Kb) 利用者界面の画面の操作要素の種類，寸法，識別名及び表示属性を資源（リソース) DV_monitor8.rc の定義。リストボックス(List box)，エディットボックス(Edit box)，ボタン（Button)などを使っている。 resource.h(資源ファイル, 1Kb) 利用者界面の画面の操作要素の種類，寸法，識別名及び表示属性を資源（リソース)のヘッダー resource.h の定義。このファイルは，DV_monitor8.rcから参照される。 resource.hm(資源ファイル, 1Kb) 利用者界面の画面の操作要素の種類，寸法，識別名及び表示属性を資源（リソース)のヘッダー resource.hm の定義。このファイルは，DV_monitor8.rcから参照される。

6.Progress(経緯） Demonstration of the Hardware at HAM fair 2007(金物の展示) August 25-26,2007, 東京ビッグサイトでDV附属装置の複製品を展示。ソフトウエアは，汎用のRS-232C試験道具を使った。 Issue outline of the specification(仕様概要，制御画面を公開) September 12, 2007,DV附属装置の制御プログラム案を提示。 Addition of sending control(送信制御の目的プログラムを公開) September 17, 2007,送信制御部の目的プログラムを公開。現在，受信処理部は実装・試験中（この時点では，未完成）。 Addition of receiving control(受信制御を含めた原始プログラムを公開) October 2, 2007, 送受信制御部を含めた原始プログラム及び目的プログラムを提示。 Addition of FT-817 control function(FT-817制御プログラム追加) October 31 2007, FT-817制御部分を追加した目的プログラム及び原始プログラムを提示した。 Addition of indicator TRX frequency and TRX shift frequency(周波数，シフト周波数表示) November 3 2007, TRX frequency及びTRX shiftの表示を追加した。ただし，それが有効になるのは，その次にSTARボタンを押して無線機に制御情報を渡してからである。 Comment out local time display(地域日時を一時的に削除) Local time display functionが表示の妨害をしているので，その解決まで目的プログラムから削除した。この処置は，原始プログラムでコメントアウトする。 Store myRepeaters and hisRepeater after EXIT(myRepeater及びhisRepeaterをファイル記録) November 9 2007,これらは，コメントアウトしたまま消して翻訳していることに気付いたので，利用者要件のとおり働かす。 Bug fix on store DV configulation(DV configの誤り修正) November 10 2007，配列の最大長が実値より小さい変数を発見し，最大長にして解決した。 Put delay time for transmitting to FT-817(FT-818への送信に時間遅延を挿入) November 16 2007，Tranceiver FT-817のシフト周波数，モード，シフト方向などの設定が不確実な原因は，まだ，前の制御命令を処理していないのに，次の命令文を送り出していたことにあった。そこで，コマンド送信の遅延時間を付与して，解決した。 Typographical Error correction on the source(DV_adapterのレピータ切り替え不能)(Resolved) November 17 2007，前版から突然DVのレピータ切り替え不能になった。その原因は，コマンドを一文字ミスタイプし，更に，s[i+1]をs[++]と間違っていた。これらを直して解決した。 Addition of Call back button(Call backボタン部のbug)(Resolved) November 17 2007，前版でボタンとcallback関数は書いていたが，変数名ID_BUTTON1がID_hisCallsignと誤っていたので修正して解決した。 Addition of changing logic in both My repeater and His repeater(自レピータ及び相手レピータの切り替え論理追加。Resolved 2007.11.19) 2007.11.19，Call backと同じように，これらの選択は，DV附加装置に接続した状態で切り替え可能とした。 Addition of Hiroshima 1200 repeater(広島1200(HS12)が欠落していたので追加。Resolved 2007.11.19) 2007.11.19，全日本のレピータ行脚をしていて，広島1200(HS12)がファイルD-STAR_repeaters.txtに欠落していることを発見し追記した。 Testing under Window Vista(Window Vista機で目的プログラム作動を確認。2007.11.21) 2007.11.21，MFC71.DLLの実装されているWindow Vista機で目的プログラムが立ち上がることを確認した。ただし，現時点ではＤＶ附属装置も無線機も接続試験をしていない。 Double entry of his repeater list after my repeater changed(My repeaterを変更するとHisRepeaterが二重に登録される。Resolved 2007.11.22) 2007.11.22，実害はないが，his repeater listに二重に登録される誤りを発見し，修正した。 Fill space when transfer message is less than 20 characters(20文字に満たない送信メッセージ部分を空白（space)で埋める。Resolved 2007.11.24) 2007.11.24，20文字以下の送信電文の末尾符号がNULLになっていたので，空白（space)に変更した。 Correction on Transfer data(送信メッセージが送られない。Resolved 2007.12.03) 2007.12.03，5文字に分割して送信されるように命令語を変更し，かつ，遅延時間を延長した。 Correction on Hisrepeaters(相手レピータ表が何回も書き込まれる。Resolved 2007.12.05) 2007.12.05，書き換え時に前の状態を確実に消していない誤りを発見し，Resolved。 Addition of repeaters in DFW,Texas(ダラスフォートワース地域のレピータを追加［参考］。 2007.12.05，Repeaters.txt更新し，参考までに米国テキサス州ダラス・フォートワース地域のレピータ群を加えた。ただし，日本国網から呼び出せるわけではない。 Addition of repeaters in Shibuya,Sakaiand Rename Inage(渋谷1200及び堺430追加並びに稲毛名称変更。 2007.12.10，Repeaters.txt更新し，渋谷1200及び堺430を追加し，美浜430を稲毛430と改名した。 Correction of code in my_callsign transmittion(自呼出符号の送出構文に誤りを発見，訂正。 2007.12.31，My callsignを変えても，DV adapterに送信しない誤りを訂正した。一応，目的プログラムは，Windows XP(SP2)及びWindow Vistaで稼動し，レピータを受信して，交信局，レピータ呼出符号を受信窓に表示する。しかし，受信履歴に日時を追加したい，操作上，もっと改良したい点，更に，すでに判明したバグがあるが，参考までに公開する。もし，何かの事情で，計算機が無限動作に入った場合，[Ctrl],[Alt]及び[Delete]キーを三つ同時に押して，Taskマネジャを呼出し，プログラムを停止させていただきたい。

7.Known bugs including some fixed items(判明している誤動作及び解決状態） NON STOP(Occasionally) 何かのtimingでDV_monitor8をSTOPできない。この場合，[Ctrl]+[Alt]+[Delete] keysを同時に押し， Task manegaerを呼び出して，DV_monitor8を停止させてください(調査中)。 No display time stamp(Local Time(日時）表示が他の受信表示を消去) Receiving窓で日時を表示させると，交信呼出符号を消してしまう。2007/11/3現在，とりあえず，日時表示を停止させた(調査中）。 2007/11/5，どうもこの現象は，DV附属装置からの9600bps（1ms/byte)に受信処理が間に合わない懸念が濃厚。受信バッファ付きで割り込み処理への移行を図らねば達成できないと思われる。 Too much space lines on receiving(受信表示の空行) 受信表示に空行が表示される（調査中）。 No effect on sending message(送信メッセージ不動作, Resolved) この機能は，DV_Adapter hardware（PIC program)との整合させないと働かない。 2007/12/03, 5文字に分割して送出し，かつ，間隔をあけて解決した。 No effect on control(DV adapter制御・無線機がかなり鈍感) かなりの頻度で，うまく，制御できていないことがある（Resolved。2007/11/16）。 2007.11.16, FT-817へのコマンド送信に遅延時間を入れて解決した。 Windows crash after Simplex Starting(Simplex開始でWindowsが落ちる) 2007.11.6発見。これは，致命傷です。他のtaskまで不意な中断を余儀なくさせられます。電源を落として,電源を入れ直しです（調査中）。 Store value for D-STAR_DV_config.txt(D-STAR_DV_configのmyCallAreaの値の不良，Resolved) Simplex操作の後，file“D-STAR_DV_config.txt”中，myCallAreaの値がSimpNoneと保存される(Resolved on 2007/11/10)。 Store value for DV_my_rpt.txt and DV_his_rpt.txt(DV_my_rpt.txt及びDV_his_rpt.txtが更新されない。Resolved) 2007.11.9発見，EXIT操作の後にコード挿入した(Resolved on 2007/11/9)。 Call back button not work(Call backボタンを新設したが，意図したように動かない。 Resolved 2007.11.17) 2007.11.16，画面と原始プログラムにCall back ボタンを追加したが，まだ，動いていない。 2007.11.17, Debug and Resolved(解決)。 Double entry of his repeater list(His repeaterが二重に登録される。 Resolved 2007.12.05) 2007.11.22, Debug and Resolved(my repeaterを変更された場合，his repeaterの従来の並びを削除する手順を追加して，解決)。 2007.12.05, Debug and Resolved again(Bug発見し，訂正した。解決)。

8.Remarks(備考) A)Editorial error on Yaesu FT-817 Manual in Japanese version(FT-817ndマニュアルの誤記) 開発・試験の途中で，FT-817のレピータ偏移周波数のコマンドがYaesu FT-817ndのマニュアル(p72,p73) に記載された状態では，-5MHzを与えると-50MHzになる記載誤りを発見した。誤：例）5.00MHzの場合，P1=05，P2=00，P3=00，P4=00 正：例）5.00MHzの場合，P1=00，P2=50，P3=00，P4=00 この原始プログラムは，この位取りを訂正しておいた。なお，バーテックスタンダード社には，マニュアルが誤りか，実機が不良なのかを問い合わせ中です（2007/11/1)。 Nov.1 2007, バーテックスタンダード社から，早速，マニュアルの誤記があったとのメールでの回答を得た。 B)Presentation at 2nd Symposium of Japan Personal Computer Users Technology Society(JPCATS) (第2回日本パーソナルコンピュータユーザ利用技術学会全国大会で発表） 2007年12月2日(日)，千葉商科大学を借りて行われる JPCATS の全国大会での発表論文（予稿）を提出した（2007/11/8）。 C)Research Award received(研究奨励賞受賞) 2008年6月14日，このプログラムをパーソナルコンピュータ利用技術学会の第２回全国大会（2007.12.2)で発表したところ，研究奨励賞の賞状が届いた。