K5 VSSP VLBI System

IP-VLBI (K5/VSSP) 観測ソフトウェア群

最近の更新履歴
2016-08-08 VDIFデータ関係プログラムの公開開始 2016-07-21 k5tom5bのバグ（0hUTCをまたぐスキャンの時刻が異常になる）を改修した。すでに異常となっているMark5Bファイルを修正するソフト"m5b_recov"の提供を開始 2015-12-21 サンプリングデータの時系列ダイナミック表示ユーティリティ"oscillo"とスペクトルのダイナミック表示ユーティリティ"speana_n"の公開開始 2015-10-28 Ubuntu14.04(64bit)で動作確認したドライバーの公開開始 2014-02-07 バージョンを合わせるためのアーカイブ

最近の更新履歴

2016-08-08
VDIFデータ関係プログラムの公開開始
2016-07-21
k5tom5bのバグ（0hUTCをまたぐスキャンの時刻が異常になる）を改修した。すでに異常となっているMark5Bファイルを修正するソフト"m5b_recov"の提供を開始
2015-12-21
サンプリングデータの時系列ダイナミック表示ユーティリティ"oscillo"とスペクトルのダイナミック表示ユーティリティ"speana_n"の公開開始
2015-10-28
Ubuntu14.04(64bit)で動作確認したドライバーの公開開始
2014-02-07
バージョンを合わせるためのアーカイブ

動作条件

K5/VSSP（旧IP-VLBI)サンプラーボードおよびK5/VSSP32サンプラーユニットの推奨環境および動作が確認された環境は以下の通りです。

K5/VSSPサンプラーボード

環境	備考
FreeBSD 4.0-RELEASE i386 プラットフォーム	推奨環境
Debian GNU/Linux 3.1 (kernel 2.6.8-2-386) i386 プラットフォーム

K5/VSSP32サンプラーユニット

環境備考
Debian GNU/Linux 3.1 (kernel 2.6.8-2-386) i386 プラットフォームオリジナルドライバーの動作環境
Debian GNU/Linux 4.1 (kernel 2.6.18-4-686) i386 プラットフォームただしFedraCore用のドライバアーカイブ vlbi-usb-linux-FC-20070411.tar.gz および以降を使用すること※
Debian GNU/Linux 5.0 (kernel 2.6.26-1-686) vlbi-usb-linux-1.18.tar.gz を使用
CentOS GNU/Linux (kernel 2.6.9-42.ELsmp) i386 プラットフォーム K5ソフト群のVersion 2007-04-11以降使用のこと
CentOS 5 GNU/Linux (kernel 2.6.18-53.el5) i386 プラットフォーム K5ソフト群のVersion 2007-04-11以降使用のこと
更にFedraCore用のドライバアーカイブ vlbi-usb-linux-FC-20070411.tar.gz および以降を使用すること※

CentOS 5 GNU/Linux (kernel 2.6.18-164.el5) i386 プラットフォーム vlbi-usb-linux-1.18.tar.gz を使用
Fedora Core GNU/Linux (kernel 2.6.18-1.2798.fc6) i386 プラットフォーム K5ソフト群のVersion 2007-04-11以降使用のこと
更にFedraCore用のドライバアーカイブ vlbi-usb-linux-FC-20070411.tar.gz および以降を使用すること※

Fedora14 GNU/Linux (kernel 2.6.35.10-74.fc14.i686) vlbi-usb-linux-01TK.tar.gz を使用

Ubuntu10.10 GNU/Linux (kernel 2.6.35-22-generic) i686 vlbi-usb-linux-2011-01TK.tar.gz を使用

Ubuntu11.04 GNU/Linux (kernel 2.6.38-8-generic) i686 vlbi-usb-linux-2011-10TK.tar.gz を使用

Ubuntu12.04 GNU/Linux (kernel 3.2.0-86-generic) i686 vlbi-usb-linux-2011-10TK.tar.gz を使用

Ubuntu14.04(64bit) GNU/Linux (kernel 3.13.0-66-generic) x86_64 vlbi-usb-linux64-2011-10TK.tar.gz を使用

環境	備考
Debian GNU/Linux 3.1 (kernel 2.6.8-2-386) i386 プラットフォーム	オリジナルドライバーの動作環境
Debian GNU/Linux 4.1 (kernel 2.6.18-4-686) i386 プラットフォーム	ただしFedraCore用のドライバアーカイブ vlbi-usb-linux-FC-20070411.tar.gz および以降を使用すること※
Debian GNU/Linux 5.0 (kernel 2.6.26-1-686)	vlbi-usb-linux-1.18.tar.gz を使用
CentOS GNU/Linux (kernel 2.6.9-42.ELsmp) i386 プラットフォーム	K5ソフト群のVersion 2007-04-11以降使用のこと
CentOS 5 GNU/Linux (kernel 2.6.18-53.el5) i386 プラットフォーム	K5ソフト群のVersion 2007-04-11以降使用のこと更にFedraCore用のドライバアーカイブ vlbi-usb-linux-FC-20070411.tar.gz および以降を使用すること※
CentOS 5 GNU/Linux (kernel 2.6.18-164.el5) i386 プラットフォーム	vlbi-usb-linux-1.18.tar.gz を使用
Fedora Core GNU/Linux (kernel 2.6.18-1.2798.fc6) i386 プラットフォーム	K5ソフト群のVersion 2007-04-11以降使用のこと更にFedraCore用のドライバアーカイブ vlbi-usb-linux-FC-20070411.tar.gz および以降を使用すること※
Fedora14 GNU/Linux (kernel 2.6.35.10-74.fc14.i686)	vlbi-usb-linux-01TK.tar.gz を使用
Ubuntu10.10 GNU/Linux (kernel 2.6.35-22-generic) i686	vlbi-usb-linux-2011-01TK.tar.gz を使用
Ubuntu11.04 GNU/Linux (kernel 2.6.38-8-generic) i686	vlbi-usb-linux-2011-10TK.tar.gz を使用
Ubuntu12.04 GNU/Linux (kernel 3.2.0-86-generic) i686	vlbi-usb-linux-2011-10TK.tar.gz を使用
Ubuntu14.04(64bit) GNU/Linux (kernel 3.13.0-66-generic) x86_64	vlbi-usb-linux64-2011-10TK.tar.gz を使用

※コンパイル時に以下の警告が出るが、VSSP32は正常に機能しました。

                WARNING: modpost: GPL-incompatible module utds.ko uses future GPL-only symbol 'usb_register_driver'
                WARNING: modpost: GPL-incompatible module utds.ko uses future GPL-only symbol 'usb_deregister'

注意：gcc 4で生じるドライバーmake時のエラーについて(2007/5/16)

VSSP32用ドライバをmakeするときにgccのバージョンが4の場合、

                include/asm/processor.h:87: error: array type has incomplete element type

というエラーが出て、make出来無い場合はカーネルとgccのバージョンが合ってないことが原因と考えられます。その時はgccのバージョンを３に落としてください。

ソフトウェア一覧

Ｋ５観測ソフトウェア群（Version 2015-12-22）

サンプラー依存ソフト（K5/VSSPまたはK5/VSSP32用に別々にコンパイルする必要有り）

signalcheck ボードに10MHzおよび1PPSが供給されているかどうかのチェックプログラム
timesettk ボードの時刻のセット（ログ機能を追加）
timeadjust K5/VSSP(K5/VSSP32)の時刻を秒単位（進み遅れ）でセットする（ログ出力あり）
timedisp ボードの時刻表示
timesync ボードの１ＰＰＳ同期および時刻表示（ログ機能を追加）
sampling 手動によるデータ収集
sampling2 手動によるデータ収集(高機能版：１秒ファイル生成モードではシンクパターンのチェックあり)
autoobs 自動データ収集。ログ出力機能と複数ハードディスクサポート。「NOZOMI」観測モードサポート。サブネット観測対応。
monit K5/VSSP(IP-VLBI)ボードおよびK5/VSSP32の入力信号レベルのモニター。時刻表示有り
monit2 主にK5/VSSP32のエラー回数モニター
setdcoffset K5/VSSP32ボードのDCオフセットのセット（ログ出力あり）
pctimeset ＰＣの時刻をK5/VSSP(K5/VSSP32)ボードの時刻に合わせる（ログ出力あり）
timesetpc K5/VSSP(K5/VSSP32)の時刻をＰＣの時刻に合わせる（ボードテスト用、ログ出力あり）
timecheck K5/VSSP32の時刻表示の誤動作チェック（ログ出力あり）

signalcheck	ボードに10MHzおよび1PPSが供給されているかどうかのチェックプログラム
timesettk	ボードの時刻のセット（ログ機能を追加）
timeadjust	K5/VSSP(K5/VSSP32)の時刻を秒単位（進み遅れ）でセットする（ログ出力あり）
timedisp	ボードの時刻表示
timesync	ボードの１ＰＰＳ同期および時刻表示（ログ機能を追加）
sampling	手動によるデータ収集
sampling2	手動によるデータ収集(高機能版：１秒ファイル生成モードではシンクパターンのチェックあり)
autoobs	自動データ収集。ログ出力機能と複数ハードディスクサポート。「NOZOMI」観測モードサポート。サブネット観測対応。
monit	K5/VSSP(IP-VLBI)ボードおよびK5/VSSP32の入力信号レベルのモニター。時刻表示有り
monit2	主にK5/VSSP32のエラー回数モニター
setdcoffset	K5/VSSP32ボードのDCオフセットのセット（ログ出力あり）
pctimeset	ＰＣの時刻をK5/VSSP(K5/VSSP32)ボードの時刻に合わせる（ログ出力あり）
timesetpc	K5/VSSP(K5/VSSP32)の時刻をＰＣの時刻に合わせる（ボードテスト用、ログ出力あり）
timecheck	K5/VSSP32の時刻表示の誤動作チェック（ログ出力あり）

サンプラー不要のソフト

datachk データチェック（ヘッダー部を頼りにヘッダー間のデータビット数をカウント）。オプションでサンプリング統計表示機能
oscillo サンプリングデータの時系列ダイナミック表示 (PGPLOTでコンパイル時のみ有効）NEW
speana オフラインスペクトル表示（speana2の機能実装済み）
speana_n オフラインスペクトルのダイナミック表示 (PGPLOTでコンパイル時のみ有効）NEW
speana2 オフラインスペクトル表示(高機能版）
skdchk スケジュールファイルのチェック
extdata サンプリングデータファイルから特定のｃｈのデータを抽出しテキストファイルに書き出す
four2one ４chモードで収集したデータから任意のチャンネルのデータを切り出し、１chモードのデータに変換する
datacut サンプリングデータファイルからある時間範囲のデータを抜き出す
datatime_edit サンプリングデータファイルの時刻を修正（変更）する
adbitconv サンプリングデータファイルのADビット数を任意のADビット数（ただし、1,2,4,8）に変換する
one2four ４台のＩＰ－ＶＬＢＩボードから１ｃｈモードで取得したデータファイル４つを結合し、 4ｃｈモードのデータファイルを作成する
data_half サンプリングデータを間引きすることにより見かけのサンプリング周波数を半分にする
data_double サンプリングデータを繰り返すことにより見かけのサンプリング周波数を倍にする
k5v32tok5 K5/VSSP32フォーマットデータをK5/VSSPフォーマットに変換する
k5tok5v32 K5/VSSPフォーマットデータをK5/VSSP32フォーマットに変換する
data_recov K5/VSSPおよびK5/VSSP32データヘッダー部の修復を行う
vssplogana sampling（autoobsも可）のログファイルおよびdatachkのサマリー出力ファイルを解析し、発生エラー状況の統計結果を表示する
aux_recov K5/VSSP32データでデータチェック時にAUX MISALIGN (misaligned AUX field)と表示されるデータの修復を行う
pcalcheck K5/VSSPおよびVSSP32データファイル中のPCAL位相と強度をグラフ表示する

datachk	データチェック（ヘッダー部を頼りにヘッダー間のデータビット数をカウント）。オプションでサンプリング統計表示機能
oscillo	サンプリングデータの時系列ダイナミック表示 (PGPLOTでコンパイル時のみ有効）NEW
speana	オフラインスペクトル表示（speana2の機能実装済み）
speana_n	オフラインスペクトルのダイナミック表示 (PGPLOTでコンパイル時のみ有効）NEW
speana2	オフラインスペクトル表示(高機能版）
skdchk	スケジュールファイルのチェック
extdata	サンプリングデータファイルから特定のｃｈのデータを抽出しテキストファイルに書き出す
four2one	４chモードで収集したデータから任意のチャンネルのデータを切り出し、１chモードのデータに変換する
datacut	サンプリングデータファイルからある時間範囲のデータを抜き出す
datatime_edit	サンプリングデータファイルの時刻を修正（変更）する
adbitconv	サンプリングデータファイルのADビット数を任意のADビット数（ただし、1,2,4,8）に変換する
one2four	４台のＩＰ－ＶＬＢＩボードから１ｃｈモードで取得したデータファイル４つを結合し、 4ｃｈモードのデータファイルを作成する
data_half	サンプリングデータを間引きすることにより見かけのサンプリング周波数を半分にする
data_double	サンプリングデータを繰り返すことにより見かけのサンプリング周波数を倍にする
k5v32tok5	K5/VSSP32フォーマットデータをK5/VSSPフォーマットに変換する
k5tok5v32	K5/VSSPフォーマットデータをK5/VSSP32フォーマットに変換する
data_recov	K5/VSSPおよびK5/VSSP32データヘッダー部の修復を行う
vssplogana	sampling（autoobsも可）のログファイルおよびdatachkのサマリー出力ファイルを解析し、発生エラー状況の統計結果を表示する
aux_recov	K5/VSSP32データでデータチェック時にAUX MISALIGN (misaligned AUX field)と表示されるデータの修復を行う
pcalcheck	K5/VSSPおよびVSSP32データファイル中のPCAL位相と強度をグラフ表示する

ボードテスト用シェルスクリプト（観測ソフト群のアーカイブに含まれています） Version 2007-03-02

vssp32test.sh K5/VSSP32ユニットのサンプリング周波数を変えての自動テスト
vssp32test2.sh K5/VSSP32ユニットのサンプリングパラメータを固定して、繰り返しの耐久テスト
vssp32test3.sh K5/VSSP32ユニットのサンプリング周波数を変えての自動テスト。下限周波数の設定可

vssp32test.sh	K5/VSSP32ユニットのサンプリング周波数を変えての自動テスト
vssp32test2.sh	K5/VSSP32ユニットのサンプリングパラメータを固定して、繰り返しの耐久テスト
vssp32test3.sh	K5/VSSP32ユニットのサンプリング周波数を変えての自動テスト。下限周波数の設定可

K5/VSSP <-> Mark5フォーマット変換ソフト群（Version 2016-07-21）

k5tom5 K5からMark5への変換(K5/VSSP32フォーマットもサポート）
k5tom5b K5からMark5Bへの変換(K5/VSSP32フォーマットもサポート）UPDATED
m5check Mark5のファイル形式チェック（8|16|32|64トラックモードの自動判定）およびシンクブロックチェックなしでのヘッダー部表示
m5time Mark5データの時刻表示
m5btime Mark5Bデータの時刻表示
m5tok5 Mark5からK5への変換（Mark5全モード対応高速版：K5/VSSP32への変換は未対応）
m5btok5 Mark5BからK5への変換
m5vex_ana ＶＥＸファイルの解析を行う
m5b_recov k5tom5bのVer.2016-07-20以前で変換したMark5Bファイルの不具合（0hUTCをまたぐスキャンで発生）の修正を行なうNEW

k5tom5	K5からMark5への変換(K5/VSSP32フォーマットもサポート）
k5tom5b	K5からMark5Bへの変換(K5/VSSP32フォーマットもサポート）UPDATED
m5check	Mark5のファイル形式チェック（8\|16\|32\|64トラックモードの自動判定）およびシンクブロックチェックなしでのヘッダー部表示
m5time	Mark5データの時刻表示
m5btime	Mark5Bデータの時刻表示
m5tok5	Mark5からK5への変換（Mark5全モード対応高速版：K5/VSSP32への変換は未対応）
m5btok5	Mark5BからK5への変換
m5vex_ana	ＶＥＸファイルの解析を行う
m5b_recov	k5tom5bのVer.2016-07-20以前で変換したMark5Bファイルの不具合（0hUTCをまたぐスキャンで発生）の修正を行なうNEW

ADS3000+(DBBCモード) <-> K5/VSSPフォーマット変換ソフト群（Version 2010-06-21）

ads2k5 ADS3000+のDBBCモードデータからVSSP32またはVSSPフォーマットへの変換

ads2k5	ADS3000+のDBBCモードデータからVSSP32またはVSSPフォーマットへの変換

VDIFフォーマット <-> K5フォーマット変換ソフト群（Version 2016-08-08）

vdif2k5 VDIFからK5/VSSP32フォーマットへの変換を行う NEW
vdifcheck VDIFのファイル形式をチェックする NEW
speana_vdif VDIFデータのスペクトル表示 NEW
k5tovdif K5からVDIFへのフォーマット変換を行う NEW

vdif2k5	VDIFからK5/VSSP32フォーマットへの変換を行う NEW
vdifcheck	VDIFのファイル形式をチェックする NEW
speana_vdif	VDIFデータのスペクトル表示 NEW
k5tovdif	K5からVDIFへのフォーマット変換を行う NEW

K5/VSSP観測ソフトウェア群の詳細はここをご覧下さい。
K5/VSSP観測時に発生するエラーコードの詳細はここをご覧下さい。
ボードテスト用シェルスクリプトの詳細はここをご覧下さい。
K5/VSSP <-> Mark5フォーマット変換ソフト群の詳細はここおよびここをご覧下さい。
ADS3000+(DBBCモード) <-> K5/VSSPフォーマット変換ソフトの詳細はここおよびここをご覧下さい。

サンプラーボードおよびユニットの問題点と対処法

K5/VSSPに生じている問題点と対処法(2007/03/29版)

K5/VSSP32に残っている問題点と対処法(2008/1/24版)

IP-VLBI (K5/VSSP) 観測ソフトウェア群のインストール

一つのソースファイルでFreeBSD、linux、一部サンプラーボードを使用しないユーティリティについては WIN32のすべてに対応しています。
具体的には

   #ifdef WIN32
    printf("This is Windows \n");
   #elif defined(__FreeBSD__)
    printf("This is FreeBSD \n");
   #elif defined(linux)
    printf("This is linux \n");
   #endif

の原理を使っています。

Ｋ５観測ソフトウェア群のインストール法

すでにサンプラーのドライバーは別途インストールされているものとします

1. 適当なディレクトリにipvlbi_obs20160808.tar.gz （IP-VLBI(K5/VSSP)ユーティリティVer.2016-08-03) を置く
2. tar xvzf ipvlbi_obsXXXXXXXX.tar.gz
で解凍する
3. cd ipvlbiXXXXXXXX
で作業ディレクトリを移動する（Ver.2005-06-17およびそれ以前は解凍したディレクトリにとどまる）
4. 【この項大幅更新】
注：Ver.2010-02-07より前のアーカイブの場合は、インストールのデフォルトがK5/VSSPとなっていますので、 K5/VSSP32をインストールする場合は、install_obs.shの代わりにinstall_obs_vssp32.shを使用してください。
Ver.2010-02-07以降のアーカイブを使ってK5/VSSPをインストールする場合はinstall_obs.shの代わりに install_obs_vssp.shを使用してください。
Ver.2010-02-07以降のアーカイブを使ってK5/VSSP32システムをインストールするには、 install_obs.sh を実行してください。ここで従来(Ver.2007-10-30以前）のようにsourceコマンドは使用しないでinstall_obs.shを直接実行してください。実行権が適切にセットされていない場合はセットしてください。
グラフィック表示はデフォルトではPGPLOTですが、GNUPLOTを使用したい場合はそれぞれのシェルスクリプト実行時にオプションG=GNUPLOTをつけて実行してください。VSSP32の場合は　install_obs.sh G=GNUPLOT のようになります。
FreeBSDシステムでは

/usr/lib/libg2c.so: warning: tempnam() possibly used unsafely; consider using mkstemp()

という警告メッセージが出ますが、これはインストールされているPGPLOTパッケージ中の関数に関する警告ですので無視してください。
linuxシステムにてコンパイル時に警告メッセージが多く出る場合は、 install_obs.64.shをお使い下さい。（install_obs.64.shはファイルオープンにfopen64を使用したコンパイルを行います）
5. 【環境の設定を行う】
インストールしたソフト群のディレクトリが例えば$HOME/K5/ipvlbiXXXXXXXXである場合
シンボリックリンクで

ln -s $HOME/K5/ipvlbiXXXXXXXX $HOME/ipvlbi

すでにリンクがある場合新しく貼り直す場合は"f"オプションをつけて、

ln -sf $HOME/K5/ipvlbiXXXXXXXX $HOME/ipvlbi

でリンクを作成し、.bashrcなどのリソースファイル中で

export PATH=$PATH:$HOME/ipvlbi/bin (.bashrcの場合） setenv PATH $PATH:$HOME/ipvlbi/bin (.cshrcの場合）

を記述しておけば、K5ソフト群のバージョンアップを行った際もシンボリックリンクを張り直すだけで良くなる。
Ver.2010-02-08以降のアーカイブではmanページファイルも含まれているので、.bashrcなどに

export MANPATH=$HOME/ipvlbi/man:$MANPATH (.bashrcの場合） setenv MANPATH $HOME/ipvlbi/man:$MANPATH (.cshrcの場合）

を記述しておけば、manコマンド(例えば"man autoobs"等)でK5ソフト群の使用方法を得ることができる。なお、"man k5util"を実行することにより、K5ソフト群全体の説明を得ることができる。

ユーティリティの詳細は取り説をご覧下さい。

クリーンインストール（昔のディレクトリの中身を削除後のインストール）を行うには解凍後、clean_install_obs.sh XXXXXXXX を実行してください。ここで　XXXXXXXXは　アーカイブファイル名 ipvlbi_obsXXXXXXXX.tar.gz の XXXXXXXX 部分です。通常は４桁年２桁月２桁日のアーカイブ日付です。

linuxでmakeする際、サンプラーのincludeファイルsys/tdsio.h が見つからないというエラーが出る場合は tdsio.h が /usr/include/sys の下にない場合かと思いますので、どこかにあるであろうtdsio.hを/usr/include/sys の下に置いてください。ＮＩＣＴでテストしているＰＣでは/usr/include/linuxの下にあります。
==>Ver.2005-09-28以降のバージョンではこの問題は解決されています

PGPLOTのインストールをするにはここをご覧下さい。
GNUPLOTは大抵の場合予めインストールされていると思いますが、インストールされていない場合は適宜インストールを行い（GNUPLOTのインストール法はここでは触れません）、 gnuplotコマンドにパスを通して下さい。

K5/VSSP <--> Mark5フォーマット変換ソフト群および
ADS300+(DBBCモード) <-> K5/VSSP変換ソフトの
インストール法

適当なディレクトリにipvlbi_m5k20160808.tar.gz （K5・Mark5・ADS3000+ フォーマット変換ユーティリティVer.2016-08-08) を置く

tar xvzf ipvlbi_m5kXXXXXXXX.tar.gz
で解凍する

cd ipvlbiXXXXXXXX
で作業ディレクトリを移動し、install_m5k.sh を実行する。

FreeBSDシステムでは

/usr/lib/libg2c.so: warning: tempnam() possibly used unsafely; consider using mkstemp()

という警告メッセージが出ますが、これはインストールされているPGPLOTパッケージ中の関数に関する警告ですので無視してください。

VDIF <--> K5/VSSPフォーマット変換ソフト群のインストール法

1.	適当なディレクトリにipvlbi_vdif20160808.tar.gz （K5・VDIF フォーマット変換ユーティリティVer.2016-08-08) を置く
2.	tar xvzf ipvlbi_vdifXXXXXXXX.tar.gz で解凍する
3.	cd ipvlbiXXXXXXXX で作業ディレクトリを移動し、install_vdif.sh を実行する。

K5/VSSP（旧IP-VLBIボード)とK5/VSSP32の同時インストール

K5/VSSP32をインストールしているＰＣにK5/VSSPの観測ソフトをインストールすることが出来ます。以下に手順を載せます。（注：Ver. 2007-10-30以前と手順が若干異なっています）

K5/VSSPを常用とする場合

1.	両方のドライバ(K5/VSSP用はlinux2.6用ドライバを使用する）をインストールする
2.	cd ipvlbiXXXXXXXX/src で作業ディレクトリを移動
3.	make S=VSSP32 で観測ソフト群をK5/VSSP32用にコンパイルする　（FreeBSDの場合は　make -f BSDmakefile S=VSSP32）
4.	make install S=VSSP32 （FreeBSDの場合は　make -f BSDmakefile install S=VSSP32）を実行する
5.	4.の作業の結果として　ipvlbiXXXXXXXX/bin32 以下にK5/VSSP32用の観測ソフト（実行プログラム）群が収納される
6.	ipvlbiXXXXXXXX/src ディレクトリで今度は　make clean (FreeBSDの場合は make -f BSDmakefile clean）を実行する
7.	更に make S=VSSP を実行する（FreeBSDの場合は　make -f BSDmakefile）。この作業により観測ソフト群がK5/VSSP（旧IP-VLBIボード）用にコンパイルされる
8.	make install S=VSSP（FreeBSDの場合は　make -f BSDmakefile install）を実行する
9.	8.の作業で ipvlbiXXXXXXXX/bin 以下にK5/VSSP用の観測ソフト（実行プログラム）群と両方(VSSPおよびVSSP32）に共通に使用できるプログラム群が収納される。またipvlbiXXXXXXXX/bin_vssp以下にもK5/VSSP用の実行プログラムが収納される

K5/VSSP32を常用とする場合

上記の手順で先にK5/VSSP用ソフト群をインストールし、後でK5/VSSP32用ソフト群をインストールする。具体的な手順は以下の通り

1.	両方のドライバ(K5/VSSP用はlinux2.6用ドライバを使用する）をインストールする
2.	cd ipvlbiXXXXXXXX/src で作業ディレクトリを移動
3.	make S=VSSP で観測ソフト群をK5/VSSP用にコンパイルする　（FreeBSDの場合は　make -f BSDmakefile）
4.	make install S=VSSP（FreeBSDの場合は　make -f BSDmakefile install）を実行する
5.	4.の作業の結果として　ipvlbiXXXXXXXX/bin_vssp 以下にK5/VSSP用の観測ソフト（実行プログラム）群が収納される
6.	ipvlbiXXXXXXXX/src ディレクトリで今度は　make clean (FreeBSDの場合は make -f BSDmakefile clean）を実行する
7.	更にmake S=VSSP32 で観測ソフト群をK5/VSSP32用にコンパイルする　（FreeBSDの場合は　make -f BSDmakefile S=VSSP32）
8.	make install S=VSSP32 （FreeBSDの場合は　make -f BSDmakefile install S=VSSP32）を実行する
9.	9.の作業で ipvlbiXXXXXXXX/bin 以下にK5/VSSP32用の観測ソフト（実行プログラム）群と両方(VSSPおよびVSSP32）に共通に使用できるプログラム群が収納される。またipvlbiXXXXXXXX/bin32以下にもK5/VSSP32用の実行プログラムが収納される。

上記の手順でipvlbiXXXXXXXX/bin 以下には最後にコンパイルした観測ソフト（実行プログラム）群と両方(VSSPおよびVSSP32）に共通に使用できるプログラム群が収納され、ipvlbiXXXXXXXX/bin_vssp 以下にK5/VSSP用の観測ソフト（実行プログラム）群、 ipvlbiXXXXXXXX/bin32 以下にK5/VSSP32用の観測ソフト（実行プログラム）群が収納される。従って、例えばsignalcheckをK5/VSSP32ユニットに対して実行するときは

   ipvlbiXXXXXXXX/bin32/signalcheck

K5/VSSPボードに対して実行するときは

   ipvlbiXXXXXXXX/bin_vssp/signalcheck

のようにする。
なお、ipvlbiXXXXXXXX/bin以下には最後にコンパイルしたボードに対する実行プログラムが収納される。

ダウンロード

最新および古いバージョンのIP-VLBIボードドライバーのダウンロード

K5/VSSP32用ドライバー
- ドライバーアーカイブ（vlbi-usb-linux64-2011-10TK.tar.gz)
  ==== linux kernel 2.6.38 以上用ドライバ（2011.10.14公開開始）（Ubuntu12.04での動作確認）======
- ドライバーアーカイブ（vlbi-usb-linux-2011-10TK.tar.gz)
  ==== linux kernel 2.6.35 用ドライバ（2011.01.06版）（Fedra10, Ubuntu10.10での動作確認）======
- ドライバーアーカイブ（vlbi-usb-linux-2011-01TK.tar.gz)
  ==== Debian GNU/Linux5.0用ドライバ（2010.1.24公開開始：日通機提供）（CentOSでも動作確認）======
- ドライバーマニュアル（7680B_DrvManual_Ver119.pdf）
- ドライバーアーカイブ（vlbi-usb-linux-1.18.tar.gz)
  ==== Debian GNU/Linux3.1用ドライバ（日通機提供）（CentOSでも動作確認）======
- ドライバーマニュアル（debian_driver_manual.pdf）
- ドライバーアーカイブ（vlbi-usb-linux-20070823.tar.gz)（ビットシフト他サポート）
- ドライバーアーカイブ（vlbi-usb-linux-20070302.tar.gz)
  ==== FedraCore用ドライバ（および Debian GNU/Linux4.1) ======
- ドライバーアーカイブ（vlbi-usb-linux-FC-20070823.tar.gz)（ビットシフト他サポート）
- ドライバーアーカイブ（vlbi-usb-linux-FC-20070411.tar.gz)
注１．VSSP32用ドライバをmakeするときにgccのバージョンが4の場合、
```
      include/asm/processor.h:87: error: array type has incomplete element type
```
というエラーが出て、make出来ない場合は、カーネルとgccのバージョンがあっていませんので、gccのバージョンを３に落としてください。
注２．再起動後にドライバーがロードされないとき（VSSP32へのアクセスがエラーとなるとき）は /etc/rc.local に以下の３行を追加して再起動して下さい。
```
      KERNVER=`uname -r`
      /sbin/insmod /lib/modules/$KERNVER/kernel/drivers/usb/misc/utds.ko
      chmod 666 /dev/utds0
```
/dev/utds0のモードが666に上手くセットされない場合は、上記chmod 666 /dev/utds0の前に sleep 1; を入れてみてください。
```
      KERNVER=`uname -r`
      /sbin/insmod /lib/modules/$KERNVER/kernel/drivers/usb/misc/utds.ko
      sleep 1;
      chmod 666 /dev/utds0
```
注３．ドライバーのインストールには事前にカーネルのヘッダーがインストールされている必要があります。ドライバーインストール時にエラーが出た場合は、以下の手順でカーネルヘッダーをインストールしてください
```
   DebianおよびUbuntuの場合
   
      # apt-cache search linux-headers   <==インストールするパッケージ名を探す
      # apt-get install linux-headers-VERSION
                  ここで VERSIONは 2.6.26-2-686など現在使っているカーネルのバージョンを指定
                  カーネルのバージョンを得るには uname -r が使える
```
```
   CentOSおよびFedoraの場合

      # yum search kernel-devel   <==インストールするパッケージ名を探す
      # yum install XXXXXXXX
                  ここで XXXXXXXXはサーチで得たパッケージ名 (例 kernel-devel.i686)
```
注４．ドライバー(vlbi-usb-linux-1.18)のインストール時に
```
      ......./vlbi-usb-linux-1.18/driver/utds.c:17:27: error:
      asm/semaphore.h: そのようなファイルやディレクトリはありません
```
というエラーが生じた場合は ......./vlbi-usb-linux-1.18/driver/utds.c 中の #include < asm/semaphore.h >を
```
      // #include < asm/semaphore.h >
```
のようにコメントアウトすることによりコンパイルできます。 asm/semaphore.h は kernel 2.6.27.x 以降なくなったようで、そのために発生するエラーです。
注５．ドライバー(vlbi-usb-linux-1.18)のインストール時のヒント
kernel 2.6.27以降にインストールする際は ......./vlbi-usb-linux-1.18/driver/utds.c 中の #include < asm/semaphore.h >を
```
      // #include < asm/semaphore.h >
```
のようにコメントアウトすること。
kernel 2.6.35にインストールする際は ......./vlbi-usb-linux-1.18/driver/utds.c の最初の方に以下の２行を追加する(カーネルバージョン少なくとも2.6.35以降で関数名が変更されているよう）
```
                #define usb_buffer_alloc  usb_alloc_coherent
                #define usb_buffer_free   usb_free_coherent
```
ドライバー(vlbi-usb-linux-2011-01TK)にはこれらの修正が反映されている。
メモ．ドライバー(vlbi-usb-linux-2011-10TK)にはどのような修正が施されたか。(2011-10-14)
ドライバー utds.cで使用しているfile_operation型変数のメンバー関数中、Cプログラムからioctl関数を呼んだときに呼ばれる関数が少なくともlinux kernel 2.6.38ではioctl　から　unlocked_ioctlに変更になっている。また関数のプロトタイプも
```
     static int ioctl(struct inode *, struct file *, unsigned int, unsigned long); 
```
から
```
     static long unlocked_ioctl(struct file *, unsigned int, unsigned long);
```
に変更になっている。これに合わせた修正を行っている。
K5/VSSP用ドライバー
- FreeBSD用ドライバインストール法
- FreeBSD用ドライバー（tds_driver20040521.tar.gz)
- FreeBSD用ドライバー（tds_driver20030415.tar.gz)
- FreeBSD用ドライバー(old)（tds_driver.tar.gz)
- script archive tds-scripts_20160421.tgz (tds_driver_cp.sh, tds_driver_mk.sh, tds_lib_mk.sh)
  ====linux2.6用ドライバ（2005.9.28リリース開始）======
- Linux2.6用ドライバインストール法
- Linux2.6用ドライバー（tds_linux_26.tgz)（これを使用するには2005-09-28以降のアーカイブを使ってください）
  ====linux2.4用ドライバ（改良版2005.6.28リリース）======
- Linux2.4用ドライバ（改良版）インストール法
- Linux2.4用ドライバー（改良版）（tds_20050628.tgz)
- 改修箇所の説明（ [PDF版],[HTML版]）
  ====以下はオリジナルlinuxドライバー=====
- Linux用ドライバインストール法
- Linux用ドライバー（linux.tgz)

最新および古いバージョンの観測ソフトダウンロード

最新バージョン

観測用ソフトウェア群（ipvlbi_obs20160808.tar.gz）<==バージョンを合わせるためのアーカイブ
K5-M5-ADS3000ファイル変換ソフトウェア群（ipvlbi_m5k20160808.tar.gz）<==バージョンを合わせるためのアーカイブ
K5-VDIFファイル変換ソフトウェア群（ipvlbi_vdif20160808.tar.gz）

古いバージョン

古いバージョンダウンロードページ

更新履歴

2016-08-08
VDIFデータ変換プログラム群の公開開始
2016-07-21
k5tom5bのバグ（0hUTCをまたぐスキャンの時刻が異常になる）を改修した。すでに異常となっているMark5Bファイルを修正するソフト"m5b_recov"の提供を開始。
2015-12-22
サンプリングデータの時系列ダイナミック表示ユーティリティ"oscillo"とスペクトルのダイナミック表示ユーティリティ"speana_n"の公開開始
2015-10-28
Ubuntu14.04(64bit)で動作確認したドライバーの公開開始
2014-05-24
k5tom5bを改修し、変換時のチャンネルアサインを自由に変更できるようにした。具体的には"-chN nn"(N=1～16）オプションと "-chall nn:nn:nn:....:nn"オプションを追加した。
2014-02-07
バージョンを合わせるためのアーカイブ
2013-03-06
pfindを改修。VSSP32をデフォルトにした。datacutも改修。VSSP32モードでAUXフィールドのバイト数が20でない値となっていた場合は強制的に20にセット。
2012-12-27
m5btok5およびm5tok5の改修版のアーカイブ。改修個所はm5btok5.c, m5tok5.cおよび libmk5tok5.c中の関数mk5_atamadashi, mk5_sync_detect, mk5b_dat_anal, convM5B2K5.更にgene_updated_time 関数を追加。
2011-10-14
VSSP32のドライバーのlinux kernelのバージョン2.6.38以上対応版の公開。このドライバーを使用してVSSP32がUbuntu11.04で動作することを確認。

2011-02-09
K5ソフト群（src,mark5,apri,corr,sdelay,networkディレクトリ)すべてに以下の改修を行った（ubuntu10.10でコンパイルした場合、多数の警告が出るのを無くするため）。

  1. すべての"long int"型（除くスレッド関係）を"int"型に変更した

  2. int64_t型のフォーマット記述子に"%u"や"%d"や"%ld"を使っていた部分を"%lld"に変更した。

  3. scanfにおいて
       char cbuf[20];
       scanf("%s",&cbuf);
    を
       int iret;
       char cbuf[20];
       iret=scanf("%s",cbuf);
       
    のように修正し、

     warning: format ‘%s’ expects type ‘char *’, but argument 2 has type ‘char (*)[3]’
     warning: ignoring return value of ‘scanf’, declared with attribute warn_unused_result

    の警告がでないようにした

  4. 戻り値のある関数( int scanf, int system, char* fgets)の戻り値を無視しないようにした。
     具体的には

      system(...);      ==>   iret=system(...);    (where  "iret" is int type)
      scanf(...);       ==>   iret=ssanf(...);     (where  "iret" is int type)
      fgets(...);       ==>   ret=fgets(...);      (where  "ret" is char* type)

2011-02-18
バージョンを合わせるためのアーカイブ公開
2011-02-04
pcalcheckを改修し、１ビットADデータでも4010kHzのような中途半端なPCAL周波数を処理できるようにした。
2011-01-12
m5checkの改修。512Mbps以上のMark5bデータに対してデータレートの推定がうまくいかない不具合を修正した。２GB以上のファイルサイズ表示がおかしくなっっていた不具合も修正した。
2011-01-09
k5tom5bのデバグ。64Msps×２ビットモードの変換時、Mark5bデータの時刻ラベルが誤差の蓄積でずれてくる不具合を修正した。
2011-01-07
Fedora14, Ubuntu10.10でVSSP32が動作することを確認した。ただし、ドライバー(バージョンvlbi-usb-linux-1.18)ソフトutds.c 中の #include < asm/semaphore.h >を
```
      // #include < asm/semaphore.h >
```
のようにコメントアウトし、さらに最初の方に以下の２行を追加(カーネルバージョン少なくとも2.6.35以降で関数名が変更されているよう）してからドライバーをインストールすること。
```
     #define usb_buffer_alloc  usb_alloc_coherent
     #define usb_buffer_free   usb_free_coherent
```
2010-08-03
"k5tom5","k5tom5b"のK5データの２つ目以降のヘッダーエラー（時刻エラー）を無視するオプション"-nocheck"を追加した。この機能追加に伴う修正箇所は以下の通り
src/libvssp32.cに関数"CheckK5header_with_Read_but_no_search"を追加。src/libvssp32.h, mark5/libmk5tok5.h, mark5/k5tom5.c, mark5/k5tom5b.c
2010-07-21
ヘイスタックからの依頼によりk5tom5bを改修し、変換後のMark5Bデータが整数秒の切れ目で終了するようにした。
Mark5Bデータ専用の時刻およびデータ長チェックプログラムm5btimeを開発した。
2010-07-16
src以下のmakefileでサンプラーをシミュレーションするモードでのコンパイル"make S=SIM"をサポートした。 "make S=NONE"との相違はS=NONEではサンプラーを使うプログラムはコンパイルされないが、S=SIM ではサンプラーを使うプログラムもコンパイルされる。ただし、サンプラーとしては実際のサンプラー(VSSPおよびVSSP32）ではなく、動作の一部をソフト的にシミュレーションするだけである（主にデバグ目的）。従って、S=SIMとすればドライバーをインストールしていなくてもコンパイル可能である。
2010-06-25
ADS300+のDBBCモードデータをK5/VSSP32またはK5/VSSPフォーマットに変換するプログラムads2k5の公開を開始。
2010-02-08
K5ソフト群のmanページファイルを整備した。
2010-02-07
srcおよびnetwork以下のmakefileのデフォルトサンプラーをK5/VSSPからK5/VSSP32に変更した。これに伴い、インストールシェルスクリプトとしてinstall_obs.sh, install_all.sh, install_all_usefftw.sh を使用した場合はK5/VSSP32用ソフト群がインストールされる。K5/VSSPをインストールするには、install_obs_vssp.sh, install_all_vssp.sh, install_all_vssp_usefftw.sh を使用すること.
one2fourのプログラム使用法の記述に一部不具合があったので修正した。
2010-01-24
Debian 5.0用のVSSP32用ドライバーの公開開始
更新履歴（2009年および以前）

更新日２０１６年８月８日

1.	適当なディレクトリにipvlbi_obs20160808.tar.gz （IP-VLBI(K5/VSSP)ユーティリティVer.2016-08-03) を置く
2.	tar xvzf ipvlbi_obsXXXXXXXX.tar.gz で解凍する
3.	cd ipvlbiXXXXXXXX で作業ディレクトリを移動する（Ver.2005-06-17およびそれ以前は解凍したディレクトリにとどまる）
4.	【この項大幅更新】注：Ver.2010-02-07より前のアーカイブの場合は、インストールのデフォルトがK5/VSSPとなっていますので、 K5/VSSP32をインストールする場合は、install_obs.shの代わりにinstall_obs_vssp32.shを使用してください。 Ver.2010-02-07以降のアーカイブを使ってK5/VSSPをインストールする場合はinstall_obs.shの代わりに install_obs_vssp.shを使用してください。 Ver.2010-02-07以降のアーカイブを使ってK5/VSSP32システムをインストールするには、 install_obs.sh を実行してください。ここで従来(Ver.2007-10-30以前）のようにsourceコマンドは使用しないでinstall_obs.shを直接実行してください。実行権が適切にセットされていない場合はセットしてください。グラフィック表示はデフォルトではPGPLOTですが、GNUPLOTを使用したい場合はそれぞれのシェルスクリプト実行時にオプションG=GNUPLOTをつけて実行してください。VSSP32の場合は　install_obs.sh G=GNUPLOT のようになります。 FreeBSDシステムでは /usr/lib/libg2c.so: warning: tempnam() possibly used unsafely; consider using mkstemp() という警告メッセージが出ますが、これはインストールされているPGPLOTパッケージ中の関数に関する警告ですので無視してください。 linuxシステムにてコンパイル時に警告メッセージが多く出る場合は、 install_obs.64.shをお使い下さい。（install_obs.64.shはファイルオープンにfopen64を使用したコンパイルを行います）
5.	【環境の設定を行う】インストールしたソフト群のディレクトリが例えば$HOME/K5/ipvlbiXXXXXXXXである場合シンボリックリンクで ln -s $HOME/K5/ipvlbiXXXXXXXX $HOME/ipvlbi すでにリンクがある場合新しく貼り直す場合は"f"オプションをつけて、 ln -sf $HOME/K5/ipvlbiXXXXXXXX $HOME/ipvlbi でリンクを作成し、.bashrcなどのリソースファイル中で export PATH=$PATH:$HOME/ipvlbi/bin (.bashrcの場合） setenv PATH $PATH:$HOME/ipvlbi/bin (.cshrcの場合）を記述しておけば、K5ソフト群のバージョンアップを行った際もシンボリックリンクを張り直すだけで良くなる。 Ver.2010-02-08以降のアーカイブではmanページファイルも含まれているので、.bashrcなどに export MANPATH=$HOME/ipvlbi/man:$MANPATH (.bashrcの場合） setenv MANPATH $HOME/ipvlbi/man:$MANPATH (.cshrcの場合）を記述しておけば、manコマンド(例えば"man autoobs"等)でK5ソフト群の使用方法を得ることができる。なお、"man k5util"を実行することにより、K5ソフト群全体の説明を得ることができる。