![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
#author("2016-08-02T00:11:35+09:00","","") #author("2016-08-02T00:12:31+09:00","","") [[ツール]] * trax-host: 審判プログラム本体 [#e3d54054] 審判プログラムはシリアル / TCP でプレーヤと接続したり、 標準入力から棋譜を入力して、ターミナルに順次盤面を表示し、 勝敗判定などを行います。 標準入力から入力するには -R オプションとリダイレクトを使って、 % ./trax-host -R < tests/longest-60.trx % ./trax-host -R < tests/longest-60.trx | less -R のようにすることができます。 Forced play (連鎖ルール) が適用される分は棋譜には記録されませんが、 その場合にはこのプログラムにより自動的に適用されます。 盤面には、タイルが +, /, \ で表示され、 VT100 なエスケープシーケンスで色がつきます。 これはタイルの右辺に出る線の色です。慣れれば盤面がみえてきます。 また、ループやラインが成立した場合、 該当するタイルにはアンダーラインが引かれます。 ** 通信する [#b333dcff] プレーヤとの通信には Trax 通信[[プロトコル]]を使って 2つのクライアントに接続してゲームを進め、 経過を審判プログラムに渡します。先手後手の決定や、 制限時間などはこのプログラムが判断します。 クライアントとの通信方法にはシリアルポートと TCP があり、 両方のクライアントともシリアル、あるいは TCP でも接続できますし、 一方のクライアントにはシリアル、もう一方には TCP でそれぞれ接続接続するような混在環境もサポートしています。 また、シリアルポートのかわりに任意の pty デバイスも指定できますので、 [[socat>http://www.dest-unreach.org/socat/]] などと組み合わせてさまざまなインタフェイスで接続が可能です。 シリアルデバイスを使う場合には、たとえば、 % ./trax-host /dev/cuaU0 /dev/cuaU1 のようにデバイスを指定すれば、/dev/cuaU0, /dev/cuaU1 に接続され、先に指定した /dev/cuaU0 に接続されたクライアントが先手プレーヤーとなります。 シリアルポートの通信速度は 19200bps です。 また、 % ./trax-host 10000 10001 のようにポート番号を指定すれば TCP のポートを開けて接続待ちになり、 クライアントがこれに接続することでゲームが開始されます。この場合も、 先に指定した 10000 番ポートに接続したプレーヤーが ポート番号は 10000-10010 を使用してください。 デバイスやポート番号の指定を省略した場合、ソースコード中にある、 serial_devs[] に基づいて、シリアルデバイスの自動探索が行われます。 自動探索では、ここに列挙されたポートに対して Trax 通信[[プロトコル]]の -T コマンドが順次送信され、最初に応答があったものが先手、 次に応答があったものが後手となります。 一手あたりの持ち時間はデフォルトで 10 秒ですが、 これは -t オプションで変更できます (たとえば、-t 5 で5秒になります。) また、先手・後手を入れ替えるには "-r" オプションを使用します。 -l オプションを付けると、 連番のついたファイルに棋譜が保存されます。 また、棋譜の連番を記録しておくために "log-seq" というファイルがカレントディレクトリに生成されます。 ~-l オプションを付けると、 連番のついたファイルに棋譜が保存されます。 また、棋譜の連番を記録しておくために "log-seq" というファイルがカレントディレクトリに生成されます。 ** おまけ: 標準入出力を TCP に振り替える [#pc888e41] TCP で審判プログラムに接続するコードを書くのは、 それほど難しいことではありませんが、入出力が TCP になってしまうと、 デバッグの際になにかと面倒なので、やはり標準入出力を使いたい、 と思うこともあると思います。しかし、通常のパイプやリダイレクトでは、 これは困難です。このような場合に便利なのが、 [[socat>http://www.dest-unreach.org/socat/]] というツールです。 たとえば、 % socat TCP:localhost:10001 exec:"./my_trax",pty,ctty,echo=0 のようにすると、socat が ./my_trax を起動し、 その標準入出力を TCP 経由で localhost の 10001 番を listen している審判プログラムに接続してくれます。開発用にどうぞ。 ** 謝辞 [#t196fd5d] trax-host の通信部分は、 広島市立大の児島先生から寄贈されたコードを元にしています。
